ghostrail 0.0.0

package/dist/backend/container.js

@@ -0,0 +1,70 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { DEFAULT_CONTAINER_IMAGE, dockerCpArgs, dockerExecArgs, dockerRmArgs, dockerRunArgs, } from "./docker.js";
+import { spawnCollect } from "./proc.js";
+const KIND = "container";
+async function docker(args, timeoutMs) {
+    return spawnCollect(["docker", ...args], timeoutMs === undefined ? {} : { timeoutMs });
+}
+/**
+ * The recommended default for a shared tool: a fresh, disposable container per
+ * item, on its own branch, with a clean filesystem and nothing bleeding between
+ * runs. The repo is cloned on the host onto the new branch and copied into the
+ * container, so the image only needs a shell (not git); commands run via
+ * `docker exec`. Teardown force-removes the container.
+ */
+export class ContainerBackend {
+    kind = KIND;
+    /** True if the Docker CLI and daemon are reachable. */
+    static async isAvailable() {
+        const result = await docker(["version", "--format", "{{.Server.Version}}"], 10_000);
+        return result.exitCode === 0;
+    }
+    async provision(spec) {
+        const id = randomUUID();
+        const name = `ghostrail-${id}`;
+        const image = spec.image ?? DEFAULT_CONTAINER_IMAGE;
+        const hostClone = join(tmpdir(), "ghostrail-cc", id);
+        await mkdir(join(tmpdir(), "ghostrail-cc"), { recursive: true });
+        try {
+            const clone = await spawnCollect(["git", "clone", "--quiet", spec.repoPath, hostClone]);
+            if (clone.exitCode !== 0)
+                throw new Error(`git clone failed: ${clone.stderr.trim()}`);
+            // "create" makes a new branch off the base; "attach" checks out an existing branch.
+            const checkoutArgs = spec.mode === "attach"
+                ? ["checkout", spec.branch]
+                : ["checkout", "-B", spec.branch, spec.baseBranch];
+            const branch = await spawnCollect(["git", "-C", hostClone, ...checkoutArgs]);
+            if (branch.exitCode !== 0)
+                throw new Error(`git checkout failed: ${branch.stderr.trim()}`);
+            const run = await docker(dockerRunArgs(name, image));
+            if (run.exitCode !== 0)
+                throw new Error(`docker run failed: ${run.stderr.trim()}`);
+            const cp = await docker(dockerCpArgs(`${hostClone}/.`, name));
+            if (cp.exitCode !== 0) {
+                await docker(dockerRmArgs(name));
+                throw new Error(`docker cp failed: ${cp.stderr.trim()}`);
+            }
+            return { id, backend: KIND, ref: name, branch: spec.branch };
+        }
+        finally {
+            await rm(hostClone, { recursive: true, force: true });
+        }
+    }
+    exec(workspace, command, options = {}) {
+        return docker(dockerExecArgs(workspace.ref, command, options), options.timeoutMs);
+    }
+    stream(workspace, command, onLog, options = {}) {
+        const args = dockerExecArgs(workspace.ref, command, options);
+        return spawnCollect(["docker", ...args], {
+            onLog,
+            ...(options.timeoutMs === undefined ? {} : { timeoutMs: options.timeoutMs }),
+        });
+    }
+    async teardown(workspace) {
+        await docker(dockerRmArgs(workspace.ref));
+    }
+}
+//# sourceMappingURL=container.js.map

package/dist/backend/container.js.map

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

package/dist/backend/docker.d.ts

@@ -0,0 +1,22 @@
+import type { ExecOptions } from "./types.js";
+/** The image used when a container backend config gives none. */
+export declare const DEFAULT_CONTAINER_IMAGE = "alpine:3";
+/** Working directory inside every container. */
+export declare const CONTAINER_WORKDIR = "/work";
+/**
+ * Build `docker run` args for a long-lived, detached container that idles until
+ * torn down. The container is named `name`, works out of {@link CONTAINER_WORKDIR},
+ * and runs `sleep infinity` so commands can be `docker exec`'d into it.
+ */
+export declare function dockerRunArgs(name: string, image: string): string[];
+/**
+ * Build `docker exec` args to run `command` inside container `name`.
+ * A relative `options.cwd` is resolved under {@link CONTAINER_WORKDIR}; each
+ * `options.env` entry becomes a `-e KEY=VALUE` flag, in insertion order.
+ */
+export declare function dockerExecArgs(name: string, command: readonly string[], options?: ExecOptions): string[];
+/** Build `docker cp` args to copy host `source` into `name`'s work dir. */
+export declare function dockerCpArgs(source: string, name: string): string[];
+/** Build `docker rm -f` args to force-remove container `name`. */
+export declare function dockerRmArgs(name: string): string[];
+//# sourceMappingURL=docker.d.ts.map

package/dist/backend/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../src/backend/docker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAElD,gDAAgD;AAChD,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAEzC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,GAAE,WAAgB,GACxB,MAAM,EAAE,CAYV;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEnE;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEnD"}

package/dist/backend/docker.js

@@ -0,0 +1,38 @@
+/** The image used when a container backend config gives none. */
+export const DEFAULT_CONTAINER_IMAGE = "alpine:3";
+/** Working directory inside every container. */
+export const CONTAINER_WORKDIR = "/work";
+/**
+ * Build `docker run` args for a long-lived, detached container that idles until
+ * torn down. The container is named `name`, works out of {@link CONTAINER_WORKDIR},
+ * and runs `sleep infinity` so commands can be `docker exec`'d into it.
+ */
+export function dockerRunArgs(name, image) {
+    return ["run", "-d", "--name", name, "-w", CONTAINER_WORKDIR, image, "sleep", "infinity"];
+}
+/**
+ * Build `docker exec` args to run `command` inside container `name`.
+ * A relative `options.cwd` is resolved under {@link CONTAINER_WORKDIR}; each
+ * `options.env` entry becomes a `-e KEY=VALUE` flag, in insertion order.
+ */
+export function dockerExecArgs(name, command, options = {}) {
+    const args = ["exec"];
+    const workdir = options.cwd !== undefined ? `${CONTAINER_WORKDIR}/${options.cwd}` : CONTAINER_WORKDIR;
+    args.push("-w", workdir);
+    if (options.env) {
+        for (const [key, value] of Object.entries(options.env)) {
+            args.push("-e", `${key}=${value}`);
+        }
+    }
+    args.push(name, ...command);
+    return args;
+}
+/** Build `docker cp` args to copy host `source` into `name`'s work dir. */
+export function dockerCpArgs(source, name) {
+    return ["cp", source, `${name}:${CONTAINER_WORKDIR}`];
+}
+/** Build `docker rm -f` args to force-remove container `name`. */
+export function dockerRmArgs(name) {
+    return ["rm", "-f", name];
+}
+//# sourceMappingURL=docker.js.map

package/dist/backend/docker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.js","sourceRoot":"","sources":["../../src/backend/docker.ts"],"names":[],"mappings":"AAEA,iEAAiE;AACjE,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;AAElD,gDAAgD;AAChD,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,KAAa;IACvD,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAC5F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,OAA0B,EAC1B,UAAuB,EAAE;IAEzB,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,MAAM,OAAO,GACX,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,iBAAiB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC;IACxF,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC,CAAC;IAC5B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,IAAY;IACvD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,IAAI,iBAAiB,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC5B,CAAC"}

package/dist/backend/fs.d.ts

@@ -0,0 +1,9 @@
+import type { Backend, Workspace } from "./types.js";
+/**
+ * Write `content` to `path` (relative to the workspace root) through the backend,
+ * creating parent directories. Content is base64-encoded and decoded in the
+ * workspace, so it is shell-safe for any bytes and needs no stdin (which
+ * {@link Backend.exec} does not provide). Works identically on every backend.
+ */
+export declare function writeWorkspaceFile(backend: Backend, workspace: Workspace, path: string, content: string): Promise<void>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/backend/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/backend/fs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAOrD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/backend/fs.js

@@ -0,0 +1,21 @@
+/** Single-quote a string for safe use in a `sh -c` script. */
+function shellQuote(value) {
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+/**
+ * Write `content` to `path` (relative to the workspace root) through the backend,
+ * creating parent directories. Content is base64-encoded and decoded in the
+ * workspace, so it is shell-safe for any bytes and needs no stdin (which
+ * {@link Backend.exec} does not provide). Works identically on every backend.
+ */
+export async function writeWorkspaceFile(backend, workspace, path, content) {
+    const encoded = Buffer.from(content, "utf8").toString("base64");
+    const quotedPath = shellQuote(path);
+    const script = `mkdir -p "$(dirname ${quotedPath})" && ` +
+        `printf %s ${shellQuote(encoded)} | base64 -d > ${quotedPath}`;
+    const result = await backend.exec(workspace, ["sh", "-c", script]);
+    if (result.exitCode !== 0) {
+        throw new Error(`writeWorkspaceFile(${path}) failed: ${result.stderr.trim()}`);
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/backend/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/backend/fs.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAgB,EAChB,SAAoB,EACpB,IAAY,EACZ,OAAe;IAEf,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,MAAM,GACV,uBAAuB,UAAU,QAAQ;QACzC,aAAa,UAAU,CAAC,OAAO,CAAC,kBAAkB,UAAU,EAAE,CAAC;IACjE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACnE,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,aAAa,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACjF,CAAC;AACH,CAAC"}

package/dist/backend/index.d.ts

@@ -0,0 +1,7 @@
+export { ContainerBackend } from "./container.js";
+export { writeWorkspaceFile } from "./fs.js";
+export { CONTAINER_WORKDIR, DEFAULT_CONTAINER_IMAGE, dockerCpArgs, dockerExecArgs, dockerRmArgs, dockerRunArgs, } from "./docker.js";
+export { LocalWorktreeBackend } from "./local-worktree.js";
+export { splitStream } from "./proc.js";
+export type { Backend, ExecOptions, ExecResult, LogLine, ProvisionSpec, Workspace, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EACV,OAAO,EACP,WAAW,EACX,UAAU,EACV,OAAO,EACP,aAAa,EACb,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/backend/index.js

@@ -0,0 +1,6 @@
+export { ContainerBackend } from "./container.js";
+export { writeWorkspaceFile } from "./fs.js";
+export { CONTAINER_WORKDIR, DEFAULT_CONTAINER_IMAGE, dockerCpArgs, dockerExecArgs, dockerRmArgs, dockerRunArgs, } from "./docker.js";
+export { LocalWorktreeBackend } from "./local-worktree.js";
+export { splitStream } from "./proc.js";
+//# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/backend/local-worktree.d.ts

@@ -0,0 +1,17 @@
+import type { Backend, ExecOptions, ExecResult, LogLine, ProvisionSpec, Workspace } from "./types.js";
+/**
+ * The zero-infrastructure default backend: a git worktree in the current
+ * environment. Fastest and least isolated, best for a trusted solo repo. Each
+ * provision adds a worktree on a fresh branch off the base; teardown removes it.
+ */
+export declare class LocalWorktreeBackend implements Backend {
+    readonly kind = "local-worktree";
+    /** repoPath per workspace id, needed to remove the worktree at teardown. */
+    private readonly repoByWorkspace;
+    provision(spec: ProvisionSpec): Promise<Workspace>;
+    exec(workspace: Workspace, command: readonly string[], options?: ExecOptions): Promise<ExecResult>;
+    stream(workspace: Workspace, command: readonly string[], onLog: (line: LogLine) => void, options?: ExecOptions): Promise<ExecResult>;
+    teardown(workspace: Workspace): Promise<void>;
+    private execOptions;
+}
+//# sourceMappingURL=local-worktree.d.ts.map

package/dist/backend/local-worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-worktree.d.ts","sourceRoot":"","sources":["../../src/backend/local-worktree.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,OAAO,EACP,WAAW,EACX,UAAU,EACV,OAAO,EACP,aAAa,EACb,SAAS,EACV,MAAM,YAAY,CAAC;AAIpB;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,OAAO;IAClD,QAAQ,CAAC,IAAI,oBAAQ;IACrB,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAEvD,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;IAqBxD,IAAI,CACF,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC;IAItB,MAAM,CACJ,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,EAC9B,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC;IAIhB,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnD,OAAO,CAAC,WAAW;CAIpB"}

package/dist/backend/local-worktree.js

@@ -0,0 +1,51 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { spawnCollect } from "./proc.js";
+const KIND = "local-worktree";
+/**
+ * The zero-infrastructure default backend: a git worktree in the current
+ * environment. Fastest and least isolated, best for a trusted solo repo. Each
+ * provision adds a worktree on a fresh branch off the base; teardown removes it.
+ */
+export class LocalWorktreeBackend {
+    kind = KIND;
+    /** repoPath per workspace id, needed to remove the worktree at teardown. */
+    repoByWorkspace = new Map();
+    async provision(spec) {
+        const id = randomUUID();
+        const dir = join(tmpdir(), "ghostrail-wt", id);
+        await mkdir(join(tmpdir(), "ghostrail-wt"), { recursive: true });
+        // "create" makes a new branch off the base; "attach" checks out an existing branch.
+        const addArgs = spec.mode === "attach"
+            ? ["worktree", "add", dir, spec.branch]
+            : ["worktree", "add", "-b", spec.branch, dir, spec.baseBranch];
+        const result = await spawnCollect(["git", "-C", spec.repoPath, ...addArgs]);
+        if (result.exitCode !== 0) {
+            throw new Error(`local-worktree provision failed: ${result.stderr.trim() || result.stdout.trim()}`);
+        }
+        this.repoByWorkspace.set(id, spec.repoPath);
+        return { id, backend: KIND, ref: dir, branch: spec.branch };
+    }
+    exec(workspace, command, options = {}) {
+        return spawnCollect(command, this.execOptions(workspace, options));
+    }
+    stream(workspace, command, onLog, options = {}) {
+        return spawnCollect(command, { ...this.execOptions(workspace, options), onLog });
+    }
+    async teardown(workspace) {
+        const repoPath = this.repoByWorkspace.get(workspace.id);
+        if (repoPath !== undefined) {
+            await spawnCollect(["git", "-C", repoPath, "worktree", "remove", "--force", workspace.ref]);
+            await spawnCollect(["git", "-C", repoPath, "worktree", "prune"]);
+            this.repoByWorkspace.delete(workspace.id);
+        }
+        await rm(workspace.ref, { recursive: true, force: true });
+    }
+    execOptions(workspace, options) {
+        const cwd = options.cwd !== undefined ? join(workspace.ref, options.cwd) : workspace.ref;
+        return { ...options, cwd };
+    }
+}
+//# sourceMappingURL=local-worktree.js.map

package/dist/backend/local-worktree.js.map

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

package/dist/backend/proc.d.ts

@@ -0,0 +1,24 @@
+import type { ExecOptions, ExecResult, LogLine } from "./types.js";
+/**
+ * Split a running text stream into complete lines.
+ *
+ * Given the leftover `pending` text from the previous chunk and a new `chunk`,
+ * return the complete lines finished by this chunk (without their trailing
+ * newline) and the new `pending` remainder (text after the last newline, which
+ * may be empty). Handles `\n` and `\r\n`. A chunk with no newline yields no
+ * lines and grows `pending`.
+ */
+export declare function splitStream(pending: string, chunk: string): {
+    lines: string[];
+    pending: string;
+};
+/**
+ * Spawn a command, collect its output, and resolve an {@link ExecResult}.
+ * Never rejects: a spawn error resolves with a non-zero exit code and the error
+ * text on stderr. If `onLog` is given, each complete output line is delivered as
+ * it arrives. A `timeoutMs` kills the process and sets `timedOut`.
+ */
+export declare function spawnCollect(command: readonly string[], options?: ExecOptions & {
+    onLog?: (line: LogLine) => void;
+}): Promise<ExecResult>;
+//# sourceMappingURL=proc.d.ts.map

package/dist/backend/proc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proc.d.ts","sourceRoot":"","sources":["../../src/backend/proc.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEnE;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAMhG;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,GAAE,WAAW,GAAG;IAAE,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;CAAO,GAC9D,OAAO,CAAC,UAAU,CAAC,CA+ErB"}

package/dist/backend/proc.js

@@ -0,0 +1,103 @@
+import { spawn } from "node:child_process";
+import process from "node:process";
+/**
+ * Split a running text stream into complete lines.
+ *
+ * Given the leftover `pending` text from the previous chunk and a new `chunk`,
+ * return the complete lines finished by this chunk (without their trailing
+ * newline) and the new `pending` remainder (text after the last newline, which
+ * may be empty). Handles `\n` and `\r\n`. A chunk with no newline yields no
+ * lines and grows `pending`.
+ */
+export function splitStream(pending, chunk) {
+    const combined = pending + chunk;
+    const parts = combined.split("\n");
+    const rest = parts.pop() ?? "";
+    const lines = parts.map((line) => (line.endsWith("\r") ? line.slice(0, -1) : line));
+    return { lines, pending: rest };
+}
+/**
+ * Spawn a command, collect its output, and resolve an {@link ExecResult}.
+ * Never rejects: a spawn error resolves with a non-zero exit code and the error
+ * text on stderr. If `onLog` is given, each complete output line is delivered as
+ * it arrives. A `timeoutMs` kills the process and sets `timedOut`.
+ */
+export function spawnCollect(command, options = {}) {
+    const [file, ...args] = command;
+    const start = Date.now();
+    if (file === undefined) {
+        return Promise.resolve({
+            exitCode: 1,
+            stdout: "",
+            stderr: "spawnCollect: empty command",
+            durationMs: 0,
+            timedOut: false,
+        });
+    }
+    return new Promise((resolve) => {
+        // detached: the child leads its own process group, so a timeout can kill the
+        // whole tree (shell + its children), not just the shell — otherwise a killed
+        // shell's grandchildren keep the pipes open and the call hangs.
+        const child = spawn(file, args, {
+            cwd: options.cwd,
+            env: options.env ? { ...process.env, ...options.env } : process.env,
+            detached: true,
+        });
+        const killTree = () => {
+            if (child.pid === undefined)
+                return;
+            try {
+                process.kill(-child.pid, "SIGKILL");
+            }
+            catch {
+                child.kill("SIGKILL");
+            }
+        };
+        let stdout = "";
+        let stderr = "";
+        let timedOut = false;
+        let settled = false;
+        const pending = { stdout: "", stderr: "" };
+        const onData = (which) => (buf) => {
+            const text = buf.toString("utf8");
+            if (which === "stdout")
+                stdout += text;
+            else
+                stderr += text;
+            if (options.onLog) {
+                const split = splitStream(pending[which], text);
+                pending[which] = split.pending;
+                for (const line of split.lines)
+                    options.onLog({ stream: which, text: line });
+            }
+        };
+        child.stdout?.on("data", onData("stdout"));
+        child.stderr?.on("data", onData("stderr"));
+        const timer = options.timeoutMs !== undefined
+            ? setTimeout(() => {
+                timedOut = true;
+                killTree();
+            }, options.timeoutMs)
+            : undefined;
+        const finish = (exitCode) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timer)
+                clearTimeout(timer);
+            if (options.onLog) {
+                for (const which of ["stdout", "stderr"]) {
+                    if (pending[which].length > 0)
+                        options.onLog({ stream: which, text: pending[which] });
+                }
+            }
+            resolve({ exitCode, stdout, stderr, durationMs: Date.now() - start, timedOut });
+        };
+        child.on("error", (error) => {
+            stderr += `${error instanceof Error ? error.message : String(error)}\n`;
+            finish(127);
+        });
+        child.on("close", (code) => finish(timedOut ? 124 : (code ?? 0)));
+    });
+}
+//# sourceMappingURL=proc.js.map

package/dist/backend/proc.js.map

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

package/dist/backend/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * The backend adapter contract: the isolation seam and the heart of
+ * "optionality for back ends". Every backend (local-worktree, container,
+ * and later Firecracker/E2B/remote) implements the same five verbs so the loop,
+ * the agent, and the gate never care where a run physically executes.
+ *
+ * The five verbs from the research spec map onto this interface as:
+ *   provision -> provision(), exec -> exec(), stream -> stream(),
+ *   result    -> the resolved ExecResult, teardown -> teardown().
+ */
+/** How to create an isolated workspace for one item. */
+export interface ProvisionSpec {
+    /** Absolute path to the source git repository on the host. */
+    repoPath: string;
+    /** Existing ref to branch from (e.g. "main"). Ignored when `mode` is "attach". */
+    baseBranch: string;
+    /** The branch to work on: created when `mode` is "create", checked out when "attach". */
+    branch: string;
+    /**
+     * "create" (default) makes a new `branch` off `baseBranch`; "attach" checks out
+     * an existing `branch` (e.g. a PR's head branch, for the respond pass).
+     */
+    mode?: "create" | "attach";
+    /** Container image, for backends that need one. Ignored by local-worktree. */
+    image?: string;
+}
+/** A provisioned, isolated working copy. Opaque handle addressed by `ref`. */
+export interface Workspace {
+    /** Unique id for this provisioning. */
+    id: string;
+    /** The backend kind that produced it. */
+    backend: string;
+    /**
+     * How the backend addresses the workspace: a host directory for
+     * local-worktree, a container name for container. Not assumed host-readable.
+     */
+    ref: string;
+    /** The branch the work happens on. */
+    branch: string;
+}
+export interface ExecOptions {
+    /** Directory to run in, relative to the workspace root. */
+    cwd?: string;
+    /** Extra environment variables for the command. */
+    env?: Record<string, string>;
+    /** Kill the command and set `timedOut` after this many milliseconds. */
+    timeoutMs?: number;
+}
+/** The outcome of running a command in a workspace (the "result" verb). */
+export interface ExecResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+    /** True when the command was killed for exceeding `timeoutMs`. */
+    timedOut: boolean;
+}
+/** One line of streamed command output. */
+export interface LogLine {
+    stream: "stdout" | "stderr";
+    text: string;
+}
+/** A pluggable isolation backend. */
+export interface Backend {
+    readonly kind: string;
+    /** Create an isolated workspace on `spec.branch`, based on `spec.baseBranch`. */
+    provision(spec: ProvisionSpec): Promise<Workspace>;
+    /** Run a command to completion in the workspace and return its result. */
+    exec(workspace: Workspace, command: readonly string[], options?: ExecOptions): Promise<ExecResult>;
+    /** Like {@link Backend.exec}, but delivers each output line to `onLog` as it arrives. */
+    stream(workspace: Workspace, command: readonly string[], onLog: (line: LogLine) => void, options?: ExecOptions): Promise<ExecResult>;
+    /** Destroy the workspace and its resources. Idempotent: a second call is a no-op. */
+    teardown(workspace: Workspace): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/backend/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/backend/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2EAA2E;AAC3E,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,2CAA2C;AAC3C,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qCAAqC;AACrC,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACnD,0EAA0E;IAC1E,IAAI,CACF,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,yFAAyF;IACzF,MAAM,CACJ,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,EAC9B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,qFAAqF;IACrF,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C"}

package/dist/backend/types.js

@@ -0,0 +1,12 @@
+/**
+ * The backend adapter contract: the isolation seam and the heart of
+ * "optionality for back ends". Every backend (local-worktree, container,
+ * and later Firecracker/E2B/remote) implements the same five verbs so the loop,
+ * the agent, and the gate never care where a run physically executes.
+ *
+ * The five verbs from the research spec map onto this interface as:
+ *   provision -> provision(), exec -> exec(), stream -> stream(),
+ *   result    -> the resolved ExecResult, teardown -> teardown().
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/backend/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/backend/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

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

package/dist/bin.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import process from "node:process";
+import { run } from "./cli.js";
+run(process.argv.slice(2))
+    .then((code) => process.exit(code))
+    .catch((error) => {
+    process.stderr.write(`ghostrail: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACvB,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAClC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/board/index.d.ts

@@ -0,0 +1,4 @@
+export { type BoardOptions, createBoardServer, parseRoute, type Route } from "./server.js";
+export { PAGE_HTML } from "./page.js";
+export { computeStats, type Stats } from "./stats.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/board/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/board/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/board/index.js

@@ -0,0 +1,4 @@
+export { createBoardServer, parseRoute } from "./server.js";
+export { PAGE_HTML } from "./page.js";
+export { computeStats } from "./stats.js";
+//# sourceMappingURL=index.js.map

package/dist/board/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/board/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,iBAAiB,EAAE,UAAU,EAAc,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC"}

package/dist/board/page.d.ts

@@ -0,0 +1,3 @@
+/** The self-contained board page: polls the read API and renders runs + stats. */
+export declare const PAGE_HTML = "<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\" />\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n<title>ghostrail board</title>\n<style>\n  :root { color-scheme: light dark; }\n  body { font: 14px/1.5 system-ui, sans-serif; margin: 0; padding: 1.5rem; }\n  h1 { font-size: 1.1rem; margin: 0 0 1rem; }\n  .stats { display: flex; gap: 1rem; flex-wrap: wrap; margin-bottom: 1rem; }\n  .stat { border: 1px solid #8884; border-radius: 8px; padding: .5rem .75rem; }\n  .stat b { display: block; font-size: 1.3rem; }\n  table { border-collapse: collapse; width: 100%; }\n  th, td { text-align: left; padding: .4rem .6rem; border-bottom: 1px solid #8883; }\n  .state { font-weight: 600; }\n  .done { color: #2a9d3a; } .failed { color: #d33; } .blocked { color: #d90; }\n  .noop, .skipped { opacity: .6; } .muted { opacity: .6; }\n  a { color: inherit; }\n</style>\n</head>\n<body>\n<h1>ghostrail board</h1>\n<div class=\"stats\" id=\"stats\"></div>\n<table><thead><tr><th>Run</th><th>Item</th><th>State</th><th>Backend</th><th>Gate</th><th>PR</th><th>When</th></tr></thead>\n<tbody id=\"rows\"></tbody></table>\n<script>\nconst esc = (s) => String(s ?? \"\").replace(/[&<>]/g, (c) => ({ \"&\": \"&amp;\", \"<\": \"&lt;\", \">\": \"&gt;\" }[c]));\nasync function refresh() {\n  const [runs, stats] = await Promise.all([\n    fetch(\"api/runs\").then((r) => r.json()),\n    fetch(\"api/stats\").then((r) => r.json()),\n  ]);\n  document.getElementById(\"stats\").innerHTML = [\n    [\"runs\", stats.total],\n    [\"success\", (stats.successRate * 100).toFixed(0) + \"%\"],\n    [\"PRs\", stats.prCount],\n  ].map(([k, v]) => '<div class=\"stat\"><b>' + esc(v) + \"</b>\" + esc(k) + \"</div>\").join(\"\");\n  document.getElementById(\"rows\").innerHTML = runs.map((r) => {\n    const gate = (r.gate || []).map((s) => (s.exitCode === 0 ? \"\u2713\" : \"\u2717\")).join(\"\");\n    const pr = r.prUrl ? '<a href=\"' + esc(r.prUrl) + '\">#' + esc(r.prNumber) + \"</a>\" : \"\";\n    const when = r.startedAt ? new Date(r.startedAt).toLocaleString() : \"\";\n    const state = esc(r.state || \"in-progress\");\n    return \"<tr><td class=muted>\" + esc(r.runId.slice(0, 8)) + \"</td><td>\" + esc(r.title || r.itemId || \"\") +\n      '</td><td class=\"state ' + state + '\">' + state + \"</td><td>\" + esc(r.backend || \"\") +\n      \"</td><td>\" + gate + \"</td><td>\" + pr + \"</td><td class=muted>\" + esc(when) + \"</td></tr>\";\n  }).join(\"\");\n}\nrefresh();\nsetInterval(refresh, 5000);\n</script>\n</body>\n</html>";
+//# sourceMappingURL=page.d.ts.map

package/dist/board/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/board/page.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,eAAO,MAAM,SAAS,ugFAoDd,CAAC"}