@a-company/paradigm 5.21.2 → 5.22.0

package/dist/{chunk-SWFC4HD7.js → chunk-QIGE36CB.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import*as e from'fs';import*as r from'path';import*as E from'os';import {execSync}from'child_process';import o from'chalk';var y=`#!/bin/sh
+import*as e from'fs';import*as r from'path';import*as E from'os';import {execSync}from'child_process';import o from'chalk';var C=`#!/bin/sh
 # paradigm-common.sh \u2014 Shared compliance checks for Paradigm stop hooks
 # Sourced by claude-code-stop.sh and cursor-stop.sh
 #
@@ -30,6 +30,8 @@ import*as e from'fs';import*as r from'path';import*as E from'os';import {execSyn
 #   9. Purpose-required patterns from config.yaml
 #  10. Aspect drift detection with auto-heal (from unified compliance-check)
 #  11. Portal gate implementation compliance (from unified compliance-check)
+#  12. Graduation failure tracking (auto-demotion)
+#  13. Orchestration required for complex tasks
 
 VIOLATIONS=""
 VIOLATION_COUNT=0
@@ -37,6 +39,35 @@ AUTO_FIXED=""
 AUTO_FIX_COUNT=0
 PARADIGM_AUTO_FIX="\${PARADIGM_AUTO_FIX:-0}"
 
+# --- Load enforcement config ---
+ENFORCEMENT_MAP=""
+if command -v paradigm >/dev/null 2>&1; then
+  ENFORCEMENT_MAP=$(paradigm enforcement resolve --json 2>/dev/null) || true
+fi
+
+# Helper: get severity for a check ID
+_check_severity() {
+  _id="$1"
+  _default="$2"
+  if [ -z "$ENFORCEMENT_MAP" ]; then
+    echo "$_default"
+    return
+  fi
+  _val=$(echo "$ENFORCEMENT_MAP" | grep -o "\\"$_id\\":\\"[^\\"]*\\"" | sed 's/.*":\\"//' | sed 's/"//')
+  if [ -n "$_val" ]; then
+    echo "$_val"
+  else
+    echo "$_default"
+  fi
+}
+
+# Read orchestration threshold
+ORCH_THRESHOLD=3
+if [ -n "$ENFORCEMENT_MAP" ]; then
+  _ot=$(echo "$ENFORCEMENT_MAP" | grep -o '"orchestrationThreshold":[0-9]*' | sed 's/.*://')
+  [ -n "$_ot" ] && ORCH_THRESHOLD="$_ot"
+fi
+
 # --- Cache .purpose file paths (avoid repeated find scans) ---
 PURPOSE_CACHE=".paradigm/.purpose-paths"
 if [ -f "$PURPOSE_CACHE" ]; then
@@ -103,17 +134,24 @@ for file in $MODIFIED; do
 done
 
 # Only flag if there are uncovered directories AND zero paradigm files were touched
-if [ -n "$UNCOVERED_SOURCE_DIRS" ] && [ "$PARADIGM_COUNT" -eq 0 ]; then
+_SEV=$(_check_severity "purpose-coverage" "block")
+if [ "$_SEV" != "off" ] && [ -n "$UNCOVERED_SOURCE_DIRS" ] && [ "$PARADIGM_COUNT" -eq 0 ]; then
   # Count uncovered dirs
   UNCOVERED_DIR_COUNT=0
   for _d in $UNCOVERED_SOURCE_DIRS; do
     UNCOVERED_DIR_COUNT=$((UNCOVERED_DIR_COUNT + 1))
   done
-  VIOLATIONS="$VIOLATIONS
+  if [ "$_SEV" = "block" ]; then
+    VIOLATIONS="$VIOLATIONS
   - You modified source files in $UNCOVERED_DIR_COUNT director(ies) without updating their .purpose files:
    $UNCOVERED_SOURCE_DIRS
     Update the nearest .purpose file for each modified code area."
-  VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+    VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+  else
+    ADVISORY="$ADVISORY
+  - (warn) Source files in $UNCOVERED_DIR_COUNT director(ies) modified without .purpose updates:
+   $UNCOVERED_SOURCE_DIRS"
+  fi
 fi
 
 # --- Check 2: Modified source directories missing .purpose files ---
@@ -149,7 +187,8 @@ for file in $MODIFIED; do
   fi
 done
 
-if [ -n "$DIRS_WITHOUT_PURPOSE" ]; then
+_SEV=$(_check_severity "purpose-exists" "block")
+if [ "$_SEV" != "off" ] && [ -n "$DIRS_WITHOUT_PURPOSE" ]; then
   if [ "$PARADIGM_AUTO_FIX" = "1" ]; then
     # Auto-fix: create stub .purpose files for directories missing them
     for dir in $DIRS_WITHOUT_PURPOSE; do
@@ -165,86 +204,107 @@ PURPOSEEOF
   - Created stub .purpose in $dir (update descriptions)"
       AUTO_FIX_COUNT=$((AUTO_FIX_COUNT + 1))
     done
-  else
+  elif [ "$_SEV" = "block" ]; then
     VIOLATIONS="$VIOLATIONS
   - These directories have modified source files but no .purpose file anywhere in their path:
    $DIRS_WITHOUT_PURPOSE
     Create a .purpose file using paradigm_purpose_init + paradigm_purpose_add_component."
     VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+  else
+    ADVISORY="$ADVISORY
+  - (warn) Directories with modified source files but no .purpose file:
+   $DIRS_WITHOUT_PURPOSE"
   fi
 fi
 
 # --- Check 3: Route patterns added without portal.yaml ---
-if [ -f "portal.yaml" ] || echo "$MODIFIED" | grep -q "portal.yaml"; then
-  : # portal.yaml exists or was modified \u2014 OK
-else
-  # Check if any modified files contain route-like patterns
-  # Skip: test/spec/fixture files, markdown, and comment-only matches
-  ROUTE_FILES=""
-  for file in $MODIFIED; do
-    # Skip test, spec, and fixture files entirely
-    case "$file" in
-      *test*|*spec*|*fixture*|*__tests__*|*__mocks__*|*.test.*|*.spec.*) continue ;;
-    esac
-    case "$file" in
-      *.ts|*.js|*.tsx|*.jsx|*.py|*.rs|*.go)
-        if [ -f "$file" ]; then
-          # Grep for route patterns, then filter out comment lines and description strings
-          ROUTE_MATCH=$(grep -nE '\\.(get|post|put|patch|delete)\\s*\\(|router\\.|app\\.(get|post|put|delete)|@(Get|Post|Put|Delete)|#\\[actix_web::(get|post)' "$file" 2>/dev/null \\
-            | grep -v '^\\s*[0-9]*:\\s*//' \\
-            | grep -v '^\\s*[0-9]*:\\s*\\*' \\
-            | grep -v '^\\s*[0-9]*:\\s*#' \\
-            | grep -v '^\\s*[0-9]*:\\s*<!--' \\
-            | grep -v 'description:' \\
-            | grep -v 'summary:' \\
-            | grep -v 'comment:' \\
-            | grep -v '@example' \\
-            | grep -v '@see' \\
-            || true)
-          if [ -n "$ROUTE_MATCH" ]; then
-            ROUTE_FILES="$ROUTE_FILES $file"
+_SEV=$(_check_severity "portal-gates" "block")
+if [ "$_SEV" != "off" ]; then
+  if [ -f "portal.yaml" ] || echo "$MODIFIED" | grep -q "portal.yaml"; then
+    : # portal.yaml exists or was modified \u2014 OK
+  else
+    # Check if any modified files contain route-like patterns
+    # Skip: test/spec/fixture files, markdown, and comment-only matches
+    ROUTE_FILES=""
+    for file in $MODIFIED; do
+      # Skip test, spec, and fixture files entirely
+      case "$file" in
+        *test*|*spec*|*fixture*|*__tests__*|*__mocks__*|*.test.*|*.spec.*) continue ;;
+      esac
+      case "$file" in
+        *.ts|*.js|*.tsx|*.jsx|*.py|*.rs|*.go)
+          if [ -f "$file" ]; then
+            # Grep for route patterns, then filter out comment lines and description strings
+            ROUTE_MATCH=$(grep -nE '\\.(get|post|put|patch|delete)\\s*\\(|router\\.|app\\.(get|post|put|delete)|@(Get|Post|Put|Delete)|#\\[actix_web::(get|post)' "$file" 2>/dev/null \\
+              | grep -v '^\\s*[0-9]*:\\s*//' \\
+              | grep -v '^\\s*[0-9]*:\\s*\\*' \\
+              | grep -v '^\\s*[0-9]*:\\s*#' \\
+              | grep -v '^\\s*[0-9]*:\\s*<!--' \\
+              | grep -v 'description:' \\
+              | grep -v 'summary:' \\
+              | grep -v 'comment:' \\
+              | grep -v '@example' \\
+              | grep -v '@see' \\
+              || true)
+            if [ -n "$ROUTE_MATCH" ]; then
+              ROUTE_FILES="$ROUTE_FILES $file"
+            fi
           fi
