ghostrail 0.0.0

package/dist/loop/engine.js

@@ -0,0 +1,204 @@
+import { randomUUID } from "node:crypto";
+import { stageArtifacts } from "../global/stage.js";
+import { branchName } from "./branch.js";
+const nullLogger = { info: () => { }, warn: () => { } };
+/** Branch prefix for factory work. */
+const BRANCH_PREFIX = "fix";
+/** Emit an event to the sink if present; recording never breaks a run. */
+async function emitEvent(sink, event) {
+    if (sink === undefined)
+        return;
+    try {
+        await sink.emit(event);
+    }
+    catch {
+        // recording is best-effort
+    }
+}
+/** Emit the gate steps, PR, and outcome captured in a finished item's result. */
+async function recordResult(sink, runId, result) {
+    if (sink === undefined)
+        return;
+    const ts = Date.now();
+    for (const step of result.gate?.steps ?? []) {
+        await emitEvent(sink, { type: "gate_step", runId, ts, ...step });
+    }
+    if (result.prUrl !== undefined) {
+        const match = result.prUrl.match(/\/pull\/(\d+)/);
+        await emitEvent(sink, {
+            type: "pr_opened",
+            runId,
+            ts,
+            prNumber: match ? Number(match[1]) : 0,
+            prUrl: result.prUrl,
+        });
+    }
+    await emitEvent(sink, {
+        type: "outcome",
+        runId,
+        ts,
+        state: result.state,
+        ...(result.error === undefined ? {} : { error: result.error }),
+    });
+}
+/** Swallow errors from a best-effort cleanup call so it can't mask the real outcome. */
+async function ignoreErrors(action) {
+    try {
+        await action();
+    }
+    catch {
+        // best-effort; nothing to do
+    }
+}
+/**
+ * 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 async function runTick(deps, config) {
+    const logger = deps.logger ?? nullLogger;
+    const acquired = await deps.lock.acquire();
+    if (!acquired) {
+        logger.warn("another tick holds the lock; skipping");
+        return { lockAcquired: false, results: [] };
+    }
+    const results = [];
+    try {
+        const eligible = await deps.source.listEligible();
+        const items = eligible.slice(0, config.guardrails.maxItemsPerRun);
+        logger.info(`discovered ${eligible.length} eligible item(s), taking ${items.length}`);
+        for (const item of items) {
+            results.push(await runItem(deps, config, item, logger));
+        }
+    }
+    finally {
+        await deps.lock.release();
+    }
+    return { lockAcquired: true, results };
+}
+async function runItem(deps, config, item, logger) {
+    let workspace;
+    const runId = randomUUID();
+    try {
+        const claimed = await deps.source.claim(item);
+        if (!claimed) {
+            logger.info(`${item.id}: claim lost, skipping`);
+            return { itemId: item.id, state: "skipped" };
+        }
+        await emitEvent(deps.events, {
+            type: "claimed",
+            runId,
+            ts: Date.now(),
+            itemId: item.id,
+            title: item.title,
+        });
+        workspace = await deps.backend.provision({
+            repoPath: deps.repoPath,
+            baseBranch: config.factory.baseBranch,
+            branch: branchName(BRANCH_PREFIX, item.id, item.title),
+        });
+        await emitEvent(deps.events, {
+            type: "provisioned",
+            runId,
+            ts: Date.now(),
+            backend: workspace.backend,
+            branch: workspace.branch,
+        });
+        if (deps.globalStore !== undefined && config.artifacts.length > 0) {
+            await stageArtifacts(deps.backend, workspace, deps.globalStore, config.artifacts, logger);
+        }
+        const outcome = await deps.agent.run({
+            backend: deps.backend,
+            workspace,
+            item,
+            agent: config.agent,
+            guardrails: config.guardrails,
+        });
+        await emitEvent(deps.events, {
+            type: "agent_finished",
+            runId,
+            ts: Date.now(),
+            status: outcome.status,
+        });
+        const result = await route(deps, config, item, workspace, outcome, logger);
+        await recordResult(deps.events, runId, result);
+        return result;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.warn(`${item.id}: errored, resetting: ${message}`);
+        await ignoreErrors(() => deps.source.reset(item));
+        await emitEvent(deps.events, {
+            type: "outcome",
+            runId,
+            ts: Date.now(),
+            state: "failed",
+            error: message,
+        });
+        return { itemId: item.id, state: "failed", error: message };
+    }
+    finally {
+        if (workspace !== undefined) {
+            await ignoreErrors(() => deps.backend.teardown(workspace));
+        }
+    }
+}
+async function route(deps, config, item, workspace, outcome, logger) {
+    switch (outcome.status) {
+        case "noop":
+            logger.info(`${item.id}: no change`);
+            return { itemId: item.id, state: "noop" };
+        case "blocked":
+            logger.info(`${item.id}: blocked, handing back to a human`);
+            await deps.source.comment(item, outcome.questions);
+            await deps.source.reassignToHuman(item);
+            await deps.source.reset(item);
+            return { itemId: item.id, state: "blocked", summary: outcome.questions };
+        case "failed":
+            logger.info(`${item.id}: agent failed, resetting`);
+            await deps.source.comment(item, outcome.error);
+            await deps.source.reset(item);
+            return { itemId: item.id, state: "failed", error: outcome.error };
+        case "done":
+            return routeDone(deps, config, item, workspace, outcome.summary, logger);
+    }
+}
+async function routeDone(deps, config, item, workspace, summary, logger) {
+    if (config.gate.commands.length > 0) {
+        const gate = await deps.gate.run({
+            backend: deps.backend,
+            workspace,
+            commands: config.gate.commands,
+            timeoutMs: config.guardrails.timeoutMs,
+        });
+        if (!gate.passed) {
+            const failed = gate.steps.find((step) => step.exitCode !== 0);
+            const reason = failed ? `gate failed at step "${failed.name}"` : "gate failed";
+            logger.info(`${item.id}: ${reason}, resetting`);
+            await deps.source.comment(item, reason);
+            await deps.source.reset(item);
+            return { itemId: item.id, state: "failed", error: reason, gate };
+        }
+        if (!config.output.openPr) {
+            return { itemId: item.id, state: "done", summary, gate };
+        }
+        const pr = await deps.publisher.openPullRequest(item, workspace, summary);
+        logger.info(`${item.id}: opened ${pr.url}`);
+        return { itemId: item.id, state: "done", summary, gate, prUrl: pr.url };
+    }
+    if (!config.output.openPr) {
+        return { itemId: item.id, state: "done", summary };
+    }
+    const pr = await deps.publisher.openPullRequest(item, workspace, summary);
+    logger.info(`${item.id}: opened ${pr.url}`);
+    return { itemId: item.id, state: "done", summary, prUrl: pr.url };
+}
+//# sourceMappingURL=engine.js.map

package/dist/loop/engine.js.map

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

package/dist/loop/index.d.ts

@@ -0,0 +1,6 @@
+export { branchName, slugify } from "./branch.js";
+export { type LoopDeps, runTick } from "./engine.js";
+export type { Agent, AgentContext, AgentOutcome, Gate, GateContext, GateResult, GateStepResult, Logger, Lock, Publisher, PullRequest, Source, WorkItem, } from "./ports.js";
+export type { RunResult, RunState, TickResult } from "./record.js";
+export type { Backend, Workspace } from "../backend/types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/loop/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,KAAK,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACrD,YAAY,EACV,KAAK,EACL,YAAY,EACZ,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,UAAU,EACV,cAAc,EACd,MAAM,EACN,IAAI,EACJ,SAAS,EACT,WAAW,EACX,MAAM,EACN,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/loop/index.js

@@ -0,0 +1,3 @@
+export { branchName, slugify } from "./branch.js";
+export { runTick } from "./engine.js";
+//# sourceMappingURL=index.js.map

package/dist/loop/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/loop/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAiB,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/loop/ports.d.ts

@@ -0,0 +1,97 @@
+import type { Backend, Workspace } from "../backend/types.js";
+import type { AgentConfig, Guardrails } from "../config/schema.js";
+/**
+ * The adapter ports the loop engine orchestrates. The engine depends only on
+ * these interfaces (dependency inversion); the concrete Linear source, the
+ * claude-code agent, and the gate runner implement them. Isolation is the
+ * five-verb {@link Backend} from `../backend`; the agent and gate run their
+ * commands through it, so they work the same on every backend.
+ */
+/** A unit of work drawn from a tracker. */
+export interface WorkItem {
+    /** Tracker identifier, e.g. "TJ-123". */
+    id: string;
+    title: string;
+    url?: string;
+}
+/** Where work comes from (Linear, GitHub Issues, Beads). */
+export interface Source {
+    /** Items currently eligible for the factory, most-ready first. */
+    listEligible(): Promise<WorkItem[]>;
+    /**
+     * Attempt to claim an item so no other run picks it up. Idempotent: returns
+     * false if the item is already claimed (by this or another run).
+     */
+    claim(item: WorkItem): Promise<boolean>;
+    comment(item: WorkItem, body: string): Promise<void>;
+    /** Hand the item back to a human (reassign) when a decision is needed. */
+    reassignToHuman(item: WorkItem): Promise<void>;
+    /** Return the item to the eligible pool (e.g. after a failure). */
+    reset(item: WorkItem): Promise<void>;
+}
+/** The outcome an agent reports after working an item. */
+export type AgentOutcome = {
+    status: "done";
+    summary: string;
+} | {
+    status: "blocked";
+    questions: string;
+} | {
+    status: "failed";
+    error: string;
+} | {
+    status: "noop";
+};
+/** Everything an agent needs to work one item in its provisioned workspace. */
+export interface AgentContext {
+    backend: Backend;
+    workspace: Workspace;
+    item: WorkItem;
+    agent: AgentConfig;
+    guardrails: Guardrails;
+}
+/** The inner loop: a coding agent that only ever writes files in the workspace. */
+export interface Agent {
+    run(context: AgentContext): Promise<AgentOutcome>;
+}
+export interface GateStepResult {
+    name: string;
+    exitCode: number;
+    durationMs: number;
+}
+export interface GateResult {
+    passed: boolean;
+    steps: GateStepResult[];
+}
+/** Inputs for one gate run in a provisioned workspace. */
+export interface GateContext {
+    backend: Backend;
+    workspace: Workspace;
+    commands: readonly string[];
+    /** Per-command wall-clock cap. */
+    timeoutMs?: number;
+}
+/** The oracle: runs the CI-mirror commands in the workspace, in order. */
+export interface Gate {
+    run(context: GateContext): Promise<GateResult>;
+}
+export interface PullRequest {
+    number: number;
+    url: string;
+}
+/** Opens the pull request for a green run. Never merges. */
+export interface Publisher {
+    openPullRequest(item: WorkItem, workspace: Workspace, summary: string): Promise<PullRequest>;
+}
+/** A single-holder lock (the `flock` analog) so only one run executes at a time. */
+export interface Lock {
+    /** Acquire the lock; returns false if it is already held. */
+    acquire(): Promise<boolean>;
+    release(): Promise<void>;
+}
+/** Structured progress sink; a no-op logger is a valid default. */
+export interface Logger {
+    info(message: string): void;
+    warn(message: string): void;
+}
+//# sourceMappingURL=ports.d.ts.map

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

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

package/dist/loop/ports.js

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

package/dist/loop/ports.js.map

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

package/dist/loop/record.d.ts

@@ -0,0 +1,26 @@
+import type { GateResult } from "./ports.js";
+/**
+ * Terminal state of a single item's run.
+ * - `done` — gate passed (or no gate) and the item was routed to a PR.
+ * - `blocked` — the agent hit a decision; questions posted, item handed back.
+ * - `failed` — the agent failed, the gate went red, or an error was thrown.
+ * - `noop` — the agent made no change.
+ * - `skipped` — the claim was lost to another run; nothing was done.
+ */
+export type RunState = "done" | "blocked" | "failed" | "noop" | "skipped";
+/** What happened to one work item during a tick. */
+export interface RunResult {
+    itemId: string;
+    state: RunState;
+    prUrl?: string;
+    gate?: GateResult;
+    summary?: string;
+    error?: string;
+}
+/** The result of a whole tick. */
+export interface TickResult {
+    /** False when the global lock was already held, so nothing ran. */
+    lockAcquired: boolean;
+    results: RunResult[];
+}
+//# sourceMappingURL=record.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/loop/record.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1E,oDAAoD;AACpD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB"}

package/dist/loop/record.js

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

package/dist/loop/record.js.map

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

package/dist/publish/gh.d.ts

