Repository navigation
T18 — Render an entry's or a box's expanded spec #2906
Description
Task
| slice | size | difficulty | model | who | estimated lines |
|---|---|---|---|---|---|
| Inspect specs and types | L | routine | standard | an agent | 820 (340 code, 480 tests) |
min box specshows an entry's expanded spec before start and a box's stored spec after, with the source of every value.
Covers:
- BCLI-021
- BCLI-022
- BCLI-023
Re-planned by the owner on 2026-11-11, after the first run came back as a no-op. A daemon layer adds GetBoxSpec, because no RPC returned a box's stored spec. The hooks rows moved to T41 (#3283), which waits on BOX-179's implementation (#3282). The session hooks alias row is dropped: the old verbs are removed with no alias (owner ruling, 2026-11-09).
Layers:
- client:
- crates/minimal/src/cli.rs: the verb's arguments and help in the one command model
- crates/minimal/src/cmd/mod.rs: dispatches the verb
- crates/minimal/src/cmd/box_spec.rs: the entry and box forms,
-o toml|json|yaml, the layer and type beside each value - crates/minimal/src/tests.rs: the in-process minimald test harness gains this layer's tests
cargo nextest run -p minimal box_spec_renders_formats_secrets_as_refscargo nextest run -p minimal box_spec_path_form_renders_bep_rowscargo nextest run -p minimal box_spec_entry_network_flags_match_startcargo nextest run -p minimal box_spec_box_renders_stored_copycargo nextest run -p minimal box_spec_argument_directory_then_entry_then_boxcargo nextest run -p minimal box_spec_renders_unenforced_sections
- daemon:
- crates/minimald-rpc/src/lib.rs: a
GetBoxSpecrequest returns a box's stored spec (spec.json) to the client - crates/minimald/src/box_manager.rs: answers
GetBoxSpecfrom the box's stored spec.json cargo nextest run -p minimald get_box_spec_returns_stored_spec
- crates/minimald-rpc/src/lib.rs: a
Waits on:
- T4 — Resolve a box address across the local hosts #2895
- BOX: does the stored spec keep each lifecycle hook's declarer? (BCLI-022 / session hooks parity) #2877
- BCLI: min box spec reads a directory before an entry of the same name; pick the rule (BCLI-021/022) #2878
Plan block
### T18 — Render an entry's or a box's expanded spec
slice: S5
kind: task
covers: BCLI-021, BCLI-022, BCLI-023
size: L
est: 340 code, 480 tests
executor: agent
difficulty: routine
model: standard
diagnostics: `min box spec <entry>` prints each value with the layer and type it came from, and a secret as its reference only, pinned by box_spec_renders_formats_secrets_as_refs
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/cmd/mod.rs: dispatches the verb
- crates/minimal/src/cmd/box_spec.rs: the entry and box forms, `-o toml|json|yaml`, the layer and type beside each value
- crates/minimal/src/tests.rs: the in-process minimald test harness gains this layer's tests
test: cargo nextest run -p minimal box_spec_renders_formats_secrets_as_refs
test: cargo nextest run -p minimal box_spec_path_form_renders_bep_rows
test: cargo nextest run -p minimal box_spec_entry_network_flags_match_start
test: cargo nextest run -p minimal box_spec_box_renders_stored_copy
test: cargo nextest run -p minimal box_spec_argument_directory_then_entry_then_box
test: cargo nextest run -p minimal box_spec_renders_unenforced_sections
- daemon:
- crates/minimald-rpc/src/lib.rs: a `GetBoxSpec` request returns a box's stored spec (spec.json) to the client
- crates/minimald/src/box_manager.rs: answers `GetBoxSpec` from the box's stored spec.json
test: cargo nextest run -p minimald get_box_spec_returns_stored_spec
produces: none
consumes:
- crates/minimal/src/cmd/boxes/address.rs
proof: `min box spec` shows an entry's expanded spec before start and a box's stored spec after, with the source of every value.
depends on:
- blocked by #2895
- blocked by #2877
- blocked by #2878
Reacted by minimal-foundry
Activity
minimal-foundry commentedon Nov 11, 2026
Done. #3290 merged.
branch
agent/2906-render-an-entry-s-or-a-box-s-expanded-spec· epic #2879 · PR #3290327d1edf6ac044dbb412b045d6b0cd39Updated 2026-11-12T02:30:28.223Z.