@boyingliu01/xp-gate 0.18.0 → 0.18.2

package/lib/sprint-init.js

@@ -1,207 +1,207 @@
-/**
- * xp-gate sprint-init — Programmatic sprint initialization.
- *
- * Resolves #366 (phase-transition never called by orchestrator).
- * Layer 1 of the three-layer enforcement mechanism.
- *
- * Creates .sprint-state/sprint-state.json as the single entry point
- * for sprint initialization. Replaces manual state file creation.
- *
- * Usage:
- *   xp-gate sprint-init "<task_description>" [--issues "<#123,#456>"] [--force] [--dry-run] [--dir <path>]
- *
- * Non-interactive design (LLM orchestrator cannot handle stdin):
- *   - Default: existing active sprint → error exit 1
- *   - --force: override existing sprint, backup old state to .sprint-history/
- *   - --dry-run: pre-check conflicts, no writes
- *   - Idempotent: same task_description + branch → output dashboard, exit 0
- *
- * @module sprint-init
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { execFileSync } = require('child_process');
-const { SprintStateManager } = require('./sprint-state-manager');
-const { renderDashboard } = require('./phase-transition');
-
-/**
- * Detect current git branch.
- * @param {string} cwd - Working directory
- * @returns {string} Branch name or 'detached'
- */
-function detectBranch(cwd) {
-  try {
-    const branch = execFileSync('git', ['branch', '--show-current'], {
-      cwd, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'],
-    }).trim();
-    return branch || 'detached';
-  } catch {
-    return 'unknown';
-  }
-}
-
-/**
- * Generate sprint ID from date and sequence.
- * @returns {string} Sprint ID like "sprint-20260722-01"
- */
-function generateSprintId() {
-  const now = new Date();
-  const dateStr = now.toISOString().slice(0, 10).replace(/-/g, '');
-  const seq = String(Math.floor(Math.random() * 99) + 1).padStart(2, '0');
-  return `sprint-${dateStr}-${seq}`;
-}
-
-/**
- * Backup existing sprint state to .sprint-history/.
- * @param {string} projectRoot - Project root directory
- * @param {object} state - Current sprint state
- */
-function backupSprintState(projectRoot, state) {
-  const historyDir = path.join(projectRoot, '.sprint-history');
-  if (!fs.existsSync(historyDir)) {
-    fs.mkdirSync(historyDir, { recursive: true });
-  }
-  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
-  const backupFile = path.join(historyDir, `sprint-state-${state.id || 'unknown'}-${timestamp}.json`);
-  fs.writeFileSync(backupFile, JSON.stringify(state, null, 2), 'utf8');
-  return backupFile;
-}
-
-/**
- * CLI entry point for sprint-init command.
- * @param {string[]} args - CLI arguments
- * @returns {Promise<number>} Exit code
- */
-async function handleSprintInit(args = []) {
-  if (args.includes('--help')) {
-    console.log('Usage: xp-gate sprint-init "<task_description>" [options]');
-    console.log('');
-    console.log('Arguments:');
-    console.log('  task_description   Sprint task description (required)');
-    console.log('');
-    console.log('Options:');
-    console.log('  --issues <list>    Comma-separated issue numbers (e.g. "#123,#456")');
-    console.log('  --force            Override existing active sprint (backs up old state)');
-    console.log('  --dry-run          Pre-check conflicts without writing');
-    console.log('  --dir <path>       Project directory (default: cwd)');
-    console.log('');
-    console.log('Examples:');
-    console.log('  xp-gate sprint-init "Implement user auth"');
-    console.log('  xp-gate sprint-init "Fix #366" --issues "#366" --force');
-    return 0;
-  }
-
-  // Parse arguments
-  const forceFlag = args.includes('--force');
-  const dryRunFlag = args.includes('--dry-run');
-  const dirIdx = args.indexOf('--dir');
-  const projectDir = dirIdx >= 0 ? args[dirIdx + 1] : process.cwd();
-  const issuesIdx = args.indexOf('--issues');
-  const issues = issuesIdx >= 0 ? args[issuesIdx + 1] : '';
-
-  // First non-flag argument is task_description
-  const taskDescription = args.find(a => !a.startsWith('--') && a !== projectDir && a !== issues);
-  if (!taskDescription) {
-    console.error('Error: Missing task_description. Usage: xp-gate sprint-init "<task_description>"');
-    return 1;
-  }
-
-  const manager = new SprintStateManager(projectDir);
-  const branch = detectBranch(projectDir);
-
-  // Check existing sprint state
-  let existingState = null;
-  try {
-    existingState = manager.read();
-  } catch {
-    // Corrupted state — treat as no state (will be overwritten)
-    existingState = null;
-  }
-
-  if (existingState) {
-    // Idempotent check: same task_description + branch → output dashboard, exit 0
-    const normalizedExisting = (existingState.task_description || '').trim();
-    const normalizedNew = taskDescription.trim();
-    const existingBranch = existingState.isolation?.branch || '';
-
-    if (normalizedExisting === normalizedNew && existingBranch === branch && branch !== 'detached') {
-      console.log('ℹ️  Sprint already initialized (idempotent call). Current state:');
-      console.log('');
-      console.log(renderDashboard(existingState));
-      return 0;
-    }
-
-    // Conflict: existing active sprint
-    if (!forceFlag) {
-      if (dryRunFlag) {
-        console.log(JSON.stringify({
-          decision: 'deny',
-          reason: `Active sprint "${existingState.id}" exists (task: "${normalizedExisting}")`,
-          hint: 'Use --force to override (backs up old state)',
-        }));
-        return 0;
-      }
-      console.error(`Error: Active sprint "${existingState.id}" already exists.`);
-      console.error(`  Task: "${normalizedExisting}"`);
-      console.error(`  Branch: ${existingBranch}`);
-      console.error('  Use --force to override (backs up old state to .sprint-history/)');
-      return 1;
-    }
-
-    // --force: backup and override
-    const backupPath = backupSprintState(projectDir, existingState);
-    console.log(`📦 Backed up existing sprint to: ${backupPath}`);
-  }
-
-  if (dryRunFlag) {
-    console.log(JSON.stringify({
-      decision: 'allow',
-      reason: existingState ? 'Would override existing sprint (--force)' : 'No existing sprint',
-      branch,
-      task_description: taskDescription.trim(),
-    }));
-    return 0;
-  }
-
-  // Create new sprint state
-  const sprintId = generateSprintId();
-  const newState = {
-    _schema_version: 1,
-    id: sprintId,
-    task_description: taskDescription.trim(),
-    phase: 1,
-    status: 'in_progress',
-    started_at: new Date().toISOString(),
-    phase_history: [
-      {
-        phase: 1,
-        name: 'PREP',
-        status: 'in_progress',
-        started_at: new Date().toISOString(),
-      },
-    ],
-    isolation: {
-      worktree_path: projectDir,
-      branch,
-    },
-    outputs: issues ? { issues } : {},
-    metrics: {},
-  };
-
-  // Write state atomically
-  manager.write(newState);
-
-  console.log(`✅ Sprint initialized: ${sprintId}`);
-  console.log(`   Task: ${taskDescription.trim()}`);
-  console.log(`   Branch: ${branch}`);
-  if (issues) console.log(`   Issues: ${issues}`);
-  console.log('');
-  console.log(renderDashboard(newState));
-
-  return 0;
-}
-
-module.exports = { handleSprintInit, detectBranch, generateSprintId, backupSprintState };
+/**
+ * xp-gate sprint-init — Programmatic sprint initialization.
+ *
+ * Resolves #366 (phase-transition never called by orchestrator).
+ * Layer 1 of the three-layer enforcement mechanism.
+ *
+ * Creates .sprint-state/sprint-state.json as the single entry point
+ * for sprint initialization. Replaces manual state file creation.
+ *
+ * Usage:
+ *   xp-gate sprint-init "<task_description>" [--issues "<#123,#456>"] [--force] [--dry-run] [--dir <path>]
+ *
+ * Non-interactive design (LLM orchestrator cannot handle stdin):
+ *   - Default: existing active sprint → error exit 1
+ *   - --force: override existing sprint, backup old state to .sprint-history/
+ *   - --dry-run: pre-check conflicts, no writes
+ *   - Idempotent: same task_description + branch → output dashboard, exit 0
+ *
+ * @module sprint-init
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { execFileSync } = require('child_process');
+const { SprintStateManager } = require('./sprint-state-manager');
+const { renderDashboard } = require('./phase-transition');
+
+/**
+ * Detect current git branch.
+ * @param {string} cwd - Working directory
+ * @returns {string} Branch name or 'detached'
+ */
+function detectBranch(cwd) {
+  try {
+    const branch = execFileSync('git', ['branch', '--show-current'], {
+      cwd, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'],
+    }).trim();
+    return branch || 'detached';
+  } catch {
+    return 'unknown';
+  }
+}
+
+/**
+ * Generate sprint ID from date and sequence.
+ * @returns {string} Sprint ID like "sprint-20260722-01"
+ */
+function generateSprintId() {
+  const now = new Date();
+  const dateStr = now.toISOString().slice(0, 10).replace(/-/g, '');
+  const seq = String(Math.floor(Math.random() * 99) + 1).padStart(2, '0');
+  return `sprint-${dateStr}-${seq}`;
+}
+
+/**
+ * Backup existing sprint state to .sprint-history/.
+ * @param {string} projectRoot - Project root directory
+ * @param {object} state - Current sprint state
+ */
+function backupSprintState(projectRoot, state) {
+  const historyDir = path.join(projectRoot, '.sprint-history');
+  if (!fs.existsSync(historyDir)) {
+    fs.mkdirSync(historyDir, { recursive: true });
+  }
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+  const backupFile = path.join(historyDir, `sprint-state-${state.id || 'unknown'}-${timestamp}.json`);
+  fs.writeFileSync(backupFile, JSON.stringify(state, null, 2), 'utf8');
+  return backupFile;
+}
+
+/**
+ * CLI entry point for sprint-init command.
+ * @param {string[]} args - CLI arguments
+ * @returns {Promise<number>} Exit code
+ */
+async function handleSprintInit(args = []) {
+  if (args.includes('--help')) {
+    console.log('Usage: xp-gate sprint-init "<task_description>" [options]');
+    console.log('');
+    console.log('Arguments:');
+    console.log('  task_description   Sprint task description (required)');
+    console.log('');
+    console.log('Options:');
+    console.log('  --issues <list>    Comma-separated issue numbers (e.g. "#123,#456")');
+    console.log('  --force            Override existing active sprint (backs up old state)');
+    console.log('  --dry-run          Pre-check conflicts without writing');
+    console.log('  --dir <path>       Project directory (default: cwd)');
+    console.log('');
+    console.log('Examples:');
+    console.log('  xp-gate sprint-init "Implement user auth"');
+    console.log('  xp-gate sprint-init "Fix #366" --issues "#366" --force');
+    return 0;
+  }
+
+  // Parse arguments
+  const forceFlag = args.includes('--force');
+  const dryRunFlag = args.includes('--dry-run');
+  const dirIdx = args.indexOf('--dir');
+  const projectDir = dirIdx >= 0 ? args[dirIdx + 1] : process.cwd();
+  const issuesIdx = args.indexOf('--issues');
+  const issues = issuesIdx >= 0 ? args[issuesIdx + 1] : '';
+
+  // First non-flag argument is task_description
+  const taskDescription = args.find(a => !a.startsWith('--') && a !== projectDir && a !== issues);
+  if (!taskDescription) {
+    console.error('Error: Missing task_description. Usage: xp-gate sprint-init "<task_description>"');
+    return 1;
+  }
+
+  const manager = new SprintStateManager(projectDir);
+  const branch = detectBranch(projectDir);
+
+  // Check existing sprint state
+  let existingState = null;
+  try {
+    existingState = manager.read();
+  } catch {
+    // Corrupted state — treat as no state (will be overwritten)
+    existingState = null;
+  }
+
+  if (existingState) {
+    // Idempotent check: same task_description + branch → output dashboard, exit 0
+    const normalizedExisting = (existingState.task_description || '').trim();
+    const normalizedNew = taskDescription.trim();
+    const existingBranch = existingState.isolation?.branch || '';
+
+    if (normalizedExisting === normalizedNew && existingBranch === branch && branch !== 'detached') {
+      console.log('ℹ️  Sprint already initialized (idempotent call). Current state:');
+      console.log('');
+      console.log(renderDashboard(existingState));
+      return 0;
+    }
+
+    // Conflict: existing active sprint
+    if (!forceFlag) {
+      if (dryRunFlag) {
+        console.log(JSON.stringify({
+          decision: 'deny',
+          reason: `Active sprint "${existingState.id}" exists (task: "${normalizedExisting}")`,
+          hint: 'Use --force to override (backs up old state)',
+        }));
+        return 0;
+      }
+      console.error(`Error: Active sprint "${existingState.id}" already exists.`);
+      console.error(`  Task: "${normalizedExisting}"`);
+      console.error(`  Branch: ${existingBranch}`);
+      console.error('  Use --force to override (backs up old state to .sprint-history/)');
+      return 1;
+    }
+
+    // --force: backup and override
+    const backupPath = backupSprintState(projectDir, existingState);
+    console.log(`📦 Backed up existing sprint to: ${backupPath}`);
+  }
+
+  if (dryRunFlag) {
+    console.log(JSON.stringify({
+      decision: 'allow',
+      reason: existingState ? 'Would override existing sprint (--force)' : 'No existing sprint',
+      branch,
+      task_description: taskDescription.trim(),
+    }));
+    return 0;
+  }
+
+  // Create new sprint state
+  const sprintId = generateSprintId();
+  const newState = {
+    _schema_version: 1,
+    id: sprintId,
+    task_description: taskDescription.trim(),
+    phase: 1,
+    status: 'in_progress',
+    started_at: new Date().toISOString(),
+    phase_history: [
+      {
+        phase: 1,
+        name: 'PREP',
+        status: 'in_progress',
+        started_at: new Date().toISOString(),
+      },
+    ],
+    isolation: {
+      worktree_path: projectDir,
+      branch,
+    },
+    outputs: issues ? { issues } : {},
+    metrics: {},
+  };
+
+  // Write state atomically
+  manager.write(newState);
+
+  console.log(`✅ Sprint initialized: ${sprintId}`);
+  console.log(`   Task: ${taskDescription.trim()}`);
+  console.log(`   Branch: ${branch}`);
+  if (issues) console.log(`   Issues: ${issues}`);
+  console.log('');
+  console.log(renderDashboard(newState));
+
+  return 0;
+}
+
+module.exports = { handleSprintInit, detectBranch, generateSprintId, backupSprintState };

