@vibecheckai/cli 3.0.3 → 3.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/bin/cli-hygiene.js +241 -0
  2. package/bin/guardrail.js +834 -0
  3. package/bin/runners/cli-utils.js +1070 -0
  4. package/bin/runners/context/ai-task-decomposer.js +337 -0
  5. package/bin/runners/context/analyzer.js +462 -0
  6. package/bin/runners/context/api-contracts.js +427 -0
  7. package/bin/runners/context/context-diff.js +342 -0
  8. package/bin/runners/context/context-pruner.js +291 -0
  9. package/bin/runners/context/dependency-graph.js +414 -0
  10. package/bin/runners/context/generators/claude.js +107 -0
  11. package/bin/runners/context/generators/codex.js +108 -0
  12. package/bin/runners/context/generators/copilot.js +119 -0
  13. package/bin/runners/context/generators/cursor.js +514 -0
  14. package/bin/runners/context/generators/mcp.js +151 -0
  15. package/bin/runners/context/generators/windsurf.js +180 -0
  16. package/bin/runners/context/git-context.js +302 -0
  17. package/bin/runners/context/index.js +1042 -0
  18. package/bin/runners/context/insights.js +173 -0
  19. package/bin/runners/context/mcp-server/generate-rules.js +337 -0
  20. package/bin/runners/context/mcp-server/index.js +1176 -0
  21. package/bin/runners/context/mcp-server/package.json +24 -0
  22. package/bin/runners/context/memory.js +200 -0
  23. package/bin/runners/context/monorepo.js +215 -0
  24. package/bin/runners/context/multi-repo-federation.js +404 -0
  25. package/bin/runners/context/patterns.js +253 -0
  26. package/bin/runners/context/proof-context.js +972 -0
  27. package/bin/runners/context/security-scanner.js +303 -0
  28. package/bin/runners/context/semantic-search.js +350 -0
  29. package/bin/runners/context/shared.js +264 -0
  30. package/bin/runners/context/team-conventions.js +310 -0
  31. package/bin/runners/lib/ai-bridge.js +416 -0
  32. package/bin/runners/lib/analysis-core.js +271 -0
  33. package/bin/runners/lib/analyzers.js +541 -0
  34. package/bin/runners/lib/audit-bridge.js +391 -0
  35. package/bin/runners/lib/auth-truth.js +193 -0
  36. package/bin/runners/lib/auth.js +215 -0
  37. package/bin/runners/lib/backup.js +62 -0
  38. package/bin/runners/lib/billing.js +107 -0
  39. package/bin/runners/lib/claims.js +118 -0
  40. package/bin/runners/lib/cli-ui.js +540 -0
  41. package/bin/runners/lib/compliance-bridge-new.js +0 -0
  42. package/bin/runners/lib/compliance-bridge.js +165 -0
  43. package/bin/runners/lib/contracts/auth-contract.js +194 -0
  44. package/bin/runners/lib/contracts/env-contract.js +178 -0
  45. package/bin/runners/lib/contracts/external-contract.js +198 -0
  46. package/bin/runners/lib/contracts/guard.js +168 -0
  47. package/bin/runners/lib/contracts/index.js +89 -0
  48. package/bin/runners/lib/contracts/plan-validator.js +311 -0
  49. package/bin/runners/lib/contracts/route-contract.js +192 -0
  50. package/bin/runners/lib/detect.js +89 -0
  51. package/bin/runners/lib/doctor/autofix.js +254 -0
  52. package/bin/runners/lib/doctor/index.js +37 -0
  53. package/bin/runners/lib/doctor/modules/dependencies.js +325 -0
  54. package/bin/runners/lib/doctor/modules/index.js +46 -0
  55. package/bin/runners/lib/doctor/modules/network.js +250 -0
  56. package/bin/runners/lib/doctor/modules/project.js +312 -0
  57. package/bin/runners/lib/doctor/modules/runtime.js +224 -0
  58. package/bin/runners/lib/doctor/modules/security.js +348 -0
  59. package/bin/runners/lib/doctor/modules/system.js +213 -0
  60. package/bin/runners/lib/doctor/modules/vibecheck.js +394 -0
  61. package/bin/runners/lib/doctor/reporter.js +262 -0
  62. package/bin/runners/lib/doctor/service.js +262 -0
  63. package/bin/runners/lib/doctor/types.js +113 -0
  64. package/bin/runners/lib/doctor/ui.js +263 -0
  65. package/bin/runners/lib/doctor-enhanced.js +233 -0
  66. package/bin/runners/lib/doctor-v2.js +608 -0
  67. package/bin/runners/lib/enforcement.js +72 -0
  68. package/bin/vibecheck.js +0 -0
  69. package/package.json +8 -9
