claudecode-omc 4.4.10 → 4.7.4

package/bridge/team.js

@@ -0,0 +1,1460 @@
+// src/cli/team.ts
+import { spawn } from "child_process";
+import { existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
+import { appendFile as appendFile2, readFile as readFile2, readdir, rm as rm2 } from "fs/promises";
+import { homedir as homedir2 } from "os";
+import { dirname as dirname5, join as join9 } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
+
+// src/team/tmux-session.ts
+import { exec, execFile, execSync, execFileSync } from "child_process";
+import { join, basename, isAbsolute, win32 } from "path";
+import { promisify } from "util";
+import fs from "fs/promises";
+
+// src/team/team-name.ts
+var TEAM_NAME_PATTERN = /^[a-z0-9][a-z0-9-]{0,48}[a-z0-9]$/;
+function validateTeamName(teamName) {
+  if (!TEAM_NAME_PATTERN.test(teamName)) {
+    throw new Error(
+      `Invalid team name: "${teamName}". Team name must match /^[a-z0-9][a-z0-9-]{0,48}[a-z0-9]$/.`
+    );
+  }
+  return teamName;
+}
+
+// src/team/tmux-session.ts
+var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+var promisifiedExec = promisify(exec);
+var promisifiedExecFile = promisify(execFile);
+async function tmuxAsync(args) {
+  if (args.some((a) => a.includes("#{"))) {
+    const escaped = args.map((a) => `"${a.replace(/"/g, '\\"')}"`).join(" ");
+    return promisifiedExec(`tmux ${escaped}`);
+  }
+  return promisifiedExecFile("tmux", args);
+}
+async function isWorkerAlive(paneId) {
+  try {
+    const { execFile: execFile2 } = await import("child_process");
+    const { promisify: promisify2 } = await import("util");
+    const execFileAsync = promisify2(execFile2);
+    const result = await tmuxAsync([
+      "display-message",
+      "-t",
+      paneId,
+      "-p",
+      "#{pane_dead}"
+    ]);
+    return result.stdout.trim() === "0";
+  } catch {
+    return false;
+  }
+}
+async function killWorkerPanes(opts) {
+  const { paneIds, leaderPaneId, teamName, cwd, graceMs = 1e4 } = opts;
+  if (!paneIds.length) return;
+  const shutdownPath = join(cwd, ".omc", "state", "team", teamName, "shutdown.json");
+  try {
+    await fs.writeFile(shutdownPath, JSON.stringify({ requestedAt: Date.now() }));
+    await sleep(graceMs);
+  } catch {
+  }
+  const { execFile: execFile2 } = await import("child_process");
+  const { promisify: promisify2 } = await import("util");
+  const execFileAsync = promisify2(execFile2);
+  for (const paneId of paneIds) {
+    if (paneId === leaderPaneId) continue;
+    try {
+      await execFileAsync("tmux", ["kill-pane", "-t", paneId]);
+    } catch {
+    }
+  }
+}
+async function killTeamSession(sessionName, workerPaneIds, leaderPaneId) {
+  const { execFile: execFile2 } = await import("child_process");
+  const { promisify: promisify2 } = await import("util");
+  const execFileAsync = promisify2(execFile2);
+  if (sessionName.includes(":")) {
+    if (!workerPaneIds?.length) return;
+    for (const id of workerPaneIds) {
+      if (id === leaderPaneId) continue;
+      try {
+        await execFileAsync("tmux", ["kill-pane", "-t", id]);
+      } catch {
+      }
+    }
+    return;
+  }
+  if (process.env.OMC_TEAM_ALLOW_KILL_CURRENT_SESSION !== "1" && process.env.TMUX) {
+    try {
+      const current = await tmuxAsync(["display-message", "-p", "#S"]);
+      const currentSessionName = current.stdout.trim();
+      if (currentSessionName && currentSessionName === sessionName) {
+        return;
+      }
+    } catch {
+    }
+  }
+  try {
+    await execFileAsync("tmux", ["kill-session", "-t", sessionName]);
+  } catch {
+  }
+}
+
+// src/team/runtime.ts
+import { mkdir as mkdir2, writeFile as writeFile2, readFile, rm, rename } from "fs/promises";
+import { join as join8 } from "path";
+import { existsSync as existsSync4 } from "fs";
+
+// src/team/model-contract.ts
+import { spawnSync } from "child_process";
+import { isAbsolute as isAbsolute2, normalize, win32 as win32Path } from "path";
+
+// src/team/worker-bootstrap.ts
+import { mkdir, writeFile, appendFile } from "fs/promises";
+import { join as join4, dirname as dirname3 } from "path";
+
+// src/agents/prompt-helpers.ts
+import { readdirSync } from "fs";
+import { join as join3, dirname as dirname2, basename as basename3 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+
+// src/agents/utils.ts
+import { readFileSync } from "fs";
+import { join as join2, dirname, basename as basename2, resolve, relative, isAbsolute as isAbsolute3 } from "path";
+import { fileURLToPath } from "url";
+
+// src/agents/prompt-helpers.ts
+function getPackageDir() {
+  if (typeof __dirname !== "undefined" && __dirname) {
+    const currentDirName = basename3(__dirname);
+    const parentDirName = basename3(dirname2(__dirname));
+    if (currentDirName === "bridge") {
+      return join3(__dirname, "..");
+    }
+    if (currentDirName === "agents" && (parentDirName === "src" || parentDirName === "dist")) {
+      return join3(__dirname, "..", "..");
+    }
+  }
+  try {
+    const __filename = fileURLToPath2(import.meta.url);
+    const __dirname2 = dirname2(__filename);
+    return join3(__dirname2, "..", "..");
+  } catch {
+  }
+  return process.cwd();
+}
+var _cachedRoles = null;
+function getValidAgentRoles() {
+  if (_cachedRoles) return _cachedRoles;
+  try {
+    if (typeof __AGENT_ROLES__ !== "undefined" && Array.isArray(__AGENT_ROLES__) && __AGENT_ROLES__.length > 0) {
+      _cachedRoles = __AGENT_ROLES__;
+      return _cachedRoles;
+    }
+  } catch {
+  }
+  try {
+    const agentsDir = join3(getPackageDir(), "agents");
+    const files = readdirSync(agentsDir);
+    _cachedRoles = files.filter((f) => f.endsWith(".md")).map((f) => basename3(f, ".md")).sort();
+  } catch (err) {
+    console.error("[prompt-injection] CRITICAL: Could not scan agents/ directory for role discovery:", err);
+    _cachedRoles = [];
+  }
+  return _cachedRoles;
+}
+var VALID_AGENT_ROLES = getValidAgentRoles();
+
+// src/team/task-file-ops.ts
+import { readFileSync as readFileSync3, readdirSync as readdirSync3, existsSync as existsSync3, openSync as openSync2, closeSync as closeSync2, unlinkSync as unlinkSync2, writeSync as writeSync2, statSync as statSync2, constants as fsConstants } from "fs";
+import { join as join7 } from "path";
+
+// src/utils/paths.ts
+import { join as join5 } from "path";
+import { existsSync, readFileSync as readFileSync2, readdirSync as readdirSync2, statSync, unlinkSync, rmSync } from "fs";
+import { homedir } from "os";
+var STALE_THRESHOLD_MS = 24 * 60 * 60 * 1e3;
+
+// src/team/fs-utils.ts
+import { writeFileSync, existsSync as existsSync2, mkdirSync, renameSync, openSync, writeSync, closeSync, realpathSync, constants } from "fs";
+import { dirname as dirname4, resolve as resolve2, relative as relative2, basename as basename4, isAbsolute as isAbsolute4 } from "path";
+
+// src/team/state-paths.ts
+import { join as join6 } from "path";
+
+// src/team/runtime.ts
+function stateRoot(cwd, teamName) {
+  validateTeamName(teamName);
+  return join8(cwd, `.omc/state/team/${teamName}`);
+}
+async function writeJson(filePath, data) {
+  await mkdir2(join8(filePath, ".."), { recursive: true });
+  await writeFile2(filePath, JSON.stringify(data, null, 2), "utf-8");
+}
+async function readJsonSafe(filePath) {
+  const isDoneSignalPath = filePath.endsWith("done.json");
+  const maxAttempts = isDoneSignalPath ? 4 : 1;
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      const content = await readFile(filePath, "utf-8");
+      try {
+        return JSON.parse(content);
+      } catch {
+        if (!isDoneSignalPath || attempt === maxAttempts) {
+          return null;
+        }
+      }
+    } catch (error) {
+      const isMissingDoneSignal = isDoneSignalPath && typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+      if (isMissingDoneSignal) {
+        return null;
+      }
+      if (!isDoneSignalPath || attempt === maxAttempts) {
+        return null;
+      }
+    }
+    await new Promise((resolve3) => setTimeout(resolve3, 25));
+  }
+  return null;
+}
+function taskPath(root, taskId) {
+  return join8(root, "tasks", `${taskId}.json`);
+}
+async function readTask(root, taskId) {
+  return readJsonSafe(taskPath(root, taskId));
+}
+async function monitorTeam(teamName, cwd, workerPaneIds) {
+  validateTeamName(teamName);
+  const monitorStartedAt = Date.now();
+  const root = stateRoot(cwd, teamName);
+  const taskScanStartedAt = Date.now();
+  const taskCounts = { pending: 0, inProgress: 0, completed: 0, failed: 0 };
+  try {
+    const { readdir: readdir2 } = await import("fs/promises");
+    const taskFiles = await readdir2(join8(root, "tasks"));
+    for (const f of taskFiles.filter((f2) => f2.endsWith(".json"))) {
+      const task = await readJsonSafe(join8(root, "tasks", f));
+      if (task?.status === "pending") taskCounts.pending++;
+      else if (task?.status === "in_progress") taskCounts.inProgress++;
+      else if (task?.status === "completed") taskCounts.completed++;
+      else if (task?.status === "failed") taskCounts.failed++;
+    }
+  } catch {
+  }
+  const listTasksMs = Date.now() - taskScanStartedAt;
+  const workerScanStartedAt = Date.now();
+  const workers = [];
+  const deadWorkers = [];
+  for (let i = 0; i < workerPaneIds.length; i++) {
+    const wName = `worker-${i + 1}`;
+    const paneId = workerPaneIds[i];
+    const alive = await isWorkerAlive(paneId);
+    const heartbeatPath = join8(root, "workers", wName, "heartbeat.json");
+    const heartbeat = await readJsonSafe(heartbeatPath);
+    let stalled = false;
+    if (heartbeat?.updatedAt) {
+      const age = Date.now() - new Date(heartbeat.updatedAt).getTime();
+      stalled = age > 6e4;
+    }
+    const status = {
+      workerName: wName,
+      alive,
+      paneId,
+      currentTaskId: heartbeat?.currentTaskId,
+      lastHeartbeat: heartbeat?.updatedAt,
+      stalled
+    };
+    workers.push(status);
+    if (!alive) deadWorkers.push(wName);
+  }
+  const workerScanMs = Date.now() - workerScanStartedAt;
+  let phase = "executing";
+  if (taskCounts.inProgress === 0 && taskCounts.pending > 0 && taskCounts.completed === 0) {
+    phase = "planning";
+  } else if (taskCounts.failed > 0 && taskCounts.pending === 0 && taskCounts.inProgress === 0) {
+    phase = "fixing";
+  } else if (taskCounts.completed > 0 && taskCounts.pending === 0 && taskCounts.inProgress === 0 && taskCounts.failed === 0) {
+    phase = "completed";
+  }
+  return {
+    teamName,
+    phase,
+    workers,
+    taskCounts,
+    deadWorkers,
+    monitorPerformance: {
+      listTasksMs,
+      workerScanMs,
+      totalMs: Date.now() - monitorStartedAt
+    }
+  };
+}
+async function shutdownTeam(teamName, sessionName, cwd, timeoutMs = 3e4, workerPaneIds, leaderPaneId) {
+  const root = stateRoot(cwd, teamName);
+  await writeJson(join8(root, "shutdown.json"), {
+    requestedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    teamName
+  });
+  const configData = await readJsonSafe(join8(root, "config.json"));
+  const CLI_AGENT_TYPES = /* @__PURE__ */ new Set(["claude", "codex", "gemini"]);
+  const agentTypes = configData?.agentTypes ?? [];
+  const isCliWorkerTeam = agentTypes.length > 0 && agentTypes.every((t) => CLI_AGENT_TYPES.has(t));
+  if (!isCliWorkerTeam) {
+    const deadline = Date.now() + timeoutMs;
+    const workerCount = configData?.workerCount ?? 0;
+    const expectedAcks = Array.from({ length: workerCount }, (_, i) => `worker-${i + 1}`);
+    while (Date.now() < deadline && expectedAcks.length > 0) {
+      for (const wName of [...expectedAcks]) {
+        const ackPath = join8(root, "workers", wName, "shutdown-ack.json");
+        if (existsSync4(ackPath)) {
+          expectedAcks.splice(expectedAcks.indexOf(wName), 1);
+        }
+      }
+      if (expectedAcks.length > 0) {
+        await new Promise((r) => setTimeout(r, 500));
+      }
+    }
+  }
+  await killTeamSession(sessionName, workerPaneIds, leaderPaneId);
+  try {
+    await rm(root, { recursive: true, force: true });
+  } catch {
+  }
+}
+async function resumeTeam(teamName, cwd) {
+  const root = stateRoot(cwd, teamName);
+  const configData = await readJsonSafe(join8(root, "config.json"));
+  if (!configData) return null;
+  const { execFile: execFile2 } = await import("child_process");
+  const { promisify: promisify2 } = await import("util");
+  const execFileAsync = promisify2(execFile2);
+  const sName = `omc-team-${teamName}`;
+  try {
+    await execFileAsync("tmux", ["has-session", "-t", sName]);
+  } catch {
+    return null;
+  }
+  const panesResult = await execFileAsync("tmux", [
+    "list-panes",
+    "-t",
+    sName,
+    "-F",
+    "#{pane_id}"
+  ]);
+  const allPanes = panesResult.stdout.trim().split("\n").filter(Boolean);
+  const workerPaneIds = allPanes.slice(1);
+  const workerNames = workerPaneIds.map((_, i) => `worker-${i + 1}`);
+  const paneByWorker = new Map(
+    workerNames.map((wName, i) => [wName, workerPaneIds[i] ?? ""])
+  );
+  const activeWorkers = /* @__PURE__ */ new Map();
+  for (let i = 0; i < configData.tasks.length; i++) {
+    const taskId = String(i + 1);
+    const task = await readTask(root, taskId);
+    if (task?.status === "in_progress" && task.owner) {
+      const paneId = paneByWorker.get(task.owner) ?? "";
+      activeWorkers.set(task.owner, {
+        paneId,
+        taskId,
+        spawnedAt: task.assignedAt ? new Date(task.assignedAt).getTime() : Date.now()
+      });
+    }
+  }
+  return {
+    teamName,
+    sessionName: sName,
+    leaderPaneId: allPanes[0] ?? "",
+    config: configData,
+    workerNames,
+    workerPaneIds,
+    activeWorkers,
+    cwd
+  };
+}
+
+// src/cli/team.ts
+var JOB_ID_PATTERN = /^omc-[a-z0-9]{1,12}$/;
+var VALID_CLI_AGENT_TYPES = /* @__PURE__ */ new Set(["claude", "codex", "gemini"]);
+var SUBCOMMANDS = /* @__PURE__ */ new Set(["start", "status", "wait", "cleanup", "resume", "shutdown", "api", "help", "--help", "-h"]);
+var SUPPORTED_API_OPERATIONS = /* @__PURE__ */ new Set([
+  "send-message",
+  "broadcast",
+  "mailbox-list",
+  "mailbox-mark-delivered",
+  "list-tasks",
+  "read-task",
+  "read-config",
+  "get-summary"
+]);
+var TEAM_API_USAGE = `
+Usage:
+  omc team api <operation> --input '<json>' [--json] [--cwd DIR]
+
+Supported operations:
+  ${Array.from(SUPPORTED_API_OPERATIONS).join(", ")}
+`.trim();
+function getTeamWorkerIdentityFromEnv(env = process.env) {
+  const omc = typeof env.OMC_TEAM_WORKER === "string" ? env.OMC_TEAM_WORKER.trim() : "";
+  if (omc) return omc;
+  const omx = typeof env.OMX_TEAM_WORKER === "string" ? env.OMX_TEAM_WORKER.trim() : "";
+  return omx || null;
+}
+function assertTeamSpawnAllowed(env = process.env) {
+  const workerIdentity = getTeamWorkerIdentityFromEnv(env);
+  if (!workerIdentity) return;
+  throw new Error(
+    `Worker context (${workerIdentity}) cannot start/spawn new teams. Use only "omc team api ..." operations from worker sessions.`
+  );
+}
+function resolveJobsDir(env = process.env) {
+  return env.OMC_JOBS_DIR || join9(homedir2(), ".omc", "team-jobs");
+}
+function resolveRuntimeCliPath(env = process.env) {
+  if (env.OMC_RUNTIME_CLI_PATH) {
+    return env.OMC_RUNTIME_CLI_PATH;
+  }
+  const moduleDir = dirname5(fileURLToPath3(import.meta.url));
+  return join9(moduleDir, "../../bridge/runtime-cli.cjs");
+}
+function ensureJobsDir(jobsDir) {
+  if (!existsSync5(jobsDir)) {
+    mkdirSync2(jobsDir, { recursive: true });
+  }
+}
+function jobPath(jobsDir, jobId) {
+  return join9(jobsDir, `${jobId}.json`);
+}
+function resultArtifactPath(jobsDir, jobId) {
+  return join9(jobsDir, `${jobId}-result.json`);
+}
+function panesArtifactPath(jobsDir, jobId) {
+  return join9(jobsDir, `${jobId}-panes.json`);
+}
+function teamStateRoot(cwd, teamName) {
+  return join9(cwd, ".omc", "state", "team", teamName);
+}
+function validateJobId(jobId) {
+  if (!JOB_ID_PATTERN.test(jobId)) {
+    throw new Error(`Invalid job id: ${jobId}`);
+  }
+}
+function parseJsonSafe(content) {
+  try {
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+function readJobFromDisk(jobId, jobsDir) {
+  try {
+    const content = readFileSync4(jobPath(jobsDir, jobId), "utf-8");
+    return parseJsonSafe(content);
+  } catch {
+    return null;
+  }
+}
+function writeJobToDisk(jobId, job, jobsDir) {
+  ensureJobsDir(jobsDir);
+  writeFileSync2(jobPath(jobsDir, jobId), JSON.stringify(job), "utf-8");
+}
+function isPidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function parseJobResult(raw) {
+  if (!raw) return void 0;
+  const parsed = parseJsonSafe(raw);
+  return parsed ?? raw;
+}
+function buildStatus(jobId, job) {
+  return {
+    jobId,
+    status: job.status,
+    elapsedSeconds: ((Date.now() - job.startedAt) / 1e3).toFixed(1),
+    result: parseJobResult(job.result),
+    stderr: job.stderr
+  };
+}
+function generateJobId(now = Date.now()) {
+  return `omc-${now.toString(36)}`;
+}
+function convergeWithResultArtifact(jobId, job, jobsDir) {
+  try {
+    const artifactRaw = readFileSync4(resultArtifactPath(jobsDir, jobId), "utf-8");
+    const artifactParsed = parseJsonSafe(artifactRaw);
+    if (artifactParsed?.status === "completed" || artifactParsed?.status === "failed") {
+      return {
+        ...job,
+        status: artifactParsed.status,
+        result: artifactRaw
+      };
+    }
+  } catch {
+  }
+  if (job.status === "running" && job.pid != null && !isPidAlive(job.pid)) {
+    return {
+      ...job,
+      status: "failed",
+      result: job.result ?? JSON.stringify({ error: "Process no longer alive" })
+    };
+  }
+  return job;
+}
+function output(value, asJson) {
+  if (asJson) {
+    console.log(JSON.stringify(value, null, 2));
+    return;
+  }
+  console.log(value);
+}
+function toInt(value, flag) {
+  const parsed = Number.parseInt(value, 10);
+  if (!Number.isFinite(parsed)) {
+    throw new Error(`Invalid ${flag} value: ${value}`);
+  }
+  return parsed;
+}
+function normalizeAgentType(value) {
+  const normalized = value.trim().toLowerCase();
+  if (!normalized) throw new Error("Agent type cannot be empty");
+  if (!VALID_CLI_AGENT_TYPES.has(normalized)) {
+    throw new Error(`Unsupported agent type: ${value}`);
+  }
+  return normalized;
+}
+function autoTeamName(task) {
+  const slug = task.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 24) || "task";
+  return `omc-${slug}-${Date.now().toString(36).slice(-4)}`;
+}
+function parseJsonInput(inputRaw) {
+  if (!inputRaw || !inputRaw.trim()) return {};
+  const parsed = parseJsonSafe(inputRaw);
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error("Invalid --input JSON payload");
+  }
+  return parsed;
+}
+function readInputString(input, ...keys) {
+  for (const key of keys) {
+    const value = input[key];
+    if (typeof value === "string" && value.trim()) {
+      return value.trim();
+    }
+  }
+  return "";
+}
+function mailboxPath(cwd, teamName, workerName) {
+  return join9(teamStateRoot(cwd, teamName), "mailbox", `${workerName}.jsonl`);
+}
+async function readTaskFiles(cwd, teamName) {
+  const tasksDir = join9(teamStateRoot(cwd, teamName), "tasks");
+  let files = [];
+  try {
+    files = (await readdir(tasksDir)).filter((f) => f.endsWith(".json"));
+  } catch {
+    return [];
+  }
+  const loaded = await Promise.all(
+    files.map(async (file) => {
+      try {
+        const raw = await readFile2(join9(tasksDir, file), "utf-8");
+        const parsed = parseJsonSafe(raw);
+        return parsed ?? null;
+      } catch {
+        return null;
+      }
+    })
+  );
+  return loaded.filter((v) => v !== null);
+}
+async function startTeamJob(input) {
+  assertTeamSpawnAllowed();
+  validateTeamName(input.teamName);
+  if (!Array.isArray(input.agentTypes) || input.agentTypes.length === 0) {
+    throw new Error("agentTypes must be a non-empty array");
+  }
+  if (!Array.isArray(input.tasks) || input.tasks.length === 0) {
+    throw new Error("tasks must be a non-empty array");
+  }
+  const jobsDir = resolveJobsDir();
+  const runtimeCliPath = resolveRuntimeCliPath();
+  const jobId = generateJobId();
+  const job = {
+    status: "running",
+    startedAt: Date.now(),
+    teamName: input.teamName,
+    cwd: input.cwd
+  };
+  const child = spawn("node", [runtimeCliPath], {
+    env: {
+      ...process.env,
+      OMC_JOB_ID: jobId,
+      OMC_JOBS_DIR: jobsDir
+    },
+    detached: true,
+    stdio: ["pipe", "ignore", "ignore"]
+  });
+  const payload = {
+    teamName: input.teamName,
+    workerCount: input.workerCount,
+    agentTypes: input.agentTypes,
+    tasks: input.tasks,
+    cwd: input.cwd,
+    pollIntervalMs: input.pollIntervalMs,
+    sentinelGateTimeoutMs: input.sentinelGateTimeoutMs,
+    sentinelGatePollIntervalMs: input.sentinelGatePollIntervalMs
+  };
+  child.stdin.write(JSON.stringify(payload));
+  child.stdin.end();
+  child.unref();
+  if (child.pid != null) {
+    job.pid = child.pid;
+  }
+  writeJobToDisk(jobId, job, jobsDir);
+  return {
+    jobId,
+    status: "running",
+    pid: child.pid
+  };
+}
+async function getTeamJobStatus(jobId) {
+  validateJobId(jobId);
+  const jobsDir = resolveJobsDir();
+  const job = readJobFromDisk(jobId, jobsDir);
+  if (!job) {
+    throw new Error(`No job found: ${jobId}`);
+  }
+  const converged = convergeWithResultArtifact(jobId, job, jobsDir);
+  if (JSON.stringify(converged) !== JSON.stringify(job)) {
+    writeJobToDisk(jobId, converged, jobsDir);
+  }
+  return buildStatus(jobId, converged);
+}
+async function waitForTeamJob(jobId, options = {}) {
+  const timeoutMs = Math.min(options.timeoutMs ?? 3e5, 36e5);
+  const deadline = Date.now() + timeoutMs;
+  let delayMs = 500;
+  while (Date.now() < deadline) {
+    const status2 = await getTeamJobStatus(jobId);
+    if (status2.status !== "running") {
+      return status2;
+    }
+    await new Promise((resolve3) => setTimeout(resolve3, delayMs));
+    delayMs = Math.min(Math.floor(delayMs * 1.5), 2e3);
+  }
+  const status = await getTeamJobStatus(jobId);
+  return {
+    ...status,
+    timedOut: true,
+    error: `Timed out waiting for job ${jobId} after ${(timeoutMs / 1e3).toFixed(0)}s`
+  };
+}
+async function cleanupTeamJob(jobId, graceMs = 1e4) {
+  validateJobId(jobId);
+  const jobsDir = resolveJobsDir();
+  const job = readJobFromDisk(jobId, jobsDir);
+  if (!job) {
+    throw new Error(`No job found: ${jobId}`);
+  }
+  const paneArtifact = await readFile2(panesArtifactPath(jobsDir, jobId), "utf-8").then((content) => parseJsonSafe(content)).catch(() => null);
+  if (paneArtifact?.paneIds?.length) {
+    await killWorkerPanes({
+      paneIds: paneArtifact.paneIds,
+      leaderPaneId: paneArtifact.leaderPaneId,
+      teamName: job.teamName,
+      cwd: job.cwd,
+      graceMs
+    });
+  }
+  await rm2(teamStateRoot(job.cwd, job.teamName), {
+    recursive: true,
+    force: true
+  }).catch(() => void 0);
+  writeJobToDisk(jobId, {
+    ...job,
+    cleanedUpAt: (/* @__PURE__ */ new Date()).toISOString()
+  }, jobsDir);
+  return {
+    jobId,
+    message: paneArtifact?.paneIds?.length ? `Cleaned up ${paneArtifact.paneIds.length} worker pane(s)` : "No worker pane ids found for this job"
+  };
+}
+async function teamStatusByTeamName(teamName, cwd = process.cwd()) {
+  validateTeamName(teamName);
+  const runtime = await resumeTeam(teamName, cwd);
+  if (!runtime) {
+    return {
+      teamName,
+      running: false,
+      error: "Team session is not currently resumable"
+    };
+  }
+  const snapshot = await monitorTeam(teamName, cwd, runtime.workerPaneIds);
+  return {
+    teamName,
+    running: true,
+    sessionName: runtime.sessionName,
+    leaderPaneId: runtime.leaderPaneId,
+    workerPaneIds: runtime.workerPaneIds,
+    snapshot
+  };
+}
+async function teamResumeByName(teamName, cwd = process.cwd()) {
+  validateTeamName(teamName);
+  const runtime = await resumeTeam(teamName, cwd);
+  if (!runtime) {
+    return {
+      teamName,
+      resumed: false,
+      error: "Team session is not currently resumable"
+    };
+  }
+  return {
+    teamName,
+    resumed: true,
+    sessionName: runtime.sessionName,
+    leaderPaneId: runtime.leaderPaneId,
+    workerPaneIds: runtime.workerPaneIds,
+    activeWorkers: runtime.activeWorkers.size
+  };
+}
+async function teamShutdownByName(teamName, options = {}) {
+  validateTeamName(teamName);
+  const cwd = options.cwd ?? process.cwd();
+  const runtime = await resumeTeam(teamName, cwd);
+  if (!runtime) {
+    if (options.force) {
+      await rm2(teamStateRoot(cwd, teamName), { recursive: true, force: true }).catch(() => void 0);
+      return {
+        teamName,
+        shutdown: true,
+        forced: true,
+        sessionFound: false
+      };
+    }
+    throw new Error(`Team ${teamName} is not running. Use --force to clear stale state.`);
+  }
+  await shutdownTeam(
+    runtime.teamName,
+    runtime.sessionName,
+    runtime.cwd,
+    options.force ? 0 : 3e4,
+    runtime.workerPaneIds,
+    runtime.leaderPaneId
+  );
+  return {
+    teamName,
+    shutdown: true,
+    forced: Boolean(options.force),
+    sessionFound: true
+  };
+}
+async function executeTeamApiOperation(operation, input, cwd = process.cwd()) {
+  if (!SUPPORTED_API_OPERATIONS.has(operation)) {
+    return {
+      ok: false,
+      operation,
+      error: {
+        code: "UNSUPPORTED_OPERATION",
+        message: `Unsupported omc team api operation: ${operation}`
+      }
+    };
+  }
+  const teamName = readInputString(input, "teamName", "team_name");
+  if (!teamName) {
+    return {
+      ok: false,
+      operation,
+      error: {
+        code: "INVALID_INPUT",
+        message: "teamName is required in --input payload"
+      }
+    };
+  }
+  validateTeamName(teamName);
+  if (operation === "send-message") {
+    const toWorker = readInputString(input, "toWorker", "to_worker");
+    const body = readInputString(input, "body");
+    const fromWorker = readInputString(input, "fromWorker", "from_worker") || "leader";
+    if (!toWorker || !body) {
+      return {
+        ok: false,
+        operation,
+        error: {
+          code: "INVALID_INPUT",
+          message: "send-message requires toWorker and body"
+        }
+      };
+    }
+    mkdirSync2(dirname5(mailboxPath(cwd, teamName, toWorker)), { recursive: true });
+    await appendFile2(mailboxPath(cwd, teamName, toWorker), `${JSON.stringify({
+      id: `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+      from: fromWorker,
+      to: toWorker,
+      body,
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      notifiedAt: null
+    })}
+`, "utf-8");
+    return {
+      ok: true,
+      operation,
+      data: { teamName, toWorker }
+    };
+  }
+  if (operation === "broadcast") {
+    const body = readInputString(input, "body");
+    const fromWorker = readInputString(input, "fromWorker", "from_worker") || "leader";
+    if (!body) {
+      return {
+        ok: false,
+        operation,
+        error: {
+          code: "INVALID_INPUT",
+          message: "broadcast requires body"
+        }
+      };
+    }
+    const mailboxDir = join9(teamStateRoot(cwd, teamName), "mailbox");
+    let workers = [];
+    try {
+      workers = (await readdir(mailboxDir)).filter((f) => f.endsWith(".jsonl")).map((f) => f.replace(/\.jsonl$/, ""));
+    } catch {
+      workers = [];
+    }
+    if (workers.length === 0) {
+      const configRaw = await readFile2(join9(teamStateRoot(cwd, teamName), "config.json"), "utf-8").catch(() => "");
+      const config = parseJsonSafe(configRaw);
+      const workerCount = Number.isFinite(config?.workerCount) && (config?.workerCount ?? 0) > 0 ? Number(config?.workerCount) : 0;
+      workers = Array.from({ length: workerCount }, (_, i) => `worker-${i + 1}`);
+    }
+    await Promise.all(workers.map(async (worker) => {
+      mkdirSync2(dirname5(mailboxPath(cwd, teamName, worker)), { recursive: true });
+      await appendFile2(mailboxPath(cwd, teamName, worker), `${JSON.stringify({
+        id: `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+        from: fromWorker,
+        to: worker,
+        body,
+        createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+        broadcast: true
+      })}
+`, "utf-8");
+    }));
+    return {
+      ok: true,
+      operation,
+      data: { teamName, recipients: workers }
+    };
+  }
+  if (operation === "mailbox-list") {
+    const mailboxDir = join9(teamStateRoot(cwd, teamName), "mailbox");
+    const workerFilter = readInputString(input, "workerName", "worker");
+    let files = [];
+    try {
+      files = (await readdir(mailboxDir)).filter((f) => f.endsWith(".jsonl"));
+    } catch {
+      files = [];
+    }
+    const selected = workerFilter ? files.filter((f) => f === `${workerFilter}.jsonl`) : files;
+    const mailboxes = await Promise.all(selected.map(async (file) => {
+      const workerName = file.replace(/\.jsonl$/, "");
+      const raw = await readFile2(join9(mailboxDir, file), "utf-8").catch(() => "");
+      const lines = raw.split("\n").filter((line) => line.trim().length > 0);
+      return { workerName, count: lines.length };
+    }));
+    return {
+      ok: true,
+      operation,
+      data: { teamName, mailboxes }
+    };
+  }
+  if (operation === "mailbox-mark-delivered") {
+    const workerName = readInputString(input, "workerName", "worker");
+    const messageId = readInputString(input, "messageId", "message_id");
+    if (!workerName || !messageId) {
+      return {
+        ok: false,
+        operation,
+        error: {
+          code: "INVALID_INPUT",
+          message: "mailbox-mark-delivered requires workerName and messageId"
+        }
+      };
+    }
+    mkdirSync2(dirname5(mailboxPath(cwd, teamName, workerName)), { recursive: true });
+    await appendFile2(mailboxPath(cwd, teamName, workerName), `${JSON.stringify({
+      id: messageId,
+      type: "delivered",
+      deliveredAt: (/* @__PURE__ */ new Date()).toISOString()
+    })}
+`, "utf-8");
+    return {
+      ok: true,
+      operation,
+      data: { teamName, workerName, messageId }
+    };
+  }
+  if (operation === "list-tasks") {
+    const tasks2 = await readTaskFiles(cwd, teamName);
+    return {
+      ok: true,
+      operation,
+      data: { teamName, tasks: tasks2 }
+    };
+  }
+  if (operation === "read-task") {
+    const taskId = readInputString(input, "taskId", "task_id");
+    if (!taskId) {
+      return {
+        ok: false,
+        operation,
+        error: {
+          code: "INVALID_INPUT",
+          message: "read-task requires taskId"
+        }
+      };
+    }
+    const raw = await readFile2(join9(teamStateRoot(cwd, teamName), "tasks", `${taskId}.json`), "utf-8").catch(() => "");
+    const task = raw ? parseJsonSafe(raw) : null;
+    return {
+      ok: true,
+      operation,
+      data: { teamName, taskId, task }
+    };
+  }
+  if (operation === "read-config") {
+    const raw = await readFile2(join9(teamStateRoot(cwd, teamName), "config.json"), "utf-8").catch(() => "");
+    return {
+      ok: true,
+      operation,
+      data: { teamName, config: raw ? parseJsonSafe(raw) : null }
+    };
+  }
+  const tasks = await readTaskFiles(cwd, teamName);
+  const taskCounts = tasks.reduce(
+    (acc, task) => {
+      const status = String(task.status ?? "unknown");
+      if (status === "pending") acc.pending += 1;
+      else if (status === "in_progress") acc.inProgress += 1;
+      else if (status === "completed") acc.completed += 1;
+      else if (status === "failed") acc.failed += 1;
+      return acc;
+    },
+    { pending: 0, inProgress: 0, completed: 0, failed: 0 }
+  );
+  const runtime = await resumeTeam(teamName, cwd);
+  const snapshot = runtime ? await monitorTeam(teamName, cwd, runtime.workerPaneIds) : null;
+  return {
+    ok: true,
+    operation,
+    data: {
+      teamName,
+      taskCounts,
+      workerCount: runtime?.workerPaneIds.length ?? 0,
+      phase: snapshot?.phase ?? null
+    }
+  };
+}
+async function teamStartCommand(input, options = {}) {
+  const result = await startTeamJob(input);
+  output(result, Boolean(options.json));
+  return result;
+}
+async function teamStatusCommand(jobId, options = {}) {
+  const result = await getTeamJobStatus(jobId);
+  output(result, Boolean(options.json));
+  return result;
+}
+async function teamWaitCommand(jobId, waitOptions = {}, options = {}) {
+  const result = await waitForTeamJob(jobId, waitOptions);
+  output(result, Boolean(options.json));
+  return result;
+}
+async function teamCleanupCommand(jobId, cleanupOptions = {}, options = {}) {
+  const result = await cleanupTeamJob(jobId, cleanupOptions.graceMs);
+  output(result, Boolean(options.json));
+  return result;
+}
+var TEAM_USAGE = `
+Usage:
+  omc team start --agent <claude|codex|gemini>[,<agent>...] --task "<task>" [--count N] [--name TEAM] [--cwd DIR] [--json]
+  omc team status <job_id|team_name> [--json] [--cwd DIR]
+  omc team wait <job_id> [--timeout-ms MS] [--json]
+  omc team cleanup <job_id> [--grace-ms MS] [--json]
+  omc team resume <team_name> [--json] [--cwd DIR]
+  omc team shutdown <team_name> [--force] [--json] [--cwd DIR]
+  omc team api <operation> [--input '<json>'] [--json] [--cwd DIR]
+  omc team [ralph] <N:agent-type> "task" [--json] [--cwd DIR]
+
+Examples:
+  omc team start --agent codex --count 2 --task "review auth flow"
+  omc team status omc-abc123
+  omc team status auth-review
+  omc team resume auth-review
+  omc team shutdown auth-review --force
+  omc team api list-tasks --input '{"teamName":"auth-review"}' --json
+  omc team 3:codex "refactor launch command"
+`.trim();
+function parseStartArgs(args) {
+  const agentValues = [];
+  const taskValues = [];
+  let teamName;
+  let cwd = process.cwd();
+  let count = 1;
+  let json = false;
+  let subjectPrefix = "Task";
+  let pollIntervalMs;
+  let sentinelGateTimeoutMs;
+  let sentinelGatePollIntervalMs;
+  for (let i = 0; i < args.length; i += 1) {
+    const token = args[i];
+    const next = args[i + 1];
+    if (token === "--json") {
+      json = true;
+      continue;
+    }
+    if (token === "--agent") {
+      if (!next) throw new Error("Missing value after --agent");
+      agentValues.push(...next.split(",").map(normalizeAgentType));
+      i += 1;
+      continue;
+    }
+    if (token.startsWith("--agent=")) {
+      agentValues.push(...token.slice("--agent=".length).split(",").map(normalizeAgentType));
+      continue;
+    }
+    if (token === "--task") {
+      if (!next) throw new Error("Missing value after --task");
+      taskValues.push(next);
+      i += 1;
+      continue;
+    }
+    if (token.startsWith("--task=")) {
+      taskValues.push(token.slice("--task=".length));
+      continue;
+    }
+    if (token === "--count") {
+      if (!next) throw new Error("Missing value after --count");
+      count = toInt(next, "--count");
+      i += 1;
+      continue;
+    }
+    if (token.startsWith("--count=")) {
+      count = toInt(token.slice("--count=".length), "--count");
+      continue;
+    }
+    if (token === "--name") {
+      if (!next) throw new Error("Missing value after --name");
+      teamName = next;
+      i += 1;
+      continue;
+    }
+    if (token.startsWith("--name=")) {
+      teamName = token.slice("--name=".length);
+      continue;
+    }
+    if (token === "--cwd") {
+      if (!next) throw new Error("Missing value after --cwd");
+      cwd = next;
+      i += 1;
+      continue;
+    }
+    if (token.startsWith("--cwd=")) {
+      cwd = token.slice("--cwd=".length);
+      continue;
+    }
+    if (token === "--subject") {
+      if (!next) throw new Error("Missing value after --subject");
+      subjectPrefix = next;
+      i += 1;
+      continue;
+    }
+    if (token.startsWith("--subject=")) {
+      subjectPrefix = token.slice("--subject=".length);
+      continue;
+    }
+    if (token === "--poll-interval-ms") {
+      if (!next) throw new Error("Missing value after --poll-interval-ms");
+      pollIntervalMs = toInt(next, "--poll-interval-ms");
+      i += 1;
+      continue;
+    }
+    if (token.startsWith("--poll-interval-ms=")) {
+      pollIntervalMs = toInt(token.slice("--poll-interval-ms=".length), "--poll-interval-ms");
+      continue;
+    }
+    if (token === "--sentinel-gate-timeout-ms") {
+      if (!next) throw new Error("Missing value after --sentinel-gate-timeout-ms");
+      sentinelGateTimeoutMs = toInt(next, "--sentinel-gate-timeout-ms");
+      i += 1;
+      continue;
+    }
+    if (token.startsWith("--sentinel-gate-timeout-ms=")) {
+      sentinelGateTimeoutMs = toInt(token.slice("--sentinel-gate-timeout-ms=".length), "--sentinel-gate-timeout-ms");
+      continue;
+    }
+    if (token === "--sentinel-gate-poll-interval-ms") {
+      if (!next) throw new Error("Missing value after --sentinel-gate-poll-interval-ms");
+      sentinelGatePollIntervalMs = toInt(next, "--sentinel-gate-poll-interval-ms");
+      i += 1;
+      continue;
+    }
+    if (token.startsWith("--sentinel-gate-poll-interval-ms=")) {
+      sentinelGatePollIntervalMs = toInt(token.slice("--sentinel-gate-poll-interval-ms=".length), "--sentinel-gate-poll-interval-ms");
+      continue;
+    }
+    throw new Error(`Unknown argument for "omc team start": ${token}`);
+  }
+  if (count < 1) throw new Error("--count must be >= 1");
+  if (agentValues.length === 0) throw new Error("Missing required --agent");
+  if (taskValues.length === 0) throw new Error("Missing required --task");
+  const agentTypes = agentValues.length === 1 ? Array.from({ length: count }, () => agentValues[0]) : [...agentValues];
+  if (agentValues.length > 1 && count !== 1) {
+    throw new Error("Do not combine --count with multiple --agent values; either use one agent+count or explicit agent list.");
+  }
+  const taskDescriptions = taskValues.length === 1 ? Array.from({ length: agentTypes.length }, () => taskValues[0]) : [...taskValues];
+  if (taskDescriptions.length !== agentTypes.length) {
+    throw new Error(`Task count (${taskDescriptions.length}) must match worker count (${agentTypes.length}).`);
+  }
+  const resolvedTeamName = teamName && teamName.trim() ? teamName.trim() : autoTeamName(taskDescriptions[0]);
+  const tasks = taskDescriptions.map((description, index) => ({
+    subject: `${subjectPrefix} ${index + 1}`,
+    description
+  }));
+  return {
+    input: {
+      teamName: resolvedTeamName,
+      agentTypes,
+      tasks,
+      cwd,
+      ...pollIntervalMs != null ? { pollIntervalMs } : {},
+      ...sentinelGateTimeoutMs != null ? { sentinelGateTimeoutMs } : {},
+      ...sentinelGatePollIntervalMs != null ? { sentinelGatePollIntervalMs } : {}
+    },
+    json
+  };
+}
+function parseCommonJobArgs(args, command) {
+  let json = false;
+  let target;
+  let cwd;
+  let timeoutMs;
+  let graceMs;
+  for (let i = 0; i < args.length; i += 1) {
+    const token = args[i];
+    const next = args[i + 1];
+    if (!token.startsWith("-") && !target) {
+      target = token;
+      continue;
+    }
+    if (token === "--json") {
+      json = true;
+      continue;
+    }
+    if (token === "--cwd") {
+      if (!next) throw new Error("Missing value after --cwd");
+      cwd = next;
+      i += 1;
+      continue;
+    }
+    if (token.startsWith("--cwd=")) {
+      cwd = token.slice("--cwd=".length);
+      continue;
+    }
+    if (token === "--job-id") {
+      if (!next) throw new Error("Missing value after --job-id");
+      target = next;
+      i += 1;
+      continue;
+    }
+    if (token.startsWith("--job-id=")) {
+      target = token.slice("--job-id=".length);
+      continue;
+    }
+    if (command === "wait") {
+      if (token === "--timeout-ms") {
+        if (!next) throw new Error("Missing value after --timeout-ms");
+        timeoutMs = toInt(next, "--timeout-ms");
+        i += 1;
+        continue;
+      }
+      if (token.startsWith("--timeout-ms=")) {
+        timeoutMs = toInt(token.slice("--timeout-ms=".length), "--timeout-ms");
+        continue;
+      }
+    }
+    if (command === "cleanup") {
+      if (token === "--grace-ms") {
+        if (!next) throw new Error("Missing value after --grace-ms");
+        graceMs = toInt(next, "--grace-ms");
+        i += 1;
+        continue;
+      }
+      if (token.startsWith("--grace-ms=")) {
+        graceMs = toInt(token.slice("--grace-ms=".length), "--grace-ms");
+        continue;
+      }
+    }
+    throw new Error(`Unknown argument for "omc team ${command}": ${token}`);
+  }
+  if (!target) {
+    throw new Error(`Missing required target for "omc team ${command}".`);
+  }
+  return {
+    target,
+    json,
+    ...cwd ? { cwd } : {},
+    ...timeoutMs != null ? { timeoutMs } : {},
+    ...graceMs != null ? { graceMs } : {}
+  };
+}
+function parseTeamTargetArgs(args, command) {
+  let teamName;
+  let json = false;
+  let cwd;
+  let force = false;
+  for (let i = 0; i < args.length; i += 1) {
+    const token = args[i];
+    const next = args[i + 1];
+    if (!token.startsWith("-") && !teamName) {
+      teamName = token;
+      continue;
+    }
+    if (token === "--json") {
+      json = true;
+      continue;
+    }
+    if (token === "--cwd") {
+      if (!next) throw new Error("Missing value after --cwd");
+      cwd = next;
+      i += 1;
+      continue;
+    }
+    if (token.startsWith("--cwd=")) {
+      cwd = token.slice("--cwd=".length);
+      continue;
+    }
+    if (command === "shutdown" && token === "--force") {
+      force = true;
+      continue;
+    }
+    throw new Error(`Unknown argument for "omc team ${command}": ${token}`);
+  }
+  if (!teamName) {
+    throw new Error(`Missing required <team_name> for "omc team ${command}".`);
+  }
+  return {
+    teamName,
+    json,
+    ...cwd ? { cwd } : {},
+    ...command === "shutdown" ? { force } : {}
+  };
+}
+function parseApiArgs(args) {
+  let operation;
+  let inputRaw;
+  let json = false;
+  let cwd;
+  for (let i = 0; i < args.length; i += 1) {
+    const token = args[i];
+    const next = args[i + 1];
+    if (!token.startsWith("-") && !operation) {
+      operation = token;
+      continue;
+    }
+    if (token === "--json") {
+      json = true;
+      continue;
+    }
+    if (token === "--input") {
+      if (!next) throw new Error("Missing value after --input");
+      inputRaw = next;
+      i += 1;
+      continue;
+    }
+    if (token.startsWith("--input=")) {
+      inputRaw = token.slice("--input=".length);
+      continue;
+    }
+    if (token === "--cwd") {
+      if (!next) throw new Error("Missing value after --cwd");
+      cwd = next;
+      i += 1;
+      continue;
+    }
+    if (token.startsWith("--cwd=")) {
+      cwd = token.slice("--cwd=".length);
+      continue;
+    }
+    throw new Error(`Unknown argument for "omc team api": ${token}`);
+  }
+  if (!operation) {
+    throw new Error(`Missing required <operation> for "omc team api"
+
+${TEAM_API_USAGE}`);
+  }
+  return {
+    operation,
+    input: parseJsonInput(inputRaw),
+    json,
+    ...cwd ? { cwd } : {}
+  };
+}
+function parseLegacyStartAlias(args) {
+  if (args.length < 2) return null;
+  let index = 0;
+  let ralph = false;
+  if (args[index]?.toLowerCase() === "ralph") {
+    ralph = true;
+    index += 1;
+  }
+  const spec = args[index];
+  if (!spec) return null;
+  const match = spec.match(/^(\d+):([a-zA-Z0-9_-]+)$/);
+  if (!match) return null;
+  const workerCount = toInt(match[1], "worker-count");
+  if (workerCount < 1) throw new Error("worker-count must be >= 1");
+  const agentType = normalizeAgentType(match[2]);
+  index += 1;
+  let json = false;
+  let cwd = process.cwd();
+  const taskParts = [];
+  for (let i = index; i < args.length; i += 1) {
+    const token = args[i];
+    const next = args[i + 1];
+    if (token === "--json") {
+      json = true;
+      continue;
+    }
+    if (token === "--cwd") {
+      if (!next) throw new Error("Missing value after --cwd");
+      cwd = next;
+      i += 1;
+      continue;
+    }
+    if (token.startsWith("--cwd=")) {
+      cwd = token.slice("--cwd=".length);
+      continue;
+    }
+    taskParts.push(token);
+  }
+  const task = taskParts.join(" ").trim();
+  if (!task) throw new Error("Legacy start alias requires a task string");
+  return {
+    workerCount,
+    agentType,
+    task,
+    teamName: autoTeamName(task),
+    ralph,
+    json,
+    cwd
+  };
+}
+async function teamCommand(argv) {
+  const [commandRaw, ...rest] = argv;
+  const command = (commandRaw || "").toLowerCase();
+  if (!command || command === "help" || command === "--help" || command === "-h") {
+    console.log(TEAM_USAGE);
+    return;
+  }
+  if (command === "start") {
+    const parsed = parseStartArgs(rest);
+    await teamStartCommand(parsed.input, { json: parsed.json });
+    return;
+  }
+  if (command === "status") {
+    const parsed = parseCommonJobArgs(rest, "status");
+    if (JOB_ID_PATTERN.test(parsed.target)) {
+      await teamStatusCommand(parsed.target, { json: parsed.json });
+      return;
+    }
+    const byTeam = await teamStatusByTeamName(parsed.target, parsed.cwd ?? process.cwd());
+    output(byTeam, parsed.json);
+    return;
+  }
+  if (command === "wait") {
+    const parsed = parseCommonJobArgs(rest, "wait");
+    await teamWaitCommand(parsed.target, { ...parsed.timeoutMs != null ? { timeoutMs: parsed.timeoutMs } : {} }, { json: parsed.json });
+    return;
+  }
+  if (command === "cleanup") {
+    const parsed = parseCommonJobArgs(rest, "cleanup");
+    await teamCleanupCommand(parsed.target, { ...parsed.graceMs != null ? { graceMs: parsed.graceMs } : {} }, { json: parsed.json });
+    return;
+  }
+  if (command === "resume") {
+    const parsed = parseTeamTargetArgs(rest, "resume");
+    const result = await teamResumeByName(parsed.teamName, parsed.cwd ?? process.cwd());
+    output(result, parsed.json);
+    return;
+  }
+  if (command === "shutdown") {
+    const parsed = parseTeamTargetArgs(rest, "shutdown");
+    const result = await teamShutdownByName(parsed.teamName, {
+      cwd: parsed.cwd ?? process.cwd(),
+      force: Boolean(parsed.force)
+    });
+    output(result, parsed.json);
+    return;
+  }
+  if (command === "api") {
+    if (rest.length === 0 || rest[0] === "help" || rest[0] === "--help" || rest[0] === "-h") {
+      console.log(TEAM_API_USAGE);
+      return;
+    }
+    const parsed = parseApiArgs(rest);
+    const result = await executeTeamApiOperation(parsed.operation, parsed.input, parsed.cwd ?? process.cwd());
+    if (!result.ok && !parsed.json) {
+      throw new Error(result.error?.message ?? "Team API operation failed");
+    }
+    output(result, parsed.json);
+    return;
+  }
+  if (!SUBCOMMANDS.has(command)) {
+    const legacy = parseLegacyStartAlias(argv);
+    if (legacy) {
+      const tasks = Array.from({ length: legacy.workerCount }, (_, idx) => ({
+        subject: legacy.ralph ? `Ralph Task ${idx + 1}` : `Task ${idx + 1}`,
+        description: legacy.task
+      }));
+      const result = await startTeamJob({
+        teamName: legacy.teamName,
+        workerCount: legacy.workerCount,
+        agentTypes: Array.from({ length: legacy.workerCount }, () => legacy.agentType),
+        tasks,
+        cwd: legacy.cwd
+      });
+      output(result, legacy.json);
+      return;
+    }
+  }
+  throw new Error(`Unknown team command: ${command}
+
+${TEAM_USAGE}`);
+}
+async function main(argv) {
+  await teamCommand(argv);
+}
+export {
+  TEAM_USAGE,
+  cleanupTeamJob,
+  executeTeamApiOperation,
+  getTeamJobStatus,
+  main,
+  startTeamJob,
+  teamCleanupCommand,
+  teamCommand,
+  teamResumeByName,
+  teamShutdownByName,
+  teamStartCommand,
+  teamStatusByTeamName,
+  teamStatusCommand,
+  teamWaitCommand,
+  waitForTeamJob
+};