ghostrail 0.0.0

package/dist/publish/github-publisher.d.ts

@@ -0,0 +1,30 @@
+import type { Backend, Workspace } from "../backend/types.js";
+import type { Publisher, PullRequest, WorkItem } from "../loop/ports.js";
+import type { GitHost } from "./githost.js";
+export interface PublisherOptions {
+    baseBranch: string;
+    /** Labels to apply to opened PRs. Defaults to `["ghostrail"]`. */
+    labels?: readonly string[];
+    /** Conventional-commit type for the commit + PR title. Defaults to `fix`. */
+    commitType?: string;
+    /** Open PRs as drafts (the content-factory default). */
+    draft?: boolean;
+}
+/**
+ * Opens the pull request for a green run and never merges. It commits the
+ * agent's file changes and pushes the branch through the backend (so it works
+ * wherever the workspace lives), then opens the PR through the {@link GitHost}.
+ * The commit fails loudly if the agent produced no changes.
+ */
+export declare class GitHubPublisher implements Publisher {
+    private readonly backend;
+    private readonly host;
+    private readonly baseBranch;
+    private readonly labels;
+    private readonly commitType;
+    private readonly draft;
+    constructor(backend: Backend, host: GitHost, options: PublisherOptions);
+    openPullRequest(item: WorkItem, workspace: Workspace, summary: string): Promise<PullRequest>;
+    private git;
+}
+//# sourceMappingURL=github-publisher.d.ts.map

package/dist/publish/github-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-publisher.d.ts","sourceRoot":"","sources":["../../src/publish/github-publisher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,SAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;gBAEpB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB;IAShE,eAAe,CACnB,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,CAAC;YA0BT,GAAG;CAQlB"}

package/dist/publish/github-publisher.js

@@ -0,0 +1,51 @@
+import { commitMessage, prBody } from "./githost.js";
+/**
+ * Opens the pull request for a green run and never merges. It commits the
+ * agent's file changes and pushes the branch through the backend (so it works
+ * wherever the workspace lives), then opens the PR through the {@link GitHost}.
+ * The commit fails loudly if the agent produced no changes.
+ */
+export class GitHubPublisher {
+    backend;
+    host;
+    baseBranch;
+    labels;
+    commitType;
+    draft;
+    constructor(backend, host, options) {
+        this.backend = backend;
+        this.host = host;
+        this.baseBranch = options.baseBranch;
+        this.labels = options.labels ?? ["ghostrail"];
+        this.commitType = options.commitType ?? "fix";
+        this.draft = options.draft ?? false;
+    }
+    async openPullRequest(item, workspace, summary) {
+        await this.git(workspace, ["add", "-A"]);
+        const commit = await this.backend.exec(workspace, [
+            "git",
+            "commit",
+            "-m",
+            commitMessage(item.id, item.title, this.commitType),
+        ]);
+        if (commit.exitCode !== 0) {
+            throw new Error(`commit failed (no changes to commit?): ${commit.stderr.trim() || commit.stdout.trim()}`);
+        }
+        await this.git(workspace, ["push", "-u", "origin", workspace.branch]);
+        return this.host.openPr({
+            baseBranch: this.baseBranch,
+            headBranch: workspace.branch,
+            title: commitMessage(item.id, item.title, this.commitType),
+            body: prBody(item, summary),
+            labels: this.labels,
+            draft: this.draft,
+        });
+    }
+    async git(workspace, args) {
+        const result = await this.backend.exec(workspace, ["git", ...args]);
+        if (result.exitCode !== 0) {
+            throw new Error(`git ${args.join(" ")} failed: ${result.stderr.trim() || result.stdout.trim()}`);
+        }
+    }
+}
+//# sourceMappingURL=github-publisher.js.map

