@h-rig/cli 0.0.6-alpha.27 → 0.0.6-alpha.280

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

@@ -1,203 +0,0 @@
-// @bun
-// packages/cli/src/commands/_help-catalog.ts
-import pc from "picocolors";
-var PRIMARY_GROUPS = [
-  {
-    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 --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 --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: "server",
-    summary: "Choose, inspect, and start the Rig server that owns tasks and runs.",
-    usage: ["rig server <status|list|add|use|start> [options]"],
-    commands: [
-      { command: "status", description: "Show the selected server for this repo.", primary: true },
-      { command: "list", description: "List saved local/remote server aliases.", primary: true },
-      { command: "add <alias> <url>", description: "Save a remote Rig server URL.", primary: true },
-      { command: "use [alias|local]", description: "Select a server; prompts in an interactive TTY.", primary: true },
-      { command: "start [--host <host>] [--port <n>]", description: "Start a local rig-server process.", primary: true }
-    ],
-    examples: [
-      "rig server status",
-      "rig server add prod https://where.rig-does.work",
-      "rig server use prod",
-      "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."],
-    advanced: ["Compatibility alias: `rig connect ...` remains callable."]
-  },
-  {
-    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>] [--state open|closed]", description: "List tasks from the selected server/source.", primary: true },
-      { command: "next [filters]", description: "Pick the next matching task.", primary: true },
-      { command: "show <id>|--task <id>", description: "Show task details.", primary: true },
-      { command: "run [#<issue>|<task-id>|--next|--task <id>]", description: "Submit a task run; interactive follows with bundled Pi.", primary: true },
-      { command: "validate|verify [--task <id>]", description: "Run configured task checks/review gates." },
-      { 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 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.",
-    usage: ["rig run <list|status|show|attach|stop> [options]"],
-    commands: [
-      { command: "list", description: "List recent runs from the selected server or local state.", primary: true },
-      { command: "status", description: "Summarize active and recent runs.", primary: true },
-      { command: "show --run <id>", description: "Show one run record.", primary: true },
-      { command: "attach <run-id>|--run <id> [--follow]", description: "Attach to the run; `--follow` launches native bundled Pi for live Pi runs.", primary: true },
-      { command: "stop [<run-id>|--run <id>]", description: "Request stop for one run or local active runs.", primary: true },
-      { command: "timeline --run <id> [--follow]", description: "Stream raw run timeline events." },
-      { command: "delete|cleanup", description: "Remove completed run records/artifacts." }
-    ],
-    examples: [
-      "rig run list",
-      "rig run attach 01234567-89ab-cdef-0123-456789abcdef --follow",
-      "rig run show --run <run-id>",
-      "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."]
-  }
-];
-var ADVANCED_GROUPS = [
-  { name: "connect", summary: "Compatibility alias for `rig server` selection commands.", usage: ["rig connect <status|list|add|use>"], commands: [{ command: "status|list|add|use", description: "Use `rig server ...` for the primary UX." }] },
-  { name: "github", summary: "GitHub auth helpers.", usage: ["rig github auth <status|import-gh|token>"], commands: [{ command: "auth status", description: "Show GitHub auth state." }] },
-  { name: "doctor", summary: "Diagnostics for project/server/GitHub/Pi state.", usage: ["rig doctor [check|run|shared|...]"], commands: [{ command: "check", description: "Run diagnostics." }] },
-  { name: "setup", summary: "Bootstrap/check local setup.", usage: ["rig setup <bootstrap|check|preflight>"], commands: [{ command: "bootstrap|check|preflight", description: "Setup helpers." }] },
-  { name: "inspect", summary: "Inspect logs, artifacts, graphs, failures.", usage: ["rig inspect <logs|artifacts|failures|graph|audit|diff>"], commands: [{ command: "logs --task <id>", description: "Inspect task logs." }] },
-  { name: "repo", summary: "Repository sync/baseline helpers.", usage: ["rig repo <sync|reset-baseline>"], commands: [{ command: "sync", description: "Sync project repository state." }] },
-  { name: "profile", summary: "Runtime profile/model defaults.", usage: ["rig profile <show|set>"], commands: [{ command: "show", description: "Show active profile." }] },
-  { name: "review", summary: "Review policy configuration.", usage: ["rig review <show|set>"], commands: [{ command: "show", description: "Show review settings." }] },
-  { name: "browser", summary: "Browser/app diagnostics.", usage: ["rig browser <help|explain|demo|app>"], commands: [{ command: "help", description: "Browser command help." }] },
-  { name: "plugin", summary: "Plugin validation/listing.", usage: ["rig plugin <list|validate>"], commands: [{ command: "list", description: "List plugins." }] },
-  { name: "queue", summary: "Run task queues locally.", usage: ["rig queue run [options]"], commands: [{ command: "run", description: "Process queue work." }] },
-  { name: "agent", summary: "Runtime agent workspace helpers.", usage: ["rig agent <list|prepare|run|cleanup>"], commands: [{ command: "list", description: "List prepared agents." }] },
-  { 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>"], commands: [{ command: "build", description: "Build distribution." }] },
-  { name: "workspace", summary: "Workspace topology/service helpers.", usage: ["rig workspace <summary|topology|remote-hosts>"], commands: [{ command: "summary", description: "Show workspace summary." }] },
-  { name: "remote", summary: "Legacy remote orchestration controls.", usage: ["rig remote <status|watch|pause|resume|...>"], commands: [{ command: "status", description: "Show remote state." }] },
-  { name: "inbox", summary: "Approval/input inbox for blocked runs.", usage: ["rig inbox <approvals|approve|inputs|respond>"], commands: [{ command: "approvals", description: "List pending approvals." }] },
-  { 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 pc.bold(pc.cyan(title));
-}
-function commandLine(command, description) {
-  const commandColumn = command.length >= 34 ? `${command}  ` : command.padEnd(34);
-  return `${pc.dim("\u2502")} ${pc.bold(commandColumn)} ${description}`;
-}
-function renderGroup(group) {
-  const lines = [
-    `${heading(`rig ${group.name}`)} \u2014 ${group.summary}`,
-    "",
-    pc.bold("Usage"),
-    ...group.usage.map((line) => `  ${line}`),
-    "",
-    pc.bold("Commands"),
-    ...group.commands.map((entry) => commandLine(entry.command, entry.description))
-  ];
-  if (group.examples?.length) {
-    lines.push("", pc.bold("Examples"), ...group.examples.map((line) => `  ${pc.dim("$")} ${line}`));
-  }
-  if (group.next?.length) {
-    lines.push("", pc.bold("Next steps"), ...group.next.map((line) => `  ${pc.dim("\u203A")} ${line}`));
-  }
-  if (group.advanced?.length) {
-    lines.push("", pc.bold("Compatibility / advanced"), ...group.advanced.map((line) => `  ${pc.dim("\u203A")} ${line}`));
-  }
-  return lines.join(`
-`);
-}
-function renderTopLevelHelp() {
-  return [
-    `${heading("rig")} ${pc.dim("\u2014 server-owned task/run control plane for Pi-backed engineering work")}`,
-    pc.dim("A repo-local CLI for setup, server selection, task runs, live attach, and completion review."),
-    "",
-    `${pc.bold(pc.magenta("\u25C7 Start here"))} \u2014 ${pc.dim("bootstrap a repo and choose where Rig runs")}`,
-    commandLine("rig init", "Interactive setup: project config, GitHub auth, task source, server, checkout, Pi."),
-    commandLine("rig init --yes", "Non-interactive setup using detected defaults; good for repeatable installs."),
-    commandLine("rig server status", "Show whether this repo is using local Rig or a remote server."),
-    commandLine("rig server use <alias|local>", "Switch the server that owns task/run state for this repo."),
-    "",
-    `${pc.bold(pc.magenta("\u25C7 Daily task loop"))} \u2014 ${pc.dim("find work, start a worker, and rejoin it later")}`,
-    commandLine("rig task list", "List tasks from the selected task source/server with status, labels, and source."),
-    commandLine("rig task next", "Pick the next matching task without starting it."),
-    commandLine("rig task run --next", "Start the next task and attach to the live bundled Pi frontend."),
-    commandLine("rig task run #123 --detach", "Submit a specific issue/task and return immediately."),
-    "",
-    `${pc.bold(pc.magenta("\u25C7 Live run control"))} \u2014 ${pc.dim("observe, steer, stop, or inspect active runs")}`,
-    commandLine("rig run list", "Show recent/active runs from the selected server or local state."),
-    commandLine("rig run attach <run-id> --follow", "Open the native Pi live view for a worker-backed run."),
-    commandLine("rig run show --run <id>", "Print one run record; add `--json` for automation."),
-    commandLine("rig run stop <run-id>", "Request cancellation for a running worker."),
-    "",
-    `${pc.bold(pc.magenta("\u25C7 Core groups"))} \u2014 ${pc.dim("run `rig <group> --help` for detailed commands and examples")}`,
-    ...PRIMARY_GROUPS.map((group) => commandLine(group.name, group.summary)),
-    commandLine("doctor", "Diagnose project/server/GitHub/task/Pi wiring when setup or runs misbehave."),
-    "",
-    `${pc.bold(pc.magenta("\u25C7 More"))}`,
-    commandLine("rig help --advanced", "Legacy, dev, diagnostics, browser, queue, agent, remote, git, harness commands."),
-    commandLine("rig <group> --help", "Rich per-group help with usage, descriptions, examples, and next steps."),
-    commandLine("rig --version", "Print the installed Rig CLI version."),
-    "",
-    `${pc.bold(pc.magenta("\u25C7 Global options"))}`,
-    commandLine("--project <path>", "Use a project root instead of auto-discovery."),
-    commandLine("--json", "Emit structured output for scripts/agents."),
-    commandLine("--dry-run", "Print the command plan without mutating state.")
-  ].join(`
-`);
-}
-function renderAdvancedHelp() {
-  return [
-    `${heading("rig advanced")} \u2014 legacy, dev, and compatibility groups`,
-    "",
-    pc.bold("Primary groups are still"),
-    "  init, server, task, run",
-    "",
-    pc.bold("Advanced groups"),
-    ...ADVANCED_GROUPS.map((group) => commandLine(group.name, group.summary)),
-    "",
-    pc.dim("All groups remain callable. Prefer `rig server`, `rig task`, and `rig run` for day-to-day work.")
-  ].join(`
-`);
-}
-function renderGroupHelp(groupName) {
-  const group = ALL_GROUPS.find((candidate) => candidate.name === groupName);
-  return group ? renderGroup(group) : null;
-}
-function listHelpGroups() {
-  return ALL_GROUPS.map((group) => group.name);
-}
-export {
-  renderTopLevelHelp,
-  renderGroupHelp,
-  renderAdvancedHelp,
-  listHelpGroups
-};

package/dist/src/commands/_operator-surface.js

@@ -1,204 +0,0 @@
-// @bun
-// packages/cli/src/commands/_operator-surface.ts
-import { createInterface } from "readline";
-import { createInterface as createPromptInterface } from "readline/promises";
-var CANONICAL_STAGES = [
-  "Connect",
-  "GitHub/task sync",
-  "Prepare workspace",
-  "Launch Pi",
-  "Plan",
-  "Implement",
-  "Validate",
-  "Commit",
-  "Open PR",
-  "Review/CI",
-  "Merge",
-  "Complete"
-];
-function logDetail(log) {
-  return typeof log.detail === "string" ? log.detail.trim() : "";
-}
-function parseProviderProtocolLog(title, detail) {
-  if (title.trim().toLowerCase() !== "agent output")
-    return null;
-  if (!detail.startsWith("{") || !detail.endsWith("}"))
-    return null;
-  try {
-    const record = JSON.parse(detail);
-    if (!record || typeof record !== "object" || Array.isArray(record))
-      return null;
-    const type = record.type;
-    return typeof type === "string" && [
-      "assistant",
-      "message_start",
-      "message_update",
-      "message_end",
-      "stream_event",
-      "tool_result",
-      "tool_execution_start",
-      "tool_execution_update",
-      "tool_execution_end",
-      "turn_start",
-      "turn_end"
-    ].includes(type) ? record : null;
-  } catch {
-    return null;
-  }
-}
-function renderProviderProtocolLog(record) {
-  const type = typeof record.type === "string" ? record.type : "";
-  if (type === "tool_execution_start" || type === "tool_execution_update" || type === "tool_execution_end") {
-    const toolName = String(record.toolName ?? record.name ?? "tool");
-    const status = type === "tool_execution_start" ? "started" : type === "tool_execution_end" ? record.isError === true || record.result && typeof record.result === "object" && !Array.isArray(record.result) && record.result.isError === true ? "failed" : "completed" : "running";
-    return `[Pi tool] ${toolName} ${status}`;
-  }
-  return null;
-}
-function entryId(entry, fallback) {
-  return typeof entry.id === "string" && entry.id.trim() ? entry.id : fallback;
-}
-function renderOperatorSnapshot(snapshot) {
-  const run = snapshot.run.run && typeof snapshot.run.run === "object" ? snapshot.run.run : snapshot.run;
-  const runId = String(run.runId ?? run.id ?? "run");
-  const status = String(run.status ?? "unknown");
-  const logs = snapshot.logs ?? [];
-  const latestByStage = new Map;
-  for (const log of logs) {
-    const title = String(log.title ?? "").toLowerCase();
-    const stageName = String(log.stage ?? "").toLowerCase();
-    const stage = CANONICAL_STAGES.find((candidate) => candidate.toLowerCase() === title || candidate.toLowerCase() === stageName);
-    if (stage)
-      latestByStage.set(stage, log);
-  }
-  const stageLines = CANONICAL_STAGES.flatMap((stage) => {
-    const match = latestByStage.get(stage);
-    return match ? [`${stage}: ${String(match.status ?? status)}${logDetail(match) ? ` \u2014 ${logDetail(match)}` : ""}`] : [];
-  });
-  return [`Rig run ${runId}: ${status}`, ...stageLines].join(`
-`);
-}
-function createPiRunStreamRenderer(output = process.stdout) {
-  let lastSnapshot = "";
-  const assistantTextById = new Map;
-  const seenTimeline = new Set;
-  const seenLogs = new Set;
-  const writeLine = (line) => output.write(`${line}
-`);
-  return {
-    renderSnapshot(snapshot) {
-      const rendered = renderOperatorSnapshot(snapshot);
-      if (rendered && rendered !== lastSnapshot) {
-        writeLine(rendered);
-        lastSnapshot = rendered;
-      }
-    },
-    renderTimeline(entries) {
-      for (const [index, entry] of entries.entries()) {
-        const id = entryId(entry, `timeline:${index}:${String(entry.cursor ?? "")}`);
-        if (entry.type === "assistant_message" && typeof entry.text === "string") {
-          const text = entry.text;
-          const previousText = assistantTextById.get(id) ?? "";
-          if (!previousText && text.trim()) {
-            writeLine("[Pi assistant]");
-          }
-          if (text.startsWith(previousText)) {
-            const delta = text.slice(previousText.length);
-            if (delta)
-              output.write(delta);
-          } else if (text.trim() && text !== previousText) {
-            if (previousText)
-              writeLine(`
-[Pi assistant]`);
-            output.write(text);
-          }
-          assistantTextById.set(id, text);
-          continue;
-        }
-        if (seenTimeline.has(id))
-          continue;
-        seenTimeline.add(id);
-        if (entry.type === "tool_execution_start" || entry.type === "tool_execution_update" || entry.type === "tool_execution_end" || entry.type === "mcp_tool_call") {
-          writeLine(`[Pi tool] ${String(entry.toolName ?? entry.name ?? entry.title ?? entry.type)} ${String(entry.status ?? entry.state ?? "")}`.trim());
-          continue;
-        }
-        if (entry.type === "timeline_warning") {
-          writeLine(`[Rig timeline] ${String(entry.detail ?? entry.message ?? "timeline unavailable")}`);
-        }
-      }
-    },
-    renderLogs(entries) {
-      for (const [index, entry] of entries.entries()) {
-        const id = entryId(entry, `log:${index}:${String(entry.createdAt ?? "")}:${String(entry.title ?? "")}`);
-        if (seenLogs.has(id))
-          continue;
-        seenLogs.add(id);
-        const title = String(entry.title ?? "");
-        if (CANONICAL_STAGES.some((stage) => stage.toLowerCase() === title.toLowerCase()))
-          continue;
-        const detail = logDetail(entry);
-        if (!detail)
-          continue;
-        const protocolRecord = parseProviderProtocolLog(title, detail);
-        if (protocolRecord) {
-          const protocolLine = renderProviderProtocolLog(protocolRecord);
-          if (protocolLine)
-            writeLine(protocolLine);
-          continue;
-        }
-        writeLine(`[${title || "Rig log"}] ${detail}`);
-      }
-    }
-  };
-}
-function createOperatorSurface(options = {}) {
-  const input = options.input ?? process.stdin;
-  const output = options.output ?? process.stdout;
-  const errorOutput = options.errorOutput ?? process.stderr;
-  const renderer = createPiRunStreamRenderer(output);
-  const writeLine = (line) => output.write(`${line}
-`);
-  return {
-    mode: "pi-compatible-text",
-    ...renderer,
-    info: writeLine,
-    error: (message) => errorOutput.write(`${message}
-`),
-    attachCommandInput(handler) {
-      if (options.interactive === false || !input.isTTY)
-        return null;
-      const rl = createInterface({ input, output: process.stdout, terminal: false });
-      rl.on("line", (line) => {
-        Promise.resolve(handler(line)).catch((error) => writeLine(`Operator command failed: ${error instanceof Error ? error.message : String(error)}`));
-      });
-      return { close: () => rl.close() };
-    }
-  };
-}
-function taskId(task) {
-  return typeof task.id === "string" && task.id.trim() ? task.id : "<unknown>";
-}
-function taskTitle(task) {
-  return typeof task.title === "string" && task.title.trim() ? task.title : "Untitled task";
-}
-function taskStatus(task) {
-  return typeof task.status === "string" && task.status.trim() ? task.status : "unknown";
-}
-function renderTaskPickerRows(tasks) {
-  return tasks.map((task, index) => `${index + 1}. ${taskId(task)} \xB7 ${taskStatus(task)} \xB7 ${taskTitle(task)}`);
-}
-async function promptForTaskSelection(question) {
-  const rl = createPromptInterface({ input: process.stdin, output: process.stdout });
-  try {
-    return await rl.question(question);
-  } finally {
-    rl.close();
-  }
-}
-export {
-  renderTaskPickerRows,
-  renderOperatorSnapshot,
-  promptForTaskSelection,
-  createPiRunStreamRenderer,
-  createOperatorSurface
-};