@@ -0,0 +1,24 @@
+import type { GitHost, OpenPr, PrComment, PrRef, PrSpec } from "./githost.js";
+/** Runs `gh` with the given args (in the repo) and resolves its result. */
+export type GhRunner = (args: readonly string[]) => Promise<{
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}>;
+/** Build `gh pr create` args from a PR spec (one `--label` per label, in order). */
+export declare function ghOpenPrArgs(spec: PrSpec): string[];
+/** Parse `gh pr list --json number,url,headRefName` output into open PRs. */
+export declare function parseOpenPrList(stdout: string): OpenPr[];
+/** Parse `gh pr view --json comments` output into comments. */
+export declare function parseCommentList(stdout: string): PrComment[];
+/** The GitHub implementation of {@link GitHost} over the `gh` CLI. */
+export declare class GhHost implements GitHost {
+    private readonly run;
+    constructor(run: GhRunner);
+    openPr(spec: PrSpec): Promise<PrRef>;
+    listOpenPrs(label: string): Promise<OpenPr[]>;
+    listComments(prNumber: number): Promise<PrComment[]>;
+    postComment(prNumber: number, body: string): Promise<void>;
+    private exec;
+}
+//# sourceMappingURL=gh.d.ts.map

package/dist/publish/gh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gh.d.ts","sourceRoot":"","sources":["../../src/publish/gh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG9E,2EAA2E;AAC3E,MAAM,MAAM,QAAQ,GAAG,CACrB,IAAI,EAAE,SAAS,MAAM,EAAE,KACpB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEnE,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBnD;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAYxD;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAqB5D;AAWD,sEAAsE;AACtE,qBAAa,MAAO,YAAW,OAAO;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAW;gBAEnB,GAAG,EAAE,QAAQ;IAInB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAKpC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAc7C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAKpD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAIlD,IAAI;CASnB"}

package/dist/publish/gh.js

@@ -0,0 +1,109 @@
+import { parsePrUrl } from "./githost.js";
+/** Build `gh pr create` args from a PR spec (one `--label` per label, in order). */
+export function ghOpenPrArgs(spec) {
+    const args = [
+        "pr",
+        "create",
+        "--base",
+        spec.baseBranch,
+        "--head",
+        spec.headBranch,
+        "--title",
+        spec.title,
+        "--body",
+        spec.body,
+    ];
+    if (spec.draft === true)
+        args.push("--draft");
+    for (const label of spec.labels)
+        args.push("--label", label);
+    return args;
+}
+/** Parse `gh pr list --json number,url,headRefName` output into open PRs. */
+export function parseOpenPrList(stdout) {
+    const rows = safeJsonArray(stdout);
+    const prs = [];
+    for (const row of rows) {
+        if (row === null || typeof row !== "object")
+            continue;
+        const record = row;
+        const { number, url, headRefName } = record;
+        if (typeof number === "number" && typeof url === "string" && typeof headRefName === "string") {
+            prs.push({ number, url, headBranch: headRefName });
+        }
+    }
+    return prs;
+}
+/** Parse `gh pr view --json comments` output into comments. */
+export function parseCommentList(stdout) {
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout);
+    }
+    catch {
+        return [];
+    }
+    const comments = parsed?.comments;
+    if (!Array.isArray(comments))
+        return [];
+    const result = [];
+    for (const row of comments) {
+        if (row === null || typeof row !== "object")
+            continue;
+        const record = row;
+        const author = record.author?.login;
+        const { body, createdAt } = record;
+        if (typeof author === "string" && typeof body === "string" && typeof createdAt === "string") {
+            result.push({ author, body, createdAt });
+        }
+    }
+    return result;
+}
+function safeJsonArray(text) {
+    try {
+        const value = JSON.parse(text);
+        return Array.isArray(value) ? value : [];
+    }
+    catch {
+        return [];
+    }
+}
+/** The GitHub implementation of {@link GitHost} over the `gh` CLI. */
+export class GhHost {
+    run;
+    constructor(run) {
+        this.run = run;
+    }
+    async openPr(spec) {
+        const result = await this.exec(ghOpenPrArgs(spec));
+        return parsePrUrl(result.stdout);
+    }
+    async listOpenPrs(label) {
+        const result = await this.exec([
+            "pr",
+            "list",
+            "--label",
+            label,
+            "--state",
+            "open",
+            "--json",
+            "number,url,headRefName",
+        ]);
+        return parseOpenPrList(result.stdout);
+    }
+    async listComments(prNumber) {
+        const result = await this.exec(["pr", "view", String(prNumber), "--json", "comments"]);
+        return parseCommentList(result.stdout);
+    }
+    async postComment(prNumber, body) {
+        await this.exec(["pr", "comment", String(prNumber), "--body", body]);
+    }
+    async exec(args) {
+        const result = await this.run(args);
+        if (result.exitCode !== 0) {
+            throw new Error(`gh ${args.join(" ")} failed: ${result.stderr.trim() || result.stdout.trim()}`);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=gh.js.map

package/dist/publish/gh.js.map

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

package/dist/publish/githost.d.ts

@@ -0,0 +1,54 @@
+import type { WorkItem } from "../loop/ports.js";
+/** Hidden marker in bodies ghostrail authors, so the respond pass never acts on its own. */
+export declare const GHOSTRAIL_MARKER = "<!-- ghostrail -->";
+export interface PrSpec {
+    baseBranch: string;
+    headBranch: string;
+    title: string;
+    body: string;
+    labels: readonly string[];
+    /** Open as a draft PR (the content-factory default). */
+    draft?: boolean;
+}
+export interface PrRef {
+    number: number;
+    url: string;
+}
+/** An open PR as listed by the host. */
+export interface OpenPr {
+    number: number;
+    url: string;
+    headBranch: string;
+}
+/** A comment on a PR. */
+export interface PrComment {
+    /** Login/handle of the comment's author. */
+    author: string;
+    body: string;
+    /** ISO-8601 timestamp. */
+    createdAt: string;
+}
+/** A code-hosting provider (GitHub today), abstracted so the flows are testable. */
+export interface GitHost {
+    openPr(spec: PrSpec): Promise<PrRef>;
+    listOpenPrs(label: string): Promise<OpenPr[]>;
+    listComments(prNumber: number): Promise<PrComment[]>;
+    postComment(prNumber: number, body: string): Promise<void>;
+}
+/**
+ * Extract the PR number and URL from `gh pr create` output, which prints the PR
+ * URL (e.g. `https://github.com/owner/repo/pull/42`) on its own line. Throws if
+ * no PR URL is present.
+ */
+export declare function parsePrUrl(stdout: string): PrRef;
+/**
+ * Build the git commit message for an item: `<type>: <title> (<id>)`.
+ * The type defaults to `fix`.
+ */
+export declare function commitMessage(id: string, title: string, type?: string): string;
+/**
+ * Build the PR body: the agent's summary, a footer linking the tracker item, and
+ * the hidden ghostrail marker so the respond pass can recognize its own PRs.
+ */
+export declare function prBody(item: WorkItem, summary: string): string;
+//# sourceMappingURL=githost.d.ts.map

package/dist/publish/githost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"githost.d.ts","sourceRoot":"","sources":["../../src/publish/githost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,4FAA4F;AAC5F,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AAErD,MAAM,WAAW,MAAM;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wCAAwC;AACxC,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yBAAyB;AACzB,MAAM,WAAW,SAAS;IACxB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oFAAoF;AACpF,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACrD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAMhD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,SAAQ,GAAG,MAAM,CAE7E;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAK9D"}

package/dist/publish/githost.js

@@ -0,0 +1,33 @@
+/** Hidden marker in bodies ghostrail authors, so the respond pass never acts on its own. */
+export const GHOSTRAIL_MARKER = "<!-- ghostrail -->";
+/**
+ * Extract the PR number and URL from `gh pr create` output, which prints the PR
+ * URL (e.g. `https://github.com/owner/repo/pull/42`) on its own line. Throws if
+ * no PR URL is present.
+ */
+export function parsePrUrl(stdout) {
+    const match = stdout.match(/https?:\/\/\S+\/pull\/(\d+)/);
+    if (match === null || match[1] === undefined) {
+        throw new Error(`could not find a PR URL in output: ${stdout.trim()}`);
+    }
+    return { number: Number(match[1]), url: match[0] };
+}
+/**
+ * Build the git commit message for an item: `<type>: <title> (<id>)`.
+ * The type defaults to `fix`.
+ */
+export function commitMessage(id, title, type = "fix") {
+    return `${type}: ${title} (${id})`;
+}
+/**
+ * Build the PR body: the agent's summary, a footer linking the tracker item, and
+ * the hidden ghostrail marker so the respond pass can recognize its own PRs.
+ */
+export function prBody(item, summary) {
+    const lines = [summary.trim(), "", `Factory run for ${item.id}.`];
+    if (item.url !== undefined && item.url.length > 0)
+        lines.push(item.url);
+    lines.push("", GHOSTRAIL_MARKER);
+    return lines.join("\n");
+}
+//# sourceMappingURL=githost.js.map

package/dist/publish/githost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"githost.js","sourceRoot":"","sources":["../../src/publish/githost.ts"],"names":[],"mappings":"AAEA,4FAA4F;AAC5F,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAyCrD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC1D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,EAAU,EAAE,KAAa,EAAE,IAAI,GAAG,KAAK;IACnE,OAAO,GAAG,IAAI,KAAK,KAAK,KAAK,EAAE,GAAG,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,IAAc,EAAE,OAAe;IACpD,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,mBAAmB,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IAClE,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}