@vibecheckai/cli 3.5.0 → 3.5.1

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 (326) hide show
  1. package/bin/registry.js +174 -449
  2. package/bin/runners/cli-utils.js +33 -2
  3. package/bin/runners/context/generators/cursor.js +2 -49
  4. package/bin/runners/context/generators/mcp.js +13 -15
  5. package/bin/runners/context/proof-context.js +1 -248
  6. package/bin/runners/lib/analysis-core.js +180 -198
  7. package/bin/runners/lib/analyzers.js +241 -2212
  8. package/bin/runners/lib/cli-output.js +210 -242
  9. package/bin/runners/lib/detectors-v2.js +785 -547
  10. package/bin/runners/lib/entitlements-v2.js +431 -161
  11. package/bin/runners/lib/error-handler.js +9 -16
  12. package/bin/runners/lib/global-flags.js +0 -37
  13. package/bin/runners/lib/html-proof-report.js +700 -350
  14. package/bin/runners/lib/missions/plan.js +6 -46
  15. package/bin/runners/lib/missions/templates.js +0 -232
  16. package/bin/runners/lib/route-truth.js +322 -1167
  17. package/bin/runners/lib/scan-output.js +467 -493
  18. package/bin/runners/lib/ship-output.js +27 -280
  19. package/bin/runners/lib/terminal-ui.js +700 -310
  20. package/bin/runners/lib/truth.js +321 -1004
  21. package/bin/runners/lib/unified-output.js +158 -162
  22. package/bin/runners/lib/upsell.js +204 -104
  23. package/bin/runners/runAIAgent.js +10 -5
  24. package/bin/runners/runAllowlist.js +324 -0
  25. package/bin/runners/runAuth.js +94 -344
  26. package/bin/runners/runCheckpoint.js +45 -43
  27. package/bin/runners/runContext.js +24 -139
  28. package/bin/runners/runDoctor.js +101 -136
  29. package/bin/runners/runEvidencePack.js +219 -0
  30. package/bin/runners/runFix.js +71 -82
  31. package/bin/runners/runGuard.js +119 -606
  32. package/bin/runners/runInit.js +60 -22
  33. package/bin/runners/runInstall.js +281 -0
  34. package/bin/runners/runLabs.js +341 -0
  35. package/bin/runners/runMcp.js +62 -139
  36. package/bin/runners/runPolish.js +83 -282
  37. package/bin/runners/runPromptFirewall.js +12 -5
  38. package/bin/runners/runProve.js +58 -33
  39. package/bin/runners/runReality.js +58 -81
  40. package/bin/runners/runReport.js +7 -34
  41. package/bin/runners/runRuntime.js +8 -5
  42. package/bin/runners/runScan.js +844 -219
  43. package/bin/runners/runShip.js +59 -721
  44. package/bin/runners/runValidate.js +11 -24
  45. package/bin/runners/runWatch.js +76 -131
  46. package/bin/vibecheck.js +69 -295
  47. package/mcp-server/ARCHITECTURE.md +339 -0
  48. package/mcp-server/__tests__/cache.test.ts +313 -0
  49. package/mcp-server/__tests__/executor.test.ts +239 -0
  50. package/mcp-server/__tests__/fixtures/exclusion-test/.cache/webpack/cache.pack +1 -0
  51. package/mcp-server/__tests__/fixtures/exclusion-test/.next/server/chunk.js +3 -0
  52. package/mcp-server/__tests__/fixtures/exclusion-test/.turbo/cache.json +3 -0
  53. package/mcp-server/__tests__/fixtures/exclusion-test/.venv/lib/env.py +3 -0
  54. package/mcp-server/__tests__/fixtures/exclusion-test/dist/bundle.js +3 -0
  55. package/mcp-server/__tests__/fixtures/exclusion-test/package.json +5 -0
  56. package/mcp-server/__tests__/fixtures/exclusion-test/src/app.ts +5 -0
  57. package/mcp-server/__tests__/fixtures/exclusion-test/venv/lib/config.py +4 -0
  58. package/mcp-server/__tests__/ids.test.ts +345 -0
  59. package/mcp-server/__tests__/integration/tools.test.ts +410 -0
  60. package/mcp-server/__tests__/registry.test.ts +365 -0
  61. package/mcp-server/__tests__/sandbox.test.ts +323 -0
  62. package/mcp-server/__tests__/schemas.test.ts +372 -0
  63. package/mcp-server/benchmarks/run-benchmarks.ts +304 -0
  64. package/mcp-server/examples/doctor.request.json +14 -0
  65. package/mcp-server/examples/doctor.response.json +53 -0
  66. package/mcp-server/examples/error.response.json +15 -0
  67. package/mcp-server/examples/scan.request.json +14 -0
  68. package/mcp-server/examples/scan.response.json +108 -0
  69. package/mcp-server/handlers/tool-handler.ts +671 -0
  70. package/mcp-server/index-v1.js +698 -0
  71. package/mcp-server/index-v3.ts +293 -0
  72. package/mcp-server/index.js +1080 -1757
  73. package/mcp-server/index.old.js +4137 -0
  74. package/mcp-server/lib/cache.ts +341 -0
  75. package/mcp-server/lib/errors.ts +346 -0
  76. package/mcp-server/lib/executor.ts +792 -0
  77. package/mcp-server/lib/ids.ts +238 -0
  78. package/mcp-server/lib/logger.ts +368 -0
  79. package/mcp-server/lib/metrics.ts +365 -0
  80. package/mcp-server/lib/sandbox.ts +337 -0
  81. package/mcp-server/lib/validator.ts +229 -0
  82. package/mcp-server/package-lock.json +165 -0
  83. package/mcp-server/package.json +32 -7
  84. package/mcp-server/premium-tools.js +2 -2
  85. package/mcp-server/registry/tools.json +476 -0
  86. package/mcp-server/schemas/error-envelope.schema.json +125 -0
  87. package/mcp-server/schemas/finding.schema.json +167 -0
  88. package/mcp-server/schemas/report-artifact.schema.json +88 -0
  89. package/mcp-server/schemas/run-request.schema.json +75 -0
  90. package/mcp-server/schemas/verdict.schema.json +168 -0
  91. package/mcp-server/tier-auth.d.ts +71 -0
  92. package/mcp-server/tier-auth.js +371 -183
  93. package/mcp-server/truth-context.js +90 -131
  94. package/mcp-server/truth-firewall-tools.js +1000 -1611
  95. package/mcp-server/tsconfig.json +34 -0
  96. package/mcp-server/vibecheck-tools.js +2 -2
  97. package/mcp-server/vitest.config.ts +16 -0
  98. package/package.json +3 -4
  99. package/bin/runners/lib/agent-firewall/ai/false-positive-analyzer.js +0 -474
  100. package/bin/runners/lib/agent-firewall/change-packet/builder.js +0 -488
  101. package/bin/runners/lib/agent-firewall/change-packet/schema.json +0 -228
  102. package/bin/runners/lib/agent-firewall/change-packet/store.js +0 -200
  103. package/bin/runners/lib/agent-firewall/claims/claim-types.js +0 -21
  104. package/bin/runners/lib/agent-firewall/claims/extractor.js +0 -303
  105. package/bin/runners/lib/agent-firewall/claims/patterns.js +0 -24
  106. package/bin/runners/lib/agent-firewall/critic/index.js +0 -151
  107. package/bin/runners/lib/agent-firewall/critic/judge.js +0 -432
  108. package/bin/runners/lib/agent-firewall/critic/prompts.js +0 -305
  109. package/bin/runners/lib/agent-firewall/evidence/auth-evidence.js +0 -88
  110. package/bin/runners/lib/agent-firewall/evidence/contract-evidence.js +0 -75
  111. package/bin/runners/lib/agent-firewall/evidence/env-evidence.js +0 -127
  112. package/bin/runners/lib/agent-firewall/evidence/resolver.js +0 -102
  113. package/bin/runners/lib/agent-firewall/evidence/route-evidence.js +0 -213
  114. package/bin/runners/lib/agent-firewall/evidence/side-effect-evidence.js +0 -145
  115. package/bin/runners/lib/agent-firewall/fs-hook/daemon.js +0 -19
  116. package/bin/runners/lib/agent-firewall/fs-hook/installer.js +0 -87
  117. package/bin/runners/lib/agent-firewall/fs-hook/watcher.js +0 -184
  118. package/bin/runners/lib/agent-firewall/git-hook/pre-commit.js +0 -163
  119. package/bin/runners/lib/agent-firewall/ide-extension/cursor.js +0 -107
  120. package/bin/runners/lib/agent-firewall/ide-extension/vscode.js +0 -68
  121. package/bin/runners/lib/agent-firewall/ide-extension/windsurf.js +0 -66
  122. package/bin/runners/lib/agent-firewall/interceptor/base.js +0 -304
  123. package/bin/runners/lib/agent-firewall/interceptor/cursor.js +0 -35
  124. package/bin/runners/lib/agent-firewall/interceptor/vscode.js +0 -35
  125. package/bin/runners/lib/agent-firewall/interceptor/windsurf.js +0 -34
  126. package/bin/runners/lib/agent-firewall/lawbook/distributor.js +0 -465
  127. package/bin/runners/lib/agent-firewall/lawbook/evaluator.js +0 -604
  128. package/bin/runners/lib/agent-firewall/lawbook/index.js +0 -304
  129. package/bin/runners/lib/agent-firewall/lawbook/registry.js +0 -514
  130. package/bin/runners/lib/agent-firewall/lawbook/schema.js +0 -420
  131. package/bin/runners/lib/agent-firewall/learning/learning-engine.js +0 -849
  132. package/bin/runners/lib/agent-firewall/logger.js +0 -141
  133. package/bin/runners/lib/agent-firewall/policy/default-policy.json +0 -90
  134. package/bin/runners/lib/agent-firewall/policy/engine.js +0 -103
  135. package/bin/runners/lib/agent-firewall/policy/loader.js +0 -451
  136. package/bin/runners/lib/agent-firewall/policy/rules/auth-drift.js +0 -50
  137. package/bin/runners/lib/agent-firewall/policy/rules/contract-drift.js +0 -50
  138. package/bin/runners/lib/agent-firewall/policy/rules/fake-success.js +0 -86
  139. package/bin/runners/lib/agent-firewall/policy/rules/ghost-env.js +0 -162
  140. package/bin/runners/lib/agent-firewall/policy/rules/ghost-route.js +0 -189
  141. package/bin/runners/lib/agent-firewall/policy/rules/scope.js +0 -93
  142. package/bin/runners/lib/agent-firewall/policy/rules/unsafe-side-effect.js +0 -57
  143. package/bin/runners/lib/agent-firewall/policy/schema.json +0 -183
  144. package/bin/runners/lib/agent-firewall/policy/verdict.js +0 -54
  145. package/bin/runners/lib/agent-firewall/proposal/extractor.js +0 -394
  146. package/bin/runners/lib/agent-firewall/proposal/index.js +0 -212
  147. package/bin/runners/lib/agent-firewall/proposal/schema.js +0 -251
  148. package/bin/runners/lib/agent-firewall/proposal/validator.js +0 -386
  149. package/bin/runners/lib/agent-firewall/reality/index.js +0 -332
  150. package/bin/runners/lib/agent-firewall/reality/state.js +0 -625
  151. package/bin/runners/lib/agent-firewall/reality/watcher.js +0 -322
  152. package/bin/runners/lib/agent-firewall/risk/index.js +0 -173
  153. package/bin/runners/lib/agent-firewall/risk/scorer.js +0 -328
  154. package/bin/runners/lib/agent-firewall/risk/thresholds.js +0 -321
  155. package/bin/runners/lib/agent-firewall/risk/vectors.js +0 -421
  156. package/bin/runners/lib/agent-firewall/simulator/diff-simulator.js +0 -472
  157. package/bin/runners/lib/agent-firewall/simulator/import-resolver.js +0 -346
  158. package/bin/runners/lib/agent-firewall/simulator/index.js +0 -181
  159. package/bin/runners/lib/agent-firewall/simulator/route-validator.js +0 -380
  160. package/bin/runners/lib/agent-firewall/time-machine/incident-correlator.js +0 -661
  161. package/bin/runners/lib/agent-firewall/time-machine/index.js +0 -267
  162. package/bin/runners/lib/agent-firewall/time-machine/replay-engine.js +0 -436
  163. package/bin/runners/lib/agent-firewall/time-machine/state-reconstructor.js +0 -490
  164. package/bin/runners/lib/agent-firewall/time-machine/timeline-builder.js +0 -530
  165. package/bin/runners/lib/agent-firewall/truthpack/index.js +0 -67
  166. package/bin/runners/lib/agent-firewall/truthpack/loader.js +0 -137
  167. package/bin/runners/lib/agent-firewall/unblock/planner.js +0 -337
  168. package/bin/runners/lib/agent-firewall/utils/ignore-checker.js +0 -118
  169. package/bin/runners/lib/api-client.js +0 -269
  170. package/bin/runners/lib/audit-logger.js +0 -532
  171. package/bin/runners/lib/authority/authorities/architecture.js +0 -364
  172. package/bin/runners/lib/authority/authorities/compliance.js +0 -341
  173. package/bin/runners/lib/authority/authorities/human.js +0 -343
  174. package/bin/runners/lib/authority/authorities/quality.js +0 -420
  175. package/bin/runners/lib/authority/authorities/security.js +0 -228
  176. package/bin/runners/lib/authority/index.js +0 -293
  177. package/bin/runners/lib/authority-badge.js +0 -425
  178. package/bin/runners/lib/bundle/bundle-intelligence.js +0 -846
  179. package/bin/runners/lib/cli-charts.js +0 -368
  180. package/bin/runners/lib/cli-config-display.js +0 -405
  181. package/bin/runners/lib/cli-demo.js +0 -275
  182. package/bin/runners/lib/cli-errors.js +0 -438
  183. package/bin/runners/lib/cli-help-formatter.js +0 -439
  184. package/bin/runners/lib/cli-interactive-menu.js +0 -509
  185. package/bin/runners/lib/cli-prompts.js +0 -441
  186. package/bin/runners/lib/cli-scan-cards.js +0 -362
  187. package/bin/runners/lib/compliance-reporter.js +0 -710
  188. package/bin/runners/lib/conductor/index.js +0 -671
  189. package/bin/runners/lib/easy/README.md +0 -123
  190. package/bin/runners/lib/easy/index.js +0 -140
  191. package/bin/runners/lib/easy/interactive-wizard.js +0 -788
  192. package/bin/runners/lib/easy/one-click-firewall.js +0 -564
  193. package/bin/runners/lib/easy/zero-config-reality.js +0 -714
  194. package/bin/runners/lib/engines/accessibility-engine.js +0 -390
  195. package/bin/runners/lib/engines/api-consistency-engine.js +0 -467
  196. package/bin/runners/lib/engines/ast-cache.js +0 -99
  197. package/bin/runners/lib/engines/async-patterns-engine.js +0 -444
  198. package/bin/runners/lib/engines/bundle-size-engine.js +0 -433
  199. package/bin/runners/lib/engines/code-quality-engine.js +0 -255
  200. package/bin/runners/lib/engines/confidence-scoring.js +0 -276
  201. package/bin/runners/lib/engines/console-logs-engine.js +0 -115
  202. package/bin/runners/lib/engines/context-detection.js +0 -264
  203. package/bin/runners/lib/engines/cross-file-analysis-engine.js +0 -533
  204. package/bin/runners/lib/engines/database-patterns-engine.js +0 -429
  205. package/bin/runners/lib/engines/dead-code-engine.js +0 -198
  206. package/bin/runners/lib/engines/deprecated-api-engine.js +0 -226
  207. package/bin/runners/lib/engines/duplicate-code-engine.js +0 -354
  208. package/bin/runners/lib/engines/empty-catch-engine.js +0 -260
  209. package/bin/runners/lib/engines/env-variables-engine.js +0 -458
  210. package/bin/runners/lib/engines/error-handling-engine.js +0 -437
  211. package/bin/runners/lib/engines/false-positive-prevention.js +0 -630
  212. package/bin/runners/lib/engines/file-filter.js +0 -131
  213. package/bin/runners/lib/engines/framework-adapters/index.js +0 -607
  214. package/bin/runners/lib/engines/framework-detection.js +0 -508
  215. package/bin/runners/lib/engines/hardcoded-secrets-engine.js +0 -251
  216. package/bin/runners/lib/engines/import-order-engine.js +0 -429
  217. package/bin/runners/lib/engines/mock-data-engine.js +0 -315
  218. package/bin/runners/lib/engines/naming-conventions-engine.js +0 -544
  219. package/bin/runners/lib/engines/noise-reduction-engine.js +0 -452
  220. package/bin/runners/lib/engines/orchestrator.js +0 -334
  221. package/bin/runners/lib/engines/parallel-processor.js +0 -71
  222. package/bin/runners/lib/engines/performance-issues-engine.js +0 -405
  223. package/bin/runners/lib/engines/react-patterns-engine.js +0 -457
  224. package/bin/runners/lib/engines/security-vulnerabilities-engine.js +0 -571
  225. package/bin/runners/lib/engines/todo-fixme-engine.js +0 -115
  226. package/bin/runners/lib/engines/type-aware-engine.js +0 -376
  227. package/bin/runners/lib/engines/unsafe-regex-engine.js +0 -225
  228. package/bin/runners/lib/engines/vibecheck-engines/README.md +0 -53
  229. package/bin/runners/lib/engines/vibecheck-engines/index.js +0 -124
  230. package/bin/runners/lib/engines/vibecheck-engines/lib/ai-hallucination-engine.js +0 -806
  231. package/bin/runners/lib/engines/vibecheck-engines/lib/hardcoded-secrets-engine.js +0 -439
  232. package/bin/runners/lib/engines/vibecheck-engines/lib/smart-fix-engine.js +0 -577
  233. package/bin/runners/lib/engines/vibecheck-engines/lib/vibe-score-engine.js +0 -543
  234. package/bin/runners/lib/engines/vibecheck-engines/package.json +0 -13
  235. package/bin/runners/lib/engines/vibecheck-engines.js +0 -514
  236. package/bin/runners/lib/enhanced-features/index.js +0 -305
  237. package/bin/runners/lib/enhanced-output.js +0 -631
  238. package/bin/runners/lib/enterprise.js +0 -300
  239. package/bin/runners/lib/exit-codes.js +0 -275
  240. package/bin/runners/lib/fingerprint.js +0 -377
  241. package/bin/runners/lib/firewall/command-validator.js +0 -351
  242. package/bin/runners/lib/firewall/config.js +0 -341
  243. package/bin/runners/lib/firewall/content-validator.js +0 -519
  244. package/bin/runners/lib/firewall/index.js +0 -101
  245. package/bin/runners/lib/firewall/path-validator.js +0 -256
  246. package/bin/runners/lib/help-formatter.js +0 -413
  247. package/bin/runners/lib/intelligence/cross-repo-intelligence.js +0 -817
  248. package/bin/runners/lib/logger.js +0 -38
  249. package/bin/runners/lib/mcp-utils.js +0 -425
  250. package/bin/runners/lib/output/index.js +0 -1022
  251. package/bin/runners/lib/policy-engine.js +0 -652
  252. package/bin/runners/lib/polish/autofix/accessibility-fixes.js +0 -333
  253. package/bin/runners/lib/polish/autofix/async-handlers.js +0 -273
  254. package/bin/runners/lib/polish/autofix/dead-code.js +0 -280
  255. package/bin/runners/lib/polish/autofix/imports-optimizer.js +0 -344
  256. package/bin/runners/lib/polish/autofix/index.js +0 -200
  257. package/bin/runners/lib/polish/autofix/remove-consoles.js +0 -209
  258. package/bin/runners/lib/polish/autofix/strengthen-types.js +0 -245
  259. package/bin/runners/lib/polish/backend-checks.js +0 -148
  260. package/bin/runners/lib/polish/documentation-checks.js +0 -111
  261. package/bin/runners/lib/polish/frontend-checks.js +0 -168
  262. package/bin/runners/lib/polish/index.js +0 -71
  263. package/bin/runners/lib/polish/infrastructure-checks.js +0 -131
  264. package/bin/runners/lib/polish/library-detection.js +0 -175
  265. package/bin/runners/lib/polish/performance-checks.js +0 -100
  266. package/bin/runners/lib/polish/security-checks.js +0 -148
  267. package/bin/runners/lib/polish/utils.js +0 -203
  268. package/bin/runners/lib/prompt-builder.js +0 -540
  269. package/bin/runners/lib/proof-certificate.js +0 -634
  270. package/bin/runners/lib/reality/accessibility-audit.js +0 -946
  271. package/bin/runners/lib/reality/api-contract-validator.js +0 -1012
  272. package/bin/runners/lib/reality/chaos-engineering.js +0 -1084
  273. package/bin/runners/lib/reality/performance-tracker.js +0 -1077
  274. package/bin/runners/lib/reality/scenario-generator.js +0 -1404
  275. package/bin/runners/lib/reality/visual-regression.js +0 -852
  276. package/bin/runners/lib/reality-profiler.js +0 -717
  277. package/bin/runners/lib/replay/flight-recorder-viewer.js +0 -1160
  278. package/bin/runners/lib/review/ai-code-review.js +0 -832
  279. package/bin/runners/lib/rules/custom-rule-engine.js +0 -985
  280. package/bin/runners/lib/sbom-generator.js +0 -641
  281. package/bin/runners/lib/scan-output-enhanced.js +0 -512
  282. package/bin/runners/lib/security/owasp-scanner.js +0 -939
  283. package/bin/runners/lib/ship-output-enterprise.js +0 -239
  284. package/bin/runners/lib/unified-cli-output.js +0 -777
  285. package/bin/runners/lib/validators/contract-validator.js +0 -283
  286. package/bin/runners/lib/validators/dead-export-detector.js +0 -279
  287. package/bin/runners/lib/validators/dep-audit.js +0 -245
  288. package/bin/runners/lib/validators/env-validator.js +0 -319
  289. package/bin/runners/lib/validators/index.js +0 -120
  290. package/bin/runners/lib/validators/license-checker.js +0 -252
  291. package/bin/runners/lib/validators/route-validator.js +0 -290
  292. package/bin/runners/runAgent.d.ts +0 -5
  293. package/bin/runners/runAgent.js +0 -164
  294. package/bin/runners/runApprove.js +0 -1233
  295. package/bin/runners/runAuthority.js +0 -528
  296. package/bin/runners/runClassify.js +0 -862
  297. package/bin/runners/runConductor.js +0 -772
  298. package/bin/runners/runContainer.js +0 -366
  299. package/bin/runners/runContext.d.ts +0 -4
  300. package/bin/runners/runEasy.js +0 -410
  301. package/bin/runners/runFirewall.d.ts +0 -5
  302. package/bin/runners/runFirewall.js +0 -137
  303. package/bin/runners/runFirewallHook.d.ts +0 -5
  304. package/bin/runners/runFirewallHook.js +0 -59
  305. package/bin/runners/runIaC.js +0 -372
  306. package/bin/runners/runPolish.d.ts +0 -4
  307. package/bin/runners/runProof.zip +0 -0
  308. package/bin/runners/runTruth.d.ts +0 -5
  309. package/bin/runners/runTruth.js +0 -104
  310. package/bin/runners/runVibe.js +0 -791
  311. package/mcp-server/HARDENING_SUMMARY.md +0 -299
  312. package/mcp-server/agent-firewall-interceptor.js +0 -500
  313. package/mcp-server/authority-tools.js +0 -569
  314. package/mcp-server/conductor/conflict-resolver.js +0 -588
  315. package/mcp-server/conductor/execution-planner.js +0 -544
  316. package/mcp-server/conductor/index.js +0 -377
  317. package/mcp-server/conductor/lock-manager.js +0 -615
  318. package/mcp-server/conductor/request-queue.js +0 -550
  319. package/mcp-server/conductor/session-manager.js +0 -500
  320. package/mcp-server/conductor/tools.js +0 -510
  321. package/mcp-server/lib/api-client.cjs +0 -13
  322. package/mcp-server/lib/logger.cjs +0 -30
  323. package/mcp-server/logger.js +0 -173
  324. package/mcp-server/tools-v3.js +0 -1039
  325. package/mcp-server/tools.js +0 -495
  326. package/mcp-server/vibecheck-mcp-server-3.2.0.tgz +0 -0
@@ -1,530 +0,0 @@
1
- /**
2
- * Time Machine Timeline Builder
3
- *
4
- * Builds event timelines from multiple sources.
5
- * Correlates agent actions with outcomes and incidents.
6
- *
7
- * Codename: Time Machine
8
- */
9
-
10
- "use strict";
11
-
12
- const fs = require("fs");
13
- const path = require("path");
14
- const { timeMachineLogger: log, getErrorMessage } = require("../logger.js");
15
-
16
- /**
17
- * @typedef {Object} TimelineEvent
18
- * @property {string} id - Event ID
19
- * @property {Date} timestamp - When event occurred
20
- * @property {string} type - Event type
21
- * @property {string} source - Event source (firewall, conductor, git, etc.)
22
- * @property {string} summary - Human-readable summary
23
- * @property {Object} details - Full event details
24
- * @property {string[]} relatedEvents - IDs of related events
25
- * @property {Object} [causalLink] - Link to caused/causing events
26
- */
27
-
28
- /**
29
- * @typedef {Object} ForensicTimeline
30
- * @property {string} timelineId - Timeline ID
31
- * @property {Object} incident - Incident info if applicable
32
- * @property {TimelineEvent[]} events - All events in timeline
33
- * @property {Object[]} causalChain - Causal relationships
34
- * @property {TimelineEvent} [rootCause] - Identified root cause
35
- * @property {Date} generatedAt - When timeline was generated
36
- */
37
-
38
- /**
39
- * Event types for timeline
40
- */
41
- const EVENT_TYPES = {
42
- PROPOSAL_SUBMITTED: "proposal_submitted",
43
- PROPOSAL_ALLOWED: "proposal_allowed",
44
- PROPOSAL_BLOCKED: "proposal_blocked",
45
- PROPOSAL_WARNED: "proposal_warned",
46
- OVERRIDE_USED: "override_used",
47
- FILE_CHANGED: "file_changed",
48
- SESSION_STARTED: "session_started",
49
- SESSION_ENDED: "session_ended",
50
- LOCK_ACQUIRED: "lock_acquired",
51
- LOCK_RELEASED: "lock_released",
52
- CONFLICT_DETECTED: "conflict_detected",
53
- INCIDENT_REPORTED: "incident_reported",
54
- BUILD_FAILED: "build_failed",
55
- TEST_FAILED: "test_failed",
56
- };
57
-
58
- /**
59
- * Timeline Builder class
60
- */
61
- class TimelineBuilder {
62
- constructor(options = {}) {
63
- this.projectRoot = options.projectRoot || process.cwd();
64
- this.auditDir = path.join(this.projectRoot, ".vibecheck", "audit");
65
- this.packetsDir = path.join(this.projectRoot, ".vibecheck", "packets");
66
- this.incidentsDir = path.join(this.projectRoot, ".vibecheck", "incidents");
67
- }
68
-
69
- /**
70
- * Build a timeline for a time range
71
- * @param {Object} options - Build options
72
- * @returns {ForensicTimeline} Built timeline
73
- */
74
- async buildTimeline(options = {}) {
75
- const {
76
- startTime,
77
- endTime = new Date(),
78
- file = null,
79
- agentId = null,
80
- includeGit = true,
81
- includeIncidents = true,
82
- } = options;
83
-
84
- const timelineId = `timeline_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
85
- const events = [];
86
-
87
- // Load firewall events
88
- const firewallEvents = await this.loadFirewallEvents(startTime, endTime, file, agentId);
89
- events.push(...firewallEvents);
90
-
91
- // Load conductor events
92
- const conductorEvents = await this.loadConductorEvents(startTime, endTime, agentId);
93
- events.push(...conductorEvents);
94
-
95
- // Load git events if requested
96
- if (includeGit) {
97
- const gitEvents = await this.loadGitEvents(startTime, endTime, file);
98
- events.push(...gitEvents);
99
- }
100
-
101
- // Load incident events if requested
102
- let incidentInfo = null;
103
- if (includeIncidents) {
104
- const incidentEvents = await this.loadIncidentEvents(startTime, endTime, file);
105
- events.push(...incidentEvents);
106
-
107
- // Find the main incident if any
108
- incidentInfo = incidentEvents.find(e => e.type === EVENT_TYPES.INCIDENT_REPORTED)?.details;
109
- }
110
-
111
- // Sort by timestamp
112
- events.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
113
-
114
- // Build causal relationships
115
- const { causalChain, rootCause } = this.buildCausalChain(events);
116
-
117
- // Link related events
118
- this.linkRelatedEvents(events);
119
-
120
- return {
121
- timelineId,
122
- incident: incidentInfo,
123
- events,
124
- causalChain,
125
- rootCause,
126
- generatedAt: new Date(),
127
- options,
128
- };
129
- }
130
-
131
- /**
132
- * Load firewall events from audit log
133
- * @param {Date} startTime - Start time
134
- * @param {Date} endTime - End time
135
- * @param {string} file - File filter
136
- * @param {string} agentId - Agent filter
137
- * @returns {TimelineEvent[]} Firewall events
138
- */
139
- async loadFirewallEvents(startTime, endTime, file, agentId) {
140
- const events = [];
141
- const auditFile = path.join(this.auditDir, "firewall-events.jsonl");
142
-
143
- if (!fs.existsSync(auditFile)) {
144
- return events;
145
- }
146
-
147
- try {
148
- const content = fs.readFileSync(auditFile, "utf-8");
149
- const lines = content.trim().split("\n").filter(l => l);
150
-
151
- for (const line of lines) {
152
- try {
153
- const raw = JSON.parse(line);
154
- const eventTime = new Date(raw.timestamp);
155
-
156
- // Apply filters
157
- if (startTime && eventTime < new Date(startTime)) continue;
158
- if (endTime && eventTime > new Date(endTime)) continue;
159
- if (file && raw.file !== file && !raw.file?.includes(file)) continue;
160
- if (agentId && raw.agentId !== agentId) continue;
161
-
162
- events.push({
163
- id: raw.id || `evt_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
164
- timestamp: eventTime,
165
- type: this.mapVerdictToEventType(raw.verdict, raw.action),
166
- source: "firewall",
167
- summary: this.buildFirewallSummary(raw),
168
- details: raw,
169
- relatedEvents: [],
170
- });
171
- } catch {
172
- // Skip invalid lines
173
- }
174
- }
175
- } catch (error) {
176
- log.warn(`Failed to load firewall events: ${getErrorMessage(error)}`);
177
- }
178
-
179
- return events;
180
- }
181
-
182
- /**
183
- * Load conductor events
184
- * @param {Date} startTime - Start time
185
- * @param {Date} endTime - End time
186
- * @param {string} agentId - Agent filter
187
- * @returns {TimelineEvent[]} Conductor events
188
- */
189
- async loadConductorEvents(startTime, endTime, agentId) {
190
- const events = [];
191
- const conductorFile = path.join(this.auditDir, "conductor-events.jsonl");
192
-
193
- if (!fs.existsSync(conductorFile)) {
194
- return events;
195
- }
196
-
197
- try {
198
- const content = fs.readFileSync(conductorFile, "utf-8");
199
- const lines = content.trim().split("\n").filter(l => l);
200
-
201
- for (const line of lines) {
202
- try {
203
- const raw = JSON.parse(line);
204
- const eventTime = new Date(raw.timestamp);
205
-
206
- if (startTime && eventTime < new Date(startTime)) continue;
207
- if (endTime && eventTime > new Date(endTime)) continue;
208
- if (agentId && raw.agentId !== agentId) continue;
209
-
210
- events.push({
211
- id: raw.id || `evt_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
212
- timestamp: eventTime,
213
- type: raw.type || raw.action,
214
- source: "conductor",
215
- summary: this.buildConductorSummary(raw),
216
- details: raw,
217
- relatedEvents: [],
218
- });
219
- } catch {
220
- // Skip invalid lines
221
- }
222
- }
223
- } catch (error) {
224
- log.warn(`Failed to load conductor events: ${getErrorMessage(error)}`);
225
- }
226
-
227
- return events;
228
- }
229
-
230
- /**
231
- * Load git events (commits, merges)
232
- * @param {Date} startTime - Start time
233
- * @param {Date} endTime - End time
234
- * @param {string} file - File filter
235
- * @returns {TimelineEvent[]} Git events
236
- */
237
- async loadGitEvents(startTime, endTime, file) {
238
- const events = [];
239
-
240
- // This would typically call git log
241
- // For now, return empty - would be implemented with git integration
242
-
243
- return events;
244
- }
245
-
246
- /**
247
- * Load incident events
248
- * @param {Date} startTime - Start time
249
- * @param {Date} endTime - End time
250
- * @param {string} file - File filter
251
- * @returns {TimelineEvent[]} Incident events
252
- */
253
- async loadIncidentEvents(startTime, endTime, file) {
254
- const events = [];
255
- const incidentsFile = path.join(this.incidentsDir, "incidents.jsonl");
256
-
257
- if (!fs.existsSync(incidentsFile)) {
258
- return events;
259
- }
260
-
261
- try {
262
- const content = fs.readFileSync(incidentsFile, "utf-8");
263
- const lines = content.trim().split("\n").filter(l => l);
264
-
265
- for (const line of lines) {
266
- try {
267
- const raw = JSON.parse(line);
268
- const eventTime = new Date(raw.timestamp || raw.reportedAt);
269
-
270
- if (startTime && eventTime < new Date(startTime)) continue;
271
- if (endTime && eventTime > new Date(endTime)) continue;
272
- if (file && !raw.affectedFiles?.includes(file)) continue;
273
-
274
- events.push({
275
- id: raw.id || raw.incidentId,
276
- timestamp: eventTime,
277
- type: EVENT_TYPES.INCIDENT_REPORTED,
278
- source: "incident",
279
- summary: `Incident: ${raw.title || raw.description || "Unknown"}`,
280
- details: raw,
281
- relatedEvents: [],
282
- });
283
- } catch {
284
- // Skip invalid lines
285
- }
286
- }
287
- } catch (error) {
288
- log.warn(`Failed to load incident events: ${getErrorMessage(error)}`);
289
- }
290
-
291
- return events;
292
- }
293
-
294
- /**
295
- * Map verdict to event type
296
- * @param {string} verdict - Verdict
297
- * @param {string} action - Action
298
- * @returns {string} Event type
299
- */
300
- mapVerdictToEventType(verdict, action) {
301
- if (action === "override") return EVENT_TYPES.OVERRIDE_USED;
302
-
303
- switch (verdict) {
304
- case "ALLOW":
305
- return EVENT_TYPES.PROPOSAL_ALLOWED;
306
- case "BLOCK":
307
- return EVENT_TYPES.PROPOSAL_BLOCKED;
308
- case "WARN":
309
- return EVENT_TYPES.PROPOSAL_WARNED;
310
- default:
311
- return EVENT_TYPES.PROPOSAL_SUBMITTED;
312
- }
313
- }
314
-
315
- /**
316
- * Build summary for firewall event
317
- * @param {Object} raw - Raw event data
318
- * @returns {string} Summary
319
- */
320
- buildFirewallSummary(raw) {
321
- const parts = [];
322
-
323
- if (raw.verdict) {
324
- parts.push(`[${raw.verdict}]`);
325
- }
326
-
327
- if (raw.agentId) {
328
- parts.push(`Agent: ${raw.agentId}`);
329
- }
330
-
331
- if (raw.file) {
332
- parts.push(`File: ${path.basename(raw.file)}`);
333
- }
334
-
335
- if (raw.intent) {
336
- parts.push(raw.intent.slice(0, 50) + (raw.intent.length > 50 ? "..." : ""));
337
- }
338
-
339
- return parts.join(" | ") || "Firewall event";
340
- }
341
-
342
- /**
343
- * Build summary for conductor event
344
- * @param {Object} raw - Raw event data
345
- * @returns {string} Summary
346
- */
347
- buildConductorSummary(raw) {
348
- const parts = [];
349
-
350
- if (raw.type || raw.action) {
351
- parts.push(`[${raw.type || raw.action}]`);
352
- }
353
-
354
- if (raw.agentId) {
355
- parts.push(`Agent: ${raw.agentId}`);
356
- }
357
-
358
- if (raw.sessionId) {
359
- parts.push(`Session: ${raw.sessionId.slice(0, 12)}...`);
360
- }
361
-
362
- return parts.join(" | ") || "Conductor event";
363
- }
364
-
365
- /**
366
- * Build causal chain from events
367
- * @param {TimelineEvent[]} events - Events to analyze
368
- * @returns {Object} Causal chain and root cause
369
- */
370
- buildCausalChain(events) {
371
- const causalChain = [];
372
- let rootCause = null;
373
-
374
- // Find incident events
375
- const incidents = events.filter(e => e.type === EVENT_TYPES.INCIDENT_REPORTED);
376
-
377
- if (incidents.length === 0) {
378
- return { causalChain, rootCause };
379
- }
380
-
381
- // For each incident, trace back to find potential causes
382
- for (const incident of incidents) {
383
- const affectedFiles = incident.details.affectedFiles || [];
384
- const incidentTime = new Date(incident.timestamp);
385
-
386
- // Find events that affected the same files before the incident
387
- const potentialCauses = events.filter(e => {
388
- const eventTime = new Date(e.timestamp);
389
- if (eventTime >= incidentTime) return false;
390
-
391
- const eventFile = e.details?.file;
392
- if (!eventFile) return false;
393
-
394
- return affectedFiles.some(f => f.includes(eventFile) || eventFile.includes(f));
395
- });
396
-
397
- // Look for overrides or blocked proposals that were overridden
398
- for (const cause of potentialCauses) {
399
- if (cause.type === EVENT_TYPES.OVERRIDE_USED ||
400
- (cause.type === EVENT_TYPES.PROPOSAL_ALLOWED && cause.details?.overrideUsed)) {
401
- causalChain.push({
402
- cause: cause.id,
403
- effect: incident.id,
404
- relationship: "override_led_to_incident",
405
- confidence: 0.8,
406
- });
407
-
408
- if (!rootCause) {
409
- rootCause = cause;
410
- }
411
- }
412
- }
413
-
414
- // Also look for the first suspicious change
415
- const firstSuspicious = potentialCauses.find(e =>
416
- e.type === EVENT_TYPES.PROPOSAL_ALLOWED &&
417
- (e.details?.riskScore || 0) >= 50
418
- );
419
-
420
- if (firstSuspicious && !rootCause) {
421
- rootCause = firstSuspicious;
422
- causalChain.push({
423
- cause: firstSuspicious.id,
424
- effect: incident.id,
425
- relationship: "high_risk_change_led_to_incident",
426
- confidence: 0.6,
427
- });
428
- }
429
- }
430
-
431
- return { causalChain, rootCause };
432
- }
433
-
434
- /**
435
- * Link related events together
436
- * @param {TimelineEvent[]} events - Events to link
437
- */
438
- linkRelatedEvents(events) {
439
- // Group events by file
440
- const byFile = new Map();
441
-
442
- for (const event of events) {
443
- const file = event.details?.file;
444
- if (file) {
445
- if (!byFile.has(file)) {
446
- byFile.set(file, []);
447
- }
448
- byFile.get(file).push(event);
449
- }
450
- }
451
-
452
- // Link events that share the same file
453
- for (const [, fileEvents] of byFile) {
454
- for (let i = 0; i < fileEvents.length; i++) {
455
- for (let j = i + 1; j < fileEvents.length; j++) {
456
- fileEvents[i].relatedEvents.push(fileEvents[j].id);
457
- fileEvents[j].relatedEvents.push(fileEvents[i].id);
458
- }
459
- }
460
- }
461
-
462
- // Group events by session
463
- const bySession = new Map();
464
-
465
- for (const event of events) {
466
- const sessionId = event.details?.sessionId;
467
- if (sessionId) {
468
- if (!bySession.has(sessionId)) {
469
- bySession.set(sessionId, []);
470
- }
471
- bySession.get(sessionId).push(event);
472
- }
473
- }
474
-
475
- // Link events in same session
476
- for (const [, sessionEvents] of bySession) {
477
- for (let i = 0; i < sessionEvents.length; i++) {
478
- for (let j = i + 1; j < sessionEvents.length; j++) {
479
- if (!sessionEvents[i].relatedEvents.includes(sessionEvents[j].id)) {
480
- sessionEvents[i].relatedEvents.push(sessionEvents[j].id);
481
- }
482
- if (!sessionEvents[j].relatedEvents.includes(sessionEvents[i].id)) {
483
- sessionEvents[j].relatedEvents.push(sessionEvents[i].id);
484
- }
485
- }
486
- }
487
- }
488
- }
489
-
490
- /**
491
- * Generate a timeline report
492
- * @param {ForensicTimeline} timeline - Timeline to report on
493
- * @returns {Object} Report
494
- */
495
- generateReport(timeline) {
496
- const eventCounts = {};
497
- const sourceCounts = {};
498
-
499
- for (const event of timeline.events) {
500
- eventCounts[event.type] = (eventCounts[event.type] || 0) + 1;
501
- sourceCounts[event.source] = (sourceCounts[event.source] || 0) + 1;
502
- }
503
-
504
- return {
505
- timelineId: timeline.timelineId,
506
- generatedAt: timeline.generatedAt,
507
- totalEvents: timeline.events.length,
508
- eventCounts,
509
- sourceCounts,
510
- hasIncident: !!timeline.incident,
511
- rootCauseIdentified: !!timeline.rootCause,
512
- causalChainLength: timeline.causalChain.length,
513
- timeRange: {
514
- start: timeline.events[0]?.timestamp,
515
- end: timeline.events[timeline.events.length - 1]?.timestamp,
516
- },
517
- };
518
- }
519
- }
520
-
521
- /**
522
- * Create a timeline builder instance
523
- * @param {Object} options - Options
524
- * @returns {TimelineBuilder} Timeline builder
525
- */
526
- function createTimelineBuilder(options = {}) {
527
- return new TimelineBuilder(options);
528
- }
529
-
530
- module.exports = { TimelineBuilder, createTimelineBuilder, EVENT_TYPES };
@@ -1,67 +0,0 @@
1
- /**
2
- * Truthpack Accessor
3
- *
4
- * Unified interface for accessing truthpack data.
5
- */
6
-
7
- "use strict";
8
-
9
- const { loadTruthpack } = require("./loader");
10
-
11
- /**
12
- * Get routes from truthpack
13
- * @param {string} projectRoot - Project root directory
14
- * @returns {array} Array of routes
15
- */
16
- function getRoutes(projectRoot) {
17
- const truthpack = loadTruthpack(projectRoot);
18
- return truthpack.routes?.routes || [];
19
- }
20
-
21
- /**
22
- * Get environment variables from truthpack
23
- * @param {string} projectRoot - Project root directory
24
- * @returns {object} Env vars data
25
- */
26
- function getEnvVars(projectRoot) {
27
- const truthpack = loadTruthpack(projectRoot);
28
- return truthpack.env || { vars: [], declared: [], declaredSources: [] };
29
- }
30
-
31
- /**
32
- * Get auth rules from truthpack
33
- * @param {string} projectRoot - Project root directory
34
- * @returns {object} Auth rules data
35
- */
36
- function getAuthRules(projectRoot) {
37
- const truthpack = loadTruthpack(projectRoot);
38
- return truthpack.auth || { nextMiddleware: [], nextMatcherPatterns: [], fastify: {} };
39
- }
40
-
41
- /**
42
- * Get contracts from truthpack
43
- * @param {string} projectRoot - Project root directory
44
- * @returns {object} Contracts data
45
- */
46
- function getContracts(projectRoot) {
47
- const truthpack = loadTruthpack(projectRoot);
48
- return truthpack.contracts || {};
49
- }
50
-
51
- /**
52
- * Get UI graph from truthpack
53
- * @param {string} projectRoot - Project root directory
54
- * @returns {object|null} UI graph or null
55
- */
56
- function getUIGraph(projectRoot) {
57
- const truthpack = loadTruthpack(projectRoot);
58
- return truthpack.uiGraph || null;
59
- }
60
-
61
- module.exports = {
62
- getRoutes,
63
- getEnvVars,
64
- getAuthRules,
65
- getContracts,
66
- getUIGraph
67
- };