specweave 0.23.16 → 0.24.0

package/plugins/specweave/hooks/post-first-increment.sh.bak

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+# SpecWeave Post-First-Increment Hook
+#
+# Triggers after the first increment is completed
+# Congratulates the user on completing their first increment
+#
+# NON-INTERACTIVE: Just shows a message (hooks run in background)
+
+set -euo pipefail
+
+# Get project root (where .specweave/ lives)
+PROJECT_ROOT="$(pwd)"
+
+# Check if .specweave directory exists
+if [ ! -d ".specweave" ]; then
+  # Not in SpecWeave project, skip
+  exit 0
+fi
+
+# Check if this is the first increment completion
+# Count completed increments in .specweave/increments/
+COMPLETED_COUNT=0
+if [ -d ".specweave/increments" ]; then
+  # Count directories that have COMPLETION-REPORT.md or completion metadata
+  for inc_dir in .specweave/increments/[0-9][0-9][0-9][0-9]-*/; do
+    if [ -d "$inc_dir" ]; then
+      if [ -f "${inc_dir}reports/COMPLETION-REPORT.md" ] || \
+         [ -f "${inc_dir}COMPLETION-SUMMARY.md" ] || \
+         ([ -f "${inc_dir}metadata.json" ] && grep -q '"status".*"completed"' "${inc_dir}metadata.json" 2>/dev/null); then
+        COMPLETED_COUNT=$((COMPLETED_COUNT + 1))
+      fi
+    fi
+  done
+fi
+
+# Only trigger on first completion
+if [ "$COMPLETED_COUNT" -ne 1 ]; then
+  exit 0
+fi
+
+# Show congratulations message (non-interactive)
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🎉 Congratulations! You completed your first increment!"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "✅ Your increment has been documented in:"
+echo "   .specweave/increments/[increment-id]/"
+echo ""
+echo "📚 View your documentation:"
+echo "   - Specs: .specweave/docs/internal/specs/"
+echo "   - Architecture: .specweave/docs/internal/architecture/"
+echo ""
+echo "🚀 Next steps:"
+echo "   - Review your increment: /specweave:status"
+echo "   - Start next increment: /specweave:increment \"feature name\""
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+exit 0

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

@@ -27,7 +27,7 @@
 #
 ###############################################################################
 
-set -euo pipefail
+set +e  # EMERGENCY FIX: Changed from set -euo pipefail to prevent Claude Code crashes
 
 # Arguments
 SPEC_FILE_PATH="${1:-}"

package/plugins/specweave/hooks/post-spec-update.sh.bak

