@bluewombat/runtime 0.1.0

package/dist/loop/tick.js

@@ -0,0 +1,169 @@
+import { refreshWorkLine } from "./authority.js";
+import { loadCursor, saveCursor } from "./cursor.js";
+import { handleDelivery } from "./deliveries.js";
+import { driveProject } from "./drive.js";
+import { abandonGone } from "./probe.js";
+import { reportMoment } from "./report.js";
+/**
+ * States the sweep will try to drive. `escalated` is frozen for a human;
+ * `received` is the queue that nothing else starts once the tracker goes quiet.
+ */
+const SWEEP_STATES = new Set([
+    "received",
+    "planning",
+    "running",
+    "integrating",
+    "submitted",
+]);
+export async function runOnce(input) {
+    const { options, workLine, ledger, manager, journal, trace, authority } = input;
+    const interruptFlag = options.interruptFlag ?? { interrupted: false };
+    const reported = [];
+    let lastRun;
+    // Projects a delivery already drove this pass. Driving one twice is not
+    // wrong, it just does two steps where the caller asked for one.
+    const driven = new Set();
+    const since = await loadCursor(options.ledgerRoot);
+    const listenInput = {};
+    if (since !== undefined) {
+        listenInput.since = since;
+    }
+    const listened = await manager.listen(listenInput);
+    journal.append({
+        event: "listen",
+        outcome: listened.outcome,
+        deliveries: listened.deliveries.length,
+    });
+    if (listened.deliveries.length > 0) {
+        trace(`listen     ${listened.deliveries.length} to look at`);
+    }
+    const deliveryInput = { ...input, reported };
+    const probed = await abandonGone(deliveryInput, listened.outcome);
+    if (probed === "stop") {
+        return { listenerOutcome: listened.outcome, reported };
+    }
+    // The work line copy is brought up to date before anything is driven on it
+    // — and only then: a pass with nothing to drive fetches nothing. Starting
+    // work on a copy that could not be brought up to date builds on a version
+    // that no longer exists, so a failed refresh drives nothing; the next pass
+    // tries again, and a human can look at that tree meanwhile.
+    const pendingBefore = await pendingWork(ledger);
+    const somethingToDrive = listened.deliveries.length > 0 || pendingBefore.length > 0;
+    if (somethingToDrive && authority !== undefined && workLine.target !== undefined) {
+        const refreshed = refreshWorkLine({
+            workLineStable: workLine.stable,
+            workLineTarget: workLine.target,
+            refreshArgv: options.authority?.refreshArgv ?? [],
+            timeoutMs: options.timeoutMs,
+            env: workLine.env,
+        });
+        if (!refreshed.ok) {
+            journal.append({
+                event: "refresh",
+                outcome: "failed",
+                target: workLine.target,
+                ...(refreshed.detail === undefined ? {} : { detail: refreshed.detail }),
+            });
+            trace(`work line  cannot fast-forward onto ${workLine.target}, so nothing started. ${refreshed.detail ?? ""}`);
+            return { listenerOutcome: "skipped", reported };
+        }
+        journal.append({ event: "refresh", outcome: "ok", target: workLine.target });
+    }
+    // What Conductor says mid-pass is reported as it happens, not after the pass:
+    // a plan, a Subtask landed, a Submission — each is something a person waits for.
+    input.watcher.current = (moment) => reportMoment(deliveryInput, moment);
+    let cursor = since;
+    for (const delivery of listened.deliveries) {
+        if (interruptFlag.interrupted) {
+            break;
+        }
+        const handled = await handleDelivery({
+            ...deliveryInput,
+            payload: delivery.payload,
+        });
+        if (!handled.advance) {
+            break;
+        }
+        if (handled.run !== undefined) {
+            lastRun = handled.run;
+        }
+        if (handled.project !== undefined) {
+            driven.add(handled.project);
+        }
+        cursor = delivery.cursor;
+        await saveCursor(options.ledgerRoot, delivery.cursor);
+    }
+    // A Project with work in flight, or a Feature still `received` behind one,
+    // moves on whether or not the tracker mentioned it again. Nothing else
+    // claims a queue, so a restart with only `received` work would otherwise
+    // sit idle until a delivery that has no reason to come.
+    const pending = await pendingWork(ledger);
+    if (pending.length > 0) {
+        journal.append({
+            event: "sweep",
+            keys: pending.map((summary) => summary.key),
+        });
+    }
+    for (const summary of pending) {
+        if (interruptFlag.interrupted || driven.has(summary.project)) {
+            continue;
+        }
+        driven.add(summary.project);
+        const run = await driveProject(deliveryInput, summary.project, summary.key);
+        if (run !== undefined) {
+            lastRun = run;
+        }
+    }
+    if (listened.deliveries.length === 0 && pending.length === 0) {
+        journal.append({ event: "idle" });
+    }
+    const result = {
+        listenerOutcome: listened.outcome,
+        reported,
+    };
+    if (lastRun !== undefined) {
+        result.lastRun = lastRun;
+    }
+    if (cursor !== undefined) {
+        result.cursor = cursor;
+    }
+    return result;
+}
+export async function run(input) {
+    const { options, conductor, journal } = input;
+    const interruptFlag = options.interruptFlag ?? { interrupted: false };
+    let last = {
+        listenerOutcome: "completed",
+        reported: [],
+    };
+    for (;;) {
+        if (interruptFlag.interrupted) {
+            journal.append({ event: "paused" });
+            conductor.pause();
+            return last;
+        }
+        last = await runOnce(input);
+        if (options.pollIntervalMs === undefined) {
+            return last;
+        }
+        await sleep(options.pollIntervalMs, interruptFlag);
+    }
+}
+async function pendingWork(ledger) {
+    const summaries = await ledger.list();
+    return summaries.filter((summary) => SWEEP_STATES.has(summary.state));
+}
+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=tick.js.map

