@straiffi/archon 1.13.3 → 1.13.4

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 (436) hide show
  1. package/README.md +15 -0
  2. package/dist/client/assets/{ConversationMarkdown-D8iVeRE1.js → ConversationMarkdown-DzASmN5F.js} +3 -3
  3. package/dist/client/assets/{DemonstrationDialog-D01TLRCK.js → DemonstrationDialog-Cf0aJQRv.js} +1 -1
  4. package/dist/client/assets/{GitHubActionsDialog-BmIcsS_L.js → GitHubActionsDialog-SWdzhK5r.js} +1 -1
  5. package/dist/client/assets/{IconGitHubActions-CjswQj_b.js → IconGitHubActions-CNbdWcIO.js} +1 -1
  6. package/dist/client/assets/{IconStop-BN5mT2U1.js → IconStop-1dsHbpO4.js} +1 -1
  7. package/dist/client/assets/{LifecycleProvider-ei6VLwTM.js → LifecycleProvider-DoalMn3Z.js} +1 -1
  8. package/dist/client/assets/{VerificationDialog-Cke3OC3c.js → VerificationDialog-DUBa8FRo.js} +1 -1
  9. package/dist/client/assets/{WorkspaceReviewModal-CLcm4NoU.js → WorkspaceReviewModal-DZSzgA7h.js} +1 -1
  10. package/dist/client/assets/{architectureDiagram-3BPJPVTR-Pkhiqt5r.js → architectureDiagram-3BPJPVTR-GtxQ0KbU.js} +1 -1
  11. package/dist/client/assets/{blockDiagram-GPEHLZMM-ruvMsQHK.js → blockDiagram-GPEHLZMM-C7RJmMo9.js} +1 -1
  12. package/dist/client/assets/bootstrap-CstlZd87.js +98 -0
  13. package/dist/client/assets/bootstrap-Dzv2N1LT.css +2 -0
  14. package/dist/client/assets/{c4Diagram-AAUBKEIU-D1brmJbD.js → c4Diagram-AAUBKEIU-D2f6i1DL.js} +1 -1
  15. package/dist/client/assets/channel-FDr1LDrU.js +1 -0
  16. package/dist/client/assets/{chunk-2J33WTMH-CLreEKG8.js → chunk-2J33WTMH-B9Wo3hAI.js} +1 -1
  17. package/dist/client/assets/{chunk-3OPIFGDE-DCODI-Rc.js → chunk-3OPIFGDE-Cyo_Iktv.js} +1 -1
  18. package/dist/client/assets/{chunk-5ZQYHXKU-Czv3sEec.js → chunk-5ZQYHXKU-BKlRORkG.js} +1 -1
  19. package/dist/client/assets/{chunk-727SXJPM-CUS5BAia.js → chunk-727SXJPM-Dgg-Mad6.js} +1 -1
  20. package/dist/client/assets/{chunk-AQP2D5EJ-DuU68eY2.js → chunk-AQP2D5EJ-Bo8h3S3M.js} +1 -1
  21. package/dist/client/assets/{chunk-CSCIHK7Q-BFj36ajn.js → chunk-CSCIHK7Q-CqFynCvg.js} +1 -1
  22. package/dist/client/assets/{chunk-KSCS5N6A-iU27-eSU.js → chunk-KSCS5N6A-DAJRRDRy.js} +1 -1
  23. package/dist/client/assets/{chunk-L5ZTLDWV-Dkr_XhvY.js → chunk-L5ZTLDWV-CpZSmk_0.js} +1 -1
  24. package/dist/client/assets/{chunk-LZXEDZCA-CvWOZMMQ.js → chunk-LZXEDZCA-DJ9nb0ji.js} +2 -2
  25. package/dist/client/assets/{chunk-ND2GUHAM-BkfiFlFO.js → chunk-ND2GUHAM-D9YDFQTm.js} +1 -1
  26. package/dist/client/assets/{chunk-NZK2D7GU-Ci8pOVdE.js → chunk-NZK2D7GU-Bctiv_F4.js} +1 -1
  27. package/dist/client/assets/{chunk-O5CBEL6O-DQWScC0A.js → chunk-O5CBEL6O-CVguYdsZ.js} +1 -1
  28. package/dist/client/assets/{chunk-WU5MYG2G-NCbD6q3J.js → chunk-WU5MYG2G-Djvv7tcQ.js} +1 -1
  29. package/dist/client/assets/classDiagram-4FO5ZUOK-VNZavQR_.js +1 -0
  30. package/dist/client/assets/classDiagram-v2-Q7XG4LA2-c7rK07SK.js +1 -0
  31. package/dist/client/assets/{dagre-BM42HDAG-DRbkGBBP.js → dagre-BM42HDAG-DZExso27.js} +1 -1
  32. package/dist/client/assets/{diagram-2AECGRRQ-D_TKwNab.js → diagram-2AECGRRQ-BNCidogD.js} +1 -1
  33. package/dist/client/assets/{diagram-5GNKFQAL-DqgxdJ2S.js → diagram-5GNKFQAL-XHq_Rz3r.js} +1 -1
  34. package/dist/client/assets/{diagram-KO2AKTUF-DC36WkSM.js → diagram-KO2AKTUF-GGoEhXJk.js} +1 -1
  35. package/dist/client/assets/{diagram-LMA3HP47-CfgPkQ74.js → diagram-LMA3HP47-CGwPzxa0.js} +1 -1
  36. package/dist/client/assets/{diagram-OG6HWLK6-BecH_4Uu.js → diagram-OG6HWLK6-BtDc_GiR.js} +1 -1
  37. package/dist/client/assets/{erDiagram-TEJ5UH35-gVKjPSTy.js → erDiagram-TEJ5UH35-CjvscqbC.js} +1 -1
  38. package/dist/client/assets/{flowDiagram-I6XJVG4X-BI4w94Db.js → flowDiagram-I6XJVG4X-h9PFeGYQ.js} +1 -1
  39. package/dist/client/assets/{ganttDiagram-6RSMTGT7-CEwscd0z.js → ganttDiagram-6RSMTGT7-_z2FNLFr.js} +1 -1
  40. package/dist/client/assets/{gitGraphDiagram-PVQCEYII-BzYnzfZU.js → gitGraphDiagram-PVQCEYII-CV_mfLqV.js} +1 -1
  41. package/dist/client/assets/{index-C2JPbj12.js → index-d7mv-jUF.js} +2 -2
  42. package/dist/client/assets/{infoDiagram-5YYISTIA-CPYAdvo1.js → infoDiagram-5YYISTIA-DAb0F7jZ.js} +1 -1
  43. package/dist/client/assets/{input-AZAw9vJs.js → input-ztf58CfF.js} +3 -3
  44. package/dist/client/assets/{ishikawaDiagram-YF4QCWOH-Ctpfd7Fa.js → ishikawaDiagram-YF4QCWOH-BqdUij2V.js} +1 -1
  45. package/dist/client/assets/{journeyDiagram-JHISSGLW-CmpICCRR.js → journeyDiagram-JHISSGLW-B1CjBwrD.js} +1 -1
  46. package/dist/client/assets/{kanban-definition-UN3LZRKU-BvrG2MaR.js → kanban-definition-UN3LZRKU-XQpyKzwG.js} +1 -1
  47. package/dist/client/assets/{line-BuEChOFl.js → line-CbO38-BR.js} +1 -1
  48. package/dist/client/assets/{mermaid-parser.core-Cc66WWhM.js → mermaid-parser.core-Dkv9_L-g.js} +1 -1
  49. package/dist/client/assets/{mermaid.core-01K66m6d.js → mermaid.core-ByXN03jp.js} +3 -3
  50. package/dist/client/assets/{mindmap-definition-RKZ34NQL-BuyfpCKJ.js → mindmap-definition-RKZ34NQL-BZ802LEb.js} +1 -1
  51. package/dist/client/assets/{pieDiagram-4H26LBE5-CgGRmchd.js → pieDiagram-4H26LBE5-DJxIIGHN.js} +1 -1
  52. package/dist/client/assets/{quadrantDiagram-W4KKPZXB-BbiyoZff.js → quadrantDiagram-W4KKPZXB-737xKWR-.js} +1 -1
  53. package/dist/client/assets/{requirementDiagram-4Y6WPE33-BlYwYv8f.js → requirementDiagram-4Y6WPE33-BcyXer0H.js} +1 -1
  54. package/dist/client/assets/{sankeyDiagram-5OEKKPKP-Bp_j3oV6.js → sankeyDiagram-5OEKKPKP-pRWMoWA3.js} +1 -1
  55. package/dist/client/assets/{sequenceDiagram-3UESZ5HK-DqC_KQou.js → sequenceDiagram-3UESZ5HK-B8I9z11_.js} +1 -1
  56. package/dist/client/assets/{stateDiagram-AJRCARHV-BrG7IGOM.js → stateDiagram-AJRCARHV-DJNYuHfz.js} +1 -1
  57. package/dist/client/assets/stateDiagram-v2-BHNVJYJU-Ci8_IlV_.js +1 -0
  58. package/dist/client/assets/{timeline-definition-PNZ67QCA-BDe3IkOy.js → timeline-definition-PNZ67QCA-hy9ZV3k4.js} +1 -1
  59. package/dist/client/assets/{vennDiagram-CIIHVFJN-DECIVR7V.js → vennDiagram-CIIHVFJN-C6By4K-m.js} +1 -1
  60. package/dist/client/assets/{wardleyDiagram-YWT4CUSO-Bx3AJaN9.js → wardleyDiagram-YWT4CUSO-DgK8xHry.js} +1 -1
  61. package/dist/client/assets/{xychartDiagram-2RQKCTM6-152u9kKH.js → xychartDiagram-2RQKCTM6-DV8oxlzo.js} +1 -1
  62. package/dist/client/index.html +1 -1
  63. package/dist/server/db.js +2 -6452
  64. package/dist/server/db.js.map +1 -1
  65. package/dist/server/epicRoutes.js +66 -0
  66. package/dist/server/epicRoutes.js.map +1 -1
  67. package/dist/server/index.js +3 -2
  68. package/dist/server/index.js.map +1 -1
  69. package/dist/server/lib/buildCompletionContinuation.js +25 -157
  70. package/dist/server/lib/buildCompletionContinuation.js.map +1 -1
  71. package/dist/server/lib/buildCompletionContinuationTypes.js +5 -0
  72. package/dist/server/lib/buildCompletionContinuationTypes.js.map +1 -0
  73. package/dist/server/lib/buildDemonstrationSchema.js +4 -1
  74. package/dist/server/lib/buildDemonstrationSchema.js.map +1 -1
  75. package/dist/server/lib/buildPostFinalization.js +157 -0
  76. package/dist/server/lib/buildPostFinalization.js.map +1 -0
  77. package/dist/server/lib/buildTicketCheckpointLineage.js +194 -0
  78. package/dist/server/lib/buildTicketCheckpointLineage.js.map +1 -0
  79. package/dist/server/lib/buildTicketCheckpointLineageReads.js +20 -0
  80. package/dist/server/lib/buildTicketCheckpointLineageReads.js.map +1 -0
  81. package/dist/server/lib/buildTicketCommit.js +15 -192
  82. package/dist/server/lib/buildTicketCommit.js.map +1 -1
  83. package/dist/server/lib/chatSessionUsageMigration.js +7 -3
  84. package/dist/server/lib/chatSessionUsageMigration.js.map +1 -1
  85. package/dist/server/lib/chats.js +6 -2
  86. package/dist/server/lib/chats.js.map +1 -1
  87. package/dist/server/lib/checkpointExecution.js +33 -27
  88. package/dist/server/lib/checkpointExecution.js.map +1 -1
  89. package/dist/server/lib/databaseConnection.js +20 -0
  90. package/dist/server/lib/databaseConnection.js.map +1 -0
  91. package/dist/server/lib/databaseInitialization/agentRuns.js +156 -0
  92. package/dist/server/lib/databaseInitialization/agentRuns.js.map +1 -0
  93. package/dist/server/lib/databaseInitialization/automationQuestions.js +98 -0
  94. package/dist/server/lib/databaseInitialization/automationQuestions.js.map +1 -0
  95. package/dist/server/lib/databaseInitialization/buildSequences.js +198 -0
  96. package/dist/server/lib/databaseInitialization/buildSequences.js.map +1 -0
  97. package/dist/server/lib/databaseInitialization/bundleAutomation.js +57 -0
  98. package/dist/server/lib/databaseInitialization/bundleAutomation.js.map +1 -0
  99. package/dist/server/lib/databaseInitialization/chatAttachments.js +132 -0
  100. package/dist/server/lib/databaseInitialization/chatAttachments.js.map +1 -0
  101. package/dist/server/lib/databaseInitialization/checkBatchGuards.js +198 -0
  102. package/dist/server/lib/databaseInitialization/checkBatchGuards.js.map +1 -0
  103. package/dist/server/lib/databaseInitialization/checkGates.js +305 -0
  104. package/dist/server/lib/databaseInitialization/checkGates.js.map +1 -0
  105. package/dist/server/lib/databaseInitialization/checkRepairProvenance.js +220 -0
  106. package/dist/server/lib/databaseInitialization/checkRepairProvenance.js.map +1 -0
  107. package/dist/server/lib/databaseInitialization/checkRepairs.js +295 -0
  108. package/dist/server/lib/databaseInitialization/checkRepairs.js.map +1 -0
  109. package/dist/server/lib/databaseInitialization/coreColumns.js +104 -0
  110. package/dist/server/lib/databaseInitialization/coreColumns.js.map +1 -0
  111. package/dist/server/lib/databaseInitialization/coreTables.js +108 -0
  112. package/dist/server/lib/databaseInitialization/coreTables.js.map +1 -0
  113. package/dist/server/lib/databaseInitialization/executionArtifacts.js +246 -0
  114. package/dist/server/lib/databaseInitialization/executionArtifacts.js.map +1 -0
  115. package/dist/server/lib/databaseInitialization/executionAuthorities.js +426 -0
  116. package/dist/server/lib/databaseInitialization/executionAuthorities.js.map +1 -0
  117. package/dist/server/lib/databaseInitialization/executionChecks.js +398 -0
  118. package/dist/server/lib/databaseInitialization/executionChecks.js.map +1 -0
  119. package/dist/server/lib/databaseInitialization/executionEnvironmentGuards.js +232 -0
  120. package/dist/server/lib/databaseInitialization/executionEnvironmentGuards.js.map +1 -0
  121. package/dist/server/lib/databaseInitialization/executionEnvironments.js +335 -0
  122. package/dist/server/lib/databaseInitialization/executionEnvironments.js.map +1 -0
  123. package/dist/server/lib/databaseInitialization/executionLifecycle.js +242 -0
  124. package/dist/server/lib/databaseInitialization/executionLifecycle.js.map +1 -0
  125. package/dist/server/lib/databaseInitialization/executionProfiles.js +408 -0
  126. package/dist/server/lib/databaseInitialization/executionProfiles.js.map +1 -0
  127. package/dist/server/lib/databaseInitialization/featureSchemas.js +28 -0
  128. package/dist/server/lib/databaseInitialization/featureSchemas.js.map +1 -0
  129. package/dist/server/lib/databaseInitialization/finalIndexes.js +79 -0
  130. package/dist/server/lib/databaseInitialization/finalIndexes.js.map +1 -0
  131. package/dist/server/lib/databaseInitialization/legacyBackfills.js +103 -0
  132. package/dist/server/lib/databaseInitialization/legacyBackfills.js.map +1 -0
  133. package/dist/server/lib/databaseInitialization/projectMemoryMigrations.js +305 -0
  134. package/dist/server/lib/databaseInitialization/projectMemoryMigrations.js.map +1 -0
  135. package/dist/server/lib/databaseInitialization/projectMemorySelections.js +28 -0
  136. package/dist/server/lib/databaseInitialization/projectMemorySelections.js.map +1 -0
  137. package/dist/server/lib/databaseInitialization/projectMemoryTables.js +155 -0
  138. package/dist/server/lib/databaseInitialization/projectMemoryTables.js.map +1 -0
  139. package/dist/server/lib/databaseInitialization/repositoryGraph.js +387 -0
  140. package/dist/server/lib/databaseInitialization/repositoryGraph.js.map +1 -0
  141. package/dist/server/lib/databaseInitialization/reviewFindings.js +126 -0
  142. package/dist/server/lib/databaseInitialization/reviewFindings.js.map +1 -0
  143. package/dist/server/lib/databaseInitialization/reviewRepair.js +17 -0
  144. package/dist/server/lib/databaseInitialization/reviewRepair.js.map +1 -0
  145. package/dist/server/lib/databaseInitialization/reviewRepairTablesSql.js +171 -0
  146. package/dist/server/lib/databaseInitialization/reviewRepairTablesSql.js.map +1 -0
  147. package/dist/server/lib/databaseInitialization/reviewRepairTriggersSql.js +438 -0
  148. package/dist/server/lib/databaseInitialization/reviewRepairTriggersSql.js.map +1 -0
  149. package/dist/server/lib/databaseInitialization/reviewRuns.js +112 -0
  150. package/dist/server/lib/databaseInitialization/reviewRuns.js.map +1 -0
  151. package/dist/server/lib/databaseInitialization/specSessions.js +256 -0
  152. package/dist/server/lib/databaseInitialization/specSessions.js.map +1 -0
  153. package/dist/server/lib/databaseInitialization/ticketBundleMigrations.js +184 -0
  154. package/dist/server/lib/databaseInitialization/ticketBundleMigrations.js.map +1 -0
  155. package/dist/server/lib/databaseInitialization/types.js +2 -0
  156. package/dist/server/lib/databaseInitialization/types.js.map +1 -0
  157. package/dist/server/lib/databaseInitialization.js +81 -0
  158. package/dist/server/lib/databaseInitialization.js.map +1 -0
  159. package/dist/server/lib/databaseRuntime.js +34 -0
  160. package/dist/server/lib/databaseRuntime.js.map +1 -0
  161. package/dist/server/lib/epicActivity.js +54 -6
  162. package/dist/server/lib/epicActivity.js.map +1 -1
  163. package/dist/server/lib/epicAutomation.js.map +1 -1
  164. package/dist/server/lib/epicAutomationTick.js +23 -4
  165. package/dist/server/lib/epicAutomationTick.js.map +1 -1
  166. package/dist/server/lib/epicCapabilityVerificationSchema.js +2 -1
  167. package/dist/server/lib/epicCapabilityVerificationSchema.js.map +1 -1
  168. package/dist/server/lib/epicCheckpointTicketIntegration.js +15 -72
  169. package/dist/server/lib/epicCheckpointTicketIntegration.js.map +1 -1
  170. package/dist/server/lib/epicCheckpointTicketReads.js +14 -0
  171. package/dist/server/lib/epicCheckpointTicketReads.js.map +1 -0
  172. package/dist/server/lib/epicCheckpointTicketService.js +68 -0
  173. package/dist/server/lib/epicCheckpointTicketService.js.map +1 -0
  174. package/dist/server/lib/epicContentValidation.js +12 -0
  175. package/dist/server/lib/epicContentValidation.js.map +1 -0
  176. package/dist/server/lib/epicContinuationWake.js +22 -5
  177. package/dist/server/lib/epicContinuationWake.js.map +1 -1
  178. package/dist/server/lib/epicContributionEvidenceSchema.js +2 -1
  179. package/dist/server/lib/epicContributionEvidenceSchema.js.map +1 -1
  180. package/dist/server/lib/epicContributionLineage.js +2 -1
  181. package/dist/server/lib/epicContributionLineage.js.map +1 -1
  182. package/dist/server/lib/epicContributionReservationSchema.js +2 -1
  183. package/dist/server/lib/epicContributionReservationSchema.js.map +1 -1
  184. package/dist/server/lib/epicContributionSchema.js +2 -1
  185. package/dist/server/lib/epicContributionSchema.js.map +1 -1
  186. package/dist/server/lib/epicCorrectiveConditions.js +4 -3
  187. package/dist/server/lib/epicCorrectiveConditions.js.map +1 -1
  188. package/dist/server/lib/epicCorrectiveWaveAdmission.js +1 -1
  189. package/dist/server/lib/epicCorrectiveWaveAdmission.js.map +1 -1
  190. package/dist/server/lib/epicDetail.js +2 -0
  191. package/dist/server/lib/epicDetail.js.map +1 -1
  192. package/dist/server/lib/epicExternalMergedPullRequest.js +5 -1
  193. package/dist/server/lib/epicExternalMergedPullRequest.js.map +1 -1
  194. package/dist/server/lib/epicInterfaceAssessmentSchema.js +2 -1
  195. package/dist/server/lib/epicInterfaceAssessmentSchema.js.map +1 -1
  196. package/dist/server/lib/epicLegacyTechnicalBlockers.js +2 -19
  197. package/dist/server/lib/epicLegacyTechnicalBlockers.js.map +1 -1
  198. package/dist/server/lib/epicLegacyTechnicalIntervention.js +23 -0
  199. package/dist/server/lib/epicLegacyTechnicalIntervention.js.map +1 -0
  200. package/dist/server/lib/epicMergedDelivery.js +2 -23
  201. package/dist/server/lib/epicMergedDelivery.js.map +1 -1
  202. package/dist/server/lib/epicMergedDeliveryCore.js +24 -0
  203. package/dist/server/lib/epicMergedDeliveryCore.js.map +1 -0
  204. package/dist/server/lib/epicObligationMappingSchema.js +4 -1
  205. package/dist/server/lib/epicObligationMappingSchema.js.map +1 -1
  206. package/dist/server/lib/epicOperations.js +169 -11
  207. package/dist/server/lib/epicOperations.js.map +1 -1
  208. package/dist/server/lib/epicOrchestration.js +4 -830
  209. package/dist/server/lib/epicOrchestration.js.map +1 -1
  210. package/dist/server/lib/epicOrchestrationClaims.js +18 -3
  211. package/dist/server/lib/epicOrchestrationClaims.js.map +1 -1
  212. package/dist/server/lib/epicOrchestrationCore.js +701 -0
  213. package/dist/server/lib/epicOrchestrationCore.js.map +1 -0
  214. package/dist/server/lib/epicOrchestrationEpisodes.js +187 -0
  215. package/dist/server/lib/epicOrchestrationEpisodes.js.map +1 -0
  216. package/dist/server/lib/epicOrchestrationPlanning.js +3 -96
  217. package/dist/server/lib/epicOrchestrationPlanning.js.map +1 -1
  218. package/dist/server/lib/epicOrchestrationPlanningCore.js +148 -0
  219. package/dist/server/lib/epicOrchestrationPlanningCore.js.map +1 -0
  220. package/dist/server/lib/epicOrchestrationRecovery.js +6 -1
  221. package/dist/server/lib/epicOrchestrationRecovery.js.map +1 -1
  222. package/dist/server/lib/epicOrchestrationSelection.js +83 -0
  223. package/dist/server/lib/epicOrchestrationSelection.js.map +1 -0
  224. package/dist/server/lib/epicOrchestrationSnapshot.js +213 -0
  225. package/dist/server/lib/epicOrchestrationSnapshot.js.map +1 -0
  226. package/dist/server/lib/epicOwnedWorkspace.js +35 -265
  227. package/dist/server/lib/epicOwnedWorkspace.js.map +1 -1
  228. package/dist/server/lib/epicOwnedWorkspaceService.js +270 -0
  229. package/dist/server/lib/epicOwnedWorkspaceService.js.map +1 -0
  230. package/dist/server/lib/epicPackageEvidence.js +1 -1
  231. package/dist/server/lib/epicPackageEvidence.js.map +1 -1
  232. package/dist/server/lib/epicPlanningBlockerRecovery.js +133 -0
  233. package/dist/server/lib/epicPlanningBlockerRecovery.js.map +1 -0
  234. package/dist/server/lib/epicPlanningBlockerRecoveryPreview.js +281 -0
  235. package/dist/server/lib/epicPlanningBlockerRecoveryPreview.js.map +1 -0
  236. package/dist/server/lib/epicPlanningDeferral.js +35 -6
  237. package/dist/server/lib/epicPlanningDeferral.js.map +1 -1
  238. package/dist/server/lib/epicPlanningDispatch.js +2 -0
  239. package/dist/server/lib/epicPlanningDispatch.js.map +1 -0
  240. package/dist/server/lib/epicPlanningDispatchProduction.js +14 -0
  241. package/dist/server/lib/epicPlanningDispatchProduction.js.map +1 -0
  242. package/dist/server/lib/epicPlanningOperations.js +313 -87
  243. package/dist/server/lib/epicPlanningOperations.js.map +1 -1
  244. package/dist/server/lib/epicPlanningReadCore.js +182 -0
  245. package/dist/server/lib/epicPlanningReadCore.js.map +1 -0
  246. package/dist/server/lib/epicPlanningReads.js +9 -44
  247. package/dist/server/lib/epicPlanningReads.js.map +1 -1
  248. package/dist/server/lib/epicPlanningRecoveryAdmissionContext.js +21 -0
  249. package/dist/server/lib/epicPlanningRecoveryAdmissionContext.js.map +1 -0
  250. package/dist/server/lib/epicPlanningRecoveryExpiry.js +148 -0
  251. package/dist/server/lib/epicPlanningRecoveryExpiry.js.map +1 -0
  252. package/dist/server/lib/epicPlanningRecoveryOperations.js +108 -0
  253. package/dist/server/lib/epicPlanningRecoveryOperations.js.map +1 -0
  254. package/dist/server/lib/epicPlanningRecoveryPolicy.js +143 -0
  255. package/dist/server/lib/epicPlanningRecoveryPolicy.js.map +1 -0
  256. package/dist/server/lib/epicPlanningRecoveryRuntime.js +313 -0
  257. package/dist/server/lib/epicPlanningRecoveryRuntime.js.map +1 -0
  258. package/dist/server/lib/epicPlanningRecoverySchema.js +190 -0
  259. package/dist/server/lib/epicPlanningRecoverySchema.js.map +1 -0
  260. package/dist/server/lib/epicPlanningRecoveryStore.js +535 -0
  261. package/dist/server/lib/epicPlanningRecoveryStore.js.map +1 -0
  262. package/dist/server/lib/epicPlanningRecoverySummary.js +66 -0
  263. package/dist/server/lib/epicPlanningRecoverySummary.js.map +1 -0
  264. package/dist/server/lib/epicPlanningRecoveryTerminal.js +65 -0
  265. package/dist/server/lib/epicPlanningRecoveryTerminal.js.map +1 -0
  266. package/dist/server/lib/epicPlanningRecoveryTerminalStore.js +71 -0
  267. package/dist/server/lib/epicPlanningRecoveryTerminalStore.js.map +1 -0
  268. package/dist/server/lib/epicPlanningRestartInvocation.js +188 -0
  269. package/dist/server/lib/epicPlanningRestartInvocation.js.map +1 -0
  270. package/dist/server/lib/epicPlanningRestartRecovery.js +12 -2
  271. package/dist/server/lib/epicPlanningRestartRecovery.js.map +1 -1
  272. package/dist/server/lib/epicPlanningRetry.js +15 -67
  273. package/dist/server/lib/epicPlanningRetry.js.map +1 -1
  274. package/dist/server/lib/epicPlanningStartupRecovery.js +4 -0
  275. package/dist/server/lib/epicPlanningStartupRecovery.js.map +1 -1
  276. package/dist/server/lib/epicPlanningStore.js +13 -2
  277. package/dist/server/lib/epicPlanningStore.js.map +1 -1
  278. package/dist/server/lib/epicPrAcceptedProgressSchema.js +4 -1
  279. package/dist/server/lib/epicPrAcceptedProgressSchema.js.map +1 -1
  280. package/dist/server/lib/epicPrReviewedPackageEvidence.js +1 -1
  281. package/dist/server/lib/epicPrReviewedPackageEvidence.js.map +1 -1
  282. package/dist/server/lib/epicPrerequisiteRefinementSchema.js +4 -1
  283. package/dist/server/lib/epicPrerequisiteRefinementSchema.js.map +1 -1
  284. package/dist/server/lib/epicProviderRead.js +6 -0
  285. package/dist/server/lib/epicProviderRead.js.map +1 -1
  286. package/dist/server/lib/epicReadinessService.js +6 -2
  287. package/dist/server/lib/epicReadinessService.js.map +1 -1
  288. package/dist/server/lib/epicReconciliation.js +22 -8
  289. package/dist/server/lib/epicReconciliation.js.map +1 -1
  290. package/dist/server/lib/epicReconciliationErrors.js +14 -0
  291. package/dist/server/lib/epicReconciliationErrors.js.map +1 -0
  292. package/dist/server/lib/epicResidualRecurrence.js +3 -510
  293. package/dist/server/lib/epicResidualRecurrence.js.map +1 -1
  294. package/dist/server/lib/epicResidualRecurrenceCore.js +512 -0
  295. package/dist/server/lib/epicResidualRecurrenceCore.js.map +1 -0
  296. package/dist/server/lib/epicRewrittenBuildEvidence.js +104 -0
  297. package/dist/server/lib/epicRewrittenBuildEvidence.js.map +1 -0
  298. package/dist/server/lib/epicSchema.js +2 -0
  299. package/dist/server/lib/epicSchema.js.map +1 -1
  300. package/dist/server/lib/epicSemantics.js +3 -52
  301. package/dist/server/lib/epicSemantics.js.map +1 -1
  302. package/dist/server/lib/epicSemanticsPreparation.js +60 -0
  303. package/dist/server/lib/epicSemanticsPreparation.js.map +1 -0
  304. package/dist/server/lib/epicSemanticsSchema.js +9 -6
  305. package/dist/server/lib/epicSemanticsSchema.js.map +1 -1
  306. package/dist/server/lib/epicTargetAdmission.js +7 -1
  307. package/dist/server/lib/epicTargetAdmission.js.map +1 -1
  308. package/dist/server/lib/epicUnitSettlementSchema.js +5 -2
  309. package/dist/server/lib/epicUnitSettlementSchema.js.map +1 -1
  310. package/dist/server/lib/epicVerificationCheckAdmissionSchema.js +4 -1
  311. package/dist/server/lib/epicVerificationCheckAdmissionSchema.js.map +1 -1
  312. package/dist/server/lib/epicVerificationCheckLineageSchema.js +6 -3
  313. package/dist/server/lib/epicVerificationCheckLineageSchema.js.map +1 -1
  314. package/dist/server/lib/epicVerificationCheckOperations.js +4 -1
  315. package/dist/server/lib/epicVerificationCheckOperations.js.map +1 -1
  316. package/dist/server/lib/epicVerificationPolicy.js +3 -9
  317. package/dist/server/lib/epicVerificationPolicy.js.map +1 -1
  318. package/dist/server/lib/epicVerificationPolicyCapture.js +11 -0
  319. package/dist/server/lib/epicVerificationPolicyCapture.js.map +1 -1
  320. package/dist/server/lib/epicWaveArtifact.js +18 -0
  321. package/dist/server/lib/epicWaveArtifact.js.map +1 -0
  322. package/dist/server/lib/epicWaveConnectionReads.js +28 -0
  323. package/dist/server/lib/epicWaveConnectionReads.js.map +1 -0
  324. package/dist/server/lib/epicWaveContributionProvenance.js +1 -1
  325. package/dist/server/lib/epicWaveContributionProvenance.js.map +1 -1
  326. package/dist/server/lib/epicWaveContributionSchema.js +8 -2
  327. package/dist/server/lib/epicWaveContributionSchema.js.map +1 -1
  328. package/dist/server/lib/epicWaveErrors.js +11 -0
  329. package/dist/server/lib/epicWaveErrors.js.map +1 -0
  330. package/dist/server/lib/epicWaveLifecycle.js +1 -1
  331. package/dist/server/lib/epicWaveLifecycle.js.map +1 -1
  332. package/dist/server/lib/epicWavePersistence.js +348 -0
  333. package/dist/server/lib/epicWavePersistence.js.map +1 -0
  334. package/dist/server/lib/epicWavePolicyAuthority.js +2 -1
  335. package/dist/server/lib/epicWavePolicyAuthority.js.map +1 -1
  336. package/dist/server/lib/epicWaveReadiness.js +25 -445
  337. package/dist/server/lib/epicWaveReadiness.js.map +1 -1
  338. package/dist/server/lib/epicWaveReadinessCore.js +478 -0
  339. package/dist/server/lib/epicWaveReadinessCore.js.map +1 -0
  340. package/dist/server/lib/epicWaveRetirement.js +3 -100
  341. package/dist/server/lib/epicWaveRetirement.js.map +1 -1
  342. package/dist/server/lib/epicWaveRetirementStore.js +95 -0
  343. package/dist/server/lib/epicWaveRetirementStore.js.map +1 -0
  344. package/dist/server/lib/epicWaveStore.js +11 -359
  345. package/dist/server/lib/epicWaveStore.js.map +1 -1
  346. package/dist/server/lib/epicWaveValidation.js +2 -2
  347. package/dist/server/lib/epicWaveValidation.js.map +1 -1
  348. package/dist/server/lib/epicWorkspaceSnapshot.js +32 -5
  349. package/dist/server/lib/epicWorkspaceSnapshot.js.map +1 -1
  350. package/dist/server/lib/epics.js +3 -9
  351. package/dist/server/lib/epics.js.map +1 -1
  352. package/dist/server/lib/executionWorkerCompletion.js +76 -0
  353. package/dist/server/lib/executionWorkerCompletion.js.map +1 -1
  354. package/dist/server/lib/i18n/epicPlanning.js +14 -0
  355. package/dist/server/lib/i18n/epicPlanning.js.map +1 -1
  356. package/dist/server/lib/integrations/githubTransport.js +30 -1
  357. package/dist/server/lib/integrations/githubTransport.js.map +1 -1
  358. package/dist/server/lib/runtimePaths.js +2 -2
  359. package/dist/server/lib/runtimePaths.js.map +1 -1
  360. package/dist/server/lib/sessionActivitySummaries.js +29 -0
  361. package/dist/server/lib/sessionActivitySummaries.js.map +1 -0
  362. package/dist/server/lib/specs.js +6 -2
  363. package/dist/server/lib/specs.js.map +1 -1
  364. package/dist/server/lib/stageSnapshotStorage.js +153 -0
  365. package/dist/server/lib/stageSnapshotStorage.js.map +1 -0
  366. package/dist/server/lib/ticketUndo.js +48 -22
  367. package/dist/server/lib/ticketUndo.js.map +1 -1
  368. package/dist/server/lib/types.js.map +1 -1
  369. package/dist/server/lib/workspaceIdentity.js +35 -2
  370. package/dist/server/lib/workspaceIdentity.js.map +1 -1
  371. package/dist/server/workers/epicArtifactContract.js +92 -17
  372. package/dist/server/workers/epicArtifactContract.js.map +1 -1
  373. package/dist/server/workers/epicArtifactPurposeError.js +19 -12
  374. package/dist/server/workers/epicArtifactPurposeError.js.map +1 -1
  375. package/dist/server/workers/epicPlanning.js +36 -762
  376. package/dist/server/workers/epicPlanning.js.map +1 -1
  377. package/dist/server/workers/epicPlanningAdmission.js +194 -50
  378. package/dist/server/workers/epicPlanningAdmission.js.map +1 -1
  379. package/dist/server/workers/epicPlanningAdmissionRecovery.js +201 -0
  380. package/dist/server/workers/epicPlanningAdmissionRecovery.js.map +1 -0
  381. package/dist/server/workers/epicPlanningArtifactRepair.js +158 -38
  382. package/dist/server/workers/epicPlanningArtifactRepair.js.map +1 -1
  383. package/dist/server/workers/epicPlanningAssessmentRepair.js +1 -1
  384. package/dist/server/workers/epicPlanningAssessmentRepair.js.map +1 -1
  385. package/dist/server/workers/epicPlanningClosure.js +1 -1
  386. package/dist/server/workers/epicPlanningClosure.js.map +1 -1
  387. package/dist/server/workers/epicPlanningContributionRefinement.js +71 -23
  388. package/dist/server/workers/epicPlanningContributionRefinement.js.map +1 -1
  389. package/dist/server/workers/epicPlanningEvidence.js +29 -0
  390. package/dist/server/workers/epicPlanningEvidence.js.map +1 -0
  391. package/dist/server/workers/epicPlanningFailurePublication.js +39 -0
  392. package/dist/server/workers/epicPlanningFailurePublication.js.map +1 -0
  393. package/dist/server/workers/epicPlanningFirstWave.js.map +1 -1
  394. package/dist/server/workers/epicPlanningGuards.js +63 -1
  395. package/dist/server/workers/epicPlanningGuards.js.map +1 -1
  396. package/dist/server/workers/epicPlanningLivePorts.js +12 -0
  397. package/dist/server/workers/epicPlanningLivePorts.js.map +1 -0
  398. package/dist/server/workers/epicPlanningOutputAuthority.js.map +1 -1
  399. package/dist/server/workers/epicPlanningOutputRecovery.js +213 -0
  400. package/dist/server/workers/epicPlanningOutputRecovery.js.map +1 -0
  401. package/dist/server/workers/epicPlanningPolicy.js +36 -0
  402. package/dist/server/workers/epicPlanningPolicy.js.map +1 -0
  403. package/dist/server/workers/epicPlanningPrerequisiteRefinement.js +5 -2
  404. package/dist/server/workers/epicPlanningPrerequisiteRefinement.js.map +1 -1
  405. package/dist/server/workers/epicPlanningServices.js +171 -0
  406. package/dist/server/workers/epicPlanningServices.js.map +1 -0
  407. package/dist/server/workers/epicPlanningStaleTarget.js +82 -5
  408. package/dist/server/workers/epicPlanningStaleTarget.js.map +1 -1
  409. package/dist/server/workers/epicPlanningWorker.js +720 -0
  410. package/dist/server/workers/epicPlanningWorker.js.map +1 -0
  411. package/dist/server/workers/epicPlanningWorkerTypes.js +2 -0
  412. package/dist/server/workers/epicPlanningWorkerTypes.js.map +1 -0
  413. package/dist/server/workers/epicReadinessPlanningPrompt.js +1 -1
  414. package/dist/server/workers/epicReadinessPlanningPrompt.js.map +1 -1
  415. package/dist/server/workers/epicReadinessPlanningTurn.js +27 -14
  416. package/dist/server/workers/epicReadinessPlanningTurn.js.map +1 -1
  417. package/dist/server/workers/epicRevisionPrompt.js +2 -8
  418. package/dist/server/workers/epicRevisionPrompt.js.map +1 -1
  419. package/dist/server/workers/epicRevisionRules.js +10 -0
  420. package/dist/server/workers/epicRevisionRules.js.map +1 -0
  421. package/dist/shared/epicActivity.js +35 -2
  422. package/dist/shared/epicActivity.js.map +1 -1
  423. package/dist/shared/epicPlanningRecovery.js +2 -0
  424. package/dist/shared/epicPlanningRecovery.js.map +1 -0
  425. package/dist/shared/epicPlanningRecoveryOperations.js +2 -0
  426. package/dist/shared/epicPlanningRecoveryOperations.js.map +1 -0
  427. package/dist/shared/epics.js.map +1 -1
  428. package/dist/shared/sessionActivity.js +2 -0
  429. package/dist/shared/sessionActivity.js.map +1 -0
  430. package/package.json +1 -1
  431. package/dist/client/assets/bootstrap-CKROdR45.js +0 -98
  432. package/dist/client/assets/bootstrap-CX5EVEtc.css +0 -2
  433. package/dist/client/assets/channel-B01NDmbu.js +0 -1
  434. package/dist/client/assets/classDiagram-4FO5ZUOK-D_Jv2gIy.js +0 -1
  435. package/dist/client/assets/classDiagram-v2-Q7XG4LA2-CcxVBrx5.js +0 -1
  436. package/dist/client/assets/stateDiagram-v2-BHNVJYJU-rcRVsbsd.js +0 -1
