ghostrail 0.0.0

package/dist/config/schema.js

@@ -0,0 +1,35 @@
+/**
+ * The typed ghostrail configuration, normalized from `ghostrail.toml`.
+ *
+ * The TOML uses snake_case keys (`base_branch`, `allowed_tools`, ...); parsing
+ * normalizes them to the camelCase fields below. Only the Phase 0 surface is
+ * modeled here; `[store]` and `[board]` arrive in later phases.
+ */
+export const SOURCE_KINDS = ["linear", "github-issues", "beads"];
+export const BACKEND_KINDS = [
+    "local-worktree",
+    "container",
+    "firecracker",
+    "e2b",
+    "remote",
+];
+/** Default agent tool allowlist: read + write files and run shell/search only. */
+export const DEFAULT_ALLOWED_TOOLS = [
+    "Read",
+    "Edit",
+    "Write",
+    "Bash",
+    "Grep",
+    "Glob",
+];
+/** Guardrail defaults, carried over from the reference factory. */
+export const DEFAULT_GUARDRAILS = {
+    maxItemsPerRun: 3,
+    budgetUsdPerItem: 3,
+    timeoutMs: 30 * 60_000,
+    maxCostUsdPerRun: 5,
+    claimTtlMs: 2 * 3_600_000,
+};
+export const DEFAULT_BASE_BRANCH = "main";
+export const DEFAULT_BACKEND_KIND = "local-worktree";
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,CAAU,CAAC;AAG1E,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,gBAAgB;IAChB,WAAW;IACX,aAAa;IACb,KAAK;IACL,QAAQ;CACA,CAAC;AAuEX,kFAAkF;AAClF,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACtD,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;CACP,CAAC;AAEF,mEAAmE;AACnE,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC5C,cAAc,EAAE,CAAC;IACjB,gBAAgB,EAAE,CAAC;IACnB,SAAS,EAAE,EAAE,GAAG,MAAM;IACtB,gBAAgB,EAAE,CAAC;IACnB,UAAU,EAAE,CAAC,GAAG,SAAS;CAC1B,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAgB,gBAAgB,CAAC"}

package/dist/factory/build.d.ts

@@ -0,0 +1,39 @@
+import type { Backend } from "../backend/types.js";
+import type { GhostrailConfig } from "../config/schema.js";
+import type { GlobalStore } from "../global/store.js";
+import type { LoopDeps } from "../loop/engine.js";
+import type { Lock, Logger, Source } from "../loop/ports.js";
+import { type GhRunner } from "../publish/gh.js";
+import type { RespondConfig, RespondDeps } from "../respond/respond.js";
+/** The store directory inside a repo (gitignored). */
+export declare const STORE_DIR = ".factory";
+/** Runtime inputs the config cannot supply: paths, secrets, and injectables. */
+export interface BuildContext {
+    /** Absolute path to the repo the factory operates on. */
+    repoPath: string;
+    /** Linear personal API key (from the environment, never the config). */
+    linearApiKey: string;
+    /** The global lock instance. */
+    lock: Lock;
+    /** Bot logins whose PR comments the respond pass ignores. */
+    selfLogins?: readonly string[];
+    /** Global store for staging shared artifacts. */
+    globalStore?: GlobalStore;
+    logger?: Logger;
+    fetchImpl?: typeof fetch;
+    ghRunner?: GhRunner;
+}
+/** Construct the isolation backend named by the config. */
+export declare function buildBackend(config: GhostrailConfig): Backend;
+/** Construct the tracker source named by the config (Linear only in Phase 0). */
+export declare function buildSource(config: GhostrailConfig, ctx: BuildContext): Source;
+/** A gh runner that shells out to `gh` in the repo directory. */
+export declare function repoGhRunner(repoPath: string): GhRunner;
+/** Assemble the loop dependencies for `ghostrail run`. */
+export declare function buildLoopDeps(config: GhostrailConfig, ctx: BuildContext): LoopDeps;
+/** Assemble the respond dependencies + config for `ghostrail respond`. */
+export declare function buildRespondDeps(config: GhostrailConfig, ctx: BuildContext): {
+    deps: RespondDeps;
+    config: RespondConfig;
+};
+//# sourceMappingURL=build.d.ts.map

