@llipe.com/dev-tasks 0.10.0 → 0.16.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 (620) hide show
  1. package/.claude/agents/developer.md +108 -35
  2. package/.claude/agents/github-ops.md +48 -4
  3. package/.claude/agents/housekeeping.md +44 -7
  4. package/.claude/agents/qa-engineer.md +45 -3
  5. package/.claude/agents/researcher.md +116 -0
  6. package/.claude/agents/technical-writer.md +61 -6
  7. package/.claude/agents/ux-engineer.md +1 -0
  8. package/.claude/agents/verifier.md +48 -6
  9. package/.claude/commands/developer.md +2 -266
  10. package/.claude/commands/infra-engineer.md +92 -0
  11. package/.claude/commands/planner.md +64 -28
  12. package/.claude/commands/product-engineer.md +58 -19
  13. package/.claude/commands/researcher.md +27 -0
  14. package/.claude/commands/technical-writer.md +1 -1
  15. package/.claude/hooks/branch-guard.sh +30 -0
  16. package/.claude/hooks/git-guard.sh +483 -22
  17. package/.claude/skills/activity-codebase-research/SKILL.md +151 -0
  18. package/.claude/skills/activity-e2e-test-implementation/SKILL.md +156 -0
  19. package/.claude/skills/activity-generate-spec/SKILL.md +34 -10
  20. package/.claude/skills/activity-grill/SKILL.md +150 -0
  21. package/.claude/skills/activity-init/SKILL.md +121 -71
  22. package/.claude/skills/activity-integration-test-implementation/SKILL.md +156 -0
  23. package/.claude/skills/activity-refine/SKILL.md +75 -15
  24. package/.claude/skills/activity-test-standards/SKILL.md +66 -0
  25. package/.claude/skills/aws-ops/SKILL.md +155 -0
  26. package/.claude/skills/deploy-ops/SKILL.md +121 -0
  27. package/.claude/skills/fly-ops/SKILL.md +138 -0
  28. package/.claude/skills/git-ops/SKILL.md +27 -7
  29. package/.claude/skills/implement/SKILL.md +49 -4
  30. package/.claude/skills/memo-cli-usage/REFERENCE.md +230 -17
  31. package/.claude/skills/memo-cli-usage/SKILL.md +66 -13
  32. package/.claude/skills/plan/SKILL.md +43 -1
  33. package/.claude/skills/supabase-ops/SKILL.md +109 -0
  34. package/.github/agents/developer.agent.md +80 -18
  35. package/.github/agents/github-ops.agent.md +46 -4
  36. package/.github/agents/housekeeping.agent.md +43 -7
  37. package/.github/agents/infra-engineer.agent.md +139 -0
  38. package/.github/agents/planner.agent.md +45 -9
  39. package/.github/agents/product-engineer.agent.md +58 -19
  40. package/.github/agents/qa-engineer.agent.md +43 -4
  41. package/.github/agents/researcher.agent.md +115 -0
  42. package/.github/agents/technical-writer.agent.md +60 -6
  43. package/.github/agents/verifier.agent.md +46 -5
  44. package/.github/instructions/implement.instructions.md +49 -4
  45. package/.github/instructions/plan.instructions.md +43 -1
  46. package/.github/prompts/infra-engineer.prompt.md +12 -0
  47. package/.github/prompts/product-engineer-init.prompt.md +5 -6
  48. package/.github/prompts/researcher.prompt.md +28 -0
  49. package/.github/prompts/technical-writer.prompt.md +1 -1
  50. package/.github/skills/activity-codebase-research/SKILL.md +146 -0
  51. package/.github/skills/activity-e2e-test-implementation/SKILL.md +156 -0
  52. package/.github/skills/activity-generate-spec/SKILL.md +34 -10
  53. package/.github/skills/activity-grill/SKILL.md +145 -0
  54. package/.github/skills/activity-init/SKILL.md +120 -70
  55. package/.github/skills/activity-integration-test-implementation/SKILL.md +156 -0
  56. package/.github/skills/activity-refine/SKILL.md +75 -15
  57. package/.github/skills/activity-test-standards/SKILL.md +66 -0
  58. package/.github/skills/aws-ops/SKILL.md +150 -0
  59. package/.github/skills/deploy-ops/SKILL.md +116 -0
  60. package/.github/skills/fly-ops/SKILL.md +133 -0
  61. package/.github/skills/git-ops/SKILL.md +27 -7
  62. package/.github/skills/memo-cli-usage/REFERENCE.md +230 -17
  63. package/.github/skills/memo-cli-usage/SKILL.md +66 -13
  64. package/.github/skills/supabase-ops/SKILL.md +104 -0
  65. package/.kiro/agents/developer.md +81 -19
  66. package/.kiro/agents/github-ops.md +46 -4
  67. package/.kiro/agents/housekeeping.md +44 -8
  68. package/.kiro/agents/infra-engineer.md +102 -0
  69. package/.kiro/agents/planner.md +53 -20
  70. package/.kiro/agents/product-engineer.md +61 -22
  71. package/.kiro/agents/qa-engineer.md +44 -5
  72. package/.kiro/agents/researcher.md +118 -0
  73. package/.kiro/agents/technical-writer.md +63 -9
  74. package/.kiro/agents/verifier.md +48 -7
  75. package/.kiro/skills/activity-codebase-research/SKILL.md +151 -0
  76. package/.kiro/skills/activity-e2e-test-implementation/SKILL.md +156 -0
  77. package/.kiro/skills/activity-generate-spec/SKILL.md +34 -10
  78. package/.kiro/skills/activity-grill/SKILL.md +150 -0
  79. package/.kiro/skills/activity-init/SKILL.md +121 -71
  80. package/.kiro/skills/activity-integration-test-implementation/SKILL.md +156 -0
  81. package/.kiro/skills/activity-refine/SKILL.md +75 -15
  82. package/.kiro/skills/activity-test-standards/SKILL.md +66 -0
  83. package/.kiro/skills/aws-ops/SKILL.md +155 -0
  84. package/.kiro/skills/deploy-ops/SKILL.md +121 -0
  85. package/.kiro/skills/fly-ops/SKILL.md +138 -0
  86. package/.kiro/skills/git-ops/SKILL.md +27 -7
  87. package/.kiro/skills/memo-cli-usage/REFERENCE.md +230 -17
  88. package/.kiro/skills/memo-cli-usage/SKILL.md +66 -13
  89. package/.kiro/skills/supabase-ops/SKILL.md +109 -0
  90. package/.kiro/steering/implement.md +49 -4
  91. package/.kiro/steering/plan.md +43 -1
  92. package/AGENTS.md +88 -261
  93. package/AGENTS.md.template +124 -0
  94. package/CHANGELOG.md +196 -0
  95. package/CLAUDE.md +24 -18
  96. package/CLAUDE.md.template +103 -0
  97. package/README.md +168 -145
  98. package/TESTING.md +84 -140
  99. package/bundle-manifest.json +43 -2
  100. package/dist/bin/dev-tasks.js +65 -3
  101. package/dist/bin/dev-tasks.js.map +1 -1
  102. package/dist/{adapters/cli → bin}/parse-args.d.ts +2 -6
  103. package/dist/bin/parse-args.d.ts.map +1 -0
  104. package/dist/{adapters/cli → bin}/parse-args.js +2 -18
  105. package/dist/bin/parse-args.js.map +1 -0
  106. package/dist/core/checks/decision-log-format.d.ts +44 -0
  107. package/dist/core/checks/decision-log-format.d.ts.map +1 -0
  108. package/dist/core/checks/decision-log-format.js +171 -0
  109. package/dist/core/checks/decision-log-format.js.map +1 -0
  110. package/dist/core/checks/docs-structure.d.ts +82 -0
  111. package/dist/core/checks/docs-structure.d.ts.map +1 -0
  112. package/dist/core/checks/docs-structure.js +285 -0
  113. package/dist/core/checks/docs-structure.js.map +1 -0
  114. package/dist/core/checks/glossary.d.ts +178 -0
  115. package/dist/core/checks/glossary.d.ts.map +1 -0
  116. package/dist/core/checks/glossary.js +651 -0
  117. package/dist/core/checks/glossary.js.map +1 -0
  118. package/dist/core/checks/index.d.ts +19 -0
  119. package/dist/core/checks/index.d.ts.map +1 -0
  120. package/dist/core/checks/index.js +16 -0
  121. package/dist/core/checks/index.js.map +1 -0
  122. package/dist/core/checks/run.d.ts +22 -0
  123. package/dist/core/checks/run.d.ts.map +1 -0
  124. package/dist/core/checks/run.js +51 -0
  125. package/dist/core/checks/run.js.map +1 -0
  126. package/dist/core/distribution/doctor.d.ts +46 -1
  127. package/dist/core/distribution/doctor.d.ts.map +1 -1
  128. package/dist/core/distribution/doctor.js +161 -2
  129. package/dist/core/distribution/doctor.js.map +1 -1
  130. package/dist/core/distribution/index.d.ts +9 -3
  131. package/dist/core/distribution/index.d.ts.map +1 -1
  132. package/dist/core/distribution/index.js +5 -2
  133. package/dist/core/distribution/index.js.map +1 -1
  134. package/dist/core/distribution/install-if-absent.d.ts +46 -0
  135. package/dist/core/distribution/install-if-absent.d.ts.map +1 -0
  136. package/dist/core/distribution/install-if-absent.js +81 -0
  137. package/dist/core/distribution/install-if-absent.js.map +1 -0
  138. package/dist/core/distribution/install.d.ts.map +1 -1
  139. package/dist/core/distribution/install.js +5 -0
  140. package/dist/core/distribution/install.js.map +1 -1
  141. package/dist/core/distribution/migrate-docs.d.ts +64 -0
  142. package/dist/core/distribution/migrate-docs.d.ts.map +1 -0
  143. package/dist/core/distribution/migrate-docs.js +139 -0
  144. package/dist/core/distribution/migrate-docs.js.map +1 -0
  145. package/dist/core/distribution/profiles.d.ts +49 -0
  146. package/dist/core/distribution/profiles.d.ts.map +1 -1
  147. package/dist/core/distribution/profiles.js +45 -0
  148. package/dist/core/distribution/profiles.js.map +1 -1
  149. package/dist/core/distribution/update.d.ts +14 -0
  150. package/dist/core/distribution/update.d.ts.map +1 -1
  151. package/dist/core/distribution/update.js +77 -3
  152. package/dist/core/distribution/update.js.map +1 -1
  153. package/dist/core/distribution/workspace.d.ts +84 -0
  154. package/dist/core/distribution/workspace.d.ts.map +1 -0
  155. package/dist/core/distribution/workspace.js +276 -0
  156. package/dist/core/distribution/workspace.js.map +1 -0
  157. package/dist/core/exit-codes.d.ts +15 -35
  158. package/dist/core/exit-codes.d.ts.map +1 -1
  159. package/dist/core/exit-codes.js +15 -36
  160. package/dist/core/exit-codes.js.map +1 -1
  161. package/dist/core/index.d.ts +1 -6
  162. package/dist/core/index.d.ts.map +1 -1
  163. package/dist/core/index.js +1 -7
  164. package/dist/core/index.js.map +1 -1
  165. package/package.json +17 -32
  166. package/templates/claude/settings.json +48 -0
  167. package/templates/domain/ubiquitous-language.md +28 -0
  168. package/templates/infra/environments.yaml +16 -0
  169. package/templates/infra/redaction-patterns.txt +47 -0
  170. package/templates/runbooks/README.md +14 -0
  171. package/templates/runbooks/runbook-template.md +40 -0
  172. package/templates/scripts/deploy-status.sh +89 -0
  173. package/templates/scripts/deploy-verify.sh +85 -0
  174. package/templates/scripts/deploy.sh +284 -0
  175. package/templates/scripts/release.sh +170 -0
  176. package/templates/scripts/rollback.sh +109 -0
  177. package/templates/workflows/deploy-dev.yml +66 -0
  178. package/templates/workflows/deploy-prod.yml +66 -0
  179. package/templates/workflows/rollback.yml +77 -0
  180. package/dist/adapters/cli/catalog-build.d.ts +0 -30
  181. package/dist/adapters/cli/catalog-build.d.ts.map +0 -1
  182. package/dist/adapters/cli/catalog-build.js +0 -73
  183. package/dist/adapters/cli/catalog-build.js.map +0 -1
  184. package/dist/adapters/cli/catalog-query.d.ts +0 -13
  185. package/dist/adapters/cli/catalog-query.d.ts.map +0 -1
  186. package/dist/adapters/cli/catalog-query.js +0 -329
  187. package/dist/adapters/cli/catalog-query.js.map +0 -1
  188. package/dist/adapters/cli/catalog-scaffold.d.ts +0 -24
  189. package/dist/adapters/cli/catalog-scaffold.d.ts.map +0 -1
  190. package/dist/adapters/cli/catalog-scaffold.js +0 -46
  191. package/dist/adapters/cli/catalog-scaffold.js.map +0 -1
  192. package/dist/adapters/cli/catalog-validate.d.ts +0 -35
  193. package/dist/adapters/cli/catalog-validate.d.ts.map +0 -1
  194. package/dist/adapters/cli/catalog-validate.js +0 -122
  195. package/dist/adapters/cli/catalog-validate.js.map +0 -1
  196. package/dist/adapters/cli/ctx-assemble.d.ts +0 -19
  197. package/dist/adapters/cli/ctx-assemble.d.ts.map +0 -1
  198. package/dist/adapters/cli/ctx-assemble.js +0 -293
  199. package/dist/adapters/cli/ctx-assemble.js.map +0 -1
  200. package/dist/adapters/cli/ctx-fetch.d.ts +0 -49
  201. package/dist/adapters/cli/ctx-fetch.d.ts.map +0 -1
  202. package/dist/adapters/cli/ctx-fetch.js +0 -267
  203. package/dist/adapters/cli/ctx-fetch.js.map +0 -1
  204. package/dist/adapters/cli/extract-all.d.ts +0 -31
  205. package/dist/adapters/cli/extract-all.d.ts.map +0 -1
  206. package/dist/adapters/cli/extract-all.js +0 -374
  207. package/dist/adapters/cli/extract-all.js.map +0 -1
  208. package/dist/adapters/cli/extract-asyncapi.d.ts +0 -26
  209. package/dist/adapters/cli/extract-asyncapi.d.ts.map +0 -1
  210. package/dist/adapters/cli/extract-asyncapi.js +0 -142
  211. package/dist/adapters/cli/extract-asyncapi.js.map +0 -1
  212. package/dist/adapters/cli/extract-component.d.ts +0 -24
  213. package/dist/adapters/cli/extract-component.d.ts.map +0 -1
  214. package/dist/adapters/cli/extract-component.js +0 -198
  215. package/dist/adapters/cli/extract-component.js.map +0 -1
  216. package/dist/adapters/cli/extract-detect.d.ts +0 -19
  217. package/dist/adapters/cli/extract-detect.d.ts.map +0 -1
  218. package/dist/adapters/cli/extract-detect.js +0 -98
  219. package/dist/adapters/cli/extract-detect.js.map +0 -1
  220. package/dist/adapters/cli/extract-openapi.d.ts +0 -29
  221. package/dist/adapters/cli/extract-openapi.d.ts.map +0 -1
  222. package/dist/adapters/cli/extract-openapi.js +0 -111
  223. package/dist/adapters/cli/extract-openapi.js.map +0 -1
  224. package/dist/adapters/cli/extract-schema.d.ts +0 -15
  225. package/dist/adapters/cli/extract-schema.d.ts.map +0 -1
  226. package/dist/adapters/cli/extract-schema.js +0 -39
  227. package/dist/adapters/cli/extract-schema.js.map +0 -1
  228. package/dist/adapters/cli/index.d.ts +0 -6
  229. package/dist/adapters/cli/index.d.ts.map +0 -1
  230. package/dist/adapters/cli/index.js +0 -5
  231. package/dist/adapters/cli/index.js.map +0 -1
  232. package/dist/adapters/cli/init.d.ts +0 -37
  233. package/dist/adapters/cli/init.d.ts.map +0 -1
  234. package/dist/adapters/cli/init.js +0 -336
  235. package/dist/adapters/cli/init.js.map +0 -1
  236. package/dist/adapters/cli/parse-args.d.ts.map +0 -1
  237. package/dist/adapters/cli/parse-args.js.map +0 -1
  238. package/dist/adapters/cli/scope-gate.d.ts +0 -25
  239. package/dist/adapters/cli/scope-gate.d.ts.map +0 -1
  240. package/dist/adapters/cli/scope-gate.js +0 -157
  241. package/dist/adapters/cli/scope-gate.js.map +0 -1
  242. package/dist/adapters/cli/scope.d.ts +0 -26
  243. package/dist/adapters/cli/scope.d.ts.map +0 -1
  244. package/dist/adapters/cli/scope.js +0 -172
  245. package/dist/adapters/cli/scope.js.map +0 -1
  246. package/dist/adapters/cli/validate-component.d.ts +0 -24
  247. package/dist/adapters/cli/validate-component.d.ts.map +0 -1
  248. package/dist/adapters/cli/validate-component.js +0 -62
  249. package/dist/adapters/cli/validate-component.js.map +0 -1
  250. package/dist/adapters/cli/verify-contract-diff.d.ts +0 -21
  251. package/dist/adapters/cli/verify-contract-diff.d.ts.map +0 -1
  252. package/dist/adapters/cli/verify-contract-diff.js +0 -69
  253. package/dist/adapters/cli/verify-contract-diff.js.map +0 -1
  254. package/dist/adapters/cli/verify-drift.d.ts +0 -24
  255. package/dist/adapters/cli/verify-drift.d.ts.map +0 -1
  256. package/dist/adapters/cli/verify-drift.js +0 -103
  257. package/dist/adapters/cli/verify-drift.js.map +0 -1
  258. package/dist/adapters/cli/verify-impact.d.ts +0 -23
  259. package/dist/adapters/cli/verify-impact.d.ts.map +0 -1
  260. package/dist/adapters/cli/verify-impact.js +0 -119
  261. package/dist/adapters/cli/verify-impact.js.map +0 -1
  262. package/dist/adapters/mcp/index.d.ts +0 -5
  263. package/dist/adapters/mcp/index.d.ts.map +0 -1
  264. package/dist/adapters/mcp/index.js +0 -2
  265. package/dist/adapters/mcp/index.js.map +0 -1
  266. package/dist/bin/dt.d.ts +0 -7
  267. package/dist/bin/dt.d.ts.map +0 -1
  268. package/dist/bin/dt.js +0 -647
  269. package/dist/bin/dt.js.map +0 -1
  270. package/dist/core/catalog/build.d.ts +0 -143
  271. package/dist/core/catalog/build.d.ts.map +0 -1
  272. package/dist/core/catalog/build.js +0 -475
  273. package/dist/core/catalog/build.js.map +0 -1
  274. package/dist/core/catalog/checks/index.d.ts +0 -18
  275. package/dist/core/catalog/checks/index.d.ts.map +0 -1
  276. package/dist/core/catalog/checks/index.js +0 -18
  277. package/dist/core/catalog/checks/index.js.map +0 -1
  278. package/dist/core/catalog/checks/v01-schema.d.ts +0 -17
  279. package/dist/core/catalog/checks/v01-schema.d.ts.map +0 -1
  280. package/dist/core/catalog/checks/v01-schema.js +0 -57
  281. package/dist/core/catalog/checks/v01-schema.js.map +0 -1
  282. package/dist/core/catalog/checks/v02-v03-identity.d.ts +0 -14
  283. package/dist/core/catalog/checks/v02-v03-identity.d.ts.map +0 -1
  284. package/dist/core/catalog/checks/v02-v03-identity.js +0 -60
  285. package/dist/core/catalog/checks/v02-v03-identity.js.map +0 -1
  286. package/dist/core/catalog/checks/v04-referential-integrity.d.ts +0 -7
  287. package/dist/core/catalog/checks/v04-referential-integrity.d.ts.map +0 -1
  288. package/dist/core/catalog/checks/v04-referential-integrity.js +0 -32
  289. package/dist/core/catalog/checks/v04-referential-integrity.js.map +0 -1
  290. package/dist/core/catalog/checks/v05-domain-existence.d.ts +0 -6
  291. package/dist/core/catalog/checks/v05-domain-existence.d.ts.map +0 -1
  292. package/dist/core/catalog/checks/v05-domain-existence.js +0 -23
  293. package/dist/core/catalog/checks/v05-domain-existence.js.map +0 -1
  294. package/dist/core/catalog/checks/v06-v07-paths.d.ts +0 -29
  295. package/dist/core/catalog/checks/v06-v07-paths.d.ts.map +0 -1
  296. package/dist/core/catalog/checks/v06-v07-paths.js +0 -107
  297. package/dist/core/catalog/checks/v06-v07-paths.js.map +0 -1
  298. package/dist/core/catalog/checks/v08-v10-contracts.d.ts +0 -13
  299. package/dist/core/catalog/checks/v08-v10-contracts.d.ts.map +0 -1
  300. package/dist/core/catalog/checks/v08-v10-contracts.js +0 -70
  301. package/dist/core/catalog/checks/v08-v10-contracts.js.map +0 -1
  302. package/dist/core/catalog/checks/v11-manual-fields.d.ts +0 -16
  303. package/dist/core/catalog/checks/v11-manual-fields.d.ts.map +0 -1
  304. package/dist/core/catalog/checks/v11-manual-fields.js +0 -60
  305. package/dist/core/catalog/checks/v11-manual-fields.js.map +0 -1
  306. package/dist/core/catalog/checks/v12-cycles.d.ts +0 -8
  307. package/dist/core/catalog/checks/v12-cycles.d.ts.map +0 -1
  308. package/dist/core/catalog/checks/v12-cycles.js +0 -28
  309. package/dist/core/catalog/checks/v12-cycles.js.map +0 -1
  310. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts +0 -7
  311. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts.map +0 -1
  312. package/dist/core/catalog/checks/v13-orphan-contracts.js +0 -33
  313. package/dist/core/catalog/checks/v13-orphan-contracts.js.map +0 -1
  314. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts +0 -8
  315. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts.map +0 -1
  316. package/dist/core/catalog/checks/v14-v15-lifecycle.js +0 -42
  317. package/dist/core/catalog/checks/v14-v15-lifecycle.js.map +0 -1
  318. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts +0 -7
  319. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts.map +0 -1
  320. package/dist/core/catalog/checks/v16-deprecated-consumers.js +0 -47
  321. package/dist/core/catalog/checks/v16-deprecated-consumers.js.map +0 -1
  322. package/dist/core/catalog/checks/v17-low-confidence.d.ts +0 -7
  323. package/dist/core/catalog/checks/v17-low-confidence.d.ts.map +0 -1
  324. package/dist/core/catalog/checks/v17-low-confidence.js +0 -32
  325. package/dist/core/catalog/checks/v17-low-confidence.js.map +0 -1
  326. package/dist/core/catalog/checks/v18-low-payload.d.ts +0 -7
  327. package/dist/core/catalog/checks/v18-low-payload.d.ts.map +0 -1
  328. package/dist/core/catalog/checks/v18-low-payload.js +0 -33
  329. package/dist/core/catalog/checks/v18-low-payload.js.map +0 -1
  330. package/dist/core/catalog/checks/v19-domain-membership.d.ts +0 -8
  331. package/dist/core/catalog/checks/v19-domain-membership.d.ts.map +0 -1
  332. package/dist/core/catalog/checks/v19-domain-membership.js +0 -55
  333. package/dist/core/catalog/checks/v19-domain-membership.js.map +0 -1
  334. package/dist/core/catalog/coverage.d.ts +0 -39
  335. package/dist/core/catalog/coverage.d.ts.map +0 -1
  336. package/dist/core/catalog/coverage.js +0 -62
  337. package/dist/core/catalog/coverage.js.map +0 -1
  338. package/dist/core/catalog/graph.d.ts +0 -49
  339. package/dist/core/catalog/graph.d.ts.map +0 -1
  340. package/dist/core/catalog/graph.js +0 -114
  341. package/dist/core/catalog/graph.js.map +0 -1
  342. package/dist/core/catalog/index-model.d.ts +0 -96
  343. package/dist/core/catalog/index-model.d.ts.map +0 -1
  344. package/dist/core/catalog/index-model.js +0 -8
  345. package/dist/core/catalog/index-model.js.map +0 -1
  346. package/dist/core/catalog/index.d.ts +0 -5
  347. package/dist/core/catalog/index.d.ts.map +0 -1
  348. package/dist/core/catalog/index.js +0 -2
  349. package/dist/core/catalog/index.js.map +0 -1
  350. package/dist/core/catalog/queries.d.ts +0 -69
  351. package/dist/core/catalog/queries.d.ts.map +0 -1
  352. package/dist/core/catalog/queries.js +0 -165
  353. package/dist/core/catalog/queries.js.map +0 -1
  354. package/dist/core/catalog/resolve.d.ts +0 -47
  355. package/dist/core/catalog/resolve.d.ts.map +0 -1
  356. package/dist/core/catalog/resolve.js +0 -318
  357. package/dist/core/catalog/resolve.js.map +0 -1
  358. package/dist/core/catalog/scaffold.d.ts +0 -31
  359. package/dist/core/catalog/scaffold.d.ts.map +0 -1
  360. package/dist/core/catalog/scaffold.js +0 -141
  361. package/dist/core/catalog/scaffold.js.map +0 -1
  362. package/dist/core/catalog/validate-component.d.ts +0 -50
  363. package/dist/core/catalog/validate-component.d.ts.map +0 -1
  364. package/dist/core/catalog/validate-component.js +0 -105
  365. package/dist/core/catalog/validate-component.js.map +0 -1
  366. package/dist/core/catalog/validate.d.ts +0 -71
  367. package/dist/core/catalog/validate.d.ts.map +0 -1
  368. package/dist/core/catalog/validate.js +0 -103
  369. package/dist/core/catalog/validate.js.map +0 -1
  370. package/dist/core/context/assemble.d.ts +0 -126
  371. package/dist/core/context/assemble.d.ts.map +0 -1
  372. package/dist/core/context/assemble.js +0 -197
  373. package/dist/core/context/assemble.js.map +0 -1
  374. package/dist/core/context/cache.d.ts +0 -60
  375. package/dist/core/context/cache.d.ts.map +0 -1
  376. package/dist/core/context/cache.js +0 -236
  377. package/dist/core/context/cache.js.map +0 -1
  378. package/dist/core/context/exit-codes.d.ts +0 -28
  379. package/dist/core/context/exit-codes.d.ts.map +0 -1
  380. package/dist/core/context/exit-codes.js +0 -28
  381. package/dist/core/context/exit-codes.js.map +0 -1
  382. package/dist/core/context/fetch.d.ts +0 -55
  383. package/dist/core/context/fetch.d.ts.map +0 -1
  384. package/dist/core/context/fetch.js +0 -112
  385. package/dist/core/context/fetch.js.map +0 -1
  386. package/dist/core/context/index.d.ts +0 -11
  387. package/dist/core/context/index.d.ts.map +0 -1
  388. package/dist/core/context/index.js +0 -8
  389. package/dist/core/context/index.js.map +0 -1
  390. package/dist/core/context/init.d.ts +0 -179
  391. package/dist/core/context/init.d.ts.map +0 -1
  392. package/dist/core/context/init.js +0 -532
  393. package/dist/core/context/init.js.map +0 -1
  394. package/dist/core/context/layers/architecture-layer.d.ts +0 -13
  395. package/dist/core/context/layers/architecture-layer.d.ts.map +0 -1
  396. package/dist/core/context/layers/architecture-layer.js +0 -24
  397. package/dist/core/context/layers/architecture-layer.js.map +0 -1
  398. package/dist/core/context/layers/contracts-layer.d.ts +0 -13
  399. package/dist/core/context/layers/contracts-layer.d.ts.map +0 -1
  400. package/dist/core/context/layers/contracts-layer.js +0 -83
  401. package/dist/core/context/layers/contracts-layer.js.map +0 -1
  402. package/dist/core/context/layers/conventions-delta-layer.d.ts +0 -13
  403. package/dist/core/context/layers/conventions-delta-layer.d.ts.map +0 -1
  404. package/dist/core/context/layers/conventions-delta-layer.js +0 -37
  405. package/dist/core/context/layers/conventions-delta-layer.js.map +0 -1
  406. package/dist/core/context/layers/flow-layer.d.ts +0 -14
  407. package/dist/core/context/layers/flow-layer.d.ts.map +0 -1
  408. package/dist/core/context/layers/flow-layer.js +0 -61
  409. package/dist/core/context/layers/flow-layer.js.map +0 -1
  410. package/dist/core/context/layers/index-layer.d.ts +0 -13
  411. package/dist/core/context/layers/index-layer.d.ts.map +0 -1
  412. package/dist/core/context/layers/index-layer.js +0 -77
  413. package/dist/core/context/layers/index-layer.js.map +0 -1
  414. package/dist/core/context/layers/primary-layer.d.ts +0 -16
  415. package/dist/core/context/layers/primary-layer.d.ts.map +0 -1
  416. package/dist/core/context/layers/primary-layer.js +0 -61
  417. package/dist/core/context/layers/primary-layer.js.map +0 -1
  418. package/dist/core/context/layers/secondary-layer.d.ts +0 -19
  419. package/dist/core/context/layers/secondary-layer.d.ts.map +0 -1
  420. package/dist/core/context/layers/secondary-layer.js +0 -52
  421. package/dist/core/context/layers/secondary-layer.js.map +0 -1
  422. package/dist/core/context/session-lock.d.ts +0 -114
  423. package/dist/core/context/session-lock.d.ts.map +0 -1
  424. package/dist/core/context/session-lock.js +0 -90
  425. package/dist/core/context/session-lock.js.map +0 -1
  426. package/dist/core/context/tokens.d.ts +0 -35
  427. package/dist/core/context/tokens.d.ts.map +0 -1
  428. package/dist/core/context/tokens.js +0 -88
  429. package/dist/core/context/tokens.js.map +0 -1
  430. package/dist/core/extract/asyncapi/declared.d.ts +0 -19
  431. package/dist/core/extract/asyncapi/declared.d.ts.map +0 -1
  432. package/dist/core/extract/asyncapi/declared.js +0 -168
  433. package/dist/core/extract/asyncapi/declared.js.map +0 -1
  434. package/dist/core/extract/asyncapi/index.d.ts +0 -12
  435. package/dist/core/extract/asyncapi/index.d.ts.map +0 -1
  436. package/dist/core/extract/asyncapi/index.js +0 -8
  437. package/dist/core/extract/asyncapi/index.js.map +0 -1
  438. package/dist/core/extract/asyncapi/payloads.d.ts +0 -20
  439. package/dist/core/extract/asyncapi/payloads.d.ts.map +0 -1
  440. package/dist/core/extract/asyncapi/payloads.js +0 -421
  441. package/dist/core/extract/asyncapi/payloads.js.map +0 -1
  442. package/dist/core/extract/asyncapi/topics.d.ts +0 -27
  443. package/dist/core/extract/asyncapi/topics.d.ts.map +0 -1
  444. package/dist/core/extract/asyncapi/topics.js +0 -368
  445. package/dist/core/extract/asyncapi/topics.js.map +0 -1
  446. package/dist/core/extract/asyncapi/types.d.ts +0 -129
  447. package/dist/core/extract/asyncapi/types.d.ts.map +0 -1
  448. package/dist/core/extract/asyncapi/types.js +0 -5
  449. package/dist/core/extract/asyncapi/types.js.map +0 -1
  450. package/dist/core/extract/asyncapi/validate.d.ts +0 -29
  451. package/dist/core/extract/asyncapi/validate.d.ts.map +0 -1
  452. package/dist/core/extract/asyncapi/validate.js +0 -156
  453. package/dist/core/extract/asyncapi/validate.js.map +0 -1
  454. package/dist/core/extract/component.d.ts +0 -204
  455. package/dist/core/extract/component.d.ts.map +0 -1
  456. package/dist/core/extract/component.js +0 -258
  457. package/dist/core/extract/component.js.map +0 -1
  458. package/dist/core/extract/detect.d.ts +0 -35
  459. package/dist/core/extract/detect.d.ts.map +0 -1
  460. package/dist/core/extract/detect.js +0 -89
  461. package/dist/core/extract/detect.js.map +0 -1
  462. package/dist/core/extract/index.d.ts +0 -12
  463. package/dist/core/extract/index.d.ts.map +0 -1
  464. package/dist/core/extract/index.js +0 -6
  465. package/dist/core/extract/index.js.map +0 -1
  466. package/dist/core/extract/ladder.d.ts +0 -79
  467. package/dist/core/extract/ladder.d.ts.map +0 -1
  468. package/dist/core/extract/ladder.js +0 -70
  469. package/dist/core/extract/ladder.js.map +0 -1
  470. package/dist/core/extract/openapi/index.d.ts +0 -43
  471. package/dist/core/extract/openapi/index.d.ts.map +0 -1
  472. package/dist/core/extract/openapi/index.js +0 -142
  473. package/dist/core/extract/openapi/index.js.map +0 -1
  474. package/dist/core/extract/openapi/route1.d.ts +0 -36
  475. package/dist/core/extract/openapi/route1.d.ts.map +0 -1
  476. package/dist/core/extract/openapi/route1.js +0 -333
  477. package/dist/core/extract/openapi/route1.js.map +0 -1
  478. package/dist/core/extract/openapi/route2-introspect.d.ts +0 -18
  479. package/dist/core/extract/openapi/route2-introspect.d.ts.map +0 -1
  480. package/dist/core/extract/openapi/route2-introspect.js +0 -249
  481. package/dist/core/extract/openapi/route2-introspect.js.map +0 -1
  482. package/dist/core/extract/openapi/route2.d.ts +0 -69
  483. package/dist/core/extract/openapi/route2.d.ts.map +0 -1
  484. package/dist/core/extract/openapi/route2.js +0 -211
  485. package/dist/core/extract/openapi/route2.js.map +0 -1
  486. package/dist/core/extract/openapi/route3.d.ts +0 -26
  487. package/dist/core/extract/openapi/route3.d.ts.map +0 -1
  488. package/dist/core/extract/openapi/route3.js +0 -737
  489. package/dist/core/extract/openapi/route3.js.map +0 -1
  490. package/dist/core/extract/openapi/types.d.ts +0 -125
  491. package/dist/core/extract/openapi/types.d.ts.map +0 -1
  492. package/dist/core/extract/openapi/types.js +0 -5
  493. package/dist/core/extract/openapi/types.js.map +0 -1
  494. package/dist/core/extract/openapi/validate.d.ts +0 -29
  495. package/dist/core/extract/openapi/validate.d.ts.map +0 -1
  496. package/dist/core/extract/openapi/validate.js +0 -200
  497. package/dist/core/extract/openapi/validate.js.map +0 -1
  498. package/dist/core/extract/orm/drizzle.d.ts +0 -20
  499. package/dist/core/extract/orm/drizzle.d.ts.map +0 -1
  500. package/dist/core/extract/orm/drizzle.js +0 -283
  501. package/dist/core/extract/orm/drizzle.js.map +0 -1
  502. package/dist/core/extract/orm/information-schema.d.ts +0 -26
  503. package/dist/core/extract/orm/information-schema.d.ts.map +0 -1
  504. package/dist/core/extract/orm/information-schema.js +0 -142
  505. package/dist/core/extract/orm/information-schema.js.map +0 -1
  506. package/dist/core/extract/orm/prisma.d.ts +0 -23
  507. package/dist/core/extract/orm/prisma.d.ts.map +0 -1
  508. package/dist/core/extract/orm/prisma.js +0 -234
  509. package/dist/core/extract/orm/prisma.js.map +0 -1
  510. package/dist/core/extract/orm/typeorm.d.ts +0 -22
  511. package/dist/core/extract/orm/typeorm.d.ts.map +0 -1
  512. package/dist/core/extract/orm/typeorm.js +0 -269
  513. package/dist/core/extract/orm/typeorm.js.map +0 -1
  514. package/dist/core/extract/orm/types.d.ts +0 -97
  515. package/dist/core/extract/orm/types.d.ts.map +0 -1
  516. package/dist/core/extract/orm/types.js +0 -6
  517. package/dist/core/extract/orm/types.js.map +0 -1
  518. package/dist/core/extract/prompt.d.ts +0 -21
  519. package/dist/core/extract/prompt.d.ts.map +0 -1
  520. package/dist/core/extract/prompt.js +0 -79
  521. package/dist/core/extract/prompt.js.map +0 -1
  522. package/dist/core/extract/provider.d.ts +0 -121
  523. package/dist/core/extract/provider.d.ts.map +0 -1
  524. package/dist/core/extract/provider.js +0 -6
  525. package/dist/core/extract/provider.js.map +0 -1
  526. package/dist/core/extract/providers/node-ts.d.ts +0 -69
  527. package/dist/core/extract/providers/node-ts.d.ts.map +0 -1
  528. package/dist/core/extract/providers/node-ts.js +0 -320
  529. package/dist/core/extract/providers/node-ts.js.map +0 -1
  530. package/dist/core/extract/render/schema-md.d.ts +0 -16
  531. package/dist/core/extract/render/schema-md.d.ts.map +0 -1
  532. package/dist/core/extract/render/schema-md.js +0 -140
  533. package/dist/core/extract/render/schema-md.js.map +0 -1
  534. package/dist/core/extract/report.d.ts +0 -125
  535. package/dist/core/extract/report.d.ts.map +0 -1
  536. package/dist/core/extract/report.js +0 -52
  537. package/dist/core/extract/report.js.map +0 -1
  538. package/dist/core/extract/schema.d.ts +0 -34
  539. package/dist/core/extract/schema.d.ts.map +0 -1
  540. package/dist/core/extract/schema.js +0 -146
  541. package/dist/core/extract/schema.js.map +0 -1
  542. package/dist/core/extract/workspaces.d.ts +0 -33
  543. package/dist/core/extract/workspaces.d.ts.map +0 -1
  544. package/dist/core/extract/workspaces.js +0 -193
  545. package/dist/core/extract/workspaces.js.map +0 -1
  546. package/dist/core/providers/index.d.ts +0 -6
  547. package/dist/core/providers/index.d.ts.map +0 -1
  548. package/dist/core/providers/index.js +0 -2
  549. package/dist/core/providers/index.js.map +0 -1
  550. package/dist/core/providers/tracker.d.ts +0 -74
  551. package/dist/core/providers/tracker.d.ts.map +0 -1
  552. package/dist/core/providers/tracker.js +0 -38
  553. package/dist/core/providers/tracker.js.map +0 -1
  554. package/dist/core/scope/calibration.d.ts +0 -25
  555. package/dist/core/scope/calibration.d.ts.map +0 -1
  556. package/dist/core/scope/calibration.js +0 -52
  557. package/dist/core/scope/calibration.js.map +0 -1
  558. package/dist/core/scope/closure.d.ts +0 -31
  559. package/dist/core/scope/closure.d.ts.map +0 -1
  560. package/dist/core/scope/closure.js +0 -68
  561. package/dist/core/scope/closure.js.map +0 -1
  562. package/dist/core/scope/gate.d.ts +0 -41
  563. package/dist/core/scope/gate.d.ts.map +0 -1
  564. package/dist/core/scope/gate.js +0 -165
  565. package/dist/core/scope/gate.js.map +0 -1
  566. package/dist/core/scope/index.d.ts +0 -18
  567. package/dist/core/scope/index.d.ts.map +0 -1
  568. package/dist/core/scope/index.js +0 -12
  569. package/dist/core/scope/index.js.map +0 -1
  570. package/dist/core/scope/partition.d.ts +0 -36
  571. package/dist/core/scope/partition.d.ts.map +0 -1
  572. package/dist/core/scope/partition.js +0 -78
  573. package/dist/core/scope/partition.js.map +0 -1
  574. package/dist/core/scope/prompt.d.ts +0 -39
  575. package/dist/core/scope/prompt.d.ts.map +0 -1
  576. package/dist/core/scope/prompt.js +0 -123
  577. package/dist/core/scope/prompt.js.map +0 -1
  578. package/dist/core/scope/scoping.d.ts +0 -52
  579. package/dist/core/scope/scoping.d.ts.map +0 -1
  580. package/dist/core/scope/scoping.js +0 -99
  581. package/dist/core/scope/scoping.js.map +0 -1
  582. package/dist/core/scope/types.d.ts +0 -77
  583. package/dist/core/scope/types.d.ts.map +0 -1
  584. package/dist/core/scope/types.js +0 -5
  585. package/dist/core/scope/types.js.map +0 -1
  586. package/dist/core/scope/validate.d.ts +0 -47
  587. package/dist/core/scope/validate.d.ts.map +0 -1
  588. package/dist/core/scope/validate.js +0 -90
  589. package/dist/core/scope/validate.js.map +0 -1
  590. package/dist/core/verify/asyncapi-diff.d.ts +0 -34
  591. package/dist/core/verify/asyncapi-diff.d.ts.map +0 -1
  592. package/dist/core/verify/asyncapi-diff.js +0 -209
  593. package/dist/core/verify/asyncapi-diff.js.map +0 -1
  594. package/dist/core/verify/contract-diff.d.ts +0 -39
  595. package/dist/core/verify/contract-diff.d.ts.map +0 -1
  596. package/dist/core/verify/contract-diff.js +0 -63
  597. package/dist/core/verify/contract-diff.js.map +0 -1
  598. package/dist/core/verify/drift.d.ts +0 -47
  599. package/dist/core/verify/drift.d.ts.map +0 -1
  600. package/dist/core/verify/drift.js +0 -122
  601. package/dist/core/verify/drift.js.map +0 -1
  602. package/dist/core/verify/impact.d.ts +0 -22
  603. package/dist/core/verify/impact.d.ts.map +0 -1
  604. package/dist/core/verify/impact.js +0 -93
  605. package/dist/core/verify/impact.js.map +0 -1
  606. package/dist/core/verify/index.d.ts +0 -10
  607. package/dist/core/verify/index.d.ts.map +0 -1
  608. package/dist/core/verify/index.js +0 -9
  609. package/dist/core/verify/index.js.map +0 -1
  610. package/dist/core/verify/openapi-diff.d.ts +0 -29
  611. package/dist/core/verify/openapi-diff.d.ts.map +0 -1
  612. package/dist/core/verify/openapi-diff.js +0 -291
  613. package/dist/core/verify/openapi-diff.js.map +0 -1
  614. package/dist/core/verify/types.d.ts +0 -138
  615. package/dist/core/verify/types.d.ts.map +0 -1
  616. package/dist/core/verify/types.js +0 -5
  617. package/dist/core/verify/types.js.map +0 -1
  618. package/schemas/component.schema.json +0 -203
  619. package/schemas/flow.schema.json +0 -75
  620. package/schemas/scope-output.schema.json +0 -62
