kortext 3.0.0 → 3.1.0

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 (373) hide show
  1. package/README.md +159 -139
  2. package/agents/architect.md +85 -0
  3. package/agents/compliance-expert.md +36 -75
  4. package/agents/copywriter.md +36 -92
  5. package/agents/db-admin.md +43 -91
  6. package/agents/designer.md +40 -77
  7. package/agents/devops-engineer.md +37 -113
  8. package/agents/growth-expert.md +45 -88
  9. package/agents/product-manager.md +38 -83
  10. package/agents/qa-engineer.md +51 -99
  11. package/agents/security-engineer.md +47 -92
  12. package/bin/kortext.js +1 -22
  13. package/dist/app.js +829 -0
  14. package/dist/cli-spawn.js +137 -0
  15. package/dist/daemon.js +40 -0
  16. package/dist/db.js +78 -0
  17. package/dist/design-preview.js +533 -0
  18. package/dist/docs.js +701 -0
  19. package/dist/engines.js +225 -0
  20. package/dist/index.js +109 -0
  21. package/dist/pick-directory.js +38 -0
  22. package/dist/projects.js +189 -0
  23. package/dist/readiness.js +288 -0
  24. package/dist/runner.js +771 -0
  25. package/dist/update.js +55 -0
  26. package/docs/CHANGELOG.md +11 -0
  27. package/package.json +25 -57
  28. package/templates/AGENTS.md +62 -0
  29. package/templates/docs/API.md +67 -0
  30. package/templates/docs/ARCHITECTURE.md +31 -0
  31. package/templates/docs/BRIEF.md +27 -0
  32. package/templates/docs/CONTENT.md +66 -0
  33. package/templates/docs/DATABASE.md +63 -0
  34. package/templates/docs/DESIGN.md +124 -0
  35. package/templates/docs/ENGINEERING.md +66 -0
  36. package/templates/docs/ENVIRONMENT.md +102 -0
  37. package/templates/docs/GROWTH.md +44 -0
  38. package/templates/docs/LEGAL.md +48 -0
  39. package/templates/docs/PRODUCT.md +43 -0
  40. package/templates/docs/SECURITY.md +65 -0
  41. package/templates/docs/STACK.md +57 -0
  42. package/templates/docs/STRUCTURE.md +73 -0
  43. package/templates/docs/TEST.md +62 -0
  44. package/ui/dist/assets/abnfDiagram-VCTEODGH-Bm7Q2BML.js +1 -0
  45. package/ui/dist/assets/arc-BV9hs0Hu.js +1 -0
  46. package/ui/dist/assets/architecture-7GRP2DOG-RckR3gBI.js +1 -0
  47. package/ui/dist/assets/architectureDiagram-5GKGNRK7-CHiJ6JFT.js +36 -0
  48. package/ui/dist/assets/array-BifhSqXX.js +1 -0
  49. package/ui/dist/assets/blockDiagram-I7D4REHJ-qCbaKVhd.js +129 -0
  50. package/ui/dist/assets/c4Diagram-7LVT6UL2-DidCDJrv.js +38 -0
  51. package/ui/dist/assets/channel-CNUQ11ne.js +1 -0
  52. package/ui/dist/assets/chunk-2Q5K7J3B-C1jixKkw.js +1 -0
  53. package/ui/dist/assets/chunk-4HAMMTFA-CDGFjfVp.js +62 -0
  54. package/ui/dist/assets/chunk-5VM5RSS4-ZNzvKenW.js +15 -0
  55. package/ui/dist/assets/chunk-75Z2AOVW-CbNT4sDh.js +2 -0
  56. package/ui/dist/assets/chunk-DU6HZSFF-Cq2BVv26.js +127 -0
  57. package/ui/dist/assets/chunk-F27PBJKO-CE365m0v.js +1 -0
  58. package/ui/dist/assets/chunk-FOHPRMQF-DHwB1DNv.js +161 -0
  59. package/ui/dist/assets/chunk-GMAD6QVW-DxWL1VC-.js +72 -0
  60. package/ui/dist/assets/chunk-GVQU2GXP-aARV8YbK.js +1 -0
  61. package/ui/dist/assets/chunk-IMKFNOWR-CC790Kt2.js +231 -0
  62. package/ui/dist/assets/chunk-JWPE2WC7-DVXcaiue.js +1 -0
  63. package/ui/dist/assets/chunk-L3NEJ4N5-BfE4VE8J.js +1 -0
  64. package/ui/dist/assets/chunk-OSK3NFVY-BImQbSWH.js +10 -0
  65. package/ui/dist/assets/chunk-P2QGCYS3-CN3XD313.js +1 -0
  66. package/ui/dist/assets/chunk-POPQ4Y6H-Dqb6jOrX.js +1 -0
  67. package/ui/dist/assets/chunk-PWAF6VOD-DfXX6rBk.js +1 -0
  68. package/ui/dist/assets/chunk-SHT3W25Y-DATyyqPK.js +168 -0
  69. package/ui/dist/assets/chunk-SVP7TREG-r1chwRmg.js +88 -0
  70. package/ui/dist/assets/chunk-TICWLB2K-DL4atHUC.js +206 -0
  71. package/ui/dist/assets/chunk-XXDRQBXY-DXrM6jh7.js +1 -0
  72. package/ui/dist/assets/chunk-Y2CYZVJY-DsF7k-Jl.js +1 -0
  73. package/ui/dist/assets/classDiagram-ZZMXUADV-BpQxfIQ7.js +1 -0
  74. package/ui/dist/assets/classDiagram-v2-VYDZK3BY-BpQxfIQ7.js +1 -0
  75. package/ui/dist/assets/cose-bilkent-JH36ORCC-Bhe-ZBlS.js +1 -0
  76. package/ui/dist/assets/cynefin-OW5HDTMX-D1koLd-G.js +1 -0
  77. package/ui/dist/assets/cynefinDiagram-5FMLGOSQ-BMcw40hV.js +62 -0
  78. package/ui/dist/assets/cytoscape.esm-CGd-uY3x.js +321 -0
  79. package/ui/dist/assets/dagre-GXQ25YYZ-DBun-Rs2.js +4 -0
  80. package/ui/dist/assets/dagre-PrKaheQc.js +1 -0
  81. package/ui/dist/assets/defaultLocale-BFoDCU3G.js +1 -0
  82. package/ui/dist/assets/diagram-S7CK7UJ4-C1fUIGvo.js +30 -0
  83. package/ui/dist/assets/diagram-UQ7AKVKN-B5FDfkvB.js +41 -0
  84. package/ui/dist/assets/diagram-VSXAHHWV-CCIpOCNC.js +3 -0
  85. package/ui/dist/assets/diagram-VX7I27RA-DV0q2xo_.js +24 -0
  86. package/ui/dist/assets/diagram-Z3DM3KII-B3LCdNgI.js +24 -0
  87. package/ui/dist/assets/dist-EcW76Zvr.js +1 -0
  88. package/ui/dist/assets/ebnfDiagram-PWID7BFC-De_oRbYe.js +1 -0
  89. package/ui/dist/assets/erDiagram-RLTQ6QDP-B9NikMr1.js +99 -0
  90. package/ui/dist/assets/eventmodeling-NTZA5JFV-DZ4t581k.js +1 -0
  91. package/ui/dist/assets/flowDiagram-HODETNUW-DuTOJp1C.js +1 -0
  92. package/ui/dist/assets/ganttDiagram-EL5Y4UJY-BVTqqlPw.js +292 -0
  93. package/ui/dist/assets/gitGraph-4MIJSDKK-xRFaEJdZ.js +1 -0
  94. package/ui/dist/assets/gitGraphDiagram-WWUBYQGX-CK5_GCmX.js +106 -0
  95. package/ui/dist/assets/graphlib-DS17s2tU.js +1 -0
  96. package/ui/dist/assets/index-CjkpNftW.js +46 -0
  97. package/ui/dist/assets/index-DVIDTWin.css +1 -0
  98. package/ui/dist/assets/info-A6RAGUB7-Dg7z-CTI.js +1 -0
  99. package/ui/dist/assets/infoDiagram-27XIBGKW-YaqsOXh0.js +2 -0
  100. package/ui/dist/assets/init-C-OQMol4.js +1 -0
  101. package/ui/dist/assets/ishikawaDiagram-5VMMS53U-C-wtxZPa.js +70 -0
  102. package/ui/dist/assets/journeyDiagram-3NMN7TZE-DsXSXf16.js +139 -0
  103. package/ui/dist/assets/kanban-definition-UXKFOSKX-Ct59fuWk.js +89 -0
  104. package/ui/dist/assets/katex-CXMH3UgJ.js +257 -0
  105. package/ui/dist/assets/line-BUVw9Mhs.js +1 -0
  106. package/ui/dist/assets/linear-D8ncLO0X.js +1 -0
  107. package/ui/dist/assets/mermaid-parser.core-BDC4bG-O.js +7 -0
  108. package/ui/dist/assets/mermaid.core-DZY3WwzX.js +44 -0
  109. package/ui/dist/assets/mindmap-definition-YA3MSWOX-DtiuF6Ce.js +96 -0
  110. package/ui/dist/assets/ordinal-BDEzSJ7C.js +1 -0
  111. package/ui/dist/assets/packet-AYTQ26CC-BX2-w9rD.js +1 -0
  112. package/ui/dist/assets/path-fybaL0A-.js +1 -0
  113. package/ui/dist/assets/pegDiagram-XKGWAZYB-CotwuIHB.js +1 -0
  114. package/ui/dist/assets/pie-WAS4IAKB-Hth8ZVpm.js +1 -0
  115. package/ui/dist/assets/pieDiagram-E7YTZNPT-D9-INs8B.js +39 -0
  116. package/ui/dist/assets/quadrantDiagram-AXDQQJYC-CMtBXZGV.js +7 -0
  117. package/ui/dist/assets/radar-RG4KPBEZ-6UuwQPsw.js +1 -0
  118. package/ui/dist/assets/railroad-74A4TZTK-BF5TZgj0.js +1 -0
  119. package/ui/dist/assets/railroad-abnf-HS5TGJTU-3KYovtYT.js +1 -0
  120. package/ui/dist/assets/railroad-ebnf-LZEXJU2U-DeP4WedE.js +1 -0
  121. package/ui/dist/assets/railroad-peg-WCYAUIDC-i42N1-yk.js +1 -0
  122. package/ui/dist/assets/railroadDiagram-O6MQD6OU-BS6zkU3Z.js +1 -0
  123. package/ui/dist/assets/requirementDiagram-BXWQKSXE-J4IOB-kP.js +84 -0
  124. package/ui/dist/assets/rough.esm-Dy-Kn_BL.js +1 -0
  125. package/ui/dist/assets/sankeyDiagram-P5KCCOFB-jYTCuYzQ.js +40 -0
  126. package/ui/dist/assets/sequenceDiagram-WJ2MYXX4-Cd2r6PW-.js +162 -0
  127. package/ui/dist/assets/sizeCapture-INFHLROL-B0uUizjq.js +1 -0
  128. package/ui/dist/assets/src-7TsfZXRO.js +1 -0
  129. package/ui/dist/assets/stateDiagram-D77RDMKH-DXOdtOKe.js +1 -0
  130. package/ui/dist/assets/stateDiagram-v2-MP3YSRHH-9h7sIf3R.js +1 -0
  131. package/ui/dist/assets/swimlanes-42K2YHIH-BvJGmGs1.js +1 -0
  132. package/ui/dist/assets/swimlanesDiagram-VR7AAH4N-QA4gPi6a.js +8 -0
  133. package/ui/dist/assets/timeline-definition-24CTP7MA-CAaD6-yd.js +120 -0
  134. package/ui/dist/assets/treeView-Q6P3EWNA-4gDEXIyJ.js +1 -0
  135. package/ui/dist/assets/treemap-WGGIJYW6-CGel5TwW.js +1 -0
  136. package/ui/dist/assets/vennDiagram-4TSXK5OY-DpxsKboL.js +34 -0
  137. package/ui/dist/assets/wardley-WFR3VGLG-Ck38v5ns.js +1 -0
  138. package/ui/dist/assets/wardleyDiagram-VM6X3IG4-Ba0grrqs.js +78 -0
  139. package/ui/dist/assets/xychartDiagram-S5SC5T6Z-DH_gC96K.js +7 -0
  140. package/ui/dist/index.html +13 -0
  141. package/ui/dist/kortext-logo-dark.svg +41 -0
  142. package/ui/dist/kortext-logo.svg +41 -0
  143. package/workflows/existing-project-analysis.md +87 -0
  144. package/workflows/new-project-analysis.md +98 -0
  145. package/workflows/planning-pipeline.md +61 -0
  146. package/AGENTS.md +0 -24
  147. package/CHANGELOG.md +0 -81
  148. package/USER-GUIDE.md +0 -505
  149. package/agents/backend-developer.md +0 -132
  150. package/agents/delivery-manager.md +0 -121
  151. package/agents/engineering-manager.md +0 -208
  152. package/agents/frontend-developer.md +0 -174
  153. package/agents/operation-manager.md +0 -122
  154. package/bin/kortext.ts +0 -377
  155. package/dist/bin/kortext.js +0 -346
  156. package/dist/bin/kortext.js.map +0 -1
  157. package/dist/mcp/index.js +0 -4
  158. package/dist/mcp/index.js.map +0 -1
  159. package/dist/mcp/server.js +0 -553
  160. package/dist/mcp/server.js.map +0 -1
  161. package/dist/mcp/sse.js +0 -38
  162. package/dist/mcp/sse.js.map +0 -1
  163. package/dist/mcp/stdio.js +0 -44
  164. package/dist/mcp/stdio.js.map +0 -1
  165. package/dist/server/cli/cleanup.js +0 -73
  166. package/dist/server/cli/cleanup.js.map +0 -1
  167. package/dist/server/cli/commands.js +0 -73
  168. package/dist/server/cli/commands.js.map +0 -1
  169. package/dist/server/cli/doctor.js +0 -118
  170. package/dist/server/cli/doctor.js.map +0 -1
  171. package/dist/server/cli/executor-factory.js +0 -39
  172. package/dist/server/cli/executor-factory.js.map +0 -1
  173. package/dist/server/cli/init.js +0 -121
  174. package/dist/server/cli/init.js.map +0 -1
  175. package/dist/server/cli/logs.js +0 -28
  176. package/dist/server/cli/logs.js.map +0 -1
  177. package/dist/server/cli/serve.js +0 -72
  178. package/dist/server/cli/serve.js.map +0 -1
  179. package/dist/server/config/env.js +0 -12
  180. package/dist/server/config/env.js.map +0 -1
  181. package/dist/server/db/client.js +0 -32
  182. package/dist/server/db/client.js.map +0 -1
  183. package/dist/server/db/json.js +0 -21
  184. package/dist/server/db/json.js.map +0 -1
  185. package/dist/server/db/migrate.js +0 -70
  186. package/dist/server/db/migrate.js.map +0 -1
  187. package/dist/server/db/migrations/001_init.sql +0 -243
  188. package/dist/server/db/repositories/audit-log.js +0 -58
  189. package/dist/server/db/repositories/audit-log.js.map +0 -1
  190. package/dist/server/db/repositories/backlog.js +0 -96
  191. package/dist/server/db/repositories/backlog.js.map +0 -1
  192. package/dist/server/db/repositories/contexts.js +0 -54
  193. package/dist/server/db/repositories/contexts.js.map +0 -1
  194. package/dist/server/db/repositories/decisions.js +0 -71
  195. package/dist/server/db/repositories/decisions.js.map +0 -1
  196. package/dist/server/db/repositories/handovers.js +0 -53
  197. package/dist/server/db/repositories/handovers.js.map +0 -1
  198. package/dist/server/db/repositories/index.js +0 -30
  199. package/dist/server/db/repositories/index.js.map +0 -1
  200. package/dist/server/db/repositories/locks.js +0 -59
  201. package/dist/server/db/repositories/locks.js.map +0 -1
  202. package/dist/server/db/repositories/notifications.js +0 -63
  203. package/dist/server/db/repositories/notifications.js.map +0 -1
  204. package/dist/server/db/repositories/pending-questions.js +0 -63
  205. package/dist/server/db/repositories/pending-questions.js.map +0 -1
  206. package/dist/server/db/repositories/runs.js +0 -138
  207. package/dist/server/db/repositories/runs.js.map +0 -1
  208. package/dist/server/db/repositories/runtime-artifacts.js +0 -39
  209. package/dist/server/db/repositories/runtime-artifacts.js.map +0 -1
  210. package/dist/server/db/repositories/secrets.js +0 -65
  211. package/dist/server/db/repositories/secrets.js.map +0 -1
  212. package/dist/server/db/repositories/sessions.js +0 -48
  213. package/dist/server/db/repositories/sessions.js.map +0 -1
  214. package/dist/server/db/schemas.js +0 -308
  215. package/dist/server/db/schemas.js.map +0 -1
  216. package/dist/server/engine/consistency.js +0 -25
  217. package/dist/server/engine/consistency.js.map +0 -1
  218. package/dist/server/engine/dag.js +0 -86
  219. package/dist/server/engine/dag.js.map +0 -1
  220. package/dist/server/engine/executor.js +0 -2
  221. package/dist/server/engine/executor.js.map +0 -1
  222. package/dist/server/engine/executors/claude-cli-executor.js +0 -83
  223. package/dist/server/engine/executors/claude-cli-executor.js.map +0 -1
  224. package/dist/server/engine/executors/cli-spawn.js +0 -127
  225. package/dist/server/engine/executors/cli-spawn.js.map +0 -1
  226. package/dist/server/engine/executors/codex-cli-executor.js +0 -69
  227. package/dist/server/engine/executors/codex-cli-executor.js.map +0 -1
  228. package/dist/server/engine/executors/gemini-cli-executor.js +0 -69
  229. package/dist/server/engine/executors/gemini-cli-executor.js.map +0 -1
  230. package/dist/server/engine/executors/mock-executor.js +0 -52
  231. package/dist/server/engine/executors/mock-executor.js.map +0 -1
  232. package/dist/server/engine/executors/persona-routed-executor.js +0 -17
  233. package/dist/server/engine/executors/persona-routed-executor.js.map +0 -1
  234. package/dist/server/engine/gate-enforcer.js +0 -75
  235. package/dist/server/engine/gate-enforcer.js.map +0 -1
  236. package/dist/server/engine/git-commit.js +0 -42
  237. package/dist/server/engine/git-commit.js.map +0 -1
  238. package/dist/server/engine/handover.js +0 -120
  239. package/dist/server/engine/handover.js.map +0 -1
  240. package/dist/server/engine/item-lifecycle.js +0 -74
  241. package/dist/server/engine/item-lifecycle.js.map +0 -1
  242. package/dist/server/engine/persona-registry.js +0 -108
  243. package/dist/server/engine/persona-registry.js.map +0 -1
  244. package/dist/server/engine/worker-pool.js +0 -324
  245. package/dist/server/engine/worker-pool.js.map +0 -1
  246. package/dist/server/engine/workflow-loader.js +0 -55
  247. package/dist/server/engine/workflow-loader.js.map +0 -1
  248. package/dist/server/engine/workflow-parser.js +0 -158
  249. package/dist/server/engine/workflow-parser.js.map +0 -1
  250. package/dist/server/engine/worktree.js +0 -176
  251. package/dist/server/engine/worktree.js.map +0 -1
  252. package/dist/server/index.js +0 -99
  253. package/dist/server/index.js.map +0 -1
  254. package/dist/server/notifications/dispatcher.js +0 -60
  255. package/dist/server/notifications/dispatcher.js.map +0 -1
  256. package/dist/server/notifications/slack.js +0 -37
  257. package/dist/server/notifications/slack.js.map +0 -1
  258. package/dist/server/notifications/telegram.js +0 -33
  259. package/dist/server/notifications/telegram.js.map +0 -1
  260. package/dist/server/orchestrator/approval-queue.js +0 -83
  261. package/dist/server/orchestrator/approval-queue.js.map +0 -1
  262. package/dist/server/orchestrator/blueprint-watcher.js +0 -94
  263. package/dist/server/orchestrator/blueprint-watcher.js.map +0 -1
  264. package/dist/server/orchestrator/orchestrator.js +0 -283
  265. package/dist/server/orchestrator/orchestrator.js.map +0 -1
  266. package/dist/server/orchestrator/pipeline-chainer.js +0 -96
  267. package/dist/server/orchestrator/pipeline-chainer.js.map +0 -1
  268. package/dist/server/orchestrator/resume.js +0 -36
  269. package/dist/server/orchestrator/resume.js.map +0 -1
  270. package/dist/server/routes/approvals.js +0 -52
  271. package/dist/server/routes/approvals.js.map +0 -1
  272. package/dist/server/routes/backlog.js +0 -44
  273. package/dist/server/routes/backlog.js.map +0 -1
  274. package/dist/server/routes/db-info.js +0 -21
  275. package/dist/server/routes/db-info.js.map +0 -1
  276. package/dist/server/routes/docs.js +0 -70
  277. package/dist/server/routes/docs.js.map +0 -1
  278. package/dist/server/routes/doctor.js +0 -19
  279. package/dist/server/routes/doctor.js.map +0 -1
  280. package/dist/server/routes/handovers.js +0 -25
  281. package/dist/server/routes/handovers.js.map +0 -1
  282. package/dist/server/routes/health.js +0 -11
  283. package/dist/server/routes/health.js.map +0 -1
  284. package/dist/server/routes/personas.js +0 -96
  285. package/dist/server/routes/personas.js.map +0 -1
  286. package/dist/server/routes/runs.js +0 -41
  287. package/dist/server/routes/runs.js.map +0 -1
  288. package/dist/server/routes/workflows.js +0 -38
  289. package/dist/server/routes/workflows.js.map +0 -1
  290. package/dist/server/safety/harmful-output-filter.js +0 -40
  291. package/dist/server/safety/harmful-output-filter.js.map +0 -1
  292. package/dist/server/safety/secret-scanner.js +0 -169
  293. package/dist/server/safety/secret-scanner.js.map +0 -1
  294. package/dist/server/services/markdown-sync.js +0 -101
  295. package/dist/server/services/markdown-sync.js.map +0 -1
  296. package/dist/web/assets/index-B80d5ZPZ.js +0 -75
  297. package/dist/web/assets/index-B80d5ZPZ.js.map +0 -1
  298. package/dist/web/assets/index-Bge5Gzqv.css +0 -1
  299. package/dist/web/index.html +0 -13
  300. package/docs/architecture.md +0 -413
  301. package/rules/behavior.md +0 -252
  302. package/rules/branching.md +0 -82
  303. package/rules/commands.md +0 -112
  304. package/rules/emergency.md +0 -160
  305. package/rules/mcp.md +0 -47
  306. package/rules/models.md +0 -93
  307. package/scripts/copy-migrations.mjs +0 -29
  308. package/workflows/00-kortext-setup.md +0 -53
  309. package/workflows/01a-analysis-pipeline.md +0 -117
  310. package/workflows/01b-onboarding-pipeline.md +0 -110
  311. package/workflows/02-planning-pipeline.md +0 -146
  312. package/workflows/02b-spike-workflow.md +0 -120
  313. package/workflows/03-environment-setup.md +0 -99
  314. package/workflows/04-development-cycle.md +0 -203
  315. package/workflows/05-test-cycle.md +0 -123
  316. package/workflows/06-deployment-cycle.md +0 -224
  317. package/workflows/07-rollback-pipeline.md +0 -203
  318. package/workflows/08-hotfix-pipeline.md +0 -196
  319. package/workflows/09-maintenance-cycle.md +0 -133
  320. package/workspace/.locks/workspace_handover.md.lock +0 -3
  321. package/workspace/archive/.gitkeep +0 -0
  322. package/workspace/backups/.gitkeep +0 -0
  323. package/workspace/memory/backlog/.gitkeep +0 -0
  324. package/workspace/memory/backlog/BXX-[bug-name].md +0 -2
  325. package/workspace/memory/backlog/DXX-[debt-name].md +0 -2
  326. package/workspace/memory/backlog/README.md +0 -31
  327. package/workspace/memory/backlog/TXX-[task-name].md +0 -2
  328. package/workspace/memory/backlog/debt-dashboard.md +0 -3
  329. package/workspace/memory/backlog/epic-dashboard.md +0 -10
  330. package/workspace/memory/backlog/version-dashboard.md +0 -7
  331. package/workspace/memory/context/.gitkeep +0 -0
  332. package/workspace/memory/context/README.md +0 -35
  333. package/workspace/memory/context/[agent-name]-active.md +0 -2
  334. package/workspace/memory/decisions.md +0 -17
  335. package/workspace/memory/handover.md +0 -40
  336. package/workspace/memory/learned.md +0 -21
  337. package/workspace/references/access.md +0 -47
  338. package/workspace/references/api-reference.md +0 -59
  339. package/workspace/references/blueprint.md +0 -29
  340. package/workspace/references/content-strategy.md +0 -39
  341. package/workspace/references/db-schema.md +0 -51
  342. package/workspace/references/design-system.md +0 -107
  343. package/workspace/references/dictionary.md +0 -42
  344. package/workspace/references/file-system.md +0 -42
  345. package/workspace/references/growth-strategy.md +0 -46
  346. package/workspace/references/legal-strategy.md +0 -35
  347. package/workspace/references/required-skills.md +0 -11
  348. package/workspace/references/security-rules.md +0 -34
  349. package/workspace/references/tech-stack.md +0 -49
  350. package/workspace/references/test-strategy.md +0 -48
  351. package/workspace/reports/analysis-reports.md +0 -40
  352. package/workspace/reports/content-reports.md +0 -29
  353. package/workspace/reports/delivery-reports.md +0 -26
  354. package/workspace/reports/growth-reports.md +0 -9
  355. package/workspace/reports/legal-reports.md +0 -29
  356. package/workspace/reports/product-requirements.md +0 -28
  357. package/workspace/reports/release-notes.md +0 -20
  358. package/workspace/reports/security-reports.md +0 -27
  359. package/workspace/reports/status-reports.md +0 -48
  360. package/workspace/reports/tech-requirements.md +0 -30
  361. package/workspace/reports/test-reports.md +0 -61
  362. package/workspace/templates/BXX-[bug-name].md +0 -34
  363. package/workspace/templates/DXX-[debt-name].md +0 -35
  364. package/workspace/templates/EXX-[epic-name].md +0 -48
  365. package/workspace/templates/HXX-[hotfix-name].md +0 -73
  366. package/workspace/templates/SXX-[spike-name].md +0 -51
  367. package/workspace/templates/TXX-[task-name].md +0 -34
  368. package/workspace/templates/[agent-name]-active.md +0 -4
  369. package/workspace/templates/[original-name]_[YYYY-MM-DD_HHMMSS].md +0 -5
  370. package/workspace/templates/adr-XXX.md +0 -66
  371. package/workspace/templates/debt-dashboard.md +0 -10
  372. package/workspace/templates/epic-dashboard.md +0 -10
  373. package/workspace/templates/version-dashboard.md +0 -10
