specweave 0.28.36 → 0.28.45

package/plugins/specweave/hooks/user-prompt-submit.sh

@@ -76,27 +76,46 @@ if [[ -d "$SPECWEAVE_DIR/increments" ]]; then
 fi
 
 # ==============================================================================
-# DISCIPLINE VALIDATION: Block /specweave:increment if incomplete increments exist
+# DISCIPLINE VALIDATION: Warn about WIP limits (configurable, not hard block!)
 # ==============================================================================
 
 if echo "$PROMPT" | grep -q "/specweave:increment"; then
-  # Hard cap: never >2 active
-  if [[ "$ACTIVE_COUNT" -ge 2 ]]; then
+  # Read limits from config.json (respect user's settings!)
+  CONFIG_FILE="$SPECWEAVE_DIR/config.json"
+  SOFT_LIMIT=1
+  HARD_CAP=3
+
+  if [[ -f "$CONFIG_FILE" ]]; then
+    if command -v jq >/dev/null 2>&1; then
+      SOFT_LIMIT=$(jq -r '.limits.maxActiveIncrements // 1' "$CONFIG_FILE" 2>/dev/null || echo "1")
+      HARD_CAP=$(jq -r '.limits.hardCap // 3' "$CONFIG_FILE" 2>/dev/null || echo "3")
+    else
+      SOFT_LIMIT=$(grep -oP '"maxActiveIncrements"\s*:\s*\K[0-9]+' "$CONFIG_FILE" 2>/dev/null || echo "1")
+      HARD_CAP=$(grep -oP '"hardCap"\s*:\s*\K[0-9]+' "$CONFIG_FILE" 2>/dev/null || echo "3")
+    fi
+  fi
+
+  # Ensure valid numbers
+  [[ ! "$SOFT_LIMIT" =~ ^[0-9]+$ ]] && SOFT_LIMIT=1
+  [[ ! "$HARD_CAP" =~ ^[0-9]+$ ]] && HARD_CAP=3
+
+  # Above hard cap: strong warning but NOT a block (user decides!)
+  if [[ "$ACTIVE_COUNT" -ge "$HARD_CAP" ]]; then
     cat <<EOF
 {
-  "decision": "block",
-  "reason": "❌ HARD CAP REACHED\n\nYou have $ACTIVE_COUNT active increments (absolute maximum: 2)\n\nActive increments:\n$ACTIVE_LIST\n\n💡 You MUST complete or pause existing work first:\n\n1️⃣  Complete an increment:\n   /specweave:done <id>\n\n2️⃣  Pause an increment:\n   /specweave:pause <id> --reason=\"...\"\n\n3️⃣  Check status:\n   /specweave:status\n\n📝 Multiple hotfixes? Combine them into ONE increment!\n   Example: 0009-security-fixes (SQL + XSS + CSRF)\n\n⛔ This limit is enforced for your productivity.\nResearch: 3+ concurrent tasks = 40% slower + more bugs"
+  "decision": "approve",
+  "systemMessage": "⚠️  WIP LIMIT EXCEEDED (${ACTIVE_COUNT}/${HARD_CAP})\n\nYou have $ACTIVE_COUNT active increments (configured maximum: $HARD_CAP)\n\nActive increments:\n$ACTIVE_LIST\n\n🧠 Research shows 3+ concurrent tasks = 40% slower + more bugs\n\n💡 Options:\n  1️⃣  Complete an increment: /specweave:done <id>\n  2️⃣  Pause an increment: /specweave:pause <id>\n  3️⃣  Increase limit: Edit .specweave/config.json limits.hardCap\n  4️⃣  Continue anyway (not recommended)\n\n📝 To proceed anyway, just confirm your intent."
 }
 EOF
     exit 0
   fi
 
-  # Soft warning: 1 active (recommended limit)
-  if [[ "$ACTIVE_COUNT" -ge 1 ]]; then
+  # At soft limit: mild warning, approve
+  if [[ "$ACTIVE_COUNT" -ge "$SOFT_LIMIT" ]]; then
     cat <<EOF
 {
   "decision": "approve",
-  "systemMessage": "⚠️  WIP LIMIT REACHED\n\nYou have $ACTIVE_COUNT active increment (recommended limit: 1)\n\nActive increments:\n$ACTIVE_LIST\n\n🧠 Focus Principle: ONE active increment = maximum productivity\nStarting a 2nd increment reduces focus and velocity.\n\n💡 Consider:\n  1️⃣  Complete current work (recommended)\n  2️⃣  Pause current work (/specweave:pause)\n  3️⃣  Continue anyway (accept 20% productivity cost)\n\n⚠️  Emergency hotfix/bug? Use --type=hotfix or --type=bug to bypass this warning."
+  "systemMessage": "⚠️  WIP LIMIT REACHED (${ACTIVE_COUNT}/${SOFT_LIMIT})\n\nYou have $ACTIVE_COUNT active increment(s) (recommended limit: $SOFT_LIMIT)\n\nActive increments:\n$ACTIVE_LIST\n\n🧠 Focus Principle: Fewer active increments = maximum productivity\n\n💡 Consider:\n  1️⃣  Complete current work (recommended)\n  2️⃣  Pause current work (/specweave:pause)\n  3️⃣  Continue anyway\n\n⚠️  Emergency hotfix/bug? Use --type=hotfix or --type=bug"
 }
 EOF
     exit 0

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

