specweave 0.28.61 → 0.28.62

package/dist/src/cli/helpers/init/ado-repo-cloning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ado-repo-cloning.d.ts","sourceRoot":"","sources":["../../../../../src/cli/helpers/init/ado-repo-cloning.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAA+B,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAKhG;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAcD;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,mBAAmB,EACxC,YAAY,EAAE,kBAAkB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAiFf"}
+{"version":3,"file":"ado-repo-cloning.d.ts","sourceRoot":"","sources":["../../../../../src/cli/helpers/init/ado-repo-cloning.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAA+B,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAKhG;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA+BD;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,mBAAmB,EACxC,YAAY,EAAE,kBAAkB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAuFf"}

package/dist/src/cli/helpers/init/ado-repo-cloning.js

@@ -13,6 +13,22 @@ import { AzureDevOpsProvider } from '../../../core/repo-structure/providers/azur
 import { filterRepositoriesByPattern } from '../selection-strategy.js';
 import { getJobManager } from '../../../core/background/index.js';
 import { execFileNoThrowSync } from '../../../utils/execFileNoThrow.js';
+/**
+ * Build proper ADO clone URL with PAT authentication
+ *
+ * ADO clone URL format: https://{PAT}@dev.azure.com/{org}/{project}/_git/{repo}
+ *
+ * The remoteUrl from ADO API may come in different formats:
+ * - https://dev.azure.com/org/project/_git/repo
+ * - https://org@dev.azure.com/org/project/_git/repo (with org as placeholder)
+ *
+ * We need to construct a proper URL with PAT authentication.
+ */
+function buildAdoCloneUrl(org, project, repoName, pat) {
+    // Build clean URL with PAT authentication
+    // Format: https://{PAT}@dev.azure.com/{org}/{project}/_git/{repo}
+    return `https://${pat}@dev.azure.com/${org}/${project}/_git/${repoName}`;
+}
 /**
  * Trigger ADO repository cloning during init
  *
@@ -37,6 +53,10 @@ export async function triggerAdoRepoCloning(projectPath, adoProjectSelection, cl
         console.log(chalk.yellow('\n   No ADO projects selected for cloning.\n'));
         return;
     }
+    if (!pat) {
+        console.log(chalk.yellow('\n   No PAT provided. Cannot clone repositories.\n'));
+        return;
+    }
     console.log(chalk.blue('\n📦 Fetching ADO Repositories\n'));
     const provider = new AzureDevOpsProvider();
     const allRepos = [];
@@ -85,7 +105,8 @@ export async function triggerAdoRepoCloning(projectPath, adoProjectSelection, cl
     const job = jobManager.createJob('clone-repos', jobConfig, filteredRepos.length);
     jobManager.startJob(job.id);
     // Start cloning asynchronously (non-blocking)
-    cloneRepositoriesAsync(projectPath, filteredRepos, org, job.id).catch(error => {
+    // IMPORTANT: Pass PAT directly - don't rely on .env which may not exist yet
+    cloneRepositoriesAsync(projectPath, filteredRepos, org, pat, job.id).catch(error => {
         console.error(chalk.red(`Clone error: ${error instanceof Error ? error.message : String(error)}`));
         jobManager.completeJob(job.id, error instanceof Error ? error.message : String(error));
     });
@@ -99,8 +120,14 @@ export async function triggerAdoRepoCloning(projectPath, adoProjectSelection, cl
  * Clone repositories asynchronously
  *
  * This runs in background and updates job progress as repos are cloned.
+ *
+ * @param projectPath - Target directory
+ * @param repos - Repositories to clone
+ * @param org - ADO organization name
+ * @param pat - Personal Access Token (passed directly, not from .env)
+ * @param jobId - Background job ID for progress tracking
  */
-async function cloneRepositoriesAsync(projectPath, repos, org, jobId) {
+async function cloneRepositoriesAsync(projectPath, repos, org, pat, jobId) {
     const jobManager = getJobManager(projectPath);
     const reposDir = path.join(projectPath, 'repos');
     let completed = 0;
@@ -113,49 +140,35 @@ async function cloneRepositoriesAsync(projectPath, repos, org, jobId) {
             continue;
         }
         try {
-            // Clone using HTTPS URL (PAT auth)
-            // For ADO: https://dev.azure.com/org/project/_git/repo becomes
-            // https://{pat}@dev.azure.com/org/project/_git/repo for auth
-            const pat = (await getPatFromJobConfig(projectPath, jobId)) || '';
-            const authUrl = repo.remoteUrl.replace('https://', `https://${pat}@`);
+            // Build proper clone URL with PAT authentication
+            // Format: https://{PAT}@dev.azure.com/{org}/{project}/_git/{repo}
+            const cloneUrl = buildAdoCloneUrl(org, repo.project, repo.name, pat);
             // Create parent directory if needed
             if (!existsSync(reposDir)) {
                 mkdirSync(reposDir, { recursive: true });
             }
             // Clone the repository
-            const result = execFileNoThrowSync('git', ['clone', authUrl, repo.name], { cwd: reposDir });
+            const result = execFileNoThrowSync('git', ['clone', cloneUrl, repo.name], { cwd: reposDir });
             if (result.exitCode === 0) {
                 completed++;
                 jobManager.updateProgress(jobId, completed, repo.name, repo.name);
+                console.log(chalk.green(`   ✓ Cloned ${repo.name}`));
             }
             else {
                 // Clone failed - mark as failed but continue
                 jobManager.updateProgress(jobId, completed, repo.name, undefined, repo.name);
-                console.error(chalk.yellow(`   Failed to clone ${repo.name}: ${result.stderr || result.stdout}`));
+                console.error(chalk.yellow(`   ✗ Failed to clone ${repo.name}: ${result.stderr || result.stdout}`));
             }
         }
         catch (error) {
             // Mark repo as failed but continue with others
             jobManager.updateProgress(jobId, completed, repo.name, undefined, repo.name);
             const errorMsg = error instanceof Error ? error.message : String(error);
-            console.error(chalk.yellow(`   Error cloning ${repo.name}: ${errorMsg}`));
+            console.error(chalk.yellow(`   ✗ Error cloning ${repo.name}: ${errorMsg}`));
         }
     }
     // Mark job as complete
     jobManager.completeJob(jobId);
-}
-/**
- * Get PAT from job config (stored in background-jobs.json)
- */
-async function getPatFromJobConfig(projectPath, jobId) {
-    // PAT is stored in .env, not in job config (security)
-    // Read from environment or .env file
-    const { readEnvFile, parseEnvFile } = await import('../../../utils/env-file.js');
-    const envContent = readEnvFile(projectPath);
-    if (envContent) {
-        const parsed = parseEnvFile(envContent);
-        return parsed.AZURE_DEVOPS_PAT || null;
-    }
-    return process.env.AZURE_DEVOPS_PAT || null;
+    console.log(chalk.green(`\n✅ Clone job completed: ${completed}/${repos.length} repositories cloned`));
 }
 //# sourceMappingURL=ado-repo-cloning.js.map

package/dist/src/cli/helpers/init/ado-repo-cloning.js.map

@@ -1 +1 @@
-{"version":3,"file":"ado-repo-cloning.js","sourceRoot":"","sources":["../../../../../src/cli/helpers/init/ado-repo-cloning.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ado-repo-cloning.js","sourceRoot":"","sources":["../../../../../src/cli/helpers/init/ado-repo-cloning.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.28.61",
+  "version": "0.28.62",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave/commands/specweave-jobs.md

@@ -103,7 +103,7 @@ Started: 2024-01-15 10:30:00
 Updated: 2024-01-15 10:32:15
 
 Progress: 2,500/10,000 (25%)
-Current: OlySense\Core-Operations
+Current: Acme\Core-Operations
 Rate: 15.2 items/sec
 ETA: ~8 minutes
 
@@ -122,10 +122,10 @@ Watch job progress in real-time (like `tail -f`):
 
 📦 Following job abc12345 (Ctrl+C to stop)
 
-[10:30:15] Progress: 2,500/10,000 (25%) - OlySense\Core-Operations
-[10:30:16] Progress: 2,520/10,000 (25%) - OlySense\Core-Operations
-[10:30:17] Progress: 2,545/10,000 (25%) - OlySense\AI-Platform
-[10:30:18] Progress: 2,570/10,000 (26%) - OlySense\AI-Platform
+[10:30:15] Progress: 2,500/10,000 (25%) - Acme\Core-Operations
+[10:30:16] Progress: 2,520/10,000 (25%) - Acme\Core-Operations
+[10:30:17] Progress: 2,545/10,000 (25%) - Acme\AI-Platform
+[10:30:18] Progress: 2,570/10,000 (26%) - Acme\AI-Platform
 ...
 ```
 
@@ -144,8 +144,8 @@ Show detailed worker output:
 [2024-01-15T10:30:00.456Z] Project path: /Users/dev/my-project
 [2024-01-15T10:30:00.789Z] PID: 45678
 [2024-01-15T10:30:01.234Z] Dependencies loaded, starting import...
-[2024-01-15T10:30:02.567Z] Progress: 100/10000 - ado OlySense\Core-Operations
-[2024-01-15T10:30:03.890Z] Progress: 200/10000 - ado OlySense\Core-Operations
+[2024-01-15T10:30:02.567Z] Progress: 100/10000 - ado Acme\Core-Operations
+[2024-01-15T10:30:03.890Z] Progress: 200/10000 - ado Acme\Core-Operations
 ...
 ```
 

package/plugins/specweave/hooks/v2/detectors/lifecycle-detector.sh

@@ -0,0 +1,85 @@
+#!/bin/bash
+# lifecycle-detector.sh - Detect increment lifecycle changes
+# Events: increment.created, increment.done, increment.archived, increment.reopened
+#
+# Called from post-tool-use.sh when metadata.json is edited
+# Compares current vs previous status to detect transitions
+#
+# IMPORTANT: This script must be fast (<10ms) and never crash
+set +e
+
+[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
+
+INC_ID="${1:-}"
+[[ -z "$INC_ID" ]] && exit 0
+
+# Find project root
+PROJECT_ROOT="$PWD"
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+  PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
+done
+[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+
+STATE_DIR="$PROJECT_ROOT/.specweave/state"
+PREV_STATUS_FILE="$STATE_DIR/.prev-status-$INC_ID"
+META_FILE="$PROJECT_ROOT/.specweave/increments/$INC_ID/metadata.json"
+ARCHIVE_META="$PROJECT_ROOT/.specweave/increments/_archive/$INC_ID/metadata.json"
+
+mkdir -p "$STATE_DIR" 2>/dev/null
+
+# Detect event
+EVENT=""
+EVENT_DATA="$INC_ID"
+
+# Check if archived (folder moved to _archive/)
+if [[ -f "$ARCHIVE_META" ]] && [[ ! -f "$META_FILE" ]]; then
+  # Check if we already detected this
+  PREV=$(cat "$PREV_STATUS_FILE" 2>/dev/null || echo "")
+  if [[ "$PREV" != "archived" ]]; then
+    EVENT="increment.archived"
+    echo "archived" > "$PREV_STATUS_FILE"
+  fi
+
+elif [[ -f "$META_FILE" ]]; then
+  # Get current status (fast grep, no jq)
+  CURRENT_STATUS=$(grep -o '"status"[[:space:]]*:[[:space:]]*"[^"]*"' "$META_FILE" | head -1 | sed 's/.*"\([^"]*\)".*/\1/')
+  [[ -z "$CURRENT_STATUS" ]] && exit 0
+
+  # Get previous status
+  PREV_STATUS=$(cat "$PREV_STATUS_FILE" 2>/dev/null || echo "")
+
+  # Detect transitions
+  if [[ -z "$PREV_STATUS" ]]; then
+    # First time seeing this increment
+    if [[ "$CURRENT_STATUS" == "planning" ]] || [[ "$CURRENT_STATUS" == "active" ]]; then
+      EVENT="increment.created"
+    fi
+  elif [[ "$PREV_STATUS" != "$CURRENT_STATUS" ]]; then
+    # Status changed
+    case "$CURRENT_STATUS" in
+      completed)
+        EVENT="increment.done"
+        ;;
+      active)
+        # Was it completed before? That's a reopen
+        if [[ "$PREV_STATUS" == "completed" ]]; then
+          EVENT="increment.reopened"
+        fi
+        ;;
+      paused|abandoned)
+        # Status changes we don't emit events for
+        ;;
+    esac
+  fi
+
+  # Save current status
+  echo "$CURRENT_STATUS" > "$PREV_STATUS_FILE"
+fi
+
+# Fire event if detected
+if [[ -n "$EVENT" ]]; then
+  HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+  bash "$HOOK_DIR/queue/enqueue.sh" "$EVENT" "$EVENT_DATA" 2>/dev/null
+fi
+
+exit 0

package/plugins/specweave/hooks/v2/detectors/us-completion-detector.sh

@@ -0,0 +1,148 @@
+#!/bin/bash
+# us-completion-detector.sh - Detect user story completion
+# Events: user-story.completed, user-story.reopened
+#
+# A user story is complete when:
+# 1. ALL tasks for that US are completed ([x])
+# 2. ALL ACs for that US are checked ([x])
+#
+# Called from post-tool-use.sh when tasks.md or spec.md is edited
+#
+# IMPORTANT: This script must be fast (<50ms) and never crash
+set +e
+
+[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
+
+INC_ID="${1:-}"
+[[ -z "$INC_ID" ]] && exit 0
+
+# Find project root
+PROJECT_ROOT="$PWD"
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+  PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
+done
+[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+
+STATE_DIR="$PROJECT_ROOT/.specweave/state"
+TASKS_FILE="$PROJECT_ROOT/.specweave/increments/$INC_ID/tasks.md"
+SPEC_FILE="$PROJECT_ROOT/.specweave/increments/$INC_ID/spec.md"
+US_STATE_FILE="$STATE_DIR/.us-completion-$INC_ID"
+
+mkdir -p "$STATE_DIR" 2>/dev/null
+
+[[ ! -f "$TASKS_FILE" ]] && exit 0
+[[ ! -f "$SPEC_FILE" ]] && exit 0
+
+# Parse tasks.md to find US -> Tasks mapping and completion status
+# Format: ### T-001: Title
+#         **Satisfies ACs**: AC-US1-01, AC-US1-02
+#         **Status**: [x] completed
+
+declare -A US_TASKS_TOTAL
+declare -A US_TASKS_DONE
+
+# Parse task blocks
+CURRENT_TASK=""
+CURRENT_STATUS=""
+CURRENT_US=""
+
+while IFS= read -r line; do
+  # Detect task header
+  if [[ "$line" =~ ^###[[:space:]]+T-[0-9]+ ]]; then
+    # Process previous task
+    if [[ -n "$CURRENT_US" ]] && [[ -n "$CURRENT_TASK" ]]; then
+      US_TASKS_TOTAL["$CURRENT_US"]=$((${US_TASKS_TOTAL["$CURRENT_US"]:-0} + 1))
+      if [[ "$CURRENT_STATUS" == "done" ]]; then
+        US_TASKS_DONE["$CURRENT_US"]=$((${US_TASKS_DONE["$CURRENT_US"]:-0} + 1))
+      fi
+    fi
+    CURRENT_TASK=$(echo "$line" | grep -o 'T-[0-9][0-9][0-9]' | head -1)
+    CURRENT_STATUS=""
+    CURRENT_US=""
+  fi
+
+  # Detect User Story reference
+  if [[ "$line" =~ User[[:space:]]*Story.*:.*US-[0-9]+ ]]; then
+    CURRENT_US=$(echo "$line" | grep -o 'US-[0-9][0-9][0-9]' | head -1)
+  fi
+
+  # Detect completion status
+  if [[ "$line" =~ Status.*\[x\] ]]; then
+    CURRENT_STATUS="done"
+  fi
+done < "$TASKS_FILE"
+
+# Process last task
+if [[ -n "$CURRENT_US" ]] && [[ -n "$CURRENT_TASK" ]]; then
+  US_TASKS_TOTAL["$CURRENT_US"]=$((${US_TASKS_TOTAL["$CURRENT_US"]:-0} + 1))
+  if [[ "$CURRENT_STATUS" == "done" ]]; then
+    US_TASKS_DONE["$CURRENT_US"]=$((${US_TASKS_DONE["$CURRENT_US"]:-0} + 1))
+  fi
+fi
+
+# Parse spec.md for AC completion status
+# Format: - [x] **AC-US1-01**: Description
+declare -A US_ACS_TOTAL
+declare -A US_ACS_DONE
+
+while IFS= read -r line; do
+  # Find AC lines with US reference
+  if [[ "$line" =~ AC-US([0-9]+)-[0-9]+ ]]; then
+    US_NUM="${BASH_REMATCH[1]}"
+    US_ID="US-${US_NUM}"
+
+    US_ACS_TOTAL["$US_ID"]=$((${US_ACS_TOTAL["$US_ID"]:-0} + 1))
+
+    if [[ "$line" =~ \[x\] ]]; then
+      US_ACS_DONE["$US_ID"]=$((${US_ACS_DONE["$US_ID"]:-0} + 1))
+    fi
+  fi
+done < "$SPEC_FILE"
+
+# Load previous completion state
+declare -A PREV_COMPLETE
+if [[ -f "$US_STATE_FILE" ]]; then
+  while IFS='=' read -r us status; do
+    [[ -n "$us" ]] && PREV_COMPLETE["$us"]="$status"
+  done < "$US_STATE_FILE"
+fi
+
+# Check completion for each US
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+NEW_STATE=""
+
+for US_ID in "${!US_TASKS_TOTAL[@]}"; do
+  TASKS_TOTAL=${US_TASKS_TOTAL["$US_ID"]:-0}
+  TASKS_DONE=${US_TASKS_DONE["$US_ID"]:-0}
+  ACS_TOTAL=${US_ACS_TOTAL["$US_ID"]:-0}
+  ACS_DONE=${US_ACS_DONE["$US_ID"]:-0}
+
+  # US is complete if ALL tasks done AND ALL ACs checked
+  CURRENT_COMPLETE="no"
+  if [[ $TASKS_TOTAL -gt 0 ]] && [[ $TASKS_DONE -eq $TASKS_TOTAL ]]; then
+    if [[ $ACS_TOTAL -gt 0 ]] && [[ $ACS_DONE -eq $ACS_TOTAL ]]; then
+      CURRENT_COMPLETE="yes"
+    elif [[ $ACS_TOTAL -eq 0 ]]; then
+      # No ACs defined, just check tasks
+      CURRENT_COMPLETE="yes"
+    fi
+  fi
+
+  PREV="${PREV_COMPLETE["$US_ID"]:-no}"
+
+  # Detect transitions
+  if [[ "$CURRENT_COMPLETE" == "yes" ]] && [[ "$PREV" == "no" ]]; then
+    # User story just completed
+    bash "$HOOK_DIR/queue/enqueue.sh" "user-story.completed" "$INC_ID:$US_ID" 2>/dev/null
+  elif [[ "$CURRENT_COMPLETE" == "no" ]] && [[ "$PREV" == "yes" ]]; then
+    # User story reopened
+    bash "$HOOK_DIR/queue/enqueue.sh" "user-story.reopened" "$INC_ID:$US_ID" 2>/dev/null
+  fi
+
+  NEW_STATE="${NEW_STATE}${US_ID}=${CURRENT_COMPLETE}\n"
+done
+
+# Save new state
+echo -e "$NEW_STATE" > "$US_STATE_FILE"
+
+exit 0

package/plugins/specweave/hooks/v2/dispatchers/post-tool-use.sh

@@ -1,7 +1,20 @@
 #!/bin/bash
 # post-tool-use.sh - Single dispatcher for ALL PostToolUse events
 # Replaces: post-task-edit, post-metadata-change, post-increment-planning, etc.
-# Goal: <10ms execution, queue heavy work for async processing
+#
+# Architecture (EDA v2):
+# - Detectors run synchronously (fast, detect state transitions)
+# - Detectors emit events to queue
+# - Handlers process events asynchronously from queue
+#
+# Event flow:
+# 1. metadata.json change -> lifecycle-detector -> increment.* events
+# 2. tasks.md/spec.md change -> us-completion-detector -> user-story.* events
+# 3. Events queued -> processor routes to handlers
+#
+# Goal: <10ms execution, all heavy work through event queue
+#
+# IMPORTANT: Never crash Claude, always exit 0
 set +e
 
 [[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
@@ -20,25 +33,54 @@ INPUT=$(cat)
 FILE_PATH=$(echo "$INPUT" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"\([^"]*\)".*/\1/')
 [[ -z "$FILE_PATH" ]] && exit 0
 
-# Detect event type based on file
-EVENT_TYPE=""
-case "$FILE_PATH" in
-  */.specweave/increments/*/tasks.md)   EVENT_TYPE="task.updated" ;;
-  */.specweave/increments/*/spec.md)    EVENT_TYPE="spec.updated" ;;
-  */.specweave/increments/*/metadata.json) EVENT_TYPE="metadata.changed" ;;
-  */.specweave/increments/*/plan.md)    EVENT_TYPE="plan.updated" ;;
-  *) exit 0 ;;  # Not a specweave file, ignore
-esac
-
-# Extract increment ID
+# Extract increment ID from path
 INC_ID=$(echo "$FILE_PATH" | grep -o '[0-9][0-9][0-9][0-9]-[^/]*' | head -1)
+[[ -z "$INC_ID" ]] && exit 0
 
 HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+DETECTOR_DIR="$HOOK_DIR/detectors"
+
+# ============================================================================
+# EDA DISPATCHER: Route to detectors based on file type
+# Detectors detect state transitions and emit events to queue
+# All heavy work is done by handlers processing the queue
+# ============================================================================
+
+case "$FILE_PATH" in
+  */.specweave/increments/*/metadata.json)
+    # Metadata changed -> check for lifecycle transitions
+    # Events: increment.created, increment.done, increment.archived, increment.reopened
+    bash "$DETECTOR_DIR/lifecycle-detector.sh" "$INC_ID" 2>/dev/null &
+    ;;
+
+  */.specweave/increments/*/tasks.md|*/.specweave/increments/*/spec.md)
+    # Tasks or spec changed -> check for US completion
+    # Events: user-story.completed, user-story.reopened
+    bash "$DETECTOR_DIR/us-completion-detector.sh" "$INC_ID" 2>/dev/null &
+
+    # Also queue legacy event for backward compatibility
+    if [[ "$FILE_PATH" == *tasks.md ]]; then
+      bash "$HOOK_DIR/queue/enqueue.sh" "task.updated" "$INC_ID" 2>/dev/null &
+    else
+      bash "$HOOK_DIR/queue/enqueue.sh" "spec.updated" "$INC_ID" 2>/dev/null &
+    fi
+    ;;
 
-# SYNCHRONOUS: Status update only (fast, always needed)
-bash "$HOOK_DIR/handlers/status-update.sh" "$INC_ID" 2>/dev/null &
+  */.specweave/increments/*/plan.md)
+    # Plan updated (for future use, currently no special handling)
+    bash "$HOOK_DIR/queue/enqueue.sh" "plan.updated" "$INC_ID" 2>/dev/null &
+    ;;
+
+  *)
+    # Not a specweave increment file, ignore
+    exit 0
+    ;;
+esac
 
-# ASYNC: Queue heavy operations for background processing
-bash "$HOOK_DIR/queue/enqueue.sh" "$EVENT_TYPE" "$INC_ID" 2>/dev/null
+# NOTE: Removed synchronous status-update.sh call
+# Status line updates are now EVENT-DRIVEN:
+# - Updated on user-story.completed/reopened events
+# - Updated on increment lifecycle events
+# - NOT updated on every file edit (reduces flickering, race conditions)
 
 exit 0

package/plugins/specweave/hooks/v2/handlers/ac-validation-handler.sh

@@ -2,8 +2,12 @@
 # ac-validation-handler.sh - Validate AC completion status
 # Checks that completed tasks have their ACs checked in spec.md
 # Non-blocking, logs warnings only
+#
+# IMPORTANT: Never crash Claude, always exit 0
 set +e
 
+[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
+
 INC_ID="${1:-}"
 [[ -z "$INC_ID" ]] && exit 0
 

package/plugins/specweave/hooks/v2/handlers/github-sync-handler.sh

@@ -1,8 +1,12 @@
 #!/bin/bash
 # github-sync-handler.sh - Sync increment status to GitHub issue
 # Called async by processor, non-blocking, error-tolerant
+#
+# IMPORTANT: Never crash Claude, always exit 0
 set +e
 
+[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
+
 INC_ID="${1:-}"
 [[ -z "$INC_ID" ]] && exit 0
 

package/plugins/specweave/hooks/v2/handlers/living-docs-handler.sh

@@ -1,8 +1,12 @@
 #!/bin/bash
 # living-docs-handler.sh - Sync increment to living docs
 # Called async by processor, non-blocking, error-tolerant
+#
+# IMPORTANT: Never crash Claude, always exit 0
 set +e
 
+[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
+
 INC_ID="${1:-}"
 [[ -z "$INC_ID" ]] && exit 0
 

package/plugins/specweave/hooks/v2/handlers/living-specs-handler.sh

@@ -0,0 +1,179 @@
+#!/bin/bash
+# living-specs-handler.sh - Update living SPECS on lifecycle events
+# Events: increment.created, increment.done, increment.archived, increment.reopened
+#
+# This handler updates the specs/ folder structure when increment lifecycle changes.
+# It is called by the event processor, NOT directly by post-tool-use.
+#
+# IMPORTANT: This script must be fast (<100ms) and never crash Claude
+set +e
+
+[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
+
+EVENT="${1:-}"
+INC_ID="${2:-}"
+
+[[ -z "$EVENT" ]] && exit 0
+[[ -z "$INC_ID" ]] && exit 0
+
+# Find project root
+PROJECT_ROOT="$PWD"
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+  PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
+done
+[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+
+# Throttle: max once per 60 seconds per increment
+STATE_DIR="$PROJECT_ROOT/.specweave/state"
+THROTTLE_FILE="$STATE_DIR/.living-specs-$INC_ID"
+mkdir -p "$STATE_DIR" 2>/dev/null
+
+if [[ -f "$THROTTLE_FILE" ]]; then
+  if [[ "$(uname)" == "Darwin" ]]; then
+    AGE=$(($(date +%s) - $(stat -f %m "$THROTTLE_FILE" 2>/dev/null || echo 0)))
+  else
+    AGE=$(($(date +%s) - $(stat -c %Y "$THROTTLE_FILE" 2>/dev/null || echo 0)))
+  fi
+  [[ $AGE -lt 60 ]] && exit 0
+fi
+touch "$THROTTLE_FILE"
+
+# Find the sync script
+SYNC_SCRIPT=""
+for path in \
+  "$PROJECT_ROOT/plugins/specweave/lib/hooks/sync-living-docs.js" \
+  "$PROJECT_ROOT/dist/plugins/specweave/lib/hooks/sync-living-docs.js" \
+  "${CLAUDE_PLUGIN_ROOT:-}/lib/hooks/sync-living-docs.js"; do
+  [[ -f "$path" ]] && { SYNC_SCRIPT="$path"; break; }
+done
+
+# Log event (silent, async)
+LOG_FILE="$PROJECT_ROOT/.specweave/logs/hooks.log"
+mkdir -p "$(dirname "$LOG_FILE")" 2>/dev/null
+echo "[$(date '+%Y-%m-%d %H:%M:%S')] living-specs-handler: $EVENT $INC_ID" >> "$LOG_FILE" 2>/dev/null
+
+# Get increment paths
+INC_DIR="$PROJECT_ROOT/.specweave/increments/$INC_ID"
+ARCHIVE_DIR="$PROJECT_ROOT/.specweave/increments/_archive/$INC_ID"
+SPEC_FILE="$INC_DIR/spec.md"
+ARCHIVE_SPEC="$ARCHIVE_DIR/spec.md"
+
+# Extract feature ID from spec.md (fast grep)
+get_feature_id() {
+  local spec="$1"
+  [[ -f "$spec" ]] && grep -E "^(epic|feature_id):" "$spec" 2>/dev/null | head -1 | sed 's/.*:[[:space:]]*//' | tr -d '"'"'"
+}
+
+case "$EVENT" in
+  increment.created)
+    # Create spec entry in living docs via Node.js script
+    if [[ -n "$SYNC_SCRIPT" ]] && [[ -f "$SPEC_FILE" ]]; then
+      FEATURE_ID=$(get_feature_id "$SPEC_FILE")
+      cd "$PROJECT_ROOT" || exit 0
+      if [[ -n "$FEATURE_ID" ]]; then
+        FEATURE_ID="$FEATURE_ID" timeout 30 node "$SYNC_SCRIPT" "$INC_ID" >/dev/null 2>&1 &
+      else
+        timeout 30 node "$SYNC_SCRIPT" "$INC_ID" >/dev/null 2>&1 &
+      fi
+    fi
+    ;;
+
+  increment.done)
+    # Update status to complete in living docs
+    if [[ -n "$SYNC_SCRIPT" ]] && [[ -f "$SPEC_FILE" ]]; then
+      FEATURE_ID=$(get_feature_id "$SPEC_FILE")
+      cd "$PROJECT_ROOT" || exit 0
+
+      # Mark as complete in FEATURE.md if it exists
+      if [[ -n "$FEATURE_ID" ]]; then
+        SPECS_DIR="$PROJECT_ROOT/.specweave/docs/internal/specs"
+        # Find FEATURE.md for this feature
+        FEATURE_FILE=$(find "$SPECS_DIR" -path "*/$FEATURE_ID/FEATURE.md" 2>/dev/null | head -1)
+
+        if [[ -f "$FEATURE_FILE" ]]; then
+          # Update status in FEATURE.md (in-progress -> complete)
+          sed -i.bak 's/status: in-progress/status: complete/g' "$FEATURE_FILE" 2>/dev/null
+          rm -f "${FEATURE_FILE}.bak" 2>/dev/null
+
+          # Update increment row status
+          sed -i.bak "s/\[$INC_ID\].*in-progress/[$INC_ID](..\/..\/..\/..\/increments\/$INC_ID\/spec.md) | complete/g" "$FEATURE_FILE" 2>/dev/null
+          rm -f "${FEATURE_FILE}.bak" 2>/dev/null
+        fi
+
+        # Also run full sync for completeness
+        FEATURE_ID="$FEATURE_ID" timeout 30 node "$SYNC_SCRIPT" "$INC_ID" >/dev/null 2>&1 &
+      else
+        timeout 30 node "$SYNC_SCRIPT" "$INC_ID" >/dev/null 2>&1 &
+      fi
+    fi
+    ;;
+
+  increment.archived)
+    # Move spec entry to _archive section in living docs
+    if [[ -f "$ARCHIVE_SPEC" ]]; then
+      FEATURE_ID=$(get_feature_id "$ARCHIVE_SPEC")
+
+      if [[ -n "$FEATURE_ID" ]]; then
+        SPECS_DIR="$PROJECT_ROOT/.specweave/docs/internal/specs"
+        ACTIVE_FEATURE=$(find "$SPECS_DIR" -path "*/$FEATURE_ID/FEATURE.md" -not -path "*/_archive/*" 2>/dev/null | head -1)
+        ARCHIVE_SPECS="$SPECS_DIR/specweave/_archive"
+
+        if [[ -f "$ACTIVE_FEATURE" ]]; then
+          # Check if all increments for this feature are archived
+          FEATURE_DIR=$(dirname "$ACTIVE_FEATURE")
+          ACTIVE_INC_COUNT=$(ls -1 "$FEATURE_DIR"/*.md 2>/dev/null | grep -v FEATURE.md | grep -v README.md | wc -l | tr -d ' ')
+
+          if [[ "$ACTIVE_INC_COUNT" -eq 0 ]]; then
+            # Move entire feature folder to archive
+            mkdir -p "$ARCHIVE_SPECS" 2>/dev/null
+            mv "$FEATURE_DIR" "$ARCHIVE_SPECS/" 2>/dev/null
+          else
+            # Just update status in FEATURE.md
+            sed -i.bak "s/\[$INC_ID\].*|.*$/[$INC_ID](..\/..\/..\/..\/increments\/_archive\/$INC_ID\/spec.md) | archived/g" "$ACTIVE_FEATURE" 2>/dev/null
+            rm -f "${ACTIVE_FEATURE}.bak" 2>/dev/null
+          fi
+        fi
+      fi
+    fi
+    ;;
+
+  increment.reopened)
+    # Restore from archive section in living docs
+    if [[ -f "$SPEC_FILE" ]]; then
+      FEATURE_ID=$(get_feature_id "$SPEC_FILE")
+
+      if [[ -n "$FEATURE_ID" ]]; then
+        SPECS_DIR="$PROJECT_ROOT/.specweave/docs/internal/specs"
+        ARCHIVE_FEATURE="$SPECS_DIR/specweave/_archive/$FEATURE_ID"
+        ACTIVE_SPECS="$SPECS_DIR/specweave"
+
+        # Check if feature was archived, restore it
+        if [[ -d "$ARCHIVE_FEATURE" ]]; then
+          mv "$ARCHIVE_FEATURE" "$ACTIVE_SPECS/" 2>/dev/null
+
+          # Update status back to in-progress
+          FEATURE_FILE="$ACTIVE_SPECS/$FEATURE_ID/FEATURE.md"
+          if [[ -f "$FEATURE_FILE" ]]; then
+            sed -i.bak 's/status: archived/status: in-progress/g' "$FEATURE_FILE" 2>/dev/null
+            sed -i.bak 's/status: complete/status: in-progress/g' "$FEATURE_FILE" 2>/dev/null
+            rm -f "${FEATURE_FILE}.bak" 2>/dev/null
+          fi
+        else
+          # Feature still exists, just update increment status
+          FEATURE_FILE=$(find "$SPECS_DIR" -path "*/$FEATURE_ID/FEATURE.md" -not -path "*/_archive/*" 2>/dev/null | head -1)
+          if [[ -f "$FEATURE_FILE" ]]; then
+            sed -i.bak "s/\[$INC_ID\].*archived/[$INC_ID](..\/..\/..\/..\/increments\/$INC_ID\/spec.md) | in-progress/g" "$FEATURE_FILE" 2>/dev/null
+            sed -i.bak "s/\[$INC_ID\].*complete/[$INC_ID](..\/..\/..\/..\/increments\/$INC_ID\/spec.md) | in-progress/g" "$FEATURE_FILE" 2>/dev/null
+            rm -f "${FEATURE_FILE}.bak" 2>/dev/null
+          fi
+        fi
+
+        # Run full sync to restore any missing content
+        cd "$PROJECT_ROOT" || exit 0
+        FEATURE_ID="$FEATURE_ID" timeout 30 node "$SYNC_SCRIPT" "$INC_ID" >/dev/null 2>&1 &
+      fi
+    fi
+    ;;
+esac
+
+exit 0

package/plugins/specweave/hooks/v2/handlers/status-line-handler.sh

@@ -0,0 +1,165 @@
+#!/bin/bash
+# status-line-handler.sh - Event-driven status line updates
+# Events: user-story.completed, user-story.reopened, increment.done, increment.archived, increment.reopened
+#
+# This handler updates the status line ONLY when meaningful events occur:
+# - User story completed (all ACs + tasks done for that US)
+# - User story reopened (US tasks/ACs unchecked)
+# - Increment lifecycle changes (done, archived, reopened)
+#
+# It does NOT update on every task.md edit - that would cause:
+# - Race conditions (multiple rapid updates)
+# - Performance issues (too frequent writes)
+# - Status line flickering
+#
+# IMPORTANT: This script must be fast (<20ms) and never crash Claude
+set +e
+
+[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
+
+EVENT="${1:-}"
+EVENT_DATA="${2:-}"
+
+[[ -z "$EVENT" ]] && exit 0
+[[ -z "$EVENT_DATA" ]] && exit 0
+
+# Find project root
+PROJECT_ROOT="$PWD"
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+  PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
+done
+[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+
+STATE_DIR="$PROJECT_ROOT/.specweave/state"
+CACHE_FILE="$STATE_DIR/status-line.json"
+mkdir -p "$STATE_DIR" 2>/dev/null
+
+# Log event (silent, async)
+LOG_FILE="$PROJECT_ROOT/.specweave/logs/hooks.log"
+mkdir -p "$(dirname "$LOG_FILE")" 2>/dev/null
+echo "[$(date '+%Y-%m-%d %H:%M:%S')] status-line-handler: $EVENT $EVENT_DATA" >> "$LOG_FILE" 2>/dev/null
+
+# Parse event data
+# Format: INC_ID:US_ID (for user-story events) or just INC_ID (for lifecycle events)
+if [[ "$EVENT_DATA" == *":"* ]]; then
+  INC_ID="${EVENT_DATA%%:*}"
+  US_ID="${EVENT_DATA##*:}"
+else
+  INC_ID="$EVENT_DATA"
+  US_ID=""
+fi
+
+# Handle events
+case "$EVENT" in
+  user-story.completed)
+    # User story completed - update status line with US progress
+    # This is the RIGHT time to update (not on every checkbox click)
+    ;;
+
+  user-story.reopened)
+    # User story reopened - update status line
+    ;;
+
+  increment.done)
+    # Increment completed - update status line to show completion
+    ;;
+
+  increment.archived)
+    # Increment archived - clear from status line, find next active
+    INC_ID=""  # Force finding a new active increment
+    ;;
+
+  increment.reopened)
+    # Increment reopened - show it as active again
+    ;;
+
+  *)
+    # Unknown event - ignore
+    exit 0
+    ;;
+esac
+
+# Find active increment if not determined or was archived
+if [[ -z "$INC_ID" ]] || [[ "$EVENT" == "increment.archived" ]]; then
+  INC_ID=""
+  for meta in "$PROJECT_ROOT/.specweave/increments"/[0-9]*/metadata.json; do
+    [[ -f "$meta" ]] || continue
+    STATUS=$(grep -o '"status"[[:space:]]*:[[:space:]]*"[^"]*"' "$meta" | grep -o '"[^"]*"$' | tr -d '"')
+    [[ "$STATUS" == "active" || "$STATUS" == "planning" ]] && {
+      INC_ID=$(basename "$(dirname "$meta")")
+      break
+    }
+  done
+fi
+
+# If no active increment, write null status
+if [[ -z "$INC_ID" ]]; then
+  cat > "$CACHE_FILE" << 'EOF'
+{"current":null,"event":"increment.archived","ts":"__TS__"}
+EOF
+  sed -i.bak "s/__TS__/$(date +%s)/" "$CACHE_FILE" 2>/dev/null
+  rm -f "${CACHE_FILE}.bak" 2>/dev/null
+  exit 0
+fi
+
+# Get increment paths
+TASKS_FILE="$PROJECT_ROOT/.specweave/increments/$INC_ID/tasks.md"
+SPEC_FILE="$PROJECT_ROOT/.specweave/increments/$INC_ID/spec.md"
+META_FILE="$PROJECT_ROOT/.specweave/increments/$INC_ID/metadata.json"
+
+# Check files exist
+[[ ! -f "$TASKS_FILE" ]] && exit 0
+
+# Count tasks (pure bash, fast)
+TOTAL=$(grep -c "^###\? T-" "$TASKS_FILE" 2>/dev/null || echo 0)
+DONE=$(grep -c "\[x\]" "$TASKS_FILE" 2>/dev/null || echo 0)
+PCT=0; [[ $TOTAL -gt 0 ]] && PCT=$((DONE * 100 / TOTAL))
+
+# Count user stories completed
+US_TOTAL=0
+US_DONE=0
+if [[ -f "$SPEC_FILE" ]]; then
+  # Count user story headers (## US-XXX or similar)
+  US_TOTAL=$(grep -c "^##.*US-" "$SPEC_FILE" 2>/dev/null || echo 0)
+
+  # Count by checking if all ACs for each US are checked
+  # This is a simplified count - the actual detection is done by us-completion-detector.sh
+  US_STATE_FILE="$STATE_DIR/.us-completion-$INC_ID"
+  if [[ -f "$US_STATE_FILE" ]]; then
+    US_DONE=$(grep -c "=yes$" "$US_STATE_FILE" 2>/dev/null || echo 0)
+  fi
+fi
+
+# Get increment status
+INC_STATUS="active"
+if [[ -f "$META_FILE" ]]; then
+  INC_STATUS=$(grep -o '"status"[[:space:]]*:[[:space:]]*"[^"]*"' "$META_FILE" | grep -o '"[^"]*"$' | tr -d '"')
+fi
+
+# Build detailed status JSON with event info
+TMP_FILE="$CACHE_FILE.tmp.$$"
+cat > "$TMP_FILE" << EOF
+{
+  "current": {
+    "id": "$INC_ID",
+    "completed": $DONE,
+    "total": $TOTAL,
+    "percentage": $PCT,
+    "status": "$INC_STATUS",
+    "userStories": {
+      "completed": $US_DONE,
+      "total": $US_TOTAL
+    }
+  },
+  "lastEvent": {
+    "type": "$EVENT",
+    "data": "$EVENT_DATA"
+  },
+  "ts": "$(date +%s)"
+}
+EOF
+
+# Atomic write (mv is atomic on same filesystem)
+mv "$TMP_FILE" "$CACHE_FILE" 2>/dev/null
+
+exit 0

package/plugins/specweave/hooks/v2/handlers/status-update.sh

@@ -1,8 +1,15 @@
 #!/bin/bash
 # status-update.sh - Fast status line update (synchronous)
 # Goal: <20ms execution, pure bash, no external processes
+#
+# NOTE: This is the LEGACY handler. New EDA architecture uses
+# status-line-handler.sh which is EVENT-DRIVEN.
+#
+# IMPORTANT: Never crash Claude, always exit 0
 set +e
 
+[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
+
 INC_ID="${1:-}"
 
 # Find project root

package/plugins/specweave/hooks/v2/queue/dequeue.sh

@@ -2,8 +2,12 @@
 # dequeue.sh - Get and remove next event from queue
 # Usage: dequeue.sh [--peek]
 # Returns JSON event or empty if queue is empty
+#
+# IMPORTANT: Never crash Claude, always exit 0
 set +e
 
+[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
+
 PEEK=false
 [[ "$1" == "--peek" ]] && PEEK=true
 

package/plugins/specweave/hooks/v2/queue/enqueue.sh

@@ -1,9 +1,15 @@
 #!/bin/bash
-# enqueue.sh - Add event to queue with deduplication
+# enqueue.sh - Add event to queue with deduplication and coalescing
 # Usage: enqueue.sh <event_type> <event_data>
-# Events are deduplicated by type+data hash within 5 second window
+#
+# Events are coalesced (deduplicated) by type+data hash within 10 second window.
+# Events have priorities: lifecycle=1 (highest), user-story=2, other=3 (lowest)
+#
+# IMPORTANT: This script must be fast (<5ms) and never crash
 set +e
 
+[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
+
 EVENT_TYPE="${1:-unknown}"
 EVENT_DATA="${2:-}"
 
@@ -17,25 +23,57 @@ done
 QUEUE_DIR="$PROJECT_ROOT/.specweave/state/event-queue"
 mkdir -p "$QUEUE_DIR" 2>/dev/null || exit 0
 
-# Deduplication: hash event type + data
-HASH=$(echo "${EVENT_TYPE}:${EVENT_DATA}" | md5 | cut -c1-8)
+# Assign event priority
+# Priority 1: Lifecycle events (most important)
+# Priority 2: User story events
+# Priority 3: Other events
+PRIORITY=3
+case "$EVENT_TYPE" in
+  increment.created|increment.done|increment.archived|increment.reopened)
+    PRIORITY=1
+    ;;
+  user-story.completed|user-story.reopened)
+    PRIORITY=2
+    ;;
+esac
+
+# Coalescing: hash event type + data for deduplication
+# Cross-platform md5 (works on macOS and Linux)
+if command -v md5 >/dev/null 2>&1; then
+  HASH=$(echo "${EVENT_TYPE}:${EVENT_DATA}" | md5 | cut -c1-8)
+elif command -v md5sum >/dev/null 2>&1; then
+  HASH=$(echo "${EVENT_TYPE}:${EVENT_DATA}" | md5sum | cut -c1-8)
+else
+  # Fallback: simple hash from type and data
+  HASH=$(printf "%s" "${EVENT_TYPE}:${EVENT_DATA}" | cksum | cut -d' ' -f1)
+fi
+
 DEDUP_FILE="$QUEUE_DIR/.dedup-$HASH"
-DEDUP_TTL=5
+DEDUP_TTL=10  # Increased from 5s to 10s for better coalescing
 
-# Check if duplicate (within TTL)
+# Coalescing check: skip if same event within TTL
 if [[ -f "$DEDUP_FILE" ]]; then
-  AGE=$(($(date +%s) - $(stat -f %m "$DEDUP_FILE" 2>/dev/null || echo 0)))
+  if [[ "$(uname)" == "Darwin" ]]; then
+    AGE=$(($(date +%s) - $(stat -f %m "$DEDUP_FILE" 2>/dev/null || echo 0)))
+  else
+    AGE=$(($(date +%s) - $(stat -c %Y "$DEDUP_FILE" 2>/dev/null || echo 0)))
+  fi
   [[ $AGE -lt $DEDUP_TTL ]] && exit 0
 fi
 touch "$DEDUP_FILE"
 
 # Enqueue event (atomic write)
-TIMESTAMP=$(date +%s%N)
-EVENT_FILE="$QUEUE_DIR/${TIMESTAMP}-${EVENT_TYPE}.event"
-cat > "$EVENT_FILE" << EOF
-{"type":"$EVENT_TYPE","data":"$EVENT_DATA","ts":"$(date -u +%Y-%m-%dT%H:%M:%SZ)"}
+# Filename includes priority for priority-ordered processing
+TIMESTAMP=$(date +%s%N 2>/dev/null || date +%s)
+EVENT_FILE="$QUEUE_DIR/${PRIORITY}-${TIMESTAMP}-${EVENT_TYPE}.event"
+
+# Create event file atomically
+TMP_FILE="$EVENT_FILE.tmp.$$"
+cat > "$TMP_FILE" << EOF
+{"type":"$EVENT_TYPE","data":"$EVENT_DATA","priority":$PRIORITY,"ts":"$(date -u +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date +%Y-%m-%dT%H:%M:%SZ)"}
 EOF
+mv "$TMP_FILE" "$EVENT_FILE" 2>/dev/null
 
-# Cleanup old dedup files (>30s)
+# Cleanup old dedup files (>30s) - non-blocking
 find "$QUEUE_DIR" -name ".dedup-*" -mmin +1 -delete 2>/dev/null &
 exit 0

package/plugins/specweave/hooks/v2/queue/processor.sh

@@ -1,10 +1,21 @@
 #!/bin/bash
-# processor.sh - Background event processor
-# Processes queued events asynchronously, routes to handlers
+# processor.sh - Background event processor with EDA routing
+# Processes queued events asynchronously, routes to specialized handlers
+#
 # Usage: processor.sh [--daemon]
-# Self-terminates after 30s of idle
+#
+# Event routing:
+# - increment.created/done/archived/reopened -> living-specs-handler
+# - user-story.completed/reopened -> status-line-handler
+# - task.updated/spec.updated -> living-docs-handler (legacy)
+#
+# Self-terminates after 60s of idle
+#
+# IMPORTANT: This script uses flock for safe concurrent access
 set +e
 
+[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
+
 DAEMON_MODE=false
 [[ "$1" == "--daemon" ]] && DAEMON_MODE=true
 
@@ -19,23 +30,44 @@ QUEUE_DIR="$PROJECT_ROOT/.specweave/state/event-queue"
 HANDLER_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../handlers" && pwd)"
 LOG_FILE="$PROJECT_ROOT/.specweave/logs/processor.log"
 PID_FILE="$PROJECT_ROOT/.specweave/state/.processor.pid"
-IDLE_TIMEOUT=30
+LOCK_FILE="$PROJECT_ROOT/.specweave/state/.processor.lock"
+IDLE_TIMEOUT=60  # Increased from 30s to 60s
 IDLE_COUNT=0
+HANDLER_TIMEOUT=30  # Max time per handler call
 
 mkdir -p "$(dirname "$LOG_FILE")" 2>/dev/null
+mkdir -p "$QUEUE_DIR" 2>/dev/null
+
+# Acquire exclusive lock using flock
+exec 200>"$LOCK_FILE"
+if ! flock -n 200 2>/dev/null; then
+  # Another processor is running - exit silently
+  exit 0
+fi
 
-# Check if already running
+# Double-check PID file for extra safety
 if [[ -f "$PID_FILE" ]]; then
   OLD_PID=$(cat "$PID_FILE" 2>/dev/null)
-  if kill -0 "$OLD_PID" 2>/dev/null; then
+  if [[ -n "$OLD_PID" ]] && kill -0 "$OLD_PID" 2>/dev/null; then
     exit 0  # Already running
   fi
 fi
 echo $$ > "$PID_FILE"
-trap 'rm -f "$PID_FILE"' EXIT
+trap 'rm -f "$PID_FILE"; flock -u 200 2>/dev/null' EXIT
 
 log() { echo "[$(date +%H:%M:%S)] $1" >> "$LOG_FILE" 2>/dev/null; }
-log "Processor started (PID: $$)"
+log "Processor started (PID: $$, IDLE_TIMEOUT: ${IDLE_TIMEOUT}s)"
+
+# Run handler with timeout (prevents stuck handlers from blocking queue)
+run_handler() {
+  local handler="$1"
+  local event_type="$2"
+  local event_data="$3"
+
+  if [[ -x "$handler" ]]; then
+    timeout "$HANDLER_TIMEOUT" bash "$handler" "$event_type" "$event_data" 2>/dev/null || true
+  fi
+}
 
 process_event() {
   local EVENT_JSON="$1"
@@ -45,12 +77,38 @@ process_event() {
   log "Processing: $EVENT_TYPE ($EVENT_DATA)"
 
   case "$EVENT_TYPE" in
+    # ========================================
+    # EDA Event Routing (new architecture)
+    # ========================================
+
+    # Lifecycle events -> living-specs-handler
+    increment.created|increment.done|increment.archived|increment.reopened)
+      run_handler "$HANDLER_DIR/living-specs-handler.sh" "$EVENT_TYPE" "$EVENT_DATA"
+      # Also update status line on lifecycle changes
+      run_handler "$HANDLER_DIR/status-line-handler.sh" "$EVENT_TYPE" "$EVENT_DATA"
+      ;;
+
+    # User story events -> status-line-handler
+    user-story.completed|user-story.reopened)
+      run_handler "$HANDLER_DIR/status-line-handler.sh" "$EVENT_TYPE" "$EVENT_DATA"
+      ;;
+
+    # ========================================
+    # Legacy event routing (backward compat)
+    # ========================================
     task.updated|spec.updated)
-      bash "$HANDLER_DIR/living-docs-handler.sh" "$EVENT_DATA" 2>/dev/null
-      bash "$HANDLER_DIR/ac-validation-handler.sh" "$EVENT_DATA" 2>/dev/null
+      # Legacy: don't update status line on every task edit
+      # That causes race conditions and flickering
+      run_handler "$HANDLER_DIR/living-docs-handler.sh" "" "$EVENT_DATA"
+      run_handler "$HANDLER_DIR/ac-validation-handler.sh" "" "$EVENT_DATA"
       ;;
+
     metadata.changed)
-      bash "$HANDLER_DIR/github-sync-handler.sh" "$EVENT_DATA" 2>/dev/null
+      run_handler "$HANDLER_DIR/github-sync-handler.sh" "" "$EVENT_DATA"
+      ;;
+
+    *)
+      log "Unknown event type: $EVENT_TYPE"
       ;;
   esac
 }
@@ -64,9 +122,13 @@ while true; do
     process_event "$EVENT"
   else
     IDLE_COUNT=$((IDLE_COUNT + 1))
-    [[ $IDLE_COUNT -ge $IDLE_TIMEOUT ]] && { log "Idle timeout, exiting"; exit 0; }
+    if [[ $IDLE_COUNT -ge $IDLE_TIMEOUT ]]; then
+      log "Idle timeout (${IDLE_TIMEOUT}s), exiting"
+      exit 0
+    fi
     sleep 1
   fi
 
+  # In non-daemon mode, exit after 3s of idle (quick processing)
   [[ "$DAEMON_MODE" == "false" ]] && [[ $IDLE_COUNT -ge 3 ]] && exit 0
 done