@bluewombat/runtime 0.1.0

package/dist/loop/deliveries.js.map

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

package/dist/loop/describe.d.ts

@@ -0,0 +1,40 @@
+import type { PassSpec } from "../config/types.js";
+/**
+ * How a delivered feature describes itself is the Project's decision, not
+ * Host's: a team has conventions, and an agent can read the change and
+ * follow them. The Describer slot is where that lives. Host spawns it once
+ * per feature, in the feature workspace where the whole change is, tells it
+ * what was asked, and takes one JSON line back: `{ subject, body? }`. What
+ * the Authority makes of those words is the manager's business — for GitHub,
+ * the fold's message and the pull request's text. A Subtask is never
+ * described: its fold is folded again into the feature's, and words spent on
+ * it are words wasted.
+ *
+ * A slot that fails — cannot run, answers nothing readable, subject empty —
+ * is not a reason to lose the Submission: the caller keeps the words it had,
+ * and the journal says the slot was skipped.
+ */
+export type DescribeInput = {
+    id: string;
+    /** The issue's title, as the human wrote it. */
+    title: string;
+    /** The issue's body, as the human wrote it. */
+    intention: string;
+    /** The work line the change will land on, so the slot can diff against it. */
+    target: string;
+    /** The feature workspace; the slot may read its diff. */
+    cwd: string;
+};
+export type Description = {
+    subject: string;
+    body?: string;
+};
+export type DescribeAnswer = {
+    ok: true;
+    description: Description;
+} | {
+    ok: false;
+    detail: string;
+};
+export declare function describe(slot: PassSpec, input: DescribeInput): DescribeAnswer;
+//# sourceMappingURL=describe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/loop/describe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,WAAW,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,GAAG,cAAc,CAkC7E"}

package/dist/loop/describe.js

@@ -0,0 +1,48 @@
+import { spawnSync } from "node:child_process";
+export function describe(slot, input) {
+    const [command, ...rest] = slot.cmd;
+    if (command === undefined) {
+        return { ok: false, detail: "the Describer has no command" };
+    }
+    const run = spawnSync(command, [
+        ...rest,
+        "--id",
+        input.id,
+        "--title",
+        input.title,
+        "--intention",
+        input.intention,
+        "--target",
+        input.target,
+    ], { cwd: input.cwd, encoding: "utf8", timeout: slot.timeoutMs });
+    if (run.error !== undefined) {
+        return { ok: false, detail: `Describer could not run: ${run.error.message}` };
+    }
+    const answer = lastJsonLine(run.stdout ?? "");
+    if (answer === undefined) {
+        const detail = `${run.stderr ?? ""}`.trim().slice(-500);
+        return { ok: false, detail: `Describer stdout is not a JSON object. ${detail}`.trim() };
+    }
+    const subject = typeof answer.subject === "string" ? answer.subject.trim() : "";
+    if (subject.length === 0) {
+        return { ok: false, detail: "Describer answered no subject." };
+    }
+    const body = typeof answer.body === "string" ? answer.body.trim() : "";
+    return { ok: true, description: body.length === 0 ? { subject } : { subject, body } };
+}
+function lastJsonLine(stdout) {
+    const lines = stdout.split("\n").filter((line) => line.trim().length > 0);
+    for (let i = lines.length - 1; i >= 0; i--) {
+        try {
+            const parsed = JSON.parse(lines[i] ?? "");
+            if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+                return parsed;
+            }
+        }
+        catch {
+            // not this line
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=describe.js.map

package/dist/loop/describe.js.map

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

package/dist/loop/drive.d.ts

@@ -0,0 +1,15 @@
+import type { ProjectRunResult } from "@bluewombat/conductor";
+import type { HostDeliveryInput } from "./context.js";
+/**
+ * Drive one Project and report on the Feature that actually ran.
+ *
+ * A delivery names a key; `runProject` drives whoever is active on that
+ * Project. Attributing the outcome to the delivered key closed the wrong
+ * issue, or posted an escalation on one that had only been admitted.
+ *
+ * An `escalated` Feature is frozen until a human answers: driving it only
+ * repeats the verdict. The delivered key is journaled as queued, and a
+ * `progress` Event says so once on the tracker.
+ */
+export declare function driveProject(input: HostDeliveryInput, project: string, fallbackKey: string): Promise<ProjectRunResult | undefined>;
+//# sourceMappingURL=drive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drive.d.ts","sourceRoot":"","sources":["../../src/loop/drive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAItD;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CA2BvC"}

package/dist/loop/drive.js

@@ -0,0 +1,42 @@
+import { journalFeature, pushReport, reportAfterRun } from "./report.js";
+import { describeFeature } from "./trace.js";
+/**
+ * Drive one Project and report on the Feature that actually ran.
+ *
+ * A delivery names a key; `runProject` drives whoever is active on that
+ * Project. Attributing the outcome to the delivered key closed the wrong
+ * issue, or posted an escalation on one that had only been admitted.
+ *
+ * An `escalated` Feature is frozen until a human answers: driving it only
+ * repeats the verdict. The delivered key is journaled as queued, and a
+ * `progress` Event says so once on the tracker.
+ */
+export async function driveProject(input, project, fallbackKey) {
+    const held = await input.ledger.activeOn(project);
+    if (held?.state === "escalated") {
+        input.journal.append({ event: "queued", key: fallbackKey, behind: held.key });
+        input.trace(`queued     ${fallbackKey} behind ${held.key} (escalated)`);
+        await pushReport(input, {
+            event: "progress",
+            key: fallbackKey,
+            project,
+            eventId: `${fallbackKey}:queued:${held.key}`,
+            fields: {
+                summary: `Queued behind ${held.key}, which is escalated.`,
+            },
+        });
+        return undefined;
+    }
+    await input.conductor.reconcile(project);
+    const run = await input.conductor.runProject(project);
+    // idle / refused name no Feature; the delivered key is the only one we have.
+    const key = "key" in run && run.key !== undefined ? run.key : fallbackKey;
+    const got = await input.ledger.get(key);
+    if (got.ok) {
+        input.trace(describeFeature(got.aggregate));
+        journalFeature(input.journal, run.outcome, got.aggregate, input.said);
+        await reportAfterRun(input, run, got.aggregate);
+    }
+    return run;
+}
+//# sourceMappingURL=drive.js.map

package/dist/loop/drive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drive.js","sourceRoot":"","sources":["../../src/loop/drive.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAwB,EACxB,OAAe,EACf,WAAmB;IAEnB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,IAAI,EAAE,KAAK,KAAK,WAAW,EAAE,CAAC;QAChC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC9E,KAAK,CAAC,KAAK,CAAC,cAAc,WAAW,WAAW,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC;QACxE,MAAM,UAAU,CAAC,KAAK,EAAE;YACtB,KAAK,EAAE,UAAU;YACjB,GAAG,EAAE,WAAW;YAChB,OAAO;YACP,OAAO,EAAE,GAAG,WAAW,WAAW,IAAI,CAAC,GAAG,EAAE;YAC5C,MAAM,EAAE;gBACN,OAAO,EAAE,iBAAiB,IAAI,CAAC,GAAG,uBAAuB;aAC1D;SACF,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACtD,6EAA6E;IAC7E,MAAM,GAAG,GAAG,KAAK,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC;IAC1E,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;QACX,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QAC5C,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACtE,MAAM,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/loop/journal.d.ts

@@ -0,0 +1,22 @@
+/** Film of a run, next to `cursor` under the ledger root. Not truth. */
+export declare const JOURNAL_FILENAME = "events.jsonl";
+export type Journal = {
+    append(line: Record<string, unknown>): void;
+};
+export declare function journalPath(ledgerRoot: string): string;
+/**
+ * Append-only JSON lines. Host stamps `at`; Transformer fields pass through.
+ *
+ * Sync because a Transformer's ProgressWriter is sync, and the film must land
+ * before the next phase starts or a crash cuts the process off.
+ */
+export declare function openJournalFile(ledgerRoot: string, now?: () => Date): Journal;
+/**
+ * Split a file chunk into complete JSON objects. A truncated last line stays
+ * in `remainder` and is not parsed as a Feature.
+ */
+export declare function parseJournalChunk(chunk: string, remainder: string): {
+    lines: Record<string, unknown>[];
+    remainder: string;
+};
+//# sourceMappingURL=journal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/loop/journal.ts"],"names":[],"mappings":"AAGA,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC7C,CAAC;AAEF,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,IAAuB,GAAG,OAAO,CAS/F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAmBzD"}

package/dist/loop/journal.js

@@ -0,0 +1,49 @@
+import { appendFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+/** Film of a run, next to `cursor` under the ledger root. Not truth. */
+export const JOURNAL_FILENAME = "events.jsonl";
+export function journalPath(ledgerRoot) {
+    return join(ledgerRoot, JOURNAL_FILENAME);
+}
+/**
+ * Append-only JSON lines. Host stamps `at`; Transformer fields pass through.
+ *
+ * Sync because a Transformer's ProgressWriter is sync, and the film must land
+ * before the next phase starts or a crash cuts the process off.
+ */
+export function openJournalFile(ledgerRoot, now = () => new Date()) {
+    mkdirSync(ledgerRoot, { recursive: true });
+    const path = journalPath(ledgerRoot);
+    return {
+        append(line) {
+            const stamped = { ...line, at: now().toISOString() };
+            appendFileSync(path, `${JSON.stringify(stamped)}\n`);
+        },
+    };
+}
+/**
+ * Split a file chunk into complete JSON objects. A truncated last line stays
+ * in `remainder` and is not parsed as a Feature.
+ */
+export function parseJournalChunk(chunk, remainder) {
+    const text = `${remainder}${chunk}`;
+    const parts = text.split("\n");
+    const nextRemainder = parts.pop() ?? "";
+    const lines = [];
+    for (const part of parts) {
+        if (part.trim().length === 0) {
+            continue;
+        }
+        try {
+            const parsed = JSON.parse(part);
+            if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+                lines.push(parsed);
+            }
+        }
+        catch {
+            // Garbage or a split object that gained a newline: skip, do not invent a Feature.
+        }
+    }
+    return { lines, remainder: nextRemainder };
+}
+//# sourceMappingURL=journal.js.map

package/dist/loop/journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.js","sourceRoot":"","sources":["../../src/loop/journal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAM/C,MAAM,UAAU,WAAW,CAAC,UAAkB;IAC5C,OAAO,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB,EAAE,MAAkB,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE;IACpF,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IACrC,OAAO;QACL,MAAM,CAAC,IAAI;YACT,MAAM,OAAO,GAA4B,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;YAC9E,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvD,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAa,EACb,SAAiB;IAEjB,MAAM,IAAI,GAAG,GAAG,SAAS,GAAG,KAAK,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IACxC,MAAM,KAAK,GAA8B,EAAE,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5E,KAAK,CAAC,IAAI,CAAC,MAAiC,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,kFAAkF;QACpF,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;AAC7C,CAAC"}

package/dist/loop/lock.d.ts

@@ -0,0 +1,11 @@
+/**
+ * One `run` or `cancel` per ledger.
+ *
+ * Two processes on the same ledger both listen, both drive, and both report: the
+ * tracker hears everything twice and the feature is folded by whichever got
+ * there first. A lock file names the process that holds the ledger; a second
+ * command refuses to start, unless that process is gone.
+ */
+export declare function lockPath(ledgerRoot: string): string;
+export declare function acquireLock(ledgerRoot: string): Promise<() => Promise<void>>;
+//# sourceMappingURL=lock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/loop/lock.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CA+BlF"}

package/dist/loop/lock.js

@@ -0,0 +1,60 @@
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { PRODUCT } from "@bluewombat/manager-kit";
+/**
+ * One `run` or `cancel` per ledger.
+ *
+ * Two processes on the same ledger both listen, both drive, and both report: the
+ * tracker hears everything twice and the feature is folded by whichever got
+ * there first. A lock file names the process that holds the ledger; a second
+ * command refuses to start, unless that process is gone.
+ */
+export function lockPath(ledgerRoot) {
+    return join(ledgerRoot, "lock");
+}
+export async function acquireLock(ledgerRoot) {
+    await mkdir(ledgerRoot, { recursive: true });
+    const path = lockPath(ledgerRoot);
+    const mine = `${process.pid}\n`;
+    for (;;) {
+        try {
+            await writeFile(path, mine, { flag: "wx" });
+            break;
+        }
+        catch (error) {
+            if (error.code !== "EEXIST") {
+                throw error;
+            }
+        }
+        const holder = Number.parseInt((await readFile(path, "utf8")).trim(), 10);
+        if (holder !== process.pid && isAlive(holder)) {
+            throw new Error(`Another ${PRODUCT} run (pid ${holder}) holds ${ledgerRoot}. Stop it first, or point --home elsewhere.`);
+        }
+        // Ours already, or left behind by a process that is gone.
+        await rm(path, { force: true });
+    }
+    return async () => {
+        try {
+            if ((await readFile(path, "utf8")).trim() === String(process.pid)) {
+                await rm(path, { force: true });
+            }
+        }
+        catch {
+            // Already gone.
+        }
+    };
+}
+function isAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0) {
+        return false;
+    }
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        // EPERM: it exists, and is not ours to signal. Still alive.
+        return error.code === "EPERM";
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/loop/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/loop/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,UAAkB;IACzC,OAAO,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAAkB;IAClD,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;IAChC,SAAS,CAAC;QACR,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,MAAM;QACR,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1E,IAAI,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CACb,WAAW,OAAO,aAAa,MAAM,WAAW,UAAU,6CAA6C,CACxG,CAAC;QACJ,CAAC;QACD,0DAA0D;QAC1D,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,IAAI,EAAE;QAChB,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,GAAW;IAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,4DAA4D;QAC5D,OAAQ,KAA+B,CAAC,IAAI,KAAK,OAAO,CAAC;IAC3D,CAAC;AACH,CAAC"}

package/dist/loop/message.d.ts

@@ -0,0 +1,34 @@
+import type { PassSpec } from "../config/types.js";
+/**
+ * What the feature's commit says — and the pull request with it — is the
+ * Project's decision, not Host's: a team has conventions, and an agent can
+ * read the diff and follow them. The Message slot is where that lives. Host
+ * spawns it once per feature, in the feature workspace where the whole diff
+ * is, tells it what was asked, and takes one JSON line back:
+ * `{ subject, body? }`. Subtask commits are never asked about: they are
+ * squashed away, and words spent on them are words wasted.
+ *
+ * A slot that fails — cannot run, answers nothing readable, subject empty —
+ * is not a reason to lose the fold: the caller keeps the message it would
+ * have written anyway, and the journal says the slot was skipped.
+ */
+export type MessageInput = {
+    id: string;
+    /** The issue's title, as the human wrote it. */
+    title: string;
+    /** The issue's body, as the human wrote it. */
+    intention: string;
+    /** The work line the change will land on, so the slot can diff against it. */
+    target: string;
+    /** The feature workspace; the slot may read its diff. */
+    cwd: string;
+};
+export type MessageAnswer = {
+    ok: true;
+    message: string;
+} | {
+    ok: false;
+    detail: string;
+};
+export declare function askMessage(slot: PassSpec, input: MessageInput): MessageAnswer;
+//# sourceMappingURL=message.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/loop/message.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1F,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,GAAG,aAAa,CAkC7E"}

package/dist/loop/message.js

@@ -0,0 +1,48 @@
+import { spawnSync } from "node:child_process";
+export function askMessage(slot, input) {
+    const [command, ...rest] = slot.cmd;
+    if (command === undefined) {
+        return { ok: false, detail: "the Message slot has no command" };
+    }
+    const run = spawnSync(command, [
+        ...rest,
+        "--id",
+        input.id,
+        "--title",
+        input.title,
+        "--intention",
+        input.intention,
+        "--target",
+        input.target,
+    ], { cwd: input.cwd, encoding: "utf8", timeout: slot.timeoutMs });
+    if (run.error !== undefined) {
+        return { ok: false, detail: `Message slot could not run: ${run.error.message}` };
+    }
+    const answer = lastJsonLine(run.stdout ?? "");
+    if (answer === undefined) {
+        const detail = `${run.stderr ?? ""}`.trim().slice(-500);
+        return { ok: false, detail: `Message slot stdout is not a JSON object. ${detail}`.trim() };
+    }
+    const subject = typeof answer.subject === "string" ? answer.subject.trim() : "";
+    if (subject.length === 0) {
+        return { ok: false, detail: "Message slot answered no subject." };
+    }
+    const body = typeof answer.body === "string" ? answer.body.trim() : "";
+    return { ok: true, message: body.length === 0 ? subject : `${subject}\n\n${body}` };
+}
+function lastJsonLine(stdout) {
+    const lines = stdout.split("\n").filter((line) => line.trim().length > 0);
+    for (let i = lines.length - 1; i >= 0; i--) {
+        try {
+            const parsed = JSON.parse(lines[i] ?? "");
+            if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+                return parsed;
+            }
+        }
+        catch {
+            // not this line
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=message.js.map

package/dist/loop/message.js.map

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

package/dist/loop/open-host.d.ts

@@ -0,0 +1,13 @@
+import type { HostOptions } from "../config/types.js";
+import { type Journal } from "./journal.js";
+import { type Host } from "./tick.js";
+export type { HostOptions } from "../config/types.js";
+export type { CancelResult } from "./deliveries.js";
+export type { Host, HostTickResult } from "./tick.js";
+/** What a caller may hand `openHost` that is not configuration: a test's film. */
+export type OpenHostDeps = {
+    /** Film next to the ledger. Defaults to `<ledgerRoot>/events.jsonl`. */
+    journal?: Journal;
+};
+export declare function openHost(options: HostOptions, deps?: OpenHostDeps): Promise<Host>;
+//# sourceMappingURL=open-host.d.ts.map

package/dist/loop/open-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-host.d.ts","sourceRoot":"","sources":["../../src/loop/open-host.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOtD,OAAO,EAAE,KAAK,OAAO,EAAmB,MAAM,cAAc,CAAC;AAE7D,OAAO,EAAE,KAAK,IAAI,EAAgB,MAAM,WAAW,CAAC;AAKpD,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKtD,kFAAkF;AAClF,MAAM,MAAM,YAAY,GAAG;IACzB,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,wBAAsB,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmL3F"}

package/dist/loop/open-host.js

@@ -0,0 +1,180 @@
+import { mkdir } from "node:fs/promises";
+import { openConductor } from "@bluewombat/conductor";
+import { openWorkLedger } from "@bluewombat/work-ledger";
+import { DEFAULT_PERSIST } from "../config/defaults.js";
+import { homeOf } from "../config/home.js";
+import { resolveIsolationStrategy } from "../plugins/isolation.js";
+import { contextOf, loadManagerModule } from "../plugins/manager.js";
+import { resolvePersistModule } from "../plugins/persist.js";
+import { openAuthority } from "./authority.js";
+import { cancelFeature } from "./deliveries.js";
+import { openJournalFile } from "./journal.js";
+import { acquireLock } from "./lock.js";
+import { run, runOnce } from "./tick.js";
+import { openTrace } from "./trace.js";
+import { createTransformers } from "./transformers.js";
+import { inspectWorkLine, materializeWorkLine, resolveWorkLine } from "./work-line.js";
+const DEFAULT_MAX_UNITS = 10;
+const DEFAULT_MAX_FEATURE_BYTES = 65_536;
+export async function openHost(options, deps = {}) {
+    const configDir = options.configDir ?? process.cwd();
+    const home = homeOf(configDir, options.home);
+    const interruptFlag = options.interruptFlag ?? { interrupted: false };
+    const trace = openTrace(options.write ??
+        ((text) => {
+            process.stdout.write(text);
+        }));
+    const resolved = await resolveIsolationStrategy(options.workLineIsolation, configDir, options.workLineIsolationOptions);
+    if (!resolved.ok) {
+        throw new Error(resolved.reason);
+    }
+    const persistName = options.persist ?? DEFAULT_PERSIST;
+    const backend = await resolvePersistModule(persistName, configDir);
+    if (!backend.ok) {
+        throw new Error(backend.reason);
+    }
+    const request = {
+        manager: options.manager,
+        managerOptions: options.managerOptions ?? {},
+        configDir,
+        durationMs: options.timeoutMs,
+        interruptFlag,
+        env: options.env ?? process.env,
+    };
+    const loaded = await loadManagerModule(request);
+    if (!loaded.ok) {
+        throw new Error(loaded.reason);
+    }
+    const managerName = typeof options.manager === "string" ? options.manager : "the manager";
+    // Whose directory the work line is, settled before anything is written. A
+    // reference the manager names is read by the strategy — strictly, since the
+    // two agree on words nothing checks at compile time — and Host's copy of it
+    // is fetched here, so a wrong key or an unreachable remote stops the run
+    // now rather than in the middle of one.
+    const workLine = resolveWorkLine({
+        home,
+        stable: options.workLineStable,
+        branch: options.workLineBranch,
+        manager: managerName,
+        wantsAuthority: options.authority?.enabled === true,
+        reference: loaded.module.referenceManager?.(contextOf(request)),
+        strategy: resolved.strategy,
+        strategyName: resolved.specifier,
+    });
+    if (workLine.kind === "invalid") {
+        throw new Error(workLine.reason);
+    }
+    if (workLine.kind === "copy") {
+        const made = await materializeWorkLine(workLine);
+        if (!made.ok) {
+            throw new Error(made.reason);
+        }
+        if (made.fetched) {
+            trace(`work line  copied ${workLine.reference.summary} to ${workLine.stable}`);
+        }
+    }
+    const stable = workLine.stable;
+    // The reference's git environment: who the system is on the work line. Only
+    // the slots that touch the work line get it; nothing else inherits it.
+    const workLineEnv = workLine.kind === "copy" ? workLine.reference.env : undefined;
+    const target = workLine.kind === "copy" ? workLine.target : options.workLineBranch;
+    // Which work line a fold lands on is a decision, not an accident of what was
+    // left checked out. Refuse before anything is written rather than fold onto
+    // a branch nobody chose. (A copy was already held against its reference.)
+    if (workLine.kind !== "copy" && target !== undefined) {
+        const state = inspectWorkLine(stable);
+        if (state.kind === "git" && state.branch !== target) {
+            throw new Error(`WorkLineStable is on "${state.branch}", but the config wants "${target}". Switch it, or change workLine.branch.`);
+        }
+    }
+    await mkdir(options.workspaceRoot, { recursive: true });
+    const release = await acquireLock(options.ledgerRoot);
+    const persist = await backend.module.openPersist({ ledgerRoot: options.ledgerRoot });
+    const ledger = openWorkLedger({ persist });
+    const journal = deps.journal ?? openJournalFile(options.ledgerRoot);
+    const transformers = createTransformers({
+        trace,
+        journal,
+        planner: options.planner,
+        builder: options.builder,
+        assembly: options.assembly,
+        isolation: resolved.strategy.isolation,
+        fold: resolved.strategy.fold,
+        timeoutMs: options.timeoutMs,
+        maxUnits: DEFAULT_MAX_UNITS,
+        maxFeatureBytes: DEFAULT_MAX_FEATURE_BYTES,
+    });
+    const hostOptions = { ...options, interruptFlag };
+    const created = await loaded.module.createManager(contextOf(request));
+    if (!created.ok) {
+        throw new Error(created.reason);
+    }
+    const manager = created.manager;
+    // Declared, never inferred: a Project has an Authority because it says so,
+    // not because a directory happens to look a certain way. Disabled, the
+    // assembled feature is folded into WorkLineStable and that fold is final.
+    const wantsAuthority = options.authority?.enabled === true;
+    if (wantsAuthority && target === undefined) {
+        throw new Error('authority.enabled is true, but "workLine.branch" does not say which work line the work is offered to.');
+    }
+    const authority = wantsAuthority && options.authority !== undefined && target !== undefined
+        ? openAuthority({
+            manager,
+            workLineStable: stable,
+            workLineTarget: target,
+            publishArgv: options.authority.publishArgv,
+            timeoutMs: options.timeoutMs,
+            refOf: resolved.strategy.refOf ?? ((id) => id),
+            env: workLineEnv,
+            describe: options.authority.describeArgv === undefined
+                ? undefined
+                : { cmd: options.authority.describeArgv, timeoutMs: options.timeoutMs },
+            workspaceRoot: options.workspaceRoot,
+            journal,
+        })
+        : undefined;
+    // Asking for an Authority from a manager that has none is a configuration
+    // mistake, not a reason to quietly fold locally instead.
+    if (wantsAuthority && authority === undefined) {
+        throw new Error(`${managerName} declares no Submission, so it cannot be an Authority. Set "authority.enabled" to false, or name a manager that submits and folds.`);
+    }
+    // Conductor says what happens mid-pass; the tick that is running decides what
+    // to do with it (report it), so the hook is a slot the tick fills.
+    const watcher = {};
+    const conductor = openConductor({
+        ledger,
+        transformers,
+        workLineStable: stable,
+        workspaceRoot: options.workspaceRoot,
+        transformerDurationMs: options.timeoutMs,
+        observe: (moment) => watcher.current?.(moment),
+        ...(authority === undefined ? {} : { authority }),
+        ...(target === undefined ? {} : { workLineTarget: target }),
+        ...(options.maxRefusals === undefined ? {} : { maxRefusals: options.maxRefusals }),
+    });
+    const ctx = {
+        options: hostOptions,
+        workLine: {
+            stable,
+            ...(target === undefined ? {} : { target }),
+            ...(workLineEnv === undefined ? {} : { env: workLineEnv }),
+        },
+        ledger,
+        conductor,
+        manager,
+        journal,
+        trace,
+        watcher,
+        said: new Set(),
+        ...(authority === undefined ? {} : { authority }),
+    };
+    return {
+        ledger,
+        conductor,
+        runOnce: () => runOnce(ctx),
+        run: () => run(ctx),
+        cancel: (key) => cancelFeature(ctx, key),
+        close: release,
+    };
+}
+//# sourceMappingURL=open-host.js.map