@@ -0,0 +1,44 @@
+#!/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
+set +e
+
+[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && 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
+
+# Read stdin (tool result JSON)
+INPUT=$(cat)
+
+# Extract file path (fast grep, no jq)
+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
+INC_ID=$(echo "$FILE_PATH" | grep -o '[0-9][0-9][0-9][0-9]-[^/]*' | head -1)
+
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+# SYNCHRONOUS: Status update only (fast, always needed)
+bash "$HOOK_DIR/handlers/status-update.sh" "$INC_ID" 2>/dev/null &
+
+# ASYNC: Queue heavy operations for background processing
+bash "$HOOK_DIR/queue/enqueue.sh" "$EVENT_TYPE" "$INC_ID" 2>/dev/null
+
+exit 0

package/plugins/specweave/hooks/v2/dispatchers/session-start.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+# session-start.sh - Launch background processor on session start
+# Ultra-fast, non-blocking
+set +e
+
+[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && 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
+
+# Consume stdin
+cat > /dev/null
+
+PROCESSOR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../queue" && pwd)/processor.sh"
+[[ ! -f "$PROCESSOR" ]] && exit 0
+
+# Launch processor in background (daemon mode)
+nohup bash "$PROCESSOR" --daemon > /dev/null 2>&1 &
+disown 2>/dev/null
+exit 0

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

@@ -0,0 +1,46 @@
+#!/bin/bash
+# ac-validation-handler.sh - Validate AC completion status
+# Checks that completed tasks have their ACs checked in spec.md
+# Non-blocking, logs warnings only
+set +e
+
+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
+
+INC_DIR="$PROJECT_ROOT/.specweave/increments/$INC_ID"
+TASKS_FILE="$INC_DIR/tasks.md"
+SPEC_FILE="$INC_DIR/spec.md"
+LOG_FILE="$PROJECT_ROOT/.specweave/logs/ac-validation.log"
+
+[[ ! -f "$TASKS_FILE" ]] || [[ ! -f "$SPEC_FILE" ]] && exit 0
+
+mkdir -p "$(dirname "$LOG_FILE")" 2>/dev/null
+
+# Find completed tasks and their ACs
+WARNINGS=""
+while IFS= read -r line; do
+  if [[ "$line" =~ ^\*\*Satisfies\ ACs\*\*:\ (.+)$ ]]; then
+    ACS="${BASH_REMATCH[1]}"
+    # Check each AC
+    for ac in $(echo "$ACS" | tr ',' ' '); do
+      ac=$(echo "$ac" | tr -d ' ')
+      [[ -z "$ac" ]] && continue
+      # Check if AC is checked in spec.md
+      if ! grep -qE "^\s*-\s*\[x\]\s*\*\*${ac}\*\*" "$SPEC_FILE" 2>/dev/null; then
+        WARNINGS="$WARNINGS\n  - $ac not checked in spec.md"
+      fi
+    done
+  fi
+done < <(grep -A5 "\[x\] completed" "$TASKS_FILE" 2>/dev/null | grep "Satisfies ACs")
+
+if [[ -n "$WARNINGS" ]]; then
+  echo "[$(date)] $INC_ID: AC validation warnings:$WARNINGS" >> "$LOG_FILE"
+fi
+exit 0

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

@@ -0,0 +1,54 @@
+#!/bin/bash
+# github-sync-handler.sh - Sync increment status to GitHub issue
+# Called async by processor, non-blocking, error-tolerant
+set +e
+
+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
+
+CONFIG_FILE="$PROJECT_ROOT/.specweave/config.json"
+[[ ! -f "$CONFIG_FILE" ]] && exit 0
+
+# Check if GitHub sync is enabled
+GITHUB_ENABLED=$(grep -o '"enabled"[[:space:]]*:[[:space:]]*true' "$CONFIG_FILE" | head -1)
+[[ -z "$GITHUB_ENABLED" ]] && exit 0
+
+# Throttle: max once per 5 minutes per increment
+THROTTLE_FILE="$PROJECT_ROOT/.specweave/state/.github-sync-$INC_ID"
+if [[ -f "$THROTTLE_FILE" ]]; then
+  AGE=$(($(date +%s) - $(stat -f %m "$THROTTLE_FILE" 2>/dev/null || echo 0)))
+  [[ $AGE -lt 300 ]] && exit 0
+fi
+touch "$THROTTLE_FILE"
+
+# Load GitHub token
+GITHUB_TOKEN=""
+[[ -f "$PROJECT_ROOT/.env" ]] && GITHUB_TOKEN=$(grep -E "^GITHUB_TOKEN=" "$PROJECT_ROOT/.env" | cut -d'=' -f2- | tr -d '"'"'")
+[[ -z "$GITHUB_TOKEN" ]] && exit 0
+
+# Find sync script
+SYNC_SCRIPT=""
+for path in \
+  "$PROJECT_ROOT/dist/plugins/specweave-github/lib/github-feature-sync-cli.js" \
+  "${CLAUDE_PLUGIN_ROOT:-/specweave-github}/lib/github-feature-sync-cli.js"; do
+  [[ -f "$path" ]] && { SYNC_SCRIPT="$path"; break; }
+done
+[[ -z "$SYNC_SCRIPT" ]] && exit 0
+
+# Extract feature ID
+SPEC_FILE="$PROJECT_ROOT/.specweave/increments/$INC_ID/spec.md"
+FEATURE_ID=""
+[[ -f "$SPEC_FILE" ]] && FEATURE_ID=$(grep -E "^(epic|feature_id):" "$SPEC_FILE" | head -1 | sed 's/.*:[[:space:]]*//' | tr -d '"'"'")
+[[ -z "$FEATURE_ID" ]] && exit 0
+
+# Run sync (timeout 60s)
+cd "$PROJECT_ROOT" || exit 0
+GITHUB_TOKEN="$GITHUB_TOKEN" timeout 60 node "$SYNC_SCRIPT" "$FEATURE_ID" >/dev/null 2>&1
+exit 0

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

@@ -0,0 +1,46 @@
+#!/bin/bash
+# living-docs-handler.sh - Sync increment to living docs
+# Called async by processor, non-blocking, error-tolerant
+set +e
+
+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
+
+# Throttle: max once per minute per increment
+THROTTLE_FILE="$PROJECT_ROOT/.specweave/state/.living-docs-$INC_ID"
+if [[ -f "$THROTTLE_FILE" ]]; then
+  AGE=$(($(date +%s) - $(stat -f %m "$THROTTLE_FILE" 2>/dev/null || echo 0)))
+  [[ $AGE -lt 60 ]] && exit 0
+fi
+touch "$THROTTLE_FILE"
+
+# Find 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
+[[ -z "$SYNC_SCRIPT" ]] && exit 0
+
+# Extract feature ID from spec.md
+SPEC_FILE="$PROJECT_ROOT/.specweave/increments/$INC_ID/spec.md"
+FEATURE_ID=""
+[[ -f "$SPEC_FILE" ]] && FEATURE_ID=$(grep -E "^(epic|feature_id):" "$SPEC_FILE" | head -1 | sed 's/.*:[[:space:]]*//' | tr -d '"'"'")
+
+# Run sync (timeout 30s)
+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
+exit 0

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

@@ -0,0 +1,50 @@
+#!/bin/bash
+# status-update.sh - Fast status line update (synchronous)
+# Goal: <20ms execution, pure bash, no external processes
+set +e
+
+INC_ID="${1:-}"
+
+# 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
+
+# TTL check (10 seconds)
+if [[ -f "$CACHE_FILE" ]]; then
+  CACHE_AGE=$(($(date +%s) - $(stat -f %m "$CACHE_FILE" 2>/dev/null || echo 0)))
+  [[ $CACHE_AGE -lt 10 ]] && exit 0
+fi
+
+# Find active increment if not provided
+if [[ -z "$INC_ID" ]]; then
+  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
+[[ -z "$INC_ID" ]] && { echo '{"current":null}' > "$CACHE_FILE"; exit 0; }
+
+TASKS_FILE="$PROJECT_ROOT/.specweave/increments/$INC_ID/tasks.md"
+[[ ! -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))
+
+# Write cache (atomic)
+cat > "$CACHE_FILE" << EOF
+{"current":{"id":"$INC_ID","completed":$DONE,"total":$TOTAL,"percentage":$PCT},"ts":"$(date +%s)"}
+EOF
+exit 0

package/plugins/specweave/hooks/v2/hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "matcher_content": "\\.specweave/increments/",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/v2/dispatchers/post-tool-use.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

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

@@ -0,0 +1,30 @@
+#!/bin/bash
+# dequeue.sh - Get and remove next event from queue
+# Usage: dequeue.sh [--peek]
+# Returns JSON event or empty if queue is empty
+set +e
+
+PEEK=false
+[[ "$1" == "--peek" ]] && PEEK=true
+
+# 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
+
+QUEUE_DIR="$PROJECT_ROOT/.specweave/state/event-queue"
+[[ ! -d "$QUEUE_DIR" ]] && exit 0
+
+# Get oldest event file (FIFO)
+OLDEST=$(ls -1 "$QUEUE_DIR"/*.event 2>/dev/null | head -1)
+[[ -z "$OLDEST" ]] && exit 0
+
+# Output event content
+cat "$OLDEST" 2>/dev/null
+
+# Remove if not peeking
+[[ "$PEEK" == "false" ]] && rm -f "$OLDEST" 2>/dev/null
+
+exit 0

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

@@ -0,0 +1,41 @@
+#!/bin/bash
+# enqueue.sh - Add event to queue with deduplication
+# Usage: enqueue.sh <event_type> <event_data>
+# Events are deduplicated by type+data hash within 5 second window
+set +e
+
+EVENT_TYPE="${1:-unknown}"
+EVENT_DATA="${2:-}"
+
+# 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
+
+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)
+DEDUP_FILE="$QUEUE_DIR/.dedup-$HASH"
+DEDUP_TTL=5
+
+# Check if duplicate (within TTL)
+if [[ -f "$DEDUP_FILE" ]]; then
+  AGE=$(($(date +%s) - $(stat -f %m "$DEDUP_FILE" 2>/dev/null || echo 0)))
+  [[ $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)"}
+EOF
+
+# Cleanup old dedup files (>30s)
+find "$QUEUE_DIR" -name ".dedup-*" -mmin +1 -delete 2>/dev/null &
+exit 0

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

@@ -0,0 +1,72 @@
+#!/bin/bash
+# processor.sh - Background event processor
+# Processes queued events asynchronously, routes to handlers
+# Usage: processor.sh [--daemon]
+# Self-terminates after 30s of idle
+set +e
+
+DAEMON_MODE=false
+[[ "$1" == "--daemon" ]] && DAEMON_MODE=true
+
+# 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
+
+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
+IDLE_COUNT=0
+
+mkdir -p "$(dirname "$LOG_FILE")" 2>/dev/null
+
+# Check if already running
+if [[ -f "$PID_FILE" ]]; then
+  OLD_PID=$(cat "$PID_FILE" 2>/dev/null)
+  if kill -0 "$OLD_PID" 2>/dev/null; then
+    exit 0  # Already running
+  fi
+fi
+echo $$ > "$PID_FILE"
+trap 'rm -f "$PID_FILE"' EXIT
+
+log() { echo "[$(date +%H:%M:%S)] $1" >> "$LOG_FILE" 2>/dev/null; }
+log "Processor started (PID: $$)"
+
+process_event() {
+  local EVENT_JSON="$1"
+  local EVENT_TYPE=$(echo "$EVENT_JSON" | grep -o '"type":"[^"]*"' | cut -d'"' -f4)
+  local EVENT_DATA=$(echo "$EVENT_JSON" | grep -o '"data":"[^"]*"' | cut -d'"' -f4)
+
+  log "Processing: $EVENT_TYPE ($EVENT_DATA)"
+
+  case "$EVENT_TYPE" in
+    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
+      ;;
+    metadata.changed)
+      bash "$HANDLER_DIR/github-sync-handler.sh" "$EVENT_DATA" 2>/dev/null
+      ;;
+  esac
+}
+
+# Main loop
+while true; do
+  EVENT=$(bash "$(dirname "${BASH_SOURCE[0]}")/dequeue.sh" 2>/dev/null)
+
+  if [[ -n "$EVENT" ]]; then
+    IDLE_COUNT=0
+    process_event "$EVENT"
+  else
+    IDLE_COUNT=$((IDLE_COUNT + 1))
+    [[ $IDLE_COUNT -ge $IDLE_TIMEOUT ]] && { log "Idle timeout, exiting"; exit 0; }
+    sleep 1
+  fi
+
+  [[ "$DAEMON_MODE" == "false" ]] && [[ $IDLE_COUNT -ge 3 ]] && exit 0
+done

package/plugins/specweave-ado/lib/ado-multi-project-sync.js

@@ -373,7 +373,6 @@ ${userStory.technicalContext}
         return mapping.task || "Task";
       case "Subtask":
         return mapping.task || "Task";
-      // ADO doesn't have subtasks, use Task
       default:
         return "User Story";
     }