@thebassclef/lite 1.7.0 → 1.9.0

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

@@ -1,7 +1,7 @@
 ---
 tier: lite
 name: launch
-description: "Compare variants of an idea. Ships a mock gallery with an Anthropic baseline. You pick a direction from the phone. Get the spec plus user stories. Get the decomposition plus a migration plan. Two sizes: medium and full."
+description: "Compare variants of an idea. Get a mock gallery. Pick a direction. Get a spec, user stories, and a plan to build. Two sizes \u2014 medium and full. Three modes \u2014 full, local, scratch."
 problem: "An idea is a doc. A working feature is code. The gap in between is where projects stall."
 value: "Turns an idea into a buildable plan \u2014 mock gallery and spec and INVEST stories. Ready for /build."
 inputs: [A rough idea or ticket or canvas]
@@ -9,6 +9,7 @@ outputs: [Clickable mock gallery, Buildable spec, INVEST user stories, GRASP res
 user_invocable: true
 disable_model_invocation: false
 sizes: [medium, full]
+modes: [full, local, scratch]
 composes_baseline: anthropic-frontend-design
 ---
 
@@ -97,8 +98,49 @@ Per `.claude/rules/adr-discipline.md`. Mechanism: `adr-discipline-check.sh` fire
 
 ## Procedure
 
+### Phase −1a — Capability probe (per bassclef-upstream#1909)
+
+Source `lib/capability-probe.sh` and pick a mode. Three modes: **full**, **local**, **scratch**. Modes are orthogonal to the existing `--brownfield`, `--reuse-artifact`, and `--local` deploy flags (RFC H3 folded per `docs/rfcs/2026-09-23-graceful-degrade-adversarial-review.md`).
+
+- **full** — git repo + gh auth + Playwright MCP + network. Full chain runs.
+- **local** — git repo present. No PR, no screenshots. Composer-preflight skips the deploy-host check.
+- **scratch** — no git repo. Writes to a tmp dir. Composer-preflight skips entirely; only Phase 1 (interpret-input) and Phase 4 (riff-prototypes) run.
+
+The mode picker short-circuits `probe_network` when other probes already downgrade the mode below `full` (RFC C2 folded).
+
+```bash
+source "${BASSCLEF_DIR:-$REPO_ROOT}/lib/capability-probe.sh"
+
+probe_git; GIT=$?
+probe_mcp_playwright; MCP=$?
+probe_gh_auth; GH=$?
+
+if [ $GIT -eq 0 ] && [ $MCP -eq 0 ] && [ $GH -eq 0 ]; then
+  probe_network; NET=$?
+else
+  NET=1
+fi
+
+G=$([ $GIT -eq 0 ] && echo 1 || echo 0)
+M=$([ $MCP -eq 0 ] && echo 1 || echo 0)
+H=$([ $GH  -eq 0 ] && echo 1 || echo 0)
+N=$([ $NET -eq 0 ] && echo 1 || echo 0)
+
+MODE="${OVERRIDE_MODE:-$(resolve_mode "$G" "$H" "$M" "$N")}"
+validate_mode "$MODE" "$G" "$H" "$M" "$N" || exit 1
+announce_mode "$MODE" "/launch"
+
+if [ "$MODE" = "scratch" ]; then
+  echo "launch: scratch mode — Phase −1 (composer prerequisites) skipped; no git repo, no deploy chain" >&2
+fi
+```
+
+Operator override reads `--mode=<name>` from argv. The parser validates the requested mode against the environment before dispatch. Requested `full` without gh auth exits with a plain-language error.
+
 ### Phase -1 — Pre-flight (per bassclef#408 + bassclef#449/#450)
 
+Runs only when Phase −1a picked `full` or `local`. Skipped entirely in `scratch` mode.
+
 Source the shared pre-flight helper and surface all 6 prerequisites
 upfront. Pass `--no-launch` if the dispatch is variants-only (no
 `/launch-preview` chain expected); the deploy-host check (Check 6)

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

@@ -1,13 +1,14 @@
 ---
 name: riff
-description: "Produce 2-3 clickable mock alternatives for a UI surface. Includes an Anthropic baseline. Each mock uses a different luminary lens. One picks a marketing variant. Another picks a build direction. Combines /interpret-input + /luminary + /stage + /visual-review."
-problem: "Design directions get one variant and no comparison. Operator picks blind. Rework is huge."
-value: "Two or three clickable mocks per UI surface. Each mock pins a different luminary lens."
+description: "Produce 2 or 3 clickable mock variants. Each pins a luminary lens. Three modes — full, local, scratch. Full uses git, gh, and screenshots. Local writes to disk only. Scratch uses a tmp dir with no git."
+problem: "Design work gets one variant. No comparison. The operator picks blind. Rework is heavy."
+value: "Two or three mocks per surface. Each mock pins a luminary lens. Cold adopters see a result in five minutes."
 inputs: [A UI surface intent or design goal]
 outputs: [2-3 clickable mock variants, Luminary lens per variant]
 tier: lite
 user_invocable: true
 disable_model_invocation: false
+modes: [full, local, scratch]
 composes_with: [interpret-input, luminary, visual-review]
 ---
 
@@ -70,15 +71,55 @@ Standard adopters can bypass `/riff`. They invoke `/stage` directly for the full
 
 Per canvas `docs/canvases/2026-08-02-porcelain-plumbing-reframe.md` — 10 of 10 luminaries agreed on the reframe.
 
+## Modes (per bassclef-upstream#1909)
+
+Three modes let the skill run in any environment:
+
+- **full** — git repo + gh auth + Playwright MCP + network. Ships PR + screenshots.
+- **local** — git repo present. No PR. No screenshots. Artifacts land on disk.
+- **scratch** — no git. Writes to a tmp dir. No PR. No screenshots. Fastest path for cold adopters.
+
+Cold adopters typing `/riff` on a fresh Saturday hit **local** or **scratch** by default. They see a viewable result. No BLOCK on missing MCP.
+
+The mode picker sits at Phase −1. It reads four probes from `lib/capability-probe.sh`. It picks the highest-fidelity mode the environment supports. Operator can override with `--mode=<name>`. The picker validates the requested mode's requirements. If a required capability is missing, the parser exits with a plain-language error.
+
 ## Procedure
 
+0. **Phase −1 — pick the mode.** Source the probe lib. Read four capability probes. Resolve a mode. Announce it. This step short-circuits `probe_network` when the other three probes already downgrade the mode below `full` (RFC C2 folded).
+
+   ```bash
+   source "${BASSCLEF_DIR:-$REPO_ROOT}/lib/capability-probe.sh"
+
+   probe_git; GIT=$?
+   probe_mcp_playwright; MCP=$?
+   probe_gh_auth; GH=$?
+
+   # Short-circuit: only probe network when other capabilities support full mode
+   if [ $GIT -eq 0 ] && [ $MCP -eq 0 ] && [ $GH -eq 0 ]; then
+     probe_network; NET=$?
+   else
+     NET=1
+   fi
+
+   # Convert exit codes to booleans (0 = present)
+   G=$([ $GIT -eq 0 ] && echo 1 || echo 0)
+   M=$([ $MCP -eq 0 ] && echo 1 || echo 0)
+   H=$([ $GH  -eq 0 ] && echo 1 || echo 0)
+   N=$([ $NET -eq 0 ] && echo 1 || echo 0)
+
+   # Operator override reads --mode=<name>; parser validates before dispatch
+   MODE="${OVERRIDE_MODE:-$(resolve_mode "$G" "$H" "$M" "$N")}"
+   validate_mode "$MODE" "$G" "$H" "$M" "$N" || exit 1
+   announce_mode "$MODE" "/riff"
+   ```
+
 1. Parse the operator's input via `/interpret-input`. Output: normalized InputArtifact.
 2. Pick 2-3 luminary lenses. Either operator-named or via `/luminary` picker.
-3. For each lens: author a static HTML mock. Path: `docs/prototypes/YYYY-MM-DD-riff-<slug>-variant-N/index.html`. Stubbed data. Include a `<h2>` naming the lens.
-4. Screenshot each variant via Playwright MCP. Save under `.playwright-mcp/`.
-5. Assemble a gallery page. Link every variant. Show screenshots inline. Show luminary tags.
-6. Run `/visual-review` on each variant. Report findings per variant.
-7. Present the gallery URL to the operator. Operator picks. Picked variant flows into `/build` or `/launch` at standard.
+3. For each lens: author a static HTML mock. Path in `full` and `local` modes: `docs/prototypes/YYYY-MM-DD-riff-<slug>-variant-N/index.html`. Path in `scratch` mode: `${TMPDIR:-/tmp}/riff-<slug>-variant-N/index.html`. Stubbed data. Include a `<h2>` naming the lens.
+4. **Screenshots — mode-gated.** In `full` mode, screenshot each variant via Playwright MCP and save under `.playwright-mcp/`. In `local` and `scratch` modes, skip this step and note in the gallery output that screenshots are absent because the environment did not have Playwright MCP.
+5. Assemble a gallery page. Link every variant. Show screenshots inline when present. Show luminary tags in every mode.
+6. Run `/visual-review` in `full` mode. In `local` and `scratch` modes, run the self-review checklist against each variant instead. Report findings per variant.
+7. Present the gallery URL to the operator. In `full` mode, open a PR. In `local` mode, print the disk path. In `scratch` mode, print the tmp path and a note that the gallery does not survive reboot. Picked variant flows into `/build` or `/launch` at standard.
 
 ## Baseline composition
 
@@ -93,11 +134,12 @@ Per canvas `docs/canvases/2026-08-02-porcelain-plumbing-reframe.md` — 10 of 10
 
 ## Rules
 
-- MUST produce a PR. Push to a feature branch, not main.
-- MUST run on a feature branch.
-- MUST screenshot every variant via Playwright MCP. BLOCK if MCP not enabled.
-- MUST tag each variant with its luminary lens in the HTML.
-- MUST report per-variant `/visual-review` findings with the gallery link.
+- MUST produce a PR when running in `full` mode. Push to a feature branch, not main.
+- MUST run on a feature branch when git is present. Scratch mode has no branch.
+- MUST screenshot every variant via Playwright MCP when running in `full` mode. In `local` and `scratch` modes, skip screenshots and note the reason in the gallery output. (Per bassclef-upstream#1909 — the prior BLOCK broke cold adopters.)
+- MUST tag each variant with its luminary lens in the HTML in every mode.
+- MUST report per-variant `/visual-review` findings in `full` mode. In `local` and `scratch` modes, run the self-review checklist and report findings the same way.
+- MUST print the mode announcement line at Phase −1. STDOUT stays untouched; the line prints to STDERR so parsers stay clean (RFC R1 folded per `docs/risk-ledgers/2026-09-23-graceful-degrade.md`).
 
 ## Refs
 

package/dist/lite/bassclef-version.json

@@ -1,7 +1,7 @@
 {
-  "version": "v1.2.0",
-  "marker_tag": "release-2026-09-22-a26d8936",
-  "release_date": "2026-09-22T11:04:29Z",
-  "release_sha": "a26d8936",
-  "release_tag": "release-2026-09-22-a26d8936"
+  "version": "v1.4.0",
+  "marker_tag": "release-2026-09-24-f36b8f31",
+  "release_date": "2026-09-24T01:12:22Z",
+  "release_sha": "f36b8f31",
+  "release_tag": "release-2026-09-24-f36b8f31"
 }

package/dist/lite/lib/capability-probe.sh

@@ -0,0 +1,140 @@
+#!/usr/bin/env bash
+# tier: lite
+# lib/capability-probe.sh — capability probe deep module.
+#
+# Per @luminary john-ousterhout deep module: hides several probe strategies
+# behind a narrow interface. Downstream SKILLs source this lib and ask what
+# mode fits the environment. Probe strategies can change without touching
+# any SKILL.
+#
+# Exposed functions:
+#   probe_git()             — 0 inside git repo, 1 otherwise
+#   probe_gh_auth()         — 0 when authenticated to GitHub, 1 otherwise
+#   probe_mcp_playwright()  — 0 when Playwright MCP loaded, 1 otherwise
+#   probe_network()         — 0 when network reachable, 1 otherwise (or OFFLINE=1)
+#   resolve_mode g gh m n   — echoes "full" | "local" | "scratch"
+#   validate_mode m g gh m n — 0 if mode requirements met, 1 otherwise
+#   announce_mode m skill   — prints "<skill>: running in <m> mode — <reason>" to stderr
+#
+# Per bassclef-upstream#1909 + spec docs/specs/2026-09-23-graceful-degrade-skills.md.
+# Every probe fail-soft. Never throws.
+
+# --- Individual probes -------------------------------------------------------
+
+probe_git() {
+  # Short-circuit if git binary absent
+  command -v git >/dev/null 2>&1 || return 1
+  if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+    return 0
+  fi
+  return 1
+}
+
+probe_gh_auth() {
+  # Fast path: token env vars indicate auth intent + presence.
+  if [ -n "${GH_TOKEN:-}" ] || [ -n "${GITHUB_TOKEN:-}" ]; then
+    return 0
+  fi
+  # Slow path: gh CLI must be present + authenticated.
+  command -v gh >/dev/null 2>&1 || return 1
+  if gh auth status >/dev/null 2>&1; then
+    return 0
+  fi
+  return 1
+}
+
+probe_mcp_playwright() {
+  # V1 heuristic — env var contract. V2 may read tool inventory.
+  [ -n "${CLAUDE_MCP_PLAYWRIGHT:-}" ] && return 0
+  return 1
+}
+
+probe_network() {
+  # Short-circuit: OFFLINE=1 skips the wire call entirely.
+  [ -n "${OFFLINE:-}" ] && return 1
+  command -v curl >/dev/null 2>&1 || return 1
+  if curl -sSf --max-time 2 "${BASSCLEF_NETWORK_PROBE_URL:-https://api.github.com/zen}" >/dev/null 2>&1; then
+    return 0
+  fi
+  return 1
+}
+
+# --- Mode resolution ---------------------------------------------------------
+
+# resolve_mode <git> <gh> <mcp> <network>
+# Each arg is "0" or "1" per the probe result convention (1 = capability present).
+# Prints one of: "full" | "local" | "scratch".
+resolve_mode() {
+  local git="${1:-0}" gh="${2:-0}" mcp="${3:-0}" net="${4:-0}"
+  if [ "$git" = "1" ] && [ "$gh" = "1" ] && [ "$mcp" = "1" ] && [ "$net" = "1" ]; then
+    echo "full"
+  elif [ "$git" = "1" ]; then
+    echo "local"
+  else
+    echo "scratch"
+  fi
+}
+
+# validate_mode <mode> <git> <gh> <mcp> <net>
+# Returns 0 when the mode's requirements are met, 1 otherwise.
+# Stderr names the missing capability on failure.
+validate_mode() {
+  local mode="${1:-}" git="${2:-0}" gh="${3:-0}" mcp="${4:-0}" net="${5:-0}"
+  case "$mode" in
+    full)
+      [ "$git" = "1" ] || { echo "validate_mode: full requires git (not present)" >&2; return 1; }
+      [ "$gh"  = "1" ] || { echo "validate_mode: full requires gh auth (not present)" >&2; return 1; }
+      [ "$mcp" = "1" ] || { echo "validate_mode: full requires MCP (CLAUDE_MCP_PLAYWRIGHT not set)" >&2; return 1; }
+      [ "$net" = "1" ] || { echo "validate_mode: full requires network (probe failed)" >&2; return 1; }
+      return 0
+      ;;
+    local)
+      [ "$git" = "1" ] || { echo "validate_mode: local requires git (not present)" >&2; return 1; }
+      return 0
+      ;;
+    scratch)
+      return 0
+      ;;
+    *)
+      echo "validate_mode: '$mode' is not a valid mode (expected: full | local | scratch)" >&2
+      return 1
+      ;;
+  esac
+}
+
+# --- Announcement ------------------------------------------------------------
+
+# announce_mode <mode> <skill-name>
+# Prints one line to stderr naming the picked mode and the reason.
+# Honors SKIP_MODE_ANNOUNCE=1 to suppress the line (useful for scripted runs).
+# STDOUT is untouched — parsers relying on STDOUT stay clean (R1 folded).
+announce_mode() {
+  [ -n "${SKIP_MODE_ANNOUNCE:-}" ] && return 0
+  local mode="${1:-}" skill="${2:-}"
+  local reason
+  case "$mode" in
+    full)    reason="all capabilities present" ;;
+    local)   reason="one or more of gh, MCP, or network missing; disk-only" ;;
+    scratch) reason="no git repo detected; using scratch dir" ;;
+    *)       reason="unknown mode" ;;
+  esac
+  echo "${skill}: running in \`${mode}\` mode — ${reason}. Say \`--mode=<other>\` to override." >&2
+}
+
+# --- Lib self-check on source ------------------------------------------------
+# Per R13 folded (Nygard stability): a broken lib should not silently return
+# FALSE for everything. Emit a WARN if any required function is missing.
+__bassclef_capability_probe_self_check() {
+  local missing=""
+  local f
+  for f in probe_git probe_gh_auth probe_mcp_playwright probe_network resolve_mode validate_mode announce_mode; do
+    type -t "$f" >/dev/null 2>&1 || missing="$missing $f"
+  done
+  if [ -n "$missing" ]; then
+    echo "WARN: lib/capability-probe.sh is missing functions:$missing" >&2
+    return 1
+  fi
+  return 0
+}
+
+__bassclef_capability_probe_self_check || true

