@thebassclef/lite 1.6.0 → 1.7.0

package/README.md

@@ -35,7 +35,7 @@ See [`standards/os-support.md`](standards/os-support.md) for the full policy.
 
 ## Current release
 
-<!-- version-start -->1.6.0<!-- version-end -->
+<!-- version-start -->1.7.0<!-- version-end -->
 
 See [CHANGELOG.md](CHANGELOG.md) for release notes.
 

package/dist/index.cjs

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const version = "1.6.0";
+const version = "1.7.0";
 exports.version = version;

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export declare const version: "1.6.0";
+export declare const version: "1.7.0";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,4 +1,4 @@
-const version = "1.6.0";
+const version = "1.7.0";
 export {
   version
 };

package/dist/lite/.claude/bassclef-orientation.md

@@ -66,6 +66,33 @@ JTBD → HTA → Entity Model → State Diagrams → Sequence Diagrams → /deco
 - **Don't conflate "propose" with "execute".** When operator says "propose," "options," "path forward" — wait for explicit go signal.
 - **Don't use bassclef-internal jargon** in operator-facing prose. Plain English at grade-10 reading level.
 - **Don't push to main without PR review** even on solo workflows.
+- **Don't run `git stash -u` on repos with gitignored substrate.** The `-u` flag moves untracked files to the stash. When your adopter repo gitignores `.claude/hooks/`, `.claude/skills/`, `.claude/rules/`, `.claude/agents/`, or `.claude/luminaries/`, `git stash -u` grabs the substrate files and Stop hooks fail with "No such file or directory" on every tool call. INSTEAD: use plain `git stash` unless you have vetted every untracked file first.
+
+## Substrate git posture
+
+Bassclef ships adopter `.gitignore` (per `presence/dist-templates/.gitignore`) with substrate tracked-by-default. Substrate paths under `.claude/hooks/`, `.claude/skills/`, `.claude/rules/`, `.claude/agents/`, `.claude/luminaries/` are NOT gitignored. Adopters commit substrate so `git stash -u` and similar verbs cannot grab it.
+
+**Opt-out recipe** — if you prefer substrate gitignored in your adopter repo:
+
+1. Add these lines to your `.gitignore`:
+
+   ```
+   .claude/hooks/
+   .claude/skills/
+   .claude/rules/
+   .claude/agents/
+   .claude/luminaries/
+   ```
+
+2. Untrack the files git already indexed:
+
+   ```
+   git rm --cached -r .claude/hooks .claude/skills .claude/rules .claude/agents .claude/luminaries
+   ```
+
+3. Commit the change.
+
+**Caveat.** `bassclef-sync` may re-add substrate files on the next session-start. If that happens, re-run the untrack step. Long-term cure lives with the sync script.
 
 ## Luminaries at design boundaries
 

package/dist/lite/.claude/hooks/session-reflection.d/70-recent-strategic-artifacts.sh

@@ -86,12 +86,14 @@ MSG="${MSG}  explicit operator statement (\"skip recent-artifacts this session\"
 MSG="${MSG}  Override: SKIP_RECENT_ARTIFACTS=1 <command> (logged)."
 
 # Emit via inherited blocked_banner (defined in session-reflection.sh)
+# Per standards/session-start-banner-discipline.md — this check is ADVISORY:
+# recent strategic artifacts are context worth reading; session may proceed.
 if type blocked_banner >/dev/null 2>&1; then
-  blocked_banner "$MSG"
+  blocked_banner "$MSG" advisory
 else
   # Defensive fallback if module is invoked outside the coordinator
   echo ""
-  echo "🛑🛑🛑 BLOCKED 🛑🛑🛑"
+  echo "⚠  ADVISORY"
   echo "$MSG"
   echo ""
 fi

package/dist/lite/.claude/hooks/session-reflection.d/80-hook-heartbeat-check.sh

