@thebassclef/lite 1.9.10 → 1.9.11

package/README.md

@@ -67,7 +67,7 @@ your browser.
 
 ## Current release
 
-<!-- version-start -->1.9.10<!-- version-end -->
+<!-- version-start -->1.9.11<!-- version-end -->
 
 See [CHANGELOG.md](CHANGELOG.md) for the full changelog. Adopter-facing
 release notes live at [docs.bassclef.dev/docs/whats-new/releases](https://docs.bassclef.dev/docs/whats-new/releases).

package/dist/index.cjs

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,4 +1,4 @@
-const version = "1.9.10";
+const version = "1.9.11";
 export {
   version
 };

package/dist/lite/.claude/hooks/artifact-ingestion-gate.sh

@@ -143,9 +143,15 @@ if [ "$HAS_SOURCES_READ" -eq 1 ]; then
         exit
       }
     ')
-    if [ -z "$PARENT_VALUE" ]; then
-      continue
-    fi
+    # cli#311 cure — treat null / ~ / empty as "no parent declared" (Peirce three-case).
+    # YAML null shorthand is `null`, `~`, or an empty value. Prior code caught empty
+    # only; `parent_bet: null` tripped the gate on root goals that genuinely have no
+    # parent. Mirrors the #70 cure in bet-doc-gate.sh.
+    case "$PARENT_VALUE" in
+      "" | "null" | "Null" | "NULL" | "~" | "None")
+        continue
+        ;;
+    esac
 
     # Check if the parent path (or its basename without extension) appears
     # in the Sources-read section. Accepts either:

package/dist/lite/.claude/hooks/save-state.sh