package/dist/lite/presence/install/bassclef-sync.dispatcher.template.sh

@@ -126,6 +126,45 @@ bassclef_sync_resolve_pointer_file() {
   fi
 }
 
+# bassclef_sync_bundled_substrate_present <cwd>
+#
+# Returns 0 (yes) when .claude/hooks/, .claude/rules/, .claude/skills/ all
+# exist AND contain at least one file (recursively). Returns 1 (no) when
+# any of those conditions fails.
+#
+# Cures the npm-only cold adopter false-error class per
+# bassclef-upstream#1849. The dispatcher was designed for peer-checkout
+# OR source-config models. Neither works for anonymous adopters against
+# private repos. But the npm bundle already unpacks substrate at install
+# time. The fetch failure is not a real failure; this check catches the
+# steady state and lets the dispatcher exit silently.
+#
+# Composes with:
+#   @luminary alan-cooper — Sam persona; silent-on-success matches user model
+#   @luminary donald-norman — signifier; false-positive banner erodes real signal
+#   @luminary linus-torvalds — adopter contract; npm bundle IS the substrate
+#   @luminary michael-feathers — characterization tests over 3 install shapes
+#
+# Tests: .claude/hooks/tests/bassclef-sync-bundled-substrate-check.test.sh
+# Refs: bassclef-upstream#1849
+bassclef_sync_bundled_substrate_present() {
+  local cwd="${1:-}"
+  if [ -z "$cwd" ] || [ ! -d "$cwd" ]; then
+    return 1
+  fi
+  local _dir
+  for _dir in .claude/hooks .claude/rules .claude/skills; do
+    if [ ! -d "$cwd/$_dir" ]; then
+      return 1
+    fi
+    # Nonempty check: at least one file anywhere under the dir.
+    if [ -z "$(find "$cwd/$_dir" -mindepth 1 -maxdepth 4 -type f -print -quit 2>/dev/null)" ]; then
+      return 1
+    fi
+  done
+  return 0
+}
+
 bassclef_sync_self_heal_pointer() {
   local cwd="${1:-$CWD}"
   if [ "${SKIP_SELF_HEAL_POINTER:-0}" = "1" ]; then
@@ -713,6 +752,21 @@ if [ -f "$SIBLING_TEMPLATE" ]; then
   exit $?
 fi
 
+# === Path 1.5. Bundled-substrate recognition (per #1849) ===
+# npm-only cold adopters carry substrate in the package bundle. The
+# dispatcher was designed for peer-checkout OR source-config models; both
+# fail for anonymous adopters against private repos. Before firing the
+# fetch-strategies path, check whether the substrate is already loaded at
+# CWD. If yes, exit silently — no news is good news (Cooper).
+#
+# Override: BASSCLEF_DISPATCHER_STRICT=1 forces the Path 2 fetch even when
+# bundled substrate is present (operator debugging).
+if [ "${BASSCLEF_DISPATCHER_STRICT:-0}" != "1" ]; then
+  if bassclef_sync_bundled_substrate_present "$CWD"; then
+    exit 0
+  fi
+fi
+
 # === Path 2. Curl fallback ===
 # Uses the same resolver as auto_sync pre-check so old-name adopters
 # still get here (self-heal already fired above, but resolve for safety

package/dist/lite/presence/install/bassclef-sync.template.sh

@@ -256,6 +256,42 @@ bassclef_sync_parse_whereami_ts() {
   return 0
 }
 
+# === #1929 — postcondition emitter (RESTORED/DEGRADED + JSON) ===
+# Mirrors .claude/hooks/bassclef-sync.sh L215-243 (idempotent-complete-or-fail-loud
+# pattern shipped under #1894 Cure 1 of #1691). Reads globals INSTALLED_COUNT,
+# FAILED_COUNT, SKIPPED_INVALID, SKIPPED_TOTAL, missing_paths[], missing_scopes[]
+# set by the install loop below. Emits exactly one human line + one JSON status
+# line. Defined ABOVE the BASSCLEF_SYNC_TEST_MODE guard so tests can source and
+# invoke directly.
+#
+# Anchor luminaries — @luminary linus-torvalds (adopter contract), @luminary
+# michael-nygard (fail-loud stability), @luminary jerome-saltzer-and-michael-schroeder
+# (complete mediation across both callers).
+_template_emit_install_postcondition() {
+  local installed="${INSTALLED_COUNT:-0}"
+  local failed="${FAILED_COUNT:-0}"
+  local skipped_invalid="${SKIPPED_INVALID:-0}"
+  local skipped_total="${SKIPPED_TOTAL:-0}"
+  local total=$((installed + skipped_total + failed))
+  local defect_total=$((failed + skipped_invalid))
+
+  if [ "$defect_total" = "0" ]; then
+    # RESTORED — human line + minimal JSON status:complete
+    echo "bassclef-sync: RESTORED — $installed of $total hooks resolved at their scoped targets."
+    printf 'bassclef-sync: {"status":"complete","installed":%d}\n' "$installed"
+  else
+    # DEGRADED — human line + JSON with missing[] carrying path + scope + cure per entry
+    echo "bassclef-sync: DEGRADED — $defect_total of $total hooks did not resolve after self-heal."
+    local i missing_json="["
+    for i in "${!missing_paths[@]}"; do
+      [ "$i" -gt 0 ] && missing_json="$missing_json,"
+      missing_json="$missing_json{\"path\":\"${missing_paths[$i]}\",\"scope\":\"${missing_scopes[$i]}\",\"cure\":\"bassclef init --force\"}"
+    done
+    missing_json="$missing_json]"
+    printf 'bassclef-sync: {"status":"degraded","installed":%d,"missing":%s}\n' "$installed" "$missing_json"
+  fi
+}
+
 # === Test-mode early return (#897 Cure A) ===
 # Tests source this template to access helper functions (see
 # .claude/hooks/tests/bassclef-sync-*.test.sh). Early return under
@@ -898,6 +934,9 @@ SKIPPED_NO_HEADER=0
 SKIPPED_INVALID=0
 SKIPPED_LIB_MISSING=0
 FAILED_COUNT=0
+# #1929 — missing[] capture for RESTORED/DEGRADED postcondition
+missing_paths=()
+missing_scopes=()
 
 mkdir -p "$HOME/.claude/hooks" 2>/dev/null || true
 
@@ -933,6 +972,8 @@ if [ -d "$BASSCLEF_DIR/.claude/hooks" ]; then
       if [ -n "$_WALKER_MISS" ]; then
         echo "$(date -u +%FT%TZ) install-fail-missing-dep $HOOK_NAME" >> "$BASSCLEF_TRACE_LOG"
         FAILED_COUNT=$((FAILED_COUNT + 1))
+        missing_paths+=(".claude/hooks/$HOOK_NAME")
+        missing_scopes+=("operator")
         continue
       fi
 
@@ -947,6 +988,8 @@ if [ -d "$BASSCLEF_DIR/.claude/hooks" ]; then
         chmod +x "$TARGET_USER" 2>/dev/null || true
         echo "$(date -u +%FT%TZ) dispatch-fail $HOOK_NAME" >> "$BASSCLEF_TRACE_LOG"
         FAILED_COUNT=$((FAILED_COUNT + 1))
+        missing_paths+=(".claude/hooks/$HOOK_NAME")
+        missing_scopes+=("operator")
       fi
     elif [ "$HAS_HEADER" = "1" ] && [ "$DISPATCH_AVAILABLE" = "0" ]; then
       # S-F1 MED — dispatch lib missing; trace explicitly (not silent)
@@ -965,6 +1008,8 @@ if [ -d "$BASSCLEF_DIR/.claude/hooks" ]; then
       else
         echo "$(date -u +%FT%TZ) skipped-invalid-header $HOOK_NAME" >> "$BASSCLEF_TRACE_LOG"
         SKIPPED_INVALID=$((SKIPPED_INVALID + 1))
+        missing_paths+=(".claude/hooks/$HOOK_NAME")
+        missing_scopes+=("operator")
       fi
     fi
   done
@@ -1005,6 +1050,12 @@ fi
 
 # N-F1 MED — install summary with reason breakdown when non-zero
 SKIPPED_TOTAL=$((SKIPPED_NO_HEADER + SKIPPED_INVALID + SKIPPED_LIB_MISSING))
+
+# #1929 — RESTORED/DEGRADED + JSON postcondition (mirrors operator hook L215-243).
+# Retains the legacy breakdown line for adopters parsing the old shape.
+_template_emit_install_postcondition
+
+# RFC-0008 F7 legacy — plain-English breakdown line preserved for parser contract.
 if [ "$SKIPPED_TOTAL" = "0" ] && [ "$FAILED_COUNT" = "0" ]; then
   echo "bassclef-sync: installed $INSTALLED_COUNT hooks; skipped 0; failed 0"
 else

package/dist/lite/standards/bassclef-wiring-manifest.json

@@ -165,6 +165,12 @@
             "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/pre-commit-identifier-leak-scrub.sh",
             "timeout": 10,
             "tier": "lite"
+          },
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/git-stash-u-guard.sh",
+            "timeout": 5,
+            "tier": "lite"
           }
         ]
       },

