@kbediako/codex-orchestrator 0.1.38 → 0.2.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 (311) hide show
  1. package/.agents/plugins/marketplace.json +20 -0
  2. package/README.md +46 -317
  3. package/bin/codex-orchestrator.js +161 -0
  4. package/codex.orchestrator.json +149 -13
  5. package/dist/bin/codex-orchestrator.js +797 -1154
  6. package/dist/orchestrator/src/cli/adapters/CommandBuilder.js +50 -0
  7. package/dist/orchestrator/src/cli/adapters/CommandPlanner.js +22 -4
  8. package/dist/orchestrator/src/cli/adapters/CommandReviewer.js +3 -3
  9. package/dist/orchestrator/src/cli/adapters/CommandTester.js +2 -2
  10. package/dist/orchestrator/src/cli/adapters/cloudFailureDiagnostics.js +295 -11
  11. package/dist/orchestrator/src/cli/coStatusAttachCliShell.js +402 -0
  12. package/dist/orchestrator/src/cli/coStatusCliShell.js +451 -0
  13. package/dist/orchestrator/src/cli/coStatusOperatorAutopilotCliShell.js +120 -0
  14. package/dist/orchestrator/src/cli/codexCliShell.js +119 -0
  15. package/dist/orchestrator/src/cli/codexDefaultsSetup.js +265 -36
  16. package/dist/orchestrator/src/cli/config/delegationConfig.js +317 -5
  17. package/dist/orchestrator/src/cli/config/repoConfigPolicy.js +2 -3
  18. package/dist/orchestrator/src/cli/config/userConfig.js +28 -13
  19. package/dist/orchestrator/src/cli/control/authenticatedControlRouteGate.js +69 -0
  20. package/dist/orchestrator/src/cli/control/authenticatedRouteComposition.js +267 -0
  21. package/dist/orchestrator/src/cli/control/authenticatedRouteController.js +5 -0
  22. package/dist/orchestrator/src/cli/control/authenticatedRouteDispatcher.js +41 -0
  23. package/dist/orchestrator/src/cli/control/compatibilityIssuePresenter.js +1035 -0
  24. package/dist/orchestrator/src/cli/control/confirmationApproveController.js +62 -0
  25. package/dist/orchestrator/src/cli/control/confirmationCreateController.js +69 -0
  26. package/dist/orchestrator/src/cli/control/confirmationIssueConsumeController.js +43 -0
  27. package/dist/orchestrator/src/cli/control/confirmationListController.js +22 -0
  28. package/dist/orchestrator/src/cli/control/confirmationValidateController.js +58 -0
  29. package/dist/orchestrator/src/cli/control/confirmations.js +25 -3
  30. package/dist/orchestrator/src/cli/control/controlActionCancelConfirmation.js +65 -0
  31. package/dist/orchestrator/src/cli/control/controlActionController.js +77 -0
  32. package/dist/orchestrator/src/cli/control/controlActionControllerSequencing.js +161 -0
  33. package/dist/orchestrator/src/cli/control/controlActionExecution.js +142 -0
  34. package/dist/orchestrator/src/cli/control/controlActionFinalization.js +43 -0
  35. package/dist/orchestrator/src/cli/control/controlActionOutcome.js +60 -0
  36. package/dist/orchestrator/src/cli/control/controlActionPreflight.js +476 -0
  37. package/dist/orchestrator/src/cli/control/controlAuthenticatedRouteHandoff.js +57 -0
  38. package/dist/orchestrator/src/cli/control/controlBootstrapAssembly.js +39 -0
  39. package/dist/orchestrator/src/cli/control/controlBootstrapMetadataPersistence.js +16 -0
  40. package/dist/orchestrator/src/cli/control/controlEventTransport.js +49 -0
  41. package/dist/orchestrator/src/cli/control/controlExpiryLifecycle.js +102 -0
  42. package/dist/orchestrator/src/cli/control/controlHostOwnership.js +480 -0
  43. package/dist/orchestrator/src/cli/control/controlHostSupervision.js +630 -0
  44. package/dist/orchestrator/src/cli/control/controlOversightFacade.js +8 -0
  45. package/dist/orchestrator/src/cli/control/controlOversightReadContract.js +1 -0
  46. package/dist/orchestrator/src/cli/control/controlOversightReadService.js +16 -0
  47. package/dist/orchestrator/src/cli/control/controlOversightUpdateContract.js +1 -0
  48. package/dist/orchestrator/src/cli/control/controlPersistenceFiles.js +6 -0
  49. package/dist/orchestrator/src/cli/control/controlQuestionChildResolution.js +18 -0
  50. package/dist/orchestrator/src/cli/control/controlRequestContext.js +42 -0
  51. package/dist/orchestrator/src/cli/control/controlRequestController.js +9 -0
  52. package/dist/orchestrator/src/cli/control/controlRequestPredispatch.js +17 -0
  53. package/dist/orchestrator/src/cli/control/controlRequestRouteDispatch.js +44 -0
  54. package/dist/orchestrator/src/cli/control/controlRuntime.js +1003 -0
  55. package/dist/orchestrator/src/cli/control/controlServer.js +23 -1456
  56. package/dist/orchestrator/src/cli/control/controlServerAuditAndErrorHelpers.js +115 -0
  57. package/dist/orchestrator/src/cli/control/controlServerAuthenticatedRouteBranch.js +29 -0
  58. package/dist/orchestrator/src/cli/control/controlServerBootstrapLifecycle.js +30 -0
  59. package/dist/orchestrator/src/cli/control/controlServerBootstrapStartSequence.js +21 -0
  60. package/dist/orchestrator/src/cli/control/controlServerOwnedRuntimeLifecycle.js +67 -0
  61. package/dist/orchestrator/src/cli/control/controlServerPublicLifecycle.js +756 -0
  62. package/dist/orchestrator/src/cli/control/controlServerPublicRouteHelpers.js +86 -0
  63. package/dist/orchestrator/src/cli/control/controlServerReadyInstanceLifecycle.js +25 -0
  64. package/dist/orchestrator/src/cli/control/controlServerReadyInstanceStartup.js +18 -0
  65. package/dist/orchestrator/src/cli/control/controlServerRequestBodyHelpers.js +37 -0
  66. package/dist/orchestrator/src/cli/control/controlServerRequestShell.js +40 -0
  67. package/dist/orchestrator/src/cli/control/controlServerRequestShellBinding.js +17 -0
  68. package/dist/orchestrator/src/cli/control/controlServerSeedLoading.js +27 -0
  69. package/dist/orchestrator/src/cli/control/controlServerSeededRuntimeAssembly.js +186 -0
  70. package/dist/orchestrator/src/cli/control/controlServerStartupInputPreparation.js +31 -0
  71. package/dist/orchestrator/src/cli/control/controlServerStartupSequence.js +49 -0
  72. package/dist/orchestrator/src/cli/control/controlState.js +233 -2
  73. package/dist/orchestrator/src/cli/control/controlStatusDashboard.js +1904 -0
  74. package/dist/orchestrator/src/cli/control/controlTelegramBridgeBootstrapLifecycle.js +22 -0
  75. package/dist/orchestrator/src/cli/control/controlTelegramBridgeLifecycle.js +67 -0
  76. package/dist/orchestrator/src/cli/control/controlTelegramBridgeOversightFacadeFactory.js +8 -0
  77. package/dist/orchestrator/src/cli/control/controlTelegramCommandController.js +49 -0
  78. package/dist/orchestrator/src/cli/control/controlTelegramDispatchRead.js +40 -0
  79. package/dist/orchestrator/src/cli/control/controlTelegramPollingController.js +89 -0
  80. package/dist/orchestrator/src/cli/control/controlTelegramProjectionNotificationController.js +29 -0
  81. package/dist/orchestrator/src/cli/control/controlTelegramPushState.js +63 -0
  82. package/dist/orchestrator/src/cli/control/controlTelegramQuestionRead.js +13 -0
  83. package/dist/orchestrator/src/cli/control/controlTelegramReadController.js +216 -0
  84. package/dist/orchestrator/src/cli/control/controlTelegramUpdateHandler.js +63 -0
  85. package/dist/orchestrator/src/cli/control/controlWatcher.js +73 -5
  86. package/dist/orchestrator/src/cli/control/delegationRegisterController.js +35 -0
  87. package/dist/orchestrator/src/cli/control/dynamicToolBridgePolicy.js +139 -0
  88. package/dist/orchestrator/src/cli/control/eventsSseController.js +12 -0
  89. package/dist/orchestrator/src/cli/control/linearBudgetState.js +1789 -0
  90. package/dist/orchestrator/src/cli/control/linearDispatchSource.js +1137 -0
  91. package/dist/orchestrator/src/cli/control/linearGraphqlClient.js +150 -0
  92. package/dist/orchestrator/src/cli/control/linearRateLimit.js +102 -0
  93. package/dist/orchestrator/src/cli/control/linearWebhookController.js +499 -0
  94. package/dist/orchestrator/src/cli/control/liveLinearAdvisoryRuntime.js +70 -0
  95. package/dist/orchestrator/src/cli/control/observabilityApiController.js +173 -0
  96. package/dist/orchestrator/src/cli/control/observabilityReadModel.js +500 -0
  97. package/dist/orchestrator/src/cli/control/observabilitySurface.js +284 -0
  98. package/dist/orchestrator/src/cli/control/observabilityUpdateNotifier.js +22 -0
  99. package/dist/orchestrator/src/cli/control/operatorDashboardPresenter.js +252 -0
  100. package/dist/orchestrator/src/cli/control/providerAgentCapacity.js +70 -0
  101. package/dist/orchestrator/src/cli/control/providerControlHostFreshnessGauge.js +1068 -0
  102. package/dist/orchestrator/src/cli/control/providerIntakeState.js +473 -0
  103. package/dist/orchestrator/src/cli/control/providerIssueHandoff.js +6811 -0
  104. package/dist/orchestrator/src/cli/control/providerIssueObservability.js +1348 -0
  105. package/dist/orchestrator/src/cli/control/providerIssueRetryQueue.js +84 -0
  106. package/dist/orchestrator/src/cli/control/providerLinearRuntimeProof.js +588 -0
  107. package/dist/orchestrator/src/cli/control/providerLinearScreenshotProof.js +473 -0
  108. package/dist/orchestrator/src/cli/control/providerLinearWorkerTruth.js +383 -0
  109. package/dist/orchestrator/src/cli/control/providerLinearWorkflowAudit.js +254 -0
  110. package/dist/orchestrator/src/cli/control/providerLinearWorkflowFacade.js +5573 -0
  111. package/dist/orchestrator/src/cli/control/providerLinearWorkflowStates.js +115 -0
  112. package/dist/orchestrator/src/cli/control/providerMergeCloseout.js +1868 -0
  113. package/dist/orchestrator/src/cli/control/providerOperatorAutopilot.js +1580 -0
  114. package/dist/orchestrator/src/cli/control/providerOperatorAutopilotLifecycle.js +154 -0
  115. package/dist/orchestrator/src/cli/control/providerOperatorAutopilotLocalRolloutExecution.js +1006 -0
  116. package/dist/orchestrator/src/cli/control/providerPollingHealth.js +435 -0
  117. package/dist/orchestrator/src/cli/control/providerTerminalCleanup.js +516 -0
  118. package/dist/orchestrator/src/cli/control/providerWorkerHosts.js +191 -0
  119. package/dist/orchestrator/src/cli/control/providerWorkflowConfigStore.js +515 -0
  120. package/dist/orchestrator/src/cli/control/questionChildResolutionAdapter.js +361 -0
  121. package/dist/orchestrator/src/cli/control/questionQueueController.js +181 -0
  122. package/dist/orchestrator/src/cli/control/questionReadRetryDeduplication.js +9 -0
  123. package/dist/orchestrator/src/cli/control/questionReadSequence.js +10 -0
  124. package/dist/orchestrator/src/cli/control/securityViolationController.js +27 -0
  125. package/dist/orchestrator/src/cli/control/selectedRunProjection.js +1885 -0
  126. package/dist/orchestrator/src/cli/control/telegramOversightApiClient.js +48 -0
  127. package/dist/orchestrator/src/cli/control/telegramOversightBridge.js +180 -0
  128. package/dist/orchestrator/src/cli/control/telegramOversightBridgeProjectionDeliveryQueue.js +25 -0
  129. package/dist/orchestrator/src/cli/control/telegramOversightBridgeRuntimeLifecycle.js +45 -0
  130. package/dist/orchestrator/src/cli/control/telegramOversightBridgeStateStore.js +77 -0
  131. package/dist/orchestrator/src/cli/control/telegramOversightControlActionApiClient.js +45 -0
  132. package/dist/orchestrator/src/cli/control/trackerDispatchPilot.js +439 -0
  133. package/dist/orchestrator/src/cli/control/uiDataController.js +34 -0
  134. package/dist/orchestrator/src/cli/control/uiSessionController.js +100 -0
  135. package/dist/orchestrator/src/cli/controlHostCliShell.js +860 -0
  136. package/dist/orchestrator/src/cli/controlHostFreshnessGaugeCliShell.js +129 -0
  137. package/dist/orchestrator/src/cli/controlHostSupervisionCliShell.js +2127 -0
  138. package/dist/orchestrator/src/cli/delegationCliShell.js +62 -0
  139. package/dist/orchestrator/src/cli/delegationServer.js +567 -678
  140. package/dist/orchestrator/src/cli/delegationServerCliShell.js +52 -0
  141. package/dist/orchestrator/src/cli/delegationServerQuestionFlowShell.js +228 -0
  142. package/dist/orchestrator/src/cli/delegationServerToolDispatchShell.js +411 -0
  143. package/dist/orchestrator/src/cli/delegationServerTransport.js +274 -0
  144. package/dist/orchestrator/src/cli/delegationSetup.js +51 -171
  145. package/dist/orchestrator/src/cli/devtoolsCliShell.js +34 -0
  146. package/dist/orchestrator/src/cli/doctor.js +678 -164
  147. package/dist/orchestrator/src/cli/doctorCliRequestShell.js +72 -0
  148. package/dist/orchestrator/src/cli/doctorCliShell.js +138 -0
  149. package/dist/orchestrator/src/cli/doctorUsage.js +119 -15
  150. package/dist/orchestrator/src/cli/exec/experience.js +16 -2
  151. package/dist/orchestrator/src/cli/exec/summary.js +3 -0
  152. package/dist/orchestrator/src/cli/execCliShell.js +51 -0
  153. package/dist/orchestrator/src/cli/flowCliRequestShell.js +44 -0
  154. package/dist/orchestrator/src/cli/flowCliShell.js +239 -0
  155. package/dist/orchestrator/src/cli/frontendTestCliRequestShell.js +80 -0
  156. package/dist/orchestrator/src/cli/frontendTestCliShell.js +41 -0
  157. package/dist/orchestrator/src/cli/init.js +95 -1
  158. package/dist/orchestrator/src/cli/initCliShell.js +50 -0
  159. package/dist/orchestrator/src/cli/linearCliShell.js +1200 -0
  160. package/dist/orchestrator/src/cli/mcpEnableCliShell.js +132 -0
  161. package/dist/orchestrator/src/cli/metrics/metricsAggregator.js +3 -2
  162. package/dist/orchestrator/src/cli/metrics/metricsRecorder.js +56 -0
  163. package/dist/orchestrator/src/cli/orchestrator.js +66 -1376
  164. package/dist/orchestrator/src/cli/planCliShell.js +19 -0
  165. package/dist/orchestrator/src/cli/prCliShell.js +41 -0
  166. package/dist/orchestrator/src/cli/providerLinearChildLanePhaseContract.js +204 -0
  167. package/dist/orchestrator/src/cli/providerLinearChildLaneRunner.js +1835 -0
  168. package/dist/orchestrator/src/cli/providerLinearChildLaneShell.js +2420 -0
  169. package/dist/orchestrator/src/cli/providerLinearChildStreamShell.js +385 -0
  170. package/dist/orchestrator/src/cli/providerLinearWorkerRunner.js +6834 -0
  171. package/dist/orchestrator/src/cli/resumeCliShell.js +14 -0
  172. package/dist/orchestrator/src/cli/reviewCliLaunchShell.js +72 -0
  173. package/dist/orchestrator/src/cli/rlm/alignment.js +3 -3
  174. package/dist/orchestrator/src/cli/rlm/context.js +94 -7
  175. package/dist/orchestrator/src/cli/rlm/rlmCodexRuntimeShell.js +546 -0
  176. package/dist/orchestrator/src/cli/rlm/symbolic.js +4 -2
  177. package/dist/orchestrator/src/cli/rlmCliRequestShell.js +42 -0
  178. package/dist/orchestrator/src/cli/rlmCompletionCliShell.js +46 -0
  179. package/dist/orchestrator/src/cli/rlmLaunchCliShell.js +51 -0
  180. package/dist/orchestrator/src/cli/rlmRunner.js +83 -523
  181. package/dist/orchestrator/src/cli/run/blockMemory.js +500 -0
  182. package/dist/orchestrator/src/cli/run/manifest.js +410 -73
  183. package/dist/orchestrator/src/cli/run/manifestPersister.js +45 -14
  184. package/dist/orchestrator/src/cli/run/runMemoryController.js +216 -0
  185. package/dist/orchestrator/src/cli/run/source0.js +690 -0
  186. package/dist/orchestrator/src/cli/run/workspacePath.js +101 -0
  187. package/dist/orchestrator/src/cli/runtime/mode.js +2 -1
  188. package/dist/orchestrator/src/cli/runtime/provider.js +39 -2
  189. package/dist/orchestrator/src/cli/selfCheckCliShell.js +12 -0
  190. package/dist/orchestrator/src/cli/services/commandRunner.js +698 -18
  191. package/dist/orchestrator/src/cli/services/execRuntime.js +66 -1
  192. package/dist/orchestrator/src/cli/services/orchestratorAutoScoutEvidenceRecorder.js +71 -0
  193. package/dist/orchestrator/src/cli/services/orchestratorCloudBranchResolution.js +8 -0
  194. package/dist/orchestrator/src/cli/services/orchestratorCloudEnvironmentResolution.js +22 -0
  195. package/dist/orchestrator/src/cli/services/orchestratorCloudExecutionLifecycleShell.js +39 -0
  196. package/dist/orchestrator/src/cli/services/orchestratorCloudPromptBuilder.js +37 -0
  197. package/dist/orchestrator/src/cli/services/orchestratorCloudRouteFallbackContract.js +45 -0
  198. package/dist/orchestrator/src/cli/services/orchestratorCloudRouteShell.js +36 -0
  199. package/dist/orchestrator/src/cli/services/orchestratorCloudTargetExecutor.js +277 -0
  200. package/dist/orchestrator/src/cli/services/orchestratorControlPlaneLifecycle.js +98 -0
  201. package/dist/orchestrator/src/cli/services/orchestratorControlPlaneLifecycleShell.js +54 -0
  202. package/dist/orchestrator/src/cli/services/orchestratorExecutionLifecycle.js +112 -0
  203. package/dist/orchestrator/src/cli/services/orchestratorExecutionModePolicy.js +27 -0
  204. package/dist/orchestrator/src/cli/services/orchestratorExecutionRouteAdapterShell.js +59 -0
  205. package/dist/orchestrator/src/cli/services/orchestratorExecutionRouteDecisionShell.js +57 -0
  206. package/dist/orchestrator/src/cli/services/orchestratorExecutionRouteState.js +21 -0
  207. package/dist/orchestrator/src/cli/services/orchestratorExecutionRouter.js +2 -0
  208. package/dist/orchestrator/src/cli/services/orchestratorLocalPipelineExecutor.js +149 -0
  209. package/dist/orchestrator/src/cli/services/orchestratorLocalRouteShell.js +63 -0
  210. package/dist/orchestrator/src/cli/services/orchestratorPlanShell.js +54 -0
  211. package/dist/orchestrator/src/cli/services/orchestratorPlanTargetTracker.js +16 -0
  212. package/dist/orchestrator/src/cli/services/orchestratorResumePreparationShell.js +84 -0
  213. package/dist/orchestrator/src/cli/services/orchestratorResumeTokenValidation.js +15 -0
  214. package/dist/orchestrator/src/cli/services/orchestratorRunLifecycleCompletion.js +31 -0
  215. package/dist/orchestrator/src/cli/services/orchestratorRunLifecycleExecutionRegistration.js +37 -0
  216. package/dist/orchestrator/src/cli/services/orchestratorRunLifecycleOrchestrationShell.js +83 -0
  217. package/dist/orchestrator/src/cli/services/orchestratorRunLifecycleTaskManagerShell.js +37 -0
  218. package/dist/orchestrator/src/cli/services/orchestratorRuntimeManifestMutation.js +20 -0
  219. package/dist/orchestrator/src/cli/services/orchestratorStartPreparationShell.js +56 -0
  220. package/dist/orchestrator/src/cli/services/orchestratorStatusShell.js +70 -0
  221. package/dist/orchestrator/src/cli/services/pipelineResolver.js +7 -3
  222. package/dist/orchestrator/src/cli/services/plannerMemory.js +119 -0
  223. package/dist/orchestrator/src/cli/services/runPreparation.js +7 -3
  224. package/dist/orchestrator/src/cli/services/runSummaryWriter.js +9 -0
  225. package/dist/orchestrator/src/cli/setupBootstrapShell.js +114 -0
  226. package/dist/orchestrator/src/cli/setupCliShell.js +51 -0
  227. package/dist/orchestrator/src/cli/skillsCliShell.js +56 -0
  228. package/dist/orchestrator/src/cli/startCliRequestShell.js +53 -0
  229. package/dist/orchestrator/src/cli/startCliShell.js +68 -0
  230. package/dist/orchestrator/src/cli/statusCliShell.js +22 -0
  231. package/dist/orchestrator/src/cli/utils/authProvenanceFingerprint.js +27 -0
  232. package/dist/orchestrator/src/cli/utils/cloudPreflight.js +285 -7
  233. package/dist/orchestrator/src/cli/utils/codexFeatures.js +60 -0
  234. package/dist/orchestrator/src/cli/utils/delegationConfigParser.js +250 -0
  235. package/dist/orchestrator/src/cli/utils/delegationMcpHealth.js +1382 -0
  236. package/dist/orchestrator/src/cli/utils/devtools.js +2 -54
  237. package/dist/orchestrator/src/cli/utils/mcpServerEntry.js +53 -0
  238. package/dist/orchestrator/src/cli/utils/packageProgramResolver.js +151 -0
  239. package/dist/orchestrator/src/cli/utils/providerOverrideEnv.js +71 -0
  240. package/dist/orchestrator/src/cli/utils/trailingJsonObject.js +59 -0
  241. package/dist/orchestrator/src/learning/crystalizer.js +2 -2
  242. package/dist/orchestrator/src/manager.js +74 -4
  243. package/dist/orchestrator/src/persistence/ExperienceStore.js +233 -49
  244. package/dist/orchestrator/src/persistence/TaskStateStore.js +6 -6
  245. package/dist/orchestrator/src/persistence/lockFile.js +70 -4
  246. package/dist/orchestrator/src/persistence/sanitizeIdentifier.js +39 -0
  247. package/dist/orchestrator/src/sync/createCloudSyncWorker.js +3 -2
  248. package/dist/orchestrator/src/utils/atomicWrite.js +17 -2
  249. package/dist/packages/orchestrator/src/exec/unified-exec.js +99 -6
  250. package/dist/packages/orchestrator/src/instructions/promptPacks.js +150 -19
  251. package/dist/packages/sdk-node/src/orchestrator.js +137 -13
  252. package/dist/packages/shared/config/designConfig.js +8 -1
  253. package/dist/packages/shared/streams/stdio.js +1 -1
  254. package/dist/scripts/design/pipeline/permit.js +15 -0
  255. package/dist/scripts/lib/docs-catalog.js +399 -0
  256. package/dist/scripts/lib/docs-helpers.js +87 -5
  257. package/dist/scripts/lib/pr-watch-merge.js +1088 -80
  258. package/dist/scripts/lib/provider-run-contract.js +26 -0
  259. package/dist/scripts/lib/review-command-intent-classification.js +532 -0
  260. package/dist/scripts/lib/review-command-probe-classification.js +385 -0
  261. package/dist/scripts/lib/review-execution-boundary-preflight.js +279 -0
  262. package/dist/scripts/lib/review-execution-runtime.js +753 -0
  263. package/dist/scripts/lib/review-execution-state.js +1144 -0
  264. package/dist/scripts/lib/review-execution-telemetry.js +215 -0
  265. package/dist/scripts/lib/review-inspection-target-parsing.js +78 -0
  266. package/dist/scripts/lib/review-launch-attempt.js +601 -0
  267. package/dist/scripts/lib/review-meta-surface-boundary-analysis.js +300 -0
  268. package/dist/scripts/lib/review-meta-surface-normalization.js +746 -0
  269. package/dist/scripts/lib/review-non-interactive-handoff.js +61 -0
  270. package/dist/scripts/lib/review-prompt-context.js +376 -0
  271. package/dist/scripts/lib/review-scope-advisory.js +286 -0
  272. package/dist/scripts/lib/review-scope-paths.js +123 -0
  273. package/dist/scripts/lib/review-shell-command-parser.js +389 -0
  274. package/dist/scripts/lib/review-shell-env-interpreter.js +340 -0
  275. package/dist/scripts/lib/run-manifests.js +192 -36
  276. package/dist/scripts/lib/spark-policy-classifier.js +593 -0
  277. package/dist/scripts/run-review.js +507 -1777
  278. package/docs/README.md +43 -20
  279. package/docs/book/README.md +19 -0
  280. package/docs/book/codex-cli-0124-adoption.md +68 -0
  281. package/docs/book/local-hook-impact.md +73 -0
  282. package/docs/book/operations.md +60 -0
  283. package/docs/book/public-posture.md +34 -0
  284. package/docs/book/setup.md +91 -0
  285. package/docs/book/skills.md +11 -0
  286. package/docs/guides/codex-version-policy.md +104 -0
  287. package/docs/public/downstream-setup.md +113 -0
  288. package/docs/public/provider-onboarding.md +173 -0
  289. package/package.json +23 -10
  290. package/plugins/codex-orchestrator/.codex-plugin/plugin.json +30 -0
  291. package/plugins/codex-orchestrator/.mcp.json +13 -0
  292. package/plugins/codex-orchestrator/launcher.mjs +361 -0
  293. package/schemas/manifest.json +411 -0
  294. package/skills/README.md +26 -0
  295. package/skills/collab-subagents-first/SKILL.md +1 -1
  296. package/skills/delegation-usage/DELEGATION_GUIDE.md +30 -12
  297. package/skills/delegation-usage/SKILL.md +25 -14
  298. package/skills/land/SKILL.md +77 -0
  299. package/skills/linear/SKILL.md +255 -0
  300. package/skills/release/SKILL.md +47 -3
  301. package/skills/standalone-review/SKILL.md +6 -1
  302. package/templates/README.md +4 -2
  303. package/templates/codex/.codex/agents/awaiter-high.toml +2 -2
  304. package/templates/codex/.codex/agents/worker-complex.toml +1 -1
  305. package/templates/codex/.codex/config.toml +3 -4
  306. package/templates/codex/.codex/providers/README.md +13 -0
  307. package/templates/codex/.codex/providers/control.example.json +18 -0
  308. package/templates/codex/.codex/providers/provider.env.example +15 -0
  309. package/templates/codex/AGENTS.md +15 -8
  310. package/templates/codex/mcp-client.json +5 -1
  311. package/docs/assets/setup.gif +0 -0
@@ -0,0 +1,361 @@
1
+ #!/usr/bin/env node
2
+
3
+ import { spawn } from 'node:child_process';
4
+ import { existsSync, readFileSync, writeSync } from 'node:fs';
5
+ import { homedir } from 'node:os';
6
+ import { dirname, isAbsolute, join } from 'node:path';
7
+ import process from 'node:process';
8
+
9
+ const FORWARDABLE_SIGNALS = ['SIGINT', 'SIGTERM', 'SIGHUP'];
10
+ const MARKETPLACE_NAME = 'codex-orchestrator';
11
+ const MARKETPLACE_SECTION = `[marketplaces.${MARKETPLACE_NAME}]`;
12
+ const MARKETPLACE_ADD_HELP =
13
+ 'Re-run codex marketplace add for Codex 0.121.0, or codex plugin marketplace add for Codex 0.122.0+.';
14
+ const MARKETPLACE_SECTION_PATTERN = new RegExp(
15
+ `^marketplaces\\s*\\.\\s*(?:"${escapeRegExp(MARKETPLACE_NAME)}"|'${escapeRegExp(MARKETPLACE_NAME)}'|${escapeRegExp(MARKETPLACE_NAME)})$`,
16
+ 'u'
17
+ );
18
+
19
+ function main() {
20
+ const sourceRoot = resolveMarketplaceSourceRoot();
21
+ const entrypoint = join(sourceRoot, 'bin', 'codex-orchestrator.js');
22
+ if (!existsSync(entrypoint)) {
23
+ throw new Error(
24
+ `Codex Orchestrator marketplace source is missing ${entrypoint}. Keep the marketplace source installed. ${MARKETPLACE_ADD_HELP}`
25
+ );
26
+ }
27
+
28
+ const child = spawn(process.execPath, [entrypoint, ...process.argv.slice(2)], {
29
+ env: {
30
+ ...process.env,
31
+ CODEX_ORCHESTRATOR_PACKAGE_ROOT: sourceRoot
32
+ },
33
+ stdio: 'inherit'
34
+ });
35
+
36
+ let forwardedStopSignal = null;
37
+ const disposeSignalForwarding = installSignalForwarding(child, (signal) => {
38
+ forwardedStopSignal ??= signal;
39
+ });
40
+
41
+ child.once('error', (error) => {
42
+ disposeSignalForwarding();
43
+ writeWarning(error instanceof Error ? error.message : String(error));
44
+ process.exitCode = 1;
45
+ });
46
+
47
+ child.once('close', (code, signal) => {
48
+ disposeSignalForwarding();
49
+ if (forwardedStopSignal) {
50
+ reemitSignal(forwardedStopSignal);
51
+ return;
52
+ }
53
+ if (signal) {
54
+ reemitSignal(signal);
55
+ return;
56
+ }
57
+ process.exitCode = typeof code === 'number' ? code : 1;
58
+ });
59
+ }
60
+
61
+ function resolveMarketplaceSourceRoot() {
62
+ const { codexHome, configPath } = resolveCodexPaths();
63
+ if (!existsSync(configPath)) {
64
+ throw new Error(`Unable to locate Codex config at ${configPath}. ${MARKETPLACE_ADD_HELP}`);
65
+ }
66
+
67
+ const raw = readFileSync(configPath, 'utf8');
68
+ const marketplaceConfig = readMarketplaceConfig(raw, configPath);
69
+ const source = marketplaceConfig?.source;
70
+ const sourceType = marketplaceConfig?.sourceType;
71
+ if (!source) {
72
+ throw new Error(
73
+ `Codex config at ${configPath} is missing ${MARKETPLACE_SECTION}. ${MARKETPLACE_ADD_HELP}`
74
+ );
75
+ }
76
+ if (sourceType === 'local') {
77
+ return resolveLocalMarketplaceSourceRoot(source, configPath);
78
+ }
79
+ if (sourceType === 'git') {
80
+ return resolveInstalledMarketplaceSourceRoot(codexHome, source);
81
+ }
82
+ if (sourceType) {
83
+ throw new Error(
84
+ `Codex config at ${configPath} has unsupported ${MARKETPLACE_SECTION}.source_type=${JSON.stringify(sourceType)}. Expected "local" or "git".`
85
+ );
86
+ }
87
+ if (isAbsolute(source)) {
88
+ return source;
89
+ }
90
+ return resolveInstalledMarketplaceSourceRoot(codexHome, source);
91
+ }
92
+
93
+ function resolveLocalMarketplaceSourceRoot(source, configPath) {
94
+ return isAbsolute(source) ? source : join(dirname(configPath), source);
95
+ }
96
+
97
+ function resolveInstalledMarketplaceSourceRoot(codexHome, source) {
98
+ const installedMarketplaceRoot = join(codexHome, '.tmp', 'marketplaces', MARKETPLACE_NAME);
99
+ if (existsSync(installedMarketplaceRoot)) {
100
+ return installedMarketplaceRoot;
101
+ }
102
+ throw new Error(
103
+ `Codex marketplace source resolved to ${JSON.stringify(source)}, but ${installedMarketplaceRoot} is unavailable. ${MARKETPLACE_ADD_HELP}`
104
+ );
105
+ }
106
+
107
+ function resolveCodexPaths() {
108
+ const codexHome = normalizeOptionalString(process.env.CODEX_HOME);
109
+ if (codexHome) {
110
+ return {
111
+ codexHome,
112
+ configPath: join(codexHome, 'config.toml')
113
+ };
114
+ }
115
+ const resolvedCodexHome = join(homedir(), '.codex');
116
+ return {
117
+ codexHome: resolvedCodexHome,
118
+ configPath: join(resolvedCodexHome, 'config.toml')
119
+ };
120
+ }
121
+
122
+ function readMarketplaceConfig(rawConfig, configPath) {
123
+ const marketplaceSectionLines = findMarketplaceSectionLines(rawConfig);
124
+ if (!marketplaceSectionLines) {
125
+ return null;
126
+ }
127
+ const source = normalizeOptionalString(readMarketplaceAssignment(marketplaceSectionLines, 'source', configPath));
128
+ const sourceType = normalizeOptionalString(
129
+ readMarketplaceAssignment(marketplaceSectionLines, 'source_type', configPath) ??
130
+ readMarketplaceAssignment(marketplaceSectionLines, 'sourceType', configPath)
131
+ );
132
+ if (!source && !sourceType) {
133
+ return null;
134
+ }
135
+ return { source, sourceType };
136
+ }
137
+
138
+ function findMarketplaceSectionLines(rawConfig) {
139
+ const lines = rawConfig.split(/\r?\n/u);
140
+ const sectionLines = [];
141
+ let inMarketplaceSection = false;
142
+ for (const line of lines) {
143
+ const trimmed = stripTomlInlineComment(line).trim();
144
+ const tableMatch = trimmed.match(/^\[(.+)\]$/u);
145
+ if (tableMatch) {
146
+ const tableName = tableMatch[1]?.trim() ?? '';
147
+ if (MARKETPLACE_SECTION_PATTERN.test(tableName)) {
148
+ inMarketplaceSection = true;
149
+ continue;
150
+ }
151
+ if (inMarketplaceSection) {
152
+ break;
153
+ }
154
+ continue;
155
+ }
156
+ if (inMarketplaceSection) {
157
+ sectionLines.push(line);
158
+ }
159
+ }
160
+ return inMarketplaceSection ? sectionLines : null;
161
+ }
162
+
163
+ function readMarketplaceAssignment(sectionLines, key, configPath) {
164
+ const keyPattern = new RegExp(`^(?:"${escapeRegExp(key)}"|'${escapeRegExp(key)}'|${escapeRegExp(key)})\\s*=`, 'u');
165
+ for (const line of sectionLines) {
166
+ const withoutComment = stripTomlInlineComment(line).trim();
167
+ if (!keyPattern.test(withoutComment)) {
168
+ continue;
169
+ }
170
+ const separatorIndex = withoutComment.indexOf('=');
171
+ if (separatorIndex === -1) {
172
+ continue;
173
+ }
174
+ const rawKey = withoutComment.slice(0, separatorIndex).trim();
175
+ const parsedKey = rawKey.startsWith('"') || rawKey.startsWith("'")
176
+ ? parseTomlStringValue(rawKey, configPath, `key:${key}`)
177
+ : rawKey;
178
+ if (parsedKey !== key) {
179
+ continue;
180
+ }
181
+ const rawValue = withoutComment.slice(separatorIndex + 1).trim();
182
+ if (rawValue.length === 0) {
183
+ throw new Error(`Unable to parse Codex config at ${configPath}: ${MARKETPLACE_SECTION}.${key} is empty.`);
184
+ }
185
+ return parseTomlStringValue(rawValue, configPath, key);
186
+ }
187
+ return null;
188
+ }
189
+
190
+ function stripTomlInlineComment(line) {
191
+ let result = '';
192
+ let inBasicString = false;
193
+ let inLiteralString = false;
194
+ let escaping = false;
195
+ for (let index = 0; index < line.length; index += 1) {
196
+ const char = line[index];
197
+ if (escaping) {
198
+ result += char;
199
+ escaping = false;
200
+ continue;
201
+ }
202
+ if (inBasicString) {
203
+ result += char;
204
+ if (char === '\\') {
205
+ escaping = true;
206
+ } else if (char === '"') {
207
+ inBasicString = false;
208
+ }
209
+ continue;
210
+ }
211
+ if (inLiteralString) {
212
+ result += char;
213
+ if (char === "'") {
214
+ if (line[index + 1] === "'") {
215
+ result += "'";
216
+ index += 1;
217
+ } else {
218
+ inLiteralString = false;
219
+ }
220
+ }
221
+ continue;
222
+ }
223
+ if (char === '#') {
224
+ break;
225
+ }
226
+ result += char;
227
+ if (char === '"') {
228
+ inBasicString = true;
229
+ } else if (char === "'") {
230
+ inLiteralString = true;
231
+ }
232
+ }
233
+ return result;
234
+ }
235
+
236
+ function parseTomlStringValue(rawValue, configPath, key) {
237
+ if (rawValue.startsWith("'")) {
238
+ return parseTomlLiteralString(rawValue, configPath, key);
239
+ }
240
+ if (rawValue.startsWith('"')) {
241
+ return parseTomlBasicString(rawValue, configPath, key);
242
+ }
243
+ return rawValue;
244
+ }
245
+
246
+ function parseTomlBasicString(rawValue, configPath, key) {
247
+ let escaping = false;
248
+ for (let index = 1; index < rawValue.length; index += 1) {
249
+ const char = rawValue[index];
250
+ if (escaping) {
251
+ escaping = false;
252
+ continue;
253
+ }
254
+ if (char === '\\') {
255
+ escaping = true;
256
+ continue;
257
+ }
258
+ if (char === '"') {
259
+ try {
260
+ return JSON.parse(rawValue.slice(0, index + 1));
261
+ } catch (error) {
262
+ const detail = error instanceof Error ? error.message : String(error);
263
+ throw new Error(
264
+ `Unable to parse Codex config at ${configPath}: ${MARKETPLACE_SECTION}.${key} has an invalid basic string (${detail}).`
265
+ );
266
+ }
267
+ }
268
+ }
269
+ throw new Error(
270
+ `Unable to parse Codex config at ${configPath}: ${MARKETPLACE_SECTION}.${key} has an unterminated basic string.`
271
+ );
272
+ }
273
+
274
+ function parseTomlLiteralString(rawValue, configPath, key) {
275
+ let parsed = '';
276
+ for (let index = 1; index < rawValue.length; index += 1) {
277
+ const char = rawValue[index];
278
+ if (char !== "'") {
279
+ parsed += char;
280
+ continue;
281
+ }
282
+ if (rawValue[index + 1] === "'") {
283
+ parsed += "'";
284
+ index += 1;
285
+ continue;
286
+ }
287
+ return parsed;
288
+ }
289
+ throw new Error(
290
+ `Unable to parse Codex config at ${configPath}: ${MARKETPLACE_SECTION}.${key} has an unterminated literal string.`
291
+ );
292
+ }
293
+
294
+ function escapeRegExp(value) {
295
+ return value.replace(/[.*+?^${}()|[\]\\]/gu, '\\$&');
296
+ }
297
+
298
+ function normalizeOptionalString(value) {
299
+ if (typeof value !== 'string') {
300
+ return null;
301
+ }
302
+ const trimmed = value.trim();
303
+ return trimmed.length > 0 ? trimmed : null;
304
+ }
305
+
306
+ function writeWarning(message) {
307
+ const line = `${message}\n`;
308
+ const stderrFd = process.stderr.fd;
309
+ if (typeof stderrFd === 'number') {
310
+ try {
311
+ writeSync(stderrFd, line);
312
+ return;
313
+ } catch {
314
+ // Fall through to process.stderr when direct fd writes are unavailable.
315
+ }
316
+ }
317
+ process.stderr.write(line);
318
+ }
319
+
320
+ function installSignalForwarding(child, onForwardedSignal) {
321
+ const handlers = new Map();
322
+ for (const signal of FORWARDABLE_SIGNALS) {
323
+ const handler = () => {
324
+ onForwardedSignal(signal);
325
+ forwardSignal(child, signal);
326
+ };
327
+ process.on(signal, handler);
328
+ handlers.set(signal, handler);
329
+ }
330
+ return () => {
331
+ for (const [signal, handler] of handlers) {
332
+ process.off(signal, handler);
333
+ }
334
+ };
335
+ }
336
+
337
+ function forwardSignal(child, signal) {
338
+ if (child.exitCode !== null || child.signalCode !== null) {
339
+ return;
340
+ }
341
+ try {
342
+ child.kill(signal);
343
+ } catch {
344
+ // Ignore forwarding races when the child exits between checks.
345
+ }
346
+ }
347
+
348
+ function reemitSignal(signal) {
349
+ try {
350
+ process.kill(process.pid, signal);
351
+ } catch {
352
+ process.exitCode = 1;
353
+ }
354
+ }
355
+
356
+ try {
357
+ main();
358
+ } catch (error) {
359
+ writeWarning(error instanceof Error ? error.message : String(error));
360
+ process.exitCode = 1;
361
+ }