Evidence map clause
1.1 Process model
This clause and its evidence summary follow the authored EVIDENCE-MAP.md section.
Evidence map clause · EVIDENCE-MAP.md
Map clause: CLI and interaction contract.
Source heading anchors: spec/01-cli.md#11-process-model; spec/01-cli.md#12-command-tree-fixed; spec/01-cli.md#13-argument-grammar; spec/01-cli.md#14-help-pages; spec/01-cli.md#15-exit-codes-and-error-lines; spec/01-cli.md#16-project-resolution-all-project-commands; spec/01-cli.md#17-commands; spec/01-cli.md#171-intent-shape; spec/01-cli.md#172-intent-approve---by-; spec/01-cli.md#173-intent-remove---force; spec/01-cli.md#174-queue-start---detach-and-queue-stop; spec/01-cli.md#175-status---watch---json; spec/01-cli.md#176-provider-; spec/01-cli.md#177-version; spec/01-cli.md#18-signals-and-deprecations
Spec revision / decision reference: v1.2 (pinned fragment locally verified); section-level D references are listed in the source classification. Last reviewed: 2026-10-07.
Type: Normative product; safety/correctness for exit and state-reporting behavior.
Evidence and status: NO EMPIRICAL EVIDENCE for improved agent success or user experience. The
cli-dx-v2,ax-and-cli-v3, andshaping-uxentries in `research/README.md` are study-index records, not outcome receipts. Related hypotheses: H18, H24, H106–H110, H147.Unresolved measurement: A paired usability and task-success comparison of the specified headless command surface against alternatives, with the same task, model, effort, and tool access.