@h-rig/cli 0.0.6-alpha.94 → 0.0.6-alpha.96

package/dist/src/commands/stats.js

@@ -1,979 +0,0 @@
-// @bun
-// packages/cli/src/runner.ts
-import { EventBus } from "@rig/runtime/control-plane/runtime/events";
-import { CliError as RuntimeCliError } from "@rig/runtime/control-plane/errors";
-import { evaluate, loadPolicy, resolveAction } from "@rig/runtime/control-plane/runtime/guard";
-import { buildBinary } from "@rig/runtime/control-plane/runtime/isolation";
-
-class CliError extends RuntimeCliError {
-  hint;
-  constructor(message, exitCode = 1, options = {}) {
-    super(message, exitCode);
-    if (options.hint?.trim()) {
-      this.hint = options.hint.trim();
-    }
-  }
-}
-function takeOption(args, option) {
-  const rest = [];
-  let value;
-  for (let index = 0;index < args.length; index += 1) {
-    const current = args[index];
-    if (current === option) {
-      const next = args[index + 1];
-      if (!next || next.startsWith("-")) {
-        throw new CliError(`Missing value for ${option}`, 1, { hint: `Provide a value after ${option}, e.g. \`${option} <value>\`.` });
-      }
-      value = next;
-      index += 1;
-      continue;
-    }
-    if (current !== undefined) {
-      rest.push(current);
-    }
-  }
-  return { value, rest };
-}
-function requireNoExtraArgs(args, usage) {
-  if (args.length > 0) {
-    throw new CliError(`Unexpected arguments: ${args.join(" ")}
-Usage: ${usage}`);
-  }
-}
-
-// packages/cli/src/commands/_cli-format.ts
-import pc from "picocolors";
-var dim = pc.dim;
-var faintBar = pc.dim("\u2502");
-var accent = pc.cyan;
-function compactValue(value) {
-  if (value === null || value === undefined)
-    return "\u2014";
-  if (typeof value === "string")
-    return value;
-  if (typeof value === "number" || typeof value === "boolean")
-    return String(value);
-  return JSON.stringify(value);
-}
-function printFormattedOutput(message) {
-  console.log(message);
-}
-function formatStatsTable(rows) {
-  return rows.map(([label, value]) => `${faintBar} ${dim(label.padEnd(20))} ${compactValue(value)}`).join(`
-`);
-}
-
-// packages/cli/src/commands/_help-catalog.ts
-import pc2 from "picocolors";
-var TOP_LEVEL_SECTIONS = [
-  {
-    title: "Open Rig",
-    subtitle: "normal UX \u2014 bare rig opens the bundled Rig Cockpit inside OMP",
-    commands: [
-      { command: "rig", description: "Open Rig Cockpit with OMP collaboration substrate for the current workspace." },
-      { command: "rig --workspace <path>", description: "Open Rig Cockpit for another workspace." },
-      { command: "/rig", description: "Inside OMP, reopen the Rig Cockpit." },
-      { command: "rig join <link>", description: "Join an encrypted OMP collaborative session from another operator." }
-    ]
-  },
-  {
-    title: "Server",
-    subtitle: "select execution placement before reading or dispatching work",
-    commands: [
-      { command: "Cockpit Server", description: "Select/configure local or remote execution placement and the project-root link." },
-      { command: "Server target \u2192 Local", description: "Use local execution placement for the selected project." },
-      { command: "Server target \u2192 Remote", description: "Use remote execution placement with the server-host project root preserved." }
-    ]
-  },
-  {
-    title: "Tasks",
-    subtitle: "configured task source on the selected target feeds task detail",
-    commands: [
-      { command: "Cockpit Tasks", description: "List tasks from the selected server target's configured task source." },
-      { command: "Task detail", description: "Review task id, title, body, source status, labels, and issue URL before dispatch." },
-      { command: "Task detail \u2192 Dispatch", description: "Submit the selected task run through the selected target, then attach the collaborative OMP session." },
-      { command: "rig triage", description: "Run the configured issueAnalysis pass once; use cron/launchd/CI to schedule continuous triage." }
-    ]
-  },
-  {
-    title: "Runs",
-    subtitle: "dispatched Rig runs attach through collaborative OMP sessions",
-    commands: [
-      { command: "OMP Runs screen", description: "Open dispatched runs, collaboration links, cwd, identity, status, and inbox counts." },
-      { command: "rig join <link>", description: "Join a shared OMP session without changing execution placement." },
-      { command: "OMP collab guest view", description: "Watch the shared transcript live; write links can prompt the originating session." }
-    ]
-  },
-  {
-    title: "Inbox + Doctor",
-    subtitle: "approvals, user prompts, and health checks live inside Rig/OMP",
-    commands: [
-      { command: "OMP Inbox screen", description: "Review and answer pending approval/user-input workflow entries." },
-      { command: "/rig inbox", description: "Open the inbox screen from inside OMP." },
-      { command: "OMP Doctor screen", description: "Probe session discovery, collaboration registry, selected target, and workflow-entry health." }
-    ]
-  },
-  {
-    title: "Extend",
-    subtitle: "plugins and OMP extensions shape the worker environment",
-    commands: [
-      { command: "rig.config.ts plugins", description: "Register task sources, validators, hooks, skills, roles, and workflow metadata." },
-      { command: "runtime.pi.packages", description: "Declare team-wide OMP/Pi extension packages for sessions and workers." }
-    ]
-  }
-];
-var PRIMARY_GROUPS = [
-  {
-    name: "server",
-    summary: "Select and configure local vs remote execution placement.",
-    usage: ["rig server <status|list|use|add|remove> [options]"],
-    commands: [
-      { command: "status", description: "Show the selected placement (local or remote alias) and task source.", primary: true },
-      { command: "list", description: "List local plus configured remote endpoints; marks the selected one.", primary: true },
-      { command: "use local|<alias>", description: "Select where runs execute \u2014 local, or a configured remote alias.", primary: true },
-      { command: "add --alias <a> --host <h> [--port <n>] [--token <t>]", description: "Add a remote SSH endpoint (the same store run dispatch resolves).", primary: true },
-      { command: "remove <alias>", description: "Remove a configured remote endpoint." }
-    ],
-    examples: [
-      "rig server status",
-      "rig server add --alias prod --host prod.example.com --port 22",
-      "rig server use prod"
-    ],
-    next: [
-      "Placement is read by run dispatch (`rig task run` / `rig run <task>`).",
-      "The same selection is available in-session on the bare `rig` board."
-    ]
-  },
-  {
-    name: "task",
-    summary: "Find work, dispatch task runs, and validate task results.",
-    usage: ["rig task <list|next|show|run|ready|validate> [options]"],
-    commands: [
-      { command: "list [--assignee <login|me|@me>] [--state open|closed]", description: "List tasks from the configured task source.", primary: true },
-      { command: "next [filters]", description: "Render the next ready task as a selected-task card.", primary: true },
-      { command: "show <id>|--task <id> [--raw]", description: "Show a task summary; --raw prints the full payload.", primary: true },
-      { command: "run [#<issue>|<task-id>|--task <id>]", description: "Dispatch the task as a detached run; attach with `rig run attach <run-id>`.", primary: true },
-      { command: "ready", description: "List task IDs that are runnable now." },
-      { command: "validate|verify [--task <id>]", description: "Run the task's configured checks / review gates." },
-      { command: "details --task <id>", description: "Show full task info from the configured source." },
-      { command: "reopen [--task <id> | --all] [--reason <text>]", description: "Reopen closed task(s) in the configured source." },
-      { command: "artifacts|artifact-dir|artifact-write", description: "Inspect or write task artifacts." },
-      { command: "info [--task <id>]", description: "Show the active/selected task's full runtime info." },
-      { command: "scope [--files] [--task <id>]", description: "Show the task's scope (and changed files with --files)." },
-      { command: "deps [--task <id>]", description: "Show the task's dependency graph." },
-      { command: "status", description: "Show project task-tracker progress." },
-      { command: "lookup <id>", description: "Resolve a task id to its canonical record path." },
-      { command: "record <decision|failure> <text> [--task <id>]", description: "Append a decision or failure note to the task." }
-    ],
-    examples: [
-      "rig task list --assignee @me --limit 20",
-      "rig task show 123 --raw",
-      "rig task run #123"
-    ],
-    next: ["The same flow is available in-session: run bare `rig`, then Cockpit Tasks \u2192 Task detail \u2192 Dispatch."]
-  },
-  {
-    name: "run",
-    summary: "Observe, attach to, and control runs over the OMP collab substrate.",
-    usage: ["rig run <list|status|start|start-serial|start-parallel|show|attach|steer|stop|resume|restart> [options]"],
-    commands: [
-      { command: "list", description: "List discoverable runs (relay-registry + on-disk OMP run journals).", primary: true },
-      { command: "status", description: "Render active vs recent runs from the run journals.", primary: true },
-      { command: "start [#<issue>|<task-id>|--next|--task <id>] [--title <t>]", description: "Dispatch one task as a detached run; attach with the printed run id.", primary: true },
-      { command: "start-parallel [--limit <n>]", description: "Dispatch all currently-ready tasks as detached runs (limited when requested).", primary: true },
-      { command: "start-serial", description: "Dispatch the next ready task only; run again after it finishes to continue serially.", primary: true },
-      { command: "show <id>|--run <id> [--raw]", description: "Show a run's folded journal projection; --raw prints JSON.", primary: true },
-      { command: "attach <run-id>|--run <id>", description: "Attach to a live run's collab session (resolves the join link).", primary: true },
-      { command: "resume [<run-id>]", description: "Re-dispatch the run's task as a fresh detached run." },
-      { command: "steer <run-id> --message <text>", description: "Steer a live run via its journal (local runs headless; remote runs attach to steer).", primary: true },
-      { command: "stop [<run-id>|--run <id>] [--reason <text>]", description: "Request graceful stop of a live run (local headless; remote attach to stop).", primary: true },
-      { command: "replay <run-id>|--run <id> [--with-session]", description: "Print the run's consolidated journal timeline." },
-      { command: "delete|cleanup", description: "Remove a finished run's live registry entry." }
-    ],
-    examples: [
-      "rig run start --next",
-      "rig run start-parallel --limit 3",
-      "rig run attach <run-id>"
-    ],
-    next: [
-      "Attach to steer or stop a live run: rig run attach <run-id>.",
-      "The same runs appear in-session on the bare `rig` board."
-    ]
-  },
-  {
-    name: "inbox",
-    summary: "Review approval and user-input requests that block worker runs.",
-    usage: ["rig inbox <approvals|inputs|approve|respond> [options]"],
-    commands: [
-      { command: "approvals [--run <id>] [--task <id>]", description: "List pending approval requests across runs.", primary: true },
-      { command: "inputs [--run <id>] [--task <id>]", description: "List pending user-input requests across runs.", primary: true },
-      { command: "approve --run <id> --request <id> --decision approve|reject", description: "Resolve an approval \u2014 delivered over collab, so attach to resolve." },
-      { command: "respond --run <id> --request <id> --answer key=value", description: "Answer a user-input request \u2014 attach to resolve." }
-    ],
-    examples: [
-      "rig inbox approvals",
-      "rig inbox inputs --run <run-id>"
-    ],
-    next: ["Resolve a request by attaching to its run: rig run attach <run-id>."]
-  },
-  {
-    name: "stats",
-    summary: "Fleet metrics computed from on-disk run journals (no server required).",
-    usage: ["rig stats [show] [--since <7d|30d|ISO date>]"],
-    commands: [
-      { command: "show [--since <window>]", description: "Totals, completion/failure/needs-attention rates, run time, steering, stalls, approvals.", primary: true }
-    ],
-    examples: [
-      "rig stats --since 7d",
-      "rig stats --json"
-    ],
-    next: ["Inspect outliers with `rig run list` and `rig run show <run-id>`."]
-  },
-  {
-    name: "inspect",
-    summary: "Inspect logs, artifacts, failures, graph, and diffs for a task.",
-    usage: ["rig inspect <logs|artifacts|failures|graph|audit|diff> --task <id>"],
-    commands: [
-      { command: "logs --task <id>", description: "Latest run log for a task.", primary: true },
-      { command: "artifacts --task <id>", description: "List the task's completion artifacts.", primary: true },
-      { command: "diff --task <id>", description: "List files changed by a task.", primary: true },
-      { command: "failures --task <id>", description: "Recorded failures for a task.", primary: true },
-      { command: "graph", description: "Task dependency graph." },
-      { command: "audit", description: "Controlled-command audit trail." }
-    ],
-    examples: ["rig inspect logs --task <id>", "rig inspect diff --task <id>"],
-    next: ["Use `rig stats` for fleet-level metrics across runs."]
-  },
-  {
-    name: "repo",
-    summary: "Repository sync/baseline helpers for the Rig-managed checkout.",
-    usage: ["rig repo <sync|reset-baseline>"],
-    commands: [
-      { command: "sync", description: "Sync project repository state.", primary: true },
-      { command: "reset-baseline", description: "Reset the managed baseline for the repo." }
-    ],
-    examples: ["rig repo sync"]
-  },
-  {
-    name: "plugin",
-    summary: "Plugin listing, validation, and plugin-contributed commands.",
-    usage: ["rig plugin <list|validate|run> [options]"],
-    commands: [
-      { command: "list", description: "List plugins declared in rig.config.ts and their contributions.", primary: true },
-      { command: "validate --task <id>", description: "Run plugin-contributed validators for a task.", primary: true },
-      { command: "run <command-id> [args...]", description: "Execute a plugin-contributed CLI command (also callable as `rig <command-id>`)." }
-    ],
-    examples: ["rig plugin list", "rig plugin run <command-id>"]
-  },
-  {
-    name: "init",
-    summary: "Legacy automation-only config bootstrap/repair helper; not root onboarding.",
-    usage: ["rig init [--yes] [--server local|remote] [--repo owner/repo] [--remote-url <url>]"],
-    commands: [
-      { command: "init", description: "Legacy/fenced setup wizard for compatibility projects; not onboarding.", primary: true },
-      { command: "init --demo", description: "Legacy/fenced offline demo project for compatibility tests.", primary: true },
-      { command: "init --yes", description: "Legacy/fenced non-interactive setup for old automation.", primary: true },
-      { command: "init --server remote --remote-url <url>", description: "Legacy/fenced remote server link setup.", primary: true },
-      { command: "init --repair", description: "Legacy/fenced repair of missing private compatibility state." }
-    ],
-    examples: [
-      "rig init --demo   # legacy compatibility only",
-      "rig init --repair # legacy compatibility only"
-    ],
-    next: ["For onboarding and normal UX, run bare `rig`, then use Cockpit Server/Tasks and dispatch from Task detail."]
-  },
-  {
-    name: "doctor",
-    summary: "Diagnostic-only compatibility checks; normal health lives in the OMP Doctor screen.",
-    usage: ["rig doctor"],
-    commands: [
-      { command: "doctor", description: "Diagnostic/legacy-only: check compatibility setup/runtime state; not onboarding.", primary: true },
-      { command: "check", description: "Diagnostic/legacy-only spelling for compatibility checks." }
-    ],
-    examples: ["rig doctor --json # legacy diagnostic automation only"],
-    next: ["For normal UX, use the OMP Doctor screen."]
-  },
-  {
-    name: "github",
-    summary: "Legacy automation-only GitHub auth helpers for selected compatibility servers.",
-    usage: ["rig github auth <status|import-gh|token>"],
-    commands: [
-      { command: "auth status", description: "Legacy automation-only: show GitHub auth state.", primary: true },
-      { command: "auth import-gh", description: "Legacy automation-only: import the current `gh` token into the selected server." },
-      { command: "auth token --token <token>", description: "Legacy automation-only: store a token on the selected server." }
-    ],
-    examples: ["rig github auth status # legacy automation only"],
-    next: ["For normal UX, use bare `rig` and the OMP extension cockpit."]
-  }
-];
-var ADVANCED_GROUPS = [
-  {
-    name: "setup",
-    summary: "Legacy automation-only setup bootstrap/check helpers.",
-    usage: ["rig setup <bootstrap|check|preflight>"],
-    commands: [
-      { command: "bootstrap", description: "Legacy automation-only: bootstrap local setup dependencies.", primary: true },
-      { command: "check", description: "Legacy automation-only: check local setup state (toolchain, deps, config).", primary: true },
-      { command: "preflight", description: "Legacy automation-only: run preflight checks before an old run.", primary: true }
-    ]
-  },
-  {
-    name: "profile",
-    summary: "Runtime profile/model defaults.",
-    usage: ["rig profile <show|set>"],
-    commands: [
-      { command: "show", description: "Show the active execution profile.", primary: true },
-      { command: "set [--model <model>] [--runtime <runtime>] [--plugin <plugin>]", description: "Set model/runtime/plugin profile defaults.", primary: true }
-    ]
-  },
-  {
-    name: "review",
-    summary: "Inspect or change completion review gate policy.",
-    usage: ["rig review <show|set>"],
-    commands: [
-      { command: "show", description: "Show current review gate settings." },
-      { command: "set <off|advisory|required> [--provider <provider>]", description: "Change review strictness/provider (e.g. --provider greptile)." }
-    ],
-    examples: ["rig review show", "rig review set required --provider greptile"],
-    next: ["For normal workflow handoffs, use the OMP Inbox screen."]
-  },
-  {
-    name: "pi",
-    summary: "Manage Pi extension packages for this project (community extensions from npm/git).",
-    usage: ["rig pi <list|add|remove|search> [args]"],
-    commands: [
-      { command: "list", description: "Show project and user Pi extension packages." },
-      { command: "add <source>", description: "Add an npm/git Pi extension to .pi/settings.json (auto-installs at next session)." },
-      { command: "remove <source>", description: "Remove an operator-added Pi extension." },
-      { command: "search [term]", description: "Discover Pi extension packages on the npm registry." }
-    ],
-    examples: ["rig pi search subagents", "rig pi add pi-subagents", "rig pi list"],
-    next: ["Config-managed extensions: declare `runtime: { pi: { packages: [...] } }` in rig.config.ts \u2014 workers pick them up automatically."]
-  },
-  {
-    name: "queue",
-    summary: "Run task queues locally.",
-    usage: ["rig queue run [--workers <n>] [--max-tasks <n>] [--action validate|verify|pipeline] [--isolation off|worktree] [--no-runtime-reuse] [--fail-fast] [--skip-project-sync]"],
-    commands: [
-      { command: "run [--workers <n>] [--max-tasks <n>] [--action validate|verify|pipeline] [--isolation off|worktree] [--no-runtime-reuse] [--fail-fast] [--skip-project-sync]", description: "Process queue work: drain matching tasks with N workers, optional per-task action and isolation.", primary: true }
-    ]
-  },
-  {
-    name: "agent",
-    summary: "Runtime agent workspace helpers.",
-    usage: ["rig agent <list|prepare|run|cleanup>"],
-    commands: [
-      { command: "list", description: "List prepared agent runtimes.", primary: true },
-      { command: "prepare [--id <id>] [--mode <mode>] [--task <task>]", description: "Prepare an isolated agent runtime workspace.", primary: true },
-      { command: "run [--id <id>] [--mode <mode>] [--task <task>] [--skip-project-sync]", description: "Prepare (if needed) and run an agent in its workspace.", primary: true },
-      { command: "cleanup [--all] [--id <id>]", description: "Remove prepared agent workspaces.", primary: true }
-    ]
-  },
-  { name: "inspector", summary: "Event stream and drift scanners.", usage: ["rig inspector <stream|scan-upstream-drift>"], commands: [{ command: "stream", description: "Stream events." }] },
-  {
-    name: "dist",
-    summary: "Build/install packaged Rig CLI.",
-    usage: ["rig dist <build|install|doctor|rebuild-agent>"],
-    commands: [
-      { command: "build [--output-dir <dir>]", description: "Build the distributable Rig CLI.", primary: true },
-      { command: "install [--scope <scope>] [--path <path>]", description: "Install the built CLI to a scope/path.", primary: true },
-      { command: "doctor", description: "Diagnose the dist toolchain and install state.", primary: true },
-      { command: "rebuild-agent", description: "Rebuild the agent runtime image, pruning stale images.", primary: true }
-    ]
-  },
-  {
-    name: "workspace",
-    summary: "Workspace topology/service helpers.",
-    usage: ["rig workspace <summary|topology|remote-hosts|service-fabric>"],
-    commands: [
-      { command: "summary", description: "Show workspace summary.", primary: true },
-      { command: "topology", description: "List discovered workspace services.", primary: true },
-      { command: "remote-hosts", description: "List configured remote workspace hosts.", primary: true },
-      { command: "service-fabric <status|up|verify|down> [--service <name>]", description: "Inspect or mutate the workspace service fabric.", primary: true }
-    ]
-  },
-  {
-    name: "remote",
-    summary: "Legacy automation-only remote orchestration controls.",
-    usage: ["rig remote <status|tasks|watch|pause|resume|continue|stop|refresh|add-iterations|remove-iterations|endpoint ...>"],
-    commands: [
-      { command: "status [--remote <alias>]", description: "Legacy automation-only: show old remote orchestration state.", primary: true },
-      { command: "tasks [--remote <alias>]", description: "Legacy automation-only: list the old remote's tracked tasks.", primary: true },
-      { command: "watch [--remote <alias>] [--seconds <n>] [--event <type>]", description: "Legacy automation-only: stream old remote orchestration events.", primary: true },
-      { command: "pause [--remote <alias>]", description: "Legacy automation-only: pause old remote orchestration.", primary: true },
-      { command: "resume [--remote <alias>] [--max-workers <n>] [--max-iterations <n>] [--direct-merge]", description: "Legacy automation-only: resume old remote orchestration with optional tuning.", primary: true },
-      { command: "continue [--remote <alias>]", description: "Legacy automation-only: continue a paused old remote.", primary: true },
-      { command: "stop [--remote <alias>]", description: "Legacy automation-only: stop old remote orchestration.", primary: true },
-      { command: "refresh [--remote <alias>]", description: "Legacy automation-only: refresh old remote state.", primary: true },
-      { command: "add-iterations [--count <n>] [--remote <alias>]", description: "Legacy automation-only: grant an old remote more iterations.", primary: true },
-      { command: "remove-iterations [--count <n>] [--remote <alias>]", description: "Legacy automation-only: reduce an old remote's iteration budget.", primary: true },
-      { command: "endpoint list", description: "Legacy automation-only: list configured remote endpoints.", primary: true },
-      { command: "endpoint add --alias <alias> --host <host> --port <n> [--token <token>]", description: "Legacy automation-only: register a remote endpoint.", primary: true },
-      { command: "endpoint remove --alias <alias>", description: "Legacy automation-only: remove a remote endpoint.", primary: true },
-      { command: "endpoint test [--alias <alias>]", description: "Legacy diagnostic-only: test connectivity to a remote endpoint.", primary: true },
-      { command: "endpoint doctor", description: "Legacy diagnostic-only: diagnose remote endpoint configuration.", primary: true }
-    ]
-  },
-  { name: "git", summary: "Pass through to Rig git-flow helper.", usage: ["rig git <args...>"], commands: [{ command: "<args...>", description: "Advanced git flow operations." }] },
-  { name: "harness", summary: "Pass through to runtime harness CLI.", usage: ["rig harness <args...>"], commands: [{ command: "<args...>", description: "Advanced harness operations." }] },
-  { name: "test", summary: "Project test wrappers.", usage: ["rig test <unit|e2e|all>"], commands: [{ command: "all", description: "Run configured project tests." }] }
-];
-var ALL_GROUPS = [...PRIMARY_GROUPS, ...ADVANCED_GROUPS];
-function heading(title) {
-  return pc2.bold(pc2.cyan(title));
-}
-function commandLine(command, description) {
-  const commandColumn = command.length >= 38 ? `${command}  ` : command.padEnd(38);
-  return `${pc2.dim("\u2502")} ${pc2.bold(commandColumn)} ${description}`;
-}
-function renderCommandBlock(commands) {
-  return commands.map((entry) => commandLine(entry.command, entry.description)).join(`
-`);
-}
-function renderGroup(group) {
-  const lines = [
-    `${heading(`rig ${group.name}`)} \u2014 ${group.summary}`,
-    "",
-    pc2.bold("Usage"),
-    ...group.usage.map((line) => `  ${line}`),
-    "",
-    pc2.bold("Commands"),
-    ...group.commands.map((entry) => commandLine(entry.command, entry.description))
-  ];
-  if (group.examples?.length) {
-    lines.push("", pc2.bold("Examples"), ...group.examples.map((line) => `  ${pc2.dim("$")} ${line}`));
-  }
-  if (group.next?.length) {
-    lines.push("", pc2.bold("Next steps"), ...group.next.map((line) => `  ${pc2.dim("\u203A")} ${line}`));
-  }
-  if (group.advanced?.length) {
-    lines.push("", pc2.bold("Compatibility / advanced"), ...group.advanced.map((line) => `  ${pc2.dim("\u203A")} ${line}`));
-  }
-  return lines.join(`
-`);
-}
-function renderTopLevelHelp() {
-  return [
-    `${heading("rig")} ${pc2.dim("\u2014 Rig Cockpit for autonomous coding agents")}`,
-    pc2.dim("The loop: bare `rig` \u2192 Cockpit \u2192 Server target \u2192 Tasks \u2192 Task detail \u2192 Dispatch/Attach; every run uses OMP collaboration as the session substrate."),
-    "",
-    ...TOP_LEVEL_SECTIONS.flatMap((section) => [
-      `${pc2.bold(pc2.magenta(`\u25C7 ${section.title}`))} \u2014 ${pc2.dim(section.subtitle)}`,
-      renderCommandBlock(section.commands),
-      ""
-    ]),
-    pc2.dim("More: `rig help --advanced` for fenced legacy/diagnostic commands; `rig <group> --help` for per-group compatibility help; `rig --version` for the installed version."),
-    "",
-    pc2.bold("Root options"),
-    commandLine("--workspace <path>", "Open Rig Cockpit for a workspace instead of the current directory."),
-    commandLine("--json", "Compatibility flag for fenced legacy/diagnostic subcommands."),
-    commandLine("--dry-run", "Compatibility flag for fenced legacy/diagnostic subcommands.")
-  ].join(`
-`).trimEnd();
-}
-function renderGroupHelp(groupName) {
-  const group = ALL_GROUPS.find((candidate) => candidate.name === groupName);
-  return group ? renderGroup(group) : null;
-}
-function printGroupHelpDocument(groupName) {
-  console.log(renderGroupHelp(groupName) ?? renderTopLevelHelp());
-}
-
-// packages/cli/src/commands/_run-projection.ts
-import { existsSync as existsSync2, readdirSync as readdirSync2, readFileSync as readFileSync2 } from "fs";
-import { resolve as resolve2 } from "path";
-import {
-  foldRunSessionEntries,
-  sessionIdFromSessionFile as sessionIdFromSessionFile2
-} from "@rig/contracts";
-import { listAgentRuntimes as listAgentRuntimes2 } from "@rig/runtime/control-plane/runtime/isolation";
-
-// packages/cli/src/commands/_run-bridge.ts
-import { existsSync, readdirSync, readFileSync } from "fs";
-import { dirname, resolve } from "path";
-import { CUSTOM_TYPE_FOR, sessionIdFromSessionFile } from "@rig/contracts";
-import { createPluginHost } from "@rig/core";
-import { loadConfig } from "@rig/core/load-config";
-import { resolveOwnerNamespaceKey, resolveRegistryBaseUrl, resolveRegistrySecret, resolveSelectedRemote } from "@rig/runtime/control-plane/remote";
-import { listAgentRuntimes } from "@rig/runtime/control-plane/runtime/isolation";
-import { createRegistryClient } from "@rig/relay-registry";
-import {
-  listActiveCollabSessions as ompListActiveCollabSessions
-} from "@oh-my-pi/pi-coding-agent/collab/api";
-function registrySecret(env = process.env) {
-  return resolveRegistrySecret(process.cwd(), env) ?? null;
-}
-function registryBaseUrl(env = process.env) {
-  return resolveRegistryBaseUrl(process.cwd(), env);
-}
-function collabFromRegistryEntry(entry) {
-  return {
-    sessionId: entry.roomId,
-    sessionPath: "",
-    cwd: "",
-    title: entry.title,
-    joinLink: entry.joinLink,
-    webLink: entry.webLink,
-    relayUrl: entry.relayUrl,
-    owner: entry.owner,
-    selectedRepo: entry.repo,
-    startedAt: entry.startedAt,
-    updatedAt: entry.heartbeatAt,
-    ...entry.pid === undefined ? {} : { pid: entry.pid },
-    stale: entry.stale
-  };
-}
-function isRecord(value) {
-  return typeof value === "object" && value !== null;
-}
-function readLocalRunCollab(runtime) {
-  if (!runtime.sessionDir || !existsSync(runtime.sessionDir))
-    return null;
-  let files;
-  try {
-    files = readdirSync(runtime.sessionDir).filter((f) => f.endsWith(".jsonl")).sort().reverse();
-  } catch {
-    return null;
-  }
-  for (const file of files) {
-    let lines;
-    try {
-      lines = readFileSync(resolve(runtime.sessionDir, file), "utf8").split(`
-`);
-    } catch {
-      continue;
-    }
-    let host = null;
-    for (const line of lines) {
-      if (!line.includes("collab-host-started"))
-        continue;
-      let entry;
-      try {
-        entry = JSON.parse(line);
-      } catch {
-        continue;
-      }
-      if (!isRecord(entry) || entry.customType !== CUSTOM_TYPE_FOR["timeline-entry"] || !isRecord(entry.data))
-        continue;
-      const payload = isRecord(entry.data.payload) ? entry.data.payload : entry.data;
-      if (payload.type !== "collab-host-started")
-        continue;
-      host = {
-        roomId: typeof payload.roomId === "string" ? payload.roomId : undefined,
-        joinLink: typeof payload.joinLink === "string" ? payload.joinLink : undefined,
-        webLink: typeof payload.webLink === "string" ? payload.webLink : undefined,
-        relayUrl: typeof payload.relayUrl === "string" ? payload.relayUrl : undefined,
-        at: typeof entry.data.at === "string" ? entry.data.at : undefined
-      };
-    }
-    if (!host?.joinLink)
-      continue;
-    const at = host.at ?? "";
-    const sessionId = host.roomId ?? sessionIdFromSessionFile(resolve(runtime.sessionDir, file)) ?? runtime.id;
-    return {
-      sessionId,
-      sessionPath: resolve(runtime.sessionDir, file),
-      cwd: runtime.workspaceDir,
-      joinLink: host.joinLink,
-      webLink: host.webLink ?? "",
-      relayUrl: host.relayUrl ?? "",
-      title: runtime.taskId ? `[${runtime.taskId}] Rig run ${sessionId}` : `Rig run ${sessionId}`,
-      startedAt: at,
-      updatedAt: at,
-      stale: false
-    };
-  }
-  return null;
-}
-async function listLocalRunCollabSessions(projectRoot) {
-  let runtimes;
-  try {
-    runtimes = await listAgentRuntimes(projectRoot);
-  } catch {
-    return [];
-  }
-  const out = [];
-  for (const runtime of runtimes) {
-    const collab = readLocalRunCollab(runtime);
-    if (collab)
-      out.push(collab);
-  }
-  return out;
-}
-async function listActiveRunCollab(filter) {
-  return defaultListActiveCollabSessions(filter);
-}
-async function defaultListActiveCollabSessions(filter) {
-  const projectRoot = process.cwd();
-  const local = await listLocalRunCollabSessions(projectRoot);
-  const namespaceKey = filter.namespaceKey ?? resolveOwnerNamespaceKey(projectRoot);
-  const secret = registrySecret();
-  const remote = namespaceKey && secret ? (await createRegistryClient({ baseUrl: registryBaseUrl(), namespaceKey, secret }).listRoomsByOwner(filter)).map(collabFromRegistryEntry) : await ompListActiveCollabSessions(filter);
-  const seen = new Set(local.map((c) => c.sessionId));
-  return [...local, ...remote.filter((c) => !seen.has(c.sessionId))];
-}
-
-// packages/cli/src/commands/_run-diagnostics.ts
-function normalizeString(value) {
-  if (typeof value !== "string")
-    return null;
-  const normalized = value.replace(/\s+/g, " ").trim();
-  return normalized.length > 0 ? normalized : null;
-}
-function isGenericRunFailure(value) {
-  const text = normalizeString(value);
-  return Boolean(text && /^Task run failed \([^)]*\)$/i.test(text));
-}
-function appendCandidate(candidates, value) {
-  const text = normalizeString(value);
-  if (text && !candidates.includes(text))
-    candidates.push(text);
-}
-function categorizeUsefulRunError(lines) {
-  const taskSourceFailure = lines.find((line) => /failed to update task source/i.test(line));
-  if (taskSourceFailure)
-    return `Task source update failed: ${taskSourceFailure}`;
-  const moduleFailure = lines.find((line) => /cannot find module/i.test(line));
-  if (moduleFailure)
-    return `Runtime module resolution failed: ${moduleFailure}`;
-  const providerFailure = lines.find((line) => /no api key found|unauthorized|authentication failed|invalid api key/i.test(line));
-  if (providerFailure)
-    return `Provider authentication failed: ${providerFailure}`;
-  return null;
-}
-function summarizeUsefulRunError(projection) {
-  if (projection.status !== "failed")
-    return null;
-  const candidates = [];
-  for (const anomaly of projection.anomalies) {
-    appendCandidate(candidates, `Journal anomaly (${anomaly.kind}): ${anomaly.detail}`);
-  }
-  for (const phase of projection.closeoutPhases) {
-    if (phase.outcome === "failed")
-      appendCandidate(candidates, phase.detail);
-  }
-  for (const entry of projection.statusHistory) {
-    appendCandidate(candidates, entry.reason);
-  }
-  appendCandidate(candidates, projection.record.statusDetail);
-  appendCandidate(candidates, projection.record.errorText);
-  const nonGeneric = candidates.filter((candidate) => !isGenericRunFailure(candidate));
-  return categorizeUsefulRunError(nonGeneric) ?? nonGeneric.at(-1) ?? normalizeString(projection.record.errorText);
-}
-
-// packages/cli/src/commands/_run-projection.ts
-var EMPTY_PROJECTION = foldRunSessionEntries([], "");
-function stringOrNull(value) {
-  return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
-}
-function newestSessionFile(sessionDir) {
-  if (!sessionDir || !existsSync2(sessionDir))
-    return null;
-  try {
-    const files = readdirSync2(sessionDir).filter((file) => file.endsWith(".jsonl")).sort().reverse();
-    return files[0] ? resolve2(sessionDir, files[0]) : null;
-  } catch {
-    return null;
-  }
-}
-function readSessionRunEntries(sessionPath) {
-  if (!sessionPath || !existsSync2(sessionPath))
-    return [];
-  let raw;
-  try {
-    raw = readFileSync2(sessionPath, "utf8");
-  } catch {
-    return [];
-  }
-  const entries = [];
-  for (const line of raw.split(`
-`)) {
-    if (!line.trim())
-      continue;
-    let parsed;
-    try {
-      parsed = JSON.parse(line);
-    } catch {
-      continue;
-    }
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
-      continue;
-    entries.push({
-      type: "type" in parsed && typeof parsed.type === "string" ? parsed.type : "",
-      ..."customType" in parsed && typeof parsed.customType === "string" ? { customType: parsed.customType } : {},
-      ..."data" in parsed ? { data: parsed.data } : {}
-    });
-  }
-  return entries;
-}
-function recordFromProjection(runId, projection, presence) {
-  const record = projection.record;
-  const status = projection.status ?? (presence.stale ? "stale" : presence.live ? "running" : "unknown");
-  const taskId = stringOrNull(record.taskId) ?? presence.fallbackTaskId ?? null;
-  const title = stringOrNull(record.title) ?? stringOrNull(presence.title) ?? (taskId ? `Run ${taskId}` : `Rig run ${runId}`);
-  return {
-    runId,
-    taskId,
-    title,
-    status,
-    source: presence.source,
-    live: presence.live,
-    stale: presence.stale,
-    startedAt: stringOrNull(record.startedAt) ?? presence.startedAt ?? null,
-    updatedAt: stringOrNull(record.updatedAt) ?? presence.updatedAt ?? projection.lastEventAt ?? null,
-    completedAt: stringOrNull(record.completedAt),
-    joinLink: presence.joinLink ?? null,
-    webLink: presence.webLink ?? null,
-    relayUrl: presence.relayUrl ?? null,
-    sessionPath: stringOrNull(record.sessionPath) ?? presence.sessionPath ?? null,
-    prUrl: stringOrNull(record.prUrl),
-    worktreePath: stringOrNull(record.worktreePath),
-    pendingApprovals: projection.pendingApprovals.length,
-    pendingInputs: projection.pendingUserInputs.length,
-    steeringCount: projection.steeringCount,
-    stallCount: projection.stallCount,
-    errorSummary: summarizeUsefulRunError(projection),
-    projection
-  };
-}
-function recordFromLiveCollab(collab) {
-  const runId = collab.sessionId;
-  const sessionPath = stringOrNull(collab.sessionPath);
-  const projection = sessionPath ? foldRunSessionEntries(readSessionRunEntries(sessionPath), runId) : EMPTY_PROJECTION;
-  return recordFromProjection(runId, projection, {
-    source: sessionPath ? "local" : "remote",
-    live: !collab.stale,
-    stale: Boolean(collab.stale),
-    title: collab.title,
-    joinLink: stringOrNull(collab.joinLink),
-    webLink: stringOrNull(collab.webLink),
-    relayUrl: stringOrNull(collab.relayUrl),
-    sessionPath,
-    startedAt: stringOrNull(collab.startedAt),
-    updatedAt: stringOrNull(collab.updatedAt)
-  });
-}
-function recordFromRuntime(runtime) {
-  const sessionPath = newestSessionFile(runtime.sessionDir ?? "");
-  if (!sessionPath)
-    return null;
-  const projection = foldRunSessionEntries(readSessionRunEntries(sessionPath), runtime.id);
-  if (projection.lastSeq === 0)
-    return null;
-  return recordFromProjection(sessionIdFromSessionFile2(sessionPath) ?? runtime.id, projection, {
-    source: "local",
-    live: false,
-    stale: false,
-    sessionPath,
-    fallbackTaskId: stringOrNull(runtime.taskId)
-  });
-}
-function sortByRecency(records) {
-  return [...records].sort((a, b) => {
-    const at = Date.parse(b.updatedAt ?? b.startedAt ?? "") || 0;
-    const bt = Date.parse(a.updatedAt ?? a.startedAt ?? "") || 0;
-    return at - bt;
-  });
-}
-async function listRunProjections(projectRoot, filter = {}) {
-  const byRunId = new Map;
-  let live = [];
-  try {
-    live = await listActiveRunCollab(filter);
-  } catch {
-    live = [];
-  }
-  for (const collab of live) {
-    const record = recordFromLiveCollab(collab);
-    byRunId.set(record.runId, record);
-  }
-  let runtimes = [];
-  try {
-    runtimes = await listAgentRuntimes2(projectRoot);
-  } catch {
-    runtimes = [];
-  }
-  for (const runtime of runtimes) {
-    const record = recordFromRuntime(runtime);
-    if (!record)
-      continue;
-    const sessionId = sessionIdFromSessionFile2(record.sessionPath);
-    const liveMatch = sessionId ? byRunId.get(sessionId) : undefined;
-    if (liveMatch) {
-      if (liveMatch.source === "remote" || !liveMatch.sessionPath) {
-        byRunId.set(liveMatch.runId, { ...liveMatch, sessionPath: record.sessionPath, source: "local" });
-      }
-      continue;
-    }
-    if (byRunId.has(runtime.id))
-      continue;
-    byRunId.set(record.runId, record);
-  }
-  return sortByRecency([...byRunId.values()]);
-}
-
-// packages/cli/src/commands/stats.ts
-var DAY_MS = 24 * 60 * 60 * 1000;
-function parseSinceOption(value, now = new Date) {
-  if (!value?.trim())
-    return null;
-  const trimmed = value.trim();
-  const relative = trimmed.match(/^(\d+)d$/i);
-  if (relative?.[1]) {
-    const days = Number.parseInt(relative[1], 10);
-    if (!Number.isFinite(days) || days <= 0) {
-      throw new CliError(`Invalid --since value: ${value}`, 2, {
-        hint: "Use an ISO date or a relative window like `7d`."
-      });
-    }
-    return new Date(now.getTime() - days * DAY_MS);
-  }
-  const parsed = Date.parse(trimmed);
-  if (!Number.isFinite(parsed)) {
-    throw new CliError(`Invalid --since value: ${value}`, 2, {
-      hint: "Use an ISO date or a relative window like `7d`."
-    });
-  }
-  return new Date(parsed);
-}
-function parseTimestamp(value) {
-  if (!value)
-    return null;
-  const parsed = Date.parse(value);
-  return Number.isFinite(parsed) ? parsed : null;
-}
-function median(values) {
-  if (values.length === 0)
-    return null;
-  const sorted = [...values].sort((left, right) => left - right);
-  const middle = Math.floor(sorted.length / 2);
-  return sorted.length % 2 === 1 ? sorted[middle] : (sorted[middle - 1] + sorted[middle]) / 2;
-}
-function rate(part, total) {
-  return total === 0 ? null : part / total;
-}
-function isNeedsAttention(run) {
-  return run.status === "needs-attention" || run.pendingApprovals + run.pendingInputs > 0 || run.stallCount > 0;
-}
-function completedDuration(run) {
-  if (run.status !== "completed")
-    return null;
-  const startedAt = parseTimestamp(run.startedAt);
-  const completedAt = parseTimestamp(run.completedAt);
-  if (startedAt === null || completedAt === null || completedAt < startedAt)
-    return null;
-  return completedAt - startedAt;
-}
-async function computeRigStats(projectRoot, options = {}) {
-  const sinceMs = options.since ? options.since.getTime() : null;
-  const allRuns = await (options.listRuns ?? listRunProjections)(projectRoot);
-  const runs = allRuns.filter((run) => {
-    if (sinceMs === null)
-      return true;
-    const startedAt = parseTimestamp(run.startedAt);
-    return startedAt !== null && startedAt >= sinceMs;
-  });
-  const statusCounts = {};
-  const completionDurations = [];
-  let completedRuns = 0;
-  let failedRuns = 0;
-  let needsAttentionRuns = 0;
-  let steeringTotal = 0;
-  let stallTotal = 0;
-  let approvalsPending = 0;
-  for (const run of runs) {
-    const status = run.status || "unknown";
-    statusCounts[status] = (statusCounts[status] ?? 0) + 1;
-    if (status === "completed")
-      completedRuns += 1;
-    if (status === "failed")
-      failedRuns += 1;
-    if (isNeedsAttention(run))
-      needsAttentionRuns += 1;
-    const duration = completedDuration(run);
-    if (duration !== null)
-      completionDurations.push(duration);
-    steeringTotal += run.steeringCount;
-    stallTotal += run.stallCount;
-    approvalsPending += run.pendingApprovals;
-  }
-  const totalRuns = runs.length;
-  return {
-    since: options.since ? options.since.toISOString() : null,
-    totalRuns,
-    statusCounts,
-    completedRuns,
-    failedRuns,
-    needsAttentionRuns,
-    completionRate: rate(completedRuns, totalRuns),
-    failureRate: rate(failedRuns, totalRuns),
-    needsAttentionRate: rate(needsAttentionRuns, totalRuns),
-    medianCompletionMs: median(completionDurations),
-    steeringTotal,
-    steeringPerRun: totalRuns === 0 ? null : steeringTotal / totalRuns,
-    stallTotal,
-    approvalsRequested: approvalsPending,
-    approvalsApproved: 0,
-    approvalsRejected: 0,
-    approvalsPending
-  };
-}
-function formatPercent(value) {
-  return value === null ? "\u2014" : `${Math.round(value * 100)}%`;
-}
-function formatDuration(ms) {
-  if (ms === null)
-    return "\u2014";
-  const seconds = Math.round(ms / 1000);
-  if (seconds < 60)
-    return `${seconds}s`;
-  const minutes = Math.round(ms / 60000);
-  if (minutes < 60)
-    return `${minutes}m`;
-  const hours = Math.floor(minutes / 60);
-  const remainder = minutes % 60;
-  return remainder === 0 ? `${hours}h` : `${hours}h ${remainder}m`;
-}
-function formatStatsRows(stats) {
-  return [
-    ["window", stats.since ? `since ${stats.since}` : "all runs"],
-    ["total runs", stats.totalRuns],
-    ["completed", `${stats.completedRuns} (${formatPercent(stats.completionRate)})`],
-    ["failed", `${stats.failedRuns} (${formatPercent(stats.failureRate)})`],
-    ["needs attention", `${stats.needsAttentionRuns} (${formatPercent(stats.needsAttentionRate)})`],
-    ["median run time", formatDuration(stats.medianCompletionMs)],
-    ["steering", stats.steeringTotal],
-    ["stalls", stats.stallTotal],
-    ["pending approvals", stats.approvalsPending]
-  ];
-}
-async function executeStats(context, args, deps = {}) {
-  const [first = "show", ...rest] = args;
-  const command = first.startsWith("-") ? "show" : first;
-  const commandArgs = first.startsWith("-") ? args : rest;
-  if (command === "help") {
-    printGroupHelpDocument("stats");
-    return { ok: true, group: "stats", command };
-  }
-  if (command !== "show") {
-    throw new CliError(`Unknown stats command: ${command}`, 1, {
-      hint: "Run `rig stats --help` \u2014 the default command is `show`."
-    });
-  }
-  const sinceResult = takeOption(commandArgs, "--since");
-  requireNoExtraArgs(sinceResult.rest, "rig stats [show] [--since <7d|30d|ISO date>]");
-  const details = await computeRigStats(context.projectRoot, {
-    since: parseSinceOption(sinceResult.value),
-    listRuns: deps.listRuns
-  });
-  if (context.outputMode === "text") {
-    printFormattedOutput(formatStatsTable(formatStatsRows(details)));
-  }
-  return { ok: true, group: "stats", command, details };
-}
-export {
-  parseSinceOption,
-  formatStatsRows,
-  executeStats,
-  computeRigStats
-};