@h-rig/cli 0.0.6-alpha.100 → 0.0.6-alpha.101

package/dist/src/commands/_json-output.d.ts

@@ -1,11 +0,0 @@
-import { type RigCliOutputEnvelope } from "@rig/contracts";
-/**
- * Build the versioned `{ v: 1, command, data }` envelope for a command
- * outcome, or null when the command has no output schema (legacy payload)
- * or the details fail validation (warned on stderr, legacy payload).
- */
-export declare function buildCliJsonEnvelope(outcome: unknown, options?: {
-    warn?: (message: string) => void;
-}): RigCliOutputEnvelope | null;
-/** Commands with a versioned --json envelope (for help/docs/tests). */
-export declare function listSchematizedCliCommands(): string[];

package/dist/src/commands/_json-output.js

@@ -1,60 +0,0 @@
-// @bun
-// packages/cli/src/commands/_json-output.ts
-import { Schema } from "effect";
-import {
-  RigDoctorCheckOutput,
-  RigInboxApprovalsOutput,
-  RigInboxInputsOutput,
-  RigRunListOutput,
-  RigRunShowOutput,
-  RigServerRepairLinkOutput,
-  RigServerStatusOutput,
-  RigServerUseOutput,
-  RigStatsOutput,
-  RigTaskListOutput,
-  RigTaskShowOutput
-} from "@rig/contracts";
-var CLI_OUTPUT_SCHEMAS = {
-  "task list": RigTaskListOutput,
-  "task show": RigTaskShowOutput,
-  "run list": RigRunListOutput,
-  "run show": RigRunShowOutput,
-  "server use": RigServerUseOutput,
-  "server status": RigServerStatusOutput,
-  "server repair-link": RigServerRepairLinkOutput,
-  "inbox approvals": RigInboxApprovalsOutput,
-  "inbox inputs": RigInboxInputsOutput,
-  "doctor check": RigDoctorCheckOutput,
-  "stats show": RigStatsOutput
-};
-function isCommandOutcomeLike(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value))
-    return false;
-  const record = value;
-  return typeof record.group === "string" && typeof record.command === "string";
-}
-function buildCliJsonEnvelope(outcome, options = {}) {
-  if (!isCommandOutcomeLike(outcome))
-    return null;
-  const commandKey = `${outcome.group} ${outcome.command}`;
-  const schema = CLI_OUTPUT_SCHEMAS[commandKey];
-  if (!schema)
-    return null;
-  const warn = options.warn ?? ((message) => console.error(message));
-  const envelope = { v: 1, command: commandKey, data: outcome.details ?? {} };
-  try {
-    Schema.decodeUnknownSync(schema)(JSON.parse(JSON.stringify(envelope)));
-    return envelope;
-  } catch (error) {
-    warn(`[rig] --json output for "${commandKey}" failed schema validation; printing legacy payload. ` + `(${error instanceof Error ? error.message.split(`
-`)[0] : String(error)})`);
-    return null;
-  }
-}
-function listSchematizedCliCommands() {
-  return Object.keys(CLI_OUTPUT_SCHEMAS).sort();
-}
-export {
-  listSchematizedCliCommands,
-  buildCliJsonEnvelope
-};

package/dist/src/commands/_lazy-reconcile.d.ts

