Skip to content

feat(roadsselection): update v1 methods, standardized clients, and cli tools - #92

Open
n0531m wants to merge 1 commit into
mainfrom
feat/api-roadsselection-updates-newmethods
Open

feat(roadsselection): update v1 methods, standardized clients, and cli tools#92
n0531m wants to merge 1 commit into
mainfrom
feat/api-roadsselection-updates-newmethods

Conversation

@n0531m

@n0531m n0531m commented Sep 2, 2026

Copy link
Copy Markdown
Collaborator

Summary

This PR modernizes the Roads Selection API v1 client libraries, helper builders, and scenario scripts across both the api-roadsselection agentic skill and roads_management_insights/rmi_cli_tools/.

Key Changes

  • Unified Client Naming & Single-Word RPC Verbs:
    • Core RPC client methods in roadsselection_v1.sh:
      • roadsselection_v1_selectedroute_create
      • roadsselection_v1_selectedroute_batchcreate
      • roadsselection_v1_selectedroute_get
      • roadsselection_v1_selectedroute_patch
      • roadsselection_v1_selectedroute_batchupdate
      • roadsselection_v1_selectedroute_list
      • roadsselection_v1_selectedroute_delete
      • roadsselection_v1_selectedroute_batchdelete
  • Standardized Helper JSON Builders (roadsselection_v1_helpers.sh):
    • Schema-aligned builder functions:
      • roadsselection_v1_latlng_json
      • roadsselection_v1_dynamicroute_json
      • roadsselection_v1_selectedroute_json
      • roadsselection_v1_selectedroute_create_request_json
      • roadsselection_v1_selectedroute_batchcreate_request_json
      • roadsselection_v1_selectedroute_update_request_json
      • roadsselection_v1_selectedroute_batchupdate_request_json
      • roadsselection_v1_selectedroute_batchdelete_request_json
    • Backward-compatibility aliases preserved for legacy helper function names.
  • Client Libraries & Scenarios Modernization in rmi_cli_tools/:
    • Aligned standalone client scripts in rmi_cli_tools/clients/ with the unified v1 functions across Bash, Python, and TypeScript.
    • Updated scenarios (rmi_verify_api_access.sh, rmi_data_backup.sh) and rmi_cli_tools/README.md to use the updated client APIs.
  • 7 Executable Markdown Guides (examples/00_ through 06_):
    • 00_create_get_list_delete_selected_routes.md
    • 01_update_selected_route_patch.md
    • 02_batch_update_selected_routes.md
    • 03_batch_delete_selected_routes.md
    • 04_route_attributes_management.md
    • 05_route_lifecycle_and_validation.md
    • 06_batch_create_selected_routes.md
  • September 2026 API Operations & Assessment Note:
    • Highlights September 2026 advanced route mutation features with citation to official Release Notes.
    • Explicit enforcement of 100-byte UTF-8 limits on displayName and routeAttributes.
  • Standard Apache 2.0 License Headers:
    • Included across all companion Bash, Python, and TypeScript scripts.

@n0531m
n0531m force-pushed the feat/api-roadsselection-updates-newmethods branch 4 times, most recently from 5814363 to bb84c29 Compare September 2, 2026 03:08
@n0531m n0531m changed the title feat(roadsselection): update v1 methods and companion guides feat(roadsselection): update v1 methods, standardized clients, and cli tools Sep 2, 2026
@n0531m
n0531m force-pushed the feat/api-roadsselection-updates-newmethods branch from bb84c29 to 1ef630e Compare September 2, 2026 03:13
…link cli tools

- Update Roads Selection API v1 client to cover all 8 RPC methods (create, batchCreate, get, patch, batchUpdate, list, delete, batchDelete)
- Adopt unified roadsselection_v1_selectedroute_* naming standard across skills and rmi_cli_tools
- Standardize helper JSON builder functions to Option A format (roadsselection_v1_latlng_json, roadsselection_v1_dynamicroute_json, roadsselection_v1_selectedroute_json, roadsselection_v1_*_request_json) with single-word batch verbs (batchcreate, batchupdate, batchdelete) and backward compatibility aliases
- Replace duplicate client scripts in rmi_cli_tools/clients/ with relative symlinks to .agents/skills/api-roadsselection/scripts/
- Modernize rmi_verify_api_access.sh and rmi_data_backup.sh scenarios to use unified client functions
- Add 7 comprehensive runnable examples (00 through 06) covering CRUD, PATCH with updateMask, batch operations, route attributes, and lifecycle state transitions
- Add September 2026 release note reference and modernization assessment recommendation
- Clarify 100 bytes UTF-8 limits on displayName and routeAttributes across clients and guides
- Include standard Apache 2.0 license headers across companion scripts and documentation
- Align IAM authorization runbooks and official developer references
@n0531m
n0531m force-pushed the feat/api-roadsselection-updates-newmethods branch from 1ef630e to 98f87a0 Compare September 2, 2026 03:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant