vibecheck-ai 2.0.2 → 5.0.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 (456) hide show
  1. package/bin/.generated +25 -0
  2. package/bin/_deprecations.js +463 -0
  3. package/bin/_router.js +46 -0
  4. package/bin/cli-hygiene.js +241 -0
  5. package/bin/dev/run-v2-torture.js +30 -0
  6. package/bin/registry.js +656 -0
  7. package/bin/runners/CLI_REFACTOR_SUMMARY.md +229 -0
  8. package/bin/runners/ENHANCEMENT_GUIDE.md +121 -0
  9. package/bin/runners/REPORT_AUDIT.md +64 -0
  10. package/bin/runners/cli-utils.js +1070 -0
  11. package/bin/runners/context/ai-task-decomposer.js +337 -0
  12. package/bin/runners/context/analyzer.js +513 -0
  13. package/bin/runners/context/api-contracts.js +427 -0
  14. package/bin/runners/context/context-diff.js +342 -0
  15. package/bin/runners/context/context-pruner.js +291 -0
  16. package/bin/runners/context/dependency-graph.js +414 -0
  17. package/bin/runners/context/generators/claude.js +107 -0
  18. package/bin/runners/context/generators/codex.js +108 -0
  19. package/bin/runners/context/generators/copilot.js +119 -0
  20. package/bin/runners/context/generators/cursor-enhanced.js +2525 -0
  21. package/bin/runners/context/generators/cursor.js +514 -0
  22. package/bin/runners/context/generators/mcp.js +169 -0
  23. package/bin/runners/context/generators/windsurf.js +180 -0
  24. package/bin/runners/context/git-context.js +304 -0
  25. package/bin/runners/context/index.js +1110 -0
  26. package/bin/runners/context/insights.js +173 -0
  27. package/bin/runners/context/mcp-server/generate-rules.js +337 -0
  28. package/bin/runners/context/mcp-server/index.js +1176 -0
  29. package/bin/runners/context/mcp-server/package.json +24 -0
  30. package/bin/runners/context/memory.js +200 -0
  31. package/bin/runners/context/monorepo.js +215 -0
  32. package/bin/runners/context/multi-repo-federation.js +404 -0
  33. package/bin/runners/context/patterns.js +253 -0
  34. package/bin/runners/context/proof-context.js +1264 -0
  35. package/bin/runners/context/security-scanner.js +541 -0
  36. package/bin/runners/context/semantic-search.js +350 -0
  37. package/bin/runners/context/shared.js +264 -0
  38. package/bin/runners/context/team-conventions.js +336 -0
  39. package/bin/runners/lib/__tests__/entitlements-v2.test.js +295 -0
  40. package/bin/runners/lib/agent-firewall/ai/false-positive-analyzer.js +474 -0
  41. package/bin/runners/lib/agent-firewall/change-packet/builder.js +488 -0
  42. package/bin/runners/lib/agent-firewall/change-packet/schema.json +228 -0
  43. package/bin/runners/lib/agent-firewall/change-packet/store.js +200 -0
  44. package/bin/runners/lib/agent-firewall/claims/claim-types.js +21 -0
  45. package/bin/runners/lib/agent-firewall/claims/extractor.js +303 -0
  46. package/bin/runners/lib/agent-firewall/claims/patterns.js +24 -0
  47. package/bin/runners/lib/agent-firewall/critic/index.js +151 -0
  48. package/bin/runners/lib/agent-firewall/critic/judge.js +432 -0
  49. package/bin/runners/lib/agent-firewall/critic/prompts.js +305 -0
  50. package/bin/runners/lib/agent-firewall/enforcement/gateway.js +1059 -0
  51. package/bin/runners/lib/agent-firewall/enforcement/index.js +98 -0
  52. package/bin/runners/lib/agent-firewall/enforcement/mode.js +318 -0
  53. package/bin/runners/lib/agent-firewall/enforcement/orchestrator.js +484 -0
  54. package/bin/runners/lib/agent-firewall/enforcement/proof-artifact.js +418 -0
  55. package/bin/runners/lib/agent-firewall/enforcement/schemas/change-event.schema.json +173 -0
  56. package/bin/runners/lib/agent-firewall/enforcement/schemas/intent.schema.json +181 -0
  57. package/bin/runners/lib/agent-firewall/enforcement/schemas/verdict.schema.json +222 -0
  58. package/bin/runners/lib/agent-firewall/enforcement/verdict-v2.js +333 -0
  59. package/bin/runners/lib/agent-firewall/evidence/auth-evidence.js +88 -0
  60. package/bin/runners/lib/agent-firewall/evidence/contract-evidence.js +75 -0
  61. package/bin/runners/lib/agent-firewall/evidence/env-evidence.js +127 -0
  62. package/bin/runners/lib/agent-firewall/evidence/resolver.js +102 -0
  63. package/bin/runners/lib/agent-firewall/evidence/route-evidence.js +213 -0
  64. package/bin/runners/lib/agent-firewall/evidence/side-effect-evidence.js +145 -0
  65. package/bin/runners/lib/agent-firewall/fs-hook/daemon.js +19 -0
  66. package/bin/runners/lib/agent-firewall/fs-hook/installer.js +87 -0
  67. package/bin/runners/lib/agent-firewall/fs-hook/watcher.js +184 -0
  68. package/bin/runners/lib/agent-firewall/git-hook/pre-commit.js +163 -0
  69. package/bin/runners/lib/agent-firewall/ide-extension/cursor.js +107 -0
  70. package/bin/runners/lib/agent-firewall/ide-extension/vscode.js +68 -0
  71. package/bin/runners/lib/agent-firewall/ide-extension/windsurf.js +66 -0
  72. package/bin/runners/lib/agent-firewall/index.js +200 -0
  73. package/bin/runners/lib/agent-firewall/integration/index.js +20 -0
  74. package/bin/runners/lib/agent-firewall/integration/ship-gate.js +437 -0
  75. package/bin/runners/lib/agent-firewall/intent/alignment-engine.js +634 -0
  76. package/bin/runners/lib/agent-firewall/intent/auto-detect.js +426 -0
  77. package/bin/runners/lib/agent-firewall/intent/index.js +102 -0
  78. package/bin/runners/lib/agent-firewall/intent/schema.js +352 -0
  79. package/bin/runners/lib/agent-firewall/intent/store.js +283 -0
  80. package/bin/runners/lib/agent-firewall/interception/fs-interceptor.js +502 -0
  81. package/bin/runners/lib/agent-firewall/interception/index.js +23 -0
  82. package/bin/runners/lib/agent-firewall/interceptor/base.js +308 -0
  83. package/bin/runners/lib/agent-firewall/interceptor/cursor.js +35 -0
  84. package/bin/runners/lib/agent-firewall/interceptor/vscode.js +35 -0
  85. package/bin/runners/lib/agent-firewall/interceptor/windsurf.js +34 -0
  86. package/bin/runners/lib/agent-firewall/lawbook/distributor.js +465 -0
  87. package/bin/runners/lib/agent-firewall/lawbook/evaluator.js +604 -0
  88. package/bin/runners/lib/agent-firewall/lawbook/index.js +304 -0
  89. package/bin/runners/lib/agent-firewall/lawbook/registry.js +514 -0
  90. package/bin/runners/lib/agent-firewall/lawbook/schema.js +420 -0
  91. package/bin/runners/lib/agent-firewall/logger.js +141 -0
  92. package/bin/runners/lib/agent-firewall/policy/default-policy.json +90 -0
  93. package/bin/runners/lib/agent-firewall/policy/engine.js +103 -0
  94. package/bin/runners/lib/agent-firewall/policy/loader.js +451 -0
  95. package/bin/runners/lib/agent-firewall/policy/rules/auth-drift.js +50 -0
  96. package/bin/runners/lib/agent-firewall/policy/rules/contract-drift.js +50 -0
  97. package/bin/runners/lib/agent-firewall/policy/rules/fake-success.js +79 -0
  98. package/bin/runners/lib/agent-firewall/policy/rules/ghost-env.js +227 -0
  99. package/bin/runners/lib/agent-firewall/policy/rules/ghost-route.js +191 -0
  100. package/bin/runners/lib/agent-firewall/policy/rules/scope.js +93 -0
  101. package/bin/runners/lib/agent-firewall/policy/rules/unsafe-side-effect.js +57 -0
  102. package/bin/runners/lib/agent-firewall/policy/schema.json +183 -0
  103. package/bin/runners/lib/agent-firewall/policy/verdict.js +54 -0
  104. package/bin/runners/lib/agent-firewall/proposal/extractor.js +394 -0
  105. package/bin/runners/lib/agent-firewall/proposal/index.js +212 -0
  106. package/bin/runners/lib/agent-firewall/proposal/schema.js +251 -0
  107. package/bin/runners/lib/agent-firewall/proposal/validator.js +386 -0
  108. package/bin/runners/lib/agent-firewall/reality/index.js +332 -0
  109. package/bin/runners/lib/agent-firewall/reality/state.js +625 -0
  110. package/bin/runners/lib/agent-firewall/reality/watcher.js +322 -0
  111. package/bin/runners/lib/agent-firewall/risk/index.js +173 -0
  112. package/bin/runners/lib/agent-firewall/risk/scorer.js +328 -0
  113. package/bin/runners/lib/agent-firewall/risk/thresholds.js +322 -0
  114. package/bin/runners/lib/agent-firewall/risk/vectors.js +421 -0
  115. package/bin/runners/lib/agent-firewall/session/collector.js +451 -0
  116. package/bin/runners/lib/agent-firewall/session/index.js +26 -0
  117. package/bin/runners/lib/agent-firewall/simulator/diff-simulator.js +472 -0
  118. package/bin/runners/lib/agent-firewall/simulator/import-resolver.js +346 -0
  119. package/bin/runners/lib/agent-firewall/simulator/index.js +181 -0
  120. package/bin/runners/lib/agent-firewall/simulator/route-validator.js +380 -0
  121. package/bin/runners/lib/agent-firewall/time-machine/incident-correlator.js +661 -0
  122. package/bin/runners/lib/agent-firewall/time-machine/index.js +267 -0
  123. package/bin/runners/lib/agent-firewall/time-machine/replay-engine.js +436 -0
  124. package/bin/runners/lib/agent-firewall/time-machine/state-reconstructor.js +490 -0
  125. package/bin/runners/lib/agent-firewall/time-machine/timeline-builder.js +530 -0
  126. package/bin/runners/lib/agent-firewall/truthpack/index.js +67 -0
  127. package/bin/runners/lib/agent-firewall/truthpack/loader.js +137 -0
  128. package/bin/runners/lib/agent-firewall/unblock/planner.js +337 -0
  129. package/bin/runners/lib/agent-firewall/utils/ignore-checker.js +118 -0
  130. package/bin/runners/lib/ai-bridge.js +416 -0
  131. package/bin/runners/lib/analysis-core.js +309 -0
  132. package/bin/runners/lib/analyzers.js +2500 -0
  133. package/bin/runners/lib/api-client.js +269 -0
  134. package/bin/runners/lib/approve-output.js +235 -0
  135. package/bin/runners/lib/artifact-envelope.js +540 -0
  136. package/bin/runners/lib/assets/vibecheck-logo.png +0 -0
  137. package/bin/runners/lib/audit-bridge.js +391 -0
  138. package/bin/runners/lib/auth-shared.js +977 -0
  139. package/bin/runners/lib/auth-truth.js +193 -0
  140. package/bin/runners/lib/auth.js +215 -0
  141. package/bin/runners/lib/authority-badge.js +425 -0
  142. package/bin/runners/lib/backup.js +62 -0
  143. package/bin/runners/lib/billing.js +107 -0
  144. package/bin/runners/lib/checkpoint.js +941 -0
  145. package/bin/runners/lib/claims.js +118 -0
  146. package/bin/runners/lib/classify-output.js +204 -0
  147. package/bin/runners/lib/cleanup/engine.js +571 -0
  148. package/bin/runners/lib/cleanup/index.js +53 -0
  149. package/bin/runners/lib/cleanup/output.js +375 -0
  150. package/bin/runners/lib/cleanup/rules.js +1060 -0
  151. package/bin/runners/lib/cli-output.js +400 -0
  152. package/bin/runners/lib/cli-ui.js +540 -0
  153. package/bin/runners/lib/compliance-bridge-new.js +0 -0
  154. package/bin/runners/lib/compliance-bridge.js +165 -0
  155. package/bin/runners/lib/contracts/auth-contract.js +202 -0
  156. package/bin/runners/lib/contracts/env-contract.js +181 -0
  157. package/bin/runners/lib/contracts/external-contract.js +206 -0
  158. package/bin/runners/lib/contracts/guard.js +168 -0
  159. package/bin/runners/lib/contracts/index.js +89 -0
  160. package/bin/runners/lib/contracts/plan-validator.js +311 -0
  161. package/bin/runners/lib/contracts/route-contract.js +199 -0
  162. package/bin/runners/lib/contracts.js +804 -0
  163. package/bin/runners/lib/default-config.js +127 -0
  164. package/bin/runners/lib/detect.js +89 -0
  165. package/bin/runners/lib/detectors-v2.js +622 -0
  166. package/bin/runners/lib/doctor/autofix.js +254 -0
  167. package/bin/runners/lib/doctor/diagnosis-receipt.js +454 -0
  168. package/bin/runners/lib/doctor/failure-signatures.js +526 -0
  169. package/bin/runners/lib/doctor/fix-script.js +336 -0
  170. package/bin/runners/lib/doctor/index.js +37 -0
  171. package/bin/runners/lib/doctor/modules/build-tools.js +453 -0
  172. package/bin/runners/lib/doctor/modules/dependencies.js +325 -0
  173. package/bin/runners/lib/doctor/modules/index.js +105 -0
  174. package/bin/runners/lib/doctor/modules/network.js +250 -0
  175. package/bin/runners/lib/doctor/modules/os-quirks.js +706 -0
  176. package/bin/runners/lib/doctor/modules/project.js +312 -0
  177. package/bin/runners/lib/doctor/modules/repo-integrity.js +485 -0
  178. package/bin/runners/lib/doctor/modules/runtime.js +224 -0
  179. package/bin/runners/lib/doctor/modules/security.js +350 -0
  180. package/bin/runners/lib/doctor/modules/system.js +213 -0
  181. package/bin/runners/lib/doctor/modules/vibecheck.js +394 -0
  182. package/bin/runners/lib/doctor/reporter.js +262 -0
  183. package/bin/runners/lib/doctor/safe-repair.js +384 -0
  184. package/bin/runners/lib/doctor/service.js +262 -0
  185. package/bin/runners/lib/doctor/types.js +113 -0
  186. package/bin/runners/lib/doctor/ui.js +263 -0
  187. package/bin/runners/lib/doctor-enhanced.js +233 -0
  188. package/bin/runners/lib/doctor-output.js +226 -0
  189. package/bin/runners/lib/doctor-v2.js +608 -0
  190. package/bin/runners/lib/drift.js +425 -0
  191. package/bin/runners/lib/enforcement.js +72 -0
  192. package/bin/runners/lib/engine/ast-cache.js +210 -0
  193. package/bin/runners/lib/engine/auth-extractor.js +211 -0
  194. package/bin/runners/lib/engine/billing-extractor.js +112 -0
  195. package/bin/runners/lib/engine/enforcement-extractor.js +100 -0
  196. package/bin/runners/lib/engine/env-extractor.js +207 -0
  197. package/bin/runners/lib/engine/express-extractor.js +208 -0
  198. package/bin/runners/lib/engine/extractors.js +849 -0
  199. package/bin/runners/lib/engine/index.js +207 -0
  200. package/bin/runners/lib/engine/repo-index.js +514 -0
  201. package/bin/runners/lib/engine/types.js +124 -0
  202. package/bin/runners/lib/engines/accessibility-engine.js +190 -0
  203. package/bin/runners/lib/engines/api-consistency-engine.js +162 -0
  204. package/bin/runners/lib/engines/ast-cache.js +99 -0
  205. package/bin/runners/lib/engines/attack-detector.js +1192 -0
  206. package/bin/runners/lib/engines/code-quality-engine.js +255 -0
  207. package/bin/runners/lib/engines/console-logs-engine.js +115 -0
  208. package/bin/runners/lib/engines/cross-file-analysis-engine.js +268 -0
  209. package/bin/runners/lib/engines/dead-code-engine.js +198 -0
  210. package/bin/runners/lib/engines/deprecated-api-engine.js +226 -0
  211. package/bin/runners/lib/engines/empty-catch-engine.js +150 -0
  212. package/bin/runners/lib/engines/file-filter.js +131 -0
  213. package/bin/runners/lib/engines/hardcoded-secrets-engine.js +251 -0
  214. package/bin/runners/lib/engines/mock-data-engine.js +272 -0
  215. package/bin/runners/lib/engines/parallel-processor.js +71 -0
  216. package/bin/runners/lib/engines/performance-issues-engine.js +265 -0
  217. package/bin/runners/lib/engines/security-vulnerabilities-engine.js +243 -0
  218. package/bin/runners/lib/engines/todo-fixme-engine.js +115 -0
  219. package/bin/runners/lib/engines/type-aware-engine.js +152 -0
  220. package/bin/runners/lib/engines/unsafe-regex-engine.js +225 -0
  221. package/bin/runners/lib/engines/vibecheck-engines/README.md +53 -0
  222. package/bin/runners/lib/engines/vibecheck-engines/index.js +15 -0
  223. package/bin/runners/lib/engines/vibecheck-engines/lib/ast-cache.js +164 -0
  224. package/bin/runners/lib/engines/vibecheck-engines/lib/code-quality-engine.js +291 -0
  225. package/bin/runners/lib/engines/vibecheck-engines/lib/console-logs-engine.js +83 -0
  226. package/bin/runners/lib/engines/vibecheck-engines/lib/dead-code-engine.js +198 -0
  227. package/bin/runners/lib/engines/vibecheck-engines/lib/deprecated-api-engine.js +275 -0
  228. package/bin/runners/lib/engines/vibecheck-engines/lib/empty-catch-engine.js +167 -0
  229. package/bin/runners/lib/engines/vibecheck-engines/lib/file-filter.js +217 -0
  230. package/bin/runners/lib/engines/vibecheck-engines/lib/hardcoded-secrets-engine.js +139 -0
  231. package/bin/runners/lib/engines/vibecheck-engines/lib/mock-data-engine.js +140 -0
  232. package/bin/runners/lib/engines/vibecheck-engines/lib/parallel-processor.js +164 -0
  233. package/bin/runners/lib/engines/vibecheck-engines/lib/performance-issues-engine.js +234 -0
  234. package/bin/runners/lib/engines/vibecheck-engines/lib/type-aware-engine.js +217 -0
  235. package/bin/runners/lib/engines/vibecheck-engines/lib/unsafe-regex-engine.js +78 -0
  236. package/bin/runners/lib/engines/vibecheck-engines/package.json +13 -0
  237. package/bin/runners/lib/enterprise-detect.js +603 -0
  238. package/bin/runners/lib/enterprise-init.js +942 -0
  239. package/bin/runners/lib/entitlements-v2.js +265 -0
  240. package/bin/runners/lib/entitlements.generated.js +0 -0
  241. package/bin/runners/lib/entitlements.js +340 -0
  242. package/bin/runners/lib/env-resolver.js +417 -0
  243. package/bin/runners/lib/env-template.js +66 -0
  244. package/bin/runners/lib/env.js +189 -0
  245. package/bin/runners/lib/error-handler.js +368 -0
  246. package/bin/runners/lib/error-messages.js +289 -0
  247. package/bin/runners/lib/evidence-pack.js +684 -0
  248. package/bin/runners/lib/exit-codes.js +275 -0
  249. package/bin/runners/lib/extractors/client-calls.js +990 -0
  250. package/bin/runners/lib/extractors/fastify-route-dump.js +573 -0
  251. package/bin/runners/lib/extractors/fastify-routes.js +426 -0
  252. package/bin/runners/lib/extractors/index.js +363 -0
  253. package/bin/runners/lib/extractors/next-routes.js +524 -0
  254. package/bin/runners/lib/extractors/proof-graph.js +431 -0
  255. package/bin/runners/lib/extractors/route-matcher.js +451 -0
  256. package/bin/runners/lib/extractors/truthpack-v2.js +377 -0
  257. package/bin/runners/lib/extractors/ui-bindings.js +547 -0
  258. package/bin/runners/lib/finding-id.js +69 -0
  259. package/bin/runners/lib/finding-sorter.js +89 -0
  260. package/bin/runners/lib/findings-schema.js +281 -0
  261. package/bin/runners/lib/fingerprint.js +377 -0
  262. package/bin/runners/lib/firewall-prompt.js +50 -0
  263. package/bin/runners/lib/fix-output.js +228 -0
  264. package/bin/runners/lib/global-flags.js +250 -0
  265. package/bin/runners/lib/graph/graph-builder.js +265 -0
  266. package/bin/runners/lib/graph/html-renderer.js +413 -0
  267. package/bin/runners/lib/graph/index.js +32 -0
  268. package/bin/runners/lib/graph/runtime-collector.js +215 -0
  269. package/bin/runners/lib/graph/static-extractor.js +518 -0
  270. package/bin/runners/lib/help-formatter.js +413 -0
  271. package/bin/runners/lib/html-proof-report.js +913 -0
  272. package/bin/runners/lib/html-report.js +650 -0
  273. package/bin/runners/lib/init-wizard.js +601 -0
  274. package/bin/runners/lib/interactive-menu.js +1496 -0
  275. package/bin/runners/lib/json-output.js +76 -0
  276. package/bin/runners/lib/llm.js +75 -0
  277. package/bin/runners/lib/logger.js +38 -0
  278. package/bin/runners/lib/meter.js +61 -0
  279. package/bin/runners/lib/missions/briefing.js +427 -0
  280. package/bin/runners/lib/missions/checkpoint.js +753 -0
  281. package/bin/runners/lib/missions/evidence.js +126 -0
  282. package/bin/runners/lib/missions/hardening.js +851 -0
  283. package/bin/runners/lib/missions/plan.js +648 -0
  284. package/bin/runners/lib/missions/safety-gates.js +645 -0
  285. package/bin/runners/lib/missions/schema.js +478 -0
  286. package/bin/runners/lib/missions/templates.js +317 -0
  287. package/bin/runners/lib/next-action.js +560 -0
  288. package/bin/runners/lib/packs/bundle.js +675 -0
  289. package/bin/runners/lib/packs/evidence-pack.js +671 -0
  290. package/bin/runners/lib/packs/pack-factory.js +837 -0
  291. package/bin/runners/lib/packs/permissions-pack.js +686 -0
  292. package/bin/runners/lib/packs/proof-graph-pack.js +779 -0
  293. package/bin/runners/lib/patch.js +40 -0
  294. package/bin/runners/lib/permissions/auth-model.js +213 -0
  295. package/bin/runners/lib/permissions/idor-prover.js +205 -0
  296. package/bin/runners/lib/permissions/index.js +45 -0
  297. package/bin/runners/lib/permissions/matrix-builder.js +198 -0
  298. package/bin/runners/lib/pkgjson.js +28 -0
  299. package/bin/runners/lib/policy.js +295 -0
  300. package/bin/runners/lib/polish/accessibility.js +62 -0
  301. package/bin/runners/lib/polish/analyzer.js +93 -0
  302. package/bin/runners/lib/polish/backend.js +87 -0
  303. package/bin/runners/lib/polish/configuration.js +83 -0
  304. package/bin/runners/lib/polish/documentation.js +83 -0
  305. package/bin/runners/lib/polish/frontend.js +817 -0
  306. package/bin/runners/lib/polish/index.js +27 -0
  307. package/bin/runners/lib/polish/infrastructure.js +80 -0
  308. package/bin/runners/lib/polish/internationalization.js +85 -0
  309. package/bin/runners/lib/polish/libraries.js +180 -0
  310. package/bin/runners/lib/polish/observability.js +75 -0
  311. package/bin/runners/lib/polish/performance.js +64 -0
  312. package/bin/runners/lib/polish/privacy.js +110 -0
  313. package/bin/runners/lib/polish/resilience.js +92 -0
  314. package/bin/runners/lib/polish/security.js +78 -0
  315. package/bin/runners/lib/polish/seo.js +71 -0
  316. package/bin/runners/lib/polish/styles.js +62 -0
  317. package/bin/runners/lib/polish/utils.js +104 -0
  318. package/bin/runners/lib/preflight.js +142 -0
  319. package/bin/runners/lib/prerequisites.js +149 -0
  320. package/bin/runners/lib/prove-output.js +220 -0
  321. package/bin/runners/lib/reality/correlation-detectors.js +359 -0
  322. package/bin/runners/lib/reality/index.js +318 -0
  323. package/bin/runners/lib/reality/request-hashing.js +416 -0
  324. package/bin/runners/lib/reality/request-mapper.js +453 -0
  325. package/bin/runners/lib/reality/safety-rails.js +463 -0
  326. package/bin/runners/lib/reality/semantic-snapshot.js +408 -0
  327. package/bin/runners/lib/reality/toast-detector.js +393 -0
  328. package/bin/runners/lib/reality-findings.js +84 -0
  329. package/bin/runners/lib/reality-output.js +231 -0
  330. package/bin/runners/lib/receipts.js +179 -0
  331. package/bin/runners/lib/redact.js +29 -0
  332. package/bin/runners/lib/replay/capsule-manager.js +154 -0
  333. package/bin/runners/lib/replay/index.js +263 -0
  334. package/bin/runners/lib/replay/player.js +348 -0
  335. package/bin/runners/lib/replay/recorder.js +331 -0
  336. package/bin/runners/lib/report-engine.js +626 -0
  337. package/bin/runners/lib/report-html.js +1233 -0
  338. package/bin/runners/lib/report-output.js +366 -0
  339. package/bin/runners/lib/report-templates.js +967 -0
  340. package/bin/runners/lib/report.js +135 -0
  341. package/bin/runners/lib/route-detection.js +1209 -0
  342. package/bin/runners/lib/route-truth.js +1322 -0
  343. package/bin/runners/lib/safelist/index.js +96 -0
  344. package/bin/runners/lib/safelist/integration.js +334 -0
  345. package/bin/runners/lib/safelist/matcher.js +696 -0
  346. package/bin/runners/lib/safelist/schema.js +948 -0
  347. package/bin/runners/lib/safelist/store.js +438 -0
  348. package/bin/runners/lib/sandbox/index.js +59 -0
  349. package/bin/runners/lib/sandbox/proof-chain.js +399 -0
  350. package/bin/runners/lib/sandbox/sandbox-runner.js +205 -0
  351. package/bin/runners/lib/sandbox/worktree.js +174 -0
  352. package/bin/runners/lib/scan-cache.js +330 -0
  353. package/bin/runners/lib/scan-output-schema.js +344 -0
  354. package/bin/runners/lib/scan-output.js +631 -0
  355. package/bin/runners/lib/scan-runner.js +135 -0
  356. package/bin/runners/lib/schema-validator.js +350 -0
  357. package/bin/runners/lib/schemas/ajv-validator.js +464 -0
  358. package/bin/runners/lib/schemas/contracts.schema.json +160 -0
  359. package/bin/runners/lib/schemas/error-envelope.schema.json +105 -0
  360. package/bin/runners/lib/schemas/finding-v3.schema.json +151 -0
  361. package/bin/runners/lib/schemas/finding.schema.json +100 -0
  362. package/bin/runners/lib/schemas/mission-pack.schema.json +206 -0
  363. package/bin/runners/lib/schemas/proof-graph.schema.json +176 -0
  364. package/bin/runners/lib/schemas/reality-report.schema.json +162 -0
  365. package/bin/runners/lib/schemas/report-artifact.schema.json +120 -0
  366. package/bin/runners/lib/schemas/run-request.schema.json +108 -0
  367. package/bin/runners/lib/schemas/share-pack.schema.json +180 -0
  368. package/bin/runners/lib/schemas/ship-manifest.schema.json +251 -0
  369. package/bin/runners/lib/schemas/ship-report.schema.json +117 -0
  370. package/bin/runners/lib/schemas/truthpack-v2.schema.json +303 -0
  371. package/bin/runners/lib/schemas/validator.js +465 -0
  372. package/bin/runners/lib/schemas/verdict.schema.json +140 -0
  373. package/bin/runners/lib/score-history.js +282 -0
  374. package/bin/runners/lib/security-bridge.js +249 -0
  375. package/bin/runners/lib/server-usage.js +513 -0
  376. package/bin/runners/lib/share-pack.js +239 -0
  377. package/bin/runners/lib/ship-gate.js +832 -0
  378. package/bin/runners/lib/ship-manifest.js +1153 -0
  379. package/bin/runners/lib/ship-output-enterprise.js +239 -0
  380. package/bin/runners/lib/ship-output.js +1128 -0
  381. package/bin/runners/lib/snippets.js +67 -0
  382. package/bin/runners/lib/status-output.js +340 -0
  383. package/bin/runners/lib/terminal-ui.js +356 -0
  384. package/bin/runners/lib/truth.js +1691 -0
  385. package/bin/runners/lib/ui.js +562 -0
  386. package/bin/runners/lib/unified-cli-output.js +947 -0
  387. package/bin/runners/lib/unified-output.js +197 -0
  388. package/bin/runners/lib/upsell.js +410 -0
  389. package/bin/runners/lib/usage.js +153 -0
  390. package/bin/runners/lib/validate-patch.js +156 -0
  391. package/bin/runners/lib/verdict-engine.js +628 -0
  392. package/bin/runners/lib/verification.js +345 -0
  393. package/bin/runners/lib/why-tree.js +650 -0
  394. package/bin/runners/reality/engine.js +917 -0
  395. package/bin/runners/reality/flows.js +122 -0
  396. package/bin/runners/reality/report.js +378 -0
  397. package/bin/runners/reality/session.js +193 -0
  398. package/bin/runners/runAIAgent.js +229 -0
  399. package/bin/runners/runAgent.d.ts +5 -0
  400. package/bin/runners/runAgent.js +161 -0
  401. package/bin/runners/runAllowlist.js +418 -0
  402. package/bin/runners/runApprove.js +320 -0
  403. package/bin/runners/runAudit.js +692 -0
  404. package/bin/runners/runAuth.js +731 -0
  405. package/bin/runners/runCI.js +353 -0
  406. package/bin/runners/runCheckpoint.js +530 -0
  407. package/bin/runners/runClassify.js +928 -0
  408. package/bin/runners/runCleanup.js +343 -0
  409. package/bin/runners/runContext.d.ts +4 -0
  410. package/bin/runners/runContext.js +175 -0
  411. package/bin/runners/runDoctor.js +877 -0
  412. package/bin/runners/runEvidencePack.js +362 -0
  413. package/bin/runners/runFirewall.d.ts +5 -0
  414. package/bin/runners/runFirewall.js +134 -0
  415. package/bin/runners/runFirewallHook.d.ts +5 -0
  416. package/bin/runners/runFirewallHook.js +56 -0
  417. package/bin/runners/runFix.js +1355 -0
  418. package/bin/runners/runForge.js +451 -0
  419. package/bin/runners/runGuard.js +262 -0
  420. package/bin/runners/runInit.js +1927 -0
  421. package/bin/runners/runIntent.js +906 -0
  422. package/bin/runners/runKickoff.js +878 -0
  423. package/bin/runners/runLabs.js +424 -0
  424. package/bin/runners/runLaunch.js +2000 -0
  425. package/bin/runners/runLink.js +785 -0
  426. package/bin/runners/runMcp.js +1875 -0
  427. package/bin/runners/runPacks.js +2089 -0
  428. package/bin/runners/runPolish.d.ts +4 -0
  429. package/bin/runners/runPolish.js +390 -0
  430. package/bin/runners/runPromptFirewall.js +211 -0
  431. package/bin/runners/runProve.js +1411 -0
  432. package/bin/runners/runQuickstart.js +531 -0
  433. package/bin/runners/runReality.js +2260 -0
  434. package/bin/runners/runReport.js +726 -0
  435. package/bin/runners/runRuntime.js +110 -0
  436. package/bin/runners/runSafelist.js +1190 -0
  437. package/bin/runners/runScan.js +688 -0
  438. package/bin/runners/runShield.js +1282 -0
  439. package/bin/runners/runShip.js +1660 -0
  440. package/bin/runners/runTruth.d.ts +5 -0
  441. package/bin/runners/runTruth.js +101 -0
  442. package/bin/runners/runValidate.js +179 -0
  443. package/bin/runners/runWatch.js +478 -0
  444. package/bin/runners/utils.js +360 -0
  445. package/bin/scan.js +617 -0
  446. package/bin/vibecheck.js +1617 -0
  447. package/dist/guardrail/index.d.ts +2405 -0
  448. package/dist/guardrail/index.js +9747 -0
  449. package/dist/guardrail/index.js.map +1 -0
  450. package/dist/scanner/index.d.ts +282 -0
  451. package/dist/scanner/index.js +3395 -0
  452. package/dist/scanner/index.js.map +1 -0
  453. package/package.json +123 -104
  454. package/README.md +0 -491
  455. package/dist/index.js +0 -99711
  456. package/dist/index.js.map +0 -1
