From a6062c9de715d3f71e5d3d32088d5789ebe9d105 Mon Sep 17 00:00:00 2001 From: "loom-fleet-dispatch[bot]" <313063438+loom-fleet-dispatch[bot]@users.noreply.github.com> Date: Wed, 18 Nov 2026 12:35:39 +0000 Subject: [PATCH 1/2] fix: drop dead unreadable verdict from ratification help and defer row wording The ratification verb exits 3 on any unreadable candidate before scan runs, so verdict=unreadable is never printed. Trim it from --help, make the dead Verdict::Unreadable arm an explicit unreachable! pointing at the gate, and drop the stale 'no hold standing' precondition from the defer row. Co-Authored-By: Claude Sonnet 5.5 --- .../.claude/commands/loom/champion-ratification-hold.md | 2 +- loom-daemon/src/cli/champion_hold_cmd.rs | 7 ++++--- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/defaults/.claude/commands/loom/champion-ratification-hold.md b/defaults/.claude/commands/loom/champion-ratification-hold.md index 88d759e833..6fd00eed7c 100644 --- a/defaults/.claude/commands/loom/champion-ratification-hold.md +++ b/defaults/.claude/commands/loom/champion-ratification-hold.md @@ -66,7 +66,7 @@ The verb folds the state, the detector and the release comment into one | `stands` | re-assert `loom:blocked` + park record, no comment; **stop** | | `release` | post the released marker, remove `loom:blocked`; continue (a later tick sees `none` at this head) | | `clear` | the head no longer declares it: post the cleared marker, remove `loom:blocked` unless another Champion hold stands; continue | -| `defer` | unreadable candidate, no hold standing: do not merge this tick, write nothing; **stop** | +| `defer` | unreadable candidate: do not merge this tick, write nothing (a read-failure tick does not re-assert `loom:blocked` or the park record); **stop** | Exit 3 or no stdout (a failed read) is `defer`; exit 2 (a `loom-daemon` older than the verb) is `none`, since `merge-pr.sh` still refuses a held PR. diff --git a/loom-daemon/src/cli/champion_hold_cmd.rs b/loom-daemon/src/cli/champion_hold_cmd.rs index 7989c0e203..b765e24dee 100644 --- a/loom-daemon/src/cli/champion_hold_cmd.rs +++ b/loom-daemon/src/cli/champion_hold_cmd.rs @@ -57,8 +57,8 @@ pub(crate) enum ChampionHoldCommand { /// Decide the ratification hold's tick for a PR (#12992): reads the head /// contents of every spec/decision file the PR changes and the trusted - /// comments, and prints `LOOM-CHAMPION-RATIFICATION verdict= action= pr= + /// comments, and prints `LOOM-CHAMPION-RATIFICATION verdict= + /// action= pr= /// head= files=`. Exit 3 with no stdout when a read failed. Ratification(TargetArgs), @@ -297,7 +297,8 @@ fn ratification_line(t: &TargetArgs, root: &std::path::Path) -> String { let (name, hit) = match &verdict { Verdict::Clear => ("clear", Vec::new()), Verdict::Hold(h) => ("hold", h.clone()), - Verdict::Unreadable(u) => ("unreadable", u.clone()), + // Gated by `unreadable_candidates` above (exit 3 before `scan` runs). + Verdict::Unreadable(_) => unreachable!("gated by unreadable_candidates above"), }; let listed = if hit.is_empty() { "-".to_string() From 80da09f9b8aeac9076fa1974b3f737fb2948d39c Mon Sep 17 00:00:00 2001 From: Loom Doctor Date: Fri, 20 Nov 2026 07:44:26 +0000 Subject: [PATCH 2/2] docs: fail-closed bullet says unreadable candidate always defers (#14125) Co-Authored-By: Claude Sonnet 5.5 --- defaults/.claude/commands/loom/champion-ratification-hold.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/defaults/.claude/commands/loom/champion-ratification-hold.md b/defaults/.claude/commands/loom/champion-ratification-hold.md index 7d2feae2c1..ad34898247 100644 --- a/defaults/.claude/commands/loom/champion-ratification-hold.md +++ b/defaults/.claude/commands/loom/champion-ratification-hold.md @@ -40,8 +40,8 @@ Rationale: `.loom/docs/ratification-hold.md`. ratification re-arms the hold, because the text the operator released may not be the text now on the PR. - Fail closed: a candidate file whose head content cannot be read is never - `clear`. With no hold standing the tick defers (no merge, no marker); with one - standing it stays. + `clear`. The tick defers (no merge, no marker, no writes) whether or not a + hold is standing — the verb exits 3 before `decide` runs. A held PR that goes CONFLICTING is served by Doctor, hold intact (#13505): Doctor resolves and pushes, leaves `loom:blocked` and `loom:pr` on, and Judge re-reviews the new head; the operator then ratifies a clean head.