lastlight 0.1.8 → 0.2.0

package/dist/notify/notifier.js

@@ -0,0 +1,87 @@
+/**
+ * `ProgressNotifier` — the concrete {@link ProgressReporter} the runner drives.
+ *
+ * It owns the current {@link ProgressModel}, re-renders once per mutation, and
+ * fans the rendered markdown out to every wired transport's `publish()`. It
+ * knows nothing about GitHub or Slack — that lives behind
+ * {@link NotifierTransport}. Multiple transports can be attached (e.g. a
+ * GitHub-triggered build that also mirrors to a Slack thread); each owns its
+ * own in-place-update handle.
+ *
+ * Mutations are serialized through an in-flight chain so two quick transitions
+ * can't race on `publish()` and post out of order (or double-create the
+ * surface before the first create's handle is stored).
+ */
+import { renderProgress } from "./render.js";
+import { setStep, upsertBefore } from "./model.js";
+export class ProgressNotifier {
+    model = null;
+    transports;
+    chain = Promise.resolve();
+    constructor(transports) {
+        this.transports = transports.filter(Boolean);
+    }
+    /** Serialize a mutation + publish so transitions can't interleave. */
+    enqueue(fn) {
+        this.chain = this.chain.then(fn, fn);
+        return this.chain;
+    }
+    async publish() {
+        if (!this.model)
+            return;
+        const body = renderProgress(this.model);
+        // Best-effort per transport — one platform failing must not block the other.
+        await Promise.all(this.transports.map((t) => t.publish(body).catch((err) => {
+            const m = err instanceof Error ? err.message : String(err);
+            console.warn(`[notifier] publish failed: ${m}`);
+        })));
+    }
+    start(model) {
+        return this.enqueue(async () => {
+            this.model = model;
+            await this.publish();
+        });
+    }
+    step(key, status, detail) {
+        return this.enqueue(async () => {
+            if (!this.model)
+                return;
+            this.model = { ...this.model, steps: setStep(this.model.steps, key, status, detail) };
+            await this.publish();
+        });
+    }
+    insertStep(step, beforeKey) {
+        return this.enqueue(async () => {
+            if (!this.model)
+                return;
+            this.model = { ...this.model, steps: upsertBefore(this.model.steps, step, beforeKey) };
+            await this.publish();
+        });
+    }
+    footer(markdown) {
+        return this.enqueue(async () => {
+            if (!this.model)
+                return;
+            const footer = markdown.trim() || undefined;
+            this.model = { ...this.model, footer };
+            await this.publish();
+        });
+    }
+    note(markdown) {
+        return this.noteTo(this.transports, markdown);
+    }
+    noteTerminal(markdown) {
+        return this.noteTo(this.transports.filter((t) => t.terminalPing), markdown);
+    }
+    noteTo(transports, markdown) {
+        return this.enqueue(async () => {
+            if (!markdown.trim() || transports.length === 0)
+                return;
+            await Promise.all(transports.map((t) => t.note(markdown).catch((err) => {
+                const m = err instanceof Error ? err.message : String(err);
+                console.warn(`[notifier] note failed: ${m}`);
+            })));
+        });
+    }
+}
+//# sourceMappingURL=notifier.js.map

package/dist/notify/notifier.js.map

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

package/dist/notify/notifier.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/notify/notifier.test.js

