specweave 0.22.13 → 0.23.0

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

@@ -37,31 +37,33 @@ fi
 ISSUE_NUMBER=$(jq -r '.github.issue // empty' "$METADATA_FILE" 2>/dev/null)
 
 if [ -z "$ISSUE_NUMBER" ] || [ "$ISSUE_NUMBER" = "null" ]; then
-  # No GitHub issue linked - skip GitHub closure but still update status line
-  HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-  bash "$HOOK_DIR/lib/update-status-line.sh" 2>/dev/null || true
-  exit 0
-fi
-
-# Check if gh CLI is available
-if ! command -v gh &> /dev/null; then
-  echo "⚠️  $HOOK_NAME: GitHub CLI (gh) not found - skipping issue closure" >&2
-  exit 0
+  # No GitHub issue linked - skip GitHub closure but continue with sync
+  echo "ℹ️  No GitHub issue linked to increment $INCREMENT_ID"
+  SKIP_GITHUB_CLOSURE=true
+else
+  SKIP_GITHUB_CLOSURE=false
 fi
 
-# Check if issue is already closed
-ISSUE_STATE=$(gh issue view "$ISSUE_NUMBER" --json state --jq '.state' 2>/dev/null || echo "")
+# ============================================================================
+# GITHUB ISSUE CLOSURE (if linked)
+# ============================================================================
 
-if [ "$ISSUE_STATE" = "CLOSED" ]; then
-  echo "✓ GitHub issue #$ISSUE_NUMBER already closed"
-  exit 0
-fi
+if [ "$SKIP_GITHUB_CLOSURE" = "false" ]; then
+  # Check if gh CLI is available
+  if ! command -v gh &> /dev/null; then
+    echo "⚠️  $HOOK_NAME: GitHub CLI (gh) not found - skipping issue closure" >&2
+  else
+    # Check if issue is already closed
+    ISSUE_STATE=$(gh issue view "$ISSUE_NUMBER" --json state --jq '.state' 2>/dev/null || echo "")
 
-# Close the GitHub issue with completion message
-echo "🔗 Closing GitHub issue #$ISSUE_NUMBER for increment $INCREMENT_ID..."
+    if [ "$ISSUE_STATE" = "CLOSED" ]; then
+      echo "✓ GitHub issue #$ISSUE_NUMBER already closed"
+    else
+      # Close the GitHub issue with completion message
+      echo "🔗 Closing GitHub issue #$ISSUE_NUMBER for increment $INCREMENT_ID..."
 
