@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.
- package/.agents/plugins/marketplace.json +20 -0
- package/README.md +46 -317
- package/bin/codex-orchestrator.js +161 -0
- package/codex.orchestrator.json +149 -13
- package/dist/bin/codex-orchestrator.js +797 -1154
- package/dist/orchestrator/src/cli/adapters/CommandBuilder.js +50 -0
- package/dist/orchestrator/src/cli/adapters/CommandPlanner.js +22 -4
- package/dist/orchestrator/src/cli/adapters/CommandReviewer.js +3 -3
- package/dist/orchestrator/src/cli/adapters/CommandTester.js +2 -2
- package/dist/orchestrator/src/cli/adapters/cloudFailureDiagnostics.js +295 -11
- package/dist/orchestrator/src/cli/coStatusAttachCliShell.js +402 -0
- package/dist/orchestrator/src/cli/coStatusCliShell.js +451 -0
- package/dist/orchestrator/src/cli/coStatusOperatorAutopilotCliShell.js +120 -0
- package/dist/orchestrator/src/cli/codexCliShell.js +119 -0
- package/dist/orchestrator/src/cli/codexDefaultsSetup.js +265 -36
- package/dist/orchestrator/src/cli/config/delegationConfig.js +317 -5
- package/dist/orchestrator/src/cli/config/repoConfigPolicy.js +2 -3
- package/dist/orchestrator/src/cli/config/userConfig.js +28 -13
- package/dist/orchestrator/src/cli/control/authenticatedControlRouteGate.js +69 -0
- package/dist/orchestrator/src/cli/control/authenticatedRouteComposition.js +267 -0
- package/dist/orchestrator/src/cli/control/authenticatedRouteController.js +5 -0
- package/dist/orchestrator/src/cli/control/authenticatedRouteDispatcher.js +41 -0
- package/dist/orchestrator/src/cli/control/compatibilityIssuePresenter.js +1035 -0
- package/dist/orchestrator/src/cli/control/confirmationApproveController.js +62 -0
- package/dist/orchestrator/src/cli/control/confirmationCreateController.js +69 -0
- package/dist/orchestrator/src/cli/control/confirmationIssueConsumeController.js +43 -0
- package/dist/orchestrator/src/cli/control/confirmationListController.js +22 -0
- package/dist/orchestrator/src/cli/control/confirmationValidateController.js +58 -0
- package/dist/orchestrator/src/cli/control/confirmations.js +25 -3
- package/dist/orchestrator/src/cli/control/controlActionCancelConfirmation.js +65 -0
- package/dist/orchestrator/src/cli/control/controlActionController.js +77 -0
- package/dist/orchestrator/src/cli/control/controlActionControllerSequencing.js +161 -0
- package/dist/orchestrator/src/cli/control/controlActionExecution.js +142 -0
- package/dist/orchestrator/src/cli/control/controlActionFinalization.js +43 -0
- package/dist/orchestrator/src/cli/control/controlActionOutcome.js +60 -0
- package/dist/orchestrator/src/cli/control/controlActionPreflight.js +476 -0
- package/dist/orchestrator/src/cli/control/controlAuthenticatedRouteHandoff.js +57 -0
- package/dist/orchestrator/src/cli/control/controlBootstrapAssembly.js +39 -0
- package/dist/orchestrator/src/cli/control/controlBootstrapMetadataPersistence.js +16 -0
- package/dist/orchestrator/src/cli/control/controlEventTransport.js +49 -0
- package/dist/orchestrator/src/cli/control/controlExpiryLifecycle.js +102 -0
- package/dist/orchestrator/src/cli/control/controlHostOwnership.js +480 -0
- package/dist/orchestrator/src/cli/control/controlHostSupervision.js +630 -0
- package/dist/orchestrator/src/cli/control/controlOversightFacade.js +8 -0
- package/dist/orchestrator/src/cli/control/controlOversightReadContract.js +1 -0
- package/dist/orchestrator/src/cli/control/controlOversightReadService.js +16 -0
- package/dist/orchestrator/src/cli/control/controlOversightUpdateContract.js +1 -0
- package/dist/orchestrator/src/cli/control/controlPersistenceFiles.js +6 -0
- package/dist/orchestrator/src/cli/control/controlQuestionChildResolution.js +18 -0
- package/dist/orchestrator/src/cli/control/controlRequestContext.js +42 -0
- package/dist/orchestrator/src/cli/control/controlRequestController.js +9 -0
- package/dist/orchestrator/src/cli/control/controlRequestPredispatch.js +17 -0
- package/dist/orchestrator/src/cli/control/controlRequestRouteDispatch.js +44 -0
- package/dist/orchestrator/src/cli/control/controlRuntime.js +1003 -0
- package/dist/orchestrator/src/cli/control/controlServer.js +23 -1456
- package/dist/orchestrator/src/cli/control/controlServerAuditAndErrorHelpers.js +115 -0
- package/dist/orchestrator/src/cli/control/controlServerAuthenticatedRouteBranch.js +29 -0
- package/dist/orchestrator/src/cli/control/controlServerBootstrapLifecycle.js +30 -0
- package/dist/orchestrator/src/cli/control/controlServerBootstrapStartSequence.js +21 -0
- package/dist/orchestrator/src/cli/control/controlServerOwnedRuntimeLifecycle.js +67 -0
- package/dist/orchestrator/src/cli/control/controlServerPublicLifecycle.js +756 -0
- package/dist/orchestrator/src/cli/control/controlServerPublicRouteHelpers.js +86 -0
- package/dist/orchestrator/src/cli/control/controlServerReadyInstanceLifecycle.js +25 -0
- package/dist/orchestrator/src/cli/control/controlServerReadyInstanceStartup.js +18 -0
- package/dist/orchestrator/src/cli/control/controlServerRequestBodyHelpers.js +37 -0
- package/dist/orchestrator/src/cli/control/controlServerRequestShell.js +40 -0
- package/dist/orchestrator/src/cli/control/controlServerRequestShellBinding.js +17 -0
- package/dist/orchestrator/src/cli/control/controlServerSeedLoading.js +27 -0
- package/dist/orchestrator/src/cli/control/controlServerSeededRuntimeAssembly.js +186 -0
- package/dist/orchestrator/src/cli/control/controlServerStartupInputPreparation.js +31 -0
- package/dist/orchestrator/src/cli/control/controlServerStartupSequence.js +49 -0
- package/dist/orchestrator/src/cli/control/controlState.js +233 -2
- package/dist/orchestrator/src/cli/control/controlStatusDashboard.js +1904 -0
- package/dist/orchestrator/src/cli/control/controlTelegramBridgeBootstrapLifecycle.js +22 -0
- package/dist/orchestrator/src/cli/control/controlTelegramBridgeLifecycle.js +67 -0
- package/dist/orchestrator/src/cli/control/controlTelegramBridgeOversightFacadeFactory.js +8 -0
- package/dist/orchestrator/src/cli/control/controlTelegramCommandController.js +49 -0
- package/dist/orchestrator/src/cli/control/controlTelegramDispatchRead.js +40 -0
- package/dist/orchestrator/src/cli/control/controlTelegramPollingController.js +89 -0
- package/dist/orchestrator/src/cli/control/controlTelegramProjectionNotificationController.js +29 -0
- package/dist/orchestrator/src/cli/control/controlTelegramPushState.js +63 -0
- package/dist/orchestrator/src/cli/control/controlTelegramQuestionRead.js +13 -0
- package/dist/orchestrator/src/cli/control/controlTelegramReadController.js +216 -0
- package/dist/orchestrator/src/cli/control/controlTelegramUpdateHandler.js +63 -0
- package/dist/orchestrator/src/cli/control/controlWatcher.js +73 -5
- package/dist/orchestrator/src/cli/control/delegationRegisterController.js +35 -0
- package/dist/orchestrator/src/cli/control/dynamicToolBridgePolicy.js +139 -0
- package/dist/orchestrator/src/cli/control/eventsSseController.js +12 -0
- package/dist/orchestrator/src/cli/control/linearBudgetState.js +1789 -0
- package/dist/orchestrator/src/cli/control/linearDispatchSource.js +1137 -0
- package/dist/orchestrator/src/cli/control/linearGraphqlClient.js +150 -0
- package/dist/orchestrator/src/cli/control/linearRateLimit.js +102 -0
- package/dist/orchestrator/src/cli/control/linearWebhookController.js +499 -0
- package/dist/orchestrator/src/cli/control/liveLinearAdvisoryRuntime.js +70 -0
- package/dist/orchestrator/src/cli/control/observabilityApiController.js +173 -0
- package/dist/orchestrator/src/cli/control/observabilityReadModel.js +500 -0
- package/dist/orchestrator/src/cli/control/observabilitySurface.js +284 -0
- package/dist/orchestrator/src/cli/control/observabilityUpdateNotifier.js +22 -0
- package/dist/orchestrator/src/cli/control/operatorDashboardPresenter.js +252 -0
- package/dist/orchestrator/src/cli/control/providerAgentCapacity.js +70 -0
- package/dist/orchestrator/src/cli/control/providerControlHostFreshnessGauge.js +1068 -0
- package/dist/orchestrator/src/cli/control/providerIntakeState.js +473 -0
- package/dist/orchestrator/src/cli/control/providerIssueHandoff.js +6811 -0
- package/dist/orchestrator/src/cli/control/providerIssueObservability.js +1348 -0
- package/dist/orchestrator/src/cli/control/providerIssueRetryQueue.js +84 -0
- package/dist/orchestrator/src/cli/control/providerLinearRuntimeProof.js +588 -0
- package/dist/orchestrator/src/cli/control/providerLinearScreenshotProof.js +473 -0
- package/dist/orchestrator/src/cli/control/providerLinearWorkerTruth.js +383 -0
- package/dist/orchestrator/src/cli/control/providerLinearWorkflowAudit.js +254 -0
- package/dist/orchestrator/src/cli/control/providerLinearWorkflowFacade.js +5573 -0
- package/dist/orchestrator/src/cli/control/providerLinearWorkflowStates.js +115 -0
- package/dist/orchestrator/src/cli/control/providerMergeCloseout.js +1868 -0
- package/dist/orchestrator/src/cli/control/providerOperatorAutopilot.js +1580 -0
- package/dist/orchestrator/src/cli/control/providerOperatorAutopilotLifecycle.js +154 -0
- package/dist/orchestrator/src/cli/control/providerOperatorAutopilotLocalRolloutExecution.js +1006 -0
- package/dist/orchestrator/src/cli/control/providerPollingHealth.js +435 -0
- package/dist/orchestrator/src/cli/control/providerTerminalCleanup.js +516 -0
- package/dist/orchestrator/src/cli/control/providerWorkerHosts.js +191 -0
- package/dist/orchestrator/src/cli/control/providerWorkflowConfigStore.js +515 -0
- package/dist/orchestrator/src/cli/control/questionChildResolutionAdapter.js +361 -0
- package/dist/orchestrator/src/cli/control/questionQueueController.js +181 -0
- package/dist/orchestrator/src/cli/control/questionReadRetryDeduplication.js +9 -0
- package/dist/orchestrator/src/cli/control/questionReadSequence.js +10 -0
- package/dist/orchestrator/src/cli/control/securityViolationController.js +27 -0
- package/dist/orchestrator/src/cli/control/selectedRunProjection.js +1885 -0
- package/dist/orchestrator/src/cli/control/telegramOversightApiClient.js +48 -0
- package/dist/orchestrator/src/cli/control/telegramOversightBridge.js +180 -0
- package/dist/orchestrator/src/cli/control/telegramOversightBridgeProjectionDeliveryQueue.js +25 -0
- package/dist/orchestrator/src/cli/control/telegramOversightBridgeRuntimeLifecycle.js +45 -0
- package/dist/orchestrator/src/cli/control/telegramOversightBridgeStateStore.js +77 -0
- package/dist/orchestrator/src/cli/control/telegramOversightControlActionApiClient.js +45 -0
- package/dist/orchestrator/src/cli/control/trackerDispatchPilot.js +439 -0
- package/dist/orchestrator/src/cli/control/uiDataController.js +34 -0
- package/dist/orchestrator/src/cli/control/uiSessionController.js +100 -0
- package/dist/orchestrator/src/cli/controlHostCliShell.js +860 -0
- package/dist/orchestrator/src/cli/controlHostFreshnessGaugeCliShell.js +129 -0
- package/dist/orchestrator/src/cli/controlHostSupervisionCliShell.js +2127 -0
- package/dist/orchestrator/src/cli/delegationCliShell.js +62 -0
- package/dist/orchestrator/src/cli/delegationServer.js +567 -678
- package/dist/orchestrator/src/cli/delegationServerCliShell.js +52 -0
- package/dist/orchestrator/src/cli/delegationServerQuestionFlowShell.js +228 -0
- package/dist/orchestrator/src/cli/delegationServerToolDispatchShell.js +411 -0
- package/dist/orchestrator/src/cli/delegationServerTransport.js +274 -0
- package/dist/orchestrator/src/cli/delegationSetup.js +51 -171
- package/dist/orchestrator/src/cli/devtoolsCliShell.js +34 -0
- package/dist/orchestrator/src/cli/doctor.js +678 -164
- package/dist/orchestrator/src/cli/doctorCliRequestShell.js +72 -0
- package/dist/orchestrator/src/cli/doctorCliShell.js +138 -0
- package/dist/orchestrator/src/cli/doctorUsage.js +119 -15
- package/dist/orchestrator/src/cli/exec/experience.js +16 -2
- package/dist/orchestrator/src/cli/exec/summary.js +3 -0
- package/dist/orchestrator/src/cli/execCliShell.js +51 -0
- package/dist/orchestrator/src/cli/flowCliRequestShell.js +44 -0
- package/dist/orchestrator/src/cli/flowCliShell.js +239 -0
- package/dist/orchestrator/src/cli/frontendTestCliRequestShell.js +80 -0
- package/dist/orchestrator/src/cli/frontendTestCliShell.js +41 -0
- package/dist/orchestrator/src/cli/init.js +95 -1
- package/dist/orchestrator/src/cli/initCliShell.js +50 -0
- package/dist/orchestrator/src/cli/linearCliShell.js +1200 -0
- package/dist/orchestrator/src/cli/mcpEnableCliShell.js +132 -0
- package/dist/orchestrator/src/cli/metrics/metricsAggregator.js +3 -2
- package/dist/orchestrator/src/cli/metrics/metricsRecorder.js +56 -0
- package/dist/orchestrator/src/cli/orchestrator.js +66 -1376
- package/dist/orchestrator/src/cli/planCliShell.js +19 -0
- package/dist/orchestrator/src/cli/prCliShell.js +41 -0
- package/dist/orchestrator/src/cli/providerLinearChildLanePhaseContract.js +204 -0
- package/dist/orchestrator/src/cli/providerLinearChildLaneRunner.js +1835 -0
- package/dist/orchestrator/src/cli/providerLinearChildLaneShell.js +2420 -0
- package/dist/orchestrator/src/cli/providerLinearChildStreamShell.js +385 -0
- package/dist/orchestrator/src/cli/providerLinearWorkerRunner.js +6834 -0
- package/dist/orchestrator/src/cli/resumeCliShell.js +14 -0
- package/dist/orchestrator/src/cli/reviewCliLaunchShell.js +72 -0
- package/dist/orchestrator/src/cli/rlm/alignment.js +3 -3
- package/dist/orchestrator/src/cli/rlm/context.js +94 -7
- package/dist/orchestrator/src/cli/rlm/rlmCodexRuntimeShell.js +546 -0
- package/dist/orchestrator/src/cli/rlm/symbolic.js +4 -2
- package/dist/orchestrator/src/cli/rlmCliRequestShell.js +42 -0
- package/dist/orchestrator/src/cli/rlmCompletionCliShell.js +46 -0
- package/dist/orchestrator/src/cli/rlmLaunchCliShell.js +51 -0
- package/dist/orchestrator/src/cli/rlmRunner.js +83 -523
- package/dist/orchestrator/src/cli/run/blockMemory.js +500 -0
- package/dist/orchestrator/src/cli/run/manifest.js +410 -73
- package/dist/orchestrator/src/cli/run/manifestPersister.js +45 -14
- package/dist/orchestrator/src/cli/run/runMemoryController.js +216 -0
- package/dist/orchestrator/src/cli/run/source0.js +690 -0
- package/dist/orchestrator/src/cli/run/workspacePath.js +101 -0
- package/dist/orchestrator/src/cli/runtime/mode.js +2 -1
- package/dist/orchestrator/src/cli/runtime/provider.js +39 -2
- package/dist/orchestrator/src/cli/selfCheckCliShell.js +12 -0
- package/dist/orchestrator/src/cli/services/commandRunner.js +698 -18
- package/dist/orchestrator/src/cli/services/execRuntime.js +66 -1
- package/dist/orchestrator/src/cli/services/orchestratorAutoScoutEvidenceRecorder.js +71 -0
- package/dist/orchestrator/src/cli/services/orchestratorCloudBranchResolution.js +8 -0
- package/dist/orchestrator/src/cli/services/orchestratorCloudEnvironmentResolution.js +22 -0
- package/dist/orchestrator/src/cli/services/orchestratorCloudExecutionLifecycleShell.js +39 -0
- package/dist/orchestrator/src/cli/services/orchestratorCloudPromptBuilder.js +37 -0
- package/dist/orchestrator/src/cli/services/orchestratorCloudRouteFallbackContract.js +45 -0
- package/dist/orchestrator/src/cli/services/orchestratorCloudRouteShell.js +36 -0
- package/dist/orchestrator/src/cli/services/orchestratorCloudTargetExecutor.js +277 -0
- package/dist/orchestrator/src/cli/services/orchestratorControlPlaneLifecycle.js +98 -0
- package/dist/orchestrator/src/cli/services/orchestratorControlPlaneLifecycleShell.js +54 -0
- package/dist/orchestrator/src/cli/services/orchestratorExecutionLifecycle.js +112 -0
- package/dist/orchestrator/src/cli/services/orchestratorExecutionModePolicy.js +27 -0
- package/dist/orchestrator/src/cli/services/orchestratorExecutionRouteAdapterShell.js +59 -0
- package/dist/orchestrator/src/cli/services/orchestratorExecutionRouteDecisionShell.js +57 -0
- package/dist/orchestrator/src/cli/services/orchestratorExecutionRouteState.js +21 -0
- package/dist/orchestrator/src/cli/services/orchestratorExecutionRouter.js +2 -0
- package/dist/orchestrator/src/cli/services/orchestratorLocalPipelineExecutor.js +149 -0
- package/dist/orchestrator/src/cli/services/orchestratorLocalRouteShell.js +63 -0
- package/dist/orchestrator/src/cli/services/orchestratorPlanShell.js +54 -0
- package/dist/orchestrator/src/cli/services/orchestratorPlanTargetTracker.js +16 -0
- package/dist/orchestrator/src/cli/services/orchestratorResumePreparationShell.js +84 -0
- package/dist/orchestrator/src/cli/services/orchestratorResumeTokenValidation.js +15 -0
- package/dist/orchestrator/src/cli/services/orchestratorRunLifecycleCompletion.js +31 -0
- package/dist/orchestrator/src/cli/services/orchestratorRunLifecycleExecutionRegistration.js +37 -0
- package/dist/orchestrator/src/cli/services/orchestratorRunLifecycleOrchestrationShell.js +83 -0
- package/dist/orchestrator/src/cli/services/orchestratorRunLifecycleTaskManagerShell.js +37 -0
- package/dist/orchestrator/src/cli/services/orchestratorRuntimeManifestMutation.js +20 -0
- package/dist/orchestrator/src/cli/services/orchestratorStartPreparationShell.js +56 -0
- package/dist/orchestrator/src/cli/services/orchestratorStatusShell.js +70 -0
- package/dist/orchestrator/src/cli/services/pipelineResolver.js +7 -3
- package/dist/orchestrator/src/cli/services/plannerMemory.js +119 -0
- package/dist/orchestrator/src/cli/services/runPreparation.js +7 -3
- package/dist/orchestrator/src/cli/services/runSummaryWriter.js +9 -0
- package/dist/orchestrator/src/cli/setupBootstrapShell.js +114 -0
- package/dist/orchestrator/src/cli/setupCliShell.js +51 -0
- package/dist/orchestrator/src/cli/skillsCliShell.js +56 -0
- package/dist/orchestrator/src/cli/startCliRequestShell.js +53 -0
- package/dist/orchestrator/src/cli/startCliShell.js +68 -0
- package/dist/orchestrator/src/cli/statusCliShell.js +22 -0
- package/dist/orchestrator/src/cli/utils/authProvenanceFingerprint.js +27 -0
- package/dist/orchestrator/src/cli/utils/cloudPreflight.js +285 -7
- package/dist/orchestrator/src/cli/utils/codexFeatures.js +60 -0
- package/dist/orchestrator/src/cli/utils/delegationConfigParser.js +250 -0
- package/dist/orchestrator/src/cli/utils/delegationMcpHealth.js +1382 -0
- package/dist/orchestrator/src/cli/utils/devtools.js +2 -54
- package/dist/orchestrator/src/cli/utils/mcpServerEntry.js +53 -0
- package/dist/orchestrator/src/cli/utils/packageProgramResolver.js +151 -0
- package/dist/orchestrator/src/cli/utils/providerOverrideEnv.js +71 -0
- package/dist/orchestrator/src/cli/utils/trailingJsonObject.js +59 -0
- package/dist/orchestrator/src/learning/crystalizer.js +2 -2
- package/dist/orchestrator/src/manager.js +74 -4
- package/dist/orchestrator/src/persistence/ExperienceStore.js +233 -49
- package/dist/orchestrator/src/persistence/TaskStateStore.js +6 -6
- package/dist/orchestrator/src/persistence/lockFile.js +70 -4
- package/dist/orchestrator/src/persistence/sanitizeIdentifier.js +39 -0
- package/dist/orchestrator/src/sync/createCloudSyncWorker.js +3 -2
- package/dist/orchestrator/src/utils/atomicWrite.js +17 -2
- package/dist/packages/orchestrator/src/exec/unified-exec.js +99 -6
- package/dist/packages/orchestrator/src/instructions/promptPacks.js +150 -19
- package/dist/packages/sdk-node/src/orchestrator.js +137 -13
- package/dist/packages/shared/config/designConfig.js +8 -1
- package/dist/packages/shared/streams/stdio.js +1 -1
- package/dist/scripts/design/pipeline/permit.js +15 -0
- package/dist/scripts/lib/docs-catalog.js +399 -0
- package/dist/scripts/lib/docs-helpers.js +87 -5
- package/dist/scripts/lib/pr-watch-merge.js +1088 -80
- package/dist/scripts/lib/provider-run-contract.js +26 -0
- package/dist/scripts/lib/review-command-intent-classification.js +532 -0
- package/dist/scripts/lib/review-command-probe-classification.js +385 -0
- package/dist/scripts/lib/review-execution-boundary-preflight.js +279 -0
- package/dist/scripts/lib/review-execution-runtime.js +753 -0
- package/dist/scripts/lib/review-execution-state.js +1144 -0
- package/dist/scripts/lib/review-execution-telemetry.js +215 -0
- package/dist/scripts/lib/review-inspection-target-parsing.js +78 -0
- package/dist/scripts/lib/review-launch-attempt.js +601 -0
- package/dist/scripts/lib/review-meta-surface-boundary-analysis.js +300 -0
- package/dist/scripts/lib/review-meta-surface-normalization.js +746 -0
- package/dist/scripts/lib/review-non-interactive-handoff.js +61 -0
- package/dist/scripts/lib/review-prompt-context.js +376 -0
- package/dist/scripts/lib/review-scope-advisory.js +286 -0
- package/dist/scripts/lib/review-scope-paths.js +123 -0
- package/dist/scripts/lib/review-shell-command-parser.js +389 -0
- package/dist/scripts/lib/review-shell-env-interpreter.js +340 -0
- package/dist/scripts/lib/run-manifests.js +192 -36
- package/dist/scripts/lib/spark-policy-classifier.js +593 -0
- package/dist/scripts/run-review.js +507 -1777
- package/docs/README.md +43 -20
- package/docs/book/README.md +19 -0
- package/docs/book/codex-cli-0124-adoption.md +68 -0
- package/docs/book/local-hook-impact.md +73 -0
- package/docs/book/operations.md +60 -0
- package/docs/book/public-posture.md +34 -0
- package/docs/book/setup.md +91 -0
- package/docs/book/skills.md +11 -0
- package/docs/guides/codex-version-policy.md +104 -0
- package/docs/public/downstream-setup.md +113 -0
- package/docs/public/provider-onboarding.md +173 -0
- package/package.json +23 -10
- package/plugins/codex-orchestrator/.codex-plugin/plugin.json +30 -0
- package/plugins/codex-orchestrator/.mcp.json +13 -0
- package/plugins/codex-orchestrator/launcher.mjs +361 -0
- package/schemas/manifest.json +411 -0
- package/skills/README.md +26 -0
- package/skills/collab-subagents-first/SKILL.md +1 -1
- package/skills/delegation-usage/DELEGATION_GUIDE.md +30 -12
- package/skills/delegation-usage/SKILL.md +25 -14
- package/skills/land/SKILL.md +77 -0
- package/skills/linear/SKILL.md +255 -0
- package/skills/release/SKILL.md +47 -3
- package/skills/standalone-review/SKILL.md +6 -1
- package/templates/README.md +4 -2
- package/templates/codex/.codex/agents/awaiter-high.toml +2 -2
- package/templates/codex/.codex/agents/worker-complex.toml +1 -1
- package/templates/codex/.codex/config.toml +3 -4
- package/templates/codex/.codex/providers/README.md +13 -0
- package/templates/codex/.codex/providers/control.example.json +18 -0
- package/templates/codex/.codex/providers/provider.env.example +15 -0
- package/templates/codex/AGENTS.md +15 -8
- package/templates/codex/mcp-client.json +5 -1
- 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
|
+
}
|