@@ -0,0 +1,100 @@
+import { describe, it, expect, vi } from "vitest";
+import { ProgressNotifier } from "./notifier.js";
+function fakeTransport(opts = {}) {
+    const published = [];
+    const notes = [];
+    const t = {
+        publish: vi.fn(async (md) => { published.push(md); }),
+        note: vi.fn(async (md) => { notes.push(md); }),
+        terminalPing: opts.terminalPing,
+    };
+    return { t, published, notes };
+}
+const model = {
+    title: "build for #1",
+    steps: [
+        { key: "a", label: "A", status: "pending" },
+        { key: "b", label: "B", status: "pending" },
+    ],
+};
+describe("ProgressNotifier", () => {
+    it("publishes the initial model on start and re-publishes on each mutation", async () => {
+        const { t, published } = fakeTransport();
+        const n = new ProgressNotifier([t]);
+        await n.start(model);
+        await n.step("a", "running", "working");
+        await n.step("a", "done");
+        expect(published).toHaveLength(3);
+        expect(published[0]).toContain("**A**");
+        expect(published[1]).toContain("**A** — working");
+        expect(published[2]).toMatch(/✅ \*\*A\*\*/);
+    });
+    it("insertStep adds a dynamic row before the named key", async () => {
+        const { t, published } = fakeTransport();
+        const n = new ProgressNotifier([t]);
+        await n.start(model);
+        await n.insertStep({ key: "x", label: "Fix (cycle 1)", status: "running" }, "b");
+        const last = published[published.length - 1];
+        expect(last.indexOf("Fix (cycle 1)")).toBeGreaterThan(last.indexOf("**A**"));
+        expect(last.indexOf("Fix (cycle 1)")).toBeLessThan(last.indexOf("**B**"));
+    });
+    it("note posts a standalone message to every transport and skips empties", async () => {
+        const { t, notes } = fakeTransport();
+        const n = new ProgressNotifier([t]);
+        await n.start(model);
+        await n.note("done!");
+        await n.note("   ");
+        expect(notes).toEqual(["done!"]);
+    });
+    it("fans out to multiple transports and survives one failing", async () => {
+        const ok = fakeTransport();
+        const bad = {
+            publish: vi.fn(async () => { throw new Error("boom"); }),
+            note: vi.fn(async () => { }),
+        };
+        const n = new ProgressNotifier([bad, ok.t]);
+        await expect(n.start(model)).resolves.toBeUndefined();
+        expect(ok.published).toHaveLength(1); // healthy transport still got it
+    });
+    it("noteTerminal only hits transports that want a terminal ping", async () => {
+        const gh = fakeTransport({ terminalPing: false }); // GitHub: no terminal ping
+        const slack = fakeTransport({ terminalPing: true }); // Slack: wants it
+        const n = new ProgressNotifier([gh.t, slack.t]);
+        await n.start(model);
+        await n.noteTerminal("✅ build complete — PR #1.");
+        expect(slack.notes).toEqual(["✅ build complete — PR #1."]);
+        expect(gh.notes).toEqual([]);
+    });
+    it("footer sets the trailing section and re-publishes in place", async () => {
+        const { t, published } = fakeTransport();
+        const n = new ProgressNotifier([t]);
+        await n.start(model);
+        await n.footer("## CONFIRMED\nthe verdict");
+        const last = published[published.length - 1];
+        expect(last).toContain("## CONFIRMED");
+        expect(last).toContain("the verdict");
+        // Still the same surface (in-place update), not a standalone note.
+        expect(last).toContain("**A**");
+    });
+    it("footer with blank content clears the footer and re-publishes", async () => {
+        const { t, published } = fakeTransport();
+        const n = new ProgressNotifier([t]);
+        await n.start(model);
+        await n.footer("temp");
+        await n.footer("   ");
+        expect(published[published.length - 1]).not.toContain("temp");
+    });
+    it("no-ops cleanly with zero transports", async () => {
+        const n = new ProgressNotifier([]);
+        await expect(n.start(model)).resolves.toBeUndefined();
+        await expect(n.step("a", "done")).resolves.toBeUndefined();
+        await expect(n.note("x")).resolves.toBeUndefined();
+    });
+    it("ignores step/insert before start (no model yet)", async () => {
+        const { t, published } = fakeTransport();
+        const n = new ProgressNotifier([t]);
+        await n.step("a", "done");
+        expect(published).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=notifier.test.js.map

package/dist/notify/notifier.test.js.map

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

package/dist/notify/render.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The single shared renderer. Turns a {@link ProgressModel} into markdown.
+ * GitHub posts the output as-is; the Slack transport converts it via
+ * `markdownToSlackMrkdwn` first. There is exactly one renderer so the two
+ * platforms can never drift in content.
+ */
+import type { ProgressModel, StepStatus } from "./types.js";
+/** Status → leading emoji. Ported from the Mastra rebuild's EMOJI map. */
+export declare const STATUS_EMOJI: Record<StepStatus, string>;
+/** Render the model to a single markdown body. */
+export declare function renderProgress(model: ProgressModel): string;
+/**
+ * Collapse a rendered multi-line message into a compact one-line checklist
+ * detail: the first non-empty line, capped on *visible* length. The cap
+ * measures the rendered length (a markdown link counts as just its link
+ * text, not its URL) so a short label backed by a long URL is kept whole —
+ * truncating the raw string would slice through the URL and break the link.
+ * When a detail is genuinely too long, the link-stripped form is truncated,
+ * which can never produce a broken link.
+ */
+export declare function collapseDetail(s: string): string | undefined;

package/dist/notify/render.js

@@ -0,0 +1,59 @@
+/** Status → leading emoji. Ported from the Mastra rebuild's EMOJI map. */
+export const STATUS_EMOJI = {
+    pending: "⬜",
+    running: "🔄",
+    done: "✅",
+    blocked: "⛔",
+    awaiting: "⏸️",
+    failed: "❌",
+    skipped: "➖",
+};
+/** Render the model to a single markdown body. */
+export function renderProgress(model) {
+    const lines = [];
+    lines.push(`### 🤖 ${model.title}`);
+    if (model.subtitle) {
+        lines.push("");
+        lines.push(`**${model.subtitle}**`);
+    }
+    if (model.meta && model.meta.length > 0) {
+        lines.push("");
+        for (const m of model.meta)
+            if (m.trim())
+                lines.push(m);
+    }
+    lines.push("");
+    for (const step of model.steps) {
+        const emoji = STATUS_EMOJI[step.status] ?? STATUS_EMOJI.pending;
+        const detail = step.detail ? ` — ${step.detail}` : "";
+        lines.push(`- ${emoji} **${step.label}**${detail}`);
+    }
+    if (model.footer && model.footer.trim()) {
+        lines.push("");
+        lines.push(model.footer);
+    }
+    return lines.join("\n");
+}
+/** Markdown link `[text](url)` → its visible text, for length measurement. */
+const visibleText = (s) => s.replace(/\[([^\]]+)\]\([^)]+\)/g, "$1");
+/**
+ * Collapse a rendered multi-line message into a compact one-line checklist
+ * detail: the first non-empty line, capped on *visible* length. The cap
+ * measures the rendered length (a markdown link counts as just its link
+ * text, not its URL) so a short label backed by a long URL is kept whole —
+ * truncating the raw string would slice through the URL and break the link.
+ * When a detail is genuinely too long, the link-stripped form is truncated,
+ * which can never produce a broken link.
+ */
+export function collapseDetail(s) {
+    const first = s
+        .split("\n")
+        .map((l) => l.trim())
+        .find((l) => l.length > 0);
+    if (!first)
+        return undefined;
+    if (visibleText(first).length <= 160)
+        return first;
+    return `${visibleText(first).slice(0, 159)}…`;
+}
+//# sourceMappingURL=render.js.map

package/dist/notify/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/notify/render.ts"],"names":[],"mappings":"AAQA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,YAAY,GAA+B;IACtD,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,GAAG;IACT,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,GAAG;CACb,CAAC;AAEF,kDAAkD;AAClD,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACpC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI;YAAE,IAAI,CAAC,CAAC,IAAI,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC;QAChE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,8EAA8E;AAC9E,MAAM,WAAW,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;AAErF;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,MAAM,KAAK,GAAG,CAAC;SACZ,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7B,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,KAAK,CAAC;IACnD,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;AAChD,CAAC"}

package/dist/notify/render.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/notify/render.test.js

@@ -0,0 +1,65 @@
+import { describe, it, expect } from "vitest";
+import { renderProgress, collapseDetail, STATUS_EMOJI } from "./render.js";
+describe("renderProgress", () => {
+    const model = {
+        title: "build for #18",
+        subtitle: "Add retry to fetch",
+        meta: ["Branch: [`lastlight/18`](https://example/tree/lastlight/18)"],
+        steps: [
+            { key: "guardrails", label: "Guardrails", status: "done", detail: "READY" },
+            { key: "architect", label: "Architect", status: "running" },
+            { key: "pr", label: "PR", status: "pending" },
+        ],
+        footer: "Artifacts: .lastlight/",
+    };
+    it("renders heading, subtitle, meta, checklist and footer in order", () => {
+        const out = renderProgress(model);
+        const lines = out.split("\n");
+        expect(lines[0]).toBe("### 🤖 build for #18");
+        expect(out).toContain("**Add retry to fetch**");
+        expect(out).toContain("Branch: [`lastlight/18`]");
+        expect(out).toContain(`- ${STATUS_EMOJI.done} **Guardrails** — READY`);
+        expect(out).toContain(`- ${STATUS_EMOJI.running} **Architect**`);
+        expect(out).toContain(`- ${STATUS_EMOJI.pending} **PR**`);
+        expect(out.trimEnd().endsWith("Artifacts: .lastlight/")).toBe(true);
+    });
+    it("omits detail dash when a step has no detail", () => {
+        const out = renderProgress(model);
+        expect(out).toContain(`**Architect**\n`);
+        expect(out).not.toContain("**Architect** —");
+    });
+    it("renders a minimal model (no subtitle/meta/footer)", () => {
+        const out = renderProgress({ title: "t", steps: [{ key: "a", label: "A", status: "pending" }] });
+        expect(out).toContain("### 🤖 t");
+        expect(out).toContain(`- ${STATUS_EMOJI.pending} **A**`);
+    });
+});
+describe("collapseDetail", () => {
+    it("keeps a short-label markdown link intact even when the URL is long (regression)", () => {
+        // The exact shape from build.yaml: short link text, very long branch-encoded URL.
+        const url = "https://github.com/cliftonc/lastlight/blob/" +
+            encodeURIComponent("lastlight/91-feature-allow-configuration-of-otel-endp") +
+            "/.lastlight/issue-91/architect-plan.md";
+        const detail = `Plan ready — [architect-plan.md](${url})`;
+        expect(detail.length).toBeGreaterThan(160); // raw string would trip a naive cap
+        const out = collapseDetail(detail);
+        expect(out).toBe(detail); // returned whole — not truncated
+        expect(out.endsWith(")")).toBe(true); // link closes cleanly
+        expect(out).not.toContain("…");
+    });
+    it("truncates genuinely long prose (no link) with an ellipsis", () => {
+        const prose = "x".repeat(200);
+        const out = collapseDetail(prose);
+        expect(out).toBe(`${"x".repeat(159)}…`);
+        expect(out.length).toBe(160);
+    });
+    it("collapses to the first non-empty trimmed line", () => {
+        const out = collapseDetail("\n  \n  hello world  \nsecond line\n");
+        expect(out).toBe("hello world");
+    });
+    it("returns undefined for empty or whitespace-only input", () => {
+        expect(collapseDetail("")).toBeUndefined();
+        expect(collapseDetail("   \n  \n")).toBeUndefined();
+    });
+});
+//# sourceMappingURL=render.test.js.map

package/dist/notify/render.test.js.map

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

package/dist/notify/transports/github.d.ts

@@ -0,0 +1,26 @@
+/**
+ * GitHub binding for the progress notifier. Owns a single comment id and edits
+ * it in place on every `publish()`; `note()` posts a fresh comment for moments
+ * that deserve a real notification (approval prompts, terminal summary).
+ */
+import type { GitHubClient } from "../../engine/github.js";
+import type { NotifierTransport } from "../types.js";
+export interface GitHubTransportDeps {
+    github: GitHubClient;
+    owner: string;
+    repo: string;
+    issueNumber: number;
+    /** Existing status-comment id from a resumed run, if any. */
+    commentId?: number;
+    /** Persist the comment id the first time it's created (so resume re-attaches). */
+    save?: (commentId: number) => void;
+}
+export declare class GitHubTransport implements NotifierTransport {
+    private readonly deps;
+    /** No terminal ping — the finished checklist + the PR-opened event suffice. */
+    readonly terminalPing = false;
+    private commentId?;
+    constructor(deps: GitHubTransportDeps);
+    publish(markdown: string): Promise<void>;
+    note(markdown: string): Promise<void>;
+}

package/dist/notify/transports/github.js

@@ -0,0 +1,26 @@
+export class GitHubTransport {
+    deps;
+    /** No terminal ping — the finished checklist + the PR-opened event suffice. */
+    terminalPing = false;
+    commentId;
+    constructor(deps) {
+        this.deps = deps;
+        this.commentId = deps.commentId;
+    }
+    async publish(markdown) {
+        const { github, owner, repo, issueNumber } = this.deps;
+        if (this.commentId !== undefined) {
+            await github.updateComment(owner, repo, this.commentId, markdown);
+        }
+        else {
+            const id = await github.postComment(owner, repo, issueNumber, markdown);
+            this.commentId = id;
+            this.deps.save?.(id);
+        }
+    }
+    async note(markdown) {
+        const { github, owner, repo, issueNumber } = this.deps;
+        await github.postComment(owner, repo, issueNumber, markdown);
+    }
+}
+//# sourceMappingURL=github.js.map

package/dist/notify/transports/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../../src/notify/transports/github.ts"],"names":[],"mappings":"AAmBA,MAAM,OAAO,eAAe;IAKG;IAJ7B,+EAA+E;IACtE,YAAY,GAAG,KAAK,CAAC;IACtB,SAAS,CAAU;IAE3B,YAA6B,IAAyB;QAAzB,SAAI,GAAJ,IAAI,CAAqB;QACpD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QACvD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;YACxE,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QACvD,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;CACF"}

package/dist/notify/transports/slack.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Slack binding for the progress notifier. Owns a single message `ts` and
+ * edits it in place via `chat.update` on every `publish()`; `note()` posts a
+ * fresh threaded message for moments that deserve a real ping (approval
+ * prompts, terminal summary) — `chat.update` itself is silent.
+ */
+import type { SlackConnector } from "../../connectors/slack/connector.js";
+import type { NotifierTransport } from "../types.js";
+export interface SlackTransportDeps {
+    slack: SlackConnector;
+    channel: string;
+    thread: string;
+    /** Existing status-message ts from a resumed run, if any. */
+    ts?: string;
+    /** Persist the ts the first time it's created (so resume re-attaches). */
+    save?: (ts: string) => void;
+}
+export declare class SlackTransport implements NotifierTransport {
+    private readonly deps;
+    /** Slack edits are silent and there's no other signal — so it wants the ping. */
+    readonly terminalPing = true;
+    private ts?;
+    constructor(deps: SlackTransportDeps);
+    publish(markdown: string): Promise<void>;
+    note(markdown: string): Promise<void>;
+}

package/dist/notify/transports/slack.js

@@ -0,0 +1,28 @@
+export class SlackTransport {
+    deps;
+    /** Slack edits are silent and there's no other signal — so it wants the ping. */
+    terminalPing = true;
+    ts;
+    constructor(deps) {
+        this.deps = deps;
+        this.ts = deps.ts;
+    }
+    async publish(markdown) {
+        const { slack, channel, thread } = this.deps;
+        if (this.ts !== undefined) {
+            await slack.updateMessage(channel, this.ts, markdown);
+        }
+        else {
+            const ts = await slack.sendMessage(channel, thread, markdown);
+            if (typeof ts === "string") {
+                this.ts = ts;
+                this.deps.save?.(ts);
+            }
+        }
+    }
+    async note(markdown) {
+        const { slack, channel, thread } = this.deps;
+        await slack.sendMessage(channel, thread, markdown);
+    }
+}
+//# sourceMappingURL=slack.js.map

package/dist/notify/transports/slack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.js","sourceRoot":"","sources":["../../../src/notify/transports/slack.ts"],"names":[],"mappings":"AAmBA,MAAM,OAAO,cAAc;IAKI;IAJ7B,iFAAiF;IACxE,YAAY,GAAG,IAAI,CAAC;IACrB,EAAE,CAAU;IAEpB,YAA6B,IAAwB;QAAxB,SAAI,GAAJ,IAAI,CAAoB;QACnD,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QAC7C,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC9D,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;gBAC3B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QAC7C,MAAM,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/notify/transports.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/notify/transports.test.js

@@ -0,0 +1,71 @@
+import { describe, it, expect, vi } from "vitest";
+import { GitHubTransport } from "./transports/github.js";
+import { SlackTransport } from "./transports/slack.js";
+describe("GitHubTransport", () => {
+    it("creates the comment on first publish (storing the id) then edits it", async () => {
+        const postComment = vi.fn(async () => 555);
+        const updateComment = vi.fn(async () => { });
+        const github = { postComment, updateComment };
+        const saved = [];
+        const t = new GitHubTransport({
+            github, owner: "o", repo: "r", issueNumber: 7, save: (id) => saved.push(id),
+        });
+        await t.publish("first");
+        await t.publish("second");
+        expect(postComment).toHaveBeenCalledTimes(1);
+        expect(postComment).toHaveBeenCalledWith("o", "r", 7, "first");
+        expect(updateComment).toHaveBeenCalledTimes(1);
+        expect(updateComment).toHaveBeenCalledWith("o", "r", 555, "second");
+        expect(saved).toEqual([555]);
+    });
+    it("re-attaches to an existing comment id (resume) and only edits", async () => {
+        const postComment = vi.fn(async () => 999);
+        const updateComment = vi.fn(async () => { });
+        const github = { postComment, updateComment };
+        const t = new GitHubTransport({ github, owner: "o", repo: "r", issueNumber: 7, commentId: 42 });
+        await t.publish("edit me");
+        expect(postComment).not.toHaveBeenCalled();
+        expect(updateComment).toHaveBeenCalledWith("o", "r", 42, "edit me");
+    });
+    it("note always posts a fresh comment", async () => {
+        const postComment = vi.fn(async () => 1);
+        const github = { postComment, updateComment: vi.fn() };
+        const t = new GitHubTransport({ github, owner: "o", repo: "r", issueNumber: 7, commentId: 42 });
+        await t.note("ping");
+        expect(postComment).toHaveBeenCalledWith("o", "r", 7, "ping");
+    });
+});
+describe("SlackTransport", () => {
+    it("posts the message on first publish (storing the ts) then updates it", async () => {
+        const sendMessage = vi.fn(async () => "111.222");
+        const updateMessage = vi.fn(async () => { });
+        const slack = { sendMessage, updateMessage };
+        const saved = [];
+        const t = new SlackTransport({
+            slack, channel: "C", thread: "T", save: (ts) => saved.push(ts),
+        });
+        await t.publish("first");
+        await t.publish("second");
+        expect(sendMessage).toHaveBeenCalledTimes(1);
+        expect(sendMessage).toHaveBeenCalledWith("C", "T", "first");
+        expect(updateMessage).toHaveBeenCalledTimes(1);
+        expect(updateMessage).toHaveBeenCalledWith("C", "111.222", "second");
+        expect(saved).toEqual(["111.222"]);
+    });
+    it("wants a terminal ping (silent edits, no other signal) unlike GitHub", () => {
+        const slack = new SlackTransport({ slack: {}, channel: "C", thread: "T" });
+        const gh = new GitHubTransport({ github: {}, owner: "o", repo: "r", issueNumber: 1 });
+        expect(slack.terminalPing).toBe(true);
+        expect(gh.terminalPing).toBeFalsy();
+    });
+    it("re-attaches to an existing ts (resume) and only updates", async () => {
+        const sendMessage = vi.fn(async () => "x");
+        const updateMessage = vi.fn(async () => { });
+        const slack = { sendMessage, updateMessage };
+        const t = new SlackTransport({ slack, channel: "C", thread: "T", ts: "900.1" });
+        await t.publish("edit");
+        expect(sendMessage).not.toHaveBeenCalled();
+        expect(updateMessage).toHaveBeenCalledWith("C", "900.1", "edit");
+    });
+});
+//# sourceMappingURL=transports.test.js.map

package/dist/notify/transports.test.js.map

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