@yasserkhanorg/impact-gate 2.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 (587) hide show
  1. package/LICENSE +168 -0
  2. package/README.md +520 -0
  3. package/dist/adapters/cypress.d.ts +10 -0
  4. package/dist/adapters/cypress.d.ts.map +1 -0
  5. package/dist/adapters/cypress.js +86 -0
  6. package/dist/adapters/framework_adapter.d.ts +41 -0
  7. package/dist/adapters/framework_adapter.d.ts.map +1 -0
  8. package/dist/adapters/framework_adapter.js +152 -0
  9. package/dist/adapters/playwright.d.ts +10 -0
  10. package/dist/adapters/playwright.d.ts.map +1 -0
  11. package/dist/adapters/playwright.js +86 -0
  12. package/dist/adapters/pytest.d.ts +10 -0
  13. package/dist/adapters/pytest.d.ts.map +1 -0
  14. package/dist/adapters/pytest.js +96 -0
  15. package/dist/adapters/supertest.d.ts +12 -0
  16. package/dist/adapters/supertest.d.ts.map +1 -0
  17. package/dist/adapters/supertest.js +85 -0
  18. package/dist/agent/api_catalog.d.ts +11 -0
  19. package/dist/agent/api_catalog.d.ts.map +1 -0
  20. package/dist/agent/api_catalog.js +210 -0
  21. package/dist/agent/config.d.ts +193 -0
  22. package/dist/agent/config.d.ts.map +1 -0
  23. package/dist/agent/config.js +875 -0
  24. package/dist/agent/feedback.d.ts +91 -0
  25. package/dist/agent/feedback.d.ts.map +1 -0
  26. package/dist/agent/feedback.js +323 -0
  27. package/dist/agent/git.d.ts +19 -0
  28. package/dist/agent/git.d.ts.map +1 -0
  29. package/dist/agent/git.js +257 -0
  30. package/dist/agent/handoff.d.ts +22 -0
  31. package/dist/agent/handoff.d.ts.map +1 -0
  32. package/dist/agent/handoff.js +180 -0
  33. package/dist/agent/llm_agents_flow.d.ts +15 -0
  34. package/dist/agent/llm_agents_flow.d.ts.map +1 -0
  35. package/dist/agent/llm_agents_flow.js +434 -0
  36. package/dist/agent/native_flow.d.ts +6 -0
  37. package/dist/agent/native_flow.d.ts.map +1 -0
  38. package/dist/agent/native_flow.js +179 -0
  39. package/dist/agent/pipeline.d.ts +7 -0
  40. package/dist/agent/pipeline.d.ts.map +1 -0
  41. package/dist/agent/pipeline.js +260 -0
  42. package/dist/agent/pipeline_types.d.ts +54 -0
  43. package/dist/agent/pipeline_types.d.ts.map +1 -0
  44. package/dist/agent/pipeline_types.js +4 -0
  45. package/dist/agent/pipeline_utils.d.ts +12 -0
  46. package/dist/agent/pipeline_utils.d.ts.map +1 -0
  47. package/dist/agent/pipeline_utils.js +156 -0
  48. package/dist/agent/plan.d.ts +170 -0
  49. package/dist/agent/plan.d.ts.map +1 -0
  50. package/dist/agent/plan.js +86 -0
  51. package/dist/agent/playwright_report.d.ts +8 -0
  52. package/dist/agent/playwright_report.d.ts.map +1 -0
  53. package/dist/agent/playwright_report.js +126 -0
  54. package/dist/agent/process_runner.d.ts +10 -0
  55. package/dist/agent/process_runner.d.ts.map +1 -0
  56. package/dist/agent/process_runner.js +92 -0
  57. package/dist/agent/spec_generator.d.ts +5 -0
  58. package/dist/agent/spec_generator.d.ts.map +1 -0
  59. package/dist/agent/spec_generator.js +253 -0
  60. package/dist/agent/test_path.d.ts +2 -0
  61. package/dist/agent/test_path.d.ts.map +1 -0
  62. package/dist/agent/test_path.js +23 -0
  63. package/dist/agent/traceability_capture.d.ts +18 -0
  64. package/dist/agent/traceability_capture.d.ts.map +1 -0
  65. package/dist/agent/traceability_capture.js +313 -0
  66. package/dist/agent/traceability_ingest.d.ts +21 -0
  67. package/dist/agent/traceability_ingest.d.ts.map +1 -0
  68. package/dist/agent/traceability_ingest.js +237 -0
  69. package/dist/agent/types.d.ts +42 -0
  70. package/dist/agent/types.d.ts.map +1 -0
  71. package/dist/agent/types.js +4 -0
  72. package/dist/agent/utils.d.ts +13 -0
  73. package/dist/agent/utils.d.ts.map +1 -0
  74. package/dist/agent/utils.js +152 -0
  75. package/dist/agent/validation_runner.d.ts +5 -0
  76. package/dist/agent/validation_runner.d.ts.map +1 -0
  77. package/dist/agent/validation_runner.js +77 -0
  78. package/dist/agentic/fix_loop.d.ts +26 -0
  79. package/dist/agentic/fix_loop.d.ts.map +1 -0
  80. package/dist/agentic/fix_loop.js +96 -0
  81. package/dist/agentic/playwright_runner.d.ts +43 -0
  82. package/dist/agentic/playwright_runner.d.ts.map +1 -0
  83. package/dist/agentic/playwright_runner.js +165 -0
  84. package/dist/agentic/runner.d.ts +27 -0
  85. package/dist/agentic/runner.d.ts.map +1 -0
  86. package/dist/agentic/runner.js +210 -0
  87. package/dist/agentic/types.d.ts +62 -0
  88. package/dist/agentic/types.d.ts.map +1 -0
  89. package/dist/agentic/types.js +4 -0
  90. package/dist/agents/coverage-evaluator.d.ts +8 -0
  91. package/dist/agents/coverage-evaluator.d.ts.map +1 -0
  92. package/dist/agents/coverage-evaluator.js +41 -0
  93. package/dist/agents/cross-impact.d.ts +13 -0
  94. package/dist/agents/cross-impact.d.ts.map +1 -0
  95. package/dist/agents/cross-impact.js +140 -0
  96. package/dist/agents/executor.d.ts +8 -0
  97. package/dist/agents/executor.d.ts.map +1 -0
  98. package/dist/agents/executor.js +75 -0
  99. package/dist/agents/explorer.d.ts +12 -0
  100. package/dist/agents/explorer.d.ts.map +1 -0
  101. package/dist/agents/explorer.js +43 -0
  102. package/dist/agents/generator.d.ts +8 -0
  103. package/dist/agents/generator.d.ts.map +1 -0
  104. package/dist/agents/generator.js +77 -0
  105. package/dist/agents/healer.d.ts +8 -0
  106. package/dist/agents/healer.d.ts.map +1 -0
  107. package/dist/agents/healer.js +31 -0
  108. package/dist/agents/impact-analyst.d.ts +8 -0
  109. package/dist/agents/impact-analyst.d.ts.map +1 -0
  110. package/dist/agents/impact-analyst.js +38 -0
  111. package/dist/agents/regression-advisor.d.ts +8 -0
  112. package/dist/agents/regression-advisor.d.ts.map +1 -0
  113. package/dist/agents/regression-advisor.js +116 -0
  114. package/dist/agents/strategist.d.ts +9 -0
  115. package/dist/agents/strategist.d.ts.map +1 -0
  116. package/dist/agents/strategist.js +92 -0
  117. package/dist/agents/test-designer.d.ts +8 -0
  118. package/dist/agents/test-designer.d.ts.map +1 -0
  119. package/dist/agents/test-designer.js +111 -0
  120. package/dist/anthropic_provider.d.ts +65 -0
  121. package/dist/anthropic_provider.d.ts.map +1 -0
  122. package/dist/anthropic_provider.js +334 -0
  123. package/dist/api.d.ts +48 -0
  124. package/dist/api.d.ts.map +1 -0
  125. package/dist/api.js +151 -0
  126. package/dist/base_provider.d.ts +109 -0
  127. package/dist/base_provider.d.ts.map +1 -0
  128. package/dist/base_provider.js +203 -0
  129. package/dist/budget_ledger.d.ts +28 -0
  130. package/dist/budget_ledger.d.ts.map +1 -0
  131. package/dist/budget_ledger.js +62 -0
  132. package/dist/cache/cached_provider.d.ts +49 -0
  133. package/dist/cache/cached_provider.d.ts.map +1 -0
  134. package/dist/cache/cached_provider.js +91 -0
  135. package/dist/cache/response_cache.d.ts +79 -0
  136. package/dist/cache/response_cache.d.ts.map +1 -0
  137. package/dist/cache/response_cache.js +177 -0
  138. package/dist/cli/commands/analyze.d.ts +3 -0
  139. package/dist/cli/commands/analyze.d.ts.map +1 -0
  140. package/dist/cli/commands/analyze.js +77 -0
  141. package/dist/cli/commands/bootstrap.d.ts +3 -0
  142. package/dist/cli/commands/bootstrap.d.ts.map +1 -0
  143. package/dist/cli/commands/bootstrap.js +109 -0
  144. package/dist/cli/commands/cost_report.d.ts +3 -0
  145. package/dist/cli/commands/cost_report.d.ts.map +1 -0
  146. package/dist/cli/commands/cost_report.js +115 -0
  147. package/dist/cli/commands/crew.d.ts +3 -0
  148. package/dist/cli/commands/crew.d.ts.map +1 -0
  149. package/dist/cli/commands/crew.js +255 -0
  150. package/dist/cli/commands/feedback.d.ts +3 -0
  151. package/dist/cli/commands/feedback.d.ts.map +1 -0
  152. package/dist/cli/commands/feedback.js +39 -0
  153. package/dist/cli/commands/finalize.d.ts +3 -0
  154. package/dist/cli/commands/finalize.d.ts.map +1 -0
  155. package/dist/cli/commands/finalize.js +41 -0
  156. package/dist/cli/commands/gate.d.ts +3 -0
  157. package/dist/cli/commands/gate.d.ts.map +1 -0
  158. package/dist/cli/commands/gate.js +89 -0
  159. package/dist/cli/commands/generate.d.ts +4 -0
  160. package/dist/cli/commands/generate.d.ts.map +1 -0
  161. package/dist/cli/commands/generate.js +108 -0
  162. package/dist/cli/commands/heal.d.ts +3 -0
  163. package/dist/cli/commands/heal.d.ts.map +1 -0
  164. package/dist/cli/commands/heal.js +60 -0
  165. package/dist/cli/commands/impact.d.ts +4 -0
  166. package/dist/cli/commands/impact.d.ts.map +1 -0
  167. package/dist/cli/commands/impact.js +33 -0
  168. package/dist/cli/commands/init.d.ts +2 -0
  169. package/dist/cli/commands/init.d.ts.map +1 -0
  170. package/dist/cli/commands/init.js +169 -0
  171. package/dist/cli/commands/llm_health.d.ts +2 -0
  172. package/dist/cli/commands/llm_health.d.ts.map +1 -0
  173. package/dist/cli/commands/llm_health.js +22 -0
  174. package/dist/cli/commands/plan.d.ts +4 -0
  175. package/dist/cli/commands/plan.d.ts.map +1 -0
  176. package/dist/cli/commands/plan.js +120 -0
  177. package/dist/cli/commands/plan_crew.d.ts +17 -0
  178. package/dist/cli/commands/plan_crew.d.ts.map +1 -0
  179. package/dist/cli/commands/plan_crew.js +316 -0
  180. package/dist/cli/commands/traceability.d.ts +4 -0
  181. package/dist/cli/commands/traceability.d.ts.map +1 -0
  182. package/dist/cli/commands/traceability.js +77 -0
  183. package/dist/cli/commands/train.d.ts +3 -0
  184. package/dist/cli/commands/train.d.ts.map +1 -0
  185. package/dist/cli/commands/train.js +391 -0
  186. package/dist/cli/defaults.d.ts +35 -0
  187. package/dist/cli/defaults.d.ts.map +1 -0
  188. package/dist/cli/defaults.js +172 -0
  189. package/dist/cli/errors.d.ts +27 -0
  190. package/dist/cli/errors.d.ts.map +1 -0
  191. package/dist/cli/errors.js +57 -0
  192. package/dist/cli/parse_args.d.ts +6 -0
  193. package/dist/cli/parse_args.d.ts.map +1 -0
  194. package/dist/cli/parse_args.js +257 -0
  195. package/dist/cli/types.d.ts +87 -0
  196. package/dist/cli/types.d.ts.map +1 -0
  197. package/dist/cli/types.js +4 -0
  198. package/dist/cli/usage.d.ts +2 -0
  199. package/dist/cli/usage.d.ts.map +1 -0
  200. package/dist/cli/usage.js +109 -0
  201. package/dist/cli.d.ts +3 -0
  202. package/dist/cli.d.ts.map +1 -0
  203. package/dist/cli.js +194 -0
  204. package/dist/crew/context.d.ts +55 -0
  205. package/dist/crew/context.d.ts.map +1 -0
  206. package/dist/crew/context.js +36 -0
  207. package/dist/crew/orchestrator.d.ts +50 -0
  208. package/dist/crew/orchestrator.d.ts.map +1 -0
  209. package/dist/crew/orchestrator.js +329 -0
  210. package/dist/crew/protocol.d.ts +46 -0
  211. package/dist/crew/protocol.d.ts.map +1 -0
  212. package/dist/crew/protocol.js +4 -0
  213. package/dist/crew/provider.d.ts +17 -0
  214. package/dist/crew/provider.d.ts.map +1 -0
  215. package/dist/crew/provider.js +36 -0
  216. package/dist/crew/sanitize.d.ts +3 -0
  217. package/dist/crew/sanitize.d.ts.map +1 -0
  218. package/dist/crew/sanitize.js +31 -0
  219. package/dist/crew/types.d.ts +52 -0
  220. package/dist/crew/types.d.ts.map +1 -0
  221. package/dist/crew/types.js +4 -0
  222. package/dist/crew/workflows.d.ts +52 -0
  223. package/dist/crew/workflows.d.ts.map +1 -0
  224. package/dist/crew/workflows.js +36 -0
  225. package/dist/custom_provider.d.ts +20 -0
  226. package/dist/custom_provider.d.ts.map +1 -0
  227. package/dist/custom_provider.js +277 -0
  228. package/dist/engine/ai_enrichment.d.ts +44 -0
  229. package/dist/engine/ai_enrichment.d.ts.map +1 -0
  230. package/dist/engine/ai_enrichment.js +267 -0
  231. package/dist/engine/diff_loader.d.ts +11 -0
  232. package/dist/engine/diff_loader.d.ts.map +1 -0
  233. package/dist/engine/diff_loader.js +63 -0
  234. package/dist/engine/impact_engine.d.ts +72 -0
  235. package/dist/engine/impact_engine.d.ts.map +1 -0
  236. package/dist/engine/impact_engine.js +298 -0
  237. package/dist/engine/plan_builder.d.ts +11 -0
  238. package/dist/engine/plan_builder.d.ts.map +1 -0
  239. package/dist/engine/plan_builder.js +599 -0
  240. package/dist/esm/adapters/cypress.js +49 -0
  241. package/dist/esm/adapters/framework_adapter.js +114 -0
  242. package/dist/esm/adapters/playwright.js +49 -0
  243. package/dist/esm/adapters/pytest.js +59 -0
  244. package/dist/esm/adapters/supertest.js +48 -0
  245. package/dist/esm/agent/api_catalog.js +199 -0
  246. package/dist/esm/agent/config.js +872 -0
  247. package/dist/esm/agent/feedback.js +317 -0
  248. package/dist/esm/agent/git.js +252 -0
  249. package/dist/esm/agent/handoff.js +177 -0
  250. package/dist/esm/agent/llm_agents_flow.js +421 -0
  251. package/dist/esm/agent/native_flow.js +175 -0
  252. package/dist/esm/agent/pipeline.js +256 -0
  253. package/dist/esm/agent/pipeline_types.js +3 -0
  254. package/dist/esm/agent/pipeline_utils.js +146 -0
  255. package/dist/esm/agent/plan.js +83 -0
  256. package/dist/esm/agent/playwright_report.js +123 -0
  257. package/dist/esm/agent/process_runner.js +83 -0
  258. package/dist/esm/agent/spec_generator.js +249 -0
  259. package/dist/esm/agent/test_path.js +20 -0
  260. package/dist/esm/agent/traceability_capture.js +310 -0
  261. package/dist/esm/agent/traceability_ingest.js +234 -0
  262. package/dist/esm/agent/types.js +3 -0
  263. package/dist/esm/agent/utils.js +138 -0
  264. package/dist/esm/agent/validation_runner.js +73 -0
  265. package/dist/esm/agentic/fix_loop.js +91 -0
  266. package/dist/esm/agentic/playwright_runner.js +161 -0
  267. package/dist/esm/agentic/runner.js +207 -0
  268. package/dist/esm/agentic/types.js +3 -0
  269. package/dist/esm/agents/coverage-evaluator.js +37 -0
  270. package/dist/esm/agents/cross-impact.js +136 -0
  271. package/dist/esm/agents/executor.js +71 -0
  272. package/dist/esm/agents/explorer.js +39 -0
  273. package/dist/esm/agents/generator.js +73 -0
  274. package/dist/esm/agents/healer.js +27 -0
  275. package/dist/esm/agents/impact-analyst.js +34 -0
  276. package/dist/esm/agents/regression-advisor.js +112 -0
  277. package/dist/esm/agents/strategist.js +88 -0
  278. package/dist/esm/agents/test-designer.js +107 -0
  279. package/dist/esm/anthropic_provider.js +326 -0
  280. package/dist/esm/api.js +143 -0
  281. package/dist/esm/base_provider.js +198 -0
  282. package/dist/esm/budget_ledger.js +58 -0
  283. package/dist/esm/cache/cached_provider.js +85 -0
  284. package/dist/esm/cache/response_cache.js +140 -0
  285. package/dist/esm/cli/commands/analyze.js +74 -0
  286. package/dist/esm/cli/commands/bootstrap.js +106 -0
  287. package/dist/esm/cli/commands/cost_report.js +112 -0
  288. package/dist/esm/cli/commands/crew.js +252 -0
  289. package/dist/esm/cli/commands/feedback.js +36 -0
  290. package/dist/esm/cli/commands/finalize.js +38 -0
  291. package/dist/esm/cli/commands/gate.js +86 -0
  292. package/dist/esm/cli/commands/generate.js +105 -0
  293. package/dist/esm/cli/commands/heal.js +57 -0
  294. package/dist/esm/cli/commands/impact.js +30 -0
  295. package/dist/esm/cli/commands/init.js +133 -0
  296. package/dist/esm/cli/commands/llm_health.js +19 -0
  297. package/dist/esm/cli/commands/plan.js +117 -0
  298. package/dist/esm/cli/commands/plan_crew.js +309 -0
  299. package/dist/esm/cli/commands/traceability.js +73 -0
  300. package/dist/esm/cli/commands/train.js +355 -0
  301. package/dist/esm/cli/defaults.js +165 -0
  302. package/dist/esm/cli/errors.js +52 -0
  303. package/dist/esm/cli/parse_args.js +251 -0
  304. package/dist/esm/cli/types.js +3 -0
  305. package/dist/esm/cli/usage.js +106 -0
  306. package/dist/esm/cli.js +192 -0
  307. package/dist/esm/crew/context.js +32 -0
  308. package/dist/esm/crew/orchestrator.js +325 -0
  309. package/dist/esm/crew/protocol.js +3 -0
  310. package/dist/esm/crew/provider.js +33 -0
  311. package/dist/esm/crew/sanitize.js +27 -0
  312. package/dist/esm/crew/types.js +3 -0
  313. package/dist/esm/crew/workflows.js +33 -0
  314. package/dist/esm/custom_provider.js +273 -0
  315. package/dist/esm/engine/ai_enrichment.js +264 -0
  316. package/dist/esm/engine/diff_loader.js +59 -0
  317. package/dist/esm/engine/impact_engine.js +291 -0
  318. package/dist/esm/engine/plan_builder.js +593 -0
  319. package/dist/esm/index.js +72 -0
  320. package/dist/esm/knowledge/api_surface.js +408 -0
  321. package/dist/esm/knowledge/cluster_utils.js +60 -0
  322. package/dist/esm/knowledge/context_loader.js +85 -0
  323. package/dist/esm/knowledge/failure_history.js +121 -0
  324. package/dist/esm/knowledge/kg_bridge.js +381 -0
  325. package/dist/esm/knowledge/kg_types.js +3 -0
  326. package/dist/esm/knowledge/route_families.js +393 -0
  327. package/dist/esm/knowledge/spec_index.js +122 -0
  328. package/dist/esm/logger.js +115 -0
  329. package/dist/esm/mcp-server.js +621 -0
  330. package/dist/esm/metrics/prometheus.js +149 -0
  331. package/dist/esm/model_router.js +59 -0
  332. package/dist/esm/ollama_provider.js +301 -0
  333. package/dist/esm/openai_provider.js +243 -0
  334. package/dist/esm/package.json +3 -0
  335. package/dist/esm/pipeline/orchestrator.js +228 -0
  336. package/dist/esm/pipeline/spec_verifier.js +75 -0
  337. package/dist/esm/pipeline/stage0_preprocess.js +102 -0
  338. package/dist/esm/pipeline/stage1_impact.js +140 -0
  339. package/dist/esm/pipeline/stage2_coverage.js +153 -0
  340. package/dist/esm/pipeline/stage3_generation.js +284 -0
  341. package/dist/esm/pipeline/stage4_heal.js +288 -0
  342. package/dist/esm/progress.js +112 -0
  343. package/dist/esm/prompts/coverage.js +57 -0
  344. package/dist/esm/prompts/cross-impact.js +53 -0
  345. package/dist/esm/prompts/generation.js +297 -0
  346. package/dist/esm/prompts/generation_profile.js +147 -0
  347. package/dist/esm/prompts/heal.js +91 -0
  348. package/dist/esm/prompts/impact.js +63 -0
  349. package/dist/esm/prompts/json_extract.js +36 -0
  350. package/dist/esm/prompts/strategist.js +61 -0
  351. package/dist/esm/prompts/test-designer.js +92 -0
  352. package/dist/esm/provider_factory.js +366 -0
  353. package/dist/esm/provider_interface.js +23 -0
  354. package/dist/esm/provider_utils.js +96 -0
  355. package/dist/esm/qa-agent/cli.js +205 -0
  356. package/dist/esm/qa-agent/orchestrator.js +120 -0
  357. package/dist/esm/qa-agent/phase1/runner.js +139 -0
  358. package/dist/esm/qa-agent/phase1/scope.js +126 -0
  359. package/dist/esm/qa-agent/phase2/agent_browser.js +95 -0
  360. package/dist/esm/qa-agent/phase2/agent_loop.js +351 -0
  361. package/dist/esm/qa-agent/phase2/exploration_state.js +97 -0
  362. package/dist/esm/qa-agent/phase2/tools.js +386 -0
  363. package/dist/esm/qa-agent/phase2/vision.js +75 -0
  364. package/dist/esm/qa-agent/phase3/feedback.js +34 -0
  365. package/dist/esm/qa-agent/phase3/reporter.js +145 -0
  366. package/dist/esm/qa-agent/phase3/spec_generator.js +62 -0
  367. package/dist/esm/qa-agent/phase3/verdict.js +66 -0
  368. package/dist/esm/qa-agent/safe_env.js +23 -0
  369. package/dist/esm/qa-agent/types.js +3 -0
  370. package/dist/esm/reporters/junit.js +86 -0
  371. package/dist/esm/reporters/reporter.js +3 -0
  372. package/dist/esm/reporters/sarif.js +132 -0
  373. package/dist/esm/resilience/circuit_breaker.js +78 -0
  374. package/dist/esm/resilience/retry.js +56 -0
  375. package/dist/esm/sanitize.js +66 -0
  376. package/dist/esm/training/enricher.js +345 -0
  377. package/dist/esm/training/kg_scanner.js +115 -0
  378. package/dist/esm/training/merger.js +204 -0
  379. package/dist/esm/training/scanner.js +923 -0
  380. package/dist/esm/training/types.js +6 -0
  381. package/dist/esm/training/validator.js +254 -0
  382. package/dist/esm/validation/guardrails.js +101 -0
  383. package/dist/esm/validation/output_schema.js +80 -0
  384. package/dist/esm/version.js +33 -0
  385. package/dist/index.d.ts +99 -0
  386. package/dist/index.d.ts.map +1 -0
  387. package/dist/index.js +169 -0
  388. package/dist/knowledge/api_surface.d.ts +37 -0
  389. package/dist/knowledge/api_surface.d.ts.map +1 -0
  390. package/dist/knowledge/api_surface.js +418 -0
  391. package/dist/knowledge/cluster_utils.d.ts +28 -0
  392. package/dist/knowledge/cluster_utils.d.ts.map +1 -0
  393. package/dist/knowledge/cluster_utils.js +67 -0
  394. package/dist/knowledge/context_loader.d.ts +13 -0
  395. package/dist/knowledge/context_loader.d.ts.map +1 -0
  396. package/dist/knowledge/context_loader.js +90 -0
  397. package/dist/knowledge/failure_history.d.ts +39 -0
  398. package/dist/knowledge/failure_history.d.ts.map +1 -0
  399. package/dist/knowledge/failure_history.js +128 -0
  400. package/dist/knowledge/kg_bridge.d.ts +31 -0
  401. package/dist/knowledge/kg_bridge.d.ts.map +1 -0
  402. package/dist/knowledge/kg_bridge.js +388 -0
  403. package/dist/knowledge/kg_types.d.ts +75 -0
  404. package/dist/knowledge/kg_types.d.ts.map +1 -0
  405. package/dist/knowledge/kg_types.js +4 -0
  406. package/dist/knowledge/route_families.d.ts +98 -0
  407. package/dist/knowledge/route_families.d.ts.map +1 -0
  408. package/dist/knowledge/route_families.js +410 -0
  409. package/dist/knowledge/spec_index.d.ts +18 -0
  410. package/dist/knowledge/spec_index.d.ts.map +1 -0
  411. package/dist/knowledge/spec_index.js +128 -0
  412. package/dist/logger.d.ts +31 -0
  413. package/dist/logger.d.ts.map +1 -0
  414. package/dist/logger.js +119 -0
  415. package/dist/mcp-server.d.ts +68 -0
  416. package/dist/mcp-server.d.ts.map +1 -0
  417. package/dist/mcp-server.js +629 -0
  418. package/dist/metrics/prometheus.d.ts +37 -0
  419. package/dist/metrics/prometheus.d.ts.map +1 -0
  420. package/dist/metrics/prometheus.js +153 -0
  421. package/dist/model_router.d.ts +28 -0
  422. package/dist/model_router.d.ts.map +1 -0
  423. package/dist/model_router.js +63 -0
  424. package/dist/ollama_provider.d.ts +65 -0
  425. package/dist/ollama_provider.d.ts.map +1 -0
  426. package/dist/ollama_provider.js +309 -0
  427. package/dist/openai_provider.d.ts +23 -0
  428. package/dist/openai_provider.d.ts.map +1 -0
  429. package/dist/openai_provider.js +251 -0
  430. package/dist/pipeline/orchestrator.d.ts +33 -0
  431. package/dist/pipeline/orchestrator.d.ts.map +1 -0
  432. package/dist/pipeline/orchestrator.js +231 -0
  433. package/dist/pipeline/spec_verifier.d.ts +20 -0
  434. package/dist/pipeline/spec_verifier.d.ts.map +1 -0
  435. package/dist/pipeline/spec_verifier.js +79 -0
  436. package/dist/pipeline/stage0_preprocess.d.ts +31 -0
  437. package/dist/pipeline/stage0_preprocess.d.ts.map +1 -0
  438. package/dist/pipeline/stage0_preprocess.js +105 -0
  439. package/dist/pipeline/stage1_impact.d.ts +19 -0
  440. package/dist/pipeline/stage1_impact.d.ts.map +1 -0
  441. package/dist/pipeline/stage1_impact.js +143 -0
  442. package/dist/pipeline/stage2_coverage.d.ts +19 -0
  443. package/dist/pipeline/stage2_coverage.d.ts.map +1 -0
  444. package/dist/pipeline/stage2_coverage.js +156 -0
  445. package/dist/pipeline/stage3_generation.d.ts +43 -0
  446. package/dist/pipeline/stage3_generation.d.ts.map +1 -0
  447. package/dist/pipeline/stage3_generation.js +287 -0
  448. package/dist/pipeline/stage4_heal.d.ts +62 -0
  449. package/dist/pipeline/stage4_heal.d.ts.map +1 -0
  450. package/dist/pipeline/stage4_heal.js +294 -0
  451. package/dist/progress.d.ts +22 -0
  452. package/dist/progress.d.ts.map +1 -0
  453. package/dist/progress.js +116 -0
  454. package/dist/prompts/coverage.d.ts +39 -0
  455. package/dist/prompts/coverage.d.ts.map +1 -0
  456. package/dist/prompts/coverage.js +61 -0
  457. package/dist/prompts/cross-impact.d.ts +23 -0
  458. package/dist/prompts/cross-impact.d.ts.map +1 -0
  459. package/dist/prompts/cross-impact.js +57 -0
  460. package/dist/prompts/generation.d.ts +25 -0
  461. package/dist/prompts/generation.d.ts.map +1 -0
  462. package/dist/prompts/generation.js +302 -0
  463. package/dist/prompts/generation_profile.d.ts +29 -0
  464. package/dist/prompts/generation_profile.d.ts.map +1 -0
  465. package/dist/prompts/generation_profile.js +151 -0
  466. package/dist/prompts/heal.d.ts +23 -0
  467. package/dist/prompts/heal.d.ts.map +1 -0
  468. package/dist/prompts/heal.js +95 -0
  469. package/dist/prompts/impact.d.ts +31 -0
  470. package/dist/prompts/impact.d.ts.map +1 -0
  471. package/dist/prompts/impact.js +67 -0
  472. package/dist/prompts/json_extract.d.ts +14 -0
  473. package/dist/prompts/json_extract.d.ts.map +1 -0
  474. package/dist/prompts/json_extract.js +39 -0
  475. package/dist/prompts/strategist.d.ts +25 -0
  476. package/dist/prompts/strategist.d.ts.map +1 -0
  477. package/dist/prompts/strategist.js +65 -0
  478. package/dist/prompts/test-designer.d.ts +35 -0
  479. package/dist/prompts/test-designer.d.ts.map +1 -0
  480. package/dist/prompts/test-designer.js +96 -0
  481. package/dist/provider_factory.d.ts +104 -0
  482. package/dist/provider_factory.d.ts.map +1 -0
  483. package/dist/provider_factory.js +371 -0
  484. package/dist/provider_interface.d.ts +365 -0
  485. package/dist/provider_interface.d.ts.map +1 -0
  486. package/dist/provider_interface.js +28 -0
  487. package/dist/provider_utils.d.ts +39 -0
  488. package/dist/provider_utils.d.ts.map +1 -0
  489. package/dist/provider_utils.js +103 -0
  490. package/dist/qa-agent/cli.d.ts +3 -0
  491. package/dist/qa-agent/cli.d.ts.map +1 -0
  492. package/dist/qa-agent/cli.js +207 -0
  493. package/dist/qa-agent/orchestrator.d.ts +3 -0
  494. package/dist/qa-agent/orchestrator.d.ts.map +1 -0
  495. package/dist/qa-agent/orchestrator.js +123 -0
  496. package/dist/qa-agent/phase1/runner.d.ts +3 -0
  497. package/dist/qa-agent/phase1/runner.d.ts.map +1 -0
  498. package/dist/qa-agent/phase1/runner.js +142 -0
  499. package/dist/qa-agent/phase1/scope.d.ts +6 -0
  500. package/dist/qa-agent/phase1/scope.d.ts.map +1 -0
  501. package/dist/qa-agent/phase1/scope.js +129 -0
  502. package/dist/qa-agent/phase2/agent_browser.d.ts +35 -0
  503. package/dist/qa-agent/phase2/agent_browser.d.ts.map +1 -0
  504. package/dist/qa-agent/phase2/agent_browser.js +99 -0
  505. package/dist/qa-agent/phase2/agent_loop.d.ts +3 -0
  506. package/dist/qa-agent/phase2/agent_loop.d.ts.map +1 -0
  507. package/dist/qa-agent/phase2/agent_loop.js +357 -0
  508. package/dist/qa-agent/phase2/exploration_state.d.ts +12 -0
  509. package/dist/qa-agent/phase2/exploration_state.d.ts.map +1 -0
  510. package/dist/qa-agent/phase2/exploration_state.js +109 -0
  511. package/dist/qa-agent/phase2/tools.d.ts +28 -0
  512. package/dist/qa-agent/phase2/tools.d.ts.map +1 -0
  513. package/dist/qa-agent/phase2/tools.js +390 -0
  514. package/dist/qa-agent/phase2/vision.d.ts +3 -0
  515. package/dist/qa-agent/phase2/vision.d.ts.map +1 -0
  516. package/dist/qa-agent/phase2/vision.js +78 -0
  517. package/dist/qa-agent/phase3/feedback.d.ts +3 -0
  518. package/dist/qa-agent/phase3/feedback.d.ts.map +1 -0
  519. package/dist/qa-agent/phase3/feedback.js +37 -0
  520. package/dist/qa-agent/phase3/reporter.d.ts +3 -0
  521. package/dist/qa-agent/phase3/reporter.d.ts.map +1 -0
  522. package/dist/qa-agent/phase3/reporter.js +148 -0
  523. package/dist/qa-agent/phase3/spec_generator.d.ts +3 -0
  524. package/dist/qa-agent/phase3/spec_generator.d.ts.map +1 -0
  525. package/dist/qa-agent/phase3/spec_generator.js +65 -0
  526. package/dist/qa-agent/phase3/verdict.d.ts +3 -0
  527. package/dist/qa-agent/phase3/verdict.d.ts.map +1 -0
  528. package/dist/qa-agent/phase3/verdict.js +69 -0
  529. package/dist/qa-agent/safe_env.d.ts +3 -0
  530. package/dist/qa-agent/safe_env.d.ts.map +1 -0
  531. package/dist/qa-agent/safe_env.js +26 -0
  532. package/dist/qa-agent/types.d.ts +130 -0
  533. package/dist/qa-agent/types.d.ts.map +1 -0
  534. package/dist/qa-agent/types.js +4 -0
  535. package/dist/reporters/junit.d.ts +6 -0
  536. package/dist/reporters/junit.d.ts.map +1 -0
  537. package/dist/reporters/junit.js +89 -0
  538. package/dist/reporters/reporter.d.ts +42 -0
  539. package/dist/reporters/reporter.d.ts.map +1 -0
  540. package/dist/reporters/reporter.js +4 -0
  541. package/dist/reporters/sarif.d.ts +7 -0
  542. package/dist/reporters/sarif.d.ts.map +1 -0
  543. package/dist/reporters/sarif.js +135 -0
  544. package/dist/resilience/circuit_breaker.d.ts +36 -0
  545. package/dist/resilience/circuit_breaker.d.ts.map +1 -0
  546. package/dist/resilience/circuit_breaker.js +82 -0
  547. package/dist/resilience/retry.d.ts +11 -0
  548. package/dist/resilience/retry.d.ts.map +1 -0
  549. package/dist/resilience/retry.js +59 -0
  550. package/dist/sanitize.d.ts +15 -0
  551. package/dist/sanitize.d.ts.map +1 -0
  552. package/dist/sanitize.js +71 -0
  553. package/dist/training/enricher.d.ts +17 -0
  554. package/dist/training/enricher.d.ts.map +1 -0
  555. package/dist/training/enricher.js +350 -0
  556. package/dist/training/kg_scanner.d.ts +13 -0
  557. package/dist/training/kg_scanner.d.ts.map +1 -0
  558. package/dist/training/kg_scanner.js +118 -0
  559. package/dist/training/merger.d.ts +15 -0
  560. package/dist/training/merger.d.ts.map +1 -0
  561. package/dist/training/merger.js +208 -0
  562. package/dist/training/scanner.d.ts +36 -0
  563. package/dist/training/scanner.d.ts.map +1 -0
  564. package/dist/training/scanner.js +932 -0
  565. package/dist/training/types.d.ts +117 -0
  566. package/dist/training/types.d.ts.map +1 -0
  567. package/dist/training/types.js +9 -0
  568. package/dist/training/validator.d.ts +21 -0
  569. package/dist/training/validator.d.ts.map +1 -0
  570. package/dist/training/validator.js +262 -0
  571. package/dist/validation/guardrails.d.ts +31 -0
  572. package/dist/validation/guardrails.d.ts.map +1 -0
  573. package/dist/validation/guardrails.js +112 -0
  574. package/dist/validation/output_schema.d.ts +67 -0
  575. package/dist/validation/output_schema.d.ts.map +1 -0
  576. package/dist/validation/output_schema.js +84 -0
  577. package/dist/version.d.ts +6 -0
  578. package/dist/version.d.ts.map +1 -0
  579. package/dist/version.js +36 -0
  580. package/package.json +126 -0
  581. package/schemas/flow-decision.schema.json +83 -0
  582. package/schemas/gap.schema.json +18 -0
  583. package/schemas/impact.schema.json +455 -0
  584. package/schemas/plan.schema.json +491 -0
  585. package/schemas/route-families.schema.json +137 -0
  586. package/schemas/subsystem-risk-map.schema.json +62 -0
  587. package/schemas/traceability-input.schema.json +122 -0