-        fi
-        ;;
-    esac
-  done
+          ;;
+      esac
+    done
 
-  if [ -n "$ROUTE_FILES" ]; then
-    VIOLATIONS="$VIOLATIONS
+    if [ -n "$ROUTE_FILES" ]; then
+      if [ "$_SEV" = "block" ]; then
+        VIOLATIONS="$VIOLATIONS
   - Route/endpoint patterns found in modified files but no portal.yaml exists:
    $ROUTE_FILES
     Create portal.yaml with gate definitions. Use paradigm_gates_for_route for suggestions."
-    VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+        VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+      else
+        ADVISORY="$ADVISORY
+  - (warn) Route/endpoint patterns found without portal.yaml:
+   $ROUTE_FILES"
+      fi
+    fi
   fi
 fi
 
 # --- Check 4: Aspect anchor files that no longer exist ---
-for purpose_file in $PURPOSE_PATHS; do
-  if grep -q "anchors:" "$purpose_file" 2>/dev/null; then
-    purpose_dir=$(dirname "$purpose_file")
-    in_anchors=false
-    while IFS= read -r line; do
-      case "$line" in
-        *"anchors:"*) in_anchors=true; continue ;;
-        *"- "*)
-          if [ "$in_anchors" = true ]; then
-            anchor_path=$(echo "$line" | sed 's/.*- //' | sed 's/:.*//' | tr -d ' ')
-            if [ -n "$anchor_path" ]; then
-              # Try relative to .purpose dir first, then project root
-              if [ ! -f "$purpose_dir/$anchor_path" ] && [ ! -f "./$anchor_path" ]; then
-                VIOLATIONS="$VIOLATIONS
+_SEV=$(_check_severity "aspect-anchors" "block")
+if [ "$_SEV" != "off" ]; then
+  for purpose_file in $PURPOSE_PATHS; do
+    if grep -q "anchors:" "$purpose_file" 2>/dev/null; then
+      purpose_dir=$(dirname "$purpose_file")
+      in_anchors=false
+      while IFS= read -r line; do
+        case "$line" in
+          *"anchors:"*) in_anchors=true; continue ;;
+          *"- "*)
+            if [ "$in_anchors" = true ]; then
+              anchor_path=$(echo "$line" | sed 's/.*- //' | sed 's/:.*//' | tr -d ' ')
+              if [ -n "$anchor_path" ]; then
+                # Try relative to .purpose dir first, then project root
+                if [ ! -f "$purpose_dir/$anchor_path" ] && [ ! -f "./$anchor_path" ]; then
+                  if [ "$_SEV" = "block" ]; then
+                    VIOLATIONS="$VIOLATIONS
   - Aspect anchor '$anchor_path' in $purpose_file does not exist.
     Update the anchor or remove the stale aspect."
-                VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+                    VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+                  else
+                    ADVISORY="$ADVISORY
+  - (warn) Aspect anchor '$anchor_path' in $purpose_file does not exist."
+                  fi
+                fi
               fi
             fi
-          fi
-          ;;
-        *) in_anchors=false ;;
-      esac
-    done < "$purpose_file"
-  fi
-done
+            ;;
+          *) in_anchors=false ;;
+        esac
+      done < "$purpose_file"
+    fi
+  done
+fi
 
 # --- Check 5: Per-directory .purpose freshness ---
 # Uses .pending-review if available, plus a git-based fallback that cross-references
@@ -328,51 +388,62 @@ for file in $MODIFIED; do
   fi
 done
 
-if [ -n "$STALE_PURPOSES" ]; then
-  VIOLATIONS="$VIOLATIONS
+_SEV=$(_check_severity "purpose-freshness" "warn")
+if [ "$_SEV" != "off" ] && [ -n "$STALE_PURPOSES" ]; then
+  if [ "$_SEV" = "block" ]; then
+    VIOLATIONS="$VIOLATIONS
   - These .purpose files cover modified source code but were NOT updated:
    $STALE_PURPOSES
     Update each with: #components, ~aspects (with anchors), !signals, \\$flows, ^gates."
-  VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+    VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+  else
+    ADVISORY="$ADVISORY
+  - (warn) These .purpose files cover modified source code but were NOT updated:
+   $STALE_PURPOSES"
+  fi
 fi
 
 # --- Check 6: Aspect coverage advisory ---
 ADVISORY=""
-HAS_ASPECTS=false
-for purpose_file in $PURPOSE_PATHS; do
-  if grep -qE '^\\s*~' "$purpose_file" 2>/dev/null; then
-    HAS_ASPECTS=true
-    break
-  fi
-done
-
-if [ "$HAS_ASPECTS" = true ] && [ "$SOURCE_COUNT" -gt 0 ]; then
-  ASPECT_UPDATED=false
-  for file in $MODIFIED; do
-    case "$file" in
-      *.purpose)
-        if grep -qE '^\\s*~|anchors:|applies-to:' "$file" 2>/dev/null; then
-          ASPECT_UPDATED=true
-          break
-        fi
-        ;;
-    esac
+_SEV=$(_check_severity "aspect-advisory" "warn")
+if [ "$_SEV" != "off" ]; then
+  HAS_ASPECTS=false
+  for purpose_file in $PURPOSE_PATHS; do
+    if grep -qE '^\\s*~' "$purpose_file" 2>/dev/null; then
+      HAS_ASPECTS=true
+      break
+    fi
   done
 
-  if [ "$ASPECT_UPDATED" = false ]; then
-    ADVISORY="  This project defines ~aspects with code anchors. Check if existing
+  if [ "$HAS_ASPECTS" = true ] && [ "$SOURCE_COUNT" -gt 0 ]; then
+    ASPECT_UPDATED=false
+    for file in $MODIFIED; do
+      case "$file" in
+        *.purpose)
+          if grep -qE '^\\s*~|anchors:|applies-to:' "$file" 2>/dev/null; then
+            ASPECT_UPDATED=true
+            break
+          fi
+          ;;
+      esac
+    done
+
+    if [ "$ASPECT_UPDATED" = false ]; then
+      ADVISORY="  This project defines ~aspects with code anchors. Check if existing
   ~aspects need updated anchors or applies-to patterns."
+    fi
   fi
 fi
 
 # --- Check 7: Lore entry expected for significant sessions ---
-if [ "$SOURCE_COUNT" -ge 3 ] && [ -d ".paradigm/lore" ]; then
+_SEV=$(_check_severity "lore-required" "block")
+if [ "$_SEV" != "off" ] && [ "$SOURCE_COUNT" -ge 3 ] && [ -d ".paradigm/lore" ]; then
   LORE_RECORDED=false
 
   # Check git diff first (covers staged/committed lore)
   for file in $MODIFIED; do
     case "$file" in
-      .paradigm/lore/entries/*.yaml|.paradigm/lore/entries/*/*.yaml)
+      .paradigm/lore/entries/*.yaml|.paradigm/lore/entries/*/*.yaml|.paradigm/lore/entries/*.lore|.paradigm/lore/entries/*/*.lore)
         LORE_RECORDED=true
         break
         ;;
@@ -383,7 +454,7 @@ if [ "$SOURCE_COUNT" -ge 3 ] && [ -d ".paradigm/lore" ]; then
   if [ "$LORE_RECORDED" = false ]; then
     TODAY=$(date -u +"%Y-%m-%d")
     if [ -d ".paradigm/lore/entries/$TODAY" ]; then
-      ENTRY_COUNT=$(find ".paradigm/lore/entries/$TODAY" -name "*.yaml" 2>/dev/null | head -1)
+      ENTRY_COUNT=$(find ".paradigm/lore/entries/$TODAY" \\( -name "*.yaml" -o -name "*.lore" \\) 2>/dev/null | head -1)
       if [ -n "$ENTRY_COUNT" ]; then
         LORE_RECORDED=true
       fi
