specweave 0.28.34 → 0.28.42

package/dist/src/utils/validators/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Type definitions for external resource validators
+ * @module utils/validators/types
+ */
+export interface JiraProject {
+    id: string;
+    key: string;
+    name: string;
+}
+export interface JiraBoard {
+    id: number;
+    name: string;
+    type: string;
+    location?: {
+        projectKey?: string;
+        projectId?: string;
+    };
+}
+export interface JiraValidationResult {
+    valid: boolean;
+    project: {
+        exists: boolean;
+        key?: string;
+        id?: string;
+        name?: string;
+    };
+    boards: {
+        valid: boolean;
+        existing: number[];
+        missing: string[];
+        created: Array<{
+            name: string;
+            id: number;
+        }>;
+    };
+    envUpdated: boolean;
+}
+export interface AzureDevOpsProject {
+    id: string;
+    name: string;
+    description?: string;
+    state?: string;
+}
+export interface AzureDevOpsTeam {
+    id: string;
+    name: string;
+    description?: string;
+}
+export interface AzureDevOpsAreaPath {
+    id: number;
+    name: string;
+    path: string;
+    hasChildren?: boolean;
+}
+export interface AzureDevOpsProjectResult {
+    name: string;
+    id?: string;
+    exists: boolean;
+    created: boolean;
+}
+export interface AzureDevOpsAreaPathResult {
+    name: string;
+    project?: string;
+    exists: boolean;
+    created: boolean;
+}
+export interface AzureDevOpsTeamResult {
+    name: string;
+    id?: string;
+    project?: string;
+    exists: boolean;
+    created: boolean;
+}
+export interface AzureDevOpsValidationResult {
+    valid: boolean;
+    strategy?: string;
+    projects: AzureDevOpsProjectResult[];
+    teams: AzureDevOpsTeamResult[];
+    areaPaths: AzureDevOpsAreaPathResult[];
+    envUpdated: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/utils/validators/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/utils/validators/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE;QACT,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE;QACP,MAAM,EAAE,OAAO,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,MAAM,EAAE;QACN,KAAK,EAAE,OAAO,CAAC;QACf,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC9C,CAAC;IACF,UAAU,EAAE,OAAO,CAAC;CACrB;AAMD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,wBAAwB,EAAE,CAAC;IACrC,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,SAAS,EAAE,yBAAyB,EAAE,CAAC;IACvC,UAAU,EAAE,OAAO,CAAC;CACrB"}

package/dist/src/utils/validators/types.js

@@ -0,0 +1,6 @@
+/**
+ * Type definitions for external resource validators
+ * @module utils/validators/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/utils/validators/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/utils/validators/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.28.34",
+  "version": "0.28.42",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",
@@ -33,8 +33,8 @@
     "docs:dev": "cd docs-site && npm start",
     "docs:build": "cd docs-site && npm run build",
     "docs:install": "cd docs-site && npm install --legacy-peer-deps",
-    "docs:internal": "mkdocs serve -f docs-site/mkdocs-internal.yml",
-    "docs:internal:build": "mkdocs build -f docs-site/mkdocs-internal.yml",
+    "docs:internal": "cd docs-site && npm run start:internal",
+    "docs:internal:build": "cd docs-site && npm run build:internal",
     "release:patch": "bash scripts/bump-version.sh patch",
     "release:minor": "bash scripts/bump-version.sh minor",
     "release:major": "bash scripts/bump-version.sh major",

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

@@ -20,82 +20,27 @@
     "living-docs"
   ],
   "hooks": {
-    "PreToolUse": [
+    "SessionStart": [
       {
-        "matcher": "TodoWrite",
         "hooks": [
           {
             "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/pre-task-completion.sh",
-            "timeout": 2
-          }
-        ]
-      },
-      {
-        "matcher": "Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/pre-edit-write-consolidated.sh",
-            "timeout": 1,
-            "description": "Consolidated pre-hook for Edit (v0.25.0)"
-          }
-        ]
-      },
-      {
-        "matcher": "Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/pre-edit-write-consolidated.sh",
-            "timeout": 1,
-            "description": "Consolidated pre-hook for Write (v0.25.0)"
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/v2/dispatchers/session-start.sh",
+            "timeout": 2,
+            "description": "v2: Launch background event processor"
           }
         ]
       }
     ],
     "PostToolUse": [
       {
-        "matcher": "TodoWrite",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-task-completion.sh",
-            "timeout": 10
-          }
-        ]
-      },
-      {
-        "matcher": "Edit",
+        "matcher": "Edit|Write",
         "hooks": [
           {
             "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-edit-write-consolidated.sh",
-            "timeout": 5,
-            "description": "Consolidated post-hook for Edit (v0.25.0)"
-          },
-          {
-            "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-metadata-change.sh",
-            "timeout": 2,
-            "description": "Fast early-exit for non-metadata.json (v0.25.0)"
-          }
-        ]
-      },
-      {
-        "matcher": "Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-edit-write-consolidated.sh",
-            "timeout": 5,
-            "description": "Consolidated post-hook for Write (v0.25.0)"
-          },
-          {
-            "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-metadata-change.sh",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/v2/dispatchers/post-tool-use.sh",
             "timeout": 2,
-            "description": "Fast early-exit for non-metadata.json (v0.25.0)"
+            "description": "v2: Single dispatcher for all PostToolUse events (<50ms)"
           }
         ]
       }

package/plugins/specweave/commands/specweave-archive.md

@@ -53,7 +53,7 @@ This command automatically synchronizes living docs by archiving features in:
 
 - `<increment-ids>`: Specific increment IDs to archive (e.g., "1", "0001", "0031")
 - `--older-than <days>`: Archive increments older than N days
-- `--keep-last <n>`: Keep last N increments, archive the rest (**default: 3** when no other filters)
+- `--keep-last <n>`: Keep last N increments, archive the rest (**default: 5** when no other filters)
 - `--pattern <regex>`: Archive increments matching pattern
 - `--archive-completed`: Archive all completed increments (use with caution!)
 - `--preserve-active`: Never archive active/paused increments (default: true)
@@ -61,11 +61,11 @@ This command automatically synchronizes living docs by archiving features in:
 
 ## CRITICAL SAFETY FEATURE
 
-**Default `--keep-last 3`**: When called without any filtering options (no increment IDs, no pattern, no `--older-than`, no `--archive-completed`), the archiver **automatically defaults to `--keep-last 3`** to prevent accidentally archiving ALL increments.
+**Default `--keep-last 5`**: When called without any filtering options (no increment IDs, no pattern, no `--older-than`, no `--archive-completed`), the archiver **automatically defaults to `--keep-last 5`** to prevent accidentally archiving ALL increments.
 
 This safety feature ensures:
 - ✅ Running `/specweave:archive` without options won't archive everything
-- ✅ Last 3 increments always remain visible for easy reference
+- ✅ Last 5 increments always remain visible for easy reference
 - ✅ Explicit criteria required to archive recent work
 
 ## Archive Rules

package/plugins/specweave/commands/specweave-increment.md

@@ -149,11 +149,11 @@ import { MetadataManager } from '../core/metadata-manager';
 import { ConfigManager } from '../core/config-manager';
 import { IncrementType } from '../core/types';
 
-// 1. Load config (defaults: maxActiveIncrements=1, hardCap=2, allowEmergencyInterrupt=true)
+// 1. Load config (defaults: maxActiveIncrements=1, hardCap=3, allowEmergencyInterrupt=true)
 const config = ConfigManager.load();
 const limits = config.limits || {
   maxActiveIncrements: 1,
-  hardCap: 2,
+  hardCap: 3,
   allowEmergencyInterrupt: true,
   typeBehaviors: {
     canInterrupt: ['hotfix', 'bug']
@@ -167,32 +167,31 @@ const activeCount = active.length;
 // 3. Ask user for increment type (or detect from title)
 const incrementType = await promptForType(); // hotfix, feature, bug, change-request, refactor, experiment
 
-// 4. HARD CAP ENFORCEMENT (never >2 active)
+// 4. HARD CAP WARNING (negotiable - user decides!)
 if (activeCount >= limits.hardCap) {
-  console.log(chalk.red.bold('\n❌ HARD CAP REACHED\n'));
-  console.log(chalk.red(`You have ${activeCount} active increments (absolute maximum: ${limits.hardCap})\n`));
+  console.log(chalk.yellow.bold('\n⚠️  WIP LIMIT EXCEEDED\n'));
+  console.log(chalk.yellow(`You have ${activeCount} active increments (configured limit: ${limits.hardCap})\n`));
 
-  console.log(chalk.yellow('Active increments:'));
+  console.log(chalk.dim('Active increments:'));
   active.forEach(inc => {
     console.log(chalk.dim(`  • ${inc.id} [${inc.type}]`));
   });
 
-  console.log(chalk.blue('\n💡 You MUST complete or pause existing work first:\n'));
-  console.log(chalk.white('1️⃣  Complete an increment:'));
-  console.log(chalk.dim('   /specweave:done <id>\n'));
-  console.log(chalk.white('2️⃣  Pause an increment:'));
-  console.log(chalk.dim('   /specweave:pause <id> --reason="..."\n'));
-  console.log(chalk.white('3️⃣  Check status:'));
-  console.log(chalk.dim('   /specweave:status\n'));
+  console.log(chalk.blue('\n💡 Options:\n'));
+  console.log(chalk.white('1️⃣  Complete an increment: /specweave:done <id>'));
+  console.log(chalk.white('2️⃣  Pause an increment: /specweave:pause <id>'));
+  console.log(chalk.white('3️⃣  Increase limit: Edit .specweave/config.json limits.hardCap'));
+  console.log(chalk.white('4️⃣  Continue anyway (confirm below)\n'));
 
-  console.log(chalk.yellow('📝 Multiple hotfixes? Combine them into ONE increment!'));
-  console.log(chalk.dim('   Example: 0009-security-fixes (SQL + XSS + CSRF)\n'));
-
-  console.log(chalk.red.bold('⛔ This limit is enforced for your productivity.'));
   console.log(chalk.dim('Research: 3+ concurrent tasks = 40% slower + more bugs\n'));
 
-  // NO force override at hard cap - absolute maximum
-  process.exit(1);
+  // ASK user instead of blocking
+  const proceed = await promptConfirm('Continue with new increment anyway?');
+  if (!proceed) {
+    console.log(chalk.dim('Cancelled. Complete or pause existing work first.'));
+    process.exit(0);
+  }
+  console.log(chalk.green('✓ Proceeding with new increment...\n'));
 }
 
 // 5. SOFT ENFORCEMENT (activeCount >= maxActiveIncrements)

package/plugins/specweave/hooks/hooks.json

@@ -5,65 +5,19 @@
         "hooks": [
           {
             "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/session-start-reconcile.sh"
-          }
-        ]
-      }
-    ],
-    "PreToolUse": [
-      {
-        "matcher": "Edit",
-        "matcher_content": "\\.specweave/increments/[0-9]{4}-.+/tasks\\.md",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/pre-task-completion-edit.sh"
-          }
-        ]
-      }
-    ],
-    "UserPromptSubmit": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/pre-command-deduplication.sh"
-          },
-          {
-            "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/user-prompt-submit.sh"
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/v2/dispatchers/session-start.sh"
           }
         ]
       }
     ],
     "PostToolUse": [
-      {
-        "matcher": "Write",
-        "matcher_content": "\\.specweave/increments/[0-9]{4}-.+/(spec|plan|tasks)\\.md",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-increment-planning.sh"
-          }
-        ]
-      },
-      {
-        "matcher": "Edit",
-        "matcher_content": "\\.specweave/increments/[0-9]{4}-.+/(tasks|spec)\\.md",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-task-edit.sh"
-          }
-        ]
-      },
       {
         "matcher": "Edit|Write",
-        "matcher_content": "\\.specweave/increments/[0-9]{4}-.+/metadata\\.json",
+        "matcher_content": "\\.specweave/increments/",
         "hooks": [
           {
             "type": "command",
-            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-metadata-change.sh"
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/v2/dispatchers/post-tool-use.sh"
           }
         ]
       }

package/plugins/specweave/hooks/hooks.json.bak

@@ -0,0 +1,72 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/session-start-reconcile.sh"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Edit",
+        "matcher_content": "\\.specweave/increments/[0-9]{4}-.+/tasks\\.md",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/pre-task-completion-edit.sh"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/pre-command-deduplication.sh"
+          },
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/user-prompt-submit.sh"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write",
+        "matcher_content": "\\.specweave/increments/[0-9]{4}-.+/(spec|plan|tasks)\\.md",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-increment-planning.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "Edit",
+        "matcher_content": "\\.specweave/increments/[0-9]{4}-.+/(tasks|spec)\\.md",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-task-edit.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write",
+        "matcher_content": "\\.specweave/increments/[0-9]{4}-.+/metadata\\.json",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-metadata-change.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

package/plugins/specweave/hooks/hooks.json.v1-backup

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit",
+        "matcher_content": "\\.specweave/increments/[0-9]{4}-.+/(tasks|spec)\\.md",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-task-edit.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

package/plugins/specweave/hooks/lib/update-status-line.sh

@@ -87,39 +87,61 @@ if [[ ! -d "$INCREMENTS_DIR" ]]; then
 fi
 
 # ============================================================================
-# ACQUIRE LOCK
+# ACQUIRE LOCK (ATOMIC - mkdir pattern prevents TOCTOU race!)
 # ============================================================================
 mkdir -p "$STATE_DIR"
-echo $$ > "$LOCK_FILE"
-trap 'rm -f "$LOCK_FILE"' EXIT
+LOCK_DIR="$STATE_DIR/.status-update.lockdir"
+if ! mkdir "$LOCK_DIR" 2>/dev/null; then
+  # Lock exists - check if stale (>30s)
+  if [[ "$(uname)" == "Darwin" ]]; then
+    LOCK_AGE=$(( $(date +%s) - $(stat -f %m "$LOCK_DIR" 2>/dev/null || echo 0) ))
+  else
+    LOCK_AGE=$(( $(date +%s) - $(stat -c %Y "$LOCK_DIR" 2>/dev/null || echo 0) ))
+  fi
+  if [[ $LOCK_AGE -lt 30 ]]; then
+    exit 0  # Another process holds lock
+  fi
+  # Stale lock - remove and retry
+  rm -rf "$LOCK_DIR"
+  mkdir "$LOCK_DIR" 2>/dev/null || exit 0
+fi
+echo $$ > "$LOCK_DIR/pid"
+trap 'rm -rf "$LOCK_DIR"' EXIT
 
 # ============================================================================
-# FIND ACTIVE INCREMENTS (single find, no xargs)
+# FIND ACTIVE INCREMENTS (uses metadata.json - SOURCE OF TRUTH!)
 # ============================================================================
 ACTIVE_FILES=""
 OPEN_COUNT=0
 OLDEST_DATE="9999-99-99"
 CURRENT_INCREMENT=""
 
-while IFS= read -r spec_file; do
-  [[ -z "$spec_file" ]] && continue
+while IFS= read -r metadata_file; do
+  [[ -z "$metadata_file" ]] && continue
 
-  # Quick status check with head + grep (faster than full file grep)
-  if head -20 "$spec_file" 2>/dev/null | grep -qE '^status:\s*(active|planning|in-progress)'; then
-    OPEN_COUNT=$((OPEN_COUNT + 1))
-    increment_id=$(basename "$(dirname "$spec_file")")
+  # Extract status from metadata.json (jq if available, grep fallback)
+  if command -v jq >/dev/null 2>&1; then
+    status=$(jq -r '.status // "unknown"' "$metadata_file" 2>/dev/null || echo "unknown")
+    created=$(jq -r '.created // "9999-99-99"' "$metadata_file" 2>/dev/null || echo "9999-99-99")
+  else
+    status=$(grep -oP '"status"\s*:\s*"\K[^"]*' "$metadata_file" 2>/dev/null || echo "unknown")
+    created=$(grep -oP '"created"\s*:\s*"\K[^"]*' "$metadata_file" 2>/dev/null || echo "9999-99-99")
+  fi
 
-    # Get created date (first 30 lines only)
-    created=$(head -30 "$spec_file" 2>/dev/null | grep -m1 "^created:" | cut -d: -f2- | tr -d ' "' || echo "9999-99-99")
+  # Check if active
+  if [[ "$status" == "active" || "$status" == "planning" || "$status" == "in-progress" ]]; then
+    OPEN_COUNT=$((OPEN_COUNT + 1))
+    increment_id=$(basename "$(dirname "$metadata_file")")
 
     if [[ "$created" < "$OLDEST_DATE" ]]; then
       OLDEST_DATE="$created"
       CURRENT_INCREMENT="$increment_id"
     fi
 
+    spec_file="$(dirname "$metadata_file")/spec.md"
     ACTIVE_FILES="$ACTIVE_FILES $spec_file"
   fi
-done < <(find "$INCREMENTS_DIR" -maxdepth 2 -name "spec.md" -not -path "*/_archive/*" 2>/dev/null)
+done < <(find "$INCREMENTS_DIR" -maxdepth 2 -name "metadata.json" -not -path "*/_archive/*" 2>/dev/null)
 
 # No active increments?
 if [[ -z "$CURRENT_INCREMENT" ]]; then
@@ -186,10 +208,12 @@ COMPLETED_ACS=${COMPLETED_ACS:-0}
 OPEN_COUNT=${OPEN_COUNT:-0}
 PERCENTAGE=${PERCENTAGE:-0}
 
-# Generate JSON directly (avoids jq subprocess entirely!)
-cat > "$CACHE_FILE" << EOF
+# Generate JSON directly (ATOMIC: write temp then mv to prevent partial reads!)
+TEMP_CACHE="$CACHE_FILE.tmp.$$"
+cat > "$TEMP_CACHE" << EOF
 {"current":{"id":"$CURRENT_INCREMENT","name":"$CURRENT_INCREMENT","completed":$COMPLETED_TASKS,"total":$TOTAL_TASKS,"percentage":$PERCENTAGE,"acsCompleted":$COMPLETED_ACS,"acsTotal":$TOTAL_ACS},"openCount":$OPEN_COUNT,"lastUpdate":"$(date -u +%Y-%m-%dT%H:%M:%SZ)"}
 EOF
+mv "$TEMP_CACHE" "$CACHE_FILE"
 
 # Update mtime marker
 touch "$MTIME_FILE"

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

@@ -32,6 +32,16 @@ if [[ -d "$PROJECT_ROOT/.specweave" ]]; then
 
   # Update status line
   bash "$HOOK_DIR/lib/update-status-line.sh" 2>/dev/null || true
+
+  # CRASH PREVENTION: Check task count in active increments
+  for tasks_file in "$PROJECT_ROOT/.specweave/increments"/[0-9]*/tasks.md; do
+    [[ -f "$tasks_file" ]] || continue
+    task_count=$(grep -c "^### T-" "$tasks_file" 2>/dev/null || echo "0")
+    if [[ "$task_count" -gt 8 ]]; then
+      inc_name=$(basename "$(dirname "$tasks_file")")
+      echo "⚠️ CRASH RISK: $inc_name has $task_count tasks (max 8). Split increment!" >&2
+    fi
+  done
 fi
 
 exit 0

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

@@ -76,27 +76,46 @@ if [[ -d "$SPECWEAVE_DIR/increments" ]]; then
 fi
 
 # ==============================================================================
-# DISCIPLINE VALIDATION: Block /specweave:increment if incomplete increments exist
+# DISCIPLINE VALIDATION: Warn about WIP limits (configurable, not hard block!)
 # ==============================================================================
 
 if echo "$PROMPT" | grep -q "/specweave:increment"; then
-  # Hard cap: never >2 active
-  if [[ "$ACTIVE_COUNT" -ge 2 ]]; then
+  # Read limits from config.json (respect user's settings!)
+  CONFIG_FILE="$SPECWEAVE_DIR/config.json"
+  SOFT_LIMIT=1
+  HARD_CAP=3
+
+  if [[ -f "$CONFIG_FILE" ]]; then
+    if command -v jq >/dev/null 2>&1; then
+      SOFT_LIMIT=$(jq -r '.limits.maxActiveIncrements // 1' "$CONFIG_FILE" 2>/dev/null || echo "1")
+      HARD_CAP=$(jq -r '.limits.hardCap // 3' "$CONFIG_FILE" 2>/dev/null || echo "3")
+    else
+      SOFT_LIMIT=$(grep -oP '"maxActiveIncrements"\s*:\s*\K[0-9]+' "$CONFIG_FILE" 2>/dev/null || echo "1")
+      HARD_CAP=$(grep -oP '"hardCap"\s*:\s*\K[0-9]+' "$CONFIG_FILE" 2>/dev/null || echo "3")
+    fi
+  fi
+
+  # Ensure valid numbers
+  [[ ! "$SOFT_LIMIT" =~ ^[0-9]+$ ]] && SOFT_LIMIT=1
+  [[ ! "$HARD_CAP" =~ ^[0-9]+$ ]] && HARD_CAP=3
+
+  # Above hard cap: strong warning but NOT a block (user decides!)
+  if [[ "$ACTIVE_COUNT" -ge "$HARD_CAP" ]]; then
     cat <<EOF
 {
-  "decision": "block",
-  "reason": "❌ HARD CAP REACHED\n\nYou have $ACTIVE_COUNT active increments (absolute maximum: 2)\n\nActive increments:\n$ACTIVE_LIST\n\n💡 You MUST complete or pause existing work first:\n\n1️⃣  Complete an increment:\n   /specweave:done <id>\n\n2️⃣  Pause an increment:\n   /specweave:pause <id> --reason=\"...\"\n\n3️⃣  Check status:\n   /specweave:status\n\n📝 Multiple hotfixes? Combine them into ONE increment!\n   Example: 0009-security-fixes (SQL + XSS + CSRF)\n\n⛔ This limit is enforced for your productivity.\nResearch: 3+ concurrent tasks = 40% slower + more bugs"
+  "decision": "approve",
+  "systemMessage": "⚠️  WIP LIMIT EXCEEDED (${ACTIVE_COUNT}/${HARD_CAP})\n\nYou have $ACTIVE_COUNT active increments (configured maximum: $HARD_CAP)\n\nActive increments:\n$ACTIVE_LIST\n\n🧠 Research shows 3+ concurrent tasks = 40% slower + more bugs\n\n💡 Options:\n  1️⃣  Complete an increment: /specweave:done <id>\n  2️⃣  Pause an increment: /specweave:pause <id>\n  3️⃣  Increase limit: Edit .specweave/config.json limits.hardCap\n  4️⃣  Continue anyway (not recommended)\n\n📝 To proceed anyway, just confirm your intent."
 }
 EOF
     exit 0
   fi
 
-  # Soft warning: 1 active (recommended limit)
-  if [[ "$ACTIVE_COUNT" -ge 1 ]]; then
+  # At soft limit: mild warning, approve
+  if [[ "$ACTIVE_COUNT" -ge "$SOFT_LIMIT" ]]; then
     cat <<EOF
 {
   "decision": "approve",
-  "systemMessage": "⚠️  WIP LIMIT REACHED\n\nYou have $ACTIVE_COUNT active increment (recommended limit: 1)\n\nActive increments:\n$ACTIVE_LIST\n\n🧠 Focus Principle: ONE active increment = maximum productivity\nStarting a 2nd increment reduces focus and velocity.\n\n💡 Consider:\n  1️⃣  Complete current work (recommended)\n  2️⃣  Pause current work (/specweave:pause)\n  3️⃣  Continue anyway (accept 20% productivity cost)\n\n⚠️  Emergency hotfix/bug? Use --type=hotfix or --type=bug to bypass this warning."
+  "systemMessage": "⚠️  WIP LIMIT REACHED (${ACTIVE_COUNT}/${SOFT_LIMIT})\n\nYou have $ACTIVE_COUNT active increment(s) (recommended limit: $SOFT_LIMIT)\n\nActive increments:\n$ACTIVE_LIST\n\n🧠 Focus Principle: Fewer active increments = maximum productivity\n\n💡 Consider:\n  1️⃣  Complete current work (recommended)\n  2️⃣  Pause current work (/specweave:pause)\n  3️⃣  Continue anyway\n\n⚠️  Emergency hotfix/bug? Use --type=hotfix or --type=bug"
 }
 EOF
     exit 0