@ai-dev-methodologies/rlp-desk 0.11.0 → 0.12.0

package/docs/superpowers/plans/2026-04-24-gpt-5-5-default.md

@@ -1,517 +0,0 @@
-# Default Codex Model Migration (gpt-5.4 → gpt-5.5) Implementation Plan
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
-
-**Goal:** Migrate rlp-desk's default Codex model references and env-var defaults from `gpt-5.4` to `gpt-5.5` across 6 source files, without adding remap logic or altering reasoning-effort tiers. Ship as v0.10.0.
-
-**Architecture:** Purely textual replacement in configuration sites (shell defaults, Node defaults, upgrade-chain keys, doc examples, upgrade-table markdown) plus a `version` bump. No runtime logic is added. User-supplied model strings are unchanged — Codex CLI already accepts any passthrough name.
-
-**Tech Stack:** zsh, Node.js (ESM), markdown, npm (package.json). No new dependencies.
-
-**Branch:** `feature/gpt-5-5-default` (already created at plan time).
-
-**Spec:** `docs/superpowers/specs/2026-04-24-gpt-5-5-default.md`.
-
----
-
-## File Map
-
-| File | Role after this plan |
-|---|---|
-| `src/scripts/run_ralph_desk.zsh` | Shell entrypoint. Env var defaults now quote `gpt-5.5` in four places and in two CLI fallback sites. |
-| `src/node/run.mjs` | Node CLI defaults. `consensusModel` and `finalConsensusModel` default to `gpt-5.5:medium` / `gpt-5.5:high`. |
-| `src/node/runner/campaign-main-loop.mjs` | Upgrade chain keys use `gpt-5.5` namespace. Claude-engine and spark rows unchanged. |
-| `src/model-upgrade-table.md` | "Non-Pro" section retitled to `gpt-5.5`; table cells use `gpt-5.5:*`. |
-| `src/commands/rlp-desk.md` | Recommendation table, worker-model guidance, batch warnings, examples, and help text reference `gpt-5.5`. |
-| `package.json` | `version` bumped from `0.9.3` to `0.10.0`. |
-| `docs/superpowers/specs/2026-04-24-gpt-5-5-default.md` | Already written; intentionally contains `gpt-5.4` as historical context. Excluded from regression sweep. |
-
-Self-verification gate (per `CLAUDE.md`) is a required workflow step before commit; it does not produce tracked files but is captured as Task 8.
-
----
-
-## Task 1: Update shell defaults in `run_ralph_desk.zsh`
-
-**Files:**
-- Modify: `src/scripts/run_ralph_desk.zsh:33,35,104,106,114-115,2762,2766`
-
-- [ ] **Step 1: Replace comment defaults on lines 33 and 35**
-
-Before (lines 33 and 35):
-
-```zsh
-#   WORKER_CODEX_MODEL            - codex model for Worker (default: gpt-5.4)
-...
-#   VERIFIER_CODEX_MODEL          - codex model for Verifier (default: gpt-5.4)
-```
-
-After:
-
-```zsh
-#   WORKER_CODEX_MODEL            - codex model for Worker (default: gpt-5.5)
-...
-#   VERIFIER_CODEX_MODEL          - codex model for Verifier (default: gpt-5.5)
-```
-
-Edit via the Edit tool, matching the full line so the change is unambiguous.
-
-- [ ] **Step 2: Replace env var defaults on lines 104 and 106**
-
-Before:
-
-```zsh
-WORKER_CODEX_MODEL="${WORKER_CODEX_MODEL:-gpt-5.4}"
-WORKER_CODEX_REASONING="${WORKER_CODEX_REASONING:-high}"   # low|medium|high
-VERIFIER_CODEX_MODEL="${VERIFIER_CODEX_MODEL:-gpt-5.4}"
-```
-
-After:
-
-```zsh
-WORKER_CODEX_MODEL="${WORKER_CODEX_MODEL:-gpt-5.5}"
-WORKER_CODEX_REASONING="${WORKER_CODEX_REASONING:-high}"   # low|medium|high
-VERIFIER_CODEX_MODEL="${VERIFIER_CODEX_MODEL:-gpt-5.5}"
-```
-
-- [ ] **Step 3: Replace consensus defaults on lines 114 and 115**
-
-Before:
-
-```zsh
-CONSENSUS_MODEL="${CONSENSUS_MODEL:-gpt-5.4:medium}"       # per-US cross-verifier (lighter)
-FINAL_CONSENSUS_MODEL="${FINAL_CONSENSUS_MODEL:-gpt-5.4:high}"  # final cross-verifier (stricter)
-```
-
-After:
-
-```zsh
-CONSENSUS_MODEL="${CONSENSUS_MODEL:-gpt-5.5:medium}"       # per-US cross-verifier (lighter)
-FINAL_CONSENSUS_MODEL="${FINAL_CONSENSUS_MODEL:-gpt-5.5:high}"  # final cross-verifier (stricter)
-```
-
-- [ ] **Step 4: Replace CLI fallback defaults on lines 2762 and 2766**
-
-Before:
-
-```zsh
-    --consensus-model)
-      (( _cli_i++ ))
-      CONSENSUS_MODEL="${@[$_cli_i]:-gpt-5.4:medium}"
-      ;;
-    --final-consensus-model)
-      (( _cli_i++ ))
-      FINAL_CONSENSUS_MODEL="${@[$_cli_i]:-gpt-5.4:high}"
-      ;;
-```
-
-After:
-
-```zsh
-    --consensus-model)
-      (( _cli_i++ ))
-      CONSENSUS_MODEL="${@[$_cli_i]:-gpt-5.5:medium}"
-      ;;
-    --final-consensus-model)
-      (( _cli_i++ ))
-      FINAL_CONSENSUS_MODEL="${@[$_cli_i]:-gpt-5.5:high}"
-      ;;
-```
-
-- [ ] **Step 5: Verify zero residual `gpt-5.4` in file**
-
-Run:
-
-```bash
-grep -n "gpt-5\.4" src/scripts/run_ralph_desk.zsh
-```
-
-Expected: no output. Any hit means the previous steps missed a line.
-
-- [ ] **Step 6: Shell syntax sanity check**
-
-Run:
-
-```bash
-zsh -n src/scripts/run_ralph_desk.zsh
-```
-
-Expected: no output (exit 0). Parse errors would be shown to stderr.
-
----
-
-## Task 2: Update Node defaults in `run.mjs`
-
-**Files:**
-- Modify: `src/node/run.mjs:14-15`
-
-- [ ] **Step 1: Replace default model strings in `RUN_DEFAULTS`**
-
-Before (lines 14-15):
-
-```js
-  consensusModel: 'gpt-5.4:medium',
-  finalConsensusModel: 'gpt-5.4:high',
-```
-
-After:
-
-```js
-  consensusModel: 'gpt-5.5:medium',
-  finalConsensusModel: 'gpt-5.5:high',
-```
-
-- [ ] **Step 2: Verify zero residual `gpt-5.4` in file**
-
-Run:
-
-```bash
-grep -n "gpt-5\.4" src/node/run.mjs
-```
-
-Expected: no output.
-
-- [ ] **Step 3: Parse check**
-
-Run:
-
-```bash
-node --check src/node/run.mjs
-```
-
-Expected: no output (exit 0). Syntax errors would print to stderr.
-
----
-
-## Task 3: Update upgrade chain in `campaign-main-loop.mjs`
-
-**Files:**
-- Modify: `src/node/runner/campaign-main-loop.mjs:29-31`
-
-- [ ] **Step 1: Replace the non-spark rows of `MODEL_UPGRADES`**
-
-Before (lines 28-35):
-
-```js
-const MODEL_UPGRADES = {
-  'gpt-5.4:medium': 'gpt-5.4:high',
-  'gpt-5.4:high': 'gpt-5.4:xhigh',
-  'gpt-5.4:xhigh': 'BLOCKED',
-  'gpt-5.3-codex-spark:medium': 'gpt-5.3-codex-spark:high',
-  'gpt-5.3-codex-spark:high': 'gpt-5.3-codex-spark:xhigh',
-  'gpt-5.3-codex-spark:xhigh': 'BLOCKED',
-};
-```
-
-After:
-
-```js
-const MODEL_UPGRADES = {
-  'gpt-5.5:medium': 'gpt-5.5:high',
-  'gpt-5.5:high': 'gpt-5.5:xhigh',
-  'gpt-5.5:xhigh': 'BLOCKED',
-  'gpt-5.3-codex-spark:medium': 'gpt-5.3-codex-spark:high',
-  'gpt-5.3-codex-spark:high': 'gpt-5.3-codex-spark:xhigh',
-  'gpt-5.3-codex-spark:xhigh': 'BLOCKED',
-};
-```
-
-- [ ] **Step 2: Verify zero residual `gpt-5.4` in file**
-
-Run:
-
-```bash
-grep -n "gpt-5\.4" src/node/runner/campaign-main-loop.mjs
-```
-
-Expected: no output.
-
-- [ ] **Step 3: Parse check**
-
-Run:
-
-```bash
-node --check src/node/runner/campaign-main-loop.mjs
-```
-
-Expected: no output.
-
----
-
-## Task 4: Update upgrade table in `model-upgrade-table.md`
-
-**Files:**
-- Modify: `src/model-upgrade-table.md:21-28`
-
-- [ ] **Step 1: Rename the Non-Pro section and rewrite the table body**
-
-Before (lines 21-28):
-
-```markdown
-## Non-Pro (gpt-5.4)
-
-| Complexity | 1-2 | 3-4 | 5-6 | 7+ |
-|------------|-----|-----|-----|-----|
-| LOW | gpt-5.4:low | gpt-5.4:medium | gpt-5.4:high | BLOCKED |
-| MEDIUM | gpt-5.4:medium | gpt-5.4:high | gpt-5.4:xhigh | BLOCKED |
-| HIGH | gpt-5.4:high | gpt-5.4:xhigh | gpt-5.4:xhigh | BLOCKED |
-| CRITICAL | gpt-5.4:xhigh | gpt-5.4:xhigh | gpt-5.4:xhigh | BLOCKED |
-```
-
-After:
-
-```markdown
-## Non-Pro (gpt-5.5)
-
-| Complexity | 1-2 | 3-4 | 5-6 | 7+ |
-|------------|-----|-----|-----|-----|
-| LOW | gpt-5.5:low | gpt-5.5:medium | gpt-5.5:high | BLOCKED |
-| MEDIUM | gpt-5.5:medium | gpt-5.5:high | gpt-5.5:xhigh | BLOCKED |
-| HIGH | gpt-5.5:high | gpt-5.5:xhigh | gpt-5.5:xhigh | BLOCKED |
-| CRITICAL | gpt-5.5:xhigh | gpt-5.5:xhigh | gpt-5.5:xhigh | BLOCKED |
-```
-
-The GPT Pro and Claude-only sections remain unchanged.
-
-- [ ] **Step 2: Verify zero residual `gpt-5.4` in file**
-
-Run:
-
-```bash
-grep -n "gpt-5\.4" src/model-upgrade-table.md
-```
-
-Expected: no output.
-
----
-
-## Task 5: Update user-facing documentation in `rlp-desk.md`
-
-**Files:**
-- Modify: `src/commands/rlp-desk.md` (14 known occurrences across ~6 blocks: lines 78-81, 84, 94-95, 167, 173, 180, 185-186, 243, 251-252, 295-296, 476-477, 735, 740-741)
-
-Because the same token (`gpt-5.4`) appears with both `:medium` and `:high` suffixes in a tabular document, use a global replace rather than editing each occurrence individually.
-
-- [ ] **Step 1: Perform global replace of `gpt-5.4` → `gpt-5.5`**
-
-Use the Edit tool with `replace_all: true` on the single token `gpt-5.4`. This is safe because:
-- No reasoning effort label matches `gpt-5.4` as a substring.
-- No URL or external reference in the file uses `gpt-5.4`.
-- The spec file that intentionally mentions `gpt-5.4` lives in `docs/superpowers/specs/`, not `src/commands/`.
-
-Edit parameters:
-
-```
-old_string: "gpt-5.4"
-new_string: "gpt-5.5"
-replace_all: true
-```
-
-- [ ] **Step 2: Verify zero residual `gpt-5.4` in file**
-
-Run:
-
-```bash
-grep -n "gpt-5\.4" src/commands/rlp-desk.md
-```
-
-Expected: no output.
-
-- [ ] **Step 3: Spot-check a few critical lines**
-
-Run:
-
-```bash
-grep -n "gpt-5\.5" src/commands/rlp-desk.md | head -20
-```
-
-Expected: at least 14 lines referencing `gpt-5.5`, including the recommendation table body (two rows with `gpt-5.5:medium`, two with `gpt-5.5:high`), the worker model selection bullet, batch warnings, env var echo lines, example commands, and the help text.
-
----
-
-## Task 6: Bump version to 0.10.0
-
-**Files:**
-- Modify: `package.json:3`
-
-- [ ] **Step 1: Edit the `version` field**
-
-Before:
-
-```json
-  "version": "0.9.3",
-```
-
-After:
-
-```json
-  "version": "0.10.0",
-```
-
-- [ ] **Step 2: Verify package.json is still valid JSON**
-
-Run:
-
-```bash
-node -e 'const pkg = require("./package.json"); console.log(pkg.version)'
-```
-
-Expected stdout: `0.10.0`.
-
----
-
-## Task 7: Repo-wide regression sweep
-
-**Files:** none modified in this task — it is a verification gate.
-
-- [ ] **Step 1: Confirm zero `gpt-5.4` hits under `src/`**
-
-Run:
-
-```bash
-grep -rn "gpt-5\.4" src/
-```
-
-Expected: no output.
-
-- [ ] **Step 2: Confirm zero `gpt-5.4` hits under `docs/` except the spec file**
-
-Run:
-
-```bash
-grep -rn "gpt-5\.4" docs/ --exclude-dir=specs
-```
-
-Expected: no output.
-
-And:
-
-```bash
-grep -rln "gpt-5\.4" docs/superpowers/specs/
-```
-
-Expected: exactly one file — `docs/superpowers/specs/2026-04-24-gpt-5-5-default.md`.
-
-- [ ] **Step 3: Confirm `gpt-5.5` references now exist**
-
-Run:
-
-```bash
-grep -rc "gpt-5\.5" src/ | grep -v ':0$'
-```
-
-Expected: at least 5 files each with a non-zero count, covering `run_ralph_desk.zsh`, `run.mjs`, `campaign-main-loop.mjs`, `model-upgrade-table.md`, and `commands/rlp-desk.md`.
-
-If any step here fails, stop and repair the offending file before continuing. Do not proceed to Task 8 until the sweep is clean.
-
----
-
-## Task 8: Self-verification gate (CLAUDE.md §Self-Verification Gate)
-
-**Files:** none modified directly. This task produces three verifier verdict records that must all PASS before Task 9.
-
-This task is mandatory because Tasks 1 and 5 modified `src/scripts/run_ralph_desk.zsh` and `src/commands/rlp-desk.md`. Per `CLAUDE.md`, all three scenarios must run with real Worker (`execution_steps`) → Verifier (5 categories with `reasoning`) → PASS. Any FAIL blocks commit; fix and re-run all three.
-
-- [ ] **Step 1: Scenario LOW — default env propagation (L1+L3)**
-
-Describe:
-- **Worker task:** From the repo root, source `src/scripts/run_ralph_desk.zsh` (or simulate by evaluating only the env-var default block, lines 104-115 and 2760-2768) and print `WORKER_CODEX_MODEL`, `VERIFIER_CODEX_MODEL`, `CONSENSUS_MODEL`, `FINAL_CONSENSUS_MODEL`. Execution steps must include the exact commands run and their stdout.
-- **Verifier categories:** (1) Correctness — all four variables equal the expected `gpt-5.5*` strings. (2) Completeness — no variable is empty or inherits an unexpected default. (3) Regression — the script still parses under `zsh -n`. (4) Docs alignment — the printed value matches what `rlp-desk.md` now documents. (5) Reasoning — one paragraph explaining why the result is convincing.
-- **PASS criteria:** All four variables equal `gpt-5.5`, `gpt-5.5`, `gpt-5.5:medium`, `gpt-5.5:high` respectively, with zsh parse success.
-
-- [ ] **Step 2: Scenario MEDIUM — explicit override passthrough (L1+L2+L3)**
-
-Describe:
-- **Worker task:** Invoke the shell with `CONSENSUS_MODEL=gpt-5.4:high` exported before sourcing, then print the resulting `CONSENSUS_MODEL`. Also invoke with an unknown model string such as `CONSENSUS_MODEL=foo-model:custom` and print the result. Execution steps must include both runs and their stdout.
-- **Verifier categories:** (1) Correctness — both overrides are preserved byte-for-byte. (2) Completeness — no remap or warning is emitted to stderr. (3) Integration — the downstream variables that reference `CONSENSUS_MODEL` (e.g., when building consensus prompts) carry the override. (4) Docs alignment — `rlp-desk.md` describes `--consensus-model` as passthrough with a documented default. (5) Reasoning — justify why passthrough is the intended contract.
-- **PASS criteria:** `gpt-5.4:high` and `foo-model:custom` appear unchanged; stderr is silent about remapping.
-
-- [ ] **Step 3: Scenario CRITICAL — upgrade chain + security check (L1+L2+L3 + security)**
-
-Describe:
-- **Worker task:** In a Node one-off, import the `MODEL_UPGRADES` table from `src/node/runner/campaign-main-loop.mjs` (or inline-copy if import surface is not exposed) and assert the chain `gpt-5.5:medium → gpt-5.5:high → gpt-5.5:xhigh → BLOCKED`. Then verify the spark chain is untouched. Execution steps must include the exact Node invocation and output.
-- **Verifier categories:** (1) Correctness — the four assertions hold. (2) Completeness — no extra keys were introduced; legacy `gpt-5.4:*` keys are gone; spark keys remain exact. (3) Error-path — hitting `BLOCKED` is the terminal state; no silent key lookup fallback. (4) Security — confirm no shell expansion, template injection, or model-string concatenation was added to the hot path by this change set (spot-check `campaign-main-loop.mjs` diff). (5) Reasoning — one paragraph.
-- **PASS criteria:** All four assertions pass; spark chain intact; security spot-check clean.
-
-- [ ] **Step 4: Gate decision**
-
-If any scenario FAIL:
-- Fix the underlying code (not the test).
-- Re-run the failing scenario first; then re-run all three for clean slate.
-- Do not proceed to Task 9.
-
-If all three PASS, record the verdicts (even informally in the plan checkbox list) and move on.
-
----
-
-## Task 9: Local file sync verification (CLAUDE.md §Local File Sync)
-
-**Files:** none modified; this is a sync-and-verify gate executed after commit approval.
-
-Per `CLAUDE.md`, after every commit that changes any `src/` file, sync ALL distributable files to `~/.claude/` and verify with `diff -q`.
-
-This task is listed for completeness but is executed AFTER user approval of the commit, which is outside the plan's automated scope.
-
-- [ ] **Step 1: Confirm sync list is current**
-
-Re-read the Local File Sync section of `CLAUDE.md` and confirm the list of files covers: `src/commands/rlp-desk.md`, `src/governance.md`, `src/model-upgrade-table.md`, `src/scripts/init_ralph_desk.zsh`, `src/scripts/run_ralph_desk.zsh`, `src/scripts/lib_ralph_desk.zsh`, `README.md`, `install.sh`, `docs/architecture.md`, `docs/getting-started.md`, `docs/protocol-reference.md`, `docs/TODO-verification-next.md`, `docs/internal/*`, `docs/blueprints/*`.
-
-- [ ] **Step 2: Sync all runtime files**
-
-Run:
-
-```bash
-cp src/commands/rlp-desk.md ~/.claude/commands/rlp-desk.md
-cp src/governance.md ~/.claude/ralph-desk/governance.md
-cp src/model-upgrade-table.md ~/.claude/ralph-desk/model-upgrade-table.md
-cp src/scripts/init_ralph_desk.zsh ~/.claude/ralph-desk/init_ralph_desk.zsh
-cp src/scripts/run_ralph_desk.zsh ~/.claude/ralph-desk/run_ralph_desk.zsh
-cp src/scripts/lib_ralph_desk.zsh ~/.claude/ralph-desk/lib_ralph_desk.zsh
-```
-
-- [ ] **Step 3: Sync reference docs**
-
-Run:
-
-```bash
-cp README.md ~/.claude/ralph-desk/README.md
-cp install.sh ~/.claude/ralph-desk/install.sh
-cp docs/architecture.md ~/.claude/ralph-desk/docs/architecture.md
-cp docs/getting-started.md ~/.claude/ralph-desk/docs/getting-started.md
-cp docs/protocol-reference.md ~/.claude/ralph-desk/docs/protocol-reference.md
-cp docs/TODO-verification-next.md ~/.claude/ralph-desk/docs/TODO-verification-next.md
-cp -r docs/internal/. ~/.claude/ralph-desk/docs/internal/
-cp -r docs/blueprints/. ~/.claude/ralph-desk/docs/blueprints/
-```
-
-- [ ] **Step 4: Verify each runtime file is byte-identical**
-
-Run:
-
-```bash
-diff -q src/commands/rlp-desk.md ~/.claude/commands/rlp-desk.md
-diff -q src/governance.md ~/.claude/ralph-desk/governance.md
-diff -q src/model-upgrade-table.md ~/.claude/ralph-desk/model-upgrade-table.md
-diff -q src/scripts/init_ralph_desk.zsh ~/.claude/ralph-desk/init_ralph_desk.zsh
-diff -q src/scripts/run_ralph_desk.zsh ~/.claude/ralph-desk/run_ralph_desk.zsh
-diff -q src/scripts/lib_ralph_desk.zsh ~/.claude/ralph-desk/lib_ralph_desk.zsh
-diff -q README.md ~/.claude/ralph-desk/README.md
-```
-
-Expected: no output from any of the seven `diff -q` commands. Any line of output means sync failed and must be repeated.
-
----
-
-## Release workflow (outside plan automation, user approval gated)
-
-After Task 9 succeeds, the following release steps happen with explicit user approval at each stage, per `CLAUDE.md`:
-
-1. `ralplan` + `codex review` both reach zero issues.
-2. `git commit` with user-approved message.
-3. `git push -u origin feature/gpt-5-5-default`.
-4. Open PR, merge to `main` after approvals.
-5. `npm version` is already set to `0.10.0` inside `package.json` by Task 6; skip the implicit tag bump and commit the bump directly.
-6. `gh release create v0.10.0` with release notes limited to user-facing changes (see spec §Release notes draft).
-7. `npm publish`.
-8. Re-run Task 9 sync verification against the released tarball layout.
-
-Each step above is documented here as a reminder, not as an automated step. The engineer executing this plan must stop at Task 9 and request user approval before continuing.

