@straiffi/archon 1.11.14 → 1.12.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 (417) hide show
  1. package/dist/client/assets/{ActivityView-CXlLfbio.js → ActivityView-jw3H-NeG.js} +1 -1
  2. package/dist/client/assets/{GitHubActionsDialog-COncogiu.js → GitHubActionsDialog-cUxcoLqx.js} +1 -1
  3. package/dist/client/assets/VerificationDialog-DP8d6ddQ.js +4 -0
  4. package/dist/client/assets/{architectureDiagram-3BPJPVTR-BgpjZv9J.js → architectureDiagram-3BPJPVTR-BhWOZPeu.js} +1 -1
  5. package/dist/client/assets/{blockDiagram-GPEHLZMM-DZOzPj8L.js → blockDiagram-GPEHLZMM-BJjjnCa4.js} +1 -1
  6. package/dist/client/assets/{c4Diagram-AAUBKEIU-CH8w_-4O.js → c4Diagram-AAUBKEIU-CQldjeAF.js} +1 -1
  7. package/dist/client/assets/channel-2Q4_MKqQ.js +1 -0
  8. package/dist/client/assets/{chunk-2J33WTMH-BhCJUMWk.js → chunk-2J33WTMH-D3ULHOwT.js} +1 -1
  9. package/dist/client/assets/{chunk-3OPIFGDE-B4ljJWcN.js → chunk-3OPIFGDE-zDE6O-L_.js} +1 -1
  10. package/dist/client/assets/{chunk-5ZQYHXKU-BokkrzzD.js → chunk-5ZQYHXKU-C7W7qahQ.js} +1 -1
  11. package/dist/client/assets/{chunk-727SXJPM-V-Kd95sz.js → chunk-727SXJPM-ChrtCiX1.js} +1 -1
  12. package/dist/client/assets/{chunk-AQP2D5EJ-D7ZyW65i.js → chunk-AQP2D5EJ-BJcMYTJ-.js} +1 -1
  13. package/dist/client/assets/{chunk-CSCIHK7Q-3cPiGWR4.js → chunk-CSCIHK7Q-uFhZVkuh.js} +1 -1
  14. package/dist/client/assets/{chunk-KSCS5N6A-fh-t3Kan.js → chunk-KSCS5N6A-DNE-cIoY.js} +1 -1
  15. package/dist/client/assets/{chunk-L5ZTLDWV-Bz_XmsGr.js → chunk-L5ZTLDWV-B1hsOai3.js} +1 -1
  16. package/dist/client/assets/{chunk-LZXEDZCA-DUQIbmfo.js → chunk-LZXEDZCA-BFcJgF2j.js} +2 -2
  17. package/dist/client/assets/{chunk-ND2GUHAM-BeaXA2cA.js → chunk-ND2GUHAM-oXJD3VO7.js} +1 -1
  18. package/dist/client/assets/{chunk-NZK2D7GU-Cljr0eIp.js → chunk-NZK2D7GU-DRK-yrm5.js} +1 -1
  19. package/dist/client/assets/{chunk-O5CBEL6O-BSZxUONE.js → chunk-O5CBEL6O-LQ2Eqsqb.js} +1 -1
  20. package/dist/client/assets/{chunk-WU5MYG2G-CqeEBV6t.js → chunk-WU5MYG2G-DW1hrICF.js} +1 -1
  21. package/dist/client/assets/classDiagram-4FO5ZUOK-DlhYAzjF.js +1 -0
  22. package/dist/client/assets/classDiagram-v2-Q7XG4LA2-DZsqIDkO.js +1 -0
  23. package/dist/client/assets/{dagre-BM42HDAG-C684sP5O.js → dagre-BM42HDAG-DAOujANI.js} +1 -1
  24. package/dist/client/assets/{diagram-2AECGRRQ-Bsuw7S1w.js → diagram-2AECGRRQ-CQoEIHep.js} +1 -1
  25. package/dist/client/assets/{diagram-5GNKFQAL-B7TKNAIK.js → diagram-5GNKFQAL-ChV233vS.js} +1 -1
  26. package/dist/client/assets/{diagram-KO2AKTUF-RPOTY2uQ.js → diagram-KO2AKTUF-CIkpG_DX.js} +1 -1
  27. package/dist/client/assets/{diagram-LMA3HP47-Dpk6toIw.js → diagram-LMA3HP47-kxcYwQT7.js} +1 -1
  28. package/dist/client/assets/{diagram-OG6HWLK6-DVJDTxyc.js → diagram-OG6HWLK6-J5YY8urL.js} +1 -1
  29. package/dist/client/assets/{erDiagram-TEJ5UH35-BTCHMpI9.js → erDiagram-TEJ5UH35-B5WiaYY1.js} +1 -1
  30. package/dist/client/assets/{flowDiagram-I6XJVG4X-DJHpUHaK.js → flowDiagram-I6XJVG4X-BuQ2YOAf.js} +1 -1
  31. package/dist/client/assets/{ganttDiagram-6RSMTGT7-B3lqQNjh.js → ganttDiagram-6RSMTGT7-BKgtiOWd.js} +1 -1
  32. package/dist/client/assets/{gitGraphDiagram-PVQCEYII-kSFZuvH6.js → gitGraphDiagram-PVQCEYII-ZT89EFiT.js} +1 -1
  33. package/dist/client/assets/index-DTsS9gs9.css +2 -0
  34. package/dist/client/assets/index-X4XsGor3.js +309 -0
  35. package/dist/client/assets/{infoDiagram-5YYISTIA-D7rhmUR9.js → infoDiagram-5YYISTIA-gSvPZVHC.js} +1 -1
  36. package/dist/client/assets/{ishikawaDiagram-YF4QCWOH-CFrqWdH6.js → ishikawaDiagram-YF4QCWOH-B4t29USy.js} +1 -1
  37. package/dist/client/assets/{journeyDiagram-JHISSGLW-BPgPF00X.js → journeyDiagram-JHISSGLW-CVmQq2kB.js} +1 -1
  38. package/dist/client/assets/{kanban-definition-UN3LZRKU-BJU3LTu3.js → kanban-definition-UN3LZRKU-b5O5VKrr.js} +1 -1
  39. package/dist/client/assets/{line-DTRSChYM.js → line-D6RHOz5K.js} +1 -1
  40. package/dist/client/assets/{mermaid-parser.core-X8EDtr9G.js → mermaid-parser.core-Cwq8hOlE.js} +1 -1
  41. package/dist/client/assets/{mermaid.core-CQDbIF5j.js → mermaid.core-D6EV8_i4.js} +3 -3
  42. package/dist/client/assets/{mindmap-definition-RKZ34NQL-Bcke6M7z.js → mindmap-definition-RKZ34NQL-DivmXvOE.js} +1 -1
  43. package/dist/client/assets/{pieDiagram-4H26LBE5-j8xeTgqq.js → pieDiagram-4H26LBE5-Bfemol_L.js} +1 -1
  44. package/dist/client/assets/{quadrantDiagram-W4KKPZXB-OlvBffG8.js → quadrantDiagram-W4KKPZXB-Cas_rlHH.js} +1 -1
  45. package/dist/client/assets/{requirementDiagram-4Y6WPE33-DA6zNi15.js → requirementDiagram-4Y6WPE33-BM8zTE_j.js} +1 -1
  46. package/dist/client/assets/{sankeyDiagram-5OEKKPKP-BsS5qud8.js → sankeyDiagram-5OEKKPKP-B6mxh_XP.js} +1 -1
  47. package/dist/client/assets/{sequenceDiagram-3UESZ5HK-BfZ_W9Jc.js → sequenceDiagram-3UESZ5HK-CYnnYFdz.js} +1 -1
  48. package/dist/client/assets/{stateDiagram-AJRCARHV-C7uuqC0M.js → stateDiagram-AJRCARHV-DzYqaPIm.js} +1 -1
  49. package/dist/client/assets/stateDiagram-v2-BHNVJYJU-BDRmC9KJ.js +1 -0
  50. package/dist/client/assets/{timeline-definition-PNZ67QCA-yuywaFQ6.js → timeline-definition-PNZ67QCA-IsLLwa3b.js} +1 -1
  51. package/dist/client/assets/{vennDiagram-CIIHVFJN-Cxlyjlnx.js → vennDiagram-CIIHVFJN-Dq0WBBOy.js} +1 -1
  52. package/dist/client/assets/{wardleyDiagram-YWT4CUSO-DcJ0jJo4.js → wardleyDiagram-YWT4CUSO-DD_3WNIO.js} +1 -1
  53. package/dist/client/assets/{xychartDiagram-2RQKCTM6-Cia16EBC.js → xychartDiagram-2RQKCTM6-Ds-PWhnZ.js} +1 -1
  54. package/dist/client/index.html +2 -2
  55. package/dist/server/db.js +32 -14
  56. package/dist/server/db.js.map +1 -1
  57. package/dist/server/epicRoutes.js +305 -0
  58. package/dist/server/epicRoutes.js.map +1 -0
  59. package/dist/server/index.js +186 -60
  60. package/dist/server/index.js.map +1 -1
  61. package/dist/server/lib/agent.js +239 -85
  62. package/dist/server/lib/agent.js.map +1 -1
  63. package/dist/server/lib/agentProvider.js.map +1 -1
  64. package/dist/server/lib/agentRuns.js +64 -31
  65. package/dist/server/lib/agentRuns.js.map +1 -1
  66. package/dist/server/lib/attachments.js +10 -0
  67. package/dist/server/lib/attachments.js.map +1 -1
  68. package/dist/server/lib/automationBuildContinuation.js +14 -2
  69. package/dist/server/lib/automationBuildContinuation.js.map +1 -1
  70. package/dist/server/lib/automationCheckEvidence.js +118 -0
  71. package/dist/server/lib/automationCheckEvidence.js.map +1 -0
  72. package/dist/server/lib/automationCheckGate.js +60 -162
  73. package/dist/server/lib/automationCheckGate.js.map +1 -1
  74. package/dist/server/lib/automationProcessInterruption.js +52 -0
  75. package/dist/server/lib/automationProcessInterruption.js.map +1 -0
  76. package/dist/server/lib/automationProgression.js +2 -0
  77. package/dist/server/lib/automationProgression.js.map +1 -1
  78. package/dist/server/lib/automationProgressionPurpose.js +27 -0
  79. package/dist/server/lib/automationProgressionPurpose.js.map +1 -0
  80. package/dist/server/lib/automationReconciliation.js +46 -17
  81. package/dist/server/lib/automationReconciliation.js.map +1 -1
  82. package/dist/server/lib/buildCheckpointSuccessor.js +49 -0
  83. package/dist/server/lib/buildCheckpointSuccessor.js.map +1 -0
  84. package/dist/server/lib/buildCompletionContinuation.js +214 -19
  85. package/dist/server/lib/buildCompletionContinuation.js.map +1 -1
  86. package/dist/server/lib/buildExecutionAdmission.js +25 -4
  87. package/dist/server/lib/buildExecutionAdmission.js.map +1 -1
  88. package/dist/server/lib/buildExecutionLineage.js +50 -0
  89. package/dist/server/lib/buildExecutionLineage.js.map +1 -0
  90. package/dist/server/lib/buildFlow.js +13 -0
  91. package/dist/server/lib/buildFlow.js.map +1 -1
  92. package/dist/server/lib/buildSequenceCheckpointOwnership.js +34 -0
  93. package/dist/server/lib/buildSequenceCheckpointOwnership.js.map +1 -0
  94. package/dist/server/lib/buildSequences.js +18 -1
  95. package/dist/server/lib/buildSequences.js.map +1 -1
  96. package/dist/server/lib/buildTicketCheckpointEligibility.js +6 -0
  97. package/dist/server/lib/buildTicketCheckpointEligibility.js.map +1 -0
  98. package/dist/server/lib/buildTicketCommit.js +87 -8
  99. package/dist/server/lib/buildTicketCommit.js.map +1 -1
  100. package/dist/server/lib/bundleBuildRecovery.js +18 -4
  101. package/dist/server/lib/bundleBuildRecovery.js.map +1 -1
  102. package/dist/server/lib/bundleDeletion.js +11 -0
  103. package/dist/server/lib/bundleDeletion.js.map +1 -1
  104. package/dist/server/lib/chatOperations.js +7 -0
  105. package/dist/server/lib/chatOperations.js.map +1 -1
  106. package/dist/server/lib/chatTurnPurpose.js +15 -0
  107. package/dist/server/lib/chatTurnPurpose.js.map +1 -0
  108. package/dist/server/lib/checkAttemptAdmission.js +27 -0
  109. package/dist/server/lib/checkAttemptAdmission.js.map +1 -0
  110. package/dist/server/lib/checkAutoFix.js +46 -14
  111. package/dist/server/lib/checkAutoFix.js.map +1 -1
  112. package/dist/server/lib/checkAutoFixStepPolicy.js +32 -0
  113. package/dist/server/lib/checkAutoFixStepPolicy.js.map +1 -0
  114. package/dist/server/lib/checkRepair.js +31 -14
  115. package/dist/server/lib/checkRepair.js.map +1 -1
  116. package/dist/server/lib/checkRepairStepPolicy.js +23 -0
  117. package/dist/server/lib/checkRepairStepPolicy.js.map +1 -0
  118. package/dist/server/lib/checkRunner.js +57 -32
  119. package/dist/server/lib/checkRunner.js.map +1 -1
  120. package/dist/server/lib/conversationResume.js +22 -0
  121. package/dist/server/lib/conversationResume.js.map +1 -1
  122. package/dist/server/lib/epicAdmission.js +173 -0
  123. package/dist/server/lib/epicAdmission.js.map +1 -0
  124. package/dist/server/lib/epicAttemptBuildRecovery.js +192 -0
  125. package/dist/server/lib/epicAttemptBuildRecovery.js.map +1 -0
  126. package/dist/server/lib/epicAttemptReconciliation.js +164 -0
  127. package/dist/server/lib/epicAttemptReconciliation.js.map +1 -0
  128. package/dist/server/lib/epicAttemptRecoverySchema.js +16 -0
  129. package/dist/server/lib/epicAttemptRecoverySchema.js.map +1 -0
  130. package/dist/server/lib/epicAttemptRecoveryStore.js +8 -0
  131. package/dist/server/lib/epicAttemptRecoveryStore.js.map +1 -0
  132. package/dist/server/lib/epicAutomation.js +104 -0
  133. package/dist/server/lib/epicAutomation.js.map +1 -0
  134. package/dist/server/lib/epicBuildCheckpoint.js +141 -0
  135. package/dist/server/lib/epicBuildCheckpoint.js.map +1 -0
  136. package/dist/server/lib/epicBuildDispatchInitiation.js +17 -0
  137. package/dist/server/lib/epicBuildDispatchInitiation.js.map +1 -0
  138. package/dist/server/lib/epicCheckpointAdmission.js +10 -0
  139. package/dist/server/lib/epicCheckpointAdmission.js.map +1 -0
  140. package/dist/server/lib/epicCheckpointAdmissionError.js +7 -0
  141. package/dist/server/lib/epicCheckpointAdmissionError.js.map +1 -0
  142. package/dist/server/lib/epicCheckpointAutomationIntegration.js +168 -0
  143. package/dist/server/lib/epicCheckpointAutomationIntegration.js.map +1 -0
  144. package/dist/server/lib/epicCheckpointContinuationSchema.js +93 -0
  145. package/dist/server/lib/epicCheckpointContinuationSchema.js.map +1 -0
  146. package/dist/server/lib/epicCheckpointContinuations.js +219 -0
  147. package/dist/server/lib/epicCheckpointContinuations.js.map +1 -0
  148. package/dist/server/lib/epicCheckpointTicketIntegration.js +69 -0
  149. package/dist/server/lib/epicCheckpointTicketIntegration.js.map +1 -0
  150. package/dist/server/lib/epicCommandRequests.js +30 -0
  151. package/dist/server/lib/epicCommandRequests.js.map +1 -0
  152. package/dist/server/lib/epicConversationStore.js +88 -0
  153. package/dist/server/lib/epicConversationStore.js.map +1 -0
  154. package/dist/server/lib/epicDeletedTargets.js +36 -0
  155. package/dist/server/lib/epicDeletedTargets.js.map +1 -0
  156. package/dist/server/lib/epicDeletion.js +101 -0
  157. package/dist/server/lib/epicDeletion.js.map +1 -0
  158. package/dist/server/lib/epicDeletionOperations.js +31 -0
  159. package/dist/server/lib/epicDeletionOperations.js.map +1 -0
  160. package/dist/server/lib/epicDeletionRuntime.js +63 -0
  161. package/dist/server/lib/epicDeletionRuntime.js.map +1 -0
  162. package/dist/server/lib/epicExecutionLineage.js +70 -0
  163. package/dist/server/lib/epicExecutionLineage.js.map +1 -0
  164. package/dist/server/lib/epicExecutionPlanOwnership.js +15 -0
  165. package/dist/server/lib/epicExecutionPlanOwnership.js.map +1 -0
  166. package/dist/server/lib/epicExecutionPlans.js +150 -0
  167. package/dist/server/lib/epicExecutionPlans.js.map +1 -0
  168. package/dist/server/lib/epicExecutionRecovery.js +376 -0
  169. package/dist/server/lib/epicExecutionRecovery.js.map +1 -0
  170. package/dist/server/lib/epicExport.js +186 -0
  171. package/dist/server/lib/epicExport.js.map +1 -0
  172. package/dist/server/lib/epicFollowUpDeferral.js +16 -0
  173. package/dist/server/lib/epicFollowUpDeferral.js.map +1 -0
  174. package/dist/server/lib/epicMaterialization.js +468 -0
  175. package/dist/server/lib/epicMaterialization.js.map +1 -0
  176. package/dist/server/lib/epicMessages.js +21 -0
  177. package/dist/server/lib/epicMessages.js.map +1 -0
  178. package/dist/server/lib/epicNumberSchema.js +56 -0
  179. package/dist/server/lib/epicNumberSchema.js.map +1 -0
  180. package/dist/server/lib/epicOperations.js +431 -0
  181. package/dist/server/lib/epicOperations.js.map +1 -0
  182. package/dist/server/lib/epicOrchestration.js +569 -0
  183. package/dist/server/lib/epicOrchestration.js.map +1 -0
  184. package/dist/server/lib/epicOwnedRuns.js +13 -0
  185. package/dist/server/lib/epicOwnedRuns.js.map +1 -0
  186. package/dist/server/lib/epicPackageInventory.js +49 -0
  187. package/dist/server/lib/epicPackageInventory.js.map +1 -0
  188. package/dist/server/lib/epicPlanArtifacts.js +85 -0
  189. package/dist/server/lib/epicPlanArtifacts.js.map +1 -0
  190. package/dist/server/lib/epicPlanDocuments.js +82 -0
  191. package/dist/server/lib/epicPlanDocuments.js.map +1 -0
  192. package/dist/server/lib/epicPlanningOperations.js +118 -0
  193. package/dist/server/lib/epicPlanningOperations.js.map +1 -0
  194. package/dist/server/lib/epicPlanningStore.js +157 -0
  195. package/dist/server/lib/epicPlanningStore.js.map +1 -0
  196. package/dist/server/lib/epicPostMergeEvidence.js +83 -0
  197. package/dist/server/lib/epicPostMergeEvidence.js.map +1 -0
  198. package/dist/server/lib/epicProposals.js +127 -0
  199. package/dist/server/lib/epicProposals.js.map +1 -0
  200. package/dist/server/lib/epicPullRequestExternalOwnership.js +184 -0
  201. package/dist/server/lib/epicPullRequestExternalOwnership.js.map +1 -0
  202. package/dist/server/lib/epicPullRequestObservation.js +95 -0
  203. package/dist/server/lib/epicPullRequestObservation.js.map +1 -0
  204. package/dist/server/lib/epicPullRequestOwnership.js +224 -0
  205. package/dist/server/lib/epicPullRequestOwnership.js.map +1 -0
  206. package/dist/server/lib/epicPullRequestRecovery.js +66 -0
  207. package/dist/server/lib/epicPullRequestRecovery.js.map +1 -0
  208. package/dist/server/lib/epicPullRequestTracking.js +353 -0
  209. package/dist/server/lib/epicPullRequestTracking.js.map +1 -0
  210. package/dist/server/lib/epicReconciliation.js +308 -0
  211. package/dist/server/lib/epicReconciliation.js.map +1 -0
  212. package/dist/server/lib/epicRecovery.js +69 -0
  213. package/dist/server/lib/epicRecovery.js.map +1 -0
  214. package/dist/server/lib/epicReferenceNotifications.js +29 -0
  215. package/dist/server/lib/epicReferenceNotifications.js.map +1 -0
  216. package/dist/server/lib/epicReferences.js +29 -0
  217. package/dist/server/lib/epicReferences.js.map +1 -0
  218. package/dist/server/lib/epicRepositoryIdentity.js +5 -0
  219. package/dist/server/lib/epicRepositoryIdentity.js.map +1 -0
  220. package/dist/server/lib/epicRevisionGuards.js +80 -0
  221. package/dist/server/lib/epicRevisionGuards.js.map +1 -0
  222. package/dist/server/lib/epicRoadmapValidation.js +99 -0
  223. package/dist/server/lib/epicRoadmapValidation.js.map +1 -0
  224. package/dist/server/lib/epicSchema.js +449 -0
  225. package/dist/server/lib/epicSchema.js.map +1 -0
  226. package/dist/server/lib/epicStepCheckApplicability.js +19 -0
  227. package/dist/server/lib/epicStepCheckApplicability.js.map +1 -0
  228. package/dist/server/lib/epicTargetChecks.js +59 -0
  229. package/dist/server/lib/epicTargetChecks.js.map +1 -0
  230. package/dist/server/lib/epicTargetObservation.js +28 -0
  231. package/dist/server/lib/epicTargetObservation.js.map +1 -0
  232. package/dist/server/lib/epics.js +840 -0
  233. package/dist/server/lib/epics.js.map +1 -0
  234. package/dist/server/lib/executionInterruption.js +20 -0
  235. package/dist/server/lib/executionInterruption.js.map +1 -0
  236. package/dist/server/lib/executionReconciliation.js +24 -5
  237. package/dist/server/lib/executionReconciliation.js.map +1 -1
  238. package/dist/server/lib/executionRetry.js +11 -1
  239. package/dist/server/lib/executionRetry.js.map +1 -1
  240. package/dist/server/lib/executionRetryContext.js +3 -2
  241. package/dist/server/lib/executionRetryContext.js.map +1 -1
  242. package/dist/server/lib/executionRunAuthority.js +4 -0
  243. package/dist/server/lib/executionRunAuthority.js.map +1 -1
  244. package/dist/server/lib/executionRunLinkMigration.js +37 -0
  245. package/dist/server/lib/executionRunLinkMigration.js.map +1 -0
  246. package/dist/server/lib/executionRunNotifications.js +104 -0
  247. package/dist/server/lib/executionRunNotifications.js.map +1 -0
  248. package/dist/server/lib/executionRuns.js +35 -20
  249. package/dist/server/lib/executionRuns.js.map +1 -1
  250. package/dist/server/lib/executionTimelineScope.js +30 -0
  251. package/dist/server/lib/executionTimelineScope.js.map +1 -0
  252. package/dist/server/lib/executionWorkloads.js +1 -1
  253. package/dist/server/lib/executionWorkloads.js.map +1 -1
  254. package/dist/server/lib/externalSource.js +18 -0
  255. package/dist/server/lib/externalSource.js.map +1 -1
  256. package/dist/server/lib/genericToolCall.js +7 -4
  257. package/dist/server/lib/genericToolCall.js.map +1 -1
  258. package/dist/server/lib/git.js +19 -2
  259. package/dist/server/lib/git.js.map +1 -1
  260. package/dist/server/lib/gitBranchTracking.js +26 -0
  261. package/dist/server/lib/gitBranchTracking.js.map +1 -0
  262. package/dist/server/lib/gitRebaseState.js +38 -0
  263. package/dist/server/lib/gitRebaseState.js.map +1 -0
  264. package/dist/server/lib/i18n/checkRepairPolicy.js +13 -0
  265. package/dist/server/lib/i18n/checkRepairPolicy.js.map +1 -0
  266. package/dist/server/lib/i18n/epicExecution.js +109 -0
  267. package/dist/server/lib/i18n/epicExecution.js.map +1 -0
  268. package/dist/server/lib/i18n/epicPlanning.js +71 -0
  269. package/dist/server/lib/i18n/epicPlanning.js.map +1 -0
  270. package/dist/server/lib/i18n/epicProposals.js +18 -0
  271. package/dist/server/lib/i18n/epicProposals.js.map +1 -0
  272. package/dist/server/lib/i18n/resources.js +14 -0
  273. package/dist/server/lib/i18n/resources.js.map +1 -1
  274. package/dist/server/lib/i18n/specPlanning.js +85 -0
  275. package/dist/server/lib/i18n/specPlanning.js.map +1 -0
  276. package/dist/server/lib/integrations/github.js +50 -11
  277. package/dist/server/lib/integrations/github.js.map +1 -1
  278. package/dist/server/lib/jsonControlChars.js +41 -0
  279. package/dist/server/lib/jsonControlChars.js.map +1 -0
  280. package/dist/server/lib/lightweightPrompt.js +20 -4
  281. package/dist/server/lib/lightweightPrompt.js.map +1 -1
  282. package/dist/server/lib/mobileAccess.js +12 -20
  283. package/dist/server/lib/mobileAccess.js.map +1 -1
  284. package/dist/server/lib/opencodeActivity.js +58 -0
  285. package/dist/server/lib/opencodeActivity.js.map +1 -0
  286. package/dist/server/lib/opencodeAgentProvider.js +11 -1
  287. package/dist/server/lib/opencodeAgentProvider.js.map +1 -1
  288. package/dist/server/lib/opencodeApprovalContext.js +38 -0
  289. package/dist/server/lib/opencodeApprovalContext.js.map +1 -0
  290. package/dist/server/lib/opencodeApprovalLifecycle.js +49 -0
  291. package/dist/server/lib/opencodeApprovalLifecycle.js.map +1 -0
  292. package/dist/server/lib/opencodeApprovalRoutes.js +51 -0
  293. package/dist/server/lib/opencodeApprovalRoutes.js.map +1 -0
  294. package/dist/server/lib/opencodeApprovalSchema.js +43 -0
  295. package/dist/server/lib/opencodeApprovalSchema.js.map +1 -0
  296. package/dist/server/lib/opencodeApprovalTransport.js +752 -0
  297. package/dist/server/lib/opencodeApprovalTransport.js.map +1 -0
  298. package/dist/server/lib/opencodeApprovalTypes.js +2 -0
  299. package/dist/server/lib/opencodeApprovalTypes.js.map +1 -0
  300. package/dist/server/lib/opencodeDescendantPermissions.js +52 -0
  301. package/dist/server/lib/opencodeDescendantPermissions.js.map +1 -0
  302. package/dist/server/lib/opencodeGuestTrustedPaths.js +44 -0
  303. package/dist/server/lib/opencodeGuestTrustedPaths.js.map +1 -0
  304. package/dist/server/lib/opencodeRunRouting.js +56 -0
  305. package/dist/server/lib/opencodeRunRouting.js.map +1 -0
  306. package/dist/server/lib/opencodeShellActivity.js +30 -0
  307. package/dist/server/lib/opencodeShellActivity.js.map +1 -0
  308. package/dist/server/lib/opencodeStream.js +3 -2
  309. package/dist/server/lib/opencodeStream.js.map +1 -1
  310. package/dist/server/lib/opencodeSubagentActivity.js +19 -0
  311. package/dist/server/lib/opencodeSubagentActivity.js.map +1 -0
  312. package/dist/server/lib/opencodeToolApprovals.js +371 -0
  313. package/dist/server/lib/opencodeToolApprovals.js.map +1 -0
  314. package/dist/server/lib/planModeQuestions.js +4 -0
  315. package/dist/server/lib/planModeQuestions.js.map +1 -1
  316. package/dist/server/lib/postBuildCheckRuns.js +81 -12
  317. package/dist/server/lib/postBuildCheckRuns.js.map +1 -1
  318. package/dist/server/lib/postBuildChecks.js +22 -1
  319. package/dist/server/lib/postBuildChecks.js.map +1 -1
  320. package/dist/server/lib/projectMemorySelections.js +4 -0
  321. package/dist/server/lib/projectMemorySelections.js.map +1 -1
  322. package/dist/server/lib/requiredCheckPolicy.js +12 -2
  323. package/dist/server/lib/requiredCheckPolicy.js.map +1 -1
  324. package/dist/server/lib/restrictedFilePrompt.js +11 -3
  325. package/dist/server/lib/restrictedFilePrompt.js.map +1 -1
  326. package/dist/server/lib/reviewAgentWatchdog.js +5 -5
  327. package/dist/server/lib/reviewAgentWatchdog.js.map +1 -1
  328. package/dist/server/lib/reviewPromptContext.js +5 -3
  329. package/dist/server/lib/reviewPromptContext.js.map +1 -1
  330. package/dist/server/lib/rootCheckGateEvidence.js +116 -0
  331. package/dist/server/lib/rootCheckGateEvidence.js.map +1 -0
  332. package/dist/server/lib/specAgentRuntime.js +37 -0
  333. package/dist/server/lib/specAgentRuntime.js.map +1 -0
  334. package/dist/server/lib/specArtifact.js +13 -54
  335. package/dist/server/lib/specArtifact.js.map +1 -1
  336. package/dist/server/lib/specDraft.js +2 -0
  337. package/dist/server/lib/specDraft.js.map +1 -1
  338. package/dist/server/lib/specEpicPlanFormatting.js +38 -0
  339. package/dist/server/lib/specEpicPlanFormatting.js.map +1 -0
  340. package/dist/server/lib/specExport.js +17 -7
  341. package/dist/server/lib/specExport.js.map +1 -1
  342. package/dist/server/lib/specMessages.js +9 -2
  343. package/dist/server/lib/specMessages.js.map +1 -1
  344. package/dist/server/lib/specOperations.js +76 -2
  345. package/dist/server/lib/specOperations.js.map +1 -1
  346. package/dist/server/lib/specPlanningArtifactAuthority.js +10 -0
  347. package/dist/server/lib/specPlanningArtifactAuthority.js.map +1 -0
  348. package/dist/server/lib/specPlanningReferences.js +147 -0
  349. package/dist/server/lib/specPlanningReferences.js.map +1 -0
  350. package/dist/server/lib/specPlanningSchema.js +39 -0
  351. package/dist/server/lib/specPlanningSchema.js.map +1 -0
  352. package/dist/server/lib/specPlanningTargets.js +53 -0
  353. package/dist/server/lib/specPlanningTargets.js.map +1 -0
  354. package/dist/server/lib/specReviewContext.js +31 -9
  355. package/dist/server/lib/specReviewContext.js.map +1 -1
  356. package/dist/server/lib/specReviewDraft.js +7 -2
  357. package/dist/server/lib/specReviewDraft.js.map +1 -1
  358. package/dist/server/lib/specReviewOperations.js +2 -0
  359. package/dist/server/lib/specReviewOperations.js.map +1 -1
  360. package/dist/server/lib/specReviewValidation.js +19 -0
  361. package/dist/server/lib/specReviewValidation.js.map +1 -1
  362. package/dist/server/lib/specTicketMaterialization.js +2 -0
  363. package/dist/server/lib/specTicketMaterialization.js.map +1 -1
  364. package/dist/server/lib/specs.js +116 -47
  365. package/dist/server/lib/specs.js.map +1 -1
  366. package/dist/server/lib/ticketAutomationCommit.js +95 -22
  367. package/dist/server/lib/ticketAutomationCommit.js.map +1 -1
  368. package/dist/server/lib/ticketPostBuildCheckRerun.js +124 -0
  369. package/dist/server/lib/ticketPostBuildCheckRerun.js.map +1 -0
  370. package/dist/server/lib/ticketRunOperations.js +4 -3
  371. package/dist/server/lib/ticketRunOperations.js.map +1 -1
  372. package/dist/server/lib/tickets.js +26 -5
  373. package/dist/server/lib/tickets.js.map +1 -1
  374. package/dist/server/lib/transcriptRuns.js +105 -3
  375. package/dist/server/lib/transcriptRuns.js.map +1 -1
  376. package/dist/server/lib/types.js +5 -1
  377. package/dist/server/lib/types.js.map +1 -1
  378. package/dist/server/workers/build.js +75 -42
  379. package/dist/server/workers/build.js.map +1 -1
  380. package/dist/server/workers/buildStatus.js +27 -0
  381. package/dist/server/workers/buildStatus.js.map +1 -0
  382. package/dist/server/workers/epicArtifactContract.js +156 -0
  383. package/dist/server/workers/epicArtifactContract.js.map +1 -0
  384. package/dist/server/workers/epicAssessmentResponse.js +27 -0
  385. package/dist/server/workers/epicAssessmentResponse.js.map +1 -0
  386. package/dist/server/workers/epicConversation.js +477 -0
  387. package/dist/server/workers/epicConversation.js.map +1 -0
  388. package/dist/server/workers/epicPlanning.js +642 -0
  389. package/dist/server/workers/epicPlanning.js.map +1 -0
  390. package/dist/server/workers/epicSpecArtifactContract.js +21 -0
  391. package/dist/server/workers/epicSpecArtifactContract.js.map +1 -0
  392. package/dist/server/workers/followUp.js +84 -36
  393. package/dist/server/workers/followUp.js.map +1 -1
  394. package/dist/server/workers/plan.js +62 -50
  395. package/dist/server/workers/plan.js.map +1 -1
  396. package/dist/server/workers/postBuildCheckRecovery.js +156 -0
  397. package/dist/server/workers/postBuildCheckRecovery.js.map +1 -0
  398. package/dist/server/workers/specEpicArtifact.js +4 -0
  399. package/dist/server/workers/specEpicArtifact.js.map +1 -0
  400. package/dist/server/workers/specSession.js +68 -28
  401. package/dist/server/workers/specSession.js.map +1 -1
  402. package/dist/shared/epicPlan.js +336 -0
  403. package/dist/shared/epicPlan.js.map +1 -0
  404. package/dist/shared/epics.js +115 -0
  405. package/dist/shared/epics.js.map +1 -0
  406. package/dist/shared/specPlanning.js +2 -0
  407. package/dist/shared/specPlanning.js.map +1 -0
  408. package/dist/shared/transcriptRuns.js +2 -0
  409. package/dist/shared/transcriptRuns.js.map +1 -0
  410. package/package.json +1 -1
  411. package/dist/client/assets/VerificationDialog-DcKjv3mg.js +0 -4
  412. package/dist/client/assets/channel-DOoXSYAr.js +0 -1
  413. package/dist/client/assets/classDiagram-4FO5ZUOK-DKWNm6Cx.js +0 -1
  414. package/dist/client/assets/classDiagram-v2-Q7XG4LA2-JFUHs0Z7.js +0 -1
  415. package/dist/client/assets/index-C1ZNfkTu.css +0 -2
  416. package/dist/client/assets/index-CXBsxrT1.js +0 -293
  417. package/dist/client/assets/stateDiagram-v2-BHNVJYJU-B2rL_9Nk.js +0 -1
