fix(cli): include hidden verbs in registration census #987

Merged
pullings merged 2 commits from i/787-cli-registration-census into main 2026-08-27 00:46:40 +02:00
Owner

The subcommands slice now means the complete Cobra registration census, not only the advertised help surface. hidden is explicit metadata, so visibility changes do not change the denominator. build-bake, bake-digest, and post-cut are registered through the census; repin remains visible as previously decided. The C5 test explicitly excludes only the toolkit-self/cut-path entries from the adopter-facing table.

Verification:

  • go test ./cmd/rt -run TestAllSubcommandsPresent|TestSubcommandsMatchC5Contract|TestHelpSnapshot|TestSkeletonsExitCannotGrade -count=1 -> PASS
  • go test ./... -count=1 -> PASS
  • go vet ./... -> PASS
  • go build ./... -> PASS
  • bats --print-output-on-failure tests/ -> 99/99 PASS
  • shellcheck scripts -> PASS
  • go run ./cmd/rt fragment-check changelog.d -> all fragments valid, density PASS
  • git diff --check -> PASS

Focused runtime controls confirm repin is present in rt --help, the three hidden verbs are absent from help, and rt build-bake --help, rt bake-digest --help, and rt post-cut --help each resolve to a registered command.

The `subcommands` slice now means the complete Cobra registration census, not only the advertised help surface. `hidden` is explicit metadata, so visibility changes do not change the denominator. `build-bake`, `bake-digest`, and `post-cut` are registered through the census; `repin` remains visible as previously decided. The C5 test explicitly excludes only the toolkit-self/cut-path entries from the adopter-facing table. Verification: - `go test ./cmd/rt -run TestAllSubcommandsPresent|TestSubcommandsMatchC5Contract|TestHelpSnapshot|TestSkeletonsExitCannotGrade -count=1` -> PASS - `go test ./... -count=1` -> PASS - `go vet ./...` -> PASS - `go build ./...` -> PASS - `bats --print-output-on-failure tests/` -> 99/99 PASS - shellcheck scripts -> PASS - `go run ./cmd/rt fragment-check changelog.d` -> all fragments valid, density PASS - `git diff --check` -> PASS Focused runtime controls confirm `repin` is present in `rt --help`, the three hidden verbs are absent from help, and `rt build-bake --help`, `rt bake-digest --help`, and `rt post-cut --help` each resolve to a registered command.
fix(cli): census hidden workflow verbs
Some checks failed
manifest-check / manifest-vs-tag consistency (pull_request) Successful in 7s
manifest-check / check (pull_request) Successful in 0s
register-check / toolkit-self gate (PR's own rt) (pull_request) Successful in 4s
register-check / register-drift check (pull_request) Successful in 7s
register-check / check (pull_request) Successful in 0s
tests / workflow-schema (pull_request) Successful in 3s
tests / dated-examples (pull_request) Successful in 3s
tests / shellcheck (pull_request) Successful in 2s
check-self-bootstrap / check (pull_request) Successful in 1m2s
fragment-check / toolkit-self gate (PR's own rt) (pull_request) Successful in 1m37s
go-ci / lint + build + test (pull_request) Successful in 1m47s
changelog-body-check / toolkit-self gate (PR's own rt) (pull_request) Successful in 2m10s
manifest-check / toolkit-self gate (PR's own rt) (pull_request) Successful in 2m24s
tests / bats (pull_request) Successful in 2m22s
fragment-check / changelog fragment-kind (pull_request) Successful in 3m27s
fragment-check / check (pull_request) Successful in 0s
changelog-body-check / changelog body Cold-Read linter (pull_request) Successful in 3m44s
changelog-body-check / check (pull_request) Successful in 0s
ac-closure-check / ac-closure check (pull_request) Successful in 7s
ac-closure-check / check (pull_request) Successful in 0s
ac-closure-check / toolkit-self gate (PR's own rt) (pull_request) Failing after 58s
88739cbfa9
fix(ci): precreate AC fixture log before polling
All checks were successful
changelog-body-check / toolkit-self gate (PR's own rt) (pull_request) Successful in 5s
manifest-check / manifest-vs-tag consistency (pull_request) Successful in 7s
manifest-check / check (pull_request) Successful in 0s
register-check / toolkit-self gate (PR's own rt) (pull_request) Successful in 4s
register-check / register-drift check (pull_request) Successful in 7s
register-check / check (pull_request) Successful in 0s
tests / workflow-schema (pull_request) Successful in 3s
tests / bats (pull_request) Successful in 11s
tests / dated-examples (pull_request) Successful in 3s
tests / shellcheck (pull_request) Successful in 2s
go-ci / lint + build + test (pull_request) Successful in 58s
ac-closure-check / toolkit-self gate (PR's own rt) (pull_request) Successful in 1m6s
manifest-check / toolkit-self gate (PR's own rt) (pull_request) Successful in 1m26s
fragment-check / toolkit-self gate (PR's own rt) (pull_request) Successful in 2m9s
check-self-bootstrap / check (pull_request) Successful in 2m25s
ac-closure-check / ac-closure check (pull_request) Successful in 3m8s
ac-closure-check / check (pull_request) Successful in 0s
changelog-body-check / changelog body Cold-Read linter (pull_request) Successful in 3m25s
changelog-body-check / check (pull_request) Successful in 0s
fragment-check / changelog fragment-kind (pull_request) Successful in 3m42s
fragment-check / check (pull_request) Successful in 0s
536c8b8bde
lookout approved these changes 2026-08-27 00:43:33 +02:00
lookout left a comment

APPROVED — exact head 536c8b8bde.

Reviewed the complete four-file diff for rt#787. The registration census now explicitly covers all registered commands, including the three hidden workflow verbs; visibility is metadata on each census entry, and newRegisteredCmd applies that metadata while selecting the real constructor. The C5 check keeps the adopter-facing subset explicit, and the test now checks registration, uniqueness, and advertised-vs-hidden visibility rather than relying on a hand-written total. The AC fixture-log precreation is a safe race fix for the polling step.

Independent checks on this head: go test -count=1 ./...; go vet ./...; go build; Bats 99/99; hidden build-bake, bake-digest, and post-cut commands resolve to their real help/argument behavior while remaining absent from rt --help; fragment-check PASS; register-check 0; git diff --check PASS; all 21 latest status contexts success. Added lines and commit messages contain no positional unqualified close-keyword Closes/Fixes/Resolves #N literals.

APPROVED — exact head 536c8b8bde8681391fa45ebfa10a8a00dcea0dda. Reviewed the complete four-file diff for rt#787. The registration census now explicitly covers all registered commands, including the three hidden workflow verbs; visibility is metadata on each census entry, and `newRegisteredCmd` applies that metadata while selecting the real constructor. The C5 check keeps the adopter-facing subset explicit, and the test now checks registration, uniqueness, and advertised-vs-hidden visibility rather than relying on a hand-written total. The AC fixture-log precreation is a safe race fix for the polling step. Independent checks on this head: `go test -count=1 ./...`; `go vet ./...`; `go build`; Bats 99/99; hidden `build-bake`, `bake-digest`, and `post-cut` commands resolve to their real help/argument behavior while remaining absent from `rt --help`; `fragment-check` PASS; `register-check` 0; `git diff --check` PASS; all 21 latest status contexts success. Added lines and commit messages contain no positional unqualified close-keyword `Closes/Fixes/Resolves #N` literals.
pullings deleted branch i/787-cli-registration-census 2026-08-27 00:46:40 +02:00
Sign in to join this conversation.
No description provided.