@vibecheckai/cli 3.9.1 → 4.0.0

package/mcp-server/configs/README.md

@@ -0,0 +1,172 @@
+# VibeCheck MCP Standard Configuration Templates
+
+Ready-to-use configuration files for integrating VibeCheck MCP Standard with your AI IDE.
+
+## Quick Start
+
+### Automatic Setup (Recommended)
+
+```bash
+# Install VibeCheck CLI
+npm install -g @vibecheckai/cli
+
+# Auto-configure for your IDE
+vibecheck mcp install
+
+# Or configure specifically for Cursor
+vibecheck mcp cursor
+```
+
+### Manual Setup
+
+Copy the appropriate configuration file to your IDE's config directory.
+
+## Configuration Files
+
+### Claude Desktop
+
+| File | Description |
+|------|-------------|
+| `claude-desktop.json` | Basic configuration |
+| `claude-desktop-with-workspace.json` | With specific project path |
+| `claude-desktop-pro.json` | PRO features with API key |
+
+**Config Location:**
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+- Linux: `~/.config/claude/claude_desktop_config.json`
+
+### Cursor IDE
+
+| File | Description |
+|------|-------------|
+| `cursor-mcp.json` | Standard configuration |
+
+**Config Locations:**
+- Project-level: `.cursor/mcp.json` (in your project root)
+- Global (macOS): `~/Library/Application Support/Cursor/User/globalStorage/cursor.mcp/mcp.json`
+- Global (Windows): `%APPDATA%\Cursor\User\globalStorage\cursor.mcp\mcp.json`
+
+### Windsurf
+
+| File | Description |
+|------|-------------|
+| `windsurf-mcp.json` | Standard configuration |
+
+**Config Location:**
+- macOS: `~/Library/Application Support/Windsurf/mcp.json`
+- Windows: `%APPDATA%\Windsurf\mcp.json`
+
+## Configuration Options
+
+### Basic Configuration
+
+```json
+{
+  "mcpServers": {
+    "vibecheck": {
+      "command": "npx",
+      "args": ["-y", "@vibecheck/mcp-standard"]
+    }
+  }
+}
+```
+
+### With Workspace Path
+
+```json
+{
+  "mcpServers": {
+    "vibecheck": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@vibecheck/mcp-standard",
+        "--workspace",
+        "/path/to/project"
+      ]
+    }
+  }
+}
+```
+
+### With Firewall Mode
+
+```json
+{
+  "mcpServers": {
+    "vibecheck": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@vibecheck/mcp-standard",
+        "--firewall-mode",
+        "enforce"
+      ],
+      "env": {
+        "VIBECHECK_API_KEY": "vck_..."
+      }
+    }
+  }
+}
+```
+
+## Firewall Modes
+
+| Mode | Tier | Description |
+|------|------|-------------|
+| `off` | FREE | No enforcement |
+| `observe` | FREE | Log actions, warn on violations |
+| `enforce` | PRO | Block actions that violate intent |
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `VIBECHECK_API_KEY` | Your VibeCheck API key |
+| `VIBECHECK_WORKSPACE` | Override workspace path |
+| `VIBECHECK_LOG_LEVEL` | Log level (debug, info, warn, error) |
+
+## Verification
+
+After configuration, verify the setup:
+
+```bash
+# Check MCP status
+vibecheck mcp status
+
+# Test MCP connection
+vibecheck mcp test
+```
+
+## Troubleshooting
+
+### MCP not showing in IDE
+
+1. Restart your IDE after configuration
+2. Check that npx is in your PATH
+3. Verify the config file location
+
+### Permission errors
+
+Ensure the config directory exists:
+
+```bash
+# macOS/Linux
+mkdir -p ~/.config/claude
+
+# Windows (PowerShell)
+mkdir -Force "$env:APPDATA\Claude"
+```
+
+### API key issues
+
+1. Get your API key from https://vibecheckai.dev/settings/api-keys
+2. Add it to the `env` section of your config
+3. Never commit API keys to version control
+
+## Support
+
+- Documentation: https://vibecheckai.dev/docs/mcp
+- Issues: https://github.com/guardiavault-oss/VIBEYCHECK/issues
+- Discord: https://discord.gg/vibecheck

package/mcp-server/configs/claude-desktop-pro.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://raw.githubusercontent.com/anthropics/claude-desktop/main/config-schema.json",
+  "_comment": "Claude Desktop MCP Configuration for VibeCheck PRO",
+  "_instructions": [
+    "This configuration enables VibeCheck PRO features including:",
+    "  - Agent Firewall in enforce mode",
+    "  - Intent verification",
+    "  - Claim verification",
+    "  - Ship checks",
+    "",
+    "Replace YOUR_API_KEY with your VibeCheck API key.",
+    "Get your API key at: https://vibecheckai.dev/settings/api-keys",
+    "",
+    "Copy to your Claude Desktop config directory:",
+    "  macOS: ~/Library/Application Support/Claude/claude_desktop_config.json"
+  ],
+  "mcpServers": {
+    "vibecheck": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@vibecheck/mcp-standard",
+        "--firewall-mode",
+        "enforce"
+      ],
+      "env": {
+        "VIBECHECK_API_KEY": "YOUR_API_KEY"
+      }
+    }
+  }
+}

package/mcp-server/configs/claude-desktop-with-workspace.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://raw.githubusercontent.com/anthropics/claude-desktop/main/config-schema.json",
+  "_comment": "Claude Desktop MCP Configuration with workspace path",
+  "_instructions": [
+    "Use this template when you want to configure VibeCheck for a specific project.",
+    "Replace /path/to/your/project with your actual project path.",
+    "",
+    "Copy to your Claude Desktop config directory:",
+    "  macOS: ~/Library/Application Support/Claude/claude_desktop_config.json",
+    "  Windows: %APPDATA%\\Claude\\claude_desktop_config.json",
+    "  Linux: ~/.config/claude/claude_desktop_config.json"
+  ],
+  "mcpServers": {
+    "vibecheck": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@vibecheck/mcp-standard",
+        "--workspace",
+        "/path/to/your/project"
+      ],
+      "env": {}
+    }
+  }
+}

package/mcp-server/configs/claude-desktop.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://raw.githubusercontent.com/anthropics/claude-desktop/main/config-schema.json",
+  "_comment": "Claude Desktop MCP Configuration for VibeCheck MCP Standard",
+  "_instructions": [
+    "Copy this file to your Claude Desktop config directory:",
+    "  macOS: ~/Library/Application Support/Claude/claude_desktop_config.json",
+    "  Windows: %APPDATA%\\Claude\\claude_desktop_config.json",
+    "  Linux: ~/.config/claude/claude_desktop_config.json",
+    "",
+    "Or merge the mcpServers section with your existing config."
+  ],
+  "mcpServers": {
+    "vibecheck": {
+      "command": "npx",
+      "args": ["-y", "@vibecheck/mcp-standard"],
+      "env": {}
+    }
+  }
+}

package/mcp-server/configs/cursor-mcp.json

@@ -0,0 +1,21 @@
+{
+  "_comment": "Cursor IDE MCP Configuration for VibeCheck MCP Standard",
+  "_instructions": [
+    "For project-level configuration:",
+    "  Copy to: .cursor/mcp.json in your project root",
+    "",
+    "For global configuration:",
+    "  macOS: ~/Library/Application Support/Cursor/User/globalStorage/cursor.mcp/mcp.json",
+    "  Windows: %APPDATA%\\Cursor\\User\\globalStorage\\cursor.mcp\\mcp.json",
+    "  Linux: ~/.config/Cursor/User/globalStorage/cursor.mcp/mcp.json",
+    "",
+    "Or run: vibecheck mcp cursor"
+  ],
+  "mcpServers": {
+    "vibecheck": {
+      "command": "npx",
+      "args": ["-y", "@vibecheck/mcp-standard"],
+      "env": {}
+    }
+  }
+}

