@boyingliu01/xp-gate 0.12.10 → 0.12.13

package/hooks/pre-push

@@ -47,10 +47,13 @@ report = {
     {'id': '10', 'name': 'Build Integrity', 'status': '${GATE_10_STATUS:-SKIP}', 'details': {}},
     {'id': 'M', 'name': 'Mutation Testing', 'status': '${GATE_M_STATUS:-SKIP}', 'details': {}},
     {'id': 'M-Python', 'name': 'Mutation Testing (Python)', 'status': '${GATE_M_PYTHON_STATUS:-SKIP}', 'details': {}},
-    {'id': 'M2', 'name': 'Mock Density', 'status': '${GATE_M2_STATUS:-SKIP}', 'details': {}},
-    {'id': 'M3', 'name': 'Mock Layering', 'status': '${GATE_M3_STATUS:-SKIP}', 'details': {}},
+    {'id': 'M-Go', 'name': 'Mutation Testing (Go)', 'status': '${GATE_M_GO_STATUS:-SKIP}', 'details': {}},
+    {'id': 'M-Java', 'name': 'Mutation Testing (Java)', 'status': '${GATE_M_JAVA_STATUS:-SKIP}', 'details': {}},
+    {'id': 'M-Kotlin', 'name': 'Mutation Testing (Kotlin)', 'status': '${GATE_M_KOTLIN_STATUS:-SKIP}', 'details': {}},
+    {'id': 'MD', 'name': 'Mock Density', 'status': '${GATE_M2_STATUS:-SKIP}', 'details': {}},
+    {'id': 'ML', 'name': 'Mock Layering', 'status': '${GATE_M3_STATUS:-SKIP}', 'details': {}},
     {'id': 'UI', 'name': 'UI Sprint Gates', 'status': '${GATE_UI_STATUS:-SKIP}', 'details': {}},
-    {'id': 'Delphi', 'name': 'Code Walkthrough', 'status': '${GATE_DELPHI_STATUS:-SKIP}', 'details': {'remote': '$REMOTE', 'url': '$URL'}}
+    {'id': 'MW', 'name': 'Code Walkthrough', 'status': '${GATE_DELPHI_STATUS:-SKIP}', 'details': {'remote': '$REMOTE', 'url': '$URL'}}
   ],
   'warnings': [],
   'errors': [] if '$verdict' == 'PASS' else ['pre-push hook exited with code $exit_code'],
@@ -161,11 +164,11 @@ fi
 if [ -n "$SPRINT_GATE_SCRIPT" ]; then
   if ! bash "$SPRINT_GATE_SCRIPT" --pre-push; then
     GATE_S_STATUS="BLOCK"
-    echo "❌ BLOCKED - Gate S: Sprint Flow Enforcement"
+    echo "❌ BLOCKED - Gate MS: Sprint Flow Enforcement"
     exit 1
   fi
 else
-  echo "⏭️  SKIPPED - Gate S: Sprint Flow (sprint-gate.sh not found)"
+  echo "⏭️  SKIPPED - Gate MS: Sprint Flow (sprint-gate.sh not found)"
   GATE_S_STATUS="SKIP"
 fi
 echo ""
@@ -390,13 +393,223 @@ else
 fi
 
 # ============================================================================
