docs(dispatch): correct ufs mode claim + spec audit filename refs#21
Merged
Conversation
PR #20 added --staged to ufs.sh, invalidating write_any.sh's comment ("ufs.sh takes --all only (--staged retired M70)"). Correct it: ufs.sh accepts --all + --staged; --diff (not --staged) was retired in M70. Add an inline note that the UFS leaf uses --all on purpose — the per-edit lens must not be blind to an unstaged edit. write_spec.md referenced a deterministic half `audits/spec.sh` "until the Stage-2 rename" that never landed — the file is `audits/spec-template.sh`. Repoint all 5 refs to the real filename, drop the forward-ref. Comment/prose only — no rule, gate, or behavior change. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Two doc-accuracy fixes in the dispatch façades — the touch-it-fix-it tail of PR #20, plus a pre-existing forward-ref.
dispatch/write_any.shPR #20 added
--stagedtoufs.sh, which invalidated this file's comment:Corrected to:
ufs.sh accepts --all + --staged (--diff retired M70)—--diff, not--staged, was the mode M70 retired. Added an inline note on the UFS leaf call that--allis deliberate:write_any.shis the per-edit lens, and--stagedwould be blind to an unstaged edit. No behavior change — the call still runsufs.sh --all.dispatch/write_spec.mdReferenced a deterministic half
audits/spec.sh"namedaudits/spec-template.shuntil the Stage-2 rename" — a rename that never landed. The file isaudits/spec-template.sh. Repointed all 5 refs to the real filename and dropped the forward-ref. This also aligns the doc with the invariance questionnaire (Q4.19 already saysspec-template.sh).Scope
Comment/prose only — no rule, gate, lifecycle, override, or behavior change.
Verification
make auditRC=0 — ALL CHECKS PASSED · dispatch coverage clean · evals 10/10write_any.sh:bash -nclean · shellcheck clean · 48 lines.agents-invariance-signoffwritten against HEAD.🤖 Generated with Claude Code