@@ -424,12 +495,15 @@ LOREEOF
       AUTO_FIXED="$AUTO_FIXED
   - Created stub lore entry $LORE_ID (update with real summary)"
       AUTO_FIX_COUNT=$((AUTO_FIX_COUNT + 1))
-    else
+    elif [ "$_SEV" = "block" ]; then
       VIOLATIONS="$VIOLATIONS
   - You modified $SOURCE_COUNT source files but recorded no lore entry.
     Record your session: paradigm_lore_record (MCP) or paradigm lore record (CLI).
     Include: type, title, summary, and symbols_touched."
       VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+    else
+      ADVISORY="$ADVISORY
+  - (warn) $SOURCE_COUNT source files modified without a lore entry."
     fi
   fi
 fi
@@ -446,17 +520,23 @@ fi
 
 if [ -n "$COMPLIANCE_RESULT" ]; then
   # --- Check 8: Blocking habits (from unified result) ---
-  # The compliance-check command writes .habits-blocking marker internally
-  if [ -f ".paradigm/.habits-blocking" ]; then
+  _SEV=$(_check_severity "habits-blocking" "block")
+  if [ "$_SEV" != "off" ] && [ -f ".paradigm/.habits-blocking" ]; then
     HABITS_BLOCKING=$(cat ".paradigm/.habits-blocking")
-    VIOLATIONS="$VIOLATIONS
+    if [ "$_SEV" = "block" ]; then
+      VIOLATIONS="$VIOLATIONS
   - Blocking habit(s) not satisfied:
     $HABITS_BLOCKING
     Fix: satisfy the habit(s), or change severity to 'warn' in .paradigm/habits.yaml to make advisory."
-    VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+      VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+    else
+      ADVISORY="$ADVISORY
+  - (warn) Blocking habit(s) not satisfied: $HABITS_BLOCKING"
+    fi
   fi
 
   # --- Check 10: Aspect drift (from unified result) ---
+  _SEV=$(_check_severity "drift-detection" "block")
   DRIFTED_COUNT=$(echo "$COMPLIANCE_RESULT" | grep -o '"driftedCount":[0-9]*' | sed 's/.*://')
   HEALED_COUNT=$(echo "$COMPLIANCE_RESULT" | grep -o '"healedCount":[0-9]*' | sed 's/.*://')
 
@@ -464,39 +544,57 @@ if [ -n "$COMPLIANCE_RESULT" ]; then
     echo "[paradigm] Auto-healed $HEALED_COUNT shifted anchor(s)." >&2
   fi
 
-  if [ -n "$DRIFTED_COUNT" ] && [ "$DRIFTED_COUNT" -gt 0 ] 2>/dev/null; then
-    VIOLATIONS="$VIOLATIONS
+  if [ "$_SEV" != "off" ] && [ -n "$DRIFTED_COUNT" ] && [ "$DRIFTED_COUNT" -gt 0 ] 2>/dev/null; then
+    if [ "$_SEV" = "block" ]; then
+      VIOLATIONS="$VIOLATIONS
   - $DRIFTED_COUNT aspect anchor(s) have drifted (content genuinely changed).
     Run paradigm_aspect_check to review. Update anchors in .purpose files."
-    VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+      VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+    else
+      ADVISORY="$ADVISORY
+  - (warn) $DRIFTED_COUNT aspect anchor(s) have drifted."
+    fi
   fi
 
   # --- Check 11: Portal gate compliance (from unified result) ---
+  _SEV=$(_check_severity "portal-compliance" "block")
   UNDECLARED=$(echo "$COMPLIANCE_RESULT" | grep -o '"usedButUndeclaredCount":[0-9]*' | sed 's/.*://')
 
-  if [ -n "$UNDECLARED" ] && [ "$UNDECLARED" -gt 0 ] 2>/dev/null; then
+  if [ "$_SEV" != "off" ] && [ -n "$UNDECLARED" ] && [ "$UNDECLARED" -gt 0 ] 2>/dev/null; then
     UNDECLARED_LIST=$(echo "$COMPLIANCE_RESULT" | grep -o '"usedButUndeclared":\\[[^]]*\\]' | sed 's/.*\\[//;s/\\].*//;s/"//g')
-    VIOLATIONS="$VIOLATIONS
+    if [ "$_SEV" = "block" ]; then
+      VIOLATIONS="$VIOLATIONS
   - $UNDECLARED gate(s) used in code but not declared in portal.yaml:
     $UNDECLARED_LIST
     Add them to portal.yaml or use paradigm_portal_add_gate."
-    VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+      VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+    else
+      ADVISORY="$ADVISORY
+  - (warn) $UNDECLARED gate(s) used in code but not declared in portal.yaml: $UNDECLARED_LIST"
+    fi
   fi
 else
   # Fallback: check habits blocking marker even if compliance-check unavailable
-  if [ -f ".paradigm/.habits-blocking" ]; then
+  _SEV=$(_check_severity "habits-blocking" "block")
+  if [ "$_SEV" != "off" ] && [ -f ".paradigm/.habits-blocking" ]; then
     HABITS_BLOCKING=$(cat ".paradigm/.habits-blocking")
-    VIOLATIONS="$VIOLATIONS
+    if [ "$_SEV" = "block" ]; then
+      VIOLATIONS="$VIOLATIONS
   - Blocking habit(s) not satisfied:
     $HABITS_BLOCKING
     Fix: satisfy the habit(s), or change severity to 'warn' in .paradigm/habits.yaml to make advisory."
-    VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+      VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+    else
+      ADVISORY="$ADVISORY
+  - (warn) Blocking habit(s) not satisfied: $HABITS_BLOCKING"
+    fi
   fi
 fi
 
 # --- Check 9: Purpose-required patterns from config.yaml ---
+_SEV=$(_check_severity "purpose-required-patterns" "block")
 CONFIG_FILE=".paradigm/config.yaml"
-if [ -f "$CONFIG_FILE" ]; then
+if [ "$_SEV" != "off" ] && [ -f "$CONFIG_FILE" ]; then
   MISSING_REQUIRED=""
   in_section=false
   current_pattern=""
@@ -582,19 +680,24 @@ PURPOSEEOF
   - Created stub .purpose in $dir (purpose-required pattern)"
         AUTO_FIX_COUNT=$((AUTO_FIX_COUNT + 1))
       done
-    else
+    elif [ "$_SEV" = "block" ]; then
       VIOLATIONS="$VIOLATIONS
   - These directories match purpose-required patterns but have no .purpose file:
    $MISSING_REQUIRED
     Create .purpose files: paradigm_purpose_init + paradigm_purpose_add_component."
       VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+    else
+      ADVISORY="$ADVISORY
+  - (warn) Directories matching purpose-required patterns without .purpose file:
+   $MISSING_REQUIRED"
     fi
   fi
 fi
 
 # --- Check 12: Graduation failure tracking ---
 # When violations occur for graduated habits, record failures for auto-demotion.
-if [ "$VIOLATION_COUNT" -gt 0 ] && [ -f ".paradigm/graduation.yaml" ]; then
+_SEV=$(_check_severity "graduation-tracking" "warn")
+if [ "$_SEV" != "off" ] && [ "$VIOLATION_COUNT" -gt 0 ] && [ -f ".paradigm/graduation.yaml" ]; then
   GRAD_FAILURES_DIR=".paradigm/.graduation-failures"
   mkdir -p "$GRAD_FAILURES_DIR" 2>/dev/null
 
@@ -639,6 +742,23 @@ if [ "$VIOLATION_COUNT" -gt 0 ] && [ -f ".paradigm/graduation.yaml" ]; then
     fi
   done
 fi
+
+# --- Check 13: Orchestration required for complex tasks ---
+_SEV=$(_check_severity "orchestration-required" "warn")
+if [ "$_SEV" != "off" ] && [ "$SOURCE_COUNT" -ge "$ORCH_THRESHOLD" ]; then
+  if [ ! -f ".paradigm/.orchestrated" ]; then
+    if [ "$_SEV" = "block" ]; then
+      VIOLATIONS="$VIOLATIONS
+  - You modified $SOURCE_COUNT source files without running orchestration.
+    Run paradigm_orchestrate_inline mode=\\"plan\\" first.
+    Override: paradigm enforcement override orchestration-required warn"
+      VIOLATION_COUNT=$((VIOLATION_COUNT + 1))
+    else
+      ADVISORY="$ADVISORY
+  - (orchestration) $SOURCE_COUNT files modified without team orchestration."
+    fi
+  fi
+fi
 `,R=`#!/bin/sh
 # Paradigm Claude Code Stop Hook (v2)
 # Validates paradigm compliance before allowing the agent to finish.
