@thebassclef/lite 1.9.1 → 1.9.3

package/dist/lite/.claude/hooks/session-reflection.d/tests/01-adopter-message-channel.test.sh

@@ -0,0 +1,168 @@
+#!/bin/bash
+# tier: upstream
+# fixtures: mock-git-repos-inline
+# Tier 0 test for adopter message channel (bassclef-upstream#1926).
+#
+# Per @luminary alan-cooper Sam+Louis persona + @luminary donald-norman signifier
+# + @luminary linus-torvalds adopter contract.
+#
+# Source under test: .claude/hooks/session-reflection.d/01-adopter-message-channel.sh
+#
+# test-list (per .claude/rules/test-list-discipline.md — RED first, GREEN as they land):
+#
+# Fragment exists + executable
+# [ ] T00: fragment exists at expected path and is executable
+#
+# Fresh install gate — all 3 files absent → banner fires
+# [ ] T01: fresh install (no whereami, no substrate.config, no .claude/settings) → welcome text
+#
+# Onboarded gate — any of the 3 files present → silent
+# [ ] T02: whereami.md present → silent
+# [ ] T03: substrate.config.md present → silent
+# [ ] T04: .claude/settings.json present → silent
+# [ ] T08: bassclef itself (all 3 files present) → silent (Torvalds T1 fold)
+#
+# Override
+# [ ] T05: SKIP_ADOPTER_MESSAGES=1 → silent (bypass on fresh install)
+#
+# Message body (Cooper C2 fold)
+# [ ] T06: welcome text contains "Welcome to bassclef"
+# [ ] T07: welcome text contains "/onboard-repo"
+
+set -u
+
+REPO_ROOT="$(cd "$(dirname "$0")/../../../.." && pwd)"
+HOOK="${REPO_ROOT}/.claude/hooks/session-reflection.d/01-adopter-message-channel.sh"
+PASS=0
+FAIL=0
+FAILED_TESTS=()
+
+assert() {
+  local name="$1"
+  local ok="$2"
+  local why="$3"
+  if [ "$ok" = "1" ]; then
+    PASS=$((PASS + 1))
+    echo "  PASS: $name"
+  else
+    FAIL=$((FAIL + 1))
+    FAILED_TESTS+=("$name — $why")
+    echo "  FAIL: $name — $why"
+  fi
+}
+
+TMPROOT="$(mktemp -d -t adopter-message-channel.XXXXXX)"
+cleanup() { rm -rf "$TMPROOT"; }
+trap cleanup EXIT
+
+# --- T00: fragment exists + executable ---
+if [ -x "$HOOK" ]; then
+  assert "T00: fragment exists + executable" 1 ""
+else
+  assert "T00: fragment exists + executable" 0 "not found or not executable: $HOOK"
+  echo ""
+  echo "=== Results ==="
+  echo "PASS: $PASS"
+  echo "FAIL: $FAIL"
+  exit 1
+fi
+
+# --- Fixture builder ---
+run_hook_in() {
+  local tmpdir="$1"
+  (cd "$tmpdir" && bash "$HOOK" 2>&1)
+}
+
+# --- T01: fresh install (no state files) → welcome text ---
+SC_FRESH="$TMPROOT/fresh"
+mkdir -p "$SC_FRESH"
+OUT_T01=$(run_hook_in "$SC_FRESH")
+if echo "$OUT_T01" | grep -qE "Welcome to bassclef"; then
+  assert "T01: fresh install emits welcome text" 1 ""
+else
+  assert "T01: fresh install emits welcome text" 0 "no welcome text in: $OUT_T01"
+fi
+
+# --- T02: whereami.md present → silent ---
+SC_WHEREAMI="$TMPROOT/whereami-present"
+mkdir -p "$SC_WHEREAMI/docs"
+echo "---" > "$SC_WHEREAMI/docs/whereami.md"
+OUT_T02=$(run_hook_in "$SC_WHEREAMI")
+if [ -z "$OUT_T02" ]; then
+  assert "T02: whereami.md present → silent" 1 ""
+else
+  assert "T02: whereami.md present → silent" 0 "unexpected output: $OUT_T02"
+fi
+
+# --- T03: substrate.config.md present → silent ---
+SC_CONFIG="$TMPROOT/config-present"
+mkdir -p "$SC_CONFIG"
+echo "---" > "$SC_CONFIG/substrate.config.md"
+OUT_T03=$(run_hook_in "$SC_CONFIG")
+if [ -z "$OUT_T03" ]; then
+  assert "T03: substrate.config.md present → silent" 1 ""
+else
+  assert "T03: substrate.config.md present → silent" 0 "unexpected output: $OUT_T03"
+fi
+
+# --- T04: .claude/settings.json present → silent ---
+SC_SETTINGS="$TMPROOT/settings-present"
+mkdir -p "$SC_SETTINGS/.claude"
+echo '{}' > "$SC_SETTINGS/.claude/settings.json"
+OUT_T04=$(run_hook_in "$SC_SETTINGS")
+if [ -z "$OUT_T04" ]; then
+  assert "T04: .claude/settings.json present → silent" 1 ""
+else
+  assert "T04: .claude/settings.json present → silent" 0 "unexpected output: $OUT_T04"
+fi
+
+# --- T05: SKIP_ADOPTER_MESSAGES=1 bypass on fresh install ---
+SC_SKIP="$TMPROOT/skip"
+mkdir -p "$SC_SKIP"
+OUT_T05=$(SKIP_ADOPTER_MESSAGES=1 run_hook_in "$SC_SKIP")
+if [ -z "$OUT_T05" ] || echo "$OUT_T05" | grep -qE "SKIP_ADOPTER_MESSAGES"; then
+  assert "T05: SKIP_ADOPTER_MESSAGES=1 bypasses" 1 ""
+else
+  assert "T05: SKIP_ADOPTER_MESSAGES=1 bypasses" 0 "banner fired: $OUT_T05"
+fi
+
+# --- T06: welcome text contains "Welcome to bassclef" ---
+if echo "$OUT_T01" | grep -qE "Welcome to bassclef"; then
+  assert "T06: welcome contains 'Welcome to bassclef'" 1 ""
+else
+  assert "T06: welcome contains 'Welcome to bassclef'" 0 "missing in: $OUT_T01"
+fi
+
+# --- T07: welcome text contains "/onboard-repo" ---
+if echo "$OUT_T01" | grep -qE "/onboard-repo"; then
+  assert "T07: welcome contains '/onboard-repo'" 1 ""
+else
+  assert "T07: welcome contains '/onboard-repo'" 0 "missing in: $OUT_T01"
+fi
+
+# --- T08: bassclef itself (all 3 files present) → silent ---
+SC_BASSCLEF="$TMPROOT/bassclef"
+mkdir -p "$SC_BASSCLEF/docs" "$SC_BASSCLEF/.claude"
+echo "---" > "$SC_BASSCLEF/docs/whereami.md"
+echo "---" > "$SC_BASSCLEF/substrate.config.md"
+echo '{}' > "$SC_BASSCLEF/.claude/settings.json"
+OUT_T08=$(run_hook_in "$SC_BASSCLEF")
+if [ -z "$OUT_T08" ]; then
+  assert "T08: bassclef itself (all 3 present) → silent" 1 ""
+else
+  assert "T08: bassclef itself (all 3 present) → silent" 0 "unexpected: $OUT_T08"
+fi
+
+# --- Summary ---
+echo ""
+echo "=== Results ==="
+echo "PASS: $PASS"
+echo "FAIL: $FAIL"
+if [ "$FAIL" -gt 0 ]; then
+  echo ""
+  echo "Failed tests:"
+  for t in "${FAILED_TESTS[@]}"; do
+    echo "  - $t"
+  done
+  exit 1
+fi

