@thebassclef/lite 1.9.4 → 1.9.5

package/dist/lite/scripts/launch/parse-input-args.sh

@@ -0,0 +1,177 @@
+#!/usr/bin/env bash
+# tier: lite
+# scripts/launch/parse-input-args.sh — argument parser for /launch
+# (bassclef#459 sub-bet 2 — LR3 WU-2; renamed under bassclef#967).
+#
+# Parses /launch args and emits structured output describing whether
+# the dispatch is text-mode (legacy paragraph input) or brownfield-mode
+# (repo URL or local path).
+#
+# Usage forms:
+#   bash parse-input-args.sh <tier> "<text-paragraph>"
+#   bash parse-input-args.sh <tier> --brownfield <repo-url-or-path>
+#
+# Output (JSON to stdout):
+#   {
+#     "tier": "medium" | "full",
+#     "input_type": "text" | "repo",
+#     "input_source": "<paragraph or URL or path>",
+#     "brownfield_flag": true | false
+#   }
+#
+# Exit codes:
+#   0 = parse OK
+#   2 = bad input (missing tier, missing source, unknown tier)
+#
+# Pairs with: .claude/skills/launch/SKILL.md Phase 0
+#             scripts/interpret-input.sh (downstream consumer when input_type=repo)
+
+set -u
+
+TIER="${1:-}"
+shift 2>/dev/null || true
+
+if [ -z "$TIER" ]; then
+  echo "parse-input-args: missing <tier> (medium|full)" >&2
+  exit 2
+fi
+
+# Validate tier
+case "$TIER" in
+  medium|full) ;;
+  quick|light)
+    echo "parse-input-args: $TIER is a prototype tier — use /preview $TIER instead" >&2
+    exit 2
+    ;;
+  *)
+    echo "parse-input-args: unknown tier '$TIER' (must be: medium|full)" >&2
+    exit 2
+    ;;
+esac
+
+INPUT_TYPE="text"
+INPUT_SOURCE=""
+BROWNFIELD_FLAG="false"
+VOICE_INPUT_FLAG="false"
+LOCAL_MODE="false"
+REUSE_ARTIFACT_PATH=""
+
+# Parse remaining args. --brownfield takes the next arg as source.
+# Otherwise the first non-flag positional arg is the text paragraph.
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --brownfield)
+      BROWNFIELD_FLAG="true"
+      INPUT_TYPE="repo"
+      shift
+      if [ $# -eq 0 ] || [ -z "${1:-}" ]; then
+        echo "parse-input-args: --brownfield requires a <repo-url-or-path> argument" >&2
+        exit 2
+      fi
+      INPUT_SOURCE="$1"
+      shift
+      ;;
+    --brownfield=*)
+      BROWNFIELD_FLAG="true"
+      INPUT_TYPE="repo"
+      INPUT_SOURCE="${1#--brownfield=}"
+      shift
+      if [ -z "$INPUT_SOURCE" ]; then
+        echo "parse-input-args: --brownfield= requires a value" >&2
+        exit 2
+      fi
+      ;;
+    --voice-input)
+      # Phase V Hey-Alexa MVD — input text originated from voice dictation.
+      # Phase 3.5 intent extraction applies tolerant settings per
+      # standards/voice-input-pattern.md.
+      VOICE_INPUT_FLAG="true"
+      shift
+      ;;
+    --local)
+      # bassclef#923 A2 — adopter without vendor accounts. Phase 12
+      # swaps bind-subdomain for scripts/launch/local-serve.sh; gallery
+      # served on localhost. Anthropic API key is the only credential
+      # needed.
+      LOCAL_MODE="true"
+      shift
+      ;;
+    --reuse-artifact)
+      # bassclef-upstream#716 — reuse a pre-shaped InputArtifact instead
+      # of minting a fresh one via interpret-input.sh. Phase 1 of the
+      # SKILL branches on REUSE_ARTIFACT_PATH being non-empty: validates
+      # the file against input-artifact.schema.json, copies to sprint
+      # slot, skips interpret-input dispatch. Default off preserves
+      # existing text / --brownfield / --voice-input behavior.
+      shift
+      if [ $# -eq 0 ] || [ -z "${1:-}" ]; then
+        echo "parse-input-args: --reuse-artifact requires a <path> argument" >&2
+        exit 2
+      fi
+      REUSE_ARTIFACT_PATH="$1"
+      if [ ! -f "$REUSE_ARTIFACT_PATH" ]; then
+        echo "parse-input-args: --reuse-artifact file not found: $REUSE_ARTIFACT_PATH" >&2
+        exit 2
+      fi
+      shift
+      ;;
+    --reuse-artifact=*)
+      REUSE_ARTIFACT_PATH="${1#--reuse-artifact=}"
+      shift
+      if [ -z "$REUSE_ARTIFACT_PATH" ]; then
+        echo "parse-input-args: --reuse-artifact= requires a value" >&2
+        exit 2
+      fi
+      if [ ! -f "$REUSE_ARTIFACT_PATH" ]; then
+        echo "parse-input-args: --reuse-artifact file not found: $REUSE_ARTIFACT_PATH" >&2
+        exit 2
+      fi
+      ;;
+    --no-launch|--persist|base=*|seed=*)
+      # Pass-through flags consumed by other phases; ignored here
+      shift
+      ;;
+    --*)
+      # Unknown flag — pass through (phase-specific parsing may handle it)
+      shift
+      ;;
+    *)
+      # Positional text input (legacy mode)
+      if [ -z "$INPUT_SOURCE" ]; then
+        INPUT_SOURCE="$1"
+      fi
+      shift
+      ;;
+  esac
+done
+
+# When --reuse-artifact is set without a paragraph, use the artifact
+# path as the INPUT_SOURCE so downstream SPRINT_SLUG md5 computation
+# stays deterministic.
+if [ -z "$INPUT_SOURCE" ] && [ -n "$REUSE_ARTIFACT_PATH" ]; then
+  INPUT_SOURCE="$REUSE_ARTIFACT_PATH"
+fi
+
+if [ -z "$INPUT_SOURCE" ]; then
+  echo "parse-input-args: missing input — pass a text paragraph or --brownfield <source> or --reuse-artifact <path>" >&2
+  exit 2
+fi
+
+# Emit JSON
+jq -n \
+  --arg tier "$TIER" \
+  --arg input_type "$INPUT_TYPE" \
+  --arg input_source "$INPUT_SOURCE" \
+  --arg reuse_artifact_path "$REUSE_ARTIFACT_PATH" \
+  --argjson brownfield_flag "$BROWNFIELD_FLAG" \
+  --argjson voice_input_flag "$VOICE_INPUT_FLAG" \
+  --argjson local_mode "$LOCAL_MODE" \
+  '{
+    tier: $tier,
+    input_type: $input_type,
+    input_source: $input_source,
+    reuse_artifact_path: $reuse_artifact_path,
+    brownfield_flag: $brownfield_flag,
+    voice_input_flag: $voice_input_flag,
+    local_mode: $local_mode
+  }'