package/mock-policy/AGENTS.md

@@ -1,9 +1,9 @@
 # SRC/MOCK-POLICY KNOWLEDGE BASE
 
-**Generated:** 2026-07-25
-**Commit:** 3150b22
+**Generated:** 2026-07-27
+**Commit:** f112d8d
 **Branch:** main
-**Version:** 0.18.0.0
+**Version:** 0.18.2.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-25
-**Commit:** 3150b22
+**Generated:** 2026-07-27
+**Commit:** f112d8d
 **Branch:** main
-**Version:** 0.18.0.0
+**Version:** 0.18.2.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.18.0",
+  "version": "0.18.2",
   "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.18.0",
+  "version": "0.18.2",
   "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-25
-**Commit:** 3150b22
+**Generated:** 2026-07-27
+**Commit:** f112d8d
 **Branch:** main
-**Version:** 0.18.0.0
+**Version:** 0.18.2.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/grilling/SKILL.md

@@ -1,12 +1,12 @@
----
-name: grilling
-description: Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.
----
-
-Interview me relentlessly about every aspect of this until we reach a shared understanding. Walk down each branch of the decision tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.
-
-Ask the questions one at a time, waiting for feedback on each question before continuing. Asking multiple questions at once is bewildering.
-
-If a *fact* can be found by exploring the environment (filesystem, tools, etc.), look it up rather than asking me. The *decisions*, though, are mine — put each one to me and wait for my answer.
-
-Do not act on it until I confirm we have reached a shared understanding.
+---
+name: grilling
+description: Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.
+---
+
+Interview me relentlessly about every aspect of this until we reach a shared understanding. Walk down each branch of the decision tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.
+
+Ask the questions one at a time, waiting for feedback on each question before continuing. Asking multiple questions at once is bewildering.
+
+If a *fact* can be found by exploring the environment (filesystem, tools, etc.), look it up rather than asking me. The *decisions*, though, are mine — put each one to me and wait for my answer.
+
+Do not act on it until I confirm we have reached a shared understanding.

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