@@ -647,7 +767,7 @@ fi
 # Hook type: Stop
 # Exit 0 = allow, Exit 2 = block with message
 #
-# Checks 1\u201311 are defined in paradigm-common.sh (shared with Cursor hook).
+# Checks 1\u201313 are defined in paradigm-common.sh (shared with Cursor hook).
 
 # Read JSON from stdin (hook input)
 INPUT=$(cat)
@@ -747,13 +867,14 @@ rm -f ".paradigm/.pending-review"
 rm -f ".paradigm/.habits-blocking"
 rm -f ".paradigm/.session-started"
 rm -f ".paradigm/.purpose-paths"
+rm -f ".paradigm/.orchestrated"
 
 exit 0
-`,U=`#!/bin/sh
+`,A=`#!/bin/sh
 # Legacy afterFileEdit hook \u2014 replaced by paradigm-posttooluse.sh (postToolUse)
 # Kept as a no-op because Claude Code expects the file to exist.
 exit 0
-`,A=`#!/bin/sh
+`,U=`#!/bin/sh
 # Paradigm Claude Code Pre-Commit Hook
 # Intercepts git commit Bash calls and auto-rebuilds the index.
 # Installed by: paradigm hooks install --claude-code
@@ -798,7 +919,7 @@ done
 
 # Never block \u2014 exit 0
 exit 0
-`,P=`#!/bin/sh
+`,D=`#!/bin/sh
 # Paradigm Cursor Session Start Hook
 # Fires before the agent does anything \u2014 injects additional_context
 # that acts as a deterministic system prompt (not subject to context compaction).
@@ -906,7 +1027,7 @@ exit 0
 # Hook type: stop
 # Exit 0 = allow, Exit 2 = block with message
 #
-# Checks 1\u201311 are defined in paradigm-common.sh (shared with Claude Code hook).
+# Checks 1\u201313 are defined in paradigm-common.sh (shared with Claude Code hook).
 
 # Read JSON from stdin (hook input)
 INPUT=$(cat)
@@ -1028,9 +1149,10 @@ rm -f ".paradigm/.habits-blocking"
 rm -f ".paradigm/.stop-hook-active"
 rm -f ".paradigm/.session-started"
 rm -f ".paradigm/.purpose-paths"
+rm -f ".paradigm/.orchestrated"
 
 exit 0
-`,D=`#!/bin/sh
+`,P=`#!/bin/sh
 # Legacy afterFileEdit hook \u2014 replaced by paradigm-posttooluse.sh (postToolUse)
 # Kept as a no-op because Cursor expects the file to exist.
 exit 0
@@ -1348,9 +1470,9 @@ if [ "$PENDING_COUNT" -ge 30 ]; then
 fi
 
 exit 0
-`;function x(){try{let i=r.join(E.homedir(),".claude","settings.json");if(!e.existsSync(i))return {active:!1};if(!JSON.parse(e.readFileSync(i,"utf8")).enabledPlugins?.["paradigm@a-paradigm"])return {active:!1};let d=r.join(E.homedir(),".claude","plugins","cache","a-paradigm","paradigm");if(!e.existsSync(d))return {active:!1};let a=e.readdirSync(d).filter(s=>e.statSync(r.join(d,s)).isDirectory()).sort().reverse();if(a.length===0)return {active:!1};let p=r.join(d,a[0]),l=r.join(p,"hooks","hooks.json");return e.existsSync(l)?{active:!0,cacheVersion:a[0]}:{active:!1}}catch{return {active:false}}}function X(){try{let i=x();if(!i.active||!i.cacheVersion)return {compatible:!0};let h=r.join(E.homedir(),".claude","plugins","cache","a-paradigm","paradigm",i.cacheVersion,"hooks.json");if(!e.existsSync(h))return {compatible:!0};let d=JSON.parse(e.readFileSync(h,"utf8")).compatibleVersions;if(!d)return {compatible:!0};let a=W();if(!a)return {compatible:!0};let p=d.split(/\s+/);for(let l of p){let s=l.match(/^(>=?|<=?)\s*(\d+\.\d+\.\d+)/);if(!s)continue;let[,t,n]=s,f=Y(a,n);if(t===">="&&f<0)return {compatible:!1,message:`Plugin requires paradigm ${d}, current: ${a}`};if(t===">"&&f<=0)return {compatible:!1,message:`Plugin requires paradigm ${d}, current: ${a}`};if(t==="<="&&f>0)return {compatible:!1,message:`Plugin requires paradigm ${d}, current: ${a}`};if(t==="<"&&f>=0)return {compatible:!1,message:`Plugin requires paradigm ${d}, current: ${a}`}}return {compatible:!0}}catch{return {compatible:true}}}function W(){try{let i=r.join(r.dirname(new URL(import.meta.url).pathname),"..","..","package.json");return JSON.parse(e.readFileSync(i,"utf8")).version||null}catch{return null}}function Y(i,h){let c=i.split(".").map(Number),d=h.split(".").map(Number);for(let a=0;a<3;a++){if((c[a]||0)<(d[a]||0))return  -1;if((c[a]||0)>(d[a]||0))return 1}return 0}function J(i){let h=[],c=r.join(i,".claude","hooks");if(e.existsSync(c)){for(let a of ["paradigm-common.sh","paradigm-stop.sh","paradigm-precommit.sh","paradigm-postwrite.sh"]){let p=r.join(c,a);e.existsSync(p)&&(e.unlinkSync(p),h.push(a));}try{e.readdirSync(c).length===0&&e.rmdirSync(c);}catch{}}let d=r.join(i,".claude","settings.json");if(e.existsSync(d))try{let a=JSON.parse(e.readFileSync(d,"utf8")),p=a.hooks;if(p){let l=!1;for(let[s,t]of Object.entries(p)){if(!Array.isArray(t))continue;let n=t.filter(f=>!JSON.stringify(f).includes("paradigm-"));n.length!==t.length&&(l=!0,n.length===0?delete p[s]:p[s]=n);}l&&(Object.keys(p).length===0?delete a.hooks:a.hooks=p,e.writeFileSync(d,JSON.stringify(a,null,2)+`
-`,"utf8"),h.push("settings.json hooks"));}}catch{}return {cleaned:h.length>0,removed:h}}function q(i,h){try{let c=r.join(E.tmpdir(),`paradigm-hook-validate-${Date.now()}.sh`);e.writeFileSync(c,i,"utf8");try{return execSync(`bash -n "${c}" 2>&1`,{encoding:"utf-8"}),null}catch(d){return `${h}: bash syntax error \u2014 ${d.message?.split(`
-`)[0]||"unknown error"}`}finally{try{e.unlinkSync(c);}catch{}}}catch{return null}}var H=`#!/bin/sh
+`;function x(){try{let i=r.join(E.homedir(),".claude","settings.json");if(!e.existsSync(i))return {active:!1};if(!JSON.parse(e.readFileSync(i,"utf8")).enabledPlugins?.["paradigm@a-paradigm"])return {active:!1};let d=r.join(E.homedir(),".claude","plugins","cache","a-paradigm","paradigm");if(!e.existsSync(d))return {active:!1};let a=e.readdirSync(d).filter(s=>e.statSync(r.join(d,s)).isDirectory()).sort().reverse();if(a.length===0)return {active:!1};let p=r.join(d,a[0]),l=r.join(p,"hooks","hooks.json");return e.existsSync(l)?{active:!0,cacheVersion:a[0]}:{active:!1}}catch{return {active:false}}}function Y(){try{let i=x();if(!i.active||!i.cacheVersion)return {compatible:!0};let h=r.join(E.homedir(),".claude","plugins","cache","a-paradigm","paradigm",i.cacheVersion,"hooks.json");if(!e.existsSync(h))return {compatible:!0};let d=JSON.parse(e.readFileSync(h,"utf8")).compatibleVersions;if(!d)return {compatible:!0};let a=X();if(!a)return {compatible:!0};let p=d.split(/\s+/);for(let l of p){let s=l.match(/^(>=?|<=?)\s*(\d+\.\d+\.\d+)/);if(!s)continue;let[,t,n]=s,f=W(a,n);if(t===">="&&f<0)return {compatible:!1,message:`Plugin requires paradigm ${d}, current: ${a}`};if(t===">"&&f<=0)return {compatible:!1,message:`Plugin requires paradigm ${d}, current: ${a}`};if(t==="<="&&f>0)return {compatible:!1,message:`Plugin requires paradigm ${d}, current: ${a}`};if(t==="<"&&f>=0)return {compatible:!1,message:`Plugin requires paradigm ${d}, current: ${a}`}}return {compatible:!0}}catch{return {compatible:true}}}function X(){try{let i=r.join(r.dirname(new URL(import.meta.url).pathname),"..","..","package.json");return JSON.parse(e.readFileSync(i,"utf8")).version||null}catch{return null}}function W(i,h){let c=i.split(".").map(Number),d=h.split(".").map(Number);for(let a=0;a<3;a++){if((c[a]||0)<(d[a]||0))return  -1;if((c[a]||0)>(d[a]||0))return 1}return 0}function q(i){let h=[],c=r.join(i,".claude","hooks");if(e.existsSync(c)){for(let a of ["paradigm-common.sh","paradigm-stop.sh","paradigm-precommit.sh","paradigm-postwrite.sh"]){let p=r.join(c,a);e.existsSync(p)&&(e.unlinkSync(p),h.push(a));}try{e.readdirSync(c).length===0&&e.rmdirSync(c);}catch{}}let d=r.join(i,".claude","settings.json");if(e.existsSync(d))try{let a=JSON.parse(e.readFileSync(d,"utf8")),p=a.hooks;if(p){let l=!1;for(let[s,t]of Object.entries(p)){if(!Array.isArray(t))continue;let n=t.filter(f=>!JSON.stringify(f).includes("paradigm-"));n.length!==t.length&&(l=!0,n.length===0?delete p[s]:p[s]=n);}l&&(Object.keys(p).length===0?delete a.hooks:a.hooks=p,e.writeFileSync(d,JSON.stringify(a,null,2)+`
+`,"utf8"),h.push("settings.json hooks"));}}catch{}return {cleaned:h.length>0,removed:h}}function J(i,h){try{let c=r.join(E.tmpdir(),`paradigm-hook-validate-${Date.now()}.sh`);e.writeFileSync(c,i,"utf8");try{return execSync(`bash -n "${c}" 2>&1`,{encoding:"utf-8"}),null}catch(d){return `${h}: bash syntax error \u2014 ${d.message?.split(`
+`)[0]||"unknown error"}`}finally{try{e.unlinkSync(c);}catch{}}}catch{return null}}var F=`#!/bin/sh
 # Paradigm post-commit hook - captures history from commits
 # Installed by: paradigm hooks install
 