-# Create completion comment
-COMPLETION_COMMENT="## ✅ Increment Complete
+      # Create completion comment
+      COMPLETION_COMMENT="## ✅ Increment Complete
 
 Increment \`$INCREMENT_ID\` has been marked as complete.
 
@@ -74,16 +76,156 @@ Increment \`$INCREMENT_ID\` has been marked as complete.
 ---
 🤖 Auto-closed by SpecWeave post-increment-completion hook"
 
-# Close issue with comment
-gh issue close "$ISSUE_NUMBER" --comment "$COMPLETION_COMMENT" 2>/dev/null || {
-  echo "⚠️  Failed to close issue #$ISSUE_NUMBER" >&2
-  exit 0
-}
+      # Close issue with comment
+      gh issue close "$ISSUE_NUMBER" --comment "$COMPLETION_COMMENT" 2>/dev/null || {
+        echo "⚠️  Failed to close issue #$ISSUE_NUMBER" >&2
+      }
 
-echo "✅ GitHub issue #$ISSUE_NUMBER closed successfully"
+      echo "✅ GitHub issue #$ISSUE_NUMBER closed successfully"
+    fi
+  fi
+fi
 
 # Update status line cache (increment no longer open)
 HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 bash "$HOOK_DIR/lib/update-status-line.sh" 2>/dev/null || true
 
+# ============================================================================
+# SYNC LIVING DOCS (NEW in v0.24.0 - Critical Missing Feature)
+# ============================================================================
+# After increment completes, perform FULL living docs sync to ensure:
+# - Feature specs finalized with all user stories marked complete
+# - ADRs created/updated with final architecture decisions
+# - Architecture docs updated with implementation details
+# - Delivery docs updated with what was shipped
+# - Internal/public docs reflect completed work
+#
+# This is the FINAL, COMPREHENSIVE sync that happens once per increment.
+# (Task-level sync in post-task-completion.sh handles incremental updates)
+#
+# Architecture Decision: Non-blocking execution
+# - If sync fails, log error but don't crash hook (GitHub issue already closed)
+# - Living docs can be manually synced later with /specweave:sync-docs
+# - Failure mode: Graceful degradation (increment still completes)
+
+if command -v node &> /dev/null; then
+  echo ""
+  echo "📚 Performing final living docs sync for increment $INCREMENT_ID..."
+
+  # ========================================================================
+  # EXTRACT FEATURE ID (v0.23.0+)
+  # ========================================================================
+  # Extract epic field from spec.md frontmatter (e.g., epic: FS-047)
+  # This ensures sync uses the explicitly defined feature ID rather than
+  # auto-generating one, maintaining traceability with living docs structure.
+
+  FEATURE_ID=""
+  SPEC_MD_PATH="$INCREMENT_DIR/spec.md"
+
+  if [ -f "$SPEC_MD_PATH" ]; then
+    # Extract epic field from YAML frontmatter
+    FEATURE_ID=$(awk '
+      BEGIN { in_frontmatter=0 }
+      /^---$/ {
+        if (in_frontmatter == 0) {
+          in_frontmatter=1; next
+        } else {
+          exit
+        }
+      }
+      in_frontmatter == 1 && /^epic:/ {
+        gsub(/^epic:[ \t]*/, "");
+        gsub(/["'\'']/, "");
+        print;
+        exit
+      }
+    ' "$SPEC_MD_PATH" | tr -d '\r\n')
+
+    if [ -n "$FEATURE_ID" ]; then
+      echo "  📎 Using feature ID from spec.md: $FEATURE_ID"
+    else
+      echo "  ℹ️  No epic field found in spec.md - will auto-generate feature ID"
+    fi
+  else
+    echo "  ⚠️  spec.md not found at $SPEC_MD_PATH" >&2
+  fi
+
+  # ========================================================================
+  # EXTRACT PROJECT ID (v0.20.0+)
+  # ========================================================================
+  # Extract activeProject from config.json (defaults to "default")
+  # Supports multi-project mode where specs are organized by project.
+
+  PROJECT_ID="default"
+  CONFIG_PATH="$PROJECT_ROOT/.specweave/config.json"
+
+  if [ -f "$CONFIG_PATH" ]; then
+    if command -v jq >/dev/null 2>&1; then
+      ACTIVE_PROJECT=$(jq -r '.activeProject // "default"' "$CONFIG_PATH" 2>/dev/null || echo "default")
+      if [ -n "$ACTIVE_PROJECT" ] && [ "$ACTIVE_PROJECT" != "null" ]; then
+        PROJECT_ID="$ACTIVE_PROJECT"
+      fi
+    fi
+  fi
+  echo "  📁 Project ID: $PROJECT_ID"
+
+  # ========================================================================
+  # LOCATE SYNC SCRIPT
+  # ========================================================================
+  # Find sync-living-docs.js in order of preference:
+  # 1. In-place compiled (development, esbuild output)
+  # 2. Local dist (development, tsc output)
+  # 3. node_modules (installed as dependency)
+  # 4. Plugin marketplace (Claude Code global installation)
+
+  SYNC_SCRIPT=""
+  if [ -f "$PROJECT_ROOT/plugins/specweave/lib/hooks/sync-living-docs.js" ]; then
+    # Development: Use in-place compiled hooks (esbuild, not tsc)
+    SYNC_SCRIPT="$PROJECT_ROOT/plugins/specweave/lib/hooks/sync-living-docs.js"
+    echo "  🔧 Using in-place compiled hook (development mode)"
+  elif [ -f "$PROJECT_ROOT/dist/plugins/specweave/lib/hooks/sync-living-docs.js" ]; then
+    # Development: Use project's compiled files (has node_modules)
+    SYNC_SCRIPT="$PROJECT_ROOT/dist/plugins/specweave/lib/hooks/sync-living-docs.js"
+    echo "  🔧 Using local dist (development mode)"
+  elif [ -f "$PROJECT_ROOT/node_modules/specweave/dist/plugins/specweave/lib/hooks/sync-living-docs.js" ]; then
+    # Installed as dependency: Use node_modules version
+    SYNC_SCRIPT="$PROJECT_ROOT/node_modules/specweave/dist/plugins/specweave/lib/hooks/sync-living-docs.js"
+    echo "  📦 Using node_modules version"
+  elif [ -n "${CLAUDE_PLUGIN_ROOT}" ] && [ -f "${CLAUDE_PLUGIN_ROOT}/lib/hooks/sync-living-docs.js" ]; then
+    # Fallback: Plugin marketplace (may fail if deps missing)
+    SYNC_SCRIPT="${CLAUDE_PLUGIN_ROOT}/lib/hooks/sync-living-docs.js"
+    echo "  🌐 Using plugin marketplace version"
+  fi
+
+  # ========================================================================
+  # EXECUTE SYNC
+  # ========================================================================
+  # Run living docs sync with feature ID and project ID
+  # Non-blocking: Errors logged but don't crash hook
+
+  if [ -n "$SYNC_SCRIPT" ]; then
+    # Pass FEATURE_ID and PROJECT_ID as environment variables if available
+    if [ -n "$FEATURE_ID" ]; then
+      (cd "$PROJECT_ROOT" && FEATURE_ID="$FEATURE_ID" PROJECT_ID="$PROJECT_ID" node "$SYNC_SCRIPT" "$INCREMENT_ID") 2>&1 || {
+        echo "  ⚠️  Failed to sync living docs (non-blocking - you can run /specweave:sync-docs manually)" >&2
+      }
+    else
+      # No explicit feature ID - sync will auto-generate
+      (cd "$PROJECT_ROOT" && PROJECT_ID="$PROJECT_ID" node "$SYNC_SCRIPT" "$INCREMENT_ID") 2>&1 || {
+        echo "  ⚠️  Failed to sync living docs (non-blocking - you can run /specweave:sync-docs manually)" >&2
+      }
+    fi
+    echo "  ✅ Living docs sync complete"
+    echo ""
+  else
+    echo "  ⚠️  sync-living-docs.js not found in any location - skipping living docs sync" >&2
+    echo "  💡 To manually sync: /specweave:sync-docs update" >&2
+    echo ""
+  fi
+else
+  echo "  ⚠️  Node.js not found - skipping living docs sync" >&2
+  echo "  💡 Install Node.js to enable automatic living docs sync" >&2
+  echo ""
+fi
+
 exit 0

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

@@ -684,16 +684,44 @@ EOF
 
   translate_living_docs_specs "$increment_id"
 
-  # 7. Increment-level GitHub issue creation (for single-repo projects)
+  # ============================================================================
+  # INCREMENT-LEVEL GITHUB ISSUE CREATION (DEPRECATED v0.24.0+)
+  # ============================================================================
+  #
+  # ⚠️  DEPRECATED: SpecWeave now syncs ONLY at User Story level.
+  #
+  # Feature/Increment-level issues like "[FS-047] Title" are NO LONGER created.
+  # Instead, use:
+  #   /specweave-github:sync FS-047
+  #
+  # This creates PROPER User Story-level issues:
+  #   [FS-047][US-001] User Story Title
+  #   [FS-047][US-002] User Story Title
+  #   etc.
+  #
+  # @see .specweave/increments/0047-us-task-linkage/reports/GITHUB-TITLE-FORMAT-FIX-PLAN.md
+  # ============================================================================
+
+  # 7. Increment-level GitHub issue creation (DEPRECATED - disabled by default)
   log_info ""
   log_info "🔗 Checking GitHub issue auto-creation..."
 
-  # 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 upsert permission is enabled in config (v0.24.0+: Three-Permission Architecture)
+  local can_upsert=$(cat "$CONFIG_FILE" 2>/dev/null | grep -A 5 '"sync"' | grep -A 5 '"settings"' | grep -o '"canUpsertInternalItems"[[:space:]]*:[[:space:]]*\(true\|false\)' | grep -o '\(true\|false\)' || echo "false")
 
-  log_debug "Auto-create GitHub issue: $auto_create"
+  # DEPRECATED: Override to false unless explicitly enabled via env var
+  # This entire section is deprecated - use /specweave-github:sync for User Story-level issues
+  if [ "$SPECWEAVE_ENABLE_INCREMENT_GITHUB_SYNC" != "true" ]; then
+    can_upsert="false"
+    log_debug "Increment GitHub sync disabled (use /specweave-github:sync for User Story-level issues)"
+  fi
+
+  log_debug "Can upsert internal items (deprecated increment sync): $can_upsert"
+  local auto_create="$can_upsert"  # Backward compatibility alias
 
   if [ "$auto_create" = "true" ]; then
+    log_info "  ⚠️  WARNING: Increment-level sync is DEPRECATED"
+    log_info "  ✅ Use /specweave-github:sync for [FS-XXX][US-YYY] format"
     log_info "  📦 Auto-create enabled, checking for GitHub CLI..."
 
     # ============================================================================
@@ -830,6 +858,122 @@ EOF_MINIMAL
     fi
   fi
 
+  # ============================================================================
+  # LIVING DOCS SYNC (NEW - v0.23.0+, Increment 0047)
+  # ============================================================================
+  # CRITICAL: Sync increment spec to living docs structure IMMEDIATELY
+  # after increment creation (not just on task completion)
+  #
+  # Why this matters:
+  # - Creates FS-XXX feature folder with User Story files
+  # - Syncs acceptance criteria and task linkages
+  # - Enables traceability from the moment increment is planned
+  #
+  # Previous behavior (BROKEN):
+  # - Living docs only synced AFTER first task completion
+  # - New increments had empty living docs until tasks marked complete
+  # - Manual /specweave:sync-docs required for every new increment
+  #
+  # New behavior (FIXED):
+  # - Living docs auto-sync during increment creation
+  # - FS-XXX folder created with all User Stories immediately
+  # - No manual intervention needed
+  #
+  # @see .specweave/increments/0047-us-task-linkage/ (US-Task Linkage)
+  # ============================================================================
+
+  log_info ""
+  log_info "📚 Syncing living docs for new increment..."
+
+  if command -v node &> /dev/null && [ -n "$increment_id" ]; then
+    # Extract feature ID from spec.md frontmatter (epic: FS-047)
+    local FEATURE_ID=""
+    local spec_md_path="$increment_dir/spec.md"
+
+    if [ -f "$spec_md_path" ]; then
+      FEATURE_ID=$(awk '
+        BEGIN { in_frontmatter=0 }
+        /^---$/ {
+          if (in_frontmatter == 0) {
+            in_frontmatter=1; next
+          } else {
+            exit
+          }
+        }
+        in_frontmatter == 1 && /^epic:/ {
+          gsub(/^epic:[ \t]*/, "");
+          gsub(/["'\'']/, "");
+          print;
+          exit
+        }
+      ' "$spec_md_path" | tr -d '\r\n')
+
+      if [ -n "$FEATURE_ID" ]; then
+        log_debug "  📎 Extracted feature ID: $FEATURE_ID"
+      else
+        log_debug "  ⚠️  No epic field in spec.md, sync will auto-generate ID"
+      fi
+    fi
+
+    # Extract project ID from config (defaults to "default")
+    local PROJECT_ID="default"
+    if [ -f "$CONFIG_FILE" ]; then
+      if command -v jq >/dev/null 2>&1; then
+        local active_project=$(jq -r '.multiProject.activeProject // .project.name // "default"' "$CONFIG_FILE" 2>/dev/null)
+        if [ -n "$active_project" ] && [ "$active_project" != "null" ]; then
+          PROJECT_ID="$active_project"
+        fi
+      fi
+    fi
+    log_debug "  📁 Project ID: $PROJECT_ID"
+
+    # Determine sync script location (same logic as post-task-completion.sh)
+    local SYNC_SCRIPT=""
+    if [ -f "$PROJECT_ROOT/plugins/specweave/lib/hooks/sync-living-docs.js" ]; then
+      SYNC_SCRIPT="$PROJECT_ROOT/plugins/specweave/lib/hooks/sync-living-docs.js"
+      log_debug "  Using in-place compiled hook: $SYNC_SCRIPT"
+    elif [ -f "$PROJECT_ROOT/dist/plugins/specweave/lib/hooks/sync-living-docs.js" ]; then
+      SYNC_SCRIPT="$PROJECT_ROOT/dist/plugins/specweave/lib/hooks/sync-living-docs.js"
+      log_debug "  Using local dist: $SYNC_SCRIPT"
+    elif [ -f "$PROJECT_ROOT/node_modules/specweave/dist/plugins/specweave/lib/hooks/sync-living-docs.js" ]; then
+      SYNC_SCRIPT="$PROJECT_ROOT/node_modules/specweave/dist/plugins/specweave/lib/hooks/sync-living-docs.js"
+      log_debug "  Using node_modules: $SYNC_SCRIPT"
+    elif [ -n "${CLAUDE_PLUGIN_ROOT}" ] && [ -f "${CLAUDE_PLUGIN_ROOT}/lib/hooks/sync-living-docs.js" ]; then
+      SYNC_SCRIPT="${CLAUDE_PLUGIN_ROOT}/lib/hooks/sync-living-docs.js"
+      log_debug "  Using plugin marketplace: $SYNC_SCRIPT"
+    fi
+
+    if [ -n "$SYNC_SCRIPT" ]; then
+      log_info "  🔄 Syncing $increment_id to living docs..."
+
+      # Run living docs sync (non-blocking, best-effort)
+      if [ -n "$FEATURE_ID" ]; then
+        (cd "$PROJECT_ROOT" && FEATURE_ID="$FEATURE_ID" PROJECT_ID="$PROJECT_ID" node "$SYNC_SCRIPT" "$increment_id") 2>&1 | \
+          grep -E "✅|❌|⚠️|📚" | while read -r line; do echo "  $line"; done || {
+          log_info "  ⚠️  Living docs sync failed (non-blocking)"
+          log_debug "Sync error, but continuing hook execution"
+        }
+      else
+        (cd "$PROJECT_ROOT" && PROJECT_ID="$PROJECT_ID" node "$SYNC_SCRIPT" "$increment_id") 2>&1 | \
+          grep -E "✅|❌|⚠️|📚" | while read -r line; do echo "  $line"; done || {
+          log_info "  ⚠️  Living docs sync failed (non-blocking)"
+          log_debug "Sync error, but continuing hook execution"
+        }
+      fi
+
+      log_info "  ✅ Living docs sync complete!"
+    else
+      log_info "  ⚠️  sync-living-docs.js not found, skipping auto-sync"
+      log_info "  💡 Run /specweave:sync-docs manually to sync living docs"
+    fi
+  else
+    if ! command -v node &> /dev/null; then
+      log_debug "  ⚠️  Node.js not found, skipping living docs sync"
+    else
+      log_debug "  ⚠️  No increment ID, skipping living docs sync"
+    fi
+  fi
+
   # Note: Spec-level sync (SPECS → GitHub Projects/JIRA Epics) is handled separately
   # See: /specweave-github:sync-spec, /specweave-jira:sync-spec, /specweave-ado:sync-spec
 

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

@@ -200,7 +200,68 @@ fi
 
 if command -v node &> /dev/null; then
   if [ -n "$CURRENT_INCREMENT" ]; then
-    echo "[$(date)] 📚 Checking living docs sync for $CURRENT_INCREMENT" >> "$DEBUG_LOG" 2>/dev/null || true
+    # ========================================================================
+    # SKIP ARCHIVED INCREMENTS (CRITICAL - prevents folder recreation)
+    # ========================================================================
+    # If increment is archived, skip living docs sync entirely
+    # This prevents recreating archived feature folders in active location
+    # See: ULTRATHINK-ARCHIVE-REORGANIZATION-BUG.md for full analysis
+    if [ -d ".specweave/increments/_archive/$CURRENT_INCREMENT" ]; then
+      echo "[$(date)] ⏭️  Skipping living docs sync for archived increment $CURRENT_INCREMENT" >> "$DEBUG_LOG" 2>/dev/null || true
+    else
+      echo "[$(date)] 📚 Checking living docs sync for $CURRENT_INCREMENT" >> "$DEBUG_LOG" 2>/dev/null || true
+
+      # ========================================================================
+      # EXTRACT FEATURE ID (NEW in v0.23.0 - Increment 0047: US-Task Linkage)
+      # ========================================================================
+    # Extract epic field from spec.md frontmatter (e.g., epic: FS-047)
+    # This ensures sync uses the explicitly defined feature ID rather than
+    # auto-generating one, maintaining traceability with living docs structure.
+
+    FEATURE_ID=""
+    SPEC_MD_PATH=".specweave/increments/$CURRENT_INCREMENT/spec.md"
+
+    if [ -f "$SPEC_MD_PATH" ]; then
+      # Extract epic field from YAML frontmatter
+      FEATURE_ID=$(awk '
+        BEGIN { in_frontmatter=0 }
+        /^---$/ {
+          if (in_frontmatter == 0) {
+            in_frontmatter=1; next
+          } else {
+            exit
+          }
+        }
+        in_frontmatter == 1 && /^epic:/ {
+          gsub(/^epic:[ \t]*/, "");
+          gsub(/["'\'']/, "");
+          print;
+          exit
+        }
+      ' "$SPEC_MD_PATH" | tr -d '\r\n')
+
+      if [ -n "$FEATURE_ID" ]; then
+        echo "[$(date)]   📎 Extracted feature ID from spec.md: $FEATURE_ID" >> "$DEBUG_LOG" 2>/dev/null || true
+      else
+        echo "[$(date)]   ⚠️  No epic field found in spec.md frontmatter" >> "$DEBUG_LOG" 2>/dev/null || true
+        echo "[$(date)]   ℹ️  Sync will auto-generate feature ID from increment number" >> "$DEBUG_LOG" 2>/dev/null || true
+      fi
+    else
+      echo "[$(date)]   ⚠️  spec.md not found at $SPEC_MD_PATH" >> "$DEBUG_LOG" 2>/dev/null || true
+    fi
+
+    # Extract project ID from config or metadata (defaults to "default")
+    PROJECT_ID="default"
+    if [ -f ".specweave/config.json" ]; then
+      # Try to extract activeProject from config
+      if command -v jq >/dev/null 2>&1; then
+        ACTIVE_PROJECT=$(jq -r '.activeProject // "default"' ".specweave/config.json" 2>/dev/null || echo "default")
+        if [ -n "$ACTIVE_PROJECT" ] && [ "$ACTIVE_PROJECT" != "null" ]; then
+          PROJECT_ID="$ACTIVE_PROJECT"
+        fi
+      fi
+    fi
+    echo "[$(date)]   📁 Project ID: $PROJECT_ID" >> "$DEBUG_LOG" 2>/dev/null || true
 
     # Determine which sync script to use (project local or global)
     SYNC_SCRIPT=""
@@ -223,13 +284,22 @@ if command -v node &> /dev/null; then
     fi
 
     if [ -n "$SYNC_SCRIPT" ]; then
-      # Run living docs sync (non-blocking, best-effort)
-      (cd "$PROJECT_ROOT" && node "$SYNC_SCRIPT" "$CURRENT_INCREMENT") 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
-        echo "[$(date)] ⚠️  Failed to sync living docs (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
-      }
+      # Run living docs sync with feature ID (non-blocking, best-effort)
+      # Pass FEATURE_ID and PROJECT_ID as environment variables if available
+      if [ -n "$FEATURE_ID" ]; then
+        (cd "$PROJECT_ROOT" && FEATURE_ID="$FEATURE_ID" PROJECT_ID="$PROJECT_ID" node "$SYNC_SCRIPT" "$CURRENT_INCREMENT") 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+          echo "[$(date)] ⚠️  Failed to sync living docs (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
+        }
+      else
+        # No explicit feature ID - sync will auto-generate
+        (cd "$PROJECT_ROOT" && PROJECT_ID="$PROJECT_ID" node "$SYNC_SCRIPT" "$CURRENT_INCREMENT") 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+          echo "[$(date)] ⚠️  Failed to sync living docs (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
+        }
+      fi
     else
       echo "[$(date)] ⚠️  sync-living-docs.js not found in any location" >> "$DEBUG_LOG" 2>/dev/null || true
     fi
+    fi  # Close the archive check 'else' block
   fi
 fi
 

package/plugins/specweave/hooks/post-write-spec.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+#
+# Post-Write Hook: Update Status Line After spec.md or tasks.md Writes
+#
+# Triggers: After Write tool creates/replaces spec.md or tasks.md
+# Action: Updates status line cache to reflect latest AC/task progress
+
+set -e
+
+# Find project root
+find_project_root() {
+  local dir="$PWD"
+  while [[ "$dir" != "/" ]]; do
+    if [[ -d "$dir/.specweave" ]]; then
+      echo "$dir"
+      return 0
+    fi
+    dir=$(dirname "$dir")
+  done
+  echo "$PWD"
+}
+
+PROJECT_ROOT=$(find_project_root)
+
+# Get the file that was written from TOOL_USE_CONTENT environment variable
+WRITTEN_FILE="${TOOL_USE_CONTENT:-}"
+
+# Only update status line if spec.md or tasks.md was written
+if [[ "$WRITTEN_FILE" == *"/spec.md"* ]] || [[ "$WRITTEN_FILE" == *"/tasks.md"* ]]; then
+  # Check if the write is in an increment folder
+  if [[ "$WRITTEN_FILE" == *"/.specweave/increments/"* ]]; then
+    # Run status line update
+    "$PROJECT_ROOT/plugins/specweave/hooks/lib/update-status-line.sh" &>/dev/null || true
+  fi
+fi
+
+exit 0

package/plugins/specweave/lib/hooks/auto-transition.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { AutoTransitionManager } from "../../../../dist/src/core/increment/auto-transition-manager.js";
+import { AutoTransitionManager } from "../vendor/core/increment/auto-transition-manager.js";
 async function main() {
   const event = process.argv[2];
   const incrementId = process.argv[3];

package/plugins/specweave/lib/hooks/auto-transition.ts

@@ -19,7 +19,7 @@
  *   node auto-transition.ts auto-correct 0039-ultra-smart-next-command
  */
 
-import { AutoTransitionManager } from '../../../../dist/src/core/increment/auto-transition-manager.js';
+import { AutoTransitionManager } from '../vendor/core/increment/auto-transition-manager.js';
 
 async function main() {
   const event = process.argv[2];

package/plugins/specweave/lib/hooks/invoke-translator-skill.js

@@ -4,7 +4,7 @@ import {
   prepareTranslation,
   postProcessTranslation,
   getLanguageName
-} from "../../../../dist/src/utils/translation.js";
+} from "../vendor/utils/translation.js";
 async function invokeTranslatorSkill(content, sourceLang, targetLang = "en") {
   try {
     const prepared = prepareTranslation(content, sourceLang, targetLang);

package/plugins/specweave/lib/hooks/invoke-translator-skill.ts

@@ -16,7 +16,7 @@ import {
   postProcessTranslation,
   getLanguageName,
   type SupportedLanguage,
-} from '../../../../dist/src/utils/translation.js';
+} from '../vendor/utils/translation.js';
 
 /**
  * Translation result