@thebassclef/lite 1.0.2 → 1.0.4

package/dist/lite/.claude/hooks/session-reflection.d/tests/55-orientation-gate.test.sh

@@ -0,0 +1,595 @@
+#!/usr/bin/env bash
+# tier: standard
+# fixtures: post-rename-adopter bassclef-upstream-self fully-cured-adopter
+# Tests for .claude/hooks/session-reflection.d/55-orientation-gate.sh
+#
+# Per bassclef#1183 + bassclef#1266: mechanical enforcement that fires
+# BLOCKED at SessionStart when the agent is in bassclef repo and no
+# orientation marker exists for the current branch. /sprint + /longrun
+# prep procedures (WU-3/WU-4) then refuse to propose work until the
+# operator + agent have oriented at the arc level (active bet's
+# parent_drivers + open bassclef-evolution issues + open audit-drops).
+#
+# Tier 0 strict-TDD per bassclef#1037; test list block + 10 sufficiency
+# criteria per bassclef#1090 + bassclef#1098.
+#
+# Run: bash .claude/hooks/session-reflection.d/tests/55-orientation-gate.test.sh
+
+set -u
+
+# test-list:
+# [x] Branch: fires BLOCKED in consumer repo too (bassclef#1275 — drop bassclef-only guard)
+# [x] Branch: silent when in bassclef repo AND orientation marker exists for current branch
+# [x] Branch: fires BLOCKED when in bassclef repo AND no orientation marker for current branch
+# [x] Branch: fires BLOCKED on main when no main marker (cure 2 — 2026-06-30 audit)
+# [x] Branch: silent on main when state/markers/orientation-gate/main.marker exists
+# [x] Branch: silent on main when SKIP_ORIENTATION_GATE_ON_MAIN=1 (adopter compat per ADR-031)
+# [x] Exit: exit 0 on all paths (SessionStart hooks emit informational BLOCKED, not blocking exit)
+# [x] Exit: exit 0 when override SKIP_ORIENTATION_GATE=1 is set
+# [x] Exit: exit 0 on missing binaries (graceful)
+# [x] BLOCKED content: emits "🛑 BLOCKED: orientation-gate" header
+# [x] BLOCKED content: includes active iteration_bet from docs/whereami.md
+# [x] BLOCKED content: includes resolution path naming the marker file pattern
+# [x] BLOCKED content: includes override path (SKIP_ORIENTATION_GATE=1)
+# [x] BLOCKED content: cites bassclef#1183 + bassclef#1266
+# [x] Override: SKIP_ORIENTATION_GATE=1 silences output entirely
+# [x] Marker: marker at state/markers/orientation-gate/<branch-slug>.marker silences hook
+# [x] Marker: marker on a DIFFERENT branch does NOT silence (per-branch scope)
+# [x] Marker: handles branch slug with slash (feature/foo-bar → feature-foo-bar)
+# [x] State-file: handles missing docs/whereami.md gracefully (silent, no crash)
+# [x] State-file: handles whereami.md without iteration_bet field gracefully
+# [x] External-binary: silent when git binary missing (no crash)
+# [x] Config: substrate.config.md with bassclef_evolution_child_repos → BLOCKED scan includes each child repo
+# [x] Config: substrate.config.md absent → BLOCKED scan defaults to current repo only
+# [x] Config: bassclef_evolution_label override → BLOCKED scan uses configured label
+# [x] Recursive walk: hook walks parent_bet chain when bet files exist (bassclef#1347)
+# [x] Recursive walk: single bet (no parent_bet) does not crash
+# [x] Recursive walk: missing bet file degrades gracefully
+# [x] Recursive walk: cycle in chain (A→B→A) does not loop infinitely
+# [x] Recursive walk: BLOCKED message labels the ancestor chain explicitly
+# [x] Recursive walk: BLOCKED cites bassclef#1347
+# [~] Trap: no tmpfiles created in hook; no trap needed. Reason: hook is read-only on filesystem.
+
+REPO_ROOT="$(cd "$(dirname "$0")/../../../.." && pwd)"
+HOOK="${REPO_ROOT}/.claude/hooks/session-reflection.d/55-orientation-gate.sh"
+PASS=0
+FAIL=0
+FAILED_TESTS=()
+
+assert() {
+  local name="$1"
+  local result="$2"
+  if [ "$result" = "ok" ]; then
+    PASS=$((PASS + 1))
+    echo "  PASS  $name"
+  else
+    FAIL=$((FAIL + 1))
+    FAILED_TESTS+=("$name")
+    echo "  FAIL  $name — $result"
+  fi
+}
+
+setup_tmpdir() {
+  TMPDIR_TEST="$(mktemp -d)"
+  mkdir -p "$TMPDIR_TEST/.claude/hooks" "$TMPDIR_TEST/docs" "$TMPDIR_TEST/state/markers/orientation-gate"
+  # Set up a git repo so `git symbolic-ref --short HEAD` works
+  (cd "$TMPDIR_TEST" && git init -q && git config user.email t@t && git config user.name t \
+    && git checkout -q -b feature/test-branch 2>/dev/null \
+    && touch README.md && git add README.md && git commit -q -m init 2>/dev/null) || true
+}
+
+teardown_tmpdir() {
+  rm -rf "$TMPDIR_TEST"
+}
+
+# Inject a stub `gh` binary at the front of PATH that pretends we're in
+# the bassclef repo (or not, per arg). Real gh isn't called in tests.
+stub_gh_bassclef() {
+  cat > "$TMPDIR_TEST/gh" <<'EOF'
+#!/usr/bin/env bash
+# Test stub for gh CLI. Behavior controlled by GH_STUB_REPO_NAME env var.
+if [ "$1" = "repo" ] && [ "$2" = "view" ]; then
+  echo "${GH_STUB_REPO_NAME:-bassclef}"
+  exit 0
+fi
+if [ "$1" = "issue" ] && [ "$2" = "list" ]; then
+  # Return a fixed line so the hook can count
+  echo "1268    Adopter-input prompts need plain English"
+  echo "1266    Dependency-aware /longrun + /sprint"
+  echo "1265    Wiki-sync mechanism not inherited"
+  exit 0
+fi
+exit 0
+EOF
+  chmod +x "$TMPDIR_TEST/gh"
+}
+
+# Run hook with CWD=$TMPDIR_TEST + PATH including stub gh
+run_hook() {
+  HOOK_STDOUT=$(cd "$TMPDIR_TEST" \
+    && PATH="$TMPDIR_TEST:$PATH" \
+    && CLAUDE_PROJECT_DIR="$TMPDIR_TEST" \
+    bash "$HOOK" 2>&1)
+  HOOK_EXIT=$?
+}
+
+if [ ! -x "$HOOK" ]; then
+  chmod +x "$HOOK" 2>/dev/null || true
+fi
+
+echo "Testing $HOOK"
+echo "---"
+
+# =====================================================================
+# Branch coverage: adopter-too (bassclef#1275 — drop bassclef-only guard)
+# =====================================================================
+
+# Fires BLOCKED in consumer repo too — adopter inherits the discipline
+setup_tmpdir
+stub_gh_bassclef
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+GH_STUB_REPO_NAME=poa run_hook
+[ "$HOOK_EXIT" = "0" ] && echo "$HOOK_STDOUT" | grep -q "orientation-gate" && \
+  assert "fires BLOCKED in consumer repo too (bassclef#1275)" "ok" || \
+  assert "fires BLOCKED in consumer repo too (bassclef#1275)" "exit=$HOOK_EXIT output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# Fires BLOCKED when in bassclef repo + no marker
+setup_tmpdir
+stub_gh_bassclef
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+run_hook
+[ "$HOOK_EXIT" = "0" ] && echo "$HOOK_STDOUT" | grep -q "orientation-gate" && \
+  assert "fires BLOCKED in bassclef repo with no marker" "ok" || \
+  assert "fires BLOCKED in bassclef repo with no marker" "exit=$HOOK_EXIT output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# Fires BLOCKED on main when no main marker (cure 2 — 2026-06-30-session-orientation-blind-spot audit)
+setup_tmpdir
+stub_gh_bassclef
+(cd "$TMPDIR_TEST" && git checkout -q -b main 2>/dev/null || git checkout -q main 2>/dev/null)
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+run_hook
+[ "$HOOK_EXIT" = "0" ] && echo "$HOOK_STDOUT" | grep -q "orientation-gate" && \
+  assert "fires BLOCKED on main when no main marker (cure 2)" "ok" || \
+  assert "fires BLOCKED on main when no main marker (cure 2)" "exit=$HOOK_EXIT output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# Silent on main when main marker exists (sister of feature-branch-marker-silences)
+setup_tmpdir
+stub_gh_bassclef
+(cd "$TMPDIR_TEST" && git checkout -q -b main 2>/dev/null || git checkout -q main 2>/dev/null)
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+touch "$TMPDIR_TEST/state/markers/orientation-gate/main.marker"
+run_hook
+[ "$HOOK_EXIT" = "0" ] && [ -z "$HOOK_STDOUT" ] && \
+  assert "silent on main when main marker exists" "ok" || \
+  assert "silent on main when main marker exists" "exit=$HOOK_EXIT output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# Silent on main when SKIP_ORIENTATION_GATE_ON_MAIN=1 (adopter compat per ADR-031)
+setup_tmpdir
+stub_gh_bassclef
+(cd "$TMPDIR_TEST" && git checkout -q -b main 2>/dev/null || git checkout -q main 2>/dev/null)
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+HOOK_STDOUT=$(cd "$TMPDIR_TEST" \
+  && PATH="$TMPDIR_TEST:$PATH" \
+  && CLAUDE_PROJECT_DIR="$TMPDIR_TEST" \
+  && SKIP_ORIENTATION_GATE_ON_MAIN=1 \
+  bash "$HOOK" 2>&1)
+HOOK_EXIT=$?
+[ "$HOOK_EXIT" = "0" ] && [ -z "$HOOK_STDOUT" ] && \
+  assert "silent on main when SKIP_ORIENTATION_GATE_ON_MAIN=1 (adopter compat)" "ok" || \
+  assert "silent on main when SKIP_ORIENTATION_GATE_ON_MAIN=1 (adopter compat)" "exit=$HOOK_EXIT output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# =====================================================================
+# BLOCKED content
+# =====================================================================
+
+# Header
+setup_tmpdir
+stub_gh_bassclef
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+run_hook
+echo "$HOOK_STDOUT" | grep -q "🛑 BLOCKED: orientation-gate" && \
+  assert "BLOCKED header emitted" "ok" || \
+  assert "BLOCKED header emitted" "output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# Active bet surfaced
+setup_tmpdir
+stub_gh_bassclef
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+run_hook
+echo "$HOOK_STDOUT" | grep -q "2026-06-20a-longrun-sprint-orientation-cure" && \
+  assert "active iteration_bet name surfaced" "ok" || \
+  assert "active iteration_bet name surfaced" "output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# Resolution path with marker pattern
+setup_tmpdir
+stub_gh_bassclef
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+run_hook
+echo "$HOOK_STDOUT" | grep -qE "state/markers/orientation-gate" && \
+  assert "resolution path names marker file pattern" "ok" || \
+  assert "resolution path names marker file pattern" "output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# Override path in BLOCKED content
+setup_tmpdir
+stub_gh_bassclef
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+run_hook
+echo "$HOOK_STDOUT" | grep -q "SKIP_ORIENTATION_GATE=1" && \
+  assert "override path documented in BLOCKED" "ok" || \
+  assert "override path documented in BLOCKED" "output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# Cites tickets
+setup_tmpdir
+stub_gh_bassclef
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+run_hook
+echo "$HOOK_STDOUT" | grep -q "bassclef#1183" && echo "$HOOK_STDOUT" | grep -q "bassclef#1266" && \
+  assert "BLOCKED cites bassclef#1183 + bassclef#1266" "ok" || \
+  assert "BLOCKED cites bassclef#1183 + bassclef#1266" "output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# =====================================================================
+# Override
+# =====================================================================
+
+# SKIP_ORIENTATION_GATE=1 silences
+setup_tmpdir
+stub_gh_bassclef
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+HOOK_STDOUT=$(cd "$TMPDIR_TEST" && PATH="$TMPDIR_TEST:$PATH" CLAUDE_PROJECT_DIR="$TMPDIR_TEST" SKIP_ORIENTATION_GATE=1 bash "$HOOK" 2>&1)
+HOOK_EXIT=$?
+[ "$HOOK_EXIT" = "0" ] && [ -z "$HOOK_STDOUT" ] && \
+  assert "SKIP_ORIENTATION_GATE=1 silences hook" "ok" || \
+  assert "SKIP_ORIENTATION_GATE=1 silences hook" "exit=$HOOK_EXIT output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# =====================================================================
+# Marker
+# =====================================================================
+
+# Marker for current branch silences
+setup_tmpdir
+stub_gh_bassclef
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+touch "$TMPDIR_TEST/state/markers/orientation-gate/feature-test-branch.marker"
+run_hook
+[ "$HOOK_EXIT" = "0" ] && [ -z "$HOOK_STDOUT" ] && \
+  assert "marker for current branch silences hook" "ok" || \
+  assert "marker for current branch silences hook" "exit=$HOOK_EXIT output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# Marker on different branch does NOT silence
+setup_tmpdir
+stub_gh_bassclef
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+touch "$TMPDIR_TEST/state/markers/orientation-gate/feature-OTHER-branch.marker"
+run_hook
+[ "$HOOK_EXIT" = "0" ] && echo "$HOOK_STDOUT" | grep -q "orientation-gate" && \
+  assert "marker on other branch does NOT silence" "ok" || \
+  assert "marker on other branch does NOT silence" "exit=$HOOK_EXIT output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# Branch slug with slash translates to dash
+setup_tmpdir
+stub_gh_bassclef
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+# Current branch in setup_tmpdir is "feature/test-branch" → should map to "feature-test-branch.marker"
+touch "$TMPDIR_TEST/state/markers/orientation-gate/feature-test-branch.marker"
+run_hook
+[ "$HOOK_EXIT" = "0" ] && [ -z "$HOOK_STDOUT" ] && \
+  assert "slash-in-branch-name handled (feature/foo → feature-foo)" "ok" || \
+  assert "slash-in-branch-name handled (feature/foo → feature-foo)" "exit=$HOOK_EXIT output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# =====================================================================
+# State-file graceful handling
+# =====================================================================
+
+# Missing whereami.md → silent (can't determine bet, gracefully decline)
+setup_tmpdir
+stub_gh_bassclef
+# No whereami.md created
+run_hook
+[ "$HOOK_EXIT" = "0" ] && \
+  assert "missing whereami.md does not crash" "ok" || \
+  assert "missing whereami.md does not crash" "exit=$HOOK_EXIT output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# whereami.md without iteration_bet field → emits BLOCKED but with "—" or "none active" for bet
+setup_tmpdir
+stub_gh_bassclef
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+phase: Construction
+note: some note
+EOF
+run_hook
+[ "$HOOK_EXIT" = "0" ] && \
+  assert "whereami without iteration_bet field handled gracefully" "ok" || \
+  assert "whereami without iteration_bet field handled gracefully" "exit=$HOOK_EXIT output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# =====================================================================
+# External binary graceful handling
+# =====================================================================
+
+# Missing gh binary → silent (consumer-repo detection fails-soft)
+setup_tmpdir
+# No stub_gh_bassclef — PATH won't contain gh in tmpdir
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+HOOK_STDOUT=$(cd "$TMPDIR_TEST" && PATH="/usr/bin:/bin" CLAUDE_PROJECT_DIR="$TMPDIR_TEST" bash "$HOOK" 2>&1)
+HOOK_EXIT=$?
+[ "$HOOK_EXIT" = "0" ] && \
+  assert "missing gh binary does not crash" "ok" || \
+  assert "missing gh binary does not crash" "exit=$HOOK_EXIT output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# =====================================================================
+# Config — adopter-configurable scan (bassclef#1275)
+# =====================================================================
+
+# substrate.config.md with bassclef_evolution_child_repos → BLOCKED scan includes children
+setup_tmpdir
+stub_gh_bassclef
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+cat > "$TMPDIR_TEST/substrate.config.md" <<'EOF'
+bassclef_evolution_child_repos: sunj-labs/poa, sunj-labs/twodo
+EOF
+run_hook
+echo "$HOOK_STDOUT" | grep -q "sunj-labs/poa" && echo "$HOOK_STDOUT" | grep -q "sunj-labs/twodo" && \
+  assert "scan command includes child repos from substrate.config.md" "ok" || \
+  assert "scan command includes child repos from substrate.config.md" "output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# substrate.config.md absent → defaults to current repo only (no -R flag)
+setup_tmpdir
+stub_gh_bassclef
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+# No substrate.config.md
+run_hook
+# Default scan: gh issue list --label bassclef-evolution (no -R for current repo)
+echo "$HOOK_STDOUT" | grep -qE "gh issue list[^-]*--label .?bassclef-evolution" && \
+  assert "scan defaults to current repo + bassclef-evolution label when config absent" "ok" || \
+  assert "scan defaults to current repo + bassclef-evolution label when config absent" "output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# bassclef_evolution_label override → BLOCKED scan uses configured label
+setup_tmpdir
+stub_gh_bassclef
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a-longrun-sprint-orientation-cure
+EOF
+cat > "$TMPDIR_TEST/substrate.config.md" <<'EOF'
+bassclef_evolution_label: substrate-evolution
+EOF
+run_hook
+echo "$HOOK_STDOUT" | grep -q "substrate-evolution" && \
+  assert "scan command uses configured label override" "ok" || \
+  assert "scan command uses configured label override" "output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# =====================================================================
+# Recursive parent_bet walk (bassclef#1347)
+# =====================================================================
+
+# Hook walks parent_bet chain recursively and surfaces ancestor lineage
+setup_tmpdir
+stub_gh_bassclef
+mkdir -p "$TMPDIR_TEST/docs/iteration-bets"
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20h-marathon
+EOF
+cat > "$TMPDIR_TEST/docs/iteration-bets/2026-06-20h-marathon.md" <<'EOF'
+---
+slug: 2026-06-20h-marathon
+parent_bet: 2026-06-20g-validate
+---
+EOF
+cat > "$TMPDIR_TEST/docs/iteration-bets/2026-06-20g-validate.md" <<'EOF'
+---
+slug: 2026-06-20g-validate
+parent_bet: 2026-06-20f-rename
+---
+EOF
+cat > "$TMPDIR_TEST/docs/iteration-bets/2026-06-20f-rename.md" <<'EOF'
+---
+slug: 2026-06-20f-rename
+---
+EOF
+run_hook
+echo "$HOOK_STDOUT" | grep -q "2026-06-20g-validate" && \
+  echo "$HOOK_STDOUT" | grep -q "2026-06-20f-rename" && \
+  assert "recursive walk surfaces 3-deep ancestor chain" "ok" || \
+  assert "recursive walk surfaces 3-deep ancestor chain" "output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# Single bet (no parent_bet) — chain is just the active bet
+setup_tmpdir
+stub_gh_bassclef
+mkdir -p "$TMPDIR_TEST/docs/iteration-bets"
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20-alone
+EOF
+cat > "$TMPDIR_TEST/docs/iteration-bets/2026-06-20-alone.md" <<'EOF'
+---
+slug: 2026-06-20-alone
+---
+EOF
+run_hook
+[ "$HOOK_EXIT" = "0" ] && \
+  assert "single bet (no parent_bet) does not crash recursive walk" "ok" || \
+  assert "single bet (no parent_bet) does not crash recursive walk" "exit=$HOOK_EXIT output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# Missing bet file — recursive walk degrades gracefully
+setup_tmpdir
+stub_gh_bassclef
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20-missing
+EOF
+# Note: no bet file at docs/iteration-bets/2026-06-20-missing.md
+run_hook
+[ "$HOOK_EXIT" = "0" ] && \
+  assert "missing bet file does not crash recursive walk" "ok" || \
+  assert "missing bet file does not crash recursive walk" "exit=$HOOK_EXIT output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# Cycle protection — chain with bet A → B → A doesn't loop infinitely
+setup_tmpdir
+stub_gh_bassclef
+mkdir -p "$TMPDIR_TEST/docs/iteration-bets"
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: bet-A
+EOF
+cat > "$TMPDIR_TEST/docs/iteration-bets/bet-A.md" <<'EOF'
+---
+parent_bet: bet-B
+---
+EOF
+cat > "$TMPDIR_TEST/docs/iteration-bets/bet-B.md" <<'EOF'
+---
+parent_bet: bet-A
+---
+EOF
+# Cycle protection lives in the hook itself (max_depth bound); test runs normally.
+# If the hook is buggy and loops, the test hangs — that surfaces the bug.
+run_hook
+[ "$HOOK_EXIT" = "0" ] && \
+  assert "cycle in parent_bet chain does not infinite-loop" "ok" || \
+  assert "cycle in parent_bet chain does not infinite-loop" "exit=$HOOK_EXIT output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# BLOCKED message includes section labeling the ancestor chain
+setup_tmpdir
+stub_gh_bassclef
+mkdir -p "$TMPDIR_TEST/docs/iteration-bets"
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20h-marathon
+EOF
+cat > "$TMPDIR_TEST/docs/iteration-bets/2026-06-20h-marathon.md" <<'EOF'
+---
+slug: 2026-06-20h-marathon
+parent_bet: 2026-06-20g-validate
+---
+EOF
+cat > "$TMPDIR_TEST/docs/iteration-bets/2026-06-20g-validate.md" <<'EOF'
+---
+slug: 2026-06-20g-validate
+---
+EOF
+run_hook
+echo "$HOOK_STDOUT" | grep -qE "[Aa]ncestor|[Cc]hain|[Ll]ineage" && \
+  assert "BLOCKED message labels the chain explicitly" "ok" || \
+  assert "BLOCKED message labels the chain explicitly" "output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# BLOCKED cites bassclef#1347 (recursive walk source ticket)
+setup_tmpdir
+stub_gh_bassclef
+cat > "$TMPDIR_TEST/docs/whereami.md" <<'EOF'
+iteration_bet: 2026-06-20a
+EOF
+run_hook
+echo "$HOOK_STDOUT" | grep -q "bassclef#1347" && \
+  assert "BLOCKED cites bassclef#1347 (recursive walk)" "ok" || \
+  assert "BLOCKED cites bassclef#1347 (recursive walk)" "output=$HOOK_STDOUT"
+teardown_tmpdir
+
+# =====================================================================
+# Fixture-driven coverage (per #545 retroactive backfill)
+# =====================================================================
+# When FIXTURE_DIR is exported by run-with-fixtures.sh wrapper, the test
+# runs once per declared fixture against a real adopter-shaped repo.
+# Verifies the gate fires on main inside an adopter environment when no
+# main marker exists and whereami is present.
+
+if [ -n "${FIXTURE_DIR:-}" ]; then
+  fixture_name="${FIXTURE_DIR##*/}"
+  # Set up the fixture as a git repo on main + write a whereami file
+  (cd "$FIXTURE_DIR" && git init -q 2>/dev/null && git config user.email t@t && git config user.name t \
+    && git checkout -q -b main 2>/dev/null || git checkout -q main 2>/dev/null) || true
+  mkdir -p "$FIXTURE_DIR/docs" "$FIXTURE_DIR/.claude/hooks"
+  cat > "$FIXTURE_DIR/docs/whereami.md" <<'EOF'
+iteration_bet: fixture-driven-test-bet
+EOF
+  # Stub gh binary at fixture root so the hook doesn't crash on a real query
+  cat > "$FIXTURE_DIR/gh" <<'EOF'
+#!/usr/bin/env bash
+if [ "$1" = "repo" ] && [ "$2" = "view" ]; then echo "bassclef"; exit 0; fi
+if [ "$1" = "issue" ] && [ "$2" = "list" ]; then exit 0; fi
+exit 0
+EOF
+  chmod +x "$FIXTURE_DIR/gh"
+
+  FIXTURE_STDOUT=$(cd "$FIXTURE_DIR" \
+    && PATH="$FIXTURE_DIR:$PATH" \
+    && CLAUDE_PROJECT_DIR="$FIXTURE_DIR" \
+    bash "$HOOK" 2>&1)
+  FIXTURE_EXIT=$?
+
+  if [ "$FIXTURE_EXIT" = "0" ] && echo "$FIXTURE_STDOUT" | grep -q "orientation-gate"; then
+    assert "fixture-${fixture_name}-fires-on-main-with-no-marker" "ok"
+  else
+    assert "fixture-${fixture_name}-fires-on-main-with-no-marker" "exit=$FIXTURE_EXIT output=$FIXTURE_STDOUT"
+  fi
+fi
+
+# =====================================================================
+# Summary
+# =====================================================================
+
+echo "---"
+echo "Results: $PASS passed, $FAIL failed"
+
+if [ "$FAIL" -gt 0 ]; then
+  echo ""
+  echo "Failed tests:"
+  for t in "${FAILED_TESTS[@]}"; do
+    echo "  - $t"
+  done
+  exit 1
+fi
+
+exit 0