package/dist/publish/github-publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-publisher.js","sourceRoot":"","sources":["../../src/publish/github-publisher.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAYrD;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IACT,OAAO,CAAU;IACjB,IAAI,CAAU;IACd,UAAU,CAAS;IACnB,MAAM,CAAoB;IAC1B,UAAU,CAAS;IACnB,KAAK,CAAU;IAEhC,YAAY,OAAgB,EAAE,IAAa,EAAE,OAAyB;QACpE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC;QAC9C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,IAAc,EACd,SAAoB,EACpB,OAAe;QAEf,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE;YAChD,KAAK;YACL,QAAQ;YACR,IAAI;YACJ,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC;SACpD,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,0CAA0C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CACzF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QAEtE,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YACtB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU,EAAE,SAAS,CAAC,MAAM;YAC5B,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC;YAC1D,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,GAAG,CAAC,SAAoB,EAAE,IAAuB;QAC7D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QACpE,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAChF,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/publish/index.d.ts

@@ -0,0 +1,4 @@
+export { GhHost, type GhRunner, ghOpenPrArgs, parseCommentList, parseOpenPrList } from "./gh.js";
+export { type GitHost, GHOSTRAIL_MARKER, commitMessage, type OpenPr, type PrComment, type PrRef, type PrSpec, parsePrUrl, prBody, } from "./githost.js";
+export { GitHubPublisher, type PublisherOptions } from "./github-publisher.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/publish/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACjG,OAAO,EACL,KAAK,OAAO,EACZ,gBAAgB,EAChB,aAAa,EACb,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,MAAM,EACX,UAAU,EACV,MAAM,GACP,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/publish/index.js

@@ -0,0 +1,4 @@
+export { GhHost, ghOpenPrArgs, parseCommentList, parseOpenPrList } from "./gh.js";
+export { GHOSTRAIL_MARKER, commitMessage, parsePrUrl, prBody, } from "./githost.js";
+export { GitHubPublisher } from "./github-publisher.js";
+//# sourceMappingURL=index.js.map

package/dist/publish/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/publish/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACjG,OAAO,EAEL,gBAAgB,EAChB,aAAa,EAKb,UAAU,EACV,MAAM,GACP,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAyB,MAAM,uBAAuB,CAAC"}

package/dist/respond/index.d.ts

@@ -0,0 +1,4 @@
+export { FEEDBACK_PATH, type RespondConfig, type RespondDeps, type RespondResult, type RespondState, renderFeedback, respondTick, } from "./respond.js";
+export { latestTimestamp, type SelectOptions, selectNewComments } from "./select.js";
+export { FileWatermarkStore, MemoryWatermarkStore, type WatermarkStore } from "./store.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/respond/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/respond/index.js

@@ -0,0 +1,4 @@
+export { FEEDBACK_PATH, renderFeedback, respondTick, } from "./respond.js";
+export { latestTimestamp, selectNewComments } from "./select.js";
+export { FileWatermarkStore, MemoryWatermarkStore } from "./store.js";
+//# sourceMappingURL=index.js.map

package/dist/respond/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/respond/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAKb,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAsB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAuB,MAAM,YAAY,CAAC"}

package/dist/respond/respond.d.ts

