@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,313 @@
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.captureTraceabilityInput = captureTraceabilityInput;
6
+ const fs_1 = require("fs");
7
+ const path_1 = require("path");
8
+ const git_js_1 = require("./git.js");
9
+ const utils_js_1 = require("./utils.js");
10
+ function asRecord(value) {
11
+ if (!value || typeof value !== 'object' || Array.isArray(value)) {
12
+ return null;
13
+ }
14
+ return value;
15
+ }
16
+ function asArray(value) {
17
+ return Array.isArray(value) ? value : [];
18
+ }
19
+ function resolveFilePath(cwd, value) {
20
+ if ((0, path_1.isAbsolute)(value)) {
21
+ return value;
22
+ }
23
+ return (0, path_1.resolve)(cwd, value);
24
+ }
25
+ function normalizeList(values) {
26
+ return Array.from(new Set(values
27
+ .map((value) => (0, utils_js_1.normalizePath)(value))
28
+ .filter(Boolean)));
29
+ }
30
+ function parseStringArray(value) {
31
+ return normalizeList(asArray(value)
32
+ .filter((item) => typeof item === 'string')
33
+ .map((item) => item));
34
+ }
35
+ function isExecutedStatus(status) {
36
+ return status !== 'skipped';
37
+ }
38
+ function specExecuted(spec) {
39
+ const tests = asArray(spec.tests);
40
+ if (tests.length === 0) {
41
+ return false;
42
+ }
43
+ for (const testValue of tests) {
44
+ const testNode = asRecord(testValue);
45
+ if (!testNode) {
46
+ continue;
47
+ }
48
+ const testStatus = typeof testNode.status === 'string' ? testNode.status : undefined;
49
+ if (testStatus && isExecutedStatus(testStatus)) {
50
+ return true;
51
+ }
52
+ const outcome = typeof testNode.outcome === 'string' ? testNode.outcome : undefined;
53
+ if (outcome && isExecutedStatus(outcome)) {
54
+ return true;
55
+ }
56
+ const results = asArray(testNode.results);
57
+ for (const resultValue of results) {
58
+ const resultNode = asRecord(resultValue);
59
+ if (!resultNode) {
60
+ continue;
61
+ }
62
+ const status = typeof resultNode.status === 'string' ? resultNode.status : undefined;
63
+ if (status && isExecutedStatus(status)) {
64
+ return true;
65
+ }
66
+ }
67
+ }
68
+ return false;
69
+ }
70
+ function relativizePath(path, roots) {
71
+ const normalized = (0, utils_js_1.normalizePath)(path);
72
+ for (const root of roots) {
73
+ const normalizedRoot = (0, utils_js_1.normalizePath)((0, path_1.resolve)(root));
74
+ if (normalized === normalizedRoot) {
75
+ return '.';
76
+ }
77
+ if (normalized.startsWith(`${normalizedRoot}/`)) {
78
+ return normalized.slice(normalizedRoot.length + 1);
79
+ }
80
+ }
81
+ return normalized;
82
+ }
83
+ function collectExecutedSpecs(value, roots, output) {
84
+ const node = asRecord(value);
85
+ if (!node) {
86
+ return;
87
+ }
88
+ const specs = asArray(node.specs);
89
+ for (const specValue of specs) {
90
+ const specNode = asRecord(specValue);
91
+ if (!specNode) {
92
+ continue;
93
+ }
94
+ const file = typeof specNode.file === 'string' ? specNode.file : '';
95
+ if (!file) {
96
+ continue;
97
+ }
98
+ if (!specExecuted(specNode)) {
99
+ continue;
100
+ }
101
+ output.add(relativizePath(file, roots));
102
+ }
103
+ const suites = asArray(node.suites);
104
+ for (const suite of suites) {
105
+ collectExecutedSpecs(suite, roots, output);
106
+ }
107
+ }
108
+ function loadPlaywrightExecutedSpecs(reportPath, roots) {
109
+ const raw = JSON.parse((0, fs_1.readFileSync)(reportPath, 'utf-8'));
110
+ const specs = new Set();
111
+ collectExecutedSpecs(raw, roots, specs);
112
+ return Array.from(specs).sort();
113
+ }
114
+ function loadChangedFilesFromPath(filePath) {
115
+ const rawText = (0, fs_1.readFileSync)(filePath, 'utf-8');
116
+ const trimmed = rawText.trim();
117
+ if (!trimmed) {
118
+ return [];
119
+ }
120
+ if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
121
+ const parsed = JSON.parse(trimmed);
122
+ if (Array.isArray(parsed)) {
123
+ return normalizeList(parsed.filter((value) => typeof value === 'string'));
124
+ }
125
+ const node = asRecord(parsed);
126
+ if (!node) {
127
+ return [];
128
+ }
129
+ if (Array.isArray(node.files)) {
130
+ return normalizeList(node.files.filter((value) => typeof value === 'string'));
131
+ }
132
+ if (Array.isArray(node.changedFiles)) {
133
+ return normalizeList(node.changedFiles.filter((value) => typeof value === 'string'));
134
+ }
135
+ return [];
136
+ }
137
+ return normalizeList(rawText
138
+ .split('\n')
139
+ .map((line) => line.trim())
140
+ .filter(Boolean));
141
+ }
142
+ function addCoverageEntry(map, test, files) {
143
+ if (!test || files.length === 0) {
144
+ return;
145
+ }
146
+ const normalizedTest = (0, utils_js_1.normalizePath)(test);
147
+ if (!map.has(normalizedTest)) {
148
+ map.set(normalizedTest, new Set());
149
+ }
150
+ const bucket = map.get(normalizedTest);
151
+ for (const file of files) {
152
+ bucket?.add((0, utils_js_1.normalizePath)(file));
153
+ }
154
+ }
155
+ function loadCoverageMap(path) {
156
+ const raw = JSON.parse((0, fs_1.readFileSync)(path, 'utf-8'));
157
+ const map = new Map();
158
+ const appendTestEntry = (testValue, filesValue) => {
159
+ if (typeof testValue !== 'string') {
160
+ return;
161
+ }
162
+ const files = parseStringArray(filesValue);
163
+ addCoverageEntry(map, testValue, files);
164
+ };
165
+ if (Array.isArray(raw)) {
166
+ for (const entry of raw) {
167
+ const node = asRecord(entry);
168
+ if (!node) {
169
+ continue;
170
+ }
171
+ appendTestEntry(node.test, node.touchedFiles);
172
+ }
173
+ return map;
174
+ }
175
+ const node = asRecord(raw);
176
+ if (!node) {
177
+ return map;
178
+ }
179
+ for (const entry of asArray(node.tests)) {
180
+ const testNode = asRecord(entry);
181
+ if (!testNode) {
182
+ continue;
183
+ }
184
+ appendTestEntry(testNode.test, Array.isArray(testNode.touchedFiles) ? testNode.touchedFiles : testNode.files);
185
+ }
186
+ for (const entry of asArray(node.runs)) {
187
+ const runNode = asRecord(entry);
188
+ if (!runNode) {
189
+ continue;
190
+ }
191
+ const files = Array.isArray(runNode.touchedFiles)
192
+ ? runNode.touchedFiles
193
+ : (Array.isArray(runNode.coveredFiles) ? runNode.coveredFiles : runNode.files);
194
+ appendTestEntry(runNode.test, files);
195
+ }
196
+ const mappings = asArray(node.mappings);
197
+ for (const mapping of mappings) {
198
+ const mappingNode = asRecord(mapping);
199
+ if (!mappingNode || typeof mappingNode.file !== 'string' || !Array.isArray(mappingNode.tests)) {
200
+ continue;
201
+ }
202
+ const normalizedFile = (0, utils_js_1.normalizePath)(mappingNode.file);
203
+ for (const test of mappingNode.tests) {
204
+ if (typeof test !== 'string') {
205
+ continue;
206
+ }
207
+ addCoverageEntry(map, test, [normalizedFile]);
208
+ }
209
+ }
210
+ const fileToTests = asRecord(node.fileToTests);
211
+ if (fileToTests) {
212
+ for (const [file, tests] of Object.entries(fileToTests)) {
213
+ if (!Array.isArray(tests)) {
214
+ continue;
215
+ }
216
+ for (const test of tests) {
217
+ if (typeof test !== 'string') {
218
+ continue;
219
+ }
220
+ addCoverageEntry(map, test, [(0, utils_js_1.normalizePath)(file)]);
221
+ }
222
+ }
223
+ }
224
+ return map;
225
+ }
226
+ function coverageForSpec(specPath, coverageMap) {
227
+ const normalizedSpec = (0, utils_js_1.normalizePath)(specPath);
228
+ const files = new Set();
229
+ const direct = coverageMap.get(normalizedSpec);
230
+ if (direct) {
231
+ for (const file of direct) {
232
+ files.add(file);
233
+ }
234
+ }
235
+ const prefix = `${normalizedSpec}#`;
236
+ for (const [key, value] of coverageMap.entries()) {
237
+ if (key.startsWith(prefix)) {
238
+ for (const file of value) {
239
+ files.add(file);
240
+ }
241
+ }
242
+ }
243
+ return Array.from(files).sort();
244
+ }
245
+ function captureTraceabilityInput(options) {
246
+ const warnings = [];
247
+ const reportPath = resolveFilePath(process.cwd(), options.reportPath);
248
+ if (!(0, fs_1.existsSync)(reportPath)) {
249
+ throw new Error(`Traceability report not found: ${reportPath}`);
250
+ }
251
+ const roots = [options.testsRoot, options.appPath].map((root) => (0, path_1.resolve)(root));
252
+ const executedSpecs = loadPlaywrightExecutedSpecs(reportPath, roots);
253
+ if (executedSpecs.length === 0) {
254
+ warnings.push('No executed tests found in Playwright report.');
255
+ }
256
+ let changedFiles = [];
257
+ if (options.changedFilesPath) {
258
+ const changedPath = resolveFilePath(process.cwd(), options.changedFilesPath);
259
+ if ((0, fs_1.existsSync)(changedPath)) {
260
+ changedFiles = loadChangedFilesFromPath(changedPath);
261
+ }
262
+ else {
263
+ warnings.push(`Changed files path not found: ${changedPath}`);
264
+ }
265
+ }
266
+ else {
267
+ const diff = (0, git_js_1.getChangedFiles)(options.appPath, options.sinceRef, { includeUncommitted: false });
268
+ if (diff.error) {
269
+ warnings.push(`Git diff failed while building traceability input: ${diff.error}`);
270
+ }
271
+ changedFiles = diff.files;
272
+ }
273
+ changedFiles = normalizeList(changedFiles);
274
+ let coverageMap = new Map();
275
+ if (options.coverageMapPath) {
276
+ const coveragePath = resolveFilePath(process.cwd(), options.coverageMapPath);
277
+ if ((0, fs_1.existsSync)(coveragePath)) {
278
+ coverageMap = loadCoverageMap(coveragePath);
279
+ }
280
+ else {
281
+ warnings.push(`Coverage map path not found: ${coveragePath}`);
282
+ }
283
+ }
284
+ const runs = executedSpecs.map((spec) => {
285
+ const mappedFiles = coverageForSpec(spec, coverageMap);
286
+ const touchedFiles = mappedFiles.length > 0 ? mappedFiles : changedFiles;
287
+ return {
288
+ test: spec,
289
+ touchedFiles,
290
+ timestamp: new Date().toISOString(),
291
+ };
292
+ }).filter((entry) => entry.touchedFiles.length > 0);
293
+ if (runs.length < executedSpecs.length && changedFiles.length === 0) {
294
+ warnings.push('Some executed tests had no coverage-map entries and no changed-files fallback.');
295
+ }
296
+ const outputPath = options.outputPath
297
+ ? resolveFilePath(process.cwd(), options.outputPath)
298
+ : (0, path_1.resolve)(options.testsRoot, '.e2e-ai-agents', 'traceability-input.json');
299
+ (0, fs_1.mkdirSync)((0, path_1.dirname)(outputPath), { recursive: true });
300
+ (0, fs_1.writeFileSync)(outputPath, JSON.stringify({
301
+ schemaVersion: '1.0.0',
302
+ source: 'traceability-capture',
303
+ generatedAt: new Date().toISOString(),
304
+ runs,
305
+ }, null, 2), 'utf-8');
306
+ return {
307
+ outputPath,
308
+ testsSeen: executedSpecs.length,
309
+ runsGenerated: runs.length,
310
+ changedFilesUsed: changedFiles.length,
311
+ warnings,
312
+ };
313
+ }
@@ -0,0 +1,21 @@
1
+ import type { TraceabilityImpactConfig } from './config.js';
2
+ export interface TraceabilityIngestEntry {
3
+ test: string;
4
+ touchedFiles: string[];
5
+ timestamp?: string;
6
+ }
7
+ export interface TraceabilityIngestOptions {
8
+ minHits?: number;
9
+ maxFilesPerTest?: number;
10
+ maxAgeDays?: number;
11
+ }
12
+ export interface TraceabilityIngestResult {
13
+ manifestPath: string;
14
+ statePath: string;
15
+ entriesIngested: number;
16
+ testsTracked: number;
17
+ edgesTracked: number;
18
+ warnings: string[];
19
+ }
20
+ export declare function ingestTraceabilityInput(rootPath: string, traceabilityConfig: TraceabilityImpactConfig, inputPayload: unknown, options?: TraceabilityIngestOptions): TraceabilityIngestResult;
21
+ //# sourceMappingURL=traceability_ingest.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"traceability_ingest.d.ts","sourceRoot":"","sources":["../../src/agent/traceability_ingest.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,wBAAwB,EAAC,MAAM,aAAa,CAAC;AAG1D,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAgCD,MAAM,WAAW,wBAAwB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AA4MD,wBAAgB,uBAAuB,CACnC,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,wBAAwB,EAC5C,YAAY,EAAE,OAAO,EACrB,OAAO,CAAC,EAAE,yBAAyB,GACpC,wBAAwB,CAoE1B"}
@@ -0,0 +1,237 @@
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.ingestTraceabilityInput = ingestTraceabilityInput;
6
+ const fs_1 = require("fs");
7
+ const path_1 = require("path");
8
+ const utils_js_1 = require("./utils.js");
9
+ const DEFAULT_OPTIONS = {
10
+ minHits: 1,
11
+ maxFilesPerTest: 200,
12
+ maxAgeDays: 120,
13
+ };
14
+ function resolvePath(root, value) {
15
+ if ((0, path_1.isAbsolute)(value)) {
16
+ return value;
17
+ }
18
+ return (0, path_1.join)(root, value);
19
+ }
20
+ function parseDate(value) {
21
+ const parsed = Date.parse(value);
22
+ if (Number.isNaN(parsed)) {
23
+ return null;
24
+ }
25
+ return parsed;
26
+ }
27
+ function safeReadJson(path) {
28
+ if (!(0, fs_1.existsSync)(path)) {
29
+ return null;
30
+ }
31
+ try {
32
+ return JSON.parse((0, fs_1.readFileSync)(path, 'utf-8'));
33
+ }
34
+ catch {
35
+ return null;
36
+ }
37
+ }
38
+ function normalizeFiles(value) {
39
+ if (!Array.isArray(value)) {
40
+ return [];
41
+ }
42
+ return Array.from(new Set(value
43
+ .filter((entry) => typeof entry === 'string')
44
+ .map((entry) => (0, utils_js_1.normalizePath)(entry))));
45
+ }
46
+ function normalizeTest(value) {
47
+ if (typeof value !== 'string') {
48
+ return null;
49
+ }
50
+ const normalized = (0, utils_js_1.normalizePath)(value);
51
+ return normalized ? normalized : null;
52
+ }
53
+ function buildEntriesFromInput(payload) {
54
+ const warnings = [];
55
+ const entries = [];
56
+ const pushEntry = (testValue, filesValue, timestampValue) => {
57
+ const test = normalizeTest(testValue);
58
+ const files = normalizeFiles(filesValue);
59
+ if (!test || files.length === 0) {
60
+ return;
61
+ }
62
+ entries.push({
63
+ test,
64
+ touchedFiles: files,
65
+ timestamp: typeof timestampValue === 'string' ? timestampValue : undefined,
66
+ });
67
+ };
68
+ if (Array.isArray(payload)) {
69
+ for (const item of payload) {
70
+ if (!item || typeof item !== 'object') {
71
+ continue;
72
+ }
73
+ const entry = item;
74
+ pushEntry(entry.test, entry.touchedFiles, entry.timestamp);
75
+ }
76
+ if (entries.length === 0) {
77
+ warnings.push('Traceability input array had no valid entries.');
78
+ }
79
+ return { entries, warnings };
80
+ }
81
+ if (!payload || typeof payload !== 'object') {
82
+ warnings.push('Traceability input must be an object or array.');
83
+ return { entries, warnings };
84
+ }
85
+ const input = payload;
86
+ if (Array.isArray(input.tests)) {
87
+ for (const item of input.tests) {
88
+ pushEntry(item?.test, item?.touchedFiles, item?.timestamp);
89
+ }
90
+ }
91
+ if (Array.isArray(input.runs)) {
92
+ for (const item of input.runs) {
93
+ const files = Array.isArray(item?.touchedFiles) ? item?.touchedFiles : (Array.isArray(item?.coveredFiles) ? item?.coveredFiles : item?.files);
94
+ pushEntry(item?.test, files, item?.timestamp);
95
+ }
96
+ }
97
+ if (input.fileToTests && typeof input.fileToTests === 'object') {
98
+ for (const [file, tests] of Object.entries(input.fileToTests)) {
99
+ if (!Array.isArray(tests)) {
100
+ continue;
101
+ }
102
+ const normalizedFile = (0, utils_js_1.normalizePath)(file);
103
+ for (const test of tests) {
104
+ pushEntry(test, [normalizedFile]);
105
+ }
106
+ }
107
+ }
108
+ if (Array.isArray(input.mappings)) {
109
+ for (const mapping of input.mappings) {
110
+ const file = typeof mapping?.file === 'string' ? (0, utils_js_1.normalizePath)(mapping.file) : null;
111
+ if (!file || !Array.isArray(mapping.tests)) {
112
+ continue;
113
+ }
114
+ for (const test of mapping.tests) {
115
+ pushEntry(test, [file]);
116
+ }
117
+ }
118
+ }
119
+ if (entries.length === 0) {
120
+ warnings.push('Traceability input had no valid test<->file entries.');
121
+ }
122
+ return { entries, warnings };
123
+ }
124
+ function defaultState() {
125
+ return {
126
+ schemaVersion: '1.0.0',
127
+ updatedAt: new Date().toISOString(),
128
+ tests: {},
129
+ };
130
+ }
131
+ function loadState(path) {
132
+ const existing = safeReadJson(path);
133
+ if (!existing || typeof existing !== 'object' || !existing.tests) {
134
+ return defaultState();
135
+ }
136
+ return {
137
+ schemaVersion: '1.0.0',
138
+ updatedAt: existing.updatedAt || new Date().toISOString(),
139
+ tests: existing.tests,
140
+ };
141
+ }
142
+ function pruneByAge(state, maxAgeDays) {
143
+ const cutoff = Date.now() - maxAgeDays * 24 * 60 * 60 * 1000;
144
+ for (const [test, entry] of Object.entries(state.tests)) {
145
+ const lastSeen = parseDate(entry.lastSeen);
146
+ if (lastSeen === null) {
147
+ continue;
148
+ }
149
+ if (lastSeen < cutoff) {
150
+ delete state.tests[test];
151
+ }
152
+ }
153
+ }
154
+ function buildManifest(state, minHits, maxFilesPerTest) {
155
+ const tests = Object.entries(state.tests)
156
+ .map(([test, entry]) => {
157
+ const touchedFiles = Object.entries(entry.files)
158
+ .filter(([, hits]) => hits >= minHits)
159
+ .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
160
+ .slice(0, maxFilesPerTest)
161
+ .map(([file]) => file);
162
+ const signalCount = Object.values(entry.files).reduce((acc, value) => acc + value, 0);
163
+ return {
164
+ test,
165
+ touchedFiles,
166
+ signalCount,
167
+ lastSeen: entry.lastSeen,
168
+ };
169
+ })
170
+ .filter((entry) => entry.touchedFiles.length > 0)
171
+ .sort((a, b) => a.test.localeCompare(b.test));
172
+ return {
173
+ schemaVersion: '1.0.0',
174
+ generatedAt: new Date().toISOString(),
175
+ tests,
176
+ };
177
+ }
178
+ function ensureParent(path) {
179
+ (0, fs_1.mkdirSync)((0, path_1.dirname)(path), { recursive: true });
180
+ }
181
+ function ingestTraceabilityInput(rootPath, traceabilityConfig, inputPayload, options) {
182
+ const resolvedOptions = {
183
+ minHits: options?.minHits ?? DEFAULT_OPTIONS.minHits,
184
+ maxFilesPerTest: options?.maxFilesPerTest ?? DEFAULT_OPTIONS.maxFilesPerTest,
185
+ maxAgeDays: options?.maxAgeDays ?? DEFAULT_OPTIONS.maxAgeDays,
186
+ };
187
+ const warnings = [];
188
+ const manifestPath = resolvePath(rootPath, traceabilityConfig.manifestPath);
189
+ const statePath = (0, path_1.join)((0, path_1.dirname)(manifestPath), 'traceability-state.json');
190
+ if (!traceabilityConfig.enabled) {
191
+ warnings.push('Traceability is disabled in config. Input was not ingested.');
192
+ return {
193
+ manifestPath,
194
+ statePath,
195
+ entriesIngested: 0,
196
+ testsTracked: 0,
197
+ edgesTracked: 0,
198
+ warnings,
199
+ };
200
+ }
201
+ const parsed = buildEntriesFromInput(inputPayload);
202
+ warnings.push(...parsed.warnings);
203
+ const state = loadState(statePath);
204
+ const now = new Date().toISOString();
205
+ for (const entry of parsed.entries) {
206
+ const bucket = state.tests[entry.test] || {
207
+ files: {},
208
+ seenCount: 0,
209
+ lastSeen: now,
210
+ };
211
+ bucket.seenCount += 1;
212
+ bucket.lastSeen = entry.timestamp || now;
213
+ for (const file of entry.touchedFiles) {
214
+ bucket.files[file] = (bucket.files[file] || 0) + 1;
215
+ }
216
+ state.tests[entry.test] = bucket;
217
+ }
218
+ pruneByAge(state, Math.max(1, resolvedOptions.maxAgeDays));
219
+ state.updatedAt = now;
220
+ const manifest = buildManifest(state, Math.max(1, resolvedOptions.minHits), Math.max(1, resolvedOptions.maxFilesPerTest));
221
+ let edgesTracked = 0;
222
+ for (const entry of manifest.tests) {
223
+ edgesTracked += entry.touchedFiles.length;
224
+ }
225
+ ensureParent(statePath);
226
+ ensureParent(manifestPath);
227
+ (0, fs_1.writeFileSync)(statePath, JSON.stringify(state, null, 2), 'utf-8');
228
+ (0, fs_1.writeFileSync)(manifestPath, JSON.stringify(manifest, null, 2), 'utf-8');
229
+ return {
230
+ manifestPath,
231
+ statePath,
232
+ entriesIngested: parsed.entries.length,
233
+ testsTracked: manifest.tests.length,
234
+ edgesTracked,
235
+ warnings,
236
+ };
237
+ }
@@ -0,0 +1,42 @@
1
+ /**
2
+ * Shared types extracted from the legacy analysis module.
3
+ * Kept for backward compatibility with pipeline and plan systems.
4
+ */
5
+ import type { AudienceRole, FlagState } from './config.js';
6
+ export type FlowPriority = 'P0' | 'P1' | 'P2';
7
+ export type FlagSource = 'featureFlag' | 'configFlag' | 'testGate';
8
+ export interface FlagHit {
9
+ name: string;
10
+ source: FlagSource;
11
+ defaultState: FlagState;
12
+ }
13
+ export interface BlastRadius {
14
+ audience: AudienceRole[];
15
+ flags: FlagHit[];
16
+ summary: string;
17
+ scoreDelta: number;
18
+ }
19
+ export interface FlowImpact {
20
+ id: string;
21
+ name: string;
22
+ kind: 'screen' | 'flow';
23
+ score: number;
24
+ priority: FlowPriority;
25
+ reasons: string[];
26
+ keywords: string[];
27
+ files: string[];
28
+ audience?: AudienceRole[];
29
+ flags?: FlagHit[];
30
+ blastRadius?: BlastRadius;
31
+ priorityFloor?: FlowPriority;
32
+ subsystemRiskBoost?: number;
33
+ subsystemRiskRules?: string[];
34
+ existingTests?: string[];
35
+ missingScenarios?: string[];
36
+ }
37
+ export interface FlowCoverage {
38
+ flowId: string;
39
+ flowName: string;
40
+ coveredBy: string[];
41
+ }
42
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAGA;;;GAGG;AAEH,OAAO,KAAK,EAAC,YAAY,EAAE,SAAS,EAAC,MAAM,aAAa,CAAC;AAEzD,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,YAAY,GAAG,UAAU,CAAC;AAEnE,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;CACvB"}
@@ -0,0 +1,4 @@
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 });
@@ -0,0 +1,13 @@
1
+ export declare function hasGlobChars(value: string): boolean;
2
+ export declare function globToRegExp(pattern: string): RegExp;
3
+ export declare function matchGlob(pathValue: string, pattern: string): boolean;
4
+ export declare function safeReadTextFile(path: string): string | null;
5
+ export declare function normalizePath(pathValue: string): string;
6
+ export declare function toRelativePosix(root: string, filePath: string): string;
7
+ export declare function isPathWithinRoot(root: string, target: string): boolean;
8
+ export declare function fileExtension(pathValue: string): string;
9
+ export declare function baseNameWithoutExt(pathValue: string): string;
10
+ export declare function tokenize(value: string): string[];
11
+ export declare function uniqueTokens(tokens: string[]): string[];
12
+ export declare function titleCase(value: string): string;
13
+ //# sourceMappingURL=utils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/agent/utils.ts"],"names":[],"mappings":"AAuCA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA+BpD;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAWrE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU5D;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAKtE;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAI5D;AAMD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAUhD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEvD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM/C"}