@thebassclef/lite 1.9.2 → 1.9.3

package/README.md

@@ -63,7 +63,7 @@ your browser.
 
 ## Current release
 
-<!-- version-start -->1.9.2<!-- version-end -->
+<!-- version-start -->1.9.3<!-- 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.2";
+const version = "1.9.3";
 exports.version = version;

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,4 +1,4 @@
-const version = "1.9.2";
+const version = "1.9.3";
 export {
   version
 };

package/dist/lite/bassclef-version.json

@@ -1,7 +1,7 @@
 {
   "version": "v1.5.2",
-  "marker_tag": "release-2026-09-24-4dc71e87",
-  "release_date": "2026-09-24T21:29:57Z",
-  "release_sha": "4dc71e87",
-  "release_tag": "release-2026-09-24-4dc71e87"
+  "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-24T21:01:31Z",
+  "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.2",
+  "version": "1.9.3",
   "description": "Bassclef CLI — install and upgrade bassclef in your project with two commands.",
   "keywords": [
     "bassclef",