@@ -1,9 +1,9 @@
 # SKILLS/SPRINT-FLOW KNOWLEDGE BASE
 
-**Generated:** 2026-07-25
-**Commit:** 3150b22
+**Generated:** 2026-07-27
+**Commit:** f112d8d
 **Branch:** main
-**Version:** 0.18.0.0
+**Version:** 0.18.2.0
 
 ## OVERVIEW
 **6-phase** development pipeline (v2.0 compact redesign, Issue #290): PREP → DESIGN → BUILD → VERIFY → SHIP → CLOSE. Phase 3/6 BUILD default build mode is **ralph-loop** (REQ-level iteration, 40-67% token savings vs parallel). HARD-GATE between DESIGN (2/6) and BUILD (3/6): 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-25
-**Commit:** 3150b22
+**Generated:** 2026-07-27
+**Commit:** f112d8d
 **Branch:** main
-**Version:** 0.18.0.0
+**Version:** 0.18.2.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.18.0",
+  "version": "0.18.2",
   "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-25
-**Commit:** 3150b22
+**Generated:** 2026-07-27
+**Commit:** f112d8d
 **Branch:** main
-**Version:** 0.18.0.0
+**Version:** 0.18.2.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/grilling/SKILL.md

@@ -1,12 +1,12 @@
----
-name: grilling
-description: Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.
----
-
-Interview me relentlessly about every aspect of this until we reach a shared understanding. Walk down each branch of the decision tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.
-
-Ask the questions one at a time, waiting for feedback on each question before continuing. Asking multiple questions at once is bewildering.
-
-If a *fact* can be found by exploring the environment (filesystem, tools, etc.), look it up rather than asking me. The *decisions*, though, are mine — put each one to me and wait for my answer.
-
-Do not act on it until I confirm we have reached a shared understanding.
+---
+name: grilling
+description: Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.
+---
+
+Interview me relentlessly about every aspect of this until we reach a shared understanding. Walk down each branch of the decision tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.
+
+Ask the questions one at a time, waiting for feedback on each question before continuing. Asking multiple questions at once is bewildering.
+
+If a *fact* can be found by exploring the environment (filesystem, tools, etc.), look it up rather than asking me. The *decisions*, though, are mine — put each one to me and wait for my answer.
+
+Do not act on it until I confirm we have reached a shared understanding.

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

@@ -1,9 +1,9 @@
 # SKILLS/SPRINT-FLOW KNOWLEDGE BASE
 
-**Generated:** 2026-07-25
-**Commit:** 3150b22
+**Generated:** 2026-07-27
+**Commit:** f112d8d
 **Branch:** main
-**Version:** 0.18.0.0
+**Version:** 0.18.2.0
 
 ## OVERVIEW
 **6-phase** development pipeline (v2.0 compact redesign, Issue #290): PREP → DESIGN → BUILD → VERIFY → SHIP → CLOSE. Phase 3/6 BUILD default build mode is **ralph-loop** (REQ-level iteration, 40-67% token savings vs parallel). HARD-GATE between DESIGN (2/6) and BUILD (3/6): design must pass Delphi review (≥90% consensus) before any coding.

package/plugins/opencode/skills/test-specification-alignment/AGENTS.md

@@ -1,9 +1,9 @@
 # SKILLS/TEST-SPECIFICATION-ALIGNMENT KNOWLEDGE BASE
 
-**Generated:** 2026-07-25
-**Commit:** 3150b22
+**Generated:** 2026-07-27
+**Commit:** f112d8d
 **Branch:** main
-**Version:** 0.18.0.0
+**Version:** 0.18.2.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.