@thebassclef/lite 1.0.2 → 1.0.3

package/dist/lite/.claude/hooks/session-reflection.d/tests/00-bassclef-hook-connect.test.sh

@@ -0,0 +1,492 @@
+#!/usr/bin/env bash
+# tier: standard
+# fixtures: post-rename-adopter bassclef-upstream-self fully-cured-adopter
+# Tier 0 test for .claude/hooks/session-reflection.d/00-bassclef-hook-connect.sh
+#
+# Closes sunj-labs/bassclef-upstream#644 — sync-cure peer path fix.
+#
+# The fragment sources presence/install/bassclef-hook-connect.sh and calls
+# bassclef_hook_connect_apply at every session-start. Runs regardless of
+# sync path (peer, clone, npm, curl). Renames sister fragment
+# 00-settings-drift.sh -> 08-settings-drift.sh so this fragment runs first.
+#
+# Per #644 acceptance + four-lens pre-mortem:
+# - Fixture parent path OUTSIDE ~/src/sunj-labs/ (Feathers characterization)
+# - Merge populates 4 missing POA-shape drift entries
+# - Merge is idempotent (Nygard steady state)
+# - Fragment emits stderr log line on every merge (Ousterhout signal visibility)
+# - Fragment path mirrors L682 clone-path call precisely (Cockburn walking skeleton)
+#
+# Run: bash .claude/hooks/session-reflection.d/tests/00-bassclef-hook-connect.test.sh
+
+set -u
+
+# test-list:
+# [ ] Fragment file exists at expected path (RED baseline; goes GREEN after WU-2)
+# [ ] Fragment sources bassclef-hook-connect.sh when BASSCLEF_DIR is set
+# [ ] Fragment silently skips when BASSCLEF_DIR is unset
+# [ ] Fragment skips when adopter has no .claude/ dir
+# [ ] Fragment skips when bassclef settings.json is missing
+# [ ] Merge populates 4 missing POA-shape drift entries
+# [ ] Merge is idempotent — running twice does not duplicate entries
+# [ ] Fragment emits stderr log line on every merge run (Ousterhout signal-visibility)
+# [ ] SKIP_BASSCLEF_HOOK_WIRE=1 bypasses cleanly
+# [ ] Fixture parent path lives OUTSIDE ~/src/sunj-labs/ (Feathers characterization; operator ask)
+# [ ] jq missing — fragment skips cleanly
+# [ ] Bassclef self (remote URL contains sunj-labs/bassclef) — merge skips
+# [ ] Adopter settings.json missing — created with hooks {} then merged
+# [ ] Adopter settings.json malformed — skip without touching
+# [ ] Exit 0 on all paths (session-reflection.d fragments are informational)
+# [ ] Install-class project (CLAUDE_PROJECT_DIR set) resolves BASSCLEF_DIR
+# [ ] Install-class operator (HOME_OVERRIDE set) resolves BASSCLEF_DIR
+# [~] Trap: fragment writes to adopter settings.json via atomic tmp file; deep module handles the trap. Reason: covered upstream.
+
+REPO_ROOT="$(cd "$(dirname "$0")/../../../.." && pwd)"
+HOOK="${REPO_ROOT}/.claude/hooks/session-reflection.d/00-bassclef-hook-connect.sh"
+DEEP_MODULE="${REPO_ROOT}/presence/install/bassclef-hook-connect.sh"
+PASS=0
+FAIL=0
+FAILED_TESTS=()
+
+assert() {
+  local name="$1"
+  local result="$2"
+  if [ "$result" = "ok" ]; then
+    PASS=$((PASS + 1))
+  else
+    FAIL=$((FAIL + 1))
+    FAILED_TESTS+=("$name: $result")
+  fi
+}
+
+# Build a fixture with parent path OUTSIDE ~/src/sunj-labs/.
+# Returns the adopter dir path; caller must clean up parent.
+build_poa_shape_fixture() {
+  local parent="$1"
+  local bassclef="$parent/bassclef"
+  local adopter="$parent/adopter"
+
+  mkdir -p "$bassclef/.claude"
+  mkdir -p "$bassclef/presence/install"
+  mkdir -p "$adopter/.claude"
+
+  # Copy the real shared function into the fake bassclef — mirrors real layout.
+  if [ -f "$DEEP_MODULE" ]; then
+    cp "$DEEP_MODULE" "$bassclef/presence/install/bassclef-hook-connect.sh"
+  fi
+
+  # Bassclef settings.json — mirrors POA-drift shape from #644.
+  # Contains 4 entries POA's settings.json is missing.
+  cat > "$bassclef/.claude/settings.json" <<'BASSCLEF_SETTINGS'
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Read|Grep|Bash",
+        "hooks": [
+          {"type": "command", "command": "bash .claude/hooks/base-pair-reprime.sh"}
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {"type": "command", "command": "bash .claude/hooks/longrun-prep-compounding-sequence-check.sh"},
+          {"type": "command", "command": "bash .claude/hooks/stop-assertion-shape-scan.sh"}
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {"type": "command", "command": "bash .claude/hooks/pre-gh-git-claim-shape-scrub.sh"}
+        ]
+      }
+    ]
+  }
+}
+BASSCLEF_SETTINGS
+
+  # Adopter starts EMPTY (POA-shape drift — missing all 4 entries).
+  cat > "$adopter/.claude/settings.json" <<'ADOPTER_SETTINGS'
+{
+  "hooks": {}
+}
+ADOPTER_SETTINGS
+
+  echo "$adopter"
+}
+
+# --- Test 1 — RED baseline: fragment file must exist (goes GREEN when WU-2 ships)
+if [ -f "$HOOK" ]; then
+  assert "01-fragment-file-exists" "ok"
+else
+  assert "01-fragment-file-exists" "fragment missing at $HOOK (expected RED baseline)"
+fi
+
+# --- Test 2 — Fragment sources deep module when BASSCLEF_DIR is set
+if [ -f "$HOOK" ]; then
+  TMP=$(mktemp -d)
+  ADOPTER=$(build_poa_shape_fixture "$TMP")
+  out=$(cd "$ADOPTER" && CWD="$ADOPTER" BASSCLEF_DIR="$TMP/bassclef" bash "$HOOK" 2>&1)
+  ec=$?
+  rm -rf "$TMP"
+  if [ "$ec" = "0" ]; then
+    assert "02-fragment-runs-with-bassclef-dir" "ok"
+  else
+    assert "02-fragment-runs-with-bassclef-dir" "expected exit 0; got $ec ($out)"
+  fi
+else
+  assert "02-fragment-runs-with-bassclef-dir" "fragment missing at $HOOK"
+fi
+
+# --- Test 3 — Fragment silently skips when BASSCLEF_DIR is unset
+if [ -f "$HOOK" ]; then
+  TMP=$(mktemp -d)
+  ADOPTER=$(build_poa_shape_fixture "$TMP")
+  out=$(cd "$ADOPTER" && CWD="$ADOPTER" bash "$HOOK" 2>&1)
+  ec=$?
+  rm -rf "$TMP"
+  if [ "$ec" = "0" ]; then
+    assert "03-skip-when-no-bassclef-dir" "ok"
+  else
+    assert "03-skip-when-no-bassclef-dir" "expected exit 0; got $ec ($out)"
+  fi
+else
+  assert "03-skip-when-no-bassclef-dir" "fragment missing at $HOOK"
+fi
+
+# --- Test 4 — Fragment skips when adopter has no .claude dir
+if [ -f "$HOOK" ]; then
+  TMP=$(mktemp -d)
+  mkdir -p "$TMP/bassclef/.claude"
+  echo '{"hooks":{}}' > "$TMP/bassclef/.claude/settings.json"
+  mkdir -p "$TMP/adopter"  # NO .claude subdir
+  out=$(cd "$TMP/adopter" && CWD="$TMP/adopter" BASSCLEF_DIR="$TMP/bassclef" bash "$HOOK" 2>&1)
+  ec=$?
+  if [ "$ec" = "0" ] && [ ! -d "$TMP/adopter/.claude" ]; then
+    assert "04-skip-when-no-adopter-claude-dir" "ok"
+  else
+    assert "04-skip-when-no-adopter-claude-dir" "expected exit 0 + no .claude created; got ec=$ec"
+  fi
+  rm -rf "$TMP"
+else
+  assert "04-skip-when-no-adopter-claude-dir" "fragment missing at $HOOK"
+fi
+
+# --- Test 5 — Fragment skips when bassclef settings.json missing
+if [ -f "$HOOK" ]; then
+  TMP=$(mktemp -d)
+  mkdir -p "$TMP/bassclef/.claude"
+  mkdir -p "$TMP/adopter/.claude"
+  echo '{"hooks":{}}' > "$TMP/adopter/.claude/settings.json"
+  out=$(cd "$TMP/adopter" && CWD="$TMP/adopter" BASSCLEF_DIR="$TMP/bassclef" bash "$HOOK" 2>&1)
+  ec=$?
+  content=$(cat "$TMP/adopter/.claude/settings.json")
+  if [ "$ec" = "0" ] && [ "$content" = '{"hooks":{}}' ]; then
+    assert "05-skip-when-bassclef-settings-missing" "ok"
+  else
+    assert "05-skip-when-bassclef-settings-missing" "expected exit 0 + unchanged; got ec=$ec"
+  fi
+  rm -rf "$TMP"
+else
+  assert "05-skip-when-bassclef-settings-missing" "fragment missing at $HOOK"
+fi
+
+# --- Test 6 — Merge populates 4 missing POA-shape drift entries
+if [ -f "$HOOK" ] && [ -f "$DEEP_MODULE" ] && command -v jq >/dev/null 2>&1; then
+  TMP=$(mktemp -d)
+  ADOPTER=$(build_poa_shape_fixture "$TMP")
+  out=$(cd "$ADOPTER" && CWD="$ADOPTER" BASSCLEF_DIR="$TMP/bassclef" bash "$HOOK" 2>&1)
+  ec=$?
+  merged_content=$(cat "$ADOPTER/.claude/settings.json")
+  count=0
+  echo "$merged_content" | grep -q "base-pair-reprime.sh" && count=$((count + 1))
+  echo "$merged_content" | grep -q "longrun-prep-compounding-sequence-check.sh" && count=$((count + 1))
+  echo "$merged_content" | grep -q "stop-assertion-shape-scan.sh" && count=$((count + 1))
+  echo "$merged_content" | grep -q "pre-gh-git-claim-shape-scrub.sh" && count=$((count + 1))
+  rm -rf "$TMP"
+  if [ "$ec" = "0" ] && [ "$count" = "4" ]; then
+    assert "06-merge-populates-4-poa-shape-entries" "ok"
+  else
+    assert "06-merge-populates-4-poa-shape-entries" "expected 4 entries; got $count (ec=$ec)"
+  fi
+else
+  assert "06-merge-populates-4-poa-shape-entries" "prereq missing: HOOK / DEEP_MODULE / jq"
+fi
+
+# --- Test 7 — Merge is idempotent — running twice does not duplicate entries
+if [ -f "$HOOK" ] && [ -f "$DEEP_MODULE" ] && command -v jq >/dev/null 2>&1; then
+  TMP=$(mktemp -d)
+  ADOPTER=$(build_poa_shape_fixture "$TMP")
+  (cd "$ADOPTER" && CWD="$ADOPTER" BASSCLEF_DIR="$TMP/bassclef" bash "$HOOK" >/dev/null 2>&1)
+  (cd "$ADOPTER" && CWD="$ADOPTER" BASSCLEF_DIR="$TMP/bassclef" bash "$HOOK" >/dev/null 2>&1)
+  merged_content=$(cat "$ADOPTER/.claude/settings.json")
+  base_pair_count=$(echo "$merged_content" | grep -c "base-pair-reprime.sh")
+  compounding_count=$(echo "$merged_content" | grep -c "longrun-prep-compounding-sequence-check.sh")
+  rm -rf "$TMP"
+  if [ "$base_pair_count" = "1" ] && [ "$compounding_count" = "1" ]; then
+    assert "07-merge-idempotent" "ok"
+  else
+    assert "07-merge-idempotent" "expected 1 of each; got base_pair=$base_pair_count compounding=$compounding_count"
+  fi
+else
+  assert "07-merge-idempotent" "prereq missing: HOOK / DEEP_MODULE / jq"
+fi
+
+# --- Test 8 — Fragment emits stderr log line on every merge run (Ousterhout)
+if [ -f "$HOOK" ]; then
+  TMP=$(mktemp -d)
+  ADOPTER=$(build_poa_shape_fixture "$TMP")
+  stderr_out=$(cd "$ADOPTER" && CWD="$ADOPTER" BASSCLEF_DIR="$TMP/bassclef" bash "$HOOK" 2>&1 >/dev/null)
+  rm -rf "$TMP"
+  if echo "$stderr_out" | grep -q "bassclef-hook-connect"; then
+    assert "08-stderr-log-emitted" "ok"
+  else
+    assert "08-stderr-log-emitted" "no [bassclef-hook-connect] log on stderr; got: $stderr_out"
+  fi
+else
+  assert "08-stderr-log-emitted" "fragment missing at $HOOK"
+fi
+
+# --- Test 9 — SKIP_BASSCLEF_HOOK_WIRE=1 bypasses cleanly
+if [ -f "$HOOK" ]; then
+  TMP=$(mktemp -d)
+  ADOPTER=$(build_poa_shape_fixture "$TMP")
+  out=$(cd "$ADOPTER" && CWD="$ADOPTER" BASSCLEF_DIR="$TMP/bassclef" SKIP_BASSCLEF_HOOK_WIRE=1 bash "$HOOK" 2>&1)
+  ec=$?
+  content=$(cat "$ADOPTER/.claude/settings.json")
+  rm -rf "$TMP"
+  if [ "$ec" = "0" ] && [ "$content" = '{
+  "hooks": {}
+}' ]; then
+    assert "09-skip-flag-bypasses" "ok"
+  else
+    assert "09-skip-flag-bypasses" "expected exit 0 + unchanged content; got ec=$ec"
+  fi
+else
+  assert "09-skip-flag-bypasses" "fragment missing at $HOOK"
+fi
+
+# --- Test 10 — Fixture parent path lives OUTSIDE ~/src/sunj-labs/ (Feathers ask)
+if [ -f "$HOOK" ] && [ -f "$DEEP_MODULE" ] && command -v jq >/dev/null 2>&1; then
+  TMP=$(mktemp -d)
+  case "$TMP" in
+    "$HOME/src/sunj-labs"*)
+      assert "10-fixture-parent-outside-sunj-labs" "TMPDIR $TMP is inside ~/src/sunj-labs/; test setup broken"
+      rm -rf "$TMP"
+      ;;
+    *)
+      ADOPTER=$(build_poa_shape_fixture "$TMP")
+      out=$(cd "$ADOPTER" && CWD="$ADOPTER" BASSCLEF_DIR="$TMP/bassclef" bash "$HOOK" 2>&1)
+      ec=$?
+      merged=$(cat "$ADOPTER/.claude/settings.json")
+      rm -rf "$TMP"
+      if [ "$ec" = "0" ] && echo "$merged" | grep -q "base-pair-reprime.sh"; then
+        assert "10-fixture-parent-outside-sunj-labs" "ok"
+      else
+        assert "10-fixture-parent-outside-sunj-labs" "merge failed with outside-tree fixture; ec=$ec"
+      fi
+      ;;
+  esac
+else
+  assert "10-fixture-parent-outside-sunj-labs" "prereq missing: HOOK / DEEP_MODULE / jq"
+fi
+
+# --- Test 11 — jq missing — fragment skips cleanly
+# Simulate jq missing by prepending a PATH dir with a "jq" stub that returns 127.
+# This keeps bash + git available while making jq lookup fail (portable across macOS + Linux).
+if [ -f "$HOOK" ]; then
+  TMP=$(mktemp -d)
+  ADOPTER=$(build_poa_shape_fixture "$TMP")
+  FAKE_BIN="$TMP/fake-bin"
+  mkdir -p "$FAKE_BIN"
+  # Empty file named jq that is NOT executable — command -v finds it but exec fails.
+  # Actually simpler: put a script that exits 127 immediately.
+  cat > "$FAKE_BIN/jq" <<'EOF'
+#!/bin/sh
+exit 127
+EOF
+  chmod -x "$FAKE_BIN/jq"  # not executable — command -v returns non-zero
+  out=$(cd "$ADOPTER" && CWD="$ADOPTER" BASSCLEF_DIR="$TMP/bassclef" PATH="$FAKE_BIN:$PATH:__no_jq__" bash "$HOOK" 2>&1)
+  ec=$?
+  # Deep module uses `command -v jq` which checks executability — non-executable file returns non-zero.
+  rm -rf "$TMP"
+  if [ "$ec" = "0" ]; then
+    assert "11-jq-missing-graceful" "ok"
+  else
+    assert "11-jq-missing-graceful" "expected exit 0 when jq absent; got $ec"
+  fi
+else
+  assert "11-jq-missing-graceful" "fragment missing at $HOOK"
+fi
+
+# --- Test 12 — Bassclef self (git remote URL contains sunj-labs/bassclef) — skip merge
+if [ -f "$HOOK" ] && [ -f "$DEEP_MODULE" ] && command -v jq >/dev/null 2>&1 && command -v git >/dev/null 2>&1; then
+  TMP=$(mktemp -d)
+  ADOPTER=$(build_poa_shape_fixture "$TMP")
+  (cd "$ADOPTER" && git init -q 2>/dev/null && git remote add origin https://github.com/sunj-labs/bassclef 2>/dev/null)
+  original=$(cat "$ADOPTER/.claude/settings.json")
+  out=$(cd "$ADOPTER" && CWD="$ADOPTER" BASSCLEF_DIR="$TMP/bassclef" bash "$HOOK" 2>&1)
+  ec=$?
+  after=$(cat "$ADOPTER/.claude/settings.json")
+  rm -rf "$TMP"
+  if [ "$ec" = "0" ] && [ "$original" = "$after" ]; then
+    assert "12-bassclef-self-skip" "ok"
+  else
+    assert "12-bassclef-self-skip" "expected unchanged for bassclef self; ec=$ec"
+  fi
+else
+  assert "12-bassclef-self-skip" "prereq missing: HOOK / DEEP_MODULE / jq / git"
+fi
+
+# --- Test 13 — Adopter settings.json missing — created with hooks{} then merged
+if [ -f "$HOOK" ] && [ -f "$DEEP_MODULE" ] && command -v jq >/dev/null 2>&1; then
+  TMP=$(mktemp -d)
+  mkdir -p "$TMP/bassclef/.claude"
+  mkdir -p "$TMP/bassclef/presence/install"
+  cp "$DEEP_MODULE" "$TMP/bassclef/presence/install/bassclef-hook-connect.sh"
+  cat > "$TMP/bassclef/.claude/settings.json" <<'EOF'
+{
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {"type": "command", "command": "bash .claude/hooks/base-pair-reprime.sh"}
+        ]
+      }
+    ]
+  }
+}
+EOF
+  mkdir -p "$TMP/adopter/.claude"
+  out=$(cd "$TMP/adopter" && CWD="$TMP/adopter" BASSCLEF_DIR="$TMP/bassclef" bash "$HOOK" 2>&1)
+  ec=$?
+  if [ "$ec" = "0" ] && [ -f "$TMP/adopter/.claude/settings.json" ] && grep -q "base-pair-reprime.sh" "$TMP/adopter/.claude/settings.json"; then
+    assert "13-adopter-settings-missing-created" "ok"
+  else
+    assert "13-adopter-settings-missing-created" "expected settings.json created + merged; ec=$ec"
+  fi
+  rm -rf "$TMP"
+else
+  assert "13-adopter-settings-missing-created" "prereq missing: HOOK / DEEP_MODULE / jq"
+fi
+
+# --- Test 14 — Adopter settings.json malformed — skip without touching
+if [ -f "$HOOK" ] && [ -f "$DEEP_MODULE" ] && command -v jq >/dev/null 2>&1; then
+  TMP=$(mktemp -d)
+  ADOPTER=$(build_poa_shape_fixture "$TMP")
+  echo '{ "hooks": broken' > "$ADOPTER/.claude/settings.json"
+  original=$(cat "$ADOPTER/.claude/settings.json")
+  out=$(cd "$ADOPTER" && CWD="$ADOPTER" BASSCLEF_DIR="$TMP/bassclef" bash "$HOOK" 2>&1)
+  ec=$?
+  after=$(cat "$ADOPTER/.claude/settings.json")
+  rm -rf "$TMP"
+  if [ "$ec" = "0" ] && [ "$original" = "$after" ]; then
+    assert "14-adopter-malformed-untouched" "ok"
+  else
+    assert "14-adopter-malformed-untouched" "expected unchanged malformed file; ec=$ec"
+  fi
+else
+  assert "14-adopter-malformed-untouched" "prereq missing: HOOK / DEEP_MODULE / jq"
+fi
+
+# --- Test 15 — Exit 0 on all paths
+if [ -f "$HOOK" ]; then
+  TMP=$(mktemp -d)
+  ADOPTER=$(build_poa_shape_fixture "$TMP")
+  (cd "$ADOPTER" && CWD="$ADOPTER" BASSCLEF_DIR="$TMP/bassclef" bash "$HOOK" >/dev/null 2>&1)
+  ec1=$?
+  (cd "$ADOPTER" && bash "$HOOK" >/dev/null 2>&1)
+  ec2=$?
+  (cd "$ADOPTER" && CWD="$ADOPTER" bash "$HOOK" >/dev/null 2>&1)
+  ec3=$?
+  rm -rf "$TMP"
+  if [ "$ec1" = "0" ] && [ "$ec2" = "0" ] && [ "$ec3" = "0" ]; then
+    assert "15-always-exit-0" "ok"
+  else
+    assert "15-always-exit-0" "expected all exit 0; got $ec1 / $ec2 / $ec3"
+  fi
+else
+  assert "15-always-exit-0" "fragment missing at $HOOK"
+fi
+
+# --- Test 16 — Install-class project (CLAUDE_PROJECT_DIR set) resolves BASSCLEF_DIR
+if [ -f "$HOOK" ] && [ -f "$DEEP_MODULE" ] && command -v jq >/dev/null 2>&1; then
+  TMP=$(mktemp -d)
+  ADOPTER=$(build_poa_shape_fixture "$TMP")
+  out=$(cd "$ADOPTER" && CLAUDE_PROJECT_DIR="$ADOPTER" CWD="$ADOPTER" BASSCLEF_DIR="$TMP/bassclef" bash "$HOOK" 2>&1)
+  ec=$?
+  merged=$(cat "$ADOPTER/.claude/settings.json")
+  rm -rf "$TMP"
+  if [ "$ec" = "0" ] && echo "$merged" | grep -q "base-pair-reprime.sh"; then
+    assert "16-install-class-project" "ok"
+  else
+    assert "16-install-class-project" "expected exit 0 + merge under CLAUDE_PROJECT_DIR; ec=$ec"
+  fi
+else
+  assert "16-install-class-project" "prereq missing: HOOK / DEEP_MODULE / jq"
+fi
+
+# --- Test 17 — Install-class operator (HOME_OVERRIDE fixture) resolves BASSCLEF_DIR
+if [ -f "$HOOK" ] && [ -f "$DEEP_MODULE" ] && command -v jq >/dev/null 2>&1; then
+  TMP=$(mktemp -d)
+  HOME_FAKE=$(mktemp -d)
+  ADOPTER=$(build_poa_shape_fixture "$TMP")
+  out=$(cd "$ADOPTER" && HOME="$HOME_FAKE" CWD="$ADOPTER" BASSCLEF_DIR="$TMP/bassclef" bash "$HOOK" 2>&1)
+  ec=$?
+  merged=$(cat "$ADOPTER/.claude/settings.json")
+  rm -rf "$TMP" "$HOME_FAKE"
+  if [ "$ec" = "0" ] && echo "$merged" | grep -q "base-pair-reprime.sh"; then
+    assert "17-install-class-operator" "ok"
+  else
+    assert "17-install-class-operator" "expected exit 0 + merge under HOME override; ec=$ec"
+  fi
+else
+  assert "17-install-class-operator" "prereq missing: HOOK / DEEP_MODULE / jq"
+fi
+
+# --- Test 18 — fixture-driven coverage (rides under run-with-fixtures.sh wrapper)
+if [ -n "${FIXTURE_DIR:-}" ] && [ -f "$HOOK" ] && [ -f "$DEEP_MODULE" ] && command -v jq >/dev/null 2>&1; then
+  FIXTURE_TMP=$(mktemp -d)
+  mkdir -p "$FIXTURE_TMP/bassclef/.claude"
+  mkdir -p "$FIXTURE_TMP/bassclef/presence/install"
+  # Copy the shared function so the fragment can source it.
+  cp "$DEEP_MODULE" "$FIXTURE_TMP/bassclef/presence/install/bassclef-hook-connect.sh"
+  cat > "$FIXTURE_TMP/bassclef/.claude/settings.json" <<'EOF'
+{
+  "hooks": {
+    "Stop": [
+      {"hooks": [{"type": "command", "command": "bash .claude/hooks/base-pair-reprime.sh"}]}
+    ]
+  }
+}
+EOF
+  mkdir -p "$FIXTURE_DIR/.claude" 2>/dev/null
+  [ -f "$FIXTURE_DIR/.claude/settings.json" ] || echo '{"hooks":{}}' > "$FIXTURE_DIR/.claude/settings.json"
+  fixture_out=$(cd "$FIXTURE_DIR" && CWD="$FIXTURE_DIR" BASSCLEF_DIR="$FIXTURE_TMP/bassclef" bash "$HOOK" 2>&1)
+  ec=$?
+  fixture_name="${FIXTURE_DIR##*/}"
+  merged=$(cat "$FIXTURE_DIR/.claude/settings.json" 2>/dev/null || echo "")
+  rm -rf "$FIXTURE_TMP"
+  if [ "$ec" = "0" ] && echo "$merged" | grep -q "base-pair-reprime.sh"; then
+    assert "18-fixture-coverage-${fixture_name}" "ok"
+  else
+    assert "18-fixture-coverage-${fixture_name}" "fixture merge failed; ec=$ec"
+  fi
+fi
+
+# --- Summary
+TOTAL=$((PASS + FAIL))
+echo ""
+echo "=== 00-bassclef-hook-connect.sh tests ==="
+echo "Passed: $PASS / $TOTAL"
+if [ "$FAIL" -gt 0 ]; then
+  echo "Failed:"
+  for t in "${FAILED_TESTS[@]}"; do
+    echo "  - $t"
+  done
+  exit 1
+fi
+exit 0