@thebassclef/lite 1.5.1 → 1.7.0

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

@@ -1,7 +1,7 @@
 {
   "tier": "lite",
-  "manifest_version": "1.9.4",
-  "generated_at": "2026-09-21T12:32:12Z",
+  "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"
     },
     {
@@ -824,7 +824,7 @@
       "type": "lib",
       "path": "lib/mechanism-fidelity.sh",
       "tier": "lite",
-      "content_hash": "sha256:3253ce24b845e601486dea9dab4a9e27d11f7fc72f5b9084ab5fb473bea84826",
+      "content_hash": "sha256:8afeac2e42bd7fb281cda9be94395e272092857f8a8e431350b8c8673578bcf5",
       "description": "lib/mechanism-fidelity.sh — shared scanner for the mechanism-fidelity"
     },
     {
@@ -880,7 +880,7 @@
       "type": "lib",
       "path": "lib/source-graph-walker.sh",
       "tier": "lite",
-      "content_hash": "sha256:abae8c156ac538321b90326946eade3b70068ee1d4bd8ad605fdb374849400ba",
+      "content_hash": "sha256:350a3356243a2e7943e9f02d9272db58488ee72abac515e56c7690d665b1a0fd",
       "description": "lib/source-graph-walker.sh — walks source-graph closure from a seed hook"
     },
     {
@@ -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.5.1",
+  "version": "1.7.0",
   "description": "Bassclef CLI — install and upgrade bassclef in your project with two commands.",
   "keywords": [
     "bassclef",
@@ -65,7 +65,8 @@
     "typecheck": "tsc --noEmit",
     "bump": "node scripts/bump-version.mjs",
     "harness:npm-install": "vitest run --config vitest.harness.config.ts",
-    "prepublishOnly": "node scripts/prepublish-bundle-substrate.mjs"
+    "prepublishOnly": "node scripts/prepublish-bundle-substrate.mjs",
+    "install-hooks": "node scripts/install-git-hooks.mjs"
   },
   "devDependencies": {
     "@types/node": "^20.14.0",