feat(api-explorer): add command hyperlinks for large output [DEVEX-967]

[jpage-godaddy]

Summary

• Renames api describe/api endpoint to api operation get/api operation list, and adds api parameter, api response, and api schema command groups so an operation's parameters, responses, and schemas can be inspected individually instead of everything being inlined.
• Every parameter/response row now carries a type and, when there's something to drill into (a $ref or an inline object with properties), a schemaId resolvable via the new api schema get <id>.
• Truncated previews point at next_actions for the rest instead of dumping everything inline; nested tables in human output now show a real (N of M rows, ...) footer.
• An ambiguous or unresolved operation query is now a proper error with candidates listed in the fix, instead of a success-shaped response.
• Adds gddy guide api-explorer, a user-facing guide for the new command surface.
• Bumps cli-engine to 0.8.2.

Test plan

• cargo check / cargo clippy -- -D warnings / cargo fmt --check / cargo test all pass
• Manually exercised api operation get, api parameter list/get, api response list/get, api schema get, ambiguous/not-found error paths, and gddy guide api-explorer against the built binary in both --output json and --output human

🤖 Generated with Claude Code

[Copilot]

🟡 Changes recommended

There are a few user-facing correctness issues (invalid not-found “fix” command, incomplete next_action param metadata, and at least one test/header mismatch) that should be addressed before approval.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

This review doesn't count toward merge requirements. Sign up for the private preview to control whether Copilot approvals count.

Pull request overview

This PR refactors the Rust API explorer command surface to support drill-down navigation for large outputs: operations are now browsed via api operation list/get, with new api parameter, api response, and api schema groups to inspect parameters, responses, and schema trees directly, and truncated previews linking to appropriate follow-up commands. It also introduces a reusable Summary<T> envelope for capped/nested table output and upgrades cli-engine to v0.8.x to support new pagination/rendering behavior.

Changes:

• Rename api describe/api endpoint to api operation get/api operation list, and add api parameter, api response, and api schema commands for drill-down.
• Add Summary<T> (with PaginationMeta) for capped previews + “next action if truncated” linking, and improve ambiguous-operation handling as an error with candidate commands.
• Add a user-facing guide (gddy guide api-explorer) and bump cli-engine from 0.7.x to 0.8.2.

File summaries

File	Description
rust/tools/generate-api-catalog/src/main.rs	Updates generator docs to match the renamed api operation get command surface.
rust/src/summary.rs	Adds Summary<T> envelope for capped nested output with pagination metadata and truncation-aware next-actions.
rust/src/main.rs	Wires the new summary module into the binary.
rust/src/error.rs	Introduces a stable AMBIGUOUS_MATCH error code and helper constructor for ambiguous operation resolution.
rust/src/api_explorer/mod.rs	Major API explorer refactor: new command groups, new schema-id + schema-tree plumbing, capped previews + links, and new ambiguity/not-found behaviors.
rust/src/api_explorer/guides/api-explorer.md	Adds the api-explorer guide documenting the new command flow and drill-down semantics.
rust/Cargo.toml	Bumps cli-engine dependency to 0.8.x.
rust/Cargo.lock	Locks cli-engine to 0.8.2 and updates transitive deps (e.g., socket2).
docs/design/devex-967-api-explorer-drilldown.md	Removes the now-superseded design draft from docs/design.

Review details

• Files reviewed: 7/9 changed files
• Comments generated: 5
• Review effort level: Lite

We're testing this review assessment. Please use 👍 or 👎 to tell us if it's correct.

[Copilot]

🟡 Changes recommended

The current schema drill-down logic fails to emit schemaId for some drillable array schemas (blocking navigation to api schema get) and should be corrected before approval.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

This review doesn't count toward merge requirements. Sign up for the private preview to control whether Copilot approvals count.

Review details

• Files reviewed: 7/9 changed files
• Comments generated: 0 new
• Review effort level: Lite

We're testing this review assessment. Please use 👍 or 👎 to tell us if it's correct.