-
Notifications
You must be signed in to change notification settings - Fork 63
Pack v2: freeze commands and doctor final shape #668
Copy link
Copy link
Open
Labels
city-pack-v2City/pack v2 design and migration workCity/pack v2 design and migration workkind/designDesign / Product questions we need to resolveDesign / Product questions we need to resolvephase/post-0.13.6Explicitly after the 0.13.6 merge waveExplicitly after the 0.13.6 merge wavestatus/needs-triageInbox — we haven't looked at it yetInbox — we haven't looked at it yet
Metadata
Metadata
Assignees
Labels
city-pack-v2City/pack v2 design and migration workCity/pack v2 design and migration workkind/designDesign / Product questions we need to resolveDesign / Product questions we need to resolvephase/post-0.13.6Explicitly after the 0.13.6 merge waveExplicitly after the 0.13.6 merge wavestatus/needs-triageInbox — we haven't looked at it yetInbox — we haven't looked at it yet
Summary
We need to freeze the durable Pack v2 contract for
commands/anddoctor/without accidentally hardening still-open design questions.Why
The first-pass validation suite can safely gate discovery conventions, but the richer command/doctor meta-model is still under-specified. We should settle the final shape explicitly rather than letting tests or partial implementations fossilize it.
Freeze now
commands/<path>/run.shas the default command entrypointdoctor/<path>/run.shas the default doctor entrypointhelp.mdas the default adjacent help surfacecommand.toml/doctor.tomlas optional escape hatchesDecide here
command.tomlanddoctor.tomlare allowed to mean long-termOut of scope for the current suite gate
References
docs/packv2/doc-directory-conventions.mddocs/packv2/doc-pack-v2.mddocs/packv2/doc-conformance-matrix.mdmigration-validation-suite-first-pass