package/dist/lite/bassclef-version.json

@@ -1,7 +1,7 @@
 {
-  "version": "v1.5.1",
-  "marker_tag": "release-2026-09-24-c4fa9e65",
-  "release_date": "2026-09-24T16:59:30Z",
-  "release_sha": "c4fa9e65",
-  "release_tag": "release-2026-09-24-c4fa9e65"
+  "version": "v1.5.2",
+  "marker_tag": "release-2026-09-25-26328f36",
+  "release_date": "2026-09-25T17:01:41Z",
+  "release_sha": "26328f36",
+  "release_tag": "release-2026-09-25-26328f36"
 }

package/dist/lite/presence/install/bassclef-hook-connect.sh

@@ -31,6 +31,102 @@
 # If this list changes, update sync.template.sh L777 in the same PR.
 LANE_3_HOOKS=(vendored-dispatcher-refresh.sh session-reflection.sh session-start-recap-inject.sh)
 
+# _bhc_resolve_adopter_tier <adopter_cwd> — private helper (per RFC Ousterhout 3a).
+# Precedence: BASSCLEF_TIER env → .bassclef-source.json `tier` field →
+# .claude/bassclef-configs.jsonc `adopter.tier` → empty.
+# Prints tier value to stdout; empty on no-tier-declared.
+_bhc_resolve_adopter_tier() {
+  local adopter_cwd="$1"
+
+  # 1. Env override (test-only + peer coordination)
+  if [ -n "${BASSCLEF_TIER:-}" ]; then
+    echo "$BASSCLEF_TIER"
+    return 0
+  fi
+
+  # 2. .bassclef-source.json tier field
+  local source_json="$adopter_cwd/.bassclef-source.json"
+  if [ -f "$source_json" ] && command -v jq >/dev/null 2>&1; then
+    local t
+    t=$(jq -r '.tier // empty' "$source_json" 2>/dev/null)
+    if [ -n "$t" ]; then
+      echo "$t"
+      return 0
+    fi
+  fi
+
+  # 3. .claude/bassclef-configs.jsonc adopter.tier — reuse lib/tier-check.sh
+  #    precedent: strip comments + jsonc → json parse via python3.
+  local configs="$adopter_cwd/.claude/bassclef-configs.jsonc"
+  if [ -f "$configs" ] && command -v python3 >/dev/null 2>&1; then
+    local t
+    t=$(python3 - "$configs" 2>/dev/null <<'PYEOF'
+import json, re, sys
+try:
+    with open(sys.argv[1]) as f:
+        content = f.read()
+    content = re.sub(r'/\*.*?\*/', '', content, flags=re.DOTALL)
+    content = re.sub(r'//[^\n]*', '', content)
+    d = json.loads(content)
+    t = d.get('adopter', {}).get('tier', '') or d.get('tier', '')
+    if t:
+        print(t)
+except Exception:
+    pass
+PYEOF
+)
+    if [ -n "$t" ]; then
+      echo "$t"
+      return 0
+    fi
+  fi
+
+  # 4. No tier declared
+  return 0
+}
+
+# _bhc_tier_rank <tier> — bassclef tier ordering per ADR-052 D6.
+# Higher rank = broader hook set. lite < standard < ultra < upstream.
+# Prints rank integer to stdout; 0 on unknown.
+_bhc_tier_rank() {
+  case "$1" in
+    lite) echo 1 ;;
+    standard) echo 2 ;;
+    ultra) echo 3 ;;
+    upstream) echo 4 ;;
+    *) echo 0 ;;
+  esac
+}
+
+# _bhc_load_tier_hook_basenames <bassclef_root> <tier> — private helper (per RFC Ousterhout 3a).
+# Prints newline-delimited set of hook basenames in the tier's manifest.
+# Two source patterns per adopter-simulator-lite Assertion 7 pattern:
+#   1. Direct hook — `.claude/hooks/<name>.sh` → basename `<name>.sh`
+#   2. Install template — `presence/install/<name>.template.sh` → basename `<name>.sh`
+# Empty output when manifest missing or malformed (fail-soft per Nygard).
+_bhc_load_tier_hook_basenames() {
+  local bassclef_root="$1"
+  local tier="$2"
+  local manifest="$bassclef_root/${tier}-manifest.json"
+
+  if [ ! -f "$manifest" ]; then
+    return 0
+  fi
+
+  if ! command -v jq >/dev/null 2>&1; then
+    return 0
+  fi
+
+  if ! jq -e . "$manifest" >/dev/null 2>&1; then
+    return 0
+  fi
+
+  {
+    jq -r '.entries[]? | .path | select(test("^\\.claude/hooks/[^/]+\\.sh$"))' "$manifest" 2>/dev/null | sed -E 's#^\.claude/hooks/##'
+    jq -r '.entries[]? | .path | select(test("^presence/install/[^/]+\\.template\\.sh$"))' "$manifest" 2>/dev/null | sed -E 's#^presence/install/##; s#\.template\.sh$#.sh#'
+  } | sort -u
+}
+
 # bassclef_hook_connect_apply <adopter_cwd> [<bassclef_root>]
 #
 # Reads $bassclef_root/.claude/settings.json (or $BASSCLEF_SOURCE_ROOT if
