@h-rig/core 0.0.6-alpha.13 → 0.0.6-alpha.130

package/dist/src/define-config.d.ts

@@ -0,0 +1,18 @@
+import { RigConfig } from "@rig/contracts";
+/**
+ * Author-facing config input: `plugins` and `workspace` are optional and
+ * default to a plugin-less worktree setup, so the minimal documented config
+ * (project + taskSource) works out of the box.
+ */
+export type RigConfigInput = Omit<RigConfig, "plugins" | "workspace"> & {
+    plugins?: RigConfig["plugins"];
+    workspace?: RigConfig["workspace"];
+};
+/** Fill optional top-level sections before Schema decode (which requires them). */
+export declare function applyConfigDefaults(raw: unknown): unknown;
+/**
+ * Validate a Rig config and decode through Schema, preserving each plugin's
+ * `__runtime` channel. Schema decode strips unknown fields, so we capture
+ * the runtime objects before decoding and re-attach them after.
+ */
+export declare function defineConfig(cfg: RigConfigInput): RigConfig;

package/dist/src/define-config.js

@@ -2,6 +2,23 @@
 // packages/core/src/define-config.ts
 import { Schema } from "effect";
 import { RigConfig } from "@rig/contracts";
+function normalizeWorkspaceConfig(raw) {
+  const workspace = raw && typeof raw === "object" && !Array.isArray(raw) ? { ...raw } : { mainRepo: "." };
+  workspace.checkout = workspace.checkout ?? workspace.isolation ?? "worktree";
+  workspace.isolation = workspace.isolation ?? workspace.checkout;
+  workspace.sandbox = workspace.sandbox ?? "enforce";
+  return workspace;
+}
+function applyConfigDefaults(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw))
+    return raw;
+  const record = raw;
+  return {
+    ...record,
+    plugins: Array.isArray(record.plugins) ? record.plugins : [],
+    workspace: normalizeWorkspaceConfig(record.workspace)
+  };
+}
 function defineConfig(cfg) {
   const runtimeByName = new Map;
   const plugins = cfg.plugins ?? [];
@@ -10,7 +27,7 @@ function defineConfig(cfg) {
       runtimeByName.set(plugin.name, plugin.__runtime);
     }
   }
-  const decoded = Schema.decodeUnknownSync(RigConfig)(cfg);
+  const decoded = Schema.decodeUnknownSync(RigConfig)(applyConfigDefaults(cfg));
   const decodedPlugins = decoded.plugins.map((p) => {
     const runtime = runtimeByName.get(p.name);
     if (!runtime)
@@ -20,5 +37,6 @@ function defineConfig(cfg) {
   return { ...decoded, plugins: decodedPlugins };
 }
 export {
-  defineConfig
+  defineConfig,
+  applyConfigDefaults
 };

package/dist/src/define-plugin.d.ts

@@ -0,0 +1,9 @@
+import { RigPlugin } from "@rig/contracts";
+import type { RigPluginRuntime, RigPluginWithRuntime } from "./plugin-runtime";
+/**
+ * Define a Rig plugin. The first argument is the schema-validated metadata
+ * (id strings, version, contributions). The optional second argument carries
+ * executable bits (validator `run` functions, etc.) that Schema cannot
+ * represent — they travel alongside the validated metadata as `__runtime`.
+ */
+export declare function definePlugin(meta: RigPlugin, runtime?: RigPluginRuntime): RigPluginWithRuntime;

package/dist/src/define-plugin.js

@@ -43,6 +43,23 @@ function definePlugin(meta, runtime) {
       }
     }
   }
+  const declaredHooks = new Map((validated.contributes?.hooks ?? []).map((h) => [h.id, h]));
+  for (const hookId of Object.keys(runtime.hooks ?? {})) {
+    const metadata = declaredHooks.get(hookId);
+    if (!metadata) {
+      throw new Error(`definePlugin(${validated.name}): typed hook "${hookId}" has no matching metadata entry in contributes.hooks`);
+    }
+    if (metadata.command) {
+      throw new Error(`definePlugin(${validated.name}): hook "${hookId}" has both a typed implementation and a command string \u2014 pick one`);
+    }
+  }
+  if (runtime.hooks) {
+    for (const h of declaredHooks.values()) {
+      if (!runtime.hooks[h.id] && !h.command) {
+        throw new Error(`definePlugin(${validated.name}): hook metadata "${h.id}" has no implementation (typed function or command)`);
+      }
+    }
+  }
   return { ...validated, __runtime: runtime };
 }
 export {

package/dist/src/engineReadModelReducer.d.ts

@@ -0,0 +1,12 @@
+import { EngineEvent, EngineReadModel, QueueEntry, RunSummary, TaskSummary } from "@rig/contracts";
+type EngineApplyStatus = "applied" | "ignored" | "requires-resync";
+export type ApplyStatus = EngineApplyStatus;
+export interface EngineEventApplyResult {
+    readonly status: EngineApplyStatus;
+    readonly snapshot: EngineReadModel;
+}
+export declare function mapTaskStatusFromRunStatus(status: RunSummary["status"], fallback: TaskSummary["status"]): TaskSummary["status"];
+export declare function applyEngineEvent(snapshot: EngineReadModel, event: EngineEvent): EngineEventApplyResult;
+export declare function applyEngineEvents(snapshot: EngineReadModel, events: ReadonlyArray<EngineEvent>): EngineEventApplyResult;
+export declare function pruneQueueEntries(snapshot: EngineReadModel): QueueEntry[];
+export {};

package/dist/src/engineReadModelReducer.js

@@ -10,6 +10,7 @@ import {
   WorkspaceId,
   WorktreeId
 } from "@rig/contracts";
+var CANONICAL_RUNTIME_ADAPTER = "pi";
 function isRecord(value) {
   return typeof value === "object" && value !== null;
 }
@@ -149,7 +150,7 @@ function mapLegacySessionStatusToRunStatus(status) {
     case "error":
       return "failed";
     case "stopped":
-      return "cancelled";
+      return "stopped";
     default:
       return "created";
   }
@@ -185,12 +186,15 @@ function mapTaskStatusFromRunStatus(status, fallback) {
     case "paused":
       return "in_progress";
     case "reviewing":
+    case "closing-out":
       return "under_review";
+    case "needs-attention":
+      return "blocked";
     case "completed":
       return "completed";
     case "failed":
       return "ready";
-    case "cancelled":
+    case "stopped":
       return "cancelled";
   }
 }
@@ -374,7 +378,7 @@ function applySyntheticRuntimePreparation(snapshot, event) {
     ...existingRun,
     taskId: existingRun.taskId ?? nextTaskId,
     runKind: existingRun.runKind === "adhoc" && nextTaskId ? "task" : existingRun.runKind,
-    runtimeAdapter: "rig-native",
+    runtimeAdapter: CANONICAL_RUNTIME_ADAPTER,
     initialPrompt: existingRun.initialPrompt ?? null,
     executionTarget: existingRun.executionTarget ?? "local",
     remoteHostId: existingRun.remoteHostId ?? null,
@@ -390,7 +394,7 @@ function applySyntheticRuntimePreparation(snapshot, event) {
     ...runtimeBase,
     workspaceId: nextWorkspaceId,
     runId: runtimeRunId,
-    adapterKind: "rig-native",
+    adapterKind: CANONICAL_RUNTIME_ADAPTER,
     executionTarget: existingRun.executionTarget ?? "local",
     remoteHostId: existingRun.remoteHostId ?? null,
     status: failed ? "failed" : finished ? "prepared" : "starting",
@@ -439,7 +443,7 @@ function applySyntheticRuntimePrepared(snapshot, event) {
     ...snapshot.runtimes.find((runtime) => runtime.runId === runId) ?? makeRuntimeFromRun(existingRun, event.createdAt),
     workspaceId: nextWorkspaceId,
     runId: runtimeRunId,
-    adapterKind: "rig-native",
+    adapterKind: CANONICAL_RUNTIME_ADAPTER,
     executionTarget: existingRun.executionTarget ?? "local",
     remoteHostId: existingRun.remoteHostId ?? null,
     status: "prepared",
@@ -482,7 +486,7 @@ function applyLegacyProjectEvent(snapshot, event) {
       title,
       rootPath,
       sourceKind: "native",
-      defaultRuntimeAdapter: "codex-app-server",
+      defaultRuntimeAdapter: CANONICAL_RUNTIME_ADAPTER,
       defaultModel: readNullableString(payload, "defaultModel") ?? null,
       createdAt,
       updatedAt
@@ -577,7 +581,7 @@ function applyLegacyThreadEvent(snapshot, event) {
       runtimeMode: "full-access",
       interactionMode: "default",
       status: "created",
-      runtimeAdapter: "codex-app-server",
+      runtimeAdapter: CANONICAL_RUNTIME_ADAPTER,
       model,
       initialPrompt: null,
       activeRuntimeId: null,
@@ -761,7 +765,7 @@ function applyLegacyThreadEvent(snapshot, event) {
     const providerName = readNullableString(session, "providerName");
     const nextRun = {
       ...existingRun,
-      runtimeAdapter: providerName ?? existingRun.runtimeAdapter,
+      runtimeAdapter: CANONICAL_RUNTIME_ADAPTER,
       initialPrompt: existingRun.initialPrompt ?? null,
       activeRuntimeId: runtimeIdFromRunId(asRunId(runId)),
       status: mapLegacySessionStatusToRunStatus(readString(session, "status")),
@@ -774,7 +778,7 @@ function applyLegacyThreadEvent(snapshot, event) {
       ...snapshot.runtimes.find((runtime) => runtime.runId === runId) ?? makeRuntimeFromRun(nextRun, sessionUpdatedAt),
       workspaceId: existingRun.workspaceId,
       runId: asRunId(runId),
-      adapterKind: providerName ?? existingRun.runtimeAdapter,
+      adapterKind: CANONICAL_RUNTIME_ADAPTER,
       status: mapLegacySessionStatusToRuntimeStatus(readString(session, "status")),
       workspaceDir: existingRun.worktreePath,
       isolationMode: existingRun.worktreePath ? "worktree" : "env",
@@ -1008,7 +1012,7 @@ function applyEngineEvent(snapshot, event) {
         runtimeMode: payload.runtimeMode,
         interactionMode: payload.interactionMode,
         status: "created",
-        runtimeAdapter: payload.runtimeAdapter,
+        runtimeAdapter: CANONICAL_RUNTIME_ADAPTER,
         model: payload.model ?? null,
         initialPrompt: payload.initialPrompt ?? null,
         executionTarget: payload.executionTarget ?? (payload.remoteHostId ? "remote" : "local"),
@@ -1040,7 +1044,7 @@ function applyEngineEvent(snapshot, event) {
           ...base,
           runs: patchById(base.runs, payload.runId, (run) => ({
             ...run,
-            status: "cancelled",
+            status: "stopped",
             updatedAt: payload.createdAt,
             completedAt: payload.createdAt
           }))
@@ -1704,7 +1708,7 @@ function applyEngineEvent(snapshot, event) {
       runtimeMode: "full-access",
       interactionMode: "default",
       status: "created",
-      runtimeAdapter: "rig-native",
+      runtimeAdapter: CANONICAL_RUNTIME_ADAPTER,
       model: null,
       initialPrompt: null,
       activeRuntimeId: runtimeIdFromRunId(asRunId(runId)),
@@ -1724,7 +1728,7 @@ function applyEngineEvent(snapshot, event) {
       workspaceId: asWorkspaceId(workspaceId),
       taskId: asTaskId(taskId),
       runKind: "task",
-      runtimeAdapter: "rig-native",
+      runtimeAdapter: CANONICAL_RUNTIME_ADAPTER,
       activeRuntimeId: runtimeIdFromRunId(asRunId(runId)),
       updatedAt: event.createdAt
     });

package/dist/src/index.d.ts

@@ -0,0 +1,12 @@
+export declare const RIG_CORE_PACKAGE = "@rig/core";
+export { definePlugin } from "./define-plugin";
+export { defineConfig } from "./define-config";
+export { createPluginHost } from "./plugin-host";
+export type { PluginHost } from "./plugin-host";
+export { buildRigInitConfigSource, type RigInitConfigInput, } from "./rig-init-builder";
+export type { RegisteredValidator, RigPluginRuntime, RigPluginWithRuntime, TaskSourceFactoryContext, TaskSourceFactoryEntry, ValidatorContext, ValidatorResult, } from "./plugin-runtime";
+export { applyEngineEvent, applyEngineEvents, applyEngineEvent as applyRigEvent, pruneQueueEntries, type ApplyStatus, type EngineEventApplyResult, type EngineEventApplyResult as RigEventApplyResult, } from "./engineReadModelReducer";
+export { pickDefaultWorkspaceId, projectRunStatusForTaskGrouping, projectTaskStatusForGrouping, projectTaskStatusWithSessions, normalizeTaskAssigneeFilter, readTaskAssigneeLogins, selectAdhocRuns, selectAdhocRunsForWorkspace, selectApprovalsForRun, selectApprovalsForWorkspace, selectGraphsForWorkspace, selectPendingApprovals, selectPrimaryWorkspace, selectQueueForWorkspace, selectRun, selectRunsByTask, selectRunsForTask, selectRunsForWorkspace, selectTask, selectTasksByStatus, selectTasksByWorkspace, selectTasksForWorkspace, selectTasksGroupedByStatus, selectTasksAssignedTo, selectTasksAssignedToMe, selectUserInputsForRun, selectUserInputsForWorkspace, selectWorkspace, selectWorkspaces, type RigTaskSessionProjection, type RigTaskStatusGroup, type RigTaskStatusGroupingInput, } from "./rigSelectors";
+export { buildTaskReferenceIndex, computeTaskBlockingDepths, computeTaskDependencyBadges, isTaskTerminalStatus, readTaskDependencyRefs, readTaskMetadataStringList, readTaskSourceIssueId, resolveTaskReference, selectNextReadyTaskByPriority, type TaskDependencyBadge, type TaskDependencyBadgeKind, type TaskDependencyBadgeSummary, type TaskDependencyProjection, } from "./taskGraph";
+export { extractTaskCode, extractTaskGroupKey, stripTaskCode, } from "./taskGraphCodes";
+export { buildTaskGraphLayout, type TaskGraphEdge, type TaskGraphLane, type TaskGraphLayout, type TaskGraphNode, type TaskGraphStage, } from "./taskGraphLayout";