@bluewombat/runtime 0.1.0

package/dist/operator/live.js

@@ -0,0 +1,149 @@
+import { closeSync, existsSync, fstatSync, openSync, readSync } from "node:fs";
+import { openWorkLedger } from "@bluewombat/work-ledger";
+import { parseArgs } from "../config/parse-args.js";
+import { journalPath, parseJournalChunk } from "../loop/journal.js";
+import { openPersist } from "../plugins/persist.js";
+import { boardOf, jsonOf } from "./board.js";
+/**
+ * Snapshot the ledger, then optionally follow the journal.
+ *
+ * Does not open Host, a manager, or Conductor. The worker owns those.
+ */
+export async function runLive(input) {
+    const peeled = peelJson(input.argv);
+    const parsed = parseArgs(peeled.rest, { cwd: input.cwd, checkPaths: false });
+    if (!parsed.ok) {
+        input.write(`${parsed.reason}\n`);
+        return 2;
+    }
+    try {
+        const opened = await openPersist(parsed.invocation.persist, parsed.invocation.configDir, parsed.invocation.ledgerRoot);
+        if (!opened.ok) {
+            input.write(`${opened.reason}\n`);
+            return 2;
+        }
+        const ledger = openWorkLedger({ persist: opened.persist });
+        const rows = await boardOf(ledger);
+        if (peeled.json) {
+            input.write(`${JSON.stringify(jsonOf(rows), null, 2)}\n`);
+        }
+        else if (rows.length === 0) {
+            input.write("No Features in the ledger.\n");
+        }
+        else {
+            for (const row of rows) {
+                input.write(`${row.line}\n`);
+            }
+        }
+        if (!input.follow) {
+            return 0;
+        }
+        return await followJournal({
+            path: journalPath(parsed.invocation.ledgerRoot),
+            write: input.write,
+            interruptFlag: input.interruptFlag,
+            pollMs: input.pollMs ?? 250,
+        });
+    }
+    catch (error) {
+        input.write(`${error instanceof Error ? error.message : String(error)}\n`);
+        return 2;
+    }
+}
+function peelJson(argv) {
+    return {
+        json: argv.includes("--json"),
+        rest: argv.filter((token) => token !== "--json"),
+    };
+}
+function formatFilm(line) {
+    const at = typeof line.at === "string" && line.at.length >= 19 ? line.at.slice(11, 19) : "";
+    const event = typeof line.event === "string" ? line.event : "event";
+    const key = typeof line.key === "string" ? line.key : "";
+    const extra = typeof line.label === "string"
+        ? line.label
+        : typeof line.outcome === "string"
+            ? String(line.outcome)
+            : typeof line.state === "string"
+                ? String(line.state)
+                : typeof line.reference === "string"
+                    ? line.reference
+                    : typeof line.behind === "string"
+                        ? line.behind
+                        : "";
+    return [at, event, key, extra].filter((part) => part.length > 0).join("  ");
+}
+async function followJournal(input) {
+    let offset = 0;
+    let remainder = "";
+    let seen = existsSync(input.path);
+    if (seen) {
+        offset = sizeOf(input.path);
+    }
+    else {
+        input.write("Worker has not written a journal yet.\n");
+    }
+    while (!input.interruptFlag.interrupted) {
+        if (!existsSync(input.path)) {
+            await sleep(input.pollMs, input.interruptFlag);
+            continue;
+        }
+        if (!seen) {
+            seen = true;
+            offset = 0;
+            remainder = "";
+        }
+        const read = readFrom(input.path, offset);
+        offset = read.offset;
+        if (read.chunk.length > 0) {
+            const parsed = parseJournalChunk(read.chunk, remainder);
+            remainder = parsed.remainder;
+            for (const line of parsed.lines) {
+                input.write(`${formatFilm(line)}\n`);
+            }
+        }
+        await sleep(input.pollMs, input.interruptFlag);
+    }
+    return 0;
+}
+function sizeOf(path) {
+    const fd = openSync(path, "r");
+    try {
+        return fstatSync(fd).size;
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+function readFrom(path, offset) {
+    const fd = openSync(path, "r");
+    try {
+        const size = fstatSync(fd).size;
+        if (size < offset) {
+            offset = 0;
+        }
+        if (size <= offset) {
+            return { chunk: "", offset };
+        }
+        const buf = Buffer.alloc(size - offset);
+        readSync(fd, buf, 0, buf.length, offset);
+        return { chunk: buf.toString("utf8"), offset: size };
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+function sleep(ms, interruptFlag) {
+    return new Promise((resolve) => {
+        const started = Date.now();
+        const tick = () => {
+            if (interruptFlag.interrupted || Date.now() - started >= ms) {
+                resolve();
+                return;
+            }
+            setTimeout(tick, Math.min(50, ms));
+        };
+        tick();
+    });
+}
+//# sourceMappingURL=live.js.map

package/dist/operator/live.js.map

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

package/dist/operator/prompt.d.ts

@@ -0,0 +1,35 @@
+/** Reads one line. Injected, so the wizard is testable without a terminal. */
+export type Ask = (question: string) => Promise<string>;
+/**
+ * The person stopped answering — Ctrl-C, Ctrl-D, or a pipe that ran dry.
+ * Thrown rather than returned so no caller can mistake it for an empty answer
+ * and ask the same question again.
+ */
+export declare class PromptAbandoned extends Error {
+    constructor();
+}
+export type AskOptions = {
+    fallback?: string;
+    required?: boolean;
+    /** Where a "that answer will not do" hint goes. */
+    write?: (line: string) => void;
+};
+export declare function isInteractive(): boolean;
+/**
+ * A reader over the real terminal. Call `close` when the wizard is done.
+ *
+ * Lines are queued rather than read one `question` at a time: a pipe delivers
+ * every line at once, and anything arriving between two questions would
+ * otherwise be dropped on the floor. Once the input ends — EOF, or Ctrl-C —
+ * every read throws, so the wizard stops on the spot instead of re-asking.
+ */
+export declare function terminalAsk(): {
+    ask: Ask;
+    close: () => void;
+};
+/** `Question (fallback): `, with the fallback used for an empty answer. */
+export declare function askText(ask: Ask, prompt: string, options?: AskOptions): Promise<string>;
+export declare function askYesNo(ask: Ask, prompt: string, fallback: boolean, write?: (line: string) => void): Promise<boolean>;
+/** A numbered list. Returns the chosen index. */
+export declare function askChoice(ask: Ask, write: (line: string) => void, prompt: string, choices: readonly string[]): Promise<number>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/operator/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/operator/prompt.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAExD;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;;CAKzC;AAKD,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,CAAC;AAEF,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAmD7D;AAED,2EAA2E;AAC3E,wBAAsB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBjG;AAED,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC7B,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED,iDAAiD;AACjD,wBAAsB,SAAS,CAC7B,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,MAAM,CAAC,CAajB"}

package/dist/operator/prompt.js

@@ -0,0 +1,125 @@
+import { createInterface } from "node:readline/promises";
+/**
+ * The person stopped answering — Ctrl-C, Ctrl-D, or a pipe that ran dry.
+ * Thrown rather than returned so no caller can mistake it for an empty answer
+ * and ask the same question again.
+ */
+export class PromptAbandoned extends Error {
+    constructor() {
+        super("Cancelled. Nothing written.");
+        this.name = "PromptAbandoned";
+    }
+}
+/** How many times a question is re-asked before giving up on it. */
+const MAX_TRIES = 3;
+export function isInteractive() {
+    return process.stdin.isTTY === true && process.stdout.isTTY === true;
+}
+/**
+ * A reader over the real terminal. Call `close` when the wizard is done.
+ *
+ * Lines are queued rather than read one `question` at a time: a pipe delivers
+ * every line at once, and anything arriving between two questions would
+ * otherwise be dropped on the floor. Once the input ends — EOF, or Ctrl-C —
+ * every read throws, so the wizard stops on the spot instead of re-asking.
+ */
+export function terminalAsk() {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const arrived = [];
+    const waiting = [];
+    let ended = false;
+    const end = () => {
+        ended = true;
+        const pending = waiting.splice(0);
+        // The cursor is sitting after a prompt that will never be answered.
+        if (pending.length > 0) {
+            process.stdout.write("\n");
+        }
+        for (const next of pending) {
+            next(null);
+        }
+    };
+    rl.on("line", (line) => {
+        const next = waiting.shift();
+        if (next === undefined) {
+            arrived.push(line);
+            return;
+        }
+        next(line);
+    });
+    // Without this listener a Ctrl-C at a prompt is swallowed by readline.
+    rl.on("SIGINT", () => {
+        rl.close();
+    });
+    rl.on("close", end);
+    return {
+        ask: async (question) => {
+            const queued = arrived.shift();
+            if (queued !== undefined) {
+                process.stdout.write(question);
+                return queued.trim();
+            }
+            if (ended) {
+                throw new PromptAbandoned();
+            }
+            process.stdout.write(question);
+            const line = await new Promise((resolve) => waiting.push(resolve));
+            if (line === null) {
+                throw new PromptAbandoned();
+            }
+            return line.trim();
+        },
+        close: () => rl.close(),
+    };
+}
+/** `Question (fallback): `, with the fallback used for an empty answer. */
+export async function askText(ask, prompt, options = {}) {
+    const suffix = options.fallback === undefined ? "" : ` (${options.fallback})`;
+    for (let tries = 0; tries < MAX_TRIES; tries += 1) {
+        const answer = await ask(`${prompt}${suffix}: `);
+        if (answer.length > 0) {
+            return answer;
+        }
+        if (options.fallback !== undefined) {
+            return options.fallback;
+        }
+        if (options.required !== true) {
+            return "";
+        }
+        options.write?.("  This one is required.\n");
+    }
+    throw new PromptAbandoned();
+}
+export async function askYesNo(ask, prompt, fallback, write) {
+    const suffix = fallback ? "[Y/n]" : "[y/N]";
+    for (let tries = 0; tries < MAX_TRIES; tries += 1) {
+        const answer = (await ask(`${prompt} ${suffix}: `)).toLowerCase();
+        if (answer.length === 0) {
+            return fallback;
+        }
+        if (answer === "y" || answer === "yes") {
+            return true;
+        }
+        if (answer === "n" || answer === "no") {
+            return false;
+        }
+        write?.("  Answer y or n.\n");
+    }
+    throw new PromptAbandoned();
+}
+/** A numbered list. Returns the chosen index. */
+export async function askChoice(ask, write, prompt, choices) {
+    choices.forEach((choice, index) => {
+        write(`  ${index + 1}) ${choice}\n`);
+    });
+    for (let tries = 0; tries < MAX_TRIES; tries += 1) {
+        const answer = await ask(`${prompt} (1-${choices.length}): `);
+        const picked = Number(answer);
+        if (Number.isInteger(picked) && picked >= 1 && picked <= choices.length) {
+            return picked - 1;
+        }
+        write(`  Pick a number between 1 and ${choices.length}.\n`);
+    }
+    throw new PromptAbandoned();
+}
+//# sourceMappingURL=prompt.js.map

package/dist/operator/prompt.js.map

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

package/dist/operator/setup.d.ts

@@ -0,0 +1,18 @@
+export type SetupInput = {
+    cwd: string;
+    argv: string[];
+    env: Record<string, string | undefined>;
+    write: (line: string) => void;
+    interruptFlag?: {
+        interrupted: boolean;
+    };
+};
+/**
+ * Bring the tracker to the shape a run expects.
+ *
+ * Host knows none of that shape: it resolves the manager, asks it for a plan,
+ * and prints what comes back. Without `--apply` nothing is written — creating
+ * anything on somebody's tracker is asked for, never assumed.
+ */
+export declare function runSetup(input: SetupInput): Promise<number>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/operator/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/operator/setup.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,aAAa,CAAC,EAAE;QAAE,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1C,CAAC;AASF;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAgDjE"}

package/dist/operator/setup.js

@@ -0,0 +1,62 @@
+import { PRODUCT } from "@bluewombat/manager-kit";
+import { parseArgs } from "../config/parse-args.js";
+import { contextOf, loadManagerModule } from "../plugins/manager.js";
+const MARKS = {
+    satisfied: "ok  ",
+    missing: "todo",
+    applied: "done",
+    blocked: "FAIL",
+};
+/**
+ * Bring the tracker to the shape a run expects.
+ *
+ * Host knows none of that shape: it resolves the manager, asks it for a plan,
+ * and prints what comes back. Without `--apply` nothing is written — creating
+ * anything on somebody's tracker is asked for, never assumed.
+ */
+export async function runSetup(input) {
+    const apply = input.argv.includes("--apply");
+    const argv = input.argv.filter((token) => token !== "--apply");
+    const parsed = parseArgs(argv, { cwd: input.cwd, checkPaths: false });
+    if (!parsed.ok) {
+        input.write(`${parsed.reason}\n`);
+        return 2;
+    }
+    const invocation = parsed.invocation;
+    const request = {
+        manager: invocation.manager,
+        managerOptions: invocation.managerOptions,
+        configDir: invocation.configDir,
+        durationMs: invocation.timeoutMs,
+        interruptFlag: input.interruptFlag ?? { interrupted: false },
+        env: input.env,
+    };
+    const loaded = await loadManagerModule(request);
+    if (!loaded.ok) {
+        input.write(`${loaded.reason}\n`);
+        return 2;
+    }
+    if (loaded.module.setupManager === undefined) {
+        input.write(`${invocation.manager} has nothing to set up.\n`);
+        return 0;
+    }
+    const result = await loaded.module.setupManager(contextOf(request), { apply });
+    for (const step of result.steps) {
+        const detail = step.detail === undefined ? "" : ` — ${step.detail}`;
+        input.write(`${MARKS[step.state]}  ${step.summary}${detail}\n`);
+    }
+    const blocked = result.steps.filter((step) => step.state === "blocked").length;
+    if (blocked > 0) {
+        input.write(`\n${blocked} step(s) blocked.\n`);
+        return 1;
+    }
+    const missing = result.steps.filter((step) => step.state === "missing").length;
+    if (missing > 0) {
+        input.write(`\n${missing} step(s) to apply. Run: ${PRODUCT} setup --apply\n`);
+        return 0;
+    }
+    const applied = result.steps.filter((step) => step.state === "applied").length;
+    input.write(applied > 0 ? `\n${applied} step(s) applied.\n` : "\nNothing to do.\n");
+    return 0;
+}
+//# sourceMappingURL=setup.js.map

package/dist/operator/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/operator/setup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAUrE,MAAM,KAAK,GAAuC;IAChD,SAAS,EAAE,MAAM;IACjB,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,MAAM;CAChB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAiB;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAE/D,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IACtE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QAClC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IAErC,MAAM,OAAO,GAAG;QACd,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,cAAc,EAAE,UAAU,CAAC,cAAc;QACzC,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,UAAU,EAAE,UAAU,CAAC,SAAS;QAChC,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE;QAC5D,GAAG,EAAE,KAAK,CAAC,GAAG;KACf,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QAClC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QAC7C,KAAK,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/E,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACpE,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAC/E,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,KAAK,CAAC,KAAK,CAAC,KAAK,OAAO,qBAAqB,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAC/E,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,KAAK,CAAC,KAAK,CAAC,KAAK,OAAO,2BAA2B,OAAO,kBAAkB,CAAC,CAAC;QAC9E,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAC/E,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,qBAAqB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;IACpF,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/plugins/discover.d.ts

@@ -0,0 +1,13 @@
+export type DiscoveredManager = {
+    name: string;
+    description?: string;
+};
+/**
+ * The manager packages installed near `fromDir`.
+ *
+ * Host has no list of trackers and must not grow one: a package is a manager
+ * because it says so in its own keywords, so a third-party one is found the
+ * same way the two shipped here are.
+ */
+export declare function discoverManagers(fromDir: string): DiscoveredManager[];
+//# sourceMappingURL=discover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/plugins/discover.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAuBrE"}

package/dist/plugins/discover.js

@@ -0,0 +1,81 @@
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { PRODUCT } from "@bluewombat/manager-kit";
+/** What a package says about itself to be offered by `mason init`. */
+const MANAGER_KEYWORD = `${PRODUCT}-manager`;
+/**
+ * The manager packages installed near `fromDir`.
+ *
+ * Host has no list of trackers and must not grow one: a package is a manager
+ * because it says so in its own keywords, so a third-party one is found the
+ * same way the two shipped here are.
+ */
+export function discoverManagers(fromDir) {
+    const found = new Map();
+    let dir = resolve(fromDir);
+    for (;;) {
+        const modules = join(dir, "node_modules");
+        if (existsSync(modules)) {
+            for (const entry of safeList(modules)) {
+                if (entry.startsWith("@")) {
+                    for (const scoped of safeList(join(modules, entry))) {
+                        record(found, join(modules, entry, scoped));
+                    }
+                    continue;
+                }
+                record(found, join(modules, entry));
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            break;
+        }
+        dir = parent;
+    }
+    return [...found.values()].sort((left, right) => left.name.localeCompare(right.name));
+}
+function safeList(path) {
+    try {
+        return readdirSync(path);
+    }
+    catch {
+        return [];
+    }
+}
+function record(found, packageRoot) {
+    const manifest = join(packageRoot, "package.json");
+    try {
+        if (!statSync(manifest).isFile()) {
+            return;
+        }
+    }
+    catch {
+        return;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(manifest, "utf8"));
+    }
+    catch {
+        return;
+    }
+    if (parsed === null || typeof parsed !== "object") {
+        return;
+    }
+    const data = parsed;
+    if (typeof data.name !== "string" || !Array.isArray(data.keywords)) {
+        return;
+    }
+    if (!data.keywords.includes(MANAGER_KEYWORD)) {
+        return;
+    }
+    // The nearest copy wins, the way an import would resolve it.
+    if (found.has(data.name)) {
+        return;
+    }
+    found.set(data.name, {
+        name: data.name,
+        ...(typeof data.description === "string" ? { description: data.description } : {}),
+    });
+}
+//# sourceMappingURL=discover.js.map

package/dist/plugins/discover.js.map

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

package/dist/plugins/isolation.d.ts

@@ -0,0 +1,78 @@
+import type { FoldBackend } from "@bluewombat/integrator";
+import type { IsolationBackend } from "@bluewombat/isolator";
+/** What is at a path today, held against the reference it should be a copy of. */
+export type ReferenceCopyState = {
+    kind: "missing";
+} | {
+    kind: "matches";
+} | {
+    kind: "mismatch";
+    reason: string;
+};
+/**
+ * One reference work line, read and understood by the strategy. Every method
+ * is bound to the value `parse` accepted, so nothing loosely typed travels
+ * past that call.
+ */
+export type ParsedReference = {
+    ok: true;
+    /** One line for `mason doctor` and the trace. */
+    summary: string;
+    /** The work line Host offers work to, and the Refresher's `--target`. */
+    target: string;
+    /** Offline. */
+    inspect(path: string): ReferenceCopyState;
+    /** Fetches a copy to `path`. Network. */
+    materialize(path: string): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    /**
+     * What every process that touches the work line must carry — the identity
+     * the system commits under, how it authenticates. Host hands it to the
+     * Publisher and the Refresher; it never puts it in its own environment, so
+     * a Builder does not inherit a credential.
+     */
+    env?: Record<string, string> | undefined;
+};
+/**
+ * How a strategy reads what a manager names as the reference work line. The
+ * words are agreed between the two packages with nothing checking them at
+ * compile time, so `parse` is strict: an unknown key, a missing one, a wrong
+ * type — each stops the run before it writes anything.
+ */
+export type ReferenceBackend = {
+    parse(raw: Record<string, unknown>): ParsedReference | {
+        ok: false;
+        reason: string;
+    };
+};
+export type IsolationStrategy = {
+    isolation: IsolationBackend;
+    fold: FoldBackend;
+    /** Absent: this strategy cannot keep a copy of a reference work line. */
+    reference?: ReferenceBackend;
+    /**
+     * The name this strategy gave the Child isolated under `id` — what a
+     * Publisher is handed as `--ref`. Absent: the id itself is the name.
+     */
+    refOf?: (id: string) => string;
+};
+export type ResolveIsolationResult = {
+    ok: true;
+    strategy: IsolationStrategy;
+    specifier: string;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * 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 declare function resolveIsolationStrategy(name: string, fromDir: string, options?: Record<string, unknown>): Promise<ResolveIsolationResult>;
+//# sourceMappingURL=isolation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"isolation.d.ts","sourceRoot":"","sources":["../../src/plugins/isolation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,kFAAkF;AAClF,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,IAAI,CAAC;IACT,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,eAAe;IACf,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAAC;IAC1C,yCAAyC;IACzC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjF;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC1C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACtF,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,yEAAyE;IACzE,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAC9B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAqDlC;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,sBAAsB,CAAC,CAiBjC"}