@h-rig/contracts 0.0.0-e2e-live.20260630085347

package/dist/src/cli-output.d.ts

@@ -0,0 +1,348 @@
+import { Schema } from "effect";
+export declare const CLI_OUTPUT_VERSION: 1;
+/** Loose envelope shape shared by every schematized command. */
+export declare const RigCliOutputEnvelope: Schema.Struct<{
+    readonly v: Schema.Literal<1>;
+    readonly command: Schema.String;
+    readonly data: Schema.Unknown;
+}>;
+export type RigCliOutputEnvelope = typeof RigCliOutputEnvelope.Type;
+/** Task summary as emitted by `rig task list|show|next` (summarizeTask). */
+export declare const CliTaskSummary: Schema.Struct<{
+    readonly id: Schema.NullOr<Schema.String>;
+    readonly title: Schema.NullOr<Schema.String>;
+    readonly status: Schema.NullOr<Schema.String>;
+    readonly source: Schema.optional<Schema.String>;
+    readonly url: Schema.optional<Schema.String>;
+    readonly number: Schema.optional<Schema.Number>;
+    readonly labels: Schema.optional<Schema.$Array<Schema.Unknown>>;
+    readonly assignees: Schema.optional<Schema.$Array<Schema.Unknown>>;
+    readonly readiness: Schema.optional<Schema.Union<readonly [Schema.String, Schema.Boolean]>>;
+    readonly validators: Schema.optional<Schema.$Array<Schema.Unknown>>;
+    readonly raw: Schema.optional<Schema.Unknown>;
+}>;
+export type CliTaskSummary = typeof CliTaskSummary.Type;
+export declare const CliTaskFilters: Schema.Struct<{
+    readonly assignee: Schema.optional<Schema.String>;
+    readonly state: Schema.optional<Schema.String>;
+    readonly status: Schema.optional<Schema.String>;
+    readonly limit: Schema.optional<Schema.Number>;
+}>;
+export type CliTaskFilters = typeof CliTaskFilters.Type;
+/**
+ * Run records cross local disk state and remote server payloads, so the
+ * record itself stays an open map; identity fields are validated where the
+ * emitting command guarantees them.
+ */
+export declare const CliRunRecord: Schema.$Record<Schema.String, Schema.Unknown>;
+export type CliRunRecord = typeof CliRunRecord.Type;
+export declare const CliInboxRecord: Schema.$Record<Schema.String, Schema.Unknown>;
+export type CliInboxRecord = typeof CliInboxRecord.Type;
+export declare const CliDoctorCheck: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly label: Schema.String;
+    readonly status: Schema.Literals<readonly ["pass", "warn", "fail"]>;
+    readonly detail: Schema.optional<Schema.String>;
+    readonly remediation: Schema.optional<Schema.String>;
+}>;
+export type CliDoctorCheck = typeof CliDoctorCheck.Type;
+export declare const CliServerConnection: Schema.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.Literal<"local">;
+    readonly mode: Schema.Literal<"auto">;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"remote">;
+    readonly baseUrl: Schema.String;
+}>]>;
+export type CliServerConnection = typeof CliServerConnection.Type;
+export declare const CliRepoConnectionState: Schema.Struct<{
+    readonly selected: Schema.String;
+    readonly project: Schema.optional<Schema.String>;
+    readonly linkedAt: Schema.optional<Schema.String>;
+    readonly serverProjectRoot: Schema.optional<Schema.String>;
+    readonly serverProjectRootAlias: Schema.optional<Schema.String>;
+    readonly serverProjectRootBaseUrl: Schema.optional<Schema.String>;
+}>;
+export type CliRepoConnectionState = typeof CliRepoConnectionState.Type;
+export declare const CliRemoteProjectLink: Schema.Struct<{
+    readonly ok: Schema.Boolean;
+    readonly status: Schema.String;
+    readonly alias: Schema.optional<Schema.String>;
+    readonly baseUrl: Schema.optional<Schema.String>;
+    readonly repoSlug: Schema.optional<Schema.String>;
+    readonly serverProjectRoot: Schema.optional<Schema.String>;
+    readonly source: Schema.optional<Schema.String>;
+    readonly prepared: Schema.optional<Schema.Boolean>;
+    readonly validated: Schema.optional<Schema.Boolean>;
+    readonly statusCode: Schema.optional<Schema.Number>;
+    readonly message: Schema.String;
+    readonly hint: Schema.String;
+    readonly next: Schema.optional<Schema.String>;
+    readonly skippedCandidates: Schema.optional<Schema.$Array<Schema.String>>;
+}>;
+export type CliRemoteProjectLink = typeof CliRemoteProjectLink.Type;
+export declare const RigTaskListOutput: Schema.Struct<{
+    readonly v: Schema.Literal<1>;
+    readonly command: Schema.Literal<"task list">;
+    readonly data: Schema.Struct<{
+        readonly count: Schema.Number;
+        readonly filters: Schema.Struct<{
+            readonly assignee: Schema.optional<Schema.String>;
+            readonly state: Schema.optional<Schema.String>;
+            readonly status: Schema.optional<Schema.String>;
+            readonly limit: Schema.optional<Schema.Number>;
+        }>;
+        readonly raw: Schema.Boolean;
+        readonly tasks: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.NullOr<Schema.String>;
+            readonly title: Schema.NullOr<Schema.String>;
+            readonly status: Schema.NullOr<Schema.String>;
+            readonly source: Schema.optional<Schema.String>;
+            readonly url: Schema.optional<Schema.String>;
+            readonly number: Schema.optional<Schema.Number>;
+            readonly labels: Schema.optional<Schema.$Array<Schema.Unknown>>;
+            readonly assignees: Schema.optional<Schema.$Array<Schema.Unknown>>;
+            readonly readiness: Schema.optional<Schema.Union<readonly [Schema.String, Schema.Boolean]>>;
+            readonly validators: Schema.optional<Schema.$Array<Schema.Unknown>>;
+            readonly raw: Schema.optional<Schema.Unknown>;
+        }>>;
+    }>;
+}>;
+export type RigTaskListOutput = typeof RigTaskListOutput.Type;
+export declare const RigTaskShowOutput: Schema.Struct<{
+    readonly v: Schema.Literal<1>;
+    readonly command: Schema.Literal<"task show">;
+    readonly data: Schema.Struct<{
+        readonly task: Schema.Struct<{
+            readonly id: Schema.NullOr<Schema.String>;
+            readonly title: Schema.NullOr<Schema.String>;
+            readonly status: Schema.NullOr<Schema.String>;
+            readonly source: Schema.optional<Schema.String>;
+            readonly url: Schema.optional<Schema.String>;
+            readonly number: Schema.optional<Schema.Number>;
+            readonly labels: Schema.optional<Schema.$Array<Schema.Unknown>>;
+            readonly assignees: Schema.optional<Schema.$Array<Schema.Unknown>>;
+            readonly readiness: Schema.optional<Schema.Union<readonly [Schema.String, Schema.Boolean]>>;
+            readonly validators: Schema.optional<Schema.$Array<Schema.Unknown>>;
+            readonly raw: Schema.optional<Schema.Unknown>;
+        }>;
+        readonly raw: Schema.Boolean;
+    }>;
+}>;
+export type RigTaskShowOutput = typeof RigTaskShowOutput.Type;
+export declare const RigRunListOutput: Schema.Struct<{
+    readonly v: Schema.Literal<1>;
+    readonly command: Schema.Literal<"run list">;
+    readonly data: Schema.Struct<{
+        readonly runs: Schema.$Array<Schema.$Record<Schema.String, Schema.Unknown>>;
+        readonly source: Schema.Literals<readonly ["local", "server"]>;
+    }>;
+}>;
+export type RigRunListOutput = typeof RigRunListOutput.Type;
+export declare const RigRunShowOutput: Schema.Struct<{
+    readonly v: Schema.Literal<1>;
+    readonly command: Schema.Literal<"run show">;
+    readonly data: Schema.$Record<Schema.String, Schema.Unknown>;
+}>;
+export type RigRunShowOutput = typeof RigRunShowOutput.Type;
+export declare const RigServerUseOutput: Schema.Struct<{
+    readonly v: Schema.Literal<1>;
+    readonly command: Schema.Literal<"server use">;
+    readonly data: Schema.Struct<{
+        readonly selected: Schema.String;
+        readonly repo: Schema.NullOr<Schema.Struct<{
+            readonly selected: Schema.String;
+            readonly project: Schema.optional<Schema.String>;
+            readonly linkedAt: Schema.optional<Schema.String>;
+            readonly serverProjectRoot: Schema.optional<Schema.String>;
+            readonly serverProjectRootAlias: Schema.optional<Schema.String>;
+            readonly serverProjectRootBaseUrl: Schema.optional<Schema.String>;
+        }>>;
+        readonly remoteProjectLink: Schema.NullOr<Schema.Struct<{
+            readonly ok: Schema.Boolean;
+            readonly status: Schema.String;
+            readonly alias: Schema.optional<Schema.String>;
+            readonly baseUrl: Schema.optional<Schema.String>;
+            readonly repoSlug: Schema.optional<Schema.String>;
+            readonly serverProjectRoot: Schema.optional<Schema.String>;
+            readonly source: Schema.optional<Schema.String>;
+            readonly prepared: Schema.optional<Schema.Boolean>;
+            readonly validated: Schema.optional<Schema.Boolean>;
+            readonly statusCode: Schema.optional<Schema.Number>;
+            readonly message: Schema.String;
+            readonly hint: Schema.String;
+            readonly next: Schema.optional<Schema.String>;
+            readonly skippedCandidates: Schema.optional<Schema.$Array<Schema.String>>;
+        }>>;
+    }>;
+}>;
+export type RigServerUseOutput = typeof RigServerUseOutput.Type;
+export declare const RigServerStatusOutput: Schema.Struct<{
+    readonly v: Schema.Literal<1>;
+    readonly command: Schema.Literal<"server status">;
+    readonly data: Schema.Struct<{
+        readonly selected: Schema.String;
+        readonly repo: Schema.NullOr<Schema.Struct<{
+            readonly selected: Schema.String;
+            readonly project: Schema.optional<Schema.String>;
+            readonly linkedAt: Schema.optional<Schema.String>;
+            readonly serverProjectRoot: Schema.optional<Schema.String>;
+            readonly serverProjectRootAlias: Schema.optional<Schema.String>;
+            readonly serverProjectRootBaseUrl: Schema.optional<Schema.String>;
+        }>>;
+        readonly connections: Schema.$Record<Schema.String, Schema.Union<readonly [Schema.Struct<{
+            readonly kind: Schema.Literal<"local">;
+            readonly mode: Schema.Literal<"auto">;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"remote">;
+            readonly baseUrl: Schema.String;
+        }>]>>;
+        readonly remoteProjectLink: Schema.NullOr<Schema.Struct<{
+            readonly ok: Schema.Boolean;
+            readonly status: Schema.String;
+            readonly alias: Schema.optional<Schema.String>;
+            readonly baseUrl: Schema.optional<Schema.String>;
+            readonly repoSlug: Schema.optional<Schema.String>;
+            readonly serverProjectRoot: Schema.optional<Schema.String>;
+            readonly source: Schema.optional<Schema.String>;
+            readonly prepared: Schema.optional<Schema.Boolean>;
+            readonly validated: Schema.optional<Schema.Boolean>;
+            readonly statusCode: Schema.optional<Schema.Number>;
+            readonly message: Schema.String;
+            readonly hint: Schema.String;
+            readonly next: Schema.optional<Schema.String>;
+            readonly skippedCandidates: Schema.optional<Schema.$Array<Schema.String>>;
+        }>>;
+    }>;
+}>;
+export type RigServerStatusOutput = typeof RigServerStatusOutput.Type;
+export declare const RigServerRepairLinkOutput: Schema.Struct<{
+    readonly v: Schema.Literal<1>;
+    readonly command: Schema.Literal<"server repair-link">;
+    readonly data: Schema.Struct<{
+        readonly ok: Schema.Boolean;
+        readonly status: Schema.String;
+        readonly alias: Schema.optional<Schema.String>;
+        readonly baseUrl: Schema.optional<Schema.String>;
+        readonly repoSlug: Schema.optional<Schema.String>;
+        readonly serverProjectRoot: Schema.optional<Schema.String>;
+        readonly source: Schema.optional<Schema.String>;
+        readonly prepared: Schema.optional<Schema.Boolean>;
+        readonly validated: Schema.optional<Schema.Boolean>;
+        readonly statusCode: Schema.optional<Schema.Number>;
+        readonly message: Schema.String;
+        readonly hint: Schema.String;
+        readonly next: Schema.optional<Schema.String>;
+        readonly skippedCandidates: Schema.optional<Schema.$Array<Schema.String>>;
+    }>;
+}>;
+export type RigServerRepairLinkOutput = typeof RigServerRepairLinkOutput.Type;
+export declare const RigInboxApprovalsOutput: Schema.Struct<{
+    readonly v: Schema.Literal<1>;
+    readonly command: Schema.Literal<"inbox approvals">;
+    readonly data: Schema.Struct<{
+        readonly approvals: Schema.$Array<Schema.$Record<Schema.String, Schema.Unknown>>;
+    }>;
+}>;
+export type RigInboxApprovalsOutput = typeof RigInboxApprovalsOutput.Type;
+export declare const RigInboxInputsOutput: Schema.Struct<{
+    readonly v: Schema.Literal<1>;
+    readonly command: Schema.Literal<"inbox inputs">;
+    readonly data: Schema.Struct<{
+        readonly requests: Schema.$Array<Schema.$Record<Schema.String, Schema.Unknown>>;
+    }>;
+}>;
+export type RigInboxInputsOutput = typeof RigInboxInputsOutput.Type;
+export declare const RigDoctorCheckOutput: Schema.Struct<{
+    readonly v: Schema.Literal<1>;
+    readonly command: Schema.Literal<"doctor check">;
+    readonly data: Schema.Struct<{
+        readonly checks: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly label: Schema.String;
+            readonly status: Schema.Literals<readonly ["pass", "warn", "fail"]>;
+            readonly detail: Schema.optional<Schema.String>;
+            readonly remediation: Schema.optional<Schema.String>;
+        }>>;
+        readonly failures: Schema.Number;
+    }>;
+}>;
+export type RigDoctorCheckOutput = typeof RigDoctorCheckOutput.Type;
+/** Fleet metrics computed from on-disk run journals (`rig stats`). */
+export declare const RigStatsData: Schema.Struct<{
+    /** ISO timestamp of the window start, or null for all-time. */
+    readonly since: Schema.NullOr<Schema.String>;
+    readonly totalRuns: Schema.Number;
+    /** Run count per terminal/current status. */
+    readonly statusCounts: Schema.$Record<Schema.String, Schema.Number>;
+    readonly completedRuns: Schema.Number;
+    readonly failedRuns: Schema.Number;
+    readonly needsAttentionRuns: Schema.Number;
+    /** Rates over totalRuns; null when there are no runs in the window. */
+    readonly completionRate: Schema.NullOr<Schema.Number>;
+    readonly failureRate: Schema.NullOr<Schema.Number>;
+    readonly needsAttentionRate: Schema.NullOr<Schema.Number>;
+    /** Median createdAt -> completedAt for completed runs, in milliseconds. */
+    readonly medianCompletionMs: Schema.NullOr<Schema.Number>;
+    readonly steeringTotal: Schema.Number;
+    /** Average steering interventions per run; null when there are no runs. */
+    readonly steeringPerRun: Schema.NullOr<Schema.Number>;
+    readonly stallTotal: Schema.Number;
+    readonly approvalsRequested: Schema.Number;
+    readonly approvalsApproved: Schema.Number;
+    readonly approvalsRejected: Schema.Number;
+    readonly approvalsPending: Schema.Number;
+}>;
+export type RigStatsData = typeof RigStatsData.Type;
+export declare const RigStatsOutput: Schema.Struct<{
+    readonly v: Schema.Literal<1>;
+    readonly command: Schema.Literal<"stats show">;
+    readonly data: Schema.Struct<{
+        /** ISO timestamp of the window start, or null for all-time. */
+        readonly since: Schema.NullOr<Schema.String>;
+        readonly totalRuns: Schema.Number;
+        /** Run count per terminal/current status. */
+        readonly statusCounts: Schema.$Record<Schema.String, Schema.Number>;
+        readonly completedRuns: Schema.Number;
+        readonly failedRuns: Schema.Number;
+        readonly needsAttentionRuns: Schema.Number;
+        /** Rates over totalRuns; null when there are no runs in the window. */
+        readonly completionRate: Schema.NullOr<Schema.Number>;
+        readonly failureRate: Schema.NullOr<Schema.Number>;
+        readonly needsAttentionRate: Schema.NullOr<Schema.Number>;
+        /** Median createdAt -> completedAt for completed runs, in milliseconds. */
+        readonly medianCompletionMs: Schema.NullOr<Schema.Number>;
+        readonly steeringTotal: Schema.Number;
+        /** Average steering interventions per run; null when there are no runs. */
+        readonly steeringPerRun: Schema.NullOr<Schema.Number>;
+        readonly stallTotal: Schema.Number;
+        readonly approvalsRequested: Schema.Number;
+        readonly approvalsApproved: Schema.Number;
+        readonly approvalsRejected: Schema.Number;
+        readonly approvalsPending: Schema.Number;
+    }>;
+}>;
+export type RigStatsOutput = typeof RigStatsOutput.Type;
+export type OutputMode = "text" | "json";
+export type CommandExecutionResult = {
+    command: string[];
+    formattedCommand: string;
+    exitCode: number;
+    durationMs: number;
+    startedAt: string;
+    finishedAt: string;
+    stdout?: string;
+    stderr?: string;
+};
+/** Structured outcome a `rig <group> <command>` handler returns to the runner. */
+export type CommandOutcome = {
+    readonly ok: boolean;
+    readonly group: string;
+    readonly command: string;
+    readonly details?: Record<string, unknown>;
+};
+export type PluginValidatorResult = {
+    id: string;
+    passed: boolean;
+    summary: string;
+    details?: string;
+};

package/dist/src/cli-output.js

@@ -0,0 +1,190 @@
+// @bun
+// packages/contracts/src/cli-output.ts
+import { Schema } from "effect";
+var CLI_OUTPUT_VERSION = 1;
+var RigCliOutputEnvelope = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.String,
+  data: Schema.Unknown
+});
+var CliTaskSummary = Schema.Struct({
+  id: Schema.NullOr(Schema.String),
+  title: Schema.NullOr(Schema.String),
+  status: Schema.NullOr(Schema.String),
+  source: Schema.optional(Schema.String),
+  url: Schema.optional(Schema.String),
+  number: Schema.optional(Schema.Number),
+  labels: Schema.optional(Schema.Array(Schema.Unknown)),
+  assignees: Schema.optional(Schema.Array(Schema.Unknown)),
+  readiness: Schema.optional(Schema.Union([Schema.String, Schema.Boolean])),
+  validators: Schema.optional(Schema.Array(Schema.Unknown)),
+  raw: Schema.optional(Schema.Unknown)
+});
+var CliTaskFilters = Schema.Struct({
+  assignee: Schema.optional(Schema.String),
+  state: Schema.optional(Schema.String),
+  status: Schema.optional(Schema.String),
+  limit: Schema.optional(Schema.Number)
+});
+var CliRunRecord = Schema.Record(Schema.String, Schema.Unknown);
+var CliInboxRecord = Schema.Record(Schema.String, Schema.Unknown);
+var CliDoctorCheck = Schema.Struct({
+  id: Schema.String,
+  label: Schema.String,
+  status: Schema.Literals(["pass", "warn", "fail"]),
+  detail: Schema.optional(Schema.String),
+  remediation: Schema.optional(Schema.String)
+});
+var CliServerConnection = Schema.Union([
+  Schema.Struct({ kind: Schema.Literal("local"), mode: Schema.Literal("auto") }),
+  Schema.Struct({ kind: Schema.Literal("remote"), baseUrl: Schema.String })
+]);
+var CliRepoConnectionState = Schema.Struct({
+  selected: Schema.String,
+  project: Schema.optional(Schema.String),
+  linkedAt: Schema.optional(Schema.String),
+  serverProjectRoot: Schema.optional(Schema.String),
+  serverProjectRootAlias: Schema.optional(Schema.String),
+  serverProjectRootBaseUrl: Schema.optional(Schema.String)
+});
+var CliRemoteProjectLink = Schema.Struct({
+  ok: Schema.Boolean,
+  status: Schema.String,
+  alias: Schema.optional(Schema.String),
+  baseUrl: Schema.optional(Schema.String),
+  repoSlug: Schema.optional(Schema.String),
+  serverProjectRoot: Schema.optional(Schema.String),
+  source: Schema.optional(Schema.String),
+  prepared: Schema.optional(Schema.Boolean),
+  validated: Schema.optional(Schema.Boolean),
+  statusCode: Schema.optional(Schema.Number),
+  message: Schema.String,
+  hint: Schema.String,
+  next: Schema.optional(Schema.String),
+  skippedCandidates: Schema.optional(Schema.Array(Schema.String))
+});
+var RigTaskListOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("task list"),
+  data: Schema.Struct({
+    count: Schema.Number,
+    filters: CliTaskFilters,
+    raw: Schema.Boolean,
+    tasks: Schema.Array(CliTaskSummary)
+  })
+});
+var RigTaskShowOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("task show"),
+  data: Schema.Struct({
+    task: CliTaskSummary,
+    raw: Schema.Boolean
+  })
+});
+var RigRunListOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("run list"),
+  data: Schema.Struct({
+    runs: Schema.Array(CliRunRecord),
+    source: Schema.Literals(["local", "server"])
+  })
+});
+var RigRunShowOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("run show"),
+  data: CliRunRecord
+});
+var RigServerUseOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("server use"),
+  data: Schema.Struct({
+    selected: Schema.String,
+    repo: Schema.NullOr(CliRepoConnectionState),
+    remoteProjectLink: Schema.NullOr(CliRemoteProjectLink)
+  })
+});
+var RigServerStatusOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("server status"),
+  data: Schema.Struct({
+    selected: Schema.String,
+    repo: Schema.NullOr(CliRepoConnectionState),
+    connections: Schema.Record(Schema.String, CliServerConnection),
+    remoteProjectLink: Schema.NullOr(CliRemoteProjectLink)
+  })
+});
+var RigServerRepairLinkOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("server repair-link"),
+  data: CliRemoteProjectLink
+});
+var RigInboxApprovalsOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("inbox approvals"),
+  data: Schema.Struct({
+    approvals: Schema.Array(CliInboxRecord)
+  })
+});
+var RigInboxInputsOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("inbox inputs"),
+  data: Schema.Struct({
+    requests: Schema.Array(CliInboxRecord)
+  })
+});
+var RigDoctorCheckOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("doctor check"),
+  data: Schema.Struct({
+    checks: Schema.Array(CliDoctorCheck),
+    failures: Schema.Number
+  })
+});
+var RigStatsData = Schema.Struct({
+  since: Schema.NullOr(Schema.String),
+  totalRuns: Schema.Number,
+  statusCounts: Schema.Record(Schema.String, Schema.Number),
+  completedRuns: Schema.Number,
+  failedRuns: Schema.Number,
+  needsAttentionRuns: Schema.Number,
+  completionRate: Schema.NullOr(Schema.Number),
+  failureRate: Schema.NullOr(Schema.Number),
+  needsAttentionRate: Schema.NullOr(Schema.Number),
+  medianCompletionMs: Schema.NullOr(Schema.Number),
+  steeringTotal: Schema.Number,
+  steeringPerRun: Schema.NullOr(Schema.Number),
+  stallTotal: Schema.Number,
+  approvalsRequested: Schema.Number,
+  approvalsApproved: Schema.Number,
+  approvalsRejected: Schema.Number,
+  approvalsPending: Schema.Number
+});
+var RigStatsOutput = Schema.Struct({
+  v: Schema.Literal(1),
+  command: Schema.Literal("stats show"),
+  data: RigStatsData
+});
+export {
+  RigTaskShowOutput,
+  RigTaskListOutput,
+  RigStatsOutput,
+  RigStatsData,
+  RigServerUseOutput,
+  RigServerStatusOutput,
+  RigServerRepairLinkOutput,
+  RigRunShowOutput,
+  RigRunListOutput,
+  RigInboxInputsOutput,
+  RigInboxApprovalsOutput,
+  RigDoctorCheckOutput,
+  RigCliOutputEnvelope,
+  CliTaskSummary,
+  CliTaskFilters,
+  CliServerConnection,
+  CliRunRecord,
+  CliRepoConnectionState,
+  CliRemoteProjectLink,
+  CliInboxRecord,
+  CliDoctorCheck,
+  CLI_OUTPUT_VERSION
+};

package/dist/src/cli-runner.d.ts

@@ -0,0 +1,43 @@
+import type { CapabilityId } from "./capability-id";
+import type { CommandExecutionResult, OutputMode } from "./cli-output";
+import type { HarnessEvent, HarnessEventType } from "./harness-events";
+import type { PolicyConfig, PolicyMode } from "./guard";
+export type CliRuntimeInitializeOptions = {
+    readonly projectRoot: string;
+    readonly dryRun: boolean;
+    readonly outputMode: OutputMode;
+    readonly runId?: string;
+    readonly policyMode?: PolicyMode;
+};
+export type CliRuntimeContext = {
+    readonly projectRoot: string;
+    readonly dryRun: boolean;
+    readonly outputMode: OutputMode;
+    readonly runId: string;
+    readonly policyMode?: PolicyMode;
+    readonly eventBus: {
+        getRunId(): string;
+        getEventsFile(): string;
+        getMemoryEvents(): HarnessEvent[];
+        emit<TPayload extends Record<string, unknown>>(type: HarnessEventType, payload: TPayload): Promise<HarnessEvent<TPayload>>;
+    };
+    readonly emitEvent: <TPayload extends Record<string, unknown>>(type: HarnessEventType, payload: TPayload) => Promise<void>;
+    readonly runCommand: (parts: string[]) => Promise<CommandExecutionResult>;
+};
+export type AgentShellMaterializationOptions = {
+    readonly env?: Record<string, string | undefined>;
+    readonly cwd?: string;
+    readonly moduleDir?: string;
+    readonly build?: (entrypoint: string, output: string, cwd: string, define?: Record<string, string>) => Promise<void>;
+};
+export interface CliRunnerService {
+    initializeRuntime(options: CliRuntimeInitializeOptions): Promise<CliRuntimeContext>;
+    runCommand(context: CliRuntimeContext, parts: string[]): Promise<CommandExecutionResult>;
+    ensureAgentShellBinary(projectRoot: string, options?: AgentShellMaterializationOptions): Promise<string>;
+    resolveAgentMaterializationSourceRoot(projectRoot: string, options?: AgentShellMaterializationOptions): string;
+    withProjectRoot(projectRoot: string): void;
+    formatCommand(parts: string[]): string;
+    loadPolicy(projectRoot: string): PolicyConfig;
+}
+export declare const CLI_RUNNER_CAPABILITY_ID = "rig.cli.runner";
+export declare const CLI_RUNNER: CapabilityId<CliRunnerService>;

package/dist/src/cli-runner.js

@@ -0,0 +1,13 @@
+// @bun
+// packages/contracts/src/capability-id.ts
+function makeCapabilityId(id) {
+  return id;
+}
+
+// packages/contracts/src/cli-runner.ts
+var CLI_RUNNER_CAPABILITY_ID = "rig.cli.runner";
+var CLI_RUNNER = makeCapabilityId(CLI_RUNNER_CAPABILITY_ID);
+export {
+  CLI_RUNNER_CAPABILITY_ID,
+  CLI_RUNNER
+};

package/dist/src/cockpit.d.ts

@@ -0,0 +1,58 @@
+import type { TaskStatus } from "./graph";
+import type { TaskDependencyProjection } from "./task-graph-primitives";
+import type { RigTask } from "./task-source";
+export type RigTaskBadgeProjection = TaskDependencyProjection & {
+    readonly source?: string | null | undefined;
+    readonly url?: string | null | undefined;
+    readonly body?: string | null | undefined;
+    readonly assignedTo?: string | readonly string[] | null | undefined;
+    readonly assignees?: readonly string[] | null | undefined;
+};
+export type TaskProjectionListInput = {
+    readonly tasks?: readonly RigTask[];
+    readonly currentUserLogin?: string | null;
+    readonly nextReadyTaskId?: string | null;
+    readonly assignedToMe?: boolean;
+    readonly limit?: number;
+};
+export type TaskProjectionListRow = {
+    readonly id: string;
+    readonly label: string;
+    readonly currentValue: string;
+    readonly description: string;
+};
+export type TaskProjectionBoardTask = {
+    readonly id: string;
+    readonly status: string;
+    readonly title: string;
+    readonly badge?: string;
+    readonly description?: string;
+};
+export type TaskProjectionStats = {
+    readonly total: number;
+    readonly ready: number;
+    readonly running: number;
+};
+export interface TaskProjectionCapability {
+    normalizeStatus(value: string | null | undefined): TaskStatus;
+    normalizePriority(value: number | string | null | undefined): number | null;
+    project(task: RigTask): RigTaskBadgeProjection;
+    assigneeText(task: RigTask): string;
+    title(task: RigTask | null | undefined): string;
+    id(task: RigTask | null | undefined): string | null;
+    status(task: RigTask | null | undefined): string;
+    description(task: RigTask): string;
+    listRows(input: TaskProjectionListInput): readonly TaskProjectionListRow[];
+    boardTasks(input: TaskProjectionListInput): readonly TaskProjectionBoardTask[];
+    stats(tasks: readonly RigTask[] | undefined): TaskProjectionStats | null;
+}
+export interface DispatchOutcomeCapability {
+    /** Map a raw engine error to a typed operator message, or null to fall back. */
+    humanize(error: unknown): string | null;
+}
+export interface CockpitCapabilities {
+    readonly taskProjection: TaskProjectionCapability;
+    readonly dispatchOutcome: DispatchOutcomeCapability;
+}
+export declare const TASK_PROJECTION_CAPABILITY_ID: import("./capability-id").CapabilityId<TaskProjectionCapability>;
+export declare const DISPATCH_OUTCOME_CAPABILITY_ID: import("./capability-id").CapabilityId<DispatchOutcomeCapability>;

package/dist/src/cockpit.js

@@ -0,0 +1,13 @@
+// @bun
+// packages/contracts/src/capability-id.ts
+function makeCapabilityId(id) {
+  return id;
+}
+
+// packages/contracts/src/cockpit.ts
+var TASK_PROJECTION_CAPABILITY_ID = makeCapabilityId("rig:task-projection");
+var DISPATCH_OUTCOME_CAPABILITY_ID = makeCapabilityId("rig:dispatch-outcome");
+export {
+  TASK_PROJECTION_CAPABILITY_ID,
+  DISPATCH_OUTCOME_CAPABILITY_ID
+};