@@ -209,7 +209,12 @@ DIRTY=$(git status --porcelain 2>/dev/null | grep -v '\.DS_Store' | grep -v 'SES
 if [ -n "$DIRTY" ]; then
   # Stage tracked modified files + any docs/ or chronicle/ or runtime state
   git add -u 2>/dev/null || true
-  git add docs/ chronicle/ specs/ 2>/dev/null || true
+  # docs/ except docs/prototypes/ — prototypes are review-gated mocks per
+  # .claude/rules/prototype-workflow.md; auto-save must not commit them
+  # before the operator confirms the rendered output (cli#323).
+  # Same pathspec pattern used for state/markers below.
+  git add 'docs/' ':!docs/prototypes' ':!docs/prototypes/**' 2>/dev/null || true
+  git add chronicle/ specs/ 2>/dev/null || true
   # state/ except state/markers/ — markers are runtime gate evidence that
   # trigger session-rescue false-positives if committed (bassclef#341 / WU-A2).
   # Negative pathspec syntax requires git >= 2.13 (stable since 2017).

package/dist/lite/.claude/hooks/session-reflection.d/97-last-block-count.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+# tier: lite
+# install-class: dual
+# Session-reflection fragment — surface last-block marker count.
+#
+# Per @luminary don-norman signifier: when BLOCK banners from prior
+# sessions sit in state/markers/last-block/, this fragment tells the
+# adopter they exist and names /last-block as the retrieval path.
+#
+# Fires once at session-start. Reads marker count. Prints one line to
+# stdout when count > 0. Silent on empty.
+#
+# Composition — sourced by session-reflection.sh under set -e. Must use
+# `return`, not `exit`, else the coordinator dies. Per test-sufficiency
+# criterion 12 (invocation-mode variation).
+#
+# Per bassclef-upstream#2036 Finding #10 + UC-skill-last-block.md.
+
+# Resolve directory (same convention as lib/last-block.sh).
+_last_block_count_dir() {
+  if [ -n "${LAST_BLOCK_DIR:-}" ]; then
+    echo "$LAST_BLOCK_DIR"
+  else
+    echo "${CLAUDE_PROJECT_DIR:-.}/state/markers/last-block"
+  fi
+}
+
+LBC_DIR="$(_last_block_count_dir)"
+
+if [ ! -d "$LBC_DIR" ]; then
+  # Fresh install or dir never created. Silent.
+  # shellcheck disable=SC2317  # dual-use sourced-or-standalone exit path
+return 0 2>/dev/null || exit 0
+fi
+
+LBC_COUNT=$(find "$LBC_DIR" -maxdepth 1 -name '*.marker' -type f 2>/dev/null | wc -l | tr -d ' ')
+
+if [ "$LBC_COUNT" -gt 0 ]; then
+  if [ "$LBC_COUNT" = "1" ]; then
+    echo "### LAST BLOCK"
+    echo ""
+    echo "1 BLOCK banner stored. Read it with /last-block."
+    echo ""
+  else
+    echo "### LAST BLOCKS"
+    echo ""
+    echo "${LBC_COUNT} BLOCK banners stored. Read the newest with /last-block, or list all with /last-block --list."
+    echo ""
+  fi
+fi
+
+# shellcheck disable=SC2317  # dual-use sourced-or-standalone exit path
+return 0 2>/dev/null || exit 0

package/dist/lite/.claude/hooks/session-reflection.d/tests/97-last-block-count.test.sh

@@ -0,0 +1,131 @@
+#!/usr/bin/env bash
+# tier: lite
+# fixtures: bassclef-upstream-self
+# shellcheck disable=SC2034
+# Tier 0 test for .claude/hooks/session-reflection.d/97-last-block-count.sh
+#
+# Covers invocation-mode variation (criterion 12 of test-sufficiency rubric):
+# both standalone and sourced-under-set-e paths.
+#
+# Ticket: bassclef-upstream#2036 Finding #10
+#
+# test-list:
+# [x] T01: standalone + no dir -> silent, exit 0, no return error
+# [x] T02: standalone + empty dir -> silent, exit 0
+# [x] T03: standalone + 1 marker -> prints "1 BLOCK banner stored"
+# [x] T04: standalone + 3 markers -> prints "3 BLOCK banners stored"
+# [x] T05: sourced under set -e -> parent survives (no exit)
+# [x] T06: honors LAST_BLOCK_DIR env override
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+FRAG_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+FRAG="$FRAG_DIR/97-last-block-count.sh"
+
+if [ ! -f "$FRAG" ]; then
+  echo "RED: $FRAG does not exist yet" >&2
+  exit 1
+fi
+
+FIXTURE_ROOT="$(mktemp -d)"
+RESULTS_FILE="$FIXTURE_ROOT/results.log"
+touch "$RESULTS_FILE"
+trap 'rm -rf "$FIXTURE_ROOT"' EXIT
+
+pass() { echo "PASS" >> "$RESULTS_FILE"; echo "PASS: $1"; }
+fail() { echo "FAIL" >> "$RESULTS_FILE"; echo "FAIL: $1"; }
+
+# T01: standalone + no dir
+( LAST_BLOCK_DIR="$FIXTURE_ROOT/nonexistent"
+  export LAST_BLOCK_DIR
+  OUT=$(bash "$FRAG" 2>&1)
+  RC=$?
+  if [ "$RC" = "0" ] && [ -z "$OUT" ]; then
+    pass "T01: standalone + no dir -> silent"
+  else
+    fail "T01: standalone + no dir -> silent (rc=$RC out=$OUT)"
+  fi
+)
+
+# T02: standalone + empty dir
+( LAST_BLOCK_DIR="$(mktemp -d)"
+  export LAST_BLOCK_DIR
+  OUT=$(bash "$FRAG" 2>&1)
+  RC=$?
+  if [ "$RC" = "0" ] && [ -z "$OUT" ]; then
+    pass "T02: standalone + empty dir -> silent"
+  else
+    fail "T02: standalone + empty dir -> silent (rc=$RC out=$OUT)"
+  fi
+)
+
+# T03: standalone + 1 marker
+( DIR="$(mktemp -d)"
+  LAST_BLOCK_DIR="$DIR"
+  export LAST_BLOCK_DIR
+  echo "hook: a" > "$DIR/a.marker"
+  OUT=$(bash "$FRAG" 2>&1)
+  if echo "$OUT" | grep -qF "1 BLOCK banner stored"; then
+    pass "T03: 1 marker -> prints singular"
+  else
+    fail "T03: 1 marker (got: $OUT)"
+  fi
+)
+
+# T04: standalone + 3 markers
+( DIR="$(mktemp -d)"
+  LAST_BLOCK_DIR="$DIR"
+  export LAST_BLOCK_DIR
+  echo "hook: a" > "$DIR/a.marker"
+  echo "hook: b" > "$DIR/b.marker"
+  echo "hook: c" > "$DIR/c.marker"
+  OUT=$(bash "$FRAG" 2>&1)
+  if echo "$OUT" | grep -qF "3 BLOCK banners stored"; then
+    pass "T04: 3 markers -> prints plural with count"
+  else
+    fail "T04: 3 markers (got: $OUT)"
+  fi
+)
+
+# T05: sourced under set -e -> parent survives (criterion 12)
+( DIR="$(mktemp -d)"
+  LAST_BLOCK_DIR="$DIR"
+  export LAST_BLOCK_DIR
+  echo "hook: a" > "$DIR/a.marker"
+  # Simulate coordinator: set -e wrapper + source
+  CANARY_FILE="$FIXTURE_ROOT/canary-t05"
+  (
+    set -e
+    # shellcheck source=/dev/null
+    source "$FRAG"
+    # If frag used `exit` instead of `return`, this line never runs.
+    touch "$CANARY_FILE"
+  ) >/dev/null 2>&1 || true
+  if [ -f "$CANARY_FILE" ]; then
+    pass "T05: sourced under set -e survives (canary ran)"
+  else
+    fail "T05: sourced under set -e survives (canary missing)"
+  fi
+)
+
+# T06: honors LAST_BLOCK_DIR env override
+( DIR="$(mktemp -d)"
+  LAST_BLOCK_DIR="$DIR"
+  export LAST_BLOCK_DIR
+  echo "hook: a" > "$DIR/a.marker"
+  OUT=$(bash "$FRAG" 2>&1)
+  if echo "$OUT" | grep -qF "1 BLOCK banner stored"; then
+    pass "T06: honors LAST_BLOCK_DIR override"
+  else
+    fail "T06: honors LAST_BLOCK_DIR override (got: $OUT)"
+  fi
+)
+
+echo
+echo "=== Results ==="
+PASS=$(awk '/^PASS$/ {c++} END {print c+0}' "$RESULTS_FILE")
+FAIL=$(awk '/^FAIL$/ {c++} END {print c+0}' "$RESULTS_FILE")
+echo "PASS: $PASS"
+echo "FAIL: $FAIL"
+if [ "$FAIL" -gt 0 ]; then exit 1; fi

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

@@ -74,6 +74,14 @@ else
 fi
 export BASSCLEF_DIR
 
+# Source lib/last-block.sh so banner calls persist markers. Per Finding
+# #10 — adopters need a first-class way to retrieve BLOCK text they saw.
+# The lib fails soft; missing lib leaves the banners untouched.
+# shellcheck source=/dev/null
+if [ -f "${BASSCLEF_DIR}/lib/last-block.sh" ]; then
+  source "${BASSCLEF_DIR}/lib/last-block.sh"
+fi
+
 # High-contrast BLOCKED banner; used by every module that raises a gap.
 # RFC-0008 F3 — "Silence is not deferral" is a commitment device. It works
 # because it forecloses the easy out, and it is consumable: spend it on a
@@ -81,9 +89,13 @@ export BASSCLEF_DIR
 # Callers that can prove their own state is benign pass a second argument
 # and get a softer close. Callers that pass one argument behave exactly as
 # before, so the other 27 sites are untouched.
+#
+# Per Finding #10 — each call now also writes a marker so the adopter can
+# retrieve the exact banner text later via /last-block.
 blocked_banner() {
   local msg="$1"
   local severity="${2:-blocking}"
+  local hook_name="${BASSCLEF_CALLING_HOOK:-session-reflection}"
   echo ""
   case "$severity" in
     info)
@@ -106,9 +118,14 @@ blocked_banner() {
       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."
+      echo "(Retrieve this banner later with: /last-block ${hook_name})"
       ;;
   esac
   echo ""
+  # Persist marker for /last-block retrieval. Fail-soft.
+  if type -t record_last_block >/dev/null 2>&1; then
+    record_last_block "$hook_name" "$severity" "$msg" 2>/dev/null || true
+  fi
 }
 
 # Vendor-swap constant — the AI in the harness running bassclef. Adopter
@@ -131,7 +148,12 @@ guardrail_banner() {
   echo "────────────────────────────────────────────"
   echo "bassclef is steering $AI_NAME to $step — $retry"
   echo "────────────────────────────────────────────"
+  echo "(Retrieve this banner later with: /last-block ${hook_name})"
   echo ""
+  # Persist marker for /last-block retrieval. Fail-soft.
+  if type -t record_last_block >/dev/null 2>&1; then
+    record_last_block "$hook_name" "guardrail" "$step — $retry" 2>/dev/null || true
+  fi
 }
 
 # RFC-0008 F6 — this block is steering aimed at the agent, but the adopter

package/dist/lite/.claude/rules/last-block-marker.md

@@ -0,0 +1,79 @@
+---
+tier: lite
+title: Last-block marker
+anchor_luminaries:
+  - john-ousterhout
+  - tony-hoare
+  - michael-feathers
+  - don-norman
+  - alan-cooper
+  - steve-krug
+---
+
+# Last-block marker
+
+Every call to `blocked_banner()` or `guardrail_banner()` in `.claude/hooks/session-reflection.sh` persists a marker at `state/markers/last-block/<hook>.marker`. The marker carries the hook name, severity, timestamp, and verbatim banner text. The `/last-block` skill reads markers back.
+
+This rule is the methodology layer. The mechanical layer is `lib/last-block.sh` sourced by `session-reflection.sh`. Both required together to close Kunal Finding #10.
+
+## When this rule fires
+
+Every call to `blocked_banner()` or `guardrail_banner()` in `.claude/hooks/session-reflection.sh`. The banner helpers already call `record_last_block` from the sourced lib. Hook authors who call these helpers get the marker for free.
+
+## Marker format
+
+Plaintext layout per `lib/last-block.sh`:
+
+```
+hook: <hook-name>
+severity: blocking|advisory|info|guardrail
+fired_at: <ISO-8601 UTC>
+session: <CLAUDE_SESSION_ID or "unknown">
+---
+<verbatim banner text, truncated at 8KB with a truncation marker>
+```
+
+Grep-friendly. One marker file per hook. Overwrites on each fire. No rotation in V1.
+
+## What the rule requires
+
+For hooks that fire BLOCK via `blocked_banner()` or `guardrail_banner()`:
+
+- Pass the hook name via the `BASSCLEF_CALLING_HOOK` env var before the call. The default is `session-reflection` when unset.
+- Pass a plain severity (`blocking` / `advisory` / `info`) to `blocked_banner()` as the second arg.
+- The banner helper writes the marker on its own. No extra step.
+
+For hooks that fire BLOCK via plain `echo` to stderr (not via the shared helpers):
+
+- Follow-on retrofit per `.claude/rules/bootstrap-pair-discipline.md`. Adopt the shared helpers when the hook is next touched.
+
+## Anti-patterns
+
+**Hook writes a marker directly without using the lib.**
+INSTEAD source `lib/last-block.sh` and call `record_last_block`. The lib owns the format.
+
+**Marker format drift.**
+INSTEAD the plaintext layout stays pinned in `lib/last-block.sh`. Change the lib + Tier 0 tests + this rule in one PR.
+
+**BLOCK banner emitted directly to stderr without recording.**
+INSTEAD route through `blocked_banner()` so the marker lands with the banner. If a hook has a reason to skip the shared helper, call `record_last_block` directly after the echo.
+
+## Override
+
+`SKIP_LAST_BLOCK_RECORD=1` bypasses marker recording for one call. Logged via trace-helper. Rare — mostly for test fixtures that need to control marker writing timing.
+
+## Composes with
+
+- `.claude/rules/blocked-items.md` — sister rule; the two banner shapes live there, and this rule adds the persistence requirement
+- `.claude/rules/bootstrap-pair-discipline.md` — this rule + lib + skill + tests + settings wire ship together
+- `.claude/rules/testing-tier-config.md` — Tier 0 strict TDD on `lib/last-block.sh`
+- `.claude/rules/we-dont-break-adopters.md` — additive change; existing banner callers see no behavior change
+- `.claude/hooks/session-reflection.sh` — the hook that sources the lib + calls record_last_block from both banner helpers
+- `lib/last-block.sh` — the deep module
+- `.claude/skills/last-block/SKILL.md` — the user-invocable surface
+- @luminary john-ousterhout — deep module anchor
+- @luminary tony-hoare — pre/postcondition anchor (write path fail-soft)
+- @luminary michael-feathers — characterization anchor (Tier 0 tests pin every path)
+- @luminary don-norman — signifier (banner footer teaches the recovery path)
+- @luminary alan-cooper — goal-directed (one goal: get banner text back)
+- @luminary steve-krug — discoverability (no-args default)

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

@@ -371,7 +371,13 @@ fi
 
 ### Phase 2b — Adopter-mode framing (bassclef#943)
 
-Two paths — adopter-mode and operator-mode. Default is adopter when the parent /launch used `--local` (cold-adopter context); operator-mode otherwise. Mode detection reads `docs/preview-state/<slug>.yml`: when `local_url` is present, /launch shipped via the adopter path, so /build follows.
+Two paths — adopter-mode and operator-mode. Default is adopter after a `/launch --local` run. Operator-mode is the default otherwise.
+
+Mode detection reads the goal doc's `preview_state:` frontmatter field. /launch writes that field. Open the file it names. When `local_url` is present, /build picks adopter-mode. Default to operator-mode when the field is absent.
+
+<!-- FKGL-EXEMPT: ticket reference -->
+Per sunj-labs/bassclef-cli#326.
+<!-- /FKGL-EXEMPT -->
 
 #### Adopter-mode pre-dispatch surface
 

package/dist/lite/.claude/skills/ia-model/SKILL.md

@@ -62,6 +62,14 @@ Derive nav from the screen map. Apply Peter Morville's IA framework:
 - **C**ategory: by type or classification
 - **H**ierarchy: by importance or score
 
+## Output file
+
+Write to `docs/ia-models/<slug>.md`. Use the active goal or sprint slug. `/launch` Phase 6 reads from this path. `/build` Phase 0.5 reads from the same path.
+
+<!-- FKGL-EXEMPT: ticket reference -->
+Per sunj-labs/bassclef-cli#317.
+<!-- /FKGL-EXEMPT -->
+
 ## Output Format
 
 ```markdown

package/dist/lite/.claude/skills/interaction-design/SKILL.md

@@ -68,6 +68,14 @@ BACKSTAGE (system does):    Score → Index → Enrich → Notify
 SUPPORT PROCESSES:          Ingest → Classify → Deduplicate
 ```
 
+## Output file
+
+Write to `docs/interaction-designs/<slug>.md`. Use the active goal or sprint slug. `/build` Phase 0.5 reads from this path. `/launch` Phase 7 reads from the same path.
+
+<!-- FKGL-EXEMPT: ticket reference -->
+Per sunj-labs/bassclef-cli#317.
+<!-- /FKGL-EXEMPT -->
+
 ## Output Format
 
 For each interaction flow:

package/dist/lite/.claude/skills/jtbd-tasks/SKILL.md

@@ -188,9 +188,17 @@ For each JTBD, produce:
 | 1.1 ... | [job] | [screen or component implied] |
 ```
 
+## Output file
+
+Write to `docs/jtbd/<slug>.md`. Use the active goal or sprint slug. `/build` Phase 0.5 reads from this path. See the ticket noted at the end of this skill body.
+
+<!-- FKGL-EXEMPT: ticket reference -->
+Per sunj-labs/bassclef-cli#317.
+<!-- /FKGL-EXEMPT -->
+
 ## Next Step
 
-Output feeds into `/task-scenarios` (user stories) or directly into `/ia-model` (entity-driven IA).
+The output feeds `/task-scenarios` for user stories. Or it feeds `/ia-model` to drive IA.
 
 ## References
 

package/dist/lite/.claude/skills/last-block/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: last-block
+description: Print the exact text of a BLOCK or guardrail banner you saw this session or prior. No args shows the newest. One hook name shows that hook. --list enumerates every stored banner newest first.
+tier: lite
+user_invocable: true
+disable_model_invocation: false
+authoring_luminaries:
+  primary: john-ousterhout
+  supporting:
+    - tony-hoare
+    - michael-feathers
+composes_with: []
+---
+
+# /last-block
+
+## What you get
+
+An adopter who sees a BLOCK banner can retrieve the exact text later. No scrolling through the terminal. No grep over trace logs. Type `/last-block`. The banner prints.
+
+## When to use it
+
+Three cases.
+
+- You saw a BLOCK banner, scrolled past it, and want to re-read the recipe or override instruction.
+- You want to file a ticket and need the exact BLOCK text as evidence.
+- You want to see which hooks fired BLOCK during the prior session.
+
+## Usage
+
+```
+/last-block                 # print the newest stored banner
+/last-block <hook-name>     # print the banner stored under <hook-name>
+/last-block --list          # list every stored banner newest first
+```
+
+## How it works
+
+Every BLOCK banner printed by `blocked_banner()` or `guardrail_banner()` persists a marker at `state/markers/last-block/<hook>.marker`. Per-hook markers overwrite on each fire. The lib `lib/last-block.sh` reads them back.
+
+Marker format is plaintext:
+
+```
+hook: <hook-name>
+severity: blocking|advisory|info|guardrail
+fired_at: <ISO-8601 UTC>
+session: <session-id or unknown>
+---
+<verbatim banner text, truncated at 8KB>
+```
+
+## Procedure
+
+1. Source `lib/last-block.sh`.
+2. If `--list` arg, call `list_last_blocks` and print to stdout.
+3. If a hook-name arg, call `read_last_block <hook>` and print.
+4. Else call `read_last_block` and print the newest.
+5. Exit 0 on hit, 1 on miss.
+
+## Example
+
+```
+$ /last-block
+hook: pre-commit-gate
+severity: blocking
+fired_at: 2026-10-04T15:21:08Z
+session: 2026-10-04-slot-6
+---
+🛑 BLOCKED: path contains operator identifier /Users/<name>/...
+Override: SKIP_OPERATOR_PATHS=1 git commit ...
+```
+
+## FAQ
+
+### What hooks persist markers?
+
+Any hook that calls `blocked_banner()` or `guardrail_banner()` from `session-reflection.sh`. ~27 call sites today. Hooks that fire BLOCK via plain `echo` to stderr are a follow-on retrofit.
+
+### Does the marker persist across machines?
+
+No. Markers live in `state/markers/last-block/` which bassclef-upstream gitignores. The marker survives the session that wrote it; it does not sync to teammates.
+
+### Can I clear markers?
+
+Yes — delete `state/markers/last-block/<hook>.marker` or the whole directory. Next BLOCK fire re-populates.
+
+### What if the lib is missing?
+
+The banner helpers detect missing lib and skip the record call. Banners still print. The marker is just not written. `/last-block` reports "no block recorded".
+
+## Refs
+
+- Ticket: bassclef-upstream#2036 Finding #10
+- UC: `docs/use-cases/UC-skill-last-block.md`
+- Rule: `.claude/rules/last-block-marker.md`
+- Lib: `lib/last-block.sh`
+- Sister rule: `.claude/rules/blocked-items.md`
+- Luminary: `.claude/luminaries/john-ousterhout.md` (deep module)
+- /rfc outside lenses: `.claude/luminaries/don-norman.md` + `.claude/luminaries/steve-krug.md` + `.claude/luminaries/alan-cooper.md`

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

@@ -379,7 +379,7 @@ Produces `InputArtifact` at `docs/input-artifacts/<sprint-slug>-input.json`. Dow
 ### Phase 2 — `/objectory-decompose` (full BCE matrix)
 
 Same as `/stage` Phase 2 — Jacobson method via `/objectory-decompose`.
-Output: `docs/decompositions/<slug>-domain.md` with entity inventory
+Output: `docs/decompositions/<sprint-slug>-input-domain.md` with entity inventory
 + actor list + verb-goal pairs + BCE matrix.
 
 **Distinction from `/stage`**: medium + full consume the FULL BCE
@@ -500,7 +500,7 @@ map derived from BCE entities.
 /interaction-design    # consumes /ia-model + /use-case
 ```
 
-Output: state diagrams + sequence diagrams in `docs/interaction-design/<slug>/`.
+Output: state diagrams + sequence diagrams in `docs/interaction-designs/<slug>.md` (per sunj-labs/bassclef-cli#317).
 
 ### Phase 8 — `/decompose` (GRASP responsibility assignment)
 
@@ -552,12 +552,18 @@ to produce reviews per perspective. Reviews surface in PR body.
 /ux-migration <chosen-variant-slug>   # if base= provided, use that; else operator chooses post-gallery
 ```
 
-Output: `docs/specs/ux-migration-<slug>.md` — token extraction +
-prototype-HTML→React mapping table + work packages with dependency-aware
-build order.
+<!-- FKGL-EXEMPT: cli#324 cure — technical precision required naming paired SKILL steps + file paths -->
 
-This is the `/ux-migration` MUST gate per existing prototype-variants
-SKILL.md §"Step 7 — Selection → pipeline to Construction".
+Output: `docs/specs/ux-migration-<slug>.md` carries token extraction, prototype-to-React mapping, and work packages.
+
+**When to run full `/ux-migration` vs partial (cli#324):**
+
+- **Existing UI (redesign).** Run the full skill. The `/ux-migration` SKILL names this a MUST for redesigns.
+- **Greenfield (no existing UI).** Run only Step 3b and Step 3c. Step 3b extracts design tokens. Step 3c maps prototype HTML to React components. The `/ux-migration` SKILL says skip the full migration for greenfield.
+
+Pick by project state. Does `src/app/` carry a shipping UI? Yes means redesign. No means greenfield. When unsure, default to greenfield partial. The full gate's output is a component diff. A component diff has no value on an empty tree.
+
+<!-- /FKGL-EXEMPT -->
 
 ### Phase 12 — Deploy or local-serve (mode-gated)
 
@@ -621,9 +627,9 @@ status != build-ready.
 ### Phase 14 — Scaffold Construction iteration-goal draft
 
 ```yaml
-# docs/iteration-bets/<YYYY-MM-DD>-<sprint-slug>-construction.md (DRAFT)
+# docs/iteration-bets/<sprint-slug>-construction.md (DRAFT)   # cli#326
 ---
-slug: <YYYY-MM-DD>-<sprint-slug>-construction
+slug: <sprint-slug>-construction
 phase: Construction
 status: draft   # operator must change to "active" before /build-iteration runs
 parent_roadmap: docs/roadmaps/<roadmap-slug>.md  # if known
@@ -637,8 +643,8 @@ references:
   - {type: spec, id: <sprint-slug>}
   - {type: decomposition, id: <sprint-slug>-grasp}
   - {type: input-artifact, id: <sprint-slug>-input}
-appetite:
-  mode: scope-bounded
+time_budget:
+  mode: fixed-scope
   estimated_turns: <derived from /spec step enumeration>
   stopping_criteria:
     - All step PRs filed (count from spec)
@@ -677,7 +683,7 @@ appetite:
 **Viability signal**:
 (derived from /spec acceptance criteria; operator confirms)
 
-**Appetite**:
+**Time budget**:
 (derived from spec step enumeration; operator finalizes)
 ```
 

package/dist/lite/.claude/skills/objectory-decompose/SKILL.md

@@ -57,12 +57,6 @@ source lib/state.sh
 INPUT=$(state_reference_get input-artifact "<slug>")
 ```
 
-Or via wrapper:
-
-```bash
-INPUT=$(bash scripts/state.sh get reference input-artifact "<slug>")
-```
-
 **Required fields** (extract via `jq`):
 - `extracted_text` — the load-bearing input for analysis
 - `type` — guides extraction (text vs. URL vs. image have different signals)
@@ -164,18 +158,12 @@ phase: jacobson  # marks Phase B MVP scope; cockburn is follow-up
 
 ### 4. Validate output
 
-After writing, the state-validate.sh hook validates the frontmatter
-against `decomposition.schema.json`. If invalid, the write BLOCKs;
-fix frontmatter and retry.
-
-Or invoke explicitly:
-
-```bash
-bash scripts/state.sh validate docs/decompositions/<slug>-domain.md
-```
+The state-validate.sh hook runs on write. It checks the frontmatter
+against `decomposition.schema.json`. A failed check BLOCKs the write.
+Fix the frontmatter and retry.
 
-Exit 0 = clean; exit 3 = schema violation (BLOCK message names the
-field).
+Exit 0 = clean. Exit 3 = schema violation. The BLOCK message names
+the field.
 
 ### 5. Surface to next step
 

package/dist/lite/.claude/skills/use-case/SKILL.md

@@ -101,10 +101,11 @@ if a required input is missing:
 1. **Personas** — `docs/personas/*.md` (preferred) or
    `docs/design/personas/*.md` (legacy). Use-case's **primary
    actor** MUST be a persona slug, not "user."
-2. **JTBDs** — `docs/design/personas/[persona]/jtbds.md` or
-   equivalent. Each use case has a single **goal** that traces to
-   a JTBD outcome. Halt if no JTBDs for the scope in question
-   (warn the operator; offer to run `/jtbd-tasks` first).
+2. **JTBDs** — `docs/jtbd/*.md` (preferred, per cli#317) or
+   `docs/design/personas/[persona]/jtbds.md` (legacy fallback).
+   Each use case has a single **goal** that traces to a JTBD
+   outcome. Halt if no JTBDs for the scope in question (warn the
+   operator; offer to run `/jtbd-tasks` first).
 3. **Value Prop Canvas** (optional) — `docs/value-prop-canvas/*.md`.
    When present, Pain-Relievers + Gain-Creators ground the "why
    this goal matters" framing in the stakeholders+interests block.

package/dist/lite/bassclef-version.json

@@ -1,7 +1,7 @@
 {
-  "version": "v1.6.6",
-  "marker_tag": "release-2026-10-05-484c6f3e",
-  "release_date": "2026-10-05T03:42:33Z",
-  "release_sha": "484c6f3e",
-  "release_tag": "release-2026-10-05-484c6f3e"
+  "version": "v1.8.0",
+  "marker_tag": "release-2026-10-06-a874c748",
+  "release_date": "2026-10-06T20:56:57Z",
+  "release_sha": "a874c748",
+  "release_tag": "v1.8.0"
 }

package/dist/lite/lib/composer-preflight.sh

@@ -269,6 +269,18 @@ composer_preflight_check() {
       echo "check_6_message=hosting_platform=none + --no-launch (variants-only run)"
       echo "check_6_recommendation="
       pass=$((pass + 1))
+    elif [ "$skill_name" = "build" ]; then
+      # cli#309 cure — /build has no --no-launch flag and its Phase 7 deploy
+      # is a documented stub (see .claude/skills/build/SKILL.md Phase 7). Warn
+      # (not fail) so dispatch proceeds; Phase 7 will emit a TODO rather than
+      # run a real deploy. Adopter can set a real hosting_platform when ready
+      # to use Phase 7 live.
+      # Anchor: @luminary tony-hoare (postcondition per skill) +
+      # @luminary michael-nygard (fail-soft when it does not matter).
+      echo "check_6_status=warn"
+      echo "check_6_message=hosting_platform=none — /build Phase 7 deploy is a stub; dispatch proceeds, deploy emits TODO instead of running"
+      echo "check_6_recommendation=Set hosting_platform to a deploy provider (amplify) when ready to live-deploy; see .claude/skills/build/SKILL.md Phase 7"
+      warn=$((warn + 1))
     else
       echo "check_6_status=fail"
       echo "check_6_message=hosting_platform=none — composer would generate variants that can't launch"

package/dist/lite/lib/last-block.sh

@@ -0,0 +1,153 @@
+#!/usr/bin/env bash
+# tier: lite
+# lib/last-block.sh — persist and read BLOCK banners.
+#
+# Per @luminary john-ousterhout deep module: three narrow functions hide
+# the plaintext marker format. Callers persist, read, and list without
+# touching file layout.
+#
+# Exposed functions:
+#   record_last_block <hook> <severity> <message>   — write a marker
+#   read_last_block [<hook>]                        — read one marker (newest if no arg)
+#   list_last_blocks                                — list every marker newest first
+#
+# Marker format (plaintext, grep-friendly):
+#   hook: <hook-name>
+#   severity: blocking|advisory|info
+#   fired_at: <ISO-8601 UTC>
+#   session: <session-id or "unknown">
+#   ---
+#   <verbatim banner text, truncated to 8KB with [truncated] marker>
+#
+# Fail-soft: every write path returns 0 even on failure; stderr WARN
+# describes the problem. Per @luminary michael-nygard — a persistence lib
+# must never crash its caller.
+#
+# Per bassclef-upstream#2036 Finding #10 + UC-skill-last-block.md.
+
+# Resolve the marker directory. Caller overrides via LAST_BLOCK_DIR for
+# tests. Default is state/markers/last-block/ under CLAUDE_PROJECT_DIR
+# (fallback to current dir when unset).
+_last_block_dir() {
+  if [ -n "${LAST_BLOCK_DIR:-}" ]; then
+    echo "$LAST_BLOCK_DIR"
+  else
+    echo "${CLAUDE_PROJECT_DIR:-.}/state/markers/last-block"
+  fi
+}
+
+# record_last_block <hook> <severity> <message>
+# Writes a marker. Fail-soft on every error (returns 0; WARN to stderr).
+record_last_block() {
+  local hook="${1:-unknown}"
+  local severity="${2:-blocking}"
+  local message="${3:-}"
+  local dir
+  dir="$(_last_block_dir)"
+
+  # mkdir -p fail-soft — read-only disk, permission denied, etc.
+  if ! mkdir -p "$dir" 2>/dev/null; then
+    echo "record_last_block: cannot create '$dir' — marker not written" >&2
+    return 0
+  fi
+
+  # Truncate banner text to 8192 bytes to bound marker size.
+  local max_bytes=8192
+  local truncated=""
+  local body_bytes
+  body_bytes=$(printf '%s' "$message" | wc -c | tr -d ' ')
+  if [ "$body_bytes" -gt "$max_bytes" ]; then
+    message="$(printf '%s' "$message" | head -c "$max_bytes")"
+    truncated=$'\n[truncated — original was '"$body_bytes"' bytes]'
+  fi
+
+  local ts
+  ts="$(date -u +'%Y-%m-%dT%H:%M:%SZ' 2>/dev/null || echo 'unknown')"
+  local session_id="${CLAUDE_SESSION_ID:-unknown}"
+  local marker="$dir/${hook}.marker"
+  local tmp="${marker}.tmp.$$"
+
+  {
+    printf 'hook: %s\n' "$hook"
+    printf 'severity: %s\n' "$severity"
+    printf 'fired_at: %s\n' "$ts"
+    printf 'session: %s\n' "$session_id"
+    printf '%s\n' '---'
+    printf '%s%s\n' "$message" "$truncated"
+  } > "$tmp" 2>/dev/null || {
+    echo "record_last_block: write to '$tmp' failed — marker not written" >&2
+    rm -f "$tmp" 2>/dev/null
+    return 0
+  }
+
+  if ! mv "$tmp" "$marker" 2>/dev/null; then
+    echo "record_last_block: rename to '$marker' failed — marker not written" >&2
+    rm -f "$tmp" 2>/dev/null
+    return 0
+  fi
+
+  return 0
+}
+
+# read_last_block [<hook>]
+# Prints a marker's banner. With a hook arg, reads that marker. With no
+# args, reads the newest marker by mtime. Returns 1 when no marker found.
+read_last_block() {
+  local dir
+  dir="$(_last_block_dir)"
+
+  if [ ! -d "$dir" ]; then
+    echo "no block recorded (no markers directory at $dir)" >&2
+    return 1
+  fi
+
+  local marker
+  if [ $# -ge 1 ] && [ -n "$1" ]; then
+    marker="$dir/${1}.marker"
+    if [ ! -f "$marker" ]; then
+      echo "no block recorded for '$1'" >&2
+      return 1
+    fi
+  else
+    # Newest by mtime. ls -t is intentional (sort-by-mtime is its purpose).
+    # shellcheck disable=SC2012
+    marker="$(ls -t "$dir"/*.marker 2>/dev/null | head -1)"
+    if [ -z "$marker" ]; then
+      echo "no block recorded this session or prior" >&2
+      return 1
+    fi
+  fi
+
+  cat "$marker"
+  return 0
+}
+
+# list_last_blocks
+# Lists every marker newest first — one line per marker with hook name,
+# severity, timestamp. Returns 1 when the directory is empty or absent.
+list_last_blocks() {
+  local dir
+  dir="$(_last_block_dir)"
+
+  if [ ! -d "$dir" ]; then
+    echo "no blocks recorded (no markers directory at $dir)" >&2
+    return 1
+  fi
+
+  local markers
+  # shellcheck disable=SC2012
+  markers="$(ls -t "$dir"/*.marker 2>/dev/null)"
+  if [ -z "$markers" ]; then
+    echo "no blocks recorded (directory empty)" >&2
+    return 1
+  fi
+
+  local m hook severity fired_at
+  echo "$markers" | while IFS= read -r m; do
+    hook="$(awk -F': ' '/^hook:/{print $2; exit}' "$m" 2>/dev/null)"
+    severity="$(awk -F': ' '/^severity:/{print $2; exit}' "$m" 2>/dev/null)"
+    fired_at="$(awk -F': ' '/^fired_at:/{print $2; exit}' "$m" 2>/dev/null)"
+    printf '%s\t%s\t%s\n' "$hook" "$severity" "$fired_at"
+  done
+  return 0
+}

package/dist/lite/lib/state.sh

@@ -1090,6 +1090,17 @@ state_reference_get() {
     marker)
       state_marker_get "$id"
       ;;
+    input-artifact)
+      # InputArtifact — Shape C (pure JSON) per state-spine.md L262.
+      # Added per sunj-labs/bassclef-cli#315: /objectory-decompose Step 1
+      # reads input-artifact via this accessor; without a case the call
+      # exited 5 and the SKILL could not read the artifact in lite.
+      if [ -f "docs/input-artifacts/${id}.json" ]; then
+        cat "docs/input-artifacts/${id}.json"
+      else
+        return 1
+      fi
+      ;;
     gate)
       # Gates derive from Markers; not addressable directly in v0
       echo "state_reference_get: gate type derives from Marker; not directly addressable in v0" >&2

package/dist/lite/scripts/interpret-input.sh

@@ -52,12 +52,14 @@ SOURCE=""
 TYPE="auto"
 PERSIST=0
 SLUG=""
+INTENT=""     # cli#319 cure — operator intent text; defaults to SOURCE in text mode
 
 while [ $# -gt 0 ]; do
   case "$1" in
     --type=*) TYPE="${1#--type=}"; shift ;;
     --persist) PERSIST=1; shift ;;
     --slug=*) SLUG="${1#--slug=}"; shift ;;
+    --intent=*) INTENT="${1#--intent=}"; shift ;;    # cli#319
     --help|-h) usage; exit 0 ;;
     --*) echo "interpret-input: unknown flag '$1'" >&2; usage >&2; exit 2 ;;
     *)
