@thebassclef/lite 0.1.2 → 1.0.0

package/substrate/presence/install/bassclef-hook-connect.sh

@@ -1,178 +0,0 @@
-#!/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
-}