@thebassclef/lite 1.9.10 → 1.9.12

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