@vibecheckai/cli 3.2.5 → 3.3.0

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 (197) hide show
  1. package/bin/.generated +25 -25
  2. package/bin/dev/run-v2-torture.js +30 -30
  3. package/bin/registry.js +192 -5
  4. package/bin/runners/lib/__tests__/entitlements-v2.test.js +295 -295
  5. package/bin/runners/lib/agent-firewall/change-packet/builder.js +280 -6
  6. package/bin/runners/lib/agent-firewall/critic/index.js +151 -0
  7. package/bin/runners/lib/agent-firewall/critic/judge.js +432 -0
  8. package/bin/runners/lib/agent-firewall/critic/prompts.js +305 -0
  9. package/bin/runners/lib/agent-firewall/lawbook/distributor.js +465 -0
  10. package/bin/runners/lib/agent-firewall/lawbook/evaluator.js +604 -0
  11. package/bin/runners/lib/agent-firewall/lawbook/index.js +304 -0
  12. package/bin/runners/lib/agent-firewall/lawbook/registry.js +514 -0
  13. package/bin/runners/lib/agent-firewall/lawbook/schema.js +420 -0
  14. package/bin/runners/lib/agent-firewall/logger.js +141 -0
  15. package/bin/runners/lib/agent-firewall/policy/loader.js +312 -4
  16. package/bin/runners/lib/agent-firewall/policy/rules/ghost-env.js +113 -1
  17. package/bin/runners/lib/agent-firewall/policy/rules/ghost-route.js +133 -6
  18. package/bin/runners/lib/agent-firewall/proposal/extractor.js +394 -0
  19. package/bin/runners/lib/agent-firewall/proposal/index.js +212 -0
  20. package/bin/runners/lib/agent-firewall/proposal/schema.js +251 -0
  21. package/bin/runners/lib/agent-firewall/proposal/validator.js +386 -0
  22. package/bin/runners/lib/agent-firewall/reality/index.js +332 -0
  23. package/bin/runners/lib/agent-firewall/reality/state.js +625 -0
  24. package/bin/runners/lib/agent-firewall/reality/watcher.js +322 -0
  25. package/bin/runners/lib/agent-firewall/risk/index.js +173 -0
  26. package/bin/runners/lib/agent-firewall/risk/scorer.js +328 -0
  27. package/bin/runners/lib/agent-firewall/risk/thresholds.js +321 -0
  28. package/bin/runners/lib/agent-firewall/risk/vectors.js +421 -0
  29. package/bin/runners/lib/agent-firewall/simulator/diff-simulator.js +472 -0
  30. package/bin/runners/lib/agent-firewall/simulator/import-resolver.js +346 -0
  31. package/bin/runners/lib/agent-firewall/simulator/index.js +181 -0
  32. package/bin/runners/lib/agent-firewall/simulator/route-validator.js +380 -0
  33. package/bin/runners/lib/agent-firewall/time-machine/incident-correlator.js +661 -0
  34. package/bin/runners/lib/agent-firewall/time-machine/index.js +267 -0
  35. package/bin/runners/lib/agent-firewall/time-machine/replay-engine.js +436 -0
  36. package/bin/runners/lib/agent-firewall/time-machine/state-reconstructor.js +490 -0
  37. package/bin/runners/lib/agent-firewall/time-machine/timeline-builder.js +530 -0
  38. package/bin/runners/lib/analyzers.js +81 -18
  39. package/bin/runners/lib/api-client.js +269 -0
  40. package/bin/runners/lib/auth-truth.js +193 -193
  41. package/bin/runners/lib/authority-badge.js +425 -0
  42. package/bin/runners/lib/backup.js +62 -62
  43. package/bin/runners/lib/billing.js +107 -107
  44. package/bin/runners/lib/claims.js +118 -118
  45. package/bin/runners/lib/cli-output.js +7 -1
  46. package/bin/runners/lib/cli-ui.js +540 -540
  47. package/bin/runners/lib/contracts/auth-contract.js +202 -202
  48. package/bin/runners/lib/contracts/env-contract.js +181 -181
  49. package/bin/runners/lib/contracts/external-contract.js +206 -206
  50. package/bin/runners/lib/contracts/guard.js +168 -168
  51. package/bin/runners/lib/contracts/index.js +89 -89
  52. package/bin/runners/lib/contracts/plan-validator.js +311 -311
  53. package/bin/runners/lib/contracts/route-contract.js +199 -199
  54. package/bin/runners/lib/contracts.js +804 -804
  55. package/bin/runners/lib/detect.js +89 -89
  56. package/bin/runners/lib/doctor/autofix.js +254 -254
  57. package/bin/runners/lib/doctor/index.js +37 -37
  58. package/bin/runners/lib/doctor/modules/dependencies.js +325 -325
  59. package/bin/runners/lib/doctor/modules/index.js +46 -46
  60. package/bin/runners/lib/doctor/modules/network.js +250 -250
  61. package/bin/runners/lib/doctor/modules/project.js +312 -312
  62. package/bin/runners/lib/doctor/modules/runtime.js +224 -224
  63. package/bin/runners/lib/doctor/modules/security.js +348 -348
  64. package/bin/runners/lib/doctor/modules/system.js +213 -213
  65. package/bin/runners/lib/doctor/modules/vibecheck.js +394 -394
  66. package/bin/runners/lib/doctor/reporter.js +262 -262
  67. package/bin/runners/lib/doctor/service.js +262 -262
  68. package/bin/runners/lib/doctor/types.js +113 -113
  69. package/bin/runners/lib/doctor/ui.js +263 -263
  70. package/bin/runners/lib/doctor-v2.js +608 -608
  71. package/bin/runners/lib/drift.js +425 -425
  72. package/bin/runners/lib/enforcement.js +72 -72
  73. package/bin/runners/lib/enterprise-detect.js +603 -603
  74. package/bin/runners/lib/enterprise-init.js +942 -942
  75. package/bin/runners/lib/env-resolver.js +417 -417
  76. package/bin/runners/lib/env-template.js +66 -66
  77. package/bin/runners/lib/env.js +189 -189
  78. package/bin/runners/lib/error-handler.js +16 -9
  79. package/bin/runners/lib/exit-codes.js +275 -0
  80. package/bin/runners/lib/extractors/client-calls.js +990 -990
  81. package/bin/runners/lib/extractors/fastify-route-dump.js +573 -573
  82. package/bin/runners/lib/extractors/fastify-routes.js +426 -426
  83. package/bin/runners/lib/extractors/index.js +363 -363
  84. package/bin/runners/lib/extractors/next-routes.js +524 -524
  85. package/bin/runners/lib/extractors/proof-graph.js +431 -431
  86. package/bin/runners/lib/extractors/route-matcher.js +451 -451
  87. package/bin/runners/lib/extractors/truthpack-v2.js +377 -377
  88. package/bin/runners/lib/extractors/ui-bindings.js +547 -547
  89. package/bin/runners/lib/findings-schema.js +281 -281
  90. package/bin/runners/lib/firewall-prompt.js +50 -50
  91. package/bin/runners/lib/global-flags.js +37 -0
  92. package/bin/runners/lib/graph/graph-builder.js +265 -265
  93. package/bin/runners/lib/graph/html-renderer.js +413 -413
  94. package/bin/runners/lib/graph/index.js +32 -32
  95. package/bin/runners/lib/graph/runtime-collector.js +215 -215
  96. package/bin/runners/lib/graph/static-extractor.js +518 -518
  97. package/bin/runners/lib/help-formatter.js +413 -0
  98. package/bin/runners/lib/html-report.js +650 -650
  99. package/bin/runners/lib/llm.js +75 -75
  100. package/bin/runners/lib/logger.js +38 -0
  101. package/bin/runners/lib/meter.js +61 -61
  102. package/bin/runners/lib/missions/evidence.js +126 -126
  103. package/bin/runners/lib/patch.js +40 -40
  104. package/bin/runners/lib/permissions/auth-model.js +213 -213
  105. package/bin/runners/lib/permissions/idor-prover.js +205 -205
  106. package/bin/runners/lib/permissions/index.js +45 -45
  107. package/bin/runners/lib/permissions/matrix-builder.js +198 -198
  108. package/bin/runners/lib/pkgjson.js +28 -28
  109. package/bin/runners/lib/policy.js +295 -295
  110. package/bin/runners/lib/preflight.js +142 -142
  111. package/bin/runners/lib/reality/correlation-detectors.js +359 -359
  112. package/bin/runners/lib/reality/index.js +318 -318
  113. package/bin/runners/lib/reality/request-hashing.js +416 -416
  114. package/bin/runners/lib/reality/request-mapper.js +453 -453
  115. package/bin/runners/lib/reality/safety-rails.js +463 -463
  116. package/bin/runners/lib/reality/semantic-snapshot.js +408 -408
  117. package/bin/runners/lib/reality/toast-detector.js +393 -393
  118. package/bin/runners/lib/reality-findings.js +84 -84
  119. package/bin/runners/lib/receipts.js +179 -179
  120. package/bin/runners/lib/redact.js +29 -29
  121. package/bin/runners/lib/replay/capsule-manager.js +154 -154
  122. package/bin/runners/lib/replay/index.js +263 -263
  123. package/bin/runners/lib/replay/player.js +348 -348
  124. package/bin/runners/lib/replay/recorder.js +331 -331
  125. package/bin/runners/lib/report.js +135 -135
  126. package/bin/runners/lib/route-detection.js +1140 -1140
  127. package/bin/runners/lib/sandbox/index.js +59 -59
  128. package/bin/runners/lib/sandbox/proof-chain.js +399 -399
  129. package/bin/runners/lib/sandbox/sandbox-runner.js +205 -205
  130. package/bin/runners/lib/sandbox/worktree.js +174 -174
  131. package/bin/runners/lib/schema-validator.js +350 -350
  132. package/bin/runners/lib/schemas/contracts.schema.json +160 -160
  133. package/bin/runners/lib/schemas/finding.schema.json +100 -100
  134. package/bin/runners/lib/schemas/mission-pack.schema.json +206 -206
  135. package/bin/runners/lib/schemas/proof-graph.schema.json +176 -176
  136. package/bin/runners/lib/schemas/reality-report.schema.json +162 -162
  137. package/bin/runners/lib/schemas/share-pack.schema.json +180 -180
  138. package/bin/runners/lib/schemas/ship-report.schema.json +117 -117
  139. package/bin/runners/lib/schemas/truthpack-v2.schema.json +303 -303
  140. package/bin/runners/lib/schemas/validator.js +438 -438
  141. package/bin/runners/lib/score-history.js +282 -282
  142. package/bin/runners/lib/share-pack.js +239 -239
  143. package/bin/runners/lib/snippets.js +67 -67
  144. package/bin/runners/lib/unified-cli-output.js +604 -0
  145. package/bin/runners/lib/upsell.js +658 -510
  146. package/bin/runners/lib/usage.js +153 -153
  147. package/bin/runners/lib/validate-patch.js +156 -156
  148. package/bin/runners/lib/verdict-engine.js +628 -628
  149. package/bin/runners/reality/engine.js +917 -917
  150. package/bin/runners/reality/flows.js +122 -122
  151. package/bin/runners/reality/report.js +378 -378
  152. package/bin/runners/reality/session.js +193 -193
  153. package/bin/runners/runAgent.d.ts +5 -0
  154. package/bin/runners/runApprove.js +1200 -0
  155. package/bin/runners/runAuth.js +324 -95
  156. package/bin/runners/runCheckpoint.js +39 -21
  157. package/bin/runners/runClassify.js +859 -0
  158. package/bin/runners/runContext.js +136 -24
  159. package/bin/runners/runDoctor.js +108 -68
  160. package/bin/runners/runFirewall.d.ts +5 -0
  161. package/bin/runners/runFirewallHook.d.ts +5 -0
  162. package/bin/runners/runFix.js +6 -5
  163. package/bin/runners/runGuard.js +262 -168
  164. package/bin/runners/runInit.js +3 -2
  165. package/bin/runners/runMcp.js +130 -52
  166. package/bin/runners/runPolish.js +43 -20
  167. package/bin/runners/runProve.js +1 -2
  168. package/bin/runners/runReport.js +3 -2
  169. package/bin/runners/runScan.js +145 -44
  170. package/bin/runners/runShip.js +3 -4
  171. package/bin/runners/runTruth.d.ts +5 -0
  172. package/bin/runners/runValidate.js +19 -2
  173. package/bin/runners/runWatch.js +104 -53
  174. package/bin/vibecheck.js +106 -19
  175. package/mcp-server/HARDENING_SUMMARY.md +299 -0
  176. package/mcp-server/agent-firewall-interceptor.js +367 -31
  177. package/mcp-server/authority-tools.js +569 -0
  178. package/mcp-server/conductor/conflict-resolver.js +588 -0
  179. package/mcp-server/conductor/execution-planner.js +544 -0
  180. package/mcp-server/conductor/index.js +377 -0
  181. package/mcp-server/conductor/lock-manager.js +615 -0
  182. package/mcp-server/conductor/request-queue.js +550 -0
  183. package/mcp-server/conductor/session-manager.js +500 -0
  184. package/mcp-server/conductor/tools.js +510 -0
  185. package/mcp-server/index.js +1199 -208
  186. package/mcp-server/lib/api-client.cjs +305 -0
  187. package/mcp-server/lib/logger.cjs +30 -0
  188. package/mcp-server/logger.js +173 -0
  189. package/mcp-server/package.json +2 -2
  190. package/mcp-server/premium-tools.js +2 -2
  191. package/mcp-server/tier-auth.js +351 -136
  192. package/mcp-server/tools/index.js +72 -72
  193. package/mcp-server/truth-firewall-tools.js +145 -15
  194. package/mcp-server/vibecheck-tools.js +2 -2
  195. package/package.json +2 -3
  196. package/mcp-server/index.old.js +0 -4137
  197. package/mcp-server/package-lock.json +0 -165
@@ -1,453 +1,453 @@
1
- /**
2
- * Request Mapper v2
3
- *
4
- * Maps runtime requests to client calls with specificity scoring.
5
- * Handles URL normalization, basePath, proxies, tRPC/GraphQL operations.
6
- */
7
-
8
- "use strict";
9
-
10
- const crypto = require("crypto");
11
-
12
- // =============================================================================
13
- // IGNORE PATTERNS
14
- // =============================================================================
15
-
16
- const IGNORE_PATTERNS = {
17
- // Asset extensions
18
- assets: /\.(js|css|png|jpg|jpeg|gif|svg|ico|woff2?|ttf|eot|map|webp|avif)(\?.*)?$/i,
19
-
20
- // Dev/HMR patterns
21
- hmr: /(_next\/static|__webpack_hmr|hot-update|\.hot-update\.|webpack|turbopack)/i,
22
-
23
- // Analytics/tracking
24
- analytics: /(analytics|gtag|ga\.js|gtm\.js|pixel|clarity|hotjar|segment|mixpanel|amplitude)/i,
25
-
26
- // Third party
27
- thirdParty: /^https?:\/\/(fonts\.googleapis|cdn\.|unpkg\.com|cdnjs\.|jsdelivr)/i,
28
-
29
- // Browser internals
30
- browser: /^(chrome-extension|moz-extension|safari-extension|about:|data:|blob:)/i,
31
-
32
- // Favicon
33
- favicon: /favicon\.ico/i,
34
-
35
- // Source maps
36
- sourceMaps: /\.map$/i,
37
-
38
- // WebSocket
39
- websocket: /^wss?:/i,
40
- };
41
-
42
- /**
43
- * Check if request should be ignored
44
- */
45
- function shouldIgnoreRequest(url, method = "GET") {
46
- if (!url) return true;
47
-
48
- // Always include mutations
49
- if (["POST", "PUT", "PATCH", "DELETE"].includes(method?.toUpperCase())) {
50
- // But still ignore analytics POST
51
- if (IGNORE_PATTERNS.analytics.test(url)) return true;
52
- return false;
53
- }
54
-
55
- for (const pattern of Object.values(IGNORE_PATTERNS)) {
56
- if (pattern.test(url)) return true;
57
- }
58
-
59
- return false;
60
- }
61
-
62
- // =============================================================================
63
- // URL NORMALIZATION
64
- // =============================================================================
65
-
66
- /**
67
- * Normalize URL for matching
68
- */
69
- function normalizeRequestUrl(url, options = {}) {
70
- const { basePath = "", stripHost = true, stripQuery = true } = options;
71
-
72
- if (!url) return null;
73
-
74
- let normalized = url;
75
-
76
- // Strip host if absolute URL
77
- if (stripHost && /^https?:\/\//.test(normalized)) {
78
- try {
79
- const parsed = new URL(normalized);
80
- normalized = parsed.pathname + (stripQuery ? "" : parsed.search);
81
- } catch {
82
- // Invalid URL, try to extract path
83
- normalized = normalized.replace(/^https?:\/\/[^/]+/, "");
84
- }
85
- }
86
-
87
- // Strip query string
88
- if (stripQuery) {
89
- normalized = normalized.split("?")[0].split("#")[0];
90
- }
91
-
92
- // Strip basePath prefix
93
- if (basePath && normalized.startsWith(basePath)) {
94
- normalized = normalized.slice(basePath.length) || "/";
95
- }
96
-
97
- // Ensure leading slash
98
- if (!normalized.startsWith("/")) {
99
- normalized = "/" + normalized;
100
- }
101
-
102
- // Remove trailing slash except for root
103
- if (normalized.length > 1 && normalized.endsWith("/")) {
104
- normalized = normalized.slice(0, -1);
105
- }
106
-
107
- // Normalize multiple slashes
108
- normalized = normalized.replace(/\/+/g, "/");
109
-
110
- return normalized;
111
- }
112
-
113
- /**
114
- * Extract tRPC operation from URL
115
- */
116
- function extractTrpcOperation(url) {
117
- // /api/trpc/user.get?batch=1&input=...
118
- const match = url.match(/\/trpc\/([^?]+)/);
119
- if (!match) return null;
120
-
121
- const procedure = match[1];
122
- // Handle batch queries
123
- const procedures = procedure.split(",").map(p => p.trim());
124
-
125
- return {
126
- type: "trpc",
127
- procedures,
128
- isBatch: procedures.length > 1,
129
- };
130
- }
131
-
132
- /**
133
- * Extract GraphQL operation from request
134
- */
135
- function extractGraphqlOperation(url, body) {
136
- // Check if it's a GraphQL endpoint
137
- if (!url.includes("graphql")) return null;
138
-
139
- if (!body) return { type: "graphql", operationName: null };
140
-
141
- try {
142
- const parsed = typeof body === "string" ? JSON.parse(body) : body;
143
- return {
144
- type: "graphql",
145
- operationName: parsed.operationName || null,
146
- operationType: parsed.query?.trim().startsWith("mutation") ? "mutation" : "query",
147
- };
148
- } catch {
149
- return { type: "graphql", operationName: null };
150
- }
151
- }
152
-
153
- // =============================================================================
154
- // REQUEST → CLIENT CALL MATCHING
155
- // =============================================================================
156
-
157
- /**
158
- * Match a runtime request to client calls
159
- */
160
- function matchRequestToClientCalls(request, clientCalls, options = {}) {
161
- const { basePath = "", rewrites = [] } = options;
162
-
163
- const normalizedPath = normalizeRequestUrl(request.url, { basePath });
164
- if (!normalizedPath) return null;
165
-
166
- const method = (request.method || "GET").toUpperCase();
167
-
168
- // Check for tRPC
169
- const trpcOp = extractTrpcOperation(request.url);
170
- if (trpcOp) {
171
- return matchTrpcRequest(trpcOp, clientCalls, request);
172
- }
173
-
174
- // Check for GraphQL
175
- const gqlOp = extractGraphqlOperation(request.url, request.body);
176
- if (gqlOp) {
177
- return matchGraphqlRequest(gqlOp, clientCalls, request);
178
- }
179
-
180
- // Standard HTTP matching
181
- const candidates = [];
182
-
183
- for (const call of clientCalls) {
184
- if (call.kind !== "http") continue;
185
-
186
- const score = calculateMatchScore(normalizedPath, method, call, { basePath, rewrites });
187
- if (score > 0) {
188
- candidates.push({ call, score });
189
- }
190
- }
191
-
192
- // Sort by score descending
193
- candidates.sort((a, b) => b.score - a.score);
194
-
195
- if (candidates.length === 0) {
196
- return {
197
- matched: false,
198
- request,
199
- normalizedPath,
200
- method,
201
- candidates: [],
202
- };
203
- }
204
-
205
- return {
206
- matched: true,
207
- request,
208
- normalizedPath,
209
- method,
210
- bestMatch: candidates[0].call,
211
- score: candidates[0].score,
212
- candidates: candidates.slice(0, 3),
213
- };
214
- }
215
-
216
- /**
217
- * Match tRPC request to client calls
218
- */
219
- function matchTrpcRequest(trpcOp, clientCalls, request) {
220
- const trpcCalls = clientCalls.filter(c => c.kind === "trpc");
221
-
222
- for (const call of trpcCalls) {
223
- const callProcedure = call.meta?.procedure;
224
- if (!callProcedure) continue;
225
-
226
- // Check if any procedure matches
227
- for (const proc of trpcOp.procedures) {
228
- if (proc === callProcedure || proc.endsWith(callProcedure)) {
229
- return {
230
- matched: true,
231
- request,
232
- matchType: "trpc",
233
- procedure: proc,
234
- bestMatch: call,
235
- score: 1.0,
236
- };
237
- }
238
- }
239
- }
240
-
241
- return {
242
- matched: false,
243
- request,
244
- matchType: "trpc",
245
- procedures: trpcOp.procedures,
246
- };
247
- }
248
-
249
- /**
250
- * Match GraphQL request to client calls
251
- */
252
- function matchGraphqlRequest(gqlOp, clientCalls, request) {
253
- const gqlCalls = clientCalls.filter(c => c.kind === "graphql");
254
-
255
- if (gqlOp.operationName) {
256
- for (const call of gqlCalls) {
257
- if (call.meta?.operationName === gqlOp.operationName) {
258
- return {
259
- matched: true,
260
- request,
261
- matchType: "graphql",
262
- operationName: gqlOp.operationName,
263
- bestMatch: call,
264
- score: 1.0,
265
- };
266
- }
267
- }
268
- }
269
-
270
- // Fallback: match any GraphQL call
271
- if (gqlCalls.length > 0) {
272
- return {
273
- matched: true,
274
- request,
275
- matchType: "graphql",
276
- operationName: gqlOp.operationName,
277
- bestMatch: gqlCalls[0],
278
- score: 0.5,
279
- };
280
- }
281
-
282
- return {
283
- matched: false,
284
- request,
285
- matchType: "graphql",
286
- operationName: gqlOp.operationName,
287
- };
288
- }
289
-
290
- /**
291
- * Calculate match score between request and client call
292
- */
293
- function calculateMatchScore(requestPath, requestMethod, call, options = {}) {
294
- const { basePath = "", rewrites = [] } = options;
295
-
296
- let callPath = call.canonicalPath;
297
- if (!callPath) return 0;
298
-
299
- // Apply rewrites
300
- for (const rewrite of rewrites) {
301
- if (rewrite.source && rewrite.destination) {
302
- const sourceRegex = new RegExp("^" + rewrite.source.replace(/:(\w+)/g, "([^/]+)") + "$");
303
- if (sourceRegex.test(requestPath)) {
304
- // Rewrite matches, adjust call path expectation
305
- callPath = requestPath.replace(sourceRegex, rewrite.destination);
306
- break;
307
- }
308
- }
309
- }
310
-
311
- let score = 0;
312
-
313
- // Exact path match
314
- if (requestPath === callPath) {
315
- score += 1.0;
316
- }
317
- // Parameterized match
318
- else if (callPath.includes("{") || callPath.includes(":")) {
319
- const pattern = "^" + callPath
320
- .replace(/\{[^}]+\}/g, "[^/]+")
321
- .replace(/:(\w+)/g, "[^/]+") + "$";
322
- const regex = new RegExp(pattern);
323
- if (regex.test(requestPath)) {
324
- score += 0.9;
325
- }
326
- }
327
- // Prefix match (less confident)
328
- else if (requestPath.startsWith(callPath) || callPath.startsWith(requestPath)) {
329
- score += 0.5;
330
- }
331
-
332
- if (score === 0) return 0;
333
-
334
- // Method match bonus
335
- const callMethod = (call.method || "UNKNOWN").toUpperCase();
336
- if (callMethod === requestMethod) {
337
- score += 0.1;
338
- } else if (callMethod === "UNKNOWN" || callMethod === "*") {
339
- // No penalty for unknown
340
- } else {
341
- score -= 0.2; // Method mismatch penalty
342
- }
343
-
344
- // Confidence bonus
345
- if (call.confidence === "high") {
346
- score += 0.05;
347
- } else if (call.confidence === "low") {
348
- score -= 0.05;
349
- }
350
-
351
- return Math.max(0, Math.min(1, score));
352
- }
353
-
354
- // =============================================================================
355
- // BATCH MAPPING
356
- // =============================================================================
357
-
358
- /**
359
- * Map all runtime requests to client calls
360
- */
361
- function mapAllRequests(requests, clientCalls, options = {}) {
362
- const { basePath = "", rewrites = [], includeIgnored = false } = options;
363
-
364
- const results = {
365
- mapped: [],
366
- unmapped: [],
367
- ignored: [],
368
- stats: {
369
- total: requests.length,
370
- mapped: 0,
371
- unmapped: 0,
372
- ignored: 0,
373
- byMatchType: {},
374
- },
375
- };
376
-
377
- for (const request of requests) {
378
- // Check if should ignore
379
- if (shouldIgnoreRequest(request.url, request.method)) {
380
- if (includeIgnored) {
381
- results.ignored.push(request);
382
- }
383
- results.stats.ignored++;
384
- continue;
385
- }
386
-
387
- const match = matchRequestToClientCalls(request, clientCalls, { basePath, rewrites });
388
-
389
- if (match.matched) {
390
- results.mapped.push(match);
391
- results.stats.mapped++;
392
-
393
- const matchType = match.matchType || "http";
394
- results.stats.byMatchType[matchType] = (results.stats.byMatchType[matchType] || 0) + 1;
395
- } else {
396
- results.unmapped.push(match);
397
- results.stats.unmapped++;
398
- }
399
- }
400
-
401
- return results;
402
- }
403
-
404
- /**
405
- * Group mapped requests by client call
406
- */
407
- function groupRequestsByClientCall(mappedResults) {
408
- const groups = new Map();
409
-
410
- for (const match of mappedResults) {
411
- if (!match.bestMatch) continue;
412
-
413
- const callId = match.bestMatch.id;
414
- if (!groups.has(callId)) {
415
- groups.set(callId, {
416
- clientCall: match.bestMatch,
417
- requests: [],
418
- statuses: [],
419
- });
420
- }
421
-
422
- const group = groups.get(callId);
423
- group.requests.push(match.request);
424
- if (match.request.status) {
425
- group.statuses.push(match.request.status);
426
- }
427
- }
428
-
429
- return groups;
430
- }
431
-
432
- // =============================================================================
433
- // EXPORTS
434
- // =============================================================================
435
-
436
- module.exports = {
437
- // Ignore patterns
438
- IGNORE_PATTERNS,
439
- shouldIgnoreRequest,
440
-
441
- // URL normalization
442
- normalizeRequestUrl,
443
- extractTrpcOperation,
444
- extractGraphqlOperation,
445
-
446
- // Matching
447
- matchRequestToClientCalls,
448
- calculateMatchScore,
449
-
450
- // Batch operations
451
- mapAllRequests,
452
- groupRequestsByClientCall,
453
- };
1
+ /**
2
+ * Request Mapper v2
3
+ *
4
+ * Maps runtime requests to client calls with specificity scoring.
5
+ * Handles URL normalization, basePath, proxies, tRPC/GraphQL operations.
6
+ */
7
+
8
+ "use strict";
9
+
10
+ const crypto = require("crypto");
11
+
12
+ // =============================================================================
13
+ // IGNORE PATTERNS
14
+ // =============================================================================
15
+
16
+ const IGNORE_PATTERNS = {
17
+ // Asset extensions
18
+ assets: /\.(js|css|png|jpg|jpeg|gif|svg|ico|woff2?|ttf|eot|map|webp|avif)(\?.*)?$/i,
19
+
20
+ // Dev/HMR patterns
21
+ hmr: /(_next\/static|__webpack_hmr|hot-update|\.hot-update\.|webpack|turbopack)/i,
22
+
23
+ // Analytics/tracking
24
+ analytics: /(analytics|gtag|ga\.js|gtm\.js|pixel|clarity|hotjar|segment|mixpanel|amplitude)/i,
25
+
26
+ // Third party
27
+ thirdParty: /^https?:\/\/(fonts\.googleapis|cdn\.|unpkg\.com|cdnjs\.|jsdelivr)/i,
28
+
29
+ // Browser internals
30
+ browser: /^(chrome-extension|moz-extension|safari-extension|about:|data:|blob:)/i,
31
+
32
+ // Favicon
33
+ favicon: /favicon\.ico/i,
34
+
35
+ // Source maps
36
+ sourceMaps: /\.map$/i,
37
+
38
+ // WebSocket
39
+ websocket: /^wss?:/i,
40
+ };
41
+
42
+ /**
43
+ * Check if request should be ignored
44
+ */
45
+ function shouldIgnoreRequest(url, method = "GET") {
46
+ if (!url) return true;
47
+
48
+ // Always include mutations
49
+ if (["POST", "PUT", "PATCH", "DELETE"].includes(method?.toUpperCase())) {
50
+ // But still ignore analytics POST
51
+ if (IGNORE_PATTERNS.analytics.test(url)) return true;
52
+ return false;
53
+ }
54
+
55
+ for (const pattern of Object.values(IGNORE_PATTERNS)) {
56
+ if (pattern.test(url)) return true;
57
+ }
58
+
59
+ return false;
60
+ }
61
+
62
+ // =============================================================================
63
+ // URL NORMALIZATION
64
+ // =============================================================================
65
+
66
+ /**
67
+ * Normalize URL for matching
68
+ */
69
+ function normalizeRequestUrl(url, options = {}) {
70
+ const { basePath = "", stripHost = true, stripQuery = true } = options;
71
+
72
+ if (!url) return null;
73
+
74
+ let normalized = url;
75
+
76
+ // Strip host if absolute URL
77
+ if (stripHost && /^https?:\/\//.test(normalized)) {
78
+ try {
79
+ const parsed = new URL(normalized);
80
+ normalized = parsed.pathname + (stripQuery ? "" : parsed.search);
81
+ } catch {
82
+ // Invalid URL, try to extract path
83
+ normalized = normalized.replace(/^https?:\/\/[^/]+/, "");
84
+ }
85
+ }
86
+
87
+ // Strip query string
88
+ if (stripQuery) {
89
+ normalized = normalized.split("?")[0].split("#")[0];
90
+ }
91
+
92
+ // Strip basePath prefix
93
+ if (basePath && normalized.startsWith(basePath)) {
94
+ normalized = normalized.slice(basePath.length) || "/";
95
+ }
96
+
97
+ // Ensure leading slash
98
+ if (!normalized.startsWith("/")) {
99
+ normalized = "/" + normalized;
100
+ }
101
+
102
+ // Remove trailing slash except for root
103
+ if (normalized.length > 1 && normalized.endsWith("/")) {
104
+ normalized = normalized.slice(0, -1);
105
+ }
106
+
107
+ // Normalize multiple slashes
108
+ normalized = normalized.replace(/\/+/g, "/");
109
+
110
+ return normalized;
111
+ }
112
+
113
+ /**
114
+ * Extract tRPC operation from URL
115
+ */
116
+ function extractTrpcOperation(url) {
117
+ // /api/trpc/user.get?batch=1&input=...
118
+ const match = url.match(/\/trpc\/([^?]+)/);
119
+ if (!match) return null;
120
+
121
+ const procedure = match[1];
122
+ // Handle batch queries
123
+ const procedures = procedure.split(",").map(p => p.trim());
124
+
125
+ return {
126
+ type: "trpc",
127
+ procedures,
128
+ isBatch: procedures.length > 1,
129
+ };
130
+ }
131
+
132
+ /**
133
+ * Extract GraphQL operation from request
134
+ */
135
+ function extractGraphqlOperation(url, body) {
136
+ // Check if it's a GraphQL endpoint
137
+ if (!url.includes("graphql")) return null;
138
+
139
+ if (!body) return { type: "graphql", operationName: null };
140
+
141
+ try {
142
+ const parsed = typeof body === "string" ? JSON.parse(body) : body;
143
+ return {
144
+ type: "graphql",
145
+ operationName: parsed.operationName || null,
146
+ operationType: parsed.query?.trim().startsWith("mutation") ? "mutation" : "query",
147
+ };
148
+ } catch {
149
+ return { type: "graphql", operationName: null };
150
+ }
151
+ }
152
+
153
+ // =============================================================================
154
+ // REQUEST → CLIENT CALL MATCHING
155
+ // =============================================================================
156
+
157
+ /**
158
+ * Match a runtime request to client calls
159
+ */
160
+ function matchRequestToClientCalls(request, clientCalls, options = {}) {
161
+ const { basePath = "", rewrites = [] } = options;
162
+
163
+ const normalizedPath = normalizeRequestUrl(request.url, { basePath });
164
+ if (!normalizedPath) return null;
165
+
166
+ const method = (request.method || "GET").toUpperCase();
167
+
168
+ // Check for tRPC
169
+ const trpcOp = extractTrpcOperation(request.url);
170
+ if (trpcOp) {
171
+ return matchTrpcRequest(trpcOp, clientCalls, request);
172
+ }
173
+
174
+ // Check for GraphQL
175
+ const gqlOp = extractGraphqlOperation(request.url, request.body);
176
+ if (gqlOp) {
177
+ return matchGraphqlRequest(gqlOp, clientCalls, request);
178
+ }
179
+
180
+ // Standard HTTP matching
181
+ const candidates = [];
182
+
183
+ for (const call of clientCalls) {
184
+ if (call.kind !== "http") continue;
185
+
186
+ const score = calculateMatchScore(normalizedPath, method, call, { basePath, rewrites });
187
+ if (score > 0) {
188
+ candidates.push({ call, score });
189
+ }
190
+ }
191
+
192
+ // Sort by score descending
193
+ candidates.sort((a, b) => b.score - a.score);
194
+
195
+ if (candidates.length === 0) {
196
+ return {
197
+ matched: false,
198
+ request,
199
+ normalizedPath,
200
+ method,
201
+ candidates: [],
202
+ };
203
+ }
204
+
205
+ return {
206
+ matched: true,
207
+ request,
208
+ normalizedPath,
209
+ method,
210
+ bestMatch: candidates[0].call,
211
+ score: candidates[0].score,
212
+ candidates: candidates.slice(0, 3),
213
+ };
214
+ }
215
+
216
+ /**
217
+ * Match tRPC request to client calls
218
+ */
219
+ function matchTrpcRequest(trpcOp, clientCalls, request) {
220
+ const trpcCalls = clientCalls.filter(c => c.kind === "trpc");
221
+
222
+ for (const call of trpcCalls) {
223
+ const callProcedure = call.meta?.procedure;
224
+ if (!callProcedure) continue;
225
+
226
+ // Check if any procedure matches
227
+ for (const proc of trpcOp.procedures) {
228
+ if (proc === callProcedure || proc.endsWith(callProcedure)) {
229
+ return {
230
+ matched: true,
231
+ request,
232
+ matchType: "trpc",
233
+ procedure: proc,
234
+ bestMatch: call,
235
+ score: 1.0,
236
+ };
237
+ }
238
+ }
239
+ }
240
+
241
+ return {
242
+ matched: false,
243
+ request,
244
+ matchType: "trpc",
245
+ procedures: trpcOp.procedures,
246
+ };
247
+ }
248
+
249
+ /**
250
+ * Match GraphQL request to client calls
251
+ */
252
+ function matchGraphqlRequest(gqlOp, clientCalls, request) {
253
+ const gqlCalls = clientCalls.filter(c => c.kind === "graphql");
254
+
255
+ if (gqlOp.operationName) {
256
+ for (const call of gqlCalls) {
257
+ if (call.meta?.operationName === gqlOp.operationName) {
258
+ return {
259
+ matched: true,
260
+ request,
261
+ matchType: "graphql",
262
+ operationName: gqlOp.operationName,
263
+ bestMatch: call,
264
+ score: 1.0,
265
+ };
266
+ }
267
+ }
268
+ }
269
+
270
+ // Fallback: match any GraphQL call
271
+ if (gqlCalls.length > 0) {
272
+ return {
273
+ matched: true,
274
+ request,
275
+ matchType: "graphql",
276
+ operationName: gqlOp.operationName,
277
+ bestMatch: gqlCalls[0],
278
+ score: 0.5,
279
+ };
280
+ }
281
+
282
+ return {
283
+ matched: false,
284
+ request,
285
+ matchType: "graphql",
286
+ operationName: gqlOp.operationName,
287
+ };
288
+ }
289
+
290
+ /**
291
+ * Calculate match score between request and client call
292
+ */
293
+ function calculateMatchScore(requestPath, requestMethod, call, options = {}) {
294
+ const { basePath = "", rewrites = [] } = options;
295
+
296
+ let callPath = call.canonicalPath;
297
+ if (!callPath) return 0;
298
+
299
+ // Apply rewrites
300
+ for (const rewrite of rewrites) {
301
+ if (rewrite.source && rewrite.destination) {
302
+ const sourceRegex = new RegExp("^" + rewrite.source.replace(/:(\w+)/g, "([^/]+)") + "$");
303
+ if (sourceRegex.test(requestPath)) {
304
+ // Rewrite matches, adjust call path expectation
305
+ callPath = requestPath.replace(sourceRegex, rewrite.destination);
306
+ break;
307
+ }
308
+ }
309
+ }
310
+
311
+ let score = 0;
312
+
313
+ // Exact path match
314
+ if (requestPath === callPath) {
315
+ score += 1.0;
316
+ }
317
+ // Parameterized match
318
+ else if (callPath.includes("{") || callPath.includes(":")) {
319
+ const pattern = "^" + callPath
320
+ .replace(/\{[^}]+\}/g, "[^/]+")
321
+ .replace(/:(\w+)/g, "[^/]+") + "$";
322
+ const regex = new RegExp(pattern);
323
+ if (regex.test(requestPath)) {
324
+ score += 0.9;
325
+ }
326
+ }
327
+ // Prefix match (less confident)
328
+ else if (requestPath.startsWith(callPath) || callPath.startsWith(requestPath)) {
329
+ score += 0.5;
330
+ }
331
+
332
+ if (score === 0) return 0;
333
+
334
+ // Method match bonus
335
+ const callMethod = (call.method || "UNKNOWN").toUpperCase();
336
+ if (callMethod === requestMethod) {
337
+ score += 0.1;
338
+ } else if (callMethod === "UNKNOWN" || callMethod === "*") {
339
+ // No penalty for unknown
340
+ } else {
341
+ score -= 0.2; // Method mismatch penalty
342
+ }
343
+
344
+ // Confidence bonus
345
+ if (call.confidence === "high") {
346
+ score += 0.05;
347
+ } else if (call.confidence === "low") {
348
+ score -= 0.05;
349
+ }
350
+
351
+ return Math.max(0, Math.min(1, score));
352
+ }
353
+
354
+ // =============================================================================
355
+ // BATCH MAPPING
356
+ // =============================================================================
357
+
358
+ /**
359
+ * Map all runtime requests to client calls
360
+ */
361
+ function mapAllRequests(requests, clientCalls, options = {}) {
362
+ const { basePath = "", rewrites = [], includeIgnored = false } = options;
363
+
364
+ const results = {
365
+ mapped: [],
366
+ unmapped: [],
367
+ ignored: [],
368
+ stats: {
369
+ total: requests.length,
370
+ mapped: 0,
371
+ unmapped: 0,
372
+ ignored: 0,
373
+ byMatchType: {},
374
+ },
375
+ };
376
+
377
+ for (const request of requests) {
378
+ // Check if should ignore
379
+ if (shouldIgnoreRequest(request.url, request.method)) {
380
+ if (includeIgnored) {
381
+ results.ignored.push(request);
382
+ }
383
+ results.stats.ignored++;
384
+ continue;
385
+ }
386
+
387
+ const match = matchRequestToClientCalls(request, clientCalls, { basePath, rewrites });
388
+
389
+ if (match.matched) {
390
+ results.mapped.push(match);
391
+ results.stats.mapped++;
392
+
393
+ const matchType = match.matchType || "http";
394
+ results.stats.byMatchType[matchType] = (results.stats.byMatchType[matchType] || 0) + 1;
395
+ } else {
396
+ results.unmapped.push(match);
397
+ results.stats.unmapped++;
398
+ }
399
+ }
400
+
401
+ return results;
402
+ }
403
+
404
+ /**
405
+ * Group mapped requests by client call
406
+ */
407
+ function groupRequestsByClientCall(mappedResults) {
408
+ const groups = new Map();
409
+
410
+ for (const match of mappedResults) {
411
+ if (!match.bestMatch) continue;
412
+
413
+ const callId = match.bestMatch.id;
414
+ if (!groups.has(callId)) {
415
+ groups.set(callId, {
416
+ clientCall: match.bestMatch,
417
+ requests: [],
418
+ statuses: [],
419
+ });
420
+ }
421
+
422
+ const group = groups.get(callId);
423
+ group.requests.push(match.request);
424
+ if (match.request.status) {
425
+ group.statuses.push(match.request.status);
426
+ }
427
+ }
428
+
429
+ return groups;
430
+ }
431
+
432
+ // =============================================================================
433
+ // EXPORTS
434
+ // =============================================================================
435
+
436
+ module.exports = {
437
+ // Ignore patterns
438
+ IGNORE_PATTERNS,
439
+ shouldIgnoreRequest,
440
+
441
+ // URL normalization
442
+ normalizeRequestUrl,
443
+ extractTrpcOperation,
444
+ extractGraphqlOperation,
445
+
446
+ // Matching
447
+ matchRequestToClientCalls,
448
+ calculateMatchScore,
449
+
450
+ // Batch operations
451
+ mapAllRequests,
452
+ groupRequestsByClientCall,
453
+ };