@boyingliu01/xp-gate 0.27.1 → 0.27.3

package/lib/sprint-audit.js

@@ -1,235 +1,235 @@
-/**
- * xp-gate sprint-audit — Layer 2: Final sprint completeness audit.
- *
- * Checks phase_history coverage, time records, artifact records,
- * and state consistency at Phase 6 CLOSE.
- *
- * Usage:
- *   xp-gate sprint-audit [--dir <path>] [--json]
- *
- * Verdict rules:
- *   6/6 completed + 0 errors       → PASS (exit 0)
- *   >= 4/6 completed + 0 errors    → PASS_WITH_WARNINGS (exit 0)
- *   < 4/6 completed or any errors  → FAIL (exit 1)
- *   No sprint-state.json           → SKIP (exit 0)
- *
- * @module sprint-audit
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { PHASE_NAMES } = require('./phase-transition');
-
-/**
- * Run the sprint audit.
- * @param {string[]} args - CLI arguments
- * @returns {Promise<number>} Exit code
- */
-async function handleSprintAudit(args = []) {
-  if (args.includes('--help')) {
-    console.log('Usage: xp-gate sprint-audit [options]');
-    console.log('');
-    console.log('Options:');
-    console.log('  --dir <path>   Project directory (default: cwd)');
-    console.log('  --json         Output as JSON instead of human-readable');
-    console.log('');
-    console.log('Runs final sprint completeness audit at Phase 6 CLOSE.');
-    console.log('Checks phase coverage, time records, artifact records,');
-    console.log('and state consistency.');
-    return 0;
-  }
-
-  const dirIdx = args.indexOf('--dir');
-  const projectDir = dirIdx >= 0 ? args[dirIdx + 1] : process.cwd();
-  const jsonFlag = args.includes('--json');
-
-  const stateFile = path.join(projectDir, '.sprint-state', 'sprint-state.json');
-
-  // No sprint-state.json → SKIP
-  if (!fs.existsSync(stateFile)) {
-    if (jsonFlag) {
-      console.log(JSON.stringify({ verdict: 'SKIP', reason: 'No sprint-state.json found' }));
-    } else {
-      console.log('⏭️  No sprint-state.json found — skipping audit.');
-    }
-    return 0;
-  }
-
-  let state;
-  try {
-    state = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
-  } catch (err) {
-    const result = {
-      verdict: 'FAIL',
-      errors: [`Failed to parse sprint-state.json: ${err.message}`],
-    };
-    if (jsonFlag) {
-      console.log(JSON.stringify(result, null, 2));
-    } else {
-      console.error(`❌ ${result.errors[0]}`);
-    }
-    return 1;
-  }
-
-  // ── Run checks ──
-  const warnings = [];
-  const errors = [];
-  const phaseHistory = Array.isArray(state.phase_history) ? state.phase_history : [];
-
-  // Build lookup
-  const historyLookup = {};
-  for (const entry of phaseHistory) {
-    historyLookup[entry.phase] = entry;
-  }
-
-  // Check 1: Phase coverage
-  const completedPhases = [];
-  const missingPhases = [];
-  const incompletePhases = [];
-
-  for (let i = 1; i <= 6; i++) {
-    const entry = historyLookup[i];
-    if (!entry) {
-      missingPhases.push(i);
-    } else if (entry.status === 'completed' || entry.status === 'skipped') {
-      completedPhases.push(i);
-    } else {
-      incompletePhases.push({ phase: i, name: PHASE_NAMES[i] || `Phase ${i}`, status: entry.status });
-    }
-  }
-
-  // Check 2: Time records for completed phases
-  for (const phaseNum of completedPhases) {
-    const entry = historyLookup[phaseNum];
-    if (entry.status === 'completed' && (entry.duration_seconds == null || entry.duration_seconds === 0)) {
-      warnings.push(`Phase ${phaseNum} (${PHASE_NAMES[phaseNum]}) completed but has no duration recorded`);
-    }
-  }
-
-  // Check 3: Artifact records (phase-{N}-summary.md)
-  const outputsDir = path.join(projectDir, '.sprint-state', 'phase-outputs');
-  for (const phaseNum of completedPhases) {
-    if (historyLookup[phaseNum].status === 'completed') {
-      const summaryFile = path.join(outputsDir, `phase-${phaseNum}-summary.md`);
-      if (!fs.existsSync(summaryFile)) {
-        warnings.push(`Phase ${phaseNum} summary missing: .sprint-state/phase-outputs/phase-${phaseNum}-summary.md`);
-      }
-    }
-  }
-
-  // Check 4: State consistency — phase field vs phase_history last entry
-  if (phaseHistory.length > 0) {
-    const lastEntry = phaseHistory[phaseHistory.length - 1];
-    if (state.phase !== undefined && state.phase !== lastEntry.phase) {
-      errors.push(
-        `State inconsistency: sprint-state.phase=${state.phase} but phase_history last entry is phase ${lastEntry.phase}`
-      );
-    }
-  }
-
-  // ── Determine verdict ──
-  const completedCount = completedPhases.length;
-  let verdict;
-  if (errors.length > 0 || completedCount < 4) {
-    verdict = 'FAIL';
-  } else if (completedCount >= 6 && errors.length === 0) {
-    verdict = 'PASS';
-  } else {
-    verdict = 'PASS_WITH_WARNINGS';
-  }
-
-  // ── Build result ──
-  const result = {
-    sprint_id: state.id || 'unknown',
-    branch: state.isolation?.branch || 'unknown',
-    coverage: {
-      completed: completedCount,
-      total: 6,
-      pct: Math.round((completedCount / 6) * 100),
-    },
-    missing_phases: missingPhases.map(p => ({ phase: p, name: PHASE_NAMES[p] || `Phase ${p}` })),
-    incomplete_phases: incompletePhases,
-    warnings,
-    errors,
-    verdict,
-  };
-
-  // ── Persist report (latest overwrites — expected behavior) ──
-  const reportPath = path.join(projectDir, '.sprint-state', 'audit-report.json');
-  try {
-    fs.writeFileSync(reportPath, JSON.stringify(result, null, 2), 'utf8');
-  } catch (err) {
-    // Report write failure is WARNING, not BLOCK
-    warnings.push(`Failed to write audit report: ${err.message}`);
-  }
-
-  // ── Output ──
-  if (jsonFlag) {
-    console.log(JSON.stringify(result, null, 2));
-  } else {
-    printHumanReadable(result, state);
-  }
-
-  // Exit code: FAIL → 1, others → 0
-  return verdict === 'FAIL' ? 1 : 0;
-}
-
-/**
- * Print human-readable audit report.
- * @param {object} result - Audit result object
- * @param {object} state - Sprint state object
- */
-function printHumanReadable(result, state) {
-  const lines = [];
-  lines.push('');
-  lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  lines.push(`  Sprint Audit Report — ${result.sprint_id}`);
-  lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-  lines.push('');
-  lines.push(`  Branch: ${result.branch}`);
-  lines.push(`  Phase Coverage: ${result.coverage.completed}/${result.coverage.total} (${result.coverage.pct}%)`);
-  lines.push('');
-  lines.push('  Phase History:');
-
-  for (let i = 1; i <= 6; i++) {
-    const entry = result.incomplete_phases.find(p => p.phase === i);
-    const missing = result.missing_phases.find(p => p.phase === i);
-    const name = (PHASE_NAMES[i] || `Phase ${i}`).padEnd(10);
-
-    if (missing) {
-      lines.push(`  ❌ Phase ${i}/6  ${name} — not recorded`);
-    } else if (entry) {
-      lines.push(`  ⚠️  Phase ${i}/6  ${name} ${entry.status}  ← not yet completed`);
-    } else {
-      lines.push(`  ✅ Phase ${i}/6  ${name} completed`);
-    }
-  }
-
-  if (result.warnings.length > 0) {
-    lines.push('');
-    lines.push('  Warnings:');
-    for (const w of result.warnings) {
-      lines.push(`  ⚠️  ${w}`);
-    }
-  }
-
-  if (result.errors.length > 0) {
-    lines.push('');
-    lines.push('  Errors:');
-    for (const e of result.errors) {
-      lines.push(`  ❌ ${e}`);
-    }
-  }
-
-  lines.push('');
-  const issueCount = result.warnings.length + result.errors.length;
-  lines.push(`  Overall: ${result.warnings.length} warning(s), ${result.errors.length} error(s)`);
-  lines.push(`  Verdict: ${result.verdict}`);
-  lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-
-  console.log(lines.join('\n'));
-}
-
-module.exports = { handleSprintAudit };
+/**
+ * xp-gate sprint-audit — Layer 2: Final sprint completeness audit.
+ *
+ * Checks phase_history coverage, time records, artifact records,
+ * and state consistency at Phase 6 CLOSE.
+ *
+ * Usage:
+ *   xp-gate sprint-audit [--dir <path>] [--json]
+ *
+ * Verdict rules:
+ *   6/6 completed + 0 errors       → PASS (exit 0)
+ *   >= 4/6 completed + 0 errors    → PASS_WITH_WARNINGS (exit 0)
+ *   < 4/6 completed or any errors  → FAIL (exit 1)
+ *   No sprint-state.json           → SKIP (exit 0)
+ *
+ * @module sprint-audit
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { PHASE_NAMES } = require('./phase-transition');
+
+/**
+ * Run the sprint audit.
+ * @param {string[]} args - CLI arguments
+ * @returns {Promise<number>} Exit code
+ */
+async function handleSprintAudit(args = []) {
+  if (args.includes('--help')) {
+    console.log('Usage: xp-gate sprint-audit [options]');
+    console.log('');
+    console.log('Options:');
+    console.log('  --dir <path>   Project directory (default: cwd)');
+    console.log('  --json         Output as JSON instead of human-readable');
+    console.log('');
+    console.log('Runs final sprint completeness audit at Phase 6 CLOSE.');
+    console.log('Checks phase coverage, time records, artifact records,');
+    console.log('and state consistency.');
+    return 0;
+  }
+
+  const dirIdx = args.indexOf('--dir');
+  const projectDir = dirIdx >= 0 ? args[dirIdx + 1] : process.cwd();
+  const jsonFlag = args.includes('--json');
+
+  const stateFile = path.join(projectDir, '.sprint-state', 'sprint-state.json');
+
+  // No sprint-state.json → SKIP
+  if (!fs.existsSync(stateFile)) {
+    if (jsonFlag) {
+      console.log(JSON.stringify({ verdict: 'SKIP', reason: 'No sprint-state.json found' }));
+    } else {
+      console.log('⏭️  No sprint-state.json found — skipping audit.');
+    }
+    return 0;
+  }
+
+  let state;
+  try {
+    state = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
+  } catch (err) {
+    const result = {
+      verdict: 'FAIL',
+      errors: [`Failed to parse sprint-state.json: ${err.message}`],
+    };
+    if (jsonFlag) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.error(`❌ ${result.errors[0]}`);
+    }
+    return 1;
+  }
+
+  // ── Run checks ──
+  const warnings = [];
+  const errors = [];
+  const phaseHistory = Array.isArray(state.phase_history) ? state.phase_history : [];
+
+  // Build lookup
+  const historyLookup = {};
+  for (const entry of phaseHistory) {
+    historyLookup[entry.phase] = entry;
+  }
+
+  // Check 1: Phase coverage
+  const completedPhases = [];
+  const missingPhases = [];
+  const incompletePhases = [];
+
+  for (let i = 1; i <= 6; i++) {
+    const entry = historyLookup[i];
+    if (!entry) {
+      missingPhases.push(i);
+    } else if (entry.status === 'completed' || entry.status === 'skipped') {
+      completedPhases.push(i);
+    } else {
+      incompletePhases.push({ phase: i, name: PHASE_NAMES[i] || `Phase ${i}`, status: entry.status });
+    }
+  }
+
+  // Check 2: Time records for completed phases
+  for (const phaseNum of completedPhases) {
+    const entry = historyLookup[phaseNum];
+    if (entry.status === 'completed' && (entry.duration_seconds == null || entry.duration_seconds === 0)) {
+      warnings.push(`Phase ${phaseNum} (${PHASE_NAMES[phaseNum]}) completed but has no duration recorded`);
+    }
+  }
+
+  // Check 3: Artifact records (phase-{N}-summary.md)
+  const outputsDir = path.join(projectDir, '.sprint-state', 'phase-outputs');
+  for (const phaseNum of completedPhases) {
+    if (historyLookup[phaseNum].status === 'completed') {
+      const summaryFile = path.join(outputsDir, `phase-${phaseNum}-summary.md`);
+      if (!fs.existsSync(summaryFile)) {
+        warnings.push(`Phase ${phaseNum} summary missing: .sprint-state/phase-outputs/phase-${phaseNum}-summary.md`);
+      }
+    }
+  }
+
+  // Check 4: State consistency — phase field vs phase_history last entry
+  if (phaseHistory.length > 0) {
+    const lastEntry = phaseHistory[phaseHistory.length - 1];
+    if (state.phase !== undefined && state.phase !== lastEntry.phase) {
+      errors.push(
+        `State inconsistency: sprint-state.phase=${state.phase} but phase_history last entry is phase ${lastEntry.phase}`
+      );
+    }
+  }
+
+  // ── Determine verdict ──
+  const completedCount = completedPhases.length;
+  let verdict;
+  if (errors.length > 0 || completedCount < 4) {
+    verdict = 'FAIL';
+  } else if (completedCount >= 6 && errors.length === 0) {
+    verdict = 'PASS';
+  } else {
+    verdict = 'PASS_WITH_WARNINGS';
+  }
+
+  // ── Build result ──
+  const result = {
+    sprint_id: state.id || 'unknown',
+    branch: state.isolation?.branch || 'unknown',
+    coverage: {
+      completed: completedCount,
+      total: 6,
+      pct: Math.round((completedCount / 6) * 100),
+    },
+    missing_phases: missingPhases.map(p => ({ phase: p, name: PHASE_NAMES[p] || `Phase ${p}` })),
+    incomplete_phases: incompletePhases,
+    warnings,
+    errors,
+    verdict,
+  };
+
+  // ── Persist report (latest overwrites — expected behavior) ──
+  const reportPath = path.join(projectDir, '.sprint-state', 'audit-report.json');
+  try {
+    fs.writeFileSync(reportPath, JSON.stringify(result, null, 2), 'utf8');
+  } catch (err) {
+    // Report write failure is WARNING, not BLOCK
+    warnings.push(`Failed to write audit report: ${err.message}`);
+  }
+
+  // ── Output ──
+  if (jsonFlag) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    printHumanReadable(result, state);
+  }
+
+  // Exit code: FAIL → 1, others → 0
+  return verdict === 'FAIL' ? 1 : 0;
+}
+
+/**
+ * Print human-readable audit report.
+ * @param {object} result - Audit result object
+ * @param {object} state - Sprint state object
+ */
+function printHumanReadable(result, state) {
+  const lines = [];
+  lines.push('');
+  lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  lines.push(`  Sprint Audit Report — ${result.sprint_id}`);
+  lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  lines.push('');
+  lines.push(`  Branch: ${result.branch}`);
+  lines.push(`  Phase Coverage: ${result.coverage.completed}/${result.coverage.total} (${result.coverage.pct}%)`);
+  lines.push('');
+  lines.push('  Phase History:');
+
+  for (let i = 1; i <= 6; i++) {
+    const entry = result.incomplete_phases.find(p => p.phase === i);
+    const missing = result.missing_phases.find(p => p.phase === i);
+    const name = (PHASE_NAMES[i] || `Phase ${i}`).padEnd(10);
+
+    if (missing) {
+      lines.push(`  ❌ Phase ${i}/6  ${name} — not recorded`);
+    } else if (entry) {
+      lines.push(`  ⚠️  Phase ${i}/6  ${name} ${entry.status}  ← not yet completed`);
+    } else {
+      lines.push(`  ✅ Phase ${i}/6  ${name} completed`);
+    }
+  }
+
+  if (result.warnings.length > 0) {
+    lines.push('');
+    lines.push('  Warnings:');
+    for (const w of result.warnings) {
+      lines.push(`  ⚠️  ${w}`);
+    }
+  }
+
+  if (result.errors.length > 0) {
+    lines.push('');
+    lines.push('  Errors:');
+    for (const e of result.errors) {
+      lines.push(`  ❌ ${e}`);
+    }
+  }
+
+  lines.push('');
+  const issueCount = result.warnings.length + result.errors.length;
+  lines.push(`  Overall: ${result.warnings.length} warning(s), ${result.errors.length} error(s)`);
+  lines.push(`  Verdict: ${result.verdict}`);
+  lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+
+  console.log(lines.join('\n'));
+}
+
+module.exports = { handleSprintAudit };

