@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
@@ -0,0 +1,100 @@
1
+ // bin/runners/lib/engine/enforcement-extractor.js
2
+ // Optimized enforcement extraction using RepoIndex
3
+
4
+ const path = require("path");
5
+ const fs = require("fs");
6
+
7
+ const ENFORCE_HINTS = [
8
+ "enforceFeature",
9
+ "enforceLimit",
10
+ "getEntitlements",
11
+ "requirePlan",
12
+ "requireTier",
13
+ "requireSubscription",
14
+ "checkAccess",
15
+ "entitlements",
16
+ "plan",
17
+ "tier",
18
+ "subscription",
19
+ "stripe",
20
+ "credits"
21
+ ];
22
+
23
+ function looksPaidSurface(routePath) {
24
+ const p = String(routePath || "");
25
+ return (
26
+ p.includes("/api/ship") ||
27
+ p.includes("/api/verdict") ||
28
+ p.includes("/api/fix") ||
29
+ p.includes("/api/autopilot") ||
30
+ p.includes("/api/missions") ||
31
+ p.includes("/api/pr") ||
32
+ p.includes("/api/credits") ||
33
+ p.includes("/api/billing") ||
34
+ p.includes("/api/stripe") ||
35
+ p.includes("/api/entitlements")
36
+ );
37
+ }
38
+
39
+ /**
40
+ * Check if handler has enforcement signal using RepoIndex
41
+ * @param {import('./repo-index').RepoIndex} index
42
+ * @param {string} handlerRel
43
+ * @returns {{ ok: boolean, hits: string[] }}
44
+ */
45
+ function handlerHasEnforcementSignalV2(index, handlerRel) {
46
+ const fileAbs = path.join(index.repoRoot, handlerRel);
47
+
48
+ // Try to get content from index first (fast path)
49
+ let content = index.getContent(fileAbs);
50
+
51
+ // Fall back to direct read if not in index
52
+ if (!content) {
53
+ try {
54
+ content = fs.readFileSync(fileAbs, "utf8");
55
+ } catch {
56
+ return { ok: false, hits: [] };
57
+ }
58
+ }
59
+
60
+ const hits = ENFORCE_HINTS.filter(k => content.includes(k));
61
+ return { ok: hits.length > 0, hits };
62
+ }
63
+
64
+ /**
65
+ * Build enforcement truth using RepoIndex (optimized)
66
+ * @param {import('./repo-index').RepoIndex} index
67
+ * @param {Array} serverRoutes
68
+ * @returns {Object}
69
+ */
70
+ function buildEnforcementTruthV2(index, serverRoutes) {
71
+ const checked = [];
72
+ const routeList = serverRoutes || [];
73
+
74
+ for (const r of routeList) {
75
+ if (!r.handler) continue;
76
+ if (!looksPaidSurface(r.path)) continue;
77
+
78
+ const res = handlerHasEnforcementSignalV2(index, r.handler);
79
+ checked.push({
80
+ method: r.method,
81
+ path: r.path,
82
+ handler: r.handler,
83
+ enforced: res.ok,
84
+ hits: res.hits
85
+ });
86
+ }
87
+
88
+ return {
89
+ checkedCount: checked.length,
90
+ enforcedCount: checked.filter(x => x.enforced).length,
91
+ missingCount: checked.filter(x => !x.enforced).length,
92
+ checks: checked
93
+ };
94
+ }
95
+
96
+ module.exports = {
97
+ buildEnforcementTruthV2,
98
+ ENFORCE_HINTS,
99
+ looksPaidSurface,
100
+ };
@@ -0,0 +1,207 @@
1
+ // bin/runners/lib/engine/env-extractor.js
2
+ // Optimized env var extraction using RepoIndex
3
+
4
+ const path = require("path");
5
+ const fs = require("fs");
6
+ const crypto = require("crypto");
7
+ const traverse = require("@babel/traverse").default;
8
+ const t = require("@babel/types");
9
+ const { globalASTCache } = require("./ast-cache");
10
+
11
+ function sha256(text) {
12
+ return "sha256:" + crypto.createHash("sha256").update(text).digest("hex");
13
+ }
14
+
15
+ function isEnvName(s) {
16
+ return typeof s === "string" && /^[A-Z0-9_]+$/.test(s);
17
+ }
18
+
19
+ function extractEnvFromMemberExpr(node) {
20
+ if (!t.isMemberExpression(node)) return null;
21
+
22
+ // process.env.NAME
23
+ if (t.isMemberExpression(node.object) &&
24
+ t.isIdentifier(node.object.object, { name: "process" }) &&
25
+ t.isIdentifier(node.object.property, { name: "env" }) &&
26
+ t.isIdentifier(node.property)) {
27
+ return node.property.name;
28
+ }
29
+
30
+ // process.env["NAME"]
31
+ if (t.isMemberExpression(node.object) &&
32
+ t.isIdentifier(node.object.object, { name: "process" }) &&
33
+ t.isIdentifier(node.object.property, { name: "env" }) &&
34
+ t.isStringLiteral(node.property)) {
35
+ return node.property.value;
36
+ }
37
+
38
+ // import.meta.env.NAME
39
+ if (t.isMemberExpression(node.object) &&
40
+ t.isMemberExpression(node.object.object) &&
41
+ t.isIdentifier(node.object.object.object, { name: "import" }) &&
42
+ t.isIdentifier(node.object.object.property, { name: "meta" }) &&
43
+ t.isIdentifier(node.object.property, { name: "env" }) &&
44
+ t.isIdentifier(node.property)) {
45
+ return node.property.name;
46
+ }
47
+
48
+ return null;
49
+ }
50
+
51
+ function detectDefaultSignals(parentPath) {
52
+ const p = parentPath?.parentPath;
53
+ if (!p) return { hasDefault: false };
54
+
55
+ if (p.isLogicalExpression() && (p.node.operator === "||" || p.node.operator === "??")) {
56
+ return { hasDefault: true };
57
+ }
58
+ if (p.isConditionalExpression()) return { hasDefault: true };
59
+ if (p.isAssignmentExpression() && p.node.operator === "||=") return { hasDefault: true };
60
+ return { hasDefault: false };
61
+ }
62
+
63
+ function evidenceFromContent(content, fileRel, loc, reason) {
64
+ if (!loc || !content) return null;
65
+ const lines = content.split(/\r?\n/);
66
+ const start = Math.max(1, loc.start?.line || 1);
67
+ const end = Math.max(start, loc.end?.line || start);
68
+ const snippet = lines.slice(start - 1, end).join("\n");
69
+ return {
70
+ id: `ev_${crypto.randomBytes(4).toString("hex")}`,
71
+ file: fileRel,
72
+ lines: `${start}-${end}`,
73
+ snippetHash: sha256(snippet),
74
+ reason
75
+ };
76
+ }
77
+
78
+ function parseDotEnvLike(content) {
79
+ const out = new Set();
80
+ const lines = content.split(/\r?\n/);
81
+ for (const raw of lines) {
82
+ const line = raw.trim();
83
+ if (!line || line.startsWith("#")) continue;
84
+ const l = line.startsWith("export ") ? line.slice(7).trim() : line;
85
+ const eq = l.indexOf("=");
86
+ if (eq <= 0) continue;
87
+ const key = l.slice(0, eq).trim();
88
+ if (isEnvName(key)) out.add(key);
89
+ }
90
+ return out;
91
+ }
92
+
93
+ /**
94
+ * Extract env var usage using RepoIndex
95
+ * @param {import('./repo-index').RepoIndex} index
96
+ * @param {Object} stats
97
+ * @returns {Object} - Map of env var name to usage info
98
+ */
99
+ function extractEnvUsage(index, stats) {
100
+ // Use token prefilter - only scan files that reference process.env or import.meta.env
101
+ const candidateAbs = index.getByAnyToken(["process.env", "import.meta.env"]);
102
+
103
+ // Filter to JS/TS files
104
+ const jsExtensions = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
105
+ const files = candidateAbs.filter(abs => {
106
+ const ext = path.extname(abs).toLowerCase();
107
+ return jsExtensions.has(ext);
108
+ });
109
+
110
+ const usageMap = {};
111
+
112
+ for (const fileAbs of files) {
113
+ const fileRel = index.relPath(fileAbs);
114
+ const content = index.getContent(fileAbs);
115
+ if (!content) continue;
116
+
117
+ const { ast, error } = globalASTCache.parse(content, fileAbs);
118
+ if (error || !ast) {
119
+ stats.parseErrors++;
120
+ continue;
121
+ }
122
+
123
+ try {
124
+ traverse(ast, {
125
+ MemberExpression(p) {
126
+ const name = extractEnvFromMemberExpr(p.node);
127
+ if (!name || !isEnvName(name)) return;
128
+
129
+ usageMap[name] = usageMap[name] || { name, references: [], signals: { hasDefault: false } };
130
+
131
+ const ev = evidenceFromContent(content, fileRel, p.node.loc, `Env usage: ${name}`);
132
+ if (ev) usageMap[name].references.push(ev);
133
+
134
+ const sig = detectDefaultSignals(p);
135
+ if (sig.hasDefault) usageMap[name].signals.hasDefault = true;
136
+ }
137
+ });
138
+ } catch {
139
+ stats.parseErrors++;
140
+ }
141
+ }
142
+
143
+ return usageMap;
144
+ }
145
+
146
+ /**
147
+ * Extract declared env vars from .env files
148
+ * @param {string} repoRoot
149
+ * @returns {{ declared: string[], sources: string[] }}
150
+ */
151
+ function extractEnvDeclared(repoRoot) {
152
+ const candidates = [
153
+ ".env.example", ".env.template", ".env.sample",
154
+ ".env.local.example", ".env.development.example",
155
+ ".env"
156
+ ];
157
+
158
+ const declared = new Set();
159
+ const sources = [];
160
+
161
+ for (const rel of candidates) {
162
+ const abs = path.join(repoRoot, rel);
163
+ try {
164
+ if (!fs.existsSync(abs)) continue;
165
+ const content = fs.readFileSync(abs, "utf8");
166
+ const keys = parseDotEnvLike(content);
167
+ if (keys.size) {
168
+ for (const k of keys) declared.add(k);
169
+ sources.push(rel);
170
+ }
171
+ } catch {}
172
+ }
173
+
174
+ return { declared: Array.from(declared).sort(), sources };
175
+ }
176
+
177
+ /**
178
+ * Build env truth using RepoIndex (optimized)
179
+ * @param {import('./repo-index').RepoIndex} index
180
+ * @param {Object} stats
181
+ * @returns {Object}
182
+ */
183
+ function buildEnvTruthV2(index, stats) {
184
+ const usageMap = extractEnvUsage(index, stats);
185
+ const declared = extractEnvDeclared(index.repoRoot);
186
+
187
+ const used = Object.values(usageMap).sort((a, b) => a.name.localeCompare(b.name));
188
+
189
+ const vars = used.map(u => ({
190
+ name: u.name,
191
+ required: !u.signals?.hasDefault,
192
+ references: u.references || [],
193
+ notes: u.signals?.hasDefault ? "Has default/fallback usage signal" : ""
194
+ }));
195
+
196
+ return {
197
+ vars,
198
+ declared: declared.declared,
199
+ declaredSources: declared.sources
200
+ };
201
+ }
202
+
203
+ module.exports = {
204
+ extractEnvUsage,
205
+ extractEnvDeclared,
206
+ buildEnvTruthV2,
207
+ };
@@ -0,0 +1,208 @@
1
+ // bin/runners/lib/engine/express-extractor.js
2
+ // Optimized Express route extraction using RepoIndex
3
+
4
+ const path = require("path");
5
+ const crypto = require("crypto");
6
+ const traverse = require("@babel/traverse").default;
7
+ const t = require("@babel/types");
8
+ const { globalASTCache } = require("./ast-cache");
9
+
10
+ function sha256(text) {
11
+ return "sha256:" + crypto.createHash("sha256").update(text).digest("hex");
12
+ }
13
+
14
+ function canonicalizeMethod(m) {
15
+ const u = String(m || "").toUpperCase();
16
+ if (u === "ALL" || u === "ANY" || u === "*") return "*";
17
+ return u;
18
+ }
19
+
20
+ function canonicalizePath(p) {
21
+ let s = String(p || "").trim();
22
+ if (!s.startsWith("/")) s = "/" + s;
23
+ s = s.replace(/\/+/g, "/");
24
+ s = s.replace(/\[\[\.{3}([^\]]+)\]\]/g, "*$1?");
25
+ s = s.replace(/\[\.{3}([^\]]+)\]/g, "*$1");
26
+ s = s.replace(/\[([^\]]+)\]/g, ":$1");
27
+ if (s.length > 1) s = s.replace(/\/$/, "");
28
+ return s;
29
+ }
30
+
31
+ function joinPaths(prefix, p) {
32
+ const a = canonicalizePath(prefix || "/");
33
+ const b = canonicalizePath(p || "/");
34
+ if (a === "/") return b;
35
+ if (b === "/") return a;
36
+ return canonicalizePath(a + "/" + b);
37
+ }
38
+
39
+ function evidenceFromContent(content, fileRel, loc, reason) {
40
+ if (!loc || !content) return null;
41
+ const lines = content.split(/\r?\n/);
42
+ const start = Math.max(1, loc.start?.line || 1);
43
+ const end = Math.max(start, loc.end?.line || start);
44
+ const snippet = lines.slice(start - 1, end).join("\n");
45
+ return {
46
+ id: `ev_${crypto.randomBytes(4).toString("hex")}`,
47
+ file: fileRel,
48
+ lines: `${start}-${end}`,
49
+ snippetHash: sha256(snippet),
50
+ reason
51
+ };
52
+ }
53
+
54
+ const EXPRESS_METHODS = new Set(["get", "post", "put", "patch", "delete", "options", "head", "all", "use"]);
55
+ const EXPRESS_NAMES = new Set(["app", "router", "express", "server"]);
56
+
57
+ function evalStaticString(node, constMap = new Map(), depth = 0) {
58
+ if (!node || depth > 5) return null;
59
+ if (t.isStringLiteral(node)) return node.value;
60
+ if (t.isTemplateLiteral(node) && node.expressions.length === 0) {
61
+ return node.quasis.map(q => q.value.cooked || "").join("");
62
+ }
63
+ if (t.isIdentifier(node) && constMap.has(node.name)) {
64
+ return evalStaticString(constMap.get(node.name), constMap, depth + 1);
65
+ }
66
+ if (t.isBinaryExpression(node, { operator: "+" })) {
67
+ const l = evalStaticString(node.left, constMap, depth + 1);
68
+ const r = evalStaticString(node.right, constMap, depth + 1);
69
+ if (typeof l === "string" && typeof r === "string") return l + r;
70
+ }
71
+ return null;
72
+ }
73
+
74
+ /**
75
+ * Extract Express routes using RepoIndex
76
+ * @param {import('./repo-index').RepoIndex} index
77
+ * @param {Object} stats
78
+ * @returns {Array}
79
+ */
80
+ function extractExpressRoutes(index, stats) {
81
+ if (!index.hasFramework("express")) return [];
82
+
83
+ // Use token prefilter - only scan files that mention express/app/router
84
+ const candidateAbs = index.getByAnyToken(["express", "app.get", "app.post", "router.get", "router.post"]);
85
+
86
+ // Filter to JS/TS files, exclude tests
87
+ const jsExtensions = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
88
+ const files = candidateAbs.filter(abs => {
89
+ const ext = path.extname(abs).toLowerCase();
90
+ if (!jsExtensions.has(ext)) return false;
91
+ const rel = index.relPath(abs);
92
+ if (rel.includes("/test/") || rel.includes("/tests/") || rel.includes("/__tests__/")) return false;
93
+ if (rel.includes(".test.") || rel.includes(".spec.")) return false;
94
+ if (rel.endsWith(".d.ts")) return false;
95
+ return true;
96
+ });
97
+
98
+ const routes = [];
99
+
100
+ for (const fileAbs of files) {
101
+ const fileRel = index.relPath(fileAbs);
102
+ const content = index.getContent(fileAbs);
103
+ if (!content) continue;
104
+
105
+ // Quick content check
106
+ if (!content.includes("express") && !content.includes("app.") && !content.includes("router.")) continue;
107
+
108
+ const { ast, error } = globalASTCache.parse(content, fileAbs);
109
+ if (error || !ast) {
110
+ stats.parseErrors++;
111
+ continue;
112
+ }
113
+
114
+ const constMap = new Map();
115
+ const routerPrefixes = new Map();
116
+
117
+ try {
118
+ // First pass: collect constants and router.use prefixes
119
+ traverse(ast, {
120
+ VariableDeclarator(p) {
121
+ if (t.isIdentifier(p.node.id) && p.node.init) {
122
+ const v = evalStaticString(p.node.init, constMap);
123
+ if (typeof v === "string") constMap.set(p.node.id.name, p.node.init);
124
+
125
+ // Detect express/router assignment
126
+ if (t.isCallExpression(p.node.init)) {
127
+ const callee = p.node.init.callee;
128
+ if (t.isIdentifier(callee, { name: "express" }) ||
129
+ (t.isMemberExpression(callee) && t.isIdentifier(callee.property, { name: "Router" }))) {
130
+ EXPRESS_NAMES.add(p.node.id.name);
131
+ }
132
+ }
133
+ }
134
+ },
135
+ CallExpression(p) {
136
+ const callee = p.node.callee;
137
+ if (!t.isMemberExpression(callee)) return;
138
+ if (!t.isIdentifier(callee.object) || !t.isIdentifier(callee.property)) return;
139
+
140
+ const obj = callee.object.name;
141
+ const method = callee.property.name;
142
+
143
+ // app.use("/api", router) - track prefix
144
+ if (method === "use" && EXPRESS_NAMES.has(obj)) {
145
+ const args = p.node.arguments;
146
+ if (args.length >= 2) {
147
+ const prefixArg = args[0];
148
+ const routerArg = args[1];
149
+ const prefix = evalStaticString(prefixArg, constMap);
150
+ if (typeof prefix === "string" && t.isIdentifier(routerArg)) {
151
+ routerPrefixes.set(routerArg.name, prefix);
152
+ }
153
+ }
154
+ }
155
+ }
156
+ });
157
+
158
+ // Second pass: extract routes
159
+ traverse(ast, {
160
+ CallExpression(p) {
161
+ const callee = p.node.callee;
162
+ if (!t.isMemberExpression(callee)) return;
163
+ if (!t.isIdentifier(callee.object) || !t.isIdentifier(callee.property)) return;
164
+
165
+ const obj = callee.object.name;
166
+ const method = callee.property.name.toLowerCase();
167
+
168
+ if (!EXPRESS_NAMES.has(obj) && !routerPrefixes.has(obj)) return;
169
+ if (!EXPRESS_METHODS.has(method)) return;
170
+
171
+ // Get the path argument
172
+ const pathArg = p.node.arguments[0];
173
+ const routePath = evalStaticString(pathArg, constMap);
174
+ if (!routePath) return;
175
+
176
+ // Skip middleware-only patterns
177
+ if (method === "use" && !routePath.startsWith("/")) return;
178
+
179
+ // Get prefix for this router
180
+ const prefix = routerPrefixes.get(obj) || "/";
181
+ const fullPath = joinPaths(prefix, routePath);
182
+
183
+ const ev = evidenceFromContent(content, fileRel, p.node.loc, `Express ${method.toUpperCase()}("${routePath}")`);
184
+
185
+ routes.push({
186
+ method: method === "use" ? "*" : canonicalizeMethod(method),
187
+ path: fullPath,
188
+ handler: fileRel,
189
+ confidence: "med",
190
+ framework: "express",
191
+ evidence: ev ? [ev] : []
192
+ });
193
+ }
194
+ });
195
+ } catch {
196
+ stats.parseErrors++;
197
+ }
198
+ }
199
+
200
+ return routes;
201
+ }
202
+
203
+ module.exports = {
204
+ extractExpressRoutes,
205
+ canonicalizeMethod,
206
+ canonicalizePath,
207
+ joinPaths,
208
+ };