@@ -1,770 +1,44 @@
1
- import { randomUUID } from 'crypto';
2
- import { isInternalAgentOutput } from '../lib/agentOutputVisibility.js';
3
- import { broadcastEpicReferences } from '../lib/epicReferenceNotifications.js';
4
- import { isDeepStrictEqual } from 'node:util';
5
1
  import db from '../db.js';
6
- import { recordEpicPlanningSemanticInput } from '../lib/epicPlanningNoAction.js';
7
- import { getAgentErrorTranscriptRuns } from '../lib/agent.js';
8
- import { resolveEffectiveEpicPlanner as resolvePlanner } from './epicPlanningModel.js';
9
- import { getProjectById } from '../lib/projects.js';
10
- import { getExecutionRun, transitionExecutionRun } from '../lib/executionRuns.js';
11
- import { createAgentRun, emitAgentRunsUpdated, finalizeAgentRun, getNextAgentRunIndex, terminalizeAgentRunsForExecutionRun } from '../lib/agentRuns.js';
12
- import { getEpic, getEpicAttempt, appendEpicMessage, updateEpicProgress } from '../lib/epics.js';
13
- import { assertActiveEpicProposalOwner, closeEpicProposalOwner, failEpicProposalOwner } from '../lib/epicProposals.js';
14
- import { assertEpicStepEligible } from '../lib/epicReconciliation.js';
15
- import { getEpicWavePlanningAdmission, getEpicWavePublication, listEpicWaves } from '../lib/epicWaveStore.js';
16
- import { EpicWaveStaleTargetError, isActiveEpicWave, retireStaleEpicWave } from '../lib/epicWaveRetirement.js';
17
- import { prepareEpicPlanningWave, applyEpicPlanningWaveAssessments, epicPlanningWaveOutput, completeEpicPlanningWave, epicPlanningDeliveryEvidenceCatalog, epicPlanningRemainingCoverage, epicPlanningWaveHistory, assertEpicPlanningWaveContributions } from './epicPlanningWave.js';
18
- import { assertEpicWaveAssessmentsComplete } from '../lib/epicWaveReconciliationEvidence.js';
19
- import { refreshEpicPlanningSettlement } from './epicPlanningSettlement.js';
20
- import { recordEpicWaveReconciliations, retainEpicWaveReconciliationObservations } from '../lib/epicWaveReconciliation.js';
21
- import { listEpicExecutionPlans } from '../lib/epicExecutionPlans.js';
22
- import { withEpicTargetObservation } from '../lib/epicTargetObservation.js';
23
- import { getEpicPlanningScopeFingerprint as fingerprint, getEpicPlanningState, compareSetEpicPlanningState, assertEpicPlanningStepReconciled, createEpicPlanningReconciliationEvidence, createEpicPlanningReconciliationProof } from '../lib/epicPlanningStore.js';
24
- import { formatAskQuestionContinuation, formatAskQuestionMessage, parseAskQuestionResolutions } from '../lib/planQuestions.js';
25
- import { observeReservedEpicTarget } from '../lib/epicTargetObservation.js';
26
- import { requireEpicTarget } from '../lib/epicTargetResolution.js';
27
- import { prepareEpicPlanningWorkspace } from '../lib/epicPlanningWorkspace.js';
28
- import { prepareEpicTargetAdmission, recordEpicTargetAdmission } from '../lib/epicTargetAdmission.js';
29
- import { fetchObservedEpicTargetCommit } from '../lib/epicTargetProvisioning.js';
30
- import { resolveWorkloadExecutionEnvironment } from '../lib/workloadExecutionEnvironment.js';
2
+ import { createEpicPlanningWorker } from './epicPlanningWorker.js';
3
+ import { createProductionEpicPlanningServices } from './epicPlanningServices.js';
31
4
  import { enqueue, isRunning } from '../lib/queue.js';