package/dist/loop/tick.js.map

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

package/dist/loop/trace.d.ts

@@ -0,0 +1,16 @@
+import type { FeatureAggregate } from "@bluewombat/work-ledger";
+/**
+ * What the run says about itself while it works.
+ *
+ * A run can wait minutes on an Attempt and longer on a verdict. With nothing on
+ * stdout there is no way to tell working from wedged, and no way to see which
+ * stage a feature is at without reading the WorkLedger by hand.
+ *
+ * One line per thing that happened, and one per pass over a feature that is
+ * waiting — a repeated line is how a reader knows the loop is still turning.
+ */
+export type Trace = (line: string) => void;
+export declare function openTrace(write: (text: string) => void): Trace;
+/** Where this feature stands, in one line. */
+export declare function describeFeature(aggregate: FeatureAggregate): string;
+//# sourceMappingURL=trace.d.ts.map

package/dist/loop/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/loop/trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;;;GASG;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAE3C,wBAAgB,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,KAAK,CAI9D;AAED,8CAA8C;AAC9C,wBAAgB,eAAe,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAInE"}

package/dist/loop/trace.js

@@ -0,0 +1,49 @@
+export function openTrace(write) {
+    return (line) => {
+        write(`${stamp()} ${line}\n`);
+    };
+}
+/** Where this feature stands, in one line. */
+export function describeFeature(aggregate) {
+    const key = aggregate.intention.key;
+    const state = aggregate.state;
+    return `${key}  ${state.padEnd(11)} ${detailOf(aggregate)}`.trimEnd();
+}
+function detailOf(aggregate) {
+    switch (aggregate.state) {
+        case "submitted":
+            return aggregate.submission === undefined
+                ? ""
+                : `${aggregate.submission.reference}${aggregate.submission.refusals > 0
+                    ? ` (sent back ${aggregate.submission.refusals}x)`
+                    : ""}`;
+        case "done":
+            return aggregate.submission?.reference ?? "";
+        case "escalated":
+            return `${aggregate.escalation?.kind ?? "?"} — waiting for a human`;
+        case "running":
+            return runningDetail(aggregate);
+        case "planning":
+            return "";
+        case "integrating":
+            return `${countIntegrated(aggregate)} subtask(s) folded`;
+        case "invalid":
+            return aggregate.invalid?.reason ?? "";
+        default:
+            return "";
+    }
+}
+function runningDetail(aggregate) {
+    const subtasks = aggregate.plan?.subtasks ?? [];
+    const current = subtasks.find((subtask) => subtask.state === "running");
+    const at = current === undefined ? "" : `subtask ${current.id}, `;
+    return `${at}${countIntegrated(aggregate)}/${subtasks.length} folded, attempt ${aggregate.attempts_used}`;
+}
+function countIntegrated(aggregate) {
+    return (aggregate.plan?.subtasks ?? []).filter((subtask) => subtask.state === "integrated")
+        .length;
+}
+function stamp() {
+    return new Date().toISOString().slice(11, 19);
+}
+//# sourceMappingURL=trace.js.map

