@vibecheckai/cli 3.1.0 → 3.1.1

package/bin/runners/lib/cli-output.js

@@ -1,368 +1,368 @@
-/**
- * CLI Output Utilities - World-Class Consistency
- * 
- * Provides standardized JSON output, run ID generation,
- * and artifact management for all CLI commands.
- */
-
-"use strict";
-
-const fs = require("fs");
-const path = require("path");
-const crypto = require("crypto");
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// RUN ID GENERATION
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Generate a unique run ID for tracking
- */
-function generateRunId() {
-  return crypto.randomUUID();
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// OUTPUT DIRECTORY MANAGEMENT
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Get run directory paths
- */
-function getRunPaths(runId, projectPath = process.cwd()) {
-  const runDir = path.join(projectPath, ".vibecheck", "runs", runId);
-  const artifactsDir = path.join(runDir, "artifacts");
-  
-  // Ensure directories exist
-  if (!fs.existsSync(runDir)) fs.mkdirSync(runDir, { recursive: true });
-  if (!fs.existsSync(artifactsDir)) fs.mkdirSync(artifactsDir, { recursive: true });
-  
-  return {
-    runDir,
-    artifactsDir,
-    manifestPath: path.join(runDir, "manifest.json"),
-    commandPath: path.join(runDir, "command.json"),
-  };
-}
-
-/**
- * Save artifact to run directory
- */
-function saveArtifact(runId, name, data, type = "json") {
-  const { artifactsDir } = getRunPaths(runId);
-  const artifactPath = path.join(artifactsDir, `${name}.${type}`);
-  
-  if (type === "json") {
-    fs.writeFileSync(artifactPath, JSON.stringify(data, null, 2));
-  } else {
-    fs.writeFileSync(artifactPath, data);
-  }
-  
-  return artifactPath;
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// JSON OUTPUT SCHEMA
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Create standardized JSON output
- */
-function createJsonOutput(options) {
-  const {
-    runId,
-    command,
-    startTime,
-    exitCode,
-    verdict,
-    result = {},
-    tier = "free",
-    version = "1.0.0",
-    projectPath = process.cwd(),
-    artifacts = [],
-  } = options;
-  
-  const output = {
-    runId,
-    command,
-    timestamp: new Date().toISOString(),
-    duration: startTime ? Date.now() - new Date(startTime).getTime() : null,
-    exitCode,
-    verdict,
-    result,
-    meta: {
-      tier,
-      version,
-      path: projectPath,
-    },
-    artifacts: artifacts.map(art => ({
-      type: art.type,
-      path: path.relative(projectPath, art.path),
-      description: art.description,
-    })),
-  };
-  
-  return output;
-}
-
-/**
- * Write JSON output to file or stdout
- */
-function writeJsonOutput(output, outputPath) {
-  const jsonString = JSON.stringify(output, null, 2);
-  
-  if (outputPath) {
-    fs.writeFileSync(outputPath, jsonString);
-    return outputPath;
-  } else {
-    console.log(jsonString);
-    return null;
-  }
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// VERDCT MAPPING
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Map exit codes to verdict strings
- */
-function exitCodeToVerdict(exitCode) {
-  switch (exitCode) {
-    case 0: return "SHIP";
-    case 1: return "WARN";
-    case 2: return "BLOCK";
-    case 3: return "FEATURE_DENIED";
-    case 4: return "INVALID_INPUT";
-    case 5: return "INTERNAL_ERROR";
-    default: return "UNKNOWN";
-  }
-}
-
-/**
- * Map verdict to exit code
- */
-function verdictToExitCode(verdict) {
-  switch (verdict?.toUpperCase()) {
-    case "SHIP": return 0;
-    case "WARN": return 1;
-    case "BLOCK": return 2;
-    case "FEATURE_DENIED": return 3;
-    case "INVALID_INPUT": return 4;
-    case "INTERNAL_ERROR": return 5;
-    default: return 5;
-  }
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// COMMAND WRAPPER
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Wrap a command runner with standard output handling
- */
-async function withStandardOutput(commandFn, options = {}) {
-  const {
-    command,
-    startTime = new Date().toISOString(),
-    runId = generateRunId(),
-    json = false,
-    output = null,
-    ci = false,
-    verbose = false,
-    tier = "free",
-    version = "1.0.0",
-  } = options;
-  
-  // Initialize paths
-  const paths = getRunPaths(runId);
-  const artifacts = [];
-  
-  try {
-    // Run the command
-    const result = await commandFn({
-      runId,
-      paths,
-      saveArtifact: (name, data, type) => {
-        const artifactPath = saveArtifact(runId, name, data, type);
-        artifacts.push({
-          type,
-          path: artifactPath,
-          description: `${name} artifact`,
-        });
-        return artifactPath;
-      },
-    });
-    
-    // Extract exit code and verdict
-    const exitCode = typeof result === "number" ? result : result.exitCode || 0;
-    const verdict = result.verdict || exitCodeToVerdict(exitCode);
-    
-    // Create JSON output if requested
-    if (json) {
-      const jsonOutput = createJsonOutput({
-        runId,
-        command,
-        startTime,
-        exitCode,
-        verdict,
-        result: typeof result === "object" ? result : {},
-        tier,
-        version,
-        artifacts,
-      });
-      
-      writeJsonOutput(jsonOutput, output);
-    }
-    
-    // Save command output to run directory
-    const commandOutput = {
-      exitCode,
-      verdict,
-      result: typeof result === "object" ? result : {},
-      artifacts,
-    };
-    fs.writeFileSync(paths.commandPath, JSON.stringify(commandOutput, null, 2));
-    
-    // Update stable pointer
-    const lastPath = path.join(process.cwd(), ".vibecheck", "last", `${command}.json`);
-    if (!fs.existsSync(path.dirname(lastPath))) {
-      fs.mkdirSync(path.dirname(lastPath), { recursive: true });
-    }
-    fs.writeFileSync(lastPath, JSON.stringify(commandOutput, null, 2));
-    
-    return exitCode;
-  } catch (error) {
-    // Handle errors consistently
-    const exitCode = error.exitCode || 5;
-    const verdict = "INTERNAL_ERROR";
-    
-    if (json) {
-      const jsonOutput = createJsonOutput({
-        runId,
-        command,
-        startTime,
-        exitCode,
-        verdict,
-        result: {
-          error: error.message,
-          stack: error.stack,
-        },
-        tier,
-        version,
-        artifacts,
-      });
-      
-      writeJsonOutput(jsonOutput, output);
-    }
-    
-    // Save error to run directory
-    const commandOutput = {
-      exitCode,
-      verdict,
-      error: error.message,
-      artifacts,
-    };
-    fs.writeFileSync(paths.commandPath, JSON.stringify(commandOutput, null, 2));
-    
-    throw error;
-  }
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// STANDARD FLAGS PARSER
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Parse standard CLI flags
- */
-function parseStandardFlags(args) {
-  const flags = {
-    json: false,
-    ci: false,
-    path: process.cwd(),
-    output: null,
-    verbose: false,
-    strict: false,
-    help: false,
-    version: false,
-    debug: false,
-    quiet: false,
-  };
-  
-  const parsed = args.filter(arg => {
-    switch (arg) {
-      case "--json":
-      case "-j":
-        flags.json = true;
-        return false;
-      case "--ci":
-        flags.ci = true;
-        return false;
-      case "--verbose":
-      case "-v":
-        flags.verbose = true;
-        return false;
-      case "--strict":
-        flags.strict = true;
-        return false;
-      case "--help":
-      case "-h":
-        flags.help = true;
-        return false;
-      case "--version":
-      case "-V":
-        flags.version = true;
-        return false;
-      case "--debug":
-      case "-d":
-        flags.debug = true;
-        return false;
-      case "--quiet":
-      case "-q":
-        flags.quiet = true;
-        return false;
-      default:
-        if (arg.startsWith("--path=")) {
-          flags.path = arg.split("=")[1];
-          return false;
-        } else if (arg.startsWith("-p")) {
-          const idx = args.indexOf(arg);
-          if (idx < args.length - 1) {
-            flags.path = args[idx + 1];
-            args.splice(idx, 2);
-            return false;
-          }
-        } else if (arg.startsWith("--output=")) {
-          flags.output = arg.split("=")[1];
-          return false;
-        } else if (arg.startsWith("-o")) {
-          const idx = args.indexOf(arg);
-          if (idx < args.length - 1) {
-            flags.output = args[idx + 1];
-            args.splice(idx, 2);
-            return false;
-          }
-        }
-        return true;
-    }
-  });
-  
-  return { flags, parsed };
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// EXPORTS
-// ═══════════════════════════════════════════════════════════════════════════════
-
-module.exports = {
-  generateRunId,
-  getRunPaths,
-  saveArtifact,
-  createJsonOutput,
-  writeJsonOutput,
-  exitCodeToVerdict,
-  verdictToExitCode,
-  withStandardOutput,
-  parseStandardFlags,
-};
+/**
+ * CLI Output Utilities - World-Class Consistency
+ * 
+ * Provides standardized JSON output, run ID generation,
+ * and artifact management for all CLI commands.
+ */
+
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const crypto = require("crypto");
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// RUN ID GENERATION
+// ═══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * Generate a unique run ID for tracking
+ */
+function generateRunId() {
+  return crypto.randomUUID();
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// OUTPUT DIRECTORY MANAGEMENT
+// ═══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * Get run directory paths
+ */
+function getRunPaths(runId, projectPath = process.cwd()) {
+  const runDir = path.join(projectPath, ".vibecheck", "runs", runId);
+  const artifactsDir = path.join(runDir, "artifacts");
+  
+  // Ensure directories exist
+  if (!fs.existsSync(runDir)) fs.mkdirSync(runDir, { recursive: true });
+  if (!fs.existsSync(artifactsDir)) fs.mkdirSync(artifactsDir, { recursive: true });
+  
+  return {
+    runDir,
+    artifactsDir,
+    manifestPath: path.join(runDir, "manifest.json"),
+    commandPath: path.join(runDir, "command.json"),
+  };
+}
+
+/**
+ * Save artifact to run directory
+ */
+function saveArtifact(runId, name, data, type = "json") {
+  const { artifactsDir } = getRunPaths(runId);
+  const artifactPath = path.join(artifactsDir, `${name}.${type}`);
+  
+  if (type === "json") {
+    fs.writeFileSync(artifactPath, JSON.stringify(data, null, 2));
+  } else {
+    fs.writeFileSync(artifactPath, data);
+  }
+  
+  return artifactPath;
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// JSON OUTPUT SCHEMA
+// ═══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * Create standardized JSON output
+ */
+function createJsonOutput(options) {
+  const {
+    runId,
+    command,
+    startTime,
+    exitCode,
+    verdict,
+    result = {},
+    tier = "free",
+    version = "1.0.0",
+    projectPath = process.cwd(),
+    artifacts = [],
+  } = options;
+  
+  const output = {
+    runId,
+    command,
+    timestamp: new Date().toISOString(),
+    duration: startTime ? Date.now() - new Date(startTime).getTime() : null,
+    exitCode,
+    verdict,
+    result,
+    meta: {
+      tier,
+      version,
+      path: projectPath,
+    },
+    artifacts: artifacts.map(art => ({
+      type: art.type,
+      path: path.relative(projectPath, art.path),
+      description: art.description,
+    })),
+  };
+  
+  return output;
+}
+
+/**
+ * Write JSON output to file or stdout
+ */
+function writeJsonOutput(output, outputPath) {
+  const jsonString = JSON.stringify(output, null, 2);
+  
+  if (outputPath) {
+    fs.writeFileSync(outputPath, jsonString);
+    return outputPath;
+  } else {
+    console.log(jsonString);
+    return null;
+  }
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// VERDCT MAPPING
+// ═══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * Map exit codes to verdict strings
+ */
+function exitCodeToVerdict(exitCode) {
+  switch (exitCode) {
+    case 0: return "SHIP";
+    case 1: return "WARN";
+    case 2: return "BLOCK";
+    case 3: return "FEATURE_DENIED";
+    case 4: return "INVALID_INPUT";
+    case 5: return "INTERNAL_ERROR";
+    default: return "UNKNOWN";
+  }
+}
+
+/**
+ * Map verdict to exit code
+ */
+function verdictToExitCode(verdict) {
+  switch (verdict?.toUpperCase()) {
+    case "SHIP": return 0;
+    case "WARN": return 1;
+    case "BLOCK": return 2;
+    case "FEATURE_DENIED": return 3;
+    case "INVALID_INPUT": return 4;
+    case "INTERNAL_ERROR": return 5;
+    default: return 5;
+  }
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// COMMAND WRAPPER
+// ═══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * Wrap a command runner with standard output handling
+ */
+async function withStandardOutput(commandFn, options = {}) {
+  const {
+    command,
+    startTime = new Date().toISOString(),
+    runId = generateRunId(),
+    json = false,
+    output = null,
+    ci = false,
+    verbose = false,
+    tier = "free",
+    version = "1.0.0",
+  } = options;
+  
+  // Initialize paths
+  const paths = getRunPaths(runId);
+  const artifacts = [];
+  
+  try {
+    // Run the command
+    const result = await commandFn({
+      runId,
+      paths,
+      saveArtifact: (name, data, type) => {
+        const artifactPath = saveArtifact(runId, name, data, type);
+        artifacts.push({
+          type,
+          path: artifactPath,
+          description: `${name} artifact`,
+        });
+        return artifactPath;
+      },
+    });
+    
+    // Extract exit code and verdict
+    const exitCode = typeof result === "number" ? result : result.exitCode || 0;
+    const verdict = result.verdict || exitCodeToVerdict(exitCode);
+    
+    // Create JSON output if requested
+    if (json) {
+      const jsonOutput = createJsonOutput({
+        runId,
+        command,
+        startTime,
+        exitCode,
+        verdict,
+        result: typeof result === "object" ? result : {},
+        tier,
+        version,
+        artifacts,
+      });
+      
+      writeJsonOutput(jsonOutput, output);
+    }
+    
+    // Save command output to run directory
+    const commandOutput = {
+      exitCode,
+      verdict,
+      result: typeof result === "object" ? result : {},
+      artifacts,
+    };
+    fs.writeFileSync(paths.commandPath, JSON.stringify(commandOutput, null, 2));
+    
+    // Update stable pointer
+    const lastPath = path.join(process.cwd(), ".vibecheck", "last", `${command}.json`);
+    if (!fs.existsSync(path.dirname(lastPath))) {
+      fs.mkdirSync(path.dirname(lastPath), { recursive: true });
+    }
+    fs.writeFileSync(lastPath, JSON.stringify(commandOutput, null, 2));
+    
+    return exitCode;
+  } catch (error) {
+    // Handle errors consistently
+    const exitCode = error.exitCode || 5;
+    const verdict = "INTERNAL_ERROR";
+    
+    if (json) {
+      const jsonOutput = createJsonOutput({
+        runId,
+        command,
+        startTime,
+        exitCode,
+        verdict,
+        result: {
+          error: error.message,
+          stack: error.stack,
+        },
+        tier,
+        version,
+        artifacts,
+      });
+      
+      writeJsonOutput(jsonOutput, output);
+    }
+    
+    // Save error to run directory
+    const commandOutput = {
+      exitCode,
+      verdict,
+      error: error.message,
+      artifacts,
+    };
+    fs.writeFileSync(paths.commandPath, JSON.stringify(commandOutput, null, 2));
+    
+    throw error;
+  }
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// STANDARD FLAGS PARSER
+// ═══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * Parse standard CLI flags
+ */
+function parseStandardFlags(args) {
+  const flags = {
+    json: false,
+    ci: false,
+    path: process.cwd(),
+    output: null,
+    verbose: false,
+    strict: false,
+    help: false,
+    version: false,
+    debug: false,
+    quiet: false,
+  };
+  
+  const parsed = args.filter(arg => {
+    switch (arg) {
+      case "--json":
+      case "-j":
+        flags.json = true;
+        return false;
+      case "--ci":
+        flags.ci = true;
+        return false;
+      case "--verbose":
+      case "-v":
+        flags.verbose = true;
+        return false;
+      case "--strict":
+        flags.strict = true;
+        return false;
+      case "--help":
+      case "-h":
+        flags.help = true;
+        return false;
+      case "--version":
+      case "-V":
+        flags.version = true;
+        return false;
+      case "--debug":
+      case "-d":
+        flags.debug = true;
+        return false;
+      case "--quiet":
+      case "-q":
+        flags.quiet = true;
+        return false;
+      default:
+        if (arg.startsWith("--path=")) {
+          flags.path = arg.split("=")[1];
+          return false;
+        } else if (arg.startsWith("-p")) {
+          const idx = args.indexOf(arg);
+          if (idx < args.length - 1) {
+            flags.path = args[idx + 1];
+            args.splice(idx, 2);
+            return false;
+          }
+        } else if (arg.startsWith("--output=")) {
+          flags.output = arg.split("=")[1];
+          return false;
+        } else if (arg.startsWith("-o")) {
+          const idx = args.indexOf(arg);
+          if (idx < args.length - 1) {
+            flags.output = args[idx + 1];
+            args.splice(idx, 2);
+            return false;
+          }
+        }
+        return true;
+    }
+  });
+  
+  return { flags, parsed };
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// EXPORTS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+module.exports = {
+  generateRunId,
+  getRunPaths,
+  saveArtifact,
+  createJsonOutput,
+  writeJsonOutput,
+  exitCodeToVerdict,
+  verdictToExitCode,
+  withStandardOutput,
+  parseStandardFlags,
+};