@llipe.com/dev-tasks 0.11.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 (617) hide show
  1. package/.claude/agents/developer.md +105 -43
  2. package/.claude/agents/github-ops.md +48 -4
  3. package/.claude/agents/housekeeping.md +44 -7
  4. package/.claude/agents/qa-engineer.md +24 -11
  5. package/.claude/agents/researcher.md +26 -6
  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 +44 -23
  12. package/.claude/commands/product-engineer.md +21 -9
  13. package/.claude/commands/researcher.md +4 -5
  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 +4 -11
  18. package/.claude/skills/activity-generate-spec/SKILL.md +34 -10
  19. package/.claude/skills/activity-grill/SKILL.md +150 -0
  20. package/.claude/skills/activity-init/SKILL.md +121 -71
  21. package/.claude/skills/activity-refine/SKILL.md +75 -15
  22. package/.claude/skills/activity-test-standards/SKILL.md +25 -0
  23. package/.claude/skills/aws-ops/SKILL.md +155 -0
  24. package/.claude/skills/deploy-ops/SKILL.md +121 -0
  25. package/.claude/skills/fly-ops/SKILL.md +138 -0
  26. package/.claude/skills/git-ops/SKILL.md +27 -7
  27. package/.claude/skills/implement/SKILL.md +49 -4
  28. package/.claude/skills/memo-cli-usage/REFERENCE.md +230 -17
  29. package/.claude/skills/memo-cli-usage/SKILL.md +66 -13
  30. package/.claude/skills/plan/SKILL.md +43 -1
  31. package/.claude/skills/supabase-ops/SKILL.md +109 -0
  32. package/.github/agents/developer.agent.md +70 -19
  33. package/.github/agents/github-ops.agent.md +46 -4
  34. package/.github/agents/housekeeping.agent.md +43 -7
  35. package/.github/agents/infra-engineer.agent.md +139 -0
  36. package/.github/agents/planner.agent.md +25 -4
  37. package/.github/agents/product-engineer.agent.md +21 -9
  38. package/.github/agents/qa-engineer.agent.md +23 -11
  39. package/.github/agents/researcher.agent.md +25 -6
  40. package/.github/agents/technical-writer.agent.md +60 -6
  41. package/.github/agents/verifier.agent.md +46 -5
  42. package/.github/instructions/implement.instructions.md +49 -4
  43. package/.github/instructions/plan.instructions.md +43 -1
  44. package/.github/prompts/infra-engineer.prompt.md +12 -0
  45. package/.github/prompts/product-engineer-init.prompt.md +5 -6
  46. package/.github/prompts/researcher.prompt.md +4 -5
  47. package/.github/prompts/technical-writer.prompt.md +1 -1
  48. package/.github/skills/activity-codebase-research/SKILL.md +4 -16
  49. package/.github/skills/activity-generate-spec/SKILL.md +34 -10
  50. package/.github/skills/activity-grill/SKILL.md +145 -0
  51. package/.github/skills/activity-init/SKILL.md +120 -70
  52. package/.github/skills/activity-refine/SKILL.md +75 -15
  53. package/.github/skills/activity-test-standards/SKILL.md +25 -0
  54. package/.github/skills/aws-ops/SKILL.md +150 -0
  55. package/.github/skills/deploy-ops/SKILL.md +116 -0
  56. package/.github/skills/fly-ops/SKILL.md +133 -0
  57. package/.github/skills/git-ops/SKILL.md +27 -7
  58. package/.github/skills/memo-cli-usage/REFERENCE.md +230 -17
  59. package/.github/skills/memo-cli-usage/SKILL.md +66 -13
  60. package/.github/skills/supabase-ops/SKILL.md +104 -0
  61. package/.kiro/agents/developer.md +71 -20
  62. package/.kiro/agents/github-ops.md +46 -4
  63. package/.kiro/agents/housekeeping.md +44 -8
  64. package/.kiro/agents/infra-engineer.md +102 -0
  65. package/.kiro/agents/planner.md +33 -15
  66. package/.kiro/agents/product-engineer.md +24 -12
  67. package/.kiro/agents/qa-engineer.md +24 -12
  68. package/.kiro/agents/researcher.md +26 -7
  69. package/.kiro/agents/technical-writer.md +63 -9
  70. package/.kiro/agents/verifier.md +47 -6
  71. package/.kiro/skills/activity-codebase-research/SKILL.md +4 -11
  72. package/.kiro/skills/activity-generate-spec/SKILL.md +34 -10
  73. package/.kiro/skills/activity-grill/SKILL.md +150 -0
  74. package/.kiro/skills/activity-init/SKILL.md +121 -71
  75. package/.kiro/skills/activity-refine/SKILL.md +75 -15
  76. package/.kiro/skills/activity-test-standards/SKILL.md +25 -0
  77. package/.kiro/skills/aws-ops/SKILL.md +155 -0
  78. package/.kiro/skills/deploy-ops/SKILL.md +121 -0
  79. package/.kiro/skills/fly-ops/SKILL.md +138 -0
  80. package/.kiro/skills/git-ops/SKILL.md +27 -7
  81. package/.kiro/skills/memo-cli-usage/REFERENCE.md +230 -17
  82. package/.kiro/skills/memo-cli-usage/SKILL.md +66 -13
  83. package/.kiro/skills/supabase-ops/SKILL.md +109 -0
  84. package/.kiro/steering/implement.md +49 -4
  85. package/.kiro/steering/plan.md +43 -1
  86. package/AGENTS.md +60 -109
  87. package/AGENTS.md.template +124 -0
  88. package/CHANGELOG.md +163 -0
  89. package/CLAUDE.md +23 -18
  90. package/CLAUDE.md.template +103 -0
  91. package/README.md +168 -146
  92. package/TESTING.md +84 -148
  93. package/bundle-manifest.json +43 -2
  94. package/dist/bin/dev-tasks.js +65 -3
  95. package/dist/bin/dev-tasks.js.map +1 -1
  96. package/dist/{adapters/cli → bin}/parse-args.d.ts +2 -6
  97. package/dist/bin/parse-args.d.ts.map +1 -0
  98. package/dist/{adapters/cli → bin}/parse-args.js +2 -18
  99. package/dist/bin/parse-args.js.map +1 -0
  100. package/dist/core/checks/decision-log-format.d.ts +44 -0
  101. package/dist/core/checks/decision-log-format.d.ts.map +1 -0
  102. package/dist/core/checks/decision-log-format.js +171 -0
  103. package/dist/core/checks/decision-log-format.js.map +1 -0
  104. package/dist/core/checks/docs-structure.d.ts +82 -0
  105. package/dist/core/checks/docs-structure.d.ts.map +1 -0
  106. package/dist/core/checks/docs-structure.js +285 -0
  107. package/dist/core/checks/docs-structure.js.map +1 -0
  108. package/dist/core/checks/glossary.d.ts +178 -0
  109. package/dist/core/checks/glossary.d.ts.map +1 -0
  110. package/dist/core/checks/glossary.js +651 -0
  111. package/dist/core/checks/glossary.js.map +1 -0
  112. package/dist/core/checks/index.d.ts +19 -0
  113. package/dist/core/checks/index.d.ts.map +1 -0
  114. package/dist/core/checks/index.js +16 -0
  115. package/dist/core/checks/index.js.map +1 -0
  116. package/dist/core/checks/run.d.ts +22 -0
  117. package/dist/core/checks/run.d.ts.map +1 -0
  118. package/dist/core/checks/run.js +51 -0
  119. package/dist/core/checks/run.js.map +1 -0
  120. package/dist/core/distribution/doctor.d.ts +46 -1
  121. package/dist/core/distribution/doctor.d.ts.map +1 -1
  122. package/dist/core/distribution/doctor.js +161 -2
  123. package/dist/core/distribution/doctor.js.map +1 -1
  124. package/dist/core/distribution/index.d.ts +9 -3
  125. package/dist/core/distribution/index.d.ts.map +1 -1
  126. package/dist/core/distribution/index.js +5 -2
  127. package/dist/core/distribution/index.js.map +1 -1
  128. package/dist/core/distribution/install-if-absent.d.ts +46 -0
  129. package/dist/core/distribution/install-if-absent.d.ts.map +1 -0
  130. package/dist/core/distribution/install-if-absent.js +81 -0
  131. package/dist/core/distribution/install-if-absent.js.map +1 -0
  132. package/dist/core/distribution/install.d.ts.map +1 -1
  133. package/dist/core/distribution/install.js +5 -0
  134. package/dist/core/distribution/install.js.map +1 -1
  135. package/dist/core/distribution/migrate-docs.d.ts +64 -0
  136. package/dist/core/distribution/migrate-docs.d.ts.map +1 -0
  137. package/dist/core/distribution/migrate-docs.js +139 -0
  138. package/dist/core/distribution/migrate-docs.js.map +1 -0
  139. package/dist/core/distribution/profiles.d.ts +49 -0
  140. package/dist/core/distribution/profiles.d.ts.map +1 -1
  141. package/dist/core/distribution/profiles.js +45 -0
  142. package/dist/core/distribution/profiles.js.map +1 -1
  143. package/dist/core/distribution/update.d.ts +14 -0
  144. package/dist/core/distribution/update.d.ts.map +1 -1
  145. package/dist/core/distribution/update.js +77 -3
  146. package/dist/core/distribution/update.js.map +1 -1
  147. package/dist/core/distribution/workspace.d.ts +84 -0
  148. package/dist/core/distribution/workspace.d.ts.map +1 -0
  149. package/dist/core/distribution/workspace.js +276 -0
  150. package/dist/core/distribution/workspace.js.map +1 -0
  151. package/dist/core/exit-codes.d.ts +15 -35
  152. package/dist/core/exit-codes.d.ts.map +1 -1
  153. package/dist/core/exit-codes.js +15 -36
  154. package/dist/core/exit-codes.js.map +1 -1
  155. package/dist/core/index.d.ts +1 -6
  156. package/dist/core/index.d.ts.map +1 -1
  157. package/dist/core/index.js +1 -7
  158. package/dist/core/index.js.map +1 -1
  159. package/package.json +17 -32
  160. package/templates/claude/settings.json +48 -0
  161. package/templates/domain/ubiquitous-language.md +28 -0
  162. package/templates/infra/environments.yaml +16 -0
  163. package/templates/infra/redaction-patterns.txt +47 -0
  164. package/templates/runbooks/README.md +14 -0
  165. package/templates/runbooks/runbook-template.md +40 -0
  166. package/templates/scripts/deploy-status.sh +89 -0
  167. package/templates/scripts/deploy-verify.sh +85 -0
  168. package/templates/scripts/deploy.sh +284 -0
  169. package/templates/scripts/release.sh +170 -0
  170. package/templates/scripts/rollback.sh +109 -0
  171. package/templates/workflows/deploy-dev.yml +66 -0
  172. package/templates/workflows/deploy-prod.yml +66 -0
  173. package/templates/workflows/rollback.yml +77 -0
  174. package/.claude/skills/activity-contract-validation/SKILL.md +0 -167
  175. package/.github/skills/activity-contract-validation/SKILL.md +0 -167
  176. package/.kiro/skills/activity-contract-validation/SKILL.md +0 -167
  177. package/dist/adapters/cli/catalog-build.d.ts +0 -30
  178. package/dist/adapters/cli/catalog-build.d.ts.map +0 -1
  179. package/dist/adapters/cli/catalog-build.js +0 -73
  180. package/dist/adapters/cli/catalog-build.js.map +0 -1
  181. package/dist/adapters/cli/catalog-query.d.ts +0 -13
  182. package/dist/adapters/cli/catalog-query.d.ts.map +0 -1
  183. package/dist/adapters/cli/catalog-query.js +0 -329
  184. package/dist/adapters/cli/catalog-query.js.map +0 -1
  185. package/dist/adapters/cli/catalog-scaffold.d.ts +0 -24
  186. package/dist/adapters/cli/catalog-scaffold.d.ts.map +0 -1
  187. package/dist/adapters/cli/catalog-scaffold.js +0 -46
  188. package/dist/adapters/cli/catalog-scaffold.js.map +0 -1
  189. package/dist/adapters/cli/catalog-validate.d.ts +0 -35
  190. package/dist/adapters/cli/catalog-validate.d.ts.map +0 -1
  191. package/dist/adapters/cli/catalog-validate.js +0 -122
  192. package/dist/adapters/cli/catalog-validate.js.map +0 -1
  193. package/dist/adapters/cli/ctx-assemble.d.ts +0 -19
  194. package/dist/adapters/cli/ctx-assemble.d.ts.map +0 -1
  195. package/dist/adapters/cli/ctx-assemble.js +0 -293
  196. package/dist/adapters/cli/ctx-assemble.js.map +0 -1
  197. package/dist/adapters/cli/ctx-fetch.d.ts +0 -49
  198. package/dist/adapters/cli/ctx-fetch.d.ts.map +0 -1
  199. package/dist/adapters/cli/ctx-fetch.js +0 -267
  200. package/dist/adapters/cli/ctx-fetch.js.map +0 -1
  201. package/dist/adapters/cli/extract-all.d.ts +0 -31
  202. package/dist/adapters/cli/extract-all.d.ts.map +0 -1
  203. package/dist/adapters/cli/extract-all.js +0 -374
  204. package/dist/adapters/cli/extract-all.js.map +0 -1
  205. package/dist/adapters/cli/extract-asyncapi.d.ts +0 -26
  206. package/dist/adapters/cli/extract-asyncapi.d.ts.map +0 -1
  207. package/dist/adapters/cli/extract-asyncapi.js +0 -142
  208. package/dist/adapters/cli/extract-asyncapi.js.map +0 -1
  209. package/dist/adapters/cli/extract-component.d.ts +0 -24
  210. package/dist/adapters/cli/extract-component.d.ts.map +0 -1
  211. package/dist/adapters/cli/extract-component.js +0 -198
  212. package/dist/adapters/cli/extract-component.js.map +0 -1
  213. package/dist/adapters/cli/extract-detect.d.ts +0 -19
  214. package/dist/adapters/cli/extract-detect.d.ts.map +0 -1
  215. package/dist/adapters/cli/extract-detect.js +0 -98
  216. package/dist/adapters/cli/extract-detect.js.map +0 -1
  217. package/dist/adapters/cli/extract-openapi.d.ts +0 -29
  218. package/dist/adapters/cli/extract-openapi.d.ts.map +0 -1
  219. package/dist/adapters/cli/extract-openapi.js +0 -111
  220. package/dist/adapters/cli/extract-openapi.js.map +0 -1
  221. package/dist/adapters/cli/extract-schema.d.ts +0 -15
  222. package/dist/adapters/cli/extract-schema.d.ts.map +0 -1
  223. package/dist/adapters/cli/extract-schema.js +0 -39
  224. package/dist/adapters/cli/extract-schema.js.map +0 -1
  225. package/dist/adapters/cli/index.d.ts +0 -6
  226. package/dist/adapters/cli/index.d.ts.map +0 -1
  227. package/dist/adapters/cli/index.js +0 -5
  228. package/dist/adapters/cli/index.js.map +0 -1
  229. package/dist/adapters/cli/init.d.ts +0 -37
  230. package/dist/adapters/cli/init.d.ts.map +0 -1
  231. package/dist/adapters/cli/init.js +0 -336
  232. package/dist/adapters/cli/init.js.map +0 -1
  233. package/dist/adapters/cli/parse-args.d.ts.map +0 -1
  234. package/dist/adapters/cli/parse-args.js.map +0 -1
  235. package/dist/adapters/cli/scope-gate.d.ts +0 -25
  236. package/dist/adapters/cli/scope-gate.d.ts.map +0 -1
  237. package/dist/adapters/cli/scope-gate.js +0 -157
  238. package/dist/adapters/cli/scope-gate.js.map +0 -1
  239. package/dist/adapters/cli/scope.d.ts +0 -26
  240. package/dist/adapters/cli/scope.d.ts.map +0 -1
  241. package/dist/adapters/cli/scope.js +0 -172
  242. package/dist/adapters/cli/scope.js.map +0 -1
  243. package/dist/adapters/cli/validate-component.d.ts +0 -24
  244. package/dist/adapters/cli/validate-component.d.ts.map +0 -1
  245. package/dist/adapters/cli/validate-component.js +0 -62
  246. package/dist/adapters/cli/validate-component.js.map +0 -1
  247. package/dist/adapters/cli/verify-contract-diff.d.ts +0 -21
  248. package/dist/adapters/cli/verify-contract-diff.d.ts.map +0 -1
  249. package/dist/adapters/cli/verify-contract-diff.js +0 -69
  250. package/dist/adapters/cli/verify-contract-diff.js.map +0 -1
  251. package/dist/adapters/cli/verify-drift.d.ts +0 -24
  252. package/dist/adapters/cli/verify-drift.d.ts.map +0 -1
  253. package/dist/adapters/cli/verify-drift.js +0 -103
  254. package/dist/adapters/cli/verify-drift.js.map +0 -1
  255. package/dist/adapters/cli/verify-impact.d.ts +0 -23
  256. package/dist/adapters/cli/verify-impact.d.ts.map +0 -1
  257. package/dist/adapters/cli/verify-impact.js +0 -119
  258. package/dist/adapters/cli/verify-impact.js.map +0 -1
  259. package/dist/adapters/mcp/index.d.ts +0 -5
  260. package/dist/adapters/mcp/index.d.ts.map +0 -1
  261. package/dist/adapters/mcp/index.js +0 -2
  262. package/dist/adapters/mcp/index.js.map +0 -1
  263. package/dist/bin/dt.d.ts +0 -7
  264. package/dist/bin/dt.d.ts.map +0 -1
  265. package/dist/bin/dt.js +0 -647
  266. package/dist/bin/dt.js.map +0 -1
  267. package/dist/core/catalog/build.d.ts +0 -143
  268. package/dist/core/catalog/build.d.ts.map +0 -1
  269. package/dist/core/catalog/build.js +0 -475
  270. package/dist/core/catalog/build.js.map +0 -1
  271. package/dist/core/catalog/checks/index.d.ts +0 -18
  272. package/dist/core/catalog/checks/index.d.ts.map +0 -1
  273. package/dist/core/catalog/checks/index.js +0 -18
  274. package/dist/core/catalog/checks/index.js.map +0 -1
  275. package/dist/core/catalog/checks/v01-schema.d.ts +0 -17
  276. package/dist/core/catalog/checks/v01-schema.d.ts.map +0 -1
  277. package/dist/core/catalog/checks/v01-schema.js +0 -57
  278. package/dist/core/catalog/checks/v01-schema.js.map +0 -1
  279. package/dist/core/catalog/checks/v02-v03-identity.d.ts +0 -14
  280. package/dist/core/catalog/checks/v02-v03-identity.d.ts.map +0 -1
  281. package/dist/core/catalog/checks/v02-v03-identity.js +0 -60
  282. package/dist/core/catalog/checks/v02-v03-identity.js.map +0 -1
  283. package/dist/core/catalog/checks/v04-referential-integrity.d.ts +0 -7
  284. package/dist/core/catalog/checks/v04-referential-integrity.d.ts.map +0 -1
  285. package/dist/core/catalog/checks/v04-referential-integrity.js +0 -32
  286. package/dist/core/catalog/checks/v04-referential-integrity.js.map +0 -1
  287. package/dist/core/catalog/checks/v05-domain-existence.d.ts +0 -6
  288. package/dist/core/catalog/checks/v05-domain-existence.d.ts.map +0 -1
  289. package/dist/core/catalog/checks/v05-domain-existence.js +0 -23
  290. package/dist/core/catalog/checks/v05-domain-existence.js.map +0 -1
  291. package/dist/core/catalog/checks/v06-v07-paths.d.ts +0 -29
  292. package/dist/core/catalog/checks/v06-v07-paths.d.ts.map +0 -1
  293. package/dist/core/catalog/checks/v06-v07-paths.js +0 -107
  294. package/dist/core/catalog/checks/v06-v07-paths.js.map +0 -1
  295. package/dist/core/catalog/checks/v08-v10-contracts.d.ts +0 -13
  296. package/dist/core/catalog/checks/v08-v10-contracts.d.ts.map +0 -1
  297. package/dist/core/catalog/checks/v08-v10-contracts.js +0 -70
  298. package/dist/core/catalog/checks/v08-v10-contracts.js.map +0 -1
  299. package/dist/core/catalog/checks/v11-manual-fields.d.ts +0 -16
  300. package/dist/core/catalog/checks/v11-manual-fields.d.ts.map +0 -1
  301. package/dist/core/catalog/checks/v11-manual-fields.js +0 -60
  302. package/dist/core/catalog/checks/v11-manual-fields.js.map +0 -1
  303. package/dist/core/catalog/checks/v12-cycles.d.ts +0 -8
  304. package/dist/core/catalog/checks/v12-cycles.d.ts.map +0 -1
  305. package/dist/core/catalog/checks/v12-cycles.js +0 -28
  306. package/dist/core/catalog/checks/v12-cycles.js.map +0 -1
  307. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts +0 -7
  308. package/dist/core/catalog/checks/v13-orphan-contracts.d.ts.map +0 -1
  309. package/dist/core/catalog/checks/v13-orphan-contracts.js +0 -33
  310. package/dist/core/catalog/checks/v13-orphan-contracts.js.map +0 -1
  311. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts +0 -8
  312. package/dist/core/catalog/checks/v14-v15-lifecycle.d.ts.map +0 -1
  313. package/dist/core/catalog/checks/v14-v15-lifecycle.js +0 -42
  314. package/dist/core/catalog/checks/v14-v15-lifecycle.js.map +0 -1
  315. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts +0 -7
  316. package/dist/core/catalog/checks/v16-deprecated-consumers.d.ts.map +0 -1
  317. package/dist/core/catalog/checks/v16-deprecated-consumers.js +0 -47
  318. package/dist/core/catalog/checks/v16-deprecated-consumers.js.map +0 -1
  319. package/dist/core/catalog/checks/v17-low-confidence.d.ts +0 -7
  320. package/dist/core/catalog/checks/v17-low-confidence.d.ts.map +0 -1
  321. package/dist/core/catalog/checks/v17-low-confidence.js +0 -32
  322. package/dist/core/catalog/checks/v17-low-confidence.js.map +0 -1
  323. package/dist/core/catalog/checks/v18-low-payload.d.ts +0 -7
  324. package/dist/core/catalog/checks/v18-low-payload.d.ts.map +0 -1
  325. package/dist/core/catalog/checks/v18-low-payload.js +0 -33
  326. package/dist/core/catalog/checks/v18-low-payload.js.map +0 -1
  327. package/dist/core/catalog/checks/v19-domain-membership.d.ts +0 -8
  328. package/dist/core/catalog/checks/v19-domain-membership.d.ts.map +0 -1
  329. package/dist/core/catalog/checks/v19-domain-membership.js +0 -55
  330. package/dist/core/catalog/checks/v19-domain-membership.js.map +0 -1
  331. package/dist/core/catalog/coverage.d.ts +0 -39
  332. package/dist/core/catalog/coverage.d.ts.map +0 -1
  333. package/dist/core/catalog/coverage.js +0 -62
  334. package/dist/core/catalog/coverage.js.map +0 -1
  335. package/dist/core/catalog/graph.d.ts +0 -49
  336. package/dist/core/catalog/graph.d.ts.map +0 -1
  337. package/dist/core/catalog/graph.js +0 -114
  338. package/dist/core/catalog/graph.js.map +0 -1
  339. package/dist/core/catalog/index-model.d.ts +0 -96
  340. package/dist/core/catalog/index-model.d.ts.map +0 -1
  341. package/dist/core/catalog/index-model.js +0 -8
  342. package/dist/core/catalog/index-model.js.map +0 -1
  343. package/dist/core/catalog/index.d.ts +0 -5
  344. package/dist/core/catalog/index.d.ts.map +0 -1
  345. package/dist/core/catalog/index.js +0 -2
  346. package/dist/core/catalog/index.js.map +0 -1
  347. package/dist/core/catalog/queries.d.ts +0 -69
  348. package/dist/core/catalog/queries.d.ts.map +0 -1
  349. package/dist/core/catalog/queries.js +0 -165
  350. package/dist/core/catalog/queries.js.map +0 -1
  351. package/dist/core/catalog/resolve.d.ts +0 -47
  352. package/dist/core/catalog/resolve.d.ts.map +0 -1
  353. package/dist/core/catalog/resolve.js +0 -318
  354. package/dist/core/catalog/resolve.js.map +0 -1
  355. package/dist/core/catalog/scaffold.d.ts +0 -31
  356. package/dist/core/catalog/scaffold.d.ts.map +0 -1
  357. package/dist/core/catalog/scaffold.js +0 -141
  358. package/dist/core/catalog/scaffold.js.map +0 -1
  359. package/dist/core/catalog/validate-component.d.ts +0 -50
  360. package/dist/core/catalog/validate-component.d.ts.map +0 -1
  361. package/dist/core/catalog/validate-component.js +0 -105
  362. package/dist/core/catalog/validate-component.js.map +0 -1
  363. package/dist/core/catalog/validate.d.ts +0 -71
  364. package/dist/core/catalog/validate.d.ts.map +0 -1
  365. package/dist/core/catalog/validate.js +0 -103
  366. package/dist/core/catalog/validate.js.map +0 -1
  367. package/dist/core/context/assemble.d.ts +0 -126
  368. package/dist/core/context/assemble.d.ts.map +0 -1
  369. package/dist/core/context/assemble.js +0 -197
  370. package/dist/core/context/assemble.js.map +0 -1
  371. package/dist/core/context/cache.d.ts +0 -60
  372. package/dist/core/context/cache.d.ts.map +0 -1
  373. package/dist/core/context/cache.js +0 -236
  374. package/dist/core/context/cache.js.map +0 -1
  375. package/dist/core/context/exit-codes.d.ts +0 -28
  376. package/dist/core/context/exit-codes.d.ts.map +0 -1
  377. package/dist/core/context/exit-codes.js +0 -28
  378. package/dist/core/context/exit-codes.js.map +0 -1
  379. package/dist/core/context/fetch.d.ts +0 -55
  380. package/dist/core/context/fetch.d.ts.map +0 -1
  381. package/dist/core/context/fetch.js +0 -112
  382. package/dist/core/context/fetch.js.map +0 -1
  383. package/dist/core/context/index.d.ts +0 -11
  384. package/dist/core/context/index.d.ts.map +0 -1
  385. package/dist/core/context/index.js +0 -8
  386. package/dist/core/context/index.js.map +0 -1
  387. package/dist/core/context/init.d.ts +0 -179
  388. package/dist/core/context/init.d.ts.map +0 -1
  389. package/dist/core/context/init.js +0 -532
  390. package/dist/core/context/init.js.map +0 -1
  391. package/dist/core/context/layers/architecture-layer.d.ts +0 -13
  392. package/dist/core/context/layers/architecture-layer.d.ts.map +0 -1
  393. package/dist/core/context/layers/architecture-layer.js +0 -24
  394. package/dist/core/context/layers/architecture-layer.js.map +0 -1
  395. package/dist/core/context/layers/contracts-layer.d.ts +0 -13
  396. package/dist/core/context/layers/contracts-layer.d.ts.map +0 -1
  397. package/dist/core/context/layers/contracts-layer.js +0 -83
  398. package/dist/core/context/layers/contracts-layer.js.map +0 -1
  399. package/dist/core/context/layers/conventions-delta-layer.d.ts +0 -13
  400. package/dist/core/context/layers/conventions-delta-layer.d.ts.map +0 -1
  401. package/dist/core/context/layers/conventions-delta-layer.js +0 -37
  402. package/dist/core/context/layers/conventions-delta-layer.js.map +0 -1
  403. package/dist/core/context/layers/flow-layer.d.ts +0 -14
  404. package/dist/core/context/layers/flow-layer.d.ts.map +0 -1
  405. package/dist/core/context/layers/flow-layer.js +0 -61
  406. package/dist/core/context/layers/flow-layer.js.map +0 -1
  407. package/dist/core/context/layers/index-layer.d.ts +0 -13
  408. package/dist/core/context/layers/index-layer.d.ts.map +0 -1
  409. package/dist/core/context/layers/index-layer.js +0 -77
  410. package/dist/core/context/layers/index-layer.js.map +0 -1
  411. package/dist/core/context/layers/primary-layer.d.ts +0 -16
  412. package/dist/core/context/layers/primary-layer.d.ts.map +0 -1
  413. package/dist/core/context/layers/primary-layer.js +0 -61
  414. package/dist/core/context/layers/primary-layer.js.map +0 -1
  415. package/dist/core/context/layers/secondary-layer.d.ts +0 -19
  416. package/dist/core/context/layers/secondary-layer.d.ts.map +0 -1
  417. package/dist/core/context/layers/secondary-layer.js +0 -52
  418. package/dist/core/context/layers/secondary-layer.js.map +0 -1
  419. package/dist/core/context/session-lock.d.ts +0 -114
  420. package/dist/core/context/session-lock.d.ts.map +0 -1
  421. package/dist/core/context/session-lock.js +0 -90
  422. package/dist/core/context/session-lock.js.map +0 -1
  423. package/dist/core/context/tokens.d.ts +0 -35
  424. package/dist/core/context/tokens.d.ts.map +0 -1
  425. package/dist/core/context/tokens.js +0 -88
  426. package/dist/core/context/tokens.js.map +0 -1
  427. package/dist/core/extract/asyncapi/declared.d.ts +0 -19
  428. package/dist/core/extract/asyncapi/declared.d.ts.map +0 -1
  429. package/dist/core/extract/asyncapi/declared.js +0 -168
  430. package/dist/core/extract/asyncapi/declared.js.map +0 -1
  431. package/dist/core/extract/asyncapi/index.d.ts +0 -12
  432. package/dist/core/extract/asyncapi/index.d.ts.map +0 -1
  433. package/dist/core/extract/asyncapi/index.js +0 -8
  434. package/dist/core/extract/asyncapi/index.js.map +0 -1
  435. package/dist/core/extract/asyncapi/payloads.d.ts +0 -20
  436. package/dist/core/extract/asyncapi/payloads.d.ts.map +0 -1
  437. package/dist/core/extract/asyncapi/payloads.js +0 -421
  438. package/dist/core/extract/asyncapi/payloads.js.map +0 -1
  439. package/dist/core/extract/asyncapi/topics.d.ts +0 -27
  440. package/dist/core/extract/asyncapi/topics.d.ts.map +0 -1
  441. package/dist/core/extract/asyncapi/topics.js +0 -368
  442. package/dist/core/extract/asyncapi/topics.js.map +0 -1
  443. package/dist/core/extract/asyncapi/types.d.ts +0 -129
  444. package/dist/core/extract/asyncapi/types.d.ts.map +0 -1
  445. package/dist/core/extract/asyncapi/types.js +0 -5
  446. package/dist/core/extract/asyncapi/types.js.map +0 -1
  447. package/dist/core/extract/asyncapi/validate.d.ts +0 -29
  448. package/dist/core/extract/asyncapi/validate.d.ts.map +0 -1
  449. package/dist/core/extract/asyncapi/validate.js +0 -156
  450. package/dist/core/extract/asyncapi/validate.js.map +0 -1
  451. package/dist/core/extract/component.d.ts +0 -204
  452. package/dist/core/extract/component.d.ts.map +0 -1
  453. package/dist/core/extract/component.js +0 -258
  454. package/dist/core/extract/component.js.map +0 -1
  455. package/dist/core/extract/detect.d.ts +0 -35
  456. package/dist/core/extract/detect.d.ts.map +0 -1
  457. package/dist/core/extract/detect.js +0 -89
  458. package/dist/core/extract/detect.js.map +0 -1
  459. package/dist/core/extract/index.d.ts +0 -12
  460. package/dist/core/extract/index.d.ts.map +0 -1
  461. package/dist/core/extract/index.js +0 -6
  462. package/dist/core/extract/index.js.map +0 -1
  463. package/dist/core/extract/ladder.d.ts +0 -79
  464. package/dist/core/extract/ladder.d.ts.map +0 -1
  465. package/dist/core/extract/ladder.js +0 -70
  466. package/dist/core/extract/ladder.js.map +0 -1
  467. package/dist/core/extract/openapi/index.d.ts +0 -43
  468. package/dist/core/extract/openapi/index.d.ts.map +0 -1
  469. package/dist/core/extract/openapi/index.js +0 -142
  470. package/dist/core/extract/openapi/index.js.map +0 -1
  471. package/dist/core/extract/openapi/route1.d.ts +0 -36
  472. package/dist/core/extract/openapi/route1.d.ts.map +0 -1
  473. package/dist/core/extract/openapi/route1.js +0 -333
  474. package/dist/core/extract/openapi/route1.js.map +0 -1
  475. package/dist/core/extract/openapi/route2-introspect.d.ts +0 -18
  476. package/dist/core/extract/openapi/route2-introspect.d.ts.map +0 -1
  477. package/dist/core/extract/openapi/route2-introspect.js +0 -249
  478. package/dist/core/extract/openapi/route2-introspect.js.map +0 -1
  479. package/dist/core/extract/openapi/route2.d.ts +0 -69
  480. package/dist/core/extract/openapi/route2.d.ts.map +0 -1
  481. package/dist/core/extract/openapi/route2.js +0 -211
  482. package/dist/core/extract/openapi/route2.js.map +0 -1
  483. package/dist/core/extract/openapi/route3.d.ts +0 -26
  484. package/dist/core/extract/openapi/route3.d.ts.map +0 -1
  485. package/dist/core/extract/openapi/route3.js +0 -737
  486. package/dist/core/extract/openapi/route3.js.map +0 -1
  487. package/dist/core/extract/openapi/types.d.ts +0 -125
  488. package/dist/core/extract/openapi/types.d.ts.map +0 -1
  489. package/dist/core/extract/openapi/types.js +0 -5
  490. package/dist/core/extract/openapi/types.js.map +0 -1
  491. package/dist/core/extract/openapi/validate.d.ts +0 -29
  492. package/dist/core/extract/openapi/validate.d.ts.map +0 -1
  493. package/dist/core/extract/openapi/validate.js +0 -200
  494. package/dist/core/extract/openapi/validate.js.map +0 -1
  495. package/dist/core/extract/orm/drizzle.d.ts +0 -20
  496. package/dist/core/extract/orm/drizzle.d.ts.map +0 -1
  497. package/dist/core/extract/orm/drizzle.js +0 -283
  498. package/dist/core/extract/orm/drizzle.js.map +0 -1
  499. package/dist/core/extract/orm/information-schema.d.ts +0 -26
  500. package/dist/core/extract/orm/information-schema.d.ts.map +0 -1
  501. package/dist/core/extract/orm/information-schema.js +0 -142
  502. package/dist/core/extract/orm/information-schema.js.map +0 -1
  503. package/dist/core/extract/orm/prisma.d.ts +0 -23
  504. package/dist/core/extract/orm/prisma.d.ts.map +0 -1
  505. package/dist/core/extract/orm/prisma.js +0 -234
  506. package/dist/core/extract/orm/prisma.js.map +0 -1
  507. package/dist/core/extract/orm/typeorm.d.ts +0 -22
  508. package/dist/core/extract/orm/typeorm.d.ts.map +0 -1
  509. package/dist/core/extract/orm/typeorm.js +0 -269
  510. package/dist/core/extract/orm/typeorm.js.map +0 -1
  511. package/dist/core/extract/orm/types.d.ts +0 -97
  512. package/dist/core/extract/orm/types.d.ts.map +0 -1
  513. package/dist/core/extract/orm/types.js +0 -6
  514. package/dist/core/extract/orm/types.js.map +0 -1
  515. package/dist/core/extract/prompt.d.ts +0 -21
  516. package/dist/core/extract/prompt.d.ts.map +0 -1
  517. package/dist/core/extract/prompt.js +0 -79
  518. package/dist/core/extract/prompt.js.map +0 -1
  519. package/dist/core/extract/provider.d.ts +0 -121
  520. package/dist/core/extract/provider.d.ts.map +0 -1
  521. package/dist/core/extract/provider.js +0 -6
  522. package/dist/core/extract/provider.js.map +0 -1
  523. package/dist/core/extract/providers/node-ts.d.ts +0 -69
  524. package/dist/core/extract/providers/node-ts.d.ts.map +0 -1
  525. package/dist/core/extract/providers/node-ts.js +0 -320
  526. package/dist/core/extract/providers/node-ts.js.map +0 -1
  527. package/dist/core/extract/render/schema-md.d.ts +0 -16
  528. package/dist/core/extract/render/schema-md.d.ts.map +0 -1
  529. package/dist/core/extract/render/schema-md.js +0 -140
  530. package/dist/core/extract/render/schema-md.js.map +0 -1
  531. package/dist/core/extract/report.d.ts +0 -125
  532. package/dist/core/extract/report.d.ts.map +0 -1
  533. package/dist/core/extract/report.js +0 -52
  534. package/dist/core/extract/report.js.map +0 -1
  535. package/dist/core/extract/schema.d.ts +0 -34
  536. package/dist/core/extract/schema.d.ts.map +0 -1
  537. package/dist/core/extract/schema.js +0 -146
  538. package/dist/core/extract/schema.js.map +0 -1
  539. package/dist/core/extract/workspaces.d.ts +0 -33
  540. package/dist/core/extract/workspaces.d.ts.map +0 -1
  541. package/dist/core/extract/workspaces.js +0 -193
  542. package/dist/core/extract/workspaces.js.map +0 -1
  543. package/dist/core/providers/index.d.ts +0 -6
  544. package/dist/core/providers/index.d.ts.map +0 -1
  545. package/dist/core/providers/index.js +0 -2
  546. package/dist/core/providers/index.js.map +0 -1
  547. package/dist/core/providers/tracker.d.ts +0 -74
  548. package/dist/core/providers/tracker.d.ts.map +0 -1
  549. package/dist/core/providers/tracker.js +0 -38
  550. package/dist/core/providers/tracker.js.map +0 -1
  551. package/dist/core/scope/calibration.d.ts +0 -25
  552. package/dist/core/scope/calibration.d.ts.map +0 -1
  553. package/dist/core/scope/calibration.js +0 -52
  554. package/dist/core/scope/calibration.js.map +0 -1
  555. package/dist/core/scope/closure.d.ts +0 -31
  556. package/dist/core/scope/closure.d.ts.map +0 -1
  557. package/dist/core/scope/closure.js +0 -68
  558. package/dist/core/scope/closure.js.map +0 -1
  559. package/dist/core/scope/gate.d.ts +0 -41
  560. package/dist/core/scope/gate.d.ts.map +0 -1
  561. package/dist/core/scope/gate.js +0 -165
  562. package/dist/core/scope/gate.js.map +0 -1
  563. package/dist/core/scope/index.d.ts +0 -18
  564. package/dist/core/scope/index.d.ts.map +0 -1
  565. package/dist/core/scope/index.js +0 -12
  566. package/dist/core/scope/index.js.map +0 -1
  567. package/dist/core/scope/partition.d.ts +0 -36
  568. package/dist/core/scope/partition.d.ts.map +0 -1
  569. package/dist/core/scope/partition.js +0 -78
  570. package/dist/core/scope/partition.js.map +0 -1
  571. package/dist/core/scope/prompt.d.ts +0 -39
  572. package/dist/core/scope/prompt.d.ts.map +0 -1
  573. package/dist/core/scope/prompt.js +0 -123
  574. package/dist/core/scope/prompt.js.map +0 -1
  575. package/dist/core/scope/scoping.d.ts +0 -52
  576. package/dist/core/scope/scoping.d.ts.map +0 -1
  577. package/dist/core/scope/scoping.js +0 -99
  578. package/dist/core/scope/scoping.js.map +0 -1
  579. package/dist/core/scope/types.d.ts +0 -77
  580. package/dist/core/scope/types.d.ts.map +0 -1
  581. package/dist/core/scope/types.js +0 -5
  582. package/dist/core/scope/types.js.map +0 -1
  583. package/dist/core/scope/validate.d.ts +0 -47
  584. package/dist/core/scope/validate.d.ts.map +0 -1
  585. package/dist/core/scope/validate.js +0 -90
  586. package/dist/core/scope/validate.js.map +0 -1
  587. package/dist/core/verify/asyncapi-diff.d.ts +0 -34
  588. package/dist/core/verify/asyncapi-diff.d.ts.map +0 -1
  589. package/dist/core/verify/asyncapi-diff.js +0 -209
  590. package/dist/core/verify/asyncapi-diff.js.map +0 -1
  591. package/dist/core/verify/contract-diff.d.ts +0 -39
  592. package/dist/core/verify/contract-diff.d.ts.map +0 -1
  593. package/dist/core/verify/contract-diff.js +0 -63
  594. package/dist/core/verify/contract-diff.js.map +0 -1
  595. package/dist/core/verify/drift.d.ts +0 -47
  596. package/dist/core/verify/drift.d.ts.map +0 -1
  597. package/dist/core/verify/drift.js +0 -122
  598. package/dist/core/verify/drift.js.map +0 -1
  599. package/dist/core/verify/impact.d.ts +0 -22
  600. package/dist/core/verify/impact.d.ts.map +0 -1
  601. package/dist/core/verify/impact.js +0 -93
  602. package/dist/core/verify/impact.js.map +0 -1
  603. package/dist/core/verify/index.d.ts +0 -10
  604. package/dist/core/verify/index.d.ts.map +0 -1
  605. package/dist/core/verify/index.js +0 -9
  606. package/dist/core/verify/index.js.map +0 -1
  607. package/dist/core/verify/openapi-diff.d.ts +0 -29
  608. package/dist/core/verify/openapi-diff.d.ts.map +0 -1
  609. package/dist/core/verify/openapi-diff.js +0 -291
  610. package/dist/core/verify/openapi-diff.js.map +0 -1
  611. package/dist/core/verify/types.d.ts +0 -138
  612. package/dist/core/verify/types.d.ts.map +0 -1
  613. package/dist/core/verify/types.js +0 -5
  614. package/dist/core/verify/types.js.map +0 -1
  615. package/schemas/component.schema.json +0 -203
  616. package/schemas/flow.schema.json +0 -75
  617. 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