@@ -0,0 +1,158 @@
+#!/bin/bash
+
+###############################################################################
+# SpecWeave Post-Spec-Update Hook
+#
+# CRITICAL ARCHITECTURE:
+# - Fires when .specweave/docs/internal/specs/spec-*.md is updated
+# - Auto-syncs to linked external tool (GitHub Project/Jira Epic/ADO Feature)
+# - Replaces increment-based sync (which was wrong!)
+#
+# Trigger Points:
+# 1. After /specweave:sync-docs update (spec updated from increment)
+# 2. After manual spec.md edits (user updates living docs directly)
+# 3. After bidirectional sync from external tool
+#
+# What It Does:
+# - Detects which spec was updated
+# - Checks if spec is linked to external tool (frontmatter: externalLinks)
+# - Syncs changes to GitHub Project / Jira Epic / ADO Feature
+# - Updates user stories, acceptance criteria, progress
+#
+# Usage:
+#   post-spec-update.sh <spec-file-path>
+#
+# Example:
+#   post-spec-update.sh .specweave/docs/internal/specs/spec-001-core-framework.md
+#
+###############################################################################
+
+set -euo pipefail
+
+# Arguments
+SPEC_FILE_PATH="${1:-}"
+
+# Validate arguments
+if [[ -z "$SPEC_FILE_PATH" ]]; then
+  echo "❌ Error: Spec file path required"
+  echo "Usage: post-spec-update.sh <spec-file-path>"
+  exit 1
+fi
+
+# Check if spec file exists
+if [[ ! -f "$SPEC_FILE_PATH" ]]; then
+  echo "❌ Error: Spec file not found: $SPEC_FILE_PATH"
+  exit 1
+fi
+
+# Extract spec ID from file path
+# Example: .specweave/docs/internal/specs/spec-001-core-framework.md → spec-001
+SPEC_ID=$(basename "$SPEC_FILE_PATH" .md)
+
+echo ""
+echo "🔗 Post-Spec-Update Hook"
+echo "   Spec: $SPEC_ID"
+echo "   File: $SPEC_FILE_PATH"
+
+# Load config to check if auto-sync is enabled
+CONFIG_FILE=".specweave/config.json"
+if [[ ! -f "$CONFIG_FILE" ]]; then
+  echo "   ℹ️  No config file found, skipping auto-sync"
+  exit 0
+fi
+
+# Check if auto-sync is enabled
+AUTO_SYNC=$(jq -r '.hooks.post_spec_update.auto_sync // true' "$CONFIG_FILE")
+
+if [[ "$AUTO_SYNC" != "true" ]]; then
+  echo "   ℹ️  Auto-sync disabled in config, skipping"
+  exit 0
+fi
+
+# Parse spec frontmatter to detect external links
+# Use gray-matter or similar to extract YAML frontmatter
+# For now, use simple grep/sed approach
+
+# Check if GitHub link exists
+GITHUB_LINK=$(grep -A 10 "^externalLinks:" "$SPEC_FILE_PATH" | grep -A 5 "github:" | grep "projectId:" | sed 's/.*projectId: *//; s/ *$//' || echo "")
+
+# Check if Jira link exists
+JIRA_LINK=$(grep -A 10 "^externalLinks:" "$SPEC_FILE_PATH" | grep -A 5 "jira:" | grep "epicKey:" | sed 's/.*epicKey: *//; s/ *$//' || echo "")
+
+# Check if ADO link exists
+ADO_LINK=$(grep -A 10 "^externalLinks:" "$SPEC_FILE_PATH" | grep -A 5 "ado:" | grep "featureId:" | sed 's/.*featureId: *//; s/ *$//' || echo "")
+
+# Determine which provider to sync
+PROVIDER=""
+if [[ -n "$GITHUB_LINK" ]]; then
+  PROVIDER="github"
+  EXTERNAL_ID="$GITHUB_LINK"
+elif [[ -n "$JIRA_LINK" ]]; then
+  PROVIDER="jira"
+  EXTERNAL_ID="$JIRA_LINK"
+elif [[ -n "$ADO_LINK" ]]; then
+  PROVIDER="ado"
+  EXTERNAL_ID="$ADO_LINK"
+fi
+
+# No external link found - skip sync
+if [[ -z "$PROVIDER" ]]; then
+  echo "   ℹ️  Spec not linked to external tool, skipping sync"
+  echo "   Hint: Use /specweave-github:sync-spec or /specweave-jira:sync-spec to link"
+  exit 0
+fi
+
+echo "   🔗 Detected external link: $PROVIDER (ID: $EXTERNAL_ID)"
+
+# Sync to external tool based on provider
+case "$PROVIDER" in
+  github)
+    echo "   🔄 Syncing to GitHub Project..."
+
+    # Check if GitHub CLI is available
+    if ! command -v gh &> /dev/null; then
+      echo "   ⚠️  GitHub CLI (gh) not found, skipping sync"
+      exit 0
+    fi
+
+    # TODO: Call GitHub spec sync
+    # For now, just log the action
+    echo "   ✅ GitHub sync queued (implementation pending)"
+    ;;
+
+  jira)
+    echo "   🔄 Syncing to Jira Epic..."
+
+    # Check if Jira config exists
+    if [[ -z "${JIRA_DOMAIN:-}" ]]; then
+      echo "   ⚠️  Jira not configured (.env), skipping sync"
+      exit 0
+    fi
+
+    # TODO: Call Jira spec sync
+    echo "   ✅ Jira sync queued (implementation pending)"
+    ;;
+
+  ado)
+    echo "   🔄 Syncing to Azure DevOps Feature..."
+
+    # Check if ADO config exists
+    if [[ -z "${ADO_ORGANIZATION:-}" ]]; then
+      echo "   ⚠️  ADO not configured (.env), skipping sync"
+      exit 0
+    fi
+
+    # TODO: Call ADO spec sync
+    echo "   ✅ ADO sync queued (implementation pending)"
+    ;;
+
+  *)
+    echo "   ⚠️  Unknown provider: $PROVIDER"
+    exit 0
+    ;;
+esac
+
+echo "   ✅ Post-spec-update hook complete"
+echo ""
+
+exit 0

