specweave 0.26.11 → 0.26.13

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

@@ -0,0 +1,258 @@
+#!/bin/bash
+
+# SpecWeave GitHub Sync Hook
+# Runs after task completion to sync progress to GitHub Projects
+#
+# ARCHITECTURE (v0.19.0+): IMMUTABLE DESCRIPTIONS + PROGRESS COMMENTS
+# - User Story files (.specweave/docs/internal/specs/) ↔ GitHub Issues
+# - Issue descriptions created once (IMMUTABLE snapshot)
+# - All updates via progress comments (audit trail)
+#
+# This hook is part of the specweave-github plugin and handles:
+# - Finding which spec user stories the current work belongs to
+# - Syncing progress via GitHub comments (NOT editing issue body)
+# - Creating audit trail of all changes over time
+# - Notifying stakeholders via GitHub notifications
+#
+# Dependencies:
+# - Node.js and TypeScript CLI (dist/cli/commands/sync-spec-content.js)
+# - GitHub CLI (gh) must be installed and authenticated
+# - ProgressCommentBuilder (lib/progress-comment-builder.ts)
+
+set -e
+
+# ============================================================================
+# PROJECT ROOT DETECTION
+# ============================================================================
+
+# Find project root by searching upward for .specweave/ directory
+find_project_root() {
+  local dir="$1"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/.specweave" ]; then
+      echo "$dir"
+      return 0
+    fi
+    dir="$(dirname "$dir")"
+  done
+  # Fallback: try current directory
+  if [ -d "$(pwd)/.specweave" ]; then
+    pwd
+  else
+    echo "$(pwd)"
+  fi
+}
+
+PROJECT_ROOT="$(find_project_root "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")"
+cd "$PROJECT_ROOT" 2>/dev/null || true
+
+# ============================================================================
+# CONFIGURATION
+# ============================================================================
+
+LOGS_DIR=".specweave/logs"
+DEBUG_LOG="$LOGS_DIR/hooks-debug.log"
+
+mkdir -p "$LOGS_DIR" 2>/dev/null || true
+
+# ============================================================================
+# PRECONDITIONS CHECK
+# ============================================================================
+
+echo "[$(date)] [GitHub] 🔗 GitHub sync hook fired" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# Check if Node.js is available
+if ! command -v node &> /dev/null; then
+  echo "[$(date)] [GitHub] ⚠️  Node.js not found, skipping GitHub sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# Check if github-spec-content-sync CLI exists
+SYNC_CLI="$PROJECT_ROOT/dist/src/cli/commands/sync-spec-content.js"
+if [ ! -f "$SYNC_CLI" ]; then
+  echo "[$(date)] [GitHub] ⚠️  sync-spec-content CLI not found at $SYNC_CLI, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# Check for gh CLI
+if ! command -v gh &> /dev/null; then
+  echo "[$(date)] [GitHub] ⚠️  GitHub CLI (gh) not found, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# ============================================================================
+# DETECT ALL SPECS (Multi-Spec Support)
+# ============================================================================
+
+# Strategy: Use multi-spec detector to find ALL specs referenced in current increment
+
+# 1. Detect current increment (temporary context)
+CURRENT_INCREMENT=$(ls -td .specweave/increments/*/ 2>/dev/null | xargs -n1 basename | grep -v "_backlog" | grep -v "_archive" | grep -v "_working" | head -1)
+
+if [ -z "$CURRENT_INCREMENT" ]; then
+  echo "[$(date)] [GitHub] ℹ️  No active increment, checking for spec changes..." >> "$DEBUG_LOG" 2>/dev/null || true
+  # Fall through to sync all changed specs
+fi
+
+# 2. Use TypeScript CLI to detect all specs
+DETECT_CLI="$PROJECT_ROOT/dist/src/cli/commands/detect-specs.js"
+
+if [ -f "$DETECT_CLI" ]; then
+  echo "[$(date)] [GitHub] 🔍 Detecting all specs in increment $CURRENT_INCREMENT..." >> "$DEBUG_LOG" 2>/dev/null || true
+
+  # Call detect-specs CLI and capture JSON output
+  DETECTION_RESULT=$(node "$DETECT_CLI" 2>> "$DEBUG_LOG" || echo "{}")
+
+  # Extract spec count
+  SPEC_COUNT=$(echo "$DETECTION_RESULT" | node -e "const fs=require('fs'); const data=JSON.parse(fs.readFileSync(0,'utf-8')); console.log(data.specs?.length || 0)")
+
+  echo "[$(date)] [GitHub] 📋 Detected $SPEC_COUNT spec(s)" >> "$DEBUG_LOG" 2>/dev/null || true
+
+  # Store detection result for later use
+  echo "$DETECTION_RESULT" > /tmp/specweave-detected-specs.json
+else
+  echo "[$(date)] [GitHub] ⚠️  detect-specs CLI not found at $DETECT_CLI, falling back to git diff" >> "$DEBUG_LOG" 2>/dev/null || true
+  SPEC_COUNT=0
+fi
+
+# ============================================================================
+# SYNC ALL DETECTED SPECS TO GITHUB (Multi-Spec Support)
+# ============================================================================
+
+if [ -f /tmp/specweave-detected-specs.json ] && [ "$SPEC_COUNT" -gt 0 ]; then
+  # Multi-spec sync: Loop through all detected specs
+  echo "[$(date)] [GitHub] 🔄 Syncing $SPEC_COUNT spec(s) to GitHub..." >> "$DEBUG_LOG" 2>/dev/null || true
+
+  # Extract spec paths using Node.js
+  SPEC_PATHS=$(node -e "
+    const fs = require('fs');
+    const data = JSON.parse(fs.readFileSync('/tmp/specweave-detected-specs.json', 'utf-8'));
+    const syncable = data.specs.filter(s => s.syncEnabled && s.project !== '_parent');
+    syncable.forEach(s => console.log(s.path));
+  " 2>> "$DEBUG_LOG")
+
+  # Count syncable specs
+  SYNCABLE_COUNT=$(echo "$SPEC_PATHS" | grep -v '^$' | wc -l | tr -d ' ')
+
+  if [ "$SYNCABLE_COUNT" -gt 0 ]; then
+    echo "[$(date)] [GitHub] 📋 Syncing $SYNCABLE_COUNT syncable spec(s) (excluding _parent)" >> "$DEBUG_LOG" 2>/dev/null || true
+
+    # Sync each spec
+    echo "$SPEC_PATHS" | while read -r SPEC_FILE; do
+      if [ -n "$SPEC_FILE" ] && [ -f "$SPEC_FILE" ]; then
+        # Extract project and spec ID from path
+        SPEC_NAME=$(basename "$SPEC_FILE" .md)
+        PROJECT=$(basename "$(dirname "$SPEC_FILE")")
+
+        echo "[$(date)] [GitHub] 🔄 Syncing $PROJECT/$SPEC_NAME..." >> "$DEBUG_LOG" 2>/dev/null || true
+
+        (cd "$PROJECT_ROOT" && node "$SYNC_CLI" --spec "$SPEC_FILE" --provider github) 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+          echo "[$(date)] [GitHub] ⚠️  Spec sync failed for $PROJECT/$SPEC_NAME (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
+        }
+
+        echo "[$(date)] [GitHub] ✅ Synced $PROJECT/$SPEC_NAME" >> "$DEBUG_LOG" 2>/dev/null || true
+      fi
+    done
+
+    echo "[$(date)] [GitHub] ✅ Multi-spec sync complete ($SYNCABLE_COUNT synced)" >> "$DEBUG_LOG" 2>/dev/null || true
+  else
+    echo "[$(date)] [GitHub] ℹ️  No syncable specs (all specs are _parent or syncEnabled=false)" >> "$DEBUG_LOG" 2>/dev/null || true
+  fi
+
+  # Cleanup temp file
+  rm -f /tmp/specweave-detected-specs.json 2>/dev/null || true
+else
+  # Fallback: Sync all modified specs (check git diff)
+  echo "[$(date)] [GitHub] 🔄 Checking for modified specs..." >> "$DEBUG_LOG" 2>/dev/null || true
+
+  MODIFIED_SPECS=$(git diff --name-only HEAD .specweave/docs/internal/specs/**/*.md 2>/dev/null || echo "")
+
+  if [ -n "$MODIFIED_SPECS" ]; then
+    echo "[$(date)] [GitHub] 📝 Found modified specs:" >> "$DEBUG_LOG" 2>/dev/null || true
+    echo "$MODIFIED_SPECS" >> "$DEBUG_LOG" 2>/dev/null || true
+
+    # Sync each modified spec
+    echo "$MODIFIED_SPECS" | while read -r SPEC_FILE; do
+      if [ -n "$SPEC_FILE" ] && [ -f "$SPEC_FILE" ]; then
+        echo "[$(date)] [GitHub] 🔄 Syncing $SPEC_FILE..." >> "$DEBUG_LOG" 2>/dev/null || true
+        (cd "$PROJECT_ROOT" && node "$SYNC_CLI" --spec "$SPEC_FILE" --provider github) 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || true
+      fi
+    done
+
+    echo "[$(date)] [GitHub] ✅ Batch spec sync complete" >> "$DEBUG_LOG" 2>/dev/null || true
+  else
+    echo "[$(date)] [GitHub] ℹ️  No modified specs found, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  fi
+fi
+
+# ============================================================================
+# EPIC GITHUB ISSUE SYNC (DEPRECATED v0.24.0+)
+# ============================================================================
+#
+# ⚠️  DEPRECATED: SpecWeave now syncs ONLY at User Story level.
+#
+# Feature/Epic-level issues are no longer updated.
+# Use /specweave-github:sync instead to sync User Story issues.
+#
+# To re-enable (NOT recommended):
+#   export SPECWEAVE_ENABLE_EPIC_SYNC=true
+#
+# @see .specweave/increments/0047-us-task-linkage/reports/GITHUB-TITLE-FORMAT-FIX-PLAN.md
+# ============================================================================
+
+if [ "$SPECWEAVE_ENABLE_EPIC_SYNC" = "true" ]; then
+  echo "[$(date)] [GitHub] 🔄 Checking for Epic GitHub issue update (DEPRECATED)..." >> "$DEBUG_LOG" 2>/dev/null || true
+
+  # Find active increment ID
+  ACTIVE_INCREMENT=$(ls -t .specweave/increments/ | grep -v '^\.' | while read inc; do
+    if [ -f ".specweave/increments/$inc/metadata.json" ]; then
+      STATUS=$(grep -o '"status"[[:space:]]*:[[:space:]]*"[^"]*"' ".specweave/increments/$inc/metadata.json" 2>/dev/null | sed 's/.*"\([^"]*\)".*/\1/' || true)
+      if [ "$STATUS" = "active" ]; then
+        echo "$inc"
+        break
+      fi
+    fi
+  done | head -1)
+
+  if [ -n "$ACTIVE_INCREMENT" ]; then
+    echo "[$(date)] [GitHub] 🎯 Active increment: $ACTIVE_INCREMENT" >> "$DEBUG_LOG" 2>/dev/null || true
+
+    # Run Epic sync script (silently, errors logged to debug log)
+    if [ -f "$PROJECT_ROOT/scripts/update-epic-github-issue.sh" ]; then
+      echo "[$(date)] [GitHub] 🚀 Updating Epic GitHub issue (DEPRECATED)..." >> "$DEBUG_LOG" 2>/dev/null || true
+      "$PROJECT_ROOT/scripts/update-epic-github-issue.sh" "$ACTIVE_INCREMENT" >> "$DEBUG_LOG" 2>&1 || true
+      echo "[$(date)] [GitHub] ⚠️  Epic sync is deprecated. Use /specweave-github:sync instead." >> "$DEBUG_LOG" 2>/dev/null || true
+    else
+      echo "[$(date)] [GitHub] ⚠️  Epic sync script not found, skipping" >> "$DEBUG_LOG" 2>/dev/null || true
+    fi
+  else
+    echo "[$(date)] [GitHub] ℹ️  No active increment found, skipping Epic sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  fi
+else
+  echo "[$(date)] [GitHub] ℹ️  Epic sync disabled (sync at User Story level only)" >> "$DEBUG_LOG" 2>/dev/null || true
+fi
+
+# ============================================================================
+# OUTPUT TO CLAUDE
+# ============================================================================
+
+cat <<EOF
+{
+  "continue": true
+}
+EOF

