@libar-dev/architect 1.0.0-pre.3

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 (800) hide show
  1. package/CHANGELOG.md +50 -0
  2. package/LICENSE +25 -0
  3. package/LICENSE-MCP +62 -0
  4. package/README.md +147 -0
  5. package/dist/api/arch-queries.d.ts +95 -0
  6. package/dist/api/arch-queries.d.ts.map +1 -0
  7. package/dist/api/arch-queries.js +310 -0
  8. package/dist/api/arch-queries.js.map +1 -0
  9. package/dist/api/context-assembler.d.ts +124 -0
  10. package/dist/api/context-assembler.d.ts.map +1 -0
  11. package/dist/api/context-assembler.js +472 -0
  12. package/dist/api/context-assembler.js.map +1 -0
  13. package/dist/api/context-formatter.d.ts +26 -0
  14. package/dist/api/context-formatter.d.ts.map +1 -0
  15. package/dist/api/context-formatter.js +183 -0
  16. package/dist/api/context-formatter.js.map +1 -0
  17. package/dist/api/coverage-analyzer.d.ts +38 -0
  18. package/dist/api/coverage-analyzer.d.ts.map +1 -0
  19. package/dist/api/coverage-analyzer.js +117 -0
  20. package/dist/api/coverage-analyzer.js.map +1 -0
  21. package/dist/api/fuzzy-match.d.ts +75 -0
  22. package/dist/api/fuzzy-match.d.ts.map +1 -0
  23. package/dist/api/fuzzy-match.js +150 -0
  24. package/dist/api/fuzzy-match.js.map +1 -0
  25. package/dist/api/handoff-generator.d.ts +45 -0
  26. package/dist/api/handoff-generator.d.ts.map +1 -0
  27. package/dist/api/handoff-generator.js +139 -0
  28. package/dist/api/handoff-generator.js.map +1 -0
  29. package/dist/api/index.d.ts +61 -0
  30. package/dist/api/index.d.ts.map +1 -0
  31. package/dist/api/index.js +54 -0
  32. package/dist/api/index.js.map +1 -0
  33. package/dist/api/pattern-helpers.d.ts +51 -0
  34. package/dist/api/pattern-helpers.d.ts.map +1 -0
  35. package/dist/api/pattern-helpers.js +84 -0
  36. package/dist/api/pattern-helpers.js.map +1 -0
  37. package/dist/api/process-state.d.ts +224 -0
  38. package/dist/api/process-state.d.ts.map +1 -0
  39. package/dist/api/process-state.js +308 -0
  40. package/dist/api/process-state.js.map +1 -0
  41. package/dist/api/rules-query.d.ts +60 -0
  42. package/dist/api/rules-query.d.ts.map +1 -0
  43. package/dist/api/rules-query.js +154 -0
  44. package/dist/api/rules-query.js.map +1 -0
  45. package/dist/api/scope-validator.d.ts +56 -0
  46. package/dist/api/scope-validator.d.ts.map +1 -0
  47. package/dist/api/scope-validator.js +293 -0
  48. package/dist/api/scope-validator.js.map +1 -0
  49. package/dist/api/stub-resolver.d.ts +117 -0
  50. package/dist/api/stub-resolver.d.ts.map +1 -0
  51. package/dist/api/stub-resolver.js +154 -0
  52. package/dist/api/stub-resolver.js.map +1 -0
  53. package/dist/api/summarize.d.ts +75 -0
  54. package/dist/api/summarize.d.ts.map +1 -0
  55. package/dist/api/summarize.js +97 -0
  56. package/dist/api/summarize.js.map +1 -0
  57. package/dist/api/types.d.ts +221 -0
  58. package/dist/api/types.d.ts.map +1 -0
  59. package/dist/api/types.js +57 -0
  60. package/dist/api/types.js.map +1 -0
  61. package/dist/cache/file-cache.d.ts +72 -0
  62. package/dist/cache/file-cache.d.ts.map +1 -0
  63. package/dist/cache/file-cache.js +80 -0
  64. package/dist/cache/file-cache.js.map +1 -0
  65. package/dist/cache/index.d.ts +5 -0
  66. package/dist/cache/index.d.ts.map +1 -0
  67. package/dist/cache/index.js +5 -0
  68. package/dist/cache/index.js.map +1 -0
  69. package/dist/cli/cli-schema.d.ts +83 -0
  70. package/dist/cli/cli-schema.d.ts.map +1 -0
  71. package/dist/cli/cli-schema.js +505 -0
  72. package/dist/cli/cli-schema.js.map +1 -0
  73. package/dist/cli/dataset-cache.d.ts +66 -0
  74. package/dist/cli/dataset-cache.d.ts.map +1 -0
  75. package/dist/cli/dataset-cache.js +179 -0
  76. package/dist/cli/dataset-cache.js.map +1 -0
  77. package/dist/cli/error-handler.d.ts +84 -0
  78. package/dist/cli/error-handler.d.ts.map +1 -0
  79. package/dist/cli/error-handler.js +197 -0
  80. package/dist/cli/error-handler.js.map +1 -0
  81. package/dist/cli/generate-docs.d.ts +30 -0
  82. package/dist/cli/generate-docs.d.ts.map +1 -0
  83. package/dist/cli/generate-docs.js +370 -0
  84. package/dist/cli/generate-docs.js.map +1 -0
  85. package/dist/cli/lint-patterns.d.ts +57 -0
  86. package/dist/cli/lint-patterns.d.ts.map +1 -0
  87. package/dist/cli/lint-patterns.js +257 -0
  88. package/dist/cli/lint-patterns.js.map +1 -0
  89. package/dist/cli/lint-process.d.ts +54 -0
  90. package/dist/cli/lint-process.d.ts.map +1 -0
  91. package/dist/cli/lint-process.js +319 -0
  92. package/dist/cli/lint-process.js.map +1 -0
  93. package/dist/cli/lint-steps.d.ts +32 -0
  94. package/dist/cli/lint-steps.d.ts.map +1 -0
  95. package/dist/cli/lint-steps.js +172 -0
  96. package/dist/cli/lint-steps.js.map +1 -0
  97. package/dist/cli/mcp-server.d.ts +22 -0
  98. package/dist/cli/mcp-server.d.ts.map +1 -0
  99. package/dist/cli/mcp-server.js +57 -0
  100. package/dist/cli/mcp-server.js.map +1 -0
  101. package/dist/cli/output-pipeline.d.ts +130 -0
  102. package/dist/cli/output-pipeline.d.ts.map +1 -0
  103. package/dist/cli/output-pipeline.js +234 -0
  104. package/dist/cli/output-pipeline.js.map +1 -0
  105. package/dist/cli/process-api.d.ts +37 -0
  106. package/dist/cli/process-api.d.ts.map +1 -0
  107. package/dist/cli/process-api.js +1550 -0
  108. package/dist/cli/process-api.js.map +1 -0
  109. package/dist/cli/repl.d.ts +38 -0
  110. package/dist/cli/repl.d.ts.map +1 -0
  111. package/dist/cli/repl.js +239 -0
  112. package/dist/cli/repl.js.map +1 -0
  113. package/dist/cli/validate-patterns.d.ts +115 -0
  114. package/dist/cli/validate-patterns.d.ts.map +1 -0
  115. package/dist/cli/validate-patterns.js +707 -0
  116. package/dist/cli/validate-patterns.js.map +1 -0
  117. package/dist/cli/version.d.ts +35 -0
  118. package/dist/cli/version.d.ts.map +1 -0
  119. package/dist/cli/version.js +64 -0
  120. package/dist/cli/version.js.map +1 -0
  121. package/dist/config/config-loader.d.ts +167 -0
  122. package/dist/config/config-loader.d.ts.map +1 -0
  123. package/dist/config/config-loader.js +294 -0
  124. package/dist/config/config-loader.js.map +1 -0
  125. package/dist/config/defaults.d.ts +92 -0
  126. package/dist/config/defaults.d.ts.map +1 -0
  127. package/dist/config/defaults.js +103 -0
  128. package/dist/config/defaults.js.map +1 -0
  129. package/dist/config/define-config.d.ts +37 -0
  130. package/dist/config/define-config.d.ts.map +1 -0
  131. package/dist/config/define-config.js +38 -0
  132. package/dist/config/define-config.js.map +1 -0
  133. package/dist/config/factory.d.ts +79 -0
  134. package/dist/config/factory.d.ts.map +1 -0
  135. package/dist/config/factory.js +116 -0
  136. package/dist/config/factory.js.map +1 -0
  137. package/dist/config/index.d.ts +45 -0
  138. package/dist/config/index.d.ts.map +1 -0
  139. package/dist/config/index.js +48 -0
  140. package/dist/config/index.js.map +1 -0
  141. package/dist/config/merge-sources.d.ts +47 -0
  142. package/dist/config/merge-sources.d.ts.map +1 -0
  143. package/dist/config/merge-sources.js +61 -0
  144. package/dist/config/merge-sources.js.map +1 -0
  145. package/dist/config/presets.d.ts +115 -0
  146. package/dist/config/presets.d.ts.map +1 -0
  147. package/dist/config/presets.js +119 -0
  148. package/dist/config/presets.js.map +1 -0
  149. package/dist/config/project-config-schema.d.ts +192 -0
  150. package/dist/config/project-config-schema.d.ts.map +1 -0
  151. package/dist/config/project-config-schema.js +231 -0
  152. package/dist/config/project-config-schema.js.map +1 -0
  153. package/dist/config/project-config.d.ts +229 -0
  154. package/dist/config/project-config.d.ts.map +1 -0
  155. package/dist/config/project-config.js +37 -0
  156. package/dist/config/project-config.js.map +1 -0
  157. package/dist/config/regex-builders.d.ts +49 -0
  158. package/dist/config/regex-builders.d.ts.map +1 -0
  159. package/dist/config/regex-builders.js +85 -0
  160. package/dist/config/regex-builders.js.map +1 -0
  161. package/dist/config/resolve-config.d.ts +65 -0
  162. package/dist/config/resolve-config.d.ts.map +1 -0
  163. package/dist/config/resolve-config.js +150 -0
  164. package/dist/config/resolve-config.js.map +1 -0
  165. package/dist/config/types.d.ts +81 -0
  166. package/dist/config/types.d.ts.map +1 -0
  167. package/dist/config/types.js +22 -0
  168. package/dist/config/types.js.map +1 -0
  169. package/dist/config/workflow-loader.d.ts +90 -0
  170. package/dist/config/workflow-loader.d.ts.map +1 -0
  171. package/dist/config/workflow-loader.js +167 -0
  172. package/dist/config/workflow-loader.js.map +1 -0
  173. package/dist/extractor/doc-extractor.d.ts +233 -0
  174. package/dist/extractor/doc-extractor.d.ts.map +1 -0
  175. package/dist/extractor/doc-extractor.js +481 -0
  176. package/dist/extractor/doc-extractor.js.map +1 -0
  177. package/dist/extractor/dual-source-extractor.d.ts +161 -0
  178. package/dist/extractor/dual-source-extractor.d.ts.map +1 -0
  179. package/dist/extractor/dual-source-extractor.js +407 -0
  180. package/dist/extractor/dual-source-extractor.js.map +1 -0
  181. package/dist/extractor/gherkin-extractor.d.ts +170 -0
  182. package/dist/extractor/gherkin-extractor.d.ts.map +1 -0
  183. package/dist/extractor/gherkin-extractor.js +543 -0
  184. package/dist/extractor/gherkin-extractor.js.map +1 -0
  185. package/dist/extractor/index.d.ts +7 -0
  186. package/dist/extractor/index.d.ts.map +1 -0
  187. package/dist/extractor/index.js +11 -0
  188. package/dist/extractor/index.js.map +1 -0
  189. package/dist/extractor/layer-inference.d.ts +66 -0
  190. package/dist/extractor/layer-inference.d.ts.map +1 -0
  191. package/dist/extractor/layer-inference.js +93 -0
  192. package/dist/extractor/layer-inference.js.map +1 -0
  193. package/dist/extractor/shape-extractor.d.ts +79 -0
  194. package/dist/extractor/shape-extractor.d.ts.map +1 -0
  195. package/dist/extractor/shape-extractor.js +966 -0
  196. package/dist/extractor/shape-extractor.js.map +1 -0
  197. package/dist/generators/built-in/cli-recipe-generator.d.ts +30 -0
  198. package/dist/generators/built-in/cli-recipe-generator.d.ts.map +1 -0
  199. package/dist/generators/built-in/cli-recipe-generator.js +155 -0
  200. package/dist/generators/built-in/cli-recipe-generator.js.map +1 -0
  201. package/dist/generators/built-in/codec-generators.d.ts +29 -0
  202. package/dist/generators/built-in/codec-generators.d.ts.map +1 -0
  203. package/dist/generators/built-in/codec-generators.js +195 -0
  204. package/dist/generators/built-in/codec-generators.js.map +1 -0
  205. package/dist/generators/built-in/decision-doc-generator.d.ts +204 -0
  206. package/dist/generators/built-in/decision-doc-generator.d.ts.map +1 -0
  207. package/dist/generators/built-in/decision-doc-generator.js +654 -0
  208. package/dist/generators/built-in/decision-doc-generator.js.map +1 -0
  209. package/dist/generators/built-in/design-review-generator.d.ts +26 -0
  210. package/dist/generators/built-in/design-review-generator.d.ts.map +1 -0
  211. package/dist/generators/built-in/design-review-generator.js +94 -0
  212. package/dist/generators/built-in/design-review-generator.js.map +1 -0
  213. package/dist/generators/built-in/index.d.ts +22 -0
  214. package/dist/generators/built-in/index.d.ts.map +1 -0
  215. package/dist/generators/built-in/index.js +23 -0
  216. package/dist/generators/built-in/index.js.map +1 -0
  217. package/dist/generators/built-in/process-api-reference-generator.d.ts +18 -0
  218. package/dist/generators/built-in/process-api-reference-generator.d.ts.map +1 -0
  219. package/dist/generators/built-in/process-api-reference-generator.js +85 -0
  220. package/dist/generators/built-in/process-api-reference-generator.js.map +1 -0
  221. package/dist/generators/built-in/reference-generators.d.ts +51 -0
  222. package/dist/generators/built-in/reference-generators.d.ts.map +1 -0
  223. package/dist/generators/built-in/reference-generators.js +320 -0
  224. package/dist/generators/built-in/reference-generators.js.map +1 -0
  225. package/dist/generators/codec-based.d.ts +63 -0
  226. package/dist/generators/codec-based.d.ts.map +1 -0
  227. package/dist/generators/codec-based.js +88 -0
  228. package/dist/generators/codec-based.js.map +1 -0
  229. package/dist/generators/content-deduplicator.d.ts +114 -0
  230. package/dist/generators/content-deduplicator.d.ts.map +1 -0
  231. package/dist/generators/content-deduplicator.js +356 -0
  232. package/dist/generators/content-deduplicator.js.map +1 -0
  233. package/dist/generators/index.d.ts +50 -0
  234. package/dist/generators/index.d.ts.map +1 -0
  235. package/dist/generators/index.js +54 -0
  236. package/dist/generators/index.js.map +1 -0
  237. package/dist/generators/orchestrator.d.ts +265 -0
  238. package/dist/generators/orchestrator.d.ts.map +1 -0
  239. package/dist/generators/orchestrator.js +570 -0
  240. package/dist/generators/orchestrator.js.map +1 -0
  241. package/dist/generators/pipeline/build-pipeline.d.ts +131 -0
  242. package/dist/generators/pipeline/build-pipeline.d.ts.map +1 -0
  243. package/dist/generators/pipeline/build-pipeline.js +248 -0
  244. package/dist/generators/pipeline/build-pipeline.js.map +1 -0
  245. package/dist/generators/pipeline/context-inference.d.ts +55 -0
  246. package/dist/generators/pipeline/context-inference.d.ts.map +1 -0
  247. package/dist/generators/pipeline/context-inference.js +76 -0
  248. package/dist/generators/pipeline/context-inference.js.map +1 -0
  249. package/dist/generators/pipeline/index.d.ts +27 -0
  250. package/dist/generators/pipeline/index.d.ts.map +1 -0
  251. package/dist/generators/pipeline/index.js +34 -0
  252. package/dist/generators/pipeline/index.js.map +1 -0
  253. package/dist/generators/pipeline/merge-patterns.d.ts +33 -0
  254. package/dist/generators/pipeline/merge-patterns.d.ts.map +1 -0
  255. package/dist/generators/pipeline/merge-patterns.js +50 -0
  256. package/dist/generators/pipeline/merge-patterns.js.map +1 -0
  257. package/dist/generators/pipeline/relationship-resolver.d.ts +47 -0
  258. package/dist/generators/pipeline/relationship-resolver.d.ts.map +1 -0
  259. package/dist/generators/pipeline/relationship-resolver.js +132 -0
  260. package/dist/generators/pipeline/relationship-resolver.js.map +1 -0
  261. package/dist/generators/pipeline/sequence-utils.d.ts +49 -0
  262. package/dist/generators/pipeline/sequence-utils.d.ts.map +1 -0
  263. package/dist/generators/pipeline/sequence-utils.js +235 -0
  264. package/dist/generators/pipeline/sequence-utils.js.map +1 -0
  265. package/dist/generators/pipeline/transform-dataset.d.ts +82 -0
  266. package/dist/generators/pipeline/transform-dataset.d.ts.map +1 -0
  267. package/dist/generators/pipeline/transform-dataset.js +355 -0
  268. package/dist/generators/pipeline/transform-dataset.js.map +1 -0
  269. package/dist/generators/pipeline/transform-types.d.ts +96 -0
  270. package/dist/generators/pipeline/transform-types.d.ts.map +1 -0
  271. package/dist/generators/pipeline/transform-types.js +18 -0
  272. package/dist/generators/pipeline/transform-types.js.map +1 -0
  273. package/dist/generators/registry.d.ts +64 -0
  274. package/dist/generators/registry.d.ts.map +1 -0
  275. package/dist/generators/registry.js +77 -0
  276. package/dist/generators/registry.js.map +1 -0
  277. package/dist/generators/source-mapper.d.ts +143 -0
  278. package/dist/generators/source-mapper.d.ts.map +1 -0
  279. package/dist/generators/source-mapper.js +602 -0
  280. package/dist/generators/source-mapper.js.map +1 -0
  281. package/dist/generators/source-mapping-validator.d.ts +118 -0
  282. package/dist/generators/source-mapping-validator.d.ts.map +1 -0
  283. package/dist/generators/source-mapping-validator.js +334 -0
  284. package/dist/generators/source-mapping-validator.js.map +1 -0
  285. package/dist/generators/types.d.ts +104 -0
  286. package/dist/generators/types.d.ts.map +1 -0
  287. package/dist/generators/types.js +5 -0
  288. package/dist/generators/types.js.map +1 -0
  289. package/dist/generators/warning-collector.d.ts +144 -0
  290. package/dist/generators/warning-collector.d.ts.map +1 -0
  291. package/dist/generators/warning-collector.js +166 -0
  292. package/dist/generators/warning-collector.js.map +1 -0
  293. package/dist/git/branch-diff.d.ts +44 -0
  294. package/dist/git/branch-diff.d.ts.map +1 -0
  295. package/dist/git/branch-diff.js +57 -0
  296. package/dist/git/branch-diff.js.map +1 -0
  297. package/dist/git/helpers.d.ts +46 -0
  298. package/dist/git/helpers.d.ts.map +1 -0
  299. package/dist/git/helpers.js +67 -0
  300. package/dist/git/helpers.js.map +1 -0
  301. package/dist/git/index.d.ts +18 -0
  302. package/dist/git/index.d.ts.map +1 -0
  303. package/dist/git/index.js +18 -0
  304. package/dist/git/index.js.map +1 -0
  305. package/dist/git/name-status.d.ts +32 -0
  306. package/dist/git/name-status.d.ts.map +1 -0
  307. package/dist/git/name-status.js +66 -0
  308. package/dist/git/name-status.js.map +1 -0
  309. package/dist/index.d.ts +107 -0
  310. package/dist/index.d.ts.map +1 -0
  311. package/dist/index.js +122 -0
  312. package/dist/index.js.map +1 -0
  313. package/dist/lint/engine.d.ts +113 -0
  314. package/dist/lint/engine.d.ts.map +1 -0
  315. package/dist/lint/engine.js +228 -0
  316. package/dist/lint/engine.js.map +1 -0
  317. package/dist/lint/index.d.ts +26 -0
  318. package/dist/lint/index.d.ts.map +1 -0
  319. package/dist/lint/index.js +24 -0
  320. package/dist/lint/index.js.map +1 -0
  321. package/dist/lint/process-guard/decider.d.ts +166 -0
  322. package/dist/lint/process-guard/decider.d.ts.map +1 -0
  323. package/dist/lint/process-guard/decider.js +412 -0
  324. package/dist/lint/process-guard/decider.js.map +1 -0
  325. package/dist/lint/process-guard/derive-state.d.ts +96 -0
  326. package/dist/lint/process-guard/derive-state.d.ts.map +1 -0
  327. package/dist/lint/process-guard/derive-state.js +368 -0
  328. package/dist/lint/process-guard/derive-state.js.map +1 -0
  329. package/dist/lint/process-guard/detect-changes.d.ts +109 -0
  330. package/dist/lint/process-guard/detect-changes.d.ts.map +1 -0
  331. package/dist/lint/process-guard/detect-changes.js +487 -0
  332. package/dist/lint/process-guard/detect-changes.js.map +1 -0
  333. package/dist/lint/process-guard/index.d.ts +35 -0
  334. package/dist/lint/process-guard/index.d.ts.map +1 -0
  335. package/dist/lint/process-guard/index.js +39 -0
  336. package/dist/lint/process-guard/index.js.map +1 -0
  337. package/dist/lint/process-guard/types.d.ts +255 -0
  338. package/dist/lint/process-guard/types.d.ts.map +1 -0
  339. package/dist/lint/process-guard/types.js +31 -0
  340. package/dist/lint/process-guard/types.js.map +1 -0
  341. package/dist/lint/rules.d.ts +147 -0
  342. package/dist/lint/rules.d.ts.map +1 -0
  343. package/dist/lint/rules.js +289 -0
  344. package/dist/lint/rules.js.map +1 -0
  345. package/dist/lint/steps/cross-checks.d.ts +66 -0
  346. package/dist/lint/steps/cross-checks.d.ts.map +1 -0
  347. package/dist/lint/steps/cross-checks.js +290 -0
  348. package/dist/lint/steps/cross-checks.js.map +1 -0
  349. package/dist/lint/steps/feature-checks.d.ts +78 -0
  350. package/dist/lint/steps/feature-checks.d.ts.map +1 -0
  351. package/dist/lint/steps/feature-checks.js +279 -0
  352. package/dist/lint/steps/feature-checks.js.map +1 -0
  353. package/dist/lint/steps/index.d.ts +22 -0
  354. package/dist/lint/steps/index.d.ts.map +1 -0
  355. package/dist/lint/steps/index.js +26 -0
  356. package/dist/lint/steps/index.js.map +1 -0
  357. package/dist/lint/steps/pair-resolver.d.ts +29 -0
  358. package/dist/lint/steps/pair-resolver.d.ts.map +1 -0
  359. package/dist/lint/steps/pair-resolver.js +76 -0
  360. package/dist/lint/steps/pair-resolver.js.map +1 -0
  361. package/dist/lint/steps/runner.d.ts +28 -0
  362. package/dist/lint/steps/runner.d.ts.map +1 -0
  363. package/dist/lint/steps/runner.js +143 -0
  364. package/dist/lint/steps/runner.js.map +1 -0
  365. package/dist/lint/steps/step-checks.d.ts +41 -0
  366. package/dist/lint/steps/step-checks.d.ts.map +1 -0
  367. package/dist/lint/steps/step-checks.js +164 -0
  368. package/dist/lint/steps/step-checks.js.map +1 -0
  369. package/dist/lint/steps/types.d.ts +95 -0
  370. package/dist/lint/steps/types.d.ts.map +1 -0
  371. package/dist/lint/steps/types.js +79 -0
  372. package/dist/lint/steps/types.js.map +1 -0
  373. package/dist/lint/steps/utils.d.ts +22 -0
  374. package/dist/lint/steps/utils.d.ts.map +1 -0
  375. package/dist/lint/steps/utils.js +57 -0
  376. package/dist/lint/steps/utils.js.map +1 -0
  377. package/dist/mcp/file-watcher.d.ts +24 -0
  378. package/dist/mcp/file-watcher.d.ts.map +1 -0
  379. package/dist/mcp/file-watcher.js +75 -0
  380. package/dist/mcp/file-watcher.js.map +1 -0
  381. package/dist/mcp/index.d.ts +19 -0
  382. package/dist/mcp/index.d.ts.map +1 -0
  383. package/dist/mcp/index.js +21 -0
  384. package/dist/mcp/index.js.map +1 -0
  385. package/dist/mcp/pipeline-session.d.ts +33 -0
  386. package/dist/mcp/pipeline-session.d.ts.map +1 -0
  387. package/dist/mcp/pipeline-session.js +149 -0
  388. package/dist/mcp/pipeline-session.js.map +1 -0
  389. package/dist/mcp/server.d.ts +28 -0
  390. package/dist/mcp/server.d.ts.map +1 -0
  391. package/dist/mcp/server.js +197 -0
  392. package/dist/mcp/server.js.map +1 -0
  393. package/dist/mcp/tool-registry.d.ts +4 -0
  394. package/dist/mcp/tool-registry.d.ts.map +1 -0
  395. package/dist/mcp/tool-registry.js +525 -0
  396. package/dist/mcp/tool-registry.js.map +1 -0
  397. package/dist/renderable/codecs/adr.d.ts +4730 -0
  398. package/dist/renderable/codecs/adr.d.ts.map +1 -0
  399. package/dist/renderable/codecs/adr.js +590 -0
  400. package/dist/renderable/codecs/adr.js.map +1 -0
  401. package/dist/renderable/codecs/architecture.d.ts +4760 -0
  402. package/dist/renderable/codecs/architecture.d.ts.map +1 -0
  403. package/dist/renderable/codecs/architecture.js +524 -0
  404. package/dist/renderable/codecs/architecture.js.map +1 -0
  405. package/dist/renderable/codecs/business-rules.d.ts +4777 -0
  406. package/dist/renderable/codecs/business-rules.d.ts.map +1 -0
  407. package/dist/renderable/codecs/business-rules.js +648 -0
  408. package/dist/renderable/codecs/business-rules.js.map +1 -0
  409. package/dist/renderable/codecs/claude-module.d.ts +4710 -0
  410. package/dist/renderable/codecs/claude-module.d.ts.map +1 -0
  411. package/dist/renderable/codecs/claude-module.js +214 -0
  412. package/dist/renderable/codecs/claude-module.js.map +1 -0
  413. package/dist/renderable/codecs/composite.d.ts +84 -0
  414. package/dist/renderable/codecs/composite.d.ts.map +1 -0
  415. package/dist/renderable/codecs/composite.js +124 -0
  416. package/dist/renderable/codecs/composite.js.map +1 -0
  417. package/dist/renderable/codecs/convention-extractor.d.ts +105 -0
  418. package/dist/renderable/codecs/convention-extractor.d.ts.map +1 -0
  419. package/dist/renderable/codecs/convention-extractor.js +353 -0
  420. package/dist/renderable/codecs/convention-extractor.js.map +1 -0
  421. package/dist/renderable/codecs/decision-doc.d.ts +308 -0
  422. package/dist/renderable/codecs/decision-doc.d.ts.map +1 -0
  423. package/dist/renderable/codecs/decision-doc.js +485 -0
  424. package/dist/renderable/codecs/decision-doc.js.map +1 -0
  425. package/dist/renderable/codecs/design-review.d.ts +55 -0
  426. package/dist/renderable/codecs/design-review.d.ts.map +1 -0
  427. package/dist/renderable/codecs/design-review.js +532 -0
  428. package/dist/renderable/codecs/design-review.js.map +1 -0
  429. package/dist/renderable/codecs/diagram-utils.d.ts +62 -0
  430. package/dist/renderable/codecs/diagram-utils.d.ts.map +1 -0
  431. package/dist/renderable/codecs/diagram-utils.js +70 -0
  432. package/dist/renderable/codecs/diagram-utils.js.map +1 -0
  433. package/dist/renderable/codecs/helpers.d.ts +553 -0
  434. package/dist/renderable/codecs/helpers.d.ts.map +1 -0
  435. package/dist/renderable/codecs/helpers.js +913 -0
  436. package/dist/renderable/codecs/helpers.js.map +1 -0
  437. package/dist/renderable/codecs/index-codec.d.ts +4714 -0
  438. package/dist/renderable/codecs/index-codec.d.ts.map +1 -0
  439. package/dist/renderable/codecs/index-codec.js +250 -0
  440. package/dist/renderable/codecs/index-codec.js.map +1 -0
  441. package/dist/renderable/codecs/index.d.ts +46 -0
  442. package/dist/renderable/codecs/index.d.ts.map +1 -0
  443. package/dist/renderable/codecs/index.js +70 -0
  444. package/dist/renderable/codecs/index.js.map +1 -0
  445. package/dist/renderable/codecs/patterns.d.ts +4757 -0
  446. package/dist/renderable/codecs/patterns.d.ts.map +1 -0
  447. package/dist/renderable/codecs/patterns.js +462 -0
  448. package/dist/renderable/codecs/patterns.js.map +1 -0
  449. package/dist/renderable/codecs/planning.d.ts +14055 -0
  450. package/dist/renderable/codecs/planning.d.ts.map +1 -0
  451. package/dist/renderable/codecs/planning.js +449 -0
  452. package/dist/renderable/codecs/planning.js.map +1 -0
  453. package/dist/renderable/codecs/pr-changes.d.ts +4742 -0
  454. package/dist/renderable/codecs/pr-changes.d.ts.map +1 -0
  455. package/dist/renderable/codecs/pr-changes.js +425 -0
  456. package/dist/renderable/codecs/pr-changes.js.map +1 -0
  457. package/dist/renderable/codecs/reference.d.ts +215 -0
  458. package/dist/renderable/codecs/reference.d.ts.map +1 -0
  459. package/dist/renderable/codecs/reference.js +1578 -0
  460. package/dist/renderable/codecs/reference.js.map +1 -0
  461. package/dist/renderable/codecs/reporting.d.ts +14026 -0
  462. package/dist/renderable/codecs/reporting.d.ts.map +1 -0
  463. package/dist/renderable/codecs/reporting.js +365 -0
  464. package/dist/renderable/codecs/reporting.js.map +1 -0
  465. package/dist/renderable/codecs/requirements.d.ts +4743 -0
  466. package/dist/renderable/codecs/requirements.d.ts.map +1 -0
  467. package/dist/renderable/codecs/requirements.js +428 -0
  468. package/dist/renderable/codecs/requirements.js.map +1 -0
  469. package/dist/renderable/codecs/session.d.ts +9410 -0
  470. package/dist/renderable/codecs/session.d.ts.map +1 -0
  471. package/dist/renderable/codecs/session.js +848 -0
  472. package/dist/renderable/codecs/session.js.map +1 -0
  473. package/dist/renderable/codecs/shape-matcher.d.ts +54 -0
  474. package/dist/renderable/codecs/shape-matcher.d.ts.map +1 -0
  475. package/dist/renderable/codecs/shape-matcher.js +106 -0
  476. package/dist/renderable/codecs/shape-matcher.js.map +1 -0
  477. package/dist/renderable/codecs/shared-schema.d.ts +44 -0
  478. package/dist/renderable/codecs/shared-schema.d.ts.map +1 -0
  479. package/dist/renderable/codecs/shared-schema.js +43 -0
  480. package/dist/renderable/codecs/shared-schema.js.map +1 -0
  481. package/dist/renderable/codecs/taxonomy.d.ts +4733 -0
  482. package/dist/renderable/codecs/taxonomy.d.ts.map +1 -0
  483. package/dist/renderable/codecs/taxonomy.js +570 -0
  484. package/dist/renderable/codecs/taxonomy.js.map +1 -0
  485. package/dist/renderable/codecs/timeline.d.ts +14094 -0
  486. package/dist/renderable/codecs/timeline.d.ts.map +1 -0
  487. package/dist/renderable/codecs/timeline.js +906 -0
  488. package/dist/renderable/codecs/timeline.js.map +1 -0
  489. package/dist/renderable/codecs/types/base.d.ts +81 -0
  490. package/dist/renderable/codecs/types/base.d.ts.map +1 -0
  491. package/dist/renderable/codecs/types/base.js +56 -0
  492. package/dist/renderable/codecs/types/base.js.map +1 -0
  493. package/dist/renderable/codecs/types/index.d.ts +5 -0
  494. package/dist/renderable/codecs/types/index.d.ts.map +1 -0
  495. package/dist/renderable/codecs/types/index.js +5 -0
  496. package/dist/renderable/codecs/types/index.js.map +1 -0
  497. package/dist/renderable/codecs/validation-rules.d.ts +4773 -0
  498. package/dist/renderable/codecs/validation-rules.d.ts.map +1 -0
  499. package/dist/renderable/codecs/validation-rules.js +537 -0
  500. package/dist/renderable/codecs/validation-rules.js.map +1 -0
  501. package/dist/renderable/generate.d.ts +338 -0
  502. package/dist/renderable/generate.d.ts.map +1 -0
  503. package/dist/renderable/generate.js +437 -0
  504. package/dist/renderable/generate.js.map +1 -0
  505. package/dist/renderable/index.d.ts +36 -0
  506. package/dist/renderable/index.d.ts.map +1 -0
  507. package/dist/renderable/index.js +58 -0
  508. package/dist/renderable/index.js.map +1 -0
  509. package/dist/renderable/load-preamble.d.ts +56 -0
  510. package/dist/renderable/load-preamble.d.ts.map +1 -0
  511. package/dist/renderable/load-preamble.js +298 -0
  512. package/dist/renderable/load-preamble.js.map +1 -0
  513. package/dist/renderable/render.d.ts +61 -0
  514. package/dist/renderable/render.d.ts.map +1 -0
  515. package/dist/renderable/render.js +346 -0
  516. package/dist/renderable/render.js.map +1 -0
  517. package/dist/renderable/schema.d.ts +194 -0
  518. package/dist/renderable/schema.d.ts.map +1 -0
  519. package/dist/renderable/schema.js +197 -0
  520. package/dist/renderable/schema.js.map +1 -0
  521. package/dist/renderable/utils.d.ts +146 -0
  522. package/dist/renderable/utils.d.ts.map +1 -0
  523. package/dist/renderable/utils.js +362 -0
  524. package/dist/renderable/utils.js.map +1 -0
  525. package/dist/scanner/ast-parser.d.ts +75 -0
  526. package/dist/scanner/ast-parser.d.ts.map +1 -0
  527. package/dist/scanner/ast-parser.js +835 -0
  528. package/dist/scanner/ast-parser.js.map +1 -0
  529. package/dist/scanner/gherkin-ast-parser.d.ts +166 -0
  530. package/dist/scanner/gherkin-ast-parser.d.ts.map +1 -0
  531. package/dist/scanner/gherkin-ast-parser.js +507 -0
  532. package/dist/scanner/gherkin-ast-parser.js.map +1 -0
  533. package/dist/scanner/gherkin-scanner.d.ts +106 -0
  534. package/dist/scanner/gherkin-scanner.d.ts.map +1 -0
  535. package/dist/scanner/gherkin-scanner.js +149 -0
  536. package/dist/scanner/gherkin-scanner.js.map +1 -0
  537. package/dist/scanner/index.d.ts +85 -0
  538. package/dist/scanner/index.d.ts.map +1 -0
  539. package/dist/scanner/index.js +102 -0
  540. package/dist/scanner/index.js.map +1 -0
  541. package/dist/scanner/pattern-scanner.d.ts +83 -0
  542. package/dist/scanner/pattern-scanner.d.ts.map +1 -0
  543. package/dist/scanner/pattern-scanner.js +110 -0
  544. package/dist/scanner/pattern-scanner.js.map +1 -0
  545. package/dist/taxonomy/categories.d.ts +47 -0
  546. package/dist/taxonomy/categories.d.ts.map +1 -0
  547. package/dist/taxonomy/categories.js +175 -0
  548. package/dist/taxonomy/categories.js.map +1 -0
  549. package/dist/taxonomy/claude-section-values.d.ts +12 -0
  550. package/dist/taxonomy/claude-section-values.d.ts.map +1 -0
  551. package/dist/taxonomy/claude-section-values.js +17 -0
  552. package/dist/taxonomy/claude-section-values.js.map +1 -0
  553. package/dist/taxonomy/conventions.d.ts +13 -0
  554. package/dist/taxonomy/conventions.d.ts.map +1 -0
  555. package/dist/taxonomy/conventions.js +27 -0
  556. package/dist/taxonomy/conventions.js.map +1 -0
  557. package/dist/taxonomy/deliverable-status.d.ts +99 -0
  558. package/dist/taxonomy/deliverable-status.d.ts.map +1 -0
  559. package/dist/taxonomy/deliverable-status.js +131 -0
  560. package/dist/taxonomy/deliverable-status.js.map +1 -0
  561. package/dist/taxonomy/format-types.d.ts +17 -0
  562. package/dist/taxonomy/format-types.d.ts.map +1 -0
  563. package/dist/taxonomy/format-types.js +23 -0
  564. package/dist/taxonomy/format-types.js.map +1 -0
  565. package/dist/taxonomy/generator-options.d.ts +67 -0
  566. package/dist/taxonomy/generator-options.d.ts.map +1 -0
  567. package/dist/taxonomy/generator-options.js +75 -0
  568. package/dist/taxonomy/generator-options.js.map +1 -0
  569. package/dist/taxonomy/hierarchy-levels.d.ts +23 -0
  570. package/dist/taxonomy/hierarchy-levels.d.ts.map +1 -0
  571. package/dist/taxonomy/hierarchy-levels.js +22 -0
  572. package/dist/taxonomy/hierarchy-levels.js.map +1 -0
  573. package/dist/taxonomy/index.d.ts +35 -0
  574. package/dist/taxonomy/index.d.ts.map +1 -0
  575. package/dist/taxonomy/index.js +56 -0
  576. package/dist/taxonomy/index.js.map +1 -0
  577. package/dist/taxonomy/layer-types.d.ts +22 -0
  578. package/dist/taxonomy/layer-types.d.ts.map +1 -0
  579. package/dist/taxonomy/layer-types.js +28 -0
  580. package/dist/taxonomy/layer-types.js.map +1 -0
  581. package/dist/taxonomy/normalized-status.d.ts +99 -0
  582. package/dist/taxonomy/normalized-status.d.ts.map +1 -0
  583. package/dist/taxonomy/normalized-status.js +113 -0
  584. package/dist/taxonomy/normalized-status.js.map +1 -0
  585. package/dist/taxonomy/registry-builder.d.ts +104 -0
  586. package/dist/taxonomy/registry-builder.d.ts.map +1 -0
  587. package/dist/taxonomy/registry-builder.js +561 -0
  588. package/dist/taxonomy/registry-builder.js.map +1 -0
  589. package/dist/taxonomy/risk-levels.d.ts +16 -0
  590. package/dist/taxonomy/risk-levels.d.ts.map +1 -0
  591. package/dist/taxonomy/risk-levels.js +15 -0
  592. package/dist/taxonomy/risk-levels.js.map +1 -0
  593. package/dist/taxonomy/severity-types.d.ts +6 -0
  594. package/dist/taxonomy/severity-types.d.ts.map +1 -0
  595. package/dist/taxonomy/severity-types.js +5 -0
  596. package/dist/taxonomy/severity-types.js.map +1 -0
  597. package/dist/taxonomy/status-values.d.ts +39 -0
  598. package/dist/taxonomy/status-values.d.ts.map +1 -0
  599. package/dist/taxonomy/status-values.js +42 -0
  600. package/dist/taxonomy/status-values.js.map +1 -0
  601. package/dist/types/branded.d.ts +89 -0
  602. package/dist/types/branded.d.ts.map +1 -0
  603. package/dist/types/branded.js +57 -0
  604. package/dist/types/branded.js.map +1 -0
  605. package/dist/types/errors.d.ts +342 -0
  606. package/dist/types/errors.d.ts.map +1 -0
  607. package/dist/types/errors.js +251 -0
  608. package/dist/types/errors.js.map +1 -0
  609. package/dist/types/index.d.ts +41 -0
  610. package/dist/types/index.d.ts.map +1 -0
  611. package/dist/types/index.js +5 -0
  612. package/dist/types/index.js.map +1 -0
  613. package/dist/types/result.d.ts +78 -0
  614. package/dist/types/result.d.ts.map +1 -0
  615. package/dist/types/result.js +78 -0
  616. package/dist/types/result.js.map +1 -0
  617. package/dist/utils/collection-utils.d.ts +49 -0
  618. package/dist/utils/collection-utils.d.ts.map +1 -0
  619. package/dist/utils/collection-utils.js +58 -0
  620. package/dist/utils/collection-utils.js.map +1 -0
  621. package/dist/utils/id-utils.d.ts +46 -0
  622. package/dist/utils/id-utils.d.ts.map +1 -0
  623. package/dist/utils/id-utils.js +51 -0
  624. package/dist/utils/id-utils.js.map +1 -0
  625. package/dist/utils/index.d.ts +21 -0
  626. package/dist/utils/index.d.ts.map +1 -0
  627. package/dist/utils/index.js +21 -0
  628. package/dist/utils/index.js.map +1 -0
  629. package/dist/utils/string-utils.d.ts +150 -0
  630. package/dist/utils/string-utils.d.ts.map +1 -0
  631. package/dist/utils/string-utils.js +281 -0
  632. package/dist/utils/string-utils.js.map +1 -0
  633. package/dist/validation/anti-patterns.d.ts +134 -0
  634. package/dist/validation/anti-patterns.d.ts.map +1 -0
  635. package/dist/validation/anti-patterns.js +307 -0
  636. package/dist/validation/anti-patterns.js.map +1 -0
  637. package/dist/validation/dod-validator.d.ts +94 -0
  638. package/dist/validation/dod-validator.d.ts.map +1 -0
  639. package/dist/validation/dod-validator.js +198 -0
  640. package/dist/validation/dod-validator.js.map +1 -0
  641. package/dist/validation/fsm/index.d.ts +59 -0
  642. package/dist/validation/fsm/index.d.ts.map +1 -0
  643. package/dist/validation/fsm/index.js +64 -0
  644. package/dist/validation/fsm/index.js.map +1 -0
  645. package/dist/validation/fsm/states.d.ts +93 -0
  646. package/dist/validation/fsm/states.d.ts.map +1 -0
  647. package/dist/validation/fsm/states.js +98 -0
  648. package/dist/validation/fsm/states.js.map +1 -0
  649. package/dist/validation/fsm/transitions.d.ts +100 -0
  650. package/dist/validation/fsm/transitions.d.ts.map +1 -0
  651. package/dist/validation/fsm/transitions.js +122 -0
  652. package/dist/validation/fsm/transitions.js.map +1 -0
  653. package/dist/validation/fsm/validator.d.ts +163 -0
  654. package/dist/validation/fsm/validator.d.ts.map +1 -0
  655. package/dist/validation/fsm/validator.js +205 -0
  656. package/dist/validation/fsm/validator.js.map +1 -0
  657. package/dist/validation/index.d.ts +23 -0
  658. package/dist/validation/index.d.ts.map +1 -0
  659. package/dist/validation/index.js +25 -0
  660. package/dist/validation/index.js.map +1 -0
  661. package/dist/validation/types.d.ts +136 -0
  662. package/dist/validation/types.d.ts.map +1 -0
  663. package/dist/validation/types.js +56 -0
  664. package/dist/validation/types.js.map +1 -0
  665. package/dist/validation-schemas/codec-utils.d.ts +188 -0
  666. package/dist/validation-schemas/codec-utils.d.ts.map +1 -0
  667. package/dist/validation-schemas/codec-utils.js +258 -0
  668. package/dist/validation-schemas/codec-utils.js.map +1 -0
  669. package/dist/validation-schemas/config.d.ts +99 -0
  670. package/dist/validation-schemas/config.d.ts.map +1 -0
  671. package/dist/validation-schemas/config.js +178 -0
  672. package/dist/validation-schemas/config.js.map +1 -0
  673. package/dist/validation-schemas/doc-directive.d.ts +195 -0
  674. package/dist/validation-schemas/doc-directive.d.ts.map +1 -0
  675. package/dist/validation-schemas/doc-directive.js +239 -0
  676. package/dist/validation-schemas/doc-directive.js.map +1 -0
  677. package/dist/validation-schemas/dual-source.d.ts +167 -0
  678. package/dist/validation-schemas/dual-source.d.ts.map +1 -0
  679. package/dist/validation-schemas/dual-source.js +168 -0
  680. package/dist/validation-schemas/dual-source.js.map +1 -0
  681. package/dist/validation-schemas/export-info.d.ts +53 -0
  682. package/dist/validation-schemas/export-info.d.ts.map +1 -0
  683. package/dist/validation-schemas/export-info.js +101 -0
  684. package/dist/validation-schemas/export-info.js.map +1 -0
  685. package/dist/validation-schemas/extracted-pattern.d.ts +351 -0
  686. package/dist/validation-schemas/extracted-pattern.d.ts.map +1 -0
  687. package/dist/validation-schemas/extracted-pattern.js +459 -0
  688. package/dist/validation-schemas/extracted-pattern.js.map +1 -0
  689. package/dist/validation-schemas/extracted-shape.d.ts +200 -0
  690. package/dist/validation-schemas/extracted-shape.d.ts.map +1 -0
  691. package/dist/validation-schemas/extracted-shape.js +182 -0
  692. package/dist/validation-schemas/extracted-shape.js.map +1 -0
  693. package/dist/validation-schemas/feature.d.ts +554 -0
  694. package/dist/validation-schemas/feature.d.ts.map +1 -0
  695. package/dist/validation-schemas/feature.js +262 -0
  696. package/dist/validation-schemas/feature.js.map +1 -0
  697. package/dist/validation-schemas/index.d.ts +15 -0
  698. package/dist/validation-schemas/index.d.ts.map +1 -0
  699. package/dist/validation-schemas/index.js +32 -0
  700. package/dist/validation-schemas/index.js.map +1 -0
  701. package/dist/validation-schemas/lint.d.ts +46 -0
  702. package/dist/validation-schemas/lint.d.ts.map +1 -0
  703. package/dist/validation-schemas/lint.js +45 -0
  704. package/dist/validation-schemas/lint.js.map +1 -0
  705. package/dist/validation-schemas/master-dataset.d.ts +8299 -0
  706. package/dist/validation-schemas/master-dataset.d.ts.map +1 -0
  707. package/dist/validation-schemas/master-dataset.js +275 -0
  708. package/dist/validation-schemas/master-dataset.js.map +1 -0
  709. package/dist/validation-schemas/output-schemas.d.ts +183 -0
  710. package/dist/validation-schemas/output-schemas.d.ts.map +1 -0
  711. package/dist/validation-schemas/output-schemas.js +149 -0
  712. package/dist/validation-schemas/output-schemas.js.map +1 -0
  713. package/dist/validation-schemas/scenario-ref.d.ts +80 -0
  714. package/dist/validation-schemas/scenario-ref.d.ts.map +1 -0
  715. package/dist/validation-schemas/scenario-ref.js +73 -0
  716. package/dist/validation-schemas/scenario-ref.js.map +1 -0
  717. package/dist/validation-schemas/tag-registry.d.ts +210 -0
  718. package/dist/validation-schemas/tag-registry.d.ts.map +1 -0
  719. package/dist/validation-schemas/tag-registry.js +248 -0
  720. package/dist/validation-schemas/tag-registry.js.map +1 -0
  721. package/dist/validation-schemas/workflow-config.d.ts +125 -0
  722. package/dist/validation-schemas/workflow-config.d.ts.map +1 -0
  723. package/dist/validation-schemas/workflow-config.js +138 -0
  724. package/dist/validation-schemas/workflow-config.js.map +1 -0
  725. package/docs/ANNOTATION-GUIDE.md +271 -0
  726. package/docs/ARCHITECTURE.md +1636 -0
  727. package/docs/CONFIGURATION.md +337 -0
  728. package/docs/DOCS-GAP-ANALYSIS.md +811 -0
  729. package/docs/GHERKIN-PATTERNS.md +366 -0
  730. package/docs/INDEX.md +345 -0
  731. package/docs/MCP-SETUP.md +140 -0
  732. package/docs/METHODOLOGY.md +240 -0
  733. package/docs/PROCESS-API.md +65 -0
  734. package/docs/PROCESS-GUARD.md +341 -0
  735. package/docs/SESSION-GUIDES.md +391 -0
  736. package/docs/TAXONOMY.md +106 -0
  737. package/docs/VALIDATION.md +418 -0
  738. package/docs-live/ARCHITECTURE.md +362 -0
  739. package/docs-live/BUSINESS-RULES.md +24 -0
  740. package/docs-live/CHANGELOG-GENERATED.md +375 -0
  741. package/docs-live/DECISIONS.md +78 -0
  742. package/docs-live/INDEX.md +231 -0
  743. package/docs-live/PRODUCT-AREAS.md +255 -0
  744. package/docs-live/TAXONOMY.md +202 -0
  745. package/docs-live/VALIDATION-RULES.md +119 -0
  746. package/docs-live/_claude-md/annotation/annotation-overview.md +26 -0
  747. package/docs-live/_claude-md/annotation/annotation-reference.md +213 -0
  748. package/docs-live/_claude-md/architecture/architecture-codecs.md +160 -0
  749. package/docs-live/_claude-md/architecture/architecture-types.md +32 -0
  750. package/docs-live/_claude-md/architecture/reference-sample.md +162 -0
  751. package/docs-live/_claude-md/authoring/gherkin-authoring-guide.md +245 -0
  752. package/docs-live/_claude-md/configuration/configuration-guide.md +216 -0
  753. package/docs-live/_claude-md/configuration/configuration-overview.md +37 -0
  754. package/docs-live/_claude-md/core-types/core-types-overview.md +20 -0
  755. package/docs-live/_claude-md/data-api/data-api-overview.md +39 -0
  756. package/docs-live/_claude-md/generation/generation-overview.md +30 -0
  757. package/docs-live/_claude-md/process/process-overview.md +127 -0
  758. package/docs-live/_claude-md/validation/process-guard.md +185 -0
  759. package/docs-live/_claude-md/validation/validation-overview.md +37 -0
  760. package/docs-live/_claude-md/validation/validation-tools-guide.md +242 -0
  761. package/docs-live/_claude-md/workflow/session-workflow-guide.md +141 -0
  762. package/docs-live/business-rules/annotation.md +1462 -0
  763. package/docs-live/business-rules/configuration.md +465 -0
  764. package/docs-live/business-rules/core-types.md +531 -0
  765. package/docs-live/business-rules/data-api.md +1403 -0
  766. package/docs-live/business-rules/generation.md +4726 -0
  767. package/docs-live/business-rules/process.md +122 -0
  768. package/docs-live/business-rules/validation.md +998 -0
  769. package/docs-live/decisions/adr-001-taxonomy-canonical-values.md +197 -0
  770. package/docs-live/decisions/adr-002-gherkin-only-testing.md +57 -0
  771. package/docs-live/decisions/adr-003-source-first-pattern-architecture.md +147 -0
  772. package/docs-live/decisions/adr-004-session-workflow-commands.md +137 -0
  773. package/docs-live/decisions/adr-005-codec-based-markdown-rendering.md +150 -0
  774. package/docs-live/decisions/adr-006-single-read-model-architecture.md +136 -0
  775. package/docs-live/decisions/adr-021-doc-generation-proof-of-concept.md +489 -0
  776. package/docs-live/product-areas/ANNOTATION.md +591 -0
  777. package/docs-live/product-areas/CONFIGURATION.md +1048 -0
  778. package/docs-live/product-areas/CORE-TYPES.md +221 -0
  779. package/docs-live/product-areas/DATA-API.md +850 -0
  780. package/docs-live/product-areas/GENERATION.md +1200 -0
  781. package/docs-live/product-areas/PROCESS.md +351 -0
  782. package/docs-live/product-areas/VALIDATION.md +1135 -0
  783. package/docs-live/reference/ANNOTATION-REFERENCE.md +232 -0
  784. package/docs-live/reference/ARCHITECTURE-CODECS.md +675 -0
  785. package/docs-live/reference/ARCHITECTURE-TYPES.md +436 -0
  786. package/docs-live/reference/CONFIGURATION-GUIDE.md +235 -0
  787. package/docs-live/reference/GHERKIN-AUTHORING-GUIDE.md +270 -0
  788. package/docs-live/reference/PROCESS-API-RECIPES.md +476 -0
  789. package/docs-live/reference/PROCESS-API-REFERENCE.md +63 -0
  790. package/docs-live/reference/PROCESS-GUARD-REFERENCE.md +258 -0
  791. package/docs-live/reference/REFERENCE-SAMPLE.md +1135 -0
  792. package/docs-live/reference/SESSION-WORKFLOW-GUIDE.md +384 -0
  793. package/docs-live/reference/VALIDATION-TOOLS-GUIDE.md +263 -0
  794. package/docs-live/taxonomy/categories.md +33 -0
  795. package/docs-live/taxonomy/format-types.md +67 -0
  796. package/docs-live/taxonomy/metadata-tags.md +693 -0
  797. package/docs-live/validation/error-catalog.md +78 -0
  798. package/docs-live/validation/fsm-transitions.md +50 -0
  799. package/docs-live/validation/protection-levels.md +51 -0
  800. package/package.json +233 -0
