@vibecheckai/cli 3.9.0 → 4.0.0

package/README.md

@@ -216,4 +216,4 @@ MIT © Vibecheck AI
 
 ---
 
-**[Documentation](https://vibecheckai.dev/docs)** · **[Discord](https://discord.gg/vibecheck)** · **[GitHub](https://github.com/vibecheck-oss/vibecheck)**
+**[Documentation](https://vibecheckai.dev/docs)** · **[Discord](https://discord.gg/vibecheck)** · **[GitHub](https://github.com/guardiavault-oss/VIBEYCHECK)**

package/bin/runners/context/generators/cursor-enhanced.js

@@ -2375,6 +2375,14 @@ function generateCursorHooks(analysis, truthpack = null) {
 
 /**
  * Write all enhanced context files to disk
+ * 
+ * NOTE: Cursor only supports these file formats:
+ * - Rules: .cursor/rules/*.mdc
+ * - Skills: .cursor/skills/<name>/SKILL.md
+ * 
+ * Agents and Hooks are NOT native Cursor features, so we convert them:
+ * - Agents → Skills (procedural workflows)
+ * - Hooks → Rules (contextual guidelines)
  */
 function writeEnhancedContext(projectPath, analysis, truthpack = null) {
   const written = [];
@@ -2394,7 +2402,7 @@ function writeEnhancedContext(projectPath, analysis, truthpack = null) {
     written.push(`.cursor/rules/${name}.mdc`);
   }
 
-  // 3. Write Skills
+  // 3. Write Skills (native Cursor format)
   const skills = generateCursorSkills(analysis, truthpack);
   for (const [name, skill] of Object.entries(skills)) {
     const skillDir = path.dirname(path.join(projectPath, skill.path));
@@ -2403,29 +2411,107 @@ function writeEnhancedContext(projectPath, analysis, truthpack = null) {
     written.push(skill.path);
   }
 
-  // 4. Write ELITE Subagents
+  // 4. Write Subagents AS SKILLS (Cursor doesn't support .cursor/agents/)
+  // Converting agents to skills format for proper Cursor recognition
   const agents = generateCursorSubagents(analysis, truthpack);
-  const agentsDir = path.join(projectPath, ".cursor", "agents");
-  fs.mkdirSync(agentsDir, { recursive: true });
-  
   for (const [name, agent] of Object.entries(agents)) {
-    fs.writeFileSync(path.join(projectPath, agent.path), agent.content);
-    written.push(agent.path);
+    // Convert agent path from .cursor/agents/X.md to .cursor/skills/X/SKILL.md
+    const skillName = name.replace(/[^a-z0-9-]/g, '-');
+    const skillPath = `.cursor/skills/${skillName}/SKILL.md`;
+    const skillDir = path.dirname(path.join(projectPath, skillPath));
+    fs.mkdirSync(skillDir, { recursive: true });
+    
+    // Convert agent content to skill format
+    const skillContent = convertAgentToSkill(agent, name, analysis);
+    fs.writeFileSync(path.join(projectPath, skillPath), skillContent);
+    written.push(skillPath);
   }
 
-  // 5. Write Hooks (NEW!)
+  // 5. Write Hooks AS RULES (Cursor doesn't support .cursor/hooks/)
+  // Converting hooks to rules format for proper Cursor recognition
   const hooks = generateCursorHooks(analysis, truthpack);
-  const hooksDir = path.join(projectPath, ".cursor", "hooks");
-  fs.mkdirSync(hooksDir, { recursive: true });
-  
   for (const [name, hook] of Object.entries(hooks)) {
-    fs.writeFileSync(path.join(projectPath, hook.path), hook.content);
-    written.push(hook.path);
+    // Convert hook to rule format
+    const ruleName = `hook-${name}`;
+    const rulePath = path.join(rulesDir, `${ruleName}.mdc`);
+    const ruleContent = convertHookToRule(hook, name, analysis);
+    fs.writeFileSync(rulePath, ruleContent);
+    written.push(`.cursor/rules/${ruleName}.mdc`);
   }
 
   return written;
 }
 
+/**
+ * Convert an agent definition to a Cursor skill format
+ */
+function convertAgentToSkill(agent, name, analysis) {
+  // Extract description from the agent's frontmatter
+  const descMatch = agent.content.match(/description:\s*(.+)/);
+  const description = descMatch ? descMatch[1].trim() : `${name} workflow for ${analysis.name}`;
+  
+  // Clean description for SKILL.md format (must be specific and include "when to use")
+  const cleanDescription = description
+    .replace(/^Elite\s+/i, '')
+    .replace(/for\s+\$\{analysis\.name\}/g, `for ${analysis.name}`);
+  
+  // Build the skill content with proper frontmatter
+  return `---
+name: ${name}
+description: ${cleanDescription}. Use when asked about ${name.replace(/-/g, ' ')} or related tasks.
+---
+
+${agent.content.replace(/^---[\s\S]*?---\n*/m, '')}`;
+}
+
+/**
+ * Convert a hook definition to a Cursor rule (.mdc) format
+ */
+function convertHookToRule(hook, name, analysis) {
+  // Extract trigger info from hook
+  const triggerMatch = hook.content.match(/trigger:\s*(.+)/);
+  const trigger = triggerMatch ? triggerMatch[1].trim() : 'contextual';
+  
+  // Determine appropriate globs and alwaysApply based on hook type
+  let globs = '[]';
+  let alwaysApply = 'false';
+  let priority = 60;
+  
+  if (name.includes('commit') || name.includes('pr')) {
+    alwaysApply = 'true';
+    priority = 75;
+  } else if (name.includes('save') || name.includes('lint')) {
+    globs = '["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"]';
+    priority = 65;
+  } else if (name.includes('test')) {
+    globs = '["**/*.test.*", "**/*.spec.*", "**/test/**", "**/__tests__/**"]';
+    priority = 70;
+  } else if (name.includes('scaffold') || name.includes('new-file')) {
+    alwaysApply = 'true';
+    priority = 50;
+  }
+  
+  // Extract content without the old frontmatter
+  const contentWithoutFrontmatter = hook.content.replace(/^---[\s\S]*?---\n*/m, '');
+  
+  // Build MDC rule format
+  return `---
+description: "${name.replace(/-/g, ' ')} guidelines (converted from hook: ${trigger})"
+globs: ${globs}
+alwaysApply: ${alwaysApply}
+priority: ${priority}
+---
+
+> 📋 **Context Enhanced by vibecheck AI** - Auto-generated from workflow hook
+> When using this context, acknowledge: "Using vibecheck-enhanced context for ${name}"
+
+${contentWithoutFrontmatter}
+
+---
+*Converted from hook to rule for Cursor compatibility - Generated by Forge v1.0*
+`;
+}
+
 module.exports = {
   generateCursorRulesEnhanced,
   generateCursorModularRulesEnhanced,

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

@@ -97,6 +97,22 @@ const sym = {
   arrow: "→",
   arrowRight: "▸",
   star: "★",
+  // Aliases for compatibility
+  success: "✓",
+  error: "✗",
+  // Additional symbols
+  key: "🔑",
+  list: "📋",
+  badge: "🏅",
+  timer: "⏱️",
+  add: "+",
+  remove: "-",
+  person: "👤",
+  expired: "⌛",
+  review: "👁️",
+  pending: "○",
+  active: "●",
+  skip: "↷",
   // Progress
   blockFull: "█",
   blockMed: "▓",

package/bin/runners/runCI.js

@@ -0,0 +1,353 @@
+/**
+ * vibecheck ci - Enterprise CI Wiring
+ * 
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * One-command enterprise CI wiring for GitHub Actions
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * 
+ * Auto-detects your stack (Next.js, Fastify, etc.), package manager, Node version,
+ * and creates optimized workflows with SARIF output, PR comments, and status checks.
+ */
+
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const { parseGlobalFlags, shouldSuppressOutput, isJsonMode } = require("./lib/global-flags");
+const { EXIT } = require("./lib/exit-codes");
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// CLI OUTPUT
+// ═══════════════════════════════════════════════════════════════════════════════
+
+let _cliOutput = null;
+function getCliOutput() {
+  if (!_cliOutput) _cliOutput = require("./lib/unified-cli-output");
+  return _cliOutput;
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// DETECTION UTILITIES
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function detectPackageManager(projectPath) {
+  if (fs.existsSync(path.join(projectPath, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs.existsSync(path.join(projectPath, "yarn.lock"))) return "yarn";
+  if (fs.existsSync(path.join(projectPath, "bun.lockb"))) return "bun";
+  return "npm";
+}
+
+function detectNodeVersion(projectPath) {
+  // Try .nvmrc
+  const nvmrcPath = path.join(projectPath, ".nvmrc");
+  if (fs.existsSync(nvmrcPath)) {
+    const version = fs.readFileSync(nvmrcPath, "utf-8").trim();
+    return version.replace(/^v/, "");
+  }
+  
+  // Try package.json engines
+  const pkgPath = path.join(projectPath, "package.json");
+  if (fs.existsSync(pkgPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+      if (pkg.engines?.node) {
+        const match = pkg.engines.node.match(/(\d+)/);
+        if (match) return match[1];
+      }
+    } catch {}
+  }
+  
+  return "20"; // Default to LTS
+}
+
+function detectFramework(projectPath) {
+  const pkgPath = path.join(projectPath, "package.json");
+  if (!fs.existsSync(pkgPath)) return "unknown";
+  
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    
+    if (deps["next"]) return "nextjs";
+    if (deps["@fastify/core"] || deps["fastify"]) return "fastify";
+    if (deps["express"]) return "express";
+    if (deps["@nestjs/core"]) return "nestjs";
+    if (deps["vite"]) return "vite";
+    if (deps["nuxt"]) return "nuxt";
+    if (deps["remix"]) return "remix";
+    if (deps["@sveltejs/kit"]) return "sveltekit";
+    
+    return "generic";
+  } catch {
+    return "unknown";
+  }
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// WORKFLOW GENERATION
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function generateGitHubActionsWorkflow(options) {
+  const { packageManager, nodeVersion, framework, full } = options;
+  
+  const installCmd = {
+    npm: "npm ci",
+    yarn: "yarn install --frozen-lockfile",
+    pnpm: "pnpm install --frozen-lockfile",
+    bun: "bun install --frozen-lockfile",
+  }[packageManager];
+
+  const workflow = `# Generated by vibecheck ci
+# https://docs.vibecheckai.dev/ci
+
+name: VibeCheck
+
+on:
+  push:
+    branches: [main, master, develop]
+  pull_request:
+    branches: [main, master, develop]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  security-events: write
+  pull-requests: write
+
+jobs:
+  vibecheck:
+    name: Security & Quality Scan
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '${nodeVersion}'
+          cache: '${packageManager === "yarn" ? "yarn" : packageManager === "pnpm" ? "pnpm" : "npm"}'
+
+      - name: Install dependencies
+        run: ${installCmd}
+
+      - name: Install VibeCheck CLI
+        run: npm install -g @vibecheckai/cli
+
+      - name: Run VibeCheck Audit
+        id: audit
+        run: vibecheck audit --ci --sarif --output vibecheck-results.sarif
+        env:
+          VIBECHECK_API_KEY: \${{ secrets.VIBECHECK_API_KEY }}
+        continue-on-error: true
+
+      - name: Upload SARIF to GitHub
+        if: always()
+        uses: github/codeql-action/upload-sarif@v3
+        with:
+          sarif_file: vibecheck-results.sarif
+          category: vibecheck
+
+      - name: Run VibeCheck Ship
+        if: github.event_name == 'pull_request'
+        run: vibecheck ship --ci --json > ship-verdict.json
+        env:
+          VIBECHECK_API_KEY: \${{ secrets.VIBECHECK_API_KEY }}
+        continue-on-error: true
+
+      - name: Comment PR with Verdict
+        if: github.event_name == 'pull_request'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            let verdict = { verdict: 'UNKNOWN', score: 0 };
+            try {
+              verdict = JSON.parse(fs.readFileSync('ship-verdict.json', 'utf8'));
+            } catch (e) {}
+            
+            const emoji = verdict.verdict === 'SHIP' ? '🚀' : verdict.verdict === 'WARN' ? '⚠️' : '🚫';
+            const body = \`## \${emoji} VibeCheck Verdict: **\${verdict.verdict}**
+            
+            Score: \${verdict.score}/100
+            
+            [View full report](https://vibecheckai.dev/reports/\${context.repo.owner}/\${context.repo.repo}/\${context.sha})
+            \`;
+            
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: body
+            });
+`;
+
+  return workflow;
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// HELP
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function printHelp() {
+  const { ansi, sym, renderMinimalHeader } = getCliOutput();
+  
+  renderMinimalHeader("ci", "free");
+  
+  console.log(`${ansi.bold}vibecheck ci${ansi.reset} - One-command enterprise CI wiring
+
+${ansi.bold}USAGE${ansi.reset}
+  vibecheck ci [options]
+
+${ansi.bold}OPTIONS${ansi.reset}
+  ${ansi.cyan}--dry-run${ansi.reset}          Preview without creating files
+  ${ansi.cyan}--full${ansi.reset}             Create all workflows (audit, ship, e2e, security)
+  ${ansi.cyan}--validate${ansi.reset}         Validate existing workflows
+  ${ansi.cyan}--provider${ansi.reset}         CI provider: github, gitlab, azure (default: github)
+  ${ansi.cyan}--json${ansi.reset}             Output as JSON
+  ${ansi.cyan}--path <dir>${ansi.reset}       Project path
+
+${ansi.bold}EXAMPLES${ansi.reset}
+  ${ansi.dim}# Auto-detect and create CI workflows${ansi.reset}
+  vibecheck ci
+
+  ${ansi.dim}# Preview without creating files${ansi.reset}
+  vibecheck ci --dry-run
+
+  ${ansi.dim}# Create all workflows${ansi.reset}
+  vibecheck ci --full
+
+  ${ansi.dim}# Validate existing workflows${ansi.reset}
+  vibecheck ci --validate
+`);
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// MAIN RUNNER
+// ═══════════════════════════════════════════════════════════════════════════════
+
+async function runCI(args = [], context = {}) {
+  const { flags, cleanArgs } = parseGlobalFlags(args);
+  const quiet = shouldSuppressOutput(flags);
+  const json = isJsonMode(flags);
+  const projectPath = flags.path || context.repoRoot || process.cwd();
+  
+  // Handle help
+  if (flags.help) {
+    printHelp();
+    return EXIT.SUCCESS;
+  }
+  
+  const dryRun = args.includes("--dry-run");
+  const full = args.includes("--full");
+  const validate = args.includes("--validate");
+  const provider = args.find(a => a.startsWith("--provider="))?.split("=")[1] || "github";
+  
+  const { ansi, sym, renderMinimalHeader, renderSuccess, renderWarning, renderError } = getCliOutput();
+  
+  if (!quiet && !json) {
+    renderMinimalHeader("ci", "free");
+  }
+  
+  try {
+    // Detect project settings
+    const packageManager = detectPackageManager(projectPath);
+    const nodeVersion = detectNodeVersion(projectPath);
+    const framework = detectFramework(projectPath);
+    
+    if (!quiet && !json) {
+      console.log(`  ${ansi.dim}Detected:${ansi.reset}`);
+      console.log(`    Package Manager: ${ansi.cyan}${packageManager}${ansi.reset}`);
+      console.log(`    Node Version:    ${ansi.cyan}${nodeVersion}${ansi.reset}`);
+      console.log(`    Framework:       ${ansi.cyan}${framework}${ansi.reset}`);
+      console.log();
+    }
+    
+    // Handle validate
+    if (validate) {
+      const workflowDir = path.join(projectPath, ".github", "workflows");
+      const vibecheckWorkflow = path.join(workflowDir, "vibecheck.yml");
+      
+      if (fs.existsSync(vibecheckWorkflow)) {
+        renderSuccess("vibecheck.yml workflow exists");
+        return EXIT.SUCCESS;
+      } else {
+        renderWarning("vibecheck.yml workflow not found");
+        console.log(`  ${ansi.dim}Run 'vibecheck ci' to create it${ansi.reset}\n`);
+        return EXIT.NOT_FOUND || 4;
+      }
+    }
+    
+    // Generate workflow
+    const workflow = generateGitHubActionsWorkflow({
+      packageManager,
+      nodeVersion,
+      framework,
+      full,
+    });
+    
+    if (dryRun) {
+      if (json) {
+        console.log(JSON.stringify({
+          success: true,
+          dryRun: true,
+          provider,
+          detection: { packageManager, nodeVersion, framework },
+          workflow: workflow,
+        }, null, 2));
+      } else {
+        console.log(`  ${ansi.yellow}${sym.warning}${ansi.reset} ${ansi.bold}DRY RUN${ansi.reset} - No files created\n`);
+        console.log(`  ${ansi.dim}Would create:${ansi.reset} .github/workflows/vibecheck.yml\n`);
+        console.log(`  ${ansi.dim}Preview:${ansi.reset}`);
+        console.log(`  ${ansi.dim}${"─".repeat(60)}${ansi.reset}`);
+        workflow.split("\n").slice(0, 20).forEach(line => {
+          console.log(`  ${ansi.dim}${line}${ansi.reset}`);
+        });
+        console.log(`  ${ansi.dim}... (${workflow.split("\n").length - 20} more lines)${ansi.reset}`);
+        console.log(`  ${ansi.dim}${"─".repeat(60)}${ansi.reset}\n`);
+      }
+      return EXIT.SUCCESS;
+    }
+    
+    // Create workflow file
+    const workflowDir = path.join(projectPath, ".github", "workflows");
+    const workflowPath = path.join(workflowDir, "vibecheck.yml");
+    
+    // Create directories
+    fs.mkdirSync(workflowDir, { recursive: true });
+    
+    // Write workflow
+    fs.writeFileSync(workflowPath, workflow, "utf-8");
+    
+    if (json) {
+      console.log(JSON.stringify({
+        success: true,
+        created: [workflowPath],
+        provider,
+        detection: { packageManager, nodeVersion, framework },
+      }, null, 2));
+    } else {
+      renderSuccess(`Created .github/workflows/vibecheck.yml`);
+      console.log();
+      console.log(`  ${ansi.bold}Next steps:${ansi.reset}`);
+      console.log(`    1. Add ${ansi.cyan}VIBECHECK_API_KEY${ansi.reset} to your repository secrets`);
+      console.log(`    2. Push to trigger the workflow`);
+      console.log();
+      console.log(`  ${ansi.dim}Get your API key: https://vibecheckai.dev/settings/keys${ansi.reset}\n`);
+    }
+    
+    return EXIT.SUCCESS;
+    
+  } catch (error) {
+    if (json) {
+      console.log(JSON.stringify({ success: false, error: error.message }));
+    } else {
+      renderError(`CI setup failed: ${error.message}`);
+    }
+    return EXIT.INTERNAL_ERROR || 10;
+  }
+}
+
+module.exports = { runCI };

package/bin/runners/runCheckpoint.js

@@ -34,8 +34,8 @@ const {
   AUTO_REASONS,
 } = require("./lib/checkpoint");
 
-const { parseGlobalFlags, shouldSuppressOutput, isJsonMode } = require("./lib/parse-args");
-const { renderTable, renderBox, colors, symbols } = require("./lib/renderers");
+const { parseGlobalFlags, shouldSuppressOutput, isJsonMode } = require("./lib/global-flags");
+const { c: colors, sym: symbols, box: renderBox, table: renderTable } = require("./lib/ui");
 
 // ═══════════════════════════════════════════════════════════════════════════════
 // EXIT CODES

package/mcp-server/.eslintrc.json

@@ -0,0 +1,24 @@
+{
+  "root": true,
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": 2022,
+    "sourceType": "module",
+    "project": "./tsconfig.json"
+  },
+  "plugins": ["@typescript-eslint"],
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "rules": {
+    "@typescript-eslint/no-explicit-any": "warn",
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "no-console": ["warn", { "allow": ["error", "warn"] }]
+  },
+  "env": {
+    "node": true,
+    "es2022": true
+  }
+}