@h-rig/cli 0.0.6-alpha.74 → 0.0.6-alpha.76

package/dist/src/commands/_help-catalog.js

@@ -3,6 +3,18 @@
 import { intro, log, note, outro } from "@clack/prompts";
 import pc from "picocolors";
 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",
@@ -17,9 +29,9 @@ var TOP_LEVEL_SECTIONS = [
     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; interactive mode opens the native Pi session." },
+      { 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: "Join the live Pi session (worker keeps running if you /detach)." },
+      { 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`)." }
     ]
   },
@@ -98,29 +110,35 @@ var PRIMARY_GROUPS = [
   },
   {
     name: "run",
-    summary: "Observe, attach to, and control Rig runs.",
-    usage: ["rig run <list|status|show|attach|stop> [options]"],
+    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> [--follow]", description: "Attach to the run; --follow opens the enriched bundled Pi (worker brain).", 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: "steer <run-id> --message <text>", description: "Queue a steering message into a live worker without attaching." },
-      { command: "timeline --run <id> [--follow]", description: "Stream raw run timeline events." },
+      { 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: "resume", description: "Resume the most recent interrupted local run." },
-      { command: "restart", description: "Restart the most recent local run from a clean runtime." },
       { 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 status",
       "rig run show <run-id>",
-      "rig run attach <run-id> --follow",
       "rig run stop <run-id>"
     ],
-    next: ["Use `rig task run --next` to create a new run.", "Use `--json` when scripts need the full structured record."]
+    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",
@@ -343,7 +361,7 @@ function renderGroup(group) {
 function renderTopLevelHelp() {
   return [
     `${heading("rig")} ${pc.dim("\u2014 server-owned task/run control plane for Pi-backed engineering work")}`,
-    pc.dim("Current path: select a server, choose a task, submit a run, attach with native Pi, clear inbox gates."),
+    pc.dim("The loop: pick a task, dispatch an agent, open its Pi console (`rig run attach <id>`) to watch and steer it live, clear inbox gates, merge."),
     "",
     ...TOP_LEVEL_SECTIONS.flatMap((section) => [
       `${pc.bold(pc.magenta(`\u25C7 ${section.title}`))} \u2014 ${pc.dim(section.subtitle)}`,
@@ -430,7 +448,7 @@ function printTopLevelHelp(state = {}) {
     commandLine("--dry-run", "Print the command plan without mutating state.")
   ].join(`
 `), "Global options");
-  outro("init \u2192 task run \u2192 watch \u2192 inbox \u2192 merged.");
+  outro("init \u2192 task run \u2192 attach (Pi console: watch + steer live) \u2192 inbox \u2192 merged.");
 }
 function printAdvancedHelp() {
   if (!shouldUseClackOutput()) {