@@ -1,34 +0,0 @@
-import { SessionManager } from "@oh-my-pi/pi-coding-agent";
-import { type CollabRegistryFilter, type CollabSessionProjection } from "@oh-my-pi/pi-coding-agent/collab/api";
-import { type RunJournalProjection, type RunSessionCustomEntry } from "@rig/contracts";
-type SessionWriter = {
-    appendCustomEntry(customType: string, data: unknown): void;
-};
-export type CollabSessionProjectionLike = Pick<CollabSessionProjection, "collab" | "customEntries" | "source"> & {
-    readonly runId?: string;
-    readonly session: Pick<CollabSessionProjection["session"], "path" | "id">;
-};
-export type ProjectRunProjection = Pick<RunJournalProjection, "status">;
-export type ProjectRunFromSession = (source: Pick<SessionManager, "getEntries"> | ReadonlyArray<RunSessionCustomEntry> | readonly unknown[], runId: string) => ProjectRunProjection;
-export type LazyReconcileFlippedRun = {
-    readonly runId: string;
-    readonly sessionPath: string;
-    readonly reason: "lazy-reconcile:dead-pid";
-};
-export type LazyReconcileResult = {
-    readonly flipped: readonly LazyReconcileFlippedRun[];
-    readonly resumable: readonly LazyReconcileFlippedRun[];
-};
-type LazyReconcileDeps = {
-    readonly listCollabSessionProjections?: (filter: CollabRegistryFilter) => Promise<readonly CollabSessionProjectionLike[]>;
-    readonly projectRunFromSession?: ProjectRunFromSession;
-    readonly processExists?: (pid: number) => boolean;
-    readonly openSession?: (sessionPath: string) => Promise<SessionWriter>;
-    readonly nowIso?: () => string;
-};
-export type LazyReconcileInput = {
-    readonly workspaceRoot: string;
-    readonly identityFilter: CollabRegistryFilter;
-};
-export declare function runLazyReconcile(input: LazyReconcileInput, deps?: LazyReconcileDeps): Promise<LazyReconcileResult>;
-export {};

package/dist/src/commands/_lazy-reconcile.js