@@ -117,7 +119,15 @@ fi
 
 NOW=$(date -u +%Y-%m-%dT%H:%M:%SZ)
 
-STRUCTURAL_HINTS='{}'
+# cli#319 cure — default INTENT to SOURCE in text mode; empty otherwise.
+# /pick-luminaries matches intent against the luminary catalog; an empty
+# intent is explicitly valid (adopters may inject it later), but text input
+# carries operator intent in SOURCE already — reuse it as a safe default.
+if [ -z "$INTENT" ] && [ "$TYPE" = "text" ]; then
+  INTENT="$SOURCE"
+fi
+
+STRUCTURAL_HINTS='{"verb_goal_pairs": []}'
 
 case "$TYPE" in
   text)
@@ -149,7 +159,7 @@ case "$TYPE" in
     if [ -z "$REPO_LOCAL" ]; then
       # Source can't be resolved; return Phase B-style stub (still valid InputArtifact)
       EXTRACTED_TEXT="deferred to Phase C"
-      STRUCTURAL_HINTS='{}'
+      STRUCTURAL_HINTS='{"verb_goal_pairs": []}'
     else
       EXTRACT_OUT=$(bash "$REPO_ROOT/scripts/interpret-input/extract-repo.sh" "$REPO_LOCAL" 2>/dev/null)
       EXTRACT_RC=$?
