Mirror page path matching for resources

[sbsoftware-agent]

Summary

• Share Page path matching helpers with Resources
• Add Resource support for root_path, path_param, nested_path, and named uri_path
• Prevent nested Resource paths from matching parent-only collection or member paths

Testing

• CRYSTAL_CACHE_DIR=/tmp/crystal-cache- crystal spec --error-trace

[sbsoftware]

Please remove the legacy interface altogether.

[sbsoftware-agent]

Removed the legacy Resource.nested_path class-method interface locally, including the fallback matching branch and the legacy spec fixture. Updated README wording to point Resources at the Page-style root_path, path_param, and nested_path declarations.

Verification: CRYSTAL_CACHE_DIR=/tmp/crystal-cache-cr-133-review2 crystal spec --error-trace passes with 101 examples.

I could not create the focused commit from this environment because .git is mounted read-only, and the attempted GitHub connector commit was cancelled.

[sbsoftware]

Please double check whether any of the indirections in the path matching module can be removed now.

[sbsoftware-agent]

Double-checked and removed the redundant indirections that are no longer needed after dropping the legacy nested Resource hook:

• Inlined _path_matching_derived_root_path back into _root_path.
• Removed _path_matching_segment_patterns and inlined its single use in uri_path_matcher.
• Kept _path_matching_uri_path because Resource still needs it to support both legacy positional uri_path(id) for normal resources and Page-style named uri_path(**params) for declared path params.
• Simplified Resource#nested? to check declared path parts directly.

Verification: CRYSTAL_CACHE_DIR=/tmp/crystal-cache-cr-133-review3 crystal spec --error-trace passes with 101 examples.

I could not create the focused commit locally because .git is mounted read-only in this environment.