@@ -1,737 +0,0 @@
1
- /**
2
- * OpenAPI Route 3: AST-based route discovery.
3
- * Uses TypeScript Compiler API to find route registrations in:
4
- * - Express (app|router.get|post|put|patch|delete)
5
- * - Fastify (same pattern)
6
- * - Hono (app.get + .route() groupings)
7
- * - NestJS (@Controller/@Get/@Post decorators)
8
- *
9
- * Resolves full path by composing router prefixes.
10
- * Derives params from route pattern and handler type signature.
11
- * Reports dynamic routes in unresolved[].
12
- */
13
- import { readFileSync, readdirSync, statSync } from "node:fs";
14
- import { join, relative } from "node:path";
15
- import ts from "typescript";
16
- const HTTP_METHODS = ["get", "post", "put", "patch", "delete", "head", "options"];
17
- /**
18
- * Extract OpenAPI specification using Route 3 (AST) strategy.
19
- */
20
- export function extractRoute3(rootDir) {
21
- const sourceFiles = findTypeScriptFiles(rootDir);
22
- const program = createProgram(sourceFiles, rootDir);
23
- const checker = program.getTypeChecker();
24
- const endpoints = [];
25
- const unresolved = [];
26
- for (const sourceFile of program.getSourceFiles()) {
27
- const filePath = sourceFile.fileName;
28
- // Skip node_modules and non-project files
29
- if (filePath.includes("node_modules") || !filePath.startsWith(rootDir))
30
- continue;
31
- const relPath = relative(rootDir, filePath);
32
- visitNode(sourceFile, "", relPath, checker, endpoints, unresolved);
33
- }
34
- // Determine overall confidence
35
- const confidence = computeOverallConfidence(endpoints);
36
- return {
37
- openapi: "3.1.0",
38
- info: { title: "API", version: "1.0.0" },
39
- endpoints,
40
- unresolved,
41
- source: "inferred",
42
- confidence,
43
- strategy: "route3",
44
- };
45
- }
46
- /**
47
- * Visit a node to find route registrations.
48
- */
49
- function visitNode(node, prefix, filePath, checker, endpoints, unresolved) {
50
- // Check for NestJS decorators
51
- if (ts.isClassDeclaration(node)) {
52
- const controllerPrefix = getNestControllerPrefix(node);
53
- if (controllerPrefix !== null) {
54
- extractNestEndpoints(node, controllerPrefix, filePath, checker, endpoints);
55
- return;
56
- }
57
- }
58
- // Check for Express/Fastify/Hono route calls
59
- if (ts.isCallExpression(node)) {
60
- handleRouteCall(node, prefix, filePath, checker, endpoints, unresolved);
61
- }
62
- // Check for router.use() with prefix (Express/Fastify prefix composition)
63
- if (ts.isCallExpression(node)) {
64
- const usePrefix = getUsePrefix(node);
65
- if (usePrefix !== null) {
66
- // Routes registered after this use the prefix
67
- // We handle this by tracking prefixes in the parent scope
68
- }
69
- }
70
- ts.forEachChild(node, (child) => visitNode(child, prefix, filePath, checker, endpoints, unresolved));
71
- }
72
- /**
73
- * Handle a potential route registration call expression.
74
- */
75
- function handleRouteCall(node, prefix, filePath, checker, endpoints, unresolved) {
76
- // Pattern: app.get("/path", handler) or router.post("/path", handler)
77
- if (!ts.isPropertyAccessExpression(node.expression))
78
- return;
79
- const methodName = node.expression.name.text;
80
- if (!HTTP_METHODS.includes(methodName))
81
- return;
82
- // Check for Hono .route() grouping (handled separately)
83
- if (methodName === "route")
84
- return;
85
- if (node.arguments.length < 1)
86
- return;
87
- const pathArg = node.arguments[0];
88
- const path = resolvePathArgument(pathArg, filePath, node, unresolved);
89
- if (path === null)
90
- return; // Already reported as unresolved
91
- const fullPath = composePath(prefix, path);
92
- const handlerArg = node.arguments.length > 1 ? node.arguments[node.arguments.length - 1] : null;
93
- // Derive params from path pattern
94
- const pathParams = extractPathParams(fullPath);
95
- // Derive body/query params and response from handler type
96
- const { queryParams, bodySchema, responseSchema, typed } = handlerArg
97
- ? analyzeHandler(handlerArg, checker)
98
- : { queryParams: [], bodySchema: undefined, responseSchema: [], typed: false };
99
- const confidence = typed ? "medium" : "low";
100
- endpoints.push({
101
- method: methodName,
102
- path: fullPath,
103
- parameters: [...pathParams, ...queryParams],
104
- requestBody: bodySchema,
105
- responses: responseSchema.length > 0 ? responseSchema : [defaultResponse()],
106
- typed,
107
- confidence,
108
- });
109
- }
110
- /**
111
- * Extract NestJS endpoints from a controller class.
112
- */
113
- function extractNestEndpoints(classNode, controllerPrefix, filePath, checker, endpoints) {
114
- for (const member of classNode.members) {
115
- if (!ts.isMethodDeclaration(member))
116
- continue;
117
- const decorators = ts.getDecorators(member);
118
- if (!decorators)
119
- continue;
120
- for (const decorator of decorators) {
121
- if (!ts.isCallExpression(decorator.expression))
122
- continue;
123
- const decoratorName = getDecoratorName(decorator.expression);
124
- if (!decoratorName)
125
- continue;
126
- const method = decoratorNameToMethod(decoratorName);
127
- if (!method)
128
- continue;
129
- // Get the path from decorator argument
130
- let routePath = "/";
131
- if (decorator.expression.arguments.length > 0) {
132
- const pathArg = decorator.expression.arguments[0];
133
- if (ts.isStringLiteral(pathArg)) {
134
- routePath = pathArg.text;
135
- }
136
- }
137
- const fullPath = composePath(controllerPrefix, routePath);
138
- const pathParams = extractPathParams(fullPath);
139
- // Analyze method parameters for query/body
140
- const { queryParams, bodySchema, responseSchema, typed } = analyzeNestMethod(member, checker);
141
- const confidence = typed ? "medium" : "low";
142
- endpoints.push({
143
- method,
144
- path: fullPath,
145
- parameters: [...pathParams, ...queryParams],
146
- requestBody: bodySchema,
147
- responses: responseSchema.length > 0 ? responseSchema : [defaultResponse()],
148
- typed,
149
- confidence,
150
- });
151
- }
152
- }
153
- }
154
- /**
155
- * Analyze a NestJS method's parameters for query/body params.
156
- */
157
- function analyzeNestMethod(method, checker) {
158
- const queryParams = [];
159
- let bodySchema;
160
- let typed = false;
161
- for (const param of method.parameters) {
162
- const decorators = ts.getDecorators(param);
163
- if (!decorators)
164
- continue;
165
- for (const decorator of decorators) {
166
- if (!ts.isCallExpression(decorator.expression))
167
- continue;
168
- const name = getDecoratorName(decorator.expression);
169
- if (name === "Query") {
170
- const paramName = getDecoratorStringArg(decorator.expression);
171
- if (paramName) {
172
- const paramType = param.type ? getTypeString(param.type) : "string";
173
- queryParams.push({ name: paramName, in: "query", required: false, type: paramType });
174
- typed = true;
175
- }
176
- }
177
- else if (name === "Body") {
178
- const bodyType = param.type ? typeNodeToSchema(param.type, checker) : null;
179
- if (bodyType) {
180
- bodySchema = { contentType: "application/json", schema: bodyType, required: true };
181
- typed = true;
182
- }
183
- }
184
- }
185
- }
186
- // Check return type
187
- const responseSchema = analyzeReturnType(method, checker);
188
- if (responseSchema.length > 0)
189
- typed = true;
190
- return { queryParams, bodySchema, responseSchema, typed };
191
- }
192
- /**
193
- * Analyze a handler function/arrow for query/body/response types.
194
- * Supports:
195
- * - Express Request<Params, ResBody, ReqBody, ReqQuery> generics
196
- * - Zod schema validation (.input(z.object({...})))
197
- * - Direct type annotations
198
- */
199
- function analyzeHandler(handler, checker) {
200
- const queryParams = [];
201
- let bodySchema;
202
- let responseSchema = [];
203
- let typed = false;
204
- // Check for zod validation in the call chain
205
- const zodSchema = findZodSchema(handler);
206
- if (zodSchema) {
207
- bodySchema = {
208
- contentType: "application/json",
209
- schema: zodSchema,
210
- required: true,
211
- };
212
- typed = true;
213
- }
214
- // Analyze handler function parameters
215
- const fn = resolveFunction(handler);
216
- if (fn && ts.isFunctionLike(fn)) {
217
- // Check request parameter type for Express Request<P, Res, Body, Query>
218
- if (fn.parameters.length > 0) {
219
- const reqParam = fn.parameters[0];
220
- if (reqParam.type && ts.isTypeReferenceNode(reqParam.type)) {
221
- const typeArgs = reqParam.type.typeArguments;
222
- if (typeArgs && typeArgs.length >= 4) {
223
- // Query params from 4th type argument
224
- const queryType = typeNodeToSchema(typeArgs[3], checker);
225
- if (queryType && queryType.properties) {
226
- for (const [name, prop] of Object.entries(queryType.properties)) {
227
- queryParams.push({
228
- name,
229
- in: "query",
230
- required: !(prop.nullable === true),
231
- type: prop.type ?? "string",
232
- });
233
- }
234
- typed = true;
235
- }
236
- // Body from 3rd type argument
237
- if (!bodySchema && typeArgs.length >= 3) {
238
- const bodyType = typeNodeToSchema(typeArgs[2], checker);
239
- if (bodyType && Object.keys(bodyType).length > 0) {
240
- bodySchema = {
241
- contentType: "application/json",
242
- schema: bodyType,
243
- required: true,
244
- };
245
- typed = true;
246
- }
247
- }
248
- }
249
- }
250
- }
251
- // Analyze return type
252
- responseSchema = analyzeReturnType(fn, checker);
253
- if (responseSchema.length > 0)
254
- typed = true;
255
- }
256
- return { queryParams, bodySchema, responseSchema, typed };
257
- }
258
- /**
259
- * Find a zod schema in a validation chain.
260
- * Supports patterns like:
261
- * - app.post("/path", validate(z.object({...})), handler)
262
- * - .input(z.object({...}))
263
- */
264
- function findZodSchema(node) {
265
- // Walk up the call expression looking for zod patterns
266
- if (ts.isCallExpression(node)) {
267
- // Check if this is a z.object({...}) call directly
268
- const zodObj = extractZodObject(node);
269
- if (zodObj)
270
- return zodObj;
271
- }
272
- // Check parent call for validation middleware
273
- const parent = node.parent;
274
- if (parent && ts.isCallExpression(parent)) {
275
- for (const arg of parent.arguments) {
276
- if (ts.isCallExpression(arg)) {
277
- const zodObj = extractZodObjectFromValidator(arg);
278
- if (zodObj)
279
- return zodObj;
280
- }
281
- }
282
- }
283
- return null;
284
- }
285
- /**
286
- * Extract a zod object schema from a z.object({...}) call.
287
- */
288
- function extractZodObject(call) {
289
- if (!ts.isPropertyAccessExpression(call.expression))
290
- return null;
291
- if (call.expression.name.text !== "object")
292
- return null;
293
- // Check if the object is z.object
294
- const obj = call.expression.expression;
295
- if (!ts.isIdentifier(obj) || obj.text !== "z")
296
- return null;
297
- if (call.arguments.length === 0)
298
- return null;
299
- const arg = call.arguments[0];
300
- if (!ts.isObjectLiteralExpression(arg))
301
- return null;
302
- return zodObjectLiteralToSchema(arg);
303
- }
304
- /**
305
- * Extract zod schema from a validation wrapper like validate(z.object({...})).
306
- */
307
- function extractZodObjectFromValidator(call) {
308
- for (const arg of call.arguments) {
309
- if (ts.isCallExpression(arg)) {
310
- const zodObj = extractZodObject(arg);
311
- if (zodObj)
312
- return zodObj;
313
- }
314
- }
315
- return null;
316
- }
317
- /**
318
- * Convert a zod object literal to a JSON Schema-like object.
319
- */
320
- function zodObjectLiteralToSchema(obj) {
321
- const properties = {};
322
- const required = [];
323
- for (const prop of obj.properties) {
324
- if (!ts.isPropertyAssignment(prop) || !ts.isIdentifier(prop.name))
325
- continue;
326
- const fieldName = prop.name.text;
327
- const fieldSchema = zodFieldToSchema(prop.initializer);
328
- properties[fieldName] = fieldSchema;
329
- // Check if optional
330
- if (!isZodOptional(prop.initializer)) {
331
- required.push(fieldName);
332
- }
333
- }
334
- return {
335
- type: "object",
336
- properties,
337
- required: required.length > 0 ? required : undefined,
338
- };
339
- }
340
- /**
341
- * Convert a single zod field definition to a JSON Schema type.
342
- */
343
- function zodFieldToSchema(expr) {
344
- // z.string(), z.number(), z.boolean(), z.array(), z.enum()
345
- const chain = flattenZodChain(expr);
346
- if (chain.length === 0)
347
- return { type: "string" };
348
- const baseType = chain[0];
349
- switch (baseType) {
350
- case "string":
351
- return { type: "string" };
352
- case "number":
353
- return { type: "number" };
354
- case "boolean":
355
- return { type: "boolean" };
356
- case "array":
357
- return { type: "array", items: { type: "string" } };
358
- case "enum":
359
- return { type: "string", enum: extractEnumValues(expr) };
360
- default:
361
- return { type: "string" };
362
- }
363
- }
364
- function flattenZodChain(expr) {
365
- const names = [];
366
- let current = expr;
367
- while (ts.isCallExpression(current)) {
368
- if (ts.isPropertyAccessExpression(current.expression)) {
369
- names.unshift(current.expression.name.text);
370
- current = current.expression.expression;
371
- }
372
- else if (ts.isIdentifier(current.expression)) {
373
- names.unshift(current.expression.text);
374
- break;
375
- }
376
- else {
377
- break;
378
- }
379
- }
380
- // Remove 'z' prefix if present
381
- if (names[0] === "z" && names.length > 1) {
382
- return names.slice(1);
383
- }
384
- return names;
385
- }
386
- function isZodOptional(expr) {
387
- const chain = flattenZodChain(expr);
388
- return chain.includes("optional") || chain.includes("nullish");
389
- }
390
- function extractEnumValues(expr) {
391
- // z.enum(["a", "b", "c"])
392
- if (!ts.isCallExpression(expr))
393
- return [];
394
- // Walk to find the enum call with an array arg
395
- let current = expr;
396
- while (ts.isCallExpression(current)) {
397
- if (ts.isPropertyAccessExpression(current.expression)) {
398
- if (current.expression.name.text === "enum" && current.arguments.length > 0) {
399
- const arg = current.arguments[0];
400
- if (ts.isArrayLiteralExpression(arg)) {
401
- return arg.elements.filter(ts.isStringLiteral).map((e) => e.text);
402
- }
403
- }
404
- current = current.expression.expression;
405
- }
406
- else {
407
- break;
408
- }
409
- }
410
- return [];
411
- }
412
- /**
413
- * Resolve a function expression (arrow function, function expression, or identifier).
414
- */
415
- function resolveFunction(expr) {
416
- if (ts.isArrowFunction(expr) || ts.isFunctionExpression(expr)) {
417
- return expr;
418
- }
419
- // Could resolve identifiers via type checker, but for now return null
420
- return null;
421
- }
422
- /**
423
- * Analyze the return type of a function-like declaration.
424
- */
425
- function analyzeReturnType(fn, checker) {
426
- if (!fn.type)
427
- return [];
428
- // Check if return type is any/unknown → schema-less
429
- if (fn.type.kind === ts.SyntaxKind.AnyKeyword || fn.type.kind === ts.SyntaxKind.UnknownKeyword) {
430
- return [];
431
- }
432
- const schema = typeNodeToSchema(fn.type, checker);
433
- if (schema && Object.keys(schema).length > 0) {
434
- return [
435
- {
436
- statusCode: "200",
437
- contentType: "application/json",
438
- schema,
439
- description: "Successful response",
440
- },
441
- ];
442
- }
443
- return [];
444
- }
445
- /**
446
- * Convert a TypeScript type node to a JSON Schema-like object.
447
- */
448
- function typeNodeToSchema(typeNode, checker) {
449
- if (ts.isTypeLiteralNode(typeNode)) {
450
- const properties = {};
451
- const required = [];
452
- for (const member of typeNode.members) {
453
- if (ts.isPropertySignature(member) && member.name && ts.isIdentifier(member.name)) {
454
- const name = member.name.text;
455
- const isOptional = !!member.questionToken;
456
- const memberType = member.type ? getTypeString(member.type) : "string";
457
- properties[name] = { type: memberType };
458
- if (!isOptional)
459
- required.push(name);
460
- }
461
- }
462
- if (Object.keys(properties).length === 0)
463
- return null;
464
- return { type: "object", properties, required: required.length > 0 ? required : undefined };
465
- }
466
- if (ts.isTypeReferenceNode(typeNode)) {
467
- // Try to resolve the type
468
- const type = checker.getTypeAtLocation(typeNode);
469
- const properties = {};
470
- const required = [];
471
- for (const prop of type.getProperties()) {
472
- const propType = checker.getTypeOfSymbol(prop);
473
- const typeStr = checker.typeToString(propType);
474
- properties[prop.name] = { type: tsTypeToJsonSchemaType(typeStr) };
475
- // Check if optional
476
- if (!(prop.flags & ts.SymbolFlags.Optional)) {
477
- required.push(prop.name);
478
- }
479
- }
480
- if (Object.keys(properties).length === 0)
481
- return null;
482
- return { type: "object", properties, required: required.length > 0 ? required : undefined };
483
- }
484
- if (ts.isArrayTypeNode(typeNode)) {
485
- const elementSchema = typeNodeToSchema(typeNode.elementType, checker);
486
- return { type: "array", items: elementSchema ?? { type: "string" } };
487
- }
488
- // Keyword types
489
- const typeStr = getTypeString(typeNode);
490
- if (typeStr === "any" || typeStr === "unknown")
491
- return null;
492
- return { type: tsTypeToJsonSchemaType(typeStr) };
493
- }
494
- function getTypeString(typeNode) {
495
- switch (typeNode.kind) {
496
- case ts.SyntaxKind.StringKeyword:
497
- return "string";
498
- case ts.SyntaxKind.NumberKeyword:
499
- return "number";
500
- case ts.SyntaxKind.BooleanKeyword:
501
- return "boolean";
502
- case ts.SyntaxKind.AnyKeyword:
503
- return "any";
504
- case ts.SyntaxKind.UnknownKeyword:
505
- return "unknown";
506
- case ts.SyntaxKind.VoidKeyword:
507
- return "void";
508
- default:
509
- return "string";
510
- }
511
- }
512
- function tsTypeToJsonSchemaType(tsType) {
513
- switch (tsType) {
514
- case "string":
515
- return "string";
516
- case "number":
517
- return "number";
518
- case "boolean":
519
- return "boolean";
520
- case "void":
521
- return "null";
522
- default:
523
- return "string";
524
- }
525
- }
526
- // --- Path utilities ---
527
- /**
528
- * Compose a prefix and a route path into a full path.
529
- */
530
- export function composePath(prefix, routePath) {
531
- const normalizedPrefix = prefix.replace(/\/+$/, "");
532
- const normalizedRoute = routePath.startsWith("/") ? routePath : `/${routePath}`;
533
- const composed = normalizedPrefix + normalizedRoute;
534
- return composed || "/";
535
- }
536
- /**
537
- * Extract path parameters from a route pattern like "/users/:id/posts/:postId".
538
- */
539
- export function extractPathParams(path) {
540
- const params = [];
541
- // Express-style :param
542
- const colonMatches = path.matchAll(/:([a-zA-Z_][a-zA-Z0-9_]*)/g);
543
- for (const match of colonMatches) {
544
- params.push({ name: match[1], in: "path", required: true, type: "string" });
545
- }
546
- // OpenAPI-style {param}
547
- const braceMatches = path.matchAll(/\{([a-zA-Z_][a-zA-Z0-9_]*)\}/g);
548
- for (const match of braceMatches) {
549
- if (!params.some((p) => p.name === match[1])) {
550
- params.push({ name: match[1], in: "path", required: true, type: "string" });
551
- }
552
- }
553
- return params;
554
- }
555
- /**
556
- * Resolve the path argument of a route call.
557
- * Returns null and adds to unresolved if the path is dynamic.
558
- */
559
- function resolvePathArgument(pathArg, filePath, callNode, unresolved) {
560
- if (ts.isStringLiteral(pathArg) || ts.isNoSubstitutionTemplateLiteral(pathArg)) {
561
- return pathArg.text;
562
- }
563
- // Template literal with static parts
564
- if (ts.isTemplateExpression(pathArg)) {
565
- // Try to extract a static path pattern
566
- let path = pathArg.head.text;
567
- for (const span of pathArg.templateSpans) {
568
- path += `:param_${span.expression.getText()}`;
569
- path += span.literal.text;
570
- }
571
- return path;
572
- }
573
- // Dynamic/unresolvable
574
- const sourceFile = callNode.getSourceFile();
575
- const { line } = sourceFile.getLineAndCharacterOfPosition(callNode.getStart());
576
- unresolved.push({
577
- file: filePath,
578
- line: line + 1,
579
- reason: "Dynamic route path — cannot resolve statically",
580
- snippet: callNode.getText().slice(0, 100),
581
- });
582
- return null;
583
- }
584
- // --- NestJS helpers ---
585
- /**
586
- * Get the controller prefix from a @Controller() decorator.
587
- */
588
- function getNestControllerPrefix(classNode) {
589
- const decorators = ts.getDecorators(classNode);
590
- if (!decorators)
591
- return null;
592
- for (const decorator of decorators) {
593
- if (!ts.isCallExpression(decorator.expression))
594
- continue;
595
- const name = getDecoratorName(decorator.expression);
596
- if (name !== "Controller")
597
- continue;
598
- if (decorator.expression.arguments.length > 0) {
599
- const arg = decorator.expression.arguments[0];
600
- if (ts.isStringLiteral(arg)) {
601
- return arg.text.startsWith("/") ? arg.text : `/${arg.text}`;
602
- }
603
- }
604
- return "/";
605
- }
606
- return null;
607
- }
608
- function getDecoratorName(call) {
609
- if (ts.isIdentifier(call.expression)) {
610
- return call.expression.text;
611
- }
612
- return null;
613
- }
614
- function getDecoratorStringArg(call) {
615
- if (call.arguments.length > 0) {
616
- const arg = call.arguments[0];
617
- if (ts.isStringLiteral(arg))
618
- return arg.text;
619
- }
620
- return null;
621
- }
622
- function decoratorNameToMethod(name) {
623
- const map = {
624
- Get: "get",
625
- Post: "post",
626
- Put: "put",
627
- Patch: "patch",
628
- Delete: "delete",
629
- Head: "head",
630
- Options: "options",
631
- };
632
- return map[name] ?? null;
633
- }
634
- // --- Router prefix detection ---
635
- function getUsePrefix(call) {
636
- if (!ts.isPropertyAccessExpression(call.expression))
637
- return null;
638
- if (call.expression.name.text !== "use")
639
- return null;
640
- if (call.arguments.length < 2)
641
- return null;
642
- const firstArg = call.arguments[0];
643
- if (ts.isStringLiteral(firstArg)) {
644
- return firstArg.text;
645
- }
646
- return null;
647
- }
648
- // --- File and program utilities ---
649
- /**
650
- * Find all TypeScript files in a directory recursively.
651
- */
652
- function findTypeScriptFiles(rootDir) {
653
- const files = [];
654
- function walk(dir) {
655
- let entries;
656
- try {
657
- entries = readdirSync(dir);
658
- }
659
- catch {
660
- return;
661
- }
662
- for (const entry of entries) {
663
- if (entry === "node_modules" || entry === "dist" || entry === ".git")
664
- continue;
665
- const fullPath = join(dir, entry);
666
- try {
667
- const stat = statSync(fullPath);
668
- if (stat.isDirectory()) {
669
- walk(fullPath);
670
- }
671
- else if (entry.endsWith(".ts") &&
672
- !entry.endsWith(".d.ts") &&
673
- !entry.endsWith(".test.ts") &&
674
- !entry.endsWith(".spec.ts")) {
675
- files.push(fullPath);
676
- }
677
- }
678
- catch {
679
- // Skip unreadable files
680
- }
681
- }
682
- }
683
- walk(rootDir);
684
- return files;
685
- }
686
- /**
687
- * Create a TypeScript program for type checking.
688
- */
689
- function createProgram(files, rootDir) {
690
- const configPath = join(rootDir, "tsconfig.json");
691
- let compilerOptions = {
692
- target: ts.ScriptTarget.ES2022,
693
- module: ts.ModuleKind.NodeNext,
694
- moduleResolution: ts.ModuleResolutionKind.NodeNext,
695
- strict: true,
696
- esModuleInterop: true,
697
- skipLibCheck: true,
698
- noEmit: true,
699
- };
700
- // Try to read tsconfig.json
701
- try {
702
- const configText = readFileSync(configPath, "utf-8");
703
- const parsedConfig = ts.parseConfigFileTextToJson(configPath, configText);
704
- if (parsedConfig.config) {
705
- const parsed = ts.parseJsonConfigFileContent(parsedConfig.config, ts.sys, rootDir);
706
- compilerOptions = parsed.options;
707
- }
708
- }
709
- catch {
710
- // Use defaults
711
- }
712
- return ts.createProgram(files, compilerOptions);
713
- }
714
- /**
715
- * Compute overall confidence from endpoints.
716
- */
717
- function computeOverallConfidence(endpoints) {
718
- if (endpoints.length === 0)
719
- return "low";
720
- const typedCount = endpoints.filter((e) => e.typed).length;
721
- const ratio = typedCount / endpoints.length;
722
- if (ratio >= 0.7)
723
- return "medium";
724
- return "low";
725
- }
726
- /**
727
- * Default response when no type info is available.
728
- */
729
- function defaultResponse() {
730
- return {
731
- statusCode: "200",
732
- contentType: "application/json",
733
- schema: null,
734
- description: "Response",
735
- };
736
- }
737
- //# sourceMappingURL=route3.js.map