specweave 0.30.19 → 0.32.2

package/plugins/specweave-release/hooks/post-task-completion.sh.backup

@@ -0,0 +1,110 @@
+#!/bin/bash
+# Post-Increment-Completion Hook - DORA Metrics Tracking
+#
+# Fires after: /specweave:done completes
+# Purpose: Automatically track DORA metrics and update living docs dashboard
+#
+# Integration: plugins/specweave-release/hooks/hooks.json
+
+set -euo pipefail
+
+# Constants
+SPECWEAVE_ROOT="${SPECWEAVE_ROOT:-$(pwd)}"
+METRICS_DIR="${SPECWEAVE_ROOT}/.specweave/metrics"
+HISTORY_FILE="${METRICS_DIR}/dora-history.jsonl"
+DASHBOARD_FILE="${SPECWEAVE_ROOT}/.specweave/docs/internal/delivery/dora-dashboard.md"
+DORA_CALCULATOR="${SPECWEAVE_ROOT}/dist/src/metrics/dora-calculator.js"
+LATEST_FILE="${METRICS_DIR}/dora-latest.json"
+
+# Logging
+LOG_FILE="${SPECWEAVE_ROOT}/.specweave/logs/dora-tracking.log"
+mkdir -p "$(dirname "$LOG_FILE")"
+
+log() {
+  echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" | tee -a "$LOG_FILE"
+}
+
+log "🎯 Post-Increment-Completion Hook Triggered"
+
+# Check if DORA calculator exists
+if [[ ! -f "$DORA_CALCULATOR" ]]; then
+  log "⚠️  DORA calculator not found at $DORA_CALCULATOR"
+  log "   Run: npm run build"
+  exit 0  # Non-blocking
+fi
+
+# Check if GitHub token is available
+if [[ -z "${GITHUB_TOKEN:-}" ]]; then
+  log "⚠️  GITHUB_TOKEN not set. DORA metrics require GitHub API access."
+  log "   Set GITHUB_TOKEN in environment or .env file"
+  exit 0  # Non-blocking
+fi
+
+# Step 1: Calculate DORA metrics
+log "📊 Calculating DORA metrics..."
+if ! node "$DORA_CALCULATOR"; then
+  log "❌ Failed to calculate DORA metrics"
+  exit 0  # Non-blocking
+fi
+
+# Step 2: Append to history (JSONL format)
+log "💾 Appending metrics to history..."
+mkdir -p "$METRICS_DIR"
+
+if [[ -f "$LATEST_FILE" ]]; then
+  cat "$LATEST_FILE" >> "$HISTORY_FILE"
+  log "   ✓ Appended to $HISTORY_FILE"
+else
+  log "⚠️  Latest metrics file not found: $LATEST_FILE"
+fi
+
+# Step 3: Update living docs dashboard
+log "📝 Updating DORA dashboard..."
+DASHBOARD_GENERATOR="${SPECWEAVE_ROOT}/dist/plugins/specweave-release/lib/dashboard-generator.js"
+
+if [[ -f "$DASHBOARD_GENERATOR" ]]; then
+  if node "$DASHBOARD_GENERATOR"; then
+    log "   ✓ Dashboard updated: $DASHBOARD_FILE"
+  else
+    log "⚠️  Failed to update dashboard"
+  fi
+else
+  log "⚠️  Dashboard generator not found: $DASHBOARD_GENERATOR"
+  log "   Manual dashboard update required"
+fi
+
+# Step 4: Check for degradation (optional)
+log "🔍 Checking for metric degradation..."
+
+# Calculate 30-day average and compare with current
+# (This would be implemented in a TypeScript utility)
+# For now, we'll just log a reminder
+log "   ℹ️  Degradation detection: Manual review recommended"
+log "   See: $DASHBOARD_FILE for trends"
+
+# Step 5: Update main DORA metrics doc
+DORA_METRICS_DOC="${SPECWEAVE_ROOT}/.specweave/docs/internal/delivery/dora-metrics.md"
+if [[ -f "$DORA_METRICS_DOC" && -f "$LATEST_FILE" ]]; then
+  log "📄 Updating dora-metrics.md with latest values..."
+
+  # Extract current values from latest metrics
+  # (This is a simplified version - production would use jq for proper parsing)
+  TIMESTAMP=$(date '+%Y-%m-%d %H:%M UTC')
+
+  # Update "Last Calculated" timestamp
+  if command -v sed &> /dev/null; then
+    sed -i.bak "s/Last Calculated: .*/Last Calculated: $TIMESTAMP/" "$DORA_METRICS_DOC" 2>/dev/null || true
+    rm -f "${DORA_METRICS_DOC}.bak" 2>/dev/null || true
+    log "   ✓ Updated timestamp in dora-metrics.md"
+  fi
+fi
+
+log "✅ DORA metrics tracking complete!"
+log ""
+log "📊 Next steps:"
+log "   1. Review dashboard: $DASHBOARD_FILE"
+log "   2. Check trends: Are metrics improving?"
+log "   3. Take action: Address any degradation"
+log ""
+
+exit 0