@@ -1,74 +0,0 @@
1
- const TRANSITIONS = {
2
- start: { from: ['to_do'], to: 'in_progress' },
3
- review: { from: ['in_progress'], to: 'review' },
4
- done: { from: ['review'], to: 'done' },
5
- block: { from: ['in_progress', 'review'], to: 'blocked' },
6
- unblock: { from: ['blocked'], to: 'in_progress' },
7
- cancel: { from: ['to_do', 'in_progress', 'review', 'blocked'], to: 'cancelled' },
8
- };
9
- const TERMINAL_STATES = new Set(['done', 'cancelled']);
10
- export class IllegalTransitionError extends Error {
11
- itemId;
12
- transition;
13
- fromStatus;
14
- constructor(itemId, transition, fromStatus) {
15
- super(`illegal transition '${transition}' on item ${itemId} from status '${fromStatus}'`);
16
- this.itemId = itemId;
17
- this.transition = transition;
18
- this.fromStatus = fromStatus;
19
- this.name = 'IllegalTransitionError';
20
- }
21
- }
22
- export class ItemLifecycle {
23
- opts;
24
- constructor(opts) {
25
- this.opts = opts;
26
- }
27
- create(input) {
28
- if (input.owner && this.opts.personas.get(input.owner) === null) {
29
- throw new Error(`unknown persona for owner: ${input.owner}`);
30
- }
31
- return this.opts.repos.backlog.create({
32
- id: input.id,
33
- type: input.type,
34
- title: input.title,
35
- owner: input.owner ?? null,
36
- parent_id: input.parent_id ?? null,
37
- body_md: input.body_md ?? '',
38
- });
39
- }
40
- transition(itemId, action, by, reason) {
41
- const current = this.opts.repos.backlog.get(itemId);
42
- if (!current) {
43
- throw new Error(`backlog item not found: ${itemId}`);
44
- }
45
- if (TERMINAL_STATES.has(current.status)) {
46
- throw new IllegalTransitionError(itemId, action, current.status);
47
- }
48
- const rule = TRANSITIONS[action];
49
- if (!rule.from.includes(current.status)) {
50
- throw new IllegalTransitionError(itemId, action, current.status);
51
- }
52
- const updated = this.opts.repos.backlog.transitionStatus(itemId, rule.to);
53
- this.opts.repos.auditLog.append({
54
- actor: by,
55
- action: 'item_transition',
56
- resource_type: 'backlog_item',
57
- resource_id: itemId,
58
- payload: {
59
- from: current.status,
60
- to: rule.to,
61
- transition: action,
62
- reason: reason ?? null,
63
- },
64
- });
65
- return updated;
66
- }
67
- /** Items in any non-terminal state — useful for dashboard "active" view. */
68
- listOpen() {
69
- return this.opts.repos.backlog
70
- .list({ limit: 1000 })
71
- .filter((i) => !TERMINAL_STATES.has(i.status));
72
- }
73
- }
74
- //# sourceMappingURL=item-lifecycle.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"item-lifecycle.js","sourceRoot":"","sources":["../../../server/engine/item-lifecycle.ts"],"names":[],"mappings":"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"}
@@ -1,108 +0,0 @@
1
- import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
2
- import { basename, join } from 'node:path';
3
- const H1_RE = /^#\s+([\w-]+)\s*$/;
4
- const DESCRIPTION_RE = /^-\s*description\s*:\s*(.+?)\s*$/i;
5
- export function parsePersonaMarkdown(source, fileId) {
6
- const lines = source.split('\n');
7
- let handleId = null;
8
- let description = null;
9
- for (const raw of lines) {
10
- const line = raw.replace(/\r$/, '');
11
- if (handleId === null) {
12
- const m = line.match(H1_RE);
13
- if (m?.[1]) {
14
- handleId = m[1];
15
- continue;
16
- }
17
- }
18
- if (description === null) {
19
- const d = line.match(DESCRIPTION_RE);
20
- if (d?.[1]) {
21
- description = d[1];
22
- }
23
- }
24
- if (handleId !== null && description !== null)
25
- break;
26
- }
27
- if (!handleId) {
28
- throw new Error(`missing H1 handle (expected '# <handle>') in ${fileId}`);
29
- }
30
- if (!description) {
31
- throw new Error(`missing '- description:' bullet in ${fileId}`);
32
- }
33
- return {
34
- handle: `+${handleId}`,
35
- id: handleId,
36
- description,
37
- systemPrompt: source,
38
- };
39
- }
40
- export function loadPersonasFromDir(dir) {
41
- const dirStat = statSync(dir);
42
- if (!dirStat.isDirectory()) {
43
- throw new Error(`persona registry: not a directory: ${dir}`);
44
- }
45
- const byHandle = new Map();
46
- const errors = [];
47
- const refresh = () => {
48
- byHandle.clear();
49
- errors.length = 0;
50
- for (const entry of readdirSync(dir, { withFileTypes: true })) {
51
- if (!entry.isFile())
52
- continue;
53
- if (!entry.name.endsWith('.md'))
54
- continue;
55
- const fullPath = join(dir, entry.name);
56
- const fileId = basename(entry.name, '.md');
57
- try {
58
- const source = readFileSync(fullPath, 'utf8');
59
- const def = parsePersonaMarkdown(source, fileId);
60
- byHandle.set(def.handle, def);
61
- }
62
- catch (err) {
63
- errors.push({
64
- file: entry.name,
65
- reason: err instanceof Error ? err.message : String(err),
66
- });
67
- }
68
- }
69
- };
70
- refresh();
71
- return {
72
- get(handle) {
73
- const canonical = handle.startsWith('+') ? handle : `+${handle}`;
74
- return byHandle.get(canonical) ?? null;
75
- },
76
- list() {
77
- return [...byHandle.values()];
78
- },
79
- errors() {
80
- return [...errors];
81
- },
82
- reload: refresh,
83
- };
84
- }
85
- /**
86
- * Shared prompt resolver for CLI executors.
87
- *
88
- * If `source` is a registry, look up the canonical systemPrompt. Otherwise
89
- * fall back to a disk-direct read from `<agentsDir>/<handle>.md` — the
90
- * pre-Faz-5 behavior, kept for tests and stand-alone use.
91
- *
92
- * Returns an empty string when the persona is unknown / file missing. The
93
- * caller decides whether that's an error (CLI executors silently continue
94
- * today; `kortext doctor` raises it as a consistency finding).
95
- */
96
- export function readPersonaPrompt(handle, source) {
97
- if (!handle)
98
- return '';
99
- if ('list' in source) {
100
- return source.get(handle)?.systemPrompt ?? '';
101
- }
102
- const id = handle.replace(/^\+/, '');
103
- const path = join(source.agentsDir, `${id}.md`);
104
- if (!existsSync(path))
105
- return '';
106
- return readFileSync(path, 'utf8');
107
- }
108
- //# sourceMappingURL=persona-registry.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"persona-registry.js","sourceRoot":"","sources":["../../../server/engine/persona-registry.ts"],"names":[],"mappings":"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"}
@@ -1,324 +0,0 @@
1
- import { isAbsolute, join } from 'node:path';
2
- import { readFileSync } from 'node:fs';
3
- async function runSafetyGuards(step, logPath, safety, worktreePath, runId) {
4
- if (!safety)
5
- return null;
6
- const outputFiles = step.outputs.map((rel) => isAbsolute(rel) ? rel : join(worktreePath, rel));
7
- const filesToScan = logPath ? [...outputFiles, logPath] : outputFiles;
8
- if (safety.secretScanner && filesToScan.length > 0) {
9
- const report = await safety.secretScanner.scanForStep(runId, filesToScan);
10
- if (report.shouldFailRun) {
11
- const f = report.findings[0];
12
- return `secret/token detected in step output: ${f?.finding_type} at ${f?.scanned_path}:${f?.line_number}`;
13
- }
14
- }
15
- if (safety.harmfulFilter && filesToScan.length > 0) {
16
- for (const file of filesToScan) {
17
- let body;
18
- try {
19
- body = readFileSync(file, 'utf8');
20
- }
21
- catch {
22
- continue;
23
- }
24
- const report = safety.harmfulFilter.scanText(body);
25
- if (report.shouldFailRun) {
26
- const f = report.findings[0];
27
- return `banned/harmful phrase detected in ${file}:${f?.line_number} — ${f?.message}`;
28
- }
29
- }
30
- }
31
- return null;
32
- }
33
- export async function runWorkflow(graph, executor, repos, options = {}) {
34
- const concurrency = Math.max(1, options.concurrency ?? 3);
35
- const triggeredBy = options.triggeredBy ?? 'system';
36
- const run = repos.runs.createRun({
37
- workflow_id: graph.workflowId,
38
- item_id: options.itemId ?? null,
39
- status: 'queued',
40
- worktree_path: options.worktreePath ?? null,
41
- triggered_by: triggeredBy,
42
- });
43
- repos.runs.transitionRun(run.id, 'running');
44
- repos.auditLog.append({
45
- actor: 'system',
46
- action: 'pipeline.started',
47
- resource_type: 'run',
48
- resource_id: String(run.id),
49
- payload: { workflow_id: graph.workflowId, concurrency },
50
- });
51
- // Pre-create step rows so the dashboard can render the full plan immediately.
52
- const stepRowByKey = new Map();
53
- const orderedNodes = [...graph.nodes.values()].sort((a, b) => a.step.index - b.step.index);
54
- const preCompleted = options.preCompletedStepKeys ?? new Set();
55
- for (const node of orderedNodes) {
56
- const isResumed = preCompleted.has(node.step.key);
57
- const row = repos.runs.addStep({
58
- run_id: run.id,
59
- step_index: node.step.index,
60
- step_name: `${node.step.phase} — ${node.step.persona ?? '(no persona)'}: ${node.step.description.slice(0, 80)}`,
61
- persona: node.step.persona,
62
- status: 'pending',
63
- });
64
- stepRowByKey.set(node.step.key, row.id);
65
- if (isResumed) {
66
- repos.runs.transitionStep(row.id, 'skipped', {
67
- output_summary: 'resumed-from-previous-run',
68
- });
69
- }
70
- }
71
- const gateByStepIndex = new Map();
72
- for (const gate of options.gates ?? []) {
73
- if (gate.afterStepIndex >= 0)
74
- gateByStepIndex.set(gate.afterStepIndex, gate);
75
- }
76
- const firedGateIndices = new Set();
77
- let pendingGate = null;
78
- let rejectionReason = null;
79
- // Resumed runs (Orchestrator.retryRun) replay the lowest gate that sat
80
- // *after* one of the resumed steps. Without this, the scheduler's barrier
81
- // would block forever — the gate would never fire because the step that
82
- // would have fired it was pre-marked as skipped.
83
- for (const node of orderedNodes) {
84
- if (!preCompleted.has(node.step.key))
85
- continue;
86
- const gate = gateByStepIndex.get(node.step.index);
87
- if (gate && !pendingGate) {
88
- pendingGate = gate;
89
- firedGateIndices.add(gate.afterStepIndex);
90
- repos.auditLog.append({
91
- actor: 'orchestrator',
92
- action: 'gate.paused',
93
- resource_type: 'run',
94
- resource_id: String(run.id),
95
- payload: {
96
- phase: gate.phase,
97
- after_step_index: gate.afterStepIndex,
98
- reason: 'resumed',
99
- },
100
- });
101
- }
102
- }
103
- const done = new Set(preCompleted);
104
- const running = new Map();
105
- const aborter = new AbortController();
106
- let failedStepKey = null;
107
- let firstError = null;
108
- const ctxFor = (runStepId) => ({
109
- workflowId: graph.workflowId,
110
- runId: run.id,
111
- runStepId,
112
- worktreePath: options.worktreePath ?? process.cwd(),
113
- signal: aborter.signal,
114
- });
115
- const launch = (stepKey) => {
116
- const node = graph.nodes.get(stepKey);
117
- if (!node)
118
- return;
119
- const runStepId = stepRowByKey.get(stepKey);
120
- repos.runs.transitionStep(runStepId, 'running');
121
- repos.auditLog.append({
122
- actor: executor.name,
123
- action: 'pipeline.step.started',
124
- resource_type: 'run_step',
125
- resource_id: String(runStepId),
126
- payload: { run_id: run.id, step_key: stepKey, persona: node.step.persona },
127
- });
128
- const promise = executor
129
- .execute(node.step, ctxFor(runStepId))
130
- .then(async (result) => {
131
- if (result.ok) {
132
- // Apply safety guards before we mark the step as succeeded.
133
- const safetyError = await runSafetyGuards(node.step, result.logPath ?? null, options.safety, options.worktreePath ?? process.cwd(), run.id);
134
- if (safetyError) {
135
- repos.runs.transitionStep(runStepId, 'failed', {
136
- output_summary: result.outputSummary ?? null,
137
- error_message: safetyError,
138
- log_path: result.logPath ?? null,
139
- });
140
- repos.auditLog.append({
141
- actor: 'safety',
142
- action: 'pipeline.step.failed',
143
- resource_type: 'run_step',
144
- resource_id: String(runStepId),
145
- payload: { run_id: run.id, step_key: stepKey, error: safetyError },
146
- });
147
- if (!failedStepKey) {
148
- failedStepKey = stepKey;
149
- firstError = safetyError;
150
- aborter.abort();
151
- }
152
- return;
153
- }
154
- repos.runs.transitionStep(runStepId, 'succeeded', {
155
- output_summary: result.outputSummary ?? null,
156
- log_path: result.logPath ?? null,
157
- });
158
- repos.auditLog.append({
159
- actor: executor.name,
160
- action: 'pipeline.step.succeeded',
161
- resource_type: 'run_step',
162
- resource_id: String(runStepId),
163
- payload: { run_id: run.id, step_key: stepKey },
164
- });
165
- done.add(stepKey);
166
- // Gate trigger: a gate fires once after the step at its afterStepIndex completes.
167
- const gate = gateByStepIndex.get(node.step.index);
168
- if (gate && !firedGateIndices.has(gate.afterStepIndex)) {
169
- firedGateIndices.add(gate.afterStepIndex);
170
- pendingGate = gate;
171
- repos.auditLog.append({
172
- actor: 'orchestrator',
173
- action: 'gate.paused',
174
- resource_type: 'run',
175
- resource_id: String(run.id),
176
- payload: { phase: gate.phase, after_step_index: gate.afterStepIndex },
177
- });
178
- }
179
- }
180
- else {
181
- repos.runs.transitionStep(runStepId, 'failed', {
182
- output_summary: result.outputSummary ?? null,
183
- error_message: result.errorMessage ?? 'unknown failure',
184
- log_path: result.logPath ?? null,
185
- });
186
- repos.auditLog.append({
187
- actor: executor.name,
188
- action: 'pipeline.step.failed',
189
- resource_type: 'run_step',
190
- resource_id: String(runStepId),
191
- payload: { run_id: run.id, step_key: stepKey, error: result.errorMessage },
192
- });
193
- if (!failedStepKey) {
194
- failedStepKey = stepKey;
195
- firstError = result.errorMessage ?? null;
196
- aborter.abort();
197
- }
198
- }
199
- })
200
- .catch((err) => {
201
- const msg = err instanceof Error ? err.message : String(err);
202
- repos.runs.transitionStep(runStepId, 'failed', { error_message: msg });
203
- if (!failedStepKey) {
204
- failedStepKey = stepKey;
205
- firstError = msg;
206
- aborter.abort();
207
- }
208
- })
209
- .finally(() => {
210
- running.delete(stepKey);
211
- });
212
- running.set(stepKey, promise);
213
- };
214
- // Scheduler loop.
215
- while (done.size + (failedStepKey ? 1 : 0) < graph.size ||
216
- running.size > 0 ||
217
- pendingGate !== null) {
218
- // Gate barrier: when a gate is pending we drain in-flight work first,
219
- // then ask the controller for approve/reject before scheduling more steps.
220
- const gateToProcess = pendingGate;
221
- if (gateToProcess && running.size === 0 && !failedStepKey && !rejectionReason) {
222
- if (!options.gateController) {
223
- throw new Error(`gate encountered but no gateController provided (phase: ${gateToProcess.phase})`);
224
- }
225
- pendingGate = null;
226
- const decision = await options.gateController.pauseAtGate({
227
- gate: gateToProcess,
228
- runId: run.id,
229
- workflowId: graph.workflowId,
230
- });
231
- if (decision.decision === 'approve') {
232
- repos.auditLog.append({
233
- actor: 'orchestrator',
234
- action: 'gate.resumed',
235
- resource_type: 'run',
236
- resource_id: String(run.id),
237
- payload: { phase: gateToProcess.phase, decision: 'approve' },
238
- });
239
- }
240
- else {
241
- rejectionReason = decision.reason;
242
- repos.auditLog.append({
243
- actor: 'orchestrator',
244
- action: 'gate.rejected',
245
- resource_type: 'run',
246
- resource_id: String(run.id),
247
- payload: { phase: gateToProcess.phase, reason: decision.reason },
248
- });
249
- aborter.abort();
250
- }
251
- }
252
- if (!failedStepKey && !rejectionReason && !pendingGate) {
253
- // Gate barrier: do not start any step whose index lies past an un-fired gate.
254
- // This makes gates semantically equivalent to a phase boundary even when the
255
- // pure data-flow DAG sees later steps as already runnable in parallel.
256
- let barrier = Number.POSITIVE_INFINITY;
257
- for (const idx of gateByStepIndex.keys()) {
258
- if (!firedGateIndices.has(idx) && idx < barrier)
259
- barrier = idx;
260
- }
261
- const ready = graph.readyKeys(done).filter((k) => {
262
- if (running.has(k))
263
- return false;
264
- const node = graph.nodes.get(k);
265
- if (node && node.step.index > barrier)
266
- return false;
267
- return true;
268
- });
269
- while (ready.length > 0 && running.size < concurrency) {
270
- const next = ready.shift();
271
- launch(next);
272
- }
273
- }
274
- if (running.size === 0 && !pendingGate)
275
- break;
276
- if (running.size > 0) {
277
- await Promise.race(running.values());
278
- }
279
- }
280
- // Mark any un-started steps as skipped (only happens after failure or rejection).
281
- if (failedStepKey || rejectionReason) {
282
- for (const [key, rowId] of stepRowByKey) {
283
- if (done.has(key))
284
- continue;
285
- if (key === failedStepKey)
286
- continue;
287
- const row = repos.runs.getStep(rowId);
288
- if (row && row.status === 'pending') {
289
- repos.runs.transitionStep(rowId, 'skipped');
290
- }
291
- }
292
- }
293
- let finalStatus;
294
- let finalError;
295
- if (rejectionReason) {
296
- finalStatus = 'cancelled';
297
- finalError = `rejected: ${rejectionReason}`;
298
- }
299
- else if (failedStepKey) {
300
- finalStatus = 'failed';
301
- finalError = firstError;
302
- }
303
- else {
304
- finalStatus = 'succeeded';
305
- finalError = null;
306
- }
307
- const finalRun = repos.runs.transitionRun(run.id, finalStatus, {
308
- error_message: finalError,
309
- });
310
- repos.auditLog.append({
311
- actor: 'system',
312
- action: `pipeline.${finalStatus}`,
313
- resource_type: 'run',
314
- resource_id: String(run.id),
315
- payload: {
316
- workflow_id: graph.workflowId,
317
- failed_step: failedStepKey,
318
- step_count: graph.size,
319
- rejection_reason: rejectionReason,
320
- },
321
- });
322
- return { run: finalRun, failedStepKey };
323
- }
324
- //# sourceMappingURL=worker-pool.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"worker-pool.js","sourceRoot":"","sources":["../../../server/engine/worker-pool.ts"],"names":[],"mappings":"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"}
@@ -1,55 +0,0 @@
1
- import { readdirSync, statSync } from 'node:fs';
2
- import { join } from 'node:path';
3
- import { loadWorkflowFromFile, } from "./workflow-parser.js";
4
- /**
5
- * Scan `dir` and build a registry of workflows.
6
- *
7
- * - Only `*.md` files at the top level are considered (no recursion).
8
- * - Files that parse to zero steps are treated as malformed: they go to
9
- * `errors()` and are NOT included in `list()`/`get()`.
10
- * - A non-existent directory throws — this is a config bug, not an
11
- * operational error.
12
- */
13
- export function loadWorkflowsFromDir(dir) {
14
- // statSync throws ENOENT for missing dirs — that's the contract.
15
- const dirStat = statSync(dir);
16
- if (!dirStat.isDirectory()) {
17
- throw new Error(`workflow loader: not a directory: ${dir}`);
18
- }
19
- const definitions = new Map();
20
- const errors = [];
21
- const entries = readdirSync(dir, { withFileTypes: true });
22
- for (const entry of entries) {
23
- if (!entry.isFile())
24
- continue;
25
- if (!entry.name.endsWith('.md'))
26
- continue;
27
- const fullPath = join(dir, entry.name);
28
- try {
29
- const def = loadWorkflowFromFile(fullPath);
30
- if (def.steps.length === 0) {
31
- errors.push({ file: entry.name, reason: 'no steps parsed (empty workflow)' });
32
- continue;
33
- }
34
- definitions.set(def.id, def);
35
- }
36
- catch (err) {
37
- errors.push({
38
- file: entry.name,
39
- reason: err instanceof Error ? err.message : String(err),
40
- });
41
- }
42
- }
43
- return {
44
- get(id) {
45
- return definitions.get(id) ?? null;
46
- },
47
- list() {
48
- return [...definitions.values()];
49
- },
50
- errors() {
51
- return [...errors];
52
- },
53
- };
54
- }
55
- //# sourceMappingURL=workflow-loader.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"workflow-loader.js","sourceRoot":"","sources":["../../../server/engine/workflow-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,oBAAoB,GAErB,MAAM,sBAAsB,CAAC;AA4B9B;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,iEAAiE;IACjE,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,qCAAqC,GAAG,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC1D,MAAM,MAAM,GAAwB,EAAE,CAAC;IAEvC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAAE,SAAS;QAC9B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAE1C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;YAC3C,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAC,CAAC;gBAC9E,SAAS;YACX,CAAC;YACD,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACzD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,CAAC,EAAE;YACJ,OAAO,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;QACrC,CAAC;QACD,IAAI;YACF,OAAO,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QACnC,CAAC;QACD,MAAM;YACJ,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}