package/mcp-server/configs/windsurf-mcp.json

@@ -0,0 +1,17 @@
+{
+  "_comment": "Windsurf MCP Configuration for VibeCheck MCP Standard",
+  "_instructions": [
+    "Copy to your Windsurf config directory:",
+    "  macOS: ~/Library/Application Support/Windsurf/mcp.json",
+    "  Windows: %APPDATA%\\Windsurf\\mcp.json",
+    "  Linux: ~/.config/Windsurf/mcp.json"
+  ],
+  "servers": [
+    {
+      "name": "vibecheck",
+      "command": "npx",
+      "args": ["-y", "@vibecheck/mcp-standard"],
+      "env": {}
+    }
+  ]
+}

package/mcp-server/mcp-config.example.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "vibecheck": {
+      "command": "node",
+      "args": ["./mcp-server/dist/cli.js"],
+      "env": {}
+    }
+  }
+}

package/mcp-server/package.json

@@ -1,56 +1,71 @@
 {
-  "name": "vibecheck-mcp-server",
-  "version": "4.2.0",
-  "description": "Professional MCP server for vibecheck - Intelligent development environment vibechecks",
-  "type": "module",
-  "main": "index.js",
+  "name": "@vibecheck/mcp-standard",
+  "version": "4.0.0",
+  "description": "VibeCheck MCP Standard - The official Model Context Protocol implementation for AI agent security, firewall enforcement, and intent-based development",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "bin": {
-    "vibecheck-mcp": "./index.js"
+    "vibecheck-mcp": "dist/cli.js",
+    "mcp-standard": "dist/cli.js"
   },
   "scripts": {
-    "start": "node index.js",
-    "dev": "VIBECHECK_DEBUG=true node index.js",
-    "build": "tsc -p tsconfig.json",
-    "test": "vitest run",
-    "test:watch": "vitest"
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js",
+    "lint": "eslint src --ext .ts",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "mcp",
-    "ai",
-    "vibechecks",
+    "model-context-protocol",
     "vibecheck",
-    "development",
-    "validation",
-    "architecture"
+    "ai-security",
+    "agent-firewall",
+    "ai-safety",
+    "prompt-builder",
+    "cursor",
+    "claude",
+    "windsurf",
+    "ai-agent",
+    "llm-security",
+    "hallucination-detection",
+    "intent-verification",
+    "ci-cd",
+    "github-actions",
+    "security-scanning"
   ],
+  "author": "VibeCheck <team@vibecheckai.dev>",
+  "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "ajv": "^8.12.0"
+    "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@types/node": "^20.11.0",
-    "typescript": "^5.3.0",
-    "vitest": "^1.2.0"
+    "@types/node": "^20.14.0",
+    "typescript": "^5.5.0",
+    "rimraf": "^5.0.5"
   },
   "engines": {
-    "node": ">=20.11"
-  },
-  "author": "vibecheck",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
+    "node": ">=18.0.0"
   },
-  "files": [
-    "*.js",
-    "README.md"
-  ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/vibecheck-oss/vibecheck"
+    "url": "git+https://github.com/guardiavault-oss/VIBEYCHECK.git",
+    "directory": "mcp-server"
   },
+  "homepage": "https://github.com/guardiavault-oss/VIBEYCHECK/tree/main/mcp-server",
   "bugs": {
-    "url": "https://github.com/vibecheck-oss/vibecheck/issues"
+    "url": "https://github.com/guardiavault-oss/VIBEYCHECK/issues"
   },
-  "homepage": "https://github.com/vibecheck-oss/vibecheck#readme"
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/**/*",
+    "configs/**/*",
+    "SPEC.md",
+    "README.md",
+    "LICENSE"
+  ]
 }
-

package/mcp-server/src/cli.ts

