@h-rig/cli 0.0.6-alpha.89 → 0.0.6-alpha.90

package/dist/src/app-opentui/scenes/help.js

@@ -1,725 +0,0 @@
-// @bun
-// packages/cli/src/app-opentui/theme.ts
-import {
-  bold as otuiBold,
-  dim as otuiDim,
-  fg as otuiFg,
-  t,
-  TextAttributes
-} from "@opentui/core";
-var RIG_UI = {
-  bg: "#070809",
-  bg2: "#0b0c0e",
-  panel: "#101115",
-  panel2: "#14161b",
-  hover: "#181b24",
-  glass: "#1e2230",
-  border: "#2a2e3a",
-  ink: "#f4f5f8",
-  ink2: "#c7c9d3",
-  ink3: "#9aa0ae",
-  ink4: "#787b86",
-  lime: "#ccff4d",
-  limeDim: "#a9d63f",
-  cyan: "#56d8ff",
-  cyanDim: "#3f9fbd",
-  red: "#ff5d5d",
-  yellow: "#ffd24d",
-  magenta: "#ff79b0"
-};
-var styles = {
-  ink: otuiFg(RIG_UI.ink),
-  ink2: otuiFg(RIG_UI.ink2),
-  ink3: otuiFg(RIG_UI.ink3),
-  ink4: otuiFg(RIG_UI.ink4),
-  lime: otuiFg(RIG_UI.lime),
-  limeDim: otuiFg(RIG_UI.limeDim),
-  cyan: otuiFg(RIG_UI.cyan),
-  red: otuiFg(RIG_UI.red),
-  yellow: otuiFg(RIG_UI.yellow),
-  magenta: otuiFg(RIG_UI.magenta)
-};
-
-// packages/cli/src/app-opentui/drone.ts
-import { RGBA, StyledText, TextAttributes as TextAttributes2 } from "@opentui/core";
-var COLOR = {
-  body: RGBA.fromHex(RIG_UI.lime),
-  mini: RGBA.fromHex(RIG_UI.limeDim),
-  rotor: RGBA.fromHex(RIG_UI.cyan),
-  path: RGBA.fromHex(RIG_UI.cyan),
-  eye: RGBA.fromHex(RIG_UI.ink),
-  dim: RGBA.fromHex(RIG_UI.ink4),
-  ink: RGBA.fromHex(RIG_UI.ink2)
-};
-
-// packages/cli/src/app-opentui/render/scene.ts
-function line(text, options = {}) {
-  return { text, ...options };
-}
-function deckRow(input) {
-  const prefix = input.active ? "\u25B8" : " ";
-  const label = input.label.toUpperCase().padEnd(10);
-  return line(`${prefix} ${label} ${input.detail}`, {
-    fg: input.active ? RIG_UI.lime : RIG_UI.ink2,
-    bold: input.active,
-    selectableIndex: input.index,
-    activateOnClick: input.activateOnClick
-  });
-}
-function makeSceneFrame(input) {
-  return input;
-}
-
-// packages/cli/src/app-opentui/selectable.ts
-function selectableDeckRow(deck, item) {
-  return { ...deckRow({ ...deck, activateOnClick: true }), selectable: item };
-}
-
-// packages/cli/src/commands/_help-catalog.ts
-import pc from "picocolors";
-function helpCatalog() {
-  return { sections: TOP_LEVEL_SECTIONS, groups: ALL_GROUPS };
-}
-var TOP_LEVEL_SECTIONS = [
-  {
-    title: "Pi console",
-    subtitle: "the operator surface \u2014 every attach opens the run's FULL Pi session",
-    commands: [
-      { command: "rig run attach <run-id>", description: "Open the run's Pi console: complete transcript (live AND finished runs), worker turns streaming in live." },
-      { command: "type a message", description: "Inside the console, plain text steers the worker mid-turn \u2014 it lands in the agent's context, not a local model." },
-      { command: "!<command>", description: "Inside the console, runs shell in the WORKER's workspace; output streams back into the transcript." },
-      { command: "/<command>", description: "The palette includes the WORKER session's slash commands ([worker]-tagged) next to /rig." },
-      { command: "/rig abort | /rig stop", description: "Abort the worker's current turn, or stop the whole run, from inside the console." },
-      { command: "rig run steer <id> --message <text>", description: "Steer without attaching \u2014 queue a message; the worker picks it up within seconds." }
-    ]
-  },
-  {
-    title: "Start here",
-    subtitle: "one-time setup, pick a server",
-    commands: [
-      { command: "rig init", description: "Wizard: config, GitHub auth, task source, server, Pi wiring." },
-      { command: "rig server use <alias|local>", description: "Pick which Rig server owns this repo (`rig server list` to see them)." },
-      { command: "rig server status", description: "Show the selected server for this repo." }
-    ]
-  },
-  {
-    title: "Work",
-    subtitle: "find a task, put an agent on it, answer what it asks",
-    commands: [
-      { command: "rig task list", description: "What's on the board (from the selected source/server)." },
-      { command: "rig task run --next", description: "Dispatch an agent on the next ready task; interactive mode drops you into its Pi console." },
-      { command: "rig run status", description: "Active and recent runs at a glance." },
-      { command: "rig run attach <id> --follow", description: "Same as plain attach \u2014 the Pi console is always the interactive surface." },
-      { command: "rig inbox approvals", description: "Approvals workers are waiting on (then `rig inbox approve \u2026`)." }
-    ]
-  },
-  {
-    title: "Watch",
-    subtitle: "fleet metrics and per-task forensics",
-    commands: [
-      { command: "rig stats [--since 7d]", description: "Fleet metrics: completion/failure rates, median run time, steering, stalls." },
-      { command: "rig inspect logs --task <id>", description: "Latest run log for a task." },
-      { command: "rig inspect diff --task <id>", description: "Changed files for a task." }
-    ]
-  },
-  {
-    title: "Unblock",
-    subtitle: "diagnose wiring, fix auth",
-    commands: [
-      { command: "rig doctor", description: "Check every part of the wiring \u2014 run this when anything feels off." },
-      { command: "rig github auth status", description: "GitHub auth state on the selected server." }
-    ]
-  },
-  {
-    title: "Extend",
-    subtitle: "plugins contribute validators, hooks, task sources, commands",
-    commands: [
-      { command: "rig plugin list", description: "What the rig.config.ts plugins contribute." },
-      { command: "rig plugin run <command-id>", description: "Execute a plugin-contributed CLI command." }
-    ]
-  }
-];
-var PRIMARY_GROUPS = [
-  {
-    name: "server",
-    summary: "Choose, inspect, and start the Rig server that owns tasks and runs.",
-    usage: ["rig server <status|list|add|use|repair-link|start> [options]"],
-    commands: [
-      { command: "status", description: "Show the selected server and remote project-root link for this repo.", primary: true },
-      { command: "use local", description: "Switch this repo to the local Rig server.", primary: true },
-      { command: "add <alias> <url>", description: "Save a remote Rig server URL.", primary: true },
-      { command: "use <alias>", description: "Select a saved remote server alias.", primary: true },
-      { command: "repair-link [--prepare|--backfill-only] [--repo owner/repo]", description: "Backfill or prepare the selected remote's server-host checkout link.", primary: true },
-      { command: "list", description: "List saved local/remote server aliases.", primary: true },
-      { command: "start [--host <host>] [--port <n>]", description: "Start a local rig-server process." }
-    ],
-    examples: [
-      "rig server status",
-      "rig server add prod https://where.rig-does.work",
-      "rig server use prod",
-      "rig server repair-link --repo owner/repo",
-      "rig server use local",
-      "rig server start --port 3773"
-    ],
-    next: ["Use `rig task list` to see server-owned work.", "Use `rig run list` or `rig run attach <id> --follow` to monitor runs."]
-  },
-  {
-    name: "task",
-    summary: "Find work, start Pi-backed runs, and validate task results.",
-    usage: ["rig task <list|next|show|run> [options]"],
-    commands: [
-      { command: "list [--assignee <login|me|@me>] [--state open|closed]", description: "List tasks from the selected server/source.", primary: true },
-      { command: "next [filters]", description: "Render the next matching task as a selected-task card.", primary: true },
-      { command: "show <id>|--task <id> [--raw]", description: "Show a human task summary; --raw prints the full payload.", primary: true },
-      { command: "run [#<issue>|<task-id>|--next|--task <id>]", description: "Submit a task run; interactive follows with bundled Pi.", primary: true },
-      { command: "ready", description: "List task IDs that are runnable now." },
-      { command: "validate|verify [--task <id>]", description: "Run configured task 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: "report-bug", description: "Create a structured bug report/task." }
-    ],
-    examples: [
-      "rig task list --assignee @me --limit 20",
-      "rig task next",
-      "rig task show 123 --raw",
-      "rig task run --next",
-      "rig task run #123 --runtime-adapter pi",
-      "rig task run --title 'Investigate deploy drift' --initial-prompt 'Check server health'"
-    ],
-    next: ["Use `--detach` to submit without attaching.", "Use `rig run attach <run-id> --follow` to rejoin a live run."]
-  },
-  {
-    name: "run",
-    summary: "Observe, attach to, and control Rig runs. `attach` opens the Pi console \u2014 the full worker session, live.",
-    usage: ["rig run <list|status|show|attach|steer|stop|resume|restart> [options]"],
-    commands: [
-      { command: "list", description: "List recent runs from the selected server or local state.", primary: true },
-      { command: "status", description: "Render active and recent run groups.", primary: true },
-      { command: "show <id>|--run <id> [--raw]", description: "Show a human run summary; --raw prints the full payload.", primary: true },
-      { command: "attach <run-id>|--run <id>", description: "Open the run's Pi console \u2014 see 'Inside the console' below. Works on live AND finished runs.", primary: true },
-      { command: "steer <run-id> --message <text>", description: "Queue a steering message into a live worker without attaching \u2014 delivered into the agent's context within seconds.", primary: true },
-      { command: "stop [<run-id>|--run <id>]", description: "Request stop for one run or local active runs.", primary: true },
-      { command: "resume [<run-id>]", description: "Resume an interrupted run on the selected server (defaults to the most recent resumable)." },
-      { command: "restart [<run-id>]", description: "Re-dispatch a run from a clean runtime, reopening its Pi session where possible." },
-      { command: "timeline --run <id> [--follow]", description: "Stream raw run timeline events (scripts; humans should attach)." },
-      { command: "replay <run-id>|--run <id> [--with-session]", description: "Print the run's consolidated run.jsonl as a merged timeline; --with-session interleaves the Pi session log." },
-      { command: "delete|cleanup", description: "Remove completed run records/artifacts." }
-    ],
-    examples: [
-      "rig run attach <run-id>          # full session console \u2014 live mirror, steering, worker shell",
-      "rig run steer <run-id> --message 'focus on the failing test first'",
-      "rig run list",
-      "rig run show <run-id>",
-      "rig run stop <run-id>"
-    ],
-    next: [
-      "Inside the console: the run's COMPLETE transcript loads on open (finished runs too), and new worker turns stream in live.",
-      "Inside the console: plain text = steering into the worker's context \xB7 !<cmd> = shell in the WORKER workspace \xB7 /<cmd> includes the worker session's commands \xB7 /rig abort stops the current turn.",
-      "The console is read-write but remote-only: nothing runs on your machine; the worker keeps running when you exit.",
-      "Use `rig task run --next` to create a new run; interactive mode drops you straight into its console.",
-      "Use `--json` when scripts need the full structured record."
-    ]
-  },
-  {
-    name: "inbox",
-    summary: "Review approval and user-input requests that block worker runs.",
-    usage: ["rig inbox <approvals|approve|inputs|respond> [options]"],
-    commands: [
-      { command: "approvals [--run <id>] [--task <id>]", description: "List pending approvals.", primary: true },
-      { command: "inputs [--run <id>] [--task <id>]", description: "List pending user-input requests.", primary: true },
-      { command: "approve --run <id> --request <id> --decision approve|reject", description: "Resolve an approval request." },
-      { command: "respond --run <id> --request <id> --answer key=value", description: "Answer a user-input request." }
-    ],
-    examples: [
-      "rig inbox approvals",
-      "rig inbox inputs --run <run-id>",
-      "rig inbox approve --run <run-id> --request <request-id> --decision approve"
-    ],
-    next: ["Rejoin the run after resolving a block: `rig run attach <run-id> --follow`."]
-  },
-  {
-    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: "Total runs, completion/failure/needs-attention rates, median run time, steering, stalls, approvals.", primary: true }
-    ],
-    examples: [
-      "rig stats",
-      "rig stats --since 7d",
-      "rig stats --since 2026-06-01 --json"
-    ],
-    next: ["Inspect outliers with `rig run list` and `rig run show <run-id>`.", "Use `--json` for the schema'd envelope (see docs/cli-json.md)."]
-  },
-  {
-    name: "inspect",
-    summary: "Inspect logs, artifacts, graphs, failures 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 (local or selected server).", primary: true },
-      { command: "artifacts --task <id>", description: "List the task's completion artifacts.", primary: true },
-      { command: "failures --task <id>", description: "Recorded failures for a task.", primary: true },
-      { command: "diff --task <id>", description: "Changed files 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: "Set up Rig for this repo: server, GitHub auth, checkout strategy, task source, and Pi wiring.",
-    usage: ["rig init [--yes] [--server local|remote] [--repo owner/repo] [--remote-url <url>]"],
-    commands: [
-      { command: "init", description: "Interactive setup wizard for a new or existing Rig repo.", primary: true },
-      { command: "init --demo", description: "Offline demo project: files task source + 3 sample tasks, zero GitHub.", primary: true },
-      { command: "init --yes", description: "Non-interactive setup using detected/default settings.", primary: true },
-      { command: "init --server remote --remote-url <url>", description: "Link this repo to a remote Rig server.", primary: true },
-      { command: "init --repair", description: "Repair missing private state without replacing project config." }
-    ],
-    examples: [
-      "rig init",
-      "rig init --demo",
-      "rig init --yes --repo humanity-org/humanwork",
-      "rig init --server remote --remote-url https://where.rig-does.work --repo owner/repo"
-    ],
-    next: ["After init, run `rig server status`.", "Then use `rig task list` and `rig task run --next` for day-to-day work."]
-  },
-  {
-    name: "doctor",
-    summary: "Diagnostics for project/server/GitHub/Pi state.",
-    usage: ["rig doctor"],
-    commands: [
-      { command: "doctor", description: "Run setup and runtime diagnostics.", primary: true },
-      { command: "check", description: "Compatibility spelling for diagnostics." }
-    ],
-    examples: ["rig doctor", "rig doctor --json"],
-    next: ["Use `rig server status` and `rig github auth status` to inspect common failure points."]
-  },
-  {
-    name: "github",
-    summary: "GitHub auth helpers for the selected Rig server.",
-    usage: ["rig github auth <status|import-gh|token>"],
-    commands: [
-      { command: "auth status", description: "Show GitHub auth state.", primary: true },
-      { command: "auth import-gh", description: "Import the current `gh` token into the selected server." },
-      { command: "auth token --token <token>", description: "Store a token on the selected server." }
-    ],
-    examples: ["rig github auth status", "rig github auth import-gh"],
-    next: ["After auth is valid, use `rig task run --next`."]
-  }
-];
-var ADVANCED_GROUPS = [
-  {
-    name: "setup",
-    summary: "Bootstrap/check local setup.",
-    usage: ["rig setup <bootstrap|check|preflight>"],
-    commands: [
-      { command: "bootstrap", description: "Bootstrap local setup dependencies.", primary: true },
-      { command: "check", description: "Check local setup state (toolchain, deps, config).", primary: true },
-      { command: "preflight", description: "Run preflight checks before a 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: ["Use `rig inbox approvals` for blocked run handoffs."]
-  },
-  {
-    name: "browser",
-    summary: "Browser workstation actions for browser-required tasks: launch, check, CDP probe, profile reset, and app-specific smokes.",
-    usage: ["rig browser <help|explain|demo|hp-next|cdp-probe|profile-persistence|profile-lock-check|smoke-test> [options]"],
-    commands: [
-      { command: "help", description: "Rich browser command help (canonical: `rig browser help`).", primary: true },
-      { command: "explain", description: "Explain the browser-required task contract and runtime helper commands.", primary: true },
-      { command: "demo [--port <n>] [--profile <name>] [--state-dir <path>] [--target-url <url>] [--keep-open] [--no-build]", description: "Run a guided real browser/agent demo flow.", primary: true },
-      { command: "hp-next dev", description: "Start hp-next Rig Browser in dev/watch mode.", primary: true },
-      { command: "hp-next start", description: "Build/start the hp-next browser workstation without watch mode.", primary: true },
-      { command: "hp-next check", description: "Validate the hp-next CDP endpoint on the configured port.", primary: true },
-      { command: "hp-next e2e", description: "Run hp-next browser e2e smoke checks through Rig Browser.", primary: true },
-      { command: "hp-next reset", description: "Reset the hp-next browser profile when stale browser state is suspected.", primary: true },
-      { command: "cdp-probe", description: "Run an isolated CDP attach/evaluate/layout probe." },
-      { command: "profile-persistence", description: "Verify a named browser profile persists browser state." },
-      { command: "profile-lock-check", description: "Verify concurrent launches reject the same profile." },
-      { command: "smoke-test", description: "Run the browser package smoke test." }
-    ],
-    examples: [
-      "rig browser help",
-      "rig browser hp-next check",
-      "rig browser hp-next e2e",
-      "rig browser cdp-probe",
-      "rig browser profile-lock-check"
-    ],
-    next: ["Inside a task run, use rig-browser-launch, rig-browser-check, and rig-browser-attach-info from the worker PATH."]
-  },
-  {
-    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>"], commands: [{ command: "summary", description: "Show workspace summary." }] },
-  {
-    name: "remote",
-    summary: "Compatibility 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: "Show the remote orchestration state.", primary: true },
-      { command: "tasks [--remote <alias>]", description: "List the remote's tracked tasks.", primary: true },
-      { command: "watch [--remote <alias>] [--seconds <n>] [--event <type>]", description: "Stream remote orchestration events.", primary: true },
-      { command: "pause [--remote <alias>]", description: "Pause the running remote orchestration.", primary: true },
-      { command: "resume [--remote <alias>] [--max-workers <n>] [--max-iterations <n>] [--direct-merge]", description: "Resume the remote with optional tuning.", primary: true },
-      { command: "continue [--remote <alias>]", description: "Continue a paused remote orchestration.", primary: true },
-      { command: "stop [--remote <alias>]", description: "Stop the remote orchestration.", primary: true },
-      { command: "refresh [--remote <alias>]", description: "Refresh remote state.", primary: true },
-      { command: "add-iterations [--count <n>] [--remote <alias>]", description: "Grant the remote more iterations.", primary: true },
-      { command: "remove-iterations [--count <n>] [--remote <alias>]", description: "Reduce the remote's iteration budget.", primary: true },
-      { command: "endpoint list", description: "List configured remote endpoints.", primary: true },
-      { command: "endpoint add --alias <alias> --host <host> --port <n> [--token <token>]", description: "Register a remote endpoint.", primary: true },
-      { command: "endpoint remove --alias <alias>", description: "Remove a remote endpoint.", primary: true },
-      { command: "endpoint test [--alias <alias>]", description: "Test connectivity to a remote endpoint.", primary: true },
-      { command: "endpoint doctor", description: "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];
-
-// packages/cli/src/app-opentui/surface-catalog.ts
-var NATIVE_FAMILY_SCENES = {
-  run: { scene: "fleet", kind: "refresh", argv: ["run", "status"], label: "Open runs" },
-  task: { scene: "tasks", kind: "refresh", argv: ["task", "list"], label: "Open tasks" },
-  inbox: { scene: "inbox", kind: "refresh", argv: ["inbox", "approvals"], label: "Open inbox" },
-  server: { scene: "server", kind: "refresh", argv: ["server", "status"], label: "Open server" },
-  init: { scene: "init", kind: "refresh", argv: ["init"], label: "Open init" },
-  doctor: { scene: "doctor", kind: "doctor-run", argv: ["doctor"], label: "Run doctor" }
-};
-var BESPOKE_FAMILIES = new Set([
-  "run",
-  "task",
-  "inbox",
-  "server",
-  "init",
-  "doctor",
-  "pi",
-  "plugin",
-  "repo",
-  "workspace",
-  "inspect"
-]);
-var SAFE_DIRECT_COMMANDS = new Set([
-  "server status",
-  "server list",
-  "server use local",
-  "task list",
-  "task next",
-  "task ready",
-  "run list",
-  "run status",
-  "inbox approvals",
-  "inbox inputs",
-  "stats show",
-  "plugin list",
-  "doctor doctor",
-  "doctor check",
-  "github auth status",
-  "browser help",
-  "browser explain",
-  "pi list",
-  "pi search",
-  "setup check",
-  "profile show",
-  "review show",
-  "repo sync",
-  "agent list",
-  "dist doctor",
-  "workspace summary",
-  "remote status"
-]);
-function normalizeCommandTemplate(command) {
-  return command.replace(/\s+/g, " ").trim();
-}
-function firstAlternative(value) {
-  return value.split("|")[0]?.trim() ?? value.trim();
-}
-function stripOptionalSegments(value) {
-  return value.replace(/\[[^\]]*\]/g, "").replace(/\s+/g, " ").trim();
-}
-function commandNeedsArguments(template) {
-  return /<[^>]+>|\.\.\.|\|/.test(template);
-}
-function commandKey(family, command) {
-  return `${family} ${normalizeCommandTemplate(command)}`.replace(/\s+/g, " ").trim();
-}
-function commandArgvForTemplate(group, command) {
-  const family = group.name;
-  const template = normalizeCommandTemplate(command.command);
-  if (!template || template === family)
-    return [family, "--help"];
-  const key = commandKey(family, template);
-  if (SAFE_DIRECT_COMMANDS.has(key))
-    return [family, ...stripOptionalSegments(template).split(/\s+/).filter(Boolean)];
-  const base = firstAlternative(stripOptionalSegments(template));
-  const parts = base.split(/\s+/).filter(Boolean);
-  if (!commandNeedsArguments(template) && parts.length > 0)
-    return [family, ...parts];
-  return [family, "--help"];
-}
-function promptArgvForTemplate(group, command) {
-  const base = stripOptionalSegments(firstAlternative(normalizeCommandTemplate(command.command)));
-  const words = [];
-  for (const part of base.split(/\s+/).filter(Boolean)) {
-    if (/[<>]|\.\.\./.test(part))
-      break;
-    words.push(part);
-  }
-  return [group.name, ...words];
-}
-function sceneForGroup(group) {
-  const native = NATIVE_FAMILY_SCENES[group.name];
-  if (native)
-    return native;
-  if (!BESPOKE_FAMILIES.has(group.name)) {
-    return { scene: "family", kind: "refresh", argv: [group.name], label: `Open ${group.name}` };
-  }
-  return { scene: "command", kind: "command-run", argv: [group.name, "--help"], label: `Open ${group.name}` };
-}
-function tuiSurfaceActions() {
-  const { groups } = helpCatalog();
-  return groups.flatMap((group) => {
-    const family = sceneForGroup(group);
-    const groupAction = {
-      id: `family:${group.name}`,
-      family: group.name,
-      label: group.name,
-      detail: group.summary,
-      argv: family.argv,
-      scene: family.scene,
-      kind: family.kind,
-      primary: true
-    };
-    const commandActions = group.commands.map((command, index) => {
-      const argv = commandArgvForTemplate(group, command);
-      const direct = argv[0] === group.name && argv.slice(1).join(" ") === stripOptionalSegments(firstAlternative(command.command));
-      const template = normalizeCommandTemplate(command.command);
-      const needsArgs = commandNeedsArguments(template) && argv.length === 2 && argv[1] === "--help";
-      const promptArgv = needsArgs ? promptArgvForTemplate(group, command) : undefined;
-      return {
-        id: `command:${group.name}:${index}:${command.command}`,
-        family: group.name,
-        label: `${group.name} ${command.command}`,
-        detail: direct ? command.description : needsArgs ? `${command.description} \xB7 enter args to run` : `${command.description} \xB7 opens ${group.name} command workspace/help`,
-        argv,
-        scene: "command",
-        kind: "command-run",
-        primary: command.primary,
-        template: `rig ${group.name} ${command.command}`.replace(/\s+/g, " ").trim(),
-        ...needsArgs ? { needsArgs: true, promptArgv } : {}
-      };
-    });
-    return [groupAction, ...commandActions];
-  });
-}
-function intentForSurfaceAction(action) {
-  return {
-    scene: action.scene,
-    argv: action.argv,
-    action: {
-      kind: action.kind,
-      label: action.kind === "command-run" ? `Open ${action.label}` : action.label,
-      payload: {
-        argv: [...action.argv],
-        family: action.family,
-        ...action.template ? { template: action.template } : {}
-      }
-    }
-  };
-}
-
-// packages/cli/src/app-opentui/scenes/help.ts
-function surfaceActionItem(action) {
-  if (action.needsArgs && action.promptArgv) {
-    return {
-      id: action.id,
-      label: action.label,
-      prompt: {
-        label: action.template ?? action.label,
-        scene: "command",
-        argv: [...action.promptArgv],
-        intentKind: "command-run",
-        payloadBase: {},
-        payloadKey: "args",
-        appendValueToArgv: true
-      },
-      message: `${action.template ?? action.label} \xB7 enter args to run`
-    };
-  }
-  return {
-    id: action.id,
-    label: action.label,
-    intent: intentForSurfaceAction(action),
-    message: action.template ? `${action.template} \xB7 ${action.detail}` : action.detail
-  };
-}
-var SHORTCUTS = [
-  ["tab / \u2192", "next workspace"],
-  ["\u2190", "previous workspace"],
-  ["esc", "back one screen \xB7 clears search filter first"],
-  ["\u2191 \u2193 / j k", "move selection"],
-  ["enter / space / click", "activate selected action"],
-  ["/", "search the current list (runs \xB7 tasks)"],
-  [":", "command palette \u2014 type any rig command"],
-  ["mouse wheel", "scroll panel under cursor"],
-  ["ctrl-]", "detach from embedded Pi/command terminal"],
-  ["q", "back \xB7 exits from the home cockpit"],
-  ["ctrl-c", "exit"]
-];
-function panelWidth(layout) {
-  return layout?.centerWidth ?? 100;
-}
-function panelHeight(layout, top = 1) {
-  return Math.max(8, (layout?.centerHeight ?? 24) - top);
-}
-function unsupportedCommand(state) {
-  const value = state.intent.action.payload?.unsupported ?? state.intent.action.payload?.unknown;
-  if (typeof value !== "string" || !value.trim())
-    return null;
-  const reason = state.intent.action.payload?.reason;
-  return { command: value.trim(), ...typeof reason === "string" && reason.trim() ? { reason: reason.trim() } : {} };
-}
-function renderHelpScene(state, layout) {
-  const unsupported = unsupportedCommand(state);
-  const actions = tuiSurfaceActions();
-  const selected = Math.max(0, Math.min(actions.length - 1, state.selection.index));
-  const actionLines = [];
-  let previousFamily = "";
-  actions.forEach((action, index) => {
-    if (action.family !== previousFamily) {
-      if (actionLines.length > 0)
-        actionLines.push(line("", { fg: RIG_UI.ink4 }));
-      actionLines.push(line(action.family.toUpperCase(), { fg: RIG_UI.ink3, bold: true }));
-      previousFamily = action.family;
-    }
-    const label = action.id.startsWith("family:") ? action.label : `  ${action.label}`;
-    const detail = action.template ? `${action.detail} \xB7 ${action.template}` : action.detail;
-    actionLines.push(selectableDeckRow({ label, detail, index, active: selected === index }, surfaceActionItem(action)));
-  });
-  const panelLines = [
-    ...unsupported ? [
-      line(`${unsupported.command} needs the action catalog.`, { fg: RIG_UI.yellow, bold: true }),
-      line(unsupported.reason ?? "Pick an action below; command workspaces run inside this TUI unless RIG_PLAIN=1/--json/CI is explicit.", { fg: RIG_UI.ink3 }),
-      line("", { fg: RIG_UI.ink3 })
-    ] : [],
-    line("SURFACES / ACTIONS", { fg: RIG_UI.ink3, bold: true }),
-    ...actionLines,
-    line("", { fg: RIG_UI.ink3 }),
-    line("KEYS / MOUSE", { fg: RIG_UI.ink3, bold: true }),
-    ...SHORTCUTS.map(([label, detail]) => line(`${label.padEnd(22)} ${detail}`, { fg: RIG_UI.ink2 }))
-  ];
-  return makeSceneFrame({
-    scene: "help",
-    title: "Command catalog",
-    lines: [
-      line("", { fg: RIG_UI.ink4 }),
-      line("   command catalog \xB7 TUI-first Rig", { fg: RIG_UI.ink3, bold: true })
-    ],
-    panels: [{
-      id: "help-reference",
-      top: 0,
-      width: panelWidth(layout),
-      height: panelHeight(layout),
-      lines: panelLines,
-      backgroundColor: RIG_UI.panel,
-      backgroundAlpha: 184,
-      opacity: 1,
-      border: false,
-      chrome: "ad-terminal",
-      headerText: "actions",
-      headerHeight: 3,
-      paddingX: layout?.compact ? 2 : 3,
-      paddingY: 1
-    }],
-    footer: { message: "enter/click opens a workspace" },
-    live: true
-  });
-}
-export {
-  renderHelpScene
-};