@kbediako/codex-orchestrator 0.1.26 → 0.1.27

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

@@ -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.26",
+  "version": "0.1.27",
   "license": "MIT",
   "repository": {
     "type": "git",