package/dist/loop/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/loop/trace.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,SAAS,CAAC,KAA6B;IACrD,OAAO,CAAC,IAAY,EAAE,EAAE;QACtB,KAAK,CAAC,GAAG,KAAK,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC;IAChC,CAAC,CAAC;AACJ,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,eAAe,CAAC,SAA2B;IACzD,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC;IACpC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;IAC9B,OAAO,GAAG,GAAG,KAAK,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;AACxE,CAAC;AAED,SAAS,QAAQ,CAAC,SAA2B;IAC3C,QAAQ,SAAS,CAAC,KAAK,EAAE,CAAC;QACxB,KAAK,WAAW;YACd,OAAO,SAAS,CAAC,UAAU,KAAK,SAAS;gBACvC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,SAAS,GAC/B,SAAS,CAAC,UAAU,CAAC,QAAQ,GAAG,CAAC;oBAC/B,CAAC,CAAC,eAAe,SAAS,CAAC,UAAU,CAAC,QAAQ,IAAI;oBAClD,CAAC,CAAC,EACN,EAAE,CAAC;QACT,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,UAAU,EAAE,SAAS,IAAI,EAAE,CAAC;QAC/C,KAAK,WAAW;YACd,OAAO,GAAG,SAAS,CAAC,UAAU,EAAE,IAAI,IAAI,GAAG,wBAAwB,CAAC;QACtE,KAAK,SAAS;YACZ,OAAO,aAAa,CAAC,SAAS,CAAC,CAAC;QAClC,KAAK,UAAU;YACb,OAAO,EAAE,CAAC;QACZ,KAAK,aAAa;YAChB,OAAO,GAAG,eAAe,CAAC,SAAS,CAAC,oBAAoB,CAAC;QAC3D,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,CAAC;QACzC;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,SAA2B;IAChD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;IAChD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IACxE,MAAM,EAAE,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,OAAO,CAAC,EAAE,IAAI,CAAC;IAClE,OAAO,GAAG,EAAE,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,MAAM,oBAAoB,SAAS,CAAC,aAAa,EAAE,CAAC;AAC5G,CAAC;AAED,SAAS,eAAe,CAAC,SAA2B;IAClD,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,YAAY,CAAC;SACxF,MAAM,CAAC;AACZ,CAAC;AAED,SAAS,KAAK;IACZ,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/loop/transformers.d.ts

@@ -0,0 +1,27 @@
+import type { TransformerPort } from "@bluewombat/conductor";
+import { type FoldBackend } from "@bluewombat/integrator";
+import { type IsolationBackend } from "@bluewombat/isolator";
+import type { AssemblySpec, PassSpec, StageSpec } from "../config/types.js";
+import type { Journal } from "./journal.js";
+import type { Trace } from "./trace.js";
+export type TransformerSlots = {
+    /** Where the Transformers say what they are doing. Absent: nowhere. */
+    trace?: Trace;
+    /** Film of every progress line, including ones the Trace drops. Absent: nowhere. */
+    journal?: Journal;
+    planner: PassSpec;
+    /** Making a Subtask, and the Gates judging what came out of it. */
+    builder: StageSpec;
+    /** Judging the assembled feature, and the command that fixes a refusal. */
+    assembly: AssemblySpec;
+    /** How Isolator produces the Child. Host chooses; Isolator does not sniff. */
+    isolation: IsolationBackend;
+    /** How Integrator folds. Must match `isolation`. */
+    fold: FoldBackend;
+    /** How long any one child outside a Task may run: manager, isolations. */
+    timeoutMs: number;
+    maxUnits: number;
+    maxFeatureBytes: number;
+};
+export declare function createTransformers(slots: TransformerSlots): TransformerPort;
+//# sourceMappingURL=transformers.d.ts.map

