Skip to content

docs(brief): the surfaces register matches v0.12.0's commands - #763

Merged
REPPL merged 1 commit into
mainfrom
docs/brief-register-v012
Sep 30, 2026
Merged

REPPL merged 1 commit into
mainfrom
docs/brief-register-v012

Conversation

@REPPL

@REPPL REPPL commented Sep 30, 2026

Copy link
Copy Markdown
Collaborator

The brief's surfaces register now matches v0.12.0's commands. An independent docs review of the release candidate held the cut on five sentences in .abcd/development/brief/04-surfaces/README.md that still described an earlier command tree; this change corrects them, and one code comment that carried the same stale claim.

The five changes, each checked against the code it cites:

  1. The drain row in the chapter table describes drain as it ships: work the open ledger unattended, preview with --dry-run, then run it one lane at a time, routing every hand-back by its kind (internal/surface/cli/drain.go runs one move of the run without --dry-run).
  2. The bare-invocation paragraph says bare abcd drain is the run itself, one move per invocation, so it is not a render; what a drain would do renders through its dry run.
  3. The people/release row lists reflect beside launch (internal/surface/cli/helpgroups.go).
  4. The agents-block row lists intent consistency ingest, intent prepass and lab (helpgroups.go; commands/lab.md declares block: agents).
  5. The person-verb cap reads fifteen, the ceiling consolidate_test.go holds.

The bare-render exception reason for drain in internal/surface/cli/barerender.go now says what the bare verb does. That text is read only by the bare-render test, so no behaviour changes.

Gates: go test ./internal/surface/cli/..., record-lint, docs-lint and abcd docs fidelity --report (layer 1: 164 of 164) pass; make preflight passes and minted the push receipt.

Assisted-by: Claude:claude-opus-5-5

The independent docs review at 4b9b29c held the cut on five sentences in
04-surfaces/README.md that describe an earlier command tree:

- the drain row and the bare-invocation sentence said bare `drain` refuses
  to start because the run is not built; drain.go runs one move of the run
  per invocation (runDrain -> loop.Drain) without --dry-run;
- the people/release row omitted `reflect` (helpgroups.go files it under
  release);
- the agents-block row omitted `intent consistency ingest`, `intent prepass`
  and `lab` (helpgroups.go; commands/lab.md declares block: agents);
- the person-verb cap read fourteen; consolidate_test.go holds fifteen.

The bare-render exception reason for drain in barerender.go carried the
same stale claim; it now says what the bare verb does. The reason text is
read only by the bare-render test, so no behaviour changes.

Assisted-by: Claude:claude-opus-5-5
@REPPL
REPPL enabled auto-merge September 30, 2026 17:02
@REPPL
REPPL added this pull request to the merge queue Sep 30, 2026
Merged via the queue into main with commit b933099 Sep 30, 2026
13 checks passed
@REPPL
REPPL deleted the docs/brief-register-v012 branch September 30, 2026 17:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant