@h-rig/cli 0.0.6-alpha.77 → 0.0.6-alpha.79

package/dist/src/launcher.d.ts

@@ -0,0 +1,61 @@
+import type { RunnerContext } from "./runner";
+export type PolicyModeValue = "off" | "observe" | "enforce";
+export interface ResolveProjectRootOptions {
+    readonly envProjectRoot?: string;
+    readonly execPath?: string;
+    readonly importDir?: string;
+    readonly cwd?: string;
+}
+export interface CliIo {
+    readonly log: (message: string) => void;
+    readonly error: (message: string) => void;
+}
+export interface RigCliRunOptions {
+    readonly argv?: readonly string[];
+    readonly io?: CliIo;
+    readonly envProjectRoot?: string;
+    readonly execPath?: string;
+    readonly importDir?: string;
+    readonly cwd?: string;
+}
+export interface RigCliModule {
+    readonly CliError: new (message: string, exitCode?: number) => Error & {
+        exitCode: number;
+    };
+    execute: (context: RunnerContext, args: string[]) => Promise<unknown>;
+    initializeRuntime: (options: {
+        projectRoot: string;
+        dryRun: boolean;
+        outputMode: "json" | "text";
+        runId?: string | undefined;
+        policyMode?: PolicyModeValue | undefined;
+    }) => Promise<RunnerContext>;
+    loadPolicy(projectRoot: string): {
+        mode: PolicyModeValue;
+    };
+    takeFlag(args: string[], flag: string): {
+        value: boolean;
+        rest: string[];
+    };
+    takeOption(args: string[], option: string): {
+        value?: string;
+        rest: string[];
+    };
+    withProjectRoot(projectRoot: string): void;
+}
+export declare function parsePolicyMode(value: string | undefined): PolicyModeValue | undefined;
+export declare function resolveProjectRoot({ envProjectRoot, execPath, importDir, cwd, }: ResolveProjectRootOptions): string;
+export interface CliErrorPayload {
+    readonly ok: false;
+    readonly code: string;
+    readonly message: string;
+    readonly exitCode: number;
+    /** Remediation hint (next command to run); rendered as `Next: <hint>`. */
+    readonly hint?: string;
+    readonly stack?: string;
+}
+export declare function normalizeCliErrorPayload(error: unknown, CliErrorClass: RigCliModule["CliError"], options?: {
+    readonly debug?: boolean;
+}): CliErrorPayload;
+export declare function runRigCli(module: RigCliModule, options?: RigCliRunOptions): Promise<void>;
+export declare function hydrateProcessEnvFromDotEnv(projectRoot: string): void;

package/dist/src/report-bug.d.ts

@@ -0,0 +1,44 @@
+export type BrowserBugEnvironment = "local" | "shared-dev" | "staging" | "production" | "custom";
+export type BrowserBugReportInput = {
+    projectRoot: string;
+    outputRoot: string;
+    title: string;
+    url: string;
+    browserRequired?: boolean;
+    environment: BrowserBugEnvironment | string;
+    preset: string;
+    profile: string;
+    attachUrl: string;
+    stateDir: string;
+    mode: string;
+    viewport: string;
+    summary: string;
+    steps: string[];
+    expected: string;
+    actual: string;
+    evidence: string[];
+    screenshots?: string[];
+    assets?: string[];
+    issueId?: string;
+    slug?: string;
+    overwrite: boolean;
+};
+export type BrowserBugReportResult = {
+    slug: string;
+    reportDir: string;
+    taskPath: string;
+    browserPath: string | null;
+    manifestPath: string;
+    assetDir: string;
+    screenshotDir: string;
+    copiedAssets: string[];
+    copiedScreenshots: string[];
+};
+export declare function slugifyBugTitle(value: string): string;
+export declare function defaultBrowserBugProfile(title: string): string;
+export declare function defaultBrowserBugOptions(environment: string): {
+    preset: string;
+    attachUrl: string;
+    stateDir: string;
+};
+export declare function createBugReportFiles(input: BrowserBugReportInput): BrowserBugReportResult;

package/dist/src/runner.d.ts

@@ -0,0 +1,47 @@
+import { CliError as RuntimeCliError } from "@rig/runtime/control-plane/errors";
+import type { PolicyMode } from "@rig/runtime/control-plane/runtime/guard-types";
+import type { RunnerContext } from "@rig/runtime/control-plane/runtime/runner-context";
+import { buildBinary } from "@rig/runtime/control-plane/runtime/isolation";
+import type { CommandExecutionResult, OutputMode } from "@rig/runtime/control-plane/runtime/types";
+export type { RunnerContext } from "@rig/runtime/control-plane/runtime/runner-context";
+/**
+ * CLI-side error with an optional remediation hint. The hint is rendered on
+ * its own line as `Next: <hint>` (and carried in the --json error payload),
+ * so every failure names the next command to run. Extends the runtime
+ * CliError so `instanceof` checks against either class keep working.
+ */
+export declare class CliError extends RuntimeCliError {
+    readonly hint?: string;
+    constructor(message: string, exitCode?: number, options?: {
+        readonly hint?: string;
+    });
+}
+export declare function withProjectRoot(projectRoot: string): void;
+export declare function formatCommand(parts: string[]): string;
+type AgentShellBuild = typeof buildBinary;
+type AgentShellMaterializationOptions = {
+    readonly env?: Record<string, string | undefined>;
+    readonly cwd?: string;
+    readonly moduleDir?: string;
+    readonly build?: AgentShellBuild;
+};
+export declare function resolveAgentMaterializationSourceRoot(projectRoot: string, options?: AgentShellMaterializationOptions): string;
+export declare function ensureAgentShellBinary(projectRoot: string, options?: AgentShellMaterializationOptions): Promise<string>;
+export declare function initializeRuntime(options: {
+    projectRoot: string;
+    dryRun: boolean;
+    outputMode: OutputMode;
+    runId?: string;
+    policyMode?: PolicyMode;
+}): Promise<RunnerContext>;
+export declare function runCommand(context: RunnerContext, parts: string[]): Promise<CommandExecutionResult>;
+export declare function takeFlag(args: string[], flag: string): {
+    value: boolean;
+    rest: string[];
+};
+export declare function takeOption(args: string[], option: string): {
+    value: string | undefined;
+    rest: string[];
+};
+export declare function requireNoExtraArgs(args: string[], usage: string): void;
+export declare function requireTask(taskId: string | undefined, usage: string): string;

package/dist/src/withMutedConsole.d.ts

@@ -0,0 +1,2 @@
+export declare function withMutedConsole<T>(mute: boolean, fn: () => Promise<T>): Promise<T>;
+export declare function withMutedConsole<T>(mute: boolean, fn: () => T): T;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h-rig/cli",
-  "version": "0.0.6-alpha.77",
+  "version": "0.0.6-alpha.79",
   "type": "module",
   "description": "Rig package",
   "license": "UNLICENSED",
@@ -10,6 +10,7 @@
   ],
   "exports": {
     ".": {
+      "types": "./dist/src/index.d.ts",
       "import": "./dist/src/index.js"
     }
   },
@@ -18,20 +19,20 @@
   },
   "main": "./dist/src/index.js",
   "module": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
   "bin": {
     "rig": "./dist/bin/rig.js"
   },
   "dependencies": {
-    "@clack/prompts": "^1.2.0",
     "@earendil-works/pi-coding-agent": "0.79.0",
     "@earendil-works/pi-tui": "^0.79.0",
-    "@rig/client": "npm:@h-rig/client@0.0.6-alpha.77",
-    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.77",
-    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.77",
-    "@rig/pi-rig": "npm:@h-rig/pi-rig@0.0.6-alpha.77",
-    "@rig/runtime": "npm:@h-rig/runtime@0.0.6-alpha.77",
-    "@rig/server": "npm:@h-rig/server@0.0.6-alpha.77",
-    "@rig/standard-plugin": "npm:@h-rig/standard-plugin@0.0.6-alpha.77",
+    "@rig/client": "npm:@h-rig/client@0.0.6-alpha.79",
+    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.79",
+    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.79",
+    "@rig/pi-rig": "npm:@h-rig/pi-rig@0.0.6-alpha.79",
+    "@rig/runtime": "npm:@h-rig/runtime@0.0.6-alpha.79",
+    "@rig/server": "npm:@h-rig/server@0.0.6-alpha.79",
+    "@rig/standard-plugin": "npm:@h-rig/standard-plugin@0.0.6-alpha.79",
     "effect": "4.0.0-beta.78",
     "picocolors": "^1.1.1"
   }