From 19f421cd23b0af76ee218c7165bffd9a012f2d0a Mon Sep 17 00:00:00 2001 From: NagyVikt Date: Mon, 18 May 2026 17:06:05 +0200 Subject: [PATCH] docs(protocol): mark 20 shipped improvements with PR refs (state-drift sweep) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Audited docs/future/PROTOCOL.md against the actual repo + git history and flipped 20 stale `state: PROPOSED` lines to `state: SHIPPED` for items whose implementation has clearly landed on main. Each item's acceptance verification command runs green and the touched script/file already implements the proposal. Updates (section → slug → representative PR): - 1.4.1 Formal lifecycle states for every improvement entry → PR #171 (scripts/protocol/{protocol-state,check-states}.sh + state lines) - 7.4.1 --help/--version on stall-watcher.sh → PR #1 - 9.4.1 --help/--version on plan-watcher.sh → PR #46 - 10.4.1 --help/--version on review-queue.sh → PR #37 - 11.4.1 --help/--version on review-pane-scanner.sh → PR #41 - 12.4.1 --help/--version on auto-reviewer.sh → PR #99 - 17.4.1 --help/--version on show-fleet.sh → PR #139 - 18.4.1 --help/--version on token-meter.sh → PR #17 - 19.4.1 --help/--version on warm-pool.sh → PR #1 - 20.4.1 --help/--version on spawn-fleet.sh → PR #1 - 21.4.1 --help/--version on dispatch-plan.sh → PR #133 - 23.4.1 --help/--version on proactive-probe.sh → PR #1 - 24.4.1 --help/--version on claim-trigger.sh → PR #1 - 27.4.1 --help/--version on claude-supervisor.sh → PR #116 - 33.4.1 --help/--version on plan-tree-pin.sh → PR #1 - 36.4.1 --help/--version on supervisor.sh → PR #1 - 37.4.1 --help/--version on patch-codex-prompts.sh → PR #1 - 39.4.1 --help/--version on down.sh → PR #1 - 41.4.1 --help/--version on add-workers.sh → PR #1 - 42.4.1 --help/--version on codex-fleet-2.sh → PR #1 Diff is exactly 20 `- state: PROPOSED` → `- state: SHIPPED` line edits in docs/future/PROTOCOL.md; nothing else touched. Both governance checks still pass: bash scripts/protocol/check-states.sh # exit 0 bash scripts/protocol/protocol-state.sh --summary # SHIPPED: 0 → 20 PR refs live in this commit body / PR description rather than inline in the state line, because both check-states.sh and protocol-state.sh require the state token to be the bare enum value (e.g. `SHIPPED`); any suffix breaks both checks. --- docs/future/PROTOCOL.md | 40 ++++++++++++++++++++-------------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/future/PROTOCOL.md b/docs/future/PROTOCOL.md index 4dc02c2..e3c809a 100644 --- a/docs/future/PROTOCOL.md +++ b/docs/future/PROTOCOL.md @@ -157,7 +157,7 @@ Define how this docs/future protocol itself is reviewed, accepted, and converted #### 1.4.1 Formal lifecycle states for every improvement entry -- state: PROPOSED +- state: SHIPPED - lane: docs lane; no Rust changes **Problem.** Improvements live or die without a tracked state, so readers cannot triage them. @@ -1060,7 +1060,7 @@ Make `stall-watcher.sh` reliable, debuggable, and self-documenting. It triggers #### 7.4.1 Add `--help` and `--version` to stall-watcher.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -1352,7 +1352,7 @@ Make `plan-watcher.sh` reliable, debuggable, and self-documenting. It surfaces p #### 9.4.1 Add `--help` and `--version` to plan-watcher.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -1498,7 +1498,7 @@ Make `review-queue.sh` reliable, debuggable, and self-documenting. It feeds the #### 10.4.1 Add `--help` and `--version` to review-queue.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -1644,7 +1644,7 @@ Make `review-pane-scanner.sh` reliable, debuggable, and self-documenting. It aut #### 11.4.1 Add `--help` and `--version` to review-pane-scanner.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -1790,7 +1790,7 @@ Make `auto-reviewer.sh` reliable, debuggable, and self-documenting. It automates #### 12.4.1 Add `--help` and `--version` to auto-reviewer.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -2520,7 +2520,7 @@ Make `show-fleet.sh` reliable, debuggable, and self-documenting. It prints fleet #### 17.4.1 Add `--help` and `--version` to show-fleet.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -2666,7 +2666,7 @@ Make `token-meter.sh` reliable, debuggable, and self-documenting. It surfaces pe #### 18.4.1 Add `--help` and `--version` to token-meter.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -2812,7 +2812,7 @@ Make `warm-pool.sh` reliable, debuggable, and self-documenting. It keeps a warm #### 19.4.1 Add `--help` and `--version` to warm-pool.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -2958,7 +2958,7 @@ Make `spawn-fleet.sh` reliable, debuggable, and self-documenting. It is the lowe #### 20.4.1 Add `--help` and `--version` to spawn-fleet.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -3104,7 +3104,7 @@ Make `dispatch-plan.sh` reliable, debuggable, and self-documenting. It publishes #### 21.4.1 Add `--help` and `--version` to dispatch-plan.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -3396,7 +3396,7 @@ Make `proactive-probe.sh` reliable, debuggable, and self-documenting. It periodi #### 23.4.1 Add `--help` and `--version` to proactive-probe.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -3542,7 +3542,7 @@ Make `claim-trigger.sh` reliable, debuggable, and self-documenting. It triggers #### 24.4.1 Add `--help` and `--version` to claim-trigger.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -3980,7 +3980,7 @@ Make `claude-supervisor.sh` reliable, debuggable, and self-documenting. It super #### 27.4.1 Add `--help` and `--version` to claude-supervisor.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -4856,7 +4856,7 @@ Make `plan-tree-pin.sh` reliable, debuggable, and self-documenting. It pins a pl #### 33.4.1 Add `--help` and `--version` to plan-tree-pin.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -5294,7 +5294,7 @@ Make `supervisor.sh` reliable, debuggable, and self-documenting. It is the legac #### 36.4.1 Add `--help` and `--version` to supervisor.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -5440,7 +5440,7 @@ Make `patch-codex-prompts.sh` reliable, debuggable, and self-documenting. It pat #### 37.4.1 Add `--help` and `--version` to patch-codex-prompts.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -5732,7 +5732,7 @@ Make `down.sh` reliable, debuggable, and self-documenting. It tears down the fle #### 39.4.1 Add `--help` and `--version` to down.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -6024,7 +6024,7 @@ Make `add-workers.sh` reliable, debuggable, and self-documenting. It adds worker #### 41.4.1 Add `--help` and `--version` to add-workers.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source. @@ -6170,7 +6170,7 @@ Make `codex-fleet-2.sh` reliable, debuggable, and self-documenting. It is an alt #### 42.4.1 Add `--help` and `--version` to codex-fleet-2.sh -- state: PROPOSED +- state: SHIPPED - lane: scripts lane **Problem.** Discoverability is poor; flags are guessed from source.