@@ -0,0 +1,185 @@
+#!/usr/bin/env node
+/**
+ * VibeCheck MCP Server CLI Entry Point
+ * Run with: vibecheck-mcp or npx @vibecheck/mcp-server
+ */
+
+import { VibecheckMcpServer } from './server.js';
+import type { McpServerConfig, FirewallMode } from './types.js';
+
+// Parse command line arguments
+function parseArgs(): McpServerConfig {
+  const args = process.argv.slice(2);
+  const config: McpServerConfig = {};
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+
+    switch (arg) {
+      case '--workspace':
+      case '-w':
+        config.workspacePath = args[++i];
+        break;
+
+      case '--cli-path':
+        config.cliPath = args[++i];
+        break;
+
+      case '--firewall-mode':
+      case '-m':
+        const mode = args[++i];
+        if (mode === 'off' || mode === 'observe' || mode === 'enforce') {
+          config.defaultFirewallMode = mode as FirewallMode;
+        }
+        break;
+
+      case '--auto-enforce-intent':
+        config.autoEnforceIntent = true;
+        break;
+
+      case '--log-level':
+      case '-l':
+        const level = args[++i];
+        if (level === 'debug' || level === 'info' || level === 'warn' || level === 'error') {
+          config.logLevel = level;
+        }
+        break;
+
+      case '--help':
+      case '-h':
+        printHelp();
+        process.exit(0);
+
+      case '--version':
+      case '-v':
+        console.log('1.0.0');
+        process.exit(0);
+    }
+  }
+
+  return config;
+}
+
+function printHelp(): void {
+  console.log(`
+VibeCheck MCP Server - Agent Firewall, Prompt Builder & CLI Integration
+
+Usage: vibecheck-mcp [options]
+
+Options:
+  -w, --workspace <path>       Set workspace path (default: current directory)
+  --cli-path <path>            Path to vibecheck CLI executable
+  -m, --firewall-mode <mode>   Initial firewall mode: off, observe, enforce (default: off)
+  --auto-enforce-intent        Auto-enable enforce mode when intent is set
+  -l, --log-level <level>      Log level: debug, info, warn, error (default: info)
+  -h, --help                   Show this help message
+  -v, --version                Show version number
+
+MCP Server Configuration:
+  This server communicates over stdio using the Model Context Protocol.
+  Add it to your MCP client configuration:
+
+  {
+    "mcpServers": {
+      "vibecheck": {
+        "command": "npx",
+        "args": ["@vibecheck/mcp-server"],
+        "env": {}
+      }
+    }
+  }
+
+Available Tools:
+
+  CLI Tools:
+    - vibecheck_doctor       Health check
+    - vibecheck_audit        Security audit
+    - vibecheck_ship         Ship readiness
+    - vibecheck_forge        Generate AI rules
+    - vibecheck_fix          Plan/apply fixes
+    - vibecheck_checkpoint   Snapshot management
+    - vibecheck_packs        Report bundles
+    - vibecheck_reality      Browser testing
+
+  Firewall Tools:
+    - firewall_status        Get firewall status
+    - firewall_set_mode      Set firewall mode
+    - firewall_set_intent    Set current intent
+    - firewall_get_intent    Get current intent
+    - firewall_clear_intent  Clear intent
+    - firewall_check         Shield check
+    - firewall_verify_claim  Verify AI claim
+    - firewall_gate_action   Check action permission
+    - firewall_get_templates Get intent templates
+
+  Prompt Builder Tools:
+    - prompt_get_templates   Get prompt templates
+    - prompt_get_categories  Get categories
+    - prompt_detect_template Detect template from input
+    - prompt_build           Build enhanced prompt
+    - prompt_get_context     Get workspace context
+    - prompt_get_suggestions Get smart suggestions
+
+Resources:
+    - vibecheck://status        Server status
+    - vibecheck://firewall/stats Firewall statistics
+    - vibecheck://firewall/log   Action log
+    - vibecheck://context        Workspace context
+
+Examples:
+  # Run with default settings
+  vibecheck-mcp
+
+  # Run with specific workspace
+  vibecheck-mcp --workspace /path/to/project
+
+  # Run with enforce mode enabled
+  vibecheck-mcp --firewall-mode enforce
+
+  # Run with custom CLI path
+  vibecheck-mcp --cli-path /usr/local/bin/vibecheck
+`);
+}
+
+// Main entry point
+async function main(): Promise<void> {
+  const config = parseArgs();
+
+  // Default to current working directory if not specified
+  if (!config.workspacePath) {
+    config.workspacePath = process.cwd();
+  }
+
+  const server = new VibecheckMcpServer(config);
+
+  // Handle graceful shutdown
+  process.on('SIGINT', () => {
+    console.error('\nShutting down...');
+    process.exit(0);
+  });
+
+  process.on('SIGTERM', () => {
+    console.error('\nShutting down...');
+    process.exit(0);
+  });
+
+  // Handle uncaught errors
+  process.on('uncaughtException', (error) => {
+    console.error('Uncaught exception:', error);
+    process.exit(1);
+  });
+
+  process.on('unhandledRejection', (reason) => {
+    console.error('Unhandled rejection:', reason);
+    process.exit(1);
+  });
+
+  try {
+    await server.run();
+  } catch (error) {
+    console.error('Server error:', error);
+    process.exit(1);
+  }
+}
+
+main();

package/mcp-server/src/index.ts

@@ -0,0 +1,85 @@
+/**
+ * VibeCheck MCP Server
+ * 
+ * This package provides an MCP (Model Context Protocol) server for VibeCheck,
+ * enabling AI agents to interact with:
+ * - Agent Firewall (intent-based code change control)
+ * - Prompt Builder (intelligent prompt templates)
+ * - CLI Commands (audit, ship, forge, etc.)
+ * 
+ * @example
+ * ```typescript
+ * import { VibecheckMcpServer } from '@vibecheck/mcp-server';
+ * 
+ * const server = new VibecheckMcpServer({
+ *   workspacePath: '/path/to/project',
+ *   defaultFirewallMode: 'observe',
+ * });
+ * 
+ * await server.run();
+ * ```
+ */
+
+// Export main server class
+export { VibecheckMcpServer } from './server.js';
+
+// Export services for direct use
+export { CliService } from './services/cli-service.js';
+export { FirewallService } from './services/firewall-service.js';
+export { PromptBuilderService } from './services/prompt-builder-service.js';
+export { TierService, getTierService, FREE_COMMANDS, PRO_COMMANDS } from './services/tier-service.js';
+
+// Export types
+export type {
+  // CLI Types
+  CliResult,
+  AuditResult,
+  AuditFinding,
+  DoctorResult,
+  DoctorCheck,
+  ShipResult,
+  ForgeResult,
+  FixResult,
+  FixDetail,
+  CheckpointResult,
+  CheckpointInfo,
+  PacksResult,
+  RealityResult,
+  RealityFinding,
+
+  // Firewall Types
+  FirewallMode,
+  FirewallStatus,
+  FirewallVerdict,
+  FirewallViolation,
+  UnblockPlan,
+  UnblockStep,
+  ShieldCheckResult,
+  ShieldFinding,
+  Intent,
+  IntentTemplate,
+  ClaimVerificationRequest,
+  ClaimVerificationResult,
+  ClaimEvidence,
+
+  // Prompt Builder Types
+  PromptCategory,
+  PromptTemplate,
+  ContextQuestion,
+  WorkspaceContext,
+  BuiltPrompt,
+  PromptQuality,
+  SmartSuggestion,
+
+  // Server Types
+  McpServerConfig,
+  McpServerState,
+} from './types.js';
+
+// Export tier types
+export type {
+  Tier,
+  TierLimits,
+  UserEntitlements,
+  TierCheckResult,
+} from './services/tier-service.js';