@@ -104,10 +104,12 @@ done < <(jq -r '.critical_hooks[] | [.name, .max_age_seconds, .rationale] | @tsv
 if [ -n "$STALE_ENTRIES" ]; then
   NL=$'\n'
   MSG="hook liveness — stale hook(s) detected:$(echo -e "$STALE_ENTRIES")${NL}${NL}Cadence per standards/hook-cadence.json. Discipline per ADR-048 + .claude/rules/substrate-as-system.md.${NL}${NL}Resolve — run each named hook manually (check .claude/settings.json for its trigger event) OR file a substrate-defect ticket if the hook cannot be fired."
+  # Per standards/session-start-banner-discipline.md — stale hook is ADVISORY:
+  # session may proceed; operator informed to check hook trigger.
   if declare -f blocked_banner >/dev/null 2>&1; then
-    blocked_banner "$MSG"
+    blocked_banner "$MSG" advisory
   else
-    printf "BLOCKED: %b\n" "$MSG" >&2
+    printf "ADVISORY: %b\n" "$MSG" >&2
   fi
 fi
 

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/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

@@ -1,7 +1,7 @@
 {
-  "version": "v1.1.0",
-  "marker_tag": "release-2026-09-21-0e54fa7c",
-  "release_date": "2026-09-21T22:20:31Z",
-  "release_sha": "0e54fa7c",
-  "release_tag": "release-2026-09-21-0e54fa7c"
+  "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/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)

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

@@ -1,7 +1,7 @@
 {
   "tier": "lite",
-  "manifest_version": "1.9.6",
-  "generated_at": "2026-09-21T21:28:13Z",
+  "manifest_version": "1.9.11",
+  "generated_at": "2026-09-22T06:14:43Z",
   "entries": [
     {
       "slug": "029-release-pipeline",
@@ -216,7 +216,7 @@
       "type": "hook",
       "path": ".claude/hooks/session-reflection.d/70-recent-strategic-artifacts.sh",
       "tier": "lite",
-      "content_hash": "sha256:c3d8febfd3e9363df6da880a91493879893d0d3eeeabdba9a07d8fcfb7745645",
+      "content_hash": "sha256:3b5d8edc239d19f3b8d42dde3302a7bbd122d8ddfd5378643bec6414e4a8a3c2",
       "description": "Recent Strategic Artifacts — session-start branch of artifact-ingestion gate."
     },
     {
@@ -232,7 +232,7 @@
       "type": "hook",
       "path": ".claude/hooks/session-reflection.d/80-hook-heartbeat-check.sh",
       "tier": "lite",
-      "content_hash": "sha256:9f20ebd080a1a7364fe6e6c16266547b56b95c820297310cdd5be559852bab5f",
+      "content_hash": "sha256:fa72927b90d4f6f57733249f41f2353f930b84c18003c53f7a15c98eb8045e45",
       "description": "Hook heartbeat check — reads standards/hook-cadence.json, calls"
     },
     {
@@ -240,7 +240,7 @@
       "type": "hook",
       "path": ".claude/hooks/session-reflection.d/80-workflow-staleness.sh",
       "tier": "lite",
-      "content_hash": "sha256:5bb185044991df0d2e658cb12f10f3306add8682a270f0005b73f30617d3cb6c",
+      "content_hash": "sha256:c8eb12402268851aa7a6fee69ac3a2e370c64ea67dcf78795067fb321cacc2a3",
       "description": "Workflow-staleness — surfaces silent bassclef workflow failures at"
     },
     {
@@ -248,7 +248,7 @@
       "type": "hook",
       "path": ".claude/hooks/session-reflection.d/81-hook-manifest-staleness.sh",
       "tier": "lite",
-      "content_hash": "sha256:e3baa84fdb41585c51779773a2f63837eaab9f7896f9f5492a2db54d7269b75d",
+      "content_hash": "sha256:f4db0541d27a06e3f94ba557e7c8a39e747601b8ca9fd7af7313891b69548afd",
       "description": "Hook manifest staleness — flags standards/hook-cadence.json when it"
     },
     {
@@ -280,7 +280,7 @@
       "type": "hook",
       "path": ".claude/hooks/session-reflection.d/95-settings-hook-verify.sh",
       "tier": "lite",
-      "content_hash": "sha256:b3cccaf7acf82d2832b60d214e08b22384b4f4dbd9cd9f4e68b07ca85706eb6a",
+      "content_hash": "sha256:5f2a66f82c947105029074da84428fa7c6d591c88200fd9b7e957f37138d09a6",
       "description": "Settings hook path verifier — fires at every SessionStart via"
     },
     {
@@ -592,7 +592,7 @@
       "type": "hook",
       "path": ".claude/hooks/session-reflection.sh",
       "tier": "lite",
-      "content_hash": "sha256:ece32cd8261bafe4597563aa18237b504bba335c0a1e8d94e1d8d69f4a8e97ae",
+      "content_hash": "sha256:5d06b68d7503922cd3f5143ed2d83ec4e12c5d8e6f16822efcf2c702f49ed5b9",
       "description": "Session Start hook coordinator. Injects reflection prompt and iterates"
     },
     {
@@ -1326,7 +1326,7 @@
       "type": "root-doc",
       "path": ".claude/bassclef-orientation.md",
       "tier": "lite",
-      "content_hash": "sha256:7bc4b60259676a5f8f2a8f3f18734607c47ce5c0fb18bdb4c3b6b354904a3836"
+      "content_hash": "sha256:657e68fe29c52aaf9dd54ff752cf6f69498543484e4a764db89ba9837c0d9436"
     },
     {
       "slug": "claude-lite",
@@ -1629,7 +1629,7 @@
       "type": "rule",
       "path": ".claude/rules/longrun-prep-plan-doc-compression.md",
       "tier": "lite",
-      "content_hash": "sha256:35c8b9b14383864291f03dc78414d85162814ad2d43daa1fabfb268ecca197a0",
+      "content_hash": "sha256:c2c661c14988b3b0469c357fdda5600d9a4e9f237087c5b348c263d9a0e6c862",
       "description": "When a plan doc at docs/next-session-plan-*.md (modified within 48 hours) carries a ## Recommended session sequence (or equivalent) section, /longrun prep MUST skip the full Steps…"
     },
     {
@@ -2572,7 +2572,7 @@
       "type": "skill",
       "path": ".claude/skills/longrun/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:e11e395721186c5e5021266723b942ac8f330f17bff4b495adf316d05674ac01",
+      "content_hash": "sha256:1ab5a98d5ea805249761e092c7c8c8523eb3cd7ce53e6d89790d01e767a3df4b",
       "description": "Run a long autonomous session that paces itself. Prepares scope. Checkpoints at phase boundaries. Closes with session log and retrospective. Three modes: prep, checkpoint, closeout.",
       "composes_with": [
         "value-prop",
@@ -3737,7 +3737,7 @@
       "type": "standard",
       "path": "standards/lite-manifest-schema-changes.md",
       "tier": "lite",
-      "content_hash": "sha256:ba7d81b68af60e4df0e46fd7e0bb52ff756eaa13baf42b0dc679db37521b70a5",
+      "content_hash": "sha256:17f5c69efd97240348b6f74d35b200400c2817f7e303eb288b027fbb2bb38991",
       "description": "Chronological ledger of every lite-manifest schema change. Adopters read this before sync to know what shifted."
     },
     {
@@ -3972,6 +3972,14 @@
       "content_hash": "sha256:eb3ef832175ed745c412ca42f9ad854d0a298b828e647706547dcded15e2e32a",
       "description": "The session-board is a session-level coordinator artifact for multi-bet longrun sessions."
     },
+    {
+      "slug": "session-start-banner-discipline",
+      "type": "standard",
+      "path": "standards/session-start-banner-discipline.md",
+      "tier": "lite",
+      "content_hash": "sha256:444a6f20be6bd175dabb06b8aedb527b9c93525786df0386fd785d1821451a4e",
+      "description": "Four-level banner palette for session-start checks. Per Norman signifier + Cooper Sam persona consult. Match glyph to state."
+    },
     {
       "slug": "sibling-validation-checklist",
       "type": "standard",

package/dist/lite/standards/session-start-banner-discipline.md

@@ -0,0 +1,99 @@
+---
+tier: lite
+description: Four-level banner palette for session-start checks. Per Norman signifier + Cooper Sam persona consult. Match glyph to state.
+---
+
+# Session-start banner discipline
+
+Session-start checks in `.claude/hooks/session-reflection.d/` emit banners that adopters read before any tool call runs. The banner shape trains the reader's expectation. A 🛑 emoji for an advisory check reads to a first-run adopter as "you broke something." That is a signifier mismatch (Norman) and a Cooper Sam-persona failure at the magic-demo boundary.
+
+This standard names a four-level palette. Each check picks the level that matches its own state.
+
+## The four levels
+
+| Level | Glyph | Text label | When to use |
+|---|---|---|---|
+| BLOCK | 🛑 | BLOCKED | The session cannot safely proceed with substantive work. Real defect. Missing prerequisite. Active drift that will corrupt state. |
+| ADVISORY | ⚠ | ADVISORY | Context worth reading. Session may proceed. The operator is informed; they choose whether to act now or later. |
+| INFO | ℹ | INFO | State report. No action needed. Fires only when the reader benefits from knowing the state. |
+| silent-on-clean | — | — | Check runs but reports nothing when state is nominal. Fires only on non-nominal state (which routes to one of the three above). |
+
+Every check picks exactly one level. Ambiguous cases default to silent-on-clean.
+
+## How to pick
+
+Ask two questions in order.
+
+1. **Does this check indicate the session cannot safely proceed?** If yes, BLOCK. Cannot-proceed means: writing code now will corrupt state, or will ship a broken change, or will silently defeat a safety mechanism. Missing bassclef-sync template drift. Failing pre-commit gate. Schema validation error. These block.
+2. **Does the reader gain value from knowing about this now?** If yes, ADVISORY or INFO. ADVISORY when the reader may want to act (read the artifact, address the drift). INFO when it is pure state (last save time, current branch). If no, silent-on-clean.
+
+Default to silent-on-clean when in doubt. Every advisory or info banner spends the reader's attention. Spend it on things they benefit from.
+
+## Signifier discipline (Norman)
+
+The glyph is a signifier — a perceivable cue that suggests state. The signifier fit is:
+
+- 🛑 signals "stop; something is wrong." Use only when something is wrong.
+- ⚠ signals "look here; think." Use for context worth reading that does not block.
+- ℹ signals "state report." Use when the state itself is the payload.
+
+Pairing glyph with text label (BLOCKED / ADVISORY / INFO) protects screen readers, CI log parsers, and readers who read faster than they see. The text is the primary signifier; the glyph is data-ink that reinforces the level.
+
+## Sam persona discipline (Cooper)
+
+Sam is a cold-adopter running bassclef for the first time. Sam's mental model: nothing about bassclef yet. Sam sees 🛑 and thinks "I broke the install." That is a persona failure.
+
+Slice D applies the four-level palette so Sam's first-run reads context, not brokenness. Cure applies at every session-reflection.d fragment where the check is advisory. Fragments that indicate a real block keep 🛑.
+
+**First-run adopter special case.** On the very first session (no prior state on disk), even advisory checks should default to silent-on-clean. A first-run adopter has no context to act on. Fire an ADVISORY only when the state is genuinely worth surfacing. The mechanism: check `LAST_SAVE_FILE` existence or session-timing marker count; skip advisory output on first-run unless the check is critical.
+
+## Data-ink ratio (Tufte)
+
+Each glyph maps 1:1 to a severity level. The glyph carries information the reader uses to prioritize. That is data-ink, not decoration. Emoji as decoration (a 🎉 at the head of a section) is chartjunk. Emoji as severity mark (🛑 for BLOCK, ⚠ for ADVISORY) is data-ink.
+
+## Aggregate roll-up (session-end)
+
+When session-start emits multiple banners, the reader benefits from a one-line summary at the end.
+
+Format: `Session-start: N advisory, M info, K blocked.`
+
+The roll-up prints only when count > 0 on any level. Fires from the last session-reflection.d fragment (name-sorted last). This slice ships the standard; the roll-up mechanism ships as follow-on.
+
+## API — blocked_banner (session-reflection.sh)
+
+The existing `blocked_banner` function in `.claude/hooks/session-reflection.sh` accepts a second argument for severity:
+
+```
+blocked_banner "message body" blocking   # 🛑 BLOCKED (default)
+blocked_banner "message body" advisory   # ⚠ ADVISORY
+blocked_banner "message body" info       # ℹ INFO
+```
+
+Callers that pass one argument keep the historical shape (blocking). The 27 pre-existing sites are untouched.
+
+Silent-on-clean checks skip the `blocked_banner` call entirely on nominal state.
+
+## Migration path
+
+This slice migrates three advisory-class fragments as exemplars:
+
+- `.claude/hooks/session-reflection.d/70-recent-strategic-artifacts.sh`
+- `.claude/hooks/session-reflection.d/80-hook-heartbeat-check.sh`
+- `.claude/hooks/session-reflection.d/80-workflow-staleness.sh`
+
+Remaining fragments migrate under a follow-on ticket. Each PR migrates one or a small set. The pattern is: pick the level per the two questions above, change the `blocked_banner "$MSG"` to `blocked_banner "$MSG" advisory` (or `info`), update the fragment's docstring to name the level.
+
+## Composes with
+
+- `.claude/rules/blocked-items.md` — BLOCK protocol; still fires at the blocking level
+- `.claude/rules/artifact-ingestion.md` §"Session-start branch" — the 70-recent-strategic-artifacts fragment is advisory per this standard
+- `.claude/rules/bassclef-hook-drift-blocker.md` — a real drift is BLOCK; a stale check is ADVISORY
+- `@luminary donald-norman` — signifier fit
+- `@luminary alan-cooper` — Sam persona at first-run
+- `@luminary edward-tufte` — data-ink ratio for glyph-as-data
+
+## Refs
+
+- #1704 — the original consult ask (banner tone reads as broken to Sam)
+- `.claude/hooks/session-reflection.sh` L84 — `blocked_banner` function
+- `docs/canvases/2026-07-19-bassclef-lite.md` — Sam persona anchor for lite tier

package/package.json

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