32
- import { HttpError } from '../lib/httpError.js';
33
- import { EpicArtifactValidationError, parseEpicPlanningOutput } from './epicArtifactContract.js';
34
- import { epicPlanningMessage } from '../lib/i18n/epicPlanning.js';
35
- import { epicPlanningResidualReport, filterEpicResidualWave, areAllEpicResidualsBlocked } from './epicResidualPlanning.js';
36
- import { completeEpicParkedProgress } from './epicPlanningProgress.js';
37
- import { admitEpicPlanning, isEpicPlanningAdmissionBusy as admissionBusy } from './epicPlanningAdmission.js';
38
- import { assertEpicWaveResourcesReady } from '../lib/epicWaveResources.js';
39
- import { canDispatchEpicPlanningRecovery, deferEpicPlanningFailure } from '../lib/epicPlanningDeferral.js';
40
- import { assertEpicPlanningRecoveryAvailable, reconcileEpicPlanning as reconcile } from './epicPlanningPreflight.js';
41
- import { describeEpicPlanningFailure } from './epicPlanningFailure.js';
42
- import { comparableEpicPlanningEvidence, epicPlanningEvidenceDigest, readEpicPlanningOutput, saveEpicPlanningOutput } from '../lib/epicPlanningOutput.js';
43
5
  import { trackExecutionWorker } from '../lib/executionWorkerCompletion.js';
