specweave 0.28.29 → 0.28.33

package/plugins/specweave/hooks/post-increment-status-change.sh

@@ -1,15 +1,15 @@
 #!/bin/bash
 
-# SpecWeave Post-Increment-Status-Change Hook
+# SpecWeave Post-Increment-Status-Change Hook (v0.28.33)
 # Runs automatically after increment status changes (pause/resume/abandon)
 #
 # Trigger: /specweave:pause, /specweave:resume, /specweave:abandon commands
-# Purpose: Notify GitHub when increment status changes
+# Purpose: Sync GitHub issue state with increment status
 #
 # What it does:
 # 1. Detects status change (paused, resumed, abandoned)
 # 2. Posts comment to GitHub issue
-# 3. Updates metadata
+# 3. NEW (v0.28.33): Reopens issues when resumed, closes when abandoned
 #
 # Usage:
 #   ./post-increment-status-change.sh <incrementId> <newStatus> <reason>
@@ -43,6 +43,7 @@ cd "$PROJECT_ROOT" 2>/dev/null || true
 # Configuration
 LOGS_DIR=".specweave/logs"
 DEBUG_LOG="$LOGS_DIR/hooks-debug.log"
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 mkdir -p "$LOGS_DIR" 2>/dev/null || true
 
@@ -61,7 +62,7 @@ echo "[$(date)] 📊 Status changed: $NEW_STATUS" >> "$DEBUG_LOG" 2>/dev/null ||
 
 # Validate status
 case "$NEW_STATUS" in
-  paused|resumed|abandoned)
+  paused|resumed|abandoned|active|in-progress)
     ;;
   *)
     echo "[$(date)] ⚠️  Unknown status: $NEW_STATUS (skipping sync)" >> "$DEBUG_LOG" 2>/dev/null || true
@@ -89,14 +90,9 @@ if [ ! -f "$METADATA_FILE" ]; then
   exit 0
 fi
 
-# Extract GitHub issue number
+# Extract GitHub issue number (main increment issue)
 GITHUB_ISSUE=$(jq -r '.github.issue // empty' "$METADATA_FILE" 2>/dev/null)
 
-if [ -z "$GITHUB_ISSUE" ]; then
-  echo "[$(date)] ℹ️  No GitHub issue linked, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true
-  exit 0
-fi
-
 # Detect repository
 GITHUB_REMOTE=$(git remote get-url origin 2>/dev/null || echo "")
 REPO_MATCH=$(echo "$GITHUB_REMOTE" | grep -o 'github\.com[:/][^/]*/[^/]*' | sed 's/github\.com[:/]//')
@@ -106,29 +102,122 @@ if [ -z "$REPO_MATCH" ]; then
   exit 0
 fi
 
-echo "[$(date)] 🔄 Posting status change to GitHub issue #$GITHUB_ISSUE" >> "$DEBUG_LOG" 2>/dev/null || true
+# ============================================================================
+# STATUS-BASED ACTIONS (NEW in v0.28.33)
+# ============================================================================
 
-# Build comment based on status
-EMOJI=""
-TITLE=""
 case "$NEW_STATUS" in
-  paused)
-    EMOJI="⏸️"
-    TITLE="Increment Paused"
-    ;;
-  resumed)
-    EMOJI="▶️"
-    TITLE="Increment Resumed"
+  resumed|active|in-progress)
+    # ========================================================================
+    # REOPEN GitHub Issues (NEW)
+    # ========================================================================
+    # When increment is resumed, reopen all closed GitHub issues
+    echo "[$(date)] ▶️  Status is $NEW_STATUS - checking if issues need reopening" >> "$DEBUG_LOG" 2>/dev/null || true
+
+    if command -v node &> /dev/null; then
+      # Find reopen script
+      REOPEN_SCRIPT=""
+      if [ -f "$PROJECT_ROOT/plugins/specweave/lib/hooks/reopen-github-issues.js" ]; then
+        REOPEN_SCRIPT="$PROJECT_ROOT/plugins/specweave/lib/hooks/reopen-github-issues.js"
+      elif [ -f "$PROJECT_ROOT/dist/plugins/specweave/lib/hooks/reopen-github-issues.js" ]; then
+        REOPEN_SCRIPT="$PROJECT_ROOT/dist/plugins/specweave/lib/hooks/reopen-github-issues.js"
+      elif [ -f "$PROJECT_ROOT/node_modules/specweave/dist/plugins/specweave/lib/hooks/reopen-github-issues.js" ]; then
+        REOPEN_SCRIPT="$PROJECT_ROOT/node_modules/specweave/dist/plugins/specweave/lib/hooks/reopen-github-issues.js"
+      elif [ -n "${CLAUDE_PLUGIN_ROOT}" ] && [ -f "${CLAUDE_PLUGIN_ROOT}/lib/hooks/reopen-github-issues.js" ]; then
+        REOPEN_SCRIPT="${CLAUDE_PLUGIN_ROOT}/lib/hooks/reopen-github-issues.js"
+      fi
+
+      if [ -n "$REOPEN_SCRIPT" ]; then
+        # Load GITHUB_TOKEN from .env
+        if [ -f "$PROJECT_ROOT/.env" ]; then
+          GITHUB_TOKEN_FROM_ENV=$(grep -E '^GITHUB_TOKEN=' "$PROJECT_ROOT/.env" 2>/dev/null | head -1 | cut -d'=' -f2- | sed 's/^["'\'']//' | sed 's/["'\'']$//')
+          if [ -n "$GITHUB_TOKEN_FROM_ENV" ]; then
+            export GITHUB_TOKEN="$GITHUB_TOKEN_FROM_ENV"
+          fi
+        fi
+
+        echo "▶️  Reopening GitHub issues for resumed increment..."
+        (cd "$PROJECT_ROOT" && node "$REOPEN_SCRIPT" "$INCREMENT_ID" "${REASON:-Increment resumed}") 2>&1 | tee -a "$DEBUG_LOG" || {
+          echo "[$(date)] ⚠️  Failed to reopen issues (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
+        }
+      else
+        echo "[$(date)] ⚠️  reopen-github-issues.js not found" >> "$DEBUG_LOG" 2>/dev/null || true
+      fi
+    fi
     ;;
+
   abandoned)
-    EMOJI="🗑️"
-    TITLE="Increment Abandoned"
+    # ========================================================================
+    # CLOSE GitHub Issues on Abandon (NEW)
+    # ========================================================================
+    echo "[$(date)] 🗑️  Status is abandoned - closing GitHub issues" >> "$DEBUG_LOG" 2>/dev/null || true
+
+    if command -v node &> /dev/null; then
+      # Find close script
+      CLOSE_SCRIPT=""
+      if [ -f "$PROJECT_ROOT/plugins/specweave/lib/hooks/close-github-issues-abandoned.js" ]; then
+        CLOSE_SCRIPT="$PROJECT_ROOT/plugins/specweave/lib/hooks/close-github-issues-abandoned.js"
+      elif [ -f "$PROJECT_ROOT/dist/plugins/specweave/lib/hooks/close-github-issues-abandoned.js" ]; then
+        CLOSE_SCRIPT="$PROJECT_ROOT/dist/plugins/specweave/lib/hooks/close-github-issues-abandoned.js"
+      elif [ -f "$PROJECT_ROOT/node_modules/specweave/dist/plugins/specweave/lib/hooks/close-github-issues-abandoned.js" ]; then
+        CLOSE_SCRIPT="$PROJECT_ROOT/node_modules/specweave/dist/plugins/specweave/lib/hooks/close-github-issues-abandoned.js"
+      elif [ -n "${CLAUDE_PLUGIN_ROOT}" ] && [ -f "${CLAUDE_PLUGIN_ROOT}/lib/hooks/close-github-issues-abandoned.js" ]; then
+        CLOSE_SCRIPT="${CLAUDE_PLUGIN_ROOT}/lib/hooks/close-github-issues-abandoned.js"
+      fi
+
+      if [ -n "$CLOSE_SCRIPT" ]; then
+        # Load GITHUB_TOKEN from .env
+        if [ -f "$PROJECT_ROOT/.env" ]; then
+          GITHUB_TOKEN_FROM_ENV=$(grep -E '^GITHUB_TOKEN=' "$PROJECT_ROOT/.env" 2>/dev/null | head -1 | cut -d'=' -f2- | sed 's/^["'\'']//' | sed 's/["'\'']$//')
+          if [ -n "$GITHUB_TOKEN_FROM_ENV" ]; then
+            export GITHUB_TOKEN="$GITHUB_TOKEN_FROM_ENV"
+          fi
+        fi
+
+        echo "🗑️  Closing GitHub issues for abandoned increment..."
+        (cd "$PROJECT_ROOT" && node "$CLOSE_SCRIPT" "$INCREMENT_ID" "${REASON:-Increment abandoned}") 2>&1 | tee -a "$DEBUG_LOG" || {
+          echo "[$(date)] ⚠️  Failed to close issues (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
+        }
+      else
+        echo "[$(date)] ⚠️  close-github-issues-abandoned.js not found" >> "$DEBUG_LOG" 2>/dev/null || true
+      fi
+    fi
     ;;