@@ -125,12 +221,33 @@ bassclef_hook_connect_apply() {
   local lane3_re
   lane3_re=$(printf '%s\n' "${LANE_3_HOOKS[@]}" | sed 's/\.sh$//' | paste -sd'|' -)
 
+  # === Tier filter (bassclef-upstream#1946) ===
+  # Resolve adopter tier + load in-tier hook basenames. Empty tier OR empty
+  # basename set → fallback merge-all (grace preserved per ADR-031); stderr
+  # signal for observability.
+  local adopter_tier tier_basenames tier_re
+  adopter_tier=$(_bhc_resolve_adopter_tier "$adopter_cwd" 2>/dev/null || true)
+  tier_basenames=""
+  tier_re=""
+  if [ -n "$adopter_tier" ]; then
+    tier_basenames=$(_bhc_load_tier_hook_basenames "$bassclef_root" "$adopter_tier" 2>/dev/null || true)
+    if [ -z "$tier_basenames" ]; then
+      echo "[bassclef-hook-connect] tier=$adopter_tier but manifest missing/empty — merging all wires" >&2
+    else
+      # Build regex alternation from basenames (strip .sh for pattern building).
+      tier_re=$(printf '%s\n' "$tier_basenames" | sed 's/\.sh$//' | paste -sd'|' -)
+    fi
+  else
+    echo "[bassclef-hook-connect] no tier declared in .bassclef-source.json — merging all wires (grace window). Set tier: lite to filter." >&2
+  fi
+
   # Merge every hook entry from every event type. Preserves operator-owned
   # entries. Adds bassclef entries under matching (event, matcher) pairs
   # without duplicating commands. Skips Lane 3 hooks at $CLAUDE_PROJECT_DIR
-  # per <consumer-repo>#1262.
+  # per <consumer-repo>#1262. Filters off-tier entries when tier_re non-empty
+  # per bassclef-upstream#1946.
   local merged
-  merged=$(jq --slurpfile bassclef "$bassclef_settings" --arg lane3re "$lane3_re" '
+  merged=$(jq --slurpfile bassclef "$bassclef_settings" --arg lane3re "$lane3_re" --arg tierre "$tier_re" '
     . as $adopter
     | ($bassclef[0].hooks // {}) as $bhooks
     | .hooks //= {}
@@ -142,6 +259,11 @@ bassclef_hook_connect_apply() {
           ($bentry.matcher // "") as $bmatcher |
           ($bentry.hooks // [] | map(select(
             (.command // "") | test("\\$CLAUDE_PROJECT_DIR/\\.claude/hooks/(" + $lane3re + ")\\.sh") | not
+          )) | map(select(
+            # Tier filter: keep only entries whose command basename is in the
+            # tier manifest set. Empty tier_re means no filter (fallback).
+            ($tierre == "") or
+            ((.command // "") | test("\\.claude/hooks/(" + $tierre + ")\\.sh"))
           ))) as $bhookslist |
           if ($bhookslist | length) == 0 then .
           elif any(.hooks[$event][]; (.matcher // "") == $bmatcher) then

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

@@ -1,7 +1,7 @@
 {
   "tier": "lite",
   "manifest_version": "1.11.1",
-  "generated_at": "2026-09-24T15:21:28Z",
+  "generated_at": "2026-09-25T15:57:21Z",
   "entries": [
     {
       "slug": "029-release-pipeline",
@@ -1303,7 +1303,7 @@
       "type": "presence-template",
       "path": "presence/install/bassclef-hook-connect.sh",
       "tier": "lite",
-      "content_hash": "sha256:7d029e13d72fa66157105b18684920d12e0b3c4f9d4866c0baa1c3b8227b745c",
+      "content_hash": "sha256:7ac3148028a5f2fd1ca35b84812c664d2ff10b475026f278c78c490f6b12fa21",
       "description": "description: Dynamic-derive hook connect — closes bassclef-upstream#625."
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thebassclef/lite",
-  "version": "1.9.1",
+  "version": "1.9.3",
   "description": "Bassclef CLI — install and upgrade bassclef in your project with two commands.",
   "keywords": [
     "bassclef",
@@ -8,7 +8,7 @@
     "cli",
     "scaffolding"
   ],
-  "homepage": "https://github.com/sunj-labs/bassclef-cli",
+  "homepage": "https://docs.bassclef.dev",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/sunj-labs/bassclef-cli.git"