package/dist/lite/scripts/longrun-preset-detect.sh

@@ -0,0 +1,87 @@
+#!/usr/bin/env bash
+# tier: lite
+# scripts/longrun-preset-detect.sh — /longrun Step 0.85 preset picker helper
+#
+# Reads three signal sources and returns exactly one preset:
+#   converged | exploratory | reversible-small | ambiguous
+#
+# Signals (precedence order):
+#   1. plan doc — docs/next-session-plan-*.md modified within 48h → converged
+#   2. problem marker — state/markers/state-a-problem/*.marker within 48h → converged
+#   3. whereami PRIMARY — next_in_flight_goal line with PRIMARY + priority-list
+#      shape AND no unresolved GATE line above → converged
+#   (else) → exploratory
+#
+# Contract (Hoare):
+#   Precondition:  whereami path OR plan-doc dir OR problem-marker dir given
+#   Postcondition: stdout contains exactly one preset string; stderr contains
+#                  a "trigger=<source>" line naming which signal fired
+#   Exit:          always 0 (advisory helper; picker uses stdout)
+#
+# Per bassclef-upstream#1598 preset picker + Q1 /longrun 2026-09-22 Step 1
+# Per docs/use-cases/UC-rule-longrun-prep-whereami-signal.md
+# Per .claude/rules/longrun-prep-plan-doc-compression.md
+# Anchor luminaries: parnas (narrow interface) + hoare (contract) + nygard (precedence)
+
+set -uo pipefail
+
+WHEREAMI=""
+PLAN_DOC_DIR=""
+PROBLEM_MARKER_DIR=""
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --whereami) WHEREAMI="$2"; shift 2 ;;
+    --plan-doc-dir) PLAN_DOC_DIR="$2"; shift 2 ;;
+    --problem-marker-dir) PROBLEM_MARKER_DIR="$2"; shift 2 ;;
+    *) shift ;;
+  esac
+done
+
+# Signal 1 — plan doc within 48h
+if [ -n "$PLAN_DOC_DIR" ] && [ -d "$PLAN_DOC_DIR" ]; then
+  plan_doc=$(find "$PLAN_DOC_DIR" -maxdepth 1 -name 'next-session-plan-*.md' -mtime -2 -type f 2>/dev/null | head -1)
+  if [ -n "$plan_doc" ]; then
+    echo "trigger=plan-doc" >&2
+    echo "converged"
+    exit 0
+  fi
+fi
+
+# Signal 2 — fresh problem marker within 48h
+if [ -n "$PROBLEM_MARKER_DIR" ] && [ -d "$PROBLEM_MARKER_DIR" ]; then
+  fresh_marker=$(find "$PROBLEM_MARKER_DIR" -type f -mtime -2 2>/dev/null | head -1)
+  if [ -n "$fresh_marker" ]; then
+    echo "trigger=problem-marker" >&2
+    echo "converged"
+    exit 0
+  fi
+fi
+
+# Signal 3 — whereami PRIMARY queue with no unresolved GATE
+if [ -n "$WHEREAMI" ] && [ -f "$WHEREAMI" ]; then
+  # Grab the next_in_flight_goal line plus continuation lines (support both
+  # inline whereami shape and multi-line bulleted shape).
+  # Read the line and the 10 lines following it — captures multi-line PRIMARY forms.
+  goal_block=$(awk '/^next_in_flight_goal:/{flag=1; n=0} flag {print; n++; if (n>=10) flag=0}' "$WHEREAMI" 2>/dev/null)
+  if [ -n "$goal_block" ]; then
+    # Check for PRIMARY (case-insensitive) anywhere in the block
+    has_primary=$(echo "$goal_block" | grep -iE 'primary' >/dev/null 2>&1 && echo "yes" || echo "no")
+    # Priority shape — numbered "(1)" OR "priority order" phrase
+    has_priority_shape=$(echo "$goal_block" | grep -iE '\(1\)|priority order' >/dev/null 2>&1 && echo "yes" || echo "no")
+
+    # GATE guard — check for unresolved GATE line preceding PRIMARY within the block
+    has_gate=$(echo "$goal_block" | grep -iE 'gate[[:space:]:—-].*primary|gate:.*wait|GATE[[:space:]]+—[[:space:]]*wait' >/dev/null 2>&1 && echo "yes" || echo "no")
+
+    if [ "$has_primary" = "yes" ] && [ "$has_priority_shape" = "yes" ] && [ "$has_gate" = "no" ]; then
+      echo "trigger=whereami-PRIMARY" >&2
+      echo "converged"
+      exit 0
+    fi
+  fi
+fi
+
+# No signal fired — default to exploratory
+echo "trigger=none" >&2
+echo "exploratory"
+exit 0

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

