@kbediako/codex-orchestrator 0.1.25 → 0.1.27

package/README.md

@@ -89,7 +89,7 @@ Delegation guard profile:
 ## Delegation + RLM flow
 
 RLM (Recursive Language Model) is the long-horizon loop used by the `rlm` pipeline (`codex-orchestrator rlm "<goal>"` or `codex-orchestrator start rlm --goal "<goal>"`). Delegated runs only enter RLM when the child is launched with the `rlm` pipeline (or the rlm runner directly). In auto mode it resolves to symbolic when delegated, when `RLM_CONTEXT_PATH` is set, or when the context exceeds `RLM_SYMBOLIC_MIN_BYTES`; otherwise it stays iterative. The runner writes state to `.runs/<task-id>/cli/<run-id>/rlm/state.json` and stops when the validator passes or budgets are exhausted.
-Symbolic subcalls can optionally use collab tools. Fast path: `codex-orchestrator rlm --collab "<goal>"` (sets `RLM_SYMBOLIC_COLLAB=1` and implies symbolic mode). Collab requires `collab=true` in `codex features list`. Collab tool calls parsed from `codex exec --json --enable collab` are stored in `manifest.collab_tool_calls` (bounded by `CODEX_ORCHESTRATOR_COLLAB_MAX_EVENTS`, set to `0` to disable). `codex-orchestrator codex setup` remains available when you want a managed/pinned CLI path.
+Symbolic subcalls can optionally use collab tools. Fast path: `codex-orchestrator rlm --collab auto "<goal>"` (sets `RLM_SYMBOLIC_COLLAB=1` and implies symbolic mode). Collab requires `collab=true` in `codex features list`. Collab tool calls parsed from `codex exec --json --enable collab` are stored in `manifest.collab_tool_calls` (bounded by `CODEX_ORCHESTRATOR_COLLAB_MAX_EVENTS`, set to `0` to disable). `codex-orchestrator codex setup` remains available when you want a managed/pinned CLI path.
 
 ### Delegation flow
 ```mermaid
@@ -178,7 +178,7 @@ codex-orchestrator doctor --usage
 - Bootstrap + wire everything: `codex-orchestrator setup --yes`
 - Validate + measure adoption locally: `codex-orchestrator doctor --usage --format json`
 - Delegation: `codex-orchestrator doctor --apply --yes`, then enable for a Codex run with: `codex -c 'mcp_servers.delegation.enabled=true' ...`
-- Collab (symbolic RLM subagents): `codex-orchestrator rlm "<goal>" --collab auto` (requires collab feature enabled in Codex)
+- Collab (symbolic RLM subagents): `codex-orchestrator rlm --collab auto "<goal>"` (requires collab feature enabled in Codex)
 - Cloud: set `CODEX_CLOUD_ENV_ID` (and optional `CODEX_CLOUD_BRANCH`), then run: `codex-orchestrator start <pipeline> --cloud --target <stage-id>`
 
 Print DevTools MCP setup guidance:

package/dist/bin/codex-orchestrator.js

@@ -330,6 +330,10 @@ async function handlePlan(orchestrator, rawArgs) {
 }
 async function handleRlm(orchestrator, rawArgs) {
     const { positionals, flags } = parseArgs(rawArgs);
+    if (isHelpRequest(positionals, flags)) {
+        printRlmHelp();
+        return;
+    }
     const goalFromArgs = positionals.length > 0 ? positionals.join(' ') : undefined;
     const goal = goalFromArgs ?? readStringFlag(flags, 'goal') ?? process.env.RLM_GOAL?.trim();
     if (!goal) {
@@ -465,7 +469,8 @@ function emitRunOutput(result, format, label) {
         status: result.manifest.status,
         artifact_root: result.manifest.artifact_root,
         manifest: `${result.manifest.artifact_root}/manifest.json`,
-        log_path: result.manifest.log_path
+        log_path: result.manifest.log_path,
+        summary: result.manifest.summary ?? null
     };
     if (format === 'json') {
         console.log(JSON.stringify(payload, null, 2));
@@ -475,6 +480,12 @@ function emitRunOutput(result, format, label) {
     console.log(`Status: ${payload.status}`);
     console.log(`Manifest: ${payload.manifest}`);
     console.log(`Log: ${payload.log_path}`);
+    if (payload.summary) {
+        console.log('Summary:');
+        for (const line of payload.summary.split(/\r?\n/u)) {
+            console.log(`  ${line}`);
+        }
+    }
 }
 async function handleExec(rawArgs) {
     const parsed = parseExecArgs(rawArgs);
@@ -1097,7 +1108,9 @@ function splitShellLikeCommand(command) {
     return tokens;
 }
 function isHelpRequest(positionals, flags) {
-    if (flags['help'] === true) {
+    // Treat any `--help` presence as a help request, even if a user accidentally
+    // supplies a value (our minimal argv parser would otherwise treat it as `--help <value>`).
+    if (flags['help'] !== undefined) {
         return true;
     }
     const first = positionals[0];
@@ -1285,3 +1298,21 @@ Examples:
   codex-orchestrator pr watch-merge --pr 211 --auto-merge --merge-method squash
 `);
 }
+function printRlmHelp() {
+    console.log(`Usage: codex-orchestrator rlm "<goal>" [options]
+
+Options:
+  --goal "<goal>"         Alternate way to set the goal (positional is preferred).
+  --task <id>             Override task identifier (defaults to MCP_RUNNER_TASK_ID).
+  --collab [auto|true|false]  Enable collab subagents (implies symbolic mode).
+  --validator <cmd|none>  Set validator command or disable validation.
+  --max-iterations <n>    Override max iterations (0 = unlimited with validator).
+  --max-minutes <n>       Optional time-based guardrail in minutes.
+  --roles <single|triad>  Choose single or triad role split.
+  --parent-run <id>       Link run to parent run id.
+  --approval-policy <p>   Record approval policy metadata.
+  --interactive | --ui    Enable read-only HUD when running in a TTY.
+  --no-interactive        Force disable HUD.
+  --help                  Show this message.
+`);
+}

package/dist/orchestrator/src/cli/doctor.js

@@ -97,7 +97,7 @@ export function runDoctor(cwd = process.cwd()) {
             status: collabStatus,
             enabled: collabEnabled,
             enablement: [
-                'Enable collab for symbolic RLM runs with: codex-orchestrator rlm --collab "<goal>"',
+                'Enable collab for symbolic RLM runs with: codex-orchestrator rlm --collab auto "<goal>"',
                 'Or set: RLM_SYMBOLIC_COLLAB=1 (implies symbolic mode when using --collab).',
                 'If collab is disabled in codex features: codex features enable collab'
             ]
@@ -109,7 +109,8 @@ export function runDoctor(cwd = process.cwd()) {
             enablement: [
                 'Set CODEX_CLOUD_ENV_ID to a valid Codex Cloud environment id.',
                 'Optional: set CODEX_CLOUD_BRANCH (must exist on origin).',
-                'Then run a pipeline stage in cloud mode with: codex-orchestrator start <pipeline> --cloud --target <stage-id>'
+                'Then run a pipeline stage in cloud mode with: codex-orchestrator start <pipeline> --cloud --target <stage-id>',
+                'If cloud preflight fails, CO falls back to mcp and records the reason in manifest.summary (surfaced in start output).'
             ]
         },
         delegation: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kbediako/codex-orchestrator",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "license": "MIT",
   "repository": {
     "type": "git",