-esac
 
-TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+  paused)
+    # Paused: Just post comment (no close/reopen)
+    echo "[$(date)] ⏸️  Status is paused - posting comment only" >> "$DEBUG_LOG" 2>/dev/null || true
+    ;;
+esac
 
-COMMENT="$EMOJI **$TITLE**
+# ============================================================================
+# POST COMMENT TO MAIN ISSUE (always, for all status changes)
+# ============================================================================
+
+if [ -n "$GITHUB_ISSUE" ]; then
+  echo "[$(date)] 🔄 Posting status change to GitHub issue #$GITHUB_ISSUE" >> "$DEBUG_LOG" 2>/dev/null || true
+
+  # Build comment based on status
+  EMOJI=""
+  TITLE=""
+  case "$NEW_STATUS" in
+    paused)
+      EMOJI="⏸️"
+      TITLE="Increment Paused"
+      ;;
+    resumed|active|in-progress)
+      EMOJI="▶️"
+      TITLE="Increment Resumed"
+      ;;
+    abandoned)
+      EMOJI="🗑️"
+      TITLE="Increment Abandoned"
+      ;;
+  esac
+
+  TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+  COMMENT="$EMOJI **$TITLE**
 
 **Reason**: ${REASON:-Not specified}
 
@@ -137,15 +226,17 @@ COMMENT="$EMOJI **$TITLE**
 ---
 🤖 Auto-updated by SpecWeave"
 
-# Post comment
-echo "$COMMENT" | gh issue comment "$GITHUB_ISSUE" --body-file - 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
-  echo "[$(date)] ⚠️  Failed to post comment (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
-}
+  # Post comment
+  echo "$COMMENT" | gh issue comment "$GITHUB_ISSUE" --body-file - 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+    echo "[$(date)] ⚠️  Failed to post comment (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
+  }
 
-echo "[$(date)] ✅ Status change synced to GitHub" >> "$DEBUG_LOG" 2>/dev/null || true
+  echo "[$(date)] ✅ Status change synced to GitHub" >> "$DEBUG_LOG" 2>/dev/null || true
+else
+  echo "[$(date)] ℹ️  No main GitHub issue linked" >> "$DEBUG_LOG" 2>/dev/null || true
+fi
 
 # Update status line cache (status changed - may affect which increment is "current")
-HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 bash "$HOOK_DIR/lib/update-status-line.sh" 2>/dev/null || true
 
 # Return success (non-blocking)

package/plugins/specweave/hooks/session-start-reconcile.sh

