specweave 0.28.36 → 0.28.42

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";
     }