-# GATE M2: MOCK DENSITY CHECK (BLOCK at 30%, configurable via .mockpolicyrc)
+# GATE M (Go): Incremental Mutation Testing via gomutants
+# Uses the same gate-m.ts orchestrator with GoMutantsRunner.
+# ============================================================================
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "   GATE M (Go): MUTATION TESTING"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# Collect changed Go source files (exclude tests, vendor)
+GO_FILES=$(echo "$PUSHED_FILES" | grep -E '\.go$' | grep -v '_test\.go$' | grep -v '/vendor/' || true)
+
+if [ -z "$GO_FILES" ]; then
+  echo "📚 No changed Go source files. SKIP — Gate M (Go)."
+else
+  GO_FILE_LIST=$(echo "$GO_FILES" | tr '\n' ',' | sed 's/,$//')
+  echo "🔵 Changed Go files: $GO_FILE_LIST"
+
+  if detect_go_mutation_testable 2>/dev/null; then
+    MUTATION_SCRIPT=""
+    if [ -f ".xp-gate/modules/mutation/gate-m.ts" ]; then
+      MUTATION_SCRIPT=".xp-gate/modules/mutation/gate-m.ts"
+    elif [ -f "src/mutation/gate-m.ts" ]; then
+      MUTATION_SCRIPT="src/mutation/gate-m.ts"
+    elif [ -f "$HOME/.config/xp-gate/modules/mutation/gate-m.ts" ]; then
+      MUTATION_SCRIPT="$HOME/.config/xp-gate/modules/mutation/gate-m.ts"
+    fi
+
+    if [ -z "$MUTATION_SCRIPT" ]; then
+      echo "⚠ Gate M script not found. SKIP — Gate M (Go)."
+    else
+      MUTATION_OUTPUT=$(mktemp)
+      timeout 120s npx tsx "$MUTATION_SCRIPT" --changed-files "$GO_FILE_LIST" --timeout-ms 120000 > "$MUTATION_OUTPUT" 2>&1
+      MUTATION_EXIT=$?
+
+      case $MUTATION_EXIT in
+        0)
+          echo "✅ Gate M (Go): PASS"
+          GATE_M_GO_STATUS="PASS"
+          ;;
+        1)
+          echo ""
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          echo "   ❌ GATE M (Go) FAILED - PUSH BLOCKED"
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          echo ""
+          cat "$MUTATION_OUTPUT"
+          echo ""
+          rm -f "$MUTATION_OUTPUT"
+          exit 1
+          ;;
+        124)
+          cat "$MUTATION_OUTPUT"
+          echo "⏱ Gate M (Go): TIMEOUT (120s). Allowing push with warning."
+          GATE_M_GO_STATUS="TIMEOUT"
+          ;;
+        *)
+          cat "$MUTATION_OUTPUT"
+          echo "⚠ Gate M (Go): Unexpected exit code $MUTATION_EXIT. Allowing push with warning."
+          GATE_M_GO_STATUS="WARN"
+          ;;
+      esac
+
+      rm -f "$MUTATION_OUTPUT"
+    fi
+  else
+    echo "⚠ gomutants not installed. SKIP — Gate M (Go)."
+  fi
+fi
+
+# ============================================================================
+# GATE M (Java): Incremental Mutation Testing via PITest
+# Uses the same gate-m.ts orchestrator with PitestRunner.
+# ============================================================================
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "   GATE M (Java): MUTATION TESTING"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# Collect changed Java source files (exclude tests)
+JAVA_FILES=$(echo "$PUSHED_FILES" | grep -E '\.java$' | grep -v -E '(Test|Tests)\.java$' || true)
+
+if [ -z "$JAVA_FILES" ]; then
+  echo "📚 No changed Java source files. SKIP — Gate M (Java)."
+else
+  JAVA_FILE_LIST=$(echo "$JAVA_FILES" | tr '\n' ',' | sed 's/,$//')
+  echo "☕ Changed Java files: $JAVA_FILE_LIST"
+
+  if detect_pitest_testable 2>/dev/null; then
+    MUTATION_SCRIPT=""
+    if [ -f ".xp-gate/modules/mutation/gate-m.ts" ]; then
+      MUTATION_SCRIPT=".xp-gate/modules/mutation/gate-m.ts"
+    elif [ -f "src/mutation/gate-m.ts" ]; then
+      MUTATION_SCRIPT="src/mutation/gate-m.ts"
+    elif [ -f "$HOME/.config/xp-gate/modules/mutation/gate-m.ts" ]; then
+      MUTATION_SCRIPT="$HOME/.config/xp-gate/modules/mutation/gate-m.ts"
+    fi
+
+    if [ -z "$MUTATION_SCRIPT" ]; then
+      echo "⚠ Gate M script not found. SKIP — Gate M (Java)."
+    else
+      MUTATION_OUTPUT=$(mktemp)
+      timeout 600s npx tsx "$MUTATION_SCRIPT" --changed-files "$JAVA_FILE_LIST" --timeout-ms 600000 > "$MUTATION_OUTPUT" 2>&1
+      MUTATION_EXIT=$?
+
+      case $MUTATION_EXIT in
+        0)
+          echo "✅ Gate M (Java): PASS"
+          GATE_M_JAVA_STATUS="PASS"
+          ;;
+        1)
+          echo ""
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          echo "   ❌ GATE M (Java) FAILED - PUSH BLOCKED"
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          echo ""
+          cat "$MUTATION_OUTPUT"
+          echo ""
+          rm -f "$MUTATION_OUTPUT"
+          exit 1
+          ;;
+        124)
+          cat "$MUTATION_OUTPUT"
+          echo "⏱ Gate M (Java): TIMEOUT (600s). Allowing push with warning."
+          GATE_M_JAVA_STATUS="TIMEOUT"
+          ;;
+        *)
+          cat "$MUTATION_OUTPUT"
+          echo "⚠ Gate M (Java): Unexpected exit code $MUTATION_EXIT. Allowing push with warning."
+          GATE_M_JAVA_STATUS="WARN"
+          ;;
+      esac
+
+      rm -f "$MUTATION_OUTPUT"
+    fi
+  else
+    echo "⚠ PITest not configured. SKIP — Gate M (Java)."
+  fi
+fi
+
+# ============================================================================
+# GATE M (Kotlin): Incremental Mutation Testing via PITest
+# Uses the same gate-m.ts orchestrator with PitestRunner for Kotlin files.
+# ============================================================================
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "   GATE M (Kotlin): MUTATION TESTING"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# Collect changed Kotlin source files (exclude tests)
+KT_FILES=$(echo "$PUSHED_FILES" | grep -E '\.kt$|\.kts$' | grep -v -E '(Test|Tests|Spec)\.kt$' || true)
+
+if [ -z "$KT_FILES" ]; then
+  echo "📚 No changed Kotlin source files. SKIP — Gate M (Kotlin)."
+else
+  KT_FILE_LIST=$(echo "$KT_FILES" | tr '\n' ',' | sed 's/,$//')
+  echo "🟣 Changed Kotlin files: $KT_FILE_LIST"
+
+  if detect_pitest_testable 2>/dev/null; then
+    MUTATION_SCRIPT=""
+    if [ -f ".xp-gate/modules/mutation/gate-m.ts" ]; then
+      MUTATION_SCRIPT=".xp-gate/modules/mutation/gate-m.ts"
+    elif [ -f "src/mutation/gate-m.ts" ]; then
+      MUTATION_SCRIPT="src/mutation/gate-m.ts"
+    elif [ -f "$HOME/.config/xp-gate/modules/mutation/gate-m.ts" ]; then
+      MUTATION_SCRIPT="$HOME/.config/xp-gate/modules/mutation/gate-m.ts"
+    fi
+
+    if [ -z "$MUTATION_SCRIPT" ]; then
+      echo "⚠ Gate M script not found. SKIP — Gate M (Kotlin)."
+    else
+      MUTATION_OUTPUT=$(mktemp)
+      timeout 600s npx tsx "$MUTATION_SCRIPT" --changed-files "$KT_FILE_LIST" --timeout-ms 600000 > "$MUTATION_OUTPUT" 2>&1
+      MUTATION_EXIT=$?
+
+      case $MUTATION_EXIT in
+        0)
+          echo "✅ Gate M (Kotlin): PASS"
+          GATE_M_KOTLIN_STATUS="PASS"
+          ;;
+        1)
+          echo ""
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          echo "   ❌ GATE M (Kotlin) FAILED - PUSH BLOCKED"
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          echo ""
+          cat "$MUTATION_OUTPUT"
+          echo ""
+          rm -f "$MUTATION_OUTPUT"
+          exit 1
+          ;;
+        124)
+          cat "$MUTATION_OUTPUT"
+          echo "⏱ Gate M (Kotlin): TIMEOUT (600s). Allowing push with warning."
+          GATE_M_KOTLIN_STATUS="TIMEOUT"
+          ;;
+        *)
+          cat "$MUTATION_OUTPUT"
+          echo "⚠ Gate M (Kotlin): Unexpected exit code $MUTATION_EXIT. Allowing push with warning."
+          GATE_M_KOTLIN_STATUS="WARN"
+          ;;
+      esac
+
+      rm -f "$MUTATION_OUTPUT"
+    fi
+  else
+    echo "⚠ PITest not configured. SKIP — Gate M (Kotlin)."
+  fi
+fi
+
+# ============================================================================
+# GATE MD: MOCK DENSITY CHECK (BLOCK at 30%, configurable via .mockpolicyrc)
 # Phase 1: WARNING mode (collect false positive data before enabling BLOCK)
 # Per-layer thresholds: .mockpolicyrc layers.*.maxMockDensity
 # ============================================================================
 echo ""
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "   GATE M2: MOCK DENSITY CHECK"
+echo "   GATE MD: MOCK DENSITY CHECK"
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
 # Collect TS and Python test files from pushed files