package/dist/factory/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/factory/build.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIxE,sDAAsD;AACtD,eAAO,MAAM,SAAS,aAAa,CAAC;AAGpC,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,IAAI,EAAE,IAAI,CAAC;IACX,6DAA6D;IAC7D,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,iDAAiD;IACjD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAW7D;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,CAa9E;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAEvD;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,YAAY,GAAG,QAAQ,CAmBlF;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,YAAY,GAChB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAkB9C"}

package/dist/factory/build.js

@@ -0,0 +1,85 @@
+import { join } from "node:path";
+import { ClaudeCodeAgent } from "../agent/claude-code.js";
+import { ContainerBackend } from "../backend/container.js";
+import { LocalWorktreeBackend } from "../backend/local-worktree.js";
+import { spawnCollect } from "../backend/proc.js";
+import { CommandGate } from "../gate/gate.js";
+import { GhHost } from "../publish/gh.js";
+import { GitHubPublisher } from "../publish/github-publisher.js";
+import { FileWatermarkStore } from "../respond/store.js";
+import { FileStore } from "../store/file-store.js";
+/** The store directory inside a repo (gitignored). */
+export const STORE_DIR = ".factory";
+import { LinearSource, createFetchRequester } from "../source/linear.js";
+/** Construct the isolation backend named by the config. */
+export function buildBackend(config) {
+    switch (config.backend.kind) {
+        case "local-worktree":
+            return new LocalWorktreeBackend();
+        case "container":
+            return new ContainerBackend();
+        default:
+            throw new Error(`backend "${config.backend.kind}" is not available yet (Phase 0 ships local-worktree and container)`);
+    }
+}
+/** Construct the tracker source named by the config (Linear only in Phase 0). */
+export function buildSource(config, ctx) {
+    if (config.source.kind !== "linear") {
+        throw new Error(`source "${config.source.kind}" is not available yet (Phase 0 ships linear)`);
+    }
+    if (config.source.project === undefined) {
+        throw new Error("source.project is required for the Linear source (used as the team key)");
+    }
+    const requester = createFetchRequester(ctx.linearApiKey, undefined, ctx.fetchImpl ?? fetch);
+    return new LinearSource(requester, {
+        teamKey: config.source.project,
+        eligible: config.source.eligible,
+        maxItems: config.guardrails.maxItemsPerRun,
+    });
+}
+/** A gh runner that shells out to `gh` in the repo directory. */
+export function repoGhRunner(repoPath) {
+    return (args) => spawnCollect(["gh", ...args], { cwd: repoPath });
+}
+/** Assemble the loop dependencies for `ghostrail run`. */
+export function buildLoopDeps(config, ctx) {
+    const backend = buildBackend(config);
+    const host = new GhHost(ctx.ghRunner ?? repoGhRunner(ctx.repoPath));
+    const publisher = new GitHubPublisher(backend, host, {
+        baseBranch: config.factory.baseBranch,
+        draft: config.output.draft,
+    });
+    return {
+        repoPath: ctx.repoPath,
+        source: buildSource(config, ctx),
+        backend,
+        agent: new ClaudeCodeAgent(),
+        gate: new CommandGate(),
+        publisher,
+        lock: ctx.lock,
+        events: new FileStore(join(ctx.repoPath, STORE_DIR)),
+        ...(ctx.globalStore === undefined ? {} : { globalStore: ctx.globalStore }),
+        ...(ctx.logger === undefined ? {} : { logger: ctx.logger }),
+    };
+}
+/** Assemble the respond dependencies + config for `ghostrail respond`. */
+export function buildRespondDeps(config, ctx) {
+    const backend = buildBackend(config);
+    const host = new GhHost(ctx.ghRunner ?? repoGhRunner(ctx.repoPath));
+    const deps = {
+        repoPath: ctx.repoPath,
+        host,
+        backend,
+        agent: new ClaudeCodeAgent(),
+        watermarks: new FileWatermarkStore(join(ctx.repoPath, ".factory", "watermarks.json")),
+        ...(ctx.logger === undefined ? {} : { logger: ctx.logger }),
+    };
+    const respondConfig = {
+        label: "ghostrail",
+        selfLogins: ctx.selfLogins ?? [],
+        agent: config.agent,
+        guardrails: config.guardrails,
+    };
+    return { deps, config: respondConfig };
+}
+//# sourceMappingURL=build.js.map

package/dist/factory/build.js.map

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

package/dist/gate/gate.d.ts