package/dist/lite/standards/lite-manifest.json

@@ -1,7 +1,7 @@
 {
   "tier": "lite",
-  "manifest_version": "1.9.11",
-  "generated_at": "2026-09-22T06:14:43Z",
+  "manifest_version": "1.11.0",
+  "generated_at": "2026-09-24T00:06:17Z",
   "entries": [
     {
       "slug": "029-release-pipeline",
@@ -91,6 +91,14 @@
       "content_hash": "sha256:732f8c5a9c2e206f55246aafbdd7fd5c2fa2a154b37b7281b238f0b1175e1ba0",
       "description": "00-bassclef-hook-connect.sh — Auto-connect bassclef hooks to adopter settings.json."
     },
+    {
+      "slug": "01-adopter-message-channel",
+      "type": "hook",
+      "path": ".claude/hooks/session-reflection.d/01-adopter-message-channel.sh",
+      "tier": "lite",
+      "content_hash": "sha256:c2831a9400ef8cacc4d79ed4bb3c8696a1b89826c7a9ece52e373a2c30f36e8c",
+      "description": "SessionStart fragment — adopter message channel (bassclef-upstream#1926)"
+    },
     {
       "slug": "05-active-bet",
       "type": "hook",
@@ -232,7 +240,7 @@
       "type": "hook",
       "path": ".claude/hooks/session-reflection.d/80-hook-heartbeat-check.sh",
       "tier": "lite",
-      "content_hash": "sha256:fa72927b90d4f6f57733249f41f2353f930b84c18003c53f7a15c98eb8045e45",
+      "content_hash": "sha256:0955f4045ae979d6d11102b6aa711f74c3bf2683754beb1d2587e9debcdef30c",
       "description": "Hook heartbeat check — reads standards/hook-cadence.json, calls"
     },
     {
@@ -387,6 +395,14 @@
       "content_hash": "sha256:c923c8081ce4055060ac9d3e2f0a6a7f245087b96098a5c610196d74fc5ba97b",
       "description": "file-rename-discipline-check — PreToolUse hook that blocks `git commit`"
     },
+    {
+      "slug": "git-stash-u-guard",
+      "type": "hook",
+      "path": ".claude/hooks/git-stash-u-guard.sh",
+      "tier": "lite",
+      "content_hash": "sha256:23e45017aa058d6110a327e5e74a70233333b64a0d9c09c5f03549fb58c42add",
+      "description": "PreToolUse: Bash"
+    },
     {
       "slug": "hook-classifier-canary",
       "type": "hook",
@@ -723,6 +739,14 @@
       "content_hash": "sha256:10d42c54a64415f7e9b4f2a6701d57ffc89cc9d59ec0fec9ddc2af3c178855a2",
       "description": "bassclef-dir-resolver.sh — resolve BASSCLEF_DIR across install layouts."
     },
+    {
+      "slug": "capability-probe",
+      "type": "lib",
+      "path": "lib/capability-probe.sh",
+      "tier": "lite",
+      "content_hash": "sha256:12d4d7cfa78bd07e1f67a405a88b960ac62ac637297698d8ca43f217b74f4de0",
+      "description": "lib/capability-probe.sh — capability probe deep module."
+    },
     {
       "slug": "clean-artifacts-sweep",
       "type": "lib",
@@ -1287,7 +1311,7 @@
       "type": "presence-template",
       "path": "presence/install/bassclef-sync.dispatcher.template.sh",
       "tier": "lite",
-      "content_hash": "sha256:b94d6f09c8539c09918f79904c4bcbd50d1e5e44481c6bf641a60810dd117298",
+      "content_hash": "sha256:0c5eb10d58174652549d403cec382fc801a3fa7f7b3e4496dbf2eb5dcfffc2ac",
       "description": "description: Retagged standard → lite per #1301 concentric rule (ADR-052 D1) —"
     },
     {
@@ -1295,7 +1319,7 @@
       "type": "presence-template",
       "path": "presence/install/bassclef-sync.template.sh",
       "tier": "lite",
-      "content_hash": "sha256:0a689f73d94bb78d1a3e7fdb3cda760e093db1d7536548cb05cf3a9ea9fb4c6c",
+      "content_hash": "sha256:a122102a034d07ec9a7c4b23e078707160b58aa5409a05eb6e30290fd8c27fb0",
       "description": "description: BASSCLEF_SYNC_VERSION=2026-09-06-1496-sessionstart-heal-v1"
     },
     {
@@ -2146,8 +2170,8 @@
       "type": "skill",
       "path": ".claude/skills/build/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:be80d5fb771cf7665f7db67f8089229620b14b3e7757c298e516acf488680aaa",
-      "description": "Take a buildable plan and ship it. Reads a spec from /launch. Dispatches a builder per user story. Runs /verify. Opens PRs. Gates prod deploy on a human. Refuses auth, schema, security, and tenant work. --explain narrates first.",
+      "content_hash": "sha256:ef8f6b7872a29f74e8a9c181ab0b7c24f7c93bfc76b05baaf4cee4703318b10c",
+      "description": "Take a plan from /launch and ship it. One builder per user story. Runs /verify. Opens PRs. Gates prod on a human. Refuses auth, schema, security, and tenant work. Two modes — full and degrade-with-note.",
       "inputs": [
         "A goal slug pointing to a spec on disk"
       ],
@@ -2534,8 +2558,8 @@
       "type": "skill",
       "path": ".claude/skills/launch/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:a99fd150c677290ef82423318cab4ff8abcda109a2b2c2371847b53e026cd17e",
-      "description": "Compare variants of an idea. Ships a mock gallery with an Anthropic baseline. You pick a direction from the phone. Get the spec plus user stories. Get the decomposition plus a migration plan. Two sizes: medium and full.",
+      "content_hash": "sha256:35763f40fe046500da02f8d37ff4e6984e18ab08b64ed0eaa3c4095d90a22225",
+      "description": "Compare variants of an idea. Get a mock gallery. Pick a direction. Get a spec, user stories, and a plan to build. Two sizes — medium and full. Three modes — full, local, scratch.",
       "inputs": [
         "A rough idea or ticket or canvas"
       ],
@@ -2910,8 +2934,8 @@
       "type": "skill",
       "path": ".claude/skills/riff/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:e2a6a45f05df1e7cbc8138fbdcbc9ddf169aaf3b32fd5824b410912412fab0c4",
-      "description": "Produce 2-3 clickable mock alternatives for a UI surface. Includes an Anthropic baseline. Each mock uses a different luminary lens. One picks a marketing variant. Another picks a build direction. Combines /interpret-input + /luminary + /stage + /visual-review.",
+      "content_hash": "sha256:c481ce52be01c6d5e62e8ea07389e7612362b77721228fb59cd1c1c469f327ff",
+      "description": "Produce 2 or 3 clickable mock variants. Each pins a luminary lens. Three modes — full, local, scratch. Full uses git, gh, and screenshots. Local writes to disk only. Scratch uses a tmp dir with no git.",
       "composes_with": [
         "interpret-input",
         "luminary",
@@ -2924,8 +2948,8 @@
         "2-3 clickable mock variants",
         "Luminary lens per variant"
       ],
-      "problem": "Design directions get one variant and no comparison. Operator picks blind. Rework is huge.",
-      "value": "Two or three clickable mocks per UI surface. Each mock pins a different luminary lens."
+      "problem": "Design work gets one variant. No comparison. The operator picks blind. Rework is heavy.",
+      "value": "Two or three mocks per surface. Each mock pins a luminary lens. Cold adopters see a result in five minutes."
     },
     {
       "slug": "riff-prototypes",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thebassclef/lite",
-  "version": "1.7.0",
+  "version": "1.9.0",
   "description": "Bassclef CLI — install and upgrade bassclef in your project with two commands.",
   "keywords": [
     "bassclef",