Repository navigation
Add a lean pm contracts --summary mode for cheap agent bootstrap #442
Description
Problem (current behavior)
pm contracts is the recommended machine-discovery entrypoint, but its sizes are hostile to agents:
- default
--json: 25,118 bytes --availability-only: 24,666 bytes (despite the name, it still expands everyextension */package *subcommand)--action create: 63,534 bytes--full: 520,414 bytes
There is no minimal "command name + one-line intent" surface. An agent that just wants to know "what can pm do?" pays ~25KB up front before issuing a single real command.
Proposed improvement
Add a --summary / --lean mode that emits one line per top-level command: { command, intent } (collapsing extension/package subcommands and aliases), targeting a few KB. Keep --full for deep introspection. Also have --availability-only actually be lean (top-level commands only, no subcommand expansion) so the name matches the size.
Agent benefit
Lets an agent bootstrap its knowledge of the command surface for ~1–3KB instead of ~25KB, then drill into a single command via pm contracts --command <c> --flags-only --json or pm <c> --help --json as needed. Classic progressive-disclosure win.
Activity
coderabbitai commentedon Jul 5, 2026
🔗 Related PRs
#36 - [codex] Improve agent UX from manual pm audit [closed]
#142 - Guard pm tracker path targeting for agents [closed]
#343 - feat(sdk): describeExtensionActivation — single-call introspection of every registered surface [merged]
#396 - refactor(sdk): decompose cli-contracts.ts monolith into flag-contracts + tool-schema modules [merged]
#428 - Harden SDK extension runtime packaging [merged]
📝 Issue Planner
Check the box below or use the
@coderabbitai plancommand to generate an implementation plan and prompts that you can use with your favorite coding assistant.🧪 Issue enrichment is currently in open beta.
You can configure auto-planning by selecting labels in the issue_enrichment configuration.
To disable automatic issue enrichment, add the following to your
.coderabbit.yaml:💬 Have feedback or questions? Drop into our discord!
unbraind commentedon Jul 8, 2026
Shipped in 05f91b7:
pm contracts --summarylean bootstrap mode is live on main. Tracked as pm-vxxm (closed with evidence).unbraind commentedon Jul 11, 2026
pm tracker item:
pm-vxxm— Add a leanpm contracts --summarymode for cheap agent bootstrap #442: lean pm contracts --summary mode for cheap agent bootstrap (25KB -> 1-3KB)