@@ -0,0 +1,215 @@
1
+ const fs = require("fs");
2
+ const path = require("path");
3
+ const os = require("os");
4
+
5
+ // Config paths
6
+ function getConfigPath() {
7
+ const home = os.homedir();
8
+ if (process.platform === "win32") {
9
+ return path.join(
10
+ process.env.APPDATA || path.join(home, "AppData", "Roaming"),
11
+ "vibecheck",
12
+ "config.json",
13
+ );
14
+ }
15
+ return path.join(home, ".config", "vibecheck", "config.json");
16
+ }
17
+
18
+ function ensureConfigDir(configPath) {
19
+ const dir = path.dirname(configPath);
20
+ if (!fs.existsSync(dir)) {
21
+ fs.mkdirSync(dir, { recursive: true });
22
+ }
23
+ }
24
+
25
+ // 1. Get API Key
26
+ function getApiKey() {
27
+ // 1. Env var (CI/Production)
28
+ if (process.env.VIBECHECK_API_KEY) {
29
+ return { key: process.env.VIBECHECK_API_KEY, source: "env" };
30
+ }
31
+
32
+ // 2. User config
33
+ try {
34
+ const configPath = getConfigPath();
35
+ if (fs.existsSync(configPath)) {
36
+ const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
37
+ if (config.apiKey) {
38
+ return { key: config.apiKey, source: "user" };
39
+ }
40
+ }
41
+ } catch (err) {
42
+ // ignore config errors
43
+ }
44
+
45
+ return { key: null, source: null };
46
+ }
47
+
48
+ // 2. Save API Key
49
+ function saveApiKey(apiKey) {
50
+ const configPath = getConfigPath();
51
+ ensureConfigDir(configPath);
52
+
53
+ let config = {};
54
+ try {
55
+ if (fs.existsSync(configPath)) {
56
+ config = JSON.parse(fs.readFileSync(configPath, "utf8"));
57
+ }
58
+ } catch (err) {
59
+ // ignore, start fresh
60
+ }
61
+
62
+ config.apiKey = apiKey;
63
+ // Also save a basic user structure if needed, but for now just key
64
+
65
+ fs.writeFileSync(configPath, JSON.stringify(config, null, 2), {
66
+ mode: 0o600,
67
+ });
68
+ }
69
+
70
+ // 3. Delete API Key
71
+ function deleteApiKey() {
72
+ const configPath = getConfigPath();
73
+ try {
74
+ if (fs.existsSync(configPath)) {
75
+ const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
76
+ delete config.apiKey;
77
+ fs.writeFileSync(configPath, JSON.stringify(config, null, 2), {
78
+ mode: 0o600,
79
+ });
80
+ }
81
+ } catch (err) {
82
+ // ignore
83
+ }
84
+ }
85
+
86
+ // 4. Get Entitlements (Mocked for now, but ready for API)
87
+ // In real world: fetch from GET /v1/auth/whoami
88
+ async function getEntitlements(apiKey) {
89
+ if (!apiKey) return null;
90
+
91
+ // Check cache first
92
+ const configPath = getConfigPath();
93
+ const cachePath = path.join(
94
+ path.dirname(configPath),
95
+ "entitlements-cache.json",
96
+ );
97
+
98
+ try {
99
+ if (fs.existsSync(cachePath)) {
100
+ const cache = JSON.parse(fs.readFileSync(cachePath, "utf8"));
101
+ // Check if same key and fresh (10 mins)
102
+ if (
103
+ cache.keyHash === Buffer.from(apiKey).toString("base64") &&
104
+ Date.now() - cache.timestamp < 10 * 60 * 1000
105
+ ) {
106
+ return cache.data;
107
+ }
108
+ }
109
+ } catch (err) {
110
+ // ignore cache errors
111
+ }
112
+
113
+ // Simulate API delay
114
+ // await new Promise(r => setTimeout(r, 100));
115
+
116
+ // Call the real API endpoint
117
+ let res;
118
+ try {
119
+ // Try production API first, then fallback to localhost for development
120
+ const apiUrl =
121
+ process.env.VIBECHECK_API_URL || "https://api.vibecheckai.dev";
122
+ const urls = [apiUrl, "http://localhost:3000"];
123
+
124
+ for (const url of urls) {
125
+ try {
126
+ res = await fetch(`${url}/v1/auth/whoami`, {
127
+ headers: {
128
+ Authorization: `Bearer ${apiKey}`,
129
+ },
130
+ signal: AbortSignal.timeout(5000), // 5 second timeout
131
+ });
132
+ if (res.ok) break;
133
+ } catch (e) {
134
+ // Try next URL
135
+ continue;
136
+ }
137
+ }
138
+
139
+ if (!res || !res.ok) {
140
+ throw new Error("API unavailable");
141
+ }
142
+ } catch (error) {
143
+ // SECURITY: Do not fallback to mock entitlements
144
+ // If API is unavailable, fail gracefully with clear error message
145
+ throw new Error(
146
+ "Cannot connect to vibecheck API. API connection required for this feature. " +
147
+ "Please check your network connection and ensure VIBECHECK_API_URL is set correctly."
148
+ );
149
+ }
150
+
151
+ if (!res.ok) {
152
+ throw new Error(`API returned ${res.status}: ${res.statusText}`);
153
+ }
154
+
155
+ const result = await res.json();
156
+
157
+ // Write to cache
158
+ try {
159
+ ensureConfigDir(cachePath);
160
+ fs.writeFileSync(
161
+ cachePath,
162
+ JSON.stringify(
163
+ {
164
+ keyHash: Buffer.from(apiKey).toString("base64"),
165
+ timestamp: Date.now(),
166
+ data: result,
167
+ },
168
+ null,
169
+ 2,
170
+ ),
171
+ );
172
+ } catch (err) {
173
+ // ignore cache write errors
174
+ }
175
+
176
+ return result;
177
+ }
178
+
179
+ // 5. Check Entitlement
180
+ async function checkEntitlement(requiredScope) {
181
+ const { key } = getApiKey();
182
+ if (!key) {
183
+ return {
184
+ allowed: false,
185
+ reason:
186
+ 'No API key found. Run "vibecheck login" or set VIBECHECK_API_KEY.',
187
+ };
188
+ }
189
+
190
+ const entitlements = await getEntitlements(key);
191
+ if (!entitlements) {
192
+ return { allowed: false, reason: "Invalid API key." };
193
+ }
194
+
195
+ if (
196
+ entitlements.scopes.includes(requiredScope) ||
197
+ entitlements.scopes.includes("*")
198
+ ) {
199
+ return { allowed: true, plan: entitlements.plan };
200
+ }
201
+
202
+ return {
203
+ allowed: false,
204
+ reason: `Plan '${entitlements.plan}' does not support this feature. Required scope: ${requiredScope}`,
205
+ };
206
+ }
207
+
208
+ module.exports = {
209
+ getApiKey,
210
+ saveApiKey,
211
+ deleteApiKey,
212
+ getEntitlements,
213
+ checkEntitlement,
214
+ getConfigPath,
215
+ };
@@ -0,0 +1,62 @@
1
+ // bin/runners/lib/backup.js
2
+ const fs = require("fs");
3
+ const path = require("path");
4
+
5
+ function ensureDir(p) {
6
+ fs.mkdirSync(p, { recursive: true });
7
+ }
8
+
9
+ function backupFiles(repoRoot, fileRelPaths, backupRoot) {
10
+ ensureDir(backupRoot);
11
+
12
+ const saved = [];
13
+ for (const rel of fileRelPaths) {
14
+ const abs = path.join(repoRoot, rel);
15
+ if (!fs.existsSync(abs)) {
16
+ saved.push({ rel, existed: false });
17
+ continue;
18
+ }
19
+
20
+ const dest = path.join(backupRoot, rel);
21
+ ensureDir(path.dirname(dest));
22
+ fs.copyFileSync(abs, dest);
23
+ saved.push({ rel, existed: true });
24
+ }
25
+
26
+ fs.writeFileSync(
27
+ path.join(backupRoot, "_manifest.json"),
28
+ JSON.stringify({ saved }, null, 2),
29
+ "utf8"
30
+ );
31
+
32
+ return saved;
33
+ }
34
+
35
+ function restoreBackup(repoRoot, backupRoot) {
36
+ const manifestPath = path.join(backupRoot, "_manifest.json");
37
+ if (!fs.existsSync(manifestPath)) {
38
+ return { ok: false, error: "backup manifest missing" };
39
+ }
40
+
41
+ const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
42
+ const saved = manifest.saved || [];
43
+
44
+ for (const s of saved) {
45
+ const abs = path.join(repoRoot, s.rel);
46
+ const bak = path.join(backupRoot, s.rel);
47
+
48
+ if (!s.existed) {
49
+ if (fs.existsSync(abs)) fs.rmSync(abs, { force: true });
50
+ continue;
51
+ }
52
+
53
+ if (fs.existsSync(bak)) {
54
+ ensureDir(path.dirname(abs));
55
+ fs.copyFileSync(bak, abs);
56
+ }
57
+ }
58
+
59
+ return { ok: true };
60
+ }
61
+
62
+ module.exports = { backupFiles, restoreBackup };
@@ -0,0 +1,107 @@
1
+ // bin/runners/lib/billing.js
2
+ const fg = require("fast-glob");
3
+ const fs = require("fs");
4
+ const path = require("path");
5
+ const crypto = require("crypto");
6
+
7
+ function sha256(text) {
8
+ return "sha256:" + crypto.createHash("sha256").update(text).digest("hex");
9
+ }
10
+
11
+ function safeRead(fileAbs) {
12
+ return fs.readFileSync(fileAbs, "utf8");
13
+ }
14
+
15
+ function evidenceFromLine({ fileAbs, repoRoot, lineNo, reason }) {
16
+ const fileRel = path.relative(repoRoot, fileAbs).replace(/\\/g, "/");
17
+ const lines = safeRead(fileAbs).split(/\r?\n/);
18
+ const idx = Math.max(0, Math.min(lines.length - 1, lineNo - 1));
19
+ const snippet = lines[idx] || "";
20
+ return {
21
+ id: `ev_${crypto.randomBytes(4).toString("hex")}`,
22
+ file: fileRel,
23
+ lines: `${lineNo}-${lineNo}`,
24
+ snippetHash: sha256(snippet),
25
+ reason
26
+ };
27
+ }
28
+
29
+ function findLineMatches(code, regex) {
30
+ const out = [];
31
+ const lines = code.split(/\r?\n/);
32
+ for (let i = 0; i < lines.length; i++) {
33
+ if (regex.test(lines[i])) out.push(i + 1);
34
+ }
35
+ return out;
36
+ }
37
+
38
+ function classifyStripeSignals(code) {
39
+ const signals = {
40
+ usesStripeSdk: /\bstripe\b/i.test(code) && /from\s+['"]stripe['"]|require\(['"]stripe['"]\)/.test(code),
41
+ webhookConstructEvent: /\bconstructEvent(Async)?\b/.test(code) || /\bstripe\.webhooks\.constructEvent\b/.test(code),
42
+ readsStripeSignatureHeader: /stripe-signature/i.test(code) || /\bStripe-Signature\b/.test(code),
43
+ rawBodySignal:
44
+ /\bbodyParser\s*:\s*false\b/.test(code) ||
45
+ /\breq\.(text|arrayBuffer)\(\)/.test(code) ||
46
+ /\brawBody\b/.test(code) || /\brequest\.raw\b/.test(code) || /\bcontentTypeParser\b/i.test(code),
47
+ idempotencySignal:
48
+ /\bevent\.id\b/.test(code) && /\b(prisma|db|redis|cache|processed|dedupe|idempotent)\b/i.test(code) ||
49
+ /\bidempotenc(y|e)\b/i.test(code)
50
+ };
51
+
52
+ return signals;
53
+ }
54
+
55
+ async function buildBillingTruth(repoRoot) {
56
+ const files = await fg(["**/*.{ts,tsx,js,jsx}"], {
57
+ cwd: repoRoot,
58
+ absolute: true,
59
+ ignore: ["**/node_modules/**", "**/.next/**", "**/dist/**", "**/build/**"]
60
+ });
61
+
62
+ const webhookCandidates = [];
63
+ const stripeFiles = [];
64
+
65
+ for (const fileAbs of files) {
66
+ const fileRel = path.relative(repoRoot, fileAbs).replace(/\\/g, "/");
67
+ const code = safeRead(fileAbs);
68
+
69
+ const signals = classifyStripeSignals(code);
70
+
71
+ if (signals.usesStripeSdk) stripeFiles.push(fileRel);
72
+
73
+ if (signals.webhookConstructEvent || signals.readsStripeSignatureHeader) {
74
+ const ev = [];
75
+ const lines1 = findLineMatches(code, /\bconstructEvent(Async)?\b|stripe\.webhooks\.constructEvent/);
76
+ const lines2 = findLineMatches(code, /stripe-signature|Stripe-Signature/i);
77
+ const lines3 = findLineMatches(code, /bodyParser\s*:\s*false|req\.(text|arrayBuffer)\(|rawBody|contentTypeParser/i);
78
+ const lines4 = findLineMatches(code, /event\.id|idempotenc(y|e)|dedupe|processed/i);
79
+
80
+ for (const ln of lines1.slice(0, 3)) ev.push(evidenceFromLine({ fileAbs, repoRoot, lineNo: ln, reason: "Stripe webhook signature constructEvent signal" }));
81
+ for (const ln of lines2.slice(0, 3)) ev.push(evidenceFromLine({ fileAbs, repoRoot, lineNo: ln, reason: "Stripe-Signature header usage signal" }));
82
+ for (const ln of lines3.slice(0, 3)) ev.push(evidenceFromLine({ fileAbs, repoRoot, lineNo: ln, reason: "Raw body handling signal (required for Stripe verification)" }));
83
+ for (const ln of lines4.slice(0, 3)) ev.push(evidenceFromLine({ fileAbs, repoRoot, lineNo: ln, reason: "Idempotency/dedupe signal (event replay protection)" }));
84
+
85
+ webhookCandidates.push({
86
+ file: fileRel,
87
+ signals,
88
+ evidence: ev
89
+ });
90
+ }
91
+ }
92
+
93
+ const hasStripe = stripeFiles.length > 0;
94
+
95
+ return {
96
+ hasStripe,
97
+ stripeFiles: stripeFiles.slice(0, 200),
98
+ webhookCandidates,
99
+ summary: {
100
+ webhookHandlersFound: webhookCandidates.length,
101
+ verifiedWebhookHandlers: webhookCandidates.filter(w => w.signals.webhookConstructEvent && w.signals.rawBodySignal).length,
102
+ idempotentWebhookHandlers: webhookCandidates.filter(w => w.signals.idempotencySignal).length
103
+ }
104
+ };
105
+ }
106
+
107
+ module.exports = { buildBillingTruth };
@@ -0,0 +1,118 @@
1
+ // bin/runners/lib/claims.js
2
+ const { canonicalizeMethod, canonicalizePath } = require("./truth");
3
+
4
+ function escapeRegex(s) {
5
+ return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
6
+ }
7
+
8
+ function compileRoutePattern(routePath) {
9
+ const parts = routePath.split("/").filter(Boolean);
10
+ const reParts = parts.map(seg => {
11
+ if (seg.startsWith(":")) return "([^/]+)";
12
+ if (seg.startsWith("*")) {
13
+ const optional = seg.endsWith("?");
14
+ return optional ? "(.*)?" : "(.*)";
15
+ }
16
+ return escapeRegex(seg);
17
+ });
18
+ return new RegExp("^/" + reParts.join("/") + "$");
19
+ }
20
+
21
+ function routeMatches(routeDef, method, path) {
22
+ const m = method === "*" ? "*" : method;
23
+ const rm = routeDef.method;
24
+
25
+ const methodOk = (rm === "*" || m === "*" || rm === m);
26
+ if (!methodOk) return false;
27
+
28
+ if (routeDef.path === path) return true;
29
+ return compileRoutePattern(routeDef.path).test(path);
30
+ }
31
+
32
+ function validateClaimRouteExists(truthpack, claim) {
33
+ const method = canonicalizeMethod(claim?.subject?.method || "*");
34
+ const path = canonicalizePath(claim?.subject?.path || "/");
35
+
36
+ const server = truthpack?.routes?.server || [];
37
+ const matches = server.filter(r => routeMatches(r, method, path));
38
+
39
+ if (matches.length) {
40
+ // pick best confidence
41
+ const score = c => (c === "high" ? 3 : c === "med" ? 2 : 1);
42
+ matches.sort((a,b) => score(b.confidence) - score(a.confidence));
43
+ const best = matches[0];
44
+
45
+ return {
46
+ id: claim.id,
47
+ result: "true",
48
+ confidence: best.confidence,
49
+ evidence: best.evidence || [],
50
+ assumptions: [],
51
+ gaps: [],
52
+ nextSteps: []
53
+ };
54
+ }
55
+
56
+ const gaps = truthpack?.routes?.gaps || [];
57
+ const hasGaps = gaps.length > 0;
58
+
59
+ return {
60
+ id: claim.id,
61
+ result: hasGaps ? "unknown" : "false",
62
+ confidence: hasGaps ? "low" : "high",
63
+ evidence: [],
64
+ assumptions: hasGaps ? ["Fastify plugin resolution incomplete"] : [],
65
+ gaps,
66
+ nextSteps: hasGaps ? ["Resolve Fastify plugin imports (relative) or add optional runtime route dump mode later"] : []
67
+ };
68
+ }
69
+
70
+ function validateClaimEnvVarUsed(truthpack, claim) {
71
+ const name = String(claim?.subject?.name || "").trim();
72
+ const vars = truthpack?.env?.vars || [];
73
+ const hit = vars.find(v => v.name === name);
74
+
75
+ if (hit) {
76
+ return {
77
+ id: claim.id,
78
+ result: "true",
79
+ confidence: hit.references?.length ? "high" : "med",
80
+ evidence: hit.references || [],
81
+ assumptions: [],
82
+ gaps: [],
83
+ nextSteps: []
84
+ };
85
+ }
86
+ return {
87
+ id: claim.id,
88
+ result: "false",
89
+ confidence: "high",
90
+ evidence: [],
91
+ assumptions: [],
92
+ gaps: [],
93
+ nextSteps: []
94
+ };
95
+ }
96
+
97
+ function validateClaimEnvVarDeclared(truthpack, claim) {
98
+ const name = String(claim?.subject?.name || "").trim();
99
+ const declared = truthpack?.env?.declared || [];
100
+ const ok = declared.includes(name);
101
+
102
+ return {
103
+ id: claim.id,
104
+ result: ok ? "true" : "false",
105
+ confidence: "high",
106
+ evidence: [],
107
+ assumptions: [],
108
+ gaps: [],
109
+ nextSteps: ok ? [] : ["Add to .env.example/.env.template so the project contract is real"]
110
+ };
111
+ }
112
+
113
+ module.exports = {
114
+ routeMatches,
115
+ validateClaimRouteExists,
116
+ validateClaimEnvVarUsed,
117
+ validateClaimEnvVarDeclared
118
+ };