@@ -0,0 +1,42 @@
+import type { Backend } from "../backend/types.js";
+import type { AgentConfig, Guardrails } from "../config/schema.js";
+import type { Agent, Logger } from "../loop/ports.js";
+import { type GitHost, type PrComment } from "../publish/githost.js";
+import type { WatermarkStore } from "./store.js";
+/** Where the respond pass drops the human feedback for the agent to read. */
+export declare const FEEDBACK_PATH = ".ghostrail/feedback.md";
+export interface RespondDeps {
+    repoPath: string;
+    host: GitHost;
+    backend: Backend;
+    agent: Agent;
+    watermarks: WatermarkStore;
+    logger?: Logger;
+}
+export interface RespondConfig {
+    /** Label that marks factory PRs, e.g. "ghostrail". */
+    label: string;
+    /** Bot logins whose comments are ignored. */
+    selfLogins: readonly string[];
+    /** Agent config for the respond prompt (its `prompt` is the respond template). */
+    agent: AgentConfig;
+    guardrails: Guardrails;
+}
+export type RespondState = "responded" | "blocked" | "noop" | "failed";
+export interface RespondResult {
+    prNumber: number;
+    state: RespondState;
+    summary?: string;
+}
+/** Render fresh human comments into the feedback document the agent reads. */
+export declare function renderFeedback(comments: readonly PrComment[]): string;
+/**
+ * The respond pass: for every open factory PR, act only on human comments newer
+ * than the per-PR watermark that do not carry the ghostrail marker (so it never
+ * acts on its own). For each such PR it checks out the PR branch, hands the
+ * agent the new feedback, and — on a successful change — commits, pushes to the
+ * same branch, and posts a summary comment; it never opens a new PR and never
+ * merges. The watermark advances once a PR's new comments have been handled.
+ */
+export declare function respondTick(deps: RespondDeps, config: RespondConfig): Promise<RespondResult[]>;
+//# sourceMappingURL=respond.d.ts.map

package/dist/respond/respond.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"respond.d.ts","sourceRoot":"","sources":["../../src/respond/respond.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,KAAK,EAAgB,MAAM,EAAY,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAoB,KAAK,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEpG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,6EAA6E;AAC7E,eAAO,MAAM,aAAa,2BAA2B,CAAC;AAItD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,cAAc,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,kFAAkF;IAClF,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAGrE;AAOD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,aAAa,EAAE,CAAC,CAU1B"}

package/dist/respond/respond.js

@@ -0,0 +1,128 @@
+import { writeWorkspaceFile } from "../backend/fs.js";
+import { GHOSTRAIL_MARKER } from "../publish/githost.js";
+import { latestTimestamp, selectNewComments } from "./select.js";
+/** Where the respond pass drops the human feedback for the agent to read. */
+export const FEEDBACK_PATH = ".ghostrail/feedback.md";
+const nullLogger = { info: () => { }, warn: () => { } };
+/** Render fresh human comments into the feedback document the agent reads. */
+export function renderFeedback(comments) {
+    const blocks = comments.map((c) => `> from @${c.author} at ${c.createdAt}\n\n${c.body.trim()}`);
+    return `# New feedback to address\n\n${blocks.join("\n\n---\n\n")}\n`;
+}
+/** Comment body ghostrail posts, always carrying the marker so it never re-reads its own. */
+function markedComment(body) {
+    return `${body}\n\n${GHOSTRAIL_MARKER}`;
+}
+/**
+ * The respond pass: for every open factory PR, act only on human comments newer
+ * than the per-PR watermark that do not carry the ghostrail marker (so it never
+ * acts on its own). For each such PR it checks out the PR branch, hands the
+ * agent the new feedback, and — on a successful change — commits, pushes to the
+ * same branch, and posts a summary comment; it never opens a new PR and never
+ * merges. The watermark advances once a PR's new comments have been handled.
+ */
+export async function respondTick(deps, config) {
+    const logger = deps.logger ?? nullLogger;
+    const prs = await deps.host.listOpenPrs(config.label);
+    logger.info(`respond: ${prs.length} open ${config.label} PR(s)`);
+    const results = [];
+    for (const pr of prs) {
+        results.push(await respondToPr(deps, config, pr, logger));
+    }
+    return results;
+}
+async function respondToPr(deps, config, pr, logger) {
+    const comments = await deps.host.listComments(pr.number);
+    const since = await deps.watermarks.get(pr.number);
+    const fresh = selectNewComments(comments, {
+        selfLogins: config.selfLogins,
+        marker: GHOSTRAIL_MARKER,
+        ...(since === undefined ? {} : { since }),
+    });
+    if (fresh.length === 0) {
+        return { prNumber: pr.number, state: "noop" };
+    }
+    let workspace;
+    try {
+        workspace = await deps.backend.provision({
+            repoPath: deps.repoPath,
+            baseBranch: pr.headBranch,
+            branch: pr.headBranch,
+            mode: "attach",
+        });
+        await writeWorkspaceFile(deps.backend, workspace, FEEDBACK_PATH, renderFeedback(fresh));
+        const item = {
+            id: `PR-${pr.number}`,
+            title: `respond to PR #${pr.number}`,
+            url: pr.url,
+        };
+        const outcome = await deps.agent.run({
+            backend: deps.backend,
+            workspace,
+            item,
+            agent: config.agent,
+            guardrails: config.guardrails,
+        });
+        const result = await routeRespond(deps, pr, workspace, outcome, logger);
+        const mark = latestTimestamp(fresh);
+        if (mark !== undefined)
+            await deps.watermarks.set(pr.number, mark);
+        return result;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.warn(`respond #${pr.number}: errored: ${message}`);
+        return { prNumber: pr.number, state: "failed", summary: message };
+    }
+    finally {
+        if (workspace !== undefined) {
+            try {
+                await deps.backend.teardown(workspace);
+            }
+            catch {
+                // best-effort
+            }
+        }
+    }
+}
+async function routeRespond(deps, pr, workspace, outcome, logger) {
+    switch (outcome.status) {
+        case "blocked":
+            await deps.host.postComment(pr.number, markedComment(outcome.questions));
+            return { prNumber: pr.number, state: "blocked", summary: outcome.questions };
+        case "failed":
+            await deps.host.postComment(pr.number, markedComment(`The factory hit an error addressing the latest feedback: ${outcome.error}`));
+            return { prNumber: pr.number, state: "failed", summary: outcome.error };
+        case "noop":
+            await deps.host.postComment(pr.number, markedComment("No changes were needed for the latest feedback."));
+            return { prNumber: pr.number, state: "noop" };
+        case "done": {
+            const committed = await commitAndPush(deps.backend, workspace);
+            if (!committed) {
+                await deps.host.postComment(pr.number, markedComment("No changes were needed for the latest feedback."));
+                return { prNumber: pr.number, state: "noop" };
+            }
+            await deps.host.postComment(pr.number, markedComment(outcome.summary));
+            logger.info(`respond #${pr.number}: pushed an update`);
+            return { prNumber: pr.number, state: "responded", summary: outcome.summary };
+        }
+    }
+}
+/** Commit and push the agent's changes to the PR branch. Returns false if there was nothing to commit. */
+async function commitAndPush(backend, workspace) {
+    await backend.exec(workspace, ["git", "add", "-A"]);
+    const commit = await backend.exec(workspace, [
+        "git",
+        "commit",
+        "-m",
+        "respond: address review feedback",
+    ]);
+    if (commit.exitCode !== 0)
+        return false;
+    const push = await backend.exec(workspace, ["git", "push", "origin", workspace.branch]);
+    if (push.exitCode !== 0) {
+        throw new Error(`git push failed: ${push.stderr.trim() || push.stdout.trim()}`);
+    }
+    return true;
+}
+//# sourceMappingURL=respond.js.map

package/dist/respond/respond.js.map

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

package/dist/respond/select.d.ts

@@ -0,0 +1,22 @@
+import type { PrComment } from "../publish/githost.js";
+export interface SelectOptions {
+    /** Author logins that are the bot itself; their comments are always ignored. */
+    selfLogins: readonly string[];
+    /** Only comments strictly after this ISO-8601 timestamp count as new. */
+    since?: string;
+    /** Marker identifying ghostrail-authored comments, which are ignored. */
+    marker: string;
+}
+/**
+ * Select the human comments the respond pass should act on: authored by someone
+ * other than the bot (case-insensitive login match), not carrying the ghostrail
+ * marker, and, when a `since` watermark is given, created strictly after it.
+ * Order is preserved.
+ */
+export declare function selectNewComments(comments: readonly PrComment[], options: SelectOptions): PrComment[];
+/**
+ * The latest `createdAt` across the comments (lexicographic max, valid for
+ * ISO-8601), or undefined when there are none. Used as the next watermark.
+ */
+export declare function latestTimestamp(comments: readonly PrComment[]): string | undefined;
+//# sourceMappingURL=select.d.ts.map

package/dist/respond/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/respond/select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS,SAAS,EAAE,EAC9B,OAAO,EAAE,aAAa,GACrB,SAAS,EAAE,CAQb;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,GAAG,SAAS,CAMlF"}

package/dist/respond/select.js

@@ -0,0 +1,31 @@
+/**
+ * Select the human comments the respond pass should act on: authored by someone
+ * other than the bot (case-insensitive login match), not carrying the ghostrail
+ * marker, and, when a `since` watermark is given, created strictly after it.
+ * Order is preserved.
+ */
+export function selectNewComments(comments, options) {
+    const self = new Set(options.selfLogins.map((login) => login.toLowerCase()));
+    return comments.filter((comment) => {
+        if (self.has(comment.author.toLowerCase()))
+            return false;
+        if (comment.body.includes(options.marker))
+            return false;
+        if (options.since !== undefined && comment.createdAt <= options.since)
+            return false;
+        return true;
+    });
+}
+/**
+ * The latest `createdAt` across the comments (lexicographic max, valid for
+ * ISO-8601), or undefined when there are none. Used as the next watermark.
+ */
+export function latestTimestamp(comments) {
+    let latest;
+    for (const comment of comments) {
+        if (latest === undefined || comment.createdAt > latest)
+            latest = comment.createdAt;
+    }
+    return latest;
+}
+//# sourceMappingURL=select.js.map

package/dist/respond/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../src/respond/select.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAA8B,EAC9B,OAAsB;IAEtB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC7E,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;QACjC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;QACzD,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QACxD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACpF,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAA8B;IAC5D,IAAI,MAA0B,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,MAAM;YAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IACrF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/respond/store.d.ts

@@ -0,0 +1,25 @@
+/** Per-PR watermark: the timestamp of the newest comment already handled. */
+export interface WatermarkStore {
+    get(prNumber: number): Promise<string | undefined>;
+    set(prNumber: number, iso: string): Promise<void>;
+}
+/** An in-memory watermark store, for tests and ephemeral runs. */
+export declare class MemoryWatermarkStore implements WatermarkStore {
+    private readonly marks;
+    get(prNumber: number): Promise<string | undefined>;
+    set(prNumber: number, iso: string): Promise<void>;
+}
+/**
+ * A JSON-file watermark store keyed by PR number. Reads are tolerant of a
+ * missing or malformed file (treated as empty); each write persists the whole
+ * map. Suitable for the local-by-default run; a shared store arrives with the
+ * persistent run store in a later phase.
+ */
+export declare class FileWatermarkStore implements WatermarkStore {
+    private readonly path;
+    constructor(path: string);
+    get(prNumber: number): Promise<string | undefined>;
+    set(prNumber: number, iso: string): Promise<void>;
+    private read;
+}
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/respond/store.ts"],"names":[],"mappings":"AAGA,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACnD,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED,kEAAkE;AAClE,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IAEnD,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAIlD,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIlD;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,IAAI,EAAE,MAAM;IAIlB,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKlD,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAOzC,IAAI;CAYnB"}

package/dist/respond/store.js