package/dist/loop/transformers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformers.d.ts","sourceRoot":"","sources":["../../src/loop/transformers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoC,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO/F,OAAO,EAAE,KAAK,WAAW,EAAiB,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,uEAAuE;IACvE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,oFAAoF;IACpF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,QAAQ,CAAC;IAClB,mEAAmE;IACnE,OAAO,EAAE,SAAS,CAAC;IACnB,2EAA2E;IAC3E,QAAQ,EAAE,YAAY,CAAC;IACvB,8EAA8E;IAC9E,SAAS,EAAE,gBAAgB,CAAC;IAC5B,oDAAoD;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AA8IF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,eAAe,CA8G3E"}

package/dist/loop/transformers.js

@@ -0,0 +1,229 @@
+import { runBreakdown } from "@bluewombat/feature-breakdown";
+import { runImplementer, } from "@bluewombat/implementer";
+import { runIntegrator } from "@bluewombat/integrator";
+import { runIsolator } from "@bluewombat/isolator";
+const DEFAULT_MAX_ATTEMPTS = 3;
+const silent = () => { };
+/**
+ * A Transformer's progress, as a line a person reads.
+ *
+ * Each of them already says what it is doing on its own writer; Host used to
+ * drop all of it, which is why a run of several minutes said nothing at all.
+ * Only the lines that name a phase or an outcome are kept — the rest is
+ * bookkeeping nobody watches.
+ */
+function progressTrace(trace) {
+    if (trace === undefined) {
+        return silent;
+    }
+    return (line) => {
+        // Only the phase labels. Each Transformer also writes a closing line with
+        // the outcome, and that outcome is already the last phase it announced.
+        if (typeof line.label !== "string") {
+            return;
+        }
+        const id = typeof line.id === "string" ? line.id : String(line.task_id ?? "");
+        const label = id.length > 0 ? line.label.replace(`:${id}`, "") : line.label;
+        trace(id.length > 0 ? `  ${id}  ${label}` : `  ${label}`);
+    };
+}
+/**
+ * The journal keeps every progress line; the Trace keeps the ones a person reads.
+ */
+function progressWriter(slots) {
+    const toTrace = progressTrace(slots.trace);
+    const journal = slots.journal;
+    return (line) => {
+        journal?.append({ ...line });
+        toTrace(line);
+    };
+}
+/**
+ * Wire the four execution Transformers into Conductor's Transformer Port.
+ */
+/**
+ * Why an Attempt ended, when it did not end well.
+ *
+ * The first Gate that did not pass is the one that stopped the sequence, so its
+ * report is the reason. With no such Gate, the producer is what failed, and the
+ * detail it left is the reason.
+ */
+/**
+ * What ended this Attempt, and what said so.
+ *
+ * The name matters as much as the words: a report handed on unattributed
+ * reaches the next producer as "something refused this", and the Gate that
+ * looked at the work is exactly what tells it where to look.
+ */
+function reasonOf(trace) {
+    const refused = trace.gates.find((gate) => gate.verdict !== "pass");
+    if (refused !== undefined && refused.report.trim().length > 0) {
+        return { report: refused.report, from: refused.id };
+    }
+    const detail = trace.builder.result.detail;
+    return detail !== undefined && detail.trim().length > 0 ? { report: detail } : undefined;
+}
+/**
+ * Which sequence judges this Task.
+ *
+ * `assembly.gates` judge what was published, so they belong to the pass that
+ * judges — not to the one that makes, whose Gates would still be looking at what
+ * was there before it published anything.
+ *
+ * A making pass is judged like any other making pass, by the Project's own
+ * sequence. Leaving it ungated lets a producer that made nothing pass, republish
+ * the same thing, and be refused again until the budget is gone.
+ */
+function gatesFor(input, slots) {
+    return input.stage === "assembly" && input.produce === false
+        ? slots.assembly.gates
+        : slots.builder.gates;
+}
+/**
+ * How long the agent of this pass may run.
+ *
+ * A Subtask names its producer. An assembly names a fix, and only when something
+ * already refused the whole.
+ */
+function commandTimeoutMs(input, slots) {
+    if (input.stage === "assembly") {
+        return slots.assembly.fix?.timeoutMs ?? slots.timeoutMs;
+    }
+    return slots.builder.producer.timeoutMs;
+}
+function attemptBudget(input, slots) {
+    if (input.produce === false) {
+        return 1;
+    }
+    const stage = input.stage === "assembly" ? slots.assembly : slots.builder;
+    return stage.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+}
+function producersFor(input, slots) {
+    if (input.produce === false) {
+        return undefined;
+    }
+    if (input.stage === "assembly") {
+        const fix = slots.assembly.fix;
+        if (fix === undefined) {
+            return undefined;
+        }
+        // Implementer picks repairArgv only when a report is present, and Conductor
+        // never produces at assembly without one. The fix command is the producer.
+        return { builderArgv: fix.cmd };
+    }
+    const { producer, repair } = slots.builder;
+    return {
+        builderArgv: producer.cmd,
+        repairArgv: repair.cmd,
+        repairTimeoutMs: repair.timeoutMs,
+    };
+}
+export function createTransformers(slots) {
+    const write = progressWriter(slots);
+    return {
+        async isolate(input) {
+            const result = await runIsolator({
+                invocation: {
+                    id: input.id,
+                    parent: input.parent,
+                    child: input.child,
+                    durationMs: input.durationMs,
+                },
+                backend: slots.isolation,
+                write,
+            });
+            return { outcome: result.outcome };
+        },
+        async breakDown(input) {
+            const result = await runBreakdown({
+                invocation: {
+                    maxFeatureBytes: slots.maxFeatureBytes,
+                    maxUnits: slots.maxUnits,
+                    plannerArgv: slots.planner.cmd,
+                    plannerDurationMs: slots.planner.timeoutMs,
+                },
+                featureJson: input.featureJson,
+                write,
+            });
+            if (result.outcome === "planned" && result.plan !== undefined) {
+                return {
+                    outcome: "planned",
+                    plannedAt: result.plan.planned_at,
+                    subtasks: result.plan.subtasks.map((st) => ({
+                        id: st.id,
+                        intention: st.intention,
+                        definition_of_done: st.definition_of_done,
+                        depends_on: [...st.depends_on],
+                    })),
+                };
+            }
+            if (result.outcome === "refused") {
+                return {
+                    outcome: "refused",
+                    code: result.code ?? "not-specifiable",
+                    reason: result.reason ?? "FeatureBreakdown refused the Plan.",
+                };
+            }
+            if (result.outcome === "unavailable" || result.outcome === "interrupted") {
+                return { outcome: result.outcome };
+            }
+            return { outcome: "invalid-invocation" };
+        },
+        async implement(input) {
+            const producers = producersFor(input, slots);
+            const result = await runImplementer({
+                invocation: {
+                    id: input.id,
+                    intention: input.intention,
+                    // Implementer always carries the flag and never reads it; an assembly
+                    // has nothing to put in it, and the roles drop an empty one whole.
+                    definitionOfDone: input.definitionOfDone ?? "",
+                    workspace: input.workspace,
+                    // Without this the report an outside judge sent back never reaches
+                    // the producer, and the Attempt repeats blind.
+                    ...(input.report === undefined ? {} : { report: input.report }),
+                    ...(input.reportFrom === undefined ? {} : { reportFrom: input.reportFrom }),
+                    ...(input.context === undefined ? {} : { context: input.context }),
+                    ...(input.stage === undefined ? {} : { stage: input.stage }),
+                    ...(producers === undefined ? {} : producers),
+                    gates: gatesFor(input, slots),
+                    // A pass that makes nothing cannot make a different result on a second
+                    // try: whoever asked for the judgement owns the retrying.
+                    maxAttempts: attemptBudget(input, slots),
+                    builderTimeoutMs: commandTimeoutMs(input, slots),
+                },
+                write,
+            });
+            return {
+                outcome: result.outcome,
+                traces: result.traces.map((trace) => {
+                    const reason = reasonOf(trace);
+                    if (reason === undefined) {
+                        return { ended: trace.ended };
+                    }
+                    return {
+                        ended: trace.ended,
+                        report: reason.report,
+                        ...(reason.from === undefined ? {} : { refusedBy: reason.from }),
+                    };
+                }),
+            };
+        },
+        async integrate(input) {
+            const result = await runIntegrator({
+                invocation: {
+                    id: input.id,
+                    parent: input.parent,
+                    child: input.child,
+                    durationMs: input.durationMs,
+                    ...(input.subject === undefined ? {} : { subject: input.subject }),
+                    ...(input.mergeSubject === undefined ? {} : { mergeSubject: input.mergeSubject }),
+                },
+                backend: slots.fold,
+                write,
+            });
+            return { outcome: result.outcome };
+        },
+    };
+}
+//# sourceMappingURL=transformers.js.map