44
6
  import { scheduleEpicContinuationWake } from '../lib/epicContinuationWake.js';
45
- import { beginEpicPlanningInvocation, finishEpicPlanningInvocation } from '../lib/epicPlanningInvocation.js';
46
- import { recoverEpicPlanningInvocationCleanup, retainEpicPlanningInvocationCleanup } from '../lib/epicPlanningInvocationCleanup.js';
47
- import { assertCurrentEpicPlanning as assertCurrent, failEpicPlanning as fail, requirePlanningEpic as requireEpic, epicPlanningMutationScope as scope, terminalizeEpicPlanningAttempt as terminalizePlanAttempt } from './epicPlanningGuards.js';
48
- import { buildEpicPlanningPrompt } from './epicPlanningPrompt.js';
49
- import { prepareEpicPlanningStep as prepareStep, applyEpicPlanningArtifact as applyArtifact, epicPlanningPublicationResponse } from './epicPlanningPublication.js';
50
- import { interruptStaleAutomaticEpicPlanning } from './epicPlanningStaleTarget.js';
51
- import { assertEpicPlanningOutputAuthority } from './epicPlanningOutputAuthority.js';
52
- import { assertEpicAssessmentRepairScope, buildEpicAssessmentRepairPrompt, canRepairEpicDeliveryAssessment } from './epicPlanningAssessmentRepair.js';
53
- import { assertEpicArtifactRepairScope, buildEpicArtifactRepairPrompt, isEpicArtifactRepairError } from './epicPlanningArtifactRepair.js';
54
- import { assertFreshEpicResidualDiagnostics } from './epicPlanningResidualContract.js';
55
- import { assertEpicPlanningWaveCandidate, EpicWaveCandidateValidationError } from './epicPlanningWaveCandidate.js';
56
- import { assertEpicPlanningClosure } from './epicPlanningClosure.js';
57
- import { isEpicVerificationPolicyCurrent } from '../lib/epicVerificationPolicy.js';
58
- import { supersedeEpicPlanningRun, supersedeDrainedEpicPlanningRuns } from './epicPlanningPolicySupersession.js';
59
- import { completeEpicReadinessPreparation } from './epicPlanningPrerequisiteRefinement.js';
60
- import { createReadinessPlanningContext } from './epicReadinessPlanningContext.js';
61
- import { completeReadinessPlanningTurn } from './epicReadinessPlanningTurn.js';
62
- import { assertEpicPlanningFirstWave, isEpicPlanningFirstWave } from './epicPlanningFirstWave.js';
63
- import { createEpicReadinessMeasurements } from '../lib/epicReadinessMeasurements.js';
7
+ import { prepareEpicTargetAdmission } from '../lib/epicTargetAdmission.js';
8
+ import { observeReservedEpicTarget } from '../lib/epicTargetObservation.js';
9
+ import { fetchObservedEpicTargetCommit } from '../lib/epicTargetProvisioning.js';
10
+ import { prepareEpicPlanningWorkspace } from '../lib/epicPlanningWorkspace.js';
11
+ import { resolveWorkloadExecutionEnvironment } from '../lib/workloadExecutionEnvironment.js';
12
+ import { reconcileEpicPlanning } from './epicPlanningPreflight.js';
13
+ import { resolveEffectiveEpicPlanner as resolvePlanner } from './epicPlanningModel.js';
14
+ import { isEpicPlanningAdmissionBusy as admissionBusy } from './epicPlanningAdmission.js';
15
+ import { supersedeDrainedEpicPlanningRuns } from './epicPlanningPolicySupersession.js';
16
+ import { createLiveEpicPlanningPorts } from './epicPlanningLivePorts.js';
17
+ /** Existing entry points compose the production owner at call time. Explicit
18
+ * owners construct createEpicPlanningWorker with their own connection and ports. */
19
+ export const createProductionEpicPlanningDependencies = () => ({
20
+ connection: db,
21
+ services: createProductionEpicPlanningServices(),
22
+ machine: createLiveEpicPlanningPorts({
23
+ enqueue: () => enqueue,
24
+ isRunning: () => isRunning,
25
+ trackExecutionWorker: () => trackExecutionWorker,
26
+ scheduleEpicContinuationWake: () => scheduleEpicContinuationWake,
27
+ }),
28
+ provider: createLiveEpicPlanningPorts({
29
+ prepareEpicTargetAdmission: () => prepareEpicTargetAdmission,
30
+ observeReservedEpicTarget: () => observeReservedEpicTarget,
31
+ fetchObservedEpicTargetCommit: () => fetchObservedEpicTargetCommit,
32
+ prepareEpicPlanningWorkspace: () => prepareEpicPlanningWorkspace,
33
+ resolveWorkloadExecutionEnvironment: () => resolveWorkloadExecutionEnvironment,
34
+ reconcile: () => reconcileEpicPlanning,
35
+ }),
36
+ });
37
+ export const createProductionEpicPlanningWorker = () => createEpicPlanningWorker(createProductionEpicPlanningDependencies());
64
38
  export const resolveEffectiveEpicPlanner = resolvePlanner;
65
39
  export const isEpicPlanningAdmissionBusy = admissionBusy;
66
40
  export const retireSupersededEpicPlanningRuns = supersedeDrainedEpicPlanningRuns;
67
- export const admitEpicPlanningRun = (input, io) => admitEpicPlanning(input, io, resolveEffectiveEpicPlanner);
68
- export const resolveEpicPlanningQuestions = (input, io) => db.transaction(() => {
69
- const state = getEpicPlanningState(input.project_id, input.run_id);
70
- if (state.epic_id !== input.epic_id || state.generation !== input.expected_generation
71
- || state.question?.id !== input.question_id || state.question.status !== 'pending'
72
- || getExecutionRun(input.project_id, input.run_id)?.status !== 'waiting') {
73
- return fail(epicPlanningMessage('staleQuestion'));
74
- }
75
- const epic = assertCurrent(input.project_id, input.run_id, state);
76
- if (epic.version !== input.expected_version) {
77
- return fail(epicPlanningMessage('questionVersionConflict'));
78
- }
79
- const parsed = parseAskQuestionResolutions(input.resolutions, state.question);
80
- if (!parsed.ok) {
81
- return fail(parsed.error, 422);
82
- }
83
- const continuation = formatAskQuestionContinuation(state.question, parsed.resolutions);
84
- const next = compareSetEpicPlanningState(input.project_id, input.run_id, state.generation, {
85
- ...state, generation: state.generation + 1, question: { ...state.question, status: 'resolved', resolutions: parsed.resolutions },
86
- continuation: [state.continuation, continuation].filter(Boolean).join('\n\n'),
87
- });
88
- transitionExecutionRun({ projectId: input.project_id, runId: input.run_id, status: 'waiting',
89
- domainStatus: 'pending_dispatch', eventType: 'epic_questions_resolved' }, io);
90
- return next;
91
- }).immediate();
92
- /** Returns the queued completion promise, or false if this run cannot dispatch.
93
- * Question continuations deliberately start fresh: no provider session can be
94
- * reused across authority/model/runtime changes. The approved state and every
95
- * resolution are replayed explicitly with the original admitted planner. */
96
- export const startEpicPlanningRun = (projectId, runId, options) => {
97
- const state = getEpicPlanningState(projectId, runId);
98
- const key = `epic-planning:${projectId}:${state.epic_id}`;
99
- const run = getExecutionRun(projectId, runId);
100
- const superseded = !isEpicVerificationPolicyCurrent(projectId, state.epic_id, state.verification_policy);
101
- const dispatchable = run?.status === 'queued' || (run?.status === 'waiting' && ['pending_dispatch', 'policy_wait', 'recovery_wait'].includes(run.domain_status ?? ''));
102
- if (isRunning(key) || !(superseded && ['queued', 'waiting'].includes(run?.status ?? '') || dispatchable)
103
- || !superseded && (state.question?.status === 'pending' || !canDispatchEpicPlanningRecovery(projectId, state))) {
104
- return false;
105
- }
106
- requireEpic(projectId, state.epic_id);
107
- const completion = enqueue(key, async () => {
108
- const measurements = state.purpose === 'prepare_readiness' ? createEpicReadinessMeasurements(projectId, runId, options.io) : null;
109
- let mainRunId = null;
110
- let transcriptRuns;
111
- const resources = { environment: null, leaseRelease: null, workspace: null };
112
- let workerError;
113
- let activeState = state;
114
- let phase = 'preflight';
115
- let agentStarted = false;
116
- let invocationRunId = null;
117
- try {
118
- measurements?.enter('preparation');
119
- activeState = await recoverEpicPlanningInvocationCleanup(projectId, runId, activeState);
120
- const beforeAdmission = assertCurrent(projectId, runId, activeState);
121
- assertEpicPlanningFirstWave(projectId, runId, activeState);
122
- assertEpicPlanningRecoveryAvailable(activeState.recovery);
123
- if (state.purpose !== 'initial_roadmap') {
124
- assertEpicWaveResourcesReady(projectId, state.epic_id);
125
- }
126
- const acceptedVersion = await prepareEpicTargetAdmission(projectId, state.epic_id, beforeAdmission.version);
127
- const epic = db.transaction(() => {
128
- const current = assertCurrent(projectId, runId, activeState);
129
- if (current.version !== acceptedVersion) {
130
- fail(epicPlanningMessage('staleRun'));
131
- }
132
- return recordEpicTargetAdmission(projectId, state.epic_id, { advanceVersion: true });
133
- }).immediate();
134
- const project = { ...getProjectById(projectId) };
135
- activeState = compareSetEpicPlanningState(projectId, runId, activeState.generation, { ...activeState, generation: activeState.generation + 1 });
136
- transitionExecutionRun({ projectId, runId, status: 'running', domainStatus: 'planning', eventType: 'epic_planning_started' }, options.io);
137
- const preparingReadiness = state.purpose === 'prepare_readiness';
138
- const firstWave = isEpicPlanningFirstWave(activeState);
139
- const readiness = preparingReadiness
140
- ? createReadinessPlanningContext(db, projectId, state.epic_id, state.revision_id, runId, options.io, measurements) : null;
141
- const readinessInspection = readiness?.inspection;
142
- const evidence = state.purpose === 'initial_roadmap' || preparingReadiness || firstWave ? null : await reconcile(projectId, runId, activeState, 'preflight');
143
- const deliveryCatalog = firstWave || preparingReadiness ? [] : epicPlanningDeliveryEvidenceCatalog(projectId, activeState);
144
- const lockedTarget = requireEpicTarget(projectId, state.epic_id);
145
- const initialTarget = evidence ? null : await observeReservedEpicTarget(project, lockedTarget.identity);
146
- assertCurrent(projectId, runId, activeState);
147
- if (initialTarget || evidence) {
148
- activeState = compareSetEpicPlanningState(projectId, runId, activeState.generation, {
149
- ...activeState, generation: activeState.generation + 1, initial_target_observation: (evidence?.target ?? initialTarget),
150
- });
151
- }
152
- const assertPlanningTarget = async () => {
153
- const observed = initialTarget ? await observeReservedEpicTarget(project, lockedTarget.identity) : null;
154
- assertCurrent(projectId, runId, activeState);
155
- const currentProject = getProjectById(projectId);
156
- const currentTarget = requireEpicTarget(projectId, state.epic_id);
157
- if (currentProject?.repo_path !== project.repo_path || currentTarget.lock_id !== lockedTarget.lock_id
158
- || !isDeepStrictEqual(currentTarget.identity, lockedTarget.identity)
159
- || (initialTarget && !isDeepStrictEqual(initialTarget, observed))) {
160
- fail(epicPlanningMessage('evidenceConflict'));
161
- }
162
- };
163
- assertCurrent(projectId, runId, activeState);
164
- if (state.roadmap_bundle_id && !firstWave) {
165
- const admission = state.attempt_id && getEpicWavePlanningAdmission({ project_id: projectId,
166
- epic_id: state.epic_id, planning_attempt_id: state.attempt_id });
167
- if (!admission || !admission.contribution_aware) {
168
- assertEpicStepEligible(evidence, state.roadmap_bundle_id);
169
- }
170
- assertEpicPlanningStepReconciled(evidence, activeState.verification_policy);
171
- }
172
- const sealed = state.attempt_id && listEpicExecutionPlans(state.epic_id, projectId)
173
- .find(plan => plan.planning_attempt_id === state.attempt_id && plan.planning_key === runId);
174
- const sealedWave = state.attempt_id && listEpicWaves(state.epic_id, projectId)
175
- .find(wave => wave.planning_attempt_id === state.attempt_id && wave.idempotency_key === runId);
176
- const residualReport = state.wave_admission && !firstWave ? epicPlanningResidualReport(projectId, activeState) : null;
177
- const remaining = state.wave_admission ? epicPlanningRemainingCoverage(projectId, activeState) : [];
178
- const allResidualsBlocked = residualReport && areAllEpicResidualsBlocked(remaining, residualReport);
179
- if (allResidualsBlocked && !sealedWave && !sealed) {
180
- activeState = completeEpicParkedProgress(projectId, runId, activeState, remaining, residualReport, options.io);
181
- return;
182
- }
183
- const invokePlanner = async (correction) => {
184
- measurements?.enter('preparation');
185
- if (!agentStarted) {
186
- assertEpicPlanningRecoveryAvailable(activeState.recovery);
187
- }
188
- if (!resources.environment) {
189
- phase = 'preparation';
190
- if (initialTarget) {
191
- await fetchObservedEpicTargetCommit(project, lockedTarget.identity, initialTarget.commit_sha);
192
- assertCurrent(projectId, runId, activeState);
193
- await assertPlanningTarget();
194
- }
195
- const invocation = beginEpicPlanningInvocation(projectId, runId, activeState, project.repo_path, options.io);
196
- activeState = invocation.state;
197
- invocationRunId = invocation.run.id;
198
- resources.workspace = await prepareEpicPlanningWorkspace(project, invocationRunId, (evidence?.target ?? initialTarget).commit_sha);
199
- resources.environment = await resolveWorkloadExecutionEnvironment({ project, executionRunId: invocationRunId,
200
- agent: state.planner.agent, model: state.planner.model, skills: [], target: resources.workspace.target, workload: 'spec',
201
- onLeaseAcquired: release => { resources.leaseRelease = release; },
202
- });
203
- resources.leaseRelease = null;
204
- }
205
- assertCurrent(projectId, runId, activeState);
206
- await assertPlanningTarget();
207
- const target = resources.workspace.target;
208
- const environment = resources.environment;
209
- const structural = isEpicArtifactRepairError(correction?.error);
210
- const label = epicPlanningMessage(correction ? structural ? 'artifactRepairLabel' : 'assessmentRepairLabel' : 'plannerLabel');
211
- mainRunId = createAgentRun({ executionRunId: invocationRunId, parentType: 'epic', parentId: epic.id, label, role: 'main' });
212
- const invocation = getExecutionRun(projectId, invocationRunId);
213
- const prompt = readiness ? await readiness.prompt(correction) : buildEpicPlanningPrompt(projectId, epic, activeState, evidence, target.workspacePath, run?.metadata?.epic_reconciliation_evidence_only === true);
214
- const effectivePrompt = readiness ? prompt
215
- : correction ? isEpicArtifactRepairError(correction.error)
216
- ? buildEpicArtifactRepairPrompt(prompt, correction.output, correction.error)
217
- : buildEpicAssessmentRepairPrompt(prompt, correction.output, correction.error) : prompt;
218
- if (!agentStarted) {
219
- assertEpicPlanningRecoveryAvailable(activeState.recovery);
220
- }
221
- agentStarted = true;
222
- readiness?.started(effectivePrompt, Boolean(correction));
223
- const result = await options.runAgent({ parentType: 'epic', specSessionId: epic.id,
224
- tool: state.planner.agent, model: state.planner.model, variant: state.planner.variant, skills: [],
225
- prompt: effectivePrompt,
226
- cwd: target.workspacePath, resumeSessionId: null, io: options.io,
227
- executionContext: { runId: invocationRunId, projectId, correlationId: invocation.correlation_id, kind: 'epic_plan' },
228
- mainRun: { id: mainRunId, label, role: 'main', runIndex: getNextAgentRunIndex(invocationRunId) - 1 },
229
- executionProvider: environment.provider, executionTarget: target,
230
- executionLauncherEnvironment: environment.launcherEnvironment, executionRuntimeEnvironment: environment.runtimeEnvironment,
231
- opencodeRuntimeIdentity: environment.opencodeRuntimeIdentity, });
232
- transcriptRuns = [...(transcriptRuns ?? []), ...(result.transcriptRuns ?? [])];
233
- readiness?.received(result.finalResponse);
234
- return result;
235
- };
236
- let result;
237
- const retainedOutput = activeState.pending_output && readEpicPlanningOutput(runId, activeState.pending_output);
238
- const retainedArtifact = retainedOutput && !preparingReadiness ? parseEpicPlanningOutput(retainedOutput, state.purpose) : null;
239
- const replayOutput = retainedOutput && activeState.pending_output?.evidence_digest === epicPlanningEvidenceDigest(evidence, retainedArtifact?.artifact?.kind === 'completion', activeState);
240
- if (replayOutput) {
241
- mainRunId = activeState.pending_output.agent_run_id;
242
- result = { completionStatus: 'done', finalResponse: retainedOutput };
243
- }
244
- else if (sealedWave) {
245
- result = { completionStatus: 'done', finalResponse: epicPlanningWaveOutput(sealedWave) };
246
- }
247
- else if (sealed) {
248
- const attempt = getEpicAttempt(state.attempt_id, state.epic_id, projectId);
249
- if (!['pending', 'running'].includes(attempt.status)) {
250
- fail(epicPlanningMessage('materializationConflict'));
251
- }
252
- // Recovery consumes the sealed inventory; never ask the planner to regenerate it.
253
- result = { completionStatus: 'done', finalResponse: `<archon-epic-artifact>${JSON.stringify({
254
- kind: 'step', roadmap_bundle_id: sealed.package_id, summary: sealed.summary,
255
- tickets: sealed.tickets, dependencies: sealed.dependencies, coverage: sealed.coverage,
256
- })}</archon-epic-artifact>` };
257
- }
258
- else {
259
- if (activeState.assessment_repair) {
260
- throw new Error(epicPlanningMessage('assessmentRepairInterrupted'));
261
- }
262
- if (activeState.artifact_repair) {
263
- throw new Error(epicPlanningMessage('artifactRepairInterrupted'));
264
- }
265
- if (activeState.pending_output) {
266
- activeState = compareSetEpicPlanningState(projectId, runId, activeState.generation, {
267
- ...activeState, generation: activeState.generation + 1, pending_output: undefined,
268
- });
269
- }
270
- result = await invokePlanner();
271
- }
272
- assertCurrent(projectId, runId, activeState);
273
- const stop = (result) => {
274
- if (run?.metadata?.epic_automatic) {
275
- throw new HttpError(409, epicPlanningMessage('interruptedProposal'), 'epic_planning_stopped');
276
- }
277
- terminalizePlanAttempt(projectId, state, 'cancelled');
278
- if (state.proposal_owner) {
279
- closeEpicProposalOwner(state.proposal_owner);
280
- }
281
- if (mainRunId) {
282
- finalizeAgentRun(mainRunId, 'stopped', result.finalResponse ?? null);
283
- }
284
- transitionExecutionRun({ projectId, runId, status: 'cancelled', domainStatus: 'stopped', eventType: 'epic_planning_stopped' }, options.io);
285
- };
286
- if (result.completionStatus === 'stopped') {
287
- stop(result);
288
- return;
289
- }
290
- let output = result.finalResponse?.trim();
291
- if (!output) {
292
- throw new Error(epicPlanningMessage('emptyOutput'));
293
- }
294
- if (preparingReadiness) {
295
- measurements?.enter('validation');
296
- const readinessOutput = output;
297
- await completeReadinessPlanningTurn({ output, repairConsumed: Boolean(activeState.artifact_repair),
298
- complete: async (candidate) => {
299
- await assertPlanningTarget();
300
- await completeEpicReadinessPreparation(db, { projectId, runId, state: activeState,
301
- snapshotDigest: readinessInspection.snapshot_digest, output: candidate, target: initialTarget, mainRunId, io: options.io });
302
- },
303
- consumeRepair: () => {
304
- activeState = compareSetEpicPlanningState(projectId, runId, activeState.generation, { ...activeState,
305
- generation: activeState.generation + 1, artifact_repair: { attempts: 1, evidence_digest: readinessInspection.snapshot_digest } });
306
- },
307
- correct: (error, readinessRepair) => {
308
- if (mainRunId) {
309
- finalizeAgentRun(mainRunId, 'error', readinessOutput, error.message);
310
- }
311
- return invokePlanner({ output: readinessOutput, readinessRepair,
312
- error: new EpicArtifactValidationError('readiness_analysis', error.message) });
313
- },
314
- assertCurrent: () => { assertCurrent(projectId, runId, activeState); }, stop, });
315
- return;
316
- }
317
- let parsed;
318
- const validateCandidate = async (candidate) => {
319
- // Authority failures are not candidate mistakes and cannot enter correction.
320
- assertEpicPlanningFirstWave(projectId, runId, activeState, candidate.artifact);
321
- assertEpicPlanningOutputAuthority(projectId, runId, activeState, candidate.artifact);
322
- if (candidate.artifact?.kind === 'wave' && activeState.wave_admission) {
323
- const artifact = candidate.artifact;
324
- const admission = activeState.wave_admission;
325
- await withEpicTargetObservation(projectId, state.epic_id, () => {
326
- assertEpicPlanningWaveContributions(projectId, activeState, artifact);
327
- assertEpicPlanningWaveCandidate(artifact, admission, epicPlanningWaveHistory(projectId, activeState).map(entry => entry.package_id));
328
- assertEpicPlanningClosure(artifact, admission.closure_contract_version, () => epicPlanningRemainingCoverage(projectId, activeState));
329
- });
330
- }
331
- };
332
- try {
333
- parsed = parseEpicPlanningOutput(output, state.purpose);
334
- await validateCandidate(parsed);
335
- }
336
- catch (error) {
337
- if (!isEpicArtifactRepairError(error) || activeState.artifact_repair
338
- || replayOutput || sealedWave || sealed || !agentStarted) {
339
- throw error;
340
- }
341
- // Consume the budget before the provider call, including if it is interrupted.
342
- activeState = compareSetEpicPlanningState(projectId, runId, activeState.generation, {
343
- ...activeState, generation: activeState.generation + 1,
344
- artifact_repair: { attempts: 1, evidence_digest: epicPlanningEvidenceDigest(evidence, false, activeState) },
345
- });
346
- if (mainRunId) {
347
- finalizeAgentRun(mainRunId, 'error', output, error.message);
348
- }
349
- const rejected = output;
350
- result = await invokePlanner({ output, error });
351
- assertCurrent(projectId, runId, activeState);
352
- if (result.completionStatus === 'stopped') {
353
- stop(result);
354
- return;
355
- }
356
- output = result.finalResponse?.trim();
357
- if (!output) {
358
- throw new Error(epicPlanningMessage('emptyOutput'));
359
- }
360
- parsed = parseEpicPlanningOutput(output, state.purpose);
361
- assertEpicArtifactRepairScope(rejected, parsed.artifact, state.purpose, error);
362
- await validateCandidate(parsed);
363
- }
364
- if (parsed.artifact?.kind === 'wave' && !firstWave) {
365
- const proposals = parsed.artifact.residual_diagnostics ?? activeState.residual_proposals;
366
- if (proposals) {
367
- activeState = compareSetEpicPlanningState(projectId, runId, activeState.generation, {
368
- ...activeState, generation: activeState.generation + 1, residual_proposals: proposals,
369
- });
370
- }
371
- const report = epicPlanningResidualReport(projectId, activeState, proposals);
372
- if (report && !sealedWave && !sealed) {
373
- const filtered = filterEpicResidualWave(parsed.artifact, report);
374
- if (!filtered.units.length) {
375
- activeState = completeEpicParkedProgress(projectId, runId, activeState, filtered.residual_coverage, report, options.io);
376
- if (mainRunId) {
377
- finalizeAgentRun(mainRunId, 'done', output);
378
- }
379
- return;
380
- }
381
- parsed = { text: parsed.text, questionSet: null, artifact: filtered };
382
- }
383
- }
384
- phase = 'publication';
385
- if (mainRunId && parsed.artifact && !activeState.pending_output) {
386
- activeState = compareSetEpicPlanningState(projectId, runId, activeState.generation, {
387
- ...activeState, generation: activeState.generation + 1,
388
- pending_output: saveEpicPlanningOutput(mainRunId, output, epicPlanningEvidenceDigest(evidence, parsed.artifact.kind === 'completion', activeState)),
389
- });
390
- }
391
- if (!firstWave && parsed.artifact?.kind === 'unchanged' && parsed.artifact.capability_checks?.length) {
392
- const { executeEpicPlanningCapabilityChecks } = await import('./epicPlanningCapabilityVerification.js');
393
- activeState = compareSetEpicPlanningState(projectId, runId, activeState.generation, {
394
- ...activeState, generation: activeState.generation + 1, initial_target_observation: (evidence?.target ?? initialTarget),
395
- });
396
- await executeEpicPlanningCapabilityChecks(projectId, runId, activeState, parsed.artifact.capability_checks, options.io);
397
- }
398
- // Re-read live evidence after the potentially long provider call. Target and
399
- // ownership must remain current; check-only changes do not invalidate a plan.
400
- const refreshEvidence = async () => {
401
- const fresh = evidence ? await reconcile(projectId, runId, activeState, 'post_agent') : null;
402
- if (fresh) {
403
- retainEpicWaveReconciliationObservations(fresh);
404
- }
405
- assertCurrent(projectId, runId, activeState);
406
- assertEpicPlanningFirstWave(projectId, runId, activeState, parsed.artifact);
407
- await assertPlanningTarget();
408
- if (evidence && fresh && !isDeepStrictEqual(comparableEpicPlanningEvidence(evidence, parsed.artifact?.kind === 'completion'), comparableEpicPlanningEvidence(fresh, parsed.artifact?.kind === 'completion')) || !firstWave && !isDeepStrictEqual(deliveryCatalog, epicPlanningDeliveryEvidenceCatalog(projectId, activeState))) {
409
- throw new Error(epicPlanningMessage('evidenceConflict'));
410
- }
411
- return fresh;
412
- };
413
- let freshEvidence = await refreshEvidence();
414
- const applyAssessments = () => {
415
- if (firstWave) {
416
- return;
417
- }
418
- const artifact = parsed.artifact;
419
- if (artifact?.kind === 'unchanged' || artifact?.kind === 'roadmap') {
420
- assertEpicWaveResourcesReady(projectId, state.epic_id);
421
- // Invalid candidates roll back the entire batch before any correction.
422
- db.transaction(() => {
423
- assertCurrent(projectId, runId, activeState);
424
- applyEpicPlanningWaveAssessments(projectId, runId, activeState, artifact.wave_assessments ?? []);
425
- assertFreshEpicResidualDiagnostics(projectId, runId, activeState, artifact.wave_assessments ?? []);
426
- }).immediate();
427
- }
428
- };
429
- try {
430
- applyAssessments();
431
- }
432
- catch (error) {
433
- if (!canRepairEpicDeliveryAssessment(error) || activeState.assessment_repair) {
434
- throw error;
435
- }
436
- const original = parsed.artifact;
437
- const evidenceDigest = epicPlanningEvidenceDigest(evidence, false, activeState);
438
- // Consume the budget durably before any provider preparation or invocation.
439
- activeState = compareSetEpicPlanningState(projectId, runId, activeState.generation, {
440
- ...activeState, generation: activeState.generation + 1,
441
- assessment_repair: { attempts: 1, evidence_digest: evidenceDigest },
442
- });
443
- if (mainRunId) {
444
- finalizeAgentRun(mainRunId, 'error', output, error.message);
445
- }
446
- result = await invokePlanner({ output, error });
447
- assertCurrent(projectId, runId, activeState);
448
- if (result.completionStatus === 'stopped') {
449
- stop(result);
450
- return;
451
- }
452
- output = result.finalResponse?.trim();
453
- if (!output) {
454
- throw new Error(epicPlanningMessage('emptyOutput'));
455
- }
456
- parsed = parseEpicPlanningOutput(output, state.purpose);
457
- assertEpicPlanningOutputAuthority(projectId, runId, activeState, parsed.artifact);
458
- assertEpicAssessmentRepairScope(original, parsed.artifact);
459
- activeState = compareSetEpicPlanningState(projectId, runId, activeState.generation, {
460
- ...activeState, generation: activeState.generation + 1,
461
- pending_output: saveEpicPlanningOutput(mainRunId, output, evidenceDigest),
462
- });
463
- freshEvidence = await refreshEvidence();
464
- phase = 'publication';
465
- applyAssessments();
466
- }
467
- if (parsed.questionSet) {
468
- db.transaction(() => {
469
- assertCurrent(projectId, runId, activeState);
470
- const question = { ...parsed.questionSet, id: randomUUID() };
471
- const message = appendEpicMessage({ ...scope(projectId, epic.id), role: 'assistant',
472
- transcript_runs: transcriptRuns,
473
- content: [parsed.text, formatAskQuestionMessage(question)].filter(Boolean).join('\n\n'), attempt_id: state.attempt_id ?? undefined });
474
- compareSetEpicPlanningState(projectId, runId, activeState.generation, {
475
- ...activeState, generation: activeState.generation + 1, question, question_message_id: message.id,
476
- scope_fingerprint: fingerprint(requireEpic(projectId, epic.id)),
477
- });
478
- if (mainRunId) {
479
- finalizeAgentRun(mainRunId, 'done', output);
480
- }
481
- transitionExecutionRun({ projectId, runId, status: 'waiting', domainStatus: 'questions_pending', eventType: 'epic_questions_pending' }, options.io);
482
- }).immediate();
483
- }
484
- else {
485
- const artifact = parsed.artifact;
486
- const publish = (materialized, waveResult) => db.transaction(() => {
487
- assertCurrent(projectId, runId, activeState);
488
- assertEpicPlanningFirstWave(projectId, runId, activeState, artifact);
489
- const current = getEpicPlanningState(projectId, runId);
490
- if (current.generation !== activeState.generation) {
491
- fail(epicPlanningMessage('publicationConflict'));
492
- }
493
- if (!firstWave && (artifact.kind === 'unchanged' || artifact.kind === 'roadmap')) {
494
- if (freshEvidence) {
495
- refreshEpicPlanningSettlement(freshEvidence);
496
- }
497
- assertEpicWaveAssessmentsComplete(projectId, state.epic_id);
498
- if (freshEvidence && activeState.verification_policy?.mode !== 'pr_reviewed') {
499
- recordEpicWaveReconciliations(freshEvidence);
500
- }
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 { residualReport, response } = epicPlanningPublicationResponse(projectId, activeState, artifact, parsed.text, freshEvidence);
515
- const appendResultMessage = () => appendEpicMessage({ ...scope(projectId, epic.id), role: 'assistant', content: response,
516
- transcript_runs: transcriptRuns,
517
- attempt_id: state.attempt_id ?? undefined });
518
- const roadmapMessage = artifact.kind === 'roadmap' ? appendResultMessage() : null;
519
- const outcome = waveResult ? completeEpicPlanningWave(projectId, activeState, waveResult)
520
- : applyArtifact(projectId, runId, activeState, artifact, freshEvidence, materialized);
521
- const message = roadmapMessage ?? appendResultMessage();
522
- const reconciliation = reconciliationEvidence && evidenceMessage
523
- ? createEpicPlanningReconciliationProof(reconciliationEvidence, evidenceMessage.id, requireEpic(projectId, epic.id).current_revision_id)
524
- : null;
525
- const requestedAt = new Date().toISOString();
526
- compareSetEpicPlanningState(projectId, runId, activeState.generation, {
527
- ...activeState, generation: activeState.generation + 1, result: { ...outcome, message_id: message.id },
528
- recovery: undefined, pending_output: undefined,
529
- reconciliation,
530
- ...(['resume_reconciliation', 'post_merge_reconciliation'].includes(activeState.purpose) && activeState.instruction.trim()
531
- ? { residual_reevaluation: { requested_at: requestedAt, assessment_boundary: residualReport?.history.filter(entry => entry.created_at === requestedAt)
532
- .map(({ wave_id, assessment_id }) => ({ wave_id, assessment_id })) ?? [] } }
533
- : {}),
534
- ...(waveResult ? { wave_reference: { wave_id: waveResult.wave.id, digest: waveResult.wave.digest } } : {}),
535
- scope_fingerprint: fingerprint(requireEpic(projectId, epic.id)),
536
- });
537
- if (mainRunId) {
538
- finalizeAgentRun(mainRunId, 'done', output);
539
- }
540
- transitionExecutionRun({ projectId, runId, status: 'completed', domainStatus: outcome.kind, eventType: 'epic_planning_completed' }, options.io);
541
- if (outcome.kind === 'unchanged') {
542
- recordEpicPlanningSemanticInput(requireEpic(projectId, epic.id), runId);
543
- }
544
- }).immediate();
545
- if (artifact.kind === 'wave') {
546
- phase = 'materialization';
547
- const materialized = await prepareEpicPlanningWave(projectId, runId, activeState, artifact, freshEvidence, () => { assertCurrent(projectId, runId, activeState); }, result => publish(null, result));
548
- broadcastEpicReferences(projectId, state.epic_id, options.io);
549
- for (const member of materialized.members) {
550
- for (const dependency of member.createdDependencies) {
551
- options.io.emit('ticket-dependency:created', dependency);
552
- }
553
- }
554
- }
555
- else if (artifact.kind === 'step') {
556
- phase = 'materialization';
557
- const materialized = await prepareStep(projectId, runId, activeState, artifact, freshEvidence, publish);
558
- broadcastEpicReferences(projectId, state.epic_id, options.io);
559
- for (const dependency of materialized.createdDependencies) {
560
- options.io.emit('ticket-dependency:created', dependency);
561
- }
562
- }
563
- else if (artifact.kind === 'completion') {
564
- await withEpicTargetObservation(projectId, state.epic_id, () => publish(null));
565
- }
566
- else if (activeState.verification_policy?.mode === 'pr_reviewed'
567
- || listEpicWaves(state.epic_id, projectId).some(wave => wave.contribution_selection)) {
568
- await withEpicTargetObservation(projectId, state.epic_id, () => publish(null));
569
- }
570
- else {
571
- publish(null);
572
- }
573
- }
574
- }
575
- catch (error) {
576
- measurements?.enter('validation');
577
- workerError = error;
578
- if (!isEpicVerificationPolicyCurrent(projectId, state.epic_id, activeState.verification_policy)) {
579
- // Cleanup in finally owns the lifetime. Stale output cannot spend a
580
- // correction budget, publish failure prose or block the whole Epic.
581
- return;
582
- }
583
- const liveEpic = getEpic(state.epic_id, projectId);
584
- const liveRun = getExecutionRun(projectId, runId);
585
- if (liveRun && getEpicPlanningState(projectId, runId).generation !== activeState.generation) {
586
- // A recovered successor owns all publication/failure authority now.
587
- return;
588
- }
589
- let ownerActive = true;
590
- try {
591
- if (state.proposal_owner) {
592
- assertActiveEpicProposalOwner(state.proposal_owner);
593
- }
594
- }
595
- catch {
596
- ownerActive = false;
597
- }
598
- if (ownerActive && liveEpic && ['paused', 'cancelled'].includes(liveEpic.execution_intent)
599
- && liveRun && ['queued', 'running', 'waiting'].includes(liveRun.status)) {
600
- if (mainRunId) {
601
- finalizeAgentRun(mainRunId, 'stopped', null);
602
- }
603
- transitionExecutionRun({ projectId, runId, status: 'waiting', domainStatus: 'epic_paused' }, options.io);
604
- return;
605
- }
606
- if (ownerActive && liveRun?.metadata?.epic_automatic && liveEpic && !liveEpic.blockers.length
607
- && !['paused', 'cancelled'].includes(liveEpic.execution_intent)
608
- && (!liveEpic.settings.auto_plan_next_bundle || liveEpic.execution_intent !== 'running')) {
609
- if (mainRunId) {
610
- finalizeAgentRun(mainRunId, 'stopped', null);
611
- }
612
- transitionExecutionRun({ projectId, runId, status: 'waiting', domainStatus: 'policy_wait' }, options.io);
613
- return;
614
- }
615
- const { message, failureCode, failure, failureDetails } = describeEpicPlanningFailure(error, activeState.recovery, agentStarted, isInternalAgentOutput(invocationRunId ?? runId));
616
- const sealedWave = state.attempt_id && listEpicWaves(state.epic_id, projectId)
617
- .find(wave => wave.planning_attempt_id === state.attempt_id && wave.idempotency_key === runId);
618
- const waveOwner = sealedWave && getEpicAttempt(sealedWave.planning_attempt_id, state.epic_id, projectId);
619
- if (ownerActive && sealedWave && waveOwner && ['pending', 'running'].includes(waveOwner.status)
620
- && liveEpic?.current_revision_id === activeState.revision_id && fingerprint(liveEpic) === activeState.scope_fingerprint
621
- && liveRun && ['running', 'waiting'].includes(liveRun.status)
622
- && !getEpicWavePublication({ project_id: projectId, epic_id: state.epic_id, wave_id: sealedWave.id })) {
623
- if (error instanceof EpicWaveStaleTargetError) {
624
- const interrupted = interruptStaleAutomaticEpicPlanning(projectId, runId, activeState, sealedWave, error, options.io);
625
- if (interrupted) {
626
- activeState = interrupted;
627
- if (mainRunId) {
628
- finalizeAgentRun(mainRunId, 'stopped', null, message);
629
- }
630
- terminalizeAgentRunsForExecutionRun(runId, 'stopped', message);
631
- return;
632
- }
633
- retireStaleEpicWave({ project_id: projectId, epic_id: state.epic_id, wave_id: sealedWave.id,
634
- planning_attempt_id: sealedWave.planning_attempt_id, wave_digest: sealedWave.digest,
635
- observed_target_sha: error.observedTargetSha });
636
- }
637
- }
638
- if (ownerActive && liveEpic && liveRun && ['queued', 'running', 'waiting'].includes(liveRun.status)
639
- && liveEpic.current_revision_id === activeState.revision_id && fingerprint(liveEpic) === activeState.scope_fingerprint) {
640
- const deferred = deferEpicPlanningFailure({ projectId, runId, state: activeState, error, phase, agentStarted,
641
- sealedInventory: Boolean(sealedWave && isActiveEpicWave(sealedWave) && !(error instanceof EpicWaveStaleTargetError)), io: options.io });
642
- if (deferred) {
643
- activeState = deferred;
644
- return;
645
- }
646
- }
647
- if (ownerActive && state.proposal_owner) {
648
- try {
649
- failEpicProposalOwner(state.proposal_owner, failure);
650
- }
651
- catch {
652
- // Concurrent closure or deletion retains its terminal ownership record.
653
- }
654
- }
655
- try {
656
- terminalizePlanAttempt(projectId, state, 'failed', message);
657
- }
658
- catch {
659
- // Execution failure must survive a deleted project or concurrent recovery.
660
- }
661
- if (mainRunId) {
662
- finalizeAgentRun(mainRunId, 'error', null, message);
663
- }
664
- terminalizeAgentRunsForExecutionRun(runId, 'error', message);
665
- const run = getExecutionRun(projectId, runId);
666
- if (run && ['queued', 'running', 'waiting'].includes(run.status)) {
667
- try {
668
- db.transaction(() => {
669
- const current = getEpicPlanningState(projectId, runId);
670
- const epic = getEpic(state.epic_id, projectId);
671
- const project = getProjectById(projectId);
672
- if (ownerActive && current.generation === activeState.generation && epic && project && !project.deletion_started_at
673
- && epic.current_revision_id === activeState.revision_id && fingerprint(epic) === activeState.scope_fingerprint) {
674
- if (mainRunId) {
675
- appendEpicMessage({ ...scope(projectId, epic.id), role: 'assistant', content: failure,
676
- attempt_id: state.attempt_id ?? undefined,
677
- transcript_runs: isInternalAgentOutput(invocationRunId ?? runId)
678
- ? undefined : getAgentErrorTranscriptRuns(error) ?? transcriptRuns });
679
- }
680
- updateEpicProgress({ ...scope(projectId, epic.id), phase: 'blocked', blockers: [...epic.blockers, {
681
- id: `planning-failure-${runId}`, kind: 'failure', message: failure,
682
- ...(activeState.artifact_repair && activeState.purpose === 'next_bundle' && activeState.roadmap_bundle_id
683
- && (error instanceof EpicArtifactValidationError || error instanceof EpicWaveCandidateValidationError)
684
- ? { scope: { kind: 'package', package_id: activeState.roadmap_bundle_id } } : {}),
685
- ...(failureCode ? { code: failureCode } : {}),
686
- }] });
687
- }
688
- }).immediate();
689
- }
690
- catch {
691
- // Concurrent recovery/deletion must not prevent execution finalization.
692
- }
693
- try {
694
- const current = getEpicPlanningState(projectId, runId);
695
- if (current.generation === activeState.generation) {
696
- compareSetEpicPlanningState(projectId, runId, current.generation, {
697
- ...current, generation: current.generation + 1, failure,
698
- });
699
- }
700
- }
701
- catch {
702
- // A full question context cannot roll back the actionable blocker. The
703
- // same localized failure remains durable on the execution below.
704
- }
705
- transitionExecutionRun({ projectId, runId, status: 'failed', domainStatus: 'planning_failed',
706
- failure: { code: failureCode ?? 'epic_planning_failed', message: failure,
707
- ...(Object.keys(failureDetails).length ? { details: failureDetails } : {}) },
708
- eventMetadata: Object.keys(failureDetails).length ? failureDetails : undefined, eventType: 'epic_planning_failed' }, options.io);
709
- }
710
- throw error;
711
- }
712
- finally {
713
- measurements?.enter('cleanup');
714
- const cleanupErrors = [];
715
- if (invocationRunId) {
716
- retainEpicPlanningInvocationCleanup(projectId, invocationRunId, [resources.environment?.release, resources.leaseRelease], resources.workspace?.release);
717
- try {
718
- finishEpicPlanningInvocation(projectId, runId, invocationRunId, Boolean(workerError) && !getEpicPlanningState(projectId, runId).pending_output, options.io);
719
- }
720
- catch (error) {
721
- cleanupErrors.push(error);
722
- }
723
- try {
724
- activeState = await recoverEpicPlanningInvocationCleanup(projectId, runId, getEpicPlanningState(projectId, runId));
725
- }
726
- catch (error) {
727
- cleanupErrors.push(error);
728
- }
729
- }
730
- if (!isEpicVerificationPolicyCurrent(projectId, state.epic_id, activeState.verification_policy)) {
731
- let retired = false;
732
- if (!cleanupErrors.length) {
733
- try {
734
- retired = await supersedeEpicPlanningRun(projectId, runId, activeState, options.io);
735
- }
736
- catch (error) {
737
- cleanupErrors.push(error);
738
- }
739
- }
740
- const current = getExecutionRun(projectId, runId);
741
- if (!retired && current && ['queued', 'running', 'waiting'].includes(current.status)
742
- && !getEpicPlanningState(projectId, runId).result) {
743
- // Unknown cleanup keeps the exact owner retryable, without granting
744
- // publication or turning superseded work into an Epic-wide failure.
745
- transitionExecutionRun({ projectId, runId, status: 'waiting', domainStatus: 'policy_supersession_cleanup' }, options.io);
746
- }
747
- }
748
- const epic = getEpic(state.epic_id, projectId);
749
- if (epic) {
750
- options.io.emit('epic:updated', epic);
751
- }
752
- emitAgentRunsUpdated(options.io, 'epic', state.epic_id);
753
- measurements?.finish();
754
- if (cleanupErrors.length) {
755
- throw new AggregateError(workerError ? [workerError, ...cleanupErrors] : cleanupErrors, epicPlanningMessage('resourceCleanupFailed'), { cause: workerError ?? cleanupErrors[0] });
756
- }
757
- }
758
- });
759
- trackExecutionWorker(projectId, runId, completion);
760
- void completion.finally(() => {
761
- const current = getExecutionRun(projectId, runId);
762
- if (current?.status === 'completed' || current?.status === 'waiting' && current.domain_status === 'recovery_wait'
763
- || current?.status === 'interrupted' && current.domain_status === 'verification_policy_superseded'
764
- || current?.status === 'interrupted' && current.domain_status === 'target_changed' && current.metadata?.epic_automatic === true) {
765
- scheduleEpicContinuationWake(projectId, state.epic_id);
766
- }
767
- }).catch(() => undefined);
768
- return completion;
769
- };
41
+ export const admitEpicPlanningRun = (...args) => createProductionEpicPlanningWorker().admitEpicPlanningRun(...args);
42
+ export const resolveEpicPlanningQuestions = (...args) => createProductionEpicPlanningWorker().resolveEpicPlanningQuestions(...args);
43
+ export const startEpicPlanningRun = (...args) => createProductionEpicPlanningWorker().startEpicPlanningRun(...args);
770
44
  //# sourceMappingURL=epicPlanning.js.map