Repository navigation
T32 — One command model, its help, completions and reference #2922
Description
Task
| slice | size | difficulty | model | who | estimated lines |
|---|---|---|---|---|---|
| Move off the session verbs | M | routine | standard | an agent | 450 (150 code, 300 tests) |
min box --helpand the shell completions list every verb and flag, and the CLI reference documents each one.
Covers:
- BCLI-026
- BCLI-028
- BCLI-044
- BCLI-043
Layers:
- client:
- crates/minimal/src/cli.rs: the verb's arguments and help in the one command model
- crates/minimal/src/completions.rs: completions come from the same command model as the help
- crates/minimal/src/tests.rs: the in-process minimald test harness gains this layer's tests
cargo nextest run -p minimal box_verbs_exist_with_arch_flagscargo nextest run -p minimal help_and_completions_from_one_modelcargo nextest run -p minimal cli_reference_documents_box_grammarcargo nextest run -p minimal docs_name_aliases_only_in_one_migration_notecargo nextest run -p minimal setup_zed_unchanged
- docs:
- docs/reference/cli-min.md: documents every
min box, session and task verb - docs/concepts/sessions.md: carries the one migration note that names the old spellings
- docs/reference/cli-min.md: documents every
Waits on:
- T16 — See, read, wait on and stop one exec #2913
- T20 — Scaffold and append entries with min init #2893
- T23 — Show the disk a stopped box holds #2915
- T24 — Copy files out of a box and read its events #2908
- T25 — Restart a long-running box #2909
- T30 — The session and task nouns as filtered box verbs #2921
- T31 — Old session verbs as aliases with a hint #2917
Plan block
### T32 — One command model, its help, completions and reference
slice: S8
kind: task
covers: BCLI-026, BCLI-028, BCLI-044, BCLI-043
size: M
est: 150 code, 300 tests
executor: agent
difficulty: routine
model: standard
diagnostics: `min box --help` lists every verb with one line on what it does, and `min box <verb> --help` lists its flags, pinned by help_and_completions_from_one_model
observability: the command's existing tracing span records the verb, the box id it resolved and the outcome
layers:
- client:
- crates/minimal/src/cli.rs: the verb's arguments and help in the one command model
- crates/minimal/src/completions.rs: completions come from the same command model as the help
- crates/minimal/src/tests.rs: the in-process minimald test harness gains this layer's tests
test: cargo nextest run -p minimal box_verbs_exist_with_arch_flags
test: cargo nextest run -p minimal help_and_completions_from_one_model
test: cargo nextest run -p minimal cli_reference_documents_box_grammar
test: cargo nextest run -p minimal docs_name_aliases_only_in_one_migration_note
test: cargo nextest run -p minimal setup_zed_unchanged
- docs:
- docs/reference/cli-min.md: documents every `min box`, session and task verb
- docs/concepts/sessions.md: carries the one migration note that names the old spellings
produces: none
consumes: none
proof: `min box --help` and the shell completions list every verb and flag, and the CLI reference documents each one.
depends on:
- blocked by #2913
- blocked by #2893
- blocked by #2915
- blocked by #2908
- blocked by #2909
- blocked by #2921
- blocked by #2917
Activity
mitodrummer commentedon Nov 4, 2026
From BCLI T27 (#2984), for the reference and migration note:
docs/reference/cli-min.md~39 still documents--provider local-minimaldas the Linux default. It is now a hidden alias oflocal.README.md~36 still sayslocal-minimald.crates/minimal-client/src/lib.rs~1404–1406 says "the native local-minimald backend".