@@ -1434,7 +1556,7 @@ if [ -n "$SYMBOLS" ] && [ -d ".paradigm/history" ]; then
 
   echo "[paradigm] History entry $ID recorded"
 fi
-`,j=`#!/bin/sh
+`,H=`#!/bin/sh
 # Paradigm pre-push hook - reindex history before pushing
 # Installed by: paradigm hooks install
 
@@ -1444,12 +1566,12 @@ if [ -d ".paradigm/history" ] && [ -f ".paradigm/history/log.jsonl" ]; then
 fi
 `;async function te(i={}){let h=process.cwd(),c=i.dryRun||false;c&&console.log(o.cyan(`
   [dry-run] Showing what would be installed:
-`));let d=i.claudeCode&&!i.postCommit&&!i.prePush&&!i.cursor,a=i.cursor&&!i.postCommit&&!i.prePush&&!i.claudeCode;if(!c){let s=[{name:"post-commit",content:H},{name:"pre-push",content:j},{name:"paradigm-common",content:y},{name:"claude-code-stop",content:R},{name:"claude-code-precommit",content:A},{name:"claude-code-postwrite",content:U},{name:"cursor-session-start",content:P},{name:"cursor-stop",content:v},{name:"cursor-precommit",content:b},{name:"cursor-postwrite",content:D},{name:"cursor-pretooluse",content:L},{name:"cursor-posttooluse",content:w}];for(let t of s){let n=q(t.content,t.name);if(n){console.log(o.red(`Hook syntax error: ${n}`)),console.log(o.gray("Aborting installation. Fix the hook script and try again."));return}}}let p=X();if(p.compatible||(console.log(o.yellow(`
+`));let d=i.claudeCode&&!i.postCommit&&!i.prePush&&!i.cursor,a=i.cursor&&!i.postCommit&&!i.prePush&&!i.claudeCode;if(!c){let s=[{name:"post-commit",content:F},{name:"pre-push",content:H},{name:"paradigm-common",content:C},{name:"claude-code-stop",content:R},{name:"claude-code-precommit",content:U},{name:"claude-code-postwrite",content:A},{name:"cursor-session-start",content:D},{name:"cursor-stop",content:v},{name:"cursor-precommit",content:b},{name:"cursor-postwrite",content:P},{name:"cursor-pretooluse",content:L},{name:"cursor-posttooluse",content:w}];for(let t of s){let n=J(t.content,t.name);if(n){console.log(o.red(`Hook syntax error: ${n}`)),console.log(o.gray("Aborting installation. Fix the hook script and try again."));return}}}let p=Y();if(p.compatible||(console.log(o.yellow(`
 \u26A0  ${p.message}`)),console.log(o.gray(`  Hook installation will continue, but behavior may differ from plugin expectations.
-`))),!d&&!a){let s=r.join(h,".git");if(!e.existsSync(s)){console.log(o.red("Not a git repository."));return}let t=r.join(s,"hooks"),n=!i.postCommit&&!i.prePush&&!i.claudeCode,f=[];if(n||i.postCommit){let u=r.join(t,"post-commit");if(c){let g=e.existsSync(u)&&!i.force?"skip (exists)":"install";console.log(o.gray(`  post-commit: ${g} \u2192 ${u}`));}else e.existsSync(u)&&!i.force?e.readFileSync(u,"utf8").includes("paradigm")?console.log(o.gray("post-commit hook already installed by paradigm")):console.log(o.yellow("post-commit hook exists. Use --force to overwrite.")):(e.mkdirSync(t,{recursive:true}),e.writeFileSync(u,H),e.chmodSync(u,"755"),f.push("post-commit"));}if(n||i.prePush){let u=r.join(t,"pre-push");if(c){let g=e.existsSync(u)&&!i.force?"skip (exists)":"install";console.log(o.gray(`  pre-push: ${g} \u2192 ${u}`));}else e.existsSync(u)&&!i.force?e.readFileSync(u,"utf8").includes("paradigm")?console.log(o.gray("pre-push hook already installed by paradigm")):console.log(o.yellow("pre-push hook exists. Use --force to overwrite.")):(e.mkdirSync(t,{recursive:true}),e.writeFileSync(u,j),e.chmodSync(u,"755"),f.push("pre-push"));}!c&&f.length>0&&console.log(o.green(`Git hooks installed: ${f.join(", ")}`));let _=r.join(h,".paradigm/history");!e.existsSync(_)&&!c&&console.log(o.gray("Tip: Run `paradigm history init` to initialize history tracking"));}let l=!i.postCommit&&!i.prePush&&!i.claudeCode&&!i.cursor;(l||i.claudeCode)&&(c?(console.log(o.gray("  Claude Code hooks: would install paradigm-stop.sh, paradigm-precommit.sh, paradigm-postwrite.sh")),console.log(o.gray(`  \u2192 ${r.join(h,".claude","hooks")}/`)),console.log(o.gray("  \u2192 Update .claude/settings.json with hook configuration"))):await B(h,i.force)),(l||i.cursor)&&(c?(console.log(o.gray("  Cursor hooks: would install paradigm-session-start.sh, paradigm-stop.sh, paradigm-precommit.sh, paradigm-postwrite.sh, paradigm-pretooluse.sh, paradigm-posttooluse.sh")),console.log(o.gray(`  \u2192 ${r.join(h,".cursor","hooks")}/`)),console.log(o.gray("  \u2192 Update .cursor/hooks.json"))):await K(h,i.force)),c&&console.log(o.cyan(`
+`))),!d&&!a){let s=r.join(h,".git");if(!e.existsSync(s)){console.log(o.red("Not a git repository."));return}let t=r.join(s,"hooks"),n=!i.postCommit&&!i.prePush&&!i.claudeCode,f=[];if(n||i.postCommit){let u=r.join(t,"post-commit");if(c){let g=e.existsSync(u)&&!i.force?"skip (exists)":"install";console.log(o.gray(`  post-commit: ${g} \u2192 ${u}`));}else e.existsSync(u)&&!i.force?e.readFileSync(u,"utf8").includes("paradigm")?console.log(o.gray("post-commit hook already installed by paradigm")):console.log(o.yellow("post-commit hook exists. Use --force to overwrite.")):(e.mkdirSync(t,{recursive:true}),e.writeFileSync(u,F),e.chmodSync(u,"755"),f.push("post-commit"));}if(n||i.prePush){let u=r.join(t,"pre-push");if(c){let g=e.existsSync(u)&&!i.force?"skip (exists)":"install";console.log(o.gray(`  pre-push: ${g} \u2192 ${u}`));}else e.existsSync(u)&&!i.force?e.readFileSync(u,"utf8").includes("paradigm")?console.log(o.gray("pre-push hook already installed by paradigm")):console.log(o.yellow("pre-push hook exists. Use --force to overwrite.")):(e.mkdirSync(t,{recursive:true}),e.writeFileSync(u,H),e.chmodSync(u,"755"),f.push("pre-push"));}!c&&f.length>0&&console.log(o.green(`Git hooks installed: ${f.join(", ")}`));let O=r.join(h,".paradigm/history");!e.existsSync(O)&&!c&&console.log(o.gray("Tip: Run `paradigm history init` to initialize history tracking"));}let l=!i.postCommit&&!i.prePush&&!i.claudeCode&&!i.cursor;(l||i.claudeCode)&&(c?(console.log(o.gray("  Claude Code hooks: would install paradigm-stop.sh, paradigm-precommit.sh, paradigm-postwrite.sh")),console.log(o.gray(`  \u2192 ${r.join(h,".claude","hooks")}/`)),console.log(o.gray("  \u2192 Update .claude/settings.json with hook configuration"))):await B(h,i.force)),(l||i.cursor)&&(c?(console.log(o.gray("  Cursor hooks: would install paradigm-session-start.sh, paradigm-stop.sh, paradigm-precommit.sh, paradigm-postwrite.sh, paradigm-pretooluse.sh, paradigm-posttooluse.sh")),console.log(o.gray(`  \u2192 ${r.join(h,".cursor","hooks")}/`)),console.log(o.gray("  \u2192 Update .cursor/hooks.json"))):await K(h,i.force)),c&&console.log(o.cyan(`
   [dry-run] No changes made.
