@bluewombat/runtime 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+export { CONFIG_FILENAME, findConfig } from "./config/find-config.js";
+export type { ParseInput, ParseResult } from "./config/parse-args.js";
+export { parseArgs } from "./config/parse-args.js";
+export type { HostInvocation, HostOptions } from "./config/types.js";
+export type { CancelResult, Host, HostTickResult, OpenHostDeps } from "./loop/open-host.js";
+export { openHost } from "./loop/open-host.js";
+export type { TransformerSlots } from "./loop/transformers.js";
+export { createTransformers } from "./loop/transformers.js";
+export type { WorkLineState } from "./loop/work-line.js";
+export { inspectWorkLine } from "./loop/work-line.js";
+export type { CancelInput } from "./operator/cancel.js";
+export { runCancel } from "./operator/cancel.js";
+export type { DoctorInput } from "./operator/doctor.js";
+export { runDoctor } from "./operator/doctor.js";
+export { cloneWorkLine, remoteBranches } from "./operator/git-remote.js";
+export type { InitInput, InitResult } from "./operator/init.js";
+export { runInit } from "./operator/init.js";
+export type { LiveInput } from "./operator/live.js";
+export { runLive } from "./operator/live.js";
+export type { Ask } from "./operator/prompt.js";
+export { isInteractive, terminalAsk } from "./operator/prompt.js";
+export type { SetupInput } from "./operator/setup.js";
+export { runSetup } from "./operator/setup.js";
+export type { DiscoveredManager } from "./plugins/discover.js";
+export { discoverManagers } from "./plugins/discover.js";
+export type { ResolveIsolationResult } from "./plugins/isolation.js";
+export { resolveIsolationStrategy } from "./plugins/isolation.js";
+export type { LoadedModule, ManagerRequest, ResolveResult } from "./plugins/manager.js";
+export { loadManagerModule, openManager, resolveManagerModule } from "./plugins/manager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACzE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,YAAY,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAClE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+export { CONFIG_FILENAME, findConfig } from "./config/find-config.js";
+export { parseArgs } from "./config/parse-args.js";
+export { openHost } from "./loop/open-host.js";
+export { createTransformers } from "./loop/transformers.js";
+export { inspectWorkLine } from "./loop/work-line.js";
+export { runCancel } from "./operator/cancel.js";
+export { runDoctor } from "./operator/doctor.js";
+export { cloneWorkLine, remoteBranches } from "./operator/git-remote.js";
+export { runInit } from "./operator/init.js";
+export { runLive } from "./operator/live.js";
+export { isInteractive, terminalAsk } from "./operator/prompt.js";
+export { runSetup } from "./operator/setup.js";
+export { discoverManagers } from "./plugins/discover.js";
+export { resolveIsolationStrategy } from "./plugins/isolation.js";
+export { loadManagerModule, openManager, resolveManagerModule } from "./plugins/manager.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/loop/authority.d.ts

@@ -0,0 +1,51 @@
+import type { AuthorityPort } from "@bluewombat/conductor";
+import type { ManagerPort } from "@bluewombat/manager-kit";
+import type { PassSpec } from "../config/types.js";
+import type { Journal } from "./journal.js";
+/**
+ * The Authority, as Host wires it.
+ *
+ * Two halves that do not belong to the same world: publishing the work is an
+ * operation on a directory Host owns, and offering it to the outside belongs to
+ * the FeatureManager. Host runs the first as a slot it never reads into, then
+ * hands the second the name that slot published under. Neither of them judges:
+ * that is a Gate.
+ *
+ * The Publisher is a slot for the same reason the Builder is one: `git push` is
+ * one way to put work in front of a judge, not the only one, and a Project that
+ * places its work some other way changes that command and nothing else.
+ */
+export declare function openAuthority(input: {
+    manager: ManagerPort;
+    workLineStable: string;
+    workLineTarget: string;
+    publishArgv: string[];
+    timeoutMs: number;
+    /** The isolation strategy's name for a Child, from its id. */
+    refOf: (id: string) => string;
+    /** The work line's git environment (identity, credentials), for the Publisher. */
+    env?: Record<string, string> | undefined;
+    /** How the work describes itself, when the Project has a slot for it. */
+    describe?: PassSpec | undefined;
+    workspaceRoot?: string | undefined;
+    journal?: Journal | undefined;
+}): AuthorityPort | undefined;
+/**
+ * Bring the work line copy up to what the Authority holds, through the slot the
+ * Project named.
+ *
+ * The other half of the same seam as the Publisher: one puts the work where the
+ * judge reads, the other reads back what the judge accepted. `git fetch` is one
+ * way to do that, not the only one, so neither belongs in Host.
+ */
+export declare function refreshWorkLine(input: {
+    workLineStable: string;
+    workLineTarget: string;
+    refreshArgv: string[];
+    timeoutMs: number;
+    env?: Record<string, string> | undefined;
+}): {
+    ok: boolean;
+    detail?: string;
+};
+//# sourceMappingURL=authority.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"authority.d.ts","sourceRoot":"","sources":["../../src/loop/authority.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,yBAAyB,CAAC;AAC9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,OAAO,EAAE,WAAW,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9B,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACzC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B,GAAG,aAAa,GAAG,SAAS,CAyD5B;AA2ED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC1C,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAwBnC"}

package/dist/loop/authority.js

@@ -0,0 +1,166 @@
+import { spawnSync } from "node:child_process";
+import { featureWorkspacePath, subjectOf } from "@bluewombat/conductor";
+import { describe } from "./describe.js";
+/**
+ * The Authority, as Host wires it.
+ *
+ * Two halves that do not belong to the same world: publishing the work is an
+ * operation on a directory Host owns, and offering it to the outside belongs to
+ * the FeatureManager. Host runs the first as a slot it never reads into, then
+ * hands the second the name that slot published under. Neither of them judges:
+ * that is a Gate.
+ *
+ * The Publisher is a slot for the same reason the Builder is one: `git push` is
+ * one way to put work in front of a judge, not the only one, and a Project that
+ * places its work some other way changes that command and nothing else.
+ */
+export function openAuthority(input) {
+    const { manager, workLineStable, workLineTarget, publishArgv, timeoutMs, refOf } = input;
+    if (manager.submit === undefined || manager.fold === undefined) {
+        return undefined;
+    }
+    const submit = manager.submit.bind(manager);
+    const fold = manager.fold.bind(manager);
+    return {
+        async submit(offer) {
+            // The name the strategy gave this feature's Child. What the Publisher
+            // does with it — push it, copy it, upload it — is the Publisher's business.
+            const ref = refOf(offer.ref);
+            const published = publish({
+                argv: publishArgv,
+                cwd: workLineStable,
+                id: offer.key,
+                ref,
+                target: workLineTarget,
+                timeoutMs,
+                env: input.env,
+            });
+            if (!published.ok) {
+                return { outcome: "refused", reason: published.reason };
+            }
+            // The Project's own words for what it submits, when it has a slot for
+            // them; the Authority puts them where its kind of Submission is read.
+            // Asked in the feature workspace, where the whole change is.
+            let description;
+            if (input.describe !== undefined && input.workspaceRoot !== undefined) {
+                const asked = describe(input.describe, {
+                    id: offer.key,
+                    title: offer.title ?? offer.key,
+                    intention: offer.intention ?? "",
+                    target: workLineTarget,
+                    cwd: featureWorkspacePath(input.workspaceRoot, offer.key),
+                });
+                if (asked.ok) {
+                    description = asked.description;
+                }
+                else {
+                    input.journal?.append({ event: "describe-skipped", id: offer.key, detail: asked.detail });
+                }
+            }
+            return await submit({
+                ...offer,
+                ref: published.ref,
+                target: workLineTarget,
+                // What the Submission lists as its work: one line per Subtask, the way
+                // the plan was said on the tracker, not the whole intentions.
+                ...(offer.steps === undefined ? {} : { steps: offer.steps.map(subjectOf) }),
+                ...(description === undefined ? {} : { description }),
+            });
+        },
+        async fold(asked) {
+            return await fold(asked);
+        },
+    };
+}
+/**
+ * Run the Publisher slot in the work line and read the one line it answers.
+ *
+ * Same contract as every other slot: argv in, one JSON object on stdout. A slot
+ * that cannot run at all is a refusal like any other here — the Submission does
+ * not happen, the reason reaches the tracker, and the next pass tries again.
+ */
+function publish(input) {
+    const [command, ...rest] = input.argv;
+    if (command === undefined) {
+        return { ok: false, reason: "No Publisher is configured, so nothing can be submitted." };
+    }
+    const run = spawnSync(command, [...rest, "--id", input.id, "--ref", input.ref, "--target", input.target], {
+        cwd: input.cwd,
+        encoding: "utf8",
+        timeout: input.timeoutMs,
+        env: { ...process.env, ...input.env },
+    });
+    if (run.error !== undefined) {
+        return { ok: false, reason: `Publisher could not run: ${run.error.message}` };
+    }
+    const answer = lastJsonLine(run.stdout ?? "");
+    if (answer === undefined) {
+        const detail = `${run.stderr ?? ""}`.trim().slice(-1000);
+        return {
+            ok: false,
+            reason: `Publisher stdout is not a JSON object.${detail.length > 0 ? ` ${detail}` : ""}`,
+        };
+    }
+    if (typeof answer.ref === "string" && answer.ref.length > 0) {
+        return { ok: true, ref: answer.ref };
+    }
+    if (answer.outcome === "refused") {
+        const reason = typeof answer.reason === "string" ? answer.reason : "no reason given";
+        return { ok: false, reason };
+    }
+    return { ok: false, reason: "Publisher answered neither a reference nor a refusal." };
+}
+function lastJsonLine(stdout) {
+    const lines = stdout.trim().split("\n");
+    for (let i = lines.length - 1; i >= 0; i -= 1) {
+        const line = lines[i]?.trim();
+        if (line === undefined || line.length === 0) {
+            continue;
+        }
+        try {
+            const parsed = JSON.parse(line);
+            if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+                return parsed;
+            }
+        }
+        catch {
+            // Not the contract line. A slot may write anything else to stderr, but
+            // stdout noise is its own bug — keep looking for a line that parses.
+        }
+    }
+    return undefined;
+}
+/**
+ * Bring the work line copy up to what the Authority holds, through the slot the
+ * Project named.
+ *
+ * The other half of the same seam as the Publisher: one puts the work where the
+ * judge reads, the other reads back what the judge accepted. `git fetch` is one
+ * way to do that, not the only one, so neither belongs in Host.
+ */
+export function refreshWorkLine(input) {
+    const [command, ...rest] = input.refreshArgv;
+    if (command === undefined) {
+        return { ok: false, detail: "No Refresher is configured." };
+    }
+    const run = spawnSync(command, [...rest, "--target", input.workLineTarget], {
+        cwd: input.workLineStable,
+        encoding: "utf8",
+        timeout: input.timeoutMs,
+        env: { ...process.env, ...input.env },
+    });
+    if (run.error !== undefined) {
+        return { ok: false, detail: `Refresher 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: `Refresher stdout is not a JSON object. ${detail}`.trim() };
+    }
+    if (answer.ok === true) {
+        return { ok: true };
+    }
+    const reason = typeof answer.reason === "string" ? answer.reason : "no reason given";
+    return { ok: false, detail: reason };
+}
+//# sourceMappingURL=authority.js.map

package/dist/loop/authority.js.map

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

package/dist/loop/context.d.ts

@@ -0,0 +1,44 @@
+import type { AuthorityPort, Conductor, ConductorMoment } from "@bluewombat/conductor";
+import type { EventName, ManagerPort } from "@bluewombat/manager-kit";
+import type { WorkLedger } from "@bluewombat/work-ledger";
+import type { HostOptions } from "../config/types.js";
+import type { Journal } from "./journal.js";
+import type { Trace } from "./trace.js";
+/**
+ * What one Host tick needs after composition. Shared so tick, deliveries and
+ * report do not import the factory.
+ */
+export type HostRunInput = {
+    options: HostOptions;
+    /** The work line as resolved at boot: the directory, and the name work is offered to. */
+    workLine: {
+        stable: string;
+        target?: string;
+        env?: Record<string, string> | undefined;
+    };
+    ledger: WorkLedger;
+    conductor: Conductor;
+    manager: ManagerPort;
+    journal: Journal;
+    trace: Trace;
+    /** Present when the Project declared an Authority and the manager can submit. */
+    authority?: AuthorityPort;
+    /**
+     * Where Conductor's moments land during a pass. A tick points it at its own
+     * report function before driving, so what is said mid-pass counts as that
+     * tick's Events; between ticks nobody listens.
+     */
+    watcher: {
+        current?: ((moment: ConductorMoment) => Promise<void>) | undefined;
+    };
+    /**
+     * Event ids this process already reported. A fact said once is not said
+     * again by this process; the manager's own memory covers a restart.
+     */
+    said: Set<string>;
+};
+/** One Delivery (or sweep) within a tick: the run input plus Events collected so far. */
+export type HostDeliveryInput = HostRunInput & {
+    reported: EventName[];
+};
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/loop/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,WAAW,CAAC;IACrB,yFAAyF;IACzF,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;KAAE,CAAC;IACxF,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;IACb,iFAAiF;IACjF,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B;;;;OAIG;IACH,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAA;KAAE,CAAC;IAChF;;;OAGG;IACH,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACnB,CAAC;AAEF,yFAAyF;AACzF,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG;IAC7C,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB,CAAC"}

package/dist/loop/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/loop/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/loop/context.ts"],"names":[],"mappings":""}

package/dist/loop/cursor.d.ts

@@ -0,0 +1,4 @@
+export declare function cursorPath(ledgerRoot: string): string;
+export declare function loadCursor(ledgerRoot: string): Promise<string | undefined>;
+export declare function saveCursor(ledgerRoot: string, cursor: string): Promise<void>;
+//# sourceMappingURL=cursor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/loop/cursor.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAOhF;AAED,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlF"}

package/dist/loop/cursor.js

@@ -0,0 +1,20 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+export function cursorPath(ledgerRoot) {
+    return join(ledgerRoot, "cursor");
+}
+export async function loadCursor(ledgerRoot) {
+    try {
+        const text = (await readFile(cursorPath(ledgerRoot), "utf8")).trim();
+        return text.length > 0 ? text : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function saveCursor(ledgerRoot, cursor) {
+    const path = cursorPath(ledgerRoot);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, `${cursor}\n`, "utf8");
+}
+//# sourceMappingURL=cursor.js.map

package/dist/loop/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/loop/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,UAAU,UAAU,CAAC,UAAkB;IAC3C,OAAO,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB;IACjD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrE,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB,EAAE,MAAc;IACjE,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACpC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,MAAM,IAAI,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC"}

package/dist/loop/deliveries.d.ts

@@ -0,0 +1,22 @@
+import type { ProjectRunResult } from "@bluewombat/conductor";
+import type { HostDeliveryInput, HostRunInput } from "./context.js";
+export declare function handleDelivery(input: HostDeliveryInput & {
+    payload: Record<string, unknown>;
+}): Promise<{
+    advance: boolean;
+    run?: ProjectRunResult;
+    project?: string;
+}>;
+export declare function handleCancel(feature: {
+    key: string;
+    project: string;
+}, input: HostDeliveryInput): Promise<void>;
+export type CancelResult = {
+    ok: true;
+} | {
+    ok: false;
+    code: "not-found" | "point-of-no-return" | "already-cancelled" | "done";
+};
+/** Abandon one Feature by key — the same path a `cancel` delivery takes. */
+export declare function cancelFeature(input: HostRunInput, key: string): Promise<CancelResult>;
+//# sourceMappingURL=deliveries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deliveries.d.ts","sourceRoot":"","sources":["../../src/loop/deliveries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAqBpE,wBAAsB,cAAc,CAClC,KAAK,EAAE,iBAAiB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC9D,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8DzE;AAuFD,wBAAsB,YAAY,CAChC,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EACzC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,IAAI,CAAC,CAuCf;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IACE,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,WAAW,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,MAAM,CAAC;CACzE,CAAC;AAEN,4EAA4E;AAC5E,wBAAsB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAkB3F"}

package/dist/loop/deliveries.js

@@ -0,0 +1,240 @@
+import { driveProject } from "./drive.js";
+import { pushReport, resumePointOf } from "./report.js";
+/**
+ * An upsert leaves Features that ready / cancel / too-late already own.
+ * SPECS §6: leave in-flight / terminal (including submitted); do not restart.
+ * The ledger still records a *new* fingerprint as pending_fingerprint; Host
+ * does not admit here, so an echo of Submitted cannot look like one.
+ */
+const IN_FLIGHT_OR_TERMINAL = new Set([
+    "planning",
+    "running",
+    "escalated",
+    "integrating",
+    "submitted",
+    "merging",
+    "done",
+    "cancelled",
+]);
+export async function handleDelivery(input) {
+    const adapted = await input.manager.adapt(input.payload);
+    switch (adapted.outcome) {
+        case "unavailable":
+        case "interrupted":
+            return { advance: false };
+        case "invalid": {
+            // Telling the tracker writes to it, and that write delivers the same
+            // intention again. What a human wrote has not changed: said once.
+            const before = await input.ledger.get(adapted.key);
+            if (before.ok &&
+                before.aggregate.state === "invalid" &&
+                before.aggregate.intention.fingerprint === adapted.fingerprint) {
+                input.journal.append({ event: "skipped", key: adapted.key, state: "invalid" });
+                return { advance: true };
+            }
+            await input.ledger.recordInvalid({
+                key: adapted.key,
+                project: adapted.project,
+                code: adapted.invalid.code,
+                reason: adapted.invalid.reason,
+                fingerprint: adapted.fingerprint,
+            });
+            input.journal.append({
+                event: "invalid",
+                key: adapted.key,
+                reason: adapted.invalid.reason,
+            });
+            await pushReport(input, {
+                event: "invalid",
+                key: adapted.key,
+                project: adapted.project,
+                // One per intention as written: an edit is a new fingerprint and is said again.
+                eventId: `${adapted.key}:invalid:${adapted.fingerprint}`,
+                fields: { reason: adapted.invalid.reason },
+            });
+            return { advance: true };
+        }
+        case "converted":
+            break;
+    }
+    const feature = adapted.feature;
+    // Poll snapshots have no labeled edge: a ready signal on an escalated upsert
+    // is the same instruction as an explicit ready intent.
+    if (feature.intent === "upsert" && input.manager.signalsReady?.(input.payload) === true) {
+        const before = await input.ledger.get(feature.key);
+        if (before.ok && before.aggregate.state === "escalated") {
+            return await handleReady(feature, input);
+        }
+    }
+    switch (feature.intent) {
+        case "ready":
+            return await handleReady(feature, input);
+        case "cancel":
+            await handleCancel(feature, input);
+            return { advance: true };
+        case "upsert":
+            return await handleUpsert(feature, input);
+    }
+}
+async function handleUpsert(feature, input) {
+    const admission = toAdmission(feature);
+    if (admission === undefined) {
+        return { advance: true };
+    }
+    const before = await input.ledger.get(admission.key);
+    if (before.ok && IN_FLIGHT_OR_TERMINAL.has(before.aggregate.state)) {
+        input.journal.append({
+            event: "skipped",
+            key: admission.key,
+            state: before.aggregate.state,
+        });
+        return { advance: true };
+    }
+    const admitted = await input.ledger.admit(admission);
+    if (!admitted.ok) {
+        if (admitted.code === "too-late" || admitted.code === "point-of-no-return") {
+            await pushReport(input, {
+                event: "reject_late",
+                key: admission.key,
+                project: admission.project,
+                // One per intention: the same edit delivered again is the echo of
+                // this report, not another edit.
+                eventId: `${admission.key}:reject_late:${admission.fingerprint}`,
+                fields: { reason: `Admission refused: ${admitted.code}` },
+            });
+        }
+        return { advance: true };
+    }
+    if (!before.ok || before.aggregate.state === "invalid") {
+        input.journal.append({ event: "admitted", key: admission.key, project: admission.project });
+        await pushReport(input, {
+            event: "accepted",
+            key: admission.key,
+            project: admission.project,
+            // One per intention as written, like `invalid`: a corrected issue is accepted again.
+            eventId: `${admission.key}:accepted:${admission.fingerprint}`,
+            fields: { priority: admission.priority },
+        });
+    }
+    const run = await driveProject(input, admission.project, admission.key);
+    if (run === undefined) {
+        // Frozen Project: do not mark it driven, so a later delivery in this pass
+        // (a cancel, a ready) can free it and the sweep can start the queue.
+        return { advance: true };
+    }
+    return { advance: true, run, project: admission.project };
+}
+async function handleReady(feature, input) {
+    const before = await input.ledger.get(feature.key);
+    if (!before.ok || before.aggregate.state !== "escalated") {
+        return { advance: true };
+    }
+    const resumePoint = resumePointOf(before.aggregate);
+    const ready = await input.ledger.resumeReady(feature.key);
+    if (!ready.ok) {
+        return { advance: true };
+    }
+    // The signal is an instruction, not a state: left where it is, it resumes the
+    // feature again on every pass and an escalation never freezes anything.
+    await input.manager.clearReady?.(feature.key);
+    // The ledger counts the rounds; this resume is the latest one.
+    const resumed = await input.ledger.get(feature.key);
+    const round = resumed.ok ? (resumed.aggregate.resumes ?? 0) : 0;
+    await pushReport(input, {
+        event: "resumed",
+        key: feature.key,
+        project: feature.project,
+        eventId: `${feature.key}:resumed:${round}`,
+        fields: { resume_point: resumePoint },
+    });
+    const run = await driveProject(input, feature.project, feature.key);
+    if (run === undefined) {
+        return { advance: true };
+    }
+    return { advance: true, run, project: feature.project };
+}
+export async function handleCancel(feature, input) {
+    const before = await input.ledger.get(feature.key);
+    if (!before.ok) {
+        return;
+    }
+    const state = before.aggregate.state;
+    if (state === "cancelled") {
+        // The ledger takes a second cancel as done already; the tracker was told
+        // the first time, and that is what delivered this one.
+        return;
+    }
+    if (state === "done") {
+        // A finished feature's issue closing is the tracker agreeing, not a
+        // cancel arriving late — the Submission itself asked for that close.
+        input.journal.append({ event: "skipped", key: feature.key, state });
+        return;
+    }
+    const cancelled = await input.conductor.cancel(feature.key);
+    if (!cancelled.ok) {
+        if (cancelled.code === "point-of-no-return") {
+            await pushReport(input, {
+                event: "reject_late",
+                key: feature.key,
+                project: feature.project,
+                // A closed issue stays closed: every later delivery is the same cancel.
+                eventId: `${feature.key}:reject_late:cancel`,
+                fields: { reason: "Cancel arrived after the point of no return." },
+            });
+        }
+        return;
+    }
+    await pushReport(input, {
+        event: "cancelled",
+        key: feature.key,
+        project: feature.project,
+        // A Feature is cancelled once: the ledger refuses a second cancel and never re-admits the key.
+        eventId: `${feature.key}:cancelled`,
+        fields: { state },
+    });
+}
+/** Abandon one Feature by key — the same path a `cancel` delivery takes. */
+export async function cancelFeature(input, key) {
+    const got = await input.ledger.get(key);
+    if (!got.ok) {
+        return { ok: false, code: "not-found" };
+    }
+    const state = got.aggregate.state;
+    if (state === "cancelled") {
+        return { ok: false, code: "already-cancelled" };
+    }
+    if (state === "done") {
+        return { ok: false, code: "done" };
+    }
+    await handleCancel({ key, project: got.aggregate.intention.project }, { ...input, reported: [] });
+    const after = await input.ledger.get(key);
+    if (after.ok && after.aggregate.state === "cancelled") {
+        return { ok: true };
+    }
+    return { ok: false, code: "point-of-no-return" };
+}
+function toAdmission(feature) {
+    if (feature.intent !== "upsert") {
+        return undefined;
+    }
+    if (feature.intention === undefined) {
+        return undefined;
+    }
+    const admission = {
+        key: feature.key,
+        project: feature.project,
+        fingerprint: feature.fingerprint,
+        priority: feature.priority,
+        intention: feature.intention,
+        manager: feature.manager,
+        external_id: feature.external_id,
+    };
+    if (feature.title !== undefined) {
+        admission.title = feature.title;
+    }
+    if (feature.source !== undefined) {
+        admission.source = feature.source;
+    }
+    return admission;
+}
+//# sourceMappingURL=deliveries.js.map