@thebassclef/lite 1.9.16 → 1.9.18

package/dist/lite/.claude/hooks/session-reflection.d/83-install-written-paths-rebuild.sh

@@ -66,43 +66,26 @@ _iwp_fragment_main() {
     return 0
   fi
 
-  # Source lib — subshell so caller scope stays clean
+  # Source lib — subshell so caller scope stays clean.
+  # Per bassclef-upstream#2200 — bulk-rebuild verb replaces the prior
+  # 451×700ms serial register loop that timed out before completion.
+  # New verb builds one jq write + one ajv validate at the end.
   (
     # shellcheck source=/dev/null
     . "$lib" 2>/dev/null || exit 0
 
-    if ! declare -F install_written_paths_register >/dev/null 2>&1; then
-      _iwp_fragment_log "skip reason=lib-missing-verb"
-      exit 0
-    fi
-
-    # Reset manifest to empty, then walk lite-manifest entries
-    rm -f "$write_manifest" 2>/dev/null || true
-    install_written_paths_rebuild 2>/dev/null || true
-
-    local registered=0
-    local skipped=0
-
-    # Each lite-manifest entry has .path field — register when file exists on disk
-    while IFS= read -r path; do
-      [ -z "$path" ] && continue
-      local full
-      case "$path" in
-        /*) full="$path" ;;
-        *) full="$project_root/$path" ;;
-      esac
-      if [ -f "$full" ]; then
-        if install_written_paths_register "$path" "bassclef-sync-template" 2>/dev/null; then
-          registered=$((registered + 1))
-        else
-          skipped=$((skipped + 1))
-        fi
-      else
-        skipped=$((skipped + 1))
+    if declare -F install_written_paths_rebuild_from_lite_manifest >/dev/null 2>&1; then
+      # Preserve verb's stderr (ajv-fail warnings etc.) by piping to trace
+      # instead of swallowing with 2>/dev/null (architect-review F3).
+      local verb_stderr
+      verb_stderr=$(install_written_paths_rebuild_from_lite_manifest "$lite_manifest" 2>&1 >/dev/null) || true
+      if [ -n "$verb_stderr" ]; then
+        _iwp_fragment_log "bulk-rebuild stderr=$verb_stderr"
       fi
-    done < <(jq -r '.entries[]?.path // empty' "$lite_manifest" 2>/dev/null)
-
-    _iwp_fragment_log "rebuild complete registered=$registered skipped=$skipped"
+      _iwp_fragment_log "bulk-rebuild dispatched lite=$lite_manifest"
+    else
+      _iwp_fragment_log "skip reason=lib-missing-bulk-rebuild-verb"
+    fi
   ) || true
 
   return 0

package/dist/lite/.claude/hooks/turn-prose-density-measure.sh

@@ -0,0 +1,109 @@
+#!/bin/bash
+# tier: lite
+# install-class: dual
+# Turn-prose density measure — Stop hook that reads the last assistant message
+# from the transcript, counts non-standard hyphenated compounds, and writes
+# the number to a marker file at state/markers/turn-prose-density/last-turn.json
+# via lib/prose-marker.sh per standards/prose-marker-format.md.
+#
+# Density = count of [a-z]{2,}-[a-z]{2,}(?:-[a-z]{2,})? matches MINUS the
+# 25-entry standard-tech allowlist. Proxy for jargon load distinct from
+# grade-measure's existing hyphen_words count (which includes standard tech).
+#
+# The pre-turn plain-english-steering.sh reads the marker on next turn
+# (extended at Step 2d) and injects the density number into the steering
+# block alongside grade + appositive misses.
+#
+# Sibling scorers:
+#   - turn-prose-grade-measure.sh — grade metric
+#   - turn-prose-kiss-check.sh    — appositive miss count (Step 2c extension)
+#
+# Input (stdin): JSON with transcript_path + session_id
+# Output: writes state/markers/turn-prose-density/last-turn.json
+# Exit: 0 always (measurement only, no gate)
+#
+# Override: SKIP_TURN_PROSE_DENSITY=1
+
+set +e
+
+# === Override path ===
+if [ "${SKIP_TURN_PROSE_DENSITY:-0}" = "1" ]; then
+  exit 0
+fi
+
+# === Parse stdin JSON ===
+STDIN_JSON=$(cat 2>/dev/null || echo '{}')
+if ! command -v jq >/dev/null 2>&1; then
+  exit 0
+fi
+TRANSCRIPT_PATH=$(echo "$STDIN_JSON" | jq -r '.transcript_path // ""' 2>/dev/null)
+
+[ -z "$TRANSCRIPT_PATH" ] && exit 0
+[ ! -f "$TRANSCRIPT_PATH" ] && exit 0
+
+# === Resolve lib path (install-class: dual) ===
+# Project install — lib relative to this hook. Operator install — lib under $HOME.
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LIB_PATH=""
+for candidate in \
+  "${SCRIPT_DIR}/../../lib/prose-marker.sh" \
+  "${HOME:-/}/lib/prose-marker.sh" \
+  "${CLAUDE_PROJECT_DIR:-}/lib/prose-marker.sh"; do
+  if [ -f "$candidate" ]; then
+    LIB_PATH="$candidate"
+    break
+  fi
+done
+
+[ -z "$LIB_PATH" ] && exit 0
+# shellcheck disable=SC1090
+source "$LIB_PATH" 2>/dev/null || exit 0
+
+# === Extract last assistant text ===
+LAST_ASSISTANT_LINE=$(grep '"type":"assistant"' "$TRANSCRIPT_PATH" 2>/dev/null | tail -1)
+[ -z "$LAST_ASSISTANT_LINE" ] && exit 0
+
+MESSAGE_TEXT=$(echo "$LAST_ASSISTANT_LINE" \
+  | jq -r '.message.content[]? | select(.type == "text") | .text' 2>/dev/null)
+[ -z "$MESSAGE_TEXT" ] && exit 0
+
+# === Strip code blocks + inline backticks + URLs (prose only) ===
+SCRUBBED=$(echo "$MESSAGE_TEXT" | awk '
+  BEGIN { in_code = 0 }
+  /^```/ { in_code = !in_code; next }
+  in_code { next }
+  { print }
+' | sed -E 's/`[^`]*`//g; s|https?://[^ )]+||g')
+
+# Short message after strip → density=0
+STRIPPED_LEN=${#SCRUBBED}
+if [ "$STRIPPED_LEN" -lt 50 ]; then
+  write_prose_marker "turn-prose-density" "0" "short message under 50 chars"
+  exit 0
+fi
+
+# === Compute density via python ===
+# Standard-tech allowlist excluded. Pattern per standards/prose-marker-format.md.
+DENSITY=$(printf '%s' "$SCRUBBED" | python3 -c '
+import sys, re
+
+STANDARD_TECH = {
+    "pre-commit", "real-time", "data-driven", "end-to-end", "fire-and-forget",
+    "run-time", "compile-time", "read-only", "write-only", "fail-soft",
+    "fail-fast", "post-commit", "pre-push", "post-merge", "op-ed",
+    "self-test", "self-check", "re-read", "re-run", "re-fire",
+    "op-cost", "copy-paste", "cut-off", "set-up", "built-in",
+}
+
+text = sys.stdin.read().lower()
+pattern = re.compile(r"\b[a-z]{2,}-[a-z]{2,}(?:-[a-z]{2,})?\b")
+matches = pattern.findall(text)
+density = sum(1 for m in matches if m not in STANDARD_TECH)
+print(density)
+' 2>/dev/null)
+
+[ -z "$DENSITY" ] && DENSITY=0
+
+# === Write density marker via lib ===
+write_prose_marker "turn-prose-density" "$DENSITY" 2>/dev/null
+exit 0

package/dist/lite/.claude/hooks/turn-prose-kiss-check.sh

@@ -83,6 +83,20 @@ for _candidate in \
 done
 unset _candidate
 
+# === Source lib/prose-marker.sh (deep module per Longrun 2 Step 2b #2197) ===
+# Provides write_prose_marker for appositive-miss count persistence.
+# Silent-fail — no lib = no marker write; existing stderr display path unchanged.
+for _candidate in \
+  "${SCRIPT_DIR}/../../lib/prose-marker.sh" \
+  "${HOME_OVERRIDE:-${HOME:-/}}/lib/prose-marker.sh"; do
+  if [ -f "$_candidate" ]; then
+    # shellcheck disable=SC1090
+    source "$_candidate"
+    break
+  fi
+done
+unset _candidate
+
 # === Parse stdin JSON ===
 STDIN_JSON=$(cat 2>/dev/null || echo '{}')
 TRANSCRIPT_PATH=$(echo "$STDIN_JSON" | jq -r '.transcript_path // ""' 2>/dev/null)
@@ -417,8 +431,15 @@ for pattern, label in patterns:
 
 for f in flagged[:5]:  # cap at 5 findings per turn to avoid noise
     print(f)
+# Emit total count on final line as sentinel — bash strips before display.
+# Per Longrun 2 Step 2c (#2197) — scorer-stack appositive marker.
+print(f"__APPOSITIVE_COUNT__={len(flagged)}")
 ' 2>/dev/null)
 
+  # Extract the count sentinel; strip it from the display output.
+  APPOSITIVE_COUNT=$(echo "$APPOSITIVE_FINDINGS" | grep '^__APPOSITIVE_COUNT__=' | tail -1 | sed 's/^__APPOSITIVE_COUNT__=//')
+  APPOSITIVE_FINDINGS=$(echo "$APPOSITIVE_FINDINGS" | grep -v '^__APPOSITIVE_COUNT__=')
+
   if [ -n "$APPOSITIVE_FINDINGS" ]; then
     cat >&2 <<EOF
 [turn-prose-kiss-check: ADVISORY — appositive discipline (bassclef-upstream#1313)]
@@ -434,6 +455,13 @@ Override one-time: SKIP_APPOSITIVE_CHECK=1.
 V1 advisory; V2 (deferred) BLOCKs after calibration.
 EOF
   fi
+
+  # === Write appositive-miss marker via lib/prose-marker.sh (Longrun 2 Step 2c) ===
+  # Count is total matches (not capped at 5 — that cap is display-only).
+  # Silent-fail — missing lib or write error does not affect existing path.
+  if declare -f write_prose_marker >/dev/null 2>&1 && [ -n "$APPOSITIVE_COUNT" ]; then
+    write_prose_marker "turn-prose-appositive" "$APPOSITIVE_COUNT" 2>/dev/null
+  fi
 fi
 
 # === Emit findings + exit per mode ===

package/dist/lite/.claude/rules/branching.md

@@ -13,6 +13,8 @@ Branch naming:
 
 Every branch ties to a GitHub Issue. No branch without an issue.
 
+**Exception — `/launch --local`.** Adopter prototype branches created by `/launch --local` are exempt from the issue-per-branch rule. Local prototype mode exists for adopters who do not yet have a GitHub repo or who iterate ahead of filing issues. Per bassclef-upstream#2175 Batch A (F2) + bassclef-cli#328 Finding 2.
+
 Flow: issue → branch from main → work → PR → CI passes → squash merge → delete branch
 
 Rules:

package/dist/lite/.claude/rules/identifier-leak-prevention.md

@@ -30,8 +30,9 @@ No commit lands with these patterns in message OR staged content:
 
 - **Hostname shapes**: `[A-Za-z][A-Za-z0-9]*-MacBook-(Air|Pro)`, `DESKTOP-[A-Z0-9]{4,}`, `*-server-*`, `*-desktop-*`
 - **Absolute paths**: `/Users/<name>`, `/home/<name>`
+- **GitHub no-reply derived slug**: `operator-[0-9]+\+[a-zA-Z0-9][a-zA-Z0-9-]*` — the shape `/personas` historically derived from a GitHub no-reply email local part (`<id>+<handle>`), leaking account ID plus handle into committed persona + use-case + jobs docs. Per bassclef-upstream#2146. Scope-safe — the pattern targets the derived slug only; the raw email format `<id>+<handle>@users.noreply.github.com` stays allowed as a git author (Check 3 pins that in Test 22) because GitHub recommends no-reply as the privacy format for commit identity.
 
-Extension mechanism — future pattern classes added to the hook's `IDENTIFIER_PATTERNS` regex + a corresponding Tier 0 test.
+Extension mechanism — future pattern classes added to `standards/identifier-leak-patterns.txt` + a corresponding Tier 0 test. The hook reads the pattern file at run time; adding a line there extends the scrub without a hook edit.
 
 ## Anti-patterns
 

package/dist/lite/.claude/rules/lite-manifest-schema-change-discipline.md

@@ -36,6 +36,29 @@ When a PR changes the manifest schema OR output shape:
 3. **Downstream cure named** — the entry names what adopters need to do. If nothing (backward-compatible add), say so explicitly. If code change (like the v0.36.0 `upstream_commit` removal), name the pattern.
 4. **Release script pre-flight** — before every `/release`, the script reads the ledger and confirms an entry exists for the outgoing `manifest_version`. Missing entry BLOCKs the cascade.
 
+## Ledger-edit-then-regen order (bassclef-upstream#2110)
+
+The ledger file at `standards/lite-manifest-schema-changes.md` is ITSELF a `tier: lite` artifact. Its content_hash lives inside the manifest. So the regen must capture the FINAL ledger state. Order matters:
+
+1. **Edit ledger first.** Write the entry explaining the schema change.
+2. **Regen second.** Run `scripts/generate-lite-manifest.sh`.
+
+Natural authoring instinct is "regen first (see the hashes), then explain." That order ships a stale ledger hash in the manifest. CI drift check fails. A second regen commit is then needed.
+
+**Preferred cure — use the wrapper.** `scripts/update-lite-manifest.sh` enforces the order:
+
+```bash
+# Append a pre-written entry
+scripts/update-lite-manifest.sh --entry-file path/to/entry.md
+
+# Open $EDITOR on the ledger
+scripts/update-lite-manifest.sh --edit
+```
+
+Both modes hash the ledger before and after. The wrapper refuses to regen when the ledger is unchanged. Then it dispatches `scripts/generate-lite-manifest.sh` + the renderer when present.
+
+Per `.claude/rules/bootstrap-pair-discipline.md` — the wrapper ships with Tier 0 tests at `scripts/tests/update-lite-manifest.test.sh`.
+
 ## Retirements
 
 Retirement-class changes (content-remove: a file previously shipped in the lite manifest gets deleted intentionally) ship with the same discipline shape as additions. Three paired artifacts, same PR:

package/dist/lite/.claude/rules/reviewer-dispatch.md

@@ -0,0 +1,95 @@
+---
+tier: lite
+description: Any session that ships source code (files under src/, apps/, packages/, lib/, app/) MUST invoke Reviewer responsibilities before the session ends.
+---
+
+# Reviewer Dispatch
+
+Any session that ships source code (files under `src/`, `apps/`, `packages/`, `lib/`, `app/`) MUST invoke Reviewer responsibilities before the session ends. Mode-agnostic — orchestrator-gated mode dispatches the Reviewer agent; sequential mode self-invokes Reviewer responsibilities (read against spec, check tests, validate ADR compliance, flag TDD test-after patterns per Kent Beck).
+
+The discipline lives at the rule layer (this file) plus the mechanical layer (`.claude/hooks/reviewer-dispatch-check.sh` — Stop hook). Both required for adopter code quality.
+
+## When this rule fires
+
+At session end (Stop event), the hook:
+
+1. Counts source files changed since session-start (heuristic: `git diff` against `origin/main`; uncommitted + committed changes both count)
+2. Path matchers for "source": `src/`, `apps/`, `packages/`, `lib/`, `app/`
+3. When source count > 0, the hook checks for any marker at `state/markers/reviewer/*.md`
+4. When no marker exists, the hook BLOCKs with reviewer-checklist remediation
+
+## Reviewer marker contract
+
+The marker captures the Reviewer pass per the agent definition (`~/.claude/agents/reviewer.md`):
+
+```markdown
+# Reviewer pass — <session-id>
+
+mode: sequential | orchestrator-gated
+reviewed_at: <ISO-8601>
+source_files_changed: <count>
+wu_id: <e.g., bet-2026-06-25k WU-3>      # bet 25k WU-5 extension
+iteration_count: <N>                     # bet 25k WU-5 extension
+lens_used: [<luminary-slug>, ...]        # bet 25k WU-5 extension
+
+## Checks
+- spec acceptance criteria: PASS | FAIL | N/A
+- tests present + green: PASS | FAIL
+- test-after pattern check: NONE FOUND | FOUND (list)
+- ADR compliance: PASS | N/A
+- Designer sign-off: PRESENT | N/A
+- architect-review: INVOKED | N/A
+
+## Findings
+- <severity>: <description>  # BLOCK / WARN / NOTE
+
+acknowledged: true
+```
+
+### Field extensions per bassclef-upstream#366 (bet 25k WU-5)
+
+Three fields extend the prior contract to make the /loop discipline auditable per step:
+
+- **`wu_id`** — goal identifier + WU number (e.g., `bet-2026-06-25k WU-3`). Lets future audits grep markers by WU. Required when the marker is written under /longrun dispatch; optional for ad-hoc reviews.
+- **`iteration_count`** — number of /loop iterations the step ran before landing GREEN. Iteration 1 GREEN is the cleanest path; counts above 1 record rework cycles (RED → fix → GREEN). Required under /longrun dispatch.
+- **`lens_used`** — YAML list of luminary slugs that drove the review. Mirrors the goal doc's `authoring_luminaries` for the relevant WU. Required under /longrun dispatch.
+
+The three fields together let future operators answer questions like "which WUs in bet 25k ran more than one /loop iteration" or "which luminary lens caught the most rework" by greppable markers, not by chronicle archaeology. The mechanical layer (greppable fields) compounds across every goal; the bar (`## /temperance + /luminary + /loop discipline` section in the PR body) gives the immediate operator-visible read.
+
+Forward-only enforcement. Markers written before WU-5 stay as-is; markers written from WU-5 onwards carry the three new fields under /longrun dispatch.
+
+## Mode behavior
+
+**Orchestrator-gated mode** — orchestrator dispatches Reviewer agent at code-shipping handoffs. Reviewer agent reads against spec, runs checks, writes the marker per the contract above, returns PASS/FAIL/WARN findings to orchestrator.
+
+**Sequential mode** — agent self-invokes Reviewer responsibilities. Read the Reviewer agent definition. Apply checks against the session's source diff. Write the marker. The self-invocation is honor-system at the methodology layer; the marker is the mechanical evidence the hook reads.
+
+## Override path
+
+`SKIP_REVIEWER_CHECK=1 <command>` — logged via trace-helper. Use rarely:
+
+- Documentation-only session that accidentally touched a comment in src/ (operator confirms the source touch is non-behavioral)
+- Emergency rescue when the hook itself misclassifies (file substrate-defect)
+- One-shot migration script that ships hundreds of source files (operator has reviewed externally)
+- Bulk dependency-bump where the package-manager touched lockfile entries only
+
+INSTEAD of overriding for routine work: write the marker. The Reviewer-self-invocation cost is small (~5 minutes); the audit trail compounds across every adopter session.
+
+## What the rule does NOT cover
+
+- Code review process content (covered in `~/.claude/agents/reviewer.md`)
+- TDD test-list discipline (covered in `.claude/rules/test-list-discipline.md`)
+- Sufficiency rubric for tests (covered in `.claude/rules/test-sufficiency.md`)
+- ADR discipline (covered in `.claude/rules/adr-discipline.md`)
+- Architect review timing (covered in `.claude/skills/architect-review/SKILL.md`)
+
+This rule is the gate. Sister rules + skills carry the content.
+
+## Composition with other rules
+
+- `.claude/rules/testing-tier-config.md` — Tier 0 strict-TDD on hook + tests (this hook + its test file land Tier 0)
+- `.claude/rules/blocked-items.md` — BLOCK protocol the hook fires
+- `.claude/rules/test-sufficiency.md` — what Reviewer checks for under "tests present + green"
+- `.claude/rules/test-list-discipline.md` — what Reviewer checks for under "test-after pattern check" (Beck's test-list-as-planning-artifact)
+- `.claude/rules/adr-discipline.md` — what Reviewer checks for under "ADR compliance"
+- `~/.claude/agents/reviewer.md` — the full Reviewer responsibilities definition

package/dist/lite/.claude/settings.json

@@ -52,6 +52,11 @@
             "type": "command",
             "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/git-stash-u-guard.sh",
             "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/pre-push-shellcheck.sh",
+            "timeout": 60
           }
         ]
       },
@@ -167,6 +172,11 @@
             "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/turn-prose-grade-measure.sh",
             "timeout": 10
           },
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/turn-prose-density-measure.sh",
+            "timeout": 10
+          },
           {
             "type": "command",
             "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/longrun-prep-compounding-sequence-check.sh",

package/dist/lite/.claude/skills/build/SKILL.md

@@ -214,13 +214,28 @@ if echo "$@" | grep -q -- '--explain'; then
   EXPLAIN_MODE=true
 fi
 
-# Resolve goal via accessor
+# Resolve goal via accessor. #2132 — capture stderr so parse errors surface
+# instead of masquerading as "not found". Map accessor return codes:
+#   1 → goal file not found; 3 → goal file could not be parsed.
 source lib/state.sh
 BET_SLUG="$1"
-BET_JSON=$(state_iteration_bet_get "$BET_SLUG" 2>/dev/null) || {
-  echo "/build: goal '$BET_SLUG' not found via state_iteration_bet_get" >&2
-  exit 1
-}
+BET_JSON=$(state_iteration_bet_get "$BET_SLUG" 2>&1)
+BET_RC=$?
+if [ "$BET_RC" -ne 0 ]; then
+  case "$BET_RC" in
+    1)
+      echo "/build: goal file not found: $BET_SLUG" >&2
+      ;;
+    3)
+      echo "/build: goal file could not be parsed: $BET_SLUG" >&2
+      ;;
+    *)
+      echo "/build: goal '$BET_SLUG' lookup failed (rc=$BET_RC)" >&2
+      ;;
+  esac
+  echo "$BET_JSON" >&2
+  exit "$BET_RC"
+fi
 
 # Check status active
 STATUS=$(echo "$BET_JSON" | jq -r '.status // empty')
@@ -234,6 +249,15 @@ SPEC_PATH=$(echo "$BET_JSON" | jq -r '.references[]? | select(.type == "spec") |
 DECOMP_PATH=$(echo "$BET_JSON" | jq -r '.references[]? | select(.type == "decomposition") | .id // empty')
 UX_MIG_PATH=$(echo "$BET_JSON" | jq -r '.references[]? | select(.type == "ux-migration") | .id // empty')
 
+# #2132 — goal MUST declare a spec reference. Empty SPEC_PATH means Phase 1
+# would awk against docs/specs/.md and silently find nothing; cure refuses
+# at Phase 0 instead with a clear error.
+if [ -z "$SPEC_PATH" ]; then
+  echo "/build: goal '$BET_SLUG' has no spec reference — refusing" >&2
+  echo "Add a {type: spec, id: <spec-slug>} entry to goal frontmatter references[]." >&2
+  exit 4
+fi
+
 # Validate references exist
 for ref_type in spec decomposition; do
   ref_id=$(echo "$BET_JSON" | jq -r --arg t "$ref_type" '.references[]? | select(.type == $t) | .id // empty')
@@ -349,6 +373,16 @@ WU_LIST=$(awk '
 
 # Each step should reference at least one story (US-NNN)
 WU_COUNT=$(echo "$WU_LIST" | grep -cE '^### (Step|WU)-' || echo 0)
+
+# #2132 — refuse zero-step specs. The Phase 2 orphan check does not fire
+# on empty WU_LIST (no steps → no orphans → silent pass). Phase 1 refuses
+# so adopters see the real problem.
+if [ "$WU_COUNT" = "0" ]; then
+  echo "/build: spec has zero steps — refusing" >&2
+  echo "Spec file: $SPEC_FILE" >&2
+  echo "Need a Steps enumerated section with Step-N or WU-N entries." >&2
+  exit 4
+fi
 ```
 
 Build structured object: `{ bet, spec_path, decomp_path, ux_migration_path, wus[] }`.
@@ -483,6 +517,23 @@ Operator can force adopter-mode via `--adopter-mode` flag (V2). Operator can for
 
 ### Phase 3 — DryRunPlanner
 
+**Read the pre-mortem marker first (per bassclef-upstream#2175 Batch B — F5).** Before enumerating steps, read `state/markers/pre-mortem/<branch-slug>.marker` if present. The marker names the risk ledger file plus top-5 risks. Surface the ledger path + top-5 risks in the dry-run output. Builder dispatches in future LIVE mode read the ledger before writing code.
+
+<!-- FKGL-EXEMPT: bash command block; shell commands are not graded prose. -->
+
+```bash
+BRANCH_SLUG=$(git branch --show-current | tr '/' '-')
+MARKER="state/markers/pre-mortem/${BRANCH_SLUG}.marker"
+if [ -f "$MARKER" ]; then
+  echo "Pre-mortem ledger — reading top-5 risks:"
+  cat "$MARKER"
+fi
+```
+
+<!-- /FKGL-EXEMPT -->
+
+When the marker is absent, `/build` emits a one-line note that no pre-mortem fired for this branch and proceeds. `/pre-mortem` is mandatory on always-fire domains per its SKILL body; Phase 3 does not re-enforce that gate.
+
 Walk step enumeration; for each, plan what would happen in live mode:
 
 ```
@@ -534,6 +585,8 @@ TODO: live execution — operator-supervised first run only.
 - Operator-tap moments: 1 (prod deploy approval via GitHub Environment)
 ```
 
+<!-- FKGL-EXEMPT: Phase 4 stub — technical dispatch TODO; OOAD artifact names + branch slug template resist short SVO rewrites. Per bassclef-upstream#2175 Batch A — slug canon matches Phase 3. -->
+
 ### Phase 4 — BuilderDispatcher (LIVE — STUBBED)
 
 **Amendment per #1171 — Builder inputs name OOAD artifacts.**
@@ -545,7 +598,7 @@ TODO: live execution — operator-supervised first run only. Would:
 dispatch Builder against step <slug> with context from spec section
 <X> + decomp matrix entry <Y> + paired OOAD artifacts (decomposition
 + interaction-design + use-case per goal doc references). Branch:
-feature/<goal-slug>-stack-<N>.
+feature/<goal-slug>-stack-<N>-<wu-slug>.
 ```
 
 The string `TODO: live execution` is grep-able for audit. Live mode
@@ -556,6 +609,10 @@ in the goal doc `references` array — decomposition (grep for
 `type: interaction-design`), use-case (grep for `type: use-case`).
 Per #1171 — every OOAD artifact consulted for any engineering change.
 
+<!-- /FKGL-EXEMPT -->
+
+<!-- FKGL-EXEMPT: Phase 5 stub + Phase 5a Reviewer dispatch — technical TODO blocks for live-mode scaffolding. F10 cure per bassclef-upstream#2175 Batch D. -->
+
 ### Phase 5 — VerifyOrchestrator (LIVE — STUBBED)
 
 Tonight emits literal:
@@ -566,6 +623,24 @@ Match change type (UI smoke / unit / integration) and BLOCK on
 failure with line-numbered output.
 ```
 
+### Phase 5a — Reviewer dispatch (per bassclef-upstream#2175 Batch D — F10)
+
+After `/verify` passes, Phase 5 adds a Reviewer dispatch step. Running `/verify` alone catches test failures. The Reviewer agent (`.claude/agents/reviewer.md`) catches spec-acceptance drift, missing-test patterns, ADR deviations, and friction the Builder did not surface. One review step per PR before merge.
+
+Tonight emits literal:
+
+```
+TODO: live execution — would dispatch Reviewer agent against branch <name>.
+Reviewer reads: spec acceptance criteria, decomposition matrix entry, PR
+body friction report. Reviewer writes: state/markers/reviewer/<branch>.md
+with PASS / FAIL / NOTE findings. BLOCK merge on FAIL; NOTE findings file
+as follow-on tickets.
+```
+
+The Reviewer dispatch is MANDATORY per `.claude/rules/reviewer-dispatch.md` for any session shipping source code. Phase 5a is the Phase-level wiring. Live mode consumes the Reviewer marker before Phase 6 opens the PR.
+
+<!-- /FKGL-EXEMPT -->
+
 ### Phase 5.5 — Amendment B2: /pattern-review trigger reads decomposition (per #1150 + #1167)
 
 When the goal references a decomposition doc AND that doc contains `@pattern` references, dispatch `/pattern-review` with the decomposition path as input. Skip when the decomposition names no `@pattern`. Contract per `.claude/rules/pattern-annotation.md` L57-62.

package/dist/lite/.claude/skills/eisenhower/SKILL.md

@@ -151,6 +151,32 @@ Individual items: ...
 - #127 — title — no path to advance the goal — CLOSE
 ```
 
+### Step 4b — Emit the hard stack rank
+
+After the per-quadrant tables, emit one final table. Columns fixed:
+
+1. **Rank** — 1 to N, cross-repo, top-down
+2. **Ticket** — `<repo>#<number>` form
+3. **Repo** — the owning repo. Bold the repo name when work ships somewhere other than the filed repo.
+4. **Why this rank** — one plain-English sentence. Grade-8 target. Cite the Depen. tie or class fit.
+
+Row order:
+
+- Q1 first, then Q2, then Q3, then Q4
+- Within quadrant, sort by Depen. first (independents at top), then class, then ticket number
+- Flag cross-repo work in the Repo column
+
+Example row shape:
+
+```
+| Rank | Ticket | Repo              | Why this rank                        |
+|------|--------|-------------------|--------------------------------------|
+| 1    | #2008  | **bassclef-web**  | Q1 lead. Live Sam bounce.            |
+| 2    | #2011  | **bassclef-web**  | Q1 rider. Same PR as #2008.          |
+```
+
+Per bassclef-upstream#2096 amendment 3.
+
 ### Step 5 — Optional follow-on
 
 If Q3 surfaces 5+ items in the same shape, the skill offers to draft one `/promote` ticket. That ticket proposes automating the class. You accept, edit, or skip.

package/dist/lite/.claude/skills/launch/SKILL.md

@@ -264,6 +264,8 @@ fi
 
 **Local mode (`--local`) — bassclef#923 A2:**
 
+**Issue-per-branch exemption (per bassclef-upstream#2175 Batch A — F2).** `/launch --local` creates adopter prototype branches that are exempt from the `.claude/rules/branching.md` "every branch ties to a GitHub Issue" rule. Local prototype mode exists for adopters who do not yet have a GitHub repo. No issue is required for `--local` branches. All other `/launch` modes (full, scratch, operator-mode) still require an issue.
+
 `/launch --local` prints a banner first. The banner shows which picker is active:
 
 ```
@@ -546,6 +548,43 @@ The gallery is THE cameo-review surface. Luminary perspectives
 agent runtime per roadmap Stage 3) consume the gallery + spec + decomp
 to produce reviews per perspective. Reviews surface in PR body.
 
+### Phase 10a — Stack-choice ask (per bassclef-upstream#2175 Batch D — F13)
+
+<!-- FKGL-EXEMPT: Phase 10a — technical ask step with config-key contract. Short SVO loses the stack-key list. Fires before Phase 11 /ux-migration so the migration plan picks the right adapter. -->
+
+Before Phase 11 runs, ask the operator which frontend stack the migration targets. Today `/launch` silently assumes Next.js — nine SKILL bodies lean on Next.js examples. Non-React adopters hit the silent pick at Phase 11 and must rework. The ask fires once per `/launch` dispatch; the answer writes to `substrate.config.md` key `frontend_stack` for Phase 11 to read.
+
+Read `substrate.config.md` for `frontend_stack`. If set, skip the ask. If unset, ask:
+
+```
+Which stack is this app?
+
+  a. Next.js — React + App Router (bassclef default; nine SKILL bodies lean on Next.js examples)
+  b. Vite + React — React + Vite dev server
+  c. Remix — React + Remix
+  d. SvelteKit — Svelte + Kit
+  e. SolidStart — Solid + Start
+  f. none — static HTML + CSS, no framework
+  g. other — operator names it
+
+[a-g]
+```
+
+Write the answer to `substrate.config.md` `frontend_stack`:
+- `a` → `frontend_stack: nextjs`
+- `b` → `frontend_stack: vite-react`
+- `c` → `frontend_stack: remix`
+- `d` → `frontend_stack: sveltekit`
+- `e` → `frontend_stack: solidstart`
+- `f` → `frontend_stack: none`
+- `g` → `frontend_stack: <operator-named>`
+
+Default on Enter → `a` (Next.js) to preserve the historical silent pick. Operator can edit `substrate.config.md` directly at any time.
+
+Phase 11 reads `frontend_stack` and picks the matching migration adapter. When unset at Phase 11 fire, Phase 11 BLOCKs with a one-line note citing this ask.
+
+<!-- /FKGL-EXEMPT -->
+
 ### Phase 11 — `/ux-migration` (chosen variant → production migration plan)
 
 ```bash
@@ -699,8 +738,8 @@ Two templates — adopter-mode and operator-mode. Default is adopter when `--loc
 After Phase 12-alt (`local-serve.sh` running) + Phase 13 (preview-state.yml on disk), emit this template directly to the adopter — no YAML edits, no frontmatter flip, no command-soup:
 
 ```
-I made you N directions for your family recipe wiki. Walk through them on
-your phone or laptop at <LOCAL_URL> and tell me which one feels right.
+I made you N directions for your family recipe wiki. Walk through them
+on this computer at <LOCAL_URL> and tell me which one feels right.
 
 When you've picked, just tell me — "I like variant 2" or "#3 looks
 great".
@@ -740,8 +779,12 @@ None of them feel right? Tell me what's off and I'll generate new
 directions for you. (See /launch --refine, bassclef#942.)
 ```
 
+<!-- FKGL-EXEMPT: substitution instructions name three distinct placeholders; short SVO loses the mapping precision -->
 Substitute `<LOCAL_URL>` with the URL returned by Phase 12-alt. Substitute the actual variant count (`I made you N directions...`). Substitute the actual app description (`your family recipe wiki` etc.) from the InputArtifact's `intent` field.
 
+**Phone or iPad reach — opt-in with `--lan`.** The default URL binds `127.0.0.1`. Only this computer can open it. The adopter may want the gallery on a phone or iPad on the same Wi-Fi. Re-run Phase 12-alt with `--lan`: `bash scripts/launch/local-serve.sh --lan <gallery-dir>`. The script binds `0.0.0.0` and prints a one-line warning. Any device on the Wi-Fi can then reach the URL. Swap the handoff line to "on your phone, laptop, or iPad at <LOCAL_URL>" when `--lan` fires.
+<!-- /FKGL-EXEMPT -->
+
 The adopter-mode template **surfaces** (per bassclef#969):
 - The formal artifacts the chain will produce post-pick, in plain English (use case, user stories, IA, interaction design, responsibility map, build spec, migration plan)
 - The chain-ordering rationale (variants are cheap shared data; formal artifacts are expensive per-direction; cheap first → commit → expensive once)