-`));}async function B(i,h){let c=x();if(c.active){console.log(o.cyan(`  Paradigm plugin v${c.cacheVersion} is active \u2014 hooks are managed by the plugin.`));let{cleaned:O,removed:$}=J(i);console.log(O?o.green(`  Cleaned up stale project hooks: ${$.join(", ")}`):o.gray("  No stale project hooks to clean up.")),console.log(o.gray("  Plugin hooks auto-update with each session \u2014 no manual install needed."));return}let d=r.join(i,".claude","hooks");e.mkdirSync(d,{recursive:true});let a=[],p=r.join(d,"paradigm-common.sh");e.writeFileSync(p,y,"utf8"),e.chmodSync(p,"755");let l=[{name:"paradigm-stop.sh",content:R},{name:"paradigm-precommit.sh",content:A},{name:"paradigm-postwrite.sh",content:U}];for(let O of l){let $=r.join(d,O.name);if(e.existsSync($)&&!h){console.log(o.gray(`  ${O.name}: already installed`));continue}e.writeFileSync($,O.content,"utf8"),e.chmodSync($,"755"),a.push(O.name);}let s=r.join(i,".claude","settings.json"),t={};if(e.existsSync(s))try{t=JSON.parse(e.readFileSync(s,"utf8"));}catch{}let n=t.hooks||{},f={hooks:[{type:"command",command:'bash "$CLAUDE_PROJECT_DIR/.claude/hooks/paradigm-stop.sh"',timeout:10}]},_={matcher:"Bash",hooks:[{type:"command",command:'bash "$CLAUDE_PROJECT_DIR/.claude/hooks/paradigm-precommit.sh"',timeout:30}]},u=n.Stop||[];u.some(O=>JSON.stringify(O).includes("paradigm-stop.sh"))||u.push(f),n.Stop=u;let S=n.PreToolUse||[];S.some(O=>JSON.stringify(O).includes("paradigm-precommit.sh"))||S.push(_),n.PreToolUse=S;let F={matcher:"Edit,Write",hooks:[{type:"command",command:'bash "$CLAUDE_PROJECT_DIR/.claude/hooks/paradigm-postwrite.sh"',timeout:5}]},T=n.PostToolUse||[];T.some(O=>JSON.stringify(O).includes("paradigm-postwrite.sh"))||T.push(F),n.PostToolUse=T,t.hooks=n,e.writeFileSync(s,JSON.stringify(t,null,2)+`
-`,"utf8"),a.length>0&&console.log(o.green(`Claude Code hooks installed: ${a.join(", ")}`)),console.log(o.green("Claude Code settings.json updated with hook configuration"));}async function K(i,h){let c=r.join(i,".cursor","hooks");e.mkdirSync(c,{recursive:true});let d=[],a=r.join(c,"paradigm-common.sh");e.writeFileSync(a,y,"utf8"),e.chmodSync(a,"755");let p=[{name:"paradigm-session-start.sh",content:P},{name:"paradigm-stop.sh",content:v},{name:"paradigm-precommit.sh",content:b},{name:"paradigm-postwrite.sh",content:D},{name:"paradigm-pretooluse.sh",content:L},{name:"paradigm-posttooluse.sh",content:w}];for(let m of p){let k=r.join(c,m.name);if(e.existsSync(k)&&!h){console.log(o.gray(`  ${m.name}: already installed (Cursor)`));continue}e.writeFileSync(k,m.content,"utf8"),e.chmodSync(k,"755"),d.push(m.name);}let l=r.join(i,".cursor","hooks.json"),s={};if(e.existsSync(l))try{s=JSON.parse(e.readFileSync(l,"utf8"));}catch{}s.version=1;let t=s.hooks||{},n={command:".cursor/hooks/paradigm-session-start.sh",timeout:5},f={command:".cursor/hooks/paradigm-stop.sh",timeout:10,loop_limit:3},_={command:".cursor/hooks/paradigm-postwrite.sh",timeout:5},u={command:".cursor/hooks/paradigm-precommit.sh",matcher:"git commit",timeout:30},g=t.sessionStart||[];g.some(m=>JSON.stringify(m).includes("paradigm-session-start.sh"))||g.push(n),t.sessionStart=g;let I=t.stop||[];I.some(m=>JSON.stringify(m).includes("paradigm-stop.sh"))||I.push(f),t.stop=I;let T=t.afterFileEdit||[];T.some(m=>JSON.stringify(m).includes("paradigm-postwrite.sh"))||T.push(_),t.afterFileEdit=T;let O={command:".cursor/hooks/paradigm-pretooluse.sh",matcher:"Edit|Write",timeout:5},$=t.preToolUse||[];$.some(m=>JSON.stringify(m).includes("paradigm-pretooluse.sh"))||$.push(O),t.preToolUse=$;let V={command:".cursor/hooks/paradigm-posttooluse.sh",matcher:"Edit|Write",timeout:5},C=t.postToolUse||[];C.some(m=>JSON.stringify(m).includes("paradigm-posttooluse.sh"))||C.push(V),t.postToolUse=C;let N=t.beforeShellExecution||[];N.some(m=>JSON.stringify(m).includes("paradigm-precommit.sh"))||N.push(u),t.beforeShellExecution=N,s.hooks=t,e.writeFileSync(l,JSON.stringify(s,null,2)+`
+`));}async function B(i,h){let c=x();if(c.active){console.log(o.cyan(`  Paradigm plugin v${c.cacheVersion} is active \u2014 hooks are managed by the plugin.`));let{cleaned:_,removed:$}=q(i);console.log(_?o.green(`  Cleaned up stale project hooks: ${$.join(", ")}`):o.gray("  No stale project hooks to clean up.")),console.log(o.gray("  Plugin hooks auto-update with each session \u2014 no manual install needed."));return}let d=r.join(i,".claude","hooks");e.mkdirSync(d,{recursive:true});let a=[],p=r.join(d,"paradigm-common.sh");e.writeFileSync(p,C,"utf8"),e.chmodSync(p,"755");let l=[{name:"paradigm-stop.sh",content:R},{name:"paradigm-precommit.sh",content:U},{name:"paradigm-postwrite.sh",content:A}];for(let _ of l){let $=r.join(d,_.name);if(e.existsSync($)&&!h){console.log(o.gray(`  ${_.name}: already installed`));continue}e.writeFileSync($,_.content,"utf8"),e.chmodSync($,"755"),a.push(_.name);}let s=r.join(i,".claude","settings.json"),t={};if(e.existsSync(s))try{t=JSON.parse(e.readFileSync(s,"utf8"));}catch{}let n=t.hooks||{},f={hooks:[{type:"command",command:'bash "$CLAUDE_PROJECT_DIR/.claude/hooks/paradigm-stop.sh"',timeout:10}]},O={matcher:"Bash",hooks:[{type:"command",command:'bash "$CLAUDE_PROJECT_DIR/.claude/hooks/paradigm-precommit.sh"',timeout:30}]},u=n.Stop||[];u.some(_=>JSON.stringify(_).includes("paradigm-stop.sh"))||u.push(f),n.Stop=u;let T=n.PreToolUse||[];T.some(_=>JSON.stringify(_).includes("paradigm-precommit.sh"))||T.push(O),n.PreToolUse=T;let V={matcher:"Edit,Write",hooks:[{type:"command",command:'bash "$CLAUDE_PROJECT_DIR/.claude/hooks/paradigm-postwrite.sh"',timeout:5}]},S=n.PostToolUse||[];S.some(_=>JSON.stringify(_).includes("paradigm-postwrite.sh"))||S.push(V),n.PostToolUse=S,t.hooks=n,e.writeFileSync(s,JSON.stringify(t,null,2)+`
+`,"utf8"),a.length>0&&console.log(o.green(`Claude Code hooks installed: ${a.join(", ")}`)),console.log(o.green("Claude Code settings.json updated with hook configuration"));}async function K(i,h){let c=r.join(i,".cursor","hooks");e.mkdirSync(c,{recursive:true});let d=[],a=r.join(c,"paradigm-common.sh");e.writeFileSync(a,C,"utf8"),e.chmodSync(a,"755");let p=[{name:"paradigm-session-start.sh",content:D},{name:"paradigm-stop.sh",content:v},{name:"paradigm-precommit.sh",content:b},{name:"paradigm-postwrite.sh",content:P},{name:"paradigm-pretooluse.sh",content:L},{name:"paradigm-posttooluse.sh",content:w}];for(let m of p){let N=r.join(c,m.name);if(e.existsSync(N)&&!h){console.log(o.gray(`  ${m.name}: already installed (Cursor)`));continue}e.writeFileSync(N,m.content,"utf8"),e.chmodSync(N,"755"),d.push(m.name);}let l=r.join(i,".cursor","hooks.json"),s={};if(e.existsSync(l))try{s=JSON.parse(e.readFileSync(l,"utf8"));}catch{}s.version=1;let t=s.hooks||{},n={command:".cursor/hooks/paradigm-session-start.sh",timeout:5},f={command:".cursor/hooks/paradigm-stop.sh",timeout:10,loop_limit:3},O={command:".cursor/hooks/paradigm-postwrite.sh",timeout:5},u={command:".cursor/hooks/paradigm-precommit.sh",matcher:"git commit",timeout:30},g=t.sessionStart||[];g.some(m=>JSON.stringify(m).includes("paradigm-session-start.sh"))||g.push(n),t.sessionStart=g;let I=t.stop||[];I.some(m=>JSON.stringify(m).includes("paradigm-stop.sh"))||I.push(f),t.stop=I;let S=t.afterFileEdit||[];S.some(m=>JSON.stringify(m).includes("paradigm-postwrite.sh"))||S.push(O),t.afterFileEdit=S;let _={command:".cursor/hooks/paradigm-pretooluse.sh",matcher:"Edit|Write",timeout:5},$=t.preToolUse||[];$.some(m=>JSON.stringify(m).includes("paradigm-pretooluse.sh"))||$.push(_),t.preToolUse=$;let j={command:".cursor/hooks/paradigm-posttooluse.sh",matcher:"Edit|Write",timeout:5},y=t.postToolUse||[];y.some(m=>JSON.stringify(m).includes("paradigm-posttooluse.sh"))||y.push(j),t.postToolUse=y;let k=t.beforeShellExecution||[];k.some(m=>JSON.stringify(m).includes("paradigm-precommit.sh"))||k.push(u),t.beforeShellExecution=k,s.hooks=t,e.writeFileSync(l,JSON.stringify(s,null,2)+`
 `,"utf8"),d.length>0&&console.log(o.green(`Cursor hooks installed: ${d.join(", ")}`)),console.log(o.green("Cursor hooks.json updated with hook configuration"));}async function re(i={}){let h=process.cwd(),c=i.dryRun||false;if(c&&console.log(o.cyan(`
   [dry-run] Showing what would be removed:
 `)),!i.cursor){let d=r.join(h,".git");if(!e.existsSync(d)){console.log(o.red("Not a git repository."));return}let a=r.join(d,"hooks"),p=[];for(let l of ["post-commit","pre-push"]){let s=r.join(a,l);e.existsSync(s)&&e.readFileSync(s,"utf8").includes("paradigm")&&(c?console.log(o.gray(`  Would remove: ${s}`)):e.unlinkSync(s),p.push(l));}c?p.length===0&&console.log(o.gray("  No paradigm git hooks to remove")):p.length>0?console.log(o.green(`Git hooks removed: ${p.join(", ")}`)):console.log(o.gray("No paradigm git hooks found to remove"));}if(i.cursor){let d=r.join(h,".cursor","hooks"),a=[];for(let l of ["paradigm-session-start.sh","paradigm-stop.sh","paradigm-precommit.sh","paradigm-postwrite.sh","paradigm-pretooluse.sh","paradigm-posttooluse.sh"]){let s=r.join(d,l);e.existsSync(s)&&(c?console.log(o.gray(`  Would remove: ${s}`)):e.unlinkSync(s),a.push(l));}let p=r.join(h,".cursor","hooks.json");if(e.existsSync(p))if(c)console.log(o.gray(`  Would clean paradigm entries from: ${p}`));else try{let l=JSON.parse(e.readFileSync(p,"utf8")),s=l.hooks||{};for(let t of ["sessionStart","stop","afterFileEdit","beforeShellExecution","preToolUse","postToolUse"])Array.isArray(s[t])&&(s[t]=s[t].filter(n=>!JSON.stringify(n).includes("paradigm-")),s[t].length===0&&delete s[t]);l.hooks=s,e.writeFileSync(p,JSON.stringify(l,null,2)+`
