@thebassclef/lite 1.0.3 → 1.1.0

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

@@ -0,0 +1,178 @@
+#!/bin/bash
+# tier: lite
+# description: Dynamic-derive hook connect — closes bassclef-upstream#625.
+# Dynamic-derive hook connect — closes bassclef-upstream#625.
+# Retagged standard → lite per #1301 concentric rule (ADR-052 D1) —
+# sourced by tier:lite bassclef-sync.template.sh at L999-1002; without
+# ship at lite the merger never fires, adopter hooks stay unwired.
+# Closes #1301.
+#
+# Reads bassclef's own .claude/settings.json (the source of truth for which
+# hooks are wired to which events) and merges every entry into the adopter's
+# .claude/settings.json. Adopters stop hitting BLOCKED on every new hook add;
+# ADR-031 (we-don't-break-adopters) holds.
+#
+# The old §3c-hooks section in presence/install/bassclef-sync.template.sh
+# carried a hardcoded 5-hook list. Coverage was 10 % of the 49 hooks bassclef
+# actually wires. POA session 2026-07-02 merged 40 hook entries by hand.
+#
+# Anchor luminaries — @luminary michael-nygard (Steady State — the sync path
+# self-heals hook coverage on every session-start), @luminary linus-torvalds
+# (adopter contract — auto-migration is not optional), @luminary
+# john-ousterhout (deep module — read source-of-truth once; hide the merge
+# bookkeeping behind a single function).
+
+# LANE_3_HOOKS — single source of truth pairs with sync.template.sh L777.
+# These 3 hooks are installed at $HOME/.claude/hooks/ on adopters per Lane 3
+# (bassclef#1146). Bassclef itself wires them at $CLAUDE_PROJECT_DIR because
+# bassclef IS the source. Copying bassclef's project-scope entries verbatim
+# to adopters points at files that do not exist on adopter machines; the
+# result is 3 "file not found" errors per SessionStart. Closes <consumer-repo>#1262.
+# 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)
+
+# bassclef_hook_connect_apply <adopter_cwd> [<bassclef_root>]
+#
+# Reads $bassclef_root/.claude/settings.json (or $BASSCLEF_SOURCE_ROOT if
+# arg 2 omitted); merges every hook entry additively into
+# $adopter_cwd/.claude/settings.json.
+#
+# Returns 0 on success AND on every skip path. Callers must never break
+# on this function's exit code — bassclef-sync's other sections still
+# need to run.
+#
+# Environment:
+#   SKIP_BASSCLEF_HOOK_WIRE=1  bypass, logged to stderr
+#   BASSCLEF_SOURCE_ROOT       fallback for arg 2 (dispatcher exports this)
+bassclef_hook_connect_apply() {
+  local adopter_cwd="${1:-}"
+  local bassclef_root="${2:-${BASSCLEF_SOURCE_ROOT:-}}"
+
+  # Third fallback: derive from lib's own path when arg 2 and env both empty.
+  # Lib lives at presence/install/bassclef-hook-connect.sh; parent-of-parent
+  # is the bassclef repo root. Covers older vendored dispatchers that do not
+  # export BASSCLEF_SOURCE_ROOT (bassclef-upstream#1003 Layer 2 cure).
+  if [ -z "$bassclef_root" ] && [ -n "${BASH_SOURCE[0]:-}" ]; then
+    bassclef_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." 2>/dev/null && pwd)"
+  fi
+
+  # Argument sanity — adopter path must be given.
+  if [ -z "$adopter_cwd" ]; then
+    return 0
+  fi
+
+  # Operator override.
+  if [ "${SKIP_BASSCLEF_HOOK_WIRE:-0}" = "1" ]; then
+    echo "[bassclef-hook-connect] skip — SKIP_BASSCLEF_HOOK_WIRE=1" >&2
+    return 0
+  fi
+
+  # Bassclef itself does not need the merge — bassclef manages its own
+  # settings.json directly. Narrow match on repo name (not substring) so
+  # sibling repos like bassclef-web and bassclef-cli still get the merge.
+  # Pattern mirrors the SELF_MODE detection in Section 0a of
+  # presence/install/bassclef-sync.template.sh (#999 cure).
+  local remote_url
+  remote_url=$(git -C "$adopter_cwd" remote get-url origin 2>/dev/null || echo "")
+  if echo "$remote_url" | grep -qE 'sunj-labs/(bassclef|bassclef-upstream)(\.git)?/?$'; then
+    return 0
+  fi
+
+  # Adopter must have a .claude dir.
+  if [ ! -d "$adopter_cwd/.claude" ]; then
+    return 0
+  fi
+
+  # jq is required. Absent → skip cleanly.
+  if ! command -v jq >/dev/null 2>&1; then
+    echo "[bassclef-hook-connect] skip — jq not found on PATH" >&2
+    return 0
+  fi
+
+  # Bassclef source must resolve.
+  if [ -z "$bassclef_root" ]; then
+    return 0
+  fi
+  local bassclef_settings="$bassclef_root/.claude/settings.json"
+  if [ ! -f "$bassclef_settings" ]; then
+    return 0
+  fi
+
+  # Bassclef settings must parse. Malformed → skip; do not touch adopter file.
+  if ! jq -e . "$bassclef_settings" >/dev/null 2>&1; then
+    echo "[bassclef-hook-connect] skip — bassclef settings.json failed to parse" >&2
+    return 0
+  fi
+
+  local adopter_settings="$adopter_cwd/.claude/settings.json"
+
+  # Base structure — create if missing.
+  if [ ! -f "$adopter_settings" ]; then
+    echo '{"hooks":{}}' > "$adopter_settings"
+  fi
+
+  # Adopter settings must also parse. If it does not, leave it alone — an
+  # operator-authored file with a syntax error is not our repair target.
+  if ! jq -e . "$adopter_settings" >/dev/null 2>&1; then
+    echo "[bassclef-hook-connect] skip — adopter settings.json failed to parse" >&2
+    return 0
+  fi
+
+  # Build Lane 3 exclusion regex from LANE_3_HOOKS array. Matches only the
+  # $CLAUDE_PROJECT_DIR/.claude/hooks/<basename> form — leaves $HOME-scope
+  # entries alone (adopters that customize their own user-scope wiring keep
+  # working). Closes <consumer-repo>#1262.
+  local lane3_re
+  lane3_re=$(printf '%s\n' "${LANE_3_HOOKS[@]}" | sed 's/\.sh$//' | paste -sd'|' -)
+
+  # 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.
+  local merged
+  merged=$(jq --slurpfile bassclef "$bassclef_settings" --arg lane3re "$lane3_re" '
+    . as $adopter
+    | ($bassclef[0].hooks // {}) as $bhooks
+    | .hooks //= {}
+    | reduce ($bhooks | keys[]) as $event (
+        .;
+        .hooks[$event] //= [] |
+        reduce ($bhooks[$event] // [])[] as $bentry (
+          .;
+          ($bentry.matcher // "") as $bmatcher |
+          ($bentry.hooks // [] | map(select(
+            (.command // "") | test("\\$CLAUDE_PROJECT_DIR/\\.claude/hooks/(" + $lane3re + ")\\.sh") | not
+          ))) as $bhookslist |
+          if ($bhookslist | length) == 0 then .
+          elif any(.hooks[$event][]; (.matcher // "") == $bmatcher) then
+            .hooks[$event] |= map(
+              if (.matcher // "") == $bmatcher then
+                .hooks //= [] |
+                reduce $bhookslist[] as $bhook (
+                  .;
+                  if any(.hooks[]; .command == $bhook.command) then .
+                  else .hooks += [$bhook] end
+                )
+              else . end
+            )
+          else
+            .hooks[$event] += [{
+              "matcher": $bmatcher,
+              "hooks":   $bhookslist
+            } | if .matcher == "" then del(.matcher) else . end]
+          end
+        )
+      )
+  ' "$adopter_settings" 2>/dev/null)
+
+  if [ -z "$merged" ]; then
+    echo "[bassclef-hook-connect] skip — merge produced empty output" >&2
+    return 0
+  fi
+
+  # Atomic replace via tmp file.
+  echo "$merged" > "$adopter_settings.tmp" && \
+    mv "$adopter_settings.tmp" "$adopter_settings"
+
+  return 0
+}