-
Notifications
You must be signed in to change notification settings - Fork 0
Define one typed command catalog for CLI and desk surface parity #100
Copy link
Copy link
Closed
Labels
area:build-graphArtifact registry, build dependencies, and target orchestrationArtifact registry, build dependencies, and target orchestrationarea:dxContributor tooling, tests, maintainability, and development workflowContributor tooling, tests, maintainability, and development workflowarea:tuiTerminal UI, operator desk, and interactive run controlTerminal UI, operator desk, and interactive run controlarea:uxUser-facing command behavior and diagnosticsUser-facing command behavior and diagnosticsenhancementNew feature or requestNew feature or requestpriority:P1High: required for a trustworthy supported workflowHigh: required for a trustworthy supported workflowtest-layer:L1Pure unit and property-based proofsPure unit and property-based proofs
Milestone
Description
Metadata
Metadata
Assignees
Labels
area:build-graphArtifact registry, build dependencies, and target orchestrationArtifact registry, build dependencies, and target orchestrationarea:dxContributor tooling, tests, maintainability, and development workflowContributor tooling, tests, maintainability, and development workflowarea:tuiTerminal UI, operator desk, and interactive run controlTerminal UI, operator desk, and interactive run controlarea:uxUser-facing command behavior and diagnosticsUser-facing command behavior and diagnosticsenhancementNew feature or requestNew feature or requestpriority:P1High: required for a trustworthy supported workflowHigh: required for a trustworthy supported workflowtest-layer:L1Pure unit and property-based proofsPure unit and property-based proofs
Problem
The public command surface is split between
USAGE, a large conditional router, artifact-format derivation, documentation generation, and the proposed desk palette. Adding a TUI by copying that surface would violate the repository law that facts are stated once.Direction
Introduce a typed command catalog that is authoritative for command identity and discoverability while leaving command execution in the existing CLI application boundary. The CLI usage text, generated reference, desk target picker, and command palette must project from the catalog. Argument-bearing families such as
publish,art, and operator commands must have explicit schemas rather than prose parsing.This should align with the typed-boundary work in #82: #82.
Invariants
Acceptance
docs/REFERENCE.mdgeneration consumes the catalog.Links