vibecheck-ai 2.0.2 → 5.0.0

package/bin/.generated

@@ -0,0 +1,25 @@
+================================================================================
+⚠️  GENERATED CODE - DO NOT EDIT
+================================================================================
+
+This directory contains GENERATED build output.
+
+All JavaScript files here are compiled from TypeScript sources.
+Manual edits will be OVERWRITTEN on the next build.
+
+SOURCE OF TRUTH:
+  packages/cli/src/           TypeScript CLI source
+  packages/cli/src/commands/  Command implementations
+  packages/cli/src/index.ts   Main entry point
+
+TO MAKE CHANGES:
+  1. Edit the TypeScript source in packages/cli/src/
+  2. Run: pnpm build
+  3. Changes will be reflected here automatically
+
+BUILD COMMAND:
+  pnpm --filter @vibecheck/cli build
+
+================================================================================
+Generated: 2026-01-17
+================================================================================

package/bin/_deprecations.js

@@ -0,0 +1,463 @@
+/**
+ * CLI Command Deprecation System
+ * 
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * ENTERPRISE-GRADE DEPRECATION MANAGEMENT
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * 
+ * Manages deprecation warnings for renamed commands in v4.0+.
+ * Features:
+ *   - One-time warnings per user per version (cached)
+ *   - Configurable via environment variables
+ *   - Machine-readable JSON output for CI
+ *   - Graceful degradation on cache failures
+ * 
+ * Environment Variables:
+ *   VIBECHECK_SILENCE_DEPRECATIONS=1  - Suppress all deprecation warnings
+ *   VIBECHECK_DEPRECATION_JSON=1      - Output warnings as JSON
+ * 
+ * @module _deprecations
+ * @version 4.0.0
+ * @license MIT
+ */
+
+"use strict";
+
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// DEPRECATION MAP
+// Maps old command names to their new canonical equivalents
+// ═══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * Mapping of deprecated commands to their replacements
+ * @type {Object.<string, string>}
+ */
+const DEPRECATION_MAP = {
+  // ─────────────────────────────────────────────────────────────
+  // Setup Commands
+  // ─────────────────────────────────────────────────────────────
+  "init": "link",
+  "setup": "link",
+  "configure": "link",
+  "quickstart": "kickoff",
+  "qs": "kickoff",
+  "start": "kickoff",
+  "onboard": "kickoff",
+  
+  // ─────────────────────────────────────────────────────────────
+  // Truth/Context Commands
+  // ─────────────────────────────────────────────────────────────
+  "context": "forge",
+  "ctx": "forge",
+  "rules": "forge",
+  "ai-rules": "forge",
+  "mdc": "forge",
+  
+  // ─────────────────────────────────────────────────────────────
+  // Analysis Commands
+  // ─────────────────────────────────────────────────────────────
+  "scan": "audit",
+  "check": "audit",
+  "s": "audit",
+  "classify": "audit",
+  "inventory": "audit",
+  
+  // ─────────────────────────────────────────────────────────────
+  // Auth Commands (now subcommands)
+  // ─────────────────────────────────────────────────────────────
+  "login": "auth login",
+  "logout": "auth logout",
+  "whoami": "auth whoami",
+  "signin": "auth login",
+  "signout": "auth logout",
+  "me": "auth whoami",
+  "user": "auth whoami",
+  
+  // ─────────────────────────────────────────────────────────────
+  // Enforcement Commands
+  // ─────────────────────────────────────────────────────────────
+  "guard": "shield",
+  "firewall": "shield",
+  "agent": "shield",
+  "ai-guard": "shield",
+  "validate": "shield verify",
+  
+  // ─────────────────────────────────────────────────────────────
+  // CI/CD Commands
+  // ─────────────────────────────────────────────────────────────
+  "gate": "launch",
+  "ci-gate": "launch",
+  "enforce": "launch",
+  "preflight": "launch",
+  "prelaunch": "launch",
+  
+  // ─────────────────────────────────────────────────────────────
+  // Config Commands
+  // ─────────────────────────────────────────────────────────────
+  "allowlist": "safelist",
+  "al": "safelist",
+  "suppress": "safelist",
+  
+  // ─────────────────────────────────────────────────────────────
+  // Artifact Commands (now subcommands of packs)
+  // ─────────────────────────────────────────────────────────────
+  "evidence-pack": "packs evidence",
+  "pack": "packs",
+  "bundle": "packs",
+  "report": "packs report",
+  "html": "packs report",
+  "artifact": "packs report",
+  
+  // ─────────────────────────────────────────────────────────────
+  // Output Commands
+  // ─────────────────────────────────────────────────────────────
+  "badge": "seal",
+  "attest": "seal",
+};
+
+/**
+ * Deprecation metadata with additional context
+ * @type {Object.<string, Object>}
+ */
+const DEPRECATION_METADATA = {
+  // Setup
+  "init": { reason: "Renamed for clarity", since: "4.0.0", removeIn: "5.0.0" },
+  "setup": { reason: "Renamed for clarity", since: "4.0.0", removeIn: "5.0.0" },
+  "configure": { reason: "Renamed for clarity", since: "4.0.0", removeIn: "5.0.0" },
+  "quickstart": { reason: "Renamed for clarity", since: "4.0.0", removeIn: "5.0.0" },
+  "qs": { reason: "Renamed for clarity", since: "4.0.0", removeIn: "5.0.0" },
+  "start": { reason: "Renamed for clarity", since: "4.0.0", removeIn: "5.0.0" },
+  "onboard": { reason: "Renamed for clarity", since: "4.0.0", removeIn: "5.0.0" },
+  
+  // Truth/Context
+  "context": { reason: "Renamed to 'forge' (AI Brain Generator)", since: "4.0.0", removeIn: "5.0.0" },
+  "ctx": { reason: "Renamed to 'forge' (AI Brain Generator)", since: "4.0.0", removeIn: "5.0.0" },
+  "rules": { reason: "Renamed to 'forge' (AI Brain Generator)", since: "4.0.0", removeIn: "5.0.0" },
+  "ai-rules": { reason: "Renamed to 'forge' (AI Brain Generator)", since: "4.0.0", removeIn: "5.0.0" },
+  "mdc": { reason: "Renamed to 'forge' (AI Brain Generator)", since: "4.0.0", removeIn: "5.0.0" },
+  
+  // Analysis
+  "scan": { reason: "Renamed to 'audit' (convincing wrongness detector)", since: "4.0.0", removeIn: "5.0.0" },
+  "check": { reason: "Renamed to 'audit'", since: "4.0.0", removeIn: "5.0.0" },
+  "s": { reason: "Renamed to 'audit'", since: "4.0.0", removeIn: "5.0.0" },
+  "classify": { reason: "Merged into 'audit'", since: "4.0.0", removeIn: "5.0.0" },
+  "inventory": { reason: "Merged into 'audit'", since: "4.0.0", removeIn: "5.0.0" },
+  
+  // Auth (subcommands)
+  "login": { reason: "Moved to 'auth login' subcommand", since: "4.0.0", removeIn: "5.0.0" },
+  "logout": { reason: "Moved to 'auth logout' subcommand", since: "4.0.0", removeIn: "5.0.0" },
+  "whoami": { reason: "Moved to 'auth whoami' subcommand", since: "4.0.0", removeIn: "5.0.0" },
+  "signin": { reason: "Moved to 'auth login' subcommand", since: "4.0.0", removeIn: "5.0.0" },
+  "signout": { reason: "Moved to 'auth logout' subcommand", since: "4.0.0", removeIn: "5.0.0" },
+  "me": { reason: "Moved to 'auth whoami' subcommand", since: "4.0.0", removeIn: "5.0.0" },
+  "user": { reason: "Moved to 'auth whoami' subcommand", since: "4.0.0", removeIn: "5.0.0" },
+  
+  // Enforcement
+  "guard": { reason: "Unified into 'shield' (Agent Firewall)", since: "4.0.0", removeIn: "5.0.0" },
+  "firewall": { reason: "Unified into 'shield' (Agent Firewall)", since: "4.0.0", removeIn: "5.0.0" },
+  "agent": { reason: "Unified into 'shield' (Agent Firewall)", since: "4.0.0", removeIn: "5.0.0" },
+  "ai-guard": { reason: "Unified into 'shield' (Agent Firewall)", since: "4.0.0", removeIn: "5.0.0" },
+  "validate": { reason: "Moved to 'shield verify' subcommand", since: "4.0.0", removeIn: "5.0.0" },
+  
+  // CI/CD
+  "gate": { reason: "Renamed to 'launch' (pre-release wizard)", since: "4.0.0", removeIn: "5.0.0" },
+  "ci-gate": { reason: "Renamed to 'launch' (pre-release wizard)", since: "4.0.0", removeIn: "5.0.0" },
+  "enforce": { reason: "Renamed to 'launch' (pre-release wizard)", since: "4.0.0", removeIn: "5.0.0" },
+  "preflight": { reason: "Renamed to 'launch' (pre-release wizard)", since: "4.0.0", removeIn: "5.0.0" },
+  "prelaunch": { reason: "Renamed to 'launch' (pre-release wizard)", since: "4.0.0", removeIn: "5.0.0" },
+  
+  // Config
+  "allowlist": { reason: "Renamed to 'safelist' (responsible suppression)", since: "4.0.0", removeIn: "5.0.0" },
+  "al": { reason: "Renamed to 'safelist'", since: "4.0.0", removeIn: "5.0.0" },
+  "suppress": { reason: "Renamed to 'safelist'", since: "4.0.0", removeIn: "5.0.0" },
+  
+  // Artifacts (subcommands)
+  "evidence-pack": { reason: "Moved to 'packs evidence' subcommand", since: "4.0.0", removeIn: "5.0.0" },
+  "pack": { reason: "Renamed to 'packs'", since: "4.0.0", removeIn: "5.0.0" },
+  "bundle": { reason: "Moved to 'packs bundle' subcommand", since: "4.0.0", removeIn: "5.0.0" },
+  "report": { reason: "Moved to 'packs report' subcommand", since: "4.0.0", removeIn: "5.0.0" },
+  "html": { reason: "Moved to 'packs report' subcommand", since: "4.0.0", removeIn: "5.0.0" },
+  "artifact": { reason: "Moved to 'packs report' subcommand", since: "4.0.0", removeIn: "5.0.0" },
+  
+  // Output
+  "badge": { reason: "Renamed to 'seal' (ship badge generator)", since: "4.0.0", removeIn: "5.0.0" },
+  "attest": { reason: "Renamed to 'seal' (ship badge generator)", since: "4.0.0", removeIn: "5.0.0" },
+};
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// CACHE MANAGEMENT
+// ═══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * Get the path to the deprecation cache file
+ * @returns {string} Cache file path
+ */
+function getCachePath() {
+  return path.join(os.homedir(), ".vibecheck", "deprecations.json");
+}
+
+/**
+ * Load the deprecation cache
+ * @returns {Object} Cache object
+ */
+function loadCache() {
+  try {
+    const cachePath = getCachePath();
+    if (fs.existsSync(cachePath)) {
+      return JSON.parse(fs.readFileSync(cachePath, "utf8"));
+    }
+  } catch {
+    // Cache is corrupted or inaccessible, return empty
+  }
+  return {};
+}
+
+/**
+ * Save to the deprecation cache
+ * @param {Object} cache - Cache object to save
+ * @returns {boolean} Success status
+ */
+function saveCache(cache) {
+  try {
+    const cachePath = getCachePath();
+    fs.mkdirSync(path.dirname(cachePath), { recursive: true });
+    fs.writeFileSync(cachePath, JSON.stringify(cache, null, 2));
+    return true;
+  } catch {
+    // Ignore cache write errors (permissions, disk full, etc.)
+    return false;
+  }
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// DEPRECATION WARNING FUNCTIONS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * Display a deprecation warning once per version
+ * 
+ * @param {string} legacyCommand - The deprecated command name
+ * @param {string} newCommand - The replacement command name
+ * @param {string} version - Current CLI version
+ * @returns {boolean} Whether the warning was shown
+ */
+function warnDeprecationOnce(legacyCommand, newCommand, version = "dev") {
+  // Early exit conditions
+  if (!legacyCommand || !newCommand) return false;
+  if (process.env.VIBECHECK_SILENCE_DEPRECATIONS === "1") return false;
+  
+  // Check cache
+  const cache = loadCache();
+  const cacheKey = `${legacyCommand}@${version}`;
+  
+  if (cache[cacheKey]) {
+    return false; // Already warned
+  }
+  
+  // Get metadata if available
+  const meta = DEPRECATION_METADATA[legacyCommand] || {};
+  
+  // Output format
+  if (process.env.VIBECHECK_DEPRECATION_JSON === "1") {
+    // JSON output for CI systems
+    const warning = {
+      type: "deprecation",
+      command: legacyCommand,
+      replacement: newCommand,
+      version,
+      since: meta.since,
+      removeIn: meta.removeIn,
+      reason: meta.reason,
+      timestamp: new Date().toISOString(),
+    };
+    process.stderr.write(JSON.stringify(warning) + "\n");
+  } else {
+    // Human-readable output with colors
+    const c = {
+      reset: "\x1b[0m",
+      bold: "\x1b[1m",
+      dim: "\x1b[2m",
+      yellow: "\x1b[33m",
+      cyan: "\x1b[36m",
+    };
+    
+    process.stderr.write(`
+${c.yellow}${c.bold}⚠ Deprecation Warning${c.reset}
+${c.dim}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${c.reset}
+  ${c.dim}Command:${c.reset}     ${c.yellow}vibecheck ${legacyCommand}${c.reset}
+  ${c.dim}Replacement:${c.reset} ${c.cyan}vibecheck ${newCommand}${c.reset}
+${meta.reason ? `  ${c.dim}Reason:${c.reset}      ${meta.reason}\n` : ""}${meta.removeIn ? `  ${c.dim}Remove in:${c.reset}   v${meta.removeIn}\n` : ""}
+  ${c.dim}Silence with: VIBECHECK_SILENCE_DEPRECATIONS=1${c.reset}
+${c.dim}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${c.reset}
+`);
+  }
+  
+  // Update cache
+  cache[cacheKey] = {
+    warned: new Date().toISOString(),
+    replacement: newCommand,
+  };
+  saveCache(cache);
+  
+  return true;
+}
+
+/**
+ * Check if a command is deprecated
+ * 
+ * @param {string} command - Command name to check
+ * @returns {boolean} True if deprecated
+ */
+function isDeprecatedCommand(command) {
+  return command in DEPRECATION_MAP;
+}
+
+/**
+ * Get the replacement for a deprecated command
+ * 
+ * @param {string} command - Deprecated command name
+ * @returns {string|null} Replacement command or null
+ */
+function getDeprecationReplacement(command) {
+  return DEPRECATION_MAP[command] || null;
+}
+
+/**
+ * Get deprecation metadata for a command
+ * 
+ * @param {string} command - Command name
+ * @returns {Object|null} Metadata object or null
+ */
+function getDeprecationMetadata(command) {
+  return DEPRECATION_METADATA[command] || null;
+}
+
+/**
+ * Convenience function: warn if deprecated and return replacement
+ * 
+ * @param {string} command - Command name to check
+ * @param {string} version - Current CLI version
+ * @returns {string|null} Replacement command if deprecated, null otherwise
+ */
+function warnIfDeprecated(command, version = "dev") {
+  const replacement = DEPRECATION_MAP[command];
+  if (replacement) {
+    warnDeprecationOnce(command, replacement, version);
+    return replacement;
+  }
+  return null;
+}
+
+/**
+ * Get all deprecated commands
+ * 
+ * @returns {Object.<string, string>} Map of deprecated commands to replacements
+ */
+function getAllDeprecations() {
+  return { ...DEPRECATION_MAP };
+}
+
+/**
+ * Get deprecation statistics from cache
+ * 
+ * @returns {Object} Statistics object
+ */
+function getDeprecationStats() {
+  const cache = loadCache();
+  const stats = {
+    totalWarnings: Object.keys(cache).length,
+    byCommand: {},
+    byVersion: {},
+    lastWarning: null,
+  };
+  
+  for (const [key, value] of Object.entries(cache)) {
+    const [command, version] = key.split("@");
+    
+    if (!stats.byCommand[command]) {
+      stats.byCommand[command] = 0;
+    }
+    stats.byCommand[command]++;
+    
+    if (!stats.byVersion[version]) {
+      stats.byVersion[version] = 0;
+    }
+    stats.byVersion[version]++;
+    
+    if (!stats.lastWarning || value.warned > stats.lastWarning) {
+      stats.lastWarning = value.warned;
+    }
+  }
+  
+  return stats;
+}
+
+/**
+ * Clear the deprecation cache
+ * Used for testing and reset scenarios
+ * 
+ * @returns {boolean} Success status
+ */
+function clearDeprecationCache() {
+  try {
+    const cachePath = getCachePath();
+    if (fs.existsSync(cachePath)) {
+      fs.unlinkSync(cachePath);
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Reset a specific deprecation warning
+ * 
+ * @param {string} command - Command to reset
+ * @param {string} version - Version to reset
+ * @returns {boolean} Success status
+ */
+function resetDeprecationWarning(command, version = "dev") {
+  try {
+    const cache = loadCache();
+    const key = `${command}@${version}`;
+    if (cache[key]) {
+      delete cache[key];
+      saveCache(cache);
+      return true;
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// EXPORTS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+module.exports = {
+  // Core deprecation map
+  DEPRECATION_MAP,
+  DEPRECATION_METADATA,
+  
+  // Warning functions
+  warnDeprecationOnce,
+  warnIfDeprecated,
+  
+  // Query functions
+  isDeprecatedCommand,
+  getDeprecationReplacement,
+  getDeprecationMetadata,
+  getAllDeprecations,
+  getDeprecationStats,
+  
+  // Cache management
+  clearDeprecationCache,
+  resetDeprecationWarning,
+  getCachePath,
+};

package/bin/_router.js

@@ -0,0 +1,46 @@
+const LEGACY_MAP = {
+  // ship is now first-class command, not legacy
+  // reality is now its own command - no longer routes to proof
+  mockproof: { to: ["proof", "mocks"] },
+  hygiene: { to: ["scan", "--only=hygiene"] },
+  security: { to: ["scan", "--only=security"] },
+  // auth is now a first-class command - use "scan --only=auth" for auth scanning
+  routes: { to: ["scan", "--only=routes"] },
+  api: { to: ["scan", "--only=contracts"] }, // rename internal concept to contracts
+  mock: { to: ["scan", "--only=mocks"] },
+};
+
+function routeArgv(argv) {
+  const args = argv.slice(2);
+  const first = args[0];
+
+  // Handle top-level flags that act as commands
+  if (first === "--version" || first === "-v") {
+    return { legacyFrom: null, routed: ["version"] };
+  }
+  if (first === "--help" || first === "-h") {
+    return { legacyFrom: null, routed: ["help"] };
+  }
+
+  // Default command if none
+  if (!first || first.startsWith("-")) {
+    return { legacyFrom: null, routed: ["scan", ...args] };
+  }
+
+  // Legacy alias handling
+  if (LEGACY_MAP[first]) {
+    const mapped = LEGACY_MAP[first].to;
+    const rest = args.slice(1);
+    return { legacyFrom: first, routed: [...mapped, ...rest] };
+  }
+
+  // validate logic
+  if (first === "validate") {
+    return { legacyFrom: null, routed: args };
+  }
+
+  // Already new-style
+  return { legacyFrom: null, routed: args };
+}
+
+module.exports = { routeArgv };