@chllming/wave-orchestration 0.8.3 → 0.8.4

package/docs/reference/npmjs-trusted-publishing.md

@@ -2,7 +2,7 @@
 
 This repo now includes a dedicated npmjs publish workflow at [publish-npm.yml](../../.github/workflows/publish-npm.yml).
 
-The current `0.8.3` release procedure publishes through a repository Actions secret named `NPM_TOKEN`.
+The current `0.8.4` release procedure publishes through a repository Actions secret named `NPM_TOKEN`.
 
 ## What This Repo Already Does
 
@@ -47,6 +47,7 @@ If this repo later needs private npm dependencies during CI, consider a separate
 1. Confirm [publish-npm.yml](../../.github/workflows/publish-npm.yml) is on the default branch.
 2. Confirm `NPM_TOKEN` exists in the GitHub repo secrets.
 3. Confirm the package version has been bumped and committed.
-4. Push the release commit and release tag, for example `v0.8.3`.
-5. Verify both `publish-npm.yml` and `publish-package.yml` start from the tag push.
-6. Verify the npmjs publish completes successfully for the tagged source.
+4. Confirm `README.md`, `CHANGELOG.md`, `releases/manifest.json`, and `docs/plans/migration.md` all describe the same release surface.
+5. Push the release commit and release tag, for example `v0.8.4`.
+6. Verify both `publish-npm.yml` and `publish-package.yml` start from the tag push.
+7. Verify the npmjs publish completes successfully for the tagged source.

package/docs/reference/sample-waves.md

@@ -1,11 +1,11 @@
 ---
 title: "Sample Waves"
-summary: "Showcase-first sample waves that demonstrate the current 0.8.3 Wave surface."
+summary: "Showcase-first sample waves that demonstrate the current 0.8.4 Wave surface."
 ---
 
 # Sample Waves
 
-This guide points to showcase-first sample waves that demonstrate the current `0.8.3` authored Wave surface.
+This guide points to showcase-first sample waves that demonstrate the current `0.8.4` authored Wave surface.
 
 The examples are intentionally denser than typical production waves. Their job is to teach the current authoring and runtime surface quickly, not to be the smallest possible launch-ready files.
 
@@ -15,7 +15,7 @@ The examples are intentionally denser than typical production waves. Their job i
   Shows what a good `repo-landed` outcome looks like when one promoted component only closes honestly if desired-state records, reconcile-loop substrate, and cluster-view surfaces land together. It emphasizes maturity discipline, explicit deliverables, and shared-plan closure without drifting into `pilot-live` claims.
 
 - [Full modern sample wave](../plans/examples/wave-example-live-proof.md)
-  Shows the combined `0.8.3` authored surface in one file: closure roles, `E0`, optional security review, delegated and pinned benchmark targets, richer executor config, `### Skills`, `### Capabilities`, `### Deliverables`, `### Exit contract`, `### Proof artifacts`, sticky retry, deploy environments, and proof-first live-wave structure.
+  Shows the combined `0.8.4` authored surface in one file: closure roles, `E0`, optional security review, delegated and pinned benchmark targets, richer executor config, `### Skills`, `### Capabilities`, `### Deliverables`, `### Exit contract`, `### Proof artifacts`, sticky retry, deploy environments, and proof-first live-wave structure.
 
 ## What These Examples Teach
 
@@ -38,7 +38,7 @@ The examples are intentionally denser than typical production waves. Their job i
 
 ## Feature Coverage Map
 
