@vibecheckai/cli 3.5.0 → 3.5.2

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 (224) hide show
  1. package/bin/registry.js +214 -237
  2. package/bin/runners/cli-utils.js +33 -2
  3. package/bin/runners/context/analyzer.js +52 -1
  4. package/bin/runners/context/generators/cursor.js +2 -49
  5. package/bin/runners/context/git-context.js +3 -1
  6. package/bin/runners/context/team-conventions.js +33 -7
  7. package/bin/runners/lib/analysis-core.js +25 -5
  8. package/bin/runners/lib/analyzers.js +431 -481
  9. package/bin/runners/lib/default-config.js +127 -0
  10. package/bin/runners/lib/doctor/modules/security.js +3 -1
  11. package/bin/runners/lib/engine/ast-cache.js +210 -0
  12. package/bin/runners/lib/engine/auth-extractor.js +211 -0
  13. package/bin/runners/lib/engine/billing-extractor.js +112 -0
  14. package/bin/runners/lib/engine/enforcement-extractor.js +100 -0
  15. package/bin/runners/lib/engine/env-extractor.js +207 -0
  16. package/bin/runners/lib/engine/express-extractor.js +208 -0
  17. package/bin/runners/lib/engine/extractors.js +849 -0
  18. package/bin/runners/lib/engine/index.js +207 -0
  19. package/bin/runners/lib/engine/repo-index.js +514 -0
  20. package/bin/runners/lib/engine/types.js +124 -0
  21. package/bin/runners/lib/engines/accessibility-engine.js +18 -218
  22. package/bin/runners/lib/engines/api-consistency-engine.js +30 -335
  23. package/bin/runners/lib/engines/cross-file-analysis-engine.js +27 -292
  24. package/bin/runners/lib/engines/empty-catch-engine.js +17 -127
  25. package/bin/runners/lib/engines/mock-data-engine.js +10 -53
  26. package/bin/runners/lib/engines/performance-issues-engine.js +36 -176
  27. package/bin/runners/lib/engines/security-vulnerabilities-engine.js +54 -382
  28. package/bin/runners/lib/engines/type-aware-engine.js +39 -263
  29. package/bin/runners/lib/engines/vibecheck-engines/index.js +13 -122
  30. package/bin/runners/lib/engines/vibecheck-engines/lib/ast-cache.js +164 -0
  31. package/bin/runners/lib/engines/vibecheck-engines/lib/code-quality-engine.js +291 -0
  32. package/bin/runners/lib/engines/vibecheck-engines/lib/console-logs-engine.js +83 -0
  33. package/bin/runners/lib/engines/vibecheck-engines/lib/dead-code-engine.js +198 -0
  34. package/bin/runners/lib/engines/vibecheck-engines/lib/deprecated-api-engine.js +275 -0
  35. package/bin/runners/lib/engines/vibecheck-engines/lib/empty-catch-engine.js +167 -0
  36. package/bin/runners/lib/engines/vibecheck-engines/lib/file-filter.js +217 -0
  37. package/bin/runners/lib/engines/vibecheck-engines/lib/hardcoded-secrets-engine.js +73 -373
  38. package/bin/runners/lib/engines/vibecheck-engines/lib/mock-data-engine.js +140 -0
  39. package/bin/runners/lib/engines/vibecheck-engines/lib/parallel-processor.js +164 -0
  40. package/bin/runners/lib/engines/vibecheck-engines/lib/performance-issues-engine.js +234 -0
  41. package/bin/runners/lib/engines/vibecheck-engines/lib/type-aware-engine.js +217 -0
  42. package/bin/runners/lib/engines/vibecheck-engines/lib/unsafe-regex-engine.js +78 -0
  43. package/bin/runners/lib/entitlements-v2.js +73 -97
  44. package/bin/runners/lib/error-handler.js +44 -3
  45. package/bin/runners/lib/error-messages.js +289 -0
  46. package/bin/runners/lib/evidence-pack.js +7 -1
  47. package/bin/runners/lib/finding-id.js +69 -0
  48. package/bin/runners/lib/finding-sorter.js +89 -0
  49. package/bin/runners/lib/html-proof-report.js +700 -350
  50. package/bin/runners/lib/missions/plan.js +6 -46
  51. package/bin/runners/lib/missions/templates.js +0 -232
  52. package/bin/runners/lib/next-action.js +560 -0
  53. package/bin/runners/lib/prerequisites.js +149 -0
  54. package/bin/runners/lib/route-detection.js +137 -68
  55. package/bin/runners/lib/scan-output.js +91 -76
  56. package/bin/runners/lib/scan-runner.js +135 -0
  57. package/bin/runners/lib/schemas/ajv-validator.js +464 -0
  58. package/bin/runners/lib/schemas/error-envelope.schema.json +105 -0
  59. package/bin/runners/lib/schemas/finding-v3.schema.json +151 -0
  60. package/bin/runners/lib/schemas/report-artifact.schema.json +120 -0
  61. package/bin/runners/lib/schemas/run-request.schema.json +108 -0
  62. package/bin/runners/lib/schemas/validator.js +27 -0
  63. package/bin/runners/lib/schemas/verdict.schema.json +140 -0
  64. package/bin/runners/lib/ship-output-enterprise.js +23 -23
  65. package/bin/runners/lib/ship-output.js +75 -31
  66. package/bin/runners/lib/terminal-ui.js +6 -113
  67. package/bin/runners/lib/truth.js +351 -10
  68. package/bin/runners/lib/unified-cli-output.js +430 -603
  69. package/bin/runners/lib/unified-output.js +13 -9
  70. package/bin/runners/runAIAgent.js +10 -5
  71. package/bin/runners/runAgent.js +0 -3
  72. package/bin/runners/runAllowlist.js +389 -0
  73. package/bin/runners/runApprove.js +0 -33
  74. package/bin/runners/runAuth.js +73 -45
  75. package/bin/runners/runCheckpoint.js +51 -11
  76. package/bin/runners/runClassify.js +85 -21
  77. package/bin/runners/runContext.js +0 -3
  78. package/bin/runners/runDoctor.js +41 -28
  79. package/bin/runners/runEvidencePack.js +362 -0
  80. package/bin/runners/runFirewall.js +0 -3
  81. package/bin/runners/runFirewallHook.js +0 -3
  82. package/bin/runners/runFix.js +66 -76
  83. package/bin/runners/runGuard.js +18 -411
  84. package/bin/runners/runInit.js +113 -30
  85. package/bin/runners/runLabs.js +424 -0
  86. package/bin/runners/runMcp.js +19 -25
  87. package/bin/runners/runPolish.js +64 -240
  88. package/bin/runners/runPromptFirewall.js +12 -5
  89. package/bin/runners/runProve.js +57 -22
  90. package/bin/runners/runQuickstart.js +531 -0
  91. package/bin/runners/runReality.js +59 -68
  92. package/bin/runners/runReport.js +38 -33
  93. package/bin/runners/runRuntime.js +8 -5
  94. package/bin/runners/runScan.js +1413 -190
  95. package/bin/runners/runShip.js +113 -719
  96. package/bin/runners/runTruth.js +0 -3
  97. package/bin/runners/runValidate.js +13 -9
  98. package/bin/runners/runWatch.js +23 -14
  99. package/bin/scan.js +6 -1
  100. package/bin/vibecheck.js +204 -185
  101. package/mcp-server/deprecation-middleware.js +282 -0
  102. package/mcp-server/handlers/index.ts +15 -0
  103. package/mcp-server/handlers/tool-handler.ts +554 -0
  104. package/mcp-server/index-v1.js +698 -0
  105. package/mcp-server/index.js +210 -238
  106. package/mcp-server/lib/cache-wrapper.cjs +383 -0
  107. package/mcp-server/lib/error-envelope.js +138 -0
  108. package/mcp-server/lib/executor.ts +499 -0
  109. package/mcp-server/lib/index.ts +19 -0
  110. package/mcp-server/lib/rate-limiter.js +166 -0
  111. package/mcp-server/lib/sandbox.test.ts +519 -0
  112. package/mcp-server/lib/sandbox.ts +395 -0
  113. package/mcp-server/lib/types.ts +267 -0
  114. package/mcp-server/package.json +12 -3
  115. package/mcp-server/registry/tool-registry.js +794 -0
  116. package/mcp-server/registry/tools.json +605 -0
  117. package/mcp-server/registry.test.ts +334 -0
  118. package/mcp-server/tests/tier-gating.test.js +297 -0
  119. package/mcp-server/tier-auth.js +378 -45
  120. package/mcp-server/tools-v3.js +353 -442
  121. package/mcp-server/tsconfig.json +37 -0
  122. package/mcp-server/vibecheck-2.0-tools.js +14 -1
  123. package/package.json +1 -1
  124. package/bin/runners/lib/agent-firewall/learning/learning-engine.js +0 -849
  125. package/bin/runners/lib/audit-logger.js +0 -532
  126. package/bin/runners/lib/authority/authorities/architecture.js +0 -364
  127. package/bin/runners/lib/authority/authorities/compliance.js +0 -341
  128. package/bin/runners/lib/authority/authorities/human.js +0 -343
  129. package/bin/runners/lib/authority/authorities/quality.js +0 -420
  130. package/bin/runners/lib/authority/authorities/security.js +0 -228
  131. package/bin/runners/lib/authority/index.js +0 -293
  132. package/bin/runners/lib/bundle/bundle-intelligence.js +0 -846
  133. package/bin/runners/lib/cli-charts.js +0 -368
  134. package/bin/runners/lib/cli-config-display.js +0 -405
  135. package/bin/runners/lib/cli-demo.js +0 -275
  136. package/bin/runners/lib/cli-errors.js +0 -438
  137. package/bin/runners/lib/cli-help-formatter.js +0 -439
  138. package/bin/runners/lib/cli-interactive-menu.js +0 -509
  139. package/bin/runners/lib/cli-prompts.js +0 -441
  140. package/bin/runners/lib/cli-scan-cards.js +0 -362
  141. package/bin/runners/lib/compliance-reporter.js +0 -710
  142. package/bin/runners/lib/conductor/index.js +0 -671
  143. package/bin/runners/lib/easy/README.md +0 -123
  144. package/bin/runners/lib/easy/index.js +0 -140
  145. package/bin/runners/lib/easy/interactive-wizard.js +0 -788
  146. package/bin/runners/lib/easy/one-click-firewall.js +0 -564
  147. package/bin/runners/lib/easy/zero-config-reality.js +0 -714
  148. package/bin/runners/lib/engines/async-patterns-engine.js +0 -444
  149. package/bin/runners/lib/engines/bundle-size-engine.js +0 -433
  150. package/bin/runners/lib/engines/confidence-scoring.js +0 -276
  151. package/bin/runners/lib/engines/context-detection.js +0 -264
  152. package/bin/runners/lib/engines/database-patterns-engine.js +0 -429
  153. package/bin/runners/lib/engines/duplicate-code-engine.js +0 -354
  154. package/bin/runners/lib/engines/env-variables-engine.js +0 -458
  155. package/bin/runners/lib/engines/error-handling-engine.js +0 -437
  156. package/bin/runners/lib/engines/false-positive-prevention.js +0 -630
  157. package/bin/runners/lib/engines/framework-adapters/index.js +0 -607
  158. package/bin/runners/lib/engines/framework-detection.js +0 -508
  159. package/bin/runners/lib/engines/import-order-engine.js +0 -429
  160. package/bin/runners/lib/engines/naming-conventions-engine.js +0 -544
  161. package/bin/runners/lib/engines/noise-reduction-engine.js +0 -452
  162. package/bin/runners/lib/engines/orchestrator.js +0 -334
  163. package/bin/runners/lib/engines/react-patterns-engine.js +0 -457
  164. package/bin/runners/lib/engines/vibecheck-engines/lib/ai-hallucination-engine.js +0 -806
  165. package/bin/runners/lib/engines/vibecheck-engines/lib/smart-fix-engine.js +0 -577
  166. package/bin/runners/lib/engines/vibecheck-engines/lib/vibe-score-engine.js +0 -543
  167. package/bin/runners/lib/engines/vibecheck-engines.js +0 -514
  168. package/bin/runners/lib/enhanced-features/index.js +0 -305
  169. package/bin/runners/lib/enhanced-output.js +0 -631
  170. package/bin/runners/lib/enterprise.js +0 -300
  171. package/bin/runners/lib/firewall/command-validator.js +0 -351
  172. package/bin/runners/lib/firewall/config.js +0 -341
  173. package/bin/runners/lib/firewall/content-validator.js +0 -519
  174. package/bin/runners/lib/firewall/index.js +0 -101
  175. package/bin/runners/lib/firewall/path-validator.js +0 -256
  176. package/bin/runners/lib/intelligence/cross-repo-intelligence.js +0 -817
  177. package/bin/runners/lib/mcp-utils.js +0 -425
  178. package/bin/runners/lib/output/index.js +0 -1022
  179. package/bin/runners/lib/policy-engine.js +0 -652
  180. package/bin/runners/lib/polish/autofix/accessibility-fixes.js +0 -333
  181. package/bin/runners/lib/polish/autofix/async-handlers.js +0 -273
  182. package/bin/runners/lib/polish/autofix/dead-code.js +0 -280
  183. package/bin/runners/lib/polish/autofix/imports-optimizer.js +0 -344
  184. package/bin/runners/lib/polish/autofix/index.js +0 -200
  185. package/bin/runners/lib/polish/autofix/remove-consoles.js +0 -209
  186. package/bin/runners/lib/polish/autofix/strengthen-types.js +0 -245
  187. package/bin/runners/lib/polish/backend-checks.js +0 -148
  188. package/bin/runners/lib/polish/documentation-checks.js +0 -111
  189. package/bin/runners/lib/polish/frontend-checks.js +0 -168
  190. package/bin/runners/lib/polish/index.js +0 -71
  191. package/bin/runners/lib/polish/infrastructure-checks.js +0 -131
  192. package/bin/runners/lib/polish/library-detection.js +0 -175
  193. package/bin/runners/lib/polish/performance-checks.js +0 -100
  194. package/bin/runners/lib/polish/security-checks.js +0 -148
  195. package/bin/runners/lib/polish/utils.js +0 -203
  196. package/bin/runners/lib/prompt-builder.js +0 -540
  197. package/bin/runners/lib/proof-certificate.js +0 -634
  198. package/bin/runners/lib/reality/accessibility-audit.js +0 -946
  199. package/bin/runners/lib/reality/api-contract-validator.js +0 -1012
  200. package/bin/runners/lib/reality/chaos-engineering.js +0 -1084
  201. package/bin/runners/lib/reality/performance-tracker.js +0 -1077
  202. package/bin/runners/lib/reality/scenario-generator.js +0 -1404
  203. package/bin/runners/lib/reality/visual-regression.js +0 -852
  204. package/bin/runners/lib/reality-profiler.js +0 -717
  205. package/bin/runners/lib/replay/flight-recorder-viewer.js +0 -1160
  206. package/bin/runners/lib/review/ai-code-review.js +0 -832
  207. package/bin/runners/lib/rules/custom-rule-engine.js +0 -985
  208. package/bin/runners/lib/sbom-generator.js +0 -641
  209. package/bin/runners/lib/scan-output-enhanced.js +0 -512
  210. package/bin/runners/lib/security/owasp-scanner.js +0 -939
  211. package/bin/runners/lib/validators/contract-validator.js +0 -283
  212. package/bin/runners/lib/validators/dead-export-detector.js +0 -279
  213. package/bin/runners/lib/validators/dep-audit.js +0 -245
  214. package/bin/runners/lib/validators/env-validator.js +0 -319
  215. package/bin/runners/lib/validators/index.js +0 -120
  216. package/bin/runners/lib/validators/license-checker.js +0 -252
  217. package/bin/runners/lib/validators/route-validator.js +0 -290
  218. package/bin/runners/runAuthority.js +0 -528
  219. package/bin/runners/runConductor.js +0 -772
  220. package/bin/runners/runContainer.js +0 -366
  221. package/bin/runners/runEasy.js +0 -410
  222. package/bin/runners/runIaC.js +0 -372
  223. package/bin/runners/runVibe.js +0 -791
  224. package/mcp-server/tools.js +0 -495