package/docs/superpowers/specs/2026-04-24-gpt-5-5-default.md

@@ -1,107 +0,0 @@
-# Spec: Default Codex Model Migration gpt-5.4 → gpt-5.5
-
-**Date:** 2026-04-24
-**Version target:** 0.10.0 (minor bump)
-**Branch:** `feature/gpt-5-5-default`
-
-## Background
-
-Codex CLI 0.124.0 now ships with `gpt-5.5` as the default model in `~/.codex/config.toml` (replacing `gpt-5.4`). The user's reasoning effort default is `high`. rlp-desk's documented defaults, example commands, and upgrade tables still reference `gpt-5.4`, which creates drift between what users see in rlp-desk and what their Codex CLI actually runs.
-
-This spec migrates every rlp-desk default, example, and upgrade chain entry from `gpt-5.4` to `gpt-5.5`. User-supplied model flags are untouched — Codex CLI accepts any model name passthrough, so users who explicitly request `gpt-5.4:high` (or any other version) continue to work without rlp-desk interference.
-
-## Decisions
-
-| # | Decision | Rationale |
-|---|---|---|
-| D1 | Full replacement (`gpt-5.4` → `gpt-5.5` everywhere) | Codex CLI default changed; rlp-desk must mirror current reality. |
-| D2 | No auto-remap, no deprecation warning | User-supplied model names are passed through to Codex CLI as-is. rlp-desk is not a policy layer on model selection. |
-| D3 | Reasoning effort tiers (`low`/`medium`/`high`/`xhigh`) unchanged | Progressive upgrade philosophy preserved. Model name only. |
-| D4 | Minor bump 0.9.3 → 0.10.0 | Default behavior changes; semver-compliant. |
-
-## Scope
-
-### Files with `gpt-5.4` references (in-scope)
-
-| File | Change | Lines |
-|---|---|---|
-| `src/scripts/run_ralph_desk.zsh` | Default env values | 33, 35, 104, 106, 114-115, 2762, 2766 |
-| `src/node/run.mjs` | `consensusModel` / `finalConsensusModel` defaults | 14-15 |
-| `src/node/runner/campaign-main-loop.mjs` | Upgrade chain keys | 29-31 |
-| `src/model-upgrade-table.md` | Section header + full table | 21-28 |
-| `src/commands/rlp-desk.md` | Recommendation table, examples, help text | ~14 occurrences |
-| `package.json` | `version` field | — |
-
-### Out of scope (no changes)
-
-- `src/node/cli/command-builder.mjs` — no remap logic added.
-- `src/scripts/lib_ralph_desk.zsh` `parse_model_flag()` — accepts any model name as before.
-- `gpt-5.3-codex-spark` (GPT Pro) section in `model-upgrade-table.md` — distinct token limit, tracked separately.
-- Reasoning effort tier labels and progressive upgrade chain logic.
-- CLI flag names (`--worker-model`, `--consensus-model`, `--final-consensus-model`).
-
-## Release workflow
-
-Per `CLAUDE.md` gate rules (absolute):
-
-1. All source edits on `feature/gpt-5-5-default` branch.
-2. Self-verification gate triggered by changes to `src/commands/rlp-desk.md` and `src/scripts/run_ralph_desk.zsh`:
-   - LOW scenario: L1+L3
-   - MEDIUM scenario: L1+L2+L3
-   - CRITICAL scenario: L1+L2+L3 + security check
-   - All three must PASS before commit.
-3. `ralplan` + `codex review` must both reach 0 issues before merge.
-4. User approval for each: commit, version bump, merge, release, publish, local file sync.
-5. Local file sync of all 5 runtime files + reference docs per CLAUDE.md.
-6. Release notes: user-facing only (per `feedback_release_notes_scope.md`).
-
-## Release notes draft
-
-```
-### Changed
-- Default Codex model upgraded from `gpt-5.4` to `gpt-5.5` to match Codex CLI 0.124.0 defaults.
-- `WORKER_CODEX_MODEL`, `VERIFIER_CODEX_MODEL`, `CONSENSUS_MODEL`, `FINAL_CONSENSUS_MODEL` env defaults updated.
-- Upgrade chain in `model-upgrade-table.md` now references `gpt-5.5`.
-- Example commands in `/rlp-desk` recommendation table updated.
-
-### Unchanged
-- Users may still pass `--worker-model gpt-5.4:high` or any other model name explicitly; rlp-desk passes model flags through to Codex CLI without modification.
-- Reasoning effort tiers and progressive upgrade logic unchanged.
-- GPT Pro (`gpt-5.3-codex-spark`) path unchanged.
-```
-
-## Test plan
-
-### Self-verification scenarios (per CLAUDE.md §Self-Verification Gate)
-
-1. **LOW — default env value propagation.** Run `/rlp-desk run <slug>` with no model flags; confirm `WORKER_CODEX_MODEL=gpt-5.5` and `CONSENSUS_MODEL=gpt-5.5:medium` appear in the spawned command line.
-2. **MEDIUM — explicit override.** Run `/rlp-desk run <slug> --worker-model gpt-5.4:high`; confirm `gpt-5.4:high` is passed through unchanged to Codex CLI.
-3. **CRITICAL — upgrade chain.** Simulate a Worker failure; confirm the upgrade chain `gpt-5.5:medium → gpt-5.5:high → gpt-5.5:xhigh → BLOCKED` is followed.
-
-Each scenario: Worker (with `execution_steps`) → Verifier (5 categories, with `reasoning`) → PASS. Any FAIL blocks commit.
-
-### Regression sweep
-
-```bash
-grep -rn "gpt-5\.4" src/
-# Expected: zero hits.
-
-grep -rn "gpt-5\.4" docs/ --exclude-dir=superpowers/specs
-# Expected: zero hits. (This spec lives under superpowers/specs/ and intentionally mentions gpt-5.4.)
-```
-
-## Known follow-up (out of scope for v0.10.0)
-
-`tests/test_us004_self_verification.sh` has 4 pre-existing failures (PASS=42, FAIL=4) that surfaced during the post-migration full-suite sweep:
-- `AC4-boundary` / `AC13-happy`: `init_ralph_desk.zsh` lacks "no PRD found — treating as first-run" fallback language.
-- `AC13-boundary`: no note printed when `--mode` is provided but no PRD exists.
-- `AC13-runtime-happy`: `--mode improve` against a directory without a PRD does not exit 0 + print note + create a fresh PRD from template.
-
-Verified pre-existing via `git stash` baseline against pre-migration HEAD. These failures represent an unimplemented feature in `init_ralph_desk.zsh` (PRD template scaffolding for the no-PRD path), not a regression introduced by this migration. They will be tracked in a separate spec/PR (`init-no-prd-fallback`) targeting v0.10.1 or v0.11.0.
-
-## Rollback
-
-If a regression surfaces post-release:
-- Revert the `feature/gpt-5-5-default` merge commit.
-- Publish `0.10.1` with restored `gpt-5.4` defaults.
-- Users can always override via `--worker-model gpt-5.5:high` while rollback is in flight.