@@ -0,0 +1,139 @@
+#!/bin/bash
+
+# SpecWeave Session Start Reconcile Hook (NEW in v0.28.33)
+#
+# Runs on Claude Code session start to detect and fix GitHub status drift.
+# This is a lightweight hook that runs in background to not block startup.
+#
+# Features:
+# - Debounced: Only runs if >1 hour since last reconcile
+# - Non-blocking: Runs in background, errors logged but don't crash
+# - Optional: Controlled by config.sync.github.autoReconcileOnSessionStart
+#
+# Trigger: SessionStart hook event
+
+set +e  # Prevent crashes
+
+# EMERGENCY KILL SWITCH
+if [[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]]; then
+  exit 0
+fi
+
+# 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)
+CONFIG_FILE="$PROJECT_ROOT/.specweave/config.json"
+STATE_DIR="$PROJECT_ROOT/.specweave/state"
+LAST_RECONCILE_FILE="$STATE_DIR/.last-reconcile-timestamp"
+DEBUG_LOG="$PROJECT_ROOT/.specweave/logs/hooks-debug.log"
+
+mkdir -p "$STATE_DIR" 2>/dev/null || true
+mkdir -p "$(dirname "$DEBUG_LOG")" 2>/dev/null || true
+
+# Consume stdin (required for hooks)
+cat > /dev/null
+
+echo "[$(date)] session-start-reconcile: Hook fired" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# ============================================================================
+# CHECK IF AUTO-RECONCILE IS ENABLED
+# ============================================================================
+
+if [[ ! -f "$CONFIG_FILE" ]]; then
+  echo "[$(date)] session-start-reconcile: No config.json - skipping" >> "$DEBUG_LOG" 2>/dev/null || true
+  exit 0
+fi
+
+# Check config (requires jq)
+if ! command -v jq &> /dev/null; then
+  echo "[$(date)] session-start-reconcile: jq not found - skipping" >> "$DEBUG_LOG" 2>/dev/null || true
+  exit 0
+fi
+
+# Check if auto-reconcile is enabled
+AUTO_RECONCILE=$(jq -r '.sync.github.autoReconcileOnSessionStart // false' "$CONFIG_FILE" 2>/dev/null)
+
+if [[ "$AUTO_RECONCILE" != "true" ]]; then
+  echo "[$(date)] session-start-reconcile: Disabled in config - skipping" >> "$DEBUG_LOG" 2>/dev/null || true
+  exit 0
+fi
+
+echo "[$(date)] session-start-reconcile: Auto-reconcile enabled" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# ============================================================================
+# DEBOUNCE: Only run if >1 hour since last reconcile
+# ============================================================================
+
+DEBOUNCE_SECONDS=3600  # 1 hour
+
+if [[ -f "$LAST_RECONCILE_FILE" ]]; then
+  LAST_TIMESTAMP=$(cat "$LAST_RECONCILE_FILE" 2>/dev/null || echo "0")
+  CURRENT_TIMESTAMP=$(date +%s)
+  ELAPSED=$((CURRENT_TIMESTAMP - LAST_TIMESTAMP))
+
+  if [[ $ELAPSED -lt $DEBOUNCE_SECONDS ]]; then
+    REMAINING=$((DEBOUNCE_SECONDS - ELAPSED))
+    echo "[$(date)] session-start-reconcile: Debounced - last run ${ELAPSED}s ago (wait ${REMAINING}s)" >> "$DEBUG_LOG" 2>/dev/null || true
+    exit 0
+  fi
+fi
+
+echo "[$(date)] session-start-reconcile: Debounce passed - running reconcile" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# Update timestamp BEFORE running (prevents concurrent runs)
+date +%s > "$LAST_RECONCILE_FILE"
+
+# ============================================================================
+# RUN RECONCILE IN BACKGROUND (non-blocking)
+# ============================================================================
+
+if ! command -v node &> /dev/null; then
+  echo "[$(date)] session-start-reconcile: Node.js not found - skipping" >> "$DEBUG_LOG" 2>/dev/null || true
+  exit 0
+fi
+
+# Find reconcile script
+RECONCILE_SCRIPT=""
+if [[ -f "$PROJECT_ROOT/plugins/specweave/lib/hooks/session-start-reconcile-worker.js" ]]; then
+  RECONCILE_SCRIPT="$PROJECT_ROOT/plugins/specweave/lib/hooks/session-start-reconcile-worker.js"
+elif [[ -f "$PROJECT_ROOT/dist/plugins/specweave/lib/hooks/session-start-reconcile-worker.js" ]]; then
+  RECONCILE_SCRIPT="$PROJECT_ROOT/dist/plugins/specweave/lib/hooks/session-start-reconcile-worker.js"
+elif [[ -f "$PROJECT_ROOT/node_modules/specweave/dist/plugins/specweave/lib/hooks/session-start-reconcile-worker.js" ]]; then
+  RECONCILE_SCRIPT="$PROJECT_ROOT/node_modules/specweave/dist/plugins/specweave/lib/hooks/session-start-reconcile-worker.js"
+fi
+
+if [[ -z "$RECONCILE_SCRIPT" ]]; then
+  echo "[$(date)] session-start-reconcile: Worker script not found - skipping" >> "$DEBUG_LOG" 2>/dev/null || true
+  exit 0
+fi
+
+# Load GITHUB_TOKEN from .env
+if [[ -f "$PROJECT_ROOT/.env" ]]; then
+  GITHUB_TOKEN_FROM_ENV=$(grep -E '^GITHUB_TOKEN=' "$PROJECT_ROOT/.env" 2>/dev/null | head -1 | cut -d'=' -f2- | sed 's/^["'\'']//' | sed 's/["'\'']$//')
+  if [[ -n "$GITHUB_TOKEN_FROM_ENV" ]]; then
+    export GITHUB_TOKEN="$GITHUB_TOKEN_FROM_ENV"
+  fi
+fi
+
+# Run in background with nohup (fully detached)
+# Output goes to debug log, doesn't block session start
+echo "[$(date)] session-start-reconcile: Starting background reconcile" >> "$DEBUG_LOG" 2>/dev/null || true
+
+(
+  cd "$PROJECT_ROOT" && \
+  node "$RECONCILE_SCRIPT" >> "$DEBUG_LOG" 2>&1
+) &
+
+# Immediately exit (don't wait for background job)
+exit 0