@@ -1457,10 +1579,10 @@ fi
   [dry-run] No changes made.
 `));}async function ae(){let i=process.cwd(),h=r.join(i,".git");if(e.existsSync(h)){console.log(o.magenta(`
   Git Hooks Status
-`));let l=r.join(h,"hooks"),s=["post-commit","pre-push"];for(let n of s){let f=r.join(l,n);e.existsSync(f)?e.readFileSync(f,"utf8").includes("paradigm")?console.log(o.green(`  ${n}: installed (paradigm)`)):console.log(o.yellow(`  ${n}: exists (other)`)):console.log(o.gray(`  ${n}: not installed`));}console.log();let t=r.join(i,".paradigm/history");if(e.existsSync(t)){let n=r.join(t,"log.jsonl");if(e.existsSync(n)){let _=e.readFileSync(n,"utf8").split(`
-`).filter(u=>u.trim()).length;console.log(o.white(`  History entries: ${_}`));}}else console.log(o.gray("  History: not initialized")),console.log(o.gray("  Run `paradigm history init` to enable"));}else console.log(o.gray(`
+`));let l=r.join(h,"hooks"),s=["post-commit","pre-push"];for(let n of s){let f=r.join(l,n);e.existsSync(f)?e.readFileSync(f,"utf8").includes("paradigm")?console.log(o.green(`  ${n}: installed (paradigm)`)):console.log(o.yellow(`  ${n}: exists (other)`)):console.log(o.gray(`  ${n}: not installed`));}console.log();let t=r.join(i,".paradigm/history");if(e.existsSync(t)){let n=r.join(t,"log.jsonl");if(e.existsSync(n)){let O=e.readFileSync(n,"utf8").split(`
+`).filter(u=>u.trim()).length;console.log(o.white(`  History entries: ${O}`));}}else console.log(o.gray("  History: not initialized")),console.log(o.gray("  Run `paradigm history init` to enable"));}else console.log(o.gray(`
   Not a git repository (git hooks N/A)
 `));console.log(o.magenta(`  Claude Code Hooks Status
