specweave 1.0.30 → 1.0.32

package/plugins/specweave/hooks/pre-task-completion.sh

@@ -1,269 +0,0 @@
-#!/bin/bash
-
-# SpecWeave Pre-Task-Completion Hook
-# CRITICAL QUALITY GATE: Validates AC tests before allowing task completion
-#
-# Runs automatically BEFORE any task is marked complete via TodoWrite
-#
-# WORKFLOW:
-# =========
-# 1. TodoWrite called with status="completed"
-# 2. This hook fires (pre-completion validation)
-# 3. Extract task ID from TodoWrite input
-# 4. Find task in tasks.md
-# 5. Run AC test validator
-# 6. If tests PASS → Allow completion (continue: true)
-# 7. If tests FAIL → Block completion (continue: false, show error)
-#
-# ENFORCEMENT:
-# ============
-# This is the ONLY way to mark tasks complete in SpecWeave.
-# Manual edits to tasks.md are detected and flagged by pre-commit hooks.
-
-set +e  # EMERGENCY FIX: Prevents Claude Code crashes
-
-# ============================================================================
-# RECURSION PREVENTION (CRITICAL - v0.25.1)
-# ============================================================================
-# Skip if we're already inside a hook to prevent infinite recursion
-if [[ "${SPECWEAVE_IN_HOOK:-0}" == "1" ]]; then
-  exit 0
-fi
-
-# Mark that we're now inside a hook
-export SPECWEAVE_IN_HOOK=1
-
-# EMERGENCY KILL SWITCH
-if [[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]]; then
-  exit 0
-fi
-
-# Capture stdin FIRST to extract cwd from Claude's JSON input
-_EARLY_STDIN=$(mktemp)
-cat > "$_EARLY_STDIN"
-
-# Extract cwd from JSON (Claude always provides this)
-if command -v jq >/dev/null 2>&1; then
-  PROJECT_ROOT=$(jq -r '.cwd // empty' "$_EARLY_STDIN" 2>/dev/null)
-fi
-
-# Fallback: find project root by walking up from script location
-if [ -z "$PROJECT_ROOT" ] || [ ! -d "$PROJECT_ROOT/.specweave" ]; then
-  find_project_root() {
-    local dir="$1"
-    while [ "$dir" != "/" ]; do
-      if [ -d "$dir/.specweave" ]; then
-        echo "$dir"
-        return 0
-      fi
-      dir="$(dirname "$dir")"
-    done
-    pwd
-  }
-  PROJECT_ROOT="$(find_project_root "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")"
-fi
-
-cd "$PROJECT_ROOT" 2>/dev/null || true
-
-# ============================================================================
-# EMERGENCY SAFETY CHECKS (v0.24.4 - Performance Fix)
-# ============================================================================
-
-LOGS_DIR=".specweave/logs"
-DEBUG_LOG="$LOGS_DIR/hooks-debug.log"
-mkdir -p "$LOGS_DIR" 2>/dev/null || true
-
-# CIRCUIT BREAKER: Auto-disable after consecutive failures
-CIRCUIT_BREAKER_FILE=".specweave/state/.hook-circuit-breaker-pre"
-CIRCUIT_BREAKER_THRESHOLD=3
-
-mkdir -p ".specweave/state" 2>/dev/null || true
-
-if [[ -f "$CIRCUIT_BREAKER_FILE" ]]; then
-  FAILURE_COUNT=$(cat "$CIRCUIT_BREAKER_FILE" 2>/dev/null || echo 0)
-  if (( FAILURE_COUNT >= CIRCUIT_BREAKER_THRESHOLD )); then
-    # Circuit breaker is OPEN - hooks are disabled
-    exit 0
-  fi
-fi
-
-# FILE LOCK: Only allow 1 pre-task-completion hook at a time
-LOCK_FILE=".specweave/state/.hook-pre-task.lock"
-LOCK_TIMEOUT=5  # seconds (shorter than PostToolUse)
-
-LOCK_ACQUIRED=false
-for i in {1..5}; do
-  if mkdir "$LOCK_FILE" 2>/dev/null; then
-    LOCK_ACQUIRED=true
-    trap 'rmdir "$LOCK_FILE" 2>/dev/null || true' EXIT
-    break
-  fi
-
-  # Check for stale lock
-  if [[ -d "$LOCK_FILE" ]]; then
-    LOCK_AGE=$(($(date +%s) - $(stat -f "%m" "$LOCK_FILE" 2>/dev/null || echo 0)))
-    if (( LOCK_AGE > LOCK_TIMEOUT )); then
-      rmdir "$LOCK_FILE" 2>/dev/null || true
-      continue
-    fi
-  fi
-
-  sleep 0.1
-done
-
-if [[ "$LOCK_ACQUIRED" == "false" ]]; then
-  # Another instance is running, skip
-  exit 0
-fi
-
-# DEBOUNCING: Prevent duplicate hook fires
-LAST_FIRE_FILE="$LOGS_DIR/last-pre-hook-fire"
-DEBOUNCE_SECONDS=5  # Same as PostToolUse
-
-CURRENT_TIME=$(date +%s)
-
-if [ -f "$LAST_FIRE_FILE" ]; then
-  LAST_FIRE=$(cat "$LAST_FIRE_FILE" 2>/dev/null || echo "0")
-  TIME_DIFF=$((CURRENT_TIME - LAST_FIRE))
-
-  if [ "$TIME_DIFF" -lt "$DEBOUNCE_SECONDS" ]; then
-    # Debounced - skip this execution
-    exit 0
-  fi
-fi
-
-echo "$CURRENT_TIME" > "$LAST_FIRE_FILE"
-
-echo "[$(date)] 🔒 Pre-task-completion hook fired" >> "$DEBUG_LOG" 2>/dev/null || true
-
-# ============================================================================
-# CAPTURE INPUT
-# ============================================================================
-
-# Reuse the early stdin capture
-STDIN_DATA="$_EARLY_STDIN"
-
-echo "[$(date)] Input JSON:" >> "$DEBUG_LOG" 2>/dev/null || true
-cat "$STDIN_DATA" >> "$DEBUG_LOG" 2>/dev/null || true
-
-# ============================================================================
-# CHECK FOR TASK COMPLETION
-# ============================================================================
-
-# Only validate if a task is being marked complete
-COMPLETING_TASK=false
-
-if command -v jq >/dev/null 2>&1; then
-  # Check if any task is transitioning to "completed" status
-  COMPLETED_COUNT=$(jq -r '.tool_input.todos // [] | map(select(.status == "completed")) | length' "$STDIN_DATA" 2>/dev/null || echo "0")
-
-  if [ "$COMPLETED_COUNT" != "0" ]; then
-    COMPLETING_TASK=true
-    echo "[$(date)] ✓ Detected task completion (${COMPLETED_COUNT} tasks)" >> "$DEBUG_LOG" 2>/dev/null || true
-  fi
-fi
-
-# If no tasks being completed, allow without validation
-if [ "$COMPLETING_TASK" = "false" ]; then
-  echo "[$(date)] ⏭️  No tasks being completed, skipping validation" >> "$DEBUG_LOG" 2>/dev/null || true
-  rm -f "$STDIN_DATA"
-  echo '{"continue":true}'
-  exit 0
-fi
-
-# ============================================================================
-# DETECT CURRENT INCREMENT
-# ============================================================================
-
-CURRENT_INCREMENT=$(ls -td .specweave/increments/*/ 2>/dev/null | xargs -n1 basename | grep -v "_backlog" | grep -v "_archive" | grep -v "_working" | head -1)
-
-if [ -z "$CURRENT_INCREMENT" ]; then
-  echo "[$(date)] ℹ️  No active increment found, skipping validation" >> "$DEBUG_LOG" 2>/dev/null || true
-  rm -f "$STDIN_DATA"
-  echo '{"continue":true}'
-  exit 0
-fi
-
-TASKS_MD=".specweave/increments/$CURRENT_INCREMENT/tasks.md"
-
-if [ ! -f "$TASKS_MD" ]; then
-  echo "[$(date)] ℹ️  tasks.md not found for $CURRENT_INCREMENT (increment may be in planning stage)" >> "$DEBUG_LOG" 2>/dev/null || true
-  rm -f "$STDIN_DATA"
-  echo '{"continue":true}'
-  exit 0
-fi
-
-# ============================================================================
-# RUN AC TEST VALIDATION
-# ============================================================================
-
-echo "[$(date)] 🧪 Running AC test validation for $CURRENT_INCREMENT" >> "$DEBUG_LOG" 2>/dev/null || true
-
-# Determine which validation script to use
-# Priority order:
-# 1. SpecWeave development (dist/src/core/) - for contributors
-# 2. npm package installation (node_modules/specweave/dist/)
-# 3. Marketplace plugin (lib/vendor/core/) - for end users
-VALIDATOR_SCRIPT=""
-if [ -f "$PROJECT_ROOT/dist/src/core/ac-test-validator-cli.js" ]; then
-  # SpecWeave development repo
-  VALIDATOR_SCRIPT="$PROJECT_ROOT/dist/src/core/ac-test-validator-cli.js"
-elif [ -f "$PROJECT_ROOT/node_modules/specweave/dist/src/core/ac-test-validator-cli.js" ]; then
-  # npm package installation
-  VALIDATOR_SCRIPT="$PROJECT_ROOT/node_modules/specweave/dist/src/core/ac-test-validator-cli.js"
-elif [ -n "${CLAUDE_PLUGIN_ROOT}" ] && [ -f "${CLAUDE_PLUGIN_ROOT}/lib/vendor/core/ac-test-validator-cli.js" ]; then
-  # Marketplace plugin (bundled in lib/vendor/)
-  VALIDATOR_SCRIPT="${CLAUDE_PLUGIN_ROOT}/lib/vendor/core/ac-test-validator-cli.js"
-fi
-
-if [ -z "$VALIDATOR_SCRIPT" ] || ! command -v node &> /dev/null; then
-  echo "[$(date)] ⚠️  AC test validator not found or Node.js missing" >> "$DEBUG_LOG" 2>/dev/null || true
-  rm -f "$STDIN_DATA"
-  echo '{"continue":true,"systemMessage":"⚠️  Warning: AC test validator not available. Task completion validation skipped. Install Node.js and rebuild SpecWeave to enable validation."}'
-  exit 0
-fi
-
-# Run validator (captures exit code)
-VALIDATION_OUTPUT=$(mktemp)
-VALIDATION_EXIT_CODE=0
-
-(cd "$PROJECT_ROOT" && node "$VALIDATOR_SCRIPT" "$CURRENT_INCREMENT") > "$VALIDATION_OUTPUT" 2>&1 || VALIDATION_EXIT_CODE=$?
-
-echo "[$(date)] Validator exit code: $VALIDATION_EXIT_CODE" >> "$DEBUG_LOG" 2>/dev/null || true
-cat "$VALIDATION_OUTPUT" >> "$DEBUG_LOG" 2>/dev/null || true
-
-rm -f "$STDIN_DATA"
-
-# ============================================================================
-# DECISION LOGIC
-# ============================================================================
-
-if [ "$VALIDATION_EXIT_CODE" = "0" ]; then
-  # Validation passed - allow completion
-  echo "[$(date)] ✅ AC test validation passed" >> "$DEBUG_LOG" 2>/dev/null || true
-
-  # Reset circuit breaker on success
-  echo "0" > "$CIRCUIT_BREAKER_FILE" 2>/dev/null || true
-
-  VALIDATION_SUMMARY=$(cat "$VALIDATION_OUTPUT" | tail -5 | tr '\n' ' ' | sed 's/"/\\"/g')
-
-  rm -f "$VALIDATION_OUTPUT"
-
-  printf '{"continue":true,"systemMessage":"✅ AC Test Validation Passed: All acceptance criteria have passing tests. Task completion allowed. %s"}\n' "$VALIDATION_SUMMARY"
-else
-  # Validation failed - block completion
-  echo "[$(date)] ❌ AC test validation failed" >> "$DEBUG_LOG" 2>/dev/null || true
-
-  # Increment circuit breaker on failure
-  CURRENT_FAILURES=$(cat "$CIRCUIT_BREAKER_FILE" 2>/dev/null || echo 0)
-  echo "$((CURRENT_FAILURES + 1))" > "$CIRCUIT_BREAKER_FILE" 2>/dev/null || true
-
-  VALIDATION_ERROR=$(cat "$VALIDATION_OUTPUT" | grep -A 10 "VALIDATION FAILED" | tr '\n' ' ' | cut -c 1-300 | sed 's/"/\\"/g')
-
-  rm -f "$VALIDATION_OUTPUT"
-
-  printf '{"continue":false,"systemMessage":"❌ AC TEST VALIDATION FAILED: Cannot mark task as complete until all acceptance criteria have passing tests. %s\\n\\nFix the failing tests and try again. Run tests manually: npm test"}\n' "$VALIDATION_ERROR"
-fi
-
-# ALWAYS exit 0 - NEVER let hook errors crash Claude Code
-exit 0

package/plugins/specweave/hooks/pre-tool-use.sh

@@ -1,137 +0,0 @@
-#!/bin/bash
-
-# SpecWeave Pre-Tool-Use Hook
-# Runs BEFORE Claude calls any tool (PreToolUse event)
-#
-# PURPOSE: Detect when Claude asks questions via AskUserQuestion
-# - Plays sound IMMEDIATELY when question is about to be asked
-# - Complements post-task-completion hook (which only fires after TodoWrite)
-# - Ensures user is always notified when Claude needs input
-#
-# SCOPE:
-# - This hook fires for ALL tool calls (Read, Edit, Write, AskUserQuestion, etc.)
-# - We filter for AskUserQuestion specifically to play sound
-# - Non-blocking and fast (<10ms overhead)
-
-set +e  # EMERGENCY FIX: Prevents Claude Code crashes
-
-# EMERGENCY KILL SWITCH
-if [[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]]; then
-  exit 0
-fi
-
-# ============================================================================
-# CONFIGURATION
-# ============================================================================
-
-# Find project root
-find_project_root() {
-  local dir="$1"
-  while [ "$dir" != "/" ]; do
-    if [ -d "$dir/.specweave" ]; then
-      echo "$dir"
-      return 0
-    fi
-    dir="$(dirname "$dir")"
-  done
-  # Fallback
-  if [ -d "$(pwd)/.specweave" ]; then
-    pwd
-  else
-    echo "$(pwd)"
-  fi
-}
-
-PROJECT_ROOT="$(find_project_root "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")"
-cd "$PROJECT_ROOT" 2>/dev/null || true
-
-# ULTRA-FAST EARLY EXIT FOR NON-SPECWEAVE PROJECTS (T-006 - v0.26.15)
-if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
-  exit 0
-fi
-
-LOGS_DIR=".specweave/logs"
-DEBUG_LOG="$LOGS_DIR/hooks-debug.log"
-
-mkdir -p "$LOGS_DIR" 2>/dev/null || true
-
-# ============================================================================
-# CAPTURE INPUT (Tool Call Details)
-# ============================================================================
-
-STDIN_DATA=$(mktemp)
-cat > "$STDIN_DATA"
-
-# Log the tool call for debugging
-echo "[$(date)] 🔧 PreToolUse hook fired" >> "$DEBUG_LOG" 2>/dev/null || true
-echo "[$(date)] Tool call JSON:" >> "$DEBUG_LOG" 2>/dev/null || true
-cat "$STDIN_DATA" >> "$DEBUG_LOG" 2>/dev/null || true
-echo "" >> "$DEBUG_LOG" 2>/dev/null || true
-
-# ============================================================================
-# DETECT AskUserQuestion TOOL
-# ============================================================================
-
-TOOL_NAME=""
-
-if command -v jq >/dev/null 2>&1; then
-  # Use jq if available (most reliable)
-  TOOL_NAME=$(jq -r '.tool_name // empty' "$STDIN_DATA" 2>/dev/null)
-else
-  # Fallback: grep-based detection
-  if grep -q '"tool_name"' "$STDIN_DATA" 2>/dev/null; then
-    TOOL_NAME=$(grep -o '"tool_name":"[^"]*"' "$STDIN_DATA" | cut -d'"' -f4)
-  fi
-fi
-
-echo "[$(date)] Tool name: $TOOL_NAME" >> "$DEBUG_LOG" 2>/dev/null || true
-
-# ============================================================================
-# PLAY SOUND IF AskUserQuestion
-# ============================================================================
-
-play_sound() {
-  case "$(uname -s)" in
-    Darwin)
-      # macOS: Use afplay with a distinctive sound for questions
-      afplay /System/Library/Sounds/Tink.aiff 2>/dev/null || true
-      ;;
-    Linux)
-      # Linux: Use paplay or aplay
-      paplay /usr/share/sounds/freedesktop/stereo/dialog-question.oga 2>/dev/null || \
-      paplay /usr/share/sounds/freedesktop/stereo/message-new-instant.oga 2>/dev/null || \
-      aplay /usr/share/sounds/alsa/Front_Center.wav 2>/dev/null || true
-      ;;
-    MINGW*|MSYS*|CYGWIN*)
-      # Windows: Use PowerShell
-      powershell -c "(New-Object Media.SoundPlayer 'C:\Windows\Media\Windows Notify.wav').PlaySync();" 2>/dev/null || true
-      ;;
-  esac
-}
-
-if [ "$TOOL_NAME" = "AskUserQuestion" ]; then
-  echo "[$(date)] 🔔 QUESTION DETECTED! Playing notification sound" >> "$DEBUG_LOG" 2>/dev/null || true
-  play_sound
-
-  # Log this event
-  echo "[$(date)] Claude is asking for user input via AskUserQuestion" >> "$DEBUG_LOG" 2>/dev/null || true
-fi
-
-# ============================================================================
-# CLEANUP
-# ============================================================================
-
-rm -f "$STDIN_DATA"
-
-# ============================================================================
-# OUTPUT TO CLAUDE (Always continue)
-# ============================================================================
-
-if [ "$TOOL_NAME" = "AskUserQuestion" ]; then
-  echo '{"continue":true,"systemMessage":"🔔 Sound played - user notified of question request"}'
-else
-  echo '{"continue":true}'
-fi
-
-# ALWAYS exit 0 - NEVER let hook errors crash Claude Code
-exit 0

package/plugins/specweave/hooks/session-start-reconcile.sh

@@ -1,139 +0,0 @@
-#!/bin/bash
-
-# SpecWeave Session Start Reconcile Hook (NEW in v0.28.33)
-#
-# Runs on Claude Code session start to detect and fix GitHub status drift.
-# This is a lightweight hook that runs in background to not block startup.
-#
-# Features:
-# - Debounced: Only runs if >1 hour since last reconcile
-# - Non-blocking: Runs in background, errors logged but don't crash
-# - Optional: Controlled by config.sync.github.autoReconcileOnSessionStart
-#
-# Trigger: SessionStart hook event
-
-set +e  # Prevent crashes
-
-# EMERGENCY KILL SWITCH
-if [[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]]; then
-  exit 0
-fi
-
-# Find project root
-find_project_root() {
-  local dir="$PWD"
-  while [[ "$dir" != "/" ]]; do
-    if [[ -d "$dir/.specweave" ]]; then
-      echo "$dir"
-      return 0
-    fi
-    dir=$(dirname "$dir")
-  done
-  echo "$PWD"
-}
-
-PROJECT_ROOT=$(find_project_root)
-CONFIG_FILE="$PROJECT_ROOT/.specweave/config.json"
-STATE_DIR="$PROJECT_ROOT/.specweave/state"
-LAST_RECONCILE_FILE="$STATE_DIR/.last-reconcile-timestamp"
-DEBUG_LOG="$PROJECT_ROOT/.specweave/logs/hooks-debug.log"
-
-mkdir -p "$STATE_DIR" 2>/dev/null || true
-mkdir -p "$(dirname "$DEBUG_LOG")" 2>/dev/null || true
-
-# Consume stdin (required for hooks)
-cat > /dev/null
-
-echo "[$(date)] session-start-reconcile: Hook fired" >> "$DEBUG_LOG" 2>/dev/null || true
-
-# ============================================================================
-# CHECK IF AUTO-RECONCILE IS ENABLED
-# ============================================================================
-
-if [[ ! -f "$CONFIG_FILE" ]]; then
-  echo "[$(date)] session-start-reconcile: No config.json - skipping" >> "$DEBUG_LOG" 2>/dev/null || true
-  exit 0
-fi
-
-# Check config (requires jq)
-if ! command -v jq &> /dev/null; then
-  echo "[$(date)] session-start-reconcile: jq not found - skipping" >> "$DEBUG_LOG" 2>/dev/null || true
-  exit 0
-fi
-
-# Check if auto-reconcile is enabled
-AUTO_RECONCILE=$(jq -r '.sync.github.autoReconcileOnSessionStart // false' "$CONFIG_FILE" 2>/dev/null)
-
-if [[ "$AUTO_RECONCILE" != "true" ]]; then
-  echo "[$(date)] session-start-reconcile: Disabled in config - skipping" >> "$DEBUG_LOG" 2>/dev/null || true
-  exit 0
-fi
-
-echo "[$(date)] session-start-reconcile: Auto-reconcile enabled" >> "$DEBUG_LOG" 2>/dev/null || true
-
-# ============================================================================
-# DEBOUNCE: Only run if >1 hour since last reconcile
-# ============================================================================
-
-DEBOUNCE_SECONDS=3600  # 1 hour
-
-if [[ -f "$LAST_RECONCILE_FILE" ]]; then
-  LAST_TIMESTAMP=$(cat "$LAST_RECONCILE_FILE" 2>/dev/null || echo "0")
-  CURRENT_TIMESTAMP=$(date +%s)
-  ELAPSED=$((CURRENT_TIMESTAMP - LAST_TIMESTAMP))
-
-  if [[ $ELAPSED -lt $DEBOUNCE_SECONDS ]]; then
-    REMAINING=$((DEBOUNCE_SECONDS - ELAPSED))
-    echo "[$(date)] session-start-reconcile: Debounced - last run ${ELAPSED}s ago (wait ${REMAINING}s)" >> "$DEBUG_LOG" 2>/dev/null || true
-    exit 0
-  fi
-fi
-
-echo "[$(date)] session-start-reconcile: Debounce passed - running reconcile" >> "$DEBUG_LOG" 2>/dev/null || true
-
-# Update timestamp BEFORE running (prevents concurrent runs)
-date +%s > "$LAST_RECONCILE_FILE"
-
-# ============================================================================
-# RUN RECONCILE IN BACKGROUND (non-blocking)
-# ============================================================================
-
-if ! command -v node &> /dev/null; then
-  echo "[$(date)] session-start-reconcile: Node.js not found - skipping" >> "$DEBUG_LOG" 2>/dev/null || true
-  exit 0
-fi
-
-# Find reconcile script
-RECONCILE_SCRIPT=""
-if [[ -f "$PROJECT_ROOT/plugins/specweave/lib/hooks/session-start-reconcile-worker.js" ]]; then
-  RECONCILE_SCRIPT="$PROJECT_ROOT/plugins/specweave/lib/hooks/session-start-reconcile-worker.js"
-elif [[ -f "$PROJECT_ROOT/dist/plugins/specweave/lib/hooks/session-start-reconcile-worker.js" ]]; then
-  RECONCILE_SCRIPT="$PROJECT_ROOT/dist/plugins/specweave/lib/hooks/session-start-reconcile-worker.js"
-elif [[ -f "$PROJECT_ROOT/node_modules/specweave/dist/plugins/specweave/lib/hooks/session-start-reconcile-worker.js" ]]; then
-  RECONCILE_SCRIPT="$PROJECT_ROOT/node_modules/specweave/dist/plugins/specweave/lib/hooks/session-start-reconcile-worker.js"
-fi
-
-if [[ -z "$RECONCILE_SCRIPT" ]]; then
-  echo "[$(date)] session-start-reconcile: Worker script not found - skipping" >> "$DEBUG_LOG" 2>/dev/null || true
-  exit 0
-fi
-
-# Load GITHUB_TOKEN from .env
-if [[ -f "$PROJECT_ROOT/.env" ]]; then
-  GITHUB_TOKEN_FROM_ENV=$(grep -E '^GITHUB_TOKEN=' "$PROJECT_ROOT/.env" 2>/dev/null | head -1 | cut -d'=' -f2- | sed 's/^["'\'']//' | sed 's/["'\'']$//')
-  if [[ -n "$GITHUB_TOKEN_FROM_ENV" ]]; then
-    export GITHUB_TOKEN="$GITHUB_TOKEN_FROM_ENV"
-  fi
-fi
-
-# Run in background with nohup (fully detached)
-# Output goes to debug log, doesn't block session start
-echo "[$(date)] session-start-reconcile: Starting background reconcile" >> "$DEBUG_LOG" 2>/dev/null || true
-
-(
-  cd "$PROJECT_ROOT" && \
-  node "$RECONCILE_SCRIPT" >> "$DEBUG_LOG" 2>&1
-) &
-
-# Immediately exit (don't wait for background job)
-exit 0