qa360 2.1.7 → 2.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (909) hide show
  1. package/.BETA_TESTING_FEEDBACK.md +256 -0
  2. package/.claude/settings.local.json +154 -0
  3. package/.editorconfig +21 -0
  4. package/.github/CODEOWNERS +23 -0
  5. package/.github/ISSUE_TEMPLATE/bug_report.yml +108 -0
  6. package/.github/ISSUE_TEMPLATE/feedback_dx.yml +121 -0
  7. package/.github/dependabot.yml +35 -0
  8. package/.github/workflows/mcp-dx.yml +106 -0
  9. package/.github/workflows/release.yml +26 -0
  10. package/.github/workflows/test.yml +93 -0
  11. package/.nvmrc +1 -0
  12. package/.qa360/vault.db +0 -0
  13. package/.qa360/vault.db-shm +0 -0
  14. package/.qa360/vault.db-wal +0 -0
  15. package/.qa360-artifacts/.gitkeep +0 -0
  16. package/.qa360-artifacts/baselines/.gitkeep +0 -0
  17. package/.qa360-artifacts/cache/.gitkeep +0 -0
  18. package/.qa360-artifacts/reports/.gitkeep +0 -0
  19. package/.qa360-artifacts/screenshots/.gitkeep +0 -0
  20. package/.qa360-baselines/www_xyqo_ai.baseline.json +33 -0
  21. package/CHANGELOG.md +234 -0
  22. package/CODEOWNERS +43 -0
  23. package/CONTRIBUTING.md +273 -0
  24. package/NOVICE_USER_GUIDE.md +272 -0
  25. package/QUICK_START.md +191 -0
  26. package/README.md +191 -163
  27. package/adapters/README.md +46 -0
  28. package/check-branches.sh +32 -0
  29. package/cli/.qa360/keys/ed25519.key +1 -0
  30. package/cli/.qa360/keys/ed25519.pub +1 -0
  31. package/cli/CHANGELOG.md +84 -0
  32. package/cli/LICENSE +24 -0
  33. package/cli/README.md +222 -0
  34. package/cli/examples/README.md +160 -0
  35. package/cli/package.json +76 -0
  36. package/cli/scripts/bundle-for-npm.sh +51 -0
  37. package/cli/scripts/validate-package.js +116 -0
  38. package/cli/src/__tests__/commands/doctor.test.ts +108 -0
  39. package/cli/src/__tests__/index.test.ts +15 -0
  40. package/cli/src/cli-minimal.ts +44 -0
  41. package/cli/src/commands/__tests__/crawl.test.ts +412 -0
  42. package/cli/src/commands/__tests__/doctor-qa360-home.test.ts +156 -0
  43. package/cli/src/commands/__tests__/e2e-ui-tests.test.ts +494 -0
  44. package/cli/src/commands/__tests__/e2e.test.ts +187 -0
  45. package/cli/src/commands/__tests__/flakiness.test.ts +528 -0
  46. package/cli/src/commands/__tests__/generate.test.ts +507 -0
  47. package/cli/src/commands/__tests__/history.integration.test.ts +358 -0
  48. package/cli/src/commands/__tests__/history.test.ts +433 -0
  49. package/cli/src/commands/__tests__/monitor-realworld.test.ts +199 -0
  50. package/cli/src/commands/__tests__/monitor.test.ts +81 -0
  51. package/cli/src/commands/__tests__/ollama.test.ts +529 -0
  52. package/cli/src/commands/__tests__/repair.test.ts +225 -0
  53. package/cli/src/commands/__tests__/report.integration.test.ts +167 -0
  54. package/cli/src/commands/__tests__/report.test.ts +294 -0
  55. package/cli/src/commands/__tests__/report.vitest.ts +288 -0
  56. package/cli/src/commands/__tests__/retry.test.ts +78 -0
  57. package/cli/src/commands/__tests__/run.integration.test.ts +240 -0
  58. package/cli/src/commands/__tests__/run.test.ts +346 -0
  59. package/cli/src/commands/__tests__/run.vitest.ts +301 -0
  60. package/cli/src/commands/__tests__/secrets.test.ts +114 -0
  61. package/cli/src/commands/__tests__/serve.test.ts +80 -0
  62. package/cli/src/commands/__tests__/verify.test.ts +103 -0
  63. package/cli/src/commands/ai.ts +702 -0
  64. package/cli/src/commands/ask.ts +678 -0
  65. package/cli/src/commands/coverage.ts +305 -0
  66. package/cli/src/commands/crawl.ts +155 -0
  67. package/cli/src/commands/doctor.ts +610 -0
  68. package/cli/src/commands/examples.ts +248 -0
  69. package/cli/src/commands/explain.ts +710 -0
  70. package/cli/src/commands/flakiness.ts +560 -0
  71. package/cli/src/commands/generate.ts +566 -0
  72. package/cli/src/commands/history.ts +914 -0
  73. package/cli/src/commands/init.ts +777 -0
  74. package/cli/src/commands/monitor.ts +270 -0
  75. package/cli/src/commands/ollama.ts +337 -0
  76. package/cli/src/commands/pack.ts +497 -0
  77. package/cli/src/commands/regression.ts +400 -0
  78. package/cli/src/commands/repair.ts +356 -0
  79. package/cli/src/commands/report.ts +463 -0
  80. package/cli/src/commands/retry.ts +380 -0
  81. package/cli/src/commands/run.ts +220 -0
  82. package/cli/src/commands/scan.ts +177 -0
  83. package/cli/src/commands/secrets.ts +340 -0
  84. package/cli/src/commands/serve.ts +194 -0
  85. package/cli/src/commands/slo.ts +387 -0
  86. package/cli/src/commands/verify-temp-note.md +11 -0
  87. package/cli/src/commands/verify.ts +322 -0
  88. package/cli/src/generators/index.ts +6 -0
  89. package/cli/src/generators/json-reporter.ts +15 -0
  90. package/cli/src/generators/test-generator.ts +90 -0
  91. package/cli/src/index.ts +289 -0
  92. package/cli/src/scanners/dom-scanner.ts +360 -0
  93. package/cli/src/scanners/index.ts +5 -0
  94. package/cli/src/types/scan.ts +84 -0
  95. package/cli/src/utils/config.ts +145 -0
  96. package/cli/tsconfig.bundle.json +12 -0
  97. package/cli/tsconfig.json +23 -0
  98. package/cli/vitest.config.ts +59 -0
  99. package/core/LICENSE +24 -0
  100. package/core/README.md +64 -0
  101. package/core/package.json +81 -0
  102. package/core/src/__tests__/adapters-contract/adapters-contract.test.md +156 -0
  103. package/core/src/__tests__/index.test.ts +31 -0
  104. package/core/src/__tests__/integration/phase3.test.ts +405 -0
  105. package/core/src/__tests__/pack/validator.test.ts +312 -0
  106. package/core/src/__tests__/secrets/crypto.test.ts +190 -0
  107. package/core/src/__tests__/secrets/manager.test.ts +316 -0
  108. package/core/src/__tests__/security/redactor-phase3.test.ts +233 -0
  109. package/core/src/__tests__/serve/health-checker.test.ts +155 -0
  110. package/core/src/__tests__/serve/process-manager.test.ts +213 -0
  111. package/core/src/__tests__/serve/server.test.ts +103 -0
  112. package/core/src/__tests__/vault/cas.test.ts +178 -0
  113. package/core/src/__tests__/vault/vault.test.ts +296 -0
  114. package/core/src/adapters/__tests__/fixtures/jest-coverage.json +8 -0
  115. package/core/src/adapters/__tests__/fixtures/jest-results.json +41 -0
  116. package/core/src/adapters/__tests__/fixtures/pytest-junit.xml +16 -0
  117. package/core/src/adapters/__tests__/fixtures/vitest-coverage.json +8 -0
  118. package/core/src/adapters/__tests__/fixtures/vitest-results.json +50 -0
  119. package/core/src/adapters/__tests__/gitleaks-secrets.test.ts +452 -0
  120. package/core/src/adapters/__tests__/jest-adapter.test.ts +276 -0
  121. package/core/src/adapters/__tests__/k6-perf.test.ts +538 -0
  122. package/core/src/adapters/__tests__/osv-deps.test.ts +471 -0
  123. package/core/src/adapters/__tests__/playwright-native-api.test.ts +792 -0
  124. package/core/src/adapters/__tests__/playwright-ui-e2e.test.ts +431 -0
  125. package/core/src/adapters/__tests__/playwright-ui.test.ts +1073 -0
  126. package/core/src/adapters/__tests__/pytest-adapter.test.ts +207 -0
  127. package/core/src/adapters/__tests__/semgrep-sast.test.ts +436 -0
  128. package/core/src/adapters/__tests__/vitest-adapter.test.ts +208 -0
  129. package/core/src/adapters/__tests__/zap-dast.test.ts +453 -0
  130. package/core/src/adapters/gitleaks-secrets.ts +521 -0
  131. package/core/src/adapters/jest-adapter.ts +306 -0
  132. package/core/src/adapters/k6-perf.ts +479 -0
  133. package/core/src/adapters/osv-deps.ts +467 -0
  134. package/core/src/adapters/playwright-native-adapter.ts +472 -0
  135. package/core/src/adapters/playwright-native-api.ts +619 -0
  136. package/core/src/adapters/playwright-ui.ts +1088 -0
  137. package/core/src/adapters/pytest-adapter.ts +472 -0
  138. package/core/src/adapters/semgrep-sast.ts +410 -0
  139. package/core/src/adapters/unit-test-types.ts +106 -0
  140. package/core/src/adapters/vitest-adapter.ts +295 -0
  141. package/core/src/adapters/zap-dast.ts +551 -0
  142. package/core/src/ai/__tests__/deepseek-provider.test.ts +586 -0
  143. package/core/src/ai/__tests__/ollama-provider.test.ts +641 -0
  144. package/core/src/ai/anthropic-provider.ts +262 -0
  145. package/core/src/ai/deepseek-provider.ts +315 -0
  146. package/core/src/ai/index.ts +87 -0
  147. package/core/src/ai/llm-client.ts +52 -0
  148. package/core/src/ai/mock-provider.ts +146 -0
  149. package/core/src/ai/ollama-provider.ts +269 -0
  150. package/core/src/ai/openai-provider.ts +240 -0
  151. package/core/src/ai/provider-factory.ts +408 -0
  152. package/core/src/artifacts/README.md +78 -0
  153. package/core/src/artifacts/index.ts +16 -0
  154. package/core/src/artifacts/ui-artifacts.ts +412 -0
  155. package/core/src/assertions/__tests__/engine.test.ts +360 -0
  156. package/core/src/assertions/engine.ts +577 -0
  157. package/core/src/assertions/index.ts +13 -0
  158. package/core/src/assertions/types.ts +229 -0
  159. package/core/src/auth/__tests__/api-key-provider.test.ts +282 -0
  160. package/core/src/auth/__tests__/auth-manager.test.ts +430 -0
  161. package/core/src/auth/__tests__/basic-auth-provider.test.ts +364 -0
  162. package/core/src/auth/__tests__/cloud-providers.test.ts +751 -0
  163. package/core/src/auth/__tests__/jwt-provider.test.ts +400 -0
  164. package/core/src/auth/__tests__/oauth2-provider.test.ts +383 -0
  165. package/core/src/auth/__tests__/totp-provider.test.ts +294 -0
  166. package/core/src/auth/__tests__/ui-login-provider.test.ts +323 -0
  167. package/core/src/auth/api-key-provider.ts +75 -0
  168. package/core/src/auth/aws-iam-provider.ts +212 -0
  169. package/core/src/auth/azure-ad-provider.ts +126 -0
  170. package/core/src/auth/basic-auth-provider.ts +133 -0
  171. package/core/src/auth/gcp-adc-provider.ts +146 -0
  172. package/core/src/auth/index.ts +342 -0
  173. package/core/src/auth/jwt-provider.ts +193 -0
  174. package/core/src/auth/manager.ts +281 -0
  175. package/core/src/auth/oauth2-provider.ts +141 -0
  176. package/core/src/auth/totp-provider.ts +163 -0
  177. package/core/src/auth/ui-login-provider.ts +242 -0
  178. package/core/src/cache/__tests__/lru-cache.test.ts +564 -0
  179. package/core/src/cache/index.ts +13 -0
  180. package/core/src/cache/lru-cache.ts +536 -0
  181. package/core/src/crawler/__tests__/journey-generator.test.ts +344 -0
  182. package/core/src/crawler/__tests__/selector-generator.test.ts +211 -0
  183. package/core/src/crawler/index.ts +335 -0
  184. package/core/src/crawler/journey-generator.ts +471 -0
  185. package/core/src/crawler/page-analyzer.ts +857 -0
  186. package/core/src/crawler/selector-generator.ts +280 -0
  187. package/core/src/crawler/types.ts +475 -0
  188. package/core/src/dashboard/__tests__/real-world.test.ts +430 -0
  189. package/core/src/dashboard/__tests__/server.test.ts +283 -0
  190. package/core/src/dashboard/__tests__/types.test.ts +208 -0
  191. package/core/src/dashboard/assets.ts +692 -0
  192. package/core/src/dashboard/index.ts +17 -0
  193. package/core/src/dashboard/server.ts +401 -0
  194. package/core/src/dashboard/types.ts +78 -0
  195. package/core/src/discoverer/__tests__/test-discoverer.test.ts +444 -0
  196. package/core/src/discoverer/index.ts +374 -0
  197. package/core/src/fixtures/__tests__/loader.test.ts +246 -0
  198. package/core/src/fixtures/__tests__/resolver.test.ts +334 -0
  199. package/core/src/fixtures/index.ts +9 -0
  200. package/core/src/fixtures/loader.ts +200 -0
  201. package/core/src/fixtures/resolver.ts +221 -0
  202. package/core/src/fixtures/types.ts +86 -0
  203. package/core/src/flakiness/__tests__/flakiness.test.ts +554 -0
  204. package/core/src/flakiness/index.ts +536 -0
  205. package/core/src/generation/__tests__/code-formatter.test.ts +170 -0
  206. package/core/src/generation/__tests__/code-generator-contract.test.ts +207 -0
  207. package/core/src/generation/__tests__/code-generator.test.ts +586 -0
  208. package/core/src/generation/__tests__/crawler-pack-generator.test.ts +479 -0
  209. package/core/src/generation/__tests__/generation-e2e-b2bshop.test.ts +718 -0
  210. package/core/src/generation/__tests__/generation-integration.test.ts +655 -0
  211. package/core/src/generation/__tests__/pack-generator.test.ts +408 -0
  212. package/core/src/generation/__tests__/prompt-builder.test.ts +200 -0
  213. package/core/src/generation/__tests__/real-provider-integration.test.ts +414 -0
  214. package/core/src/generation/__tests__/source-analyzer.test.ts +774 -0
  215. package/core/src/generation/__tests__/test-optimizer.test.ts +255 -0
  216. package/core/src/generation/code-formatter.ts +408 -0
  217. package/core/src/generation/code-generator.ts +470 -0
  218. package/core/src/generation/crawler-pack-generator.ts +289 -0
  219. package/core/src/generation/generator.ts +113 -0
  220. package/core/src/generation/index.ts +59 -0
  221. package/core/src/generation/pack-generator.ts +527 -0
  222. package/core/src/generation/prompt-builder.ts +772 -0
  223. package/core/src/generation/source-analyzer.ts +830 -0
  224. package/core/src/generation/test-optimizer.ts +474 -0
  225. package/core/src/generation/types.ts +217 -0
  226. package/core/src/hooks/__tests__/compose.test.ts +636 -0
  227. package/core/src/hooks/__tests__/runner.test.ts +478 -0
  228. package/core/src/hooks/compose.ts +268 -0
  229. package/core/src/hooks/runner.ts +364 -0
  230. package/core/src/index.ts +255 -0
  231. package/core/src/pack/__tests__/migrator.test.ts +594 -0
  232. package/core/src/pack/__tests__/validator.test.ts +759 -0
  233. package/core/src/pack/migrator.ts +353 -0
  234. package/core/src/pack/validator.ts +359 -0
  235. package/core/src/pack-v2/__tests__/loader.test.ts +533 -0
  236. package/core/src/pack-v2/__tests__/migrator.test.ts +455 -0
  237. package/core/src/pack-v2/__tests__/validator.test.ts +609 -0
  238. package/core/src/pack-v2/index.ts +41 -0
  239. package/core/src/pack-v2/loader.ts +358 -0
  240. package/core/src/pack-v2/migrator.ts +540 -0
  241. package/core/src/pack-v2/validator.ts +731 -0
  242. package/core/src/parallel/README.md +143 -0
  243. package/core/src/parallel/index.ts +16 -0
  244. package/core/src/parallel/parallel-runner.ts +282 -0
  245. package/core/src/pom/__tests__/loader.test.ts +378 -0
  246. package/core/src/pom/base-page.ts +425 -0
  247. package/core/src/pom/index.ts +45 -0
  248. package/core/src/pom/loader.ts +480 -0
  249. package/core/src/pom/types.ts +146 -0
  250. package/core/src/proof/__tests__/proof-roundtrip.test.ts +149 -0
  251. package/core/src/proof/__tests__/schema-validation-manual.mjs +211 -0
  252. package/core/src/proof/__tests__/schema-validation.test.ts +336 -0
  253. package/core/src/proof/__tests__/signer.test.ts +486 -0
  254. package/core/src/proof/__tests__/temporal-regression.test.ts +537 -0
  255. package/core/src/proof/__tests__/verifier-advanced.test.ts +588 -0
  256. package/core/src/proof/__tests__/verifier.test.ts +413 -0
  257. package/core/src/proof/bundle.ts +290 -0
  258. package/core/src/proof/canonicalize.ts +116 -0
  259. package/core/src/proof/index.ts +74 -0
  260. package/core/src/proof/schema.ts +285 -0
  261. package/core/src/proof/signer.ts +293 -0
  262. package/core/src/proof/verifier.ts +380 -0
  263. package/core/src/regression/__tests__/detector.test.ts +396 -0
  264. package/core/src/regression/__tests__/trend-analyzer.test.ts +300 -0
  265. package/core/src/regression/detector.ts +629 -0
  266. package/core/src/regression/index.ts +34 -0
  267. package/core/src/regression/trend-analyzer.ts +468 -0
  268. package/core/src/regression/types.ts +295 -0
  269. package/core/src/regression/vault.ts +419 -0
  270. package/core/src/repair/__tests__/repairer.test.ts +572 -0
  271. package/core/src/repair/__tests__/types.test.ts +302 -0
  272. package/core/src/repair/engine/__tests__/fixer.test.ts +482 -0
  273. package/core/src/repair/engine/__tests__/suggestion-engine.test.ts +395 -0
  274. package/core/src/repair/engine/fixer.ts +271 -0
  275. package/core/src/repair/engine/suggestion-engine.ts +234 -0
  276. package/core/src/repair/index.ts +53 -0
  277. package/core/src/repair/repairer.ts +376 -0
  278. package/core/src/repair/types.ts +119 -0
  279. package/core/src/repair/utils/__tests__/error-analyzer.test.ts +454 -0
  280. package/core/src/repair/utils/error-analyzer.ts +308 -0
  281. package/core/src/reporting/README.md +144 -0
  282. package/core/src/reporting/html-reporter.ts +835 -0
  283. package/core/src/reporting/index.ts +16 -0
  284. package/core/src/retry/README.md +192 -0
  285. package/core/src/retry/__tests__/flakiness-integration.test.ts +475 -0
  286. package/core/src/retry/__tests__/retry-engine.test.ts +424 -0
  287. package/core/src/retry/flakiness-integration.ts +267 -0
  288. package/core/src/retry/index.ts +48 -0
  289. package/core/src/retry/retry-engine.ts +368 -0
  290. package/core/src/retry/types.ts +208 -0
  291. package/core/src/retry/vault.ts +413 -0
  292. package/core/src/runner/__tests__/flakiness-integration.test.ts +566 -0
  293. package/core/src/runner/__tests__/phase3-e2e-b2bshop.test.ts +218 -0
  294. package/core/src/runner/__tests__/phase3-e2e-reqres.test.ts +199 -0
  295. package/core/src/runner/__tests__/phase3-runner.test.ts +1118 -0
  296. package/core/src/runner/e2e-helpers.ts +216 -0
  297. package/core/src/runner/phase3-runner.ts +1536 -0
  298. package/core/src/schemas/gherkin-report.json +122 -0
  299. package/core/src/secrets/__tests__/crypto.test.ts +180 -0
  300. package/core/src/secrets/crypto.ts +289 -0
  301. package/core/src/secrets/manager.ts +272 -0
  302. package/core/src/security/__tests__/hardening.test.ts +480 -0
  303. package/core/src/security/redaction-patterns-extended.ts +278 -0
  304. package/core/src/security/redactor.ts +326 -0
  305. package/core/src/self-healing/assertion-healer.ts +485 -0
  306. package/core/src/self-healing/engine.ts +626 -0
  307. package/core/src/self-healing/index.ts +33 -0
  308. package/core/src/self-healing/selector-healer.ts +488 -0
  309. package/core/src/self-healing/types.ts +193 -0
  310. package/core/src/serve/diagnostics-collector.ts +201 -0
  311. package/core/src/serve/health-checker.ts +274 -0
  312. package/core/src/serve/index.ts +9 -0
  313. package/core/src/serve/metrics-collector.ts +386 -0
  314. package/core/src/serve/process-manager.ts +265 -0
  315. package/core/src/serve/server.ts +230 -0
  316. package/core/src/slo/config.ts +408 -0
  317. package/core/src/slo/index.ts +68 -0
  318. package/core/src/slo/sli-calculator.ts +474 -0
  319. package/core/src/slo/slo-tracker.ts +481 -0
  320. package/core/src/slo/types.ts +408 -0
  321. package/core/src/slo/vault.ts +600 -0
  322. package/core/src/tui/__tests__/monitor.test.ts +336 -0
  323. package/core/src/tui/__tests__/real-world.test.ts +376 -0
  324. package/core/src/tui/__tests__/renderer.test.ts +201 -0
  325. package/core/src/tui/__tests__/types.test.ts +295 -0
  326. package/core/src/tui/index.ts +19 -0
  327. package/core/src/tui/monitor.ts +331 -0
  328. package/core/src/tui/renderer.ts +269 -0
  329. package/core/src/tui/types.ts +68 -0
  330. package/core/src/types/pack-v1.ts +305 -0
  331. package/core/src/types/pack-v2.ts +525 -0
  332. package/core/src/types/trust-score.ts +258 -0
  333. package/core/src/vault/__tests__/flakiness-vault.test.ts +562 -0
  334. package/core/src/vault/__tests__/vault.test.ts +259 -0
  335. package/core/src/vault/cas.ts +323 -0
  336. package/core/src/vault/index.ts +1361 -0
  337. package/core/src/vault/schema.sql +168 -0
  338. package/core/src/visual/README.md +185 -0
  339. package/core/src/visual/index.ts +14 -0
  340. package/core/src/visual/visual-regression.ts +347 -0
  341. package/core/src/watch/__tests__/watch-mode.test.ts +192 -0
  342. package/core/src/watch/index.ts +14 -0
  343. package/core/src/watch/watch-mode.ts +565 -0
  344. package/core/tsconfig.json +12 -0
  345. package/core/vitest.config.ts +52 -0
  346. package/docs/ARCHITECTURE.md +901 -0
  347. package/docs/AUDIT-GLOBAL-DEC2025.md +271 -0
  348. package/docs/BETA_TESTING.md +257 -0
  349. package/docs/BETA_TESTING_PLAN.md +727 -0
  350. package/docs/CERTIFICATION-REPORT.md +142 -0
  351. package/docs/COMPLETE_AUDIT_REFACTORING.md +965 -0
  352. package/docs/DEVELOPMENT.md +545 -0
  353. package/docs/DEVELOPMENT_HISTORY.md +345 -0
  354. package/docs/LIMITATIONS.md +176 -0
  355. package/docs/MIGRATION.md +303 -0
  356. package/docs/OPTION_3_4_EXPLORATION.md +1257 -0
  357. package/docs/PHASE1_PERFORMANCE.md +144 -0
  358. package/docs/QA360_Cloud.postman_collection.json +89 -0
  359. package/docs/QA360_TESTING_PHILOSOPHY.md +769 -0
  360. package/docs/QA_TEST_PLAN.md +727 -0
  361. package/docs/README.md +50 -0
  362. package/docs/STATUS.md +198 -0
  363. package/docs/STRATEGIC_STUDY_GOOSE_INTEGRATION.md +615 -0
  364. package/docs/USER_GUIDE.md +687 -0
  365. package/docs/WORK-DONE-ADAPTER-TESTS.md +136 -0
  366. package/docs/adapters-security.md +485 -0
  367. package/docs/architecture-diagram.mmd +168 -0
  368. package/docs/archive/ARCH-01-DAY6-BUILD-FIXES.md +396 -0
  369. package/docs/archive/ARCH-01-DAY6-FINAL-STATUS.md +324 -0
  370. package/docs/archive/ARCH-01_MCP_MERGE_ANALYSIS.md +644 -0
  371. package/docs/archive/ARCH-01_NEXT_STEPS.md +60 -0
  372. package/docs/archive/BRANCH_PROTECTION.md +183 -0
  373. package/docs/archive/CI_LOCKDOWN_CHECKLIST.md +222 -0
  374. package/docs/archive/HANDOFF_TEST-01.md +669 -0
  375. package/docs/archive/LEGAL_READY_PLACEHOLDERS.md +372 -0
  376. package/docs/archive/NODE_UPGRADE_GUIDE.md +188 -0
  377. package/docs/archive/PHASE1_COMPLETION.md +386 -0
  378. package/docs/archive/PHASE2_COMPLETION.md +404 -0
  379. package/docs/archive/PHASE3_AND_4_FINAL.md +360 -0
  380. package/docs/archive/PHASE3_COMPLETE.md +301 -0
  381. package/docs/archive/PHASE3_STATUS.md +255 -0
  382. package/docs/archive/PRE-WEEK2-AUDIT.md +364 -0
  383. package/docs/archive/README.md +16 -0
  384. package/docs/archive/SCHEMA_AJV_2020_FIX.md +245 -0
  385. package/docs/archive/TEST-01_AUDIT_REPORT.md +240 -0
  386. package/docs/archive/TEST-01_COVERAGE_PLAN.md +423 -0
  387. package/docs/archive/obsolete-proposals/dom-element-discovery-mode.md +250 -0
  388. package/docs/archive/obsolete-proposals/qa360-comprehensive-test-plan.md +1249 -0
  389. package/docs/archive/obsolete-proposals/qa360-quick-start-guide.md +298 -0
  390. package/docs/archive/obsolete-proposals/technical-plan-dom-discovery.md +870 -0
  391. package/docs/budgets-advanced.md +308 -0
  392. package/docs/examples/history-export-gc.md +285 -0
  393. package/docs/examples/pack-v2-complete.yaml +158 -0
  394. package/docs/examples/pack-v2-quickstart.yaml +24 -0
  395. package/docs/examples/pack-v2-ui-login.yaml +81 -0
  396. package/docs/examples/qa360-report.json +50 -0
  397. package/docs/history.md +565 -0
  398. package/docs/hooks.md +304 -0
  399. package/docs/llm-providers.md +512 -0
  400. package/docs/mcp-server.md +651 -0
  401. package/docs/mcp-tools.md +1131 -0
  402. package/docs/pack-v1.md +383 -0
  403. package/docs/pack-v2.md +558 -0
  404. package/docs/page-objects.md +366 -0
  405. package/docs/proofs.md +670 -0
  406. package/docs/quickstart-5min.md +257 -0
  407. package/docs/readiness-ci.md +654 -0
  408. package/docs/rfc/README.md +20 -0
  409. package/docs/rfc/proof-bundle-v1.md +787 -0
  410. package/docs/secrets.md +392 -0
  411. package/docs/serve.md +494 -0
  412. package/docs/unit-test-adapters.md +168 -0
  413. package/docs/vault.md +491 -0
  414. package/e2e/qa360-e2e.test.ts +696 -0
  415. package/e2e/vitest.config.ts +18 -0
  416. package/examples/README.md +30 -140
  417. package/examples/ci/docker-compose-serve.yml +375 -0
  418. package/examples/ci/github-actions-serve.yml +345 -0
  419. package/examples/ci/gitlab-ci-serve.yml +407 -0
  420. package/examples/datasets/README.md +101 -0
  421. package/examples/datasets/b2bshop.ts +155 -0
  422. package/examples/datasets/index.ts +57 -0
  423. package/examples/datasets/reqres.ts +195 -0
  424. package/examples/fixtures-demo/fixtures/users.yml +39 -0
  425. package/examples/fixtures-demo/pack.yml +71 -0
  426. package/examples/future-api/README.md +16 -0
  427. package/examples/future-api/diag.js +7 -0
  428. package/examples/future-api/health.js +4 -0
  429. package/examples/future-api/packs.js +13 -0
  430. package/examples/future-api/runpack.js +10 -0
  431. package/examples/generation/README.md +148 -0
  432. package/examples/generation/pack-generator-example.js +115 -0
  433. package/examples/generation/source-analyzer-example.js +115 -0
  434. package/examples/httpbin/pack.yml +59 -0
  435. package/examples/load-testing/mcp-load.yml +115 -0
  436. package/examples/load-testing/mcp-stdio.yml +95 -0
  437. package/examples/mcp/claude-desktop-config.json +33 -0
  438. package/examples/mcp/claude-desktop.json +16 -0
  439. package/examples/mcp/conversation-sample.md +131 -0
  440. package/examples/mcp/demo-60s.md +330 -0
  441. package/examples/mcp/sample-conversation.jsonl +21 -0
  442. package/examples/mcp/vscode-settings.json +22 -0
  443. package/examples/pack-v2-complete.yml +242 -0
  444. package/examples/pack-v2-examples.md +244 -0
  445. package/examples/pack-v2-quickstart.yml +55 -0
  446. package/examples/packs-business/ecommerce-api.yml +121 -0
  447. package/examples/packs-business/saas-dashboard-ui.yml +133 -0
  448. package/examples/packs-conformance/compose-multi.yml +174 -0
  449. package/examples/packs-conformance/full.yml +152 -0
  450. package/examples/packs-conformance/heavy-artifacts.yml +152 -0
  451. package/examples/packs-conformance/minimal.yml +71 -0
  452. package/examples/packs-conformance/secrets-missing.yml +97 -0
  453. package/examples/packs-conformance/timeouts.yml +77 -0
  454. package/examples/pom-demo/README.md +104 -0
  455. package/examples/pom-demo/pack.yml +60 -0
  456. package/examples/pom-demo/pages/DashboardPage.page.ts +73 -0
  457. package/examples/pom-demo/pages/LoginPage.page.ts +76 -0
  458. package/examples/proofs/e2e-playwright-proof.json +75 -0
  459. package/examples/proofs/httpbin-proof.json +69 -0
  460. package/examples/proofs/multi-adapter-proof.json +117 -0
  461. package/examples/proofs/test-proof.json +26 -0
  462. package/examples/restful-api-dev/README.md +102 -0
  463. package/examples/restful-api-dev/restful-api-advanced.yml +29 -0
  464. package/examples/restful-api-dev/restful-api-basic.yml +29 -0
  465. package/examples/web-lite/.github/workflows/qa360-phase3.yml +73 -0
  466. package/examples/web-lite/api-mock/server.js +258 -0
  467. package/examples/web-lite/pack.yml +71 -0
  468. package/examples/web-lite/services.yml +43 -0
  469. package/examples/web-lite/web-content/healthz +1 -0
  470. package/examples/web-lite/web-content/index.html +259 -0
  471. package/package.json +56 -45
  472. package/packages/mcp/CHANGELOG.md +109 -0
  473. package/packages/mcp/IMPLEMENTATION_SUMMARY.md +350 -0
  474. package/packages/mcp/LICENSE +21 -0
  475. package/packages/mcp/QUICK_START.md +291 -0
  476. package/packages/mcp/README.md +294 -0
  477. package/packages/mcp/TELEMETRY.md +220 -0
  478. package/packages/mcp/package.json +91 -0
  479. package/packages/mcp/scripts/generate-sbom-fallback.cjs +84 -0
  480. package/packages/mcp/scripts/safe-postinstall.cjs +32 -0
  481. package/packages/mcp/src/__tests__/contract.test.ts +902 -0
  482. package/packages/mcp/src/cli/cli.ts +137 -0
  483. package/packages/mcp/src/cli/doctor.ts +286 -0
  484. package/packages/mcp/src/cli/fix.ts +99 -0
  485. package/packages/mcp/src/cli/init.ts +233 -0
  486. package/packages/mcp/src/cli/postinstall.ts +14 -0
  487. package/packages/mcp/src/cli/reset.ts +44 -0
  488. package/packages/mcp/src/cli/telemetry.ts +166 -0
  489. package/packages/mcp/src/cli/test-dx.ts +94 -0
  490. package/packages/mcp/src/cli/uninstall.ts +80 -0
  491. package/packages/mcp/src/cli/up.ts +178 -0
  492. package/packages/mcp/src/index.ts +12 -0
  493. package/packages/mcp/src/scripts/e2e-local.ts +337 -0
  494. package/packages/mcp/src/scripts/verify-settings.ts +242 -0
  495. package/packages/mcp/src/security/audit.ts +244 -0
  496. package/packages/mcp/src/security/manager.ts +242 -0
  497. package/packages/mcp/src/server/full-server.ts +212 -0
  498. package/packages/mcp/src/server/minimal-server.ts +134 -0
  499. package/packages/mcp/src/tools/history.ts +388 -0
  500. package/packages/mcp/src/tools/pack.ts +449 -0
  501. package/packages/mcp/src/tools/registry.ts +638 -0
  502. package/packages/mcp/src/tools/report.ts +100 -0
  503. package/packages/mcp/src/tools/run.ts +268 -0
  504. package/packages/mcp/src/tools/secrets.ts +198 -0
  505. package/packages/mcp/src/tools/serve.ts +221 -0
  506. package/packages/mcp/src/tools/triage.ts +532 -0
  507. package/packages/mcp/src/tools/types.ts +26 -0
  508. package/packages/mcp/src/tools/vault.ts +164 -0
  509. package/packages/mcp/src/tools/verify.ts +166 -0
  510. package/packages/mcp/src/types/index.ts +311 -0
  511. package/packages/mcp/src/types/mcp-stubs.ts +83 -0
  512. package/packages/mcp/tsconfig.json +16 -0
  513. package/playwright.config.ts +20 -0
  514. package/pnpm-workspace.yaml +4 -0
  515. package/run-test-and-push.sh +20 -0
  516. package/scripts/build-proof-cli.sh +110 -0
  517. package/scripts/ci/check-windows-paths.js +92 -0
  518. package/scripts/ci/invariants.sh +124 -0
  519. package/scripts/ci/make-final-bundle.js +106 -0
  520. package/scripts/ci/mcp-run-multipack.js +305 -0
  521. package/scripts/ci/run-pack-suite.sh +103 -0
  522. package/scripts/ci/run-phase7-final.sh +190 -0
  523. package/scripts/ci/slo-assert.js +158 -0
  524. package/scripts/ci/test-fault-tolerance.sh +301 -0
  525. package/scripts/install-mcp.sh +66 -0
  526. package/scripts/mcp-smoke.mjs +27 -0
  527. package/scripts/smoke.sh +26 -0
  528. package/scripts/stress-test.js +288 -0
  529. package/scripts/sync-version.mjs +50 -0
  530. package/scripts/validate-examples.mjs +404 -0
  531. package/scripts/validation/simple-pack-check.sh +51 -0
  532. package/scripts/validation/validate-universal-pack.mjs +77 -0
  533. package/scripts/verify-persistence.js +127 -0
  534. package/test-pack.yaml +43 -0
  535. package/test-results/.last-run.json +4 -0
  536. package/test-runner.mjs +87 -0
  537. package/tests/artifacts.spec.js +147 -0
  538. package/tests/contracts.spec.js +239 -0
  539. package/tests/e2e/assertions.test.mjs +370 -0
  540. package/tests/e2e/crawler.test.mjs +451 -0
  541. package/tests/e2e/playwright-plus-plus.test.mjs +604 -0
  542. package/tests/e2e/proof-bundle.test.mjs +258 -0
  543. package/tests/e2e/real-world/saucedemo.test.mjs +714 -0
  544. package/tests/e2e/real-world/the-internet-herokuapp.test.mjs +760 -0
  545. package/tests/e2e/ui-actions.test.mjs +546 -0
  546. package/tests/gherkin.e2e.spec.ts +310 -0
  547. package/tests/no-console-errors.spec.js +136 -0
  548. package/tests/pdf.spec.ts +252 -0
  549. package/tests/run-pack.spec.ts +58 -0
  550. package/tsconfig.base.json +15 -0
  551. package/tsconfig.build.json +8 -0
  552. package/tsconfig.json +37 -0
  553. package/tsconfig.test.json +18 -0
  554. package/typedoc.json +37 -0
  555. package/ui/README.md +50 -0
  556. package/verify-proof.mjs +60 -0
  557. package/dist/cli-minimal.d.ts +0 -6
  558. package/dist/cli-minimal.js +0 -36
  559. package/dist/commands/ai.d.ts +0 -43
  560. package/dist/commands/ai.js +0 -616
  561. package/dist/commands/ask.d.ts +0 -94
  562. package/dist/commands/ask.js +0 -582
  563. package/dist/commands/coverage.d.ts +0 -8
  564. package/dist/commands/coverage.js +0 -252
  565. package/dist/commands/crawl.d.ts +0 -24
  566. package/dist/commands/crawl.js +0 -121
  567. package/dist/commands/doctor.d.ts +0 -54
  568. package/dist/commands/doctor.js +0 -513
  569. package/dist/commands/examples.d.ts +0 -33
  570. package/dist/commands/examples.js +0 -193
  571. package/dist/commands/explain.d.ts +0 -27
  572. package/dist/commands/explain.js +0 -630
  573. package/dist/commands/flakiness.d.ts +0 -73
  574. package/dist/commands/flakiness.js +0 -435
  575. package/dist/commands/generate.d.ts +0 -66
  576. package/dist/commands/generate.js +0 -438
  577. package/dist/commands/history.d.ts +0 -76
  578. package/dist/commands/history.js +0 -755
  579. package/dist/commands/init.d.ts +0 -106
  580. package/dist/commands/init.js +0 -616
  581. package/dist/commands/monitor.d.ts +0 -27
  582. package/dist/commands/monitor.js +0 -225
  583. package/dist/commands/ollama.d.ts +0 -40
  584. package/dist/commands/ollama.js +0 -301
  585. package/dist/commands/pack.d.ts +0 -70
  586. package/dist/commands/pack.js +0 -413
  587. package/dist/commands/regression.d.ts +0 -8
  588. package/dist/commands/regression.js +0 -340
  589. package/dist/commands/repair.d.ts +0 -26
  590. package/dist/commands/repair.js +0 -307
  591. package/dist/commands/report.d.ts +0 -62
  592. package/dist/commands/report.js +0 -378
  593. package/dist/commands/retry.d.ts +0 -43
  594. package/dist/commands/retry.js +0 -275
  595. package/dist/commands/run.d.ts +0 -41
  596. package/dist/commands/run.js +0 -169
  597. package/dist/commands/scan.d.ts +0 -5
  598. package/dist/commands/scan.js +0 -155
  599. package/dist/commands/secrets.d.ts +0 -58
  600. package/dist/commands/secrets.js +0 -289
  601. package/dist/commands/serve.d.ts +0 -13
  602. package/dist/commands/serve.js +0 -156
  603. package/dist/commands/slo.d.ts +0 -8
  604. package/dist/commands/slo.js +0 -327
  605. package/dist/commands/verify.d.ts +0 -32
  606. package/dist/commands/verify.js +0 -278
  607. package/dist/core/adapters/gitleaks-secrets.d.ts +0 -114
  608. package/dist/core/adapters/gitleaks-secrets.js +0 -410
  609. package/dist/core/adapters/k6-perf.d.ts +0 -85
  610. package/dist/core/adapters/k6-perf.js +0 -398
  611. package/dist/core/adapters/osv-deps.d.ts +0 -123
  612. package/dist/core/adapters/osv-deps.js +0 -372
  613. package/dist/core/adapters/playwright-native-adapter.d.ts +0 -121
  614. package/dist/core/adapters/playwright-native-adapter.js +0 -339
  615. package/dist/core/adapters/playwright-native-api.d.ts +0 -183
  616. package/dist/core/adapters/playwright-native-api.js +0 -465
  617. package/dist/core/adapters/playwright-ui.d.ts +0 -197
  618. package/dist/core/adapters/playwright-ui.js +0 -840
  619. package/dist/core/adapters/semgrep-sast.d.ts +0 -99
  620. package/dist/core/adapters/semgrep-sast.js +0 -322
  621. package/dist/core/adapters/zap-dast.d.ts +0 -133
  622. package/dist/core/adapters/zap-dast.js +0 -424
  623. package/dist/core/ai/anthropic-provider.d.ts +0 -50
  624. package/dist/core/ai/anthropic-provider.js +0 -223
  625. package/dist/core/ai/deepseek-provider.d.ts +0 -81
  626. package/dist/core/ai/deepseek-provider.js +0 -266
  627. package/dist/core/ai/index.d.ts +0 -60
  628. package/dist/core/ai/index.js +0 -18
  629. package/dist/core/ai/llm-client.d.ts +0 -45
  630. package/dist/core/ai/llm-client.js +0 -7
  631. package/dist/core/ai/mock-provider.d.ts +0 -49
  632. package/dist/core/ai/mock-provider.js +0 -121
  633. package/dist/core/ai/ollama-provider.d.ts +0 -78
  634. package/dist/core/ai/ollama-provider.js +0 -204
  635. package/dist/core/ai/openai-provider.d.ts +0 -48
  636. package/dist/core/ai/openai-provider.js +0 -200
  637. package/dist/core/ai/provider-factory.d.ts +0 -160
  638. package/dist/core/ai/provider-factory.js +0 -269
  639. package/dist/core/artifacts/index.d.ts +0 -6
  640. package/dist/core/artifacts/index.js +0 -6
  641. package/dist/core/artifacts/ui-artifacts.d.ts +0 -133
  642. package/dist/core/artifacts/ui-artifacts.js +0 -304
  643. package/dist/core/assertions/engine.d.ts +0 -51
  644. package/dist/core/assertions/engine.js +0 -530
  645. package/dist/core/assertions/index.d.ts +0 -11
  646. package/dist/core/assertions/index.js +0 -11
  647. package/dist/core/assertions/types.d.ts +0 -121
  648. package/dist/core/assertions/types.js +0 -37
  649. package/dist/core/auth/api-key-provider.d.ts +0 -16
  650. package/dist/core/auth/api-key-provider.js +0 -63
  651. package/dist/core/auth/aws-iam-provider.d.ts +0 -35
  652. package/dist/core/auth/aws-iam-provider.js +0 -177
  653. package/dist/core/auth/azure-ad-provider.d.ts +0 -15
  654. package/dist/core/auth/azure-ad-provider.js +0 -99
  655. package/dist/core/auth/basic-auth-provider.d.ts +0 -26
  656. package/dist/core/auth/basic-auth-provider.js +0 -111
  657. package/dist/core/auth/gcp-adc-provider.d.ts +0 -27
  658. package/dist/core/auth/gcp-adc-provider.js +0 -126
  659. package/dist/core/auth/index.d.ts +0 -238
  660. package/dist/core/auth/index.js +0 -82
  661. package/dist/core/auth/jwt-provider.d.ts +0 -19
  662. package/dist/core/auth/jwt-provider.js +0 -160
  663. package/dist/core/auth/manager.d.ts +0 -84
  664. package/dist/core/auth/manager.js +0 -230
  665. package/dist/core/auth/oauth2-provider.d.ts +0 -17
  666. package/dist/core/auth/oauth2-provider.js +0 -114
  667. package/dist/core/auth/totp-provider.d.ts +0 -31
  668. package/dist/core/auth/totp-provider.js +0 -134
  669. package/dist/core/auth/ui-login-provider.d.ts +0 -26
  670. package/dist/core/auth/ui-login-provider.js +0 -198
  671. package/dist/core/cache/index.d.ts +0 -7
  672. package/dist/core/cache/index.js +0 -6
  673. package/dist/core/cache/lru-cache.d.ts +0 -203
  674. package/dist/core/cache/lru-cache.js +0 -397
  675. package/dist/core/core/coverage/analyzer.d.ts +0 -101
  676. package/dist/core/core/coverage/analyzer.js +0 -415
  677. package/dist/core/core/coverage/collector.d.ts +0 -74
  678. package/dist/core/core/coverage/collector.js +0 -459
  679. package/dist/core/core/coverage/config.d.ts +0 -37
  680. package/dist/core/core/coverage/config.js +0 -156
  681. package/dist/core/core/coverage/index.d.ts +0 -11
  682. package/dist/core/core/coverage/index.js +0 -15
  683. package/dist/core/core/coverage/types.d.ts +0 -267
  684. package/dist/core/core/coverage/types.js +0 -6
  685. package/dist/core/core/coverage/vault.d.ts +0 -95
  686. package/dist/core/core/coverage/vault.js +0 -405
  687. package/dist/core/coverage/analyzer.d.ts +0 -101
  688. package/dist/core/coverage/analyzer.js +0 -415
  689. package/dist/core/coverage/collector.d.ts +0 -74
  690. package/dist/core/coverage/collector.js +0 -459
  691. package/dist/core/coverage/config.d.ts +0 -37
  692. package/dist/core/coverage/config.js +0 -156
  693. package/dist/core/coverage/index.d.ts +0 -11
  694. package/dist/core/coverage/index.js +0 -15
  695. package/dist/core/coverage/types.d.ts +0 -267
  696. package/dist/core/coverage/types.js +0 -6
  697. package/dist/core/coverage/vault.d.ts +0 -95
  698. package/dist/core/coverage/vault.js +0 -405
  699. package/dist/core/crawler/index.d.ts +0 -57
  700. package/dist/core/crawler/index.js +0 -281
  701. package/dist/core/crawler/journey-generator.d.ts +0 -49
  702. package/dist/core/crawler/journey-generator.js +0 -412
  703. package/dist/core/crawler/page-analyzer.d.ts +0 -88
  704. package/dist/core/crawler/page-analyzer.js +0 -709
  705. package/dist/core/crawler/selector-generator.d.ts +0 -34
  706. package/dist/core/crawler/selector-generator.js +0 -240
  707. package/dist/core/crawler/types.d.ts +0 -353
  708. package/dist/core/crawler/types.js +0 -6
  709. package/dist/core/dashboard/assets.d.ts +0 -6
  710. package/dist/core/dashboard/assets.js +0 -690
  711. package/dist/core/dashboard/index.d.ts +0 -6
  712. package/dist/core/dashboard/index.js +0 -5
  713. package/dist/core/dashboard/server.d.ts +0 -72
  714. package/dist/core/dashboard/server.js +0 -354
  715. package/dist/core/dashboard/types.d.ts +0 -70
  716. package/dist/core/dashboard/types.js +0 -5
  717. package/dist/core/discoverer/index.d.ts +0 -115
  718. package/dist/core/discoverer/index.js +0 -250
  719. package/dist/core/flakiness/index.d.ts +0 -228
  720. package/dist/core/flakiness/index.js +0 -384
  721. package/dist/core/generation/code-formatter.d.ts +0 -111
  722. package/dist/core/generation/code-formatter.js +0 -307
  723. package/dist/core/generation/code-generator.d.ts +0 -144
  724. package/dist/core/generation/code-generator.js +0 -293
  725. package/dist/core/generation/crawler-pack-generator.d.ts +0 -44
  726. package/dist/core/generation/crawler-pack-generator.js +0 -231
  727. package/dist/core/generation/generator.d.ts +0 -40
  728. package/dist/core/generation/generator.js +0 -76
  729. package/dist/core/generation/index.d.ts +0 -32
  730. package/dist/core/generation/index.js +0 -30
  731. package/dist/core/generation/pack-generator.d.ts +0 -107
  732. package/dist/core/generation/pack-generator.js +0 -416
  733. package/dist/core/generation/prompt-builder.d.ts +0 -132
  734. package/dist/core/generation/prompt-builder.js +0 -672
  735. package/dist/core/generation/source-analyzer.d.ts +0 -213
  736. package/dist/core/generation/source-analyzer.js +0 -657
  737. package/dist/core/generation/test-optimizer.d.ts +0 -117
  738. package/dist/core/generation/test-optimizer.js +0 -328
  739. package/dist/core/generation/types.d.ts +0 -214
  740. package/dist/core/generation/types.js +0 -4
  741. package/dist/core/hooks/compose.d.ts +0 -61
  742. package/dist/core/hooks/compose.js +0 -225
  743. package/dist/core/hooks/runner.d.ts +0 -68
  744. package/dist/core/hooks/runner.js +0 -303
  745. package/dist/core/index.d.ts +0 -104
  746. package/dist/core/index.js +0 -91
  747. package/dist/core/pack/migrator.d.ts +0 -51
  748. package/dist/core/pack/migrator.js +0 -304
  749. package/dist/core/pack/validator.d.ts +0 -42
  750. package/dist/core/pack/validator.js +0 -322
  751. package/dist/core/pack-v2/index.d.ts +0 -9
  752. package/dist/core/pack-v2/index.js +0 -8
  753. package/dist/core/pack-v2/loader.d.ts +0 -63
  754. package/dist/core/pack-v2/loader.js +0 -292
  755. package/dist/core/pack-v2/migrator.d.ts +0 -61
  756. package/dist/core/pack-v2/migrator.js +0 -480
  757. package/dist/core/pack-v2/validator.d.ts +0 -61
  758. package/dist/core/pack-v2/validator.js +0 -577
  759. package/dist/core/parallel/index.d.ts +0 -6
  760. package/dist/core/parallel/index.js +0 -6
  761. package/dist/core/parallel/parallel-runner.d.ts +0 -107
  762. package/dist/core/parallel/parallel-runner.js +0 -192
  763. package/dist/core/proof/bundle.d.ts +0 -137
  764. package/dist/core/proof/bundle.js +0 -160
  765. package/dist/core/proof/canonicalize.d.ts +0 -47
  766. package/dist/core/proof/canonicalize.js +0 -105
  767. package/dist/core/proof/index.d.ts +0 -13
  768. package/dist/core/proof/index.js +0 -18
  769. package/dist/core/proof/schema.d.ts +0 -217
  770. package/dist/core/proof/schema.js +0 -263
  771. package/dist/core/proof/signer.d.ts +0 -111
  772. package/dist/core/proof/signer.js +0 -226
  773. package/dist/core/proof/verifier.d.ts +0 -97
  774. package/dist/core/proof/verifier.js +0 -308
  775. package/dist/core/regression/detector.d.ts +0 -107
  776. package/dist/core/regression/detector.js +0 -497
  777. package/dist/core/regression/index.d.ts +0 -9
  778. package/dist/core/regression/index.js +0 -11
  779. package/dist/core/regression/trend-analyzer.d.ts +0 -102
  780. package/dist/core/regression/trend-analyzer.js +0 -345
  781. package/dist/core/regression/types.d.ts +0 -222
  782. package/dist/core/regression/types.js +0 -7
  783. package/dist/core/regression/vault.d.ts +0 -87
  784. package/dist/core/regression/vault.js +0 -289
  785. package/dist/core/repair/engine/fixer.d.ts +0 -24
  786. package/dist/core/repair/engine/fixer.js +0 -226
  787. package/dist/core/repair/engine/suggestion-engine.d.ts +0 -18
  788. package/dist/core/repair/engine/suggestion-engine.js +0 -187
  789. package/dist/core/repair/index.d.ts +0 -10
  790. package/dist/core/repair/index.js +0 -13
  791. package/dist/core/repair/repairer.d.ts +0 -90
  792. package/dist/core/repair/repairer.js +0 -284
  793. package/dist/core/repair/types.d.ts +0 -91
  794. package/dist/core/repair/types.js +0 -6
  795. package/dist/core/repair/utils/error-analyzer.d.ts +0 -28
  796. package/dist/core/repair/utils/error-analyzer.js +0 -264
  797. package/dist/core/reporting/html-reporter.d.ts +0 -119
  798. package/dist/core/reporting/html-reporter.js +0 -737
  799. package/dist/core/reporting/index.d.ts +0 -6
  800. package/dist/core/reporting/index.js +0 -6
  801. package/dist/core/retry/flakiness-integration.d.ts +0 -60
  802. package/dist/core/retry/flakiness-integration.js +0 -228
  803. package/dist/core/retry/index.d.ts +0 -14
  804. package/dist/core/retry/index.js +0 -16
  805. package/dist/core/retry/retry-engine.d.ts +0 -80
  806. package/dist/core/retry/retry-engine.js +0 -296
  807. package/dist/core/retry/types.d.ts +0 -178
  808. package/dist/core/retry/types.js +0 -52
  809. package/dist/core/retry/vault.d.ts +0 -77
  810. package/dist/core/retry/vault.js +0 -304
  811. package/dist/core/runner/e2e-helpers.d.ts +0 -102
  812. package/dist/core/runner/e2e-helpers.js +0 -153
  813. package/dist/core/runner/phase3-runner.d.ts +0 -200
  814. package/dist/core/runner/phase3-runner.js +0 -1041
  815. package/dist/core/secrets/crypto.d.ts +0 -75
  816. package/dist/core/secrets/crypto.js +0 -223
  817. package/dist/core/secrets/manager.d.ts +0 -76
  818. package/dist/core/secrets/manager.js +0 -219
  819. package/dist/core/security/redaction-patterns-extended.d.ts +0 -27
  820. package/dist/core/security/redaction-patterns-extended.js +0 -247
  821. package/dist/core/security/redactor.d.ts +0 -71
  822. package/dist/core/security/redactor.js +0 -279
  823. package/dist/core/self-healing/assertion-healer.d.ts +0 -97
  824. package/dist/core/self-healing/assertion-healer.js +0 -371
  825. package/dist/core/self-healing/engine.d.ts +0 -122
  826. package/dist/core/self-healing/engine.js +0 -538
  827. package/dist/core/self-healing/index.d.ts +0 -10
  828. package/dist/core/self-healing/index.js +0 -11
  829. package/dist/core/self-healing/selector-healer.d.ts +0 -103
  830. package/dist/core/self-healing/selector-healer.js +0 -372
  831. package/dist/core/self-healing/types.d.ts +0 -152
  832. package/dist/core/self-healing/types.js +0 -6
  833. package/dist/core/serve/diagnostics-collector.d.ts +0 -32
  834. package/dist/core/serve/diagnostics-collector.js +0 -149
  835. package/dist/core/serve/health-checker.d.ts +0 -44
  836. package/dist/core/serve/health-checker.js +0 -219
  837. package/dist/core/serve/index.d.ts +0 -8
  838. package/dist/core/serve/index.js +0 -8
  839. package/dist/core/serve/metrics-collector.d.ts +0 -24
  840. package/dist/core/serve/metrics-collector.js +0 -322
  841. package/dist/core/serve/process-manager.d.ts +0 -36
  842. package/dist/core/serve/process-manager.js +0 -213
  843. package/dist/core/serve/server.d.ts +0 -36
  844. package/dist/core/serve/server.js +0 -191
  845. package/dist/core/slo/config.d.ts +0 -107
  846. package/dist/core/slo/config.js +0 -360
  847. package/dist/core/slo/index.d.ts +0 -11
  848. package/dist/core/slo/index.js +0 -15
  849. package/dist/core/slo/sli-calculator.d.ts +0 -92
  850. package/dist/core/slo/sli-calculator.js +0 -364
  851. package/dist/core/slo/slo-tracker.d.ts +0 -148
  852. package/dist/core/slo/slo-tracker.js +0 -379
  853. package/dist/core/slo/types.d.ts +0 -281
  854. package/dist/core/slo/types.js +0 -7
  855. package/dist/core/slo/vault.d.ts +0 -102
  856. package/dist/core/slo/vault.js +0 -427
  857. package/dist/core/tui/index.d.ts +0 -7
  858. package/dist/core/tui/index.js +0 -6
  859. package/dist/core/tui/monitor.d.ts +0 -92
  860. package/dist/core/tui/monitor.js +0 -271
  861. package/dist/core/tui/renderer.d.ts +0 -33
  862. package/dist/core/tui/renderer.js +0 -218
  863. package/dist/core/tui/types.d.ts +0 -63
  864. package/dist/core/tui/types.js +0 -5
  865. package/dist/core/types/pack-v1.d.ts +0 -251
  866. package/dist/core/types/pack-v1.js +0 -5
  867. package/dist/core/types/pack-v2.d.ts +0 -425
  868. package/dist/core/types/pack-v2.js +0 -8
  869. package/dist/core/types/trust-score.d.ts +0 -69
  870. package/dist/core/types/trust-score.js +0 -191
  871. package/dist/core/vault/cas.d.ts +0 -90
  872. package/dist/core/vault/cas.js +0 -261
  873. package/dist/core/vault/index.d.ts +0 -326
  874. package/dist/core/vault/index.js +0 -1042
  875. package/dist/core/visual/index.d.ts +0 -6
  876. package/dist/core/visual/index.js +0 -6
  877. package/dist/core/visual/visual-regression.d.ts +0 -113
  878. package/dist/core/visual/visual-regression.js +0 -236
  879. package/dist/core/watch/index.d.ts +0 -7
  880. package/dist/core/watch/index.js +0 -6
  881. package/dist/core/watch/watch-mode.d.ts +0 -213
  882. package/dist/core/watch/watch-mode.js +0 -389
  883. package/dist/generators/index.d.ts +0 -5
  884. package/dist/generators/index.js +0 -5
  885. package/dist/generators/json-reporter.d.ts +0 -10
  886. package/dist/generators/json-reporter.js +0 -12
  887. package/dist/generators/test-generator.d.ts +0 -18
  888. package/dist/generators/test-generator.js +0 -78
  889. package/dist/index.d.ts +0 -8
  890. package/dist/index.js +0 -246
  891. package/dist/scanners/dom-scanner.d.ts +0 -52
  892. package/dist/scanners/dom-scanner.js +0 -296
  893. package/dist/scanners/index.d.ts +0 -4
  894. package/dist/scanners/index.js +0 -4
  895. package/dist/schemas/pack.schema.json +0 -236
  896. package/dist/types/scan.d.ts +0 -68
  897. package/dist/types/scan.js +0 -4
  898. package/dist/utils/config.d.ts +0 -5
  899. package/dist/utils/config.js +0 -136
  900. /package/{bin → cli/bin}/qa360.js +0 -0
  901. /package/{examples → cli/examples}/accessibility.yml +0 -0
  902. /package/{examples → cli/examples}/api-basic.yml +0 -0
  903. /package/{examples → cli/examples}/complete.yml +0 -0
  904. /package/{examples → cli/examples}/crawler.yml +0 -0
  905. /package/{examples → cli/examples}/fullstack.yml +0 -0
  906. /package/{examples → cli/examples}/security.yml +0 -0
  907. /package/{examples → cli/examples}/ui-advanced.yml +0 -0
  908. /package/{examples → cli/examples}/ui-basic.yml +0 -0
  909. /package/{dist/core → core}/schemas/pack.schema.json +0 -0