package/plugins/specweave/hooks/post-edit-spec.sh

@@ -1,265 +0,0 @@
-#!/bin/bash
-#
-# Post-Edit Hook: Update Status Line After spec.md or tasks.md Edits
-#
-# Triggers: After Edit tool modifies spec.md (AC updates) or tasks.md (task completion)
-# Action: Updates status line cache to reflect latest AC/task progress
-#
-# This ensures status line stays in sync when ACs are marked complete via Edit tool
-# (not just TodoWrite, which only tracks internal todo lists)
-#
-# EMERGENCY FIXES (v0.24.3):
-# - Kill switch: Set SPECWEAVE_DISABLE_HOOKS=1 to disable ALL hooks
-# - Circuit breaker: Auto-disable after 3 consecutive failures
-# - File locking: Prevent concurrent executions (max 1 at a time)
-# - Aggressive debouncing: Increased from 1s to 5s
-# - Complete error isolation: Never let errors reach Claude Code
-#
-# TIER 1 IMPROVEMENTS (v0.24.2):
-# - Debouncing: Skip if updated less than 1 second ago (90% overhead reduction)
-# - File mtime detection: Check recently modified spec.md/tasks.md as fallback
-# - Non-blocking: Run update-status-line.sh in background
-# - Smart detection: Only update if spec/tasks files actually changed
-#
-# Previous fix (v0.24.1): Enhanced file detection for increment completion
-# - Detects edits via TOOL_USE_CONTENT, TOOL_RESULT, and argument parsing
-# - Always updates status line for ANY spec.md/tasks.md edit in increments folder
-
-# CRITICAL: Remove set -e to prevent hook errors from crashing Claude Code
-set +e
-
-# EMERGENCY KILL SWITCH: Disable all hooks if env variable set
-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)
-LOGS_DIR="$PROJECT_ROOT/.specweave/logs"
-DEBUG_LOG="$LOGS_DIR/hooks-debug.log"
-
-# Ensure state and logs directories exist
-mkdir -p "$PROJECT_ROOT/.specweave/state" "$LOGS_DIR" 2>/dev/null || true
-
-# EMERGENCY CIRCUIT BREAKER: Track consecutive failures
-CIRCUIT_BREAKER_FILE="$PROJECT_ROOT/.specweave/state/.hook-circuit-breaker"
-CIRCUIT_BREAKER_THRESHOLD=3
-
-if [[ -f "$CIRCUIT_BREAKER_FILE" ]]; then
-  FAILURE_COUNT=$(cat "$CIRCUIT_BREAKER_FILE" 2>/dev/null || echo 0)
-  if (( FAILURE_COUNT >= CIRCUIT_BREAKER_THRESHOLD )); then
-    echo "[$(date)] CIRCUIT BREAKER OPEN: Hooks disabled after $FAILURE_COUNT failures. Run: rm $CIRCUIT_BREAKER_FILE" >> "$DEBUG_LOG" 2>/dev/null || true
-    exit 0
-  fi
-fi
-
-# EMERGENCY FILE LOCK: Prevent concurrent executions
-LOCK_FILE="$PROJECT_ROOT/.specweave/state/.hook-post-edit.lock"
-LOCK_TIMEOUT=5  # seconds
-
-# Try to acquire lock with timeout
-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 if lock is stale (older than LOCK_TIMEOUT seconds)
-  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.2
-done
-
-if [[ "$LOCK_ACQUIRED" == "false" ]]; then
-  echo "[$(date)] post-edit-spec: Could not acquire lock, skipping" >> "$DEBUG_LOG" 2>/dev/null || true
-  exit 0
-fi
-
-# Log rotation: Keep debug log under 100KB
-if [[ -f "$DEBUG_LOG" ]] && [[ $(wc -c < "$DEBUG_LOG" 2>/dev/null || echo 0) -gt 102400 ]]; then
-  tail -100 "$DEBUG_LOG" > "$DEBUG_LOG.tmp" 2>/dev/null || true
-  mv "$DEBUG_LOG.tmp" "$DEBUG_LOG" 2>/dev/null || true
-  echo "[$(date)] Log rotated" >> "$DEBUG_LOG" 2>/dev/null || true
-fi
-
-# ============================================================================
-# TIER 1 FIX: Debouncing (Prevent Redundant Updates)
-# ============================================================================
-# Skip update if we updated less than 5 seconds ago (INCREASED FROM 1s)
-# This handles rapid consecutive edits (e.g., 10 tasks marked complete quickly)
-LAST_UPDATE_FILE="$PROJECT_ROOT/.specweave/state/.last-status-update"
-DEBOUNCE_SECONDS=5
-
-if [[ -f "$LAST_UPDATE_FILE" ]]; then
-  LAST_UPDATE=$(cat "$LAST_UPDATE_FILE" 2>/dev/null || echo 0)
-  NOW=$(date +%s)
-  TIME_SINCE_UPDATE=$((NOW - LAST_UPDATE))
-
-  if (( TIME_SINCE_UPDATE < DEBOUNCE_SECONDS )); then
-    echo "[$(date)] post-edit-spec: Debounced (${TIME_SINCE_UPDATE}s since last update)" >> "$DEBUG_LOG" 2>/dev/null || true
-    exit 0  # Skip this update
-  fi
-fi
-
-# ============================================================================
-# TIER 2: Check for PreToolUse Signal (Primary Detection Method)
-# ============================================================================
-PENDING_FILE="$PROJECT_ROOT/.specweave/state/.pending-status-update"
-METRICS_FILE="$PROJECT_ROOT/.specweave/state/hook-metrics.jsonl"
-EDITED_FILE=""
-DETECTION_METHOD="none"
-
-# First, check if PreToolUse hook left a signal
-if [[ -f "$PENDING_FILE" ]]; then
-  EDITED_FILE=$(cat "$PENDING_FILE" 2>/dev/null || echo "")
-  # Delete pending file immediately (consume signal)
-  rm "$PENDING_FILE" 2>/dev/null || true
-
-  if [[ -n "$EDITED_FILE" ]]; then
-    DETECTION_METHOD="pretooluse"
-    echo "[$(date)] post-edit-spec: File from PreToolUse signal: $EDITED_FILE" >> "$DEBUG_LOG" 2>/dev/null || true
-
-    # Record Tier 2 success metric
-    TIMESTAMP=$(date -u +%Y-%m-%dT%H:%M:%SZ)
-    echo "{\"timestamp\":\"$TIMESTAMP\",\"hook\":\"post-edit-spec\",\"event\":\"tier2_success\",\"method\":\"pretooluse\"}" >> "$METRICS_FILE" 2>/dev/null || true
-  fi
-fi
-
-# ============================================================================
-# TIER 1 FALLBACK: Environment Variable Detection
-# ============================================================================
-# If PreToolUse didn't provide signal, fall back to Tier 1 methods
-if [[ -z "$EDITED_FILE" ]]; then
-  # Method 1: TOOL_USE_CONTENT environment variable
-  if [[ -n "${TOOL_USE_CONTENT:-}" ]]; then
-    EDITED_FILE="$TOOL_USE_CONTENT"
-    DETECTION_METHOD="env_content"
-  fi
-
-  # Method 2: TOOL_RESULT environment variable
-  if [[ -z "$EDITED_FILE" ]] && [[ -n "${TOOL_RESULT:-}" ]]; then
-    EDITED_FILE=$(echo "$TOOL_RESULT" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"\([^"]*\)".*/\1/' || echo "")
-    DETECTION_METHOD="env_result"
-  fi
-
-  # Method 3: TOOL_USE_ARGS
-  if [[ -z "$EDITED_FILE" ]] && [[ -n "${TOOL_USE_ARGS:-}" ]]; then
-    EDITED_FILE=$(echo "$TOOL_USE_ARGS" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"\([^"]*\)".*/\1/' || echo "")
-    DETECTION_METHOD="env_args"
-  fi
-
-  # Log env var detection (for metrics)
-  if [[ -n "$EDITED_FILE" ]]; then
-    echo "[$(date)] post-edit-spec: File from env vars ($DETECTION_METHOD): $EDITED_FILE" >> "$DEBUG_LOG" 2>/dev/null || true
-  fi
-fi
-
-# Check if we detected a spec.md or tasks.md edit in increments folder
-SHOULD_UPDATE=false
-
-if [[ -n "$EDITED_FILE" ]]; then
-  # Check if the file is spec.md or tasks.md
-  if [[ "$EDITED_FILE" == *"/spec.md" ]] || [[ "$EDITED_FILE" == *"/tasks.md" ]]; then
-    # Check if it's in an increment folder
-    if [[ "$EDITED_FILE" == *"/.specweave/increments/"* ]]; then
-      SHOULD_UPDATE=true
-      echo "[$(date)] post-edit-spec: Increment file edited - will update status line" >> "$DEBUG_LOG" 2>/dev/null || true
-    fi
-  fi
-fi
-
-# ============================================================================
-# TIER 1 FIX: File Modification Time Detection (Fallback)
-# ============================================================================
-# If we couldn't detect the file via environment variables, check which files
-# were modified recently (within last 2 seconds) instead of blindly updating
-if [[ -z "$EDITED_FILE" ]]; then
-  echo "[$(date)] post-edit-spec: Env vars empty - checking file mtimes" >> "$DEBUG_LOG" 2>/dev/null || true
-
-  NOW=$(date +%s)
-  INCREMENTS_DIR="$PROJECT_ROOT/.specweave/increments"
-
-  # Check for recently modified spec.md or tasks.md files
-  if [[ -d "$INCREMENTS_DIR" ]]; then
-    for file in "$INCREMENTS_DIR"/*/spec.md "$INCREMENTS_DIR"/*/tasks.md; do
-      if [[ -f "$file" ]]; then
-        # Get file modification time (platform-specific)
-        if [[ "$(uname)" == "Darwin" ]]; then
-          MTIME=$(stat -f "%m" "$file" 2>/dev/null || echo 0)
-        else
-          MTIME=$(stat -c "%Y" "$file" 2>/dev/null || echo 0)
-        fi
-
-        # If file was modified in last 2 seconds, consider it the edited file
-        TIME_DIFF=$((NOW - MTIME))
-        if (( TIME_DIFF <= 2 )); then
-          EDITED_FILE="$file"
-          echo "[$(date)] post-edit-spec: Detected recent modification: $file (${TIME_DIFF}s ago)" >> "$DEBUG_LOG" 2>/dev/null || true
-          SHOULD_UPDATE=true
-          break
-        fi
-      fi
-    done
-  fi
-
-  # If still no file detected, skip update (not a spec/tasks edit)
-  if [[ -z "$EDITED_FILE" ]]; then
-    echo "[$(date)] post-edit-spec: No spec/tasks modifications detected - skipping" >> "$DEBUG_LOG" 2>/dev/null || true
-    exit 0
-  fi
-fi
-
-# ============================================================================
-# TIER 1 FIX: Non-Blocking Background Update with COMPLETE ERROR ISOLATION
-# ============================================================================
-# Update status line if needed
-if [[ "$SHOULD_UPDATE" == "true" ]]; then
-  echo "[$(date)] post-edit-spec: Running update-status-line.sh (background)" >> "$DEBUG_LOG" 2>/dev/null || true
-
-  # Record update time BEFORE spawning background process
-  # This ensures debouncing works even if update hasn't completed yet
-  echo "$(date +%s)" > "$LAST_UPDATE_FILE"
-
-  # Run status line update in background with COMPLETE error isolation
-  # This prevents Edit tool from waiting for status line computation
-  (
-    set +e  # Disable error propagation
-
-    if "$PROJECT_ROOT/plugins/specweave/hooks/lib/update-status-line.sh" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null; then
-      echo "[$(date)] post-edit-spec: Status line updated successfully" >> "$DEBUG_LOG" 2>/dev/null || true
-      # Reset circuit breaker on success
-      echo "0" > "$CIRCUIT_BREAKER_FILE" 2>/dev/null || true
-    else
-      echo "[$(date)] post-edit-spec: Warning - status line update failed (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
-      # Increment circuit breaker
-      CURRENT_FAILURES=$(cat "$CIRCUIT_BREAKER_FILE" 2>/dev/null || echo 0)
-      echo "$((CURRENT_FAILURES + 1))" > "$CIRCUIT_BREAKER_FILE" 2>/dev/null || true
-    fi
-  ) &
-
-  # Disown the background process so it's not killed when hook exits
-  disown 2>/dev/null || true
-fi
-
-# Always exit 0 to prevent hook errors from crashing Claude Code
-exit 0

