@h-rig/kernel-seed 0.0.6-alpha.136 → 0.0.6-alpha.138

package/dist/src/index.js

@@ -3,13 +3,13 @@
 class JournalConformanceError extends Error {
   name = "JournalConformanceError";
 }
-var CONFORMANCE_RUN_ID = "rig.kernel.__journal-conformance__";
+var CONFORMANCE_RUN_ID = "rig.run.__journal-conformance__";
 function sampleResolvedPipeline() {
   return {
     order: ["validate", "merge-gate"],
     record: [
       { stageId: "validate", contributedBy: "default", isProtected: false },
-      { stageId: "merge-gate", contributedBy: "default", isProtected: true }
+      { stageId: "merge-gate", contributedBy: "default", isProtected: false }
     ],
     cycles: [],
     grantUses: [],
@@ -143,6 +143,42 @@ function objectAt(value, key) {
 function hasFunction(value, key) {
   return value !== null && typeof value[key] === "function";
 }
+function assertSatisfiesStageRunnerInterface(value) {
+  if (!isRecord(value) || typeof value.resolve !== "function" || typeof value.runPipeline !== "function") {
+    throw new BootIncoherent("stage-runner provider must expose resolve and runPipeline");
+  }
+}
+function assertSatisfiesJournalInterface(value) {
+  if (!isRecord(value) || typeof value.append !== "function" || typeof value.recordPipeline !== "function" || typeof value.read !== "function") {
+    throw new BootIncoherent("journal provider must expose append, recordPipeline, and read");
+  }
+}
+function assertSatisfiesLoaderPolicyInterface(value) {
+  if (!isRecord(value) || typeof value.resolveCapability !== "function") {
+    throw new BootIncoherent("loader-policy provider must expose resolveCapability");
+  }
+}
+function assertSatisfiesTransportInterface(value) {
+  if (!isRecord(value) || typeof value.dispatch !== "function") {
+    throw new BootIncoherent("transport provider must expose dispatch");
+  }
+}
+function resolveRequiredCapability(plugins, capability, config, assertInterface) {
+  const resolution = resolveCapability(plugins, capability, config);
+  if (!resolution) {
+    throw new BootIncoherent(`no ${capability} provider resolved`);
+  }
+  assertInterface(resolution.value);
+  return resolution;
+}
+function assertSatisfiesKernelStartProvider(value) {
+  if (!isRecord(value)) {
+    throw new BootIncoherent("kernel provider did not return an object");
+  }
+  if (typeof value.start !== "function") {
+    throw new BootIncoherent("kernel provider must expose start");
+  }
+}
 function assertSatisfiesKernelInterface(value) {
   if (!isRecord(value)) {
     throw new BootIncoherent("kernel provider did not return an object");
@@ -175,15 +211,41 @@ async function loadPlugins(config) {
 }
 async function boot(config) {
   const plugins = await loadPlugins(config);
-  const resolution = resolveCapability(plugins, "kernel", config);
-  if (!resolution) {
-    throw new BootIncoherent("no kernel provider resolved");
-  }
-  assertSatisfiesKernelInterface(resolution.value);
+  const kernelResolution = resolveRequiredCapability(plugins, "kernel", config, assertSatisfiesKernelStartProvider);
+  const stageRunnerResolution = resolveRequiredCapability(plugins, "stage-runner", config, assertSatisfiesStageRunnerInterface);
+  const journalResolution = resolveRequiredCapability(plugins, "journal", config, assertSatisfiesJournalInterface);
+  const loaderPolicyResolution = resolveRequiredCapability(plugins, "loader-policy", config, assertSatisfiesLoaderPolicyInterface);
+  const transportResolution = resolveRequiredCapability(plugins, "transport", config, assertSatisfiesTransportInterface);
+  const kernel = kernelResolution.value;
+  const stageRunner = stageRunnerResolution.value;
+  const journal = journalResolution.value;
+  const loaderPolicy = loaderPolicyResolution.value;
+  const transport = transportResolution.value;
+  const composed = {
+    ...kernel,
+    stageRunner,
+    journal,
+    loaderPolicy,
+    transport,
+    start(loadedPlugins) {
+      return kernel.start.call(composed, loadedPlugins);
+    }
+  };
+  assertSatisfiesKernelInterface(composed);
   if (config.verifyJournalConformance === true) {
-    await assertJournalConformance(resolution.value.journal);
+    await assertJournalConformance(composed.journal);
   }
-  return { kernel: resolution.value, plugins };
+  return {
+    kernel: composed,
+    plugins,
+    capabilityProviderIds: {
+      kernel: kernelResolution.plugin.meta.id,
+      "stage-runner": stageRunnerResolution.plugin.meta.id,
+      journal: journalResolution.plugin.meta.id,
+      "loader-policy": loaderPolicyResolution.plugin.meta.id,
+      transport: transportResolution.plugin.meta.id
+    }
+  };
 }
 export {
   resolveCapability,

package/dist/src/journalConformance.js

@@ -3,13 +3,13 @@
 class JournalConformanceError extends Error {
   name = "JournalConformanceError";
 }
-var CONFORMANCE_RUN_ID = "rig.kernel.__journal-conformance__";
+var CONFORMANCE_RUN_ID = "rig.run.__journal-conformance__";
 function sampleResolvedPipeline() {
   return {
     order: ["validate", "merge-gate"],
     record: [
       { stageId: "validate", contributedBy: "default", isProtected: false },
-      { stageId: "merge-gate", contributedBy: "default", isProtected: true }
+      { stageId: "merge-gate", contributedBy: "default", isProtected: false }
     ],
     cycles: [],
     grantUses: [],

package/dist/src/pluginAbi.d.ts

@@ -9,6 +9,7 @@ export type PluginContributions = Readonly<Record<string, unknown>>;
 export type PluginRuntimeChannel = {
     readonly capabilities?: Readonly<Record<string, unknown>>;
     readonly kernel?: KernelCapability;
+    readonly [key: string]: unknown;
 };
 export type LoadedPlugin = {
     readonly meta: PluginMeta;
@@ -19,6 +20,7 @@ export type LoadedPlugin = {
     readonly runtime: PluginRuntimeChannel;
 };
 export type CapabilityPrecedence = Partial<Record<CapabilityTag, readonly string[]>>;
+export type CapabilityProviderIds = Readonly<Record<CapabilityTag, string>>;
 export type ResolvedBootConfig = {
     readonly plugins?: readonly LoadedPlugin[];
     readonly loadPlugins?: () => Promise<readonly LoadedPlugin[]> | readonly LoadedPlugin[];
@@ -35,5 +37,6 @@ export type ResolvedBootConfig = {
 export type BootResult = {
     readonly kernel: KernelCapability;
     readonly plugins: readonly LoadedPlugin[];
+    readonly capabilityProviderIds: CapabilityProviderIds;
 };
 export declare function loadedPluginId(plugin: LoadedPlugin): string;

package/dist/src/seed.js

@@ -3,13 +3,13 @@
 class JournalConformanceError extends Error {
   name = "JournalConformanceError";
 }
-var CONFORMANCE_RUN_ID = "rig.kernel.__journal-conformance__";
+var CONFORMANCE_RUN_ID = "rig.run.__journal-conformance__";
 function sampleResolvedPipeline() {
   return {
     order: ["validate", "merge-gate"],
     record: [
       { stageId: "validate", contributedBy: "default", isProtected: false },
-      { stageId: "merge-gate", contributedBy: "default", isProtected: true }
+      { stageId: "merge-gate", contributedBy: "default", isProtected: false }
     ],
     cycles: [],
     grantUses: [],
@@ -140,6 +140,42 @@ function objectAt(value, key) {
 function hasFunction(value, key) {
   return value !== null && typeof value[key] === "function";
 }
+function assertSatisfiesStageRunnerInterface(value) {
+  if (!isRecord(value) || typeof value.resolve !== "function" || typeof value.runPipeline !== "function") {
+    throw new BootIncoherent("stage-runner provider must expose resolve and runPipeline");
+  }
+}
+function assertSatisfiesJournalInterface(value) {
+  if (!isRecord(value) || typeof value.append !== "function" || typeof value.recordPipeline !== "function" || typeof value.read !== "function") {
+    throw new BootIncoherent("journal provider must expose append, recordPipeline, and read");
+  }
+}
+function assertSatisfiesLoaderPolicyInterface(value) {
+  if (!isRecord(value) || typeof value.resolveCapability !== "function") {
+    throw new BootIncoherent("loader-policy provider must expose resolveCapability");
+  }
+}
+function assertSatisfiesTransportInterface(value) {
+  if (!isRecord(value) || typeof value.dispatch !== "function") {
+    throw new BootIncoherent("transport provider must expose dispatch");
+  }
+}
+function resolveRequiredCapability(plugins, capability, config, assertInterface) {
+  const resolution = resolveCapability(plugins, capability, config);
+  if (!resolution) {
+    throw new BootIncoherent(`no ${capability} provider resolved`);
+  }
+  assertInterface(resolution.value);
+  return resolution;
+}
+function assertSatisfiesKernelStartProvider(value) {
+  if (!isRecord(value)) {
+    throw new BootIncoherent("kernel provider did not return an object");
+  }
+  if (typeof value.start !== "function") {
+    throw new BootIncoherent("kernel provider must expose start");
+  }
+}
 function assertSatisfiesKernelInterface(value) {
   if (!isRecord(value)) {
     throw new BootIncoherent("kernel provider did not return an object");
@@ -172,15 +208,41 @@ async function loadPlugins(config) {
 }
 async function boot(config) {
   const plugins = await loadPlugins(config);
-  const resolution = resolveCapability(plugins, "kernel", config);
-  if (!resolution) {
-    throw new BootIncoherent("no kernel provider resolved");
-  }
-  assertSatisfiesKernelInterface(resolution.value);
+  const kernelResolution = resolveRequiredCapability(plugins, "kernel", config, assertSatisfiesKernelStartProvider);
+  const stageRunnerResolution = resolveRequiredCapability(plugins, "stage-runner", config, assertSatisfiesStageRunnerInterface);
+  const journalResolution = resolveRequiredCapability(plugins, "journal", config, assertSatisfiesJournalInterface);
+  const loaderPolicyResolution = resolveRequiredCapability(plugins, "loader-policy", config, assertSatisfiesLoaderPolicyInterface);
+  const transportResolution = resolveRequiredCapability(plugins, "transport", config, assertSatisfiesTransportInterface);
+  const kernel = kernelResolution.value;
+  const stageRunner = stageRunnerResolution.value;
+  const journal = journalResolution.value;
+  const loaderPolicy = loaderPolicyResolution.value;
+  const transport = transportResolution.value;
+  const composed = {
+    ...kernel,
+    stageRunner,
+    journal,
+    loaderPolicy,
+    transport,
+    start(loadedPlugins) {
+      return kernel.start.call(composed, loadedPlugins);
+    }
+  };
+  assertSatisfiesKernelInterface(composed);
   if (config.verifyJournalConformance === true) {
-    await assertJournalConformance(resolution.value.journal);
+    await assertJournalConformance(composed.journal);
   }
-  return { kernel: resolution.value, plugins };
+  return {
+    kernel: composed,
+    plugins,
+    capabilityProviderIds: {
+      kernel: kernelResolution.plugin.meta.id,
+      "stage-runner": stageRunnerResolution.plugin.meta.id,
+      journal: journalResolution.plugin.meta.id,
+      "loader-policy": loaderPolicyResolution.plugin.meta.id,
+      transport: transportResolution.plugin.meta.id
+    }
+  };
 }
 export {
   boot,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h-rig/kernel-seed",
-  "version": "0.0.6-alpha.136",
+  "version": "0.0.6-alpha.138",
   "type": "module",
   "description": "Irreducible Rig bootstrap seed, plugin ABI, and capability resolver.",
   "license": "UNLICENSED",
@@ -33,6 +33,6 @@
   "module": "./dist/src/index.js",
   "types": "./dist/src/index.d.ts",
   "dependencies": {
-    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.136"
+    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.138"
   }
 }