continuous-improvement 3.9.2 → 3.12.3

package/bin/analyze.sh

@@ -1,161 +1,161 @@
-#!/usr/bin/env bash
-# analyze.sh — Read observations.jsonl, detect patterns, create instinct YAML files
-# Runs via /continuous-improvement command. Uses claude CLI with Haiku for cost-efficient analysis.
-
-set -euo pipefail
-
-INSTINCTS_DIR="${HOME}/.claude/instincts"
-
-# ---------------------------------------------------------------------------
-# Detect project
-# ---------------------------------------------------------------------------
-PROJECT_ROOT=""
-if [[ -n "${CLAUDE_PROJECT_DIR:-}" && -d "${CLAUDE_PROJECT_DIR}" ]]; then
-  PROJECT_ROOT="${CLAUDE_PROJECT_DIR}"
-fi
-if [[ -z "$PROJECT_ROOT" ]]; then
-  PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || true)"
-fi
-if [[ -z "$PROJECT_ROOT" ]]; then
-  PROJECT_ROOT="global"
-fi
-
-# Use shasum on macOS, sha256sum on Linux
-if command -v sha256sum &>/dev/null; then
-  PROJECT_HASH="$(printf '%s' "$PROJECT_ROOT" | sha256sum | cut -c1-12)"
-elif command -v shasum &>/dev/null; then
-  PROJECT_HASH="$(printf '%s' "$PROJECT_ROOT" | shasum -a 256 | cut -c1-12)"
-else
-  # Fallback: use project root basename if no hashing available
-  PROJECT_HASH="$(basename "$PROJECT_ROOT" | tr -cd 'a-zA-Z0-9' | cut -c1-12)"
-fi
-PROJECT_NAME="$(basename "${PROJECT_ROOT%.git}")"
-PROJECT_DIR="${INSTINCTS_DIR}/${PROJECT_HASH}"
-OBS_FILE="${PROJECT_DIR}/observations.jsonl"
-
-# ---------------------------------------------------------------------------
-# Check observations exist
-# ---------------------------------------------------------------------------
-if [[ ! -f "$OBS_FILE" ]] || [[ ! -s "$OBS_FILE" ]]; then
-  echo "No observations found at ${OBS_FILE}"
-  echo "Use Claude Code with hooks installed to generate observations."
-  exit 0
-fi
-
-OBS_COUNT=$(wc -l < "$OBS_FILE")
-echo "Found ${OBS_COUNT} observations in ${OBS_FILE}"
-
-if (( OBS_COUNT < 20 )); then
-  echo "Need at least 20 observations for meaningful analysis. Keep using Claude Code (${OBS_COUNT}/20)."
-  exit 0
-fi
-
-# ---------------------------------------------------------------------------
-# Read existing instincts to avoid duplicates
-# ---------------------------------------------------------------------------
-EXISTING_INSTINCTS=""
-for f in "${PROJECT_DIR}"/*.yaml "${INSTINCTS_DIR}/global"/*.yaml; do
-  [[ -f "$f" ]] && EXISTING_INSTINCTS="${EXISTING_INSTINCTS}$(cat "$f")"$'\n'
-done
-
-# ---------------------------------------------------------------------------
-# Take last 500 observations
-# ---------------------------------------------------------------------------
-RECENT_OBS=$(tail -500 "$OBS_FILE")
-
-# ---------------------------------------------------------------------------
-# Build analysis prompt
-# ---------------------------------------------------------------------------
-ANALYSIS_PROMPT="Analyze these Claude Code session observations and extract behavioral patterns as instinct YAML files.
-
-OBSERVATIONS (JSONL — each line is a tool call):
-${RECENT_OBS}
-
-EXISTING INSTINCTS (already learned — do NOT duplicate these):
-${EXISTING_INSTINCTS}
-
-YOUR TASK:
-1. Look for REPEATED PATTERNS — same tool sequence used 3+ times
-2. Look for ERROR-THEN-FIX sequences — tool fails, next tools fix it
-3. Look for TOOL PREFERENCES — one tool consistently chosen over alternatives
-4. Look for WORKFLOW PATTERNS — consistent ordering of operations
-5. Look for USER CORRECTIONS — user says no/stop/don't after an action
-
-OUTPUT FORMAT — output ONLY new instincts as YAML blocks, separated by ---:
-
-id: descriptive-kebab-case-id
-trigger: \"when [specific situation]\"
-confidence: 0.5
-domain: workflow|tooling|testing|patterns
-source: observation
-scope: project
-project_id: ${PROJECT_HASH}
-created: \"$(date -u +%Y-%m-%d)\"
-last_seen: \"$(date -u +%Y-%m-%d)\"
-observation_count: [number of times pattern was seen]
----
-[One sentence describing the specific actionable behavior]
-
-Rules:
-- Only create instincts for patterns seen 3+ times
-- Start confidence at 0.5 (suggest level)
-- Be specific and actionable (not vague advice)
-- Different from existing instincts listed above
-
-If no new patterns are found, output exactly: NO_NEW_PATTERNS
-
-Output ONLY the YAML blocks or NO_NEW_PATTERNS. No explanation, no preamble."
-
-# ---------------------------------------------------------------------------
-# Run analysis with Haiku
-# ---------------------------------------------------------------------------
-echo "Analyzing patterns with Haiku..."
-RESULT=$(echo "$ANALYSIS_PROMPT" | claude --model haiku --print -p - 2>/dev/null) || {
-  echo "Analysis failed — claude CLI error. Try running manually."
-  exit 1
-}
-
-if [[ "$RESULT" == "NO_NEW_PATTERNS" ]] || [[ -z "$RESULT" ]]; then
-  echo "No new patterns detected yet. Keep using Claude Code — patterns emerge over time."
-  exit 0
-fi
-
-# ---------------------------------------------------------------------------
-# Write instinct YAML files
-# ---------------------------------------------------------------------------
-mkdir -p "$PROJECT_DIR"
-
-NEW_COUNT=0
-INSTINCT_ID=""
-BLOCK=""
-
-while IFS= read -r line; do
-  if [[ "$line" == "---" ]] && [[ -n "$BLOCK" ]]; then
-    if [[ -n "$INSTINCT_ID" ]]; then
-      DEST="${PROJECT_DIR}/${INSTINCT_ID}.yaml"
-      printf '%s\n' "$BLOCK" > "$DEST"
-      echo "  + ${INSTINCT_ID} -> ${DEST}"
-      NEW_COUNT=$((NEW_COUNT + 1))
-    fi
-    INSTINCT_ID=""
-    BLOCK=""
-  else
-    BLOCK="${BLOCK}${line}"$'\n'
-    if [[ "$line" =~ ^id:\ (.+) ]]; then
-      INSTINCT_ID="${BASH_REMATCH[1]}"
-      INSTINCT_ID="${INSTINCT_ID//\"/}"
-      INSTINCT_ID="${INSTINCT_ID//\'/}"
-    fi
-  fi
-done <<< "$RESULT"
-
-# Handle last block
-if [[ -n "$INSTINCT_ID" ]] && [[ -n "$BLOCK" ]]; then
-  DEST="${PROJECT_DIR}/${INSTINCT_ID}.yaml"
-  printf '%s\n' "$BLOCK" > "$DEST"
-  echo "  + ${INSTINCT_ID} -> ${DEST}"
-  NEW_COUNT=$((NEW_COUNT + 1))
-fi
-
-echo ""
-echo "Created ${NEW_COUNT} new instinct(s) in ${PROJECT_DIR}/"
+#!/usr/bin/env bash
+# analyze.sh — Read observations.jsonl, detect patterns, create instinct YAML files
+# Runs via /continuous-improvement command. Uses claude CLI with Haiku for cost-efficient analysis.
+
+set -euo pipefail
+
+INSTINCTS_DIR="${HOME}/.claude/instincts"
+
+# ---------------------------------------------------------------------------
+# Detect project
+# ---------------------------------------------------------------------------
+PROJECT_ROOT=""
+if [[ -n "${CLAUDE_PROJECT_DIR:-}" && -d "${CLAUDE_PROJECT_DIR}" ]]; then
+  PROJECT_ROOT="${CLAUDE_PROJECT_DIR}"
+fi
+if [[ -z "$PROJECT_ROOT" ]]; then
+  PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || true)"
+fi
+if [[ -z "$PROJECT_ROOT" ]]; then
+  PROJECT_ROOT="global"
+fi
+
+# Use shasum on macOS, sha256sum on Linux
+if command -v sha256sum &>/dev/null; then
+  PROJECT_HASH="$(printf '%s' "$PROJECT_ROOT" | sha256sum | cut -c1-12)"
+elif command -v shasum &>/dev/null; then
+  PROJECT_HASH="$(printf '%s' "$PROJECT_ROOT" | shasum -a 256 | cut -c1-12)"
+else
+  # Fallback: use project root basename if no hashing available
+  PROJECT_HASH="$(basename "$PROJECT_ROOT" | tr -cd 'a-zA-Z0-9' | cut -c1-12)"
+fi
+PROJECT_NAME="$(basename "${PROJECT_ROOT%.git}")"
+PROJECT_DIR="${INSTINCTS_DIR}/${PROJECT_HASH}"
+OBS_FILE="${PROJECT_DIR}/observations.jsonl"
+
+# ---------------------------------------------------------------------------
+# Check observations exist
+# ---------------------------------------------------------------------------
+if [[ ! -f "$OBS_FILE" ]] || [[ ! -s "$OBS_FILE" ]]; then
+  echo "No observations found at ${OBS_FILE}"
+  echo "Use Claude Code with hooks installed to generate observations."
+  exit 0
+fi
+
+OBS_COUNT=$(wc -l < "$OBS_FILE")
+echo "Found ${OBS_COUNT} observations in ${OBS_FILE}"
+
+if (( OBS_COUNT < 20 )); then
+  echo "Need at least 20 observations for meaningful analysis. Keep using Claude Code (${OBS_COUNT}/20)."
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Read existing instincts to avoid duplicates
+# ---------------------------------------------------------------------------
+EXISTING_INSTINCTS=""
+for f in "${PROJECT_DIR}"/*.yaml "${INSTINCTS_DIR}/global"/*.yaml; do
+  [[ -f "$f" ]] && EXISTING_INSTINCTS="${EXISTING_INSTINCTS}$(cat "$f")"$'\n'
+done
+
+# ---------------------------------------------------------------------------
+# Take last 500 observations
+# ---------------------------------------------------------------------------
+RECENT_OBS=$(tail -500 "$OBS_FILE")
+
+# ---------------------------------------------------------------------------
+# Build analysis prompt
+# ---------------------------------------------------------------------------
+ANALYSIS_PROMPT="Analyze these Claude Code session observations and extract behavioral patterns as instinct YAML files.
+
+OBSERVATIONS (JSONL — each line is a tool call):
+${RECENT_OBS}
+
+EXISTING INSTINCTS (already learned — do NOT duplicate these):
+${EXISTING_INSTINCTS}
+
+YOUR TASK:
+1. Look for REPEATED PATTERNS — same tool sequence used 3+ times
+2. Look for ERROR-THEN-FIX sequences — tool fails, next tools fix it
+3. Look for TOOL PREFERENCES — one tool consistently chosen over alternatives
+4. Look for WORKFLOW PATTERNS — consistent ordering of operations
+5. Look for USER CORRECTIONS — user says no/stop/don't after an action
+
+OUTPUT FORMAT — output ONLY new instincts as YAML blocks, separated by ---:
+
+id: descriptive-kebab-case-id
+trigger: \"when [specific situation]\"
+confidence: 0.5
+domain: workflow|tooling|testing|patterns
+source: observation
+scope: project
+project_id: ${PROJECT_HASH}
+created: \"$(date -u +%Y-%m-%d)\"
+last_seen: \"$(date -u +%Y-%m-%d)\"
+observation_count: [number of times pattern was seen]
+---
+[One sentence describing the specific actionable behavior]
+
+Rules:
+- Only create instincts for patterns seen 3+ times
+- Start confidence at 0.5 (suggest level)
+- Be specific and actionable (not vague advice)
+- Different from existing instincts listed above
+
+If no new patterns are found, output exactly: NO_NEW_PATTERNS
+
+Output ONLY the YAML blocks or NO_NEW_PATTERNS. No explanation, no preamble."
+
+# ---------------------------------------------------------------------------
+# Run analysis with Haiku
+# ---------------------------------------------------------------------------
+echo "Analyzing patterns with Haiku..."
+RESULT=$(echo "$ANALYSIS_PROMPT" | claude --model haiku --print -p - 2>/dev/null) || {
+  echo "Analysis failed — claude CLI error. Try running manually."
+  exit 1
+}
+
+if [[ "$RESULT" == "NO_NEW_PATTERNS" ]] || [[ -z "$RESULT" ]]; then
+  echo "No new patterns detected yet. Keep using Claude Code — patterns emerge over time."
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Write instinct YAML files
+# ---------------------------------------------------------------------------
+mkdir -p "$PROJECT_DIR"
+
+NEW_COUNT=0
+INSTINCT_ID=""
+BLOCK=""
+
+while IFS= read -r line; do
+  if [[ "$line" == "---" ]] && [[ -n "$BLOCK" ]]; then
+    if [[ -n "$INSTINCT_ID" ]]; then
+      DEST="${PROJECT_DIR}/${INSTINCT_ID}.yaml"
+      printf '%s\n' "$BLOCK" > "$DEST"
+      echo "  + ${INSTINCT_ID} -> ${DEST}"
+      NEW_COUNT=$((NEW_COUNT + 1))
+    fi
+    INSTINCT_ID=""
+    BLOCK=""
+  else
+    BLOCK="${BLOCK}${line}"$'\n'
+    if [[ "$line" =~ ^id:\ (.+) ]]; then
+      INSTINCT_ID="${BASH_REMATCH[1]}"
+      INSTINCT_ID="${INSTINCT_ID//\"/}"
+      INSTINCT_ID="${INSTINCT_ID//\'/}"
+    fi
+  fi
+done <<< "$RESULT"
+
+# Handle last block
+if [[ -n "$INSTINCT_ID" ]] && [[ -n "$BLOCK" ]]; then
+  DEST="${PROJECT_DIR}/${INSTINCT_ID}.yaml"
+  printf '%s\n' "$BLOCK" > "$DEST"
+  echo "  + ${INSTINCT_ID} -> ${DEST}"
+  NEW_COUNT=$((NEW_COUNT + 1))
+fi
+
+echo ""
+echo "Created ${NEW_COUNT} new instinct(s) in ${PROJECT_DIR}/"

package/bin/backfill.mjs

@@ -27,25 +27,25 @@ const args = process.argv.slice(2);
 const DRY_RUN = args.includes("--dry-run");
 const HELP = args.includes("--help") || args.includes("-h");
 if (HELP) {
-    console.log(`
-backfill — Tag legacy thin-schema observation rows.
-
-Usage:
-  npx continuous-improvement backfill            Tag rows in place
-  npx continuous-improvement backfill --dry-run  Report counts, write nothing
-
-What it does:
-  Walks ~/.claude/instincts/<hash>/observations.jsonl files and adds a
-  schema field ("thin" or "rich") to every row that lacks one. Thin rows
-  came from the legacy bash fallback (jq missing) and have no input_summary;
-  rich rows came from the Node observer and have full tool_input.command /
-  Edit.file_path / etc.
-
-Output:
-  - observations.jsonl rewritten in place (original kept as .bak)
-  - backfill-summary.json with per-project counts
-
-Idempotent. Always exits 0 — failures go to stderr only.
+    console.log(`
+backfill — Tag legacy thin-schema observation rows.
+
+Usage:
+  npx continuous-improvement backfill            Tag rows in place
+  npx continuous-improvement backfill --dry-run  Report counts, write nothing
+
+What it does:
+  Walks ~/.claude/instincts/<hash>/observations.jsonl files and adds a
+  schema field ("thin" or "rich") to every row that lacks one. Thin rows
+  came from the legacy bash fallback (jq missing) and have no input_summary;
+  rich rows came from the Node observer and have full tool_input.command /
+  Edit.file_path / etc.
+
+Output:
+  - observations.jsonl rewritten in place (original kept as .bak)
+  - backfill-summary.json with per-project counts
+
+Idempotent. Always exits 0 — failures go to stderr only.
 `);
     process.exit(0);
 }

package/bin/check-docs-substrings.mjs

@@ -177,6 +177,48 @@ export const DOCS_ASSERTIONS = [
     { file: "plugins/continuous-improvement/skills/superpowers/SKILL.md", pattern: "## Stacked-PR Plan Precondition (≥3 files)", source: "docs-substrings-manifest:superpowers-stacked-pr-precondition" },
     { file: "skills/superpowers.md", pattern: "Per-PR table", source: "docs-substrings-manifest:superpowers-stacked-pr-precondition" },
     { file: "plugins/continuous-improvement/skills/superpowers/SKILL.md", pattern: "Per-PR table", source: "docs-substrings-manifest:superpowers-stacked-pr-precondition" },
+    // superpowers Companion-Preference Override — locked 2026-05-13 (PR 1 of dispatcher-bias train).
+    // The dispatcher gained an opt-in settings key (~/.claude/settings.json →
+    // continuous_improvement.companion_preference: "ci-first" | "companions-first" | "strict-companions")
+    // that lets an operator who installed a companion plugin promote it over the CI-bundled default.
+    // Each assertion below catches a specific class of regression:
+    //   - "## Companion-Preference Override" → removing the whole override section
+    //   - "companion_preference"              → renaming or moving the settings key
+    //   - "strict-companions"                 → losing the hard-halt variant
+    { file: "skills/superpowers.md", pattern: "## Companion-Preference Override", source: "docs-substrings-manifest:superpowers-companion-preference-override" },
+    { file: "plugins/continuous-improvement/skills/superpowers/SKILL.md", pattern: "## Companion-Preference Override", source: "docs-substrings-manifest:superpowers-companion-preference-override" },
+    { file: "skills/superpowers.md", pattern: "companion_preference", source: "docs-substrings-manifest:superpowers-companion-preference-override" },
+    { file: "plugins/continuous-improvement/skills/superpowers/SKILL.md", pattern: "companion_preference", source: "docs-substrings-manifest:superpowers-companion-preference-override" },
+    { file: "skills/superpowers.md", pattern: "strict-companions", source: "docs-substrings-manifest:superpowers-companion-preference-override" },
+    { file: "plugins/continuous-improvement/skills/superpowers/SKILL.md", pattern: "strict-companions", source: "docs-substrings-manifest:superpowers-companion-preference-override" },
+    // superpowers Runtime Enforcement subsection — locked 2026-05-13 (PR 3 of dispatcher-bias train).
+    // The Companion-Preference Override moved from documented-only to runtime-enforced via
+    // hooks/companion-preference.mjs (PreToolUse). The "### Runtime enforcement" subsection
+    // names the hook file as the verify:doc-runtime-claims anchor and describes the per-mode
+    // decision contract. Each assertion catches a specific class of regression:
+    //   - "### Runtime enforcement"           → removing the whole subsection
+    //   - "hooks/companion-preference.mjs"    → losing the hook anchor (also satisfies doc-runtime-claims)
+    //   - "fails open"                        → losing the no-block-on-bug invariant
+    { file: "skills/superpowers.md", pattern: "### Runtime enforcement", source: "docs-substrings-manifest:superpowers-runtime-enforcement" },
+    { file: "plugins/continuous-improvement/skills/superpowers/SKILL.md", pattern: "### Runtime enforcement", source: "docs-substrings-manifest:superpowers-runtime-enforcement" },
+    { file: "skills/superpowers.md", pattern: "hooks/companion-preference.mjs", source: "docs-substrings-manifest:superpowers-runtime-enforcement" },
+    { file: "plugins/continuous-improvement/skills/superpowers/SKILL.md", pattern: "hooks/companion-preference.mjs", source: "docs-substrings-manifest:superpowers-runtime-enforcement" },
+    { file: "skills/superpowers.md", pattern: "fails open", source: "docs-substrings-manifest:superpowers-runtime-enforcement" },
+    { file: "plugins/continuous-improvement/skills/superpowers/SKILL.md", pattern: "fails open", source: "docs-substrings-manifest:superpowers-runtime-enforcement" },
+    // superpowers Telemetry subsection — locked 2026-05-14 (PR 4 of dispatcher-bias train).
+    // The hook gained a JSONL telemetry writer at ~/.claude/instincts/<hash>/companion-preference.jsonl
+    // that fires under every mode including ci-first (which writes `observation` shadow rows). The
+    // "### Telemetry" subsection documents the JSONL path and the four-value action enum. Each
+    // assertion catches a specific class of regression:
+    //   - "### Telemetry"                     → removing the whole subsection
+    //   - "companion-preference.jsonl"        → renaming the JSONL file
+    //   - "observation"                       → losing the ci-first shadow row that makes default-flip decisions evidence-driven
+    { file: "skills/superpowers.md", pattern: "### Telemetry", source: "docs-substrings-manifest:superpowers-telemetry-jsonl" },
+    { file: "plugins/continuous-improvement/skills/superpowers/SKILL.md", pattern: "### Telemetry", source: "docs-substrings-manifest:superpowers-telemetry-jsonl" },
+    { file: "skills/superpowers.md", pattern: "companion-preference.jsonl", source: "docs-substrings-manifest:superpowers-telemetry-jsonl" },
+    { file: "plugins/continuous-improvement/skills/superpowers/SKILL.md", pattern: "companion-preference.jsonl", source: "docs-substrings-manifest:superpowers-telemetry-jsonl" },
+    { file: "skills/superpowers.md", pattern: "`observation`", source: "docs-substrings-manifest:superpowers-telemetry-jsonl" },
+    { file: "plugins/continuous-improvement/skills/superpowers/SKILL.md", pattern: "`observation`", source: "docs-substrings-manifest:superpowers-telemetry-jsonl" },
     // verification-loop per-project ladder — locked 2026-05-07 (PR C of second-release train).
     // Phase 0 (Ladder Resolution) was added so Phases 1–6 read the project's actual build/typecheck/
     // lint/test/security/deploy_receipt invocations from .claude/verify-ladder.json (or sniff /
@@ -253,6 +295,37 @@ export const DOCS_ASSERTIONS = [
     { file: "plugins/continuous-improvement/skills/proceed-with-the-recommendation/SKILL.md", pattern: `The "no" escape valve (both tiers)`, source: "wild-risa-tiers.test.mts" },
     { file: "skills/proceed-with-the-recommendation.md", pattern: "explicit handoff signal", source: "wild-risa-tiers.test.mts" },
     { file: "plugins/continuous-improvement/skills/proceed-with-the-recommendation/SKILL.md", pattern: "explicit handoff signal", source: "wild-risa-tiers.test.mts" },
+    // proceed-with-the-recommendation --once fast-path mode — locked 2026-05-13 (PR 2 of dispatcher-bias train).
+    // The orchestrator gained an opt-in mode that runs Phase 1 + Phase 3 + Phase 4 only on single-item
+    // safe-tagged confirmations, skipping P-MAG, Plan, Reflect, and the three-section close. Hard
+    // preconditions refuse --once and fall back to the full flow if list size != 1, item is not safe,
+    // it touches > 3 files / > 150 LOC, hits restricted dirs, or is destructive. Each assertion below
+    // catches a specific class of regression:
+    //   - "## Fast-Path: `--once` Mode"        → removing the whole section
+    //   - "Refuse --once if any fail"-shaped   → losing the precondition gate (matched via "--once refused:")
+    //   - "Phase 0 — P-MAG" + "**Skipped.**"   → losing the explicit phase-status table (matched via "Skipped.** Reason: single-item")
+    { file: "skills/proceed-with-the-recommendation.md", pattern: "## Fast-Path: `--once` Mode", source: "docs-substrings-manifest:proceed-once-mode" },
+    { file: "plugins/continuous-improvement/skills/proceed-with-the-recommendation/SKILL.md", pattern: "## Fast-Path: `--once` Mode", source: "docs-substrings-manifest:proceed-once-mode" },
+    { file: "skills/proceed-with-the-recommendation.md", pattern: "--once refused:", source: "docs-substrings-manifest:proceed-once-mode" },
+    { file: "plugins/continuous-improvement/skills/proceed-with-the-recommendation/SKILL.md", pattern: "--once refused:", source: "docs-substrings-manifest:proceed-once-mode" },
+    { file: "skills/proceed-with-the-recommendation.md", pattern: "Skipped.** Reason: single-item", source: "docs-substrings-manifest:proceed-once-mode" },
+    { file: "plugins/continuous-improvement/skills/proceed-with-the-recommendation/SKILL.md", pattern: "Skipped.** Reason: single-item", source: "docs-substrings-manifest:proceed-once-mode" },
+    { file: "commands/proceed-with-the-recommendation.md", pattern: "Fast-path: `--once` mode", source: "docs-substrings-manifest:proceed-once-mode" },
+    { file: "plugins/continuous-improvement/commands/proceed-with-the-recommendation.md", pattern: "Fast-path: `--once` mode", source: "docs-substrings-manifest:proceed-once-mode" },
+    // /companion-preference status reader — locked 2026-05-14 (PR 5 of dispatcher-bias train).
+    // The reader CLI (bin/companion-preference-status.mjs) and slash command (commands/companion-preference.md)
+    // turn the JSONL telemetry from PR #138 into a per-skill aggregation report. The slash command must
+    // expose the frontmatter name, the canonical CLI invocation, and the documented --json subcommand.
+    // Each assertion catches a specific class of regression:
+    //   - "name: companion-preference"                → renaming the slash command
+    //   - "companion-preference-status.mjs"            → renaming the CLI entry point
+    //   - "## Subcommands"                             → losing the documented surface (--json, --days, --all)
+    { file: "commands/companion-preference.md", pattern: "name: companion-preference", source: "docs-substrings-manifest:companion-preference-status-reader" },
+    { file: "plugins/continuous-improvement/commands/companion-preference.md", pattern: "name: companion-preference", source: "docs-substrings-manifest:companion-preference-status-reader" },
+    { file: "commands/companion-preference.md", pattern: "companion-preference-status.mjs", source: "docs-substrings-manifest:companion-preference-status-reader" },
+    { file: "plugins/continuous-improvement/commands/companion-preference.md", pattern: "companion-preference-status.mjs", source: "docs-substrings-manifest:companion-preference-status-reader" },
+    { file: "commands/companion-preference.md", pattern: "## Subcommands", source: "docs-substrings-manifest:companion-preference-status-reader" },
+    { file: "plugins/continuous-improvement/commands/companion-preference.md", pattern: "## Subcommands", source: "docs-substrings-manifest:companion-preference-status-reader" },
 ];
 export function checkAssertions(repoRoot, assertions = DOCS_ASSERTIONS) {
     const fileCache = new Map();