@thebassclef/lite 1.5.1 → 1.7.0

package/dist/lite/.claude/hooks/session-reflection.d/80-workflow-staleness.sh

@@ -131,7 +131,9 @@ done
 # Surface findings
 if [ "$ANY_BLOCKED" = "1" ]; then
   MSG="workflow-staleness — bassclef workflow(s) failed >${THRESHOLD_HOURS}h ago without recovery:\n$(echo -e "$DETAILS")\nThis is the silent-failure class WU-9d retires. Read the failed run logs (gh run view <id>); root-cause + fix or operator-confirm deferral. Do not silently ignore."
-  blocked_banner "$MSG"
+  # Per standards/session-start-banner-discipline.md — ADVISORY: workflow is
+  # failing but the current session can proceed; operator should investigate.
+  blocked_banner "$MSG" advisory
 elif [ "$ANY_WARN" = "1" ]; then
   echo "### WORKFLOW-STALENESS — WARN (within ${THRESHOLD_HOURS}h grace)"
   echo ""

package/dist/lite/.claude/hooks/session-reflection.d/81-hook-manifest-staleness.sh

@@ -11,6 +11,27 @@
 # works cleanly both sourced AND standalone. Silent-fail on missing
 # manifest or missing jq.
 
+# SELF_MODE guard per bassclef-upstream#1804 — hook manifest staleness only
+# meaningful for adopters watching for hook churn; bassclef-upstream IS
+# the source where new hooks land daily.
+if [ "${SELF_MODE:-0}" = "1" ]; then
+  return 0 2>/dev/null || exit 0
+fi
+
+# Fresh-install gate (bassclef-upstream#1896): on cold adopter install,
+# every hook file's mtime equals install time (recent). The last_manifest_update
+# field is older by design (records when maintainer bumped it upstream). Result:
+# every hook flags as "new not in manifest" — spurious BLOCKED banner on every
+# lite adopter's first session. Cure: skip when no heartbeat markers exist
+# (mirrors 80-hook-heartbeat-check.sh cold-install gate #1818 Ship 3). The gate
+# activates the moment a producer hook fires and writes its first marker.
+# Anchor: @luminary donald-norman — banner fires only when a real problem
+# exists. @luminary michael-feathers — cold-install mtime is characterization
+# baseline; comparing against it produces false positives.
+if [ ! -d "state/markers/hook-heartbeat" ]; then
+  return 0 2>/dev/null || exit 0
+fi
+
 # Probe bundled path first (dist/lite/ ship path per ADR-056 D3), then
 # $BASSCLEF_DIR fallback for synced adopters. Pattern matches
 # session-reflection.sh:11-17. Cures #1732 Phase A silent-fail at operator

package/dist/lite/.claude/hooks/session-reflection.d/95-settings-hook-verify.sh

@@ -111,21 +111,24 @@ while IFS= read -r __shv_file; do
 done <<< "$__shv_settings_files"
 
 if [ -n "$__shv_missing" ]; then
-  blocked_banner "settings-hook-verify" \
-    "Hooks wired in settings.json but missing on disk:" \
-    "$__shv_missing" \
-    "" \
-    "Cure paths:" \
-    "  1. Re-run bassclef-sync.sh to restore vendored/symlinked hooks" \
-    "  2. Edit the settings file and remove the stale entry" \
-    "  3. Override this session: SKIP_SETTINGS_HOOK_VERIFY=1" \
-    "" \
-    "Per bassclef-upstream#888."
+  # Compose one $msg per blocked_banner (msg, severity?) signature.
+  # Prior code passed 10 args; args 3-9 silently dropped because banner
+  # takes only msg + optional severity. Per bassclef-upstream#1897.
+  __shv_msg="Hooks wired in settings.json but missing on disk:
+$__shv_missing
+
+Cure paths:
+  1. Re-run bassclef-sync.sh to restore vendored/symlinked hooks
+  2. Edit the settings file and remove the stale entry
+  3. Override this session: SKIP_SETTINGS_HOOK_VERIFY=1
+
+Per bassclef-upstream#888."
+  blocked_banner "$__shv_msg"
   trace_log "fired" "settings-hook-verify" "missing hooks detected" 2>/dev/null || true
 else
   trace_log "pass" "settings-hook-verify" "all wired hooks resolve" 2>/dev/null || true
 fi
 
 unset __shv_settings_files __shv_project_settings __shv_user_settings \