package/plugins/specweave/lib/hooks/close-github-issues-abandoned.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import { GitHubReconciler } from "../vendor/sync/github-reconciler.js";
+import { consoleLogger } from "../vendor/utils/logger.js";
+async function main() {
+  const incrementId = process.argv[2];
+  const reason = process.argv[3] || "Increment abandoned";
+  if (!incrementId) {
+    console.error("Usage: node close-github-issues-abandoned.js <increment-id> [reason]");
+    process.exit(1);
+  }
+  console.log("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+  console.log(`\u{1F5D1}\uFE0F  CLOSING GITHUB ISSUES (ABANDONED): ${incrementId}`);
+  console.log("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+  const projectRoot = process.cwd();
+  const result = await GitHubReconciler.closeAbandonedIncrementIssues(
+    projectRoot,
+    incrementId,
+    reason,
+    consoleLogger
+  );
+  console.log("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+  if (result.closed > 0) {
+    console.log(`\u2705 Closed ${result.closed} GitHub issue(s)`);
+  } else {
+    console.log("\u2139\uFE0F  No issues needed closing (all already closed or none linked)");
+  }
+  if (result.errors.length > 0) {
+    console.log(`\u26A0\uFE0F  ${result.errors.length} error(s):`);
+    result.errors.forEach((err) => console.log(`   - ${err}`));
+  }
+  console.log("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n");
+  process.exit(0);
+}
+main().catch((error) => {
+  console.error("\u274C Fatal error:", error);
+  process.exit(0);
+});

package/plugins/specweave/lib/hooks/close-github-issues-abandoned.ts

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+/**
+ * Close GitHub Issues for Abandoned Increment (NEW in v0.28.33)
+ *
+ * Called by post-increment-status-change.sh when an increment is abandoned.
+ * Closes all GitHub issues (main + User Stories) with abandon comment.
+ *
+ * Usage:
+ *   node close-github-issues-abandoned.js <increment-id> [reason]
+ *
+ * Environment:
+ *   GITHUB_TOKEN - Required for GitHub API access
+ */
+
+import { GitHubReconciler } from '../vendor/sync/github-reconciler.js';
+import { consoleLogger } from '../vendor/utils/logger.js';
+
+async function main(): Promise<void> {
+  const incrementId = process.argv[2];
+  const reason = process.argv[3] || 'Increment abandoned';
+
+  if (!incrementId) {
+    console.error('Usage: node close-github-issues-abandoned.js <increment-id> [reason]');
+    process.exit(1);
+  }
+
+  console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log(`🗑️  CLOSING GITHUB ISSUES (ABANDONED): ${incrementId}`);
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+
+  const projectRoot = process.cwd();
+
+  const result = await GitHubReconciler.closeAbandonedIncrementIssues(
+    projectRoot,
+    incrementId,
+    reason,
+    consoleLogger
+  );
+
+  console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  if (result.closed > 0) {
+    console.log(`✅ Closed ${result.closed} GitHub issue(s)`);
+  } else {
+    console.log('ℹ️  No issues needed closing (all already closed or none linked)');
+  }
+  if (result.errors.length > 0) {
+    console.log(`⚠️  ${result.errors.length} error(s):`);
+    result.errors.forEach(err => console.log(`   - ${err}`));
+  }
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+
+  // Exit 0 to not block hook chain
+  process.exit(0);
+}
+
+main().catch((error) => {
+  console.error('❌ Fatal error:', error);
+  process.exit(0); // Non-blocking
+});

package/plugins/specweave/lib/hooks/reopen-github-issues.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import { GitHubReconciler } from "../vendor/sync/github-reconciler.js";
+import { consoleLogger } from "../vendor/utils/logger.js";
+async function main() {
+  const incrementId = process.argv[2];
+  const reason = process.argv[3] || "Increment resumed";
+  if (!incrementId) {
+    console.error("Usage: node reopen-github-issues.js <increment-id> [reason]");
+    process.exit(1);
+  }
+  console.log("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+  console.log(`\u25B6\uFE0F  REOPENING GITHUB ISSUES: ${incrementId}`);
+  console.log("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+  const projectRoot = process.cwd();
+  const result = await GitHubReconciler.reopenIncrementIssues(
+    projectRoot,
+    incrementId,
+    reason,
+    consoleLogger
+  );
+  console.log("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501");
+  if (result.reopened > 0) {
+    console.log(`\u2705 Reopened ${result.reopened} GitHub issue(s)`);
+  } else {
+    console.log("\u2139\uFE0F  No issues needed reopening (all already open or none linked)");
+  }
+  if (result.errors.length > 0) {
+    console.log(`\u26A0\uFE0F  ${result.errors.length} error(s):`);
+    result.errors.forEach((err) => console.log(`   - ${err}`));
+  }
+  console.log("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n");
+  process.exit(0);
+}
+main().catch((error) => {
+  console.error("\u274C Fatal error:", error);
+  process.exit(0);
+});

package/plugins/specweave/lib/hooks/reopen-github-issues.ts

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+/**
+ * Reopen GitHub Issues Hook (NEW in v0.28.33)
+ *
+ * Called by post-increment-status-change.sh when an increment is resumed.
+ * Reopens all GitHub issues (main + User Stories) for the increment.
+ *
+ * Usage:
+ *   node reopen-github-issues.js <increment-id> [reason]
+ *
+ * Environment:
+ *   GITHUB_TOKEN - Required for GitHub API access
+ */
+
+import { GitHubReconciler } from '../vendor/sync/github-reconciler.js';
+import { consoleLogger } from '../vendor/utils/logger.js';
+
+async function main(): Promise<void> {
+  const incrementId = process.argv[2];
+  const reason = process.argv[3] || 'Increment resumed';
+
+  if (!incrementId) {
+    console.error('Usage: node reopen-github-issues.js <increment-id> [reason]');
+    process.exit(1);
+  }
+
+  console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log(`▶️  REOPENING GITHUB ISSUES: ${incrementId}`);
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+
+  const projectRoot = process.cwd();
+
+  const result = await GitHubReconciler.reopenIncrementIssues(
+    projectRoot,
+    incrementId,
+    reason,
+    consoleLogger
+  );
+
+  console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  if (result.reopened > 0) {
+    console.log(`✅ Reopened ${result.reopened} GitHub issue(s)`);
+  } else {
+    console.log('ℹ️  No issues needed reopening (all already open or none linked)');
+  }
+  if (result.errors.length > 0) {
+    console.log(`⚠️  ${result.errors.length} error(s):`);
+    result.errors.forEach(err => console.log(`   - ${err}`));
+  }
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+
+  // Exit 0 to not block hook chain
+  process.exit(0);
+}
+
+main().catch((error) => {
+  console.error('❌ Fatal error:', error);
+  process.exit(0); // Non-blocking
+});

package/plugins/specweave/lib/hooks/session-start-reconcile-worker.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { GitHubReconciler } from "../vendor/sync/github-reconciler.js";
+const silentLogger = {
+  log: () => {
+  },
+  // Suppress normal logs
+  error: (msg, ...args) => console.error(`[reconcile] ${msg}`, ...args)
+};
+async function main() {
+  console.log(`[${(/* @__PURE__ */ new Date()).toISOString()}] session-start-reconcile-worker: Starting...`);
+  const projectRoot = process.cwd();
+  try {
+    const reconciler = new GitHubReconciler({
+      projectRoot,
+      dryRun: false,
+      logger: silentLogger
+    });
+    const result = await reconciler.reconcile();
+    if (result.mismatches > 0) {
+      console.log(`[${(/* @__PURE__ */ new Date()).toISOString()}] session-start-reconcile-worker: Fixed ${result.closed} closed, ${result.reopened} reopened`);
+    } else {
+      console.log(`[${(/* @__PURE__ */ new Date()).toISOString()}] session-start-reconcile-worker: No drift detected (${result.scanned} increments)`);
+    }
+    if (result.errors.length > 0) {
+      console.error(`[${(/* @__PURE__ */ new Date()).toISOString()}] session-start-reconcile-worker: ${result.errors.length} error(s)`);
+      result.errors.forEach((err) => console.error(`  - ${err}`));
+    }
+  } catch (error) {
+    console.error(`[${(/* @__PURE__ */ new Date()).toISOString()}] session-start-reconcile-worker: Error - ${error.message}`);
+  }
+  console.log(`[${(/* @__PURE__ */ new Date()).toISOString()}] session-start-reconcile-worker: Complete`);
+}
+main().catch((error) => {
+  console.error(`[${(/* @__PURE__ */ new Date()).toISOString()}] session-start-reconcile-worker: Fatal error - ${error}`);
+  process.exit(0);
+});

package/plugins/specweave/lib/hooks/session-start-reconcile-worker.ts

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+/**
+ * Session Start Reconcile Worker (NEW in v0.28.33)
+ *
+ * Lightweight background worker that runs GitHub reconciliation on session start.
+ * Called by session-start-reconcile.sh in detached mode.
+ *
+ * Features:
+ * - Silent mode: Minimal output, errors logged to debug log
+ * - Non-blocking: Parent shell exits immediately
+ * - Idempotent: Safe to run multiple times
+ */
+
+import { GitHubReconciler } from '../vendor/sync/github-reconciler.js';
+
+// Silent logger - only logs errors
+const silentLogger = {
+  log: () => {}, // Suppress normal logs
+  error: (msg: string, ...args: any[]) => console.error(`[reconcile] ${msg}`, ...args),
+};
+
+async function main(): Promise<void> {
+  console.log(`[${new Date().toISOString()}] session-start-reconcile-worker: Starting...`);
+
+  const projectRoot = process.cwd();
+
+  try {
+    const reconciler = new GitHubReconciler({
+      projectRoot,
+      dryRun: false,
+      logger: silentLogger as any,
+    });
+
+    const result = await reconciler.reconcile();
+
+    // Log summary
+    if (result.mismatches > 0) {
+      console.log(`[${new Date().toISOString()}] session-start-reconcile-worker: Fixed ${result.closed} closed, ${result.reopened} reopened`);
+    } else {
+      console.log(`[${new Date().toISOString()}] session-start-reconcile-worker: No drift detected (${result.scanned} increments)`);
+    }
+
+    if (result.errors.length > 0) {
+      console.error(`[${new Date().toISOString()}] session-start-reconcile-worker: ${result.errors.length} error(s)`);
+      result.errors.forEach(err => console.error(`  - ${err}`));
+    }
+
+  } catch (error: any) {
+    console.error(`[${new Date().toISOString()}] session-start-reconcile-worker: Error - ${error.message}`);
+  }
+
+  console.log(`[${new Date().toISOString()}] session-start-reconcile-worker: Complete`);
+}
+
+main().catch((error) => {
+  console.error(`[${new Date().toISOString()}] session-start-reconcile-worker: Fatal error - ${error}`);
+  process.exit(0); // Non-blocking
+});