@boyingliu01/xp-gate 0.9.4 → 0.10.0

package/adapters/python.sh

@@ -101,4 +101,64 @@ run_coverage() {
   fi
 
   return $PYTEST_EXIT
-}
+}
+# ── Gate M: Python mutation testing (mutmut) ──
+
+run_mutation() {
+  local files_arg="$1"
+  local timeout_ms="${2:-120000}"
+  local timeout_s=$((timeout_ms / 1000))
+
+  if ! detect_python_mutation_testable; then
+    echo "⚠ mutmut not installed. SKIP — Gate M (Python)."
+    return 0
+  fi
+
+  # Parse comma-separated file list into mutmut --paths-to-mulate args
+  local file_list=""
+  IFS=',' read -ra FILE_ARRAY <<< "$files_arg"
+  for f in "${FILE_ARRAY[@]}"; do
+    f=$(echo "$f" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+    [ -f "$f" ] && file_list="$file_list $f"
+  done
+
+  if [ -z "$file_list" ]; then
+    echo "📚 No valid Python source files for mutation. SKIP — Gate M (Python)."
+    return 0
+  fi
+
+  echo "🐍 Running Python mutation testing (mutmut) on: $file_list"
+
+  # Gate M orchestrator (TypeScript) handles mutmut via MutmutRunner in src/mutation/runners/
+  # The shell adapter delegates to the TS runner for consistency with TS Gate M.
+  if [ -f "src/mutation/gate-m.ts" ]; then
+    timeout "${timeout_s}s" npx tsx src/mutation/gate-m.ts \
+      --changed-files "$files_arg" 2>&1
+    return $?
+  fi
+
+  # Fallback: direct mutmut CLI if TS gate module not available
+  local MUTATION_OUTPUT
+  MUTATION_OUTPUT=$(mktemp)
+
+  timeout "${timeout_s}s" mutmut run --paths-to-mutate $file_list > "$MUTATION_OUTPUT" 2>&1
+  local EXIT_CODE=$?
+
+  cat "$MUTATION_OUTPUT"
+  rm -f "$MUTATION_OUTPUT"
+
+  case $EXIT_CODE in
+    0)
+      echo "✅ Gate M (Python): PASS"
+      return 0
+      ;;
+    124)
+      echo "⏱ Gate M (Python): TIMEOUT (${timeout_s}s). Allowing push with warning."
+      return 0
+      ;;
+    *)
+      echo "❌ Gate M (Python): mutation score below threshold"
+      return 1
+      ;;
+  esac
+}

package/lib/doctor.js

@@ -386,21 +386,15 @@ function fixMissingAdapters(mode, srcDir, adaptersDir) {
   return false;
 }
 
