@bluewombat/runtime 0.1.0

package/dist/plugins/isolation.js

@@ -0,0 +1,64 @@
+import { loadPlugin } from "./load.js";
+/**
+ * The module must export `strategy` with `isolation` and `fold` backends;
+ * `reference`, when present, must be a backend with `parse`, and `refOf` a
+ * function. `createStrategy`, when present, must be a function: it is what
+ * `workLine.isolationOptions` is handed to.
+ */
+const strategyShape = {
+    kind: "Isolation strategy",
+    check(loaded) {
+        const strategy = loaded?.strategy;
+        if (strategy === null ||
+            typeof strategy !== "object" ||
+            typeof strategy.isolation !== "object" ||
+            typeof strategy.fold !== "object") {
+            return { ok: false, reason: "does not export strategy" };
+        }
+        const reference = strategy.reference;
+        if (reference !== undefined &&
+            (reference === null ||
+                typeof reference !== "object" ||
+                typeof reference.parse !== "function")) {
+            return { ok: false, reason: "exports a reference without parse" };
+        }
+        const refOf = strategy.refOf;
+        if (refOf !== undefined && typeof refOf !== "function") {
+            return { ok: false, reason: "exports a refOf that is not a function" };
+        }
+        const createStrategy = loaded.createStrategy;
+        if (createStrategy !== undefined && typeof createStrategy !== "function") {
+            return { ok: false, reason: "exports a createStrategy that is not a function" };
+        }
+        const value = { strategy: strategy };
+        if (createStrategy !== undefined) {
+            value.createStrategy = createStrategy;
+        }
+        return { ok: true, value };
+    },
+};
+/**
+ * Load the isolation strategy package named by `workLine.isolation`, shaped
+ * by `workLine.isolationOptions` when the config has any. Options handed to
+ * a package that takes none are a mistake to stop on, not to ignore: the
+ * operator meant them.
+ */
+export async function resolveIsolationStrategy(name, fromDir, options) {
+    const loaded = await loadPlugin(name, fromDir, strategyShape);
+    if (!loaded.ok) {
+        return loaded;
+    }
+    const { specifier } = loaded;
+    if (options === undefined) {
+        return { ok: true, strategy: loaded.value.strategy, specifier };
+    }
+    if (loaded.value.createStrategy === undefined) {
+        return {
+            ok: false,
+            reason: `${specifier} takes no isolationOptions; remove "workLine.isolationOptions" from the config.`,
+        };
+    }
+    const made = loaded.value.createStrategy(options);
+    return made.ok ? { ok: true, strategy: made.strategy, specifier } : made;
+}
+//# sourceMappingURL=isolation.js.map

package/dist/plugins/isolation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isolation.js","sourceRoot":"","sources":["../../src/plugins/isolation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAc,MAAM,WAAW,CAAC;AAkEnD;;;;;GAKG;AACH,MAAM,aAAa,GAA0B;IAC3C,IAAI,EAAE,oBAAoB;IAC1B,KAAK,CAAC,MAAM;QACV,MAAM,QAAQ,GAAI,MAAwC,EAAE,QAAQ,CAAC;QACrE,IACE,QAAQ,KAAK,IAAI;YACjB,OAAO,QAAQ,KAAK,QAAQ;YAC5B,OAAQ,QAAoC,CAAC,SAAS,KAAK,QAAQ;YACnE,OAAQ,QAA+B,CAAC,IAAI,KAAK,QAAQ,EACzD,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,0BAA0B,EAAE,CAAC;QAC3D,CAAC;QACD,MAAM,SAAS,GAAI,QAAoC,CAAC,SAAS,CAAC;QAClE,IACE,SAAS,KAAK,SAAS;YACvB,CAAC,SAAS,KAAK,IAAI;gBACjB,OAAO,SAAS,KAAK,QAAQ;gBAC7B,OAAQ,SAAiC,CAAC,KAAK,KAAK,UAAU,CAAC,EACjE,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mCAAmC,EAAE,CAAC;QACpE,CAAC;QACD,MAAM,KAAK,GAAI,QAAgC,CAAC,KAAK,CAAC;QACtD,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YACvD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,wCAAwC,EAAE,CAAC;QACzE,CAAC;QACD,MAAM,cAAc,GAAI,MAAuC,CAAC,cAAc,CAAC;QAC/E,IAAI,cAAc,KAAK,SAAS,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;YACzE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iDAAiD,EAAE,CAAC;QAClF,CAAC;QACD,MAAM,KAAK,GAAmB,EAAE,QAAQ,EAAE,QAA6B,EAAE,CAAC;QAC1E,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,KAAK,CAAC,cAAc,GAAG,cAA+D,CAAC;QACzF,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,IAAY,EACZ,OAAe,EACf,OAAiC;IAEjC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAC7B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;IAClE,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QAC9C,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,GAAG,SAAS,iFAAiF;SACtG,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3E,CAAC"}