package/plugins/specweave/hooks/post-user-story-complete.sh

@@ -27,7 +27,7 @@
 #
 ###############################################################################
 
-set -euo pipefail
+set +e  # EMERGENCY FIX: Changed from set -euo pipefail to prevent Claude Code crashes
 
 # Arguments
 SPEC_ID="${1:-}"

package/plugins/specweave/hooks/post-user-story-complete.sh.bak

@@ -0,0 +1,179 @@
+#!/bin/bash
+
+###############################################################################
+# SpecWeave Post-User-Story-Complete Hook
+#
+# CRITICAL ARCHITECTURE:
+# - Fires when user story marked complete in spec.md (AC checkbox checked)
+# - Updates external PM tool (GitHub Issue/Jira Story/ADO User Story)
+# - Moves GitHub card to "Done" / Closes Jira story / Completes ADO story
+#
+# Trigger Points:
+# 1. After user manually checks AC checkbox in spec.md
+# 2. After bidirectional sync updates AC status
+# 3. After increment completion syncs to spec
+#
+# What It Does:
+# - Detects which user story was completed (all AC checkboxes checked)
+# - Finds corresponding external item (GitHub Issue/Jira Story/ADO User Story)
+# - Updates item status to "Done" / "Closed"
+# - Adds completion comment with timestamp
+#
+# Usage:
+#   post-user-story-complete.sh <spec-id> <user-story-id>
+#
+# Example:
+#   post-user-story-complete.sh spec-001 US-001
+#
+###############################################################################
+
+set -euo pipefail
+
+# Arguments
+SPEC_ID="${1:-}"
+USER_STORY_ID="${2:-}"
+
+# Validate arguments
+if [[ -z "$SPEC_ID" || -z "$USER_STORY_ID" ]]; then
+  echo "❌ Error: Spec ID and User Story ID required"
+  echo "Usage: post-user-story-complete.sh <spec-id> <user-story-id>"
+  exit 1
+fi
+
+echo ""
+echo "🎉 Post-User-Story-Complete Hook"
+echo "   Spec: $SPEC_ID"
+echo "   User Story: $USER_STORY_ID"
+
+# Find spec file
+SPEC_FILE=""
+if [[ -f ".specweave/docs/internal/specs/$SPEC_ID.md" ]]; then
+  SPEC_FILE=".specweave/docs/internal/specs/$SPEC_ID.md"
+elif [[ -f ".specweave/docs/internal/projects/default/specs/$SPEC_ID.md" ]]; then
+  SPEC_FILE=".specweave/docs/internal/projects/default/specs/$SPEC_ID.md"
+else
+  echo "❌ Error: Spec file not found for $SPEC_ID"
+  exit 1
+fi
+
+# Load config to check if auto-sync is enabled
+CONFIG_FILE=".specweave/config.json"
+if [[ ! -f "$CONFIG_FILE" ]]; then
+  echo "   ℹ️  No config file found, skipping auto-sync"
+  exit 0
+fi
+
+# Check if auto-sync is enabled
+AUTO_SYNC=$(jq -r '.hooks.post_user_story_complete.auto_sync // true' "$CONFIG_FILE")
+
+if [[ "$AUTO_SYNC" != "true" ]]; then
+  echo "   ℹ️  Auto-sync disabled in config, skipping"
+  exit 0
+fi
+
+# Parse spec frontmatter to detect external links
+# Check if GitHub link exists
+GITHUB_LINK=$(grep -A 10 "^externalLinks:" "$SPEC_FILE" | grep -A 5 "github:" | grep "projectId:" | sed 's/.*projectId: *//; s/ *$//' || echo "")
+
+# Check if Jira link exists
+JIRA_LINK=$(grep -A 10 "^externalLinks:" "$SPEC_FILE" | grep -A 5 "jira:" | grep "epicKey:" | sed 's/.*epicKey: *//; s/ *$//' || echo "")
+
+# Check if ADO link exists
+ADO_LINK=$(grep -A 10 "^externalLinks:" "$SPEC_FILE" | grep -A 5 "ado:" | grep "featureId:" | sed 's/.*featureId: *//; s/ *$//' || echo "")
+
+# Determine which provider to sync
+PROVIDER=""
+if [[ -n "$GITHUB_LINK" ]]; then
+  PROVIDER="github"
+  EXTERNAL_ID="$GITHUB_LINK"
+elif [[ -n "$JIRA_LINK" ]]; then
+  PROVIDER="jira"
+  EXTERNAL_ID="$JIRA_LINK"
+elif [[ -n "$ADO_LINK" ]]; then
+  PROVIDER="ado"
+  EXTERNAL_ID="$ADO_LINK"
+fi
+
+# No external link found - skip sync
+if [[ -z "$PROVIDER" ]]; then
+  echo "   ℹ️  Spec not linked to external tool, skipping sync"
+  exit 0
+fi
+
+echo "   🔗 Detected external link: $PROVIDER"
+
+# Update external tool based on provider
+case "$PROVIDER" in
+  github)
+    echo "   🔄 Updating GitHub Issue for $USER_STORY_ID..."
+
+    # Check if GitHub CLI is available
+    if ! command -v gh &> /dev/null; then
+      echo "   ⚠️  GitHub CLI (gh) not found, skipping sync"
+      exit 0
+    fi
+
+    # Find GitHub Issue for this user story
+    # Search for issue with title pattern "[USER_STORY_ID]"
+    REPO=$(git remote get-url origin | sed -E 's/.*github\.com[:/]([^/]+\/[^/]+)(\.git)?$/\1/')
+
+    # Search for issue
+    ISSUE_NUMBER=$(gh issue list --repo "$REPO" --search "\"[$USER_STORY_ID]\" in:title" --json number --jq '.[0].number' 2>/dev/null || echo "")
+
+    if [[ -z "$ISSUE_NUMBER" ]]; then
+      echo "   ⚠️  GitHub Issue not found for $USER_STORY_ID"
+      exit 0
+    fi
+
+    echo "   📝 Found GitHub Issue #$ISSUE_NUMBER"
+
+    # Close issue
+    gh issue close "$ISSUE_NUMBER" --repo "$REPO" --comment "✅ User story completed
+
+🤖 Auto-closed by SpecWeave hook
+Completed at: $(date -u +%Y-%m-%dT%H:%M:%SZ)" 2>/dev/null || {
+      echo "   ⚠️  Failed to close issue"
+      exit 0
+    }
+
+    echo "   ✅ GitHub Issue #$ISSUE_NUMBER closed"
+    ;;
+
+  jira)
+    echo "   🔄 Updating Jira Story for $USER_STORY_ID..."
+
+    # Check if Jira config exists
+    if [[ -z "${JIRA_DOMAIN:-}" ]]; then
+      echo "   ⚠️  Jira not configured (.env), skipping sync"
+      exit 0
+    fi
+
+    # TODO: Find Jira Story by title pattern
+    # TODO: Transition story to "Done" status
+    echo "   ✅ Jira story transition queued (implementation pending)"
+    ;;
+
+  ado)
+    echo "   🔄 Updating ADO User Story for $USER_STORY_ID..."
+
+    # Check if ADO config exists
+    if [[ -z "${ADO_ORGANIZATION:-}" ]]; then
+      echo "   ⚠️  ADO not configured (.env), skipping sync"
+      exit 0
+    fi
+
+    # TODO: Find ADO User Story by title pattern
+    # TODO: Update state to "Closed"
+    echo "   ✅ ADO user story update queued (implementation pending)"
+    ;;
+
+  *)
+    echo "   ⚠️  Unknown provider: $PROVIDER"
+    exit 0
+    ;;
+esac
+
+echo "   ✅ Post-user-story-complete hook complete"
+echo ""
+
+exit 0