@@ -0,0 +1,410 @@
1
+ "use strict";
2
+ // Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
3
+ // See LICENSE.txt for license information.
4
+ Object.defineProperty(exports, "__esModule", { value: true });
5
+ exports.matchesGlob = matchesGlob;
6
+ exports.matchesAnyPattern = matchesAnyPattern;
7
+ exports.loadRouteFamilyManifest = loadRouteFamilyManifest;
8
+ exports.bindFilesToFamilies = bindFilesToFamilies;
9
+ exports.getFamilyById = getFamilyById;
10
+ exports.getFeatureById = getFeatureById;
11
+ exports.getSpecDirsForBinding = getSpecDirsForBinding;
12
+ exports.getCypressSpecDirsForBinding = getCypressSpecDirsForBinding;
13
+ exports.getPriorityForBinding = getPriorityForBinding;
14
+ exports.getUserFlowsForBinding = getUserFlowsForBinding;
15
+ exports.getRoutesForBinding = getRoutesForBinding;
16
+ exports.getAssertionPatternsForBinding = getAssertionPatternsForBinding;
17
+ exports.clearManifestCache = clearManifestCache;
18
+ exports.buildHeuristicFamilies = buildHeuristicFamilies;
19
+ exports.serializeManifest = serializeManifest;
20
+ const fs_1 = require("fs");
21
+ const path_1 = require("path");
22
+ const logger_js_1 = require("../logger.js");
23
+ const manifestCache = new Map();
24
+ function matchesGlob(filePath, pattern) {
25
+ const normalized = filePath.replace(/\\/g, '/');
26
+ const parts = pattern.replace(/\\/g, '/').split('*');
27
+ if (parts.length === 1) {
28
+ return normalized === parts[0] || normalized.startsWith(parts[0]);
29
+ }
30
+ let pos = 0;
31
+ for (let i = 0; i < parts.length; i++) {
32
+ const part = parts[i];
33
+ if (part === '') {
34
+ continue;
35
+ }
36
+ const idx = normalized.indexOf(part, pos);
37
+ if (idx < 0) {
38
+ return false;
39
+ }
40
+ if (i === 0 && idx !== 0) {
41
+ return false;
42
+ }
43
+ pos = idx + part.length;
44
+ }
45
+ return true;
46
+ }
47
+ function matchesAnyPattern(filePath, patterns) {
48
+ return patterns.some((pattern) => matchesGlob(filePath, pattern));
49
+ }
50
+ function validateApiEndpoint(ep) {
51
+ if (!ep || typeof ep !== 'object')
52
+ return null;
53
+ const obj = ep;
54
+ if (typeof obj.method !== 'string' || typeof obj.path !== 'string')
55
+ return null;
56
+ const result = { method: obj.method, path: obj.path };
57
+ if (typeof obj.description === 'string')
58
+ result.description = obj.description;
59
+ return result;
60
+ }
61
+ function validateFamily(family) {
62
+ if (!family || typeof family !== 'object') {
63
+ return null;
64
+ }
65
+ const obj = family;
66
+ if (typeof obj.id !== 'string' || !obj.id.trim()) {
67
+ return null;
68
+ }
69
+ // When testType is 'api', routes may contain API paths like "GET /api/users"
70
+ const testType = (obj.testType === 'ui' || obj.testType === 'api' || obj.testType === 'both')
71
+ ? obj.testType
72
+ : undefined;
73
+ if (!Array.isArray(obj.routes) || obj.routes.length === 0) {
74
+ return null;
75
+ }
76
+ const routes = obj.routes.filter((r) => typeof r === 'string');
77
+ if (routes.length === 0) {
78
+ return null;
79
+ }
80
+ const result = {
81
+ id: obj.id.trim(),
82
+ routes,
83
+ };
84
+ if (Array.isArray(obj.pageObjects)) {
85
+ result.pageObjects = obj.pageObjects.filter((v) => typeof v === 'string');
86
+ }
87
+ if (Array.isArray(obj.components)) {
88
+ result.components = obj.components.filter((v) => typeof v === 'string');
89
+ }
90
+ if (Array.isArray(obj.webappPaths)) {
91
+ result.webappPaths = obj.webappPaths.filter((v) => typeof v === 'string');
92
+ }
93
+ if (Array.isArray(obj.serverPaths)) {
94
+ result.serverPaths = obj.serverPaths.filter((v) => typeof v === 'string');
95
+ }
96
+ if (Array.isArray(obj.specDirs)) {
97
+ result.specDirs = obj.specDirs.filter((v) => typeof v === 'string');
98
+ }
99
+ if (Array.isArray(obj.cypressSpecDirs)) {
100
+ result.cypressSpecDirs = obj.cypressSpecDirs.filter((v) => typeof v === 'string');
101
+ }
102
+ if (Array.isArray(obj.tags)) {
103
+ result.tags = obj.tags.filter((v) => typeof v === 'string');
104
+ }
105
+ if (obj.priority === 'P0' || obj.priority === 'P1' || obj.priority === 'P2') {
106
+ result.priority = obj.priority;
107
+ }
108
+ if (Array.isArray(obj.userFlows)) {
109
+ result.userFlows = obj.userFlows.filter((v) => typeof v === 'string');
110
+ }
111
+ if (Array.isArray(obj.features)) {
112
+ result.features = obj.features
113
+ .map((f) => validateFeature(f))
114
+ .filter((f) => f !== null);
115
+ }
116
+ if (Array.isArray(obj.apiEndpoints)) {
117
+ const endpoints = obj.apiEndpoints
118
+ .map((ep) => validateApiEndpoint(ep))
119
+ .filter((ep) => ep !== null);
120
+ if (endpoints.length > 0)
121
+ result.apiEndpoints = endpoints;
122
+ }
123
+ if (testType) {
124
+ result.testType = testType;
125
+ }
126
+ if (Array.isArray(obj.assertionPatterns)) {
127
+ result.assertionPatterns = validateAssertionPatterns(obj.assertionPatterns);
128
+ }
129
+ return result;
130
+ }
131
+ const VALID_ASSERTION_TYPES = [
132
+ 'state-change', 'cross-user', 'persistence', 'negative',
133
+ 'permission', 'data-integrity', 'error-handling',
134
+ ];
135
+ function validateAssertionPatterns(patterns) {
136
+ return patterns
137
+ .filter((p) => p != null && typeof p === 'object')
138
+ .filter((p) => typeof p.type === 'string' && typeof p.pattern === 'string')
139
+ .filter((p) => VALID_ASSERTION_TYPES.includes(p.type))
140
+ .map((p) => ({ type: p.type, pattern: p.pattern }));
141
+ }
142
+ function validateFeature(feature) {
143
+ if (!feature || typeof feature !== 'object') {
144
+ return null;
145
+ }
146
+ const obj = feature;
147
+ if (typeof obj.id !== 'string' || !obj.id.trim()) {
148
+ return null;
149
+ }
150
+ const result = { id: obj.id.trim() };
151
+ if (Array.isArray(obj.routes)) {
152
+ result.routes = obj.routes.filter((v) => typeof v === 'string');
153
+ }
154
+ if (Array.isArray(obj.webappPaths)) {
155
+ result.webappPaths = obj.webappPaths.filter((v) => typeof v === 'string');
156
+ }
157
+ if (Array.isArray(obj.serverPaths)) {
158
+ result.serverPaths = obj.serverPaths.filter((v) => typeof v === 'string');
159
+ }
160
+ if (Array.isArray(obj.specDirs)) {
161
+ result.specDirs = obj.specDirs.filter((v) => typeof v === 'string');
162
+ }
163
+ if (Array.isArray(obj.cypressSpecDirs)) {
164
+ result.cypressSpecDirs = obj.cypressSpecDirs.filter((v) => typeof v === 'string');
165
+ }
166
+ if (Array.isArray(obj.tags)) {
167
+ result.tags = obj.tags.filter((v) => typeof v === 'string');
168
+ }
169
+ if (obj.priority === 'P0' || obj.priority === 'P1' || obj.priority === 'P2') {
170
+ result.priority = obj.priority;
171
+ }
172
+ if (Array.isArray(obj.userFlows)) {
173
+ result.userFlows = obj.userFlows.filter((v) => typeof v === 'string');
174
+ }
175
+ if (Array.isArray(obj.assertionPatterns)) {
176
+ result.assertionPatterns = validateAssertionPatterns(obj.assertionPatterns);
177
+ }
178
+ return result;
179
+ }
180
+ function loadRouteFamilyManifest(testsRoot, config) {
181
+ const candidates = [];
182
+ if (config?.manifestPath) {
183
+ candidates.push(config.manifestPath);
184
+ }
185
+ candidates.push((0, path_1.join)(testsRoot, '.e2e-ai-agents', 'route-families.json'));
186
+ for (const candidate of candidates) {
187
+ try {
188
+ if (!(0, fs_1.existsSync)(candidate)) {
189
+ continue;
190
+ }
191
+ const mtimeMs = (0, fs_1.statSync)(candidate).mtimeMs;
192
+ const cached = manifestCache.get(candidate);
193
+ if (cached && cached.mtimeMs === mtimeMs && cached.manifest) {
194
+ return cached.manifest;
195
+ }
196
+ const raw = JSON.parse((0, fs_1.readFileSync)(candidate, 'utf-8'));
197
+ if (!raw.families || !Array.isArray(raw.families)) {
198
+ manifestCache.set(candidate, { mtimeMs, manifest: null });
199
+ continue;
200
+ }
201
+ const families = raw.families
202
+ .map((f) => validateFamily(f))
203
+ .filter((f) => f !== null);
204
+ if (families.length === 0) {
205
+ manifestCache.set(candidate, { mtimeMs, manifest: null });
206
+ continue;
207
+ }
208
+ const manifest = { families, source: candidate };
209
+ manifestCache.set(candidate, { mtimeMs, manifest });
210
+ return manifest;
211
+ }
212
+ catch {
213
+ continue;
214
+ }
215
+ }
216
+ if (config?.strict) {
217
+ logger_js_1.logger.warn('Route family manifest not found. Create .e2e-ai-agents/route-families.json to enable family-level routing hints.');
218
+ }
219
+ return null;
220
+ }
221
+ function bindFilesToFamilies(changedFiles, manifest) {
222
+ return changedFiles.map((file) => {
223
+ const normalized = file.replace(/\\/g, '/');
224
+ const bindings = [];
225
+ for (const family of manifest.families) {
226
+ const featureBindings = [];
227
+ // Check feature-level first (more specific)
228
+ if (family.features) {
229
+ for (const feature of family.features) {
230
+ const featurePatterns = [
231
+ ...(feature.webappPaths || []),
232
+ ...(feature.serverPaths || []),
233
+ ...(feature.specDirs || []),
234
+ ];
235
+ if (featurePatterns.length > 0 && matchesAnyPattern(normalized, featurePatterns)) {
236
+ featureBindings.push({ family: family.id, feature: feature.id });
237
+ }
238
+ }
239
+ }
240
+ if (featureBindings.length > 0) {
241
+ bindings.push(...featureBindings);
242
+ continue;
243
+ }
244
+ // Fall back to family-level patterns
245
+ const familyPatterns = [
246
+ ...(family.webappPaths || []),
247
+ ...(family.serverPaths || []),
248
+ ...(family.specDirs || []),
249
+ ...(family.cypressSpecDirs || []),
250
+ ];
251
+ if (familyPatterns.length > 0 && matchesAnyPattern(normalized, familyPatterns)) {
252
+ bindings.push({ family: family.id });
253
+ }
254
+ }
255
+ return { file: normalized, bindings };
256
+ });
257
+ }
258
+ function getFamilyById(manifest, familyId) {
259
+ return manifest.families.find((f) => f.id === familyId);
260
+ }
261
+ function getFeatureById(family, featureId) {
262
+ return family.features?.find((f) => f.id === featureId);
263
+ }
264
+ function getSpecDirsForBinding(manifest, binding) {
265
+ const family = getFamilyById(manifest, binding.family);
266
+ if (!family) {
267
+ return [];
268
+ }
269
+ if (binding.feature) {
270
+ const feature = getFeatureById(family, binding.feature);
271
+ // An explicitly declared specDirs (even []) is intentional — don't fall back to family.
272
+ if (feature && feature.specDirs !== undefined) {
273
+ return feature.specDirs;
274
+ }
275
+ }
276
+ return family.specDirs || [];
277
+ }
278
+ function getCypressSpecDirsForBinding(manifest, binding) {
279
+ const family = getFamilyById(manifest, binding.family);
280
+ if (!family) {
281
+ return [];
282
+ }
283
+ if (binding.feature) {
284
+ const feature = getFeatureById(family, binding.feature);
285
+ // An explicitly declared cypressSpecDirs (even []) is intentional — don't fall back to family.
286
+ if (feature && feature.cypressSpecDirs !== undefined) {
287
+ return feature.cypressSpecDirs;
288
+ }
289
+ }
290
+ return family.cypressSpecDirs || [];
291
+ }
292
+ function getPriorityForBinding(manifest, binding) {
293
+ const family = getFamilyById(manifest, binding.family);
294
+ if (!family) {
295
+ return 'P2';
296
+ }
297
+ if (binding.feature) {
298
+ const feature = getFeatureById(family, binding.feature);
299
+ if (feature?.priority) {
300
+ return feature.priority;
301
+ }
302
+ }
303
+ return family.priority || 'P2';
304
+ }
305
+ function getUserFlowsForBinding(manifest, binding) {
306
+ const family = getFamilyById(manifest, binding.family);
307
+ if (!family) {
308
+ return [];
309
+ }
310
+ if (binding.feature) {
311
+ const feature = getFeatureById(family, binding.feature);
312
+ if (feature?.userFlows && feature.userFlows.length > 0) {
313
+ return feature.userFlows;
314
+ }
315
+ }
316
+ return family.userFlows || [];
317
+ }
318
+ function getRoutesForBinding(manifest, binding) {
319
+ const family = getFamilyById(manifest, binding.family);
320
+ if (!family) {
321
+ return [];
322
+ }
323
+ if (binding.feature) {
324
+ const feature = getFeatureById(family, binding.feature);
325
+ if (feature?.routes && feature.routes.length > 0) {
326
+ return feature.routes;
327
+ }
328
+ }
329
+ return family.routes;
330
+ }
331
+ function getAssertionPatternsForBinding(manifest, binding) {
332
+ const family = getFamilyById(manifest, binding.family);
333
+ if (!family) {
334
+ return [];
335
+ }
336
+ if (binding.feature) {
337
+ const feature = getFeatureById(family, binding.feature);
338
+ if (feature?.assertionPatterns && feature.assertionPatterns.length > 0) {
339
+ return feature.assertionPatterns;
340
+ }
341
+ }
342
+ return family.assertionPatterns || [];
343
+ }
344
+ function clearManifestCache() {
345
+ manifestCache.clear();
346
+ }
347
+ /**
348
+ * Build heuristic route families from changed files when no manifest exists.
349
+ * Groups files by their top-level directory to create rough family groupings.
350
+ * Results are lower confidence but allow analysis to proceed without training.
351
+ */
352
+ function buildHeuristicFamilies(changedFiles, testsRoot) {
353
+ const dirGroups = new Map();
354
+ for (const file of changedFiles) {
355
+ const normalized = file.replace(/\\/g, '/');
356
+ const parts = normalized.split('/');
357
+ // Use the first meaningful directory segment as the family ID
358
+ // Skip common prefixes like 'src/', 'app/', 'lib/'
359
+ const skipDirs = new Set(['src', 'app', 'lib', 'packages', 'components']);
360
+ let familyDir = parts[0] || 'root';
361
+ if (skipDirs.has(familyDir) && parts.length > 1) {
362
+ familyDir = parts[1];
363
+ }
364
+ // Normalize to a clean family name
365
+ familyDir = familyDir.replace(/\.[^.]+$/, ''); // strip file extensions for single files
366
+ if (!dirGroups.has(familyDir)) {
367
+ dirGroups.set(familyDir, []);
368
+ }
369
+ dirGroups.get(familyDir).push(normalized);
370
+ }
371
+ const families = [];
372
+ for (const [dir, files] of dirGroups) {
373
+ families.push({
374
+ id: dir,
375
+ routes: [`/${dir}`],
376
+ webappPaths: files.map((f) => `${f}*`),
377
+ });
378
+ }
379
+ logger_js_1.logger.info(`Built ${families.length} heuristic families from ${changedFiles.length} changed files (no route-families.json found)`);
380
+ logger_js_1.logger.info('Tip: Run `impact-gate train` to generate a proper route-families manifest for better accuracy.');
381
+ return {
382
+ families,
383
+ source: 'heuristic',
384
+ };
385
+ }
386
+ /**
387
+ * Serialize a RouteFamilyManifest to clean JSON, stripping empty optional fields.
388
+ */
389
+ function serializeManifest(manifest) {
390
+ const output = {
391
+ families: manifest.families.map((f) => {
392
+ const cleaned = { ...f };
393
+ const optionalArrays = [
394
+ 'pageObjects', 'components', 'webappPaths', 'serverPaths',
395
+ 'specDirs', 'cypressSpecDirs', 'tags', 'userFlows', 'features', 'apiEndpoints', 'assertionPatterns',
396
+ ];
397
+ for (const key of optionalArrays) {
398
+ if (!cleaned[key] || (Array.isArray(cleaned[key]) && cleaned[key].length === 0)) {
399
+ delete cleaned[key];
400
+ }
401
+ }
402
+ if (!cleaned.priority)
403
+ delete cleaned.priority;
404
+ if (!cleaned.testType)
405
+ delete cleaned.testType;
406
+ return cleaned;
407
+ }),
408
+ };
409
+ return JSON.stringify(output, null, 2) + '\n';
410
+ }
@@ -0,0 +1,18 @@
1
+ import type { RouteFamilyManifest } from './route_families.js';
2
+ export interface SpecEntry {
3
+ path: string;
4
+ relativePath: string;
5
+ testTitles: string[];
6
+ tags: string[];
7
+ familyId?: string;
8
+ featureId?: string;
9
+ }
10
+ export interface SpecIndex {
11
+ specs: SpecEntry[];
12
+ indexedAt: string;
13
+ }
14
+ export declare function buildSpecIndex(testsRoot: string, _specPatterns?: string[], manifest?: RouteFamilyManifest | null): SpecIndex;
15
+ export declare function getSpecsForFamily(index: SpecIndex, familyId: string, featureId?: string): SpecEntry[];
16
+ export declare function getSpecByPath(index: SpecIndex, relativePath: string): SpecEntry | undefined;
17
+ export declare function formatSpecsForPrompt(specs: SpecEntry[]): string;
18
+ //# sourceMappingURL=spec_index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"spec_index.d.ts","sourceRoot":"","sources":["../../src/knowledge/spec_index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,qBAAqB,CAAC;AAE7D,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACrB;AAwFD,wBAAgB,cAAc,CAC1B,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,MAAM,EAAE,EACxB,QAAQ,CAAC,EAAE,mBAAmB,GAAG,IAAI,GACtC,SAAS,CAcX;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAUrG;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE3F;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,CAQ/D"}
@@ -0,0 +1,128 @@
1
+ "use strict";
2
+ // Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
3
+ // See LICENSE.txt for license information.
4
+ Object.defineProperty(exports, "__esModule", { value: true });
5
+ exports.buildSpecIndex = buildSpecIndex;
6
+ exports.getSpecsForFamily = getSpecsForFamily;
7
+ exports.getSpecByPath = getSpecByPath;
8
+ exports.formatSpecsForPrompt = formatSpecsForPrompt;
9
+ const fs_1 = require("fs");
10
+ const path_1 = require("path");
11
+ function extractTestTitles(content) {
12
+ const titles = [];
13
+ const testRe = /\btest\s*\(\s*(['"`])((?:(?!\1).|\\.)*)\1/g;
14
+ let match;
15
+ while ((match = testRe.exec(content)) !== null) {
16
+ const title = match[2].trim();
17
+ if (title) {
18
+ titles.push(title);
19
+ }
20
+ }
21
+ return titles;
22
+ }
23
+ function extractTags(content) {
24
+ const tags = new Set();
25
+ const singleTagRe = /\btag:\s*['"`](@[\w-]+)['"`]/g;
26
+ let match;
27
+ while ((match = singleTagRe.exec(content)) !== null) {
28
+ tags.add(match[1]);
29
+ }
30
+ const arrayTagRe = /\btag:\s*\[([^\]]*)\]/g;
31
+ while ((match = arrayTagRe.exec(content)) !== null) {
32
+ const inner = match[1];
33
+ const tagRe = /['"`](@[\w-]+)['"`]/g;
34
+ let tagMatch;
35
+ while ((tagMatch = tagRe.exec(inner)) !== null) {
36
+ tags.add(tagMatch[1]);
37
+ }
38
+ }
39
+ return Array.from(tags);
40
+ }
41
+ function scanSpecDir(dir, testsRoot) {
42
+ const entries = [];
43
+ if (!(0, fs_1.existsSync)(dir)) {
44
+ return entries;
45
+ }
46
+ const items = (0, fs_1.readdirSync)(dir, { withFileTypes: true });
47
+ for (const item of items) {
48
+ const fullPath = (0, path_1.join)(dir, item.name);
49
+ if (item.isDirectory()) {
50
+ entries.push(...scanSpecDir(fullPath, testsRoot));
51
+ continue;
52
+ }
53
+ if (!item.name.endsWith('.spec.ts') && !item.name.endsWith('.spec.tsx')) {
54
+ continue;
55
+ }
56
+ try {
57
+ const content = (0, fs_1.readFileSync)(fullPath, 'utf-8');
58
+ entries.push({
59
+ path: fullPath,
60
+ relativePath: (0, path_1.relative)(testsRoot, fullPath).replace(/\\/g, '/'),
61
+ testTitles: extractTestTitles(content),
62
+ tags: extractTags(content),
63
+ });
64
+ }
65
+ catch {
66
+ continue;
67
+ }
68
+ }
69
+ return entries;
70
+ }
71
+ function bindSpecToFamily(spec, manifest) {
72
+ const specPath = spec.relativePath;
73
+ for (const family of manifest.families) {
74
+ if (family.features) {
75
+ for (const feature of family.features) {
76
+ if (feature.specDirs?.some((dir) => specPath.startsWith(dir))) {
77
+ spec.familyId = family.id;
78
+ spec.featureId = feature.id;
79
+ return;
80
+ }
81
+ }
82
+ }
83
+ if (family.specDirs?.some((dir) => specPath.startsWith(dir))) {
84
+ spec.familyId = family.id;
85
+ return;
86
+ }
87
+ if (family.tags && spec.tags.some((t) => family.tags.includes(t))) {
88
+ spec.familyId = family.id;
89
+ return;
90
+ }
91
+ }
92
+ }
93
+ function buildSpecIndex(testsRoot, _specPatterns, manifest) {
94
+ const specsDir = (0, path_1.join)(testsRoot, 'specs');
95
+ const specs = scanSpecDir(specsDir, testsRoot);
96
+ if (manifest) {
97
+ for (const spec of specs) {
98
+ bindSpecToFamily(spec, manifest);
99
+ }
100
+ }
101
+ return {
102
+ specs,
103
+ indexedAt: new Date().toISOString(),
104
+ };
105
+ }
106
+ function getSpecsForFamily(index, familyId, featureId) {
107
+ return index.specs.filter((s) => {
108
+ if (s.familyId !== familyId) {
109
+ return false;
110
+ }
111
+ if (featureId && s.featureId && s.featureId !== featureId) {
112
+ return false;
113
+ }
114
+ return true;
115
+ });
116
+ }
117
+ function getSpecByPath(index, relativePath) {
118
+ return index.specs.find((s) => s.relativePath === relativePath);
119
+ }
120
+ function formatSpecsForPrompt(specs) {
121
+ return specs
122
+ .map((s) => {
123
+ const titles = s.testTitles.map((t) => ` - ${t}`).join('\n');
124
+ const tagsStr = s.tags.length > 0 ? ` [${s.tags.join(', ')}]` : '';
125
+ return `${s.relativePath}${tagsStr}\n${titles}`;
126
+ })
127
+ .join('\n\n');
128
+ }
@@ -0,0 +1,31 @@
1
+ /**
2
+ * Structured logging system.
3
+ * Environment variable: LOG_LEVEL (ERROR, WARN, INFO, DEBUG)
4
+ */
5
+ export declare enum LogLevel {
6
+ ERROR = 0,
7
+ WARN = 1,
8
+ INFO = 2,
9
+ DEBUG = 3
10
+ }
11
+ export declare class Logger {
12
+ private level;
13
+ private jsonMode;
14
+ constructor(minLevel?: LogLevel);
15
+ error(message: string, context?: Record<string, unknown>): void;
16
+ warn(message: string, context?: Record<string, unknown>): void;
17
+ info(message: string, context?: Record<string, unknown>): void;
18
+ debug(message: string, context?: Record<string, unknown>): void;
19
+ setLevel(level: LogLevel): void;
20
+ setJsonMode(enabled: boolean): void;
21
+ /**
22
+ * Start a timer for measuring duration of an operation.
23
+ * Returns an object with `end()` that logs at DEBUG level and returns elapsed ms.
24
+ */
25
+ timer(label: string): {
26
+ end: () => number;
27
+ };
28
+ private log;
29
+ }
30
+ export declare const logger: Logger;
31
+ //# sourceMappingURL=logger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA;;;GAGG;AAEH,oBAAY,QAAQ;IAChB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACZ;AAqCD,qBAAa,MAAM;IACf,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,QAAQ,CAAU;gBAEd,QAAQ,CAAC,EAAE,QAAQ;IAK/B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM/D,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAInC;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG;QAAC,GAAG,EAAE,MAAM,MAAM,CAAA;KAAC;IAWzC,OAAO,CAAC,GAAG;CAoBd;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC"}