-Together these samples cover the main surfaces added or hardened for `0.8.3`:
+Together these samples cover the main surfaces added or hardened for `0.8.4`:
 
 - repo-landed maturity discipline and anti-overclaim framing
 - explicit shared-plan closure for future-wave safety

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chllming/wave-orchestration",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "license": "MIT",
   "description": "Generic wave-based multi-agent orchestration for repository work.",
   "repository": {

package/releases/manifest.json

@@ -2,6 +2,26 @@
   "schemaVersion": 1,
   "packageName": "@chllming/wave-orchestration",
   "releases": [
+    {
+      "version": "0.8.4",
+      "date": "2026-03-25",
+      "summary": "Contradiction replay repair, consistent component-promotion thresholds, projection-writer persistence centralization, and 0.8.4 release-surface alignment.",
+      "features": [
+        "Hermetic contradiction replay no longer depends on component-matrix parsing when the trace does not declare promoted components.",
+        "`requireComponentPromotionsFromWave` now gates both component-promotion proof validation and component-matrix current-level validation consistently across live and replay paths.",
+        "Projection persistence is now centralized under `projection-writer.mjs`, while `derived-state-engine.mjs` computes projection payloads without writing them directly.",
+        "The operator migration guide now covers fresh adoption plus upgrades from `0.8.3`, `0.8.0`-`0.8.2`, `0.6.x`-`0.7.x`, and `0.5.x` or earlier with explicit repo-owned surface sync guidance.",
+        "Shipped package metadata, README, migration guidance, current-state notes, sample-wave docs, and npm publishing instructions now point at the `0.8.4` release surface."
+      ],
+      "manualSteps": [
+        "Run `pnpm exec wave doctor` and `pnpm exec wave launch --lane main --dry-run --no-dashboard` after upgrading so the repo validates against the `0.8.4` replay, projection, and component-threshold behavior.",
+        "If your adopted repo uses planner workflows and copied the starter planner corpus, sync `docs/agents/wave-planner-role.md`, `skills/role-planner/`, `docs/context7/planner-agent/`, `docs/reference/wave-planning-lessons.md`, and the `planner-agentic` bundle entry in `docs/context7/bundles.json`.",
+        "If your repo copied the shipped starter docs or skills, sync the current operator runbook, architecture docs, launcher or orchestrator prompts, planner corpus, and relevant runtime or closure-role starter skills before relying on local runbooks.",
+        "If your repo keeps historical replay fixtures, replay at least one contradiction-blocked trace and one promoted-component trace after the upgrade so both code paths stay covered.",
+        "If an older adopted repo still carries legacy evaluator wording or pre-control-plane operator docs, complete the repo-owned prompt and runbook migration described in `docs/plans/migration.md` before cutting live waves on `0.8.4`."
+      ],
+      "breaking": false
+    },
     {
       "version": "0.8.3",
       "date": "2026-03-24",

package/scripts/wave-orchestrator/agent-state.mjs

@@ -1180,494 +1180,3 @@ export function validateContQaSummary(agent, summary, options = {}) {
     detail: summary.verdict.detail || summary.gate.detail || "cont-QA gate passed.",
   };
 }
-
-// ---------------------------------------------------------------------------
-// Agent Result Envelope — P1-6 End-State (schemaVersion 2)
-// ---------------------------------------------------------------------------
-
-import { toIsoTimestamp } from "./shared.mjs";
-
-/**
- * Valid roles for the agent result envelope.
- */
-export const ENVELOPE_VALID_ROLES = [
-  "implementation",
-  "integration",
-  "documentation",
-  "cont-qa",
-  "cont-eval",
-  "security",
-  "deploy",
-];
-
-function inferEnvelopeRole(agent, summary) {
-  const candidate = String(agent?.role || summary?.role || "").trim().toLowerCase();
-  if (candidate && ENVELOPE_VALID_ROLES.includes(candidate)) {
-    return candidate;
-  }
-  if (summary?.integration) {
-    return "integration";
-  }
-  if (summary?.docClosure) {
-    return "documentation";
-  }
-  if (summary?.eval) {
-    return "cont-eval";
-  }
-  if (summary?.security) {
-    return "security";
-  }
-  if (summary?.gate || summary?.verdict) {
-    return "cont-qa";
-  }
-  if (summary?.deploy) {
-    return "deploy";
-  }
-  if (summary?.proof || summary?.docDelta || Array.isArray(summary?.components)) {
-    return "implementation";
-  }
-  return null;
-}
-
-function toSummaryRelativePath(filePath) {
-  const normalized = String(filePath || "").trim();
-  if (!normalized) {
-    return null;
-  }
-  return path.isAbsolute(normalized) ? path.relative(REPO_ROOT, normalized) : normalized;
-}
-
-function toLegacyProofState(state) {
-  if (state === "satisfied") {
-    return "met";
-  }
-  if (state === "partial") {
-    return "gap";
-  }
-  if (state === "failed") {
-    return "failed";
-  }
-  return "not_applicable";
-}
-
-/**
- * Compute the attempt-scoped canonical envelope path.
- *
- * End-state path: .tmp/<lane>/results/wave-<N>/attempt-<A>/<agentId>.json
- *
- * @param {object} options - { lane, waveNumber, attempt, agentId }
- * @returns {string} The envelope file path
- */
-export function agentEnvelopePath({ lane, waveNumber, attempt, agentId }) {
-  const safeLane = lane || "main";
-  const safeWave = waveNumber ?? 0;
-  const safeAttempt = attempt ?? 1;
-  const safeAgent = agentId || "unknown";
-  return `.tmp/${safeLane}-wave-launcher/results/wave-${safeWave}/attempt-${safeAttempt}/${safeAgent}.json`;
-}
-
-/**
- * Legacy path derivation from status path.
- * Retained for backward compatibility during migration.
- *
- * @param {string} statusPath - Path to the .status or .summary file
- * @returns {string} The envelope file path
- */
-export function agentEnvelopePathFromStatusPath(statusPath) {
-  if (statusPath.endsWith(".summary.json")) {
-    return statusPath.replace(/\.summary\.json$/i, ".envelope.json");
-  }
-  if (statusPath.endsWith(".status")) {
-    return statusPath.replace(/\.status$/i, ".envelope.json");
-  }
-  return `${statusPath}.envelope.json`;
-}
-
-/**
- * Build a structured result envelope from an already-parsed execution summary.
- * Pure function — the envelope is a normalized projection of the summary.
- *
- * End-state P1-6: common header + role-specific typed optional payloads.
- * Absent role sections are NOT included (not null, not empty object).
- *
- * @param {object} agent - Agent definition from wave (must include .role)
- * @param {object} summary - Execution summary from buildAgentExecutionSummary
- * @param {object} [options] - { waveNumber, attempt, exitCode }
- * @returns {object} AgentResultEnvelope (schemaVersion 2)
- */
-export function buildAgentResultEnvelope(agent, summary, options = {}) {
-  const safeAgent = agent || {};
-  const safeSummary = summary || {};
-  const safeOptions = options || {};
-
-  const agentId = safeAgent.agentId || safeSummary.agentId || null;
-  const role = inferEnvelopeRole(safeAgent, safeSummary);
-
-  // --- Common header ---
-  const proof = safeSummary.proof || {};
-  const proofSection = {
-    state: proof.state === "met" ? "satisfied"
-      : proof.state === "gap" ? "partial"
-      : proof.state === "failed" ? "failed"
-      : "not_applicable",
-    completion: proof.completion || null,
-    durability: proof.durability || null,
-    proofLevel: proof.proof || null,
-    detail: proof.detail || null,
-  };
-
-  // Deliverables — with sha256
-  const deliverables = Array.isArray(safeSummary.deliverables)
-    ? safeSummary.deliverables.map((d) => ({
-        path: d.path || null,
-        exists: d.exists === true,
-        sha256: d.sha256 || null,
-      }))
-    : [];
-
-  // Proof artifacts — with sha256 and requiredFor
-  const proofArtifacts = Array.isArray(safeSummary.proofArtifacts)
-    ? safeSummary.proofArtifacts.map((artifact) => ({
-        path: artifact.path || null,
-        kind: artifact.kind || null,
-        exists: artifact.exists === true,
-        sha256: artifact.sha256 || null,
-        requiredFor: artifact.requiredFor || null,
-      }))
-    : [];
-
-  // Gaps
-  const gaps = Array.isArray(safeSummary.gaps)
-    ? safeSummary.gaps.map((g) => ({
-        kind: g.kind || null,
-        detail: g.detail || null,
-      }))
-    : [];
-
-  // Unresolved blockers
-  const unresolvedBlockers = Array.isArray(safeSummary.unresolvedBlockers)
-    ? safeSummary.unresolvedBlockers.map((b) =>
-        typeof b === "object" ? { kind: b.kind || null, detail: b.detail || null, blocking: b.blocking || null } : { kind: null, detail: String(b), blocking: null },
-      )
-    : [];
-
-  // Risk notes
-  const riskNotes = Array.isArray(safeSummary.riskNotes) ? safeSummary.riskNotes : [];
-
-  // Facts
-  const facts = Array.isArray(safeSummary.facts)
-    ? safeSummary.facts.map((f) => ({
-        factId: f.factId || null,
-        kind: f.kind || null,
-        content: f.content || null,
-      }))
-    : [];
-
-  const envelope = {
-    schemaVersion: 2,
-    agentId,
-    waveNumber: safeOptions.waveNumber ?? safeSummary.waveNumber ?? null,
-    attempt: safeOptions.attempt ?? safeSummary.attempt ?? null,
-    completedAt: safeOptions.completedAt || toIsoTimestamp(),
-    exitCode: typeof safeOptions.exitCode === "number" ? safeOptions.exitCode : (typeof safeSummary.exitCode === "number" ? safeSummary.exitCode : 0),
-    role,
-    proof: proofSection,
-    deliverables,
-    proofArtifacts,
-    gaps,
-    unresolvedBlockers,
-    riskNotes,
-    facts,
-  };
-
-  // --- Role-specific typed payloads (absent when not applicable) ---
-
-  if (role === "implementation") {
-    const docDelta = safeSummary.docDelta || {};
-    const components = Array.isArray(safeSummary.components)
-      ? safeSummary.components.map((c) => ({
-          componentId: c.componentId || null,
-          level: c.level || null,
-          state: c.state || null,
-          detail: c.detail || null,
-        }))
-      : [];
-    envelope.implementation = {
-      docDelta: {
-        state: docDelta.state || "none",
-        paths: Array.isArray(docDelta.paths) ? docDelta.paths : [],
-        detail: docDelta.detail || null,
-      },
-      components,
-    };
-  }
-
-  if (role === "integration") {
-    const integ = safeSummary.integration || {};
-    envelope.integration = {
-      state: integ.state || null,
-      claims: integ.claims || 0,
-      conflicts: integ.conflicts || 0,
-      blockers: integ.blockers || 0,
-      detail: integ.detail || null,
-    };
-  }
-
-  if (role === "documentation") {
-    const docDelta = safeSummary.docDelta || safeSummary.docClosure || {};
-    envelope.documentation = {
-      docClosure: {
-        state: docDelta.state || "no-change",
-        paths: Array.isArray(docDelta.paths) ? docDelta.paths : [],
-        detail: docDelta.detail || null,
-      },
-    };
-  }
-
-  if (role === "cont-qa") {
-    const verdict = safeSummary.verdict || {};
-    const gate = safeSummary.gate || {};
-    envelope.contQa = {
-      verdict: {
-        verdict: verdict.verdict || null,
-        detail: verdict.detail || null,
-      },
-      gateClaims: {
-        architecture: gate.architecture || null,
-        integration: gate.integration || null,
-        durability: gate.durability || null,
-        live: gate.live || null,
-        docs: gate.docs || null,
-      },
-    };
-  }
-
-  if (role === "cont-eval") {
-    const evalSection = safeSummary.eval || {};
-    envelope.contEval = {
-      state: evalSection.state || null,
-      targets: evalSection.targets || 0,
-      benchmarks: evalSection.benchmarks || 0,
-      regressions: evalSection.regressions || 0,
-      targetIds: Array.isArray(evalSection.targetIds) ? evalSection.targetIds : [],
-      benchmarkIds: Array.isArray(evalSection.benchmarkIds) ? evalSection.benchmarkIds : [],
-      detail: evalSection.detail || null,
-    };
-  }
-
-  if (role === "security") {
-    const sec = safeSummary.security || {};
-    envelope.security = {
-      state: sec.state || null,
-      findings: sec.findings || 0,
-      approvals: sec.approvals || 0,
-      detail: sec.detail || null,
-    };
-  }
-
-  if (role === "deploy") {
-    const dep = safeSummary.deploy || {};
-    envelope.deploy = {
-      state: dep.state || "not_applicable",
-      environment: dep.environment || null,
-      healthCheck: dep.healthCheck || null,
-      rolloutArtifact: dep.rolloutArtifact || null,
-      detail: dep.detail || null,
-    };
-  }
-
-  return envelope;
-}
-
-/**
- * Build a v2 envelope from legacy parsed log markers.
- * Migration adapter: synthesizes the end-state envelope shape from the
- * output of buildAgentExecutionSummary (which parses log markers).
- *
- * This exists so the gate engine always sees a consistent v2 shape,
- * even when the agent emitted legacy log markers rather than a structured envelope.
- *
- * @param {object} agent - Agent definition (must include .agentId, .role)
- * @param {object} legacySummary - Result from buildAgentExecutionSummary
- * @param {object} [options] - { waveNumber, attempt, exitCode }
- * @returns {object} AgentResultEnvelope (schemaVersion 2)
- */
-export function buildEnvelopeFromLegacySignals(agent, legacySummary, options = {}) {
-  const envelope = buildAgentResultEnvelope(agent, legacySummary, options);
-  envelope._synthesizedFromLegacy = true;
-  return envelope;
-}
-
-export function buildExecutionSummaryFromEnvelope(envelope, options = {}) {
-  if (!envelope || typeof envelope !== "object" || Array.isArray(envelope)) {
-    return null;
-  }
-  const role = inferEnvelopeRole(options.agent || {}, envelope);
-  const proof = envelope.proof && typeof envelope.proof === "object"
-    ? {
-        state: toLegacyProofState(envelope.proof.state),
-        completion: envelope.proof.completion || null,
-        durability: envelope.proof.durability || null,
-        proof: envelope.proof.proofLevel || null,
-        detail: envelope.proof.detail || null,
-      }
-    : null;
-  const summary = {
-    agentId: envelope.agentId || options.agent?.agentId || null,
-    role,
-    waveNumber: envelope.waveNumber ?? options.waveNumber ?? null,
-    attempt: envelope.attempt ?? options.attempt ?? null,
-    completedAt: envelope.completedAt || null,
-    exitCode: typeof envelope.exitCode === "number" ? envelope.exitCode : 0,
-    logPath: toSummaryRelativePath(options.logPath),
-    reportPath: toSummaryRelativePath(options.reportPath),
-    proof,
-    deliverables: Array.isArray(envelope.deliverables)
-      ? envelope.deliverables.map((deliverable) => ({
-          path: deliverable.path || null,
-          exists: deliverable.exists === true,
-          sha256: deliverable.sha256 || null,
-        }))
-      : [],
-    proofArtifacts: Array.isArray(envelope.proofArtifacts)
-      ? envelope.proofArtifacts.map((artifact) => ({
-          path: artifact.path || null,
-          kind: artifact.kind || null,
-          exists: artifact.exists === true,
-          sha256: artifact.sha256 || null,
-          requiredFor: artifact.requiredFor || null,
-        }))
-      : [],
-    gaps: Array.isArray(envelope.gaps)
-      ? envelope.gaps.map((gap) => ({
-          kind: gap.kind || null,
-          detail: gap.detail || null,
-        }))
-      : [],
-    unresolvedBlockers: Array.isArray(envelope.unresolvedBlockers)
-      ? envelope.unresolvedBlockers.map((blocker) => ({
-          kind: blocker.kind || null,
-          detail: blocker.detail || null,
-          blocking: blocker.blocking ?? null,
-        }))
-      : [],
-    riskNotes: Array.isArray(envelope.riskNotes) ? envelope.riskNotes.slice() : [],
-    facts: Array.isArray(envelope.facts)
-      ? envelope.facts.map((fact) => ({
-          factId: fact.factId || null,
-          kind: fact.kind || null,
-          content: fact.content || null,
-        }))
-      : [],
-  };
-
-  if (envelope.implementation) {
-    summary.docDelta = {
-      state: envelope.implementation.docDelta?.state || "none",
-      paths: Array.isArray(envelope.implementation.docDelta?.paths)
-        ? envelope.implementation.docDelta.paths
-        : [],
-      detail: envelope.implementation.docDelta?.detail || null,
-    };
-    summary.components = Array.isArray(envelope.implementation.components)
-      ? envelope.implementation.components.map((component) => ({
-          componentId: component.componentId || null,
-          level: component.level || null,
-          state: component.state || null,
-          detail: component.detail || null,
-        }))
-      : [];
-  }
-
-  if (envelope.documentation?.docClosure) {
-    summary.docClosure = {
-      state: envelope.documentation.docClosure.state || "no-change",
-      paths: Array.isArray(envelope.documentation.docClosure.paths)
-        ? envelope.documentation.docClosure.paths
-        : [],
-      detail: envelope.documentation.docClosure.detail || null,
-    };
-  }
-
-  if (envelope.integration) {
-    summary.integration = {
-      state: envelope.integration.state || null,
-      claims: envelope.integration.claims || 0,
-      conflicts: envelope.integration.conflicts || 0,
-      blockers: envelope.integration.blockers || 0,
-      detail: envelope.integration.detail || null,
-    };
-  }
-
-  if (envelope.contEval) {
-    summary.eval = {
-      state: envelope.contEval.state || null,
-      targets: envelope.contEval.targets || 0,
-      benchmarks: envelope.contEval.benchmarks || 0,
-      regressions: envelope.contEval.regressions || 0,
-      targetIds: Array.isArray(envelope.contEval.targetIds) ? envelope.contEval.targetIds : [],
-      benchmarkIds: Array.isArray(envelope.contEval.benchmarkIds) ? envelope.contEval.benchmarkIds : [],
-      detail: envelope.contEval.detail || null,
-    };
-  }
-
-  if (envelope.contQa) {
-    summary.gate = {
-      architecture: envelope.contQa.gateClaims?.architecture || null,
-      integration: envelope.contQa.gateClaims?.integration || null,
-      durability: envelope.contQa.gateClaims?.durability || null,
-      live: envelope.contQa.gateClaims?.live || null,
-      docs: envelope.contQa.gateClaims?.docs || null,
-      detail: envelope.contQa.gateClaims?.detail || null,
-    };
-    summary.verdict = {
-      verdict: envelope.contQa.verdict?.verdict || null,
-      detail: envelope.contQa.verdict?.detail || null,
-    };
-  }
-
-  if (envelope.security) {
-    summary.security = {
-      state: envelope.security.state || null,
-      findings: envelope.security.findings || 0,
-      approvals: envelope.security.approvals || 0,
-      detail: envelope.security.detail || null,
-    };
-  }
-
-  if (envelope.deploy) {
-    summary.deploy = {
-      state: envelope.deploy.state || "not_applicable",
-      environment: envelope.deploy.environment || null,
-      healthCheck: envelope.deploy.healthCheck || null,
-      rolloutArtifact: envelope.deploy.rolloutArtifact || null,
-      detail: envelope.deploy.detail || null,
-    };
-  }
-
-  return summary;
-}
-
-/**
- * Write an agent result envelope alongside the summary file.
- *
- * @param {string} statusPath - Path to the .status file
- * @param {object} envelope - Result from buildAgentResultEnvelope
- */
-export function writeAgentResultEnvelope(statusPath, envelope) {
-  const envelopePath = agentEnvelopePathFromStatusPath(statusPath);
-  writeJsonAtomic(envelopePath, envelope);
-  return envelopePath;
-}
-
-/**
- * Read an agent result envelope if it exists.
- *
- * @param {string} statusPath - Path to the .status file
- * @returns {object|null} The envelope or null
- */
-export function readAgentResultEnvelope(statusPath) {
-  const envelopePath = agentEnvelopePathFromStatusPath(statusPath);
-  const payload = readJsonOrNull(envelopePath);
-  return payload && typeof payload === "object" ? payload : null;
-}

package/scripts/wave-orchestrator/autonomous.mjs

@@ -1,7 +1,13 @@
 import { spawnSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
-import { DEFAULT_EXECUTOR_MODE, normalizeExecutorMode, SUPPORTED_EXECUTOR_MODES } from "./config.mjs";
+import {
+  DEFAULT_CODEX_SANDBOX_MODE,
+  DEFAULT_EXECUTOR_MODE,
+  normalizeCodexSandboxMode,
+  normalizeExecutorMode,
+  SUPPORTED_EXECUTOR_MODES,
+} from "./config.mjs";
 import {
   DEFAULT_AGENT_LAUNCH_STAGGER_MS,
   DEFAULT_AGENT_RATE_LIMIT_BASE_DELAY_SECONDS,
@@ -17,10 +23,6 @@ import {
   parsePositiveInt,
   sanitizeLaneName,
 } from "./shared.mjs";
-import {
-  DEFAULT_CODEX_SANDBOX_MODE,
-  normalizeCodexSandboxMode,
-} from "./launcher.mjs";
 import {
   maybeAnnouncePackageUpdate,
   WAVE_SUPPRESS_UPDATE_NOTICE_ENV,
@@ -29,6 +31,8 @@ import { readRunState } from "./wave-files.mjs";
 import { readDependencyTickets } from "./coordination-store.mjs";
 import { readWaveLedger } from "./ledger.mjs";
 
+const AUTONOMOUS_EXECUTOR_MODES = SUPPORTED_EXECUTOR_MODES.filter((mode) => mode !== "local");
+
 function printUsage() {
   console.log(`Usage: pnpm exec wave autonomous [options]
 
@@ -46,7 +50,7 @@ Options:
   --agent-launch-stagger-ms <n> Delay between agent launches (default: ${DEFAULT_AGENT_LAUNCH_STAGGER_MS})
   --orchestrator-id <id>        Orchestrator ID for coordination board
   --resident-orchestrator       Launch a resident orchestrator session for each live wave
-  --executor <mode>             Default executor passed to launcher: ${SUPPORTED_EXECUTOR_MODES.join(" | ")} (default: lane config)
+  --executor <mode>             Default executor passed to launcher: ${AUTONOMOUS_EXECUTOR_MODES.join(" | ")} (default: lane config)
   --codex-sandbox <mode>        Default Codex sandbox mode passed to launcher (default: ${DEFAULT_CODEX_SANDBOX_MODE})
   --dashboard                   Enable dashboards (default: disabled)
   --keep-sessions               Keep tmux sessions between waves