package/plugins/specweave/hooks/pre-command-deduplication.sh

@@ -4,7 +4,7 @@
 # Fires BEFORE any command executes (UserPromptSubmit hook)
 # Purpose: Prevent duplicate command invocations within configurable time window
 
-set -euo pipefail
+set +e  # EMERGENCY FIX: Changed from set -euo pipefail to prevent Claude Code crashes
 
 # ==============================================================================
 # PROJECT ROOT DETECTION

package/plugins/specweave/hooks/pre-command-deduplication.sh.bak

@@ -0,0 +1,83 @@
+#!/bin/bash
+
+# SpecWeave Pre-Command Deduplication Hook
+# Fires BEFORE any command executes (UserPromptSubmit hook)
+# Purpose: Prevent duplicate command invocations within configurable time window
+
+set -euo pipefail
+
+# ==============================================================================
+# 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
+
+# Read input JSON from stdin
+INPUT=$(cat)
+
+# ==============================================================================
+# DEDUPLICATION CHECK: Block duplicate commands within 1 second
+# ==============================================================================
+
+# Check if deduplication module is available
+if command -v node >/dev/null 2>&1 && [[ -f "dist/src/core/deduplication/command-deduplicator.js" ]]; then
+  # Use dedicated wrapper script for ES module compatibility
+  DEDUP_RESULT=$(echo "$INPUT" | node scripts/check-deduplication.js 2>/dev/null || echo "OK")
+
+  # Parse result
+  STATUS=$(echo "$DEDUP_RESULT" | head -1)
+
+  if [[ "$STATUS" == "DUPLICATE" ]]; then
+    # Get stats
+    STATS=$(echo "$DEDUP_RESULT" | tail -1)
+
+    # Extract command and stats for readable message
+    COMMAND=$(echo "$STATS" | grep -o '"lastCommand":"[^"]*"' | cut -d'"' -f4 || echo "unknown")
+    TOTAL_BLOCKED=$(echo "$STATS" | grep -o '"totalDuplicatesBlocked":[0-9]*' | cut -d':' -f2 || echo "1")
+    CACHE_SIZE=$(echo "$STATS" | grep -o '"currentCacheSize":[0-9]*' | cut -d':' -f2 || echo "1")
+
+    # Build error message WITHOUT embedding JSON (avoid escaping issues)
+    MESSAGE=$(cat <<'EOF'
+{
+  "decision": "block",
+  "reason": "🚫 DUPLICATE COMMAND DETECTED\n\nCommand: `COMMAND_PLACEHOLDER`\nTime window: 1 second\n\nThis command was just executed! To prevent unintended duplicates, this invocation has been blocked.\n\n💡 If you meant to run this command again:\n  1. Wait 1 second\n  2. Run the command again\n\nDeduplication Stats:\n- Total duplicates blocked: BLOCKED_PLACEHOLDER\n- Commands in cache: CACHE_PLACEHOLDER"
+}
+EOF
+)
+    # Replace placeholders (avoids JSON escaping issues)
+    # Use | as sed delimiter to avoid conflicts with / in command names
+    echo "$MESSAGE" | sed "s|COMMAND_PLACEHOLDER|$COMMAND|g" | sed "s|BLOCKED_PLACEHOLDER|$TOTAL_BLOCKED|g" | sed "s|CACHE_PLACEHOLDER|$CACHE_SIZE|g"
+    exit 0
+  fi
+fi
+
+# ==============================================================================
+# PASS THROUGH: No duplicate detected, proceed with command
+# ==============================================================================
+
+cat <<EOF
+{
+  "decision": "approve"
+}
+EOF
+
+exit 0