-`));let c=x();if(c.active){console.log(o.cyan(`  Plugin: paradigm v${c.cacheVersion} (active)`)),console.log(o.green("  Hooks are managed by the plugin \u2014 auto-updates with each session."));let l=r.join(i,".claude","hooks"),s=[];for(let f of ["paradigm-common.sh","paradigm-stop.sh","paradigm-precommit.sh","paradigm-postwrite.sh"])e.existsSync(r.join(l,f))&&s.push(f);let t=r.join(i,".claude","settings.json"),n=false;if(e.existsSync(t))try{let f=JSON.parse(e.readFileSync(t,"utf8"));n=JSON.stringify(f.hooks||{}).includes("paradigm-");}catch{}(s.length>0||n)&&(console.log(o.yellow(`  WARNING: Stale project hooks detected (${s.join(", ")}${n?", settings.json entries":""})`)),console.log(o.yellow("  These shadow the plugin hooks and may run outdated logic.")),console.log(o.gray("  Run `paradigm hooks install --claude-code` to clean them up.")));}else {console.log(o.gray("  Plugin: not active (using project-level hooks)"));let l=r.join(i,".claude","hooks"),s=["paradigm-stop.sh","paradigm-precommit.sh","paradigm-postwrite.sh"];for(let n of s){let f=r.join(l,n);e.existsSync(f)?console.log(o.green(`  ${n}: installed`)):console.log(o.gray(`  ${n}: not installed`));}let t=r.join(i,".claude","settings.json");if(e.existsSync(t))try{let f=JSON.parse(e.readFileSync(t,"utf8")).hooks||{},_=JSON.stringify(f.Stop||[]).includes("paradigm-stop.sh"),u=JSON.stringify(f.PreToolUse||[]).includes("paradigm-precommit.sh"),g=JSON.stringify(f.PostToolUse||[]).includes("paradigm-postwrite.sh");console.log(o.gray(`  settings.json Stop hook: ${_?"configured":"missing"}`)),console.log(o.gray(`  settings.json PreToolUse hook: ${u?"configured":"missing"}`)),console.log(o.gray(`  settings.json PostToolUse hook: ${g?"configured":"missing"}`));}catch{console.log(o.yellow("  settings.json: parse error"));}else console.log(o.gray("  settings.json: not found"));}console.log(o.magenta(`
+`));let c=x();if(c.active){console.log(o.cyan(`  Plugin: paradigm v${c.cacheVersion} (active)`)),console.log(o.green("  Hooks are managed by the plugin \u2014 auto-updates with each session."));let l=r.join(i,".claude","hooks"),s=[];for(let f of ["paradigm-common.sh","paradigm-stop.sh","paradigm-precommit.sh","paradigm-postwrite.sh"])e.existsSync(r.join(l,f))&&s.push(f);let t=r.join(i,".claude","settings.json"),n=false;if(e.existsSync(t))try{let f=JSON.parse(e.readFileSync(t,"utf8"));n=JSON.stringify(f.hooks||{}).includes("paradigm-");}catch{}(s.length>0||n)&&(console.log(o.yellow(`  WARNING: Stale project hooks detected (${s.join(", ")}${n?", settings.json entries":""})`)),console.log(o.yellow("  These shadow the plugin hooks and may run outdated logic.")),console.log(o.gray("  Run `paradigm hooks install --claude-code` to clean them up.")));}else {console.log(o.gray("  Plugin: not active (using project-level hooks)"));let l=r.join(i,".claude","hooks"),s=["paradigm-stop.sh","paradigm-precommit.sh","paradigm-postwrite.sh"];for(let n of s){let f=r.join(l,n);e.existsSync(f)?console.log(o.green(`  ${n}: installed`)):console.log(o.gray(`  ${n}: not installed`));}let t=r.join(i,".claude","settings.json");if(e.existsSync(t))try{let f=JSON.parse(e.readFileSync(t,"utf8")).hooks||{},O=JSON.stringify(f.Stop||[]).includes("paradigm-stop.sh"),u=JSON.stringify(f.PreToolUse||[]).includes("paradigm-precommit.sh"),g=JSON.stringify(f.PostToolUse||[]).includes("paradigm-postwrite.sh");console.log(o.gray(`  settings.json Stop hook: ${O?"configured":"missing"}`)),console.log(o.gray(`  settings.json PreToolUse hook: ${u?"configured":"missing"}`)),console.log(o.gray(`  settings.json PostToolUse hook: ${g?"configured":"missing"}`));}catch{console.log(o.yellow("  settings.json: parse error"));}else console.log(o.gray("  settings.json: not found"));}console.log(o.magenta(`
   Cursor Hooks Status
-`));let d=r.join(i,".cursor","hooks"),a=["paradigm-session-start.sh","paradigm-stop.sh","paradigm-precommit.sh","paradigm-postwrite.sh","paradigm-pretooluse.sh","paradigm-posttooluse.sh"];for(let l of a){let s=r.join(d,l);e.existsSync(s)?console.log(o.green(`  ${l}: installed`)):console.log(o.gray(`  ${l}: not installed`));}let p=r.join(i,".cursor","hooks.json");if(e.existsSync(p))try{let s=JSON.parse(e.readFileSync(p,"utf8")).hooks||{},t=JSON.stringify(s.sessionStart||[]).includes("paradigm-session-start.sh"),n=JSON.stringify(s.stop||[]).includes("paradigm-stop.sh"),f=JSON.stringify(s.afterFileEdit||[]).includes("paradigm-postwrite.sh"),_=JSON.stringify(s.beforeShellExecution||[]).includes("paradigm-precommit.sh"),u=JSON.stringify(s.preToolUse||[]).includes("paradigm-pretooluse.sh"),g=JSON.stringify(s.postToolUse||[]).includes("paradigm-posttooluse.sh");console.log(o.gray(`  hooks.json sessionStart: ${t?"configured":"missing"}`)),console.log(o.gray(`  hooks.json stop: ${n?"configured":"missing"}`)),console.log(o.gray(`  hooks.json afterFileEdit: ${f?"configured":"missing"}`)),console.log(o.gray(`  hooks.json preToolUse: ${u?"configured":"missing"}`)),console.log(o.gray(`  hooks.json postToolUse: ${g?"configured":"missing"}`)),console.log(o.gray(`  hooks.json beforeShellExecution: ${_?"configured":"missing"}`));}catch{console.log(o.yellow("  hooks.json: parse error"));}else console.log(o.gray("  hooks.json: not found"));console.log();}export{te as a,re as b,ae as c};
+`));let d=r.join(i,".cursor","hooks"),a=["paradigm-session-start.sh","paradigm-stop.sh","paradigm-precommit.sh","paradigm-postwrite.sh","paradigm-pretooluse.sh","paradigm-posttooluse.sh"];for(let l of a){let s=r.join(d,l);e.existsSync(s)?console.log(o.green(`  ${l}: installed`)):console.log(o.gray(`  ${l}: not installed`));}let p=r.join(i,".cursor","hooks.json");if(e.existsSync(p))try{let s=JSON.parse(e.readFileSync(p,"utf8")).hooks||{},t=JSON.stringify(s.sessionStart||[]).includes("paradigm-session-start.sh"),n=JSON.stringify(s.stop||[]).includes("paradigm-stop.sh"),f=JSON.stringify(s.afterFileEdit||[]).includes("paradigm-postwrite.sh"),O=JSON.stringify(s.beforeShellExecution||[]).includes("paradigm-precommit.sh"),u=JSON.stringify(s.preToolUse||[]).includes("paradigm-pretooluse.sh"),g=JSON.stringify(s.postToolUse||[]).includes("paradigm-posttooluse.sh");console.log(o.gray(`  hooks.json sessionStart: ${t?"configured":"missing"}`)),console.log(o.gray(`  hooks.json stop: ${n?"configured":"missing"}`)),console.log(o.gray(`  hooks.json afterFileEdit: ${f?"configured":"missing"}`)),console.log(o.gray(`  hooks.json preToolUse: ${u?"configured":"missing"}`)),console.log(o.gray(`  hooks.json postToolUse: ${g?"configured":"missing"}`)),console.log(o.gray(`  hooks.json beforeShellExecution: ${O?"configured":"missing"}`));}catch{console.log(o.yellow("  hooks.json: parse error"));}else console.log(o.gray("  hooks.json: not found"));console.log();}export{te as a,re as b,ae as c};