-      __shv_missing __shv_file
+      __shv_missing __shv_file __shv_msg
 unset -f __shv_check_file __shv_scan_settings

package/dist/lite/.claude/hooks/session-reflection.sh

@@ -85,20 +85,29 @@ blocked_banner() {
   local msg="$1"
   local severity="${2:-blocking}"
   echo ""
-  if [ "$severity" = "advisory" ]; then
-    echo "NOTE"
-    echo "────────────────────────────────────────────"
-    echo "$msg"
-    echo "────────────────────────────────────────────"
-    echo "Worth doing. Not blocking this session."
-  else
-    echo "🛑🛑🛑 BLOCKED 🛑🛑🛑"
-    echo "────────────────────────────────────────────"
-    echo "$msg"
-    echo "────────────────────────────────────────────"
-    echo "ACTION: resolve OR explicitly defer (per .claude/rules/blocked-items.md)."
-    echo "Silence is not deferral. Propose this as item #1 in your session plan."
-  fi
+  case "$severity" in
+    info)
+      echo "ℹ  INFO"
+      echo "────────────────────────────────────────────"
+      echo "$msg"
+      echo "────────────────────────────────────────────"
+      ;;
+    advisory)
+      echo "⚠  ADVISORY"
+      echo "────────────────────────────────────────────"
+      echo "$msg"
+      echo "────────────────────────────────────────────"
+      echo "Worth reading. Not blocking this session."
+      ;;
+    blocking|*)
+      echo "🛑🛑🛑 BLOCKED 🛑🛑🛑"
+      echo "────────────────────────────────────────────"
+      echo "$msg"
+      echo "────────────────────────────────────────────"
+      echo "ACTION: resolve OR explicitly defer (per .claude/rules/blocked-items.md)."
+      echo "Silence is not deferral. Propose this as item #1 in your session plan."
+      ;;
+  esac
   echo ""
 }
 

package/dist/lite/.claude/rules/longrun-prep-plan-doc-compression.md

@@ -13,21 +13,33 @@ This rule is the methodology layer. The mechanism is the /longrun SKILL body Ste
 
 Every `/longrun prep` dispatch. The SKILL body Step 0.85 checks for a plan doc first. When one is found, the compressed prep path fires (converged preset). When none matches, prep falls to exploratory or reversible-small per the picker.
 
-Detection criteria for the converged preset (all three must match):
+Detection fires from three signal sources. The picker checks in precedence order:
+
+**Signal 1 — plan doc present + fresh** (all three must match):
 
 1. File matching `docs/next-session-plan-*.md` exists at repo root
 2. File was modified within the last 48 hours (`find -mtime -2`)
 3. File body contains one of: `## Recommended session sequence`, `## Recommended sequence`, `## Next-session pickup`
 
+**Signal 2 — fresh /state-a-problem marker** (`state/markers/state-a-problem/` `-mtime -2`).
+
+**Signal 3 — whereami PRIMARY queue** (per Q1 /longrun 2026-09-22 Step 1):
+
+1. `docs/whereami.md` carries a `next_in_flight_goal:` line
+2. That line (or its continuation within 10 lines) names PRIMARY candidates in priority order (numbered `(1)`, `(2)` OR the phrase `priority order`)
+3. No unresolved `GATE` line sits above the PRIMARY list (a `GATE — wait for X` inside the same block blocks converged)
+
+Precedence — plan doc wins over problem marker; problem marker wins over whereami PRIMARY. The mechanical helper at `scripts/longrun-preset-detect.sh` encodes this precedence. Test coverage at `scripts/tests/longrun-preset-detect.test.sh` (15 Tier 0 tests).
+
 ## The three presets (per bassclef-upstream#1598)
 
 Per `.claude/skills/longrun/SKILL.md` Step 0.85 picker. Prep renders in the shape that fits the mode:
 
 | Preset | Fires when | Shape |
 |---|---|---|
-| **converged** | Plan doc matches criteria above OR fresh `/state-a-problem` marker present | Lean canvas — Problem + Value + Solution + options table |
-| **exploratory** | No plan doc + operator typed `/longrun` alone + no fresh problem marker | Scan-table dominant — options table + one line per row + recommend row marker |
-| **reversible-small** | Small scope stated in the invocation + won't break other work | Three-chunk compact — one line per option, one recommend line, one action line |
+| **converged** | Any of the three signals above fires (plan doc OR problem marker OR whereami PRIMARY) | Lean canvas — Problem + Value + Solution + options table |
+| **exploratory** | No signal fires; operator typed `/longrun` alone | Scan-table dominant — options table + one line per row + recommend row marker |
+| **reversible-small** | Small scope stated in the invocation + will not break other work | Three-chunk compact — one line per option, one recommend line, one action line |
 
 Ambiguous cases: picker asks `Converged / Exploratory / Small? (c/e/s/skip)`.
 