@@ -1,245 +0,0 @@
1
- /**
2
- * Dependency Auditor - Ship-only check
3
- * Checks for known vulnerabilities in dependencies
4
- */
5
-
6
- "use strict";
7
-
8
- const path = require("path");
9
- const fs = require("fs");
10
- const { execSync } = require("child_process");
11
-
12
- /**
13
- * Audit dependencies for known vulnerabilities
14
- * Uses npm audit / pnpm audit under the hood
15
- */
16
- async function auditDependencies(projectPath) {
17
- const findings = [];
18
- const startTime = Date.now();
19
-
20
- try {
21
- // Detect package manager
22
- const packageManager = detectPackageManager(projectPath);
23
-
24
- // Check for package.json
25
- const packageJsonPath = path.join(projectPath, "package.json");
26
- if (!fs.existsSync(packageJsonPath)) {
27
- return {
28
- findings,
29
- duration: Date.now() - startTime,
30
- type: "dep-audit",
31
- };
32
- }
33
-
34
- // Check for lockfile
35
- const hasLockfile = checkLockfile(projectPath, packageManager);
36
- if (!hasLockfile) {
37
- findings.push({
38
- id: "DEP_NO_LOCKFILE",
39
- category: "DependencyAudit",
40
- severity: "WARN",
41
- title: "No lockfile found",
42
- message: "Project has no package-lock.json, pnpm-lock.yaml, or yarn.lock. Dependencies are not pinned.",
43
- confidence: "high",
44
- type: "no_lockfile",
45
- });
46
- }
47
-
48
- // Run audit command
49
- const auditResult = await runAudit(projectPath, packageManager);
50
-
51
- // Parse audit results
52
- if (auditResult.vulnerabilities) {
53
- const vulnCounts = {
54
- critical: 0,
55
- high: 0,
56
- moderate: 0,
57
- low: 0,
58
- };
59
-
60
- for (const [name, vuln] of Object.entries(auditResult.vulnerabilities)) {
61
- const severity = vuln.severity || "moderate";
62
- vulnCounts[severity] = (vulnCounts[severity] || 0) + 1;
63
-
64
- // Only report critical and high
65
- if (severity === "critical" || severity === "high") {
66
- findings.push({
67
- id: `DEP_VULN_${hashString(name)}`,
68
- category: "DependencyAudit",
69
- severity: severity === "critical" ? "BLOCK" : "WARN",
70
- title: `Vulnerable dependency: ${name}`,
71
- message: `${severity.toUpperCase()} severity vulnerability in ${name}${vuln.via ? ` via ${Array.isArray(vuln.via) ? vuln.via[0] : vuln.via}` : ""}`,
72
- confidence: "high",
73
- type: "vulnerability",
74
- details: {
75
- package: name,
76
- severity,
77
- fixAvailable: vuln.fixAvailable || false,
78
- },
79
- });
80
- }
81
- }
82
-
83
- // Summary finding
84
- if (vulnCounts.critical > 0 || vulnCounts.high > 0) {
85
- findings.push({
86
- id: "DEP_VULN_SUMMARY",
87
- category: "DependencyAudit",
88
- severity: vulnCounts.critical > 0 ? "BLOCK" : "WARN",
89
- title: "Dependency vulnerabilities found",
90
- message: `${vulnCounts.critical} critical, ${vulnCounts.high} high, ${vulnCounts.moderate} moderate, ${vulnCounts.low} low severity vulnerabilities`,
91
- confidence: "high",
92
- type: "summary",
93
- });
94
- }
95
- }
96
-
97
- // Check for outdated dependencies (major versions behind)
98
- const outdatedFindings = await checkOutdatedDependencies(projectPath, packageManager);
99
- findings.push(...outdatedFindings);
100
-
101
- } catch (error) {
102
- // Audit command failed - this is common if node_modules doesn't exist
103
- if (!error.message.includes("ENOENT")) {
104
- findings.push({
105
- id: "DEP_AUDIT_ERROR",
106
- category: "DependencyAudit",
107
- severity: "INFO",
108
- title: "Dependency audit incomplete",
109
- message: `Could not run dependency audit: ${error.message}`,
110
- confidence: "low",
111
- type: "audit_error",
112
- });
113
- }
114
- }
115
-
116
- return {
117
- findings,
118
- duration: Date.now() - startTime,
119
- type: "dep-audit",
120
- };
121
- }
122
-
123
- function detectPackageManager(projectPath) {
124
- if (fs.existsSync(path.join(projectPath, "pnpm-lock.yaml"))) return "pnpm";
125
- if (fs.existsSync(path.join(projectPath, "yarn.lock"))) return "yarn";
126
- if (fs.existsSync(path.join(projectPath, "bun.lockb"))) return "bun";
127
- return "npm";
128
- }
129
-
130
- function checkLockfile(projectPath, packageManager) {
131
- const lockfiles = {
132
- npm: "package-lock.json",
133
- pnpm: "pnpm-lock.yaml",
134
- yarn: "yarn.lock",
135
- bun: "bun.lockb",
136
- };
137
- return fs.existsSync(path.join(projectPath, lockfiles[packageManager]));
138
- }
139
-
140
- async function runAudit(projectPath, packageManager) {
141
- try {
142
- let command;
143
- switch (packageManager) {
144
- case "pnpm":
145
- command = "pnpm audit --json";
146
- break;
147
- case "yarn":
148
- command = "yarn audit --json";
149
- break;
150
- default:
151
- command = "npm audit --json";
152
- }
153
-
154
- const result = execSync(command, {
155
- cwd: projectPath,
156
- encoding: "utf8",
157
- stdio: ["pipe", "pipe", "pipe"],
158
- timeout: 60000, // 60 second timeout
159
- });
160
-
161
- return JSON.parse(result);
162
- } catch (error) {
163
- // npm audit exits with non-zero when vulnerabilities found
164
- if (error.stdout) {
165
- try {
166
- return JSON.parse(error.stdout);
167
- } catch {
168
- return { vulnerabilities: {} };
169
- }
170
- }
171
- return { vulnerabilities: {} };
172
- }
173
- }
174
-
175
- async function checkOutdatedDependencies(projectPath, packageManager) {
176
- const findings = [];
177
-
178
- try {
179
- let command;
180
- switch (packageManager) {
181
- case "pnpm":
182
- command = "pnpm outdated --json";
183
- break;
184
- case "yarn":
185
- command = "yarn outdated --json";
186
- break;
187
- default:
188
- command = "npm outdated --json";
189
- }
190
-
191
- const result = execSync(command, {
192
- cwd: projectPath,
193
- encoding: "utf8",
194
- stdio: ["pipe", "pipe", "pipe"],
195
- timeout: 60000,
196
- });
197
-
198
- const outdated = JSON.parse(result || "{}");
199
-
200
- // Count packages that are multiple major versions behind
201
- let majorOutdated = 0;
202
- for (const [name, info] of Object.entries(outdated)) {
203
- const current = info.current || "0.0.0";
204
- const latest = info.latest || "0.0.0";
205
-
206
- const currentMajor = parseInt(current.split(".")[0], 10) || 0;
207
- const latestMajor = parseInt(latest.split(".")[0], 10) || 0;
208
-
209
- if (latestMajor - currentMajor >= 2) {
210
- majorOutdated++;
211
- }
212
- }
213
-
214
- if (majorOutdated > 5) {
215
- findings.push({
216
- id: "DEP_MAJOR_OUTDATED",
217
- category: "DependencyAudit",
218
- severity: "WARN",
219
- title: "Many dependencies are significantly outdated",
220
- message: `${majorOutdated} dependencies are 2+ major versions behind. Consider updating.`,
221
- confidence: "medium",
222
- type: "outdated",
223
- });
224
- }
225
-
226
- } catch {
227
- // Outdated check failed - ignore
228
- }
229
-
230
- return findings;
231
- }
232
-
233
- function hashString(str) {
234
- let hash = 0;
235
- for (let i = 0; i < str.length; i++) {
236
- const char = str.charCodeAt(i);
237
- hash = ((hash << 5) - hash) + char;
238
- hash = hash & hash;
239
- }
240
- return Math.abs(hash).toString(36).substring(0, 8);
241
- }
242
-
243
- module.exports = {
244
- auditDependencies,
245
- };
@@ -1,319 +0,0 @@
1
- /**
2
- * Environment Validator - Ship-only check
3
- * Validates environment variable configuration
4
- */
5
-
6
- "use strict";
7
-
8
- const path = require("path");
9
- const fs = require("fs");
10
- const fg = require("fast-glob");
11
-
12
- /**
13
- * Validate environment variable configuration
14
- * Checks:
15
- * - All used env vars are documented in .env.example
16
- * - No secrets in .env files that should be in .gitignore
17
- * - Required env vars have validation
18
- * - Env var naming conventions
19
- */
20
- async function validateEnv(projectPath) {
21
- const findings = [];
22
- const startTime = Date.now();
23
-
24
- try {
25
- // Find .env files
26
- const envFiles = fg.sync([".env*", "**/.env*"], {
27
- cwd: projectPath,
28
- absolute: true,
29
- ignore: ["**/node_modules/**"],
30
- dot: true,
31
- });
32
-
33
- // Parse env template (.env.example, .env.template)
34
- const templateVars = await parseEnvTemplate(projectPath);
35
-
36
- // Parse actual env files
37
- const actualEnvVars = new Map();
38
- const envFileContents = new Map();
39
-
40
- for (const envFile of envFiles) {
41
- const relativePath = path.relative(projectPath, envFile).replace(/\\/g, "/");
42
- const content = fs.readFileSync(envFile, "utf8");
43
- envFileContents.set(relativePath, content);
44
-
45
- const vars = parseEnvFile(content);
46
- for (const [key, value] of Object.entries(vars)) {
47
- if (!actualEnvVars.has(key)) {
48
- actualEnvVars.set(key, { files: [], value });
49
- }
50
- actualEnvVars.get(key).files.push(relativePath);
51
- }
52
- }
53
-
54
- // Find env var usage in code
55
- const usedEnvVars = await findEnvVarUsage(projectPath);
56
-
57
- // Check for missing documentation
58
- for (const [varName, usage] of usedEnvVars.entries()) {
59
- if (!templateVars.has(varName) && !isSystemEnvVar(varName)) {
60
- findings.push({
61
- id: `ENV_UNDOCUMENTED_${hashString(varName)}`,
62
- category: "EnvValidation",
63
- severity: "WARN",
64
- title: `Environment variable not documented: ${varName}`,
65
- message: `${varName} is used in code but not in .env.example`,
66
- file: usage.files[0],
67
- line: usage.line,
68
- confidence: "medium",
69
- type: "undocumented_env",
70
- });
71
- }
72
- }
73
-
74
- // Check for secrets in committed env files
75
- for (const [filePath, content] of envFileContents.entries()) {
76
- // Skip .env.example, .env.template, .env.local (usually gitignored)
77
- if (filePath.includes("example") || filePath.includes("template")) continue;
78
-
79
- const potentialSecrets = findPotentialSecrets(content);
80
-
81
- for (const secret of potentialSecrets) {
82
- findings.push({
83
- id: `ENV_SECRET_${hashString(secret.key + filePath)}`,
84
- category: "EnvValidation",
85
- severity: "BLOCK",
86
- title: `Potential secret in env file: ${secret.key}`,
87
- message: `${filePath} contains what looks like a secret value for ${secret.key}. Ensure this file is gitignored.`,
88
- file: filePath,
89
- confidence: "high",
90
- type: "potential_secret",
91
- });
92
- }
93
- }
94
-
95
- // Check .gitignore for env files
96
- const gitignorePath = path.join(projectPath, ".gitignore");
97
- if (fs.existsSync(gitignorePath)) {
98
- const gitignore = fs.readFileSync(gitignorePath, "utf8");
99
- const envFilesIgnored = gitignore.includes(".env") || gitignore.includes("*.env");
100
-
101
- if (!envFilesIgnored) {
102
- findings.push({
103
- id: "ENV_NOT_GITIGNORED",
104
- category: "EnvValidation",
105
- severity: "WARN",
106
- title: ".env files may not be gitignored",
107
- message: "Add .env* to .gitignore to prevent committing secrets",
108
- file: ".gitignore",
109
- confidence: "medium",
110
- type: "gitignore_missing",
111
- });
112
- }
113
- }
114
-
115
- // Check for .env.example
116
- const hasEnvExample = templateVars.size > 0;
117
- if (!hasEnvExample && usedEnvVars.size > 5) {
118
- findings.push({
119
- id: "ENV_NO_EXAMPLE",
120
- category: "EnvValidation",
121
- severity: "WARN",
122
- title: "No .env.example file",
123
- message: "Create a .env.example to document required environment variables",
124
- confidence: "high",
125
- type: "no_example",
126
- });
127
- }
128
-
129
- // Check naming conventions
130
- for (const varName of usedEnvVars.keys()) {
131
- if (isSystemEnvVar(varName)) continue;
132
-
133
- // Check for lowercase (should be SCREAMING_SNAKE_CASE)
134
- if (varName !== varName.toUpperCase() && !varName.startsWith("npm_")) {
135
- findings.push({
136
- id: `ENV_NAMING_${hashString(varName)}`,
137
- category: "EnvValidation",
138
- severity: "INFO",
139
- title: `Environment variable naming: ${varName}`,
140
- message: `Convention is SCREAMING_SNAKE_CASE. Consider renaming to ${varName.toUpperCase()}`,
141
- confidence: "low",
142
- type: "naming_convention",
143
- });
144
- }
145
- }
146
-
147
- } catch (error) {
148
- findings.push({
149
- id: "ENV_VALIDATION_ERROR",
150
- category: "EnvValidation",
151
- severity: "INFO",
152
- title: "Environment validation incomplete",
153
- message: `Could not complete env validation: ${error.message}`,
154
- confidence: "low",
155
- type: "validation_error",
156
- });
157
- }
158
-
159
- return {
160
- findings,
161
- duration: Date.now() - startTime,
162
- type: "env-validator",
163
- };
164
- }
165
-
166
- async function parseEnvTemplate(projectPath) {
167
- const templateVars = new Map();
168
-
169
- const templateFiles = [".env.example", ".env.template", ".env.sample"];
170
-
171
- for (const filename of templateFiles) {
172
- const filePath = path.join(projectPath, filename);
173
- if (fs.existsSync(filePath)) {
174
- const content = fs.readFileSync(filePath, "utf8");
175
- const vars = parseEnvFile(content);
176
- for (const [key, value] of Object.entries(vars)) {
177
- templateVars.set(key, { value, file: filename });
178
- }
179
- }
180
- }
181
-
182
- return templateVars;
183
- }
184
-
185
- function parseEnvFile(content) {
186
- const vars = {};
187
- const lines = content.split("\n");
188
-
189
- for (const line of lines) {
190
- const trimmed = line.trim();
191
- if (!trimmed || trimmed.startsWith("#")) continue;
192
-
193
- const match = trimmed.match(/^([A-Za-z_][A-Za-z0-9_]*)=(.*)$/);
194
- if (match) {
195
- vars[match[1]] = match[2].replace(/^["']|["']$/g, "");
196
- }
197
- }
198
-
199
- return vars;
200
- }
201
-
202
- async function findEnvVarUsage(projectPath) {
203
- const usedVars = new Map();
204
-
205
- const files = fg.sync(["**/*.{ts,tsx,js,jsx}"], {
206
- cwd: projectPath,
207
- absolute: true,
208
- ignore: [
209
- "**/node_modules/**",
210
- "**/dist/**",
211
- "**/build/**",
212
- "**/*.test.*",
213
- "**/*.spec.*",
214
- ],
215
- });
216
-
217
- for (const file of files) {
218
- try {
219
- const content = fs.readFileSync(file, "utf8");
220
- const relativePath = path.relative(projectPath, file).replace(/\\/g, "/");
221
-
222
- // process.env.VAR_NAME
223
- const processEnvMatches = content.matchAll(/process\.env\.([A-Z_][A-Z0-9_]*)/g);
224
- for (const match of processEnvMatches) {
225
- const varName = match[1];
226
- const line = content.substring(0, match.index).split("\n").length;
227
-
228
- if (!usedVars.has(varName)) {
229
- usedVars.set(varName, { files: [], line });
230
- }
231
- usedVars.get(varName).files.push(relativePath);
232
- }
233
-
234
- // import.meta.env.VAR_NAME (Vite)
235
- const importMetaMatches = content.matchAll(/import\.meta\.env\.([A-Z_][A-Z0-9_]*)/g);
236
- for (const match of importMetaMatches) {
237
- const varName = match[1];
238
- const line = content.substring(0, match.index).split("\n").length;
239
-
240
- if (!usedVars.has(varName)) {
241
- usedVars.set(varName, { files: [], line });
242
- }
243
- usedVars.get(varName).files.push(relativePath);
244
- }
245
- } catch {
246
- // Skip files that can't be read
247
- }
248
- }
249
-
250
- return usedVars;
251
- }
252
-
253
- function isSystemEnvVar(name) {
254
- const systemVars = [
255
- "NODE_ENV", "PORT", "HOST", "PATH", "HOME", "USER", "SHELL",
256
- "PWD", "LANG", "TZ", "TERM", "CI", "DEBUG", "VERBOSE",
257
- "npm_package_version", "npm_package_name",
258
- ];
259
- return systemVars.includes(name) || name.startsWith("npm_") || name.startsWith("NODE_");
260
- }
261
-
262
- function findPotentialSecrets(content) {
263
- const secrets = [];
264
- const lines = content.split("\n");
265
-
266
- const secretPatterns = [
267
- /^(.*(?:SECRET|KEY|TOKEN|PASSWORD|PRIVATE|CREDENTIAL|AUTH).*?)=(.+)$/i,
268
- /^(.*API_KEY.*)=(.+)$/i,
269
- /^(.*ACCESS_TOKEN.*)=(.+)$/i,
270
- /^(.*DATABASE_URL.*)=(.+)$/i,
271
- /^(.*STRIPE_.*)=(.+)$/i,
272
- /^(.*AWS_.*)=(.+)$/i,
273
- /^(.*GOOGLE_.*)=(.+)$/i,
274
- /^(.*GITHUB_.*)=(.+)$/i,
275
- ];
276
-
277
- for (const line of lines) {
278
- const trimmed = line.trim();
279
- if (!trimmed || trimmed.startsWith("#")) continue;
280
-
281
- for (const pattern of secretPatterns) {
282
- const match = trimmed.match(pattern);
283
- if (match) {
284
- const value = match[2].replace(/^["']|["']$/g, "");
285
- // Skip placeholder values
286
- if (!isPlaceholderValue(value)) {
287
- secrets.push({ key: match[1], hasValue: true });
288
- break;
289
- }
290
- }
291
- }
292
- }
293
-
294
- return secrets;
295
- }
296
-
297
- function isPlaceholderValue(value) {
298
- const placeholders = [
299
- "", "your-", "xxx", "TODO", "CHANGEME", "placeholder",
300
- "<", ">", "...", "example", "test", "dev", "local",
301
- ];
302
-
303
- const lowerValue = value.toLowerCase();
304
- return placeholders.some(p => lowerValue.includes(p)) || value.length < 8;
305
- }
306
-
307
- function hashString(str) {
308
- let hash = 0;
309
- for (let i = 0; i < str.length; i++) {
310
- const char = str.charCodeAt(i);
311
- hash = ((hash << 5) - hash) + char;
312
- hash = hash & hash;
313
- }
314
- return Math.abs(hash).toString(36).substring(0, 8);
315
- }
316
-
317
- module.exports = {
318
- validateEnv,
319
- };
@@ -1,120 +0,0 @@
1
- /**
2
- * Ship-only Validators
3
- * These validators only run during `vibecheck ship` (PRO feature)
4
- */
5
-
6
- "use strict";
7
-
8
- const { validateRoutes } = require("./route-validator");
9
- const { validateContracts } = require("./contract-validator");
10
- const { auditDependencies } = require("./dep-audit");
11
- const { checkLicenses } = require("./license-checker");
12
- const { validateEnv } = require("./env-validator");
13
- const { detectDeadExports } = require("./dead-export-detector");
14
-
15
- /**
16
- * Run all ship-only validators
17
- * @param {string} projectPath - Path to project root
18
- * @param {Object} options - Validator options
19
- * @returns {Promise<{findings: Array, stats: Object}>}
20
- */
21
- async function runShipValidators(projectPath, options = {}) {
22
- const { onProgress = null, parallel = true } = options;
23
-
24
- const startTime = Date.now();
25
- const results = [];
26
-
27
- const validators = [
28
- { name: "Route Integrity", fn: validateRoutes },
29
- { name: "Contract Validation", fn: validateContracts },
30
- { name: "Dependency Audit", fn: auditDependencies },
31
- { name: "License Compliance", fn: checkLicenses },
32
- { name: "Environment Validation", fn: validateEnv },
33
- { name: "Dead Export Detection", fn: detectDeadExports },
34
- ];
35
-
36
- if (parallel) {
37
- // Run validators in parallel
38
- const promises = validators.map(async ({ name, fn }) => {
39
- try {
40
- if (onProgress) onProgress(name, "running");
41
- const result = await fn(projectPath);
42
- if (onProgress) onProgress(name, "complete");
43
- return { name, ...result };
44
- } catch (error) {
45
- if (onProgress) onProgress(name, "error");
46
- return {
47
- name,
48
- findings: [{
49
- id: `VALIDATOR_ERROR_${name.replace(/\s/g, "_")}`,
50
- category: "ValidatorError",
51
- severity: "INFO",
52
- title: `${name} validator failed`,
53
- message: error.message,
54
- confidence: "low",
55
- type: "validator_error",
56
- }],
57
- duration: 0,
58
- };
59
- }
60
- });
61
-
62
- results.push(...await Promise.all(promises));
63
- } else {
64
- // Run validators sequentially
65
- for (const { name, fn } of validators) {
66
- try {
67
- if (onProgress) onProgress(name, "running");
68
- const result = await fn(projectPath);
69
- if (onProgress) onProgress(name, "complete");
70
- results.push({ name, ...result });
71
- } catch (error) {
72
- if (onProgress) onProgress(name, "error");
73
- results.push({
74
- name,
75
- findings: [{
76
- id: `VALIDATOR_ERROR_${name.replace(/\s/g, "_")}`,
77
- category: "ValidatorError",
78
- severity: "INFO",
79
- title: `${name} validator failed`,
80
- message: error.message,
81
- confidence: "low",
82
- type: "validator_error",
83
- }],
84
- duration: 0,
85
- });
86
- }
87
- }
88
- }
89
-
90
- // Aggregate findings
91
- const allFindings = [];
92
- const stats = {
93
- validatorsRun: results.length,
94
- findingsPerValidator: {},
95
- totalDuration: Date.now() - startTime,
96
- };
97
-
98
- for (const result of results) {
99
- stats.findingsPerValidator[result.name] = result.findings.length;
100
- allFindings.push(...result.findings.map(f => ({
101
- ...f,
102
- validator: result.name,
103
- })));
104
- }
105
-
106
- return { findings: allFindings, stats };
107
- }
108
-
109
- module.exports = {
110
- // Main orchestrator
111
- runShipValidators,
112
-
113
- // Individual validators
114
- validateRoutes,
115
- validateContracts,
116
- auditDependencies,
117
- checkLicenses,
118
- validateEnv,
119
- detectDeadExports,
120
- };