@@ -1,102 +0,0 @@
-// @bun
-var __require = import.meta.require;
-
-// packages/cli/src/commands/_lazy-reconcile.ts
-import { SessionManager } from "@oh-my-pi/pi-coding-agent";
-import {
-  listCollabSessionProjections as ompListCollabSessionProjections
-} from "@oh-my-pi/pi-coding-agent/collab/api";
-import {
-  CUSTOM_TYPE_FOR,
-  isTerminalRunStatus
-} from "@rig/contracts";
-var ACTIVE_LOCAL_RUN_STATUSES = new Set([
-  "created",
-  "preparing",
-  "running",
-  "validating",
-  "reviewing",
-  "closing-out"
-]);
-function processExists(pid) {
-  if (!Number.isInteger(pid) || pid <= 0)
-    return false;
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
-async function defaultProjectRunFromSession(source, runId) {
-  const mod = await import("@rig/runtime/control-plane/run-session-projection");
-  const candidate = Reflect.get(mod, "projectRunFromSession");
-  if (typeof candidate !== "function") {
-    throw new Error("@rig/runtime/control-plane/run-session-projection does not export projectRunFromSession yet; inject projectRunFromSession until RunState lands it.");
-  }
-  return candidate(source, runId);
-}
-async function defaultOpenSession(sessionPath) {
-  return await SessionManager.open(sessionPath, undefined, undefined, { suppressBreadcrumb: true });
-}
-function projectionRunId(item) {
-  if (item.runId?.trim())
-    return item.runId.trim();
-  if (item.collab?.sessionId?.trim())
-    return item.collab.sessionId.trim();
-  if (item.session.id?.trim())
-    return item.session.id.trim();
-  return null;
-}
-function isLocallyDiscovered(item) {
-  return item.source === "session-list";
-}
-function isActiveStatus(status) {
-  if (status === null)
-    return false;
-  return !isTerminalRunStatus(status);
-}
-function shouldFlip(item, status, exists) {
-  if (!isActiveStatus(status))
-    return false;
-  if (item.collab?.stale === true)
-    return true;
-  const pid = item.collab?.pid;
-  return isLocallyDiscovered(item) && pid !== undefined && ACTIVE_LOCAL_RUN_STATUSES.has(status) && !exists(pid);
-}
-function failedStatusData(status, at) {
-  return {
-    type: "status-changed",
-    from: status,
-    to: "failed",
-    reason: "lazy-reconcile:dead-pid",
-    actor: { kind: "agent" },
-    at
-  };
-}
-async function runLazyReconcile(input, deps = {}) {
-  const listProjections = deps.listCollabSessionProjections ?? ompListCollabSessionProjections;
-  const projectRun = deps.projectRunFromSession ?? defaultProjectRunFromSession;
-  const exists = deps.processExists ?? processExists;
-  const openSession = deps.openSession ?? defaultOpenSession;
-  const nowIso = deps.nowIso ?? (() => new Date().toISOString());
-  const projections = await listProjections(input.identityFilter);
-  const flipped = [];
-  for (const item of projections) {
-    const runId = projectionRunId(item);
-    const sessionPath = item.session.path || item.collab?.sessionPath || "";
-    if (!runId || !sessionPath)
-      continue;
-    const projection = await projectRun(item.customEntries, runId);
-    const status = projection.status;
-    if (status === null || !shouldFlip(item, status, exists))
-      continue;
-    const session = await openSession(sessionPath);
-    session.appendCustomEntry(CUSTOM_TYPE_FOR["status-changed"], failedStatusData(status, nowIso()));
-    flipped.push({ runId, sessionPath, reason: "lazy-reconcile:dead-pid" });
-  }
-  return { flipped, resumable: flipped };
-}
-export {
-  runLazyReconcile
-};

package/dist/src/commands/_parsers.d.ts

@@ -1,15 +0,0 @@
-import type { TaskSourceConfig } from "@rig/contracts";
-import type { RigPluginWithRuntime } from "@rig/core";
-export declare function parsePositiveInt(value: string | undefined, option: string, fallback: number): number;
-export declare function parseOptionalPositiveInt(value: string | undefined, option: string): number | undefined;
-export declare function parseRequiredPositiveInt(value: string | undefined, option: string): number;
-export declare function parseAction(value: string | undefined): "validate" | "verify" | "pipeline";
-export declare function parseIsolationMode(value: string | undefined, allowOff: true): "off" | "worktree";
-export declare function parseIsolationMode(value: string | undefined, allowOff: false): "worktree";
-export declare function parseInstallScope(value: string | undefined): "user" | "system";
-export declare function resolveInstallDir(scope: "user" | "system", explicitPath: string | undefined): string;
-export type CliRigConfig = {
-    plugins?: readonly RigPluginWithRuntime[];
-    taskSource?: TaskSourceConfig;
-};
-export declare function loadRigConfigOrNull(projectRoot: string): Promise<CliRigConfig | null>;

package/dist/src/commands/_parsers.js

@@ -1,114 +0,0 @@
-// @bun
-var __require = import.meta.require;
-
-// packages/cli/src/commands/_parsers.ts
-import { homedir } from "os";
-import { resolve } from "path";
-
-// 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();
-    }
-  }
-}
-
-// packages/cli/src/commands/_parsers.ts
-function parsePositiveInt(value, option, fallback) {
-  if (!value) {
-    return fallback;
-  }
-  const parsed = Number.parseInt(value, 10);
-  if (!Number.isFinite(parsed) || parsed <= 0) {
-    throw new CliError(`Invalid ${option} value: ${value}`, 1, { hint: `Pass a positive integer, e.g. \`${option} 10\`.` });
-  }
-  return parsed;
-}
-function parseOptionalPositiveInt(value, option) {
-  if (!value) {
-    return;
-  }
-  const parsed = Number.parseInt(value, 10);
-  if (!Number.isFinite(parsed) || parsed <= 0) {
-    throw new CliError(`Invalid ${option} value: ${value}`, 1, { hint: `Pass a positive integer, e.g. \`${option} 10\`.` });
-  }
-  return parsed;
-}
-function parseRequiredPositiveInt(value, option) {
-  if (!value) {
-    throw new CliError(`Missing value for ${option}.`, 1, { hint: `Provide a value after ${option}, e.g. \`${option} 10\`.` });
-  }
-  const parsed = Number.parseInt(value, 10);
-  if (!Number.isFinite(parsed) || parsed <= 0) {
-    throw new CliError(`Invalid ${option} value: ${value}`, 1, { hint: `Pass a positive integer, e.g. \`${option} 10\`.` });
-  }
-  return parsed;
-}
-function parseAction(value) {
-  if (!value || value === "validate") {
-    return "validate";
-  }
-  if (value === "verify") {
-    return "verify";
-  }
-  if (value === "pipeline") {
-    return "pipeline";
-  }
-  throw new CliError(`Invalid --action value: ${value}. Use validate, verify, or pipeline.`);
-}
-function parseIsolationMode(value, allowOff) {
-  if (!value) {
-    return "worktree";
-  }
-  if (value === "worktree") {
-    return value;
-  }
-  if (allowOff && value === "off") {
-    return value;
-  }
-  throw new CliError(`Invalid isolation mode: ${value}. Use ${allowOff ? "off|" : ""}worktree.`);
-}
-function parseInstallScope(value) {
-  if (!value || value === "user") {
-    return "user";
-  }
-  if (value === "system") {
-    return "system";
-  }
-  throw new CliError(`Invalid --scope value: ${value}. Use user|system.`);
-}
-function resolveInstallDir(scope, explicitPath) {
-  if (explicitPath) {
-    return resolve(explicitPath);
-  }
-  if (scope === "system") {
-    return "/usr/local/bin";
-  }
-  return resolve(homedir(), ".local/bin");
-}
-async function loadRigConfigOrNull(projectRoot) {
-  try {
-    const { loadConfig } = await import("@rig/core/load-config");
-    return await loadConfig(projectRoot);
-  } catch {
-    return null;
-  }
-}
-export {
-  resolveInstallDir,
-  parseRequiredPositiveInt,
-  parsePositiveInt,
-  parseOptionalPositiveInt,
-  parseIsolationMode,
-  parseInstallScope,
-  parseAction,
-  loadRigConfigOrNull
-};

package/dist/src/commands/_paths.d.ts

@@ -1,11 +0,0 @@
-export declare function resolveControlPlaneMonorepoRoot(projectRoot: string): string;
-export declare function resolveControlPlaneTaskConfigPath(projectRoot: string): string;
-export declare function resolveControlPlaneHostStateRoot(projectRoot: string): string;
-export declare function resolveControlPlaneHostStateDir(projectRoot: string): string;
-export declare function resolveControlPlaneHostLogsDir(projectRoot: string): string;
-export declare function resolveControlPlaneHostBinDir(projectRoot: string): string;
-export declare function resolveControlPlaneHostDistDir(projectRoot: string): string;
-export declare function resolveControlPlaneMonorepoStateRoot(projectRoot: string): string;
-export declare function resolveControlPlaneMonorepoRuntimeDir(projectRoot: string): string;
-export declare function resolveControlPlaneArtifactsDir(projectRoot: string): string;
-export declare function resolveControlPlaneDefinitionRoot(projectRoot: string): string;

package/dist/src/commands/_paths.js

@@ -1,50 +0,0 @@
-// @bun
-// packages/cli/src/commands/_paths.ts
-import { resolve } from "path";
-import { resolveMonorepoRoot } from "@rig/runtime/layout";
-function resolveControlPlaneMonorepoRoot(projectRoot) {
-  return resolveMonorepoRoot(projectRoot);
-}
-function resolveControlPlaneTaskConfigPath(projectRoot) {
-  return resolve(resolveControlPlaneMonorepoRoot(projectRoot), ".rig", "task-config.json");
-}
-function resolveControlPlaneHostStateRoot(projectRoot) {
-  return resolve(projectRoot, ".rig");
-}
-function resolveControlPlaneHostStateDir(projectRoot) {
-  return resolve(resolveControlPlaneHostStateRoot(projectRoot), "state");
-}
-function resolveControlPlaneHostLogsDir(projectRoot) {
-  return resolve(resolveControlPlaneHostStateRoot(projectRoot), "logs");
-}
-function resolveControlPlaneHostBinDir(projectRoot) {
-  return resolve(resolveControlPlaneHostStateRoot(projectRoot), "bin");
-}
-function resolveControlPlaneHostDistDir(projectRoot) {
-  return resolve(resolveControlPlaneHostStateRoot(projectRoot), "dist");
-}
-function resolveControlPlaneMonorepoStateRoot(projectRoot) {
-  return resolve(resolveControlPlaneMonorepoRoot(projectRoot), ".rig");
-}
-function resolveControlPlaneMonorepoRuntimeDir(projectRoot) {
-  return resolve(resolveControlPlaneMonorepoStateRoot(projectRoot), "runtime");
-}
-function resolveControlPlaneArtifactsDir(projectRoot) {
-  return resolve(resolveControlPlaneMonorepoRoot(projectRoot), "artifacts");
-}
-function resolveControlPlaneDefinitionRoot(projectRoot) {
-  return resolve(projectRoot, "rig");
-}
-export {
-  resolveControlPlaneTaskConfigPath,
-  resolveControlPlaneMonorepoStateRoot,
-  resolveControlPlaneMonorepoRuntimeDir,
-  resolveControlPlaneMonorepoRoot,
-  resolveControlPlaneHostStateRoot,
-  resolveControlPlaneHostStateDir,
-  resolveControlPlaneHostLogsDir,
-  resolveControlPlaneHostDistDir,
-  resolveControlPlaneHostBinDir,
-  resolveControlPlaneDefinitionRoot,
-  resolveControlPlaneArtifactsDir
-};