package/plugins/specweave/hooks/pre-increment-start.sh

@@ -0,0 +1,168 @@
+#!/bin/bash
+#
+# Pre-Increment-Start Hook
+#
+# Validates increment readiness before allowing `/specweave:do` to start work.
+#
+# **Critical Checks**:
+# 1. spec.md contains Acceptance Criteria
+# 2. AC count matches metadata.json
+# 3. No duplicate task files (tasks.md, tasks-detailed.md)
+# 4. Increment structure is valid
+#
+# **Triggered by**: /specweave:do command (before starting implementation)
+#
+# **Exit codes**:
+# - 0: Validation passed, safe to start
+# - 1: Validation failed, BLOCK start
+#
+# **See**: ADR-0062 (AC Embedding Architecture)
+#
+
+set -euo pipefail
+
+# Get increment path from environment or argument
+INCREMENT_PATH="${1:-}"
+
+if [ -z "$INCREMENT_PATH" ]; then
+  echo "❌ Error: INCREMENT_PATH not provided"
+  echo "Usage: $0 <increment-path>"
+  exit 1
+fi
+
+if [ ! -d "$INCREMENT_PATH" ]; then
+  echo "❌ Error: Increment path not found: $INCREMENT_PATH"
+  exit 1
+fi
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "PRE-START VALIDATION: $(basename "$INCREMENT_PATH")"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+VALIDATION_PASSED=true
+
+# Check 1: spec.md exists
+if [ ! -f "$INCREMENT_PATH/spec.md" ]; then
+  echo "❌ CRITICAL: spec.md not found"
+  VALIDATION_PASSED=false
+fi
+
+# Check 2: Acceptance Criteria section exists
+if [ -f "$INCREMENT_PATH/spec.md" ]; then
+  if ! grep -q "## Acceptance Criteria" "$INCREMENT_PATH/spec.md"; then
+    echo "❌ CRITICAL: spec.md missing '## Acceptance Criteria' section"
+    echo ""
+    echo "   spec.md MUST contain inline Acceptance Criteria for AC sync to work."
+    echo "   Even when using 'structure: user-stories', ACs must be embedded in spec.md."
+    echo ""
+    echo "   💡 SUGGESTED FIX:"
+    echo "      Run: /specweave:embed-acs $(basename "$INCREMENT_PATH")"
+    echo ""
+    VALIDATION_PASSED=false
+  fi
+fi
+
+# Check 3: Count ACs in spec.md
+AC_COUNT=0
+if [ -f "$INCREMENT_PATH/spec.md" ]; then
+  AC_COUNT=$(grep -cE "^- \[[x ]\] \*\*AC-US[0-9]+-[0-9]+\*\*:" "$INCREMENT_PATH/spec.md" || true)
+fi
+
+if [ "$AC_COUNT" -eq 0 ]; then
+  echo "❌ CRITICAL: spec.md contains 0 Acceptance Criteria"
+  echo ""
+  echo "   Cannot start increment with no ACs defined."
+  echo ""
+  echo "   💡 SUGGESTED FIX:"
+  echo "      1. Add ACs manually to spec.md, OR"
+  echo "      2. Run: /specweave:embed-acs $(basename "$INCREMENT_PATH") (auto-embed from living docs)"
+  echo ""
+  VALIDATION_PASSED=false
+else
+  echo "✅ Acceptance Criteria: $AC_COUNT ACs found in spec.md"
+fi
+
+# Check 4: Validate AC count matches metadata.json
+if [ -f "$INCREMENT_PATH/metadata.json" ]; then
+  EXPECTED_AC_COUNT=$(jq -r '.total_acs // 0' "$INCREMENT_PATH/metadata.json")
+
+  if [ "$EXPECTED_AC_COUNT" -ne "$AC_COUNT" ]; then
+    echo "⚠️  WARNING: AC count mismatch"
+    echo "   spec.md: $AC_COUNT ACs"
+    echo "   metadata.json: $EXPECTED_AC_COUNT ACs"
+    echo ""
+    echo "   This may cause status line desyncs."
+    echo ""
+    # Don't block, just warn (metadata.json may be stale)
+  else
+    echo "✅ AC Count: Matches metadata.json ($EXPECTED_AC_COUNT ACs)"
+  fi
+fi
+
+# Check 5: No duplicate task files
+TASK_FILES=$(find "$INCREMENT_PATH" -maxdepth 1 -name "tasks*.md" -type f | wc -l)
+if [ "$TASK_FILES" -gt 1 ]; then
+  echo "❌ CRITICAL: Multiple task files detected (MUST be only ONE tasks.md)"
+  find "$INCREMENT_PATH" -maxdepth 1 -name "tasks*.md" -type f -exec basename {} \;
+  echo ""
+  echo "   💡 SUGGESTED FIX:"
+  echo "      Keep tasks.md, move others to reports/ directory"
+  echo ""
+  VALIDATION_PASSED=false
+else
+  echo "✅ Structure: Single tasks.md file (no duplicates)"
+fi
+
+# Check 6: Validate frontmatter for 'structure: user-stories' pattern
+if [ -f "$INCREMENT_PATH/spec.md" ]; then
+  if grep -q "structure: user-stories" "$INCREMENT_PATH/spec.md"; then
+    if [ "$AC_COUNT" -eq 0 ]; then
+      echo ""
+      echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+      echo "🚨 CRITICAL ARCHITECTURE VIOLATION"
+      echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+      echo ""
+      echo "spec.md uses 'structure: user-stories' but contains NO inline ACs."
+      echo ""
+      echo "**Why this is critical**:"
+      echo "  - AC sync hooks expect ACs in spec.md (not living docs)"
+      echo "  - Without inline ACs, status line will show 0% completion"
+      echo "  - Tasks-to-AC traceability will be broken"
+      echo ""
+      echo "**Architecture requirement (ADR-0062)**:"
+      echo "  spec.md is ALWAYS the source of truth for ACs,"
+      echo "  even when living docs exist as documentation layer."
+      echo ""
+      echo "**IMMEDIATE ACTION REQUIRED**:"
+      echo "  Run: /specweave:embed-acs $(basename "$INCREMENT_PATH")"
+      echo ""
+      echo "This will auto-embed ACs from living docs into spec.md."
+      echo ""
+      VALIDATION_PASSED=false
+    else
+      echo "✅ Living Docs Structure: ACs properly embedded in spec.md"
+    fi
+  fi
+fi
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+if [ "$VALIDATION_PASSED" = true ]; then
+  echo "✅ PRE-START VALIDATION: PASSED"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+  echo "Increment is ready to start. Proceeding with /specweave:do..."
+  exit 0
+else
+  echo "❌ PRE-START VALIDATION: FAILED"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+  echo "Cannot start increment due to validation failures above."
+  echo ""
+  echo "Fix the issues and try again, or run validation manually:"
+  echo "  /specweave:validate $(basename "$INCREMENT_PATH")"
+  echo ""
+  exit 1
+fi

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

@@ -4,7 +4,7 @@
 # Fires BEFORE user's command executes (prompt-based hook)
 # Purpose: Discipline validation, context injection, command suggestions
 
-set -euo pipefail
+set +e  # EMERGENCY FIX: Changed from set -euo pipefail to prevent Claude Code crashes
 
 # Read input JSON from stdin
 INPUT=$(cat)