package/dist/plugins/load.d.ts

@@ -0,0 +1,35 @@
+/**
+ * How Host loads anything a Project names in its config: a manager, an
+ * isolation strategy, whatever comes next. One loader, one set of resolution
+ * rules, one wording for a package that is missing. What differs per kind is
+ * only the shape the module must have, and that is the `Shape` handed in.
+ *
+ * Resolution: a relative or absolute name is a file. A bare name is imported
+ * the normal way first — mason and its plugins installed side by side in one
+ * project — then looked for by walking `node_modules` up from `fromDir`, which
+ * covers a globally installed `mason` driving a plugin installed next to the
+ * config file.
+ */
+/** What one kind of plugin must look like once imported. */
+export type Shape<T> = {
+    /** How the kind is called in a refusal: `Manager`, `Isolation strategy`. */
+    kind: string;
+    /** Read the module; `reason` says what is missing, without naming the file. */
+    check(loaded: unknown): {
+        ok: true;
+        value: T;
+    } | {
+        ok: false;
+        reason: string;
+    };
+};
+export type Loaded<T> = {
+    ok: true;
+    value: T;
+    specifier: string;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function loadPlugin<T>(name: string, fromDir: string, shape: Shape<T>): Promise<Loaded<T>>;
+//# sourceMappingURL=load.d.ts.map

package/dist/plugins/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/plugins/load.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AAEH,4DAA4D;AAC5D,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI;IACrB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAChF,CAAC;AAEF,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElG,wBAAsB,UAAU,CAAC,CAAC,EAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GACd,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAyBpB"}

package/dist/plugins/load.js

@@ -0,0 +1,109 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { PRODUCT } from "@bluewombat/manager-kit";
+export async function loadPlugin(name, fromDir, shape) {
+    const attempts = [];
+    if (name.startsWith(".") || isAbsolute(name)) {
+        const path = resolve(fromDir, name);
+        if (!existsSync(path)) {
+            return { ok: false, reason: `${shape.kind} "${name}" is not a file: ${path}` };
+        }
+        return await importFrom(pathToFileURL(path).href, name, shape, attempts);
+    }
+    const direct = await importFrom(name, name, shape, attempts);
+    if (direct.ok) {
+        return direct;
+    }
+    const nearby = findInNodeModules(name, fromDir);
+    if (nearby === undefined) {
+        return {
+            ok: false,
+            reason: `${shape.kind} "${name}" could not be loaded. Install it next to ${PRODUCT} ` +
+                `(npm install ${name}).\n${attempts.join("\n")}`,
+        };
+    }
+    return await importFrom(pathToFileURL(nearby).href, name, shape, attempts);
+}
+async function importFrom(url, name, shape, attempts) {
+    let loaded;
+    try {
+        loaded = await import(url);
+    }
+    catch (error) {
+        attempts.push(`  ${url}: ${error instanceof Error ? error.message : String(error)}`);
+        return { ok: false, reason: attempts.join("\n") };
+    }
+    const checked = shape.check(loaded);
+    if (!checked.ok) {
+        return { ok: false, reason: `${shape.kind} "${name}" ${checked.reason} (${name}).` };
+    }
+    return { ok: true, value: checked.value, specifier: name };
+}
+/** The entry file of `<dir>/node_modules/<specifier>`, walking up from `from`. */
+function findInNodeModules(specifier, from) {
+    let dir = resolve(from);
+    for (;;) {
+        const packageRoot = join(dir, "node_modules", specifier);
+        const manifest = join(packageRoot, "package.json");
+        if (existsSync(manifest)) {
+            const entry = entryOf(manifest);
+            if (entry !== undefined) {
+                const path = resolve(packageRoot, entry);
+                if (existsSync(path)) {
+                    return path;
+                }
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            return undefined;
+        }
+        dir = parent;
+    }
+}
+function entryOf(manifest) {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(manifest, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+    if (parsed === null || typeof parsed !== "object") {
+        return undefined;
+    }
+    const object = parsed;
+    const root = readExports(object.exports);
+    if (root !== undefined) {
+        return root;
+    }
+    if (typeof object.module === "string") {
+        return object.module;
+    }
+    return typeof object.main === "string" ? object.main : undefined;
+}
+function readExports(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if (value === null || typeof value !== "object") {
+        return undefined;
+    }
+    const root = value["."] ?? value;
+    if (typeof root === "string") {
+        return root;
+    }
+    if (root === null || typeof root !== "object") {
+        return undefined;
+    }
+    const conditions = root;
+    for (const key of ["import", "module", "default"]) {
+        const candidate = conditions[key];
+        if (typeof candidate === "string") {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=load.js.map

package/dist/plugins/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/plugins/load.ts"],"names":[],"mappings":"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"}

package/dist/plugins/manager.d.ts

@@ -0,0 +1,43 @@
+import type { ManagerContext, ManagerModule, ManagerPort } from "@bluewombat/manager-kit";
+export type ResolveResult = {
+    ok: true;
+    module: ManagerModule;
+    specifier: string;
+} | {
+    ok: false;
+    reason: string;
+};
+/** Load the manager package named by the config. */
+export declare function resolveManagerModule(name: string, fromDir: string): Promise<ResolveResult>;
+export type ManagerRequest = {
+    manager: string | ManagerModule;
+    managerOptions: Record<string, unknown>;
+    configDir: string;
+    durationMs: number;
+    interruptFlag: {
+        interrupted: boolean;
+    };
+    env: Record<string, string | undefined>;
+};
+export type LoadedModule = {
+    ok: true;
+    module: ManagerModule;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function contextOf(request: ManagerRequest): ManagerContext;
+/** The module face, so `mason doctor` can ask a manager to check itself. */
+export declare function loadManagerModule(request: ManagerRequest): Promise<LoadedModule>;
+/**
+ * Resolve the manager package, then let it build its own Port. Host reads
+ * neither the options nor the environment on its behalf.
+ */
+export declare function openManager(request: ManagerRequest): Promise<{
+    ok: true;
+    manager: ManagerPort;
+} | {
+    ok: false;
+    reason: string;
+}>;
+//# sourceMappingURL=manager.d.ts.map

package/dist/plugins/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/plugins/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAkB1F,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,oDAAoD;AACpD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAGhG;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE;QAAE,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;IACxC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/F,wBAAgB,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAQjE;AAED,4EAA4E;AAC5E,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAMtF;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAM7E"}

package/dist/plugins/manager.js

@@ -0,0 +1,47 @@
+import { loadPlugin } from "./load.js";
+/** The module face a manager package must export. Contract: `@bluewombat/manager-kit`. */
+const managerShape = {
+    kind: "Manager",
+    check(loaded) {
+        if (loaded === null ||
+            typeof loaded !== "object" ||
+            typeof loaded.createManager !== "function") {
+            return { ok: false, reason: "does not export createManager" };
+        }
+        return { ok: true, value: loaded };
+    },
+};
+/** Load the manager package named by the config. */
+export async function resolveManagerModule(name, fromDir) {
+    const loaded = await loadPlugin(name, fromDir, managerShape);
+    return loaded.ok ? { ok: true, module: loaded.value, specifier: loaded.specifier } : loaded;
+}
+export function contextOf(request) {
+    return {
+        options: request.managerOptions,
+        durationMs: request.durationMs,
+        interruptFlag: request.interruptFlag,
+        configDir: request.configDir,
+        env: request.env,
+    };
+}
+/** The module face, so `mason doctor` can ask a manager to check itself. */
+export async function loadManagerModule(request) {
+    if (typeof request.manager !== "string") {
+        return { ok: true, module: request.manager };
+    }
+    const resolved = await resolveManagerModule(request.manager, request.configDir);
+    return resolved.ok ? { ok: true, module: resolved.module } : resolved;
+}
+/**
+ * Resolve the manager package, then let it build its own Port. Host reads
+ * neither the options nor the environment on its behalf.
+ */
+export async function openManager(request) {
+    const loaded = await loadManagerModule(request);
+    if (!loaded.ok) {
+        return loaded;
+    }
+    return await loaded.module.createManager(contextOf(request));
+}
+//# sourceMappingURL=manager.js.map

package/dist/plugins/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/plugins/manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAc,MAAM,WAAW,CAAC;AAEnD,0FAA0F;AAC1F,MAAM,YAAY,GAAyB;IACzC,IAAI,EAAE,SAAS;IACf,KAAK,CAAC,MAAM;QACV,IACE,MAAM,KAAK,IAAI;YACf,OAAO,MAAM,KAAK,QAAQ;YAC1B,OAAQ,MAAsC,CAAC,aAAa,KAAK,UAAU,EAC3E,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAC;QAChE,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAuB,EAAE,CAAC;IACtD,CAAC;CACF,CAAC;AAMF,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,OAAe;IACtE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AAC9F,CAAC;AAaD,MAAM,UAAU,SAAS,CAAC,OAAuB;IAC/C,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,cAAc;QAC/B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAuB;IAC7D,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;IAC/C,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAChF,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAuB;IAEvB,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/plugins/persist.d.ts

@@ -0,0 +1,33 @@
+import type { PersistencePort } from "@bluewombat/work-ledger";
+/**
+ * How the ledger is stored. The Port is `@bluewombat/work-ledger`'s; what a
+ * backend package exports to hand one over is fixed here: `openPersist`,
+ * given the directory Host keeps its ledger in. Where inside that directory
+ * the bytes go — one file per key, one SQLite file — is the backend's.
+ */
+export type PersistContext = {
+    /** Absolute. Host's own; the backend writes under it. */
+    ledgerRoot: string;
+};
+export type PersistModule = {
+    openPersist(context: PersistContext): Promise<PersistencePort>;
+};
+export type ResolvePersistResult = {
+    ok: true;
+    module: PersistModule;
+    specifier: string;
+} | {
+    ok: false;
+    reason: string;
+};
+/** Load the persistence backend named by `persist`. */
+export declare function resolvePersistModule(name: string, fromDir: string): Promise<ResolvePersistResult>;
+/** Resolve the backend, then open the Port under `ledgerRoot`. */
+export declare function openPersist(name: string, fromDir: string, ledgerRoot: string): Promise<{
+    ok: true;
+    persist: PersistencePort;
+} | {
+    ok: false;
+    reason: string;
+}>;
+//# sourceMappingURL=persist.d.ts.map

package/dist/plugins/persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.d.ts","sourceRoot":"","sources":["../../src/plugins/persist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG/D;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAChE,CAAC;AAgBF,MAAM,MAAM,oBAAoB,GAC5B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,uDAAuD;AACvD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,CAAC,CAG/B;AAED,kEAAkE;AAClE,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAMjF"}

package/dist/plugins/persist.js

@@ -0,0 +1,26 @@
+import { loadPlugin } from "./load.js";
+const persistShape = {
+    kind: "Persistence backend",
+    check(loaded) {
+        if (loaded === null ||
+            typeof loaded !== "object" ||
+            typeof loaded.openPersist !== "function") {
+            return { ok: false, reason: "does not export openPersist" };
+        }
+        return { ok: true, value: loaded };
+    },
+};
+/** Load the persistence backend named by `persist`. */
+export async function resolvePersistModule(name, fromDir) {
+    const loaded = await loadPlugin(name, fromDir, persistShape);
+    return loaded.ok ? { ok: true, module: loaded.value, specifier: loaded.specifier } : loaded;
+}
+/** Resolve the backend, then open the Port under `ledgerRoot`. */
+export async function openPersist(name, fromDir, ledgerRoot) {
+    const resolved = await resolvePersistModule(name, fromDir);
+    if (!resolved.ok) {
+        return resolved;
+    }
+    return { ok: true, persist: await resolved.module.openPersist({ ledgerRoot }) };
+}
+//# sourceMappingURL=persist.js.map

package/dist/plugins/persist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist.js","sourceRoot":"","sources":["../../src/plugins/persist.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAc,MAAM,WAAW,CAAC;AAiBnD,MAAM,YAAY,GAAyB;IACzC,IAAI,EAAE,qBAAqB;IAC3B,KAAK,CAAC,MAAM;QACV,IACE,MAAM,KAAK,IAAI;YACf,OAAO,MAAM,KAAK,QAAQ;YAC1B,OAAQ,MAAoC,CAAC,WAAW,KAAK,UAAU,EACvE,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,6BAA6B,EAAE,CAAC;QAC9D,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAuB,EAAE,CAAC;IACtD,CAAC;CACF,CAAC;AAMF,uDAAuD;AACvD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAY,EACZ,OAAe;IAEf,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AAC9F,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,OAAe,EACf,UAAkB;IAElB,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;AAClF,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@bluewombat/runtime",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "The mason process: listen, admit, run Conductor, report. Loads one FeatureManager plugin.",
+  "keywords": [
+    "mason",
+    "bluewombat",
+    "cli",
+    "automation"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/tilap/bluewombat/tree/main/packages/host/runtime#readme",
+  "bugs": "https://github.com/tilap/bluewombat/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tilap/bluewombat.git",
+    "directory": "packages/host/runtime"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "mason": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "SPECS.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=24.20.0"
+  },
+  "scripts": {
+    "lint": "biome check .",
+    "format": "biome check --write .",
+    "tsc": "tsc --noEmit",
+    "test": "tsx --test $(find src -name '*.test.ts')",
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "@bluewombat/conductor": "^0.1.0",
+    "@bluewombat/feature-breakdown": "^0.1.0",
+    "@bluewombat/manager-kit": "^0.1.0",
+    "@bluewombat/implementer": "^0.1.0",
+    "@bluewombat/integrator": "^0.1.0",
+    "@bluewombat/isolation-copy": "^0.1.0",
+    "@bluewombat/isolation-git": "^0.1.0",
+    "@bluewombat/isolator": "^0.1.0",
+    "@bluewombat/slots": "^0.1.0",
+    "@bluewombat/work-ledger": "^0.1.0",
+    "@bluewombat/persist-fs": "^0.1.0"
+  },
+  "devDependencies": {
+    "@bluewombat/manager-fake": "^0.1.0",
+    "@bluewombat/manager-github": "^0.1.0",
+    "@bluewombat/persist-sqlite": "^0.1.0"
+  }
+}