specweave 0.17.0 → 0.17.2

package/plugins/specweave/hooks/lib/sync-spec-content.sh

@@ -0,0 +1,149 @@
+#!/bin/bash
+#
+# Sync Spec Content to External Tools
+#
+# This script automatically syncs spec CONTENT (title, description, user stories)
+# to external tools (GitHub Issues, JIRA Epics, Azure DevOps Features).
+#
+# CRITICAL: This does NOT sync STATUS - that's managed by external tools.
+#
+# Sync Direction:
+# - Title/Description/User Stories: SpecWeave → External Tool (we update)
+# - Status/State: External Tool → SpecWeave (we read)
+#
+# Usage:
+#   sync-spec-content.sh <spec-path>
+#
+
+set -euo pipefail
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../../../.." && pwd)"
+
+# Input validation
+if [ $# -lt 1 ]; then
+  echo "Usage: $0 <spec-path>" >&2
+  exit 1
+fi
+
+SPEC_PATH="$1"
+
+# Validate spec file exists
+if [ ! -f "$SPEC_PATH" ]; then
+  echo "❌ Spec file not found: $SPEC_PATH" >&2
+  exit 1
+fi
+
+# Check if sync is enabled
+CONFIG_FILE="$PROJECT_ROOT/.specweave/config.json"
+if [ ! -f "$CONFIG_FILE" ]; then
+  echo "ℹ️  No config file found, skipping spec content sync" >&2
+  exit 0
+fi
+
+# Check if sync is enabled in config
+SYNC_ENABLED=$(node -p "
+  try {
+    const config = require('$CONFIG_FILE');
+    config.sync?.enabled ?? false;
+  } catch {
+    false;
+  }
+" 2>/dev/null || echo "false")
+
+if [ "$SYNC_ENABLED" != "true" ]; then
+  echo "ℹ️  Sync disabled in config, skipping spec content sync" >&2
+  exit 0
+fi
+
+# Check if spec content sync is enabled
+SPEC_SYNC_ENABLED=$(node -p "
+  try {
+    const config = require('$CONFIG_FILE');
+    config.sync?.settings?.syncSpecContent ?? true;
+  } catch {
+    true;
+  }
+" 2>/dev/null || echo "true")
+
+if [ "$SPEC_SYNC_ENABLED" != "true" ]; then
+  echo "ℹ️  Spec content sync disabled in config" >&2
+  exit 0
+fi
+
+# Get active provider
+ACTIVE_PROFILE=$(node -p "
+  try {
+    const config = require('$CONFIG_FILE');
+    config.sync?.activeProfile ?? null;
+  } catch {
+    null;
+  }
+" 2>/dev/null || echo "null")
+
+if [ "$ACTIVE_PROFILE" = "null" ]; then
+  echo "ℹ️  No active sync profile, skipping spec content sync" >&2
+  exit 0
+fi
+
+# Get provider from active profile
+PROVIDER=$(node -p "
+  try {
+    const config = require('$CONFIG_FILE');
+    config.sync?.profiles?.['"$ACTIVE_PROFILE"']?.provider ?? null;
+  } catch {
+    null;
+  }
+" 2>/dev/null || echo "null")
+
+if [ "$PROVIDER" = "null" ]; then
+  echo "ℹ️  No provider configured for profile '$ACTIVE_PROFILE'" >&2
+  exit 0
+fi
+
+# Validate provider
+if [[ ! "$PROVIDER" =~ ^(github|jira|ado)$ ]]; then
+  echo "❌ Invalid provider: $PROVIDER (must be github, jira, or ado)" >&2
+  exit 1
+fi
+
+# Check if sync CLI command exists
+SYNC_CLI="$PROJECT_ROOT/dist/cli/commands/sync-spec-content.js"
+if [ ! -f "$SYNC_CLI" ]; then
+  echo "ℹ️  Sync CLI not built, skipping spec content sync" >&2
+  echo "   Run: npm run build" >&2
+  exit 0
+fi
+
+# Check if Node.js is available
+if ! command -v node &> /dev/null; then
+  echo "❌ Node.js not found, cannot sync spec content" >&2
+  exit 1
+fi
+
+echo ""
+echo "🔄 Syncing spec content to $PROVIDER..."
+echo "   Spec: $(basename "$SPEC_PATH")"
+echo ""
+
+# Run sync
+set +e
+node "$SYNC_CLI" --spec "$SPEC_PATH" --provider "$PROVIDER"
+SYNC_EXIT_CODE=$?
+set -e
+
+if [ $SYNC_EXIT_CODE -eq 0 ]; then
+  echo ""
+  echo "✅ Spec content synced successfully"
+  echo ""
+else
+  echo ""
+  echo "⚠️  Spec content sync failed (exit code: $SYNC_EXIT_CODE)" >&2
+  echo "   This is non-blocking. You can sync manually later:" >&2
+  echo "   node dist/cli/commands/sync-spec-content.js --spec \"$SPEC_PATH\" --provider $PROVIDER" >&2
+  echo ""
+  # Non-blocking: continue execution even if sync fails
+fi
+
+exit 0

package/plugins/specweave/hooks/post-increment-planning.sh

@@ -646,49 +646,71 @@ EOF
 
   translate_living_docs_specs "$increment_id"
 
-  # 7. Auto-create GitHub issue (if configured)
+  # 7. Increment-level GitHub sync (DISABLED - See architecture note below)
   log_info ""
-  log_info "🔗 Checking GitHub issue auto-creation..."
+  log_info "ℹ️  Increment-level GitHub sync disabled (by design)"
+  log_debug "Increments are INTERNAL work units, not synced to external tools"
+  log_debug "External sync happens at SPEC level (.specweave/docs/internal/specs/)"
+  log_debug "See: .specweave/increments/0025-per-project-resource-config/reports/CORRECT-SYNC-ARCHITECTURE.md"
+
+  # TODO: Implement spec-level sync instead
+  # Architecture:
+  #   - SPECS (.specweave/docs/internal/specs/) → GitHub Projects/JIRA Epics/ADO Features
+  #   - User Stories → GitHub Issues
+  #   - Increments → INTERNAL ONLY (no external sync)
+  #
+  # Commands to implement:
+  #   - /specweave-github:sync-spec spec-001
+  #   - /specweave-jira:sync-spec spec-001
+  #   - /specweave-ado:sync-spec spec-001
+  #
+  # See: plugins/specweave-github/commands/specweave-github-sync-spec.md
+
+  # COMMENTED OUT: Increment-level GitHub issue creation (architecturally wrong)
+  # # Check if auto-create is enabled in config
+  # local auto_create=$(cat "$CONFIG_FILE" 2>/dev/null | grep -A 5 '"sync"' | grep -A 2 '"settings"' | grep -o '"autoCreateIssue"[[:space:]]*:[[:space:]]*\(true\|false\)' | grep -o '\(true\|false\)' || echo "false")
+  #
+  # if [ "$auto_create" = "true" ]; then
+  #   ... (increment-level sync code removed)
+  # fi
+
+  # 8. Sync spec content to external tools (if configured)
+  log_info ""
+  log_info "🔗 Checking spec content sync..."
 
-  # Check if auto-create is enabled in config
-  local auto_create=$(cat "$CONFIG_FILE" 2>/dev/null | grep -A 5 '"sync"' | grep -A 2 '"settings"' | grep -o '"autoCreateIssue"[[:space:]]*:[[:space:]]*\(true\|false\)' | grep -o '\(true\|false\)' || echo "false")
+  # Check if sync is enabled in config
+  local sync_enabled=$(cat "$CONFIG_FILE" 2>/dev/null | grep -o '"enabled"[[:space:]]*:[[:space:]]*\(true\|false\)' | head -1 | grep -o '\(true\|false\)' || echo "false")
 
-  if [ "$auto_create" = "true" ]; then
-    log_info "  📦 Auto-create enabled, checking for GitHub CLI..."
+  if [ "$sync_enabled" = "true" ]; then
+    log_info "  📦 Sync enabled, syncing spec content to external tool..."
 
-    # Check if gh CLI is available
-    if command -v gh &> /dev/null; then
-      log_info "  ✓ GitHub CLI found"
+    # Find the helper script
+    local sync_script="${CLAUDE_PLUGIN_ROOT}/hooks/lib/sync-spec-content.sh"
 
-      # Check if metadata.json already has GitHub issue
-      local metadata_file="$increment_dir/metadata.json"
-      local existing_issue=""
+    # Fallback to relative path if CLAUDE_PLUGIN_ROOT not set
+    if [ -z "$CLAUDE_PLUGIN_ROOT" ]; then
+      local hook_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+      sync_script="$hook_dir/lib/sync-spec-content.sh"
+    fi
 
-      if [ -f "$metadata_file" ]; then
-        existing_issue=$(cat "$metadata_file" 2>/dev/null | grep -o '"issue"[[:space:]]*:[[:space:]]*[0-9]*' | grep -o '[0-9]*' || echo "")
-      fi
+    if [ -f "$sync_script" ] && [ -x "$sync_script" ]; then
+      log_debug "Calling sync-spec-content.sh for $spec_file"
 
-      if [ -n "$existing_issue" ]; then
-        log_info "  ℹ️  GitHub issue already exists: #$existing_issue"
+      # Call the sync script (non-blocking)
+      if "$sync_script" "$spec_file" 2>&1 | while read -r line; do echo "  $line"; done; then
+        log_info "  ✅ Spec content sync completed successfully!"
       else
-        log_info "  🚀 Creating GitHub issue for $increment_id..."
-
-        # Call the create_github_issue function (defined below)
-        if create_github_issue "$increment_id" "$increment_dir"; then
-          log_info "  ✅ GitHub issue created successfully!"
-        else
-          log_info "  ⚠️  Failed to create GitHub issue (non-blocking)"
-          log_debug "Issue creation failed, continuing..."
-        fi
+        log_info "  ⚠️  Spec content sync failed (non-blocking)"
+        log_debug "Spec sync failed, continuing..."
       fi
     else
-      log_debug "GitHub CLI not found, skipping issue creation"
+      log_debug "Sync script not found or not executable: $sync_script"
     fi
   else
-    log_debug "GitHub issue auto-create disabled in config"
+    log_debug "Spec content sync disabled in config"
   fi
 
-  # 8. Final summary
+  # 9. Final summary
   log_info ""
   local total_translated=$((increment_success_count))
 

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

@@ -102,10 +102,23 @@ EOF
       if [[ -n "$INCOMPLETE_INCREMENTS" ]]; then
         COUNT=$(echo "$INCOMPLETE_INCREMENTS" | wc -l | xargs)
 
+        # Get incomplete task count for migration guidance
+        MIGRATION_SCRIPT="$(dirname "${BASH_SOURCE[0]}")/lib/migrate-increment-work.sh"
+        INCOMPLETE_TASKS=""
+
+        for increment in $INCOMPLETE_INCREMENTS; do
+          if [[ -x "$MIGRATION_SCRIPT" ]]; then
+            TASK_COUNT=$("$MIGRATION_SCRIPT" count-incomplete "$increment" 2>/dev/null || echo "?")
+            INCOMPLETE_TASKS="${INCOMPLETE_TASKS}\n  - $increment ($TASK_COUNT incomplete tasks)"
+          else
+            INCOMPLETE_TASKS="${INCOMPLETE_TASKS}\n  - $increment"
+          fi
+        done
+
         cat <<EOF
 {
   "decision": "block",
-  "reason": "❌ Cannot create new increment! You have $COUNT incomplete increment(s):\n\n$(echo "$INCOMPLETE_INCREMENTS" | sed 's/^/  - /')\n\n💡 Complete or close them first:\n  - /specweave:done <id>     # Mark as complete\n  - /specweave:pause <id>    # Pause for later\n  - /specweave:abandon <id>  # Abandon if obsolete\n\nℹ️ The discipline exists for a reason:\n  ✓ Prevents scope creep\n  ✓ Ensures completions are tracked\n  ✓ Maintains living docs accuracy\n  ✓ Keeps work focused"
+  "reason": "❌ Cannot create new increment! You have $COUNT incomplete increment(s):$INCOMPLETE_TASKS\n\n💡 **SMART MIGRATION OPTIONS:**\n\n1️⃣  **Transfer Work** (Recommended)\n   Move incomplete tasks to new increment:\n   \`\`\`bash\n   # After creating new increment, run:\n   bash plugins/specweave/hooks/lib/migrate-increment-work.sh transfer <old-id> <new-id>\n   \`\`\`\n   ✅ Clean closure + work continues\n\n2️⃣  **Adjust WIP Limit** (Emergency Only)\n   Temporarily allow 3 active increments:\n   \`\`\`bash\n   bash plugins/specweave/hooks/lib/migrate-increment-work.sh adjust-wip 3\n   \`\`\`\n   ⚠️  20% productivity cost, revert ASAP\n\n3️⃣  **Force-Close** (Quick Fix)\n   Mark increment as complete (work lost):\n   \`\`\`bash\n   bash plugins/specweave/hooks/lib/migrate-increment-work.sh force-close <increment-id>\n   \`\`\`\n   ⚠️  Incomplete work NOT transferred!\n\n📝 **Traditional Options:**\n  - /specweave:done <id>     # Complete properly\n  - /specweave:pause <id>    # Pause for later\n  - /specweave:abandon <id>  # Abandon if obsolete\n\nℹ️ The discipline exists for a reason:\n  ✓ Prevents scope creep\n  ✓ Ensures completions are tracked\n  ✓ Maintains living docs accuracy\n  ✓ Keeps work focused"
 }
 EOF
         exit 0
@@ -114,6 +127,76 @@ EOF
   fi
 fi
 
+# ==============================================================================
+# PRE-FLIGHT SYNC CHECK: Ensure living docs are fresh before operations
+# ==============================================================================
+
+# Detect increment operations that need fresh data
+if echo "$PROMPT" | grep -qE "/(specweave:)?(done|validate|progress|do)"; then
+  # Extract increment ID from prompt (if provided)
+  INCREMENT_ID=$(echo "$PROMPT" | grep -oE "[0-9]{4}[a-z0-9-]*" | head -1)
+
+  # If no ID in prompt, try to find active increment
+  if [[ -z "$INCREMENT_ID" ]] && [[ -d ".specweave/increments" ]]; then
+    INCREMENT_ID=$(find .specweave/increments -mindepth 1 -maxdepth 1 -type d | while read increment_dir; do
+      metadata="$increment_dir/metadata.json"
+      if [[ -f "$metadata" ]]; then
+        status=$(node -e "
+          try {
+            const data = JSON.parse(require('fs').readFileSync('$metadata', 'utf-8'));
+            if (data.status === 'active') {
+              console.log('$(basename "$increment_dir")');
+            }
+          } catch (e) {}
+        " 2>/dev/null)
+
+        if [[ -n "$status" ]]; then
+          echo "$status"
+          break
+        fi
+      fi
+    done)
+  fi
+
+  # If we have an increment ID, check freshness
+  if [[ -n "$INCREMENT_ID" ]]; then
+    INCREMENT_SPEC=".specweave/increments/$INCREMENT_ID/spec.md"
+    LIVING_DOCS_SPEC=".specweave/docs/internal/specs/spec-$INCREMENT_ID.md"
+
+    # Check if increment spec exists
+    if [[ -f "$INCREMENT_SPEC" ]]; then
+      # Get modification times
+      if [[ "$(uname)" == "Darwin" ]]; then
+        # macOS
+        INCREMENT_MTIME=$(stat -f %m "$INCREMENT_SPEC" 2>/dev/null || echo 0)
+        LIVING_DOCS_MTIME=$(stat -f %m "$LIVING_DOCS_SPEC" 2>/dev/null || echo 0)
+      else
+        # Linux
+        INCREMENT_MTIME=$(stat -c %Y "$INCREMENT_SPEC" 2>/dev/null || echo 0)
+        LIVING_DOCS_MTIME=$(stat -c %Y "$LIVING_DOCS_SPEC" 2>/dev/null || echo 0)
+      fi
+
+      # Check if increment is newer than living docs (or living docs doesn't exist)
+      if [[ "$INCREMENT_MTIME" -gt "$LIVING_DOCS_MTIME" ]]; then
+        # Sync needed - run sync-living-docs
+        PLUGIN_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+        SYNC_SCRIPT="$PLUGIN_ROOT/lib/hooks/sync-living-docs.js"
+
+        if [[ -f "$SYNC_SCRIPT" ]]; then
+          # Run sync (capture output but don't block on errors)
+          if node "$SYNC_SCRIPT" "$INCREMENT_ID" >/dev/null 2>&1; then
+            # Success - sync completed
+            :
+          else
+            # Sync failed - log but continue
+            echo "[WARNING] Pre-flight sync failed for $INCREMENT_ID" >&2
+          fi
+        fi
+      fi
+    fi
+  fi
+fi
+
 # ==============================================================================
 # CONTEXT INJECTION: Add current increment status
 # ==============================================================================
@@ -142,20 +225,44 @@ if [[ -d ".specweave/increments" ]]; then
   done)
 
   if [[ -n "$ACTIVE_INCREMENT" ]]; then
-    # Get task completion percentage
-    TASKS_FILE=".specweave/increments/$ACTIVE_INCREMENT/tasks.md"
-    if [[ -f "$TASKS_FILE" ]]; then
-      TASK_STATS=$(grep -E "^\s*-\s*\[[ x]\]" "$TASKS_FILE" 2>/dev/null | wc -l | xargs || echo "0")
-      COMPLETED_TASKS=$(grep -E "^\s*-\s*\[x\]" "$TASKS_FILE" 2>/dev/null | wc -l | xargs || echo "0")
-
-      if [[ "$TASK_STATS" -gt 0 ]]; then
-        PERCENTAGE=$(( COMPLETED_TASKS * 100 / TASK_STATS ))
-        CONTEXT="📍 Active Increment: $ACTIVE_INCREMENT ($PERCENTAGE% complete, $COMPLETED_TASKS/$TASK_STATS tasks)"
+    # Use status line cache for consistent display
+    STATUS_LINE_CACHE=".specweave/state/status-line.json"
+    if [[ -f "$STATUS_LINE_CACHE" ]]; then
+      # Get status line from cache (ultra-fast)
+      STATUS_LINE=$(node -e "
+        try {
+          const { StatusLineManager } = require('./dist/core/status-line/status-line-manager.js');
+          const manager = new StatusLineManager(process.cwd());
+          const result = manager.render();
+          console.log(result || '');
+        } catch (e) {
+          // Fallback: show increment name only
+          console.log('');
+        }
+      " 2>/dev/null || echo "")
+
+      if [[ -n "$STATUS_LINE" ]]; then
+        CONTEXT="✓ $STATUS_LINE"
       else
-        CONTEXT="📍 Active Increment: $ACTIVE_INCREMENT"
+        # Fallback: parse tasks.md manually
+        TASKS_FILE=".specweave/increments/$ACTIVE_INCREMENT/tasks.md"
+        if [[ -f "$TASKS_FILE" ]]; then
+          TASK_STATS=$(grep -E "^\s*-\s*\[[ x]\]" "$TASKS_FILE" 2>/dev/null | wc -l | xargs || echo "0")
+          COMPLETED_TASKS=$(grep -E "^\s*-\s*\[x\]" "$TASKS_FILE" 2>/dev/null | wc -l | xargs || echo "0")
+
+          if [[ "$TASK_STATS" -gt 0 ]]; then
+            PERCENTAGE=$(( COMPLETED_TASKS * 100 / TASK_STATS ))
+            CONTEXT="✓ Active Increment: $ACTIVE_INCREMENT ($PERCENTAGE% complete, $COMPLETED_TASKS/$TASK_STATS tasks)"
+          else
+            CONTEXT="✓ Active Increment: $ACTIVE_INCREMENT"
+          fi
+        else
+          CONTEXT="✓ Active Increment: $ACTIVE_INCREMENT"
+        fi
       fi
     else
-      CONTEXT="📍 Active Increment: $ACTIVE_INCREMENT"
+      # No cache, fall back to increment name only
+      CONTEXT="✓ Active Increment: $ACTIVE_INCREMENT"
     fi
   fi
 fi

package/plugins/specweave/lib/hooks/sync-living-docs.js

@@ -18,8 +18,9 @@ async function syncLivingDocs(incrementId) {
       return;
     }
     console.log("\u2705 Living docs sync enabled");
+    const specCopied = await copyIncrementSpecToLivingDocs(incrementId);
     const changedDocs = detectChangedDocs();
-    if (changedDocs.length === 0) {
+    if (changedDocs.length === 0 && !specCopied) {
       console.log("\u2139\uFE0F  No living docs changed (no git diff in .specweave/docs/)");
       return;
     }
@@ -31,6 +32,31 @@ async function syncLivingDocs(incrementId) {
     console.error("\u274C Error syncing living docs:", error);
   }
 }
+async function copyIncrementSpecToLivingDocs(incrementId) {
+  try {
+    const incrementSpecPath = path.join(process.cwd(), ".specweave", "increments", incrementId, "spec.md");
+    const livingDocsPath = path.join(process.cwd(), ".specweave", "docs", "internal", "specs", `spec-${incrementId}.md`);
+    if (!fs.existsSync(incrementSpecPath)) {
+      console.log(`\u26A0\uFE0F  Increment spec not found: ${incrementSpecPath}`);
+      return false;
+    }
+    if (fs.existsSync(livingDocsPath)) {
+      const incrementContent = await fs.readFile(incrementSpecPath, "utf-8");
+      const livingDocsContent = await fs.readFile(livingDocsPath, "utf-8");
+      if (incrementContent === livingDocsContent) {
+        console.log(`\u2139\uFE0F  Living docs spec already up-to-date: spec-${incrementId}.md`);
+        return false;
+      }
+    }
+    await fs.ensureDir(path.dirname(livingDocsPath));
+    await fs.copy(incrementSpecPath, livingDocsPath);
+    console.log(`\u2705 Copied increment spec to living docs: spec-${incrementId}.md`);
+    return true;
+  } catch (error) {
+    console.error(`\u274C Error copying increment spec: ${error}`);
+    return false;
+  }
+}
 function detectChangedDocs() {
   try {
     const output = execSync("git diff --name-only .specweave/docs/ 2>/dev/null || true", {

package/plugins/specweave/lib/hooks/sync-living-docs.ts

@@ -59,10 +59,13 @@ async function syncLivingDocs(incrementId: string): Promise<void> {
 
     console.log('✅ Living docs sync enabled');
 
-    // 3. Detect changed docs via git diff
+    // 3. Copy increment spec to living docs
+    const specCopied = await copyIncrementSpecToLivingDocs(incrementId);
+
+    // 4. Detect changed docs via git diff
     const changedDocs = detectChangedDocs();
 
-    if (changedDocs.length === 0) {
+    if (changedDocs.length === 0 && !specCopied) {
       console.log('ℹ️  No living docs changed (no git diff in .specweave/docs/)');
       return;
     }
@@ -81,6 +84,47 @@ async function syncLivingDocs(incrementId: string): Promise<void> {
   }
 }
 
+/**
+ * Copy increment spec to living docs
+ * Returns true if spec was copied, false if skipped
+ */
+async function copyIncrementSpecToLivingDocs(incrementId: string): Promise<boolean> {
+  try {
+    const incrementSpecPath = path.join(process.cwd(), '.specweave', 'increments', incrementId, 'spec.md');
+    const livingDocsPath = path.join(process.cwd(), '.specweave', 'docs', 'internal', 'specs', `spec-${incrementId}.md`);
+
+    // Check if increment spec exists
+    if (!fs.existsSync(incrementSpecPath)) {
+      console.log(`⚠️  Increment spec not found: ${incrementSpecPath}`);
+      return false;
+    }
+
+    // Check if living docs spec already exists and is identical
+    if (fs.existsSync(livingDocsPath)) {
+      const incrementContent = await fs.readFile(incrementSpecPath, 'utf-8');
+      const livingDocsContent = await fs.readFile(livingDocsPath, 'utf-8');
+
+      if (incrementContent === livingDocsContent) {
+        console.log(`ℹ️  Living docs spec already up-to-date: spec-${incrementId}.md`);
+        return false;
+      }
+    }
+
+    // Ensure target directory exists
+    await fs.ensureDir(path.dirname(livingDocsPath));
+
+    // Copy spec to living docs
+    await fs.copy(incrementSpecPath, livingDocsPath);
+
+    console.log(`✅ Copied increment spec to living docs: spec-${incrementId}.md`);
+    return true;
+
+  } catch (error) {
+    console.error(`❌ Error copying increment spec: ${error}`);
+    return false;
+  }
+}
+
 /**
  * Detect changed documentation files via git diff
  */

package/plugins/specweave-ado/.claude-plugin/plugin.json

@@ -16,5 +16,6 @@
     "sync",
     "integration"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "hooks": "hooks/hooks.json"
 }

package/plugins/specweave-ado/hooks/post-task-completion.sh

@@ -139,6 +139,28 @@ node dist/commands/ado-sync.js "$CURRENT_INCREMENT" 2>&1 | tee -a "$DEBUG_LOG" >
 
 echo "[$(date)] [ADO] ✅ Azure DevOps sync complete" >> "$DEBUG_LOG" 2>/dev/null || true
 
+# ============================================================================
+# SPEC COMMIT SYNC (NEW!)
+# ============================================================================
+
+echo "[$(date)] [ADO] 🔗 Checking for spec commit sync..." >> "$DEBUG_LOG" 2>/dev/null || true
+
+# Call TypeScript CLI to sync commits
+if command -v node &> /dev/null && [ -f "$PROJECT_ROOT/dist/cli/commands/sync-spec-commits.js" ]; then
+  echo "[$(date)] [ADO] 🚀 Running spec commit sync..." >> "$DEBUG_LOG" 2>/dev/null || true
+
+  node "$PROJECT_ROOT/dist/cli/commands/sync-spec-commits.js" \
+    --increment "$PROJECT_ROOT/.specweave/increments/$CURRENT_INCREMENT" \
+    --provider ado \
+    2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+      echo "[$(date)] [ADO] ⚠️  Spec commit sync failed (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
+    }
+
+  echo "[$(date)] [ADO] ✅ Spec commit sync complete" >> "$DEBUG_LOG" 2>/dev/null || true
+else
+  echo "[$(date)] [ADO] ℹ️  Spec commit sync not available (node or script not found)" >> "$DEBUG_LOG" 2>/dev/null || true
+fi
+
 # ============================================================================
 # OUTPUT TO CLAUDE
 # ============================================================================

package/plugins/specweave-ado/lib/ado-client-v2.d.ts

@@ -55,12 +55,14 @@ export interface UpdateWorkItemRequest {
 }
 export declare class AdoClientV2 {
     private organization;
-    private project;
-    private workItemType;
-    private areaPath?;
-    private iterationPath?;
+    private project?;
+    private projects?;
+    private workItemTypes?;
+    private areaPaths?;
     private baseUrl;
     private authHeader;
+    private customQuery?;
+    private isMultiProject;
     /**
      * Create ADO client from sync profile
      */
@@ -68,7 +70,7 @@ export declare class AdoClientV2 {
     /**
      * Create client from organization/project directly
      */
-    static fromProject(organization: string, project: string, personalAccessToken: string, workItemType?: string): AdoClientV2;
+    static fromProject(organization: string, project: string, personalAccessToken: string): AdoClientV2;
     /**
      * Test connection and authentication
      */
@@ -104,6 +106,14 @@ export declare class AdoClientV2 {
      * List work items within time range
      */
     listWorkItemsInTimeRange(timeRange: TimeRangePreset, customStart?: string, customEnd?: string): Promise<WorkItem[]>;
+    /**
+     * Query work items across multiple projects (multi-project mode)
+     */
+    private queryWorkItemsAcrossProjects;
+    /**
+     * Build WIQL query for a specific project
+     */
+    private buildProjectWIQL;
     /**
      * Calculate date range from preset
      */

package/plugins/specweave-ado/lib/ado-client-v2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ado-client-v2.d.ts","sourceRoot":"","sources":["ado-client-v2.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ado-client-v2.d.ts","sourceRoot":"","sources":["ado-client-v2.ts"],"names":[],"mappings":"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"}