qa360 2.1.2 → 2.1.4

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 (866) hide show
  1. package/.BETA_TESTING_FEEDBACK.md +256 -0
  2. package/.claude/settings.local.json +151 -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-artifacts/.gitkeep +0 -0
  13. package/.qa360-artifacts/baselines/.gitkeep +0 -0
  14. package/.qa360-artifacts/cache/.gitkeep +0 -0
  15. package/.qa360-artifacts/reports/.gitkeep +0 -0
  16. package/.qa360-artifacts/screenshots/.gitkeep +0 -0
  17. package/.qa360-baselines/www_xyqo_ai.baseline.json +33 -0
  18. package/CHANGELOG.md +234 -0
  19. package/CODEOWNERS +43 -0
  20. package/CONTRIBUTING.md +273 -0
  21. package/NOVICE_USER_GUIDE.md +272 -0
  22. package/QUICK_START.md +191 -0
  23. package/README.md +191 -163
  24. package/adapters/README.md +62 -0
  25. package/check-branches.sh +32 -0
  26. package/cli/CHANGELOG.md +84 -0
  27. package/cli/LICENSE +24 -0
  28. package/cli/README.md +222 -0
  29. package/cli/examples/README.md +160 -0
  30. package/cli/package.json +76 -0
  31. package/cli/scripts/bundle-for-npm.sh +51 -0
  32. package/cli/scripts/validate-package.js +116 -0
  33. package/cli/src/__tests__/commands/doctor.test.ts +97 -0
  34. package/cli/src/__tests__/index.test.ts +15 -0
  35. package/cli/src/cli-minimal.ts +44 -0
  36. package/cli/src/commands/__tests__/crawl.test.ts +412 -0
  37. package/cli/src/commands/__tests__/doctor-qa360-home.test.ts +156 -0
  38. package/cli/src/commands/__tests__/e2e-ui-tests.test.ts +494 -0
  39. package/cli/src/commands/__tests__/e2e.test.ts +187 -0
  40. package/cli/src/commands/__tests__/flakiness.test.ts +528 -0
  41. package/cli/src/commands/__tests__/generate.test.ts +507 -0
  42. package/cli/src/commands/__tests__/history.integration.test.ts +358 -0
  43. package/cli/src/commands/__tests__/history.test.ts +433 -0
  44. package/cli/src/commands/__tests__/monitor-realworld.test.ts +199 -0
  45. package/cli/src/commands/__tests__/monitor.test.ts +81 -0
  46. package/cli/src/commands/__tests__/ollama.test.ts +529 -0
  47. package/cli/src/commands/__tests__/repair.test.ts +225 -0
  48. package/cli/src/commands/__tests__/report.integration.test.ts +167 -0
  49. package/cli/src/commands/__tests__/report.test.ts +294 -0
  50. package/cli/src/commands/__tests__/report.vitest.ts +288 -0
  51. package/cli/src/commands/__tests__/retry.test.ts +78 -0
  52. package/cli/src/commands/__tests__/run.integration.test.ts +240 -0
  53. package/cli/src/commands/__tests__/run.test.ts +346 -0
  54. package/cli/src/commands/__tests__/run.vitest.ts +301 -0
  55. package/cli/src/commands/__tests__/secrets.test.ts +114 -0
  56. package/cli/src/commands/__tests__/serve.test.ts +80 -0
  57. package/cli/src/commands/__tests__/verify.test.ts +103 -0
  58. package/cli/src/commands/ai.ts +579 -0
  59. package/cli/src/commands/ask.ts +678 -0
  60. package/cli/src/commands/coverage.ts +305 -0
  61. package/cli/src/commands/crawl.ts +155 -0
  62. package/cli/src/commands/doctor.ts +610 -0
  63. package/cli/src/commands/examples.ts +248 -0
  64. package/cli/src/commands/explain.ts +710 -0
  65. package/cli/src/commands/flakiness.ts +560 -0
  66. package/cli/src/commands/generate.ts +566 -0
  67. package/cli/src/commands/history.ts +914 -0
  68. package/cli/src/commands/init.ts +763 -0
  69. package/cli/src/commands/monitor.ts +270 -0
  70. package/cli/src/commands/ollama.ts +337 -0
  71. package/cli/src/commands/pack.ts +497 -0
  72. package/cli/src/commands/regression.ts +400 -0
  73. package/cli/src/commands/repair.ts +356 -0
  74. package/cli/src/commands/report.ts +463 -0
  75. package/cli/src/commands/retry.ts +380 -0
  76. package/cli/src/commands/run.ts +218 -0
  77. package/cli/src/commands/scan.ts +177 -0
  78. package/cli/src/commands/secrets.ts +340 -0
  79. package/cli/src/commands/serve.ts +194 -0
  80. package/cli/src/commands/slo.ts +387 -0
  81. package/cli/src/commands/verify-temp-note.md +11 -0
  82. package/cli/src/commands/verify.ts +322 -0
  83. package/cli/src/generators/index.ts +6 -0
  84. package/cli/src/generators/json-reporter.ts +15 -0
  85. package/cli/src/generators/test-generator.ts +90 -0
  86. package/cli/src/index.ts +289 -0
  87. package/cli/src/scanners/dom-scanner.ts +360 -0
  88. package/cli/src/scanners/index.ts +5 -0
  89. package/cli/src/types/scan.ts +84 -0
  90. package/cli/src/utils/config.ts +145 -0
  91. package/cli/tsconfig.bundle.json +12 -0
  92. package/cli/tsconfig.json +23 -0
  93. package/cli/vitest.config.ts +57 -0
  94. package/core/LICENSE +24 -0
  95. package/core/README.md +64 -0
  96. package/core/package.json +81 -0
  97. package/core/src/__tests__/adapters-contract/adapters-contract.test.md +156 -0
  98. package/core/src/__tests__/index.test.ts +31 -0
  99. package/core/src/__tests__/integration/phase3.test.ts +405 -0
  100. package/core/src/__tests__/pack/validator.test.ts +312 -0
  101. package/core/src/__tests__/secrets/crypto.test.ts +190 -0
  102. package/core/src/__tests__/secrets/manager.test.ts +316 -0
  103. package/core/src/__tests__/security/redactor-phase3.test.ts +233 -0
  104. package/core/src/__tests__/serve/health-checker.test.ts +155 -0
  105. package/core/src/__tests__/serve/process-manager.test.ts +213 -0
  106. package/core/src/__tests__/serve/server.test.ts +103 -0
  107. package/core/src/__tests__/vault/cas.test.ts +178 -0
  108. package/core/src/__tests__/vault/vault.test.ts +296 -0
  109. package/core/src/adapters/__tests__/gitleaks-secrets.test.ts +452 -0
  110. package/core/src/adapters/__tests__/k6-perf.test.ts +538 -0
  111. package/core/src/adapters/__tests__/osv-deps.test.ts +471 -0
  112. package/core/src/adapters/__tests__/playwright-native-api.test.ts +792 -0
  113. package/core/src/adapters/__tests__/playwright-ui-e2e.test.ts +431 -0
  114. package/core/src/adapters/__tests__/playwright-ui.test.ts +1073 -0
  115. package/core/src/adapters/__tests__/semgrep-sast.test.ts +436 -0
  116. package/core/src/adapters/__tests__/zap-dast.test.ts +453 -0
  117. package/core/src/adapters/gitleaks-secrets.ts +521 -0
  118. package/core/src/adapters/k6-perf.ts +479 -0
  119. package/core/src/adapters/osv-deps.ts +467 -0
  120. package/core/src/adapters/playwright-native-adapter.ts +472 -0
  121. package/core/src/adapters/playwright-native-api.ts +619 -0
  122. package/core/src/adapters/playwright-ui.ts +1088 -0
  123. package/core/src/adapters/semgrep-sast.ts +410 -0
  124. package/core/src/adapters/zap-dast.ts +551 -0
  125. package/core/src/ai/__tests__/deepseek-provider.test.ts +586 -0
  126. package/core/src/ai/__tests__/ollama-provider.test.ts +641 -0
  127. package/core/src/ai/anthropic-provider.ts +248 -0
  128. package/core/src/ai/deepseek-provider.ts +301 -0
  129. package/core/src/ai/index.ts +87 -0
  130. package/core/src/ai/llm-client.ts +52 -0
  131. package/core/src/ai/mock-provider.ts +146 -0
  132. package/core/src/ai/ollama-provider.ts +255 -0
  133. package/core/src/ai/openai-provider.ts +226 -0
  134. package/core/src/ai/provider-factory.ts +408 -0
  135. package/core/src/artifacts/README.md +78 -0
  136. package/core/src/artifacts/index.ts +16 -0
  137. package/core/src/artifacts/ui-artifacts.ts +412 -0
  138. package/core/src/assertions/__tests__/engine.test.ts +360 -0
  139. package/core/src/assertions/engine.ts +577 -0
  140. package/core/src/assertions/index.ts +13 -0
  141. package/core/src/assertions/types.ts +229 -0
  142. package/core/src/auth/__tests__/api-key-provider.test.ts +282 -0
  143. package/core/src/auth/__tests__/auth-manager.test.ts +430 -0
  144. package/core/src/auth/__tests__/basic-auth-provider.test.ts +364 -0
  145. package/core/src/auth/__tests__/cloud-providers.test.ts +751 -0
  146. package/core/src/auth/__tests__/jwt-provider.test.ts +400 -0
  147. package/core/src/auth/__tests__/oauth2-provider.test.ts +383 -0
  148. package/core/src/auth/__tests__/totp-provider.test.ts +294 -0
  149. package/core/src/auth/__tests__/ui-login-provider.test.ts +323 -0
  150. package/core/src/auth/api-key-provider.ts +75 -0
  151. package/core/src/auth/aws-iam-provider.ts +212 -0
  152. package/core/src/auth/azure-ad-provider.ts +126 -0
  153. package/core/src/auth/basic-auth-provider.ts +133 -0
  154. package/core/src/auth/gcp-adc-provider.ts +146 -0
  155. package/core/src/auth/index.ts +342 -0
  156. package/core/src/auth/jwt-provider.ts +193 -0
  157. package/core/src/auth/manager.ts +281 -0
  158. package/core/src/auth/oauth2-provider.ts +141 -0
  159. package/core/src/auth/totp-provider.ts +163 -0
  160. package/core/src/auth/ui-login-provider.ts +242 -0
  161. package/core/src/cache/__tests__/lru-cache.test.ts +564 -0
  162. package/core/src/cache/index.ts +13 -0
  163. package/core/src/cache/lru-cache.ts +536 -0
  164. package/core/src/crawler/__tests__/journey-generator.test.ts +344 -0
  165. package/core/src/crawler/__tests__/selector-generator.test.ts +211 -0
  166. package/core/src/crawler/index.ts +335 -0
  167. package/core/src/crawler/journey-generator.ts +471 -0
  168. package/core/src/crawler/page-analyzer.ts +857 -0
  169. package/core/src/crawler/selector-generator.ts +280 -0
  170. package/core/src/crawler/types.ts +475 -0
  171. package/core/src/dashboard/__tests__/real-world.test.ts +430 -0
  172. package/core/src/dashboard/__tests__/server.test.ts +283 -0
  173. package/core/src/dashboard/__tests__/types.test.ts +208 -0
  174. package/core/src/dashboard/assets.ts +692 -0
  175. package/core/src/dashboard/index.ts +17 -0
  176. package/core/src/dashboard/server.ts +401 -0
  177. package/core/src/dashboard/types.ts +78 -0
  178. package/core/src/discoverer/__tests__/test-discoverer.test.ts +444 -0
  179. package/core/src/discoverer/index.ts +374 -0
  180. package/core/src/flakiness/__tests__/flakiness.test.ts +554 -0
  181. package/core/src/flakiness/index.ts +536 -0
  182. package/core/src/generation/__tests__/code-formatter.test.ts +170 -0
  183. package/core/src/generation/__tests__/code-generator-contract.test.ts +207 -0
  184. package/core/src/generation/__tests__/code-generator.test.ts +586 -0
  185. package/core/src/generation/__tests__/crawler-pack-generator.test.ts +479 -0
  186. package/core/src/generation/__tests__/generation-e2e-b2bshop.test.ts +718 -0
  187. package/core/src/generation/__tests__/generation-integration.test.ts +655 -0
  188. package/core/src/generation/__tests__/pack-generator.test.ts +408 -0
  189. package/core/src/generation/__tests__/prompt-builder.test.ts +200 -0
  190. package/core/src/generation/__tests__/real-provider-integration.test.ts +414 -0
  191. package/core/src/generation/__tests__/source-analyzer.test.ts +774 -0
  192. package/core/src/generation/__tests__/test-optimizer.test.ts +255 -0
  193. package/core/src/generation/code-formatter.ts +408 -0
  194. package/core/src/generation/code-generator.ts +470 -0
  195. package/core/src/generation/crawler-pack-generator.ts +289 -0
  196. package/core/src/generation/generator.ts +113 -0
  197. package/core/src/generation/index.ts +59 -0
  198. package/core/src/generation/pack-generator.ts +527 -0
  199. package/core/src/generation/prompt-builder.ts +772 -0
  200. package/core/src/generation/source-analyzer.ts +830 -0
  201. package/core/src/generation/test-optimizer.ts +474 -0
  202. package/core/src/generation/types.ts +217 -0
  203. package/core/src/hooks/__tests__/compose.test.ts +636 -0
  204. package/core/src/hooks/__tests__/runner.test.ts +478 -0
  205. package/core/src/hooks/compose.ts +268 -0
  206. package/core/src/hooks/runner.ts +364 -0
  207. package/core/src/index.ts +237 -0
  208. package/core/src/pack/__tests__/migrator.test.ts +594 -0
  209. package/core/src/pack/__tests__/validator.test.ts +759 -0
  210. package/core/src/pack/migrator.ts +353 -0
  211. package/core/src/pack/validator.ts +359 -0
  212. package/core/src/pack-v2/__tests__/loader.test.ts +533 -0
  213. package/core/src/pack-v2/__tests__/migrator.test.ts +455 -0
  214. package/core/src/pack-v2/__tests__/validator.test.ts +549 -0
  215. package/core/src/pack-v2/index.ts +41 -0
  216. package/core/src/pack-v2/loader.ts +321 -0
  217. package/core/src/pack-v2/migrator.ts +540 -0
  218. package/core/src/pack-v2/validator.ts +673 -0
  219. package/core/src/parallel/README.md +143 -0
  220. package/core/src/parallel/index.ts +16 -0
  221. package/core/src/parallel/parallel-runner.ts +282 -0
  222. package/core/src/proof/__tests__/proof-roundtrip.test.ts +149 -0
  223. package/core/src/proof/__tests__/schema-validation-manual.mjs +211 -0
  224. package/core/src/proof/__tests__/schema-validation.test.ts +336 -0
  225. package/core/src/proof/__tests__/signer.test.ts +486 -0
  226. package/core/src/proof/__tests__/temporal-regression.test.ts +537 -0
  227. package/core/src/proof/__tests__/verifier-advanced.test.ts +588 -0
  228. package/core/src/proof/__tests__/verifier.test.ts +413 -0
  229. package/core/src/proof/bundle.ts +290 -0
  230. package/core/src/proof/canonicalize.ts +116 -0
  231. package/core/src/proof/index.ts +74 -0
  232. package/core/src/proof/schema.ts +285 -0
  233. package/core/src/proof/signer.ts +293 -0
  234. package/core/src/proof/verifier.ts +380 -0
  235. package/core/src/regression/__tests__/detector.test.ts +396 -0
  236. package/core/src/regression/__tests__/trend-analyzer.test.ts +300 -0
  237. package/core/src/regression/detector.ts +629 -0
  238. package/core/src/regression/index.ts +34 -0
  239. package/core/src/regression/trend-analyzer.ts +468 -0
  240. package/core/src/regression/types.ts +295 -0
  241. package/core/src/regression/vault.ts +419 -0
  242. package/core/src/repair/__tests__/repairer.test.ts +572 -0
  243. package/core/src/repair/__tests__/types.test.ts +302 -0
  244. package/core/src/repair/engine/__tests__/fixer.test.ts +482 -0
  245. package/core/src/repair/engine/__tests__/suggestion-engine.test.ts +395 -0
  246. package/core/src/repair/engine/fixer.ts +271 -0
  247. package/core/src/repair/engine/suggestion-engine.ts +234 -0
  248. package/core/src/repair/index.ts +53 -0
  249. package/core/src/repair/repairer.ts +376 -0
  250. package/core/src/repair/types.ts +119 -0
  251. package/core/src/repair/utils/__tests__/error-analyzer.test.ts +454 -0
  252. package/core/src/repair/utils/error-analyzer.ts +308 -0
  253. package/core/src/reporting/README.md +144 -0
  254. package/core/src/reporting/html-reporter.ts +835 -0
  255. package/core/src/reporting/index.ts +16 -0
  256. package/core/src/retry/README.md +192 -0
  257. package/core/src/retry/__tests__/flakiness-integration.test.ts +475 -0
  258. package/core/src/retry/__tests__/retry-engine.test.ts +424 -0
  259. package/core/src/retry/flakiness-integration.ts +267 -0
  260. package/core/src/retry/index.ts +48 -0
  261. package/core/src/retry/retry-engine.ts +368 -0
  262. package/core/src/retry/types.ts +208 -0
  263. package/core/src/retry/vault.ts +413 -0
  264. package/core/src/runner/__tests__/flakiness-integration.test.ts +566 -0
  265. package/core/src/runner/__tests__/phase3-e2e-b2bshop.test.ts +218 -0
  266. package/core/src/runner/__tests__/phase3-e2e-reqres.test.ts +199 -0
  267. package/core/src/runner/__tests__/phase3-runner.test.ts +1118 -0
  268. package/core/src/runner/e2e-helpers.ts +216 -0
  269. package/core/src/runner/phase3-runner.ts +1236 -0
  270. package/core/src/schemas/gherkin-report.json +122 -0
  271. package/core/src/secrets/__tests__/crypto.test.ts +180 -0
  272. package/core/src/secrets/crypto.ts +289 -0
  273. package/core/src/secrets/manager.ts +272 -0
  274. package/core/src/security/__tests__/hardening.test.ts +480 -0
  275. package/core/src/security/redaction-patterns-extended.ts +278 -0
  276. package/core/src/security/redactor.ts +326 -0
  277. package/core/src/self-healing/assertion-healer.ts +485 -0
  278. package/core/src/self-healing/engine.ts +626 -0
  279. package/core/src/self-healing/index.ts +33 -0
  280. package/core/src/self-healing/selector-healer.ts +488 -0
  281. package/core/src/self-healing/types.ts +193 -0
  282. package/core/src/serve/diagnostics-collector.ts +201 -0
  283. package/core/src/serve/health-checker.ts +274 -0
  284. package/core/src/serve/index.ts +9 -0
  285. package/core/src/serve/metrics-collector.ts +386 -0
  286. package/core/src/serve/process-manager.ts +265 -0
  287. package/core/src/serve/server.ts +230 -0
  288. package/core/src/slo/config.ts +408 -0
  289. package/core/src/slo/index.ts +68 -0
  290. package/core/src/slo/sli-calculator.ts +474 -0
  291. package/core/src/slo/slo-tracker.ts +481 -0
  292. package/core/src/slo/types.ts +408 -0
  293. package/core/src/slo/vault.ts +600 -0
  294. package/core/src/tui/__tests__/monitor.test.ts +336 -0
  295. package/core/src/tui/__tests__/real-world.test.ts +376 -0
  296. package/core/src/tui/__tests__/renderer.test.ts +201 -0
  297. package/core/src/tui/__tests__/types.test.ts +295 -0
  298. package/core/src/tui/index.ts +19 -0
  299. package/core/src/tui/monitor.ts +331 -0
  300. package/core/src/tui/renderer.ts +269 -0
  301. package/core/src/tui/types.ts +68 -0
  302. package/core/src/types/pack-v1.ts +305 -0
  303. package/core/src/types/pack-v2.ts +491 -0
  304. package/core/src/types/trust-score.ts +258 -0
  305. package/core/src/vault/__tests__/flakiness-vault.test.ts +562 -0
  306. package/core/src/vault/__tests__/vault.test.ts +259 -0
  307. package/core/src/vault/cas.ts +323 -0
  308. package/core/src/vault/index.ts +1361 -0
  309. package/core/src/vault/schema.sql +168 -0
  310. package/core/src/visual/README.md +185 -0
  311. package/core/src/visual/index.ts +14 -0
  312. package/core/src/visual/visual-regression.ts +347 -0
  313. package/core/src/watch/__tests__/watch-mode.test.ts +192 -0
  314. package/core/src/watch/index.ts +14 -0
  315. package/core/src/watch/watch-mode.ts +565 -0
  316. package/core/tsconfig.json +12 -0
  317. package/core/vitest.config.ts +52 -0
  318. package/docs/ARCHITECTURE.md +901 -0
  319. package/docs/AUDIT-GLOBAL-DEC2025.md +271 -0
  320. package/docs/BETA_TESTING.md +257 -0
  321. package/docs/BETA_TESTING_PLAN.md +727 -0
  322. package/docs/CERTIFICATION-REPORT.md +142 -0
  323. package/docs/COMPLETE_AUDIT_REFACTORING.md +965 -0
  324. package/docs/DEVELOPMENT.md +331 -0
  325. package/docs/DEVELOPMENT_HISTORY.md +345 -0
  326. package/docs/LIMITATIONS.md +176 -0
  327. package/docs/MIGRATION.md +303 -0
  328. package/docs/OPTION_3_4_EXPLORATION.md +1257 -0
  329. package/docs/PHASE1_PERFORMANCE.md +144 -0
  330. package/docs/QA360_Cloud.postman_collection.json +89 -0
  331. package/docs/README.md +50 -0
  332. package/docs/STATUS.md +179 -0
  333. package/docs/STRATEGIC_STUDY_GOOSE_INTEGRATION.md +615 -0
  334. package/docs/USER_GUIDE.md +687 -0
  335. package/docs/WORK-DONE-ADAPTER-TESTS.md +136 -0
  336. package/docs/adapters-security.md +485 -0
  337. package/docs/architecture-diagram.mmd +168 -0
  338. package/docs/archive/ARCH-01-DAY6-BUILD-FIXES.md +396 -0
  339. package/docs/archive/ARCH-01-DAY6-FINAL-STATUS.md +324 -0
  340. package/docs/archive/ARCH-01_MCP_MERGE_ANALYSIS.md +644 -0
  341. package/docs/archive/ARCH-01_NEXT_STEPS.md +60 -0
  342. package/docs/archive/BRANCH_PROTECTION.md +183 -0
  343. package/docs/archive/CI_LOCKDOWN_CHECKLIST.md +222 -0
  344. package/docs/archive/HANDOFF_TEST-01.md +669 -0
  345. package/docs/archive/LEGAL_READY_PLACEHOLDERS.md +372 -0
  346. package/docs/archive/NODE_UPGRADE_GUIDE.md +188 -0
  347. package/docs/archive/PHASE1_COMPLETION.md +386 -0
  348. package/docs/archive/PHASE2_COMPLETION.md +404 -0
  349. package/docs/archive/PHASE3_AND_4_FINAL.md +360 -0
  350. package/docs/archive/PHASE3_COMPLETE.md +301 -0
  351. package/docs/archive/PHASE3_STATUS.md +255 -0
  352. package/docs/archive/PRE-WEEK2-AUDIT.md +364 -0
  353. package/docs/archive/README.md +33 -0
  354. package/docs/archive/SCHEMA_AJV_2020_FIX.md +245 -0
  355. package/docs/archive/TEST-01_AUDIT_REPORT.md +240 -0
  356. package/docs/archive/TEST-01_COVERAGE_PLAN.md +423 -0
  357. package/docs/budgets-advanced.md +308 -0
  358. package/docs/examples/history-export-gc.md +285 -0
  359. package/docs/examples/pack-v2-complete.yaml +158 -0
  360. package/docs/examples/pack-v2-quickstart.yaml +24 -0
  361. package/docs/examples/pack-v2-ui-login.yaml +81 -0
  362. package/docs/examples/qa360-report.json +50 -0
  363. package/docs/history.md +565 -0
  364. package/docs/hooks.md +304 -0
  365. package/docs/llm-providers.md +419 -0
  366. package/docs/mcp-server.md +651 -0
  367. package/docs/mcp-tools.md +1131 -0
  368. package/docs/pack-v1.md +383 -0
  369. package/docs/pack-v2.md +558 -0
  370. package/docs/proofs.md +670 -0
  371. package/docs/quickstart-5min.md +257 -0
  372. package/docs/readiness-ci.md +654 -0
  373. package/docs/rfc/README.md +20 -0
  374. package/docs/rfc/proof-bundle-v1.md +787 -0
  375. package/docs/secrets.md +392 -0
  376. package/docs/serve.md +494 -0
  377. package/docs/vault.md +491 -0
  378. package/e2e/qa360-e2e.test.ts +696 -0
  379. package/e2e/vitest.config.ts +18 -0
  380. package/examples/README.md +30 -140
  381. package/examples/ci/docker-compose-serve.yml +375 -0
  382. package/examples/ci/github-actions-serve.yml +345 -0
  383. package/examples/ci/gitlab-ci-serve.yml +407 -0
  384. package/examples/datasets/README.md +101 -0
  385. package/examples/datasets/b2bshop.ts +155 -0
  386. package/examples/datasets/index.ts +57 -0
  387. package/examples/datasets/reqres.ts +195 -0
  388. package/examples/future-api/README.md +16 -0
  389. package/examples/future-api/diag.js +7 -0
  390. package/examples/future-api/health.js +4 -0
  391. package/examples/future-api/packs.js +13 -0
  392. package/examples/future-api/runpack.js +10 -0
  393. package/examples/generation/README.md +148 -0
  394. package/examples/generation/pack-generator-example.js +115 -0
  395. package/examples/generation/source-analyzer-example.js +115 -0
  396. package/examples/httpbin/pack.yml +59 -0
  397. package/examples/load-testing/mcp-load.yml +115 -0
  398. package/examples/load-testing/mcp-stdio.yml +95 -0
  399. package/examples/mcp/claude-desktop-config.json +33 -0
  400. package/examples/mcp/claude-desktop.json +16 -0
  401. package/examples/mcp/conversation-sample.md +131 -0
  402. package/examples/mcp/demo-60s.md +330 -0
  403. package/examples/mcp/sample-conversation.jsonl +21 -0
  404. package/examples/mcp/vscode-settings.json +22 -0
  405. package/examples/pack-v2-complete.yml +242 -0
  406. package/examples/pack-v2-examples.md +244 -0
  407. package/examples/pack-v2-quickstart.yml +55 -0
  408. package/examples/packs-business/ecommerce-api.yml +121 -0
  409. package/examples/packs-business/saas-dashboard-ui.yml +133 -0
  410. package/examples/packs-conformance/compose-multi.yml +174 -0
  411. package/examples/packs-conformance/full.yml +152 -0
  412. package/examples/packs-conformance/heavy-artifacts.yml +152 -0
  413. package/examples/packs-conformance/minimal.yml +71 -0
  414. package/examples/packs-conformance/secrets-missing.yml +97 -0
  415. package/examples/packs-conformance/timeouts.yml +77 -0
  416. package/examples/proofs/e2e-playwright-proof.json +75 -0
  417. package/examples/proofs/httpbin-proof.json +69 -0
  418. package/examples/proofs/multi-adapter-proof.json +117 -0
  419. package/examples/proofs/test-proof.json +26 -0
  420. package/examples/restful-api-dev/README.md +102 -0
  421. package/examples/restful-api-dev/restful-api-advanced.yml +29 -0
  422. package/examples/restful-api-dev/restful-api-basic.yml +29 -0
  423. package/examples/web-lite/.github/workflows/qa360-phase3.yml +73 -0
  424. package/examples/web-lite/api-mock/server.js +258 -0
  425. package/examples/web-lite/pack.yml +71 -0
  426. package/examples/web-lite/services.yml +43 -0
  427. package/examples/web-lite/web-content/healthz +1 -0
  428. package/examples/web-lite/web-content/index.html +259 -0
  429. package/package.json +55 -45
  430. package/packages/mcp/CHANGELOG.md +109 -0
  431. package/packages/mcp/IMPLEMENTATION_SUMMARY.md +350 -0
  432. package/packages/mcp/LICENSE +21 -0
  433. package/packages/mcp/QUICK_START.md +291 -0
  434. package/packages/mcp/README.md +294 -0
  435. package/packages/mcp/TELEMETRY.md +220 -0
  436. package/packages/mcp/package.json +92 -0
  437. package/packages/mcp/scripts/generate-sbom-fallback.cjs +84 -0
  438. package/packages/mcp/scripts/safe-postinstall.cjs +32 -0
  439. package/packages/mcp/src/__tests__/contract.test.ts +902 -0
  440. package/packages/mcp/src/cli/cli.ts +137 -0
  441. package/packages/mcp/src/cli/doctor.ts +286 -0
  442. package/packages/mcp/src/cli/fix.ts +99 -0
  443. package/packages/mcp/src/cli/init.ts +233 -0
  444. package/packages/mcp/src/cli/postinstall.ts +14 -0
  445. package/packages/mcp/src/cli/reset.ts +44 -0
  446. package/packages/mcp/src/cli/telemetry.ts +166 -0
  447. package/packages/mcp/src/cli/test-dx.ts +94 -0
  448. package/packages/mcp/src/cli/uninstall.ts +80 -0
  449. package/packages/mcp/src/cli/up.ts +178 -0
  450. package/packages/mcp/src/index.ts +12 -0
  451. package/packages/mcp/src/scripts/e2e-local.ts +337 -0
  452. package/packages/mcp/src/scripts/verify-settings.ts +242 -0
  453. package/packages/mcp/src/security/audit.ts +244 -0
  454. package/packages/mcp/src/security/manager.ts +242 -0
  455. package/packages/mcp/src/server/full-server.ts +212 -0
  456. package/packages/mcp/src/server/minimal-server.ts +134 -0
  457. package/packages/mcp/src/tools/history.ts +388 -0
  458. package/packages/mcp/src/tools/pack.ts +449 -0
  459. package/packages/mcp/src/tools/registry.ts +638 -0
  460. package/packages/mcp/src/tools/report.ts +100 -0
  461. package/packages/mcp/src/tools/run.ts +268 -0
  462. package/packages/mcp/src/tools/secrets.ts +198 -0
  463. package/packages/mcp/src/tools/serve.ts +221 -0
  464. package/packages/mcp/src/tools/triage.ts +532 -0
  465. package/packages/mcp/src/tools/types.ts +26 -0
  466. package/packages/mcp/src/tools/vault.ts +164 -0
  467. package/packages/mcp/src/tools/verify.ts +166 -0
  468. package/packages/mcp/src/types/index.ts +311 -0
  469. package/packages/mcp/src/types/mcp-stubs.ts +83 -0
  470. package/packages/mcp/tsconfig.json +16 -0
  471. package/playwright.config.ts +20 -0
  472. package/pnpm-workspace.yaml +4 -0
  473. package/run-test-and-push.sh +20 -0
  474. package/scripts/build-proof-cli.sh +110 -0
  475. package/scripts/ci/check-windows-paths.js +92 -0
  476. package/scripts/ci/invariants.sh +124 -0
  477. package/scripts/ci/make-final-bundle.js +106 -0
  478. package/scripts/ci/mcp-run-multipack.js +305 -0
  479. package/scripts/ci/run-pack-suite.sh +103 -0
  480. package/scripts/ci/run-phase7-final.sh +190 -0
  481. package/scripts/ci/slo-assert.js +158 -0
  482. package/scripts/ci/test-fault-tolerance.sh +301 -0
  483. package/scripts/install-mcp.sh +66 -0
  484. package/scripts/mcp-smoke.mjs +27 -0
  485. package/scripts/smoke.sh +26 -0
  486. package/scripts/stress-test.js +288 -0
  487. package/scripts/validate-examples.mjs +404 -0
  488. package/scripts/validation/simple-pack-check.sh +51 -0
  489. package/scripts/validation/validate-universal-pack.mjs +77 -0
  490. package/scripts/verify-persistence.js +127 -0
  491. package/test-pack.yaml +43 -0
  492. package/test-results/.last-run.json +4 -0
  493. package/test-runner.mjs +87 -0
  494. package/tests/artifacts.spec.js +147 -0
  495. package/tests/contracts.spec.js +239 -0
  496. package/tests/e2e/assertions.test.mjs +370 -0
  497. package/tests/e2e/crawler.test.mjs +451 -0
  498. package/tests/e2e/playwright-plus-plus.test.mjs +604 -0
  499. package/tests/e2e/proof-bundle.test.mjs +258 -0
  500. package/tests/e2e/real-world/saucedemo.test.mjs +714 -0
  501. package/tests/e2e/real-world/the-internet-herokuapp.test.mjs +760 -0
  502. package/tests/e2e/ui-actions.test.mjs +546 -0
  503. package/tests/gherkin.e2e.spec.ts +310 -0
  504. package/tests/no-console-errors.spec.js +136 -0
  505. package/tests/pdf.spec.ts +252 -0
  506. package/tests/run-pack.spec.ts +58 -0
  507. package/tsconfig.base.json +15 -0
  508. package/tsconfig.build.json +8 -0
  509. package/tsconfig.json +37 -0
  510. package/tsconfig.test.json +18 -0
  511. package/typedoc.json +37 -0
  512. package/ui/README.md +51 -0
  513. package/verify-proof.mjs +60 -0
  514. package/dist/cli-minimal.d.ts +0 -6
  515. package/dist/cli-minimal.js +0 -36
  516. package/dist/commands/ai.d.ts +0 -41
  517. package/dist/commands/ai.js +0 -511
  518. package/dist/commands/ask.d.ts +0 -94
  519. package/dist/commands/ask.js +0 -582
  520. package/dist/commands/coverage.d.ts +0 -8
  521. package/dist/commands/coverage.js +0 -252
  522. package/dist/commands/crawl.d.ts +0 -24
  523. package/dist/commands/crawl.js +0 -121
  524. package/dist/commands/doctor.d.ts +0 -54
  525. package/dist/commands/doctor.js +0 -513
  526. package/dist/commands/examples.d.ts +0 -33
  527. package/dist/commands/examples.js +0 -193
  528. package/dist/commands/explain.d.ts +0 -27
  529. package/dist/commands/explain.js +0 -630
  530. package/dist/commands/flakiness.d.ts +0 -73
  531. package/dist/commands/flakiness.js +0 -435
  532. package/dist/commands/generate.d.ts +0 -66
  533. package/dist/commands/generate.js +0 -438
  534. package/dist/commands/history.d.ts +0 -76
  535. package/dist/commands/history.js +0 -757
  536. package/dist/commands/init.d.ts +0 -106
  537. package/dist/commands/init.js +0 -599
  538. package/dist/commands/monitor.d.ts +0 -27
  539. package/dist/commands/monitor.js +0 -225
  540. package/dist/commands/ollama.d.ts +0 -40
  541. package/dist/commands/ollama.js +0 -301
  542. package/dist/commands/pack.d.ts +0 -70
  543. package/dist/commands/pack.js +0 -413
  544. package/dist/commands/regression.d.ts +0 -8
  545. package/dist/commands/regression.js +0 -340
  546. package/dist/commands/repair.d.ts +0 -26
  547. package/dist/commands/repair.js +0 -307
  548. package/dist/commands/report.d.ts +0 -62
  549. package/dist/commands/report.js +0 -378
  550. package/dist/commands/retry.d.ts +0 -43
  551. package/dist/commands/retry.js +0 -275
  552. package/dist/commands/run.d.ts +0 -41
  553. package/dist/commands/run.js +0 -169
  554. package/dist/commands/scan.d.ts +0 -5
  555. package/dist/commands/scan.js +0 -155
  556. package/dist/commands/secrets.d.ts +0 -58
  557. package/dist/commands/secrets.js +0 -289
  558. package/dist/commands/serve.d.ts +0 -13
  559. package/dist/commands/serve.js +0 -156
  560. package/dist/commands/slo.d.ts +0 -8
  561. package/dist/commands/slo.js +0 -327
  562. package/dist/commands/verify.d.ts +0 -32
  563. package/dist/commands/verify.js +0 -278
  564. package/dist/core/adapters/gitleaks-secrets.d.ts +0 -114
  565. package/dist/core/adapters/gitleaks-secrets.js +0 -410
  566. package/dist/core/adapters/k6-perf.d.ts +0 -85
  567. package/dist/core/adapters/k6-perf.js +0 -398
  568. package/dist/core/adapters/osv-deps.d.ts +0 -123
  569. package/dist/core/adapters/osv-deps.js +0 -372
  570. package/dist/core/adapters/playwright-native-adapter.d.ts +0 -121
  571. package/dist/core/adapters/playwright-native-adapter.js +0 -339
  572. package/dist/core/adapters/playwright-native-api.d.ts +0 -183
  573. package/dist/core/adapters/playwright-native-api.js +0 -461
  574. package/dist/core/adapters/playwright-ui.d.ts +0 -197
  575. package/dist/core/adapters/playwright-ui.js +0 -840
  576. package/dist/core/adapters/semgrep-sast.d.ts +0 -99
  577. package/dist/core/adapters/semgrep-sast.js +0 -322
  578. package/dist/core/adapters/zap-dast.d.ts +0 -133
  579. package/dist/core/adapters/zap-dast.js +0 -424
  580. package/dist/core/ai/anthropic-provider.d.ts +0 -50
  581. package/dist/core/ai/anthropic-provider.js +0 -211
  582. package/dist/core/ai/deepseek-provider.d.ts +0 -81
  583. package/dist/core/ai/deepseek-provider.js +0 -254
  584. package/dist/core/ai/index.d.ts +0 -60
  585. package/dist/core/ai/index.js +0 -18
  586. package/dist/core/ai/llm-client.d.ts +0 -45
  587. package/dist/core/ai/llm-client.js +0 -7
  588. package/dist/core/ai/mock-provider.d.ts +0 -49
  589. package/dist/core/ai/mock-provider.js +0 -121
  590. package/dist/core/ai/ollama-provider.d.ts +0 -78
  591. package/dist/core/ai/ollama-provider.js +0 -192
  592. package/dist/core/ai/openai-provider.d.ts +0 -48
  593. package/dist/core/ai/openai-provider.js +0 -188
  594. package/dist/core/ai/provider-factory.d.ts +0 -160
  595. package/dist/core/ai/provider-factory.js +0 -269
  596. package/dist/core/artifacts/index.d.ts +0 -6
  597. package/dist/core/artifacts/index.js +0 -6
  598. package/dist/core/artifacts/ui-artifacts.d.ts +0 -133
  599. package/dist/core/artifacts/ui-artifacts.js +0 -304
  600. package/dist/core/assertions/engine.d.ts +0 -51
  601. package/dist/core/assertions/engine.js +0 -530
  602. package/dist/core/assertions/index.d.ts +0 -11
  603. package/dist/core/assertions/index.js +0 -11
  604. package/dist/core/assertions/types.d.ts +0 -121
  605. package/dist/core/assertions/types.js +0 -37
  606. package/dist/core/auth/api-key-provider.d.ts +0 -16
  607. package/dist/core/auth/api-key-provider.js +0 -63
  608. package/dist/core/auth/aws-iam-provider.d.ts +0 -35
  609. package/dist/core/auth/aws-iam-provider.js +0 -177
  610. package/dist/core/auth/azure-ad-provider.d.ts +0 -15
  611. package/dist/core/auth/azure-ad-provider.js +0 -99
  612. package/dist/core/auth/basic-auth-provider.d.ts +0 -26
  613. package/dist/core/auth/basic-auth-provider.js +0 -111
  614. package/dist/core/auth/gcp-adc-provider.d.ts +0 -27
  615. package/dist/core/auth/gcp-adc-provider.js +0 -126
  616. package/dist/core/auth/index.d.ts +0 -238
  617. package/dist/core/auth/index.js +0 -82
  618. package/dist/core/auth/jwt-provider.d.ts +0 -19
  619. package/dist/core/auth/jwt-provider.js +0 -160
  620. package/dist/core/auth/manager.d.ts +0 -84
  621. package/dist/core/auth/manager.js +0 -230
  622. package/dist/core/auth/oauth2-provider.d.ts +0 -17
  623. package/dist/core/auth/oauth2-provider.js +0 -114
  624. package/dist/core/auth/totp-provider.d.ts +0 -31
  625. package/dist/core/auth/totp-provider.js +0 -134
  626. package/dist/core/auth/ui-login-provider.d.ts +0 -26
  627. package/dist/core/auth/ui-login-provider.js +0 -198
  628. package/dist/core/cache/index.d.ts +0 -7
  629. package/dist/core/cache/index.js +0 -6
  630. package/dist/core/cache/lru-cache.d.ts +0 -203
  631. package/dist/core/cache/lru-cache.js +0 -397
  632. package/dist/core/core/coverage/analyzer.d.ts +0 -101
  633. package/dist/core/core/coverage/analyzer.js +0 -415
  634. package/dist/core/core/coverage/collector.d.ts +0 -74
  635. package/dist/core/core/coverage/collector.js +0 -459
  636. package/dist/core/core/coverage/config.d.ts +0 -37
  637. package/dist/core/core/coverage/config.js +0 -156
  638. package/dist/core/core/coverage/index.d.ts +0 -11
  639. package/dist/core/core/coverage/index.js +0 -15
  640. package/dist/core/core/coverage/types.d.ts +0 -267
  641. package/dist/core/core/coverage/types.js +0 -6
  642. package/dist/core/core/coverage/vault.d.ts +0 -95
  643. package/dist/core/core/coverage/vault.js +0 -405
  644. package/dist/core/coverage/analyzer.d.ts +0 -101
  645. package/dist/core/coverage/analyzer.js +0 -415
  646. package/dist/core/coverage/collector.d.ts +0 -74
  647. package/dist/core/coverage/collector.js +0 -459
  648. package/dist/core/coverage/config.d.ts +0 -37
  649. package/dist/core/coverage/config.js +0 -156
  650. package/dist/core/coverage/index.d.ts +0 -11
  651. package/dist/core/coverage/index.js +0 -15
  652. package/dist/core/coverage/types.d.ts +0 -267
  653. package/dist/core/coverage/types.js +0 -6
  654. package/dist/core/coverage/vault.d.ts +0 -95
  655. package/dist/core/coverage/vault.js +0 -405
  656. package/dist/core/crawler/index.d.ts +0 -57
  657. package/dist/core/crawler/index.js +0 -281
  658. package/dist/core/crawler/journey-generator.d.ts +0 -49
  659. package/dist/core/crawler/journey-generator.js +0 -412
  660. package/dist/core/crawler/page-analyzer.d.ts +0 -88
  661. package/dist/core/crawler/page-analyzer.js +0 -709
  662. package/dist/core/crawler/selector-generator.d.ts +0 -34
  663. package/dist/core/crawler/selector-generator.js +0 -240
  664. package/dist/core/crawler/types.d.ts +0 -353
  665. package/dist/core/crawler/types.js +0 -6
  666. package/dist/core/dashboard/assets.d.ts +0 -6
  667. package/dist/core/dashboard/assets.js +0 -690
  668. package/dist/core/dashboard/index.d.ts +0 -6
  669. package/dist/core/dashboard/index.js +0 -5
  670. package/dist/core/dashboard/server.d.ts +0 -72
  671. package/dist/core/dashboard/server.js +0 -354
  672. package/dist/core/dashboard/types.d.ts +0 -70
  673. package/dist/core/dashboard/types.js +0 -5
  674. package/dist/core/discoverer/index.d.ts +0 -115
  675. package/dist/core/discoverer/index.js +0 -250
  676. package/dist/core/flakiness/index.d.ts +0 -228
  677. package/dist/core/flakiness/index.js +0 -384
  678. package/dist/core/generation/code-formatter.d.ts +0 -111
  679. package/dist/core/generation/code-formatter.js +0 -307
  680. package/dist/core/generation/code-generator.d.ts +0 -144
  681. package/dist/core/generation/code-generator.js +0 -293
  682. package/dist/core/generation/crawler-pack-generator.d.ts +0 -44
  683. package/dist/core/generation/crawler-pack-generator.js +0 -231
  684. package/dist/core/generation/generator.d.ts +0 -40
  685. package/dist/core/generation/generator.js +0 -76
  686. package/dist/core/generation/index.d.ts +0 -32
  687. package/dist/core/generation/index.js +0 -30
  688. package/dist/core/generation/pack-generator.d.ts +0 -107
  689. package/dist/core/generation/pack-generator.js +0 -416
  690. package/dist/core/generation/prompt-builder.d.ts +0 -132
  691. package/dist/core/generation/prompt-builder.js +0 -672
  692. package/dist/core/generation/source-analyzer.d.ts +0 -213
  693. package/dist/core/generation/source-analyzer.js +0 -657
  694. package/dist/core/generation/test-optimizer.d.ts +0 -117
  695. package/dist/core/generation/test-optimizer.js +0 -328
  696. package/dist/core/generation/types.d.ts +0 -214
  697. package/dist/core/generation/types.js +0 -4
  698. package/dist/core/hooks/compose.d.ts +0 -61
  699. package/dist/core/hooks/compose.js +0 -225
  700. package/dist/core/hooks/runner.d.ts +0 -68
  701. package/dist/core/hooks/runner.js +0 -303
  702. package/dist/core/index.d.ts +0 -104
  703. package/dist/core/index.js +0 -91
  704. package/dist/core/pack/migrator.d.ts +0 -51
  705. package/dist/core/pack/migrator.js +0 -304
  706. package/dist/core/pack/validator.d.ts +0 -42
  707. package/dist/core/pack/validator.js +0 -322
  708. package/dist/core/pack-v2/index.d.ts +0 -9
  709. package/dist/core/pack-v2/index.js +0 -8
  710. package/dist/core/pack-v2/loader.d.ts +0 -62
  711. package/dist/core/pack-v2/loader.js +0 -259
  712. package/dist/core/pack-v2/migrator.d.ts +0 -61
  713. package/dist/core/pack-v2/migrator.js +0 -480
  714. package/dist/core/pack-v2/validator.d.ts +0 -61
  715. package/dist/core/pack-v2/validator.js +0 -577
  716. package/dist/core/parallel/index.d.ts +0 -6
  717. package/dist/core/parallel/index.js +0 -6
  718. package/dist/core/parallel/parallel-runner.d.ts +0 -107
  719. package/dist/core/parallel/parallel-runner.js +0 -192
  720. package/dist/core/proof/bundle.d.ts +0 -137
  721. package/dist/core/proof/bundle.js +0 -160
  722. package/dist/core/proof/canonicalize.d.ts +0 -47
  723. package/dist/core/proof/canonicalize.js +0 -105
  724. package/dist/core/proof/index.d.ts +0 -13
  725. package/dist/core/proof/index.js +0 -18
  726. package/dist/core/proof/schema.d.ts +0 -217
  727. package/dist/core/proof/schema.js +0 -263
  728. package/dist/core/proof/signer.d.ts +0 -111
  729. package/dist/core/proof/signer.js +0 -226
  730. package/dist/core/proof/verifier.d.ts +0 -97
  731. package/dist/core/proof/verifier.js +0 -308
  732. package/dist/core/regression/detector.d.ts +0 -107
  733. package/dist/core/regression/detector.js +0 -497
  734. package/dist/core/regression/index.d.ts +0 -9
  735. package/dist/core/regression/index.js +0 -11
  736. package/dist/core/regression/trend-analyzer.d.ts +0 -102
  737. package/dist/core/regression/trend-analyzer.js +0 -345
  738. package/dist/core/regression/types.d.ts +0 -222
  739. package/dist/core/regression/types.js +0 -7
  740. package/dist/core/regression/vault.d.ts +0 -87
  741. package/dist/core/regression/vault.js +0 -289
  742. package/dist/core/repair/engine/fixer.d.ts +0 -24
  743. package/dist/core/repair/engine/fixer.js +0 -226
  744. package/dist/core/repair/engine/suggestion-engine.d.ts +0 -18
  745. package/dist/core/repair/engine/suggestion-engine.js +0 -187
  746. package/dist/core/repair/index.d.ts +0 -10
  747. package/dist/core/repair/index.js +0 -13
  748. package/dist/core/repair/repairer.d.ts +0 -90
  749. package/dist/core/repair/repairer.js +0 -284
  750. package/dist/core/repair/types.d.ts +0 -91
  751. package/dist/core/repair/types.js +0 -6
  752. package/dist/core/repair/utils/error-analyzer.d.ts +0 -28
  753. package/dist/core/repair/utils/error-analyzer.js +0 -264
  754. package/dist/core/reporting/html-reporter.d.ts +0 -119
  755. package/dist/core/reporting/html-reporter.js +0 -737
  756. package/dist/core/reporting/index.d.ts +0 -6
  757. package/dist/core/reporting/index.js +0 -6
  758. package/dist/core/retry/flakiness-integration.d.ts +0 -60
  759. package/dist/core/retry/flakiness-integration.js +0 -228
  760. package/dist/core/retry/index.d.ts +0 -14
  761. package/dist/core/retry/index.js +0 -16
  762. package/dist/core/retry/retry-engine.d.ts +0 -80
  763. package/dist/core/retry/retry-engine.js +0 -296
  764. package/dist/core/retry/types.d.ts +0 -178
  765. package/dist/core/retry/types.js +0 -52
  766. package/dist/core/retry/vault.d.ts +0 -77
  767. package/dist/core/retry/vault.js +0 -304
  768. package/dist/core/runner/e2e-helpers.d.ts +0 -102
  769. package/dist/core/runner/e2e-helpers.js +0 -153
  770. package/dist/core/runner/phase3-runner.d.ts +0 -200
  771. package/dist/core/runner/phase3-runner.js +0 -1039
  772. package/dist/core/secrets/crypto.d.ts +0 -75
  773. package/dist/core/secrets/crypto.js +0 -223
  774. package/dist/core/secrets/manager.d.ts +0 -76
  775. package/dist/core/secrets/manager.js +0 -219
  776. package/dist/core/security/redaction-patterns-extended.d.ts +0 -27
  777. package/dist/core/security/redaction-patterns-extended.js +0 -247
  778. package/dist/core/security/redactor.d.ts +0 -71
  779. package/dist/core/security/redactor.js +0 -279
  780. package/dist/core/self-healing/assertion-healer.d.ts +0 -97
  781. package/dist/core/self-healing/assertion-healer.js +0 -371
  782. package/dist/core/self-healing/engine.d.ts +0 -122
  783. package/dist/core/self-healing/engine.js +0 -538
  784. package/dist/core/self-healing/index.d.ts +0 -10
  785. package/dist/core/self-healing/index.js +0 -11
  786. package/dist/core/self-healing/selector-healer.d.ts +0 -103
  787. package/dist/core/self-healing/selector-healer.js +0 -372
  788. package/dist/core/self-healing/types.d.ts +0 -152
  789. package/dist/core/self-healing/types.js +0 -6
  790. package/dist/core/serve/diagnostics-collector.d.ts +0 -32
  791. package/dist/core/serve/diagnostics-collector.js +0 -149
  792. package/dist/core/serve/health-checker.d.ts +0 -44
  793. package/dist/core/serve/health-checker.js +0 -219
  794. package/dist/core/serve/index.d.ts +0 -8
  795. package/dist/core/serve/index.js +0 -8
  796. package/dist/core/serve/metrics-collector.d.ts +0 -24
  797. package/dist/core/serve/metrics-collector.js +0 -322
  798. package/dist/core/serve/process-manager.d.ts +0 -36
  799. package/dist/core/serve/process-manager.js +0 -213
  800. package/dist/core/serve/server.d.ts +0 -36
  801. package/dist/core/serve/server.js +0 -191
  802. package/dist/core/slo/config.d.ts +0 -107
  803. package/dist/core/slo/config.js +0 -360
  804. package/dist/core/slo/index.d.ts +0 -11
  805. package/dist/core/slo/index.js +0 -15
  806. package/dist/core/slo/sli-calculator.d.ts +0 -92
  807. package/dist/core/slo/sli-calculator.js +0 -364
  808. package/dist/core/slo/slo-tracker.d.ts +0 -148
  809. package/dist/core/slo/slo-tracker.js +0 -379
  810. package/dist/core/slo/types.d.ts +0 -281
  811. package/dist/core/slo/types.js +0 -7
  812. package/dist/core/slo/vault.d.ts +0 -102
  813. package/dist/core/slo/vault.js +0 -427
  814. package/dist/core/tui/index.d.ts +0 -7
  815. package/dist/core/tui/index.js +0 -6
  816. package/dist/core/tui/monitor.d.ts +0 -92
  817. package/dist/core/tui/monitor.js +0 -271
  818. package/dist/core/tui/renderer.d.ts +0 -33
  819. package/dist/core/tui/renderer.js +0 -218
  820. package/dist/core/tui/types.d.ts +0 -63
  821. package/dist/core/tui/types.js +0 -5
  822. package/dist/core/types/pack-v1.d.ts +0 -251
  823. package/dist/core/types/pack-v1.js +0 -5
  824. package/dist/core/types/pack-v2.d.ts +0 -425
  825. package/dist/core/types/pack-v2.js +0 -8
  826. package/dist/core/types/trust-score.d.ts +0 -69
  827. package/dist/core/types/trust-score.js +0 -191
  828. package/dist/core/vault/cas.d.ts +0 -90
  829. package/dist/core/vault/cas.js +0 -261
  830. package/dist/core/vault/index.d.ts +0 -326
  831. package/dist/core/vault/index.js +0 -1042
  832. package/dist/core/visual/index.d.ts +0 -6
  833. package/dist/core/visual/index.js +0 -6
  834. package/dist/core/visual/visual-regression.d.ts +0 -113
  835. package/dist/core/visual/visual-regression.js +0 -236
  836. package/dist/core/watch/index.d.ts +0 -7
  837. package/dist/core/watch/index.js +0 -6
  838. package/dist/core/watch/watch-mode.d.ts +0 -213
  839. package/dist/core/watch/watch-mode.js +0 -389
  840. package/dist/generators/index.d.ts +0 -5
  841. package/dist/generators/index.js +0 -5
  842. package/dist/generators/json-reporter.d.ts +0 -10
  843. package/dist/generators/json-reporter.js +0 -12
  844. package/dist/generators/test-generator.d.ts +0 -18
  845. package/dist/generators/test-generator.js +0 -78
  846. package/dist/index.d.ts +0 -8
  847. package/dist/index.js +0 -246
  848. package/dist/scanners/dom-scanner.d.ts +0 -52
  849. package/dist/scanners/dom-scanner.js +0 -296
  850. package/dist/scanners/index.d.ts +0 -4
  851. package/dist/scanners/index.js +0 -4
  852. package/dist/schemas/pack.schema.json +0 -236
  853. package/dist/types/scan.d.ts +0 -68
  854. package/dist/types/scan.js +0 -4
  855. package/dist/utils/config.d.ts +0 -5
  856. package/dist/utils/config.js +0 -136
  857. /package/{bin → cli/bin}/qa360.js +0 -0
  858. /package/{examples → cli/examples}/accessibility.yml +0 -0
  859. /package/{examples → cli/examples}/api-basic.yml +0 -0
  860. /package/{examples → cli/examples}/complete.yml +0 -0
  861. /package/{examples → cli/examples}/crawler.yml +0 -0
  862. /package/{examples → cli/examples}/fullstack.yml +0 -0
  863. /package/{examples → cli/examples}/security.yml +0 -0
  864. /package/{examples → cli/examples}/ui-advanced.yml +0 -0
  865. /package/{examples → cli/examples}/ui-basic.yml +0 -0
  866. /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
+ });