From 49c541cefe5f792bb4f798f92e50766197f50ba7 Mon Sep 17 00:00:00 2001 From: Kishore Kumar Date: Fri, 5 Jun 2026 19:16:52 +0530 Subject: [PATCH] docs(dispatch): correct ufs mode claim + spec audit filename refs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- dispatch/write_any.sh | 6 +++--- dispatch/write_spec.md | 11 +++++------ 2 files changed, 8 insertions(+), 9 deletions(-) diff --git a/dispatch/write_any.sh b/dispatch/write_any.sh index a8c48cc..b1da97c 100755 --- a/dispatch/write_any.sh +++ b/dispatch/write_any.sh @@ -14,8 +14,8 @@ # Exit: 0 = mechanical gates pass · 1 = ≥1 failed · 2 = usage error. # # Leaf modes are verified against each script's own arg-parser (lib.sh warns the -# contracts are NON-UNIFORM): ufs.sh takes --all only (--staged retired M70); -# logging.sh / error-codes.sh / msid-ui.sh all accept --staged. +# contracts are NON-UNIFORM): ufs.sh accepts --all + --staged (--diff retired +# M70); logging.sh / error-codes.sh / msid-ui.sh all accept --staged. # The fn≤50/method≤70 sub-cap (write_any.md, file-length card) is a TODO-CHECK: # dispatch_length_gate enforces only the file cap; no fn/method leaf is wired yet. @@ -27,7 +27,7 @@ dispatch_header # ── deterministic gates ──────────────────────────────────────────── dispatch_length_gate 350 # FLL — file cap (fn/method 50/70 = TODO-CHECK) -dispatch_run_helper "UFS" "ufs.sh" "--all" +dispatch_run_helper "UFS" "ufs.sh" "--all" # full-tree on purpose: the per-edit lens must not be blind to an unstaged edit dispatch_run_helper "LOG" "logging.sh" "--staged" dispatch_run_helper "MSID" "msid-ui.sh" "--staged" diff --git a/dispatch/write_spec.md b/dispatch/write_spec.md index 392b0ea..b4a8858 100644 --- a/dispatch/write_spec.md +++ b/dispatch/write_spec.md @@ -2,13 +2,12 @@ This is the prose the AGENT reads **before writing or editing a spec** under `docs/v*/{pending,active,done}/`. It pairs with the deterministic half -`audits/spec.sh` (named `audits/spec-template.sh` until the Stage-2 rename), -which runs in `make lint`. (This is the former Spec Template gate absorbed into +`audits/spec-template.sh`, which runs in `make lint`. (This is the former Spec Template gate absorbed into the dispatch model — `docs/TEMPLATE.md` remains the canonical section source.) **Signal legend:** -- 🟢 / 🔴 — `audits/spec.sh` mechanically passes/fails the prohibited-pattern and +- 🟢 / 🔴 — `audits/spec-template.sh` mechanically passes/fails the prohibited-pattern and required-section checks. - 🔵 DECIDE — whether a required section is *meaningfully filled* (not just present) is the agent's judgment at author time. @@ -70,11 +69,11 @@ SPEC TEMPLATE GATE: | prohibited:<0|list> required-sections: