@bluewombat/integrator 0.1.0

package/dist/fold/fold.js

@@ -0,0 +1,49 @@
+import { removeSnapshot, restoreWorkingFiles, snapshotWorkingFiles, } from "./working-files.js";
+/**
+ * Fold Child working files into Parent through the injected backend.
+ * Parent is restored unless the fold completes.
+ */
+export async function fold(input) {
+    const { parent, child, backend, id, subject, mergeSubject, deadlineMs, now, shouldInterrupt } = input;
+    const backup = await snapshotWorkingFiles(parent);
+    const shouldStop = () => {
+        if (shouldInterrupt()) {
+            return "interrupt";
+        }
+        if (now() >= deadlineMs) {
+            return "clock";
+        }
+        return undefined;
+    };
+    const fail = async (result) => {
+        await restoreWorkingFiles(parent, backup);
+        await removeSnapshot(backup);
+        return result;
+    };
+    try {
+        const result = await backend.fold({
+            parent,
+            child,
+            ...(id === undefined ? {} : { id }),
+            ...(subject === undefined ? {} : { subject }),
+            ...(mergeSubject === undefined ? {} : { mergeSubject }),
+            deadlineMs,
+            now,
+            shouldInterrupt,
+            shouldStop,
+        });
+        if (result.ok) {
+            await removeSnapshot(backup);
+            return result;
+        }
+        return fail(result);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        return fail({
+            ok: false,
+            detail: `Integration could not complete: ${detail}`,
+        });
+    }
+}
+//# sourceMappingURL=fold.js.map

package/dist/fold/fold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold.js","sourceRoot":"","sources":["../../src/fold/fold.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,cAAc,EACd,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAQ5B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,KAW1B;IACC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,EAAE,eAAe,EAAE,GAC3F,KAAK,CAAC;IACR,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAElD,MAAM,UAAU,GAAG,GAAyB,EAAE;QAC5C,IAAI,eAAe,EAAE,EAAE,CAAC;YACtB,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,IAAI,GAAG,EAAE,IAAI,UAAU,EAAE,CAAC;YACxB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,KAAK,EAAE,MAAkB,EAAuB,EAAE;QAC7D,MAAM,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1C,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAChC,MAAM;YACN,KAAK;YACL,GAAG,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;YACnC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;YAC7C,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;YACvD,UAAU;YACV,GAAG;YACH,eAAe;YACf,UAAU;SACX,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;YAC7B,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC;YACV,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,mCAAmC,MAAM,EAAE;SACpD,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/fold/working-files.d.ts

@@ -0,0 +1,28 @@
+export type FoldStop = "clock" | "interrupt";
+export type PathKind = "file" | "directory" | "symlink" | "missing";
+export declare class IntegrationStoppedError extends Error {
+    readonly stop: FoldStop;
+    constructor(stop: FoldStop);
+}
+export declare function throwIfStopped(shouldStop: () => FoldStop | undefined): Promise<void>;
+export declare function direntKind(entry: {
+    isSymbolicLink(): boolean;
+    isDirectory(): boolean;
+    isFile(): boolean;
+}): PathKind | "other";
+export declare function pathKind(path: string): Promise<PathKind | "other">;
+/**
+ * Copy working files from `from` into an existing `to` directory.
+ * Skips `.git` only at the root of `from` when `skipGitAtRoot` is set.
+ */
+export declare function copyWorkingFiles(input: {
+    from: string;
+    to: string;
+    skipGitAtRoot: boolean;
+    shouldStop: () => FoldStop | undefined;
+}): Promise<void>;
+export declare function wipeWorkingFiles(directory: string, shouldStop: () => FoldStop | undefined): Promise<void>;
+export declare function snapshotWorkingFiles(directory: string): Promise<string>;
+export declare function restoreWorkingFiles(directory: string, backup: string): Promise<void>;
+export declare function removeSnapshot(backup: string): Promise<void>;
+//# sourceMappingURL=working-files.d.ts.map

package/dist/fold/working-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"working-files.d.ts","sourceRoot":"","sources":["../../src/fold/working-files.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;AAE7C,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpE,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;gBAEZ,IAAI,EAAE,QAAQ;CAS3B;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAK1F;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAChC,cAAc,IAAI,OAAO,CAAC;IAC1B,WAAW,IAAI,OAAO,CAAC;IACvB,MAAM,IAAI,OAAO,CAAC;CACnB,GAAG,QAAQ,GAAG,OAAO,CAWrB;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,CAmBxE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,QAAQ,GAAG,SAAS,CAAC;CACxC,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhB;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,QAAQ,GAAG,SAAS,GACrC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS7E;AAED,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ1F;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAElE"}

package/dist/fold/working-files.js

@@ -0,0 +1,122 @@
+import { copyFile, lstat, mkdir, mkdtemp, readdir, readlink, rm, symlink } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+export class IntegrationStoppedError extends Error {
+    stop;
+    constructor(stop) {
+        super(stop === "clock"
+            ? "The Integration clock fired."
+            : "A stop signal arrived before Integration completed.");
+        this.name = "IntegrationStoppedError";
+        this.stop = stop;
+    }
+}
+export async function throwIfStopped(shouldStop) {
+    const stop = shouldStop();
+    if (stop !== undefined) {
+        throw new IntegrationStoppedError(stop);
+    }
+}
+export function direntKind(entry) {
+    if (entry.isSymbolicLink()) {
+        return "symlink";
+    }
+    if (entry.isDirectory()) {
+        return "directory";
+    }
+    if (entry.isFile()) {
+        return "file";
+    }
+    return "other";
+}
+export async function pathKind(path) {
+    try {
+        const stats = await lstat(path);
+        if (stats.isSymbolicLink()) {
+            return "symlink";
+        }
+        if (stats.isDirectory()) {
+            return "directory";
+        }
+        if (stats.isFile()) {
+            return "file";
+        }
+        return "other";
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            return "missing";
+        }
+        throw error;
+    }
+}
+/**
+ * Copy working files from `from` into an existing `to` directory.
+ * Skips `.git` only at the root of `from` when `skipGitAtRoot` is set.
+ */
+export async function copyWorkingFiles(input) {
+    await copyDir(input.from, input.to, true, input.skipGitAtRoot, input.shouldStop);
+}
+export async function wipeWorkingFiles(directory, shouldStop) {
+    await throwIfStopped(shouldStop);
+    const entries = await readdir(directory);
+    for (const name of entries) {
+        await throwIfStopped(shouldStop);
+        if (name === ".git") {
+            continue;
+        }
+        await rm(join(directory, name), { recursive: true, force: true });
+    }
+}
+export async function snapshotWorkingFiles(directory) {
+    const backup = await mkdtemp(join(tmpdir(), "integrator-parent-"));
+    await copyWorkingFiles({
+        from: directory,
+        to: backup,
+        skipGitAtRoot: true,
+        shouldStop: () => undefined,
+    });
+    return backup;
+}
+export async function restoreWorkingFiles(directory, backup) {
+    await wipeWorkingFiles(directory, () => undefined);
+    await copyWorkingFiles({
+        from: backup,
+        to: directory,
+        skipGitAtRoot: true,
+        shouldStop: () => undefined,
+    });
+}
+export async function removeSnapshot(backup) {
+    await rm(backup, { recursive: true, force: true });
+}
+async function copyDir(from, to, isRoot, skipGitAtRoot, shouldStop) {
+    await throwIfStopped(shouldStop);
+    if (!isRoot) {
+        await mkdir(to);
+    }
+    const entries = await readdir(from, { withFileTypes: true });
+    for (const entry of entries) {
+        await throwIfStopped(shouldStop);
+        if (isRoot && skipGitAtRoot && entry.name === ".git") {
+            continue;
+        }
+        const src = join(from, entry.name);
+        const dest = join(to, entry.name);
+        if (entry.isDirectory()) {
+            await copyDir(src, dest, false, false, shouldStop);
+            continue;
+        }
+        if (entry.isSymbolicLink()) {
+            const target = await readlink(src);
+            await symlink(target, dest);
+            continue;
+        }
+        if (entry.isFile()) {
+            await copyFile(src, dest);
+            continue;
+        }
+        throw new Error(`Cannot fold "${src}": unsupported file type.`);
+    }
+}
+//# sourceMappingURL=working-files.js.map

package/dist/fold/working-files.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Import entry point for this Transformer.
+ *
+ * The Transformer is a function. `cli.ts` is a thin adapter over this surface: it
+ * reads argv and stdin, calls runIntegrator, and maps the outcome to an exit code.
+ * Everything a caller needs in process is reachable from here.
+ *
+ * Isolation strategies (git, copy, …) live under `packages/plugins/isolation-*`.
+ */
+export type { FoldBackend } from "./fold/backend.js";
+export type { FoldStop } from "./fold/working-files.js";
+export { IntegrationStoppedError, throwIfStopped } from "./fold/working-files.js";
+export type { ProgressWriter } from "./progress/emit.js";
+export type { RunOptions, RunResult } from "./run/run-integrator.js";
+export { runIntegrator } from "./run/run-integrator.js";
+export type * from "./types.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;;;;;;;;GAQG;AAEH,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAClF,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,mBAAmB,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * Import entry point for this Transformer.
+ *
+ * The Transformer is a function. `cli.ts` is a thin adapter over this surface: it
+ * reads argv and stdin, calls runIntegrator, and maps the outcome to an exit code.
+ * Everything a caller needs in process is reachable from here.
+ *
+ * Isolation strategies (git, copy, …) live under `packages/plugins/isolation-*`.
+ */
+export { IntegrationStoppedError, throwIfStopped } from "./fold/working-files.js";
+export { runIntegrator } from "./run/run-integrator.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;;;;;;;;GAQG;AAIH,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGlF,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/progress/emit.d.ts

@@ -0,0 +1,5 @@
+import type { Status } from "../types.js";
+export type ProgressWriter = (line: Record<string, unknown>) => void;
+export declare function createStdoutProgressWriter(): ProgressWriter;
+export declare function emitStatusEvent(write: ProgressWriter, status: Status): void;
+//# sourceMappingURL=emit.d.ts.map

package/dist/progress/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../src/progress/emit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAErE,wBAAgB,0BAA0B,IAAI,cAAc,CAI3D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAU3E"}

package/dist/progress/emit.js

@@ -0,0 +1,17 @@
+export function createStdoutProgressWriter() {
+    return (line) => {
+        process.stdout.write(`${JSON.stringify(line)}\n`);
+    };
+}
+export function emitStatusEvent(write, status) {
+    const line = {
+        event: "status",
+        phase: status.phase,
+        label: status.label,
+    };
+    if (status.id !== undefined) {
+        line.id = status.id;
+    }
+    write(line);
+}
+//# sourceMappingURL=emit.js.map

package/dist/progress/emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../src/progress/emit.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,0BAA0B;IACxC,OAAO,CAAC,IAAI,EAAE,EAAE;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAqB,EAAE,MAAc;IACnE,MAAM,IAAI,GAA4B;QACpC,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;IACF,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;IACtB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/run/run-integrator.d.ts

@@ -0,0 +1,35 @@
+import type { FoldBackend } from "../fold/backend.js";
+import type { ProgressWriter } from "../progress/emit.js";
+import type { IntegrationOutcome, Invocation } from "../types.js";
+export type RunResult = {
+    outcome: IntegrationOutcome;
+    parent?: string;
+    report?: string;
+    exitCode: number;
+};
+export type RunOptions = {
+    invocation: Invocation;
+    /** How Integrator folds. Required; Integrator does not sniff `.git`. */
+    backend: FoldBackend;
+    write?: ProgressWriter;
+    /** Injectable clock for tests. */
+    now?: () => number;
+    /** When set, polled for interrupt; otherwise process signals are used. */
+    interruptFlag?: {
+        interrupted: boolean;
+    };
+    /** Working directory for spawned children. Undefined lets them inherit. */
+    cwd?: string;
+};
+/**
+ * Run one Integrator invocation to an Integration outcome.
+ */
+export declare function runIntegrator(options: RunOptions): Promise<RunResult>;
+export declare function invalidInvocationResult(input: {
+    id: string | undefined;
+    onStatusArgv: string[] | undefined;
+    write: ProgressWriter;
+    reason: string;
+    cwd: string | undefined;
+}): Promise<RunResult>;
+//# sourceMappingURL=run-integrator.d.ts.map

package/dist/run/run-integrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-integrator.d.ts","sourceRoot":"","sources":["../../src/run/run-integrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,wEAAwE;IACxE,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,0EAA0E;IAC1E,aAAa,CAAC,EAAE;QAAE,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;IACzC,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAwBF;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAgB3E;AAuID,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACnC,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACzB,GAAG,OAAO,CAAC,SAAS,CAAC,CA0BrB"}

package/dist/run/run-integrator.js

@@ -0,0 +1,172 @@
+import { fold } from "../fold/fold.js";
+import { announceStatus } from "../status/announce.js";
+import { makeStatus } from "../status/make-status.js";
+function exitCodeFor(outcome) {
+    switch (outcome) {
+        case "integrated":
+            return 0;
+        case "conflict":
+            return 1;
+        case "invalid-invocation":
+            return 2;
+        case "failed":
+            return 3;
+        case "interrupted":
+            return 130;
+    }
+}
+function withId(id, line) {
+    if (id !== undefined) {
+        line.id = id;
+    }
+    return line;
+}
+/**
+ * Run one Integrator invocation to an Integration outcome.
+ */
+export async function runIntegrator(options) {
+    const { invocation, backend } = options;
+    const write = options.write ?? (() => { });
+    const now = options.now ?? (() => Date.now());
+    const interruptState = options.interruptFlag ?? { interrupted: false };
+    const shouldInterrupt = () => interruptState.interrupted;
+    return await runIntegration({
+        invocation,
+        backend,
+        write,
+        now,
+        shouldInterrupt,
+        cwd: options.cwd,
+    });
+}
+async function runIntegration(input) {
+    const { invocation, backend, write, now, shouldInterrupt } = input;
+    await announceStatus({
+        onStatusArgv: invocation.onStatusArgv,
+        status: makeStatus({ phase: "integrating", id: invocation.id }),
+        write,
+        shouldInterrupt,
+        cwd: input.cwd,
+    });
+    write(withId(invocation.id, {
+        event: "integration-started",
+    }));
+    const deadlineMs = now() + invocation.durationMs;
+    const folded = await fold({
+        parent: invocation.parent,
+        child: invocation.child,
+        backend,
+        ...(invocation.id === undefined ? {} : { id: invocation.id }),
+        ...(invocation.subject === undefined ? {} : { subject: invocation.subject }),
+        ...(invocation.mergeSubject === undefined ? {} : { mergeSubject: invocation.mergeSubject }),
+        deadlineMs,
+        now,
+        shouldInterrupt,
+    });
+    if (folded.ok) {
+        // A stop signal racing a just-completed fold uses integrated.
+        return finishIntegration({
+            cwd: input.cwd,
+            invocation,
+            write,
+            outcome: "integrated",
+            parent: invocation.parent,
+        });
+    }
+    if ("stop" in folded && folded.stop === "interrupt") {
+        return finishIntegration({ cwd: input.cwd, invocation, write, outcome: "interrupted" });
+    }
+    if ("stop" in folded && folded.stop === "clock") {
+        if (shouldInterrupt()) {
+            return finishIntegration({ cwd: input.cwd, invocation, write, outcome: "interrupted" });
+        }
+        return finishIntegration({
+            cwd: input.cwd,
+            invocation,
+            write,
+            outcome: "failed",
+            report: "The Integration clock fired.",
+        });
+    }
+    if ("conflict" in folded && folded.conflict) {
+        if (shouldInterrupt()) {
+            return finishIntegration({ cwd: input.cwd, invocation, write, outcome: "interrupted" });
+        }
+        return finishIntegration({
+            cwd: input.cwd,
+            invocation,
+            write,
+            outcome: "conflict",
+            report: folded.report,
+        });
+    }
+    const detail = "detail" in folded ? folded.detail : "Integration could not complete.";
+    if (shouldInterrupt()) {
+        return finishIntegration({ cwd: input.cwd, invocation, write, outcome: "interrupted" });
+    }
+    return finishIntegration({
+        cwd: input.cwd,
+        invocation,
+        write,
+        outcome: "failed",
+        report: detail,
+    });
+}
+async function finishIntegration(input) {
+    const { invocation, write, outcome } = input;
+    await announceStatus({
+        onStatusArgv: invocation.onStatusArgv,
+        status: makeStatus({ phase: outcome, id: invocation.id }),
+        write,
+        shouldInterrupt: () => false,
+        cwd: input.cwd,
+    });
+    const finished = {
+        event: "integration-finished",
+        outcome,
+    };
+    if (outcome === "integrated" && input.parent !== undefined) {
+        finished.parent = input.parent;
+    }
+    if ((outcome === "conflict" || outcome === "failed") && input.report !== undefined) {
+        finished.report = input.report;
+    }
+    write(withId(invocation.id, finished));
+    const result = {
+        outcome,
+        exitCode: exitCodeFor(outcome),
+    };
+    if (input.parent !== undefined) {
+        result.parent = input.parent;
+    }
+    if (input.report !== undefined) {
+        result.report = input.report;
+    }
+    return result;
+}
+export async function invalidInvocationResult(input) {
+    const statusInput = { phase: "invalid" };
+    if (input.id !== undefined) {
+        statusInput.id = input.id;
+    }
+    const status = makeStatus(statusInput);
+    await announceStatus({
+        onStatusArgv: input.onStatusArgv,
+        status,
+        write: input.write,
+        shouldInterrupt: () => false,
+        cwd: input.cwd,
+    });
+    input.write(withId(input.id, {
+        event: "integration-finished",
+        outcome: "invalid-invocation",
+        report: input.reason,
+    }));
+    const result = {
+        outcome: "invalid-invocation",
+        report: input.reason,
+        exitCode: exitCodeFor("invalid-invocation"),
+    };
+    return result;
+}
+//# sourceMappingURL=run-integrator.js.map

package/dist/run/run-integrator.js.map

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

package/dist/status/announce.d.ts

@@ -0,0 +1,14 @@
+import type { ProgressWriter } from "../progress/emit.js";
+import type { Status } from "../types.js";
+/**
+ * Announce Status on stdout (and optionally via --on-status).
+ * --on-status never affects the Integration outcome.
+ */
+export declare function announceStatus(input: {
+    onStatusArgv: string[] | undefined;
+    status: Status;
+    write: ProgressWriter;
+    shouldInterrupt: () => boolean;
+    cwd: string | undefined;
+}): Promise<void>;
+//# sourceMappingURL=announce.d.ts.map

package/dist/status/announce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"announce.d.ts","sourceRoot":"","sources":["../../src/status/announce.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;GAGG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE;IAC1C,YAAY,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,cAAc,CAAC;IACtB,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBhB"}

package/dist/status/announce.js

@@ -0,0 +1,28 @@
+import { runChild } from "../child/run-child.js";
+import { emitStatusEvent } from "../progress/emit.js";
+/**
+ * Announce Status on stdout (and optionally via --on-status).
+ * --on-status never affects the Integration outcome.
+ */
+export async function announceStatus(input) {
+    const { status, write, shouldInterrupt, cwd } = input;
+    emitStatusEvent(write, status);
+    const onStatus = input.onStatusArgv;
+    if (onStatus === undefined) {
+        return;
+    }
+    const argv = [...onStatus];
+    if (status.id !== undefined) {
+        argv.push("--id", status.id);
+    }
+    argv.push("--label", status.label, "--phase", status.phase);
+    // Soft cap only: a hang or non-zero exit must not change the Integration outcome.
+    await runChild({
+        argv,
+        cwd,
+        timeoutMs: 5_000,
+        timeoutClock: "integration",
+        shouldInterrupt,
+    });
+}
+//# sourceMappingURL=announce.js.map

package/dist/status/announce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"announce.js","sourceRoot":"","sources":["../../src/status/announce.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAMpC;IACC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;IACtD,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAE/B,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,CAAC;IACpC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IAC3B,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5D,kFAAkF;IAClF,MAAM,QAAQ,CAAC;QACb,IAAI;QACJ,GAAG;QACH,SAAS,EAAE,KAAK;QAChB,YAAY,EAAE,aAAa;QAC3B,eAAe;KAChB,CAAC,CAAC;AACL,CAAC"}

package/dist/status/make-status.d.ts

@@ -0,0 +1,7 @@
+import type { Status, StatusPhase } from "../types.js";
+export declare function buildStatusLabel(phase: StatusPhase, id: string | undefined): string;
+export declare function makeStatus(input: {
+    phase: StatusPhase;
+    id?: string;
+}): Status;
+//# sourceMappingURL=make-status.d.ts.map

package/dist/status/make-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-status.d.ts","sourceRoot":"","sources":["../../src/status/make-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQnF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAQ7E"}

package/dist/status/make-status.js

@@ -0,0 +1,19 @@
+export function buildStatusLabel(phase, id) {
+    if (phase === "invalid") {
+        return "invalid";
+    }
+    if (id === undefined) {
+        throw new Error(`Status phase "${phase}" requires id.`);
+    }
+    return `${phase}:${id}`;
+}
+export function makeStatus(input) {
+    const { phase, id } = input;
+    const label = buildStatusLabel(phase, id);
+    const status = { phase, label };
+    if (id !== undefined) {
+        status.id = id;
+    }
+    return status;
+}
+//# sourceMappingURL=make-status.js.map

package/dist/status/make-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-status.js","sourceRoot":"","sources":["../../src/status/make-status.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,KAAkB,EAAE,EAAsB;IACzE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,gBAAgB,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,GAAG,KAAK,IAAI,EAAE,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAA0C;IACnE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC;IAC5B,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAW,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACxC,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,32 @@
+/** Domain types owned by Integrator. Names match the Transformer perimeter only. */
+export type IntegrationOutcome = "invalid-invocation" | "integrated" | "conflict" | "failed" | "interrupted";
+export type StatusPhase = "integrating" | "integrated" | "conflict" | "failed" | "interrupted" | "invalid";
+export type ClockName = "integration";
+export type Status = {
+    phase: StatusPhase;
+    id?: string;
+    label: string;
+};
+export type Invocation = {
+    id: string;
+    parent: string;
+    child: string;
+    durationMs: number;
+    /** What the folded work is, for whoever reads the history it leaves. */
+    subject?: string;
+    /** What the fold itself is, when it has to leave a merge of its own. */
+    mergeSubject?: string;
+    onStatusArgv?: string[];
+};
+export type ParseFailure = {
+    ok: false;
+    reason: string;
+    id?: string;
+    onStatusArgv?: string[];
+};
+export type ParseResult = {
+    ok: true;
+    invocation: Invocation;
+    strategy: string;
+} | ParseFailure;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,MAAM,MAAM,kBAAkB,GAC1B,oBAAoB,GACpB,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,aAAa,CAAC;AAElB,MAAM,MAAM,WAAW,GACnB,aAAa,GACb,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC;AAEtC,MAAM,MAAM,MAAM,GAAG;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+/** Domain types owned by Integrator. Names match the Transformer perimeter only. */
+export {};
+//# sourceMappingURL=types.js.map