package/plugins/specweave-github/lib/completion-calculator.js

@@ -99,8 +99,11 @@ class CompletionCalculator {
    * Process:
    * 1. Find increment link in user story's "Implementation" section
    * 2. Read increment's tasks.md
-   * 3. Filter tasks that reference this user story's ACs
+   * 3. Filter tasks that reference this user story (via **User Story** field OR AC-IDs)
    * 4. Extract completion status from **Status**: [x] or [ ]
+   *
+   * IMPORTANT: Checks **User Story** field FIRST (handles multi-story tasks like "US-001, US-002"),
+   * then falls back to AC-based filtering. Also handles "Satisfies ACs: All" correctly.
    */
   async extractTasks(userStoryContent, userStoryId) {
     const tasks = [];
@@ -125,33 +128,48 @@ class CompletionCalculator {
       return tasks;
     }
     const tasksContent = await readFile(tasksPath, "utf-8");
+    const normalizeUsId = (id) => {
+      const num = id.replace(/^US-?0*/, "");
+      return `US-${num.padStart(3, "0")}`;
+    };
+    const normalizedCurrentUs = normalizeUsId(userStoryId);
     const taskPattern = /###?\s+(T-\d+):\s*([^\n]+)\n([\s\S]*?)(?=\n###?\s+T-\d+:|$)/g;
     let match;
     while ((match = taskPattern.exec(tasksContent)) !== null) {
       const taskId = match[1];
       const taskTitle = match[2].trim();
       const taskBody = match[3];
-      const acMatch = taskBody.match(/\*\*(?:Satisfies ACs?|AC)\*\*:\s*([^\n]+)/);
-      if (!acMatch) {
-        continue;
+      const userStoryFieldMatch = taskBody.match(/\*\*User Story\*\*:\s*([^\n]+)/);
+      let belongsToThisUS = false;
+      if (userStoryFieldMatch) {
+        const userStoryList = userStoryFieldMatch[1].trim();
+        const userStoryIds = userStoryList.split(",").map((us) => us.trim());
+        belongsToThisUS = userStoryIds.some((usId) => {
+          return normalizeUsId(usId) === normalizedCurrentUs;
+        });
+      }
+      if (!belongsToThisUS) {
+        const acMatch2 = taskBody.match(/\*\*(?:Satisfies ACs?|AC)\*\*:\s*([^\n]+)/);
+        if (acMatch2) {
+          const acList = acMatch2[1].trim();
+          if (acList.toLowerCase() !== "all") {
+            const acIds2 = acList.split(",").map((ac) => ac.trim());
+            belongsToThisUS = acIds2.some((acId) => {
+              const usMatch = acId.match(/AC-([A-Z]+\d+)-/);
+              if (!usMatch) return false;
+              const extractedUsId = usMatch[1];
+              return normalizeUsId(extractedUsId) === normalizedCurrentUs;
+            });
+          }
+        }
       }
-      const acList = acMatch[1].trim();
-      const acIds = acList.split(",").map((ac) => ac.trim());
-      const belongsToThisUS = acIds.some((acId) => {
-        const usMatch = acId.match(/AC-([A-Z]+\d+)-/);
-        if (!usMatch) return false;
-        const extractedUsId = usMatch[1];
-        const extractedNum = extractedUsId.replace(/^US/, "");
-        const normalizedExtracted = `US-${extractedNum.padStart(3, "0")}`;
-        const currentNum = userStoryId.replace(/^US-?/, "");
-        const normalizedCurrent = `US-${currentNum.padStart(3, "0")}`;
-        return normalizedExtracted === normalizedCurrent;
-      });
       if (!belongsToThisUS) {
         continue;
       }
       const statusMatch = taskBody.match(/\*\*Status\*\*:\s*\[([x ])\]/);
       const completed = statusMatch ? statusMatch[1] === "x" : false;
+      const acMatch = taskBody.match(/\*\*(?:Satisfies ACs?|AC)\*\*:\s*([^\n]+)/);
+      const acIds = acMatch ? acMatch[1].trim().split(",").map((ac) => ac.trim()) : [];
       tasks.push({
         id: taskId,
         title: taskTitle,

package/plugins/specweave-github/lib/completion-calculator.ts

@@ -212,8 +212,11 @@ export class CompletionCalculator {
    * Process:
    * 1. Find increment link in user story's "Implementation" section
    * 2. Read increment's tasks.md
-   * 3. Filter tasks that reference this user story's ACs
+   * 3. Filter tasks that reference this user story (via **User Story** field OR AC-IDs)
    * 4. Extract completion status from **Status**: [x] or [ ]
+   *
+   * IMPORTANT: Checks **User Story** field FIRST (handles multi-story tasks like "US-001, US-002"),
+   * then falls back to AC-based filtering. Also handles "Satisfies ACs: All" correctly.
    */
   private async extractTasks(userStoryContent: string, userStoryId: string): Promise<Task[]> {
     const tasks: Task[] = [];
@@ -252,12 +255,20 @@ export class CompletionCalculator {
 
     const tasksContent = await readFile(tasksPath, 'utf-8');
 
-    // Extract tasks that reference this User Story via AC-IDs
+    // Normalize the current user story ID for comparison
+    // Handles: "US-001", "US-1", "US001", "001"
+    const normalizeUsId = (id: string): string => {
+      const num = id.replace(/^US-?0*/, ''); // Remove "US-", "US", and leading zeros
+      return `US-${num.padStart(3, '0')}`; // Normalize to "US-001" format
+    };
+    const normalizedCurrentUs = normalizeUsId(userStoryId);
+
+    // Extract tasks that reference this User Story
     // Pattern:
     // ### T-001: Task Title
-    // **User Story**: ...
-    // **Status**: [x] (100% - Completed) or [ ] (0% - Not started)
-    // **AC**: AC-US1-01, AC-US1-02
+    // **User Story**: US-001, US-002  ← Check this FIRST!
+    // **Satisfies ACs**: AC-US1-01, AC-US1-02 (or "All")
+    // **Status**: [x] completed
     const taskPattern = /###?\s+(T-\d+):\s*([^\n]+)\n([\s\S]*?)(?=\n###?\s+T-\d+:|$)/g;
     let match;
 
@@ -266,34 +277,41 @@ export class CompletionCalculator {
       const taskTitle = match[2].trim();
       const taskBody = match[3];
 
-      // Extract AC list (support both old and new field names)
-      const acMatch = taskBody.match(/\*\*(?:Satisfies ACs?|AC)\*\*:\s*([^\n]+)/);
-      if (!acMatch) {
-        continue; // Skip tasks without AC field
+      // PRIORITY 1: Check **User Story** field directly (handles multi-story tasks!)
+      // Pattern: **User Story**: US-001, US-002, US-003
+      const userStoryFieldMatch = taskBody.match(/\*\*User Story\*\*:\s*([^\n]+)/);
+      let belongsToThisUS = false;
+
+      if (userStoryFieldMatch) {
+        const userStoryList = userStoryFieldMatch[1].trim();
+        // Split by comma and check if any matches current user story
+        const userStoryIds = userStoryList.split(',').map((us) => us.trim());
+        belongsToThisUS = userStoryIds.some((usId) => {
+          return normalizeUsId(usId) === normalizedCurrentUs;
+        });
+      }
+
+      // PRIORITY 2: Fall back to AC-based filtering (legacy support)
+      if (!belongsToThisUS) {
+        const acMatch = taskBody.match(/\*\*(?:Satisfies ACs?|AC)\*\*:\s*([^\n]+)/);
+        if (acMatch) {
+          const acList = acMatch[1].trim();
+
+          // Handle special "All" case - if "All", include task if User Story field matched
+          // (already handled above), otherwise skip AC-based check for "All"
+          if (acList.toLowerCase() !== 'all') {
+            const acIds = acList.split(',').map((ac) => ac.trim());
+            belongsToThisUS = acIds.some((acId) => {
+              // Extract US ID from AC-ID: AC-US1-01 → US-001
+              const usMatch = acId.match(/AC-([A-Z]+\d+)-/);
+              if (!usMatch) return false;
+
+              const extractedUsId = usMatch[1]; // e.g., "US1" or "US001"
+              return normalizeUsId(extractedUsId) === normalizedCurrentUs;
+            });
+          }
+        }
       }
-      const acList = acMatch[1].trim();
-
-      // Check if any AC in this task belongs to current User Story
-      // AC-US1-01 → US-001
-      // AC-US001-01 → US-001
-      const acIds = acList.split(',').map((ac) => ac.trim());
-      const belongsToThisUS = acIds.some((acId) => {
-        // Extract US ID from AC-ID
-        // AC-US1-01 → US1 → US-001
-        // AC-US001-01 → US001 → US-001
-        const usMatch = acId.match(/AC-([A-Z]+\d+)-/);
-        if (!usMatch) return false;
-
-        // Normalize to US-XXX format (pad with zeros)
-        const extractedUsId = usMatch[1]; // e.g., "US1" or "US001"
-        const extractedNum = extractedUsId.replace(/^US/, ''); // "1" or "001"
-        const normalizedExtracted = `US-${extractedNum.padStart(3, '0')}`; // "US-001"
-
-        const currentNum = userStoryId.replace(/^US-?/, ''); // "001" or "1"
-        const normalizedCurrent = `US-${currentNum.padStart(3, '0')}`; // "US-001"
-
-        return normalizedExtracted === normalizedCurrent;
-      });
 
       if (!belongsToThisUS) {
         continue;
@@ -303,6 +321,10 @@ export class CompletionCalculator {
       const statusMatch = taskBody.match(/\*\*Status\*\*:\s*\[([x ])\]/);
       const completed = statusMatch ? statusMatch[1] === 'x' : false;
 
+      // Extract AC list for userStories field (for backward compatibility)
+      const acMatch = taskBody.match(/\*\*(?:Satisfies ACs?|AC)\*\*:\s*([^\n]+)/);
+      const acIds = acMatch ? acMatch[1].trim().split(',').map((ac) => ac.trim()) : [];
+
       tasks.push({
         id: taskId,
         title: taskTitle,

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

@@ -0,0 +1,172 @@
+#!/bin/bash
+
+# SpecWeave JIRA Sync Hook
+# Runs after task completion to sync progress to JIRA Issues
+#
+# This hook is part of the specweave-jira plugin and handles:
+# - Syncing task completion state to JIRA issues
+# - Updating JIRA issue status based on increment progress
+#
+# Dependencies:
+# - Node.js for running sync scripts
+# - jq for JSON parsing
+# - metadata.json must have .jira.issue field
+# - JIRA API credentials in .env
+
+set -e
+
+# ============================================================================
+# PROJECT ROOT DETECTION
+# ============================================================================
+
+# Find project root by searching upward for .specweave/ directory
+find_project_root() {
+  local dir="$1"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/.specweave" ]; then
+      echo "$dir"
+      return 0
+    fi
+    dir="$(dirname "$dir")"
+  done
+  # Fallback: try current directory
+  if [ -d "$(pwd)/.specweave" ]; then
+    pwd
+  else
+    echo "$(pwd)"
+  fi
+}
+
+PROJECT_ROOT="$(find_project_root "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")"
+cd "$PROJECT_ROOT" 2>/dev/null || true
+
+# ============================================================================
+# CONFIGURATION
+# ============================================================================
+
+LOGS_DIR=".specweave/logs"
+DEBUG_LOG="$LOGS_DIR/hooks-debug.log"
+
+mkdir -p "$LOGS_DIR" 2>/dev/null || true
+
+# ============================================================================
+# PRECONDITIONS CHECK
+# ============================================================================
+
+echo "[$(date)] [JIRA] 🔗 JIRA sync hook fired" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# Detect current increment
+CURRENT_INCREMENT=$(ls -td .specweave/increments/*/ 2>/dev/null | xargs -n1 basename | grep -v "_backlog" | grep -v "_archive" | grep -v "_working" | head -1)
+
+if [ -z "$CURRENT_INCREMENT" ]; then
+  echo "[$(date)] [JIRA] ℹ️  No active increment, skipping JIRA sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# Check for metadata.json
+METADATA_FILE=".specweave/increments/$CURRENT_INCREMENT/metadata.json"
+
+if [ ! -f "$METADATA_FILE" ]; then
+  echo "[$(date)] [JIRA] ℹ️  No metadata.json for $CURRENT_INCREMENT, skipping JIRA sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# Check for JIRA issue link
+if ! command -v jq &> /dev/null; then
+  echo "[$(date)] [JIRA] ⚠️  jq not found, skipping JIRA sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+JIRA_ISSUE=$(jq -r '.jira.issue // empty' "$METADATA_FILE" 2>/dev/null)
+
+if [ -z "$JIRA_ISSUE" ]; then
+  echo "[$(date)] [JIRA] ℹ️  No JIRA issue linked to $CURRENT_INCREMENT, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# Check for Node.js
+if ! command -v node &> /dev/null; then
+  echo "[$(date)] [JIRA] ⚠️  Node.js not found, skipping JIRA sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# Check for JIRA sync script
+if [ ! -f "dist/commands/jira-sync.js" ]; then
+  echo "[$(date)] [JIRA] ⚠️  jira-sync.js not found, skipping JIRA sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# ============================================================================
+# JIRA SYNC LOGIC
+# ============================================================================
+
+echo "[$(date)] [JIRA] 🔄 Syncing to JIRA issue $JIRA_ISSUE" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# Run JIRA sync command (non-blocking)
+node dist/commands/jira-sync.js "$CURRENT_INCREMENT" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+  echo "[$(date)] [JIRA] ⚠️  Failed to sync to JIRA (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
+}
+
+echo "[$(date)] [JIRA] ✅ JIRA sync complete" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# ============================================================================
+# SPEC COMMIT SYNC (NEW!)
+# ============================================================================
+
+echo "[$(date)] [JIRA] 🔗 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)] [JIRA] 🚀 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 jira \
+    2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+      echo "[$(date)] [JIRA] ⚠️  Spec commit sync failed (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
+    }
+
+  echo "[$(date)] [JIRA] ✅ Spec commit sync complete" >> "$DEBUG_LOG" 2>/dev/null || true
+else
+  echo "[$(date)] [JIRA] ℹ️  Spec commit sync not available (node or script not found)" >> "$DEBUG_LOG" 2>/dev/null || true
+fi
+
+# ============================================================================
+# OUTPUT TO CLAUDE
+# ============================================================================
+
+cat <<EOF
+{
+  "continue": true
+}
+EOF

package/plugins/specweave-jira/lib/enhanced-jira-sync.js

@@ -1,6 +1,6 @@
-import { EnhancedContentBuilder } from "../../../src/core/sync/enhanced-content-builder.js";
-import { SpecIncrementMapper } from "../../../src/core/sync/spec-increment-mapper.js";
-import { parseSpecContent } from "../../../src/core/spec-content-sync.js";
+import { EnhancedContentBuilder } from "../../../dist/src/core/sync/enhanced-content-builder.js";
+import { SpecIncrementMapper } from "../../../dist/src/core/sync/spec-increment-mapper.js";
+import { parseSpecContent } from "../../../dist/src/core/spec-content-sync.js";
 import * as path from "path";
 import * as fs from "fs/promises";
 async function syncSpecToJiraWithEnhancedContent(options) {