@@ -160,10 +170,13 @@ case "$TYPE" in
 
       if [ "$EXTRACT_RC" != "0" ] || [ -z "$EXTRACT_OUT" ]; then
         EXTRACTED_TEXT="repo extraction returned no signal for $SOURCE"
-        STRUCTURAL_HINTS='{}'
+        STRUCTURAL_HINTS='{"verb_goal_pairs": []}'
       else
         EXTRACTED_TEXT=$(echo "$EXTRACT_OUT" | jq -r '.extracted_text')
-        STRUCTURAL_HINTS=$(echo "$EXTRACT_OUT" | jq -c '.structural_hints')
+        # cli#312 cure — merge default verb_goal_pairs: [] so downstream readers
+        # (/build, /launch templates) always find the key even when extract
+        # doesn't produce it. Extract wins on any key it does emit.
+        STRUCTURAL_HINTS=$(echo "$EXTRACT_OUT" | jq -c '{verb_goal_pairs: []} + .structural_hints')
       fi
     fi
     EXTERNAL_URLS='[]'
@@ -179,6 +192,7 @@ ARTIFACT=$(jq -n \
   --arg type "$TYPE" \
   --arg source "$SOURCE" \
   --arg extracted_text "$EXTRACTED_TEXT" \
+  --arg intent "$INTENT" \
   --arg created_at "$NOW" \
   --argjson external_urls "$EXTERNAL_URLS" \
   --argjson structural_hints "$STRUCTURAL_HINTS" \
@@ -187,6 +201,7 @@ ARTIFACT=$(jq -n \
     type: $type,
     source: $source,
     extracted_text: $extracted_text,
+    intent: $intent,
     structural_hints: $structural_hints,
     external_urls: $external_urls,
     created_at: $created_at

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

@@ -34,6 +34,76 @@ Every entry stays in this file for the life of the manifest. Never pruned. When
 
 ## Entries (newest first)
 
+### cli#319 — interpret-input writes intent field (v1.16.9 → v1.16.10, 2026-10-07)
+
+- **Change type:** content-change (1 file: `scripts/interpret-input.sh`). Script now emits `intent` field in input-artifact JSON. Prior shape omitted it.
+- **Fields:** 448 entries (unchanged). Content hash shifts on the `interpret-input` script slug.
+- **Version bump:** v1.16.9 → v1.16.10 (patch — content-only change on 1 slug; rides on top of cli#312 v1.16.9 bump).
+- **Rationale:** bassclef-cli#319 — Kunal cold-adopter smoke caught downstream readers (`/launch`, `/build`) needing the intent field + missing on artifact JSON. Per PR #2105.
+- **Downstream cure:** no action for adopters at exact-pin. Downstream readers now get a stable intent key.
+- **Old shape retired:** nothing retired. Additive key.
+
+
+### cli#312 — interpret-input emits verb_goal_pairs default (v1.16.8 → v1.16.9, 2026-10-07)
+
+- **Change type:** content-change (1 file: `scripts/interpret-input.sh`). Script now writes `structural_hints.verb_goal_pairs` as an empty array when no pairs detected. Prior code omitted the key.
+- **Fields:** 448 entries (unchanged). Content hash shifts on the `interpret-input` script slug.
+- **Version bump:** v1.16.8 → v1.16.9 (patch — content-only change on 1 slug; rides on top of cli#324 v1.16.8 bump).
+- **Rationale:** bassclef-cli#312 — Kunal cold-adopter smoke caught downstream readers tripping on missing key. Default-empty-array is defensive. Per PR #2104.
+- **Downstream cure:** no action for adopters at exact-pin. Downstream readers of `structural_hints.verb_goal_pairs` get a consistent array shape.
+- **Old shape retired:** nothing retired. Behavior is additive — the key always exists now; readers that handled missing-key still work.
+
+
+### cli#324 — /launch Phase 11 greenfield partial vs redesign full (v1.16.7 → v1.16.8, 2026-10-07)
+
+- **Change type:** content-change (1 file: `.claude/skills/launch/SKILL.md`). Phase 11 now distinguishes greenfield partial-fit from redesign full-fit. Prior behavior conflated both cases.
+- **Fields:** 448 entries (unchanged). Content hash shifts on the `launch` skill slug.
+- **Version bump:** v1.16.7 → v1.16.8 (patch — content-only change on 1 slug; rides on top of cli#322 v1.16.7 bump).
+- **Rationale:** bassclef-cli#324 — Kunal cold-adopter smoke caught `/launch` Phase 11 misreading greenfield intents as redesign full-reshape. Partial-fit path missing. Per PR #2103.
+- **Downstream cure:** no action for adopters at exact-pin. Phase 11 now reads adopter intent + routes to partial OR full. Prior sessions that hit full-reshape see no regression (full stays as-is).
+- **Old shape retired:** nothing retired. Phase 11 branch is additive.
+
+
+### cli#322 — /launch Phase 14 jargon gate (v1.16.6 → v1.16.7, 2026-10-07)
+
+- **Change type:** content-change (1 file: `.claude/skills/launch/SKILL.md`). Phase 14 template now runs a jargon gate on the output before writing. Prior behavior shipped jargon through.
+- **Fields:** 448 entries (unchanged). Content hash shifts on the `launch` skill slug.
+- **Version bump:** v1.16.6 → v1.16.7 (patch — content-only change on 1 slug; rides on top of cli#309 v1.16.6 bump).
+- **Rationale:** bassclef-cli#322 — Kunal cold-adopter smoke caught `/launch` Phase 14 shipping bassclef-internal jargon into adopter-facing output. Per PR #2100.
+- **Downstream cure:** no action for adopters at exact-pin. Phase 14 now surfaces jargon via gate before write.
+- **Old shape retired:** nothing retired. Gate is additive.
+
+
+### cli#309 — /build hosting_platform=none warns (v1.16.5 → v1.16.6, 2026-10-07)
+
+- **Change type:** content-change (1 file: `lib/composer-preflight.sh`). Helper now warns + continues when hosting_platform=none instead of refusing. Prior code refused unconditionally.
+- **Fields:** 448 entries (unchanged). Content hash shifts on the `composer-preflight` lib slug.
+- **Version bump:** v1.16.5 → v1.16.6 (patch — content-only change on 1 slug; rides on top of cli#311 v1.16.5 bump).
+- **Rationale:** bassclef-cli#309 — Kunal cold-adopter smoke caught `/build` refusing when adopter opted out of hosting. Local-only builds are a valid shape. Per PR #2101.
+- **Downstream cure:** no action for adopters at exact-pin. Local-only builds (hosting_platform=none) now warn + proceed.
+- **Old shape retired:** nothing retired. Behavior is additive — refuse stays for other invalid states.
+
+
+### cli#311 — artifact-ingestion-gate skip when parent_bet is null (v1.16.4 → v1.16.5, 2026-10-07)
+
+- **Change type:** content-change (1 file: `.claude/hooks/artifact-ingestion-gate.sh`). Hook now skips the goal-doc parent-walk when the active goal declares `parent_bet: null` in frontmatter. Prior behavior treated null as missing + fired BLOCK on orientation-gate.
+- **Fields:** 448 entries (unchanged). Content hash shifts on the `artifact-ingestion-gate` hook slug.
+- **Version bump:** v1.16.4 → v1.16.5 (patch — content-only change on 1 slug; no entry count change).
+- **Rationale:** bassclef-cli#311 — Kunal cold-adopter smoke caught the orientation-gate firing BLOCK on root-level goals (no parent). Null parent_bet is valid state for arc-root goals; the gate was treating it as unresolved reference. Per PR #2102.
+- **Downstream cure:** no action for adopters at exact-pin. Root goals with `parent_bet: null` stop firing BLOCK at session-start; existing goals with non-null parents still get the walk.
+- **Old shape retired:** nothing retired. Null-parent-bet branch is additive on top of existing walk logic.
+
+
+### #2036 Finding #10 — /last-block skill + marker format (v1.15.5 → v1.16.0, 2026-10-06)
+
+- **Change type:** content-add (4 new files: `.claude/skills/last-block/SKILL.md`, `lib/last-block.sh`, `.claude/rules/last-block-marker.md`, `.claude/hooks/session-reflection.d/97-last-block-count.sh`). New skill that prints the exact text of a BLOCK or guardrail banner from this session or prior. New marker format at `state/last-block/<slug>.md`.
+- **Fields:** 448 entries (+4 from 444). Four new slugs — skill `last-block`, lib `last-block`, rule `last-block-marker`, hook `97-last-block-count`.
+- **Version bump:** v1.15.5 → v1.16.0 (minor — content-add of 4 new lite slugs). Rides on top of Finding #7 which landed first (v1.15.4 → v1.15.5).
+- **Rationale:** Kunal v1.6.4 adopter run — "I saw a BLOCK banner scroll off the top of the terminal. No way to read it again." Finding #10 adds `/last-block` for recall + a hook that counts markers at session-reflection time. Per bassclef-upstream#2036 Finding #10 + PR #2061.
+- **Downstream cure:** no action for adopters at exact-pin. Four new files land on next sync — all `tier: lite` so every tier picks them up. No shape change on existing slugs.
+- **Old shape retired:** nothing retired (content-add only).
+
+
 ### cli#305 — identifier-leak scrub self-exclude + commit author check (v1.15.3 → v1.15.4, 2026-10-04)
 
 - **Change type:** content-change (1 file: `.claude/hooks/pre-commit-identifier-leak-scrub.sh`). Check 2 now filters out hunks from the hook's own files, its test, the rule, and the pattern source. Check 3 added — scans `git var GIT_AUTHOR_IDENT` for the pattern set plus the `.local` suffix. BLOCK banner adds a resolution path pointing at the GitHub no-reply address.

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

@@ -1,7 +1,7 @@
 {
   "tier": "lite",
-  "manifest_version": "1.15.5",
-  "generated_at": "2026-10-04T22:12:41Z",
+  "manifest_version": "1.16.10",
+  "generated_at": "2026-10-06T20:37:31Z",
   "entries": [
     {
       "slug": "029-release-pipeline",
@@ -315,12 +315,20 @@
       "content_hash": "sha256:84ad2a7a53280369506a584d96085acc143a592d50fc9dd6ca70fe9ca9f6eaef",
       "description": "97-install-class-dispatch.sh — fragment that sources the install-class"
     },
+    {
+      "slug": "97-last-block-count",
+      "type": "hook",
+      "path": ".claude/hooks/session-reflection.d/97-last-block-count.sh",
+      "tier": "lite",
+      "content_hash": "sha256:850263f8cb92f2a42758f577ea7e06dce990d4c0b8d8d3a4a2cbc8fd6497a2fa",
+      "description": "Session-reflection fragment — surface last-block marker count."
+    },
     {
       "slug": "artifact-ingestion-gate",
       "type": "hook",
       "path": ".claude/hooks/artifact-ingestion-gate.sh",
       "tier": "lite",
-      "content_hash": "sha256:f633c412002d62ed1e1458fff047e635b1a705a9b7fc4b2c47f16d0b9f5b0e9f",
+      "content_hash": "sha256:1d317b210ee902be6e60d47b94db5c265b24932e21d09623650a154cb5bda443",
       "description": "Artifact Ingestion Gate — fires on Write/Edit to generative artifact paths."
     },
     {
@@ -592,7 +600,7 @@
       "type": "hook",
       "path": ".claude/hooks/save-state.sh",
       "tier": "lite",
-      "content_hash": "sha256:b5bd5eb5d0e30f614c8afff6fd57380257413dfa08d7722b0e6e453bfa416e96",
+      "content_hash": "sha256:f2eb5009b9550ec235090021da1b46ab1fd9fe582bda56068ec16759bf5e7185",
       "description": "Save State — graceful checkpoint of all work in progress."
     },
     {
@@ -608,7 +616,7 @@
       "type": "hook",
       "path": ".claude/hooks/session-reflection.sh",
       "tier": "lite",
-      "content_hash": "sha256:7350b6b8e0163eb79207e01c2ef70be741ff6bcb94f23ca92acb387618b642d3",
+      "content_hash": "sha256:bd3c0fd948b150d9d94cd3dd60b3e288d20b8c58ebc11de98025371331026950",
       "description": "Session Start hook coordinator. Injects reflection prompt and iterates"
     },
     {
@@ -776,7 +784,7 @@
       "type": "lib",
       "path": "lib/composer-preflight.sh",
       "tier": "lite",
-      "content_hash": "sha256:70e8d5ac6a0c5c39c8e217206fe9e0d5bd3afe3ca402a98e095e5e041be5dc12",
+      "content_hash": "sha256:6276c6e012837104c8cbe14266319cc5809ab31e4b4bc9c4cad1de8fd19c2f74",
       "description": "lib/composer-preflight.sh — shared pre-flight check for composer skills."
     },
     {
@@ -851,6 +859,14 @@
       "content_hash": "sha256:38148e8de456928b13846c2999377c30ac303cf0369cc7755ecc0ba9a8f899fb",
       "description": "Install-written-paths manifest + accessor lib."
     },
+    {
+      "slug": "last-block",
+      "type": "lib",
+      "path": "lib/last-block.sh",
+      "tier": "lite",
+      "content_hash": "sha256:ebe007f9a6f01f76e3fa30ca8db6da0812bcc8ba0ad22d9d98625cd556c56e15",
+      "description": "lib/last-block.sh — persist and read BLOCK banners."
+    },
     {
       "slug": "luminary-pick",
       "type": "lib",
@@ -936,7 +952,7 @@
       "type": "lib",
       "path": "lib/state.sh",
       "tier": "lite",
-      "content_hash": "sha256:e8482e2cf41f90adfedb3dc58dc585547db93983a6ca71bb19ae3b0507a76307",
+      "content_hash": "sha256:1bd77e04250aa785363851c0aaf26f594b526cd95e4ec539a6f2d74615afb218",
       "description": "lib/state.sh — typed accessor library over bassclef's state spine."
     },
     {
@@ -1671,6 +1687,13 @@
       "content_hash": "sha256:bcee28ea68d61b635e0a6880eee6d92d2b04ecfc8cf7eeef4a726b48dd831115",
       "description": "When Orchestrator (or any agent) delegates a Construction stack to a subagent (Builder, Designer, Architect), the brief MUST include, verbatim and with file paths, every artifact…"
     },
+    {
+      "slug": "last-block-marker",
+      "type": "rule",
+      "path": ".claude/rules/last-block-marker.md",
+      "tier": "lite",
+      "content_hash": "sha256:e9148cb0ad5a179097719f19263beaabaa125e2952f16425406da6d1039901e8"
+    },
     {
       "slug": "lite-manifest-schema-change-discipline",
       "type": "rule",
@@ -2092,7 +2115,7 @@
       "type": "script",
       "path": "scripts/interpret-input.sh",
       "tier": "lite",
-      "content_hash": "sha256:882ac0c728bb903b59a3d92648e9db738d1cf503eebfe3bfdd28094b28e6167c",
+      "content_hash": "sha256:5faa7d7139471053d0a76883ceef0b39754326e489726aad7673421a3cf16f88",
       "description": "scripts/interpret-input.sh — input-handler CLI wrapper."
     },
     {
@@ -2249,7 +2272,7 @@
       "type": "skill",
       "path": ".claude/skills/build/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:a9196b9d0b89d8ed8619be911d3cae31b7e15b9bbe5d43592848c4310180cffb",
+      "content_hash": "sha256:739d409886adc42c0111d7fc21d6290ede7d4403d5b51a1050efd3799c9eb1c2",
       "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"
@@ -2503,7 +2526,7 @@
       "type": "skill",
       "path": ".claude/skills/ia-model/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:f1571468b8a84a0e6a3f1babea6db21d18282ce94ff1eb5b1a0e2ca758f5cb28",
+      "content_hash": "sha256:35ad02ec8931ce235c23b62f103d41b0edd3cecf88d2d25e6e01530c98d5302b",
       "description": "Build information architecture from an entity inventory plus task flows. Derives nav structure, labeling, and screen map from the domain nouns.",
       "inputs": [
         "Task flows from spec",
@@ -2522,7 +2545,7 @@
       "type": "skill",
       "path": ".claude/skills/interaction-design/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:fde42694455cfecd84aa51a616ea4dc96b9bd33ffbf807f36ba0a2ab0343eaaa",
+      "content_hash": "sha256:9382a33e8f35fb04c77ed89916abfacf018ab6f1fe2f8e42e59b2547fe0b8eec",
       "description": "Turn IA plus task flows into interaction design — state diagrams, sequence diagrams, user flows. Final step in the UX translation chain before decompose.",
       "inputs": [
         "IA model plus task flows"
@@ -2597,7 +2620,7 @@
       "type": "skill",
       "path": ".claude/skills/jtbd-tasks/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:77d6922a6f23ce17b2168a86f59365977bd7b4634ccecc3003adf1f7371f3bee",
+      "content_hash": "sha256:7982dbf7ff7da9a3c85ca0cc6d406abbbbc1cbcdef29d7d7eea1c938cdaa2f7f",
       "description": "Translate Jobs-to-be-Done into task analysis — HTA trees plus CTA decision points. First step in the UX translation chain.",
       "inputs": [
         "A JTBD statement or persona ref"
@@ -2632,12 +2655,20 @@
       "problem": "Scope grows. Prose fills with jargon. Adopters read a wall of bassclef-internal words and give up.",
       "value": "Two modes — scope compresses what ships. Words rewrites vocabulary to grade 8. Plain English at the wire."
     },
+    {
+      "slug": "last-block",
+      "type": "skill",
+      "path": ".claude/skills/last-block/SKILL.md",
+      "tier": "lite",
+      "content_hash": "sha256:bc7868b20c5a3e9a53461ef741d2e7799de3b5a20595fd272c59ea04817a8518",
+      "description": "Print the exact text of a BLOCK or guardrail banner you saw this session or prior. No args shows the newest. One hook name shows that hook. --list enumerates every stored banner newest first."
+    },
     {
       "slug": "launch",
       "type": "skill",
       "path": ".claude/skills/launch/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:f0373719bb530dbdc5721c6d253dff7c628afb75a4f94112cf0a622ce039e4b0",
+      "content_hash": "sha256:2a950b16e8ef4cdfe2f7f418855c66f5566c48b392dd6e950f83a087669fcd6b",
       "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"
@@ -2722,7 +2753,7 @@
       "type": "skill",
       "path": ".claude/skills/objectory-decompose/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:b7b87dbc4893eb7f464e1d08a5cb752c1e1f5a78e37cd97bce97fa71958a8828",
+      "content_hash": "sha256:d1174e8877d3b0d67801dcce3458952c6c556f7b4eee717bf11fd9a513b71ce6",
       "description": "Apply Jacobson's analysis method to an InputArtifact. Extracts entities (domain nouns), actors (verb subjects), verb-goal pairs (use case candidates). Classifies objects per BCE (Boundary / Control / Entity). Output at docs/decompositions/.",
       "inputs": [
         "An InputArtifact from /interpret-input"
@@ -3385,7 +3416,7 @@
       "type": "skill",
       "path": ".claude/skills/use-case/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:f181c284c49218429f9088652412f6f11822605d787c242b7e8105492d3fb3ef",
+      "content_hash": "sha256:43859ba8c958dbc281cc244616898c1f0f2547f99a789724632f0a4293cc7cf6",
       "description": "Produce Cockburn-style use cases — main success scenario, numbered extensions, preconditions, postconditions, and stakeholders. Closes the gap between /user-stories and /spec. Distinct from /task-scenarios (UX narrative).",
       "inputs": [
         "A feature or persona-scoped scope"
@@ -3840,7 +3871,7 @@
       "type": "standard",
       "path": "standards/lite-manifest-schema-changes.md",
       "tier": "lite",
-      "content_hash": "sha256:a3fb462a6061680fbb5416823055f0f7845d7b11c186479573bf7de7777a61ff",
+      "content_hash": "sha256:94cb2a396222954fed8bc29bbf13dd379c46ae49b983f8d546a83adbc89b1285",
       "description": "Chronological ledger of every lite-manifest schema change. Adopters read this before sync to know what shifted."
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thebassclef/lite",
-  "version": "1.9.10",
+  "version": "1.9.11",
   "description": "Bassclef CLI — install and upgrade bassclef in your project with two commands.",
   "keywords": [
     "bassclef",
@@ -42,7 +42,7 @@
     "LICENSE"
   ],
   "bassclef": {
-    "upstream_tag": "v0.46.0",
+    "upstream_tag": "v1.8.0",
     "wiring_manifest_schema_major": 2,
     "bundle_paths": [
       "dist/lite/"