@vibecheckai/cli 3.2.5 → 3.3.0

package/bin/runners/lib/contracts/guard.js

@@ -1,168 +1,168 @@
-/**
- * Contract Guard
- * Validates code against contracts - CI gate functionality
- */
-
-"use strict";
-
-const fs = require("fs");
-const path = require("path");
-const { validateAgainstRouteContract } = require("./route-contract");
-const { validateAgainstEnvContract } = require("./env-contract");
-const { validateAuthContract } = require("./auth-contract");
-const { validateExternalContract } = require("./external-contract");
-
-/**
- * Load contracts from .vibecheck/contracts/
- */
-function loadContracts(repoRoot) {
-  const contractDir = path.join(repoRoot, ".vibecheck", "contracts");
-  const contracts = {};
-
-  const files = {
-    routes: "routes.json",
-    env: "env.json",
-    auth: "auth.json",
-    external: "external.json"
-  };
-
-  for (const [key, file] of Object.entries(files)) {
-    const filePath = path.join(contractDir, file);
-    if (fs.existsSync(filePath)) {
-      try {
-        contracts[key] = JSON.parse(fs.readFileSync(filePath, "utf8"));
-      } catch (e) {
-        console.warn(`Warning: Could not parse ${file}: ${e.message}`);
-      }
-    }
-  }
-
-  return contracts;
-}
-
-/**
- * Save contracts to .vibecheck/contracts/
- */
-function saveContracts(repoRoot, contracts) {
-  const contractDir = path.join(repoRoot, ".vibecheck", "contracts");
-  fs.mkdirSync(contractDir, { recursive: true });
-
-  const files = {
-    routes: "routes.json",
-    env: "env.json",
-    auth: "auth.json",
-    external: "external.json"
-  };
-
-  for (const [key, file] of Object.entries(files)) {
-    if (contracts[key]) {
-      const filePath = path.join(contractDir, file);
-      fs.writeFileSync(filePath, JSON.stringify(contracts[key], null, 2), "utf8");
-    }
-  }
-}
-
-/**
- * Guard: Validate current code against contracts
- */
-function guardContracts(contracts, truthpack, options = {}) {
-  const violations = [];
-
-  // Route contract validation
-  if (contracts.routes && truthpack?.routes?.clientRefs) {
-    const routeViolations = validateAgainstRouteContract(
-      contracts.routes,
-      truthpack.routes.clientRefs
-    );
-    violations.push(...routeViolations);
-  }
-
-  // Env contract validation
-  if (contracts.env && truthpack?.env?.vars) {
-    const envViolations = validateAgainstEnvContract(
-      contracts.env,
-      truthpack.env.vars
-    );
-    violations.push(...envViolations);
-  }
-
-  // Auth contract validation
-  if (contracts.auth && truthpack?.routes?.server) {
-    const authViolations = validateAuthContract(
-      contracts.auth,
-      truthpack.routes.server,
-      options.realityResults
-    );
-    violations.push(...authViolations);
-  }
-
-  // External contract validation
-  if (contracts.external) {
-    const externalViolations = validateExternalContract(contracts.external);
-    violations.push(...externalViolations);
-  }
-
-  return {
-    valid: violations.filter(v => v.severity === "BLOCK").length === 0,
-    violations,
-    blocks: violations.filter(v => v.severity === "BLOCK"),
-    warns: violations.filter(v => v.severity === "WARN")
-  };
-}
-
-/**
- * Get guard summary for CI output
- */
-function getGuardSummary(guardResult) {
-  const { valid, blocks, warns } = guardResult;
-
-  return {
-    verdict: valid ? (warns.length ? "WARN" : "PASS") : "BLOCK",
-    exitCode: valid ? (warns.length ? 1 : 0) : 2,
-    summary: {
-      blocks: blocks.length,
-      warns: warns.length,
-      total: blocks.length + warns.length
-    },
-    violations: guardResult.violations
-  };
-}
-
-/**
- * Format guard result for console output
- */
-function formatGuardResult(guardResult) {
-  const lines = [];
-  const { violations, blocks, warns } = guardResult;
-
-  if (violations.length === 0) {
-    lines.push("✓ All contracts satisfied");
-    return lines.join("\n");
-  }
-
-  if (blocks.length > 0) {
-    lines.push(`\n🛑 BLOCKS (${blocks.length}):`);
-    for (const v of blocks) {
-      lines.push(`  ✗ [${v.type}] ${v.message}`);
-      if (v.route) lines.push(`    Route: ${v.route}`);
-      if (v.name) lines.push(`    Var: ${v.name}`);
-    }
-  }
-
-  if (warns.length > 0) {
-    lines.push(`\n⚠️ WARNINGS (${warns.length}):`);
-    for (const v of warns) {
-      lines.push(`  ⚠ [${v.type}] ${v.message}`);
-    }
-  }
-
-  return lines.join("\n");
-}
-
-module.exports = {
-  loadContracts,
-  saveContracts,
-  guardContracts,
-  getGuardSummary,
-  formatGuardResult
-};
+/**
+ * Contract Guard
+ * Validates code against contracts - CI gate functionality
+ */
+
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const { validateAgainstRouteContract } = require("./route-contract");
+const { validateAgainstEnvContract } = require("./env-contract");
+const { validateAuthContract } = require("./auth-contract");
+const { validateExternalContract } = require("./external-contract");
+
+/**
+ * Load contracts from .vibecheck/contracts/
+ */
+function loadContracts(repoRoot) {
+  const contractDir = path.join(repoRoot, ".vibecheck", "contracts");
+  const contracts = {};
+
+  const files = {
+    routes: "routes.json",
+    env: "env.json",
+    auth: "auth.json",
+    external: "external.json"
+  };
+
+  for (const [key, file] of Object.entries(files)) {
+    const filePath = path.join(contractDir, file);
+    if (fs.existsSync(filePath)) {
+      try {
+        contracts[key] = JSON.parse(fs.readFileSync(filePath, "utf8"));
+      } catch (e) {
+        console.warn(`Warning: Could not parse ${file}: ${e.message}`);
+      }
+    }
+  }
+
+  return contracts;
+}
+
+/**
+ * Save contracts to .vibecheck/contracts/
+ */
+function saveContracts(repoRoot, contracts) {
+  const contractDir = path.join(repoRoot, ".vibecheck", "contracts");
+  fs.mkdirSync(contractDir, { recursive: true });
+
+  const files = {
+    routes: "routes.json",
+    env: "env.json",
+    auth: "auth.json",
+    external: "external.json"
+  };
+
+  for (const [key, file] of Object.entries(files)) {
+    if (contracts[key]) {
+      const filePath = path.join(contractDir, file);
+      fs.writeFileSync(filePath, JSON.stringify(contracts[key], null, 2), "utf8");
+    }
+  }
+}
+
+/**
+ * Guard: Validate current code against contracts
+ */
+function guardContracts(contracts, truthpack, options = {}) {
+  const violations = [];
+
+  // Route contract validation
+  if (contracts.routes && truthpack?.routes?.clientRefs) {
+    const routeViolations = validateAgainstRouteContract(
+      contracts.routes,
+      truthpack.routes.clientRefs
+    );
+    violations.push(...routeViolations);
+  }
+
+  // Env contract validation
+  if (contracts.env && truthpack?.env?.vars) {
+    const envViolations = validateAgainstEnvContract(
+      contracts.env,
+      truthpack.env.vars
+    );
+    violations.push(...envViolations);
+  }
+
+  // Auth contract validation
+  if (contracts.auth && truthpack?.routes?.server) {
+    const authViolations = validateAuthContract(
+      contracts.auth,
+      truthpack.routes.server,
+      options.realityResults
+    );
+    violations.push(...authViolations);
+  }
+
+  // External contract validation
+  if (contracts.external) {
+    const externalViolations = validateExternalContract(contracts.external);
+    violations.push(...externalViolations);
+  }
+
+  return {
+    valid: violations.filter(v => v.severity === "BLOCK").length === 0,
+    violations,
+    blocks: violations.filter(v => v.severity === "BLOCK"),
+    warns: violations.filter(v => v.severity === "WARN")
+  };
+}
+
+/**
+ * Get guard summary for CI output
+ */
+function getGuardSummary(guardResult) {
+  const { valid, blocks, warns } = guardResult;
+
+  return {
+    verdict: valid ? (warns.length ? "WARN" : "PASS") : "BLOCK",
+    exitCode: valid ? (warns.length ? 1 : 0) : 2,
+    summary: {
+      blocks: blocks.length,
+      warns: warns.length,
+      total: blocks.length + warns.length
+    },
+    violations: guardResult.violations
+  };
+}
+
+/**
+ * Format guard result for console output
+ */
+function formatGuardResult(guardResult) {
+  const lines = [];
+  const { violations, blocks, warns } = guardResult;
+
+  if (violations.length === 0) {
+    lines.push("✓ All contracts satisfied");
+    return lines.join("\n");
+  }
+
+  if (blocks.length > 0) {
+    lines.push(`\n🛑 BLOCKS (${blocks.length}):`);
+    for (const v of blocks) {
+      lines.push(`  ✗ [${v.type}] ${v.message}`);
+      if (v.route) lines.push(`    Route: ${v.route}`);
+      if (v.name) lines.push(`    Var: ${v.name}`);
+    }
+  }
+
+  if (warns.length > 0) {
+    lines.push(`\n⚠️ WARNINGS (${warns.length}):`);
+    for (const v of warns) {
+      lines.push(`  ⚠ [${v.type}] ${v.message}`);
+    }
+  }
+
+  return lines.join("\n");
+}
+
+module.exports = {
+  loadContracts,
+  saveContracts,
+  guardContracts,
+  getGuardSummary,
+  formatGuardResult
+};