@@ -72,6 +84,13 @@ INSTEAD of overriding routinely: update the plan doc. A stale plan doc is a bad
 - `.claude/rules/plan-enumeration-needs-value-props.md` — every option in the compressed scan-table still carries a value-prop cell
 - `.claude/rules/blocked-items.md` — silence is not deferral (plan doc detection reports fire vs skip explicitly)
 - `.claude/rules/bootstrap-pair-discipline.md` — this rule + SKILL amendment ship as paired bootstrap
-- @luminary john-ousterhout — deep module (compression path hides plan-doc detection behind narrow interface)
-- @luminary donald-norman — signifier + feedback (plan doc presence is a signifier; compressed vs full ceremony is user feedback)
+- `scripts/longrun-preset-detect.sh` — mechanical detection helper (added Q1 /longrun 2026-09-22 Step 1)
+- `scripts/tests/longrun-preset-detect.test.sh` — Tier 0 test coverage (15 tests) pinning helper behavior
+- `docs/use-cases/UC-rule-longrun-prep-whereami-signal.md` — brief use case for whereami PRIMARY signal
+- @luminary john-ousterhout — deep module (compression path hides detection behind narrow helper interface)
+- @luminary david-parnas — information hiding (rule cites helper; SKILL sources helper; logic in one place)
+- @luminary tony-hoare — pre/postcondition contract (helper input: 3 optional dirs; output: exactly one preset + trigger source)
+- @luminary donald-norman — signifier + feedback (helper prints trigger source to stderr so operator sees which signal fired)
+- @luminary michael-nygard — stability (explicit precedence: plan doc > problem marker > whereami PRIMARY)
+- @luminary michael-feathers — characterization test (fixtures pin REAL whereami shape variants)
 - @luminary frederick-brooks — conceptual integrity (compression preserves the option-table + card + step-card shape; only volume shrinks)

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

@@ -228,5 +228,9 @@
     "$HOME/src/sunj-labs/bassclef/.claude/luminaries",
     "$HOME/src/sunj-labs/bassclef/.claude/agents"
   ],
-  "$schema": "https://bassclef.sunj-labs/state-spine/v0/schemas/bassclef-wiring-manifest.schema.json"
+  "$schema": "https://bassclef.sunj-labs/state-spine/v0/schemas/bassclef-wiring-manifest.schema.json",
+  "statusLine": {
+    "type": "command",
+    "command": "bash ~/.claude/bassclef-statusline.sh"
+  }
 }

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

@@ -207,22 +207,39 @@ The helper stays advisory through 2026-10-31 per ADR-031. Old hooks and libs lan
 
 | Preset | Fires when | Rendered shape |
 |---|---|---|
-| **converged** | Plan doc newer than 48h + carries `## Recommended` section, OR fresh `/state-a-problem` marker present | Lean canvas — Problem + Value + Solution + options table + card on ask |
-| **exploratory** | No plan doc + operator typed `/longrun` alone + no fresh problem marker | Scan-table dominant — options table + one line per row + recommend row marker |
-| **reversible-small** | Small scope stated in the invocation + won't break other work | Three-chunk compact — one line per option, one recommend line, one action line |
+| **converged** | Any of: plan doc newer than 48h + carries `## Recommended`; OR fresh `/state-a-problem` marker; OR whereami `next_in_flight_goal:` carries PRIMARY queue with no unresolved GATE above | Lean canvas — Problem + Value + Solution + options table + card on ask |
+| **exploratory** | No plan doc + operator typed `/longrun` alone + no fresh problem marker + no whereami PRIMARY | Scan-table dominant — options table + one line per row + recommend row marker |
+| **reversible-small** | Small scope stated in the invocation + will not break other work | Three-chunk compact — one line per option, one recommend line, one action line |
 
 Ambiguous cases: picker asks the operator directly — `Converged / Exploratory / Small? (c/e/s/skip)`.
 