package/mock-policy/AGENTS.md

@@ -1,9 +1,9 @@
 # SRC/MOCK-POLICY KNOWLEDGE BASE
 
-**Generated:** 2026-10-16
-**Commit:** 0b556f5f
+**Generated:** 2026-10-17
+**Commit:** b207e882
 **Branch:** main
-**Version:** 0.27.1.0
+**Version:** 0.27.3.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-10-16
-**Commit:** 0b556f5f
+**Generated:** 2026-10-17
+**Commit:** b207e882
 **Branch:** main
-**Version:** 0.27.1.0
+**Version:** 0.27.3.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.27.1",
+  "version": "0.27.3",
   "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.27.1",
+  "version": "0.27.3",
   "displayName": "XP-Gate",
   "description": "Extreme Programming quality gates + AI workflow skills for Claude Code. Includes 12 pre-commit gates (Gate 0-11), 8 pre-push gates, Sprint Flow (6 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-10-16
-**Commit:** 0b556f5f
+**Generated:** 2026-10-17
+**Commit:** b207e882
 **Branch:** main
-**Version:** 0.27.1.0
+**Version:** 0.27.3.0
 
 ## OVERVIEW
 Delphi Consensus Review — multi-round anonymous expert review (≥90% threshold, exactly 3 experts with distinct executable model IDs). Supports design, requirements, and code-walkthrough modes.

package/plugins/claude-code/skills/grill-with-docs/SKILL.md

@@ -1,8 +1,7 @@
 ---
 name: grill-with-docs
-version: 1.0.0
 description: A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
 disable-model-invocation: true
 ---
 
-Run a `/grilling` session, using the `/domain-modeling` skill.
+Call the Skill tool twice, for "grilling" and "domain-modeling".

package/plugins/claude-code/skills/grilling/SKILL.md

@@ -1,13 +1,30 @@
 ---
 name: grilling
-version: 1.0.0
 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.
+Interview the user relentlessly until you reach a shared understanding. Map this as a **design tree**: every decision branches into the decisions that hang off it.
 
-Ask the questions one at a time, waiting for feedback on each question before continuing. Asking multiple questions at once is bewildering.
+Work the tree in **rounds**. The **frontier** is every decision whose prerequisites are already settled: the questions you can ask _now_ without guessing at answers you haven't heard yet. Ask the whole frontier in one round: number each question and give your recommended answer. Then wait for the user's answers before the next round.
 
-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.
+Format a round like so:
 
-Do not act on it until I confirm we have reached a shared understanding.
+```
+❓ **Q1** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices>
+
+➡️ <your recommended answer>
+
+---
+
+❓ **Q2** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices>
+
+➡️ <your recommended answer>
+```
+
+Word each question so "yes" accepts your recommended answer.
+
+Each round the user answers reshapes the tree: settled decisions push the frontier outward and unblock questions that depended on them. Recompute the frontier and ask the next round. A question whose answer depends on another question still open in this round belongs to a _later_ round, not this one.
+
+Finding _facts_ is your job, never the user's. When a frontier question needs a fact from the environment (filesystem, tools, etc.), dispatch a sub-agent to find it; don't ask the user for anything you could look up yourself. Don't block on it: a running exploration is an unsettled prerequisite, so only the questions downstream of it wait for the sub-agent to report; ask the rest of the frontier now. The _decisions_ are the user's: put each to them and wait.
+
+The session is done when the frontier is empty: every branch of the design tree visited, nothing left silently assumed. Do not act on it until the user confirms you 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-10-16
-**Commit:** 0b556f5f
+**Generated:** 2026-10-17
+**Commit:** b207e882
 **Branch:** main
-**Version:** 0.27.1.0
+**Version:** 0.27.3.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-10-16
-**Commit:** 0b556f5f
+**Generated:** 2026-10-17
+**Commit:** b207e882
 **Branch:** main
-**Version:** 0.27.1.0
+**Version:** 0.27.3.0
 
 ## OVERVIEW
 Test-Specification Alignment Engine — two-stage validation ensuring tests accurately reflect requirements and design specs.

package/plugins/dsh/lib/command.d.ts

@@ -0,0 +1,32 @@
+import { type ShellDialect } from "./dialect.js";
+export { type ShellDialect, detectDialect, shellQuote, shq } from "./dialect.js";
+/** Shown when the global `xp-gate` CLI is not on PATH. */
+export declare const FALLBACK_MESSAGE = "[XP-Gate] xp-gate CLI not installed. Install it with: npm install -g @boyingliu01/xp-gate";
+/**
+ * Allowlist of xp-gate gate aliases that are safe to invoke standalone
+ * (non-preCommitOnly gates + common aliases). Anything outside this set is
+ * rejected before reaching the shell.
+ */
+export declare const GATE_WHITELIST: readonly ["duplicates", "complexity", "principles", "arch", "architecture", "iac", "secrets", "sast"];
+export type GateId = (typeof GATE_WHITELIST)[number];
+export declare function isGateAllowed(gate: string): boolean;
+export interface BuildCommandOptions {
+    subcommand: "check" | "principles" | "arch";
+    target?: string;
+    gates?: readonly string[];
+    config?: string;
+    /**
+     * Executor dialect. Defaults to `"posix"` so existing callers keep working;
+     * callers running under DSH on Windows must pass `"powershell"`.
+     */
+    dialect?: ShellDialect;
+}
+/**
+ * Build a single guarded shell command: runs `xp-gate …` when the global CLI
+ * is present, otherwise prints the graceful-degradation hint. A single
+ * presence check avoids a separate probe/run race.
+ */
+export declare function buildCommand(options: BuildCommandOptions): string;
+/** Resolve a model-supplied path against the session cwd; absolutes pass through. */
+export declare function resolveTarget(rawPath: string, cwd: string): string;
+//# sourceMappingURL=command.d.ts.map

package/plugins/dsh/lib/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,YAAY,EAAc,MAAM,cAAc,CAAA;AAI5D,OAAO,EAAE,KAAK,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAEhF,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,8FACgE,CAAA;AAE7F;;;;GAIG;AACH,eAAO,MAAM,cAAc,uGASjB,CAAA;AAEV,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,GAAG,YAAY,GAAG,MAAM,CAAA;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB;AA+BD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAmBjE;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAElE"}