@@ -0,0 +1,49 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+/** An in-memory watermark store, for tests and ephemeral runs. */
+export class MemoryWatermarkStore {
+    marks = new Map();
+    get(prNumber) {
+        return Promise.resolve(this.marks.get(prNumber));
+    }
+    set(prNumber, iso) {
+        this.marks.set(prNumber, iso);
+        return Promise.resolve();
+    }
+}
+/**
+ * A JSON-file watermark store keyed by PR number. Reads are tolerant of a
+ * missing or malformed file (treated as empty); each write persists the whole
+ * map. Suitable for the local-by-default run; a shared store arrives with the
+ * persistent run store in a later phase.
+ */
+export class FileWatermarkStore {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    async get(prNumber) {
+        const marks = await this.read();
+        return marks[String(prNumber)];
+    }
+    async set(prNumber, iso) {
+        const marks = await this.read();
+        marks[String(prNumber)] = iso;
+        await mkdir(dirname(this.path), { recursive: true });
+        await writeFile(this.path, `${JSON.stringify(marks, null, 2)}\n`, "utf8");
+    }
+    async read() {
+        try {
+            const raw = await readFile(this.path, "utf8");
+            const parsed = JSON.parse(raw);
+            if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+                return parsed;
+            }
+        }
+        catch {
+            // missing or malformed: start empty
+        }
+        return {};
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/respond/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/respond/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,kEAAkE;AAClE,MAAM,OAAO,oBAAoB;IACd,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEnD,GAAG,CAAC,QAAgB;QAClB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,GAAG,CAAC,QAAgB,EAAE,GAAW;QAC/B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC9B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IACZ,IAAI,CAAS;IAE9B,YAAY,IAAY;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAgB;QACxB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,GAAW;QACrC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAChC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,GAAG,CAAC;QAC9B,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5E,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;YAC1C,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5E,OAAO,MAAgC,CAAC;YAC1C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/secrets/redact.d.ts

@@ -0,0 +1,11 @@
+/** Placeholder written in place of a redacted secret. */
+export declare const REDACTION = "***";
+/**
+ * Replace every occurrence of each known secret value in `text` with `***`.
+ * Secrets shorter than {@link MIN_SECRET_LENGTH} are ignored so trivial values
+ * don't blank out unrelated text. Redaction is applied before anything is
+ * logged or shipped, and never after. Purely a string transform; the input
+ * `secrets` is not mutated.
+ */
+export declare function redactSecrets(text: string, secrets: readonly string[]): string;
+//# sourceMappingURL=redact.d.ts.map

package/dist/secrets/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/secrets/redact.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,eAAO,MAAM,SAAS,QAAQ,CAAC;AAK/B;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAO9E"}

package/dist/secrets/redact.js

@@ -0,0 +1,21 @@
+/** Placeholder written in place of a redacted secret. */
+export const REDACTION = "***";
+/** Minimum secret length to redact, so short/empty values don't over-match. */
+const MIN_SECRET_LENGTH = 6;
+/**
+ * Replace every occurrence of each known secret value in `text` with `***`.
+ * Secrets shorter than {@link MIN_SECRET_LENGTH} are ignored so trivial values
+ * don't blank out unrelated text. Redaction is applied before anything is
+ * logged or shipped, and never after. Purely a string transform; the input
+ * `secrets` is not mutated.
+ */
+export function redactSecrets(text, secrets) {
+    let result = text;
+    for (const secret of secrets) {
+        if (secret.length < MIN_SECRET_LENGTH)
+            continue;
+        result = result.split(secret).join(REDACTION);
+    }
+    return result;
+}
+//# sourceMappingURL=redact.js.map

package/dist/secrets/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/secrets/redact.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAC;AAE/B,+EAA+E;AAC/E,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,OAA0B;IACpE,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,MAAM,GAAG,iBAAiB;YAAE,SAAS;QAChD,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/source/index.d.ts

@@ -0,0 +1,2 @@
+export { buildIssueFilter, createFetchRequester, ELIGIBLE_ISSUES_QUERY, LINEAR_ENDPOINT, type LinearRequester, LinearSource, type LinearSourceOptions, parseIssueNodes, } from "./linear.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,KAAK,eAAe,EACpB,YAAY,EACZ,KAAK,mBAAmB,EACxB,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/source/index.js

@@ -0,0 +1,2 @@
+export { buildIssueFilter, createFetchRequester, ELIGIBLE_ISSUES_QUERY, LINEAR_ENDPOINT, LinearSource, parseIssueNodes, } from "./linear.js";
+//# sourceMappingURL=index.js.map

package/dist/source/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EAEf,YAAY,EAEZ,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/source/linear.d.ts

@@ -0,0 +1,61 @@
+import type { EligibleFilter } from "../config/schema.js";
+import type { Source, WorkItem } from "../loop/ports.js";
+/**
+ * Issues a Linear GraphQL operation and resolves the `data` payload. Injectable
+ * so the network layer can be faked in tests. Implementations should throw on a
+ * transport error or a GraphQL `errors` array.
+ */
+export type LinearRequester = (query: string, variables: Record<string, unknown>) => Promise<Record<string, unknown>>;
+export declare const LINEAR_ENDPOINT = "https://api.linear.app/graphql";
+/**
+ * A default requester over `fetch`, authenticating with a Linear personal API
+ * key (sent verbatim in the Authorization header, per Linear's API).
+ */
+export declare function createFetchRequester(apiKey: string, endpoint?: string, fetchImpl?: typeof fetch): LinearRequester;
+/** A Linear issue node as returned by the eligible-issues query. */
+interface IssueNode {
+    id: string;
+    identifier: string;
+    title: string;
+    url: string;
+}
+export declare const ELIGIBLE_ISSUES_QUERY = "\nquery EligibleIssues($filter: IssueFilter!, $first: Int!) {\n  issues(filter: $filter, first: $first, orderBy: updatedAt) {\n    nodes { id identifier title url }\n  }\n}";
+/**
+ * Build the Linear `IssueFilter` for an eligibility spec: state name, each label
+ * (via `and`), unassigned, and optionally scoped to a team key. Only the
+ * provided fields are included.
+ */
+export declare function buildIssueFilter(eligible: EligibleFilter, teamKey?: string): Record<string, unknown>;
+/** Extract issue nodes from an `issues` query payload, ignoring malformed nodes. */
+export declare function parseIssueNodes(data: Record<string, unknown>): IssueNode[];
+export interface LinearSourceOptions {
+    teamKey: string;
+    eligible: EligibleFilter;
+    /** State to claim into; defaults to "In Progress". */
+    inProgressState?: string;
+    /** State to reset to; defaults to the eligible state, else "Todo". */
+    resetState?: string;
+    maxItems?: number;
+}
+/**
+ * The Linear implementation of the {@link Source} port, over the GraphQL API
+ * (a headless `claude -p` has no Linear MCP). Claiming an item moves it to the
+ * in-progress state and assigns it to the acting user, which removes it from the
+ * eligible pool; reset returns it to the reset state, unassigned.
+ */
+export declare class LinearSource implements Source {
+    private readonly request;
+    private readonly opts;
+    private bootstrap?;
+    private readonly uuidByIdentifier;
+    constructor(request: LinearRequester, opts: LinearSourceOptions);
+    listEligible(): Promise<WorkItem[]>;
+    claim(item: WorkItem): Promise<boolean>;
+    comment(item: WorkItem, body: string): Promise<void>;
+    reassignToHuman(item: WorkItem): Promise<void>;
+    reset(item: WorkItem): Promise<void>;
+    private ensureBootstrap;
+    private uuidFor;
+}
+export {};
+//# sourceMappingURL=linear.d.ts.map

package/dist/source/linear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear.d.ts","sourceRoot":"","sources":["../../src/source/linear.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAC5B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEtC,eAAO,MAAM,eAAe,mCAAmC,CAAC;AAEhE;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAwB,EAClC,SAAS,GAAE,OAAO,KAAa,GAC9B,eAAe,CAgBjB;AAED,oEAAoE;AACpE,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,qBAAqB,iLAKhC,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAkB1E;AA0BD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;IACzB,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,MAAM;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAEnB;IACF,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;gBAElD,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,mBAAmB;IAWzD,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAUnC,KAAK,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAUvC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9C,KAAK,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;YAS5B,eAAe;YAmBf,OAAO;CAKtB"}