-Detection commands:
+Detection helper (per bassclef-upstream#1598 + Q1 /longrun 2026-09-22 Step 1). One call returns one preset. Trigger source goes to stderr.
 
 ```bash
-# Converged signal — plan doc present + fresh
+bash scripts/longrun-preset-detect.sh \
+  --whereami docs/whereami.md \
+  --plan-doc-dir docs \
+  --problem-marker-dir state/markers/state-a-problem
+```
+
+Helper stdout is one of: `converged`, `exploratory`, `reversible-small`, `ambiguous`. Helper stderr names the trigger: `trigger=plan-doc`, `trigger=problem-marker`, `trigger=whereami-PRIMARY`, or `trigger=none`.
+
+Raw detection commands (still valid; the helper wraps these):
+
+```bash
+# Signal 1 — plan doc present + fresh
 find docs -maxdepth 1 -name 'next-session-plan-*.md' -mtime -2 -type f 2>/dev/null | head -1
 
-# Fresh problem statement
+# Signal 2 — fresh problem statement
 find state/markers/state-a-problem -type f -mtime -2 2>/dev/null | head -1
+
+# Signal 3 — whereami PRIMARY queue (added 2026-09-22)
+awk '/^next_in_flight_goal:/{flag=1; n=0} flag {print; n++; if (n>=10) flag=0}' docs/whereami.md \
+  | grep -iE 'primary' | grep -iE '\(1\)|priority order'
 ```
 
+Precedence rule: plan doc wins over problem marker. Problem marker wins over whereami PRIMARY. The helper enforces this order.
+
 The picker writes the preset marker at `state/markers/longrun-preset/<branch>.marker`. Downstream Stop hook reads the marker + applies the per-preset axis set from `.claude/rules/compounding-sequence-fresh-analysis.md` § Per-preset axis sets.
 
 Converged preset triggers Step 0.75 shipped-state check first. When any recommended path lands SHIPPED, prep reshapes to exploratory automatically.

package/dist/lite/bassclef-version.json

@@ -0,0 +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"
+}

package/dist/lite/gitignore

@@ -1,12 +1,20 @@
 # Bassclef adopter .gitignore template
 # Ships via bassclef init from presence/dist-templates/.gitignore per goal 12e Step 3.
 #
+# Substrate tracked-by-default policy (per bassclef-upstream#1691 Cure 3 Path A):
+#   Substrate files under .claude/hooks/, .claude/skills/, .claude/rules/,
+#   .claude/agents/, .claude/luminaries/ are NOT ignored here. Adopters
+#   commit them so `git stash -u` does not grab them and Stop hooks do
+#   not fail. See .claude/bassclef-orientation.md for the opt-out recipe
+#   if you prefer substrate gitignored.
+#
 # Reasoning:
 #   - state/markers/* — session-local telemetry (per feedback-marker-paths-real-files-not-symlinks memory)
 #   - state/session-locks/ + state/session-timing/ — session-scoped ephemeral state
 #   - state/tier-accounting/ + state/luminary-implementations/ — walker output; regenerated on demand
 #   - dist/ — build output (per goal 12e Step 2 build-adopter-tree.sh)
 #   - .claude/hooks/logs/ — hook trace logs (operator-only)
+#   - .claude/hooks/*.trace — hook trace output (operator-only)
 #   - node_modules/ — universal
 #   - .DS_Store — macOS metadata
 #

package/dist/lite/lib/mechanism-fidelity.sh

@@ -469,6 +469,29 @@ _classify_via_patterns_json() {
   return 1
 }
 
+# === _install_pattern_classification (private helper for Layer 2) ===
+# Reads classification_when_unwired for a given pattern name from the JSON.
+# Returns 0 + emits label on success; returns 1 if pattern missing or JSON
+# not available. Enables Parnas info-hiding — each label lives as a
+# grep-discoverable string in standards/hook-invocation-patterns.json
+# instead of being algorithmically derived at runtime.
+# Per bassclef-upstream#1880 — closes the doc-code drift class.
+_install_pattern_classification() {
+  local candidate="${1:-}"
+  [ -z "$candidate" ] && return 1
+  local project_root="${CLAUDE_PROJECT_DIR:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}"
+  local patterns_json="$project_root/standards/hook-invocation-patterns.json"
+  [ -f "$patterns_json" ] || return 1
+  command -v jq >/dev/null 2>&1 || return 1
+  local label
+  label=$(jq -r --arg n "$candidate" '.patterns[] | select(.name == $n) | .classification_when_unwired' "$patterns_json" 2>/dev/null)
+  if [ -n "$label" ] && [ "$label" != "null" ]; then
+    echo "$label"
+    return 0
+  fi
+  return 1
+}
+
 # === _install_pattern_is_valid (private helper for Layer 2) ===
 # Returns 0 if pattern is in the JSON pattern list OR in the hardcoded
 # fallback list (ci|launchd|lib|release|standard). Returns 1 otherwise.