@@ -0,0 +1,532 @@
1
+ /**
2
+ * @architect
3
+ * @architect-core
4
+ * @architect-pattern DesignReviewCodec
5
+ * @architect-status active
6
+ * @architect-implements DesignReviewGeneration
7
+ * @architect-arch-role projection
8
+ * @architect-arch-context renderer
9
+ * @architect-arch-layer application
10
+ * @architect-include codec-transformation
11
+ * @architect-uses MasterDataset, SequenceIndex, MermaidDiagramUtils
12
+ * @architect-convention codec-registry
13
+ * @architect-product-area:Generation
14
+ *
15
+ * ## DesignReviewCodec
16
+ *
17
+ * Transforms MasterDataset into a RenderableDocument containing design review
18
+ * artifacts: sequence diagrams, component diagrams, type definition tables,
19
+ * and design question templates.
20
+ *
21
+ * **Purpose:** Auto-generate design review documents from sequence annotations
22
+ * on Gherkin specs. Diagrams stay synchronized with spec changes.
23
+ *
24
+ * **Output Files:** `architect/design-reviews/{pattern-name}.md`
25
+ *
26
+ * ### Factory Pattern
27
+ *
28
+ * ```typescript
29
+ * const codec = createDesignReviewCodec({ patternName: 'SetupCommand' });
30
+ * const doc = codec.decode(dataset);
31
+ * ```
32
+ */
33
+ import { z } from 'zod';
34
+ import { MasterDatasetSchema, } from '../../validation-schemas/master-dataset.js';
35
+ import { heading, paragraph, separator, table, mermaid, document, } from '../schema.js';
36
+ import { getPatternName, findPatternByName } from '../../api/pattern-helpers.js';
37
+ import { DEFAULT_BASE_OPTIONS, mergeOptions } from './types/base.js';
38
+ import { RenderableDocumentOutputSchema } from './shared-schema.js';
39
+ import { sanitizeNodeId } from './diagram-utils.js';
40
+ /**
41
+ * Default options for DesignReviewCodec
42
+ */
43
+ const DEFAULT_DESIGN_REVIEW_OPTIONS = {
44
+ ...DEFAULT_BASE_OPTIONS,
45
+ patternName: '',
46
+ includeAnnotationConvention: true,
47
+ includeComponentDiagram: true,
48
+ };
49
+ // ═══════════════════════════════════════════════════════════════════════════
50
+ // Design Review Document Codec
51
+ // ═══════════════════════════════════════════════════════════════════════════
52
+ /**
53
+ * Create a DesignReviewCodec with the given options.
54
+ *
55
+ * @param options - Codec configuration (patternName is required)
56
+ * @returns Configured Zod codec that transforms MasterDataset → RenderableDocument
57
+ */
58
+ export function createDesignReviewCodec(options) {
59
+ const opts = mergeOptions(DEFAULT_DESIGN_REVIEW_OPTIONS, options);
60
+ return z.codec(MasterDatasetSchema, RenderableDocumentOutputSchema, {
61
+ decode: (dataset) => {
62
+ return buildDesignReviewDocument(dataset, opts);
63
+ },
64
+ /** @throws Always - this codec is decode-only. See zod-codecs.md */
65
+ encode: () => {
66
+ throw new Error('DesignReviewCodec is decode-only. See zod-codecs.md');
67
+ },
68
+ });
69
+ }
70
+ // ═══════════════════════════════════════════════════════════════════════════
71
+ // Document Builder
72
+ // ═══════════════════════════════════════════════════════════════════════════
73
+ /**
74
+ * Build the design review document from dataset
75
+ */
76
+ function buildDesignReviewDocument(dataset, options) {
77
+ const { patternName } = options;
78
+ // Find the pattern and its sequence index entry
79
+ const pattern = findPatternByName(dataset.patterns, patternName);
80
+ if (!pattern) {
81
+ return document(`Design Review: ${patternName}`, [
82
+ heading(2, 'Pattern Not Found'),
83
+ paragraph(`Pattern "${patternName}" not found in dataset.`),
84
+ ]);
85
+ }
86
+ const entry = dataset.sequenceIndex?.[getPatternName(pattern)];
87
+ if (!entry) {
88
+ return document(`Design Review: ${patternName}`, [
89
+ heading(2, 'No Sequence Data'),
90
+ paragraph(`Pattern "${patternName}" has no sequence annotations. ` +
91
+ 'Add `@architect-sequence-orchestrator` and `@architect-sequence-step` ' +
92
+ 'tags to generate design review diagrams.'),
93
+ ]);
94
+ }
95
+ const sections = [];
96
+ const displayName = getPatternName(pattern);
97
+ // Header metadata
98
+ sections.push(...buildHeaderSection(pattern, entry));
99
+ // Annotation Convention (optional)
100
+ if (options.includeAnnotationConvention) {
101
+ sections.push(separator());
102
+ sections.push(...buildAnnotationConventionSection());
103
+ }
104
+ // Sequence Diagram
105
+ sections.push(separator());
106
+ sections.push(...buildSequenceDiagramSection(entry, pattern));
107
+ // Component Diagram (optional)
108
+ if (options.includeComponentDiagram) {
109
+ sections.push(separator());
110
+ sections.push(...buildComponentDiagramSection(entry, pattern));
111
+ }
112
+ // Key Type Definitions
113
+ sections.push(separator());
114
+ sections.push(...buildTypeDefinitionsSection(entry));
115
+ // Design Questions (template with auto metrics)
116
+ sections.push(separator());
117
+ sections.push(...buildDesignQuestionsSection(entry));
118
+ // Findings (placeholder)
119
+ sections.push(separator());
120
+ sections.push(...buildFindingsSection());
121
+ // Summary
122
+ sections.push(separator());
123
+ sections.push(...buildSummarySection(entry, displayName));
124
+ return document(`Design Review: ${displayName}`, sections, {
125
+ purpose: 'Auto-generated design review with sequence and component diagrams',
126
+ detailLevel: 'Design review artifact from sequence annotations',
127
+ });
128
+ }
129
+ // ═══════════════════════════════════════════════════════════════════════════
130
+ // Section Builders
131
+ // ═══════════════════════════════════════════════════════════════════════════
132
+ function buildHeaderSection(pattern, entry) {
133
+ const name = getPatternName(pattern);
134
+ const phase = pattern.phase !== undefined ? `Phase ${String(pattern.phase)}` : 'N/A';
135
+ const status = pattern.status ?? 'unknown';
136
+ return [
137
+ paragraph(`**Pattern:** ${name} | **Phase:** ${phase} | **Status:** ${status} | ` +
138
+ `**Orchestrator:** ${entry.orchestrator} | **Steps:** ${String(entry.steps.length)} | ` +
139
+ `**Participants:** ${String(entry.participants.length)}`),
140
+ paragraph(`**Source:** \`${pattern.source.file}\``),
141
+ ];
142
+ }
143
+ function buildAnnotationConventionSection() {
144
+ return [
145
+ heading(2, 'Annotation Convention'),
146
+ paragraph('This design review is generated from the following annotations:'),
147
+ table(['Tag', 'Level', 'Format', 'Purpose'], [
148
+ ['sequence-orchestrator', 'Feature', 'value', 'Identifies the coordinator module'],
149
+ ['sequence-step', 'Rule', 'number', 'Explicit execution ordering'],
150
+ ['sequence-module', 'Rule', 'csv', 'Maps Rule to deliverable module(s)'],
151
+ ['sequence-error', 'Scenario', 'flag', 'Marks scenario as error/alt path'],
152
+ ]),
153
+ paragraph('Description markers: `**Input:**` and `**Output:**` in Rule descriptions ' +
154
+ 'define data flow types for sequence diagram call arrows and component diagram edges.'),
155
+ ];
156
+ }
157
+ // ═══════════════════════════════════════════════════════════════════════════
158
+ // Sequence Diagram Builder
159
+ // ═══════════════════════════════════════════════════════════════════════════
160
+ function buildSequenceDiagramSection(entry, pattern) {
161
+ const lines = generateSequenceDiagram(entry, pattern);
162
+ return [
163
+ heading(2, 'Sequence Diagram — Runtime Interaction Flow'),
164
+ paragraph('Generated from: `@architect-sequence-step`, `@architect-sequence-module`, ' +
165
+ '`@architect-sequence-error`, `**Input:**`/`**Output:**` markers, and ' +
166
+ '`@architect-sequence-orchestrator` on the Feature.'),
167
+ mermaid(lines.join('\n')),
168
+ ];
169
+ }
170
+ function generateSequenceDiagram(entry, pattern) {
171
+ const lines = ['sequenceDiagram'];
172
+ // Participant declarations
173
+ lines.push(' participant User');
174
+ const orchId = sanitizeNodeId(entry.orchestrator);
175
+ const orchLabel = resolveModuleLabel(entry.orchestrator, pattern);
176
+ lines.push(` participant ${orchId} as ${quoteMermaidText(orchLabel)}`);
177
+ for (const mod of entry.participants) {
178
+ if (mod === entry.orchestrator)
179
+ continue;
180
+ const modId = sanitizeNodeId(mod);
181
+ const modLabel = resolveModuleLabel(mod, pattern);
182
+ lines.push(` participant ${modId} as ${quoteMermaidText(modLabel)}`);
183
+ }
184
+ lines.push('');
185
+ // User → orchestrator initial call
186
+ lines.push(` User->>${orchId}: invoke`);
187
+ lines.push('');
188
+ // Steps
189
+ for (const step of entry.steps) {
190
+ // Note block for rule
191
+ lines.push(` Note over ${orchId}: Rule ${String(step.stepNumber)} — ${sanitizeMermaidRawText(step.invariant ?? step.ruleName)}`);
192
+ lines.push('');
193
+ // Call from orchestrator to each module
194
+ for (const mod of step.modules) {
195
+ const modId = sanitizeNodeId(mod);
196
+ const inputLabel = sanitizeMermaidRawText(extractTypeName(step.input) || step.ruleName);
197
+ const outputLabel = sanitizeMermaidRawText(extractTypeName(step.output) || 'result');
198
+ lines.push(` ${orchId}->>+${modId}: ${inputLabel}`);
199
+ lines.push(` ${modId}-->>-${orchId}: ${outputLabel}`);
200
+ }
201
+ // Alt blocks for error scenarios
202
+ if (step.errorScenarios.length > 0) {
203
+ for (const errScenario of step.errorScenarios) {
204
+ lines.push('');
205
+ lines.push(` alt ${sanitizeMermaidRawText(errScenario)}`);
206
+ lines.push(` ${orchId}-->>User: error`);
207
+ lines.push(` ${orchId}->>${orchId}: exit(1)`);
208
+ lines.push(' end');
209
+ }
210
+ }
211
+ lines.push('');
212
+ }
213
+ return lines;
214
+ }
215
+ // ═══════════════════════════════════════════════════════════════════════════
216
+ // Component Diagram Builder
217
+ // ═══════════════════════════════════════════════════════════════════════════
218
+ function buildComponentDiagramSection(entry, pattern) {
219
+ const lines = generateComponentDiagram(entry, pattern);
220
+ return [
221
+ heading(2, 'Component Diagram — Types and Data Flow'),
222
+ paragraph('Generated from: `@architect-sequence-module` (nodes), `**Input:**`/`**Output:**` ' +
223
+ '(edges and type shapes), deliverables table (locations), and `sequence-step` (grouping).'),
224
+ mermaid(lines.join('\n')),
225
+ ];
226
+ }
227
+ function generateComponentDiagram(entry, pattern) {
228
+ const lines = ['graph LR'];
229
+ // Group steps into phases by shared input type
230
+ const phases = groupStepsByInputType(entry.steps);
231
+ // Render phase subgraphs (use phase_N prefix for unique IDs)
232
+ for (let i = 0; i < phases.length; i++) {
233
+ const phase = phases[i];
234
+ if (!phase)
235
+ continue;
236
+ const phaseId = `phase_${String(i + 1)}`;
237
+ lines.push(` subgraph ${phaseId}[${quoteMermaidText(`Phase ${String(i + 1)}: ${phase.label}`)}]`);
238
+ const declaredModules = new Set();
239
+ for (const mod of phase.modules) {
240
+ const modId = getPhaseModuleNodeId(i, mod);
241
+ if (declaredModules.has(modId))
242
+ continue;
243
+ declaredModules.add(modId);
244
+ const modLabel = resolveModuleLabel(mod, pattern);
245
+ lines.push(` ${modId}[${quoteMermaidText(modLabel)}]`);
246
+ }
247
+ lines.push(' end');
248
+ lines.push('');
249
+ }
250
+ // Orchestrator subgraph
251
+ const orchId = sanitizeNodeId(entry.orchestrator);
252
+ const orchLabel = resolveModuleLabel(entry.orchestrator, pattern);
253
+ lines.push(` subgraph orchestrator[${quoteMermaidText('Orchestrator')}]`);
254
+ lines.push(` ${orchId}[${quoteMermaidText(orchLabel)}]`);
255
+ lines.push(' end');
256
+ lines.push('');
257
+ // Type nodes (hexagon shape) for types with field definitions
258
+ const typeDefs = collectTypeDefs(entry.steps);
259
+ if (typeDefs.length > 0) {
260
+ lines.push(` subgraph types[${quoteMermaidText('Key Types')}]`);
261
+ for (const typeDef of typeDefs) {
262
+ const typeId = sanitizeNodeId(typeDef.name);
263
+ if (typeDef.fields) {
264
+ // Convert comma-separated fields to newline-separated for hexagon node display
265
+ const hexFields = typeDef.fields
266
+ .split(',')
267
+ .map((f) => f.trim())
268
+ .filter(Boolean)
269
+ .join('\n');
270
+ lines.push(` ${typeId}{{${quoteMermaidText(`${typeDef.name}\n-----------\n${hexFields}`, {
271
+ preserveLineBreaks: true,
272
+ })}}}`);
273
+ }
274
+ else {
275
+ lines.push(` ${typeId}{{${quoteMermaidText(typeDef.name)}}}`);
276
+ }
277
+ }
278
+ lines.push(' end');
279
+ lines.push('');
280
+ }
281
+ // Edges: module outputs → orchestrator (only for proper types with -- field separator)
282
+ for (let i = 0; i < phases.length; i++) {
283
+ const phase = phases[i];
284
+ if (!phase)
285
+ continue;
286
+ for (const step of phase.steps) {
287
+ if (step.output?.includes('--') !== true)
288
+ continue;
289
+ const outputType = extractTypeName(step.output);
290
+ for (const mod of step.modules) {
291
+ const modId = getPhaseModuleNodeId(i, mod);
292
+ lines.push(` ${modId} -->|${quoteMermaidText(outputType)}| ${orchId}`);
293
+ }
294
+ }
295
+ }
296
+ // Orchestrator dispatches to steps that take an input
297
+ for (let i = 0; i < phases.length; i++) {
298
+ const phase = phases[i];
299
+ if (!phase)
300
+ continue;
301
+ for (const step of phase.steps) {
302
+ const inputType = extractTypeName(step.input);
303
+ if (!inputType)
304
+ continue;
305
+ for (const mod of step.modules) {
306
+ const modId = getPhaseModuleNodeId(i, mod);
307
+ lines.push(` ${orchId} -->|${quoteMermaidText(inputType)}| ${modId}`);
308
+ }
309
+ }
310
+ }
311
+ return lines;
312
+ }
313
+ // ═══════════════════════════════════════════════════════════════════════════
314
+ // Type Definitions Section
315
+ // ═══════════════════════════════════════════════════════════════════════════
316
+ function buildTypeDefinitionsSection(entry) {
317
+ const typeDefs = collectTypeDefs(entry.steps);
318
+ if (typeDefs.length === 0) {
319
+ return [
320
+ heading(2, 'Key Type Definitions'),
321
+ paragraph('No structured types found in Output annotations.'),
322
+ ];
323
+ }
324
+ const rows = [];
325
+ for (const typeDef of typeDefs) {
326
+ const producedBy = findProducers(entry.steps, typeDef.name);
327
+ const consumedBy = findConsumers(entry.steps, typeDef.name);
328
+ rows.push([
329
+ `\`${typeDef.name}\``,
330
+ typeDef.fields ?? '—',
331
+ producedBy.join(', '),
332
+ consumedBy.join(', '),
333
+ ]);
334
+ }
335
+ return [
336
+ heading(2, 'Key Type Definitions'),
337
+ table(['Type', 'Fields', 'Produced By', 'Consumed By'], rows),
338
+ ];
339
+ }
340
+ // ═══════════════════════════════════════════════════════════════════════════
341
+ // Design Questions (template with auto metrics)
342
+ // ═══════════════════════════════════════════════════════════════════════════
343
+ function buildDesignQuestionsSection(entry) {
344
+ const stepCount = entry.steps.length;
345
+ const typeCount = collectTypeDefs(entry.steps).length;
346
+ const errorCount = entry.errorPaths.length;
347
+ return [
348
+ heading(2, 'Design Questions'),
349
+ paragraph('Verify these design properties against the diagrams above:'),
350
+ table(['#', 'Question', 'Auto-Check', 'Diagram'], [
351
+ [
352
+ 'DQ-1',
353
+ 'Is the execution ordering correct?',
354
+ `${String(stepCount)} steps in monotonic order`,
355
+ 'Sequence',
356
+ ],
357
+ [
358
+ 'DQ-2',
359
+ 'Are all interfaces well-defined?',
360
+ `${String(typeCount)} distinct types across ${String(stepCount)} steps`,
361
+ 'Component',
362
+ ],
363
+ [
364
+ 'DQ-3',
365
+ 'Is error handling complete?',
366
+ `${String(errorCount)} error paths identified`,
367
+ 'Sequence',
368
+ ],
369
+ ['DQ-4', 'Is data flow unidirectional?', 'Review component diagram edges', 'Component'],
370
+ ['DQ-5', 'Does validation prove the full path?', 'Review final step', 'Both'],
371
+ ]),
372
+ ];
373
+ }
374
+ // ═══════════════════════════════════════════════════════════════════════════
375
+ // Findings (placeholder for human review)
376
+ // ═══════════════════════════════════════════════════════════════════════════
377
+ function buildFindingsSection() {
378
+ return [
379
+ heading(2, 'Findings'),
380
+ paragraph('Record design observations from reviewing the diagrams above. ' +
381
+ 'Each finding should reference which diagram revealed it and its impact on the spec.'),
382
+ table(['#', 'Finding', 'Diagram Source', 'Impact on Spec'], [['F-1', '(Review the diagrams and add findings here)', '—', '—']]),
383
+ ];
384
+ }
385
+ // ═══════════════════════════════════════════════════════════════════════════
386
+ // Summary
387
+ // ═══════════════════════════════════════════════════════════════════════════
388
+ function buildSummarySection(entry, displayName) {
389
+ const stepCount = entry.steps.length;
390
+ const participantCount = entry.participants.length;
391
+ const typeCount = collectTypeDefs(entry.steps).length;
392
+ const errorCount = entry.errorPaths.length;
393
+ return [
394
+ heading(2, 'Summary'),
395
+ paragraph(`The ${displayName} design review covers ${String(stepCount)} sequential steps across ` +
396
+ `${String(participantCount)} participants with ${String(typeCount)} key data types ` +
397
+ `and ${String(errorCount)} error paths.`),
398
+ ];
399
+ }
400
+ // ═══════════════════════════════════════════════════════════════════════════
401
+ // Shared Helpers
402
+ // ═══════════════════════════════════════════════════════════════════════════
403
+ /**
404
+ * Sanitize Mermaid text in raw positions such as notes, alt conditions, and
405
+ * sequence message labels where the text is not wrapped in quotes.
406
+ */
407
+ function sanitizeMermaidRawText(text) {
408
+ return (text
409
+ .replace(/\r?\n/g, ' ')
410
+ .replace(/%%/g, '% %')
411
+ .replace(/\|/g, '&#124;')
412
+ .replace(/"/g, '&quot;')
413
+ .replace(/>>/g, '> >')
414
+ // In raw (unquoted) Mermaid positions, `--` is edge syntax; em-dash renders visually equivalent
415
+ .replace(/--/g, '\u2014')
416
+ .trim());
417
+ }
418
+ /**
419
+ * Quote Mermaid text for label positions that already use Mermaid string syntax.
420
+ */
421
+ function quoteMermaidText(text, options = {}) {
422
+ const { preserveLineBreaks = false } = options;
423
+ const escapedBackslashes = text.replace(/\\/g, '\\\\');
424
+ const normalized = preserveLineBreaks
425
+ ? escapedBackslashes.replace(/\r?\n/g, '\\n')
426
+ : escapedBackslashes.replace(/\r?\n/g, ' ');
427
+ return `"${normalized
428
+ .replace(/%%/g, '% %')
429
+ .replace(/\|/g, '&#124;')
430
+ .replace(/"/g, '&quot;')
431
+ .trim()}"`;
432
+ }
433
+ /**
434
+ * Extract the type name from an Input or Output annotation string.
435
+ * Format: "TypeName -- field1, field2" → "TypeName"
436
+ * Or just: "some description" → "some description"
437
+ * Returns empty string for undefined.
438
+ */
439
+ function extractTypeName(annotation) {
440
+ if (!annotation)
441
+ return '';
442
+ const dashIndex = annotation.indexOf('--');
443
+ if (dashIndex >= 0) {
444
+ return annotation.slice(0, dashIndex).trim();
445
+ }
446
+ return annotation.trim();
447
+ }
448
+ /**
449
+ * Resolve a module ID to a display label.
450
+ * Checks deliverables table for Location basenames, falls back to module ID + .ts.
451
+ */
452
+ function resolveModuleLabel(moduleId, pattern) {
453
+ if (pattern.deliverables) {
454
+ for (const d of pattern.deliverables) {
455
+ const basename = d.location
456
+ .split('/')
457
+ .pop()
458
+ ?.replace(/\.[^.]+$/, '') ?? '';
459
+ if (basename === moduleId) {
460
+ return d.location.split('/').pop() ?? `${moduleId}.ts`;
461
+ }
462
+ }
463
+ }
464
+ return `${moduleId}.ts`;
465
+ }
466
+ /**
467
+ * Collect distinct type definitions from Output annotations.
468
+ * Only includes annotations with the "TypeName -- fields" format.
469
+ */
470
+ function collectTypeDefs(steps) {
471
+ const seen = new Set();
472
+ const defs = [];
473
+ for (const step of steps) {
474
+ if (!step.output)
475
+ continue;
476
+ const dashIndex = step.output.indexOf('--');
477
+ if (dashIndex < 0)
478
+ continue; // Skip description-style outputs
479
+ const name = step.output.slice(0, dashIndex).trim();
480
+ if (seen.has(name))
481
+ continue;
482
+ seen.add(name);
483
+ const rawFields = step.output.slice(dashIndex + 2).trim();
484
+ defs.push({ name, fields: rawFields.length > 0 ? rawFields : undefined });
485
+ }
486
+ return defs;
487
+ }
488
+ /** Find which modules produce a given type (by Output annotation) */
489
+ function findProducers(steps, typeName) {
490
+ const producers = [];
491
+ for (const step of steps) {
492
+ if (step.output && extractTypeName(step.output) === typeName) {
493
+ producers.push(...step.modules);
494
+ }
495
+ }
496
+ return producers;
497
+ }
498
+ /** Find which modules consume a given type (by Input annotation) */
499
+ function findConsumers(steps, typeName) {
500
+ const consumers = [];
501
+ for (const step of steps) {
502
+ if (step.input && extractTypeName(step.input) === typeName) {
503
+ consumers.push(...step.modules);
504
+ }
505
+ }
506
+ return consumers;
507
+ }
508
+ /**
509
+ * Group contiguous steps by shared Input type into phases.
510
+ * Only adjacent steps with the same Input type are grouped together.
511
+ * Non-contiguous steps with the same input type become separate phases.
512
+ */
513
+ function groupStepsByInputType(steps) {
514
+ const phases = [];
515
+ for (const step of steps) {
516
+ const inputType = extractTypeName(step.input) || `Step ${String(step.stepNumber)}`;
517
+ const lastPhase = phases[phases.length - 1];
518
+ // Only merge into the previous phase if it has the same input type (contiguous grouping)
519
+ if (lastPhase?.label === inputType) {
520
+ lastPhase.modules.push(...step.modules);
521
+ lastPhase.steps.push(step);
522
+ }
523
+ else {
524
+ phases.push({ label: inputType, modules: [...step.modules], steps: [step] });
525
+ }
526
+ }
527
+ return phases;
528
+ }
529
+ function getPhaseModuleNodeId(phaseIndex, moduleId) {
530
+ return `phase_${String(phaseIndex + 1)}_${sanitizeNodeId(moduleId)}`;
531
+ }
532
+ //# sourceMappingURL=design-review.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"design-review.js","sourceRoot":"","sources":["../../../src/renderable/codecs/design-review.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,mBAAmB,GAIpB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EAGL,OAAO,EACP,SAAS,EACT,SAAS,EACT,KAAK,EACL,OAAO,EACP,QAAQ,GACT,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAAyB,oBAAoB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAoBpD;;GAEG;AACH,MAAM,6BAA6B,GAAuC;IACxE,GAAG,oBAAoB;IACvB,WAAW,EAAE,EAAE;IACf,2BAA2B,EAAE,IAAI;IACjC,uBAAuB,EAAE,IAAI;CAC9B,CAAC;AAEF,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAiC;IAEjC,MAAM,IAAI,GAAG,YAAY,CAAC,6BAA6B,EAAE,OAAO,CAAC,CAAC;IAElE,OAAO,CAAC,CAAC,KAAK,CAAC,mBAAmB,EAAE,8BAA8B,EAAE;QAClE,MAAM,EAAE,CAAC,OAAsB,EAAsB,EAAE;YACrD,OAAO,yBAAyB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;QACD,oEAAoE;QACpE,MAAM,EAAE,GAAU,EAAE;YAClB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;GAEG;AACH,SAAS,yBAAyB,CAChC,OAAsB,EACtB,OAA2C;IAE3C,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEhC,gDAAgD;IAChD,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACjE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC,kBAAkB,WAAW,EAAE,EAAE;YAC/C,OAAO,CAAC,CAAC,EAAE,mBAAmB,CAAC;YAC/B,SAAS,CAAC,YAAY,WAAW,yBAAyB,CAAC;SAC5D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,QAAQ,CAAC,kBAAkB,WAAW,EAAE,EAAE;YAC/C,OAAO,CAAC,CAAC,EAAE,kBAAkB,CAAC;YAC9B,SAAS,CACP,YAAY,WAAW,iCAAiC;gBACtD,wEAAwE;gBACxE,0CAA0C,CAC7C;SACF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAE5C,kBAAkB;IAClB,QAAQ,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAErD,mCAAmC;IACnC,IAAI,OAAO,CAAC,2BAA2B,EAAE,CAAC;QACxC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,GAAG,gCAAgC,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,mBAAmB;IACnB,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,GAAG,2BAA2B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAE9D,+BAA+B;IAC/B,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAC3B,QAAQ,CAAC,IAAI,CAAC,GAAG,4BAA4B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,uBAAuB;IACvB,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC,CAAC;IAErD,gDAAgD;IAChD,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC,CAAC;IAErD,yBAAyB;IACzB,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,GAAG,oBAAoB,EAAE,CAAC,CAAC;IAEzC,UAAU;IACV,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;IAE1D,OAAO,QAAQ,CAAC,kBAAkB,WAAW,EAAE,EAAE,QAAQ,EAAE;QACzD,OAAO,EAAE,mEAAmE;QAC5E,WAAW,EAAE,kDAAkD;KAChE,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,SAAS,kBAAkB,CAAC,OAAyB,EAAE,KAAyB;IAC9E,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACrF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC;IAE3C,OAAO;QACL,SAAS,CACP,gBAAgB,IAAI,iBAAiB,KAAK,kBAAkB,MAAM,KAAK;YACrE,qBAAqB,KAAK,CAAC,YAAY,iBAAiB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK;YACvF,qBAAqB,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAC3D;QACD,SAAS,CAAC,iBAAiB,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;KACpD,CAAC;AACJ,CAAC;AAED,SAAS,gCAAgC;IACvC,OAAO;QACL,OAAO,CAAC,CAAC,EAAE,uBAAuB,CAAC;QACnC,SAAS,CAAC,iEAAiE,CAAC;QAC5E,KAAK,CACH,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,EACrC;YACE,CAAC,uBAAuB,EAAE,SAAS,EAAE,OAAO,EAAE,mCAAmC,CAAC;YAClF,CAAC,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,6BAA6B,CAAC;YAClE,CAAC,iBAAiB,EAAE,MAAM,EAAE,KAAK,EAAE,oCAAoC,CAAC;YACxE,CAAC,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,kCAAkC,CAAC;SAC3E,CACF;QACD,SAAS,CACP,2EAA2E;YACzE,sFAAsF,CACzF;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,SAAS,2BAA2B,CAClC,KAAyB,EACzB,OAAyB;IAEzB,MAAM,KAAK,GAAG,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtD,OAAO;QACL,OAAO,CAAC,CAAC,EAAE,6CAA6C,CAAC;QACzD,SAAS,CACP,4EAA4E;YAC1E,uEAAuE;YACvE,oDAAoD,CACvD;QACD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAyB,EAAE,OAAyB;IACnF,MAAM,KAAK,GAAa,CAAC,iBAAiB,CAAC,CAAC;IAE5C,2BAA2B;IAC3B,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAClE,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,OAAO,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAE1E,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACrC,IAAI,GAAG,KAAK,KAAK,CAAC,YAAY;YAAE,SAAS;QACzC,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,mBAAmB,KAAK,OAAO,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,mCAAmC;IACnC,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,UAAU,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,QAAQ;IACR,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,sBAAsB;QACtB,KAAK,CAAC,IAAI,CACR,iBAAiB,MAAM,UAAU,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,sBAAsB,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CACxH,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,wCAAwC;QACxC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;YAClC,MAAM,UAAU,GAAG,sBAAsB,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxF,MAAM,WAAW,GAAG,sBAAsB,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,CAAC;YAErF,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC,CAAC;YACvD,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,QAAQ,MAAM,KAAK,WAAW,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,iCAAiC;QACjC,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,WAAW,sBAAsB,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBAC7D,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,iBAAiB,CAAC,CAAC;gBAC/C,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,MAAM,MAAM,WAAW,CAAC,CAAC;gBACrD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,SAAS,4BAA4B,CACnC,KAAyB,EACzB,OAAyB;IAEzB,MAAM,KAAK,GAAG,wBAAwB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACvD,OAAO;QACL,OAAO,CAAC,CAAC,EAAE,yCAAyC,CAAC;QACrD,SAAS,CACP,mFAAmF;YACjF,0FAA0F,CAC7F;QACD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAyB,EAAE,OAAyB;IACpF,MAAM,KAAK,GAAa,CAAC,UAAU,CAAC,CAAC;IAErC,+CAA+C;IAC/C,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAElD,6DAA6D;IAC7D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,OAAO,GAAG,SAAS,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CACR,gBAAgB,OAAO,IAAI,gBAAgB,CAAC,SAAS,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CACzF,CAAC;QACF,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;QAC1C,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,oBAAoB,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAC3C,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAS;YACzC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC3B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,wBAAwB;IACxB,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAClE,KAAK,CAAC,IAAI,CAAC,6BAA6B,gBAAgB,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAC7E,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,IAAI,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,8DAA8D;IAC9D,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,sBAAsB,gBAAgB,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACnE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,+EAA+E;gBAC/E,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM;qBAC7B,KAAK,CAAC,GAAG,CAAC;qBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;qBACpB,MAAM,CAAC,OAAO,CAAC;qBACf,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,KAAK,CAAC,IAAI,CACR,WAAW,MAAM,KAAK,gBAAgB,CAAC,GAAG,OAAO,CAAC,IAAI,kBAAkB,SAAS,EAAE,EAAE;oBACnF,kBAAkB,EAAE,IAAI;iBACzB,CAAC,IAAI,CACP,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,KAAK,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,uFAAuF;IACvF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI;gBAAE,SAAS;YACnD,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAChD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC/B,MAAM,KAAK,GAAG,oBAAoB,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBAC3C,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,QAAQ,gBAAgB,CAAC,UAAU,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9C,IAAI,CAAC,SAAS;gBAAE,SAAS;YACzB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC/B,MAAM,KAAK,GAAG,oBAAoB,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBAC3C,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,QAAQ,gBAAgB,CAAC,SAAS,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,SAAS,2BAA2B,CAAC,KAAyB;IAC5D,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAE9C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,OAAO,CAAC,CAAC,EAAE,sBAAsB,CAAC;YAClC,SAAS,CAAC,kDAAkD,CAAC;SAC9D,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAe,EAAE,CAAC;IAC5B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,CAAC;YACR,KAAK,OAAO,CAAC,IAAI,IAAI;YACrB,OAAO,CAAC,MAAM,IAAI,GAAG;YACrB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;YACrB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,OAAO,CAAC,CAAC,EAAE,sBAAsB,CAAC;QAClC,KAAK,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,gDAAgD;AAChD,8EAA8E;AAE9E,SAAS,2BAA2B,CAAC,KAAyB;IAC5D,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;IACrC,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IACtD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;IAE3C,OAAO;QACL,OAAO,CAAC,CAAC,EAAE,kBAAkB,CAAC;QAC9B,SAAS,CAAC,4DAA4D,CAAC;QACvE,KAAK,CACH,CAAC,GAAG,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,CAAC,EAC1C;YACE;gBACE,MAAM;gBACN,oCAAoC;gBACpC,GAAG,MAAM,CAAC,SAAS,CAAC,2BAA2B;gBAC/C,UAAU;aACX;YACD;gBACE,MAAM;gBACN,kCAAkC;gBAClC,GAAG,MAAM,CAAC,SAAS,CAAC,0BAA0B,MAAM,CAAC,SAAS,CAAC,QAAQ;gBACvE,WAAW;aACZ;YACD;gBACE,MAAM;gBACN,6BAA6B;gBAC7B,GAAG,MAAM,CAAC,UAAU,CAAC,yBAAyB;gBAC9C,UAAU;aACX;YACD,CAAC,MAAM,EAAE,8BAA8B,EAAE,gCAAgC,EAAE,WAAW,CAAC;YACvF,CAAC,MAAM,EAAE,sCAAsC,EAAE,mBAAmB,EAAE,MAAM,CAAC;SAC9E,CACF;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAE9E,SAAS,oBAAoB;IAC3B,OAAO;QACL,OAAO,CAAC,CAAC,EAAE,UAAU,CAAC;QACtB,SAAS,CACP,gEAAgE;YAC9D,qFAAqF,CACxF;QACD,KAAK,CACH,CAAC,GAAG,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,EACpD,CAAC,CAAC,KAAK,EAAE,6CAA6C,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CACnE;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,mBAAmB,CAAC,KAAyB,EAAE,WAAmB;IACzE,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;IACrC,MAAM,gBAAgB,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC;IACnD,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IACtD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;IAE3C,OAAO;QACL,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC;QACrB,SAAS,CACP,OAAO,WAAW,yBAAyB,MAAM,CAAC,SAAS,CAAC,2BAA2B;YACrF,GAAG,MAAM,CAAC,gBAAgB,CAAC,sBAAsB,MAAM,CAAC,SAAS,CAAC,kBAAkB;YACpF,OAAO,MAAM,CAAC,UAAU,CAAC,eAAe,CAC3C;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,sBAAsB,CAAC,IAAY;IAC1C,OAAO,CACL,IAAI;SACD,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;SACxB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;QACtB,gGAAgG;SAC/F,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;SACxB,IAAI,EAAE,CACV,CAAC;AACJ,CAAC;AAMD;;GAEG;AACH,SAAS,gBAAgB,CAAC,IAAY,EAAE,UAA8B,EAAE;IACtE,MAAM,EAAE,kBAAkB,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAC/C,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,kBAAkB;QACnC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC;QAC7C,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAE9C,OAAO,IAAI,UAAU;SAClB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;SACxB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,IAAI,EAAE,GAAG,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,UAA8B;IACrD,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACnB,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,QAAgB,EAAE,OAAyB;IACrE,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACrC,MAAM,QAAQ,GACZ,CAAC,CAAC,QAAQ;iBACP,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,EAAE;gBACN,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;YACpC,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC1B,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG,QAAQ,KAAK,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,QAAQ,KAAK,CAAC;AAC1B,CAAC;AAQD;;;GAGG;AACH,SAAS,eAAe,CAAC,KAA8B;IACrD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,IAAI,GAAc,EAAE,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,SAAS;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,SAAS,GAAG,CAAC;YAAE,SAAS,CAAC,iCAAiC;QAE9D,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;QACpD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEf,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qEAAqE;AACrE,SAAS,aAAa,CAAC,KAA8B,EAAE,QAAgB;IACrE,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC7D,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,oEAAoE;AACpE,SAAS,aAAa,CAAC,KAA8B,EAAE,QAAgB;IACrE,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,KAAK,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC3D,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AASD;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,KAA8B;IAC3D,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,QAAQ,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACnF,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAE5C,yFAAyF;QACzF,IAAI,SAAS,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC;YACnC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACxC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,oBAAoB,CAAC,UAAkB,EAAE,QAAgB;IAChE,OAAO,SAAS,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;AACvE,CAAC"}
@@ -0,0 +1,62 @@
1
+ /**
2
+ * @architect
3
+ * @architect-pattern MermaidDiagramUtils
4
+ * @architect-status completed
5
+ * @architect-used-by Architecture Codec, Reference Codec
6
+ * @architect-arch-context renderer
7
+ *
8
+ * ## Shared Mermaid Diagram Utilities
9
+ *
10
+ * Sanitization and formatting helpers shared across architecture.ts and reference.ts
11
+ * diagram builders.
12
+ *
13
+ * **When to Use:** When building Mermaid diagram output in a codec — use
14
+ * `sanitizeNodeId()`, `EDGE_STYLES`, `NODE_SHAPES`, and `formatNodeDeclaration()`
15
+ * rather than inlining diagram syntax in the codec directly.
16
+ */
17
+ /**
18
+ * Sanitize pattern name for Mermaid node ID.
19
+ * Mermaid requires alphanumeric + underscore only.
20
+ */
21
+ export declare function sanitizeNodeId(name: string): string;
22
+ /** Arrow styles per relationship type for Mermaid diagram generation */
23
+ export declare const EDGE_STYLES: {
24
+ readonly uses: "-->";
25
+ readonly dependsOn: "-.->";
26
+ readonly implementsPatterns: "..->";
27
+ readonly extendsPattern: "-->>";
28
+ };
29
+ /** Human-readable relationship labels for edge annotations (DD-4) */
30
+ export declare const EDGE_LABELS: {
31
+ readonly uses: "uses";
32
+ readonly dependsOn: "depends on";
33
+ readonly implementsPatterns: "implements";
34
+ readonly extendsPattern: "extends";
35
+ };
36
+ /** Arrow syntax for sequence diagram messages (DD-2) */
37
+ export declare const SEQUENCE_ARROWS: {
38
+ readonly uses: "->>";
39
+ readonly dependsOn: "-->>";
40
+ readonly implementsPatterns: "--)";
41
+ readonly extendsPattern: "-->>";
42
+ };
43
+ /**
44
+ * Mermaid flowchart node shape brackets per archRole (DD-1).
45
+ * Maps archRole to [openBracket, closeBracket] pairs.
46
+ * Uses `satisfies` to ensure every canonical archRole has a mapping.
47
+ */
48
+ export declare const NODE_SHAPES: {
49
+ readonly 'bounded-context': readonly ["[[\"", "\"]]"];
50
+ readonly 'command-handler': readonly ["([\"", "\"])"];
51
+ readonly projection: readonly ["[(\"", "\")]"];
52
+ readonly saga: readonly ["{{\"", "\"}}"];
53
+ readonly 'process-manager': readonly ["{{\"", "\"}}"];
54
+ readonly infrastructure: readonly ["[/\"", "\"/]"];
55
+ readonly repository: readonly ["[(\"", "\")]"];
56
+ readonly decider: readonly ["(\"", "\")"];
57
+ readonly 'read-model': readonly ["[/\"", "\"/]"];
58
+ readonly service: readonly ["(\"", "\")"];
59
+ };
60
+ /** Format a Mermaid flowchart node declaration with shape based on archRole */
61
+ export declare function formatNodeDeclaration(nodeId: string, label: string, archRole?: string): string;
62
+ //# sourceMappingURL=diagram-utils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"diagram-utils.d.ts","sourceRoot":"","sources":["../../../src/renderable/codecs/diagram-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAUH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wEAAwE;AACxE,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX,qEAAqE;AACrE,eAAO,MAAM,WAAW;;;;;CAK6B,CAAC;AAEtD,wDAAwD;AACxD,eAAO,MAAM,eAAe;;;;;CAKyB,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;CAWwC,CAAC;AAEjE,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAM9F"}