package/dist/loop/transformers.js.map

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

package/dist/loop/work-line.d.ts

@@ -0,0 +1,73 @@
+import type { IsolationStrategy, ParsedReference, ReferenceCopyState } from "../plugins/isolation.js";
+export type WorkLineState = {
+    kind: "missing";
+} | {
+    kind: "not-a-directory";
+} | {
+    kind: "plain";
+} | {
+    kind: "git";
+    branch: string;
+};
+/** What is at that path today. Integrator folds by merge only on a git tree. */
+export declare function inspectWorkLine(path: string): WorkLineState;
+export type WorkLineInput = {
+    /** Host's own directory; the copy of a reference lives there unless `stable` says otherwise. */
+    home: string;
+    /** `workLine.stable`, when the operator set it. */
+    stable: string | undefined;
+    /** `workLine.branch`, when the operator set it. */
+    branch: string | undefined;
+    /** The manager's name, for the messages. */
+    manager: string;
+    /** `authority.enabled`. Without one, the work line is the operator's whatever the manager names. */
+    wantsAuthority: boolean;
+    /** What `referenceManager` returned, unread. */
+    reference: Record<string, unknown> | undefined;
+    strategy: IsolationStrategy;
+    strategyName: string;
+};
+/**
+ * Which directory is the work line, and whose it is.
+ *
+ * - `operators`: no reference is named, so `workLine.stable` is a work line
+ *   the operator maintains — the fold lands there and that is final.
+ * - `unchecked`: a reference is named but this strategy cannot read one, so an
+ *   explicit `workLine.stable` is taken on trust, as before any of this.
+ * - `copy`: a reference is named and read. The directory is Host's copy of it,
+ *   whether the operator chose the path or the default did.
+ * - `invalid`: something disagrees, and the run must not start.
+ */
+export type WorkLineResolution = {
+    kind: "operators";
+    stable: string;
+} | {
+    kind: "unchecked";
+    stable: string;
+    reason: string;
+} | {
+    kind: "copy";
+    stable: string;
+    target: string;
+    reference: ParsedReference;
+    state: ReferenceCopyState;
+} | {
+    kind: "invalid";
+    reason: string;
+};
+/** Offline. Everything here reads; `materializeWorkLine` is the one write. */
+export declare function resolveWorkLine(input: WorkLineInput): WorkLineResolution;
+/**
+ * Bring a `copy` resolution to a directory a run can use: fetch a missing one,
+ * refuse a directory that is not a copy of the reference. Network.
+ */
+export declare function materializeWorkLine(resolution: Extract<WorkLineResolution, {
+    kind: "copy";
+}>): Promise<{
+    ok: true;
+    fetched: boolean;
+} | {
+    ok: false;
+    reason: string;
+}>;
+//# sourceMappingURL=work-line.d.ts.map

package/dist/loop/work-line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-line.d.ts","sourceRoot":"","sources":["../../src/loop/work-line.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAW3D;AAgBD,MAAM,MAAM,aAAa,GAAG;IAC1B,gGAAgG;IAChG,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,mDAAmD;IACnD,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,oGAAoG;IACpG,cAAc,EAAE,OAAO,CAAC;IACxB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC/C,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,kBAAkB,CAAC;CAC3B,GACD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,kBAAkB,CAgDxE;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,OAAO,CAAC,kBAAkB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACxD,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBzE"}