@@ -0,0 +1,12 @@
+import type { Gate, GateContext, GateResult } from "../loop/ports.js";
+/**
+ * The oracle: runs the configured gate commands in order inside the workspace,
+ * through the backend, so it behaves identically on every backend. Each command
+ * is run via `sh -c`, capturing its exit code and duration. It fails fast: the
+ * first non-zero command stops the run and the gate does not pass. An empty
+ * command list passes vacuously.
+ */
+export declare class CommandGate implements Gate {
+    run(context: GateContext): Promise<GateResult>;
+}
+//# sourceMappingURL=gate.d.ts.map

package/dist/gate/gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../src/gate/gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAEtF;;;;;;GAMG;AACH,qBAAa,WAAY,YAAW,IAAI;IAChC,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAkBrD"}

package/dist/gate/gate.js

@@ -0,0 +1,22 @@
+/**
+ * The oracle: runs the configured gate commands in order inside the workspace,
+ * through the backend, so it behaves identically on every backend. Each command
+ * is run via `sh -c`, capturing its exit code and duration. It fails fast: the
+ * first non-zero command stops the run and the gate does not pass. An empty
+ * command list passes vacuously.
+ */
+export class CommandGate {
+    async run(context) {
+        const steps = [];
+        const execOptions = context.timeoutMs === undefined ? {} : { timeoutMs: context.timeoutMs };
+        for (const command of context.commands) {
+            const result = await context.backend.exec(context.workspace, ["sh", "-c", command], execOptions);
+            steps.push({ name: command, exitCode: result.exitCode, durationMs: result.durationMs });
+            if (result.exitCode !== 0) {
+                return { passed: false, steps };
+            }
+        }
+        return { passed: true, steps };
+    }
+}
+//# sourceMappingURL=gate.js.map

package/dist/gate/gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../src/gate/gate.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,WAAW;IACtB,KAAK,CAAC,GAAG,CAAC,OAAoB;QAC5B,MAAM,KAAK,GAAqB,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;QAE5F,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CACvC,OAAO,CAAC,SAAS,EACjB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EACrB,WAAW,CACZ,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YACxF,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAClC,CAAC;QACH,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACjC,CAAC;CACF"}

package/dist/gate/index.d.ts

@@ -0,0 +1,2 @@
+export { CommandGate } from "./gate.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/gate/index.js

@@ -0,0 +1,2 @@
+export { CommandGate } from "./gate.js";
+//# sourceMappingURL=index.js.map

package/dist/gate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/global/index.d.ts

@@ -0,0 +1,3 @@
+export { artifactFileName, type GlobalEnv, GlobalStore, resolveGlobalDir } from "./store.js";
+export { STAGED_ARTIFACTS_DIR, stageArtifacts } from "./stage.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/global/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/global/index.js

@@ -0,0 +1,3 @@
+export { artifactFileName, GlobalStore, resolveGlobalDir } from "./store.js";
+export { STAGED_ARTIFACTS_DIR, stageArtifacts } from "./stage.js";
+//# sourceMappingURL=index.js.map

package/dist/global/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/global/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAkB,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/global/stage.d.ts

@@ -0,0 +1,13 @@
+import type { Backend, Workspace } from "../backend/types.js";
+import type { Logger } from "../loop/ports.js";
+import { type GlobalStore } from "./store.js";
+/** Where staged global artifacts land in a run's workspace. */
+export declare const STAGED_ARTIFACTS_DIR = ".ghostrail/artifacts";
+/**
+ * Copy the named global artifacts into the run's workspace under
+ * `.ghostrail/artifacts/<name>.md`, so the agent (which only reads files) can
+ * use shared references like writing guidelines. Missing artifacts are warned
+ * about and skipped. Returns the names actually staged.
+ */
+export declare function stageArtifacts(backend: Backend, workspace: Workspace, store: GlobalStore, names: readonly string[], logger?: Logger): Promise<string[]>;
+//# sourceMappingURL=stage.d.ts.map

package/dist/global/stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../../src/global/stage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,KAAK,WAAW,EAAoB,MAAM,YAAY,CAAC;AAEhE,+DAA+D;AAC/D,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB"}

package/dist/global/stage.js

@@ -0,0 +1,24 @@
+import { writeWorkspaceFile } from "../backend/fs.js";
+import { artifactFileName } from "./store.js";
+/** Where staged global artifacts land in a run's workspace. */
+export const STAGED_ARTIFACTS_DIR = ".ghostrail/artifacts";
+/**
+ * Copy the named global artifacts into the run's workspace under
+ * `.ghostrail/artifacts/<name>.md`, so the agent (which only reads files) can
+ * use shared references like writing guidelines. Missing artifacts are warned
+ * about and skipped. Returns the names actually staged.
+ */
+export async function stageArtifacts(backend, workspace, store, names, logger) {
+    const staged = [];
+    for (const name of names) {
+        const content = await store.readArtifact(name);
+        if (content === undefined) {
+            logger?.warn(`artifact not found in global store: ${name}`);
+            continue;
+        }
+        await writeWorkspaceFile(backend, workspace, `${STAGED_ARTIFACTS_DIR}/${artifactFileName(name)}`, content);
+        staged.push(name);
+    }
+    return staged;
+}
+//# sourceMappingURL=stage.js.map

package/dist/global/stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.js","sourceRoot":"","sources":["../../src/global/stage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,EAAoB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAgB,EAChB,SAAoB,EACpB,KAAkB,EAClB,KAAwB,EACxB,MAAe;IAEf,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,EAAE,IAAI,CAAC,uCAAuC,IAAI,EAAE,CAAC,CAAC;YAC5D,SAAS;QACX,CAAC;QACD,MAAM,kBAAkB,CACtB,OAAO,EACP,SAAS,EACT,GAAG,oBAAoB,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,EACnD,OAAO,CACR,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/global/store.d.ts