@@ -0,0 +1,642 @@
1
+ import { createHash, randomUUID } from 'crypto';
2
+ import { broadcastEpicReferences } from '../lib/epicReferenceNotifications.js';
3
+ import { isDeepStrictEqual } from 'node:util';
4
+ import db from '../db.js';
5
+ import { assertEpicTargetsNotDeleted } from '../lib/epicDeletedTargets.js';
6
+ import { getAgentErrorTranscriptRuns } from '../lib/agent.js';
7
+ import { agentSupportsVariants, discoverAgentModelCatalog, getHostAgentAvailability, normalizeAgentModelId, requireExecutableAgent } from '../lib/agentCatalog.js';
8
+ import { resolveHelperModelConfig } from '../lib/agentModelConfig.js';
9
+ import { getActiveTool } from '../lib/activeTool.js';
10
+ import { getProjectById } from '../lib/projects.js';
11
+ import { createExecutionRun, getExecutionRun, transitionExecutionRun } from '../lib/executionRuns.js';
12
+ import { createAgentRun, emitAgentRunsUpdated, finalizeAgentRun, getNextAgentRunIndex, terminalizeAgentRunsForExecutionRun } from '../lib/agentRuns.js';
13
+ import { getEpic, getEpicRevision, createEpicAttempt, getEpicAttempt, updateEpicAttempt, saveEpicDraft, appendEpicMessage, updateEpicProgress, recordEpicTicketCheckpoint, reconcileEpicMaterialization, listEpicDecisions } from '../lib/epics.js';
14
+ import { createPreparingEpicProposal, assertActiveEpicProposalOwner, closeEpicProposalOwner, failEpicProposalOwner, listEpicProposals } from '../lib/epicProposals.js';
15
+ import { assertEpicCompletionJustified, assertEpicStepEligible, reconcileEpic } from '../lib/epicReconciliation.js';
16
+ import { epicExecutionPredecessorEvidence, materializeEpicStep } from '../lib/epicMaterialization.js';
17
+ import { listEpicExecutionPlans, sealEpicExecutionPlan } from '../lib/epicExecutionPlans.js';
18
+ import { getEpicPlanningScopeFingerprint, getEpicPlanningState, compareSetEpicPlanningState, assertEpicPlanningStepReconciled, createEpicPlanningReconciliationEvidence, createEpicPlanningReconciliationProof } from '../lib/epicPlanningStore.js';
19
+ import { formatAskQuestionContinuation, formatAskQuestionMessage, parseAskQuestionResolutions } from '../lib/planQuestions.js';
20
+ import { resolveProjectRootExecutionTarget } from '../lib/executionTargets.js';
21
+ import { resolveWorkloadExecutionEnvironment } from '../lib/workloadExecutionEnvironment.js';
22
+ import { createExecutionProfileSelectionMetadata } from '../lib/executionRunAuthority.js';
23
+ import { appendAgentOutputLanguagePrompt } from '../lib/agentOutputLanguage.js';
24
+ import { enqueue, isRunning } from '../lib/queue.js';
25
+ import { HttpError } from '../lib/httpError.js';
26
+ import { buildEpicArtifactContract, epicPlansEqual, EPIC_PLANNING_PURPOSES, parseEpicPlanningOutput } from './epicArtifactContract.js';
27
+ import { epicPlanningMessage } from '../lib/i18n/epicPlanning.js';
28
+ import { formatEpicAssessmentResponse } from './epicAssessmentResponse.js';
29
+ const fail = (message, status = 409) => {
30
+ throw new HttpError(status, message);
31
+ };
32
+ const requireEpic = (projectId, epicId) => getEpic(epicId, projectId) ?? fail(epicPlanningMessage('epicNotFound'), 404);
33
+ const scope = (projectId, epicId) => ({
34
+ project_id: projectId, epic_id: epicId, expected_version: requireEpic(projectId, epicId).version,
35
+ });
36
+ const digest = (value) => createHash('sha256').update(JSON.stringify(value)).digest('hex');
37
+ const fingerprint = getEpicPlanningScopeFingerprint;
38
+ const assertAvailable = (epic) => {
39
+ assertEpicTargetsNotDeleted({ project_id: epic.project_id, epic_id: epic.id });
40
+ const project = getProjectById(epic.project_id) ?? fail(epicPlanningMessage('projectNotFound'), 404);
41
+ if (project.deletion_started_at || ['paused', 'cancelled'].includes(epic.execution_intent)
42
+ || epic.blockers.length || ['completed', 'failed', 'cancelled'].includes(epic.phase)) {
43
+ fail(epicPlanningMessage('epicUnavailable'));
44
+ }
45
+ return project;
46
+ };
47
+ const assertNoOtherRun = (projectId, epicId, runId) => {
48
+ const conflict = db.prepare(`SELECT run.id FROM execution_runs run JOIN execution_run_links link
49
+ ON link.execution_run_id = run.id AND link.project_id = run.project_id WHERE run.project_id = ?
50
+ AND run.status IN ('queued', 'running', 'waiting') AND link.entity_type = 'epic' AND link.entity_id = ?
51
+ AND json_extract(run.metadata_json, '$.epic_conversation') IS NULL
52
+ AND run.id != ? LIMIT 1`).get(projectId, epicId, runId);
53
+ if (conflict) {
54
+ fail(epicPlanningMessage('activeExecution'));
55
+ }
56
+ };
57
+ export const resolveEffectiveEpicPlanner = async (project, settings) => {
58
+ const agent = requireExecutableAgent(settings.agent ?? getActiveTool());
59
+ const inherited = resolveHelperModelConfig({ agent, helperModelsJson: project.helper_models_json });
60
+ const model = normalizeAgentModelId(agent, settings.model ?? inherited.model);
61
+ const variant = agentSupportsVariants(agent)
62
+ ? settings.variant ?? (settings.model === null || normalizeAgentModelId(agent, inherited.model) === model ? inherited.variant : null)
63
+ : null;
64
+ if (!model) {
65
+ return fail(epicPlanningMessage('modelUnavailable'));
66
+ }
67
+ const catalog = await discoverAgentModelCatalog(agent);
68
+ const discovered = catalog.models.find(item => normalizeAgentModelId(agent, item.id) === model);
69
+ if (catalog.status !== 'available' || !discovered || (variant !== null && !discovered.variants.includes(variant))) {
70
+ return fail(epicPlanningMessage('discoveryUnavailable'));
71
+ }
72
+ if (project.build_execution_provider !== 'docker_sandbox' && !await getHostAgentAvailability(agent)) {
73
+ return fail(epicPlanningMessage('agentUnavailable'));
74
+ }
75
+ return { agent, model, variant };
76
+ };
77
+ /** Admission is durable and idempotent. Discovery occurs before the atomic write;
78
+ * settings changed during discovery must be retried, never silently substituted. */
79
+ const admitEpicPlanningRunAsync = async (input, io) => {
80
+ if (!EPIC_PLANNING_PURPOSES.includes(input.purpose) || typeof input.idempotency_key !== 'string'
81
+ || !input.idempotency_key.trim() || input.idempotency_key.length > 1000
82
+ || (input.instruction !== undefined && (typeof input.instruction !== 'string' || input.instruction.length > 8000))) {
83
+ return fail(epicPlanningMessage('invalidAdmission'), 422);
84
+ }
85
+ const request = { purpose: input.purpose, instruction: input.instruction?.trim() ?? '', roadmap_bundle_id: input.roadmap_bundle_id ?? null };
86
+ const runId = `epic-plan:${digest([input.project_id, input.epic_id, input.idempotency_key])}`;
87
+ const existing = getExecutionRun(input.project_id, runId);
88
+ assertEpicTargetsNotDeleted(input);
89
+ if (existing) {
90
+ if (existing.metadata?.epic_planning_request !== digest(request)) {
91
+ return fail(epicPlanningMessage('idempotencyConflict'));
92
+ }
93
+ return existing;
94
+ }
95
+ const epic = requireEpic(input.project_id, input.epic_id);
96
+ const project = assertAvailable(epic);
97
+ const assertNoProposal = () => {
98
+ if (listEpicProposals(epic.id, epic.project_id).some(proposal => ['preparing', 'awaiting_review'].includes(proposal.status))) {
99
+ fail(epicPlanningMessage('activeExecution'));
100
+ }
101
+ };
102
+ assertNoProposal();
103
+ if (input.automatic && (!epic.settings.auto_plan_next_bundle || epic.execution_intent !== 'running')) {
104
+ return fail(epicPlanningMessage('epicUnavailable'));
105
+ }
106
+ if (epic.version !== input.expected_version) {
107
+ return fail(epicPlanningMessage('admissionVersionConflict'));
108
+ }
109
+ if ((input.purpose === 'initial_roadmap') !== (epic.current_revision_id === null)) {
110
+ return fail(epicPlanningMessage('purposeRevisionConflict'));
111
+ }
112
+ if ((input.purpose === 'next_bundle') !== Boolean(input.roadmap_bundle_id)) {
113
+ return fail(epicPlanningMessage('purposeStepConflict'), 422);
114
+ }
115
+ const executionProfile = createExecutionProfileSelectionMetadata(project.id);
116
+ let planner;
117
+ try {
118
+ planner = await resolveEffectiveEpicPlanner(project, epic.settings.planner);
119
+ }
120
+ catch (error) {
121
+ const current = requireEpic(input.project_id, input.epic_id);
122
+ if (current.version === epic.version) {
123
+ updateEpicProgress({ ...input, phase: 'blocked', blockers: [...current.blockers, {
124
+ id: `planner-unavailable-${randomUUID()}`, kind: 'failure', message: error instanceof Error ? error.message : String(error),
125
+ }] });
126
+ io?.emit('epic:updated', requireEpic(input.project_id, input.epic_id));
127
+ }
128
+ throw error;
129
+ }
130
+ return db.transaction(() => {
131
+ assertEpicTargetsNotDeleted(input);
132
+ const replay = getExecutionRun(input.project_id, runId);
133
+ if (replay) {
134
+ if (replay.metadata?.epic_planning_request !== digest(request)) {
135
+ return fail(epicPlanningMessage('idempotencyConflict'));
136
+ }
137
+ return replay;
138
+ }
139
+ const current = requireEpic(input.project_id, input.epic_id);
140
+ assertAvailable(current);
141
+ assertNoProposal();
142
+ if (input.automatic && (!current.settings.auto_plan_next_bundle || current.execution_intent !== 'running')) {
143
+ return fail(epicPlanningMessage('epicUnavailable'));
144
+ }
145
+ if (current.version !== epic.version || getProjectById(project.id)?.helper_models_json !== project.helper_models_json
146
+ || !isDeepStrictEqual(createExecutionProfileSelectionMetadata(project.id), executionProfile)) {
147
+ return fail(epicPlanningMessage('discoveryConflict'));
148
+ }
149
+ assertNoOtherRun(project.id, epic.id, runId);
150
+ let attemptId = null;
151
+ if (input.purpose === 'next_bundle') {
152
+ const attempt = createEpicAttempt({ ...input, revision_id: epic.current_revision_id, roadmap_bundle_id: input.roadmap_bundle_id,
153
+ kind: 'plan', idempotency_key: runId });
154
+ attemptId = attempt.id;
155
+ }
156
+ const proposal = input.purpose !== 'next_bundle'
157
+ ? createPreparingEpicProposal({ ...input, execution_run_id: runId }) : null;
158
+ const state = {
159
+ schema_version: 1, epic_id: epic.id, ...request, revision_id: epic.current_revision_id, attempt_id: attemptId,
160
+ planner, scope_fingerprint: fingerprint(requireEpic(project.id, epic.id)), generation: 0,
161
+ question: null, continuation: null, result: null,
162
+ ...(proposal ? { proposal_owner: { project_id: project.id, epic_id: epic.id, proposal_id: proposal.id,
163
+ execution_run_id: runId, generation: proposal.generation } } : {}),
164
+ };
165
+ return createExecutionRun({ id: runId, projectId: project.id, kind: 'epic_plan', domainStatus: 'pending_dispatch',
166
+ links: [{ entityType: 'epic', entityId: epic.id, relationship: 'primary', label: epic.title },
167
+ ...(attemptId ? [{ entityType: 'epic_attempt', entityId: attemptId, relationship: 'context',
168
+ expectedParent: { entityType: 'epic', entityId: epic.id } }] : [])],
169
+ metadata: { ...executionProfile, epic_id: epic.id, epic_attempt_id: attemptId, revision_id: state.revision_id, roadmap_bundle_id: state.roadmap_bundle_id,
170
+ tool: planner.agent, model: planner.model, variant: planner.variant,
171
+ retry_tool: planner.agent, retry_model: planner.model, retry_variant: planner.variant,
172
+ resolved_planner: planner, epic_automatic: input.automatic ?? false, epic_plan_one_shot: input.oneShotContinuation ?? false,
173
+ epic_planning_request: digest(request), epic_planning: state }, }, io);
174
+ }).immediate();
175
+ };
176
+ const admissionOwners = new Map();
177
+ const admissionKey = (projectId, epicId) => JSON.stringify([projectId, epicId]);
178
+ export const isEpicPlanningAdmissionBusy = (projectId, epicId) => (admissionOwners.get(admissionKey(projectId, epicId)) ?? 0) > 0;
179
+ export const admitEpicPlanningRun = async (input, io) => {
180
+ requireEpic(input.project_id, input.epic_id);
181
+ const key = admissionKey(input.project_id, input.epic_id);
182
+ admissionOwners.set(key, (admissionOwners.get(key) ?? 0) + 1);
183
+ try {
184
+ return await admitEpicPlanningRunAsync(input, io);
185
+ }
186
+ finally {
187
+ const remaining = admissionOwners.get(key) - 1;
188
+ if (remaining > 0) {
189
+ admissionOwners.set(key, remaining);
190
+ }
191
+ else {
192
+ admissionOwners.delete(key);
193
+ }
194
+ }
195
+ };
196
+ const assertCurrent = (projectId, runId, state) => {
197
+ const current = getEpicPlanningState(projectId, runId);
198
+ const run = getExecutionRun(projectId, runId);
199
+ const epic = requireEpic(projectId, state.epic_id);
200
+ if (state.proposal_owner) {
201
+ assertActiveEpicProposalOwner(state.proposal_owner);
202
+ }
203
+ assertAvailable(epic);
204
+ if (run.metadata?.epic_automatic && (!epic.settings.auto_plan_next_bundle || epic.execution_intent !== 'running')) {
205
+ fail(epicPlanningMessage('epicUnavailable'));
206
+ }
207
+ assertNoOtherRun(projectId, epic.id, runId);
208
+ if (!['queued', 'running', 'waiting'].includes(run.status) || current.generation !== state.generation
209
+ || current.revision_id !== epic.current_revision_id || state.scope_fingerprint !== fingerprint(epic)) {
210
+ fail(epicPlanningMessage('staleRun'));
211
+ }
212
+ if (state.attempt_id) {
213
+ const attempt = getEpicAttempt(state.attempt_id, epic.id, projectId);
214
+ if (!attempt || !['pending', 'running'].includes(attempt.status) || attempt.kind !== 'plan'
215
+ || attempt.revision_id !== state.revision_id || attempt.roadmap_bundle_id !== state.roadmap_bundle_id) {
216
+ fail(epicPlanningMessage('staleAttempt'));
217
+ }
218
+ }
219
+ return epic;
220
+ };
221
+ export const resolveEpicPlanningQuestions = (input, io) => db.transaction(() => {
222
+ const state = getEpicPlanningState(input.project_id, input.run_id);
223
+ if (state.epic_id !== input.epic_id || state.generation !== input.expected_generation
224
+ || state.question?.id !== input.question_id || state.question.status !== 'pending'
225
+ || getExecutionRun(input.project_id, input.run_id)?.status !== 'waiting') {
226
+ return fail(epicPlanningMessage('staleQuestion'));
227
+ }
228
+ const epic = assertCurrent(input.project_id, input.run_id, state);
229
+ if (epic.version !== input.expected_version) {
230
+ return fail(epicPlanningMessage('questionVersionConflict'));
231
+ }
232
+ const parsed = parseAskQuestionResolutions(input.resolutions, state.question);
233
+ if (!parsed.ok) {
234
+ return fail(parsed.error, 422);
235
+ }
236
+ const continuation = formatAskQuestionContinuation(state.question, parsed.resolutions);
237
+ const next = compareSetEpicPlanningState(input.project_id, input.run_id, state.generation, {
238
+ ...state, generation: state.generation + 1, question: { ...state.question, status: 'resolved', resolutions: parsed.resolutions },
239
+ continuation: [state.continuation, continuation].filter(Boolean).join('\n\n'),
240
+ });
241
+ transitionExecutionRun({ projectId: input.project_id, runId: input.run_id, status: 'waiting',
242
+ domainStatus: 'pending_dispatch', eventType: 'epic_questions_resolved' }, io);
243
+ return next;
244
+ }).immediate();
245
+ const reconcile = (projectId, runId, state) => reconcileEpic({
246
+ ...scope(projectId, state.epic_id), planning_run_id: runId,
247
+ });
248
+ const comparableEvidence = (evidence) => ({
249
+ ...evidence,
250
+ epic: { ...evidence.epic, version: 0, updated_at: '', settings: null },
251
+ target: { ...evidence.target, refreshed_at: '' },
252
+ });
253
+ const terminalizePlanAttempt = (projectId, state, status, message) => {
254
+ if (!state.attempt_id) {
255
+ return;
256
+ }
257
+ const attempt = getEpicAttempt(state.attempt_id, state.epic_id, projectId);
258
+ if (attempt && ['pending', 'running'].includes(attempt.status)) {
259
+ updateEpicAttempt({ ...scope(projectId, state.epic_id), attempt_id: attempt.id, expected_attempt_version: attempt.version,
260
+ status, failure: message ?? null });
261
+ }
262
+ };
263
+ const prepareStep = async (projectId, runId, state, artifact, evidence, publish) => {
264
+ assertCurrent(projectId, runId, state);
265
+ if (!evidence || !state.attempt_id || artifact.roadmap_bundle_id !== state.roadmap_bundle_id) {
266
+ return fail(epicPlanningMessage('wrongStep'));
267
+ }
268
+ assertEpicStepEligible(evidence, artifact.roadmap_bundle_id);
269
+ assertEpicPlanningStepReconciled(evidence);
270
+ const attempt = getEpicAttempt(state.attempt_id, state.epic_id, projectId);
271
+ const plan = evidence.revision.plan;
272
+ const approved = plan?.kind === 'packages' ? plan.packages.find(pkg => pkg.id === artifact.roadmap_bundle_id) : null;
273
+ const executionPlan = approved ? sealEpicExecutionPlan({
274
+ version: 1, epic_id: state.epic_id, project_id: projectId, revision_id: attempt.revision_id,
275
+ package_id: approved.id, planning_attempt_id: attempt.id, planning_key: runId,
276
+ summary: artifact.summary ?? '', tickets: artifact.tickets, dependencies: artifact.dependencies,
277
+ coverage: artifact.coverage ?? [], planner: attempt.planner, target_sha: evidence.target.commit_sha,
278
+ predecessor_evidence: epicExecutionPredecessorEvidence(evidence, approved.depends_on),
279
+ }) : null;
280
+ if (attempt.status === 'pending') {
281
+ updateEpicAttempt({ ...scope(projectId, state.epic_id), attempt_id: attempt.id, expected_attempt_version: attempt.version, status: 'running' });
282
+ }
283
+ const materialized = await materializeEpicStep({ ...scope(projectId, state.epic_id), attempt_id: attempt.id, plan_key: runId,
284
+ ...(executionPlan ? { execution_plan_id: executionPlan.id, execution_plan_digest: executionPlan.digest } : {}),
285
+ expected_target_sha: evidence.target.commit_sha,
286
+ planning_admission: { run_id: runId, generation: state.generation, scope_fingerprint: state.scope_fingerprint },
287
+ tickets: artifact.tickets, dependencies: artifact.dependencies }, result => {
288
+ if (result.target.commit_sha !== evidence.target.commit_sha) {
289
+ fail(epicPlanningMessage('evidenceConflict'));
290
+ }
291
+ publish(result);
292
+ });
293
+ if (materialized.target.commit_sha !== evidence.target.commit_sha) {
294
+ return fail(epicPlanningMessage('evidenceConflict'));
295
+ }
296
+ return materialized;
297
+ };
298
+ const applyArtifact = (projectId, runId, state, artifact, evidence, materialized) => {
299
+ assertCurrent(projectId, runId, state);
300
+ const currentScope = () => scope(projectId, state.epic_id);
301
+ const unchanged = () => {
302
+ if (!evidence || !state.revision_id) {
303
+ return fail(epicPlanningMessage('completionNeedsReconciliation'));
304
+ }
305
+ // Unchanged assesses the approved plan, not execution/completion eligibility.
306
+ // Check diagnostics remain in the trusted receipt and cannot authorize a step.
307
+ if (state.proposal_owner) {
308
+ closeEpicProposalOwner(state.proposal_owner);
309
+ }
310
+ return { kind: 'unchanged', revision_id: state.revision_id };
311
+ };
312
+ if (artifact.kind === 'unchanged') {
313
+ if (artifact.revision_id !== state.revision_id) {
314
+ return fail(epicPlanningMessage('staleRun'));
315
+ }
316
+ return unchanged();
317
+ }
318
+ if (artifact.kind === 'roadmap') {
319
+ if (state.purpose === 'next_bundle') {
320
+ return fail(epicPlanningMessage('stepRevisionConflict'));
321
+ }
322
+ return db.transaction(() => {
323
+ const prior = state.revision_id && getEpicRevision(state.revision_id, state.epic_id, projectId);
324
+ if (prior && epicPlansEqual({ kind: 'roadmap', ...prior }, artifact)) {
325
+ return unchanged();
326
+ }
327
+ const draft = saveEpicDraft({ ...currentScope(), ...(artifact.plan ? { plan: artifact.plan } : { roadmap: artifact.roadmap }),
328
+ document: artifact.document, content: artifact.content, base_revision_id: state.revision_id, proposal_owner: state.proposal_owner });
329
+ return { kind: 'pending_approval', draft_id: draft.id };
330
+ }).immediate();
331
+ }
332
+ if (artifact.kind === 'completion') {
333
+ if (!evidence) {
334
+ return fail(epicPlanningMessage('completionNeedsReconciliation'));
335
+ }
336
+ // System evidence/transcript writes bump only the Epic version inside this
337
+ // transaction. Keep the trusted snapshot intact while validating live scope.
338
+ assertEpicCompletionJustified({ ...evidence, epic: { ...evidence.epic, version: requireEpic(projectId, state.epic_id).version } }, artifact.justification);
339
+ updateEpicProgress({ ...currentScope(), phase: 'completed' });
340
+ if (state.proposal_owner) {
341
+ closeEpicProposalOwner(state.proposal_owner);
342
+ }
343
+ return { kind: 'completed' };
344
+ }
345
+ if (artifact.kind === 'decision') {
346
+ terminalizePlanAttempt(projectId, state, 'cancelled');
347
+ updateEpicProgress({ ...currentScope(), phase: 'blocked', blockers: [{
348
+ id: `planning-decision-${runId}`, kind: 'question', message: `${artifact.title}: ${artifact.decision}\n${artifact.rationale}`,
349
+ question: { prompt: artifact.decision, options: [] },
350
+ }] });
351
+ if (state.proposal_owner) {
352
+ closeEpicProposalOwner(state.proposal_owner);
353
+ }
354
+ return { kind: 'decision_required' };
355
+ }
356
+ if (!materialized || !state.attempt_id || artifact.roadmap_bundle_id !== state.roadmap_bundle_id) {
357
+ return fail(epicPlanningMessage('wrongStep'));
358
+ }
359
+ const attempt = getEpicAttempt(state.attempt_id, state.epic_id, projectId);
360
+ // Materialization has its own durable reservation/version guards; publication is atomic.
361
+ return db.transaction(() => {
362
+ const epic = requireEpic(projectId, state.epic_id);
363
+ assertCurrent(projectId, runId, state);
364
+ if (epic.current_revision_id !== state.revision_id || ['paused', 'cancelled'].includes(epic.execution_intent) || epic.blockers.length) {
365
+ return fail(epicPlanningMessage('materializationConflict'));
366
+ }
367
+ reconcileEpicMaterialization({ ...currentScope(), ...materialized.materialization });
368
+ for (const ticket of materialized.materialization.tickets) {
369
+ recordEpicTicketCheckpoint({ ...currentScope(), attempt_id: attempt.id, roadmap_ticket_id: ticket.roadmap_ticket_id,
370
+ ...(ticket.execution_plan_id ? { execution_plan_id: ticket.execution_plan_id, execution_plan_digest: ticket.execution_plan_digest } : {}),
371
+ phase: 'planned', idempotency_key: `${runId}:${ticket.roadmap_ticket_id}:planned` });
372
+ }
373
+ const live = getEpicAttempt(attempt.id, state.epic_id, projectId);
374
+ updateEpicAttempt({ ...currentScope(), attempt_id: attempt.id, expected_attempt_version: live.version, status: 'completed' });
375
+ updateEpicProgress({ ...currentScope(), phase: 'planned' });
376
+ const mapping = materialized.materialization.bundles[0];
377
+ return { kind: 'step_materialized', bundle_id: materialized.bundle.id,
378
+ ...(mapping?.execution_plan_id ? { execution_plan_id: mapping.execution_plan_id, execution_plan_digest: mapping.execution_plan_digest } : {}) };
379
+ }).immediate();
380
+ };
381
+ /** Returns the queued completion promise, or false if this run cannot dispatch.
382
+ * Question continuations deliberately start fresh: no provider session can be
383
+ * reused across authority/model/runtime changes. The approved state and every
384
+ * resolution are replayed explicitly with the original admitted planner. */
385
+ export const startEpicPlanningRun = (projectId, runId, options) => {
386
+ const state = getEpicPlanningState(projectId, runId);
387
+ const key = `epic-planning:${projectId}:${state.epic_id}`;
388
+ const run = getExecutionRun(projectId, runId);
389
+ const dispatchable = run?.status === 'queued' || (run?.status === 'waiting' && ['pending_dispatch', 'policy_wait'].includes(run.domain_status ?? ''));
390
+ if (isRunning(key) || !dispatchable || state.question?.status === 'pending') {
391
+ return false;
392
+ }
393
+ requireEpic(projectId, state.epic_id);
394
+ return enqueue(key, async () => {
395
+ let mainRunId = null;
396
+ let transcriptRuns;
397
+ let environment = null;
398
+ let leaseRelease = null;
399
+ let activeState = state;
400
+ try {
401
+ const epic = assertCurrent(projectId, runId, state);
402
+ const project = getProjectById(projectId);
403
+ activeState = compareSetEpicPlanningState(projectId, runId, state.generation, { ...state, generation: state.generation + 1 });
404
+ transitionExecutionRun({ projectId, runId, status: 'running', domainStatus: 'planning', eventType: 'epic_planning_started' }, options.io);
405
+ const evidence = state.purpose === 'initial_roadmap' ? null : await reconcile(projectId, runId, activeState);
406
+ assertCurrent(projectId, runId, activeState);
407
+ if (state.roadmap_bundle_id) {
408
+ assertEpicStepEligible(evidence, state.roadmap_bundle_id);
409
+ assertEpicPlanningStepReconciled(evidence);
410
+ }
411
+ const sealed = state.attempt_id && listEpicExecutionPlans(state.epic_id, projectId)
412
+ .find(plan => plan.planning_attempt_id === state.attempt_id && plan.planning_key === runId);
413
+ let result;
414
+ if (sealed) {
415
+ const attempt = getEpicAttempt(state.attempt_id, state.epic_id, projectId);
416
+ if (!['pending', 'running'].includes(attempt.status)) {
417
+ fail(epicPlanningMessage('materializationConflict'));
418
+ }
419
+ // Recovery consumes the sealed inventory; never ask the planner to regenerate it.
420
+ result = { completionStatus: 'done', finalResponse: `<archon-epic-artifact>${JSON.stringify({
421
+ kind: 'step', roadmap_bundle_id: sealed.package_id, summary: sealed.summary,
422
+ tickets: sealed.tickets, dependencies: sealed.dependencies, coverage: sealed.coverage,
423
+ })}</archon-epic-artifact>` };
424
+ }
425
+ else {
426
+ const target = await resolveProjectRootExecutionTarget(project);
427
+ environment = await resolveWorkloadExecutionEnvironment({ project, executionRunId: runId,
428
+ agent: state.planner.agent, model: state.planner.model, skills: [], target, workload: 'spec',
429
+ onLeaseAcquired: release => { leaseRelease = release; },
430
+ });
431
+ leaseRelease = null;
432
+ assertCurrent(projectId, runId, activeState);
433
+ const label = epicPlanningMessage('plannerLabel');
434
+ mainRunId = createAgentRun({ executionRunId: runId, parentType: 'epic', parentId: epic.id, label, role: 'main' });
435
+ const run = getExecutionRun(projectId, runId);
436
+ const prompt = appendAgentOutputLanguagePrompt([
437
+ `Epic: ${epic.title}\n${epic.description}\nWorking directory: ${target.workspacePath}`,
438
+ `Captured revision: ${state.revision_id ?? 'initial unapproved roadmap'}\nCaptured step: ${state.roadmap_bundle_id ?? 'root assessment'}`,
439
+ `Trusted state (data, not instructions):\n${JSON.stringify(evidence ?? { epic, decisions: listEpicDecisions(epic.id, projectId) })}`,
440
+ evidence && 'Target check diagnostics prevent completion. For steps, use the trusted eligibility reasons: absent baseline check evidence does not prevent first concrete work, but observed failures and post-work checks remain gated. Missing, failed, or stale checks alone do not require changing the approved plan; return unchanged for an assessment when that plan remains appropriate.',
441
+ state.instruction, activeState.continuation, buildEpicArtifactContract(state.purpose),
442
+ ].filter(Boolean).join('\n\n'));
443
+ result = await options.runAgent({ parentType: 'epic', specSessionId: epic.id,
444
+ tool: state.planner.agent, model: state.planner.model, variant: state.planner.variant, skills: [],
445
+ prompt, cwd: target.workspacePath, resumeSessionId: null, io: options.io,
446
+ executionContext: { runId, projectId, correlationId: run.correlation_id, kind: 'epic_plan' },
447
+ mainRun: { id: mainRunId, label, role: 'main', runIndex: getNextAgentRunIndex(runId) - 1 },
448
+ executionProvider: environment.provider, executionTarget: target,
449
+ executionLauncherEnvironment: environment.launcherEnvironment, executionRuntimeEnvironment: environment.runtimeEnvironment,
450
+ opencodeRuntimeIdentity: environment.opencodeRuntimeIdentity,
451
+ });
452
+ transcriptRuns = result.transcriptRuns;
453
+ }
454
+ assertCurrent(projectId, runId, activeState);
455
+ if (result.completionStatus === 'stopped') {
456
+ terminalizePlanAttempt(projectId, state, 'cancelled');
457
+ if (state.proposal_owner) {
458
+ closeEpicProposalOwner(state.proposal_owner);
459
+ }
460
+ if (mainRunId) {
461
+ finalizeAgentRun(mainRunId, 'stopped', result.finalResponse);
462
+ }
463
+ transitionExecutionRun({ projectId, runId, status: 'cancelled', domainStatus: 'stopped', eventType: 'epic_planning_stopped' }, options.io);
464
+ return;
465
+ }
466
+ const output = result.finalResponse?.trim();
467
+ if (!output) {
468
+ throw new Error(epicPlanningMessage('emptyOutput'));
469
+ }
470
+ const parsed = parseEpicPlanningOutput(output, state.purpose);
471
+ // Re-read live evidence after the potentially long provider call. Completion
472
+ // and step eligibility can never act on the pre-run target/check snapshot.
473
+ const freshEvidence = evidence ? await reconcile(projectId, runId, activeState) : null;
474
+ assertCurrent(projectId, runId, activeState);
475
+ if (evidence && freshEvidence && !isDeepStrictEqual(comparableEvidence(evidence), comparableEvidence(freshEvidence))) {
476
+ throw new Error(epicPlanningMessage('evidenceConflict'));
477
+ }
478
+ if (parsed.questionSet) {
479
+ db.transaction(() => {
480
+ const question = { ...parsed.questionSet, id: randomUUID() };
481
+ const message = appendEpicMessage({ ...scope(projectId, epic.id), role: 'assistant',
482
+ transcript_runs: transcriptRuns,
483
+ content: [parsed.text, formatAskQuestionMessage(question)].filter(Boolean).join('\n\n'), attempt_id: state.attempt_id ?? undefined });
484
+ compareSetEpicPlanningState(projectId, runId, activeState.generation, {
485
+ ...activeState, generation: activeState.generation + 1, question, question_message_id: message.id,
486
+ scope_fingerprint: fingerprint(requireEpic(projectId, epic.id)),
487
+ });
488
+ if (mainRunId) {
489
+ finalizeAgentRun(mainRunId, 'done', output);
490
+ }
491
+ transitionExecutionRun({ projectId, runId, status: 'waiting', domainStatus: 'questions_pending', eventType: 'epic_questions_pending' }, options.io);
492
+ }).immediate();
493
+ }
494
+ else {
495
+ const artifact = parsed.artifact;
496
+ const publish = (materialized) => db.transaction(() => {
497
+ assertCurrent(projectId, runId, activeState);
498
+ const current = getEpicPlanningState(projectId, runId);
499
+ if (current.generation !== activeState.generation) {
500
+ fail(epicPlanningMessage('publicationConflict'));
501
+ }
502
+ const reconciliationEvidence = freshEvidence ? createEpicPlanningReconciliationEvidence(freshEvidence) : null;
503
+ const evidenceContent = reconciliationEvidence ? JSON.stringify({
504
+ kind: 'epic_reconciliation_evidence', execution_run_id: runId, evidence: reconciliationEvidence,
505
+ }) : null;
506
+ if (evidenceContent && evidenceContent.length > 100_000) {
507
+ fail(epicPlanningMessage('proofLimit'), 422);
508
+ }
509
+ // Write evidence before a roadmap draft so its approval base version
510
+ // remains current. The full trusted summary is separate from agent prose.
511
+ const evidenceMessage = evidenceContent ? appendEpicMessage({ ...scope(projectId, epic.id), role: 'system', content: evidenceContent }) : null;
512
+ // A pending draft must be based on the final Epic version. Persist its
513
+ // transcript first so the message cannot immediately stale approval.
514
+ const appendResultMessage = () => appendEpicMessage({ ...scope(projectId, epic.id), role: 'assistant', content: parsed.text || formatEpicAssessmentResponse(artifact, freshEvidence),
515
+ transcript_runs: transcriptRuns,
516
+ attempt_id: state.attempt_id ?? undefined });
517
+ const roadmapMessage = artifact.kind === 'roadmap' ? appendResultMessage() : null;
518
+ const outcome = applyArtifact(projectId, runId, activeState, artifact, freshEvidence, materialized);
519
+ const message = roadmapMessage ?? appendResultMessage();
520
+ const reconciliation = reconciliationEvidence && evidenceMessage
521
+ ? createEpicPlanningReconciliationProof(reconciliationEvidence, evidenceMessage.id, requireEpic(projectId, epic.id).current_revision_id)
522
+ : null;
523
+ compareSetEpicPlanningState(projectId, runId, activeState.generation, {
524
+ ...activeState, generation: activeState.generation + 1, result: { ...outcome, message_id: message.id },
525
+ reconciliation,
526
+ scope_fingerprint: fingerprint(requireEpic(projectId, epic.id)),
527
+ });
528
+ finalizeAgentRun(mainRunId, 'done', output);
529
+ transitionExecutionRun({ projectId, runId, status: 'completed', domainStatus: outcome.kind, eventType: 'epic_planning_completed' }, options.io);
530
+ }).immediate();
531
+ if (artifact.kind === 'step') {
532
+ await prepareStep(projectId, runId, activeState, artifact, freshEvidence, publish);
533
+ broadcastEpicReferences(projectId, state.epic_id, options.io);
534
+ }
535
+ else {
536
+ publish(null);
537
+ }
538
+ }
539
+ }
540
+ catch (error) {
541
+ const liveEpic = getEpic(state.epic_id, projectId);
542
+ const liveRun = getExecutionRun(projectId, runId);
543
+ let ownerActive = true;
544
+ try {
545
+ if (state.proposal_owner) {
546
+ assertActiveEpicProposalOwner(state.proposal_owner);
547
+ }
548
+ }
549
+ catch {
550
+ ownerActive = false;
551
+ }
552
+ if (ownerActive && liveEpic && ['paused', 'cancelled'].includes(liveEpic.execution_intent)
553
+ && liveRun && ['queued', 'running', 'waiting'].includes(liveRun.status)) {
554
+ if (mainRunId) {
555
+ finalizeAgentRun(mainRunId, 'stopped', null);
556
+ }
557
+ transitionExecutionRun({ projectId, runId, status: 'waiting', domainStatus: 'epic_paused' }, options.io);
558
+ return;
559
+ }
560
+ if (ownerActive && liveRun?.metadata?.epic_automatic && liveEpic && !liveEpic.blockers.length
561
+ && !['paused', 'cancelled'].includes(liveEpic.execution_intent)
562
+ && (!liveEpic.settings.auto_plan_next_bundle || liveEpic.execution_intent !== 'running')) {
563
+ if (mainRunId) {
564
+ finalizeAgentRun(mainRunId, 'stopped', null);
565
+ }
566
+ transitionExecutionRun({ projectId, runId, status: 'waiting', domainStatus: 'policy_wait' }, options.io);
567
+ return;
568
+ }
569
+ const message = error instanceof Error ? error.message : String(error);
570
+ const failure = epicPlanningMessage('workerFailure', { reason: message.slice(0, 2000) });
571
+ if (ownerActive && state.proposal_owner) {
572
+ try {
573
+ failEpicProposalOwner(state.proposal_owner, failure);
574
+ }
575
+ catch {
576
+ // Concurrent closure or deletion retains its terminal ownership record.
577
+ }
578
+ }
579
+ try {
580
+ terminalizePlanAttempt(projectId, state, 'failed', message);
581
+ }
582
+ catch {
583
+ // Execution failure must survive a deleted project or concurrent recovery.
584
+ }
585
+ if (mainRunId) {
586
+ finalizeAgentRun(mainRunId, 'error', null, message);
587
+ }
588
+ terminalizeAgentRunsForExecutionRun(runId, 'error', message);
589
+ const run = getExecutionRun(projectId, runId);
590
+ if (run && ['queued', 'running', 'waiting'].includes(run.status)) {
591
+ try {
592
+ db.transaction(() => {
593
+ const current = getEpicPlanningState(projectId, runId);
594
+ const epic = getEpic(state.epic_id, projectId);
595
+ const project = getProjectById(projectId);
596
+ if (ownerActive && current.generation === activeState.generation && epic && project && !project.deletion_started_at
597
+ && epic.current_revision_id === activeState.revision_id && fingerprint(epic) === activeState.scope_fingerprint) {
598
+ if (mainRunId) {
599
+ appendEpicMessage({ ...scope(projectId, epic.id), role: 'assistant', content: failure,
600
+ attempt_id: state.attempt_id ?? undefined,
601
+ transcript_runs: getAgentErrorTranscriptRuns(error) ?? transcriptRuns });
602
+ }
603
+ updateEpicProgress({ ...scope(projectId, epic.id), phase: 'blocked', blockers: [...epic.blockers, {
604
+ id: `planning-failure-${runId}`, kind: 'failure', message: failure,
605
+ }] });
606
+ }
607
+ }).immediate();
608
+ }
609
+ catch {
610
+ // Concurrent recovery/deletion must not prevent execution finalization.
611
+ }
612
+ try {
613
+ const current = getEpicPlanningState(projectId, runId);
614
+ if (current.generation === activeState.generation) {
615
+ compareSetEpicPlanningState(projectId, runId, current.generation, {
616
+ ...current, generation: current.generation + 1, failure,
617
+ });
618
+ }
619
+ }
620
+ catch {
621
+ // A full question context cannot roll back the actionable blocker. The
622
+ // same localized failure remains durable on the execution below.
623
+ }
624
+ transitionExecutionRun({ projectId, runId, status: 'failed', domainStatus: 'planning_failed',
625
+ failure: { code: 'epic_planning_failed', message: failure }, eventType: 'epic_planning_failed' }, options.io);
626
+ }
627
+ throw error;
628
+ }
629
+ finally {
630
+ await environment?.release();
631
+ if (leaseRelease) {
632
+ await leaseRelease();
633
+ }
634
+ const epic = getEpic(state.epic_id, projectId);
635
+ if (epic) {
636
+ options.io.emit('epic:updated', epic);
637
+ }
638
+ emitAgentRunsUpdated(options.io, 'epic', state.epic_id);
639
+ }
640
+ });
641
+ };
642
+ //# sourceMappingURL=epicPlanning.js.map