@@ -0,0 +1,774 @@
1
+ /**
2
+ * Tests for Source Analyzer
3
+ *
4
+ * Tests for source code analysis and test generation suggestions.
5
+ */
6
+
7
+ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
8
+ import {
9
+ SourceAnalyzer,
10
+ analyzeSourceFile,
11
+ analyzeSourceDirectory,
12
+ generateTestSpec,
13
+ type SourceAnalysis,
14
+ type SourceAnalyzerOptions
15
+ } from '../source-analyzer.js';
16
+ import { mkdirSync, writeFileSync, rmSync, existsSync } from 'fs';
17
+ import { join } from 'path';
18
+
19
+ describe('SourceAnalyzer', () => {
20
+ let analyzer: SourceAnalyzer;
21
+ let testDir: string;
22
+
23
+ beforeEach(() => {
24
+ analyzer = new SourceAnalyzer();
25
+ testDir = join(process.cwd(), '.tmp-test-source-analyzer');
26
+ });
27
+
28
+ afterEach(() => {
29
+ if (existsSync(testDir)) {
30
+ rmSync(testDir, { recursive: true, force: true });
31
+ }
32
+ });
33
+
34
+ describe('Constructor', () => {
35
+ it('should create analyzer with default options', () => {
36
+ expect(analyzer).toBeInstanceOf(SourceAnalyzer);
37
+ });
38
+
39
+ it('should accept custom options', () => {
40
+ const options: SourceAnalyzerOptions = {
41
+ includePrivate: true,
42
+ maxComplexity: 5,
43
+ exclude: ['test', 'spec'],
44
+ followImports: true
45
+ };
46
+
47
+ const customAnalyzer = new SourceAnalyzer(options);
48
+ expect(customAnalyzer).toBeInstanceOf(SourceAnalyzer);
49
+ });
50
+ });
51
+
52
+ describe('TypeScript Analysis', () => {
53
+ it('should analyze TypeScript functions', () => {
54
+ const content = `
55
+ export function addUser(name: string, email: string): User {
56
+ return database.createUser(name, email);
57
+ }
58
+
59
+ export async function getUserById(id: string): Promise<User | null> {
60
+ return database.findUser(id);
61
+ }
62
+
63
+ private function internalHelper() {
64
+ return 'secret';
65
+ }
66
+ `;
67
+
68
+ const filePath = createTestFile('userService.ts', content);
69
+ const analysis = analyzer.analyzeFile(filePath);
70
+
71
+ expect(analysis.language).toBe('typescript');
72
+ expect(analysis.exports).toContain('addUser');
73
+ expect(analysis.exports).toContain('getUserById');
74
+ expect(analysis.exports).not.toContain('internalHelper');
75
+ expect(analysis.functions).toHaveLength(3);
76
+ });
77
+
78
+ it('should analyze TypeScript classes', () => {
79
+ const content = `
80
+ export class UserService {
81
+ private db: Database;
82
+
83
+ constructor(db: Database) {
84
+ this.db = db;
85
+ }
86
+
87
+ public async createUser(data: UserData): Promise<User> {
88
+ return this.db.insert(data);
89
+ }
90
+
91
+ public getUser(id: string): User {
92
+ return this.db.find(id);
93
+ }
94
+
95
+ private validate(data: UserData): boolean {
96
+ return !!data.email;
97
+ }
98
+ }
99
+ `;
100
+
101
+ const filePath = createTestFile('userService.ts', content);
102
+ const analysis = analyzer.analyzeFile(filePath);
103
+
104
+ expect(analysis.classes).toHaveLength(1);
105
+ expect(analysis.classes[0].name).toBe('UserService');
106
+ // The regex picks up methods with params (excluding constructor and properties)
107
+ expect(analysis.classes[0].methods.length).toBeGreaterThanOrEqual(2);
108
+ expect(analysis.classes[0].methods.some(m => m.name === 'createUser')).toBe(true);
109
+ expect(analysis.classes[0].methods.some(m => m.name === 'getUser')).toBe(true);
110
+ });
111
+
112
+ it('should analyze TypeScript imports', () => {
113
+ const content = `
114
+ import { express, Request, Response } from 'express';
115
+ import { Database } from './database';
116
+ import axios from 'axios';
117
+ import * as fs from 'fs';
118
+ `;
119
+
120
+ const filePath = createTestFile('app.ts', content);
121
+ const analysis = analyzer.analyzeFile(filePath);
122
+
123
+ expect(analysis.imports.length).toBeGreaterThan(0);
124
+ expect(analysis.imports.some(i => i.module === 'express')).toBe(true);
125
+ expect(analysis.imports.some(i => i.module === './database')).toBe(true);
126
+ expect(analysis.imports.find(i => i.module === 'express')?.isExternal).toBe(true);
127
+ expect(analysis.imports.find(i => i.module === './database')?.isExternal).toBe(false);
128
+ });
129
+
130
+ it('should detect async functions', () => {
131
+ const content = `
132
+ export async function fetchData(): Promise<Data> {
133
+ return await http.get('/data');
134
+ }
135
+
136
+ export function syncData(): Data {
137
+ return db.query('SELECT * FROM data');
138
+ }
139
+ `;
140
+
141
+ const filePath = createTestFile('api.ts', content);
142
+ const analysis = analyzer.analyzeFile(filePath);
143
+
144
+ // The analyzer checks if 'async' appears before the function name
145
+ const asyncFn = analysis.functions.find(f => f.name === 'fetchData');
146
+ const syncFn = analysis.functions.find(f => f.name === 'syncData');
147
+ expect(asyncFn?.isAsync).toBe(true);
148
+ expect(syncFn?.isAsync).toBe(false);
149
+ });
150
+
151
+ it('should calculate function complexity', () => {
152
+ const content = `
153
+ export function complexFunction(x: number): number {
154
+ if (x > 0) {
155
+ if (x > 10) {
156
+ for (let i = 0; i < x; i++) {
157
+ switch (i) {
158
+ case 1:
159
+ return x * 2;
160
+ case 2:
161
+ return x * 3;
162
+ default:
163
+ return x;
164
+ }
165
+ }
166
+ }
167
+ }
168
+ return x;
169
+ }
170
+
171
+ export function simpleFunction(x: number): number {
172
+ return x + 1;
173
+ }
174
+ `;
175
+
176
+ const filePath = createTestFile('functions.ts', content);
177
+ const analysis = analyzer.analyzeFile(filePath);
178
+
179
+ const complexFn = analysis.functions.find(f => f.name === 'complexFunction');
180
+ const simpleFn = analysis.functions.find(f => f.name === 'simpleFunction');
181
+
182
+ expect(complexFn?.complexity).toBeGreaterThan(simpleFn?.complexity || 0);
183
+ });
184
+ });
185
+
186
+ describe('Python Analysis', () => {
187
+ it('should analyze Python functions', () => {
188
+ const content = `
189
+ def create_user(name: str, email: str) -> User:
190
+ return db.create(name, email)
191
+
192
+ async def get_user(id: str) -> User | None:
193
+ return await db.find(id)
194
+
195
+ def _private_helper():
196
+ return "secret"
197
+ `;
198
+
199
+ const filePath = createTestFile('user_service.py', content);
200
+ const analysis = analyzer.analyzeFile(filePath);
201
+
202
+ expect(analysis.language).toBe('python');
203
+ // Python analysis has different behavior - only non-private functions are exports
204
+ expect(analysis.functions.length).toBeGreaterThan(0);
205
+ expect(analysis.exports).not.toContain('_private_helper');
206
+ });
207
+
208
+ it('should analyze Python classes', () => {
209
+ const content = `
210
+ class UserService:
211
+ def __init__(self, db):
212
+ self.db = db
213
+
214
+ def create_user(self, data):
215
+ return self.db.insert(data)
216
+
217
+ def get_user(self, id):
218
+ return self.db.find(id)
219
+ `;
220
+
221
+ const filePath = createTestFile('user_service.py', content);
222
+ const analysis = analyzer.analyzeFile(filePath);
223
+
224
+ expect(analysis.classes).toHaveLength(1);
225
+ expect(analysis.classes[0].name).toBe('UserService');
226
+ // Note: Python class method extraction is basic - adds to functions, not class methods
227
+ });
228
+ });
229
+
230
+ describe('Go Analysis', () => {
231
+ it('should analyze Go functions', () => {
232
+ const content = `
233
+ package main
234
+
235
+ func CreateUser(name string, email string) User {
236
+ return db.Create(name, email)
237
+ }
238
+
239
+ func GetUserById(id string) User {
240
+ return db.Find(id)
241
+ }
242
+
243
+ func privateHelper() string {
244
+ return "secret"
245
+ }
246
+ `;
247
+
248
+ const filePath = createTestFile('user_service.go', content);
249
+ const analysis = analyzer.analyzeFile(filePath);
250
+
251
+ expect(analysis.language).toBe('go');
252
+ expect(analysis.exports).toContain('CreateUser');
253
+ expect(analysis.exports).toContain('GetUserById');
254
+ });
255
+
256
+ it('should analyze Go structs', () => {
257
+ const content = `
258
+ package main
259
+
260
+ type User struct {
261
+ Name string
262
+ Email string
263
+ }
264
+
265
+ type ProductService struct {
266
+ db *Database
267
+ }
268
+ `;
269
+
270
+ const filePath = createTestFile('models.go', content);
271
+ const analysis = analyzer.analyzeFile(filePath);
272
+
273
+ expect(analysis.classes).toHaveLength(2);
274
+ expect(analysis.classes[0].name).toBe('User');
275
+ expect(analysis.classes[1].name).toBe('ProductService');
276
+ });
277
+ });
278
+
279
+ describe('Directory Analysis', () => {
280
+ it('should analyze all source files in directory', () => {
281
+ mkdirSync(testDir, { recursive: true });
282
+
283
+ writeFileSync(join(testDir, 'file1.ts'), 'export function fn1() {}');
284
+ writeFileSync(join(testDir, 'file2.ts'), 'export function fn2() {}');
285
+ writeFileSync(join(testDir, 'README.md'), '# Readme');
286
+ writeFileSync(join(testDir, 'file3.js'), 'export function fn3() {}');
287
+
288
+ const results = analyzer.analyzeDirectory(testDir);
289
+
290
+ expect(results).toHaveLength(3);
291
+ expect(results.every(r => r.language === 'typescript' || r.language === 'javascript'));
292
+ });
293
+
294
+ it('should respect exclude patterns', () => {
295
+ mkdirSync(testDir, { recursive: true });
296
+ mkdirSync(join(testDir, 'node_modules'), { recursive: true });
297
+
298
+ writeFileSync(join(testDir, 'file.ts'), 'export function fn() {}');
299
+ writeFileSync(join(testDir, 'node_modules', 'dep.ts'), 'export function dep() {}');
300
+
301
+ const excludeAnalyzer = new SourceAnalyzer({ exclude: ['node_modules'] });
302
+ const results = excludeAnalyzer.analyzeDirectory(testDir);
303
+
304
+ expect(results).toHaveLength(1);
305
+ expect(results[0].filePath).not.toContain('node_modules');
306
+ });
307
+ });
308
+
309
+ describe('Test Specification Generation', () => {
310
+ it('should generate unit test spec from analysis', () => {
311
+ const content = `
312
+ export function calculateDiscount(price: number, percentage: number): number {
313
+ return price * (1 - percentage / 100);
314
+ }
315
+
316
+ export function formatCurrency(amount: number): string {
317
+ return '$' + amount.toFixed(2);
318
+ }
319
+ `;
320
+
321
+ const filePath = createTestFile('pricing.ts', content);
322
+ const analysis = analyzer.analyzeFile(filePath);
323
+ const spec = analyzer.generateSpec(analysis);
324
+
325
+ expect(spec.type).toBe('unit');
326
+ expect(spec.source.language).toBe('typescript');
327
+ expect(spec.source.filePath).toBe(filePath);
328
+ expect(spec.source.exports).toHaveLength(2);
329
+ expect(spec.framework).toBe('vitest');
330
+ });
331
+
332
+ it('should recommend correct framework per language', () => {
333
+ const tsAnalyzer = new SourceAnalyzer();
334
+ const pyAnalyzer = new SourceAnalyzer();
335
+ const goAnalyzer = new SourceAnalyzer();
336
+
337
+ // Mock analyses
338
+ const tsAnalysis: SourceAnalysis = {
339
+ filePath: 'test.ts',
340
+ language: 'typescript',
341
+ exports: [],
342
+ functions: [],
343
+ classes: [],
344
+ imports: [],
345
+ hasTests: false,
346
+ complexity: 1,
347
+ linesOfCode: 10
348
+ };
349
+
350
+ const pyAnalysis: SourceAnalysis = { ...tsAnalysis, filePath: 'test.py', language: 'python' };
351
+ const goAnalysis: SourceAnalysis = { ...tsAnalysis, filePath: 'test.go', language: 'go' };
352
+
353
+ expect(tsAnalyzer.generateSpec(tsAnalysis).framework).toBe('vitest');
354
+ expect(pyAnalyzer.generateSpec(pyAnalysis).framework).toBe('pytest');
355
+ expect(goAnalyzer.generateSpec(goAnalysis).framework).toBe('go test');
356
+ });
357
+ });
358
+
359
+ describe('Test Suggestions', () => {
360
+ it('should generate unit test suggestions', () => {
361
+ const content = `
362
+ export function validateEmail(email: string): boolean {
363
+ const regex = /^[^@]+@[^@]+\.[^@]+$/;
364
+ return regex.test(email);
365
+ }
366
+
367
+ export function sanitizeInput(input: string): string {
368
+ return input.trim().toLowerCase();
369
+ }
370
+ `;
371
+
372
+ const filePath = createTestFile('validator.ts', content);
373
+ const analysis = analyzer.analyzeFile(filePath);
374
+ const suggestions = analyzer.generateSuggestions(analysis);
375
+
376
+ expect(suggestions.length).toBeGreaterThan(0);
377
+
378
+ const unitSuggestions = suggestions.filter(s => s.type === 'unit');
379
+ expect(unitSuggestions.length).toBeGreaterThan(0);
380
+ expect(unitSuggestions[0].assertions).toBeDefined();
381
+ expect(unitSuggestions[0].assertions.length).toBeGreaterThan(0);
382
+ });
383
+
384
+ it('should suggest integration tests for complex classes', () => {
385
+ const content = `
386
+ export class ComplexService {
387
+ constructor(dep1: Dep1, dep2: Dep2) {}
388
+
389
+ public method1() {}
390
+ public method2() {}
391
+ public method3() {}
392
+ }
393
+ `;
394
+
395
+ const filePath = createTestFile('service.ts', content);
396
+ const analysis = analyzer.analyzeFile(filePath);
397
+ const suggestions = analyzer.generateSuggestions(analysis);
398
+
399
+ const integrationSuggestions = suggestions.filter(s => s.type === 'integration');
400
+ expect(integrationSuggestions.length).toBeGreaterThan(0);
401
+ });
402
+
403
+ it('should suggest E2E tests for HTTP-using code', () => {
404
+ const content = `
405
+ import axios from 'axios';
406
+
407
+ export async function fetchUserData(id: string) {
408
+ const response = await axios.get(\`/api/users/\${id}\`);
409
+ return response.data;
410
+ }
411
+ `;
412
+
413
+ const filePath = createTestFile('api.ts', content);
414
+ const analysis = analyzer.analyzeFile(filePath);
415
+ const suggestions = analyzer.generateSuggestions(analysis);
416
+
417
+ const e2eSuggestions = suggestions.filter(s => s.type === 'e2e');
418
+ expect(e2eSuggestions.length).toBeGreaterThan(0);
419
+ });
420
+
421
+ it('should prioritize suggestions by complexity', () => {
422
+ const content = `
423
+ export function simple() { return 1; }
424
+
425
+ export function complex(x: number) {
426
+ if (x > 0) {
427
+ if (x > 10) {
428
+ for (let i = 0; i < x; i++) {
429
+ if (i % 2 === 0) {
430
+ return i * 2;
431
+ }
432
+ }
433
+ }
434
+ }
435
+ return x;
436
+ }
437
+ `;
438
+
439
+ const filePath = createTestFile('functions.ts', content);
440
+ const analysis = analyzer.analyzeFile(filePath);
441
+ const suggestions = analyzer.generateSuggestions(analysis);
442
+
443
+ // Complex function should have higher priority
444
+ const complexSuggestion = suggestions.find(s => s.functionName === 'complex');
445
+ expect(complexSuggestion).toBeDefined();
446
+ // Priority is determined by complexity score
447
+ });
448
+ });
449
+
450
+ describe('API Spec Generation', () => {
451
+ it('should generate API spec from Express handlers', () => {
452
+ const content = `
453
+ export async function getUsers(req: Request, res: Response) {
454
+ const users = await db.findAll();
455
+ res.json(users);
456
+ }
457
+
458
+ export function createUser(req: Request, res: Response) {
459
+ const user = db.create(req.body);
460
+ res.status(201).json(user);
461
+ }
462
+
463
+ export function getUserById(req: Request, res: Response) {
464
+ const user = db.findById(req.params.id);
465
+ res.json(user);
466
+ }
467
+ `;
468
+
469
+ const filePath = createTestFile('handlers.ts', content);
470
+ const analysis = analyzer.analyzeFile(filePath);
471
+ const apiSpec = analyzer.generateApiSpec(analysis);
472
+
473
+ expect(apiSpec).not.toBeNull();
474
+ expect(apiSpec?.type).toBe('api');
475
+ expect(apiSpec?.endpoints).toHaveLength(3);
476
+ });
477
+
478
+ it('should detect HTTP methods from function names', () => {
479
+ const content = `
480
+ export function getUser(req: Request, res: Response) {}
481
+ export function postUser(req: Request, res: Response) {}
482
+ export function deleteUser(req: Request, res: Response) {}
483
+ `;
484
+
485
+ const filePath = createTestFile('api.ts', content);
486
+ const analysis = analyzer.analyzeFile(filePath);
487
+ const apiSpec = analyzer.generateApiSpec(analysis);
488
+
489
+ expect(apiSpec?.endpoints).toHaveLength(3);
490
+ expect(apiSpec?.endpoints[0].method).toBe('GET');
491
+ expect(apiSpec?.endpoints[1].method).toBe('POST');
492
+ expect(apiSpec?.endpoints[2].method).toBe('DELETE');
493
+ });
494
+ });
495
+
496
+ describe('Test File Detection', () => {
497
+ it('should detect existing test files', () => {
498
+ mkdirSync(testDir, { recursive: true });
499
+
500
+ const sourceFile = join(testDir, 'userService.ts');
501
+ const testFile = join(testDir, 'userService.test.ts');
502
+
503
+ writeFileSync(sourceFile, 'export function fn() {}');
504
+ writeFileSync(testFile, 'test content');
505
+
506
+ const analysis = analyzer.analyzeFile(sourceFile);
507
+
508
+ expect(analysis.hasTests).toBe(true);
509
+ expect(analysis.testFilePath).toBe(testFile);
510
+ });
511
+
512
+ it('should find test in __tests__ directory', () => {
513
+ mkdirSync(testDir, { recursive: true });
514
+ mkdirSync(join(testDir, '__tests__'), { recursive: true });
515
+
516
+ const sourceFile = join(testDir, 'userService.ts');
517
+ const testFile = join(testDir, '__tests__', 'userService.test.ts');
518
+
519
+ writeFileSync(sourceFile, 'export function fn() {}');
520
+ writeFileSync(testFile, 'test content');
521
+
522
+ const analysis = analyzer.analyzeFile(sourceFile);
523
+
524
+ expect(analysis.hasTests).toBe(true);
525
+ expect(analysis.testFilePath).toBeDefined();
526
+ });
527
+
528
+ it('should detect when no test file exists', () => {
529
+ const filePath = createTestFile('userService.ts', 'export function fn() {}');
530
+ const analysis = analyzer.analyzeFile(filePath);
531
+
532
+ expect(analysis.hasTests).toBe(false);
533
+ expect(analysis.testFilePath).toBeUndefined();
534
+ });
535
+ });
536
+
537
+ describe('Lines of Code', () => {
538
+ it('should count lines of code correctly', () => {
539
+ const content = `
540
+ line 1
541
+ line 2
542
+ line 3
543
+ line 4
544
+ line 5
545
+ `;
546
+
547
+ const filePath = createTestFile('test.ts', content);
548
+ const analysis = analyzer.analyzeFile(filePath);
549
+
550
+ expect(analysis.linesOfCode).toBeGreaterThan(0);
551
+ });
552
+ });
553
+
554
+ describe('Complexity Calculation', () => {
555
+ it('should calculate overall complexity', () => {
556
+ const content = `
557
+ export function fn1() { return 1; }
558
+ export function fn2() { if (true) return 2; }
559
+ export function fn3() { if (a) { if (b) return 3; } }
560
+ `;
561
+
562
+ const filePath = createTestFile('test.ts', content);
563
+ const analysis = analyzer.analyzeFile(filePath);
564
+
565
+ expect(analysis.complexity).toBeGreaterThan(0);
566
+ });
567
+ });
568
+
569
+ describe('Error Handling', () => {
570
+ it('should throw error for non-existent file', () => {
571
+ expect(() => {
572
+ analyzer.analyzeFile('/non/existent/file.ts');
573
+ }).toThrow('Source file not found');
574
+ });
575
+
576
+ it('should throw error for non-existent directory', () => {
577
+ expect(() => {
578
+ analyzer.analyzeDirectory('/non/existent/dir');
579
+ }).toThrow('Directory not found');
580
+ });
581
+
582
+ it('should skip files that fail to analyze in directory mode', () => {
583
+ // This test verifies the graceful handling of parse errors
584
+ mkdirSync(testDir, { recursive: true });
585
+ writeFileSync(join(testDir, 'valid.ts'), 'export function fn() {}');
586
+
587
+ // Invalid file should be skipped, not throw
588
+ const results = analyzer.analyzeDirectory(testDir);
589
+ expect(results.length).toBeGreaterThanOrEqual(1);
590
+ });
591
+ });
592
+
593
+ describe('Convenience Functions', () => {
594
+ it('should analyze file using convenience function', () => {
595
+ const filePath = createTestFile('test.ts', 'export function fn() {}');
596
+ const analysis = analyzeSourceFile(filePath);
597
+
598
+ expect(analysis).toBeDefined();
599
+ expect(analysis.exports).toContain('fn');
600
+ });
601
+
602
+ it('should analyze directory using convenience function', () => {
603
+ mkdirSync(testDir, { recursive: true });
604
+ writeFileSync(join(testDir, 'file.ts'), 'export function fn() {}');
605
+
606
+ const results = analyzeSourceDirectory(testDir);
607
+ expect(results).toHaveLength(1);
608
+ });
609
+
610
+ it('should generate spec using convenience function', () => {
611
+ const filePath = createTestFile('test.ts', 'export function fn() {}');
612
+ const analysis = analyzer.analyzeFile(filePath);
613
+ const spec = generateTestSpec(analysis);
614
+
615
+ expect(spec.type).toBe('unit');
616
+ });
617
+ });
618
+
619
+ describe('Generation Source Conversion', () => {
620
+ it('should convert analysis to GenerationSource', () => {
621
+ const content = 'export function test() { return true; }';
622
+ const filePath = createTestFile('test.ts', content);
623
+ const analysis = analyzer.analyzeFile(filePath);
624
+ const source = analyzer.toGenerationSource(analysis);
625
+
626
+ expect(source.type).toBe('code');
627
+ expect(source.language).toBe('typescript');
628
+ expect(source.code).toContain('export function');
629
+ });
630
+ });
631
+
632
+ // Helper function to create test files
633
+ function createTestFile(name: string, content: string): string {
634
+ mkdirSync(testDir, { recursive: true });
635
+ const filePath = join(testDir, name);
636
+ writeFileSync(filePath, content, 'utf-8');
637
+ return filePath;
638
+ }
639
+ });
640
+
641
+ describe('SourceAnalyzer Integration', () => {
642
+ let testDir: string;
643
+
644
+ beforeEach(() => {
645
+ testDir = join(process.cwd(), '.tmp-test-source-integration');
646
+ });
647
+
648
+ afterEach(() => {
649
+ if (existsSync(testDir)) {
650
+ rmSync(testDir, { recursive: true, force: true });
651
+ }
652
+ });
653
+
654
+ describe('Full Workflow', () => {
655
+ it('should complete analyze → suggest → generate workflow', () => {
656
+ mkdirSync(testDir, { recursive: true });
657
+
658
+ const content = `
659
+ /**
660
+ * User service for managing users
661
+ */
662
+ import { Database } from './db';
663
+
664
+ export class UserService {
665
+ constructor(private db: Database) {}
666
+
667
+ async createUser(name: string, email: string) {
668
+ return this.db.insert({ name, email });
669
+ }
670
+
671
+ async getUserById(id: string) {
672
+ return this.db.findById(id);
673
+ }
674
+
675
+ async updateUser(id: string, data: any) {
676
+ return this.db.update(id, data);
677
+ }
678
+
679
+ async deleteUser(id: string) {
680
+ return this.db.delete(id);
681
+ }
682
+ }
683
+ `;
684
+
685
+ const filePath = join(testDir, 'userService.ts');
686
+ writeFileSync(filePath, content);
687
+
688
+ const analyzer = new SourceAnalyzer();
689
+ const analysis = analyzer.analyzeFile(filePath);
690
+ const suggestions = analyzer.generateSuggestions(analysis);
691
+ const spec = analyzer.generateSpec(analysis);
692
+
693
+ // Verify analysis
694
+ expect(analysis.classes).toHaveLength(1);
695
+ expect(analysis.classes[0].name).toBe('UserService');
696
+ expect(analysis.hasTests).toBe(false);
697
+
698
+ // Verify suggestions
699
+ expect(suggestions.length).toBeGreaterThan(0);
700
+ expect(suggestions.some(s => s.type === 'unit'));
701
+
702
+ // Verify spec
703
+ expect(spec.type).toBe('unit');
704
+ expect(spec.source.exports).toBeDefined();
705
+ });
706
+
707
+ it('should handle API handler analysis', () => {
708
+ mkdirSync(testDir, { recursive: true });
709
+
710
+ const content = `
711
+ import { Router, Request, Response } from 'express';
712
+
713
+ const router = Router();
714
+
715
+ export async function getUsers(req: Request, res: Response): Promise<void> {
716
+ const users = await db.users.findAll();
717
+ res.json(users);
718
+ }
719
+
720
+ export async function getUser(req: Request, res: Response): Promise<void> {
721
+ const user = await db.users.findById(req.params.id);
722
+ res.json(user);
723
+ }
724
+
725
+ export async function createUser(req: Request, res: Response): Promise<void> {
726
+ const user = await db.users.create(req.body);
727
+ res.status(201).json(user);
728
+ }
729
+
730
+ export async function updateUser(req: Request, res: Response): Promise<void> {
731
+ const user = await db.users.update(req.params.id, req.body);
732
+ res.json(user);
733
+ }
734
+
735
+ export async function deleteUser(req: Request, res: Response): Promise<void> {
736
+ await db.users.delete(req.params.id);
737
+ res.status(204).send();
738
+ }
739
+ `;
740
+
741
+ const filePath = join(testDir, 'handlers.ts');
742
+ writeFileSync(filePath, content);
743
+
744
+ const analyzer = new SourceAnalyzer();
745
+ const analysis = analyzer.analyzeFile(filePath);
746
+ const apiSpec = analyzer.generateApiSpec(analysis);
747
+
748
+ expect(apiSpec).not.toBeNull();
749
+ expect(apiSpec?.endpoints).toHaveLength(5);
750
+ // All handlers with req/res params default to GET unless name indicates otherwise
751
+ expect(apiSpec?.endpoints[0].method).toBe('GET');
752
+ expect(apiSpec?.endpoints).toBeDefined();
753
+ });
754
+ });
755
+
756
+ describe('Multi-File Project', () => {
757
+ it('should analyze entire project structure', () => {
758
+ mkdirSync(testDir, { recursive: true });
759
+ mkdirSync(join(testDir, 'src'), { recursive: true });
760
+ mkdirSync(join(testDir, 'src', 'services'), { recursive: true });
761
+
762
+ writeFileSync(join(testDir, 'src', 'index.ts'), 'export * from "./services";');
763
+ writeFileSync(join(testDir, 'src', 'services', 'user.ts'), 'export class UserService {}');
764
+ writeFileSync(join(testDir, 'src', 'services', 'auth.ts'), 'export class AuthService {}');
765
+ writeFileSync(join(testDir, 'src', 'services', 'data.ts'), 'export class DataService {}');
766
+
767
+ const analyzer = new SourceAnalyzer({ exclude: ['node_modules'] });
768
+ const results = analyzer.analyzeDirectory(join(testDir, 'src'));
769
+
770
+ expect(results).toHaveLength(4);
771
+ expect(results.some(r => r.classes.length > 0));
772
+ });
773
+ });
774
+ });