package/bin/runners/lib/contracts/index.js

@@ -1,89 +1,89 @@
-/**
- * Context Contracts - Module Index
- * 
- * Exports all contract functionality for CLI and MCP use
- */
-
-"use strict";
-
-const { buildRouteContract, validateAgainstRouteContract, diffRouteContracts } = require("./route-contract");
-const { buildEnvContract, validateAgainstEnvContract, diffEnvContracts } = require("./env-contract");
-const { buildAuthContract, validateAuthContract, diffAuthContracts } = require("./auth-contract");
-const { buildExternalContract, validateExternalContract, diffExternalContracts } = require("./external-contract");
-const { loadContracts, saveContracts, guardContracts, getGuardSummary, formatGuardResult } = require("./guard");
-const { validatePlan, parsePlanActions, formatValidationResult } = require("./plan-validator");
-
-/**
- * Build all contracts from truthpack
- */
-function buildAllContracts(truthpack) {
-  return {
-    routes: buildRouteContract(truthpack),
-    env: buildEnvContract(truthpack),
-    auth: buildAuthContract(truthpack),
-    external: buildExternalContract(truthpack)
-  };
-}
-
-/**
- * Diff all contracts
- */
-function diffAllContracts(before, after) {
-  return {
-    routes: before.routes && after.routes ? diffRouteContracts(before.routes, after.routes) : null,
-    env: before.env && after.env ? diffEnvContracts(before.env, after.env) : null,
-    auth: before.auth && after.auth ? diffAuthContracts(before.auth, after.auth) : null,
-    external: before.external && after.external ? diffExternalContracts(before.external, after.external) : null
-  };
-}
-
-/**
- * Check if contracts have meaningful changes
- */
-function hasContractChanges(diff) {
-  if (!diff) return false;
-  
-  const checkDiff = (d) => {
-    if (!d) return false;
-    return (d.added?.length > 0) || (d.removed?.length > 0) || (d.changed?.length > 0) ||
-           (d.protectedAdded?.length > 0) || (d.protectedRemoved?.length > 0);
-  };
-
-  return checkDiff(diff.routes) || checkDiff(diff.env) || 
-         checkDiff(diff.auth) || checkDiff(diff.external);
-}
-
-module.exports = {
-  // Contract builders
-  buildRouteContract,
-  buildEnvContract,
-  buildAuthContract,
-  buildExternalContract,
-  buildAllContracts,
-  
-  // Contract validation
-  validateAgainstRouteContract,
-  validateAgainstEnvContract,
-  validateAuthContract,
-  validateExternalContract,
-  
-  // Contract diffing
-  diffRouteContracts,
-  diffEnvContracts,
-  diffAuthContracts,
-  diffExternalContracts,
-  diffAllContracts,
-  hasContractChanges,
-  
-  // Guard (CI gate)
-  loadContracts,
-  saveContracts,
-  guardContracts,
-  getGuardSummary,
-  formatGuardResult,
-  
-  // Plan validation (hallucination stopper)
-  validatePlan,
-  parsePlanActions,
-  formatValidationResult
-};
+/**
+ * Context Contracts - Module Index
+ * 
+ * Exports all contract functionality for CLI and MCP use
+ */
+
+"use strict";
+
+const { buildRouteContract, validateAgainstRouteContract, diffRouteContracts } = require("./route-contract");
+const { buildEnvContract, validateAgainstEnvContract, diffEnvContracts } = require("./env-contract");
+const { buildAuthContract, validateAuthContract, diffAuthContracts } = require("./auth-contract");
+const { buildExternalContract, validateExternalContract, diffExternalContracts } = require("./external-contract");
+const { loadContracts, saveContracts, guardContracts, getGuardSummary, formatGuardResult } = require("./guard");
+const { validatePlan, parsePlanActions, formatValidationResult } = require("./plan-validator");
+
+/**
+ * Build all contracts from truthpack
+ */
+function buildAllContracts(truthpack) {
+  return {
+    routes: buildRouteContract(truthpack),
+    env: buildEnvContract(truthpack),
+    auth: buildAuthContract(truthpack),
+    external: buildExternalContract(truthpack)
+  };
+}
+
+/**
+ * Diff all contracts
+ */
+function diffAllContracts(before, after) {
+  return {
+    routes: before.routes && after.routes ? diffRouteContracts(before.routes, after.routes) : null,
+    env: before.env && after.env ? diffEnvContracts(before.env, after.env) : null,
+    auth: before.auth && after.auth ? diffAuthContracts(before.auth, after.auth) : null,
+    external: before.external && after.external ? diffExternalContracts(before.external, after.external) : null
+  };
+}
+
+/**
+ * Check if contracts have meaningful changes
+ */
+function hasContractChanges(diff) {
+  if (!diff) return false;
+  
+  const checkDiff = (d) => {
+    if (!d) return false;
+    return (d.added?.length > 0) || (d.removed?.length > 0) || (d.changed?.length > 0) ||
+           (d.protectedAdded?.length > 0) || (d.protectedRemoved?.length > 0);
+  };
+
+  return checkDiff(diff.routes) || checkDiff(diff.env) || 
+         checkDiff(diff.auth) || checkDiff(diff.external);
+}
+
+module.exports = {
+  // Contract builders
+  buildRouteContract,
+  buildEnvContract,
+  buildAuthContract,
+  buildExternalContract,
+  buildAllContracts,
+  
+  // Contract validation
+  validateAgainstRouteContract,
+  validateAgainstEnvContract,
+  validateAuthContract,
+  validateExternalContract,
+  
+  // Contract diffing
+  diffRouteContracts,
+  diffEnvContracts,
+  diffAuthContracts,
+  diffExternalContracts,
+  diffAllContracts,
+  hasContractChanges,
+  
+  // Guard (CI gate)
+  loadContracts,
+  saveContracts,
+  guardContracts,
+  getGuardSummary,
+  formatGuardResult,
+  
+  // Plan validation (hallucination stopper)
+  validatePlan,
+  parsePlanActions,
+  formatValidationResult
+};