@@ -556,10 +579,17 @@ classify_finding() {
     # Hook lives on disk but settings.json wiring absent.
     # If the hook is meant to live elsewhere (CI / launchd / sourced lib),
     # this is by design, not a failure.
-    # Layer 2 (bassclef-upstream#1163) — algorithmic label derivation:
-    # "standard" → DEAD-LETTER; anything else → NOT-WIRED-BY-DESIGN-<UPPER>.
-    # New patterns land in standards/hook-invocation-patterns.json; their
-    # classification label flows through this branch without cascade edits.
+    # Layer 2 + bassclef-upstream#1880 — read classification_when_unwired
+    # from JSON so each label lives as a grep-discoverable string in
+    # standards/hook-invocation-patterns.json. Falls back to algorithmic
+    # derivation if JSON missing (defensive per @luminary michael-nygard).
+    local label
+    label=$(_install_pattern_classification "$install_pattern" 2>/dev/null)
+    if [ -n "$label" ]; then
+      echo "$label"
+      return 0
+    fi
+    # Fallback — hardcoded/algorithmic derivation when JSON unavailable
     if [ "$install_pattern" = "standard" ]; then
       echo "DEAD-LETTER"
       return 0

package/dist/lite/lib/source-graph-walker.sh

@@ -58,14 +58,41 @@ _sgw_init_cache() {
 # Extract every .sh literal ref from a shell file — the walker's resolve
 # step filters to only paths that map to real files, so false-positive
 # extractions are cheap.
+#
+# Post-filter (#1889): reject refs containing regex metacharacters —
+# [^, \., .*, .+ — which appear when hooks grep for `.sh` patterns in
+# other files. The suffix-fallback in _sgw_resolve_ref_in_repo would
+# otherwise map these to phantom paths (e.g., `/[^/]+\.sh` resolves
+# to a real hook via suffix extraction).
+#
+# NOT tightened to invocation-only extraction (`source X`/`bash X`)
+# because many hooks assign paths to vars first, then invoke via the
+# var later — `X_PATH="path/to/x.sh"; source "$X_PATH"`. The extractor
+# would miss X_PATH's target line and the resolver could not follow.
+# See docs/risk-ledgers/2026-09-21-source-graph-walker-tighten.md
+# for the design decision to keep raw extraction + post-filter.
+#
+# Env-var escape: BASSCLEF_SGW_REGEX_FILTER=0 restores prior extractor
+# behavior (no post-filter). For rescue when a real path contains a
+# regex metacharacter (rare — paths never contain [^, \., .*, .+ in
+# bassclef substrate).
 _sgw_extract_all_refs() {
   local file="$1"
+  local raw
 
   # 1. Every .sh literal in the file (quoted or path-shaped), from non-comment lines
-  grep -vE '^[[:space:]]*#' "$file" 2>/dev/null | \
+  raw=$(grep -vE '^[[:space:]]*#' "$file" 2>/dev/null | \
     grep -oE '"[^"]+\.sh"|'"'"'[^'"'"']+\.sh'"'"'|\$\{[^}]+\}/[^"'"'"'[:space:]]+\.sh|[$][A-Za-z_][A-Za-z0-9_]*/[^"'"'"'[:space:]]+\.sh|(\./|\.\./|/)[^"'"'"'[:space:]$]+\.sh' 2>/dev/null | \
     tr -d '"'"'"'"' | \
-    sort -u
+    sort -u)
+
+  # Post-filter (#1889) — drop refs with regex metacharacters.
+  # Escape via BASSCLEF_SGW_REGEX_FILTER=0.
+  if [ "${BASSCLEF_SGW_REGEX_FILTER:-1}" = "1" ] && [ -n "$raw" ]; then
+    echo "$raw" | grep -vE '\[\^|\\\.|\.\*|\.\+' 2>/dev/null || true
+  else
+    echo "$raw"
+  fi
 
   # 2. Glob-source patterns — for loops iterating dir/*.sh
   grep -oE 'for[[:space:]]+[[:alnum:]_]+[[:space:]]+in[[:space:]]+[^;$]+/\*\.sh' "$file" 2>/dev/null | \

package/dist/lite/presence/cli/bassclef-statusline.dispatcher.sh

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+# tier: standard
+# BASSCLEF_SYNC_VERSION=thin-pointer-statusline-2026-06-22
+# ^^ DO NOT REMOVE — used by Surface 4 self-heal (migrate-adopter-references.sh)
+#    + bassclef-side drift check. Format: thin-pointer-statusline-YYYY-MM-DD.
+#
+# Thin-pointer bassclef statusline dispatcher.
+#
+# Source of truth for adopters' user-level statusline. Adopters install
+# THIS file at ~/.claude/bassclef-statusline.sh; it finds bassclef's
+# rich impl via sibling fast-path and exec's it on every tick. Substrate
+# updates to the rich impl reach existing adopters because the pointer
+# runs the live file, not a frozen copy.
+#
+# Three paths, tried in order (per #1860):
+#
+#   1. Sibling fast-path: $HOME/src/sunj-labs/bassclef OR /bassclef-upstream
+#      — if presence/cli/bassclef-statusline.sh exists and is executable,
+#        exec it with stdin piped through.
+#
+#   2. Script-relative: same directory as this dispatcher. Serves adopters
+#      who install only @thebassclef/lite via npm — the tarball ships both
+#      scripts side by side under node_modules/@thebassclef/lite/dist/lite/
+#      presence/cli/. Uses `cd $(dirname); pwd` for macOS + Linux portability
+#      (BSD readlink lacks -f per R15 rfc finding).
+#
+#   3. Fallback: minimal render so SessionStart doesn't crash. Adopter
+#      sees "bassclef · ?" instead of an empty statusline.
+#
+# Always exits 0 — same SessionStart-safe discipline as bassclef-sync
+# dispatcher (per ADR-032).
+#
+# Versioning:
+#   thin-pointer-statusline-2026-06-22 — initial. Bump format when the
+#     dispatcher's contract changes (rare; ideally never).
+#
+# Primary lens: Linus — substrate carries the recovery cost. Adopters
+# don't re-install when the rich impl evolves; the dispatcher's
+# stability is what shields them.
+#
+# Anchor: Hyrum — the version string IS the observable surface adopters
+# can grep to detect drift. Surface 4 self-heal in
+# migrate-adopter-references.sh uses it.
+
+set -u
+
+__bassclef_statusline_version() {
+  echo "thin-pointer-statusline-2026-06-22"
+}
+
+# Read all of stdin so we can pipe it through to the rich impl
+INPUT=$(cat 2>/dev/null || echo "{}")
+
+# Resolve this dispatcher's directory for the script-relative fallback.
+# `cd $(dirname); pwd` is portable across macOS (BSD readlink lacks -f) and
+# Linux (GNU readlink -f works but we don't need it).
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Find rich impl via sibling fast-path, then script-relative fallback
+RICH_IMPL=""
+for CANDIDATE in \
+    "$HOME/src/sunj-labs/bassclef/presence/cli/bassclef-statusline.sh" \
+    "$HOME/src/sunj-labs/bassclef-upstream/presence/cli/bassclef-statusline.sh" \
+    "$SCRIPT_DIR/bassclef-statusline.sh"; do
+  if [ -x "$CANDIDATE" ]; then
+    RICH_IMPL="$CANDIDATE"
+    break
+  fi
+done
+
+if [ -n "$RICH_IMPL" ]; then
+  echo "$INPUT" | bash "$RICH_IMPL"
+  exit 0
+fi
+
+# Fallback — minimal render when no sibling is available
+echo "bassclef · ?"
+exit 0

package/dist/lite/presence/cli/bassclef-statusline.sh

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+# tier: standard
+# bassclef — Claude Code status line.
+# Claude Code pipes session JSON on stdin every tick; whatever we print to stdout
+# becomes the status line (ANSI colors allowed). Requires accepting the workspace
+# trust prompt, same as any shell-executing setting. Keep it ONE short line.
+#
+# Register it in ~/.claude/settings.json — see bassclef-settings.snippet.json.
+# Test:  echo '{"model":{"display_name":"Opus"},"workspace":{"current_dir":"/x/bassline"},"context_window":{"used_percentage":23}}' | bash bassclef-statusline.sh
+
+# Script-relative dir for tarball-layout fallback (#1860). Portable across
+# macOS + Linux — `cd $(dirname); pwd` avoids BSD readlink -f gap. Python
+# picks this up via os.environ; we cannot use __file__ under python3 -c.
+BASSCLEF_STATUSLINE_SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+export BASSCLEF_STATUSLINE_SCRIPT_DIR
+
+python3 -c '
+import sys, json, os
+try:
+    d = json.load(sys.stdin)
+except Exception:
+    d = {}
+model = d.get("model", {}).get("display_name", "?")
+cwd   = d.get("workspace", {}).get("current_dir") or d.get("cwd", "")
+base  = os.path.basename(cwd.rstrip("/")) or "~"
+pct   = d.get("context_window", {}).get("used_percentage")
+
+# Bassclef version segment (bet 2026-07-09d WU-1 / sunj-labs/bassclef-upstream#686).
+# Reads bassclef-version.json. Fallback chain: env var, workspace root,
+# peer sibling ../bassclef/. Prefers .version, falls back to .release_tag.
+# Silent on any failure.
+def read_bassclef_version(cwd):
+    def try_file(path):
+        if not path or not os.path.isfile(path):
+            return None
+        try:
+            with open(path) as f:
+                data = json.load(f)
+        except Exception:
+            return None
+        v = data.get("version") or data.get("release_tag")
+        return v if v else None
+    candidates = []
+    env_path = os.environ.get("BASSCLEF_VERSION_FILE")
+    if env_path:
+        candidates.append(env_path)
+    if cwd:
+        candidates.append(os.path.join(cwd, "bassclef-version.json"))
+        candidates.append(os.path.join(cwd, "..", "bassclef", "bassclef-version.json"))
+    # Script-relative tarball-layout fallback (#1860). Adopters installing
+    # only @thebassclef/lite via npm land under node_modules/@thebassclef/
+    # lite/dist/lite/presence/cli/, with bassclef-version.json two dirs up
+    # at dist/lite/bassclef-version.json. Runs LAST — cwd + peer sibling
+    # still win for adopters with a cloned repo (order per R16 rfc finding).
+    script_dir = os.environ.get("BASSCLEF_STATUSLINE_SCRIPT_DIR")
+    if script_dir:
+        candidates.append(os.path.join(script_dir, "..", "..", "bassclef-version.json"))
+    for p in candidates:
+        v = try_file(p)
+        if v:
+            return v
+    return None
+
+version = read_bassclef_version(cwd)
+
+O = "\033[38;2;232;93;4m"   # burnt orange
+C = "\033[38;2;205;201;189m"# cream
+D = "\033[2m"               # dim
+R = "\033[0m"
+sep = " " + D + "\u00b7" + R + " "       # dim middot
+
+seg = [O + "\U0001D122 bassclef.dev" + R, C + model + R, D + base + R]
+if version:
+    seg.append(D + version + R)
+if pct is not None:
+    seg.append(D + str(pct) + "%" + R)
+sys.stdout.write(sep.join(seg))
+'

package/dist/lite/standards/lite-manifest-schema-changes.md

@@ -34,6 +34,47 @@ Every entry stays in this file for the life of the manifest. Never pruned. When
 
 ## Entries (newest first)
 
+### Q1 /longrun Slice D — session-start banner-tone discipline (v1.9.10 → v1.9.11, 2026-09-22)
+
+- **Change type:** content-add (1 new standard) + content-change (session-reflection.sh + 3 fragments)
+- **Fields:** 431 entries (up from 430). New standard `session-start-banner-discipline`. Content hashes shift on `session-reflection.sh` + 3 exemplar fragments.
+- **Version bump:** v1.9.10 → v1.9.11 (patch; entry added + content-hash changes; no schema shape shift).
+- **Rationale:** bassclef-upstream#1704 Norman + Cooper consult. `blocked_banner` extended to 3-severity palette (info / advisory / blocking). 3 exemplar fragments migrated to advisory tone so Sam's first-run reads context not "broken install."
+- **Downstream cure:** none owed. Existing 27 `blocked_banner` callers keep default `blocking` behavior; adopters see no change unless they update fragments.
+
+### Q1 /longrun Slice C — adopter git safety docs + tracked-by-default policy (v1.9.9 → v1.9.10, 2026-09-22)
+
+- **Change type:** content-change (1 content hash; no entries added or removed)
+- **Fields:** none changed. 430 entries before and after. One `content_hash` value moves — `.claude/bassclef-orientation.md`.
+- **Version bump:** v1.9.9 → v1.9.10 (patch; content-hash change only; no schema shape shift).
+- **Rationale:** bassclef-upstream#1691 Cure 2 + Cure 3 Path A. Orientation.md gains a "Substrate git posture" section explaining tracked-by-default plus a `git stash -u` footgun bullet and adopter opt-out recipe. The `presence/dist-templates/.gitignore` already permits substrate tracking; Slice C confirms with an inline comment naming the policy. No file removal or rewrite. Adopters see zero behavior change unless they read the new section.
+- **Downstream cure:** none owed for adopters. Content-only change; adopters get the docs update via next `bassclef-sync`. Adopter opt-out recipe is documented for the small subset who prefer substrate gitignored.
+
+### Q1 /longrun Slice A — 81-hook-manifest-staleness fresh-install gate (v1.9.8 → v1.9.9, 2026-09-22)
+
+- **Change type:** content-change (1 content hash; no entries added or removed)
+- **Fields:** none changed. 430 entries before and after. One `content_hash` value moves — `hook/81-hook-manifest-staleness`.
+- **Version bump:** v1.9.8 → v1.9.9 (patch; content-hash change only; no schema shape shift).
+- **Rationale:** bassclef-upstream#1896 cure. Cold adopter install produces mtime = install time on every hook. `81-hook-manifest-staleness.sh` compared each hook's mtime to `last_manifest_update` field, flagging every hook as "new not in manifest" on cold install. Added fresh-install gate mirroring `80-hook-heartbeat-check.sh` L39-41 pattern per #1818 Ship 3. Sister SELF_MODE guard also added per #1804 pattern.
+- **Downstream cure:** none owed for adopters. Content-only change; adopters get the fixed hook via next `bassclef-sync`.
+
+### Q1 /longrun Slice B — settings-hook-verify blocked_banner caller cure (v1.9.7 → v1.9.8, 2026-09-22)
+
+- **Change type:** content-change (1 content hash; no entries added or removed)
+- **Fields:** none changed. 430 entries before and after. One `content_hash` value moves — `hook/95-settings-hook-verify`.
+- **Version bump:** v1.9.7 → v1.9.8 (patch; content-hash change only; no schema shape shift).
+- **Rationale:** bassclef-upstream#1897 caller-side cure. `.claude/hooks/session-reflection.d/95-settings-hook-verify.sh` L114-125 rewritten so the 10-arg blocked_banner call serializes into one `$msg` body per the (msg, severity?) signature at `.claude/hooks/session-reflection.sh` L84. Missing-hooks list now surfaces at session-start banner instead of dropping silently. Deep tier-template cure defers to #1901 follow-on.
+- **Downstream cure:** none owed for adopters. Content-only change; adopters get the fixed hook via next `bassclef-sync`.
+
+### Q1 /longrun Step 1 — /longrun Step 0.85 whereami PRIMARY signal (v1.9.6 → v1.9.7, 2026-09-22)
+
+- **Change type:** content-change (2 content hashes; no entries added or removed)
+- **Fields:** none changed. 430 entries before and after. Two `content_hash` values move — `rule/longrun-prep-plan-doc-compression` and `skill/longrun`.
+- **Version bump:** v1.9.6 → v1.9.7 (patch; content-hash change only; no schema shape shift, no entry count change).
+- **Rationale:** bassclef-upstream#1598 extension. `/longrun` Step 0.85 preset picker gains a third converged signal — whereami `next_in_flight_goal:` PRIMARY queue with no unresolved GATE. Rule and SKILL body now cite the new mechanical helper at `scripts/longrun-preset-detect.sh`. Rule adds 4 anchor luminaries. SKILL Step 0.85 detection block adds helper invocation + raw command for signal 3 + precedence note.
+- **Downstream cure:** none. Patch bump; adopters on sync pick it up at the next `bassclef-sync`. The new helper lives at `scripts/longrun-preset-detect.sh` (tier upstream) — adopters do not receive it, only the rule + SKILL prose that cites it.
+- **Old shape retired:** none.
+
 ### Ship 1 — install-class boundary + retag rollout (v1.8.7 → v1.9.0, 2026-09-20)
 
 - **Change type:** entry-removal (3 entries drop) + entry-add (1 template ships) + policy-change (Gate B install-class filter + Gate C wiring/file symmetry check added to generator)