@@ -486,7 +699,7 @@ else
 fi
 
 # ============================================================================
-# Gate M3: Mock Layering Strategy
+# Gate ML: Mock Layering Strategy
 # Validates mock policies based on test layer and dependency scope
 # Runs only in non-main branches, TypeScript projects with the module available
 # ============================================================================
@@ -496,7 +709,7 @@ run_gate_m3() {
 
   echo ""
   echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-  echo "   GATE M3: MOCK LAYERING STRATEGY"
+  echo "   GATE ML: MOCK LAYERING STRATEGY"
   echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
   # Skip on main/master
@@ -540,14 +753,14 @@ run_gate_m3() {
   done <<< "$test_files"
 
   if npx tsx "$GATE_M3_SCRIPT" "${args[@]}"; then
-    echo "✅ Gate M3: PASS"
+    echo "✅ Gate ML: PASS"
     return 0
   else
     local exit_code=$?
     if [[ "$exit_code" -eq 1 ]]; then
       echo ""
       echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-      echo "   ❌ GATE M3 FAILED - PUSH BLOCKED"
+      echo "   ❌ GATE ML FAILED - PUSH BLOCKED"
       echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
       echo ""
       echo "Mock layering violations found. Review and fix or adjust"
@@ -555,7 +768,7 @@ run_gate_m3() {
       echo ""
       return 1
     fi
-    echo "⚠️ Gate M3: Unexpected error — allowing push with warning"
+    echo "⚠️ Gate ML: Unexpected error — allowing push with warning"
     return 0
   fi
 }
@@ -638,19 +851,19 @@ else
 fi
 
 # ============================================================================
-# VALIDATE CODE WALKTHROUGH RESULT FILE
+# GATE MW: VALIDATE CODE WALKTHROUGH RESULT FILE
 # ============================================================================
 RESULT_FILE=".code-walkthrough-result.json"
 
-# Skip Delphi walkthrough for main/master (Gate M already ran above)
+# Skip MW walkthrough for main/master (Gate M already ran above)
 if [[ "$CURRENT_BRANCH" == "main" || "$CURRENT_BRANCH" == "master" ]]; then
-  echo "⚠️ Pushing to main/master - Delphi walkthrough skipped"
+  echo "⚠️ Pushing to main/master - MW walkthrough skipped"
 else
 
 if [ ! -f "$RESULT_FILE" ]; then
   echo ""
   echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-  echo "   ❌ CODE WALKTHROUGH REQUIRED - PUSH BLOCKED"
+  echo "   ❌ GATE MW: CODE WALKTHROUGH REQUIRED - PUSH BLOCKED"
   echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
   echo ""
   echo "No code walkthrough result found."
@@ -745,7 +958,7 @@ fi
 if [ "$RESULT_VERDICT" != "APPROVED" ]; then
   echo ""
   echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-  echo "   ❌ CODE WALKTHROUGH NOT APPROVED - PUSH BLOCKED"
+  echo "   ❌ GATE MW: CODE WALKTHROUGH NOT APPROVED - PUSH BLOCKED"
   echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
   echo ""
   echo "Verdict: $RESULT_VERDICT"
@@ -785,7 +998,7 @@ fi
 # ============================================================================
 echo ""
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "   ✅ CODE WALKTHROUGH VERIFIED"
+  echo "   ✅ GATE MW: CODE WALKTHROUGH VERIFIED"
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo ""
 echo "Branch: $CURRENT_BRANCH"

package/lib/__tests__/sprint-discovery.test.ts

@@ -13,7 +13,8 @@ import os from 'os';
 
 // Types mirroring DiscoveredSprint interface
 interface DiscoveredSprint {
-  state: Record<string, unknown>;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  state: any;
   sourcePath: string;
   worktreeExists: boolean;
 }
@@ -285,8 +286,8 @@ describe('sprint-discovery: discoverActiveSprints', () => {
     });
     const results = sprintDiscovery.discoverActiveSprints(TMP_ROOT);
     const duplicates = results.filter(r => r.state.id === 'sprint-2026-06-23-01');
-    expect(duplicates.length).toBe(1, 'Should deduplicate to exactly 1 entry');
-    expect(duplicates[0].worktreeExists).toBe(true, 'Should prefer worktree version');
+    expect(duplicates.length).toBe(1);
+    expect(duplicates[0].worktreeExists).toBe(true);
   });
 
   test('tie-breaker: latest started_at wins when same sprint.id in two worktrees', () => {
@@ -324,7 +325,7 @@ describe('sprint-discovery: discoverActiveSprints', () => {
     // Should not throw, result should be skipped (no valid id)
     const results = sprintDiscovery.discoverActiveSprints(TMP_ROOT);
     const partials = results.filter(r => r.state.task_description === 'Partial fields only');
-    expect(partials.length).toBe(0, 'Sprint without id should be skipped');
+    expect(partials.length).toBe(0);
   });
 
   test('handles EACCES on .sprint-state/ directory gracefully', () => {

package/lib/__tests__/sprint-status.test.ts

@@ -101,10 +101,11 @@ describe('sprint-status: readSprintState', () => {
     writeState(ACTIVE_STATE);
     const state = sprintStatus!.readSprintState(TMP_DIR);
     expect(state).not.toBeNull();
-    expect(state?.task_description).toBe('Test sprint');
-    expect(state?.phase).toBe(2);
-    expect(state?.status).toBe('running');
-    expect(Array.isArray(state?.phase_history)).toBe(true);
+    const stateObj = state as Record<string, unknown>;
+    expect(stateObj.task_description).toBe('Test sprint');
+    expect(stateObj.phase).toBe(2);
+    expect(stateObj.status).toBe('running');
+    expect(Array.isArray(stateObj.phase_history)).toBe(true);
   });
 
   // AC-SPRINTSTATUS-001-02: No active sprint

package/lib/__tests__/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../../../tsconfig.json",
+  "compilerOptions": {
+    "allowJs": true,
+    "checkJs": false,
+    "types": ["node", "vitest/globals"]
+  }
+}

package/lib/init.js

@@ -279,13 +279,75 @@ function printCliToolStatus() {
   console.log(`CLI tools: ${available.length}/${GATE_CLI_TOOLS.length} available`);
   if (missing.length > 0) {
     console.log(`  Missing: ${missing.join(', ')}`);
-    console.log('  Quality gates using these tools will silently SKIP until they are installed.');
-    console.log(`  Run 'xp-gate bootstrap' to install all missing tools, or 'xp-gate doctor' for details.\n`);
+    console.log('  Quality gates using these tools will silently SKIP until they are installed.\n');
   } else {
     console.log('');
   }
 }
 
+/**
+ * Ask the user for confirmation via stdin.
+ * @param {string} question - The yes/no question to display
+ * @returns {Promise<boolean>} true if user answered yes
+ */
+function askYesNo(question) {
+  return new Promise((resolve) => {
+    const rl = require('readline').createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+    rl.question(`${question} (Y/n) `, (answer) => {
+      rl.close();
+      const normalized = answer.trim().toLowerCase();
+      // Empty (just Enter) or y/yes → yes; anything else → no
+      resolve(normalized === '' || normalized === 'y' || normalized === 'yes');
+    });
+  });
+}
+
+/**
+ * Prompt the user to auto-install missing CLI quality-gate tools.
+ * Called after installation completes. Interactive only when TTY is available.
+ * Skips silently when no tools are missing.
+ *
+ * @param {boolean} autoYes - If true, skip prompt and auto-install
+ * @returns {Promise<number>} 0 on success or skipped, 1 on failure
+ */
+async function promptBootstrap(autoYes) {
+  const { bootstrap } = require('./bootstrap.js');
+
+  // Check what's missing without printing a full header
+  const missing = [];
+  for (const entry of GATE_CLI_TOOLS) {
+    const result = checkCliTool(entry.tool);
+    if (!result.available) {
+      missing.push(entry.tool);
+    }
+  }
+
+  if (missing.length === 0) return 0;
+
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('  Quality Gate CLI Tools');
+  console.log('');
+  console.log(`  ${missing.length} tool(s) required by quality gates are not installed:`);
+  for (const tool of missing) {
+    console.log(`    ✗ ${tool}`);
+  }
+  console.log('');
+  console.log('  Without these tools, the corresponding quality gates will');
+  console.log('  silently SKIP during git commits — you may miss issues.');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+
+  if (autoYes || (process.stdin.isTTY && await askYesNo('\nInstall missing tools now?'))) {
+    console.log('');
+    return bootstrap([]);
+  }
+
+  console.log('\n  Skipped. Run "xp-gate bootstrap" later to install them.');
+  return 0;
+}
+
 async function init(args) {
   console.log('XP-Gate Initialization');
   console.log('====================\n');
@@ -384,6 +446,23 @@ async function installLocal(args) {
 
   console.log('\nInstallation complete!');
   console.log('Run git commit to trigger quality gates');
+
+  // Auto-install missing CLI tools (prompt user)
+  const autoYes = args.includes('--yes') || args.includes('--auto-install');
+  await promptBootstrap(autoYes);
+  console.log('━━━ FIRST-CLASS TEST QUALITY ━━━');
+  console.log('XP-Gate treats test code as a first-class citizen:');
+  console.log('  • TypeScript: test files are type-checked, not excluded from tsconfig.json');
+  console.log('  • Static analysis: lint/ESLint/Biome check test files alongside source');
+  console.log('  • Complexity: cyclomatic complexity is measured on test files too');
+  console.log('  • Duplicate code: jscpd scans test files (fixtures/snapshots excluded)');
+  console.log('  • Architecture: archlint validates test code structure');
+  console.log('');
+  console.log('  To include tests in your project:');
+  console.log('  1. Remove __tests__/ from tsconfig.json exclude');
+  console.log('  2. Remove __tests__/ from jscpd.conf.json ignore');
+  console.log('  3. Add tsconfig.json: "types": ["vitest/globals"]');
+  console.log('  4. Run "xp-gate doctor" to verify setup');
   return 0;
 }
 
@@ -441,6 +520,21 @@ async function setupGlobal(args) {
   console.log('\nGlobal setup complete!');
   console.log('All git repositories will now use xp-gate quality gates.');
   console.log('Per-project adapters can still override by creating <repo>/githooks/');
+
+  // Auto-install missing CLI tools (prompt user)
+  const autoYes = args.includes('--yes') || args.includes('--auto-install');
+  await promptBootstrap(autoYes);
+
+  console.log('');
+  console.log('━━━ FIRST-CLASS TEST QUALITY ━━━');
+  console.log('XP-Gate treats test code as a first-class citizen:');
+  console.log('  All quality gates apply equally to test files.');
+  console.log('  To include tests in your project:');
+  console.log('  1. Remove __tests__/ from tsconfig.json exclude');
+  console.log('  2. Remove __tests__/ from jscpd.conf.json ignore');
+  console.log('  3. Remove test patterns from .archlint.yaml ignore');
+  console.log('  4. Add "types": ["vitest/globals"] to tsconfig.json');
+  console.log('  5. Run "xp-gate doctor" to verify');
   return 0;
 }
 
@@ -532,4 +626,4 @@ function injectKarpathyPrinciples(projectRoot) {
   }
 }
 
-module.exports = { init };
+module.exports = { init, promptBootstrap };

package/mock-policy/AGENTS.md

@@ -1,9 +1,9 @@
 # SRC/MOCK-POLICY KNOWLEDGE BASE
 
-**Generated:** 2026-07-03
-**Commit:** c3ed581
+**Generated:** 2026-07-07
+**Commit:** 897f8eb
 **Branch:** main
-**Version:** 0.12.4.0
+**Version:** 0.12.13.0
 
 ## OVERVIEW
 Mock layering policy enforcement — Gate M3 of pre-push hook. Ensures integration tests use real implementations for internal dependencies, mock external dependencies, and annotate pending mocks with removal plans. Combines project scope scanning, mock decision engine, and per-file validation into a single pipeline.

package/mutation/AGENTS.md

@@ -1,9 +1,9 @@
 # SRC/MUTATION KNOWLEDGE BASE
 
-**Generated:** 2026-07-03
-**Commit:** c3ed581
+**Generated:** 2026-07-07
+**Commit:** 897f8eb
 **Branch:** main
-**Version:** 0.12.4.0
+**Version:** 0.12.13.0
 
 ## OVERVIEW
 **Gate M** (incremental mutation testing) + **Gate M2** helpers (test-layer detection used by `src/mock-policy/`). Pre-push quality gate. TypeScript-only; uses Stryker.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boyingliu01/xp-gate",
-  "version": "0.12.10",
+  "version": "0.12.13",
   "description": "AI-driven development workflow: 6 quality gates + Delphi review + Sprint Flow",
   "bin": {
     "xp-gate": "./bin/xp-gate.js"

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

@@ -1,6 +1,6 @@
 {
   "name": "xp-gate",
-  "version": "0.12.10",
+  "version": "0.12.13",
   "displayName": "XP-Gate",
   "description": "Extreme Programming quality gates + AI workflow skills for Claude Code. Includes 10 quality gates (Gate 0-9), Sprint Flow (11 phases), and Delphi multi-expert review (>=90% consensus).",
   "author": {

package/plugins/claude-code/skills/delphi-review/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
-**Generated:** 2026-07-03
-**Commit:** c3ed581
+**Generated:** 2026-07-07
+**Commit:** 897f8eb
 **Branch:** main
-**Version:** 0.12.4.0
+**Version:** 0.12.13.0
 
 ## OVERVIEW
 Delphi Consensus Review — multi-round anonymous expert review (≥90% threshold, 3 experts from ≥2 providers, domestic models only). Supports design + code-walkthrough modes.

package/plugins/claude-code/skills/sprint-flow/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/SPRINT-FLOW KNOWLEDGE BASE
 
-**Generated:** 2026-07-03
-**Commit:** c3ed581
+**Generated:** 2026-07-07
+**Commit:** 897f8eb
 **Branch:** main
-**Version:** 0.12.4.0
+**Version:** 0.12.13.0
 
 ## OVERVIEW
 **11-phase** development pipeline: ISOLATE → AUTO-ESTIMATE → THINK → PLAN → BUILD → REVIEW → SHIP → LAND → USER ACCEPTANCE → FEEDBACK → CLEANUP. Phase 2 default build mode is **ralph-loop** (REQ-level iteration, 40-67% token savings vs parallel). HARD-GATE in Phase 1: design must pass Delphi review (≥90% consensus) before any coding.

package/plugins/claude-code/skills/test-specification-alignment/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/TEST-SPECIFICATION-ALIGNMENT KNOWLEDGE BASE
 
-**Generated:** 2026-07-03
-**Commit:** c3ed581
+**Generated:** 2026-07-07
+**Commit:** 897f8eb
 **Branch:** main
-**Version:** 0.12.4.0
+**Version:** 0.12.13.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.

package/plugins/opencode/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boyingliu01/opencode-plugin",
-  "version": "0.12.10",
+  "version": "0.12.13",
   "type": "module",
   "main": "index.ts",
   "description": "XP-Gate quality gates + AI workflow skills + Sprint Flow TUI sidebar for OpenCode",

package/plugins/opencode/skills/delphi-review/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/DELPHI-REVIEW KNOWLEDGE BASE
 
-**Generated:** 2026-07-03
-**Commit:** c3ed581
+**Generated:** 2026-07-07
+**Commit:** 897f8eb
 **Branch:** main
-**Version:** 0.12.4.0
+**Version:** 0.12.13.0
 
 ## OVERVIEW
 Delphi Consensus Review — multi-round anonymous expert review (≥90% threshold, 3 experts from ≥2 providers, domestic models only). Supports design + code-walkthrough modes.

package/plugins/opencode/skills/sprint-flow/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/SPRINT-FLOW KNOWLEDGE BASE
 
-**Generated:** 2026-07-03
-**Commit:** c3ed581
+**Generated:** 2026-07-07
+**Commit:** 897f8eb
 **Branch:** main
-**Version:** 0.12.4.0
+**Version:** 0.12.13.0
 
 ## OVERVIEW
 **11-phase** development pipeline: ISOLATE → AUTO-ESTIMATE → THINK → PLAN → BUILD → REVIEW → SHIP → LAND → USER ACCEPTANCE → FEEDBACK → CLEANUP. Phase 2 default build mode is **ralph-loop** (REQ-level iteration, 40-67% token savings vs parallel). HARD-GATE in Phase 1: design must pass Delphi review (≥90% consensus) before any coding.