-/**
- * Attempt to fix known issues.
- * Only operates when mode === 'active' (local or global).
- */
-function fixIssues(checks, config) {
-  console.log('');
-  console.log('Attempting fixes...');
-  console.log('-------------------');
-
-  const srcDir = PKG_DIR;
+function fixConfigMismatches(config) {
   let fixed = false;
-
   fixed = fixVersionMismatch(config, getPackageVersion()) || fixed;
   fixed = fixTemplateDirMismatch(config, getTemplateDir()) || fixed;
+  return fixed;
+}
 
+function fixHooksByMode(config, srcDir) {
+  let fixed = false;
   if (config.mode === 'local') {
     const gitDir = getGitDir();
     if (gitDir) {
@@ -410,18 +404,40 @@ function fixIssues(checks, config) {
   } else {
     fixed = fixMissingHooks('global', srcDir, GLOBAL_HOOKS_DIR) || fixed;
   }
+  return fixed;
+}
 
-  if (config.mode === 'global') {
-    const hooksPath = getCurrentHooksPath();
-    if (hooksPath !== GLOBAL_HOOKS_DIR) {
-      fixed = fixCoreHooksPath(GLOBAL_HOOKS_DIR) || fixed;
-    }
+function fixGlobalHooksPath(config) {
+  if (config.mode !== 'global') return false;
+  const hooksPath = getCurrentHooksPath();
+  if (hooksPath !== GLOBAL_HOOKS_DIR) {
+    return fixCoreHooksPath(GLOBAL_HOOKS_DIR);
   }
+  return false;
+}
 
-  const adaptersDir = config.mode === 'local'
+function getAdaptersDirByMode(config) {
+  return config.mode === 'local'
     ? path.join(path.dirname(getGitDir() || ''), 'githooks', 'adapters')
     : GLOBAL_ADAPTERS_DIR;
-  fixed = fixMissingAdapters(config.mode, srcDir, adaptersDir) || fixed;
+}
+
+/**
+ * Attempt to fix known issues.
+ * Only operates when mode === 'active' (local or global).
+ */
+function fixIssues(checks, config) {
+  console.log('');
+  console.log('Attempting fixes...');
+  console.log('-------------------');
+
+  const srcDir = PKG_DIR;
+  let fixed = false;
+
+  fixed = fixConfigMismatches(config) || fixed;
+  fixed = fixHooksByMode(config, srcDir) || fixed;
+  fixed = fixGlobalHooksPath(config) || fixed;
+  fixed = fixMissingAdapters(config.mode, srcDir, getAdaptersDirByMode(config)) || fixed;
 
   if (!fixed) {
     console.log('  No fixable issues found.');

package/lib/shared-phase-constants.js

@@ -24,6 +24,27 @@ const PHASE_NAMES = {
 
 const PHASE_ORDER = ['-1', '-0.5', '0', '1', '2', '3', '4', '5', '6', '7', '8'];
 
+/**
+ * Safely parse a date-like value into epoch ms.
+ * @param {*} value - Timestamp to parse
+ * @returns {number} Epoch ms, or NaN if invalid
+ */
+function parseTime(value) {
+  return new Date(value).getTime();
+}
+
+/**
+ * Get the max of an existing value and a new timestamp (if valid and larger).
+ * @param {number} current - Current best value
+ * @param {*} candidate - Candidate timestamp
+ * @returns {number} Max value
+ */
+function maxValid(current, candidate) {
+  if (!candidate) return current;
+  const t = parseTime(candidate);
+  return !isNaN(t) && t > current ? t : current;
+}
+
 /**
  * Find the most recent timestamp across started_at and phase_history.
  * @param {object} state - Sprint state object
@@ -31,19 +52,12 @@ const PHASE_ORDER = ['-1', '-0.5', '0', '1', '2', '3', '4', '5', '6', '7', '8'];
  */
 function getLatestTimestamp(state) {
   if (!state || !state.started_at) return 0;
-  const started = new Date(state.started_at).getTime();
+  const started = parseTime(state.started_at);
   if (isNaN(started)) return 0;
   let latest = started;
   if (Array.isArray(state.phase_history)) {
     for (const ph of state.phase_history) {
-      if (ph.completed_at) {
-        const t = new Date(ph.completed_at).getTime();
-        if (!isNaN(t) && t > latest) latest = t;
-      }
-      if (ph.started_at) {
-        const t = new Date(ph.started_at).getTime();
-        if (!isNaN(t) && t > latest) latest = t;
-      }
+      latest = maxValid(maxValid(latest, ph.completed_at), ph.started_at);
     }
   }
   return latest;

package/mock-policy/AGENTS.md

@@ -1,9 +1,9 @@
 # SRC/MOCK-POLICY KNOWLEDGE BASE
 
-**Generated:** 2026-06-19
-**Commit:** b67f7f9
+**Generated:** 2026-06-22
+**Commit:** 984d568
 **Branch:** main
-**Version:** 0.9.4.0
+**Version:** 0.10.0.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-06-19
-**Commit:** b67f7f9
+**Generated:** 2026-06-22
+**Commit:** 984d568
 **Branch:** main
-**Version:** 0.9.4.0
+**Version:** 0.10.0.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.