@@ -0,0 +1,30 @@
+export interface GlobalEnv {
+    GHOSTRAIL_HOME?: string;
+    XDG_CONFIG_HOME?: string;
+}
+/**
+ * Resolve the global ghostrail config directory that holds account-level
+ * settings and shared artifacts across all factory instances:
+ * `$GHOSTRAIL_HOME`, else `$XDG_CONFIG_HOME/ghostrail`, else
+ * `<homedir>/.config/ghostrail`. Pure given the environment and home directory.
+ */
+export declare function resolveGlobalDir(env: GlobalEnv, homedir: string): string;
+/** Normalize an artifact name to its `.md` file name. */
+export declare function artifactFileName(name: string): string;
+/**
+ * The global store: account settings (`settings.toml`) and shared artifacts
+ * (`artifacts/<name>.md`) reusable by every local factory instance. An artifact
+ * is looked up by name with or without the `.md` suffix.
+ */
+export declare class GlobalStore {
+    private readonly dir;
+    constructor(dir: string);
+    settingsPath(): string;
+    /** The `settings.toml` contents, or undefined if there is none. */
+    readSettings(): Promise<string | undefined>;
+    /** Artifact base names present in the store, sorted. */
+    listArtifacts(): Promise<string[]>;
+    /** An artifact's contents by name (with or without `.md`), or undefined. */
+    readArtifact(name: string): Promise<string | undefined>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/global/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/global/store.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAOxE;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,GAAG,EAAE,MAAM;IAIvB,YAAY,IAAI,MAAM;IAItB,mEAAmE;IAC7D,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAQjD,wDAAwD;IAClD,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAQxC,4EAA4E;IACtE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAU9D"}

package/dist/global/store.js

@@ -0,0 +1,65 @@
+import { readFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+/**
+ * Resolve the global ghostrail config directory that holds account-level
+ * settings and shared artifacts across all factory instances:
+ * `$GHOSTRAIL_HOME`, else `$XDG_CONFIG_HOME/ghostrail`, else
+ * `<homedir>/.config/ghostrail`. Pure given the environment and home directory.
+ */
+export function resolveGlobalDir(env, homedir) {
+    if (env.GHOSTRAIL_HOME !== undefined && env.GHOSTRAIL_HOME.length > 0)
+        return env.GHOSTRAIL_HOME;
+    const base = env.XDG_CONFIG_HOME !== undefined && env.XDG_CONFIG_HOME.length > 0
+        ? env.XDG_CONFIG_HOME
+        : join(homedir, ".config");
+    return join(base, "ghostrail");
+}
+/** Normalize an artifact name to its `.md` file name. */
+export function artifactFileName(name) {
+    return name.endsWith(".md") ? name : `${name}.md`;
+}
+/**
+ * The global store: account settings (`settings.toml`) and shared artifacts
+ * (`artifacts/<name>.md`) reusable by every local factory instance. An artifact
+ * is looked up by name with or without the `.md` suffix.
+ */
+export class GlobalStore {
+    dir;
+    constructor(dir) {
+        this.dir = dir;
+    }
+    settingsPath() {
+        return join(this.dir, "settings.toml");
+    }
+    /** The `settings.toml` contents, or undefined if there is none. */
+    async readSettings() {
+        try {
+            return await readFile(this.settingsPath(), "utf8");
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /** Artifact base names present in the store, sorted. */
+    async listArtifacts() {
+        try {
+            return (await readdir(join(this.dir, "artifacts"))).sort();
+        }
+        catch {
+            return [];
+        }
+    }
+    /** An artifact's contents by name (with or without `.md`), or undefined. */
+    async readArtifact(name) {
+        for (const candidate of new Set([name, artifactFileName(name)])) {
+            try {
+                return await readFile(join(this.dir, "artifacts", candidate), "utf8");
+            }
+            catch {
+                // try the next candidate
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/global/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/global/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAOjC;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAc,EAAE,OAAe;IAC9D,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS,IAAI,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,cAAc,CAAC;IACjG,MAAM,IAAI,GACR,GAAG,CAAC,eAAe,KAAK,SAAS,IAAI,GAAG,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;QACjE,CAAC,CAAC,GAAG,CAAC,eAAe;QACrB,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC/B,OAAO,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AACjC,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACL,GAAG,CAAS;IAE7B,YAAY,GAAW;QACrB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IACzC,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,MAAM,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,YAAY,CAAC,IAAY;QAC7B,KAAK,MAAM,SAAS,IAAI,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,IAAI,CAAC;gBACH,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;YACxE,CAAC;YAAC,MAAM,CAAC;gBACP,yBAAyB;YAC3B,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/lock/file-lock.d.ts

@@ -0,0 +1,16 @@
+import type { Lock } from "../loop/ports.js";
+/**
+ * A single-holder lock backed by an atomic `mkdir` (the `flock` analog), so only
+ * one tick runs at a time even across processes. A lock older than `staleMs`
+ * (e.g. from a crashed run) is considered abandoned and reclaimed once.
+ */
+export declare class FileLock implements Lock {
+    private readonly dir;
+    private readonly staleMs;
+    constructor(dir: string, staleMs?: number);
+    acquire(): Promise<boolean>;
+    release(): Promise<void>;
+    private tryMkdir;
+    private isStale;
+}
+//# sourceMappingURL=file-lock.d.ts.map

package/dist/lock/file-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-lock.d.ts","sourceRoot":"","sources":["../../src/lock/file-lock.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;GAIG;AACH,qBAAa,QAAS,YAAW,IAAI;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,GAAG,EAAE,MAAM,EAAE,OAAO,SAAgB;IAK1C,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAS3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAIhB,QAAQ;YAYR,OAAO;CAQtB"}

package/dist/lock/file-lock.js

@@ -0,0 +1,51 @@
+import { mkdir, rm, stat, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import process from "node:process";
+/**
+ * A single-holder lock backed by an atomic `mkdir` (the `flock` analog), so only
+ * one tick runs at a time even across processes. A lock older than `staleMs`
+ * (e.g. from a crashed run) is considered abandoned and reclaimed once.
+ */
+export class FileLock {
+    dir;
+    staleMs;
+    constructor(dir, staleMs = 2 * 3_600_000) {
+        this.dir = dir;
+        this.staleMs = staleMs;
+    }
+    async acquire() {
+        if (await this.tryMkdir())
+            return true;
+        if (await this.isStale()) {
+            await rm(this.dir, { recursive: true, force: true });
+            return this.tryMkdir();
+        }
+        return false;
+    }
+    async release() {
+        await rm(this.dir, { recursive: true, force: true });
+    }
+    async tryMkdir() {
+        try {
+            await mkdir(dirname(this.dir), { recursive: true });
+            await mkdir(this.dir);
+            await writeFile(join(this.dir, "owner"), `${process.pid}\n`, "utf8");
+            return true;
+        }
+        catch (error) {
+            if (error.code === "EEXIST")
+                return false;
+            throw error;
+        }
+    }
+    async isStale() {
+        try {
+            const info = await stat(this.dir);
+            return Date.now() - info.mtimeMs > this.staleMs;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=file-lock.js.map

package/dist/lock/file-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-lock.js","sourceRoot":"","sources":["../../src/lock/file-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,OAAO,MAAM,cAAc,CAAC;AAGnC;;;;GAIG;AACH,MAAM,OAAO,QAAQ;IACF,GAAG,CAAS;IACZ,OAAO,CAAS;IAEjC,YAAY,GAAW,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS;QAC9C,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,MAAM,IAAI,CAAC,QAAQ,EAAE;YAAE,OAAO,IAAI,CAAC;QACvC,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YACzB,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAEO,KAAK,CAAC,QAAQ;QACpB,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtB,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;YACrE,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACrE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/loop/branch.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Turn a title into a short, git-safe slug: lowercase, non-alphanumeric runs
+ * collapsed to single hyphens, leading/trailing hyphens trimmed, and truncated
+ * to `maxLength` characters (trimming a trailing hyphen left by truncation).
+ * An empty or all-punctuation title yields "".
+ */
+export declare function slugify(title: string, maxLength?: number): string;
+/**
+ * Build the working branch for an item: `<prefix>/<id>-<slug(title)>`, with the
+ * id lowercased. When the title slugs to nothing, the branch is
+ * `<prefix>/<id>` with no trailing hyphen.
+ */
+export declare function branchName(prefix: string, id: string, title: string): string;
+//# sourceMappingURL=branch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"branch.d.ts","sourceRoot":"","sources":["../../src/loop/branch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,MAAM,CAM7D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI5E"}

package/dist/loop/branch.js

@@ -0,0 +1,24 @@
+/**
+ * Turn a title into a short, git-safe slug: lowercase, non-alphanumeric runs
+ * collapsed to single hyphens, leading/trailing hyphens trimmed, and truncated
+ * to `maxLength` characters (trimming a trailing hyphen left by truncation).
+ * An empty or all-punctuation title yields "".
+ */
+export function slugify(title, maxLength = 40) {
+    const slug = title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug.slice(0, maxLength).replace(/-+$/g, "");
+}
+/**
+ * Build the working branch for an item: `<prefix>/<id>-<slug(title)>`, with the
+ * id lowercased. When the title slugs to nothing, the branch is
+ * `<prefix>/<id>` with no trailing hyphen.
+ */
+export function branchName(prefix, id, title) {
+    const base = `${prefix}/${id.toLowerCase()}`;
+    const slug = slugify(title);
+    return slug === "" ? base : `${base}-${slug}`;
+}
+//# sourceMappingURL=branch.js.map

package/dist/loop/branch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch.js","sourceRoot":"","sources":["../../src/loop/branch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,SAAS,GAAG,EAAE;IACnD,MAAM,IAAI,GAAG,KAAK;SACf,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,EAAU,EAAE,KAAa;IAClE,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;AAChD,CAAC"}

package/dist/loop/engine.d.ts

@@ -0,0 +1,37 @@
+import type { Backend } from "../backend/types.js";
+import type { GhostrailConfig } from "../config/schema.js";
+import type { GlobalStore } from "../global/store.js";
+import type { EventSink } from "../store/events.js";
+import type { Agent, Gate, Lock, Logger, Publisher, Source } from "./ports.js";
+import type { TickResult } from "./record.js";
+/** The adapters and services a tick runs against. */
+export interface LoopDeps {
+    /** Absolute path to the source git repository the factory provisions from. */
+    repoPath: string;
+    source: Source;
+    backend: Backend;
+    agent: Agent;
+    gate: Gate;
+    publisher: Publisher;
+    lock: Lock;
+    logger?: Logger;
+    /** Optional run-event sink (the store). Omit to record nothing. */
+    events?: EventSink;
+    /** Optional global store for staging shared artifacts into the workspace. */
+    globalStore?: GlobalStore;
+}
+/**
+ * Run one factory tick: discover eligible work, and for each item (up to the
+ * `max_items_per_run` guardrail) claim it, provision an isolated workspace, run
+ * the agent, gate a successful change, and route the outcome to a PR (done),
+ * back to a human (blocked), or to a reset (failed/noop). The whole tick runs
+ * under a single global lock so only one tick executes at a time; if the lock
+ * is already held, nothing runs.
+ *
+ * The loop owns no tracker, git, or agent specifics: every side effect goes
+ * through the injected ports, and the agent and gate run their commands through
+ * the backend. Auto-merge is never performed here; a green run ends at an open
+ * pull request.
+ */
+export declare function runTick(deps: LoopDeps, config: GhostrailConfig): Promise<TickResult>;
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/loop/engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EACV,KAAK,EAEL,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,SAAS,EACT,MAAM,EAEP,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzD,qDAAqD;AACrD,MAAM,WAAW,QAAQ;IACvB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAwDD;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAuB1F"}