MDM-19 add command catalog discovery

[dudash]

Summary

• Add mdm commands --json as an agent-readable command catalog envelope.
• Include command paths, args, flags, output modes, formats, examples, docs/skill pointers, and safety metadata.
• Add catalog drift coverage against Clap definitions and an integration test for the emitted catalog.
• Update the agent CLI contract and mdm-cli-inspection skill docs to use the catalog as the tactical discovery layer.
• Fix clippy warnings surfaced by CI.

Validation

• cargo fmt
• cargo clippy --all-targets --all-features -- -D warnings
• cargo test --test cli
• cargo test
• scripts/test-skills.sh --skill mdm-cli-inspection

[Copilot]

Pull request overview

Adds an agent-readable command catalog to the mdm CLI to enable local command discovery (including safety/IO metadata and examples), and updates agent-facing docs/skills plus tests to keep the catalog aligned with the Clap command surface.

Changes:

• Introduce mdm commands / mdm commands --json emitting a command_catalog.v1 envelope and add drift checks against Clap subcommand paths.
• Refactor CLI JSON/plain/pretty printing call sites via an OutputSpec struct.
• Update agent contract docs and mdm-cli-inspection skill references; add an integration test for the catalog.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/cli.rs	Adds the commands subcommand, implements the command catalog, refactors output plumbing, and adds catalog drift/unit tests.
tests/cli.rs	Adds an integration test validating mdm commands --json envelope and key catalog properties.
src/importer.rs	Small refactors to address clippy warnings (no behavior change intended).
docs/AGENT_CLI_CONTRACT.md	Documents mdm commands --json and the new command_catalog.v1 envelope shape/expectations.
skills/README.md	Updates skill overview to mention using mdm commands --json for discovery.
skills/mdm-cli-inspection/SKILL.md	Adds guidance to use the command catalog for local discovery.
skills/mdm-cli-inspection/references/query-and-export.md	Adds a note about mdm commands --json usage.
skills/mdm-cli-inspection/references/command-patterns.md	Adds a discovery section showing how to use the catalog.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.