@straiffi/archon 1.11.16 → 1.12.1

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