@@ -34,6 +34,42 @@ Every entry stays in this file for the life of the manifest. Never pruned. When
 
 ## Entries (newest first)
 
+### #1961 — persistent statusline for bassclef version + sync status (v1.12.2 → v1.13.0, 2026-09-27)
+
+- **Change type:** content-add (1 new entry: `statusline-version` lib) + content-change (2 files: `bassclef-sync` hook + `bassclef-orientation`)
+- **Fields:** 440 entries → 441 entries. New entry: `lib/statusline-version.sh` (type=lib, slug=`statusline-version`). Content hashes shift on `bassclef-sync` and `bassclef-orientation` slugs (state-file writer added; opt-in section documented).
+- **Version bump:** v1.12.2 → v1.13.0 (MINOR — new entry added, no shape shift, nothing removed).
+- **Rationale:** peer session `bassclef-cli-b2` cold-adopter smoke on cli v1.9.4 + bassclef v1.6.2 surfaced the visibility gap. Operators cannot see bassclef version + sync status on every prompt today; the SessionStart banner scrolls off. The new lib reads state written by `bassclef-sync.sh` at end-of-run and emits `bassclef v<X> · <sync_status>` for adopters who opt in at user-scope. See PR (this cure) + `docs/use-cases/UC-lib-statusline-version-drift.md` + `docs/decompositions/2026-09-27-statusline-version-drift.md`.
+- **Downstream cure:** none required. Adopters opt in via user-scope `~/.claude/settings.json` `statusLine.command` per the section in `.claude/bassclef-orientation.md`. Adopters who do not opt in see zero change.
+- **Old shape retired:** none — additive only.
+
+### #1959 — /onboard-repo friendlier first-run greeting (v1.12.1 → v1.12.2, 2026-09-27)
+
+- **Change type:** content-change (1 file: `onboard-repo` skill body)
+- **Fields:** 440 entries (unchanged). Content hash shifts on the `onboard-repo` slug — `.claude/skills/onboard-repo/SKILL.md` gains a new `## First-run greeting (state-detected)` section BEFORE the existing 4-option picker.
+- **Version bump:** v1.12.1 → v1.12.2 (content_hash change only → patch bump per policy).
+- **Rationale:** peer bassclef-cli-b2 cold-adopter smoke against cli v1.9.4 + bassclef v1.6.2 flagged the first-run picker as slower than needed. Fresh-init adopter with `.bassclef/init.manifest.json` under 24h + no remote + on main now reads a two-line question naming the two most common paths (share on GitHub / top up local) plus a `skip` line to the full picker. Adopters outside those state conditions see the current picker unchanged.
+- **Downstream cure:** none required. Adopters see one additional greeting section only when state matches.
+- **Old shape retired:** none — the existing picker is preserved verbatim as fallback.
+
+### #1962 — capability-probe self-check removed (v1.12.0 → v1.12.1, 2026-09-26)
+
+- **Change type:** content-change (1 file: `capability-probe`)
+- **Fields:** 440 entries (unchanged). Content hash shifts on the `capability-probe` slug — `lib/capability-probe.sh` loses the runtime self-check block at L124-140.
+- **Version bump:** v1.12.0 → v1.12.1 (content_hash change only → patch bump per policy).
+- **Rationale:** peer bassclef-cli-aa cold-adopter smoke against `@thebassclef/lite@1.6.2` surfaced false WARN emissions on stderr from a self-check that erroneously reported missing functions on healthy state. Root cause not reproduced in bassclef-upstream root. The Tier 0 test at `lib/tests/capability-probe.test.sh` T02 already asserts every function resolves after source; that signal is stricter and more precise. See PR (this cure).
+- **Downstream cure:** none required. Adopters see one fewer noise line on stderr when a session sources the lib.
+- **Old shape retired:** immediately. The runtime WARN was noise, not a promised feature.
+
+### #1960 — extractor recurses nested scripts + retags two scripts to lite (v1.11.3 → v1.12.0, 2026-09-26)
+
+- **Change type:** content-add (6 new entries) + policy-change (extractor recursion on 6 collections)
+- **Fields:** 434 entries → 440 entries. New entries: `scripts/launch/local-serve.sh`, `scripts/launch/local-serve-stop.sh`, `scripts/launch/parse-input-args.sh`, `scripts/interpret-input/extract-repo.sh`, `scripts/interpret-input.sh` (retag standard → lite), `scripts/longrun-preset-detect.sh` (retag upstream → lite).
+- **Version bump:** v1.11.3 → v1.12.0 (MINOR — entries added, no shape shift, no entries removed).
+- **Rationale:** `scripts/generate-lite-manifest.sh` used `find -maxdepth 1` on six collections (`lib/`, `scripts/`, `presence/install/` × 3 file extensions, `templates/`). Nested scripts under `scripts/launch/` and `scripts/interpret-input/` silently dropped. `/launch` and `/longrun` skills at `tier: lite` dispatched shell files public bassclef never shipped. Peer session `bassclef-cli-b2` surfaced the class during cold-adopter smoke on cli v1.9.4 + bassclef v1.6.2. See PR (this cure) + `docs/use-cases/UC-scripts-generate-lite-manifest-recurse.md`.
+- **Downstream cure:** none required for adopters at MINOR bump. Adopters pinning exact `manifest_version` (bassclef-web#256 + bassclef-cli#51 are the known consumers) update their pin from v1.11.x to v1.12.0 on their normal cadence. Coord comments posted on both tickets before the release cascade fires.
+- **Old shape retired:** immediately. The pre-v1.12.0 flat extraction had no adopter-observable contract worth preserving — the omitted scripts were bugs, not features.
+
 ### Track 1 v1.5.1 — bassclef-sync clone-fail postcondition emit + banner-to-stderr (v1.11.0 → v1.11.1, 2026-09-24)
 
 - **Change type:** content-change (1 file: `bassclef-sync-template`)

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

@@ -1,7 +1,7 @@
 {
   "tier": "lite",
-  "manifest_version": "1.11.2",
-  "generated_at": "2026-09-26T11:18:11Z",
+  "manifest_version": "1.13.0",
+  "generated_at": "2026-09-27T22:46:25Z",
   "entries": [
     {
       "slug": "029-release-pipeline",
@@ -608,7 +608,7 @@
       "type": "hook",
       "path": ".claude/hooks/session-reflection.sh",
       "tier": "lite",
-      "content_hash": "sha256:5d06b68d7503922cd3f5143ed2d83ec4e12c5d8e6f16822efcf2c702f49ed5b9",
+      "content_hash": "sha256:7350b6b8e0163eb79207e01c2ef70be741ff6bcb94f23ca92acb387618b642d3",
       "description": "Session Start hook coordinator. Injects reflection prompt and iterates"
     },
     {
@@ -728,7 +728,7 @@
       "type": "lib",
       "path": "lib/ancestor-claude-check.sh",
       "tier": "lite",
-      "content_hash": "sha256:f84c7b57ae28ef15b0c4c138ee4781030e04e7bb858ff0c53a80a538672d64dd",
+      "content_hash": "sha256:ccfbdb9f9d10f16c530c29d126a7a67386d2d15631e014ef1b44033d77c9a402",
       "description": "ancestor-claude-check.sh — walks up from a starting directory to $HOME"
     },
     {
@@ -744,7 +744,7 @@
       "type": "lib",
       "path": "lib/capability-probe.sh",
       "tier": "lite",
-      "content_hash": "sha256:12d4d7cfa78bd07e1f67a405a88b960ac62ac637297698d8ca43f217b74f4de0",
+      "content_hash": "sha256:2db9a81735980513eebc9712510cb3b615557a5ab1b48ace48840ed28bc1e4c1",
       "description": "lib/capability-probe.sh — capability probe deep module."
     },
     {
@@ -915,6 +915,14 @@
       "content_hash": "sha256:38b6cfa82123e75bb1046b97887060962a62d90ba9d089764529207ebf8c8194",
       "description": "lib/state.sh — typed accessor library over bassclef's state spine."
     },
+    {
+      "slug": "statusline-version",
+      "type": "lib",
+      "path": "lib/statusline-version.sh",
+      "tier": "lite",
+      "content_hash": "sha256:89785704ee8df0cccfd20b32bbcca537505872cda75ca49fa6ee2824b236b27f",
+      "description": "lib/statusline-version.sh — bassclef statusline reader."
+    },
     {
       "slug": "telemetry",
       "type": "lib",
@@ -1319,7 +1327,7 @@
       "type": "presence-template",
       "path": "presence/install/bassclef-sync.template.sh",
       "tier": "lite",
-      "content_hash": "sha256:d79a9a6499c1bcaa368e0472f7a9cd76611f2dbdb8ab2b42533c3f85de2323c4",
+      "content_hash": "sha256:92fa84059bd69964a35887b9b77812bfb3acc58c9ca4c9618bacf11d56079c2a",
       "description": "description: BASSCLEF_SYNC_VERSION=2026-09-06-1496-sessionstart-heal-v1"
     },
     {
@@ -1350,7 +1358,7 @@
       "type": "root-doc",
       "path": ".claude/bassclef-orientation.md",
       "tier": "lite",
-      "content_hash": "sha256:657e68fe29c52aaf9dd54ff752cf6f69498543484e4a764db89ba9837c0d9436"
+      "content_hash": "sha256:25270e2b752a37c485b824c09b72352d264d5f2febc77b85ba5f8087db1d63b2"
     },
     {
       "slug": "claude-lite",
@@ -1477,7 +1485,7 @@
       "type": "rule",
       "path": ".claude/rules/blocked-items.md",
       "tier": "lite",
-      "content_hash": "sha256:e81e1e48d86e38fff8ba109f356e769dab8bbf362160bd2febcd6ae8f13b2b9b",
+      "content_hash": "sha256:def3b1305f7d08d4b68cd7261827e1209d5606a9c35728b13f5c3ac4d68c9f66",
       "description": "Session-start hook output may contain lines prefixed with BLOCKED:."
     },
     {
@@ -2024,12 +2032,20 @@
       "content_hash": "sha256:d7a13ca4fb37283e50fc165bb5ebd6a65539d7dade005dcd38098e1d878c52b3",
       "description": "analyze-tier-dependencies.sh — orchestrator for the tier-dependency-audit subsystem"
     },
+    {
+      "slug": "extract-repo",
+      "type": "script",
+      "path": "scripts/interpret-input/extract-repo.sh",
+      "tier": "lite",
+      "content_hash": "sha256:ba15cb33e4d13ef3936d5ad7400a4be1460fae386189aafc9f29c382e4c6a16f",
+      "description": "scripts/interpret-input/extract-repo.sh — Phase C repo extractor."
+    },
     {
       "slug": "generate-lite-manifest",
       "type": "script",
       "path": "scripts/generate-lite-manifest.sh",
       "tier": "lite",
-      "content_hash": "sha256:6342c768c91af054a4dcb6ea3e63228f0c7b4ff0e188867026fe0cdd333e3fe5",
+      "content_hash": "sha256:8d2741d06181f41af3d30965cdfd655d20508807e3fc799877fa2564811e5608",
       "description": "Generate lite-manifest.json at repo root."
     },
     {
@@ -2048,6 +2064,14 @@
       "content_hash": "sha256:9921d0b4c0375b3099bc3dc8457800ad157837286244f0ede46f8146127d0b73",
       "description": "intent-drift-check.sh — measure intent drift after an artifact body rewrite."
     },
+    {
+      "slug": "interpret-input",
+      "type": "script",
+      "path": "scripts/interpret-input.sh",
+      "tier": "lite",
+      "content_hash": "sha256:882ac0c728bb903b59a3d92648e9db738d1cf503eebfe3bfdd28094b28e6167c",
+      "description": "scripts/interpret-input.sh — input-handler CLI wrapper."
+    },
     {
       "slug": "lite-manifest-drift-check",
       "type": "script",
@@ -2056,6 +2080,38 @@
       "content_hash": "sha256:0f14aa7aec1b52820c53f7f1fd5e58d8742fd426577a6a8682f8d5f0a5ceba5f",
       "description": "Detect drift between committed lite-manifest.json and current substrate state."
     },
+    {
+      "slug": "local-serve",
+      "type": "script",
+      "path": "scripts/launch/local-serve.sh",
+      "tier": "lite",
+      "content_hash": "sha256:5494f4b46308e4b799d4e3aa2accc1f0880c78280dc8e5f5bcb45537d40036ab",
+      "description": "local-serve.sh — serve a /launch local-mode prototype gallery via python http.server"
+    },
+    {
+      "slug": "local-serve-stop",
+      "type": "script",
+      "path": "scripts/launch/local-serve-stop.sh",
+      "tier": "lite",
+      "content_hash": "sha256:89a0ee5c195c806c08ffc7221525ff6f805bd904580f94e6e7ed34be236c067b",
+      "description": "local-serve-stop.sh — stop a local-serve.sh server by slug"
+    },
+    {
+      "slug": "longrun-preset-detect",
+      "type": "script",
+      "path": "scripts/longrun-preset-detect.sh",
+      "tier": "lite",
+      "content_hash": "sha256:b339d2213b68d7db6d4d26ffbef96071507e62368ac274423e8a7367cfdb951d",
+      "description": "scripts/longrun-preset-detect.sh — /longrun Step 0.85 preset picker helper"
+    },
+    {
+      "slug": "parse-input-args",
+      "type": "script",
+      "path": "scripts/launch/parse-input-args.sh",
+      "tier": "lite",
+      "content_hash": "sha256:b117181be876c6fb76a7e9d11cf1fcbc25bbf56a9b4877a35dbf96e9bad13906",
+      "description": "scripts/launch/parse-input-args.sh — argument parser for /launch"
+    },
     {
       "slug": "render-lite-manifest-doc",
       "type": "script",
@@ -2596,7 +2652,7 @@
       "type": "skill",
       "path": ".claude/skills/longrun/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:1ab5a98d5ea805249761e092c7c8c8523eb3cd7ce53e6d89790d01e767a3df4b",
+      "content_hash": "sha256:1a7dbaf2098525b68609e0eed0ad24c56d0fdf6e7905da6196c0c620b0de6976",
       "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",
@@ -2681,7 +2737,7 @@
       "type": "skill",
       "path": ".claude/skills/onboard-repo/SKILL.md",
       "tier": "lite",
-      "content_hash": "sha256:ff92c1539bbad449bbdcfc85430963ceeda8cae67a2eded953bc95dff24a3c75",
+      "content_hash": "sha256:1903e5140a85c40034d8109f522ad973da26d7a12a71ec9ae795c66438e23286",
       "description": "Bootstrap the bassclef framework in a new repo. Installs the sync hook. Scaffolds config, whereami, and CLAUDE.md. Modes: default, --with-deploy-host, --with-secrets, --full, --greenfield-from-intent (cold-adopter magic demo).",
       "inputs": [
         "Optional flags — --with-deploy-host or --with-secrets or --full"
@@ -3761,7 +3817,7 @@
       "type": "standard",
       "path": "standards/lite-manifest-schema-changes.md",
       "tier": "lite",
-      "content_hash": "sha256:bccea2ce3acc450f35729690e7c24706391c87186ce99ece91e574a8f4686c58",
+      "content_hash": "sha256:312775fd9c55feb4537a4346de309b73a37d8f3c44793aa62f43b14246f3a2cd",
       "description": "Chronological ledger of every lite-manifest schema change. Adopters read this before sync to know what shifted."
     },
     {
@@ -4001,7 +4057,7 @@
       "type": "standard",
       "path": "standards/session-start-banner-discipline.md",
       "tier": "lite",
-      "content_hash": "sha256:444a6f20be6bd175dabb06b8aedb527b9c93525786df0386fd785d1821451a4e",
+      "content_hash": "sha256:b9d4506ec8239583d7e61797b03cd4307531c664de0c4d384bdf1157162371e2",
       "description": "Four-level banner palette for session-start checks. Per Norman signifier + Cooper Sam persona consult. Match glyph to state."
     },
     {

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

@@ -9,26 +9,39 @@ Session-start checks in `.claude/hooks/session-reflection.d/` emit banners that
 
 This standard names a four-level palette. Each check picks the level that matches its own state.
 
-## The four levels
+## The five 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. |
+| GUARDRAIL | ⚙ | BASSCLEF DISCIPLINE GATE | The session must pause and apply discipline before proceeding. Not a defect. Chronicle stale, architect-review overdue, temperance marker missing, /decompose evidence owed. Per sunj-labs/bassclef-upstream#1930 Category A. |
 | 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). |
+| silent-on-clean | — | — | Check runs but reports nothing when state is nominal. Fires only on non-nominal state (which routes to one of the four above). |
 
 Every check picks exactly one level. Ambiguous cases default to silent-on-clean.
 
+BLOCK and GUARDRAIL both stop the session on substantive work. The difference is tone. BLOCK signals a defect. GUARDRAIL signals a discipline pause. Machine readers grep the `BLOCKED:` prefix on message body lines regardless of header shape.
+
 ## How to pick
 
-Ask two questions in order.
+Ask three 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.
+1. **Does this check indicate a real defect that will corrupt state?** If yes, BLOCK. Schema validation failure, dangling reference, corrupt state file, missing bassclef-sync template drift. These block.
+2. **Does this check ask the agent to pause and apply discipline?** If yes, GUARDRAIL. Chronicle stale, architect-review overdue, temperance missing, /decompose evidence owed, pre-mortem light not fired. These are steering, not defects.
+3. **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.
 
+## Helper functions
+
+Two shell helpers in `.claude/hooks/session-reflection.sh` render the banners.
+
+- `blocked_banner "$msg" [severity]` — renders BLOCK, ADVISORY, or INFO based on the second arg (default: blocking). Used by all four historical severities.
+- `guardrail_banner "$hook_name" "$step" "$retry"` — renders GUARDRAIL. Takes three args: hook name (goes in header), specific step, retry action. Reads `AI_NAME` from `${BASSCLEF_AI_NAME:-Claude}`. Per #1930 Category A design lock.
+
+Callers migrate from `blocked_banner` (blocking) to `guardrail_banner` one at a time when the check fits the discipline-gate shape (question 2 above). The additive-only path preserves the machine-reader contract.
+
 ## Signifier discipline (Norman)
 
 The glyph is a signifier — a perceivable cue that suggests state. The signifier fit is:

package/package.json

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