package/dist/src/commands/_pi-frontend.d.ts

@@ -1,35 +0,0 @@
-import type { RunnerContext } from "../runner";
-type AttachResult = {
-    readonly run: Record<string, unknown>;
-    readonly logs: Record<string, unknown>[];
-    readonly timeline: Record<string, unknown>[];
-    readonly timelineCursor: string | null;
-    readonly steered: boolean;
-    readonly rendered: string;
-    readonly detached?: boolean;
-};
-export declare function resolveOperatorDroneCwd(runId: string, homeDir?: string): string;
-/**
- * Compose the operator-session environment used by the legacy interactive
- * attach shim. Exported for tests that pin the env contract.
- */
-export declare function buildOperatorPiEnv(input: {
-    readonly runId: string;
-    readonly serverUrl: string;
-    readonly authToken?: string | null;
-    readonly serverProjectRoot?: string | null;
-    readonly sessionDir: string;
-}): Record<string, string>;
-export declare function shouldRequireOperatorTranscript(status: unknown): boolean;
-export declare function missingOperatorTranscriptMessage(runId: string, status: unknown): string;
-/**
- * Run `body` in-process while RETURNING (instead of terminating) when it calls
- * `process.exit`. Exported for unit tests that pin the guard semantics.
- */
-export declare function runWithProcessExitGuard(body: () => Promise<unknown>): Promise<number>;
-export declare function attachRunBundledPiFrontend(context: Pick<RunnerContext, "projectRoot" | "outputMode">, input: {
-    readonly runId: string;
-    readonly steered?: boolean;
-    readonly returnOnQuit?: boolean;
-}): Promise<AttachResult>;
-export {};

package/dist/src/commands/_pi-frontend.js

@@ -1,64 +0,0 @@
-// @bun
-// packages/cli/src/commands/_pi-frontend.ts
-import { homedir } from "os";
-import { join } from "path";
-import { assertPathInsideRoot, assertSafeRunId, safePathSegment } from "@rig/shared/safe-identifiers";
-var TERMINAL_RUN_STATUSES = { completed: true, failed: true, stopped: true, cancelled: true, canceled: true, closed: true, merged: true, needs_attention: true, "needs-attention": true };
-function resolveOperatorDroneCwd(runId, homeDir = homedir()) {
-  const safeRunId = assertSafeRunId(runId);
-  const dronesRoot = join(homeDir, ".rig", "drones");
-  return assertPathInsideRoot(dronesRoot, join(dronesRoot, safePathSegment(String(safeRunId).slice(0, 8), { fallback: "run", maxLength: 32 })), "operator drone cwd");
-}
-function buildOperatorPiEnv(input) {
-  return {
-    PI_CODING_AGENT_SESSION_DIR: input.sessionDir,
-    PI_SKIP_VERSION_CHECK: "1",
-    PI_HIDDEN_COMMANDS: "import,fork,clone,tree,new,resume,trust",
-    RIG_PI_OPERATOR_SESSION: "1",
-    RIG_RUN_ID: input.runId,
-    RIG_SERVER_URL: input.serverUrl,
-    ...input.authToken ? { RIG_AUTH_TOKEN: input.authToken } : {},
-    ...input.serverProjectRoot ? { RIG_PROJECT_ROOT: input.serverProjectRoot } : {}
-  };
-}
-function shouldRequireOperatorTranscript(status) {
-  return typeof status === "string" && TERMINAL_RUN_STATUSES[status.trim().toLowerCase()] === true;
-}
-function missingOperatorTranscriptMessage(runId, status) {
-  const shortRun = runId.trim().slice(0, 8) || "unknown";
-  const statusText = typeof status === "string" && status.trim() ? status.trim() : "terminal";
-  return `Run ${shortRun} is ${statusText}, but no worker Pi session transcript is recorded for this run. It likely failed before Pi started or predates full-session capture. Use \`rig run show ${runId}\` and \`rig run logs ${runId}\` for the lifecycle details.`;
-}
-async function runWithProcessExitGuard(body) {
-  const realExit = process.exit;
-  let exitCode = 0;
-  let signalQuit = () => {};
-  const quit = new Promise((resolve) => {
-    signalQuit = resolve;
-  });
-  const guardedExit = (code) => {
-    exitCode = typeof code === "number" ? code : 0;
-    signalQuit();
-    return;
-  };
-  process.exit = guardedExit;
-  try {
-    await Promise.race([Promise.resolve().then(body), quit]);
-  } finally {
-    process.exit = realExit;
-  }
-  return exitCode;
-}
-async function attachRunBundledPiFrontend(context, input) {
-  input.steered;
-  input.returnOnQuit;
-  throw new Error(`Interactive Pi attach for run ${input.runId} was removed in the OMP-collab cutover. Run bare \`rig\` and use the OMP cockpit run detail for the live session; legacy automation can request a non-interactive text snapshot with --once or --json.`);
-}
-export {
-  shouldRequireOperatorTranscript,
-  runWithProcessExitGuard,
-  resolveOperatorDroneCwd,
-  missingOperatorTranscriptMessage,
-  buildOperatorPiEnv,
-  attachRunBundledPiFrontend
-};

package/dist/src/commands/_pi-install.d.ts

@@ -1,42 +0,0 @@
-export type PiInstallCheck = {
-    readonly ok: boolean;
-    readonly label: string;
-    readonly detail?: string;
-    readonly hint?: string;
-};
-export type CommandRunner = (command: string[], options?: {
-    cwd?: string;
-}) => Promise<{
-    exitCode: number;
-    stdout: string;
-    stderr: string;
-}>;
-export type PiRigInstallStatus = {
-    readonly pi: PiInstallCheck;
-    readonly piRig: PiInstallCheck;
-    readonly extensionPath: string;
-};
-export declare function resolvePiRigExtensionPath(homeDir: string): string;
-export declare function resolvePiRigPackageSource(projectRoot: string, exists?: (path: string) => boolean): string;
-export declare function checkPiRigInstall(input?: {
-    readonly homeDir?: string;
-    readonly commandRunner?: CommandRunner;
-    readonly exists?: (path: string) => boolean;
-}): Promise<PiRigInstallStatus>;
-export declare function ensurePiRigInstalled(input: {
-    readonly projectRoot: string;
-    readonly homeDir?: string;
-    readonly commandRunner?: CommandRunner;
-}): Promise<PiRigInstallStatus & {
-    installedPath: string;
-}>;
-export declare function ensureRemotePiRigInstalled(input: {
-    readonly requestJson: (pathname: string, init?: RequestInit) => Promise<unknown>;
-}): Promise<PiRigInstallStatus & {
-    readonly remote: true;
-}>;
-export declare function buildPiSetupChecks(input?: {
-    readonly homeDir?: string;
-    readonly commandRunner?: CommandRunner;
-    readonly exists?: (path: string) => boolean;
-}): Promise<PiInstallCheck[]>;