ghostrail 0.0.0

package/dist/cli.js

@@ -0,0 +1,45 @@
+import process from "node:process";
+import { parseArgs } from "./args.js";
+import { cmdArtifacts, cmdBoard, cmdInit, cmdRespond, cmdRun } from "./cli/commands.js";
+import { renderHelp } from "./commands/help.js";
+import { VERSION } from "./version.js";
+const defaultStreams = {
+    out: (text) => process.stdout.write(text),
+    err: (text) => process.stderr.write(text),
+};
+/**
+ * Execute the ghostrail CLI for the given arguments (argv with the node binary
+ * and script path already stripped) and resolve the intended process exit code.
+ * Subcommands (`run`, `respond`) dispatch to their handlers; otherwise the
+ * top-level flags (`help`, `version`) are handled here.
+ *
+ * `run` performs no process-level side effects beyond writing to the provided
+ * streams and whatever the dispatched command does.
+ */
+export async function run(argv, streams = defaultStreams) {
+    const [first, ...rest] = argv;
+    if (first === "run")
+        return cmdRun(rest, streams);
+    if (first === "respond")
+        return cmdRespond(rest, streams);
+    if (first === "board")
+        return cmdBoard(rest, streams);
+    if (first === "init")
+        return cmdInit(rest, streams);
+    if (first === "artifacts")
+        return cmdArtifacts(rest, streams);
+    const parsed = parseArgs(argv);
+    switch (parsed.command) {
+        case "version":
+            streams.out(`${VERSION}\n`);
+            return 0;
+        case "help":
+            streams.out(`${renderHelp()}\n`);
+            return 0;
+        case "unknown":
+            streams.err(`ghostrail: unknown command '${parsed.raw}'\n\n`);
+            streams.out(`${renderHelp()}\n`);
+            return 1;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAQvC,MAAM,cAAc,GAAY;IAC9B,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;IACzC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;CAC1C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,IAAuB,EACvB,UAAmB,cAAc;IAEjC,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9B,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1D,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtD,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACpD,IAAI,KAAK,KAAK,WAAW;QAAE,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE9D,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,KAAK,SAAS;YACZ,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;YAC5B,OAAO,CAAC,CAAC;QACX,KAAK,MAAM;YACT,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,EAAE,IAAI,CAAC,CAAC;YACjC,OAAO,CAAC,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,CAAC,GAAG,CAAC,+BAA+B,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC;YAC9D,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,EAAE,IAAI,CAAC,CAAC;YACjC,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/commands/help.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Render the top-level help text shown by `ghostrail help` and printed
+ * alongside the error on unknown input.
+ */
+export declare function renderHelp(): string;
+//# sourceMappingURL=help.d.ts.map

package/dist/commands/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAsBnC"}

package/dist/commands/help.js

@@ -0,0 +1,29 @@
+import { VERSION } from "../version.js";
+/**
+ * Render the top-level help text shown by `ghostrail help` and printed
+ * alongside the error on unknown input.
+ */
+export function renderHelp() {
+    return [
+        `ghostrail ${VERSION} — open source software factory for coding agents`,
+        "",
+        "Usage:",
+        "  ghostrail <command> [options]",
+        "",
+        "Commands:",
+        "  init <t>    Scaffold a repo from a template (fix-bugs-local, content-loop)",
+        "  run         Drain eligible work once: claim, isolate, run, gate, open PRs",
+        "  respond     Fold new human PR comments back into their branches",
+        "  board       Serve the run store as a local dashboard",
+        "  artifacts   List shared artifacts in the global store",
+        "  help        Show this help",
+        "  version     Show the ghostrail version",
+        "",
+        "Options (run, respond):",
+        "  -c, --config <path>   Config file (default: ghostrail.toml)",
+        "  -C, --repo <path>     Repo to operate on (default: cwd)",
+        "",
+        "Docs: https://ghostrail.dev",
+    ].join("\n");
+}
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,aAAa,OAAO,mDAAmD;QACvE,EAAE;QACF,QAAQ;QACR,iCAAiC;QACjC,EAAE;QACF,WAAW;QACX,8EAA8E;QAC9E,6EAA6E;QAC7E,mEAAmE;QACnE,wDAAwD;QACxD,yDAAyD;QACzD,8BAA8B;QAC9B,0CAA0C;QAC1C,EAAE;QACF,yBAAyB;QACzB,+DAA+D;QAC/D,2DAA2D;QAC3D,EAAE;QACF,6BAA6B;KAC9B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/config/duration.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Parse a short duration string into milliseconds.
+ *
+ * Accepts a whole, positive number followed by a single unit suffix:
+ * `s` (seconds), `m` (minutes), or `h` (hours). Surrounding whitespace is
+ * ignored; the input is case-sensitive on the unit. Examples: `"30m"`,
+ * `"2h"`, `"90s"`.
+ *
+ * Returns the duration in milliseconds, or `null` if the string is not a valid
+ * duration (empty, no unit, non-integer, zero/negative, unknown unit, or extra
+ * characters).
+ */
+export declare function parseDuration(input: string): number | null;
+//# sourceMappingURL=duration.d.ts.map

package/dist/config/duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../src/config/duration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW1D"}

package/dist/config/duration.js

@@ -0,0 +1,25 @@
+/**
+ * Parse a short duration string into milliseconds.
+ *
+ * Accepts a whole, positive number followed by a single unit suffix:
+ * `s` (seconds), `m` (minutes), or `h` (hours). Surrounding whitespace is
+ * ignored; the input is case-sensitive on the unit. Examples: `"30m"`,
+ * `"2h"`, `"90s"`.
+ *
+ * Returns the duration in milliseconds, or `null` if the string is not a valid
+ * duration (empty, no unit, non-integer, zero/negative, unknown unit, or extra
+ * characters).
+ */
+export function parseDuration(input) {
+    const trimmed = input.trim();
+    const match = /^(\d+)(s|m|h)$/.exec(trimmed);
+    if (match === null)
+        return null;
+    const amount = Number(match[1]);
+    if (!Number.isSafeInteger(amount) || amount <= 0)
+        return null;
+    const unit = match[2];
+    const unitMs = unit === "s" ? 1_000 : unit === "m" ? 60_000 : 3_600_000;
+    return amount * unitMs;
+}
+//# sourceMappingURL=duration.js.map

package/dist/config/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../../src/config/duration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9D,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,MAAM,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACxE,OAAO,MAAM,GAAG,MAAM,CAAC;AACzB,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,5 @@
+export { parseDuration } from "./duration.js";
+export { deepMerge, parseConfig, parseMergedConfig, validateConfigObject } from "./load.js";
+export type { ConfigError, Result } from "./result.js";
+export * from "./schema.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAC5F,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACvD,cAAc,aAAa,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,4 @@
+export { parseDuration } from "./duration.js";
+export { deepMerge, parseConfig, parseMergedConfig, validateConfigObject } from "./load.js";
+export * from "./schema.js";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAE5F,cAAc,aAAa,CAAC"}

package/dist/config/load.d.ts

@@ -0,0 +1,26 @@
+import { type Result } from "./result.js";
+import { type GhostrailConfig } from "./schema.js";
+/**
+ * Parse and validate a `ghostrail.toml` document into a normalized config.
+ *
+ * On success the returned config has every optional field filled with its
+ * default. On failure every problem found is reported (parsing does not stop at
+ * the first error), each addressed by a dotted path such as `backend.kind`.
+ * A TOML syntax error is reported as a single error at the root path `""`.
+ */
+export declare function parseConfig(toml: string): Result<GhostrailConfig>;
+/** Validate an already-parsed config object (used after merging global settings). */
+export declare function validateConfigObject(root: Record<string, unknown>): Result<GhostrailConfig>;
+/**
+ * Deep-merge two TOML tables, with `override` winning: nested tables merge
+ * recursively; arrays and scalars from `override` replace those in `base`. Used
+ * to layer a repo's config over the global account defaults.
+ */
+export declare function deepMerge(base: Record<string, unknown>, override: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Parse a repo config layered over optional global account settings (repo wins),
+ * then validate the merged result. A TOML syntax error in either document is
+ * reported at the root path.
+ */
+export declare function parseMergedConfig(repoToml: string, globalToml?: string): Result<GhostrailConfig>;
+//# sourceMappingURL=load.d.ts.map

package/dist/config/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,MAAM,EAAW,MAAM,aAAa,CAAC;AACrE,OAAO,EAYL,KAAK,eAAe,EAMrB,MAAM,aAAa,CAAC;AAgQrB;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,CAYjE;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,eAAe,CAAC,CAa3F;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,CAOhG"}

package/dist/config/load.js

@@ -0,0 +1,306 @@
+import { TomlError, parse as parseToml } from "smol-toml";
+import { parseDuration } from "./duration.js";
+import { err, ok } from "./result.js";
+import { BACKEND_KINDS, DEFAULT_ALLOWED_TOOLS, DEFAULT_BACKEND_KIND, DEFAULT_BASE_BRANCH, DEFAULT_GUARDRAILS, SOURCE_KINDS, } from "./schema.js";
+/** True for a plain object (a TOML table), excluding arrays and null. */
+function isTable(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function join(base, key) {
+    return base === "" ? key : `${base}.${key}`;
+}
+/** Accumulates validation errors while walking the parsed config tree. */
+class Ctx {
+    errors = [];
+    add(path, message) {
+        this.errors.push({ path, message });
+    }
+    /** Read a required non-empty string; records an error and returns undefined if absent/wrong. */
+    requiredString(table, key, path) {
+        const value = table[key];
+        if (value === undefined) {
+            this.add(join(path, key), "is required");
+            return undefined;
+        }
+        if (typeof value !== "string" || value.length === 0) {
+            this.add(join(path, key), "must be a non-empty string");
+            return undefined;
+        }
+        return value;
+    }
+    optionalString(table, key, path) {
+        const value = table[key];
+        if (value === undefined)
+            return undefined;
+        if (typeof value !== "string" || value.length === 0) {
+            this.add(join(path, key), "must be a non-empty string");
+            return undefined;
+        }
+        return value;
+    }
+    optionalBool(table, key, path, fallback) {
+        const value = table[key];
+        if (value === undefined)
+            return fallback;
+        if (typeof value !== "boolean") {
+            this.add(join(path, key), "must be a boolean");
+            return fallback;
+        }
+        return value;
+    }
+    /** Read a positive, finite number; records an error and returns the fallback otherwise. */
+    positiveNumber(table, key, path, fallback) {
+        const value = table[key];
+        if (value === undefined)
+            return fallback;
+        if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+            this.add(join(path, key), "must be a number greater than 0");
+            return fallback;
+        }
+        return value;
+    }
+    /** Read a duration string (e.g. "30m") as milliseconds; records an error otherwise. */
+    durationMs(table, key, path, fallbackMs) {
+        const value = table[key];
+        if (value === undefined)
+            return fallbackMs;
+        if (typeof value !== "string") {
+            this.add(join(path, key), 'must be a duration string like "30m", "2h", or "90s"');
+            return fallbackMs;
+        }
+        const ms = parseDuration(value);
+        if (ms === null) {
+            this.add(join(path, key), `is not a valid duration: ${JSON.stringify(value)}`);
+            return fallbackMs;
+        }
+        return ms;
+    }
+    /** Read an array of non-empty strings; records an error and returns undefined otherwise. */
+    stringArray(table, key, path) {
+        const value = table[key];
+        if (value === undefined)
+            return undefined;
+        if (!Array.isArray(value) || value.some((v) => typeof v !== "string" || v.length === 0)) {
+            this.add(join(path, key), "must be an array of non-empty strings");
+            return undefined;
+        }
+        return value;
+    }
+}
+function validateFactory(ctx, root) {
+    const table = root.factory;
+    if (!isTable(table)) {
+        ctx.add("factory", "is required");
+        return { name: "", baseBranch: DEFAULT_BASE_BRANCH };
+    }
+    const name = ctx.requiredString(table, "name", "factory") ?? "";
+    const baseBranch = ctx.optionalString(table, "base_branch", "factory") ?? DEFAULT_BASE_BRANCH;
+    return { name, baseBranch };
+}
+function validateEligible(ctx, source) {
+    const raw = source.eligible;
+    if (raw === undefined)
+        return { labels: [], unassigned: true };
+    if (!isTable(raw)) {
+        ctx.add("source.eligible", "must be a table");
+        return { labels: [], unassigned: true };
+    }
+    const state = ctx.optionalString(raw, "state", "source.eligible");
+    const unassigned = ctx.optionalBool(raw, "unassigned", "source.eligible", true);
+    let labels = [];
+    const label = raw.label;
+    if (typeof label === "string" && label.length > 0) {
+        labels = [label];
+    }
+    else if (Array.isArray(label) && label.every((l) => typeof l === "string" && l.length > 0)) {
+        labels = label;
+    }
+    else if (label !== undefined) {
+        ctx.add("source.eligible.label", "must be a non-empty string or an array of non-empty strings");
+    }
+    return state === undefined ? { labels, unassigned } : { state, labels, unassigned };
+}
+function validateSource(ctx, root) {
+    const table = root.source;
+    if (!isTable(table)) {
+        ctx.add("source", "is required");
+        return { kind: "linear", eligible: { labels: [], unassigned: true } };
+    }
+    const kindRaw = ctx.requiredString(table, "kind", "source");
+    let kind = "linear";
+    if (kindRaw !== undefined) {
+        if (SOURCE_KINDS.includes(kindRaw)) {
+            kind = kindRaw;
+        }
+        else {
+            ctx.add("source.kind", `must be one of ${SOURCE_KINDS.join(", ")}`);
+        }
+    }
+    const project = ctx.optionalString(table, "project", "source");
+    const eligible = validateEligible(ctx, table);
+    return project === undefined ? { kind, eligible } : { kind, project, eligible };
+}
+function validateAgent(ctx, root) {
+    const table = root.agent;
+    if (!isTable(table)) {
+        ctx.add("agent", "is required");
+        return { kind: "claude-code", prompt: "", allowedTools: [...DEFAULT_ALLOWED_TOOLS] };
+    }
+    const kind = ctx.requiredString(table, "kind", "agent") ?? "claude-code";
+    const prompt = ctx.requiredString(table, "prompt", "agent") ?? "";
+    const allowedTools = ctx.stringArray(table, "allowed_tools", "agent") ?? [
+        ...DEFAULT_ALLOWED_TOOLS,
+    ];
+    return { kind, prompt, allowedTools };
+}
+function validateBackend(ctx, root) {
+    const table = root.backend;
+    if (table === undefined)
+        return { kind: DEFAULT_BACKEND_KIND };
+    if (!isTable(table)) {
+        ctx.add("backend", "must be a table");
+        return { kind: DEFAULT_BACKEND_KIND };
+    }
+    let kind = DEFAULT_BACKEND_KIND;
+    const kindRaw = table.kind;
+    if (kindRaw !== undefined) {
+        if (typeof kindRaw === "string" && BACKEND_KINDS.includes(kindRaw)) {
+            kind = kindRaw;
+        }
+        else {
+            ctx.add("backend.kind", `must be one of ${BACKEND_KINDS.join(", ")}`);
+        }
+    }
+    const image = ctx.optionalString(table, "image", "backend");
+    return image === undefined ? { kind } : { kind, image };
+}
+function validateGate(ctx, root) {
+    const table = root.gate;
+    if (table === undefined)
+        return { commands: [] };
+    if (!isTable(table)) {
+        ctx.add("gate", "must be a table");
+        return { commands: [] };
+    }
+    const commands = ctx.stringArray(table, "commands", "gate") ?? [];
+    return { commands };
+}
+function validateGuardrails(ctx, root) {
+    const table = root.guardrails;
+    if (table === undefined)
+        return { ...DEFAULT_GUARDRAILS };
+    if (!isTable(table)) {
+        ctx.add("guardrails", "must be a table");
+        return { ...DEFAULT_GUARDRAILS };
+    }
+    return {
+        maxItemsPerRun: ctx.positiveNumber(table, "max_items_per_run", "guardrails", DEFAULT_GUARDRAILS.maxItemsPerRun),
+        budgetUsdPerItem: ctx.positiveNumber(table, "budget_usd_per_item", "guardrails", DEFAULT_GUARDRAILS.budgetUsdPerItem),
+        timeoutMs: ctx.durationMs(table, "timeout", "guardrails", DEFAULT_GUARDRAILS.timeoutMs),
+        maxCostUsdPerRun: ctx.positiveNumber(table, "max_cost_usd_per_run", "guardrails", DEFAULT_GUARDRAILS.maxCostUsdPerRun),
+        claimTtlMs: ctx.durationMs(table, "claim_ttl", "guardrails", DEFAULT_GUARDRAILS.claimTtlMs),
+    };
+}
+function validateOutput(ctx, root) {
+    const table = root.output;
+    const defaults = { openPr: true, draft: false, autoMerge: false };
+    if (table === undefined)
+        return defaults;
+    if (!isTable(table)) {
+        ctx.add("output", "must be a table");
+        return defaults;
+    }
+    return {
+        openPr: ctx.optionalBool(table, "open_pr", "output", true),
+        draft: ctx.optionalBool(table, "draft", "output", false),
+        autoMerge: ctx.optionalBool(table, "auto_merge", "output", false),
+    };
+}
+function validateArtifacts(ctx, root) {
+    return ctx.stringArray(root, "artifacts", "") ?? [];
+}
+/**
+ * Parse and validate a `ghostrail.toml` document into a normalized config.
+ *
+ * On success the returned config has every optional field filled with its
+ * default. On failure every problem found is reported (parsing does not stop at
+ * the first error), each addressed by a dotted path such as `backend.kind`.
+ * A TOML syntax error is reported as a single error at the root path `""`.
+ */
+export function parseConfig(toml) {
+    let root;
+    try {
+        root = parseToml(toml);
+    }
+    catch (error) {
+        const message = error instanceof TomlError ? error.message : String(error);
+        return err([{ path: "", message: `invalid TOML: ${message}` }]);
+    }
+    if (!isTable(root)) {
+        return err([{ path: "", message: "config must be a TOML table" }]);
+    }
+    return validateConfigObject(root);
+}
+/** Validate an already-parsed config object (used after merging global settings). */
+export function validateConfigObject(root) {
+    const ctx = new Ctx();
+    const config = {
+        factory: validateFactory(ctx, root),
+        source: validateSource(ctx, root),
+        agent: validateAgent(ctx, root),
+        backend: validateBackend(ctx, root),
+        gate: validateGate(ctx, root),
+        guardrails: validateGuardrails(ctx, root),
+        output: validateOutput(ctx, root),
+        artifacts: validateArtifacts(ctx, root),
+    };
+    return ctx.errors.length > 0 ? err(ctx.errors) : ok(config);
+}
+/**
+ * Deep-merge two TOML tables, with `override` winning: nested tables merge
+ * recursively; arrays and scalars from `override` replace those in `base`. Used
+ * to layer a repo's config over the global account defaults.
+ */
+export function deepMerge(base, override) {
+    const result = { ...base };
+    for (const [key, value] of Object.entries(override)) {
+        const existing = result[key];
+        if (isTable(existing) && isTable(value)) {
+            result[key] = deepMerge(existing, value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Parse a repo config layered over optional global account settings (repo wins),
+ * then validate the merged result. A TOML syntax error in either document is
+ * reported at the root path.
+ */
+export function parseMergedConfig(repoToml, globalToml) {
+    const repo = parseTomlTable(repoToml, "config");
+    if (!repo.ok)
+        return repo;
+    if (globalToml === undefined)
+        return validateConfigObject(repo.value);
+    const global = parseTomlTable(globalToml, "global settings");
+    if (!global.ok)
+        return global;
+    return validateConfigObject(deepMerge(global.value, repo.value));
+}
+function parseTomlTable(toml, label) {
+    let root;
+    try {
+        root = parseToml(toml);
+    }
+    catch (error) {
+        const message = error instanceof TomlError ? error.message : String(error);
+        return err([{ path: "", message: `invalid TOML in ${label}: ${message}` }]);
+    }
+    if (!isTable(root))
+        return err([{ path: "", message: `${label} must be a TOML table` }]);
+    return ok(root);
+}
+//# sourceMappingURL=load.js.map

package/dist/config/load.js.map

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

package/dist/config/result.d.ts

@@ -0,0 +1,18 @@
+/** A single configuration problem, addressed by a dotted path into the config. */
+export interface ConfigError {
+    /** Dotted path to the offending value, e.g. `backend.kind` or `guardrails.timeout`. */
+    path: string;
+    /** Human-readable description of what is wrong and, where useful, what was expected. */
+    message: string;
+}
+/** The result of parsing/validating config: either a value or a non-empty list of errors. */
+export type Result<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    errors: ConfigError[];
+};
+export declare function ok<T>(value: T): Result<T>;
+export declare function err<T>(errors: ConfigError[]): Result<T>;
+//# sourceMappingURL=result.d.ts.map

package/dist/config/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/config/result.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6FAA6F;AAC7F,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC;AAEtF,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAEzC;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAEvD"}

package/dist/config/result.js

@@ -0,0 +1,7 @@
+export function ok(value) {
+    return { ok: true, value };
+}
+export function err(errors) {
+    return { ok: false, errors };
+}
+//# sourceMappingURL=result.js.map

package/dist/config/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/config/result.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,GAAG,CAAI,MAAqB;IAC1C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC"}

package/dist/config/schema.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 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 declare const SOURCE_KINDS: readonly ["linear", "github-issues", "beads"];
+export type SourceKind = (typeof SOURCE_KINDS)[number];
+export declare const BACKEND_KINDS: readonly ["local-worktree", "container", "firecracker", "e2b", "remote"];
+export type BackendKind = (typeof BACKEND_KINDS)[number];
+export interface FactoryConfig {
+    name: string;
+    baseBranch: string;
+}
+export interface EligibleFilter {
+    state?: string;
+    /** One or more labels an item must carry to be eligible. */
+    labels: string[];
+    unassigned: boolean;
+}
+export interface SourceConfig {
+    kind: SourceKind;
+    /** Tracker project/repo identifier the source reads from. */
+    project?: string;
+    eligible: EligibleFilter;
+}
+export interface AgentConfig {
+    /** `claude-code` today; `strands`, `acp`, or `pty:<cmd>` in later phases. */
+    kind: string;
+    /** Path to the prompt file, relative to the config file. */
+    prompt: string;
+    allowedTools: string[];
+}
+export interface BackendConfig {
+    kind: BackendKind;
+    /** Container image, for backends that use one. */
+    image?: string;
+}
+export interface GateConfig {
+    /** CI-mirror commands, run in order inside the workspace. */
+    commands: string[];
+}
+export interface Guardrails {
+    maxItemsPerRun: number;
+    budgetUsdPerItem: number;
+    /** Per-item wall-clock cap, in milliseconds (parsed from e.g. `"30m"`). */
+    timeoutMs: number;
+    maxCostUsdPerRun: number;
+    /** Claim time-to-live, in milliseconds (parsed from e.g. `"2h"`). */
+    claimTtlMs: number;
+}
+export interface OutputConfig {
+    openPr: boolean;
+    /** Open the PR as a draft (the content-factory default). */
+    draft: boolean;
+    /** Hard-defaults to false. A human owns every merge. */
+    autoMerge: boolean;
+}
+export interface GhostrailConfig {
+    factory: FactoryConfig;
+    source: SourceConfig;
+    agent: AgentConfig;
+    backend: BackendConfig;
+    gate: GateConfig;
+    guardrails: Guardrails;
+    output: OutputConfig;
+    /** Names of global shared artifacts to stage into each run's workspace. */
+    artifacts: string[];
+}
+/** Default agent tool allowlist: read + write files and run shell/search only. */
+export declare const DEFAULT_ALLOWED_TOOLS: readonly string[];
+/** Guardrail defaults, carried over from the reference factory. */
+export declare const DEFAULT_GUARDRAILS: Guardrails;
+export declare const DEFAULT_BASE_BRANCH = "main";
+export declare const DEFAULT_BACKEND_KIND: BackendKind;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,YAAY,+CAAgD,CAAC;AAC1E,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,eAAO,MAAM,aAAa,0EAMhB,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,4DAA4D;IAC5D,KAAK,EAAE,OAAO,CAAC;IACf,wDAAwD;IACxD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,kFAAkF;AAClF,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAOlD,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,EAAE,UAMhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAC1C,eAAO,MAAM,oBAAoB,EAAE,WAA8B,CAAC"}