@@ -0,0 +1,255 @@
1
+ /**
2
+ * Code Quality Detection Engine
3
+ * Detects code smells, complexity issues, maintainability problems
4
+ */
5
+
6
+ const { getAST } = require("./ast-cache");
7
+ const traverse = require("@babel/traverse").default;
8
+ const t = require("@babel/types");
9
+ const { shouldExcludeFile } = require("./file-filter");
10
+
11
+ /**
12
+ * Calculate cyclomatic complexity of a function
13
+ */
14
+ function calculateComplexity(node) {
15
+ let complexity = 1; // Base complexity
16
+
17
+ traverse(node, {
18
+ IfStatement: () => complexity++,
19
+ SwitchCase: () => complexity++,
20
+ ForStatement: () => complexity++,
21
+ ForInStatement: () => complexity++,
22
+ ForOfStatement: () => complexity++,
23
+ WhileStatement: () => complexity++,
24
+ DoWhileStatement: () => complexity++,
25
+ CatchClause: () => complexity++,
26
+ ConditionalExpression: () => complexity++,
27
+ LogicalExpression: (path) => {
28
+ if (path.node.operator === "&&" || path.node.operator === "||") {
29
+ complexity++;
30
+ }
31
+ },
32
+ });
33
+
34
+ return complexity;
35
+ }
36
+
37
+ /**
38
+ * Analyze a file for code quality issues
39
+ */
40
+ function analyzeCodeQuality(code, filePath) {
41
+ const findings = [];
42
+
43
+ // Skip excluded files
44
+ if (shouldExcludeFile(filePath)) return findings;
45
+
46
+ const ast = getAST(code, filePath);
47
+ if (!ast) return findings;
48
+
49
+ const lines = code.split("\n");
50
+
51
+ // Function complexity
52
+ traverse(ast, {
53
+ FunctionDeclaration(path) {
54
+ const node = path.node;
55
+ const complexity = calculateComplexity(node);
56
+
57
+ if (complexity > 15) {
58
+ const line = node.loc.start.line;
59
+ findings.push({
60
+ type: "high_complexity",
61
+ severity: "WARN",
62
+ category: "CodeQuality",
63
+ file: filePath,
64
+ line,
65
+ column: node.loc.start.column,
66
+ title: `High cyclomatic complexity: ${complexity}`,
67
+ message: `Function "${node.id?.name || "anonymous"}" has complexity ${complexity} - consider refactoring`,
68
+ codeSnippet: lines[line - 1]?.trim(),
69
+ confidence: "high",
70
+ });
71
+ }
72
+ },
73
+ ArrowFunctionExpression(path) {
74
+ const node = path.node;
75
+ const complexity = calculateComplexity(node);
76
+
77
+ if (complexity > 15) {
78
+ const line = node.loc.start.line;
79
+ findings.push({
80
+ type: "high_complexity",
81
+ severity: "WARN",
82
+ category: "CodeQuality",
83
+ file: filePath,
84
+ line,
85
+ column: node.loc.start.column,
86
+ title: `High cyclomatic complexity: ${complexity}`,
87
+ message: `Arrow function has complexity ${complexity} - consider refactoring`,
88
+ codeSnippet: lines[line - 1]?.trim(),
89
+ confidence: "high",
90
+ });
91
+ }
92
+ },
93
+ });
94
+
95
+ // Long functions
96
+ traverse(ast, {
97
+ FunctionDeclaration(path) {
98
+ const node = path.node;
99
+ const startLine = node.loc.start.line;
100
+ const endLine = node.loc.end.line;
101
+ const length = endLine - startLine;
102
+
103
+ if (length > 100) {
104
+ findings.push({
105
+ type: "long_function",
106
+ severity: "WARN",
107
+ category: "CodeQuality",
108
+ file: filePath,
109
+ line: startLine,
110
+ column: node.loc.start.column,
111
+ title: `Long function: ${length} lines`,
112
+ message: `Function "${node.id?.name || "anonymous"}" is ${length} lines - consider breaking into smaller functions`,
113
+ codeSnippet: lines[startLine - 1]?.trim(),
114
+ confidence: "med",
115
+ });
116
+ }
117
+ },
118
+ });
119
+
120
+ // Deeply nested code
121
+ let nestingDepth = 0;
122
+ let maxNesting = 0;
123
+ let maxNestingLine = 0;
124
+
125
+ traverse(ast, {
126
+ enter(path) {
127
+ if (t.isIfStatement(path.node) ||
128
+ t.isForStatement(path.node) ||
129
+ t.isWhileStatement(path.node) ||
130
+ t.isSwitchStatement(path.node) ||
131
+ t.isTryStatement(path.node)) {
132
+ nestingDepth++;
133
+ if (nestingDepth > maxNesting) {
134
+ maxNesting = nestingDepth;
135
+ maxNestingLine = path.node.loc.start.line;
136
+ }
137
+ }
138
+ },
139
+ exit(path) {
140
+ if (t.isIfStatement(path.node) ||
141
+ t.isForStatement(path.node) ||
142
+ t.isWhileStatement(path.node) ||
143
+ t.isSwitchStatement(path.node) ||
144
+ t.isTryStatement(path.node)) {
145
+ nestingDepth--;
146
+ }
147
+ },
148
+ });
149
+
150
+ if (maxNesting > 5) {
151
+ findings.push({
152
+ type: "deep_nesting",
153
+ severity: "WARN",
154
+ category: "CodeQuality",
155
+ file: filePath,
156
+ line: maxNestingLine,
157
+ column: 0,
158
+ title: `Deep nesting: ${maxNesting} levels`,
159
+ message: `Code has ${maxNesting} levels of nesting - consider refactoring with early returns or extraction`,
160
+ codeSnippet: lines[maxNestingLine - 1]?.trim(),
161
+ confidence: "med",
162
+ });
163
+ }
164
+
165
+ // Duplicate code detection (simple string-based)
166
+ const functionBodies = new Map();
167
+ traverse(ast, {
168
+ FunctionDeclaration(path) {
169
+ const node = path.node;
170
+ if (node.body) {
171
+ const bodyCode = code.substring(node.body.start, node.body.end);
172
+ const normalized = bodyCode.replace(/\s+/g, " ").trim();
173
+
174
+ if (normalized.length > 50) { // Only check substantial functions
175
+ if (functionBodies.has(normalized)) {
176
+ const original = functionBodies.get(normalized);
177
+ findings.push({
178
+ type: "duplicate_code",
179
+ severity: "WARN",
180
+ category: "CodeQuality",
181
+ file: filePath,
182
+ line: node.loc.start.line,
183
+ column: node.loc.start.column,
184
+ title: "Potential duplicate code",
185
+ message: `Function "${node.id?.name || "anonymous"}" appears similar to function at line ${original}`,
186
+ codeSnippet: lines[node.loc.start.line - 1]?.trim(),
187
+ confidence: "low",
188
+ });
189
+ } else {
190
+ functionBodies.set(normalized, node.loc.start.line);
191
+ }
192
+ }
193
+ }
194
+ },
195
+ });
196
+
197
+ // Magic numbers
198
+ traverse(ast, {
199
+ NumericLiteral(path) {
200
+ const node = path.node;
201
+ const value = node.value;
202
+
203
+ // Skip common constants (0, 1, -1, 100, 1000)
204
+ if ([0, 1, -1, 100, 1000].includes(value)) return;
205
+
206
+ // Check if it's not in a common context (array index, etc.)
207
+ const parent = path.parent;
208
+ if (!t.isArrayExpression(parent) &&
209
+ !t.isMemberExpression(parent) &&
210
+ !t.isBinaryExpression(parent)) {
211
+ const line = node.loc.start.line;
212
+ findings.push({
213
+ type: "magic_number",
214
+ severity: "WARN",
215
+ category: "CodeQuality",
216
+ file: filePath,
217
+ line,
218
+ column: node.loc.start.column,
219
+ title: `Magic number: ${value}`,
220
+ message: `Consider extracting ${value} as a named constant`,
221
+ codeSnippet: lines[line - 1]?.trim(),
222
+ confidence: "low",
223
+ });
224
+ }
225
+ },
226
+ });
227
+
228
+ // Long parameter lists
229
+ traverse(ast, {
230
+ FunctionDeclaration(path) {
231
+ const node = path.node;
232
+ if (node.params && node.params.length > 5) {
233
+ const line = node.loc.start.line;
234
+ findings.push({
235
+ type: "long_parameter_list",
236
+ severity: "WARN",
237
+ category: "CodeQuality",
238
+ file: filePath,
239
+ line,
240
+ column: node.loc.start.column,
241
+ title: `Long parameter list: ${node.params.length} parameters`,
242
+ message: `Function "${node.id?.name || "anonymous"}" has ${node.params.length} parameters - consider using an options object`,
243
+ codeSnippet: lines[line - 1]?.trim(),
244
+ confidence: "med",
245
+ });
246
+ }
247
+ },
248
+ });
249
+
250
+ return findings;
251
+ }
252
+
253
+ module.exports = {
254
+ analyzeCodeQuality,
255
+ };
@@ -0,0 +1,115 @@
1
+ /**
2
+ * Console Log Detection Engine
3
+ * Uses AST analysis to detect console.* calls in production code
4
+ */
5
+
6
+ const { getAST, parseCode } = require("./ast-cache");
7
+ const traverse = require("@babel/traverse").default;
8
+ const t = require("@babel/types");
9
+ const { shouldExcludeFile, isTestContext: isTestContextCheck } = require("./file-filter");
10
+
11
+ /**
12
+ * Check if a call expression is a console.* call
13
+ */
14
+ function isConsoleCall(node) {
15
+ if (!t.isCallExpression(node)) return false;
16
+
17
+ const callee = node.callee;
18
+
19
+ // console.log(), console.warn(), etc.
20
+ if (t.isMemberExpression(callee)) {
21
+ const object = callee.object;
22
+ const property = callee.property;
23
+
24
+ if (t.isIdentifier(object) && object.name === "console") {
25
+ if (t.isIdentifier(property)) {
26
+ const methods = ["log", "warn", "debug", "info", "trace", "error", "dir", "table"];
27
+ return methods.includes(property.name);
28
+ }
29
+ }
30
+ }
31
+
32
+ return false;
33
+ }
34
+
35
+ /**
36
+ * Analyze a file for console.* calls
37
+ */
38
+ function analyzeConsoleLogs(code, filePath) {
39
+ const findings = [];
40
+
41
+ // Skip excluded files
42
+ if (shouldExcludeFile(filePath)) return findings;
43
+
44
+ // Skip test contexts
45
+ if (isTestContextCheck(code, filePath)) return findings;
46
+
47
+ const ast = getAST(code, filePath);
48
+ if (!ast) return findings;
49
+
50
+ const lines = code.split("\n");
51
+ const MAX_FINDINGS = 15;
52
+ let consoleCount = 0;
53
+
54
+ traverse(ast, {
55
+ CallExpression(path) {
56
+ if (isConsoleCall(path.node)) {
57
+ // Check if it's commented out
58
+ const leadingComments = path.node.leadingComments || [];
59
+ const isCommented = leadingComments.some(c =>
60
+ c.type === "CommentLine" || c.type === "CommentBlock"
61
+ );
62
+
63
+ if (isCommented) return;
64
+
65
+ consoleCount++;
66
+
67
+ if (findings.length < MAX_FINDINGS) {
68
+ const line = path.node.loc.start.line;
69
+ const snippet = lines[line - 1]?.trim() || "";
70
+
71
+ // Get method name
72
+ let method = "log";
73
+ if (t.isMemberExpression(path.node.callee) &&
74
+ t.isIdentifier(path.node.callee.property)) {
75
+ method = path.node.callee.property.name;
76
+ }
77
+
78
+ findings.push({
79
+ type: `console_${method}`,
80
+ severity: "WARN",
81
+ category: "ConsoleLog",
82
+ file: filePath,
83
+ line,
84
+ column: path.node.loc.start.column,
85
+ title: `console.${method}() in production code`,
86
+ message: `console.${method}() call found at line ${line}`,
87
+ codeSnippet: snippet.substring(0, 60),
88
+ confidence: "high",
89
+ });
90
+ }
91
+ }
92
+ },
93
+ });
94
+
95
+ // Add summary if there are many
96
+ if (consoleCount > MAX_FINDINGS) {
97
+ findings.push({
98
+ type: "summary",
99
+ severity: "WARN",
100
+ category: "ConsoleLog",
101
+ file: filePath,
102
+ line: 0,
103
+ title: `${consoleCount} console.* statements found (${consoleCount - MAX_FINDINGS} more not shown)`,
104
+ message: `Found ${consoleCount} console statements in this file`,
105
+ confidence: "high",
106
+ });
107
+ }
108
+
109
+ return findings;
110
+ }
111
+
112
+ module.exports = {
113
+ analyzeConsoleLogs,
114
+ parseCode,
115
+ };
@@ -0,0 +1,268 @@
1
+ /**
2
+ * Cross-File Analysis Engine
3
+ * Analyzes relationships between files: unused exports, circular dependencies, import consistency
4
+ */
5
+
6
+ const fs = require("fs");
7
+ const path = require("path");
8
+ const { getAST } = require("./ast-cache");
9
+ const traverse = require("@babel/traverse").default;
10
+ const t = require("@babel/types");
11
+
12
+ /**
13
+ * Build export map for all files
14
+ */
15
+ function buildExportMap(files, repoRoot) {
16
+ const exportMap = new Map(); // filePath -> Set<exportNames>
17
+ const importMap = new Map(); // filePath -> Map<importedFrom, Set<importedNames>>
18
+
19
+ for (const fileAbs of files) {
20
+ try {
21
+ const code = fs.readFileSync(fileAbs, "utf8");
22
+ const fileRel = path.relative(repoRoot, fileAbs).replace(/\\/g, "/");
23
+ const ast = getAST(code, fileRel);
24
+ if (!ast) continue;
25
+
26
+ const exports = new Set();
27
+ const imports = new Map();
28
+
29
+ traverse(ast, {
30
+ // Collect exports
31
+ ExportNamedDeclaration(path) {
32
+ if (path.node.declaration) {
33
+ if (t.isFunctionDeclaration(path.node.declaration)) {
34
+ exports.add(path.node.declaration.id?.name);
35
+ } else if (t.isVariableDeclaration(path.node.declaration)) {
36
+ path.node.declaration.declarations.forEach(decl => {
37
+ if (t.isIdentifier(decl.id)) {
38
+ exports.add(decl.id.name);
39
+ }
40
+ });
41
+ } else if (t.isClassDeclaration(path.node.declaration)) {
42
+ exports.add(path.node.declaration.id?.name);
43
+ }
44
+ }
45
+ if (path.node.specifiers) {
46
+ path.node.specifiers.forEach(spec => {
47
+ if (t.isExportSpecifier(spec)) {
48
+ exports.add(spec.exported.name);
49
+ }
50
+ });
51
+ }
52
+ },
53
+ ExportDefaultDeclaration(path) {
54
+ if (t.isIdentifier(path.node.declaration)) {
55
+ exports.add("default");
56
+ } else if (t.isFunctionDeclaration(path.node.declaration)) {
57
+ exports.add("default");
58
+ } else if (t.isClassDeclaration(path.node.declaration)) {
59
+ exports.add("default");
60
+ }
61
+ },
62
+
63
+ // Collect imports
64
+ ImportDeclaration(path) {
65
+ const source = path.node.source.value;
66
+ if (!source.startsWith(".") && !source.startsWith("/")) {
67
+ // External import, skip
68
+ return;
69
+ }
70
+
71
+ const importedNames = new Set();
72
+ path.node.specifiers.forEach(spec => {
73
+ if (t.isImportSpecifier(spec)) {
74
+ importedNames.add(spec.imported.name);
75
+ } else if (t.isImportDefaultSpecifier(spec)) {
76
+ importedNames.add("default");
77
+ } else if (t.isImportNamespaceSpecifier(spec)) {
78
+ importedNames.add("*");
79
+ }
80
+ });
81
+
82
+ if (importedNames.size > 0) {
83
+ imports.set(source, importedNames);
84
+ }
85
+ },
86
+ });
87
+
88
+ exportMap.set(fileRel, exports);
89
+ importMap.set(fileRel, imports);
90
+ } catch (err) {
91
+ // Skip files that can't be analyzed
92
+ continue;
93
+ }
94
+ }
95
+
96
+ return { exportMap, importMap };
97
+ }
98
+
99
+ /**
100
+ * Resolve import path to actual file path
101
+ */
102
+ function resolveImportPath(importPath, fromFile, repoRoot) {
103
+ const dir = path.dirname(path.join(repoRoot, fromFile));
104
+ let resolved = path.resolve(dir, importPath);
105
+
106
+ // Try common extensions
107
+ const extensions = [".ts", ".tsx", ".js", ".jsx", "/index.ts", "/index.tsx", "/index.js", "/index.jsx"];
108
+ for (const ext of extensions) {
109
+ const candidate = resolved + ext;
110
+ if (fs.existsSync(candidate)) {
111
+ return path.relative(repoRoot, candidate).replace(/\\/g, "/");
112
+ }
113
+ }
114
+
115
+ // Try without extension
116
+ if (fs.existsSync(resolved)) {
117
+ return path.relative(repoRoot, resolved).replace(/\\/g, "/");
118
+ }
119
+
120
+ return null;
121
+ }
122
+
123
+ /**
124
+ * Analyze cross-file issues
125
+ */
126
+ function analyzeCrossFile(files, repoRoot) {
127
+ const findings = [];
128
+ const { exportMap, importMap } = buildExportMap(files, repoRoot);
129
+
130
+ // 1. Find unused exports
131
+ const usedExports = new Map(); // filePath -> Set<usedExportNames>
132
+
133
+ for (const [fileRel, imports] of importMap.entries()) {
134
+ for (const [importPath, importedNames] of imports.entries()) {
135
+ const targetFile = resolveImportPath(importPath, fileRel, repoRoot);
136
+ if (!targetFile || !exportMap.has(targetFile)) continue;
137
+
138
+ const exports = exportMap.get(targetFile);
139
+ if (!usedExports.has(targetFile)) {
140
+ usedExports.set(targetFile, new Set());
141
+ }
142
+
143
+ importedNames.forEach(name => {
144
+ if (name === "*") {
145
+ // Namespace import - mark all exports as used
146
+ exports.forEach(exp => usedExports.get(targetFile).add(exp));
147
+ } else {
148
+ usedExports.get(targetFile).add(name);
149
+ }
150
+ });
151
+ }
152
+ }
153
+
154
+ // Find unused exports
155
+ for (const [fileRel, exports] of exportMap.entries()) {
156
+ const used = usedExports.get(fileRel) || new Set();
157
+
158
+ for (const exp of exports) {
159
+ if (!used.has(exp) && exp !== "default") {
160
+ // Check if it's a test file or config file (likely to have unused exports)
161
+ if (!fileRel.includes(".test.") && !fileRel.includes(".spec.") && !fileRel.includes("config")) {
162
+ findings.push({
163
+ type: "unused_export",
164
+ severity: "WARN",
165
+ category: "CodeQuality",
166
+ file: fileRel,
167
+ line: 0, // Would need to track line numbers
168
+ title: `Unused export: ${exp}`,
169
+ message: `Export "${exp}" from ${fileRel} is never imported`,
170
+ confidence: "med",
171
+ });
172
+ }
173
+ }
174
+ }
175
+ }
176
+
177
+ // 2. Detect circular dependencies
178
+ const visited = new Set();
179
+ const recursionStack = new Set();
180
+
181
+ function detectCycle(fileRel, path = []) {
182
+ if (recursionStack.has(fileRel)) {
183
+ // Found cycle!
184
+ const cycleStart = path.indexOf(fileRel);
185
+ const cycle = path.slice(cycleStart).concat(fileRel);
186
+ return cycle;
187
+ }
188
+
189
+ if (visited.has(fileRel)) {
190
+ return null;
191
+ }
192
+
193
+ visited.add(fileRel);
194
+ recursionStack.add(fileRel);
195
+
196
+ const imports = importMap.get(fileRel);
197
+ if (imports) {
198
+ for (const [importPath] of imports.entries()) {
199
+ const targetFile = resolveImportPath(importPath, fileRel, repoRoot);
200
+ if (targetFile && exportMap.has(targetFile)) {
201
+ const cycle = detectCycle(targetFile, path.concat(fileRel));
202
+ if (cycle) {
203
+ recursionStack.delete(fileRel);
204
+ return cycle;
205
+ }
206
+ }
207
+ }
208
+ }
209
+
210
+ recursionStack.delete(fileRel);
211
+ return null;
212
+ }
213
+
214
+ for (const fileRel of exportMap.keys()) {
215
+ if (!visited.has(fileRel)) {
216
+ const cycle = detectCycle(fileRel);
217
+ if (cycle && cycle.length > 2) {
218
+ findings.push({
219
+ type: "circular_dependency",
220
+ severity: "WARN",
221
+ category: "CodeQuality",
222
+ file: cycle[0],
223
+ line: 0,
224
+ title: `Circular dependency detected`,
225
+ message: `Circular dependency: ${cycle.join(" → ")}`,
226
+ confidence: "high",
227
+ });
228
+ }
229
+ }
230
+ }
231
+
232
+ // 3. Check for inconsistent imports (same module imported differently)
233
+ const importStyles = new Map(); // modulePath -> Set<importStyles>
234
+
235
+ for (const [fileRel, imports] of importMap.entries()) {
236
+ for (const [importPath] of imports.entries()) {
237
+ const targetFile = resolveImportPath(importPath, fileRel, repoRoot);
238
+ if (!targetFile) continue;
239
+
240
+ if (!importStyles.has(targetFile)) {
241
+ importStyles.set(targetFile, new Set());
242
+ }
243
+ importStyles.get(targetFile).add(importPath);
244
+ }
245
+ }
246
+
247
+ for (const [targetFile, styles] of importStyles.entries()) {
248
+ if (styles.size > 1) {
249
+ findings.push({
250
+ type: "inconsistent_imports",
251
+ severity: "WARN",
252
+ category: "CodeQuality",
253
+ file: targetFile,
254
+ line: 0,
255
+ title: `Inconsistent import paths`,
256
+ message: `Module imported with ${styles.size} different paths: ${Array.from(styles).join(", ")}`,
257
+ confidence: "low",
258
+ });
259
+ }
260
+ }
261
+
262
+ return findings;
263
+ }
264
+
265
+ module.exports = {
266
+ analyzeCrossFile,
267
+ buildExportMap,
268
+ };