package/plugins/specweave/hooks/post-write-spec.sh

@@ -1,267 +0,0 @@
-#!/bin/bash
-#
-# Post-Write Hook: Update Status Line After spec.md or tasks.md Writes
-#
-# Triggers: After Write tool creates/replaces spec.md or tasks.md
-# Action: Updates status line cache to reflect latest AC/task progress
-#
-# EMERGENCY FIXES (v0.24.3):
-# - Kill switch: Set SPECWEAVE_DISABLE_HOOKS=1 to disable ALL hooks
-# - Circuit breaker: Auto-disable after 3 consecutive failures
-# - File locking: Prevent concurrent executions (max 1 at a time)
-# - Aggressive debouncing: Increased from 1s to 5s
-# - Complete error isolation: Never let errors reach Claude Code
-#
-# TIER 1 IMPROVEMENTS (v0.24.2):
-# - Debouncing: Skip if updated less than 1 second ago (90% overhead reduction)
-# - File mtime detection: Check recently modified spec.md/tasks.md as fallback
-# - Non-blocking: Run update-status-line.sh in background
-# - Smart detection: Only update if spec/tasks files actually changed
-#
-# Previous fix (v0.24.1): Enhanced file detection for increment completion
-# - Detects writes via TOOL_USE_CONTENT, TOOL_RESULT, and argument parsing
-# - Always updates status line for ANY spec.md/tasks.md write in increments folder
-
-# CRITICAL: Remove set -e to prevent hook errors from crashing Claude Code
-set +e
-
-# EMERGENCY KILL SWITCH: Disable all hooks if env variable set
-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)
-LOGS_DIR="$PROJECT_ROOT/.specweave/logs"
-DEBUG_LOG="$LOGS_DIR/hooks-debug.log"
-
-# Ensure state and logs directories exist
-mkdir -p "$PROJECT_ROOT/.specweave/state" "$LOGS_DIR" 2>/dev/null || true
-
-# EMERGENCY CIRCUIT BREAKER: Track consecutive failures
-CIRCUIT_BREAKER_FILE="$PROJECT_ROOT/.specweave/state/.hook-circuit-breaker"
-CIRCUIT_BREAKER_THRESHOLD=3
-
-if [[ -f "$CIRCUIT_BREAKER_FILE" ]]; then
-  FAILURE_COUNT=$(cat "$CIRCUIT_BREAKER_FILE" 2>/dev/null || echo 0)
-  if (( FAILURE_COUNT >= CIRCUIT_BREAKER_THRESHOLD )); then
-    echo "[$(date)] CIRCUIT BREAKER OPEN: Hooks disabled after $FAILURE_COUNT failures. Run: rm $CIRCUIT_BREAKER_FILE" >> "$DEBUG_LOG" 2>/dev/null || true
-    exit 0
-  fi
-fi
-
-# EMERGENCY FILE LOCK: Prevent concurrent executions
-LOCK_FILE="$PROJECT_ROOT/.specweave/state/.hook-post-write.lock"
-LOCK_TIMEOUT=5  # seconds
-
-# Try to acquire lock with timeout
-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 if lock is stale (older than LOCK_TIMEOUT seconds)
-  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.2
-done
-
-if [[ "$LOCK_ACQUIRED" == "false" ]]; then
-  echo "[$(date)] post-write-spec: Could not acquire lock, skipping" >> "$DEBUG_LOG" 2>/dev/null || true
-  exit 0
-fi
-
-# Log rotation: Keep debug log under 100KB
-if [[ -f "$DEBUG_LOG" ]] && [[ $(wc -c < "$DEBUG_LOG" 2>/dev/null || echo 0) -gt 102400 ]]; then
-  tail -100 "$DEBUG_LOG" > "$DEBUG_LOG.tmp" 2>/dev/null || true
-  mv "$DEBUG_LOG.tmp" "$DEBUG_LOG" 2>/dev/null || true
-  echo "[$(date)] Log rotated" >> "$DEBUG_LOG" 2>/dev/null || true
-fi
-
-# ============================================================================
-# TIER 1 FIX: Debouncing (Prevent Redundant Updates)
-# ============================================================================
-# Skip update if we updated less than 5 seconds ago (INCREASED FROM 1s)
-# This handles rapid consecutive writes (e.g., spec.md regeneration)
-LAST_UPDATE_FILE="$PROJECT_ROOT/.specweave/state/.last-status-update"
-DEBOUNCE_SECONDS=5
-
-if [[ -f "$LAST_UPDATE_FILE" ]]; then
-  LAST_UPDATE=$(cat "$LAST_UPDATE_FILE" 2>/dev/null || echo 0)
-  NOW=$(date +%s)
-  TIME_SINCE_UPDATE=$((NOW - LAST_UPDATE))
-
-  if (( TIME_SINCE_UPDATE < DEBOUNCE_SECONDS )); then
-    echo "[$(date)] post-write-spec: Debounced (${TIME_SINCE_UPDATE}s since last update)" >> "$DEBUG_LOG" 2>/dev/null || true
-    exit 0  # Skip this update
-  fi
-fi
-
-# ============================================================================
-# TIER 2: Check for PreToolUse Signal (Primary Detection Method)
-# ============================================================================
-PENDING_FILE="$PROJECT_ROOT/.specweave/state/.pending-status-update"
-METRICS_FILE="$PROJECT_ROOT/.specweave/state/hook-metrics.jsonl"
-WRITTEN_FILE=""
-DETECTION_METHOD="none"
-
-# First, check if PreToolUse hook left a signal
-if [[ -f "$PENDING_FILE" ]]; then
-  WRITTEN_FILE=$(cat "$PENDING_FILE" 2>/dev/null || echo "")
-  # Delete pending file immediately (consume signal)
-  rm "$PENDING_FILE" 2>/dev/null || true
-
-  if [[ -n "$WRITTEN_FILE" ]]; then
-    DETECTION_METHOD="pretooluse"
-    echo "[$(date)] post-write-spec: File from PreToolUse signal: $WRITTEN_FILE" >> "$DEBUG_LOG" 2>/dev/null || true
-
-    # Record Tier 2 success metric
-    TIMESTAMP=$(date -u +%Y-%m-%dT%H:%M:%SZ)
-    echo "{\"timestamp\":\"$TIMESTAMP\",\"hook\":\"post-write-spec\",\"event\":\"tier2_success\",\"method\":\"pretooluse\"}" >> "$METRICS_FILE" 2>/dev/null || true
-  fi
-fi
-
-# ============================================================================
-# TIER 1 FALLBACK: Environment Variable Detection
-# ============================================================================
-# If PreToolUse didn't provide signal, fall back to Tier 1 methods
-if [[ -z "$WRITTEN_FILE" ]]; then
-  # Method 1: TOOL_USE_CONTENT environment variable
-  if [[ -n "${TOOL_USE_CONTENT:-}" ]]; then
-    WRITTEN_FILE="$TOOL_USE_CONTENT"
-    DETECTION_METHOD="env_content"
-  fi
-
-  # Method 2: TOOL_RESULT environment variable
-  if [[ -z "$WRITTEN_FILE" ]] && [[ -n "${TOOL_RESULT:-}" ]]; then
-    WRITTEN_FILE=$(echo "$TOOL_RESULT" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"\([^"]*\)".*/\1/' || echo "")
-    DETECTION_METHOD="env_result"
-  fi
-
-  # Method 3: TOOL_USE_ARGS
-  if [[ -z "$WRITTEN_FILE" ]] && [[ -n "${TOOL_USE_ARGS:-}" ]]; then
-    WRITTEN_FILE=$(echo "$TOOL_USE_ARGS" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"\([^"]*\)".*/\1/' || echo "")
-    DETECTION_METHOD="env_args"
-  fi
-
-  # Log env var detection (for metrics)
-  if [[ -n "$WRITTEN_FILE" ]]; then
-    echo "[$(date)] post-write-spec: File from env vars ($DETECTION_METHOD): $WRITTEN_FILE" >> "$DEBUG_LOG" 2>/dev/null || true
-  fi
-fi
-
-# Log detection attempt (only log if we actually detected a file, to reduce noise)
-if [[ -n "$WRITTEN_FILE" ]]; then
-  echo "[$(date)] post-write-spec: Detected file: $WRITTEN_FILE" >> "$DEBUG_LOG" 2>/dev/null || true
-fi
-
-# Check if we detected a spec.md or tasks.md write in increments folder
-SHOULD_UPDATE=false
-
-if [[ -n "$WRITTEN_FILE" ]]; then
-  # Check if the file is spec.md or tasks.md
-  if [[ "$WRITTEN_FILE" == *"/spec.md" ]] || [[ "$WRITTEN_FILE" == *"/tasks.md" ]]; then
-    # Check if it's in an increment folder
-    if [[ "$WRITTEN_FILE" == *"/.specweave/increments/"* ]]; then
-      SHOULD_UPDATE=true
-      echo "[$(date)] post-write-spec: Increment file written - will update status line" >> "$DEBUG_LOG" 2>/dev/null || true
-    fi
-  fi
-fi
-
-# ============================================================================
-# TIER 1 FIX: File Modification Time Detection (Fallback)
-# ============================================================================
-# If we couldn't detect the file via environment variables, check which files
-# were modified recently (within last 2 seconds) instead of blindly updating
-if [[ -z "$WRITTEN_FILE" ]]; then
-  echo "[$(date)] post-write-spec: Env vars empty - checking file mtimes" >> "$DEBUG_LOG" 2>/dev/null || true
-
-  NOW=$(date +%s)
-  INCREMENTS_DIR="$PROJECT_ROOT/.specweave/increments"
-
-  # Check for recently modified spec.md or tasks.md files
-  if [[ -d "$INCREMENTS_DIR" ]]; then
-    for file in "$INCREMENTS_DIR"/*/spec.md "$INCREMENTS_DIR"/*/tasks.md; do
-      if [[ -f "$file" ]]; then
-        # Get file modification time (platform-specific)
-        if [[ "$(uname)" == "Darwin" ]]; then
-          MTIME=$(stat -f "%m" "$file" 2>/dev/null || echo 0)
-        else
-          MTIME=$(stat -c "%Y" "$file" 2>/dev/null || echo 0)
-        fi
-
-        # If file was modified in last 2 seconds, consider it the written file
-        TIME_DIFF=$((NOW - MTIME))
-        if (( TIME_DIFF <= 2 )); then
-          WRITTEN_FILE="$file"
-          echo "[$(date)] post-write-spec: Detected recent modification: $file (${TIME_DIFF}s ago)" >> "$DEBUG_LOG" 2>/dev/null || true
-          SHOULD_UPDATE=true
-          break
-        fi
-      fi
-    done
-  fi
-
-  # If still no file detected, skip update (not a spec/tasks write)
-  if [[ -z "$WRITTEN_FILE" ]]; then
-    echo "[$(date)] post-write-spec: No spec/tasks modifications detected - skipping" >> "$DEBUG_LOG" 2>/dev/null || true
-    exit 0
-  fi
-fi
-
-# ============================================================================
-# TIER 1 FIX: Non-Blocking Background Update with COMPLETE ERROR ISOLATION
-# ============================================================================
-# Update status line if needed
-if [[ "$SHOULD_UPDATE" == "true" ]]; then
-  echo "[$(date)] post-write-spec: Running update-status-line.sh (background)" >> "$DEBUG_LOG" 2>/dev/null || true
-
-  # Record update time BEFORE spawning background process
-  # This ensures debouncing works even if update hasn't completed yet
-  echo "$(date +%s)" > "$LAST_UPDATE_FILE"
-
-  # Run status line update in background with COMPLETE error isolation
-  # This prevents Write tool from waiting for status line computation
-  (
-    set +e  # Disable error propagation
-
-    if "$PROJECT_ROOT/plugins/specweave/hooks/lib/update-status-line.sh" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null; then
-      echo "[$(date)] post-write-spec: Status line updated successfully" >> "$DEBUG_LOG" 2>/dev/null || true
-      # Reset circuit breaker on success
-      echo "0" > "$CIRCUIT_BREAKER_FILE" 2>/dev/null || true
-    else
-      echo "[$(date)] post-write-spec: Warning - status line update failed (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
-      # Increment circuit breaker
-      CURRENT_FAILURES=$(cat "$CIRCUIT_BREAKER_FILE" 2>/dev/null || echo 0)
-      echo "$((CURRENT_FAILURES + 1))" > "$CIRCUIT_BREAKER_FILE" 2>/dev/null || true
-    fi
-  ) &
-
-  # Disown the background process so it's not killed when hook exits
-  disown 2>/dev/null || true
-fi
-
-# Always exit 0 to prevent hook errors from crashing Claude Code
-exit 0