@h-rig/core 0.0.6-alpha.135 → 0.0.6-alpha.136

package/dist/src/index.js

@@ -190,6 +190,8 @@ function createPluginHost(plugins) {
   const taskFieldExtensions = [];
   const taskSources = [];
   const cliCommands = [];
+  const stageMutations = [];
+  const stageExecutors = {};
   const executableValidators = [];
   const executableTaskSources = [];
   for (const plugin of plugins) {
@@ -219,6 +221,10 @@ function createPluginHost(plugins) {
       taskSources.push(...c.taskSources.map((item) => ({ item, pluginName })));
     if (c.cliCommands)
       cliCommands.push(...c.cliCommands.map((item) => ({ item, pluginName })));
+    if (c.stageMutations)
+      stageMutations.push(...c.stageMutations.map((item) => ({ item, pluginName })));
+    if (plugin.__runtime?.stages)
+      Object.assign(stageExecutors, plugin.__runtime.stages);
   }
   indexById(executableValidators, "executableValidator");
   indexById(executableTaskSources, "executableTaskSource");
@@ -247,6 +253,7 @@ function createPluginHost(plugins) {
   const allTaskFieldExtensions = taskFieldExtensions.map((c) => c.item);
   const allTaskSources = taskSources.map((c) => c.item);
   const allCliCommands = cliCommands.map((c) => c.item);
+  const allStageMutations = stageMutations.map((c) => c.item);
   const allExecutableValidators = executableValidators.map((c) => c.item);
   const allExecutableTaskSources = executableTaskSources.map((c) => c.item);
   return {
@@ -266,6 +273,8 @@ function createPluginHost(plugins) {
     listTaskFieldExtensions: () => allTaskFieldExtensions,
     listTaskSources: () => allTaskSources,
     listCliCommands: () => allCliCommands,
+    listStageMutations: () => allStageMutations,
+    listStageExecutors: () => stageExecutors,
     listExecutableValidators: () => allExecutableValidators,
     listExecutableTaskSources: () => allExecutableTaskSources,
     resolveTaskSourceFactoryByKind: (kind) => taskSourceFactoryByKind.get(kind)
@@ -3058,6 +3067,19 @@ class PipelineUnresolvableError extends Error {
     this.contributors = contributors;
   }
 }
+
+class ProtectedStageViolationError extends PipelineUnresolvableError {
+  stageId;
+  pluginId;
+  op;
+  constructor(stageId, pluginId, op) {
+    super(`Protected stage ${stageId} cannot be ${op === "remove" ? "removed" : "replaced"} by ${pluginId} without an explicit grant`, [], [pluginId]);
+    this.name = "ProtectedStageViolationError";
+    this.stageId = stageId;
+    this.pluginId = pluginId;
+    this.op = op;
+  }
+}
 function uniqueSorted(values) {
   return Array.from(new Set(values)).sort((left, right) => left.localeCompare(right));
 }
@@ -3256,7 +3278,7 @@ function resolveStagePipeline(input) {
     if (!state)
       continue;
     if (state.isProtected && !hasProtectedGrant(grants, mutation.id, contributor, "remove")) {
-      throw new PipelineUnresolvableError(`Protected stage ${mutation.id} cannot be removed by ${contributor} without an explicit grant`, [], [contributor]);
+      throw new ProtectedStageViolationError(mutation.id, contributor, "remove");
     }
     const removedState = {
       ...state,
@@ -3272,7 +3294,7 @@ function resolveStagePipeline(input) {
     if (!state)
       continue;
     if (state.isProtected && !hasProtectedGrant(grants, mutation.id, contributor, "replace")) {
-      throw new PipelineUnresolvableError(`Protected stage ${mutation.id} cannot be replaced by ${contributor} without an explicit grant`, [], [contributor]);
+      throw new ProtectedStageViolationError(mutation.id, contributor, "replace");
     }
     const replacement = { ...mutation.stage, id: mutation.id };
     states.set(mutation.id, {

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

@@ -1,4 +1,4 @@
-import type { ValidatorRegistration, HookRegistration, SkillRegistration, RepoSourceRegistration, AgentRoleRegistration, TaskFieldExtension, TaskSourceRegistration, CliCommandRegistration } from "@rig/contracts";
+import type { ValidatorRegistration, HookRegistration, SkillRegistration, RepoSourceRegistration, AgentRoleRegistration, TaskFieldExtension, TaskSourceRegistration, CliCommandRegistration, StageMutation, StageRun } from "@rig/contracts";
 import type { RegisteredValidator, RigPluginWithRuntime, TaskSourceFactoryEntry } from "./plugin-runtime";
 export interface PluginHost {
     getValidator(id: string): ValidatorRegistration | undefined;
@@ -17,6 +17,19 @@ export interface PluginHost {
     listTaskFieldExtensions(): readonly TaskFieldExtension[];
     listTaskSources(): readonly TaskSourceRegistration[];
     listCliCommands(): readonly CliCommandRegistration[];
+    /**
+     * Stage mutations contributed by all loaded plugins, flattened in load order.
+     * The kernel resolves these (+ the default-lifecycle stages) into the run
+     * pipeline — this is the wire that makes "every plugin mutates the lifecycle"
+     * real (drift pre-merge gate, closure observer, reclassify observer).
+     */
+    listStageMutations(): readonly StageMutation[];
+    /**
+     * Executable stage implementations contributed by plugins (`runtime.stages`),
+     * merged by stage id. The kernel's stage runner uses these to execute
+     * plugin-contributed stages inserted via stageMutations.
+     */
+    listStageExecutors(): Readonly<Record<string, StageRun>>;
     /**
      * Executable validators contributed by plugins. Only validators whose
      * metadata appears in `listValidators()` and whose plugin shipped a runtime

package/dist/src/plugin-host.js

@@ -90,6 +90,8 @@ function createPluginHost(plugins) {
   const taskFieldExtensions = [];
   const taskSources = [];
   const cliCommands = [];
+  const stageMutations = [];
+  const stageExecutors = {};
   const executableValidators = [];
   const executableTaskSources = [];
   for (const plugin of plugins) {
@@ -119,6 +121,10 @@ function createPluginHost(plugins) {
       taskSources.push(...c.taskSources.map((item) => ({ item, pluginName })));
     if (c.cliCommands)
       cliCommands.push(...c.cliCommands.map((item) => ({ item, pluginName })));
+    if (c.stageMutations)
+      stageMutations.push(...c.stageMutations.map((item) => ({ item, pluginName })));
+    if (plugin.__runtime?.stages)
+      Object.assign(stageExecutors, plugin.__runtime.stages);
   }
   indexById(executableValidators, "executableValidator");
   indexById(executableTaskSources, "executableTaskSource");
@@ -147,6 +153,7 @@ function createPluginHost(plugins) {
   const allTaskFieldExtensions = taskFieldExtensions.map((c) => c.item);
   const allTaskSources = taskSources.map((c) => c.item);
   const allCliCommands = cliCommands.map((c) => c.item);
+  const allStageMutations = stageMutations.map((c) => c.item);
   const allExecutableValidators = executableValidators.map((c) => c.item);
   const allExecutableTaskSources = executableTaskSources.map((c) => c.item);
   return {
@@ -166,6 +173,8 @@ function createPluginHost(plugins) {
     listTaskFieldExtensions: () => allTaskFieldExtensions,
     listTaskSources: () => allTaskSources,
     listCliCommands: () => allCliCommands,
+    listStageMutations: () => allStageMutations,
+    listStageExecutors: () => stageExecutors,
     listExecutableValidators: () => allExecutableValidators,
     listExecutableTaskSources: () => allExecutableTaskSources,
     resolveTaskSourceFactoryByKind: (kind) => taskSourceFactoryByKind.get(kind)

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

@@ -1,4 +1,4 @@
-import type { HookImplementation, RegisteredTaskSource, RigConfig, RigPlugin, TaskSourceConfig, TaskSourceRegistration, ValidatorRegistration } from "@rig/contracts";
+import type { HookImplementation, RegisteredTaskSource, RigConfig, RigPlugin, StageRun, TaskSourceConfig, TaskSourceRegistration, ValidatorRegistration } from "@rig/contracts";
 export interface ValidatorResult {
     id: string;
     passed: boolean;
@@ -58,6 +58,14 @@ export interface RigPluginRuntime {
      * `@rig/runtime/control-plane/hook-runner`).
      */
     hooks?: Record<string, HookImplementation>;
+    /**
+     * Executable stage implementations keyed by stage id — the runtime counterpart
+     * to `contributes.stageMutations` (which carries only the ordering descriptor).
+     * When a plugin inserts/replaces a stage, its `run(ctx)` lives here. The plugin
+     * host flattens these (`listStageExecutors()`) so the kernel's stage runner can
+     * execute plugin-contributed stages (e.g. the docs-drift pre-merge gate).
+     */
+    stages?: Record<string, StageRun>;
 }
 export type RigPluginWithRuntime = RigPlugin & {
     __runtime?: RigPluginRuntime;

package/dist/src/stageResolve.d.ts

@@ -81,4 +81,17 @@ export declare class PipelineUnresolvableError extends Error {
     readonly contributors: readonly string[];
     constructor(message: string, cycles: readonly (readonly string[])[], contributors: readonly string[]);
 }
+/**
+ * Raised when a plugin attempts to `remove`/`replace` a protected stage without
+ * an explicit grant. Subclasses {@link PipelineUnresolvableError} so existing
+ * `instanceof PipelineUnresolvableError` checks keep working, but carries the
+ * stage/plugin/op so the kernel layer can surface the typed contracts
+ * `ProtectedStageViolation` (with its `KernelBootErrorCode`).
+ */
+export declare class ProtectedStageViolationError extends PipelineUnresolvableError {
+    readonly stageId: string;
+    readonly pluginId: string;
+    readonly op: "remove" | "replace";
+    constructor(stageId: string, pluginId: string, op: "remove" | "replace");
+}
 export declare function resolveStagePipeline<TStage extends ResolvableStage>(input: ResolveStagePipelineInput<TStage>): ResolvedStagePipeline<TStage>;

package/dist/src/stageResolve.js

@@ -10,6 +10,19 @@ class PipelineUnresolvableError extends Error {
     this.contributors = contributors;
   }
 }
+
+class ProtectedStageViolationError extends PipelineUnresolvableError {
+  stageId;
+  pluginId;
+  op;
+  constructor(stageId, pluginId, op) {
+    super(`Protected stage ${stageId} cannot be ${op === "remove" ? "removed" : "replaced"} by ${pluginId} without an explicit grant`, [], [pluginId]);
+    this.name = "ProtectedStageViolationError";
+    this.stageId = stageId;
+    this.pluginId = pluginId;
+    this.op = op;
+  }
+}
 function uniqueSorted(values) {
   return Array.from(new Set(values)).sort((left, right) => left.localeCompare(right));
 }
@@ -208,7 +221,7 @@ function resolveStagePipeline(input) {
     if (!state)
       continue;
     if (state.isProtected && !hasProtectedGrant(grants, mutation.id, contributor, "remove")) {
-      throw new PipelineUnresolvableError(`Protected stage ${mutation.id} cannot be removed by ${contributor} without an explicit grant`, [], [contributor]);
+      throw new ProtectedStageViolationError(mutation.id, contributor, "remove");
     }
     const removedState = {
       ...state,
@@ -224,7 +237,7 @@ function resolveStagePipeline(input) {
     if (!state)
       continue;
     if (state.isProtected && !hasProtectedGrant(grants, mutation.id, contributor, "replace")) {
-      throw new PipelineUnresolvableError(`Protected stage ${mutation.id} cannot be replaced by ${contributor} without an explicit grant`, [], [contributor]);
+      throw new ProtectedStageViolationError(mutation.id, contributor, "replace");
     }
     const replacement = { ...mutation.stage, id: mutation.id };
     states.set(mutation.id, {
@@ -371,5 +384,6 @@ function resolveStagePipeline(input) {
 }
 export {
   resolveStagePipeline,
+  ProtectedStageViolationError,
   PipelineUnresolvableError
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h-rig/core",
-  "version": "0.0.6-alpha.135",
+  "version": "0.0.6-alpha.136",
   "type": "module",
   "description": "Config and plugin composition library for Rig's OMP extension ecosystem; not a product host/runtime.",
   "license": "UNLICENSED",
@@ -45,7 +45,7 @@
   "module": "./dist/src/index.js",
   "types": "./dist/src/index.d.ts",
   "dependencies": {
-    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.135",
+    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.136",
     "effect": "https://pkg.pr.new/Effect-TS/effect-smol/effect@8881a9b"
   }
 }