@vibecheckai/cli 3.5.0 → 3.5.1

package/mcp-server/registry/tools.json

@@ -0,0 +1,476 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "version": "3.0.0",
+  "description": "Vibecheck MCP Tool Registry - Single Source of Truth",
+  "tools": [
+    {
+      "name": "vibecheck.doctor",
+      "cli": "doctor",
+      "tier": "free",
+      "description": "Environment health check. Verifies dependencies, Node version, configs, permissions.",
+      "category": "setup",
+      "cacheable": true,
+      "cacheMaxAge": 300,
+      "timeout": 30000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "fix": { "type": "boolean", "description": "Auto-fix issues when possible", "default": false },
+          "category": { "type": "string", "enum": ["all", "system", "runtime", "project", "deps", "security"], "default": "all" }
+        }
+      },
+      "outputSchema": { "$ref": "../schemas/verdict.schema.json" }
+    },
+    {
+      "name": "vibecheck.init",
+      "cli": "init",
+      "tier": "free",
+      "description": "Initialize vibecheck for a project. Creates .vibecheck/ directory and Truth Pack.",
+      "category": "setup",
+      "cacheable": false,
+      "timeout": 60000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "force": { "type": "boolean", "description": "Overwrite existing config", "default": false }
+        }
+      },
+      "outputSchema": { "type": "object" }
+    },
+    {
+      "name": "vibecheck.scan",
+      "cli": "scan",
+      "tier": "free",
+      "description": "Deep code analysis: secrets, auth gaps, fake success, dead UI, billing bypasses, missing routes.",
+      "category": "analysis",
+      "cacheable": true,
+      "cacheMaxAge": 300,
+      "timeout": 120000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "profile": { "type": "string", "enum": ["quick", "full", "security", "billing", "ci"], "default": "quick" },
+          "type": { "type": "string", "enum": ["all", "secrets", "auth", "routes", "mocks", "billing"], "default": "all" },
+          "since": { "type": "string", "description": "Git commit for incremental scan" },
+          "baseline": { "type": "string", "description": "Baseline file path to suppress known findings" }
+        }
+      },
+      "outputSchema": { "$ref": "../schemas/verdict.schema.json" }
+    },
+    {
+      "name": "vibecheck.ship",
+      "cli": "ship",
+      "tier": "free",
+      "description": "Get ship verdict: SHIP/WARN/BLOCK with evidence. Returns top blockers and fix suggestions.",
+      "category": "analysis",
+      "cacheable": true,
+      "cacheMaxAge": 120,
+      "timeout": 90000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "strict": { "type": "boolean", "description": "Treat warnings as blockers", "default": false },
+          "ci": { "type": "boolean", "description": "CI mode with exit codes", "default": false },
+          "mockproof": { "type": "boolean", "description": "Include MockProof gate", "default": true }
+        }
+      },
+      "outputSchema": { "$ref": "../schemas/verdict.schema.json" }
+    },
+    {
+      "name": "vibecheck.prove",
+      "cli": "prove",
+      "tier": "pro",
+      "description": "One-command reality proof: ctx → reality → ship → fix loop until SHIP or stuck.",
+      "category": "verification",
+      "cacheable": false,
+      "timeout": 600000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "url": { "type": "string", "description": "Base URL for runtime testing" },
+          "auth": { "type": "string", "description": "Login credentials (email:password)" },
+          "storageState": { "type": "string", "description": "Playwright session state path" },
+          "maxFixRounds": { "type": "integer", "description": "Max auto-fix attempts", "default": 3, "minimum": 1, "maximum": 10 },
+          "skipReality": { "type": "boolean", "description": "Skip runtime testing", "default": false },
+          "skipFix": { "type": "boolean", "description": "Skip auto-fix", "default": false }
+        }
+      },
+      "outputSchema": { "$ref": "../schemas/verdict.schema.json" }
+    },
+    {
+      "name": "vibecheck.reality",
+      "cli": "reality",
+      "tier": "starter",
+      "description": "Runtime browser verification with Playwright. Two-pass auth verification, Dead UI detection.",
+      "category": "verification",
+      "cacheable": false,
+      "timeout": 300000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "url": { "type": "string", "description": "Base URL to verify" },
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "auth": { "type": "string", "description": "Login credentials (email:password)" },
+          "verifyAuth": { "type": "boolean", "description": "Enable two-pass auth verification", "default": false },
+          "storageState": { "type": "string", "description": "Playwright session state path" },
+          "maxPages": { "type": "integer", "description": "Max pages to crawl", "default": 18, "minimum": 1, "maximum": 100 },
+          "headed": { "type": "boolean", "description": "Run browser headed", "default": false },
+          "recordVideo": { "type": "boolean", "description": "Record video", "default": false },
+          "recordTrace": { "type": "boolean", "description": "Record Playwright trace", "default": false }
+        },
+        "required": ["url"]
+      },
+      "outputSchema": { "$ref": "../schemas/verdict.schema.json" }
+    },
+    {
+      "name": "vibecheck.fix",
+      "cli": "fix",
+      "tier": "free",
+      "tierGated": {
+        "apply": "pro",
+        "autopilot": "pro"
+      },
+      "description": "Generate fix plan or apply patches. Plan is FREE, apply requires PRO.",
+      "category": "remediation",
+      "cacheable": false,
+      "timeout": 300000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "promptOnly": { "type": "boolean", "description": "Generate prompts only", "default": false },
+          "apply": { "type": "boolean", "description": "Apply patches (PRO)", "default": false },
+          "autopilot": { "type": "boolean", "description": "Autopilot loop (PRO)", "default": false },
+          "maxMissions": { "type": "integer", "description": "Max missions", "default": 8, "minimum": 1, "maximum": 20 }
+        }
+      },
+      "outputSchema": { "type": "object" }
+    },
+    {
+      "name": "vibecheck.guard",
+      "cli": "guard",
+      "tier": "free",
+      "description": "Trust boundary enforcement. Validates claims, checks for hallucinations, prompt injection.",
+      "category": "validation",
+      "cacheable": true,
+      "cacheMaxAge": 60,
+      "timeout": 60000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "claims": { "type": "boolean", "description": "Verify AI claims", "default": false },
+          "hallucinations": { "type": "boolean", "description": "Check for hallucinations", "default": false },
+          "prompts": { "type": "boolean", "description": "Check for prompt injection", "default": false },
+          "strict": { "type": "boolean", "description": "Fail on warnings", "default": false }
+        }
+      },
+      "outputSchema": { "$ref": "../schemas/verdict.schema.json" }
+    },
+    {
+      "name": "vibecheck.ctx",
+      "cli": "ctx",
+      "tier": "free",
+      "description": "Generate Truth Pack with routes, env, auth, billing facts. Ground truth for AI agents.",
+      "category": "context",
+      "cacheable": true,
+      "cacheMaxAge": 600,
+      "timeout": 90000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "snapshot": { "type": "boolean", "description": "Save timestamped snapshot", "default": false },
+          "sync": { "type": "boolean", "description": "Sync contracts", "default": false }
+        }
+      },
+      "outputSchema": { "type": "object" }
+    },
+    {
+      "name": "vibecheck.report",
+      "cli": "report",
+      "tier": "free",
+      "tierGated": {
+        "sarif": "starter",
+        "pdf": "pro"
+      },
+      "description": "Generate reports: HTML, MD, SARIF, PDF. HTML/MD are FREE, SARIF requires STARTER.",
+      "category": "reporting",
+      "cacheable": true,
+      "cacheMaxAge": 300,
+      "timeout": 60000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "type": { "type": "string", "enum": ["executive", "technical", "compliance"], "default": "executive" },
+          "format": { "type": "string", "enum": ["html", "md", "json", "sarif", "csv", "pdf"], "default": "html" },
+          "output": { "type": "string", "description": "Output file path" },
+          "maxFindings": { "type": "integer", "description": "Max findings to include", "default": 50 }
+        }
+      },
+      "outputSchema": { "$ref": "../schemas/report-artifact.schema.json" }
+    },
+    {
+      "name": "vibecheck.polish",
+      "cli": "polish",
+      "tier": "free",
+      "description": "Production polish analyzer. Checks for rough edges, missing features, quality issues.",
+      "category": "analysis",
+      "cacheable": true,
+      "cacheMaxAge": 300,
+      "timeout": 60000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "category": { "type": "string", "enum": ["all", "frontend", "backend", "security", "performance", "accessibility", "seo"], "default": "all" },
+          "fix": { "type": "boolean", "description": "Auto-fix issues", "default": false }
+        }
+      },
+      "outputSchema": { "$ref": "../schemas/verdict.schema.json" }
+    },
+    {
+      "name": "vibecheck.get_truthpack",
+      "cli": null,
+      "tier": "free",
+      "description": "Get the full Truth Pack. Use BEFORE making claims about the codebase.",
+      "category": "query",
+      "cacheable": true,
+      "cacheMaxAge": 300,
+      "timeout": 30000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "refresh": { "type": "boolean", "description": "Force regenerate", "default": false }
+        }
+      },
+      "outputSchema": { "type": "object" }
+    },
+    {
+      "name": "vibecheck.validate_claim",
+      "cli": null,
+      "tier": "free",
+      "description": "Validate a claim about the codebase. Returns true/false/unknown with evidence.",
+      "category": "query",
+      "cacheable": false,
+      "timeout": 30000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "claim": { "type": "string", "description": "The claim to validate" },
+          "type": { "type": "string", "enum": ["route_exists", "env_var_used", "auth_enforced", "file_exists", "function_exists"], "description": "Claim type" }
+        },
+        "required": ["claim"]
+      },
+      "outputSchema": { "type": "object" }
+    },
+    {
+      "name": "vibecheck.search_evidence",
+      "cli": null,
+      "tier": "free",
+      "description": "Search for evidence with file/line citations.",
+      "category": "query",
+      "cacheable": true,
+      "cacheMaxAge": 60,
+      "timeout": 30000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "query": { "type": "string", "description": "Search query" },
+          "type": { "type": "string", "enum": ["route", "handler", "middleware", "component", "env_var", "model", "any"], "default": "any" },
+          "limit": { "type": "integer", "description": "Max results", "default": 10, "minimum": 1, "maximum": 50 }
+        },
+        "required": ["query"]
+      },
+      "outputSchema": { "type": "object" }
+    },
+    {
+      "name": "vibecheck.status",
+      "cli": "status",
+      "tier": "free",
+      "description": "Get vibecheck status: last verdict, findings count, truthpack freshness.",
+      "category": "utility",
+      "cacheable": true,
+      "cacheMaxAge": 30,
+      "timeout": 10000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." }
+        }
+      },
+      "outputSchema": { "type": "object" }
+    },
+    {
+      "name": "vibecheck.share",
+      "cli": "share",
+      "tier": "starter",
+      "description": "Generate share bundle for PR/review. Creates share.json, share.md, pr_comment.md.",
+      "category": "utility",
+      "cacheable": false,
+      "timeout": 30000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "missionDir": { "type": "string", "description": "Specific mission directory" }
+        }
+      },
+      "outputSchema": { "$ref": "../schemas/report-artifact.schema.json" }
+    },
+    {
+      "name": "vibecheck.badge",
+      "cli": "badge",
+      "tier": "starter",
+      "description": "Generate ship badge for README/PR showing scan status.",
+      "category": "utility",
+      "cacheable": true,
+      "cacheMaxAge": 3600,
+      "timeout": 10000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "format": { "type": "string", "enum": ["svg", "md", "html"], "default": "svg" },
+          "style": { "type": "string", "enum": ["flat", "flat-square"], "default": "flat" }
+        }
+      },
+      "outputSchema": { "$ref": "../schemas/report-artifact.schema.json" }
+    },
+    {
+      "name": "vibecheck.list_reports",
+      "cli": null,
+      "tier": "free",
+      "description": "List available report artifacts in .vibecheck/",
+      "category": "utility",
+      "cacheable": true,
+      "cacheMaxAge": 30,
+      "timeout": 5000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "type": { "type": "string", "enum": ["all", "verdict", "scan", "reality", "fix", "share"], "default": "all" },
+          "limit": { "type": "integer", "description": "Max results", "default": 10 }
+        }
+      },
+      "outputSchema": { "type": "array", "items": { "$ref": "../schemas/report-artifact.schema.json" } }
+    },
+    {
+      "name": "vibecheck.get_last_verdict",
+      "cli": null,
+      "tier": "free",
+      "description": "Get last ship verdict (cached, fast).",
+      "category": "utility",
+      "cacheable": true,
+      "cacheMaxAge": 60,
+      "timeout": 5000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." }
+        }
+      },
+      "outputSchema": { "$ref": "../schemas/verdict.schema.json" }
+    },
+    {
+      "name": "vibecheck.get_finding",
+      "cli": null,
+      "tier": "free",
+      "description": "Get a specific finding by ID with full evidence.",
+      "category": "utility",
+      "cacheable": true,
+      "cacheMaxAge": 300,
+      "timeout": 5000,
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "projectPath": { "type": "string", "description": "Path to project root", "default": "." },
+          "findingId": { "type": "string", "description": "Finding ID" }
+        },
+        "required": ["findingId"]
+      },
+      "outputSchema": { "$ref": "../schemas/finding.schema.json" }
+    }
+  ],
+  "aliases": {
+    "vibecheck.context": "vibecheck.ctx",
+    "vibecheck.verify": "vibecheck.reality",
+    "vibecheck.gate": "vibecheck.ship",
+    "vibecheck.proof": "vibecheck.prove",
+    "vibecheck.compile_context": "vibecheck.ctx",
+    "vibecheck.check_invariants": "vibecheck.guard",
+    "vibecheck.autopilot_plan": "vibecheck.fix",
+    "vibecheck.autopilot_apply": "vibecheck.fix"
+  },
+  "deprecated": [
+    {
+      "name": "vibecheck.intelligence.*",
+      "reason": "Not CLI-backed. Use vibecheck.scan with appropriate profile.",
+      "replacement": "vibecheck.scan",
+      "removeIn": "4.0.0"
+    },
+    {
+      "name": "vibecheck_architect_*",
+      "reason": "Not CLI-backed. Use vibecheck.ctx for context.",
+      "replacement": "vibecheck.ctx",
+      "removeIn": "4.0.0"
+    },
+    {
+      "name": "vibecheck_checkpoint*",
+      "reason": "Not CLI-backed. Use vibecheck.guard for validation.",
+      "replacement": "vibecheck.guard",
+      "removeIn": "4.0.0"
+    },
+    {
+      "name": "vibecheck_intent_*",
+      "reason": "Not CLI-backed. Use vibecheck.guard --claims.",
+      "replacement": "vibecheck.guard",
+      "removeIn": "4.0.0"
+    },
+    {
+      "name": "vibecheckai.dev-test",
+      "reason": "Experimental. Use vibecheck.reality for runtime testing.",
+      "replacement": "vibecheck.reality",
+      "removeIn": "4.0.0"
+    },
+    {
+      "name": "vibecheck.add_assumption",
+      "reason": "Not CLI-backed.",
+      "replacement": null,
+      "removeIn": "4.0.0"
+    },
+    {
+      "name": "vibecheck.autopilot",
+      "reason": "Experimental. Use vibecheck.fix with --autopilot.",
+      "replacement": "vibecheck.fix",
+      "removeIn": "4.0.0"
+    }
+  ],
+  "categories": {
+    "setup": { "description": "Project setup and health", "order": 1 },
+    "analysis": { "description": "Code analysis and scanning", "order": 2 },
+    "verification": { "description": "Runtime verification", "order": 3 },
+    "validation": { "description": "Trust boundary validation", "order": 4 },
+    "remediation": { "description": "Fix generation and application", "order": 5 },
+    "context": { "description": "Context and truth pack", "order": 6 },
+    "reporting": { "description": "Report generation", "order": 7 },
+    "query": { "description": "Evidence queries", "order": 8 },
+    "utility": { "description": "Utility tools", "order": 9 }
+  },
+  "tiers": {
+    "free": { "name": "FREE", "order": 0 },
+    "starter": { "name": "STARTER", "price": 39, "order": 1 },
+    "pro": { "name": "PRO", "price": 99, "order": 2 },
+    "compliance": { "name": "COMPLIANCE", "order": 3 }
+  }
+}

package/mcp-server/schemas/error-envelope.schema.json

@@ -0,0 +1,125 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://vibecheck.dev/schemas/error-envelope.json",
+  "x-schemaVersion": "1.0.0",
+  "title": "ErrorEnvelope",
+  "description": "Standardized error response for all vibecheck MCP tools. Never returns raw stack traces.",
+  "type": "object",
+  "properties": {
+    "ok": {
+      "type": "boolean",
+      "const": false
+    },
+    "error": {
+      "type": "object",
+      "properties": {
+        "code": {
+          "type": "string",
+          "description": "Machine-readable error code",
+          "enum": [
+            "INVALID_INPUT",
+            "VALIDATION_ERROR",
+            "PATH_NOT_FOUND",
+            "PATH_OUTSIDE_SANDBOX",
+            "PERMISSION_DENIED",
+            "TIER_REQUIRED",
+            "RATE_LIMITED",
+            "TIMEOUT",
+            "CANCELLED",
+            "CLI_ERROR",
+            "INTERNAL_ERROR",
+            "NOT_FOUND",
+            "ALREADY_EXISTS",
+            "DEPENDENCY_MISSING",
+            "CONFIG_ERROR",
+            "NETWORK_ERROR",
+            "TRUTH_FIREWALL_REQUIRED"
+          ]
+        },
+        "message": {
+          "type": "string",
+          "description": "Human-readable error message",
+          "maxLength": 1000
+        },
+        "details": {
+          "type": "object",
+          "description": "Additional error details",
+          "additionalProperties": true
+        },
+        "retryable": {
+          "type": "boolean",
+          "description": "Whether this error is retryable",
+          "default": false
+        },
+        "retryAfterMs": {
+          "type": "integer",
+          "description": "Suggested retry delay in milliseconds",
+          "minimum": 0
+        },
+        "userAction": {
+          "type": "string",
+          "description": "Suggested action for the user to take",
+          "maxLength": 500
+        },
+        "docsUrl": {
+          "type": "string",
+          "format": "uri",
+          "description": "Link to relevant documentation"
+        }
+      },
+      "required": ["code", "message"],
+      "additionalProperties": false
+    },
+    "requestId": {
+      "type": "string",
+      "description": "Request ID for tracing"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time"
+    }
+  },
+  "required": ["ok", "error", "timestamp"],
+  "additionalProperties": false,
+  "examples": [
+    {
+      "ok": false,
+      "error": {
+        "code": "PATH_OUTSIDE_SANDBOX",
+        "message": "Path '/etc/passwd' is outside the allowed workspace",
+        "retryable": false,
+        "userAction": "Provide a path within your project workspace"
+      },
+      "requestId": "req_abc123",
+      "timestamp": "2024-01-15T10:30:00Z"
+    },
+    {
+      "ok": false,
+      "error": {
+        "code": "TIER_REQUIRED",
+        "message": "This feature requires PRO tier",
+        "details": {
+          "requiredTier": "pro",
+          "currentTier": "free",
+          "feature": "fix.apply_patches"
+        },
+        "retryable": false,
+        "userAction": "Upgrade to PRO tier at https://vibecheck.dev/pricing"
+      },
+      "requestId": "req_def456",
+      "timestamp": "2024-01-15T10:30:00Z"
+    },
+    {
+      "ok": false,
+      "error": {
+        "code": "TIMEOUT",
+        "message": "Operation timed out after 120000ms",
+        "retryable": true,
+        "retryAfterMs": 5000,
+        "userAction": "Try again with a smaller scope or increase timeout"
+      },
+      "requestId": "req_ghi789",
+      "timestamp": "2024-01-15T10:30:00Z"
+    }
+  ]
+}