@h-rig/cli 0.0.6-alpha.82 → 0.0.6-alpha.83

package/dist/src/app-opentui/command-pty-host.d.ts

@@ -0,0 +1,62 @@
+export type CommandPtyHostStatus = "starting" | "running" | "exited" | "failed";
+export type CommandPtyHostSnapshot = {
+    readonly command: readonly string[];
+    readonly label: string;
+    readonly status: CommandPtyHostStatus;
+    readonly cols: number;
+    readonly rows: number;
+    readonly lines: readonly string[];
+    readonly message?: string;
+    readonly exitCode?: number;
+    readonly signal?: string | null;
+};
+type CommandPtyInput = string | Uint8Array<ArrayBufferLike> | BufferSource;
+export type CommandPtyHostOptions = {
+    readonly argv: readonly string[];
+    readonly projectRoot: string;
+    readonly cols: number;
+    readonly rows: number;
+    readonly label?: string;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly onSnapshot?: (snapshot: CommandPtyHostSnapshot) => void;
+    readonly onExit?: (snapshot: CommandPtyHostSnapshot) => void;
+    readonly onError?: (error: unknown, snapshot: CommandPtyHostSnapshot) => void;
+};
+export declare function getActiveCommandHost(): CommandPtyHost | null;
+export declare function stopActiveCommandHost(reason?: string): void;
+export declare function startCommandPtyHost(options: CommandPtyHostOptions): Promise<CommandPtyHost>;
+export declare class CommandPtyHost {
+    private readonly argv;
+    private readonly projectRoot;
+    private readonly label;
+    private readonly env?;
+    private readonly onSnapshot?;
+    private readonly onExit?;
+    private readonly onError?;
+    private readonly terminal;
+    private readonly decoder;
+    private proc;
+    private pty;
+    private status;
+    private cols;
+    private rows;
+    private message;
+    private exitCode;
+    private signal;
+    private notifyTimer;
+    private _disposed;
+    constructor(options: CommandPtyHostOptions);
+    get disposed(): boolean;
+    get snapshot(): CommandPtyHostSnapshot;
+    start(): Promise<void>;
+    write(data: CommandPtyInput): void;
+    resize(cols: number, rows: number): void;
+    dispose(reason?: string, options?: {
+        readonly kill?: boolean;
+        readonly notify?: boolean;
+    }): void;
+    private handlePtyData;
+    private emitSnapshotSoon;
+    private createSnapshot;
+}
+export {};

package/dist/src/app-opentui/command-pty-host.js

@@ -0,0 +1,248 @@
+// @bun
+// packages/cli/src/app-opentui/command-pty-host.ts
+import { basename } from "path";
+import { fileURLToPath } from "url";
+import { Terminal as XtermTerminal } from "@xterm/headless";
+var MIN_COLS = 40;
+var MIN_ROWS = 10;
+var MAX_ROWS = 300;
+var MAX_SNAPSHOT_LINES = 420;
+var SNAPSHOT_DELAY_MS = 80;
+var fallbackCliScriptPath = fileURLToPath(new URL("../../bin/rig.ts", import.meta.url));
+var activeHost = null;
+function clampCols(cols) {
+  return Math.max(MIN_COLS, Math.trunc(cols || 120));
+}
+function clampRows(rows) {
+  return Math.max(MIN_ROWS, Math.min(MAX_ROWS, Math.trunc(rows || 36)));
+}
+function childCommandPrefix() {
+  const execName = basename(process.execPath).toLowerCase();
+  const currentEntry = process.argv[1];
+  if (execName === "bun" || execName === "bun.exe") {
+    return currentEntry ? [process.execPath, currentEntry] : [process.execPath, fallbackCliScriptPath];
+  }
+  return [process.execPath];
+}
+function withEnv(base) {
+  const env = {};
+  for (const [key, value] of Object.entries(base ?? process.env)) {
+    if (key === "NO_COLOR")
+      continue;
+    if (typeof value === "string")
+      env[key] = value;
+  }
+  return {
+    ...env,
+    TERM: "xterm-256color",
+    COLORTERM: "truecolor",
+    FORCE_COLOR: env.FORCE_COLOR ?? "1",
+    RIG_PLAIN: "1",
+    RIG_OPENTUI_COMMAND_HOST: "1",
+    RIG_CLI_PLAIN_HELP: env.RIG_CLI_PLAIN_HELP ?? "1"
+  };
+}
+function commandLabel(argv, fallback) {
+  const command = argv.join(" ").trim();
+  return fallback?.trim() || (command ? `rig ${command}` : "rig");
+}
+function getActiveCommandHost() {
+  return activeHost && !activeHost.disposed ? activeHost : null;
+}
+function stopActiveCommandHost(reason = "detach") {
+  activeHost?.dispose(reason);
+  activeHost = null;
+}
+async function startCommandPtyHost(options) {
+  activeHost?.dispose("replace");
+  const host = new CommandPtyHost(options);
+  activeHost = host;
+  await host.start();
+  return host;
+}
+
+class CommandPtyHost {
+  argv;
+  projectRoot;
+  label;
+  env;
+  onSnapshot;
+  onExit;
+  onError;
+  terminal;
+  decoder = new TextDecoder("utf-8");
+  proc = null;
+  pty = null;
+  status = "starting";
+  cols;
+  rows;
+  message = "starting command";
+  exitCode;
+  signal;
+  notifyTimer = null;
+  _disposed = false;
+  constructor(options) {
+    this.argv = [...options.argv];
+    this.projectRoot = options.projectRoot;
+    this.label = commandLabel(options.argv, options.label);
+    this.env = options.env;
+    this.cols = clampCols(options.cols);
+    this.rows = clampRows(options.rows);
+    this.onSnapshot = options.onSnapshot;
+    this.onExit = options.onExit;
+    this.onError = options.onError;
+    this.terminal = new XtermTerminal({ allowProposedApi: true, cols: this.cols, rows: this.rows, scrollback: 2000 });
+  }
+  get disposed() {
+    return this._disposed;
+  }
+  get snapshot() {
+    return this.createSnapshot();
+  }
+  async start() {
+    if (this._disposed)
+      throw new Error("Command PTY host is disposed.");
+    if (typeof Bun.Terminal !== "function") {
+      throw new Error("Bun native PTY is unavailable in this runtime. Command host requires Bun.Terminal.");
+    }
+    const spawnOptions = {
+      cwd: this.projectRoot,
+      env: withEnv(this.env),
+      terminal: {
+        cols: this.cols,
+        rows: this.rows,
+        name: "xterm-256color",
+        data: (_terminal, data) => this.handlePtyData(data)
+      }
+    };
+    const proc = Bun.spawn([...childCommandPrefix(), ...this.argv], spawnOptions);
+    if (!proc.terminal)
+      throw new Error("Bun did not attach a terminal to the command child process.");
+    this.proc = proc;
+    this.pty = proc.terminal;
+    this.status = "running";
+    this.message = "running";
+    this.emitSnapshotSoon(0);
+    proc.exited.then((exitCode) => {
+      if (this._disposed)
+        return;
+      this.status = exitCode === 0 ? "exited" : "failed";
+      this.exitCode = exitCode;
+      this.signal = null;
+      this.message = exitCode === 0 ? "completed" : `exited with code ${exitCode}`;
+      const snapshot = this.createSnapshot();
+      this.onSnapshot?.(snapshot);
+      this.onExit?.(snapshot);
+      if (activeHost === this)
+        activeHost = null;
+      this.dispose("exit", { kill: false, notify: false });
+    }).catch((error) => {
+      if (this._disposed)
+        return;
+      this.status = "failed";
+      this.message = error instanceof Error ? error.message : String(error);
+      const snapshot = this.createSnapshot();
+      this.onSnapshot?.(snapshot);
+      this.onError?.(error, snapshot);
+      if (activeHost === this)
+        activeHost = null;
+      this.dispose("error", { kill: false, notify: false });
+    });
+  }
+  write(data) {
+    if (this._disposed || !this.pty)
+      return;
+    try {
+      this.pty.write(data);
+    } catch (error) {
+      this.status = "failed";
+      this.message = error instanceof Error ? error.message : String(error);
+      const snapshot = this.createSnapshot();
+      this.onSnapshot?.(snapshot);
+      this.onError?.(error, snapshot);
+    }
+  }
+  resize(cols, rows) {
+    const nextCols = clampCols(cols);
+    const nextRows = clampRows(rows);
+    if (nextCols === this.cols && nextRows === this.rows)
+      return;
+    this.cols = nextCols;
+    this.rows = nextRows;
+    this.terminal.resize(nextCols, nextRows);
+    try {
+      this.pty?.resize(nextCols, nextRows);
+    } catch {}
+    this.emitSnapshotSoon(0);
+  }
+  dispose(reason = "dispose", options = {}) {
+    if (this._disposed)
+      return;
+    this._disposed = true;
+    if (this.notifyTimer)
+      clearTimeout(this.notifyTimer);
+    this.notifyTimer = null;
+    if (options.kill !== false) {
+      try {
+        this.proc?.kill("SIGTERM");
+      } catch {}
+    }
+    try {
+      this.pty?.close();
+    } catch {}
+    try {
+      this.terminal.dispose();
+    } catch {}
+    if (activeHost === this)
+      activeHost = null;
+    if (options.notify) {
+      this.message = reason;
+      this.onSnapshot?.(this.createSnapshot(reason));
+    }
+  }
+  handlePtyData(data) {
+    if (this._disposed)
+      return;
+    this.decoder.decode(data, { stream: true });
+    this.terminal.write(data, () => this.emitSnapshotSoon());
+  }
+  emitSnapshotSoon(delayMs = SNAPSHOT_DELAY_MS) {
+    if (this._disposed || this.notifyTimer)
+      return;
+    this.notifyTimer = setTimeout(() => {
+      this.notifyTimer = null;
+      if (this._disposed)
+        return;
+      this.onSnapshot?.(this.createSnapshot());
+    }, delayMs);
+  }
+  createSnapshot(message = this.message) {
+    const buffer = this.terminal.buffer.active;
+    const end = buffer.length;
+    const start = Math.max(0, end - MAX_SNAPSHOT_LINES);
+    const lines = [];
+    for (let row = start;row < end; row += 1) {
+      const line = buffer.getLine(row);
+      lines.push((line?.translateToString(false) ?? "").slice(0, this.cols));
+    }
+    while (lines.length < this.rows)
+      lines.push("");
+    return {
+      command: this.argv,
+      label: this.label,
+      status: this.status,
+      cols: this.cols,
+      rows: this.rows,
+      lines,
+      message,
+      ...this.exitCode !== undefined ? { exitCode: this.exitCode } : {},
+      ...this.signal !== undefined ? { signal: this.signal } : {}
+    };
+  }
+}
+export {
+  stopActiveCommandHost,
+  startCommandPtyHost,
+  getActiveCommandHost,
+  CommandPtyHost
+};

package/dist/src/app-opentui/events.js

@@ -17,7 +17,7 @@ function normalizeError(error) {
   const message = error instanceof Error ? error.message : String(error);
   const rawHint = error instanceof Error ? error.hint : undefined;
   return {
-    message: message || "Unknown Rig app error",
+    message: message || "Unknown app error",
     ...typeof rawHint === "string" && rawHint.trim() ? { hint: rawHint.trim() } : {},
     cause: error
   };

package/dist/src/app-opentui/focus-manager.d.ts

@@ -0,0 +1,14 @@
+import type { TypeBarRenderables } from "./render/type-bar";
+export type AppModalState = {
+    readonly active: boolean;
+    readonly owner?: string;
+};
+export declare class AppFocusManager {
+    private modalStack;
+    pushModal(owner: string): void;
+    popModal(owner: string): void;
+    get modal(): AppModalState;
+    restoreTypeBarFocus(typeBar: TypeBarRenderables | null, options?: {
+        readonly hidden?: boolean;
+    }): void;
+}

package/dist/src/app-opentui/focus-manager.js

@@ -0,0 +1,24 @@
+// @bun
+// packages/cli/src/app-opentui/focus-manager.ts
+class AppFocusManager {
+  modalStack = [];
+  pushModal(owner) {
+    this.modalStack = [...this.modalStack.filter((entry) => entry !== owner), owner];
+  }
+  popModal(owner) {
+    this.modalStack = this.modalStack.filter((entry) => entry !== owner);
+  }
+  get modal() {
+    const owner = this.modalStack[this.modalStack.length - 1];
+    return owner ? { active: true, owner } : { active: false };
+  }
+  restoreTypeBarFocus(typeBar, options = {}) {
+    if (options.hidden || this.modal.active || !typeBar)
+      return;
+    if (!typeBar.input.focused)
+      typeBar.input.focus();
+  }
+}
+export {
+  AppFocusManager
+};