@boyingliu01/xp-gate 0.15.5 → 0.18.0

package/lib/gate-runner.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const { execSync, execFileSync } = require('child_process');
+const { execSync, execFileSync, spawnSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
 
@@ -28,6 +28,54 @@ function runBashScript(scriptPath) {
 // Gate metadata registry — maps gate IDs to names, descriptions, and how to run them.
 // Standalone gates (<gate-id>: { run }) are invokable via xp-gate gate-<id>.
 // Pre-commit-only gates (<gate-id>: { preCommitOnly: true }) run only in git commit context.
+
+/**
+ * Run a TypeScript gate module via npx tsx.
+ * Finds the .ts entry point, spawns tsx with --run flag.
+ * Falls back to bash script if TypeScript module not found.
+ */
+function runTsGate(gateModule, targetPath) {
+  const entry = findTsGateEntry(gateModule);
+  if (!entry) {
+    // Fallback to bash script
+    const script = resolveGateScript(gateModule.replace('gate-', ''));
+    if (script) {
+      runBashScript(script);
+    } else {
+      console.log(`Gate ${gateModule}: TypeScript module not found and no bash fallback available.`);
+    }
+    return 0;
+  }
+
+  const args = ['-y', 'tsx', entry, '--run'];
+  if (targetPath) args.push('--cwd', targetPath);
+
+  const result = spawnSync('npx', args, {
+    stdio: 'inherit',
+    shell: process.platform === 'win32',
+    cwd: targetPath || process.cwd(),
+    timeout: 120000,
+  });
+
+  return result.status === null ? 1 : result.status;
+}
+
+function findTsGateEntry(gateModule) {
+  const candidates = [
+    // Development layout
+    path.resolve(__dirname, '..', '..', '..', 'src', 'gates', `${gateModule}.ts`),
+    // npm package bundled layout
+    path.resolve(__dirname, '..', 'gates', `${gateModule}.ts`),
+    // node_modules install
+    path.resolve(__dirname, '..', '..', 'src', 'gates', `${gateModule}.ts`),
+    // Repo root
+    path.resolve(process.cwd(), 'src', 'gates', `${gateModule}.ts`),
+  ];
+  for (const c of candidates) {
+    if (fs.existsSync(c)) return c;
+  }
+  return null;
+}
 const GATE_REGISTRY = {
   '0': {
     name: 'Version Consistency',
@@ -59,14 +107,7 @@ const GATE_REGISTRY = {
     description: 'lizard cyclomatic complexity analysis',
     aliases: ['complexity', 'ccn', '3'],
     run: (targetPath) => {
-      const script = resolveGateScript('3');
-      if (script) {
-        runBashScript(script);
-      } else {
-        const target = targetPath || '.';
-        console.log(`Running lizard on ${target}...`);
-        execFileSync('lizard', [target, '--CCN', '10', '--length', '50', '--arguments', '5', '--warnings_only'], { stdio: 'inherit', shell: true });
-      }
+      return runTsGate('gate-3', targetPath);
     },
   },
   '4': {
@@ -99,13 +140,7 @@ const GATE_REGISTRY = {
     description: 'Infrastructure-as-Code security scanning (checkov, hadolint, kube-score, tflint)',
     aliases: ['iac', 'infra', '7'],
     run: (targetPath) => {
-      const script = resolveGateScript('7');
-      if (script) {
-        runBashScript(script);
-      } else {
-        console.log('IaC security scan requires git-staged context for changed files detection.');
-        console.log('Run: git commit to trigger Gate 7 automatically.');
-      }
+      return runTsGate('gate-7', targetPath);
     },
   },
   '8': {
@@ -113,13 +148,7 @@ const GATE_REGISTRY = {
     description: 'gitleaks secret and credential detection',
     aliases: ['secrets', 'secret', '8'],
     run: (targetPath) => {
-      const script = resolveGateScript('8');
-      if (script) {
-        runBashScript(script);
-      } else {
-        console.log('Secret scanning requires git-staged context for changed files detection.');
-        console.log('Run: git commit to trigger Gate 8 automatically.');
-      }
+      return runTsGate('gate-8', targetPath);
     },
   },
   '9': {
@@ -127,13 +156,7 @@ const GATE_REGISTRY = {
     description: 'semgrep static application security testing',
     aliases: ['sast', 'semgrep', '9'],
     run: (targetPath) => {
-      const script = resolveGateScript('9');
-      if (script) {
-        runBashScript(script);
-      } else {
-        console.log('SAST scanning requires git-staged context for changed files detection.');
-        console.log('Run: git commit to trigger Gate 9 automatically.');
-      }
+      return runTsGate('gate-9', targetPath);
     },
   },
   '10': {
@@ -150,6 +173,30 @@ const GATE_REGISTRY = {
     preCommitOnly: true,
     reason: 'Requires sprint state (.sprint-state/) and git branch context',
   },
+  'python-health': {
+    name: 'Python Environment Health',
+    description: 'Comprehensive Python environment diagnostics',
+    aliases: ['python-health', 'py-health'],
+    run: (targetPath) => {
+      return runTsGate('python-health', targetPath);
+    },
+  },
+  'test-layers': {
+    name: 'Test Layer Analytics',
+    description: 'Report test distribution across unit/integration/e2e layers',
+    aliases: ['test-layers', 'layers', 'test-analytics'],
+    run: (targetPath) => {
+      return runTsGate('test-layers', targetPath);
+    },
+  },
+  'pbt': {
+    name: 'Property-Based Testing Detection',
+    description: 'Detect PBT framework usage and report coverage',
+    aliases: ['pbt', 'pbt-detect', 'property-based-testing'],
+    run: (targetPath) => {
+      return runTsGate('pbt-detect', targetPath);
+    },
+  },
 };
 
 // Reverse-lookup: alias → gate ID (built once at module load)

package/lib/init.js

@@ -318,6 +318,7 @@ async function init(args) {
   console.log('====================\n');
 
   // Check bash availability (required for shell hooks)
+  console.log('Checking bash availability...');
   const bashCheck = checkBash();
   if (bashCheck.ok) {
     console.log(`Bash: ✓ ${bashCheck.path} (v${bashCheck.version})\n`);
@@ -327,8 +328,10 @@ async function init(args) {
   }
 
   // Check CLI tools availability (quality gates will SKIP silently if tools are missing)
+  console.log('Checking CLI tools...');
   printCliToolStatus();
 
+  console.log('Checking platform dependencies...');
   // Detect platform and check/auto-install dependencies
   const platform = detectPlatform();
   console.log(`Platform: ${platform}\n`);
@@ -534,18 +537,22 @@ async function setupGlobal(args) {
   console.log(`Global hooks: ${GLOBAL_HOOKS_DIR}`);
   console.log(`Global adapters: ${GLOBAL_ADAPTERS_DIR}\n`);
 
+  console.log('[setup-global] Creating global directories...');
   fs.mkdirSync(GLOBAL_HOOKS_DIR, { recursive: true });
   fs.mkdirSync(GLOBAL_ADAPTERS_DIR, { recursive: true });
 
+  console.log('[setup-global] Installing git hooks...');
   copyHooks(srcDir, GLOBAL_HOOKS_DIR);
   console.log('Installing hooks...');
   console.log(`  pre-commit -> ${GLOBAL_HOOKS_DIR}`);
   console.log(`  pre-push -> ${GLOBAL_HOOKS_DIR}`);
 
+  console.log('[setup-global] Installing adapters...');
   copyAdapters(srcDir, GLOBAL_ADAPTERS_DIR);
   console.log(`  adapter-common.sh + adapters -> ${GLOBAL_ADAPTERS_DIR}`);
 
   // Install principles/, mutation/, mock-policy/ to global modules dir
+  console.log('[setup-global] Installing quality gate modules...');
   const globalModulesDir = path.join(CONFIG_DIR, 'modules');
   ['principles', 'mutation', 'mock-policy'].forEach(module => {
     const moduleSrc = path.join(srcDir, module);
@@ -557,6 +564,7 @@ async function setupGlobal(args) {
     }
   });
 
+  console.log('[setup-global] Configuring git...');
   const { execSync } = require('child_process');
   try {
     execSync(`git config --global core.hooksPath "${GLOBAL_HOOKS_DIR}"`);
@@ -567,6 +575,7 @@ async function setupGlobal(args) {
 
   ensureConfigDir();
 
+  console.log('[setup-global] Generating installation manifest...');
   const manifest = generateGlobalManifest(srcDir);
   updateConfig({ lastInit: new Date().toISOString(), mode: 'global', templateDir: TEMPLATE_DIR, manifest });
 
@@ -581,6 +590,7 @@ async function setupGlobal(args) {
   console.log('Per-project adapters can still override by creating <repo>/githooks/');
 
   // Auto-install missing CLI tools (prompt user)
+  console.log('[setup-global] Checking quality gate CLI tools...');
   const autoYes = args.includes('--yes') || args.includes('--auto-install');
   await promptBootstrap(autoYes);