prtape-cli 0.0.0-stage → 0.1.0

package/dist/run.js

@@ -0,0 +1,218 @@
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { parseClaude } from "./adapters/claude.js";
+import { defaultClaudeHome, findSession, NoSessionError, } from "./discover.js";
+import { presentSummary } from "./display.js";
+import { glanceRaster } from "./glance.js";
+import { GhError, postComment, pullRequestHead } from "./gh.js";
+import { hostTimelinePng } from "./orphan.js";
+import { renderPng } from "./png.js";
+import { sessionIsEmpty } from "./summary.js";
+import { renderComment, terminalSummary } from "./timeline/md.js";
+import { publicSteps } from "./timeline/format.js";
+import { renderSvg } from "./timeline/svg.js";
+import { VERSION } from "./version.js";
+export function toPublicJson(summary, image = { imageHosted: false }) {
+    return {
+        version: VERSION,
+        source: summary.source,
+        startedAt: summary.startedAt ?? null,
+        model: summary.model ?? null,
+        branch: summary.branch ?? null,
+        title: summary.title,
+        decision: summary.decision,
+        testsRun: summary.testsRun,
+        tests: summary.tests,
+        files: summary.files.filter((file) => isRepoRelative(file.path)),
+        steps: publicSteps(summary.steps.flatMap((step) => {
+            if ((step.kind === "read" || step.kind === "edit") && step.path && !isRepoRelative(step.path)) {
+                return step.kind === "read" ? [{ ...step, path: undefined }] : [];
+            }
+            return [step];
+        })),
+        imageHosted: image.imageHosted,
+        imageUrl: image.imageUrl ?? null,
+    };
+}
+export async function runPr(options) {
+    const cwd = path.resolve(options.cwd);
+    const found = locate(options, cwd);
+    const raw = readSession(found.path);
+    const summary = parseFound(found.path, raw);
+    if (!summary.branch) {
+        const branch = gitBranch(cwd);
+        if (branch)
+            summary.branch = branch;
+    }
+    if (!options.dryRun) {
+        const head = await pullRequestHead(cwd, options.runner, options.prNumber);
+        if (head)
+            summary.branch = head;
+    }
+    if (sessionIsEmpty(summary)) {
+        throw new NoSessionError(`Nothing to timeline in ${found.path}. No prompt, edit, test, or summary was recognized.`);
+    }
+    const redactOptions = { emails: options.redactEmails };
+    const view = presentSummary(summary, redactOptions);
+    const shown = view.summary;
+    const svg = renderSvg(summary, redactOptions, options.demo === true);
+    const tmpDir = options.tmpDir ?? os.tmpdir();
+    const svgPath = writeTimelineFile(svg, cwd, summary.sessionId, tmpDir, "svg");
+    const raster = rasterize(svg);
+    const pngPath = raster.png
+        ? writeTimelineFile(raster.png, cwd, summary.sessionId, tmpDir, "png")
+        : undefined;
+    if (options.dryRun) {
+        return {
+            summary: shown,
+            comment: pngPath
+                ? renderComment(summary, redactOptions, { url: "timeline.png", isPrivate: false, dryRun: true }, options.demo === true)
+                : renderComment(summary, redactOptions, undefined, options.demo === true),
+            svg,
+            svgPath,
+            pngPath,
+            posted: false,
+            imageHosted: false,
+            sessionNote: found.note,
+            origin: found.path,
+            note: [
+                "PRtape dry-run. Nothing was posted and nothing was pushed.",
+                "A real run pushes the PNG to refs/prtape/<head> and the comment leads with https://github.com/{owner}/{repo}/raw/{sha}/timeline.png.",
+                "Logged-out viewers see that image on a public repo. On a private repo they may not.",
+            ].join("\n"),
+        };
+    }
+    const hosted = await resolveHost(options, cwd, raster);
+    const comment = hosted.ok
+        ? renderComment(summary, redactOptions, { url: hosted.url, isPrivate: hosted.isPrivate }, options.demo === true)
+        : renderComment(summary, redactOptions, undefined, options.demo === true);
+    const base = {
+        summary: shown,
+        comment,
+        svg,
+        svgPath,
+        pngPath,
+        sessionNote: found.note,
+        origin: found.path,
+        imageHosted: hosted.ok,
+        imageUrl: hosted.ok ? hosted.url : undefined,
+    };
+    if (!hosted.ok && blocksComment(hosted.glance)) {
+        return { ...base, posted: false, note: `${hosted.glance}\nNothing was posted.` };
+    }
+    try {
+        const pr = await postComment(cwd, comment, options.runner, options.prNumber);
+        if (!hosted.ok) {
+            return {
+                ...base,
+                posted: true,
+                prNumber: pr.number,
+                prUrl: pr.url || undefined,
+                note: `${hosted.glance}\n${pr.updated ? "Updated" : "Posted"} the text timeline on PR #${pr.number}. The PNG is not in the comment.`,
+            };
+        }
+        return {
+            ...base,
+            posted: true,
+            prNumber: pr.number,
+            prUrl: pr.url || undefined,
+            note: `${pr.updated ? "Updated" : "Commented on"} PR #${pr.number} with the hosted PNG.\n${hosted.url}`,
+        };
+    }
+    catch (error) {
+        const reason = error instanceof GhError ? error.message : "Could not post the comment.";
+        const imageLine = hosted.ok
+            ? `The PNG is on ${hosted.ref} at ${hosted.url}, but the comment was not posted.`
+            : hosted.glance;
+        return { ...base, posted: false, note: `${imageLine}\n${reason} Nothing was posted.` };
+    }
+}
+function rasterize(svg) {
+    try {
+        return { png: renderPng(svg) };
+    }
+    catch {
+        return { glance: glanceRaster() };
+    }
+}
+async function resolveHost(options, cwd, raster) {
+    if (!raster.png)
+        return { ok: false, glance: raster.glance ?? glanceRaster() };
+    if (options.hostImage)
+        return options.hostImage({ cwd, png: raster.png });
+    return hostTimelinePng({ cwd, png: raster.png, runner: options.runner, tmpRoot: options.tmpDir });
+}
+function blocksComment(glance) {
+    return /gh is not installed|gh is not authenticated/.test(glance);
+}
+export function formatPosted(result) {
+    const lines = [result.note];
+    if (result.prUrl)
+        lines.push(result.prUrl);
+    lines.push(`SVG: ${result.svgPath}`);
+    if (result.pngPath)
+        lines.push(`PNG: ${result.pngPath}`);
+    lines.push("");
+    lines.push(terminalSummary(result.summary));
+    return `${lines.join("\n")}\n`;
+}
+function locate(options, cwd) {
+    if (options.sessionPath) {
+        const file = path.resolve(options.sessionPath);
+        if (!fs.existsSync(file) || !fs.statSync(file).isFile()) {
+            throw new NoSessionError(`Session file not found: ${file}`);
+        }
+        return { source: "claude-code", path: file };
+    }
+    const discover = {
+        cwd,
+        source: options.source,
+        claudeHome: options.claudeHome ?? defaultClaudeHome(),
+        recentFiles: options.recentFiles,
+    };
+    return findSession(discover);
+}
+function parseFound(file, raw) {
+    return parseClaude(raw, path.basename(file));
+}
+/** A path a reviewer can place inside the repository. Home leftovers and absolutes stay out. */
+function isRepoRelative(filePath) {
+    const value = filePath.replace(/\\/g, "/").trim();
+    if (!value || value.startsWith("/") || /^[A-Za-z]:\//.test(value))
+        return false;
+    if (value === ".." || value.startsWith("../") || value.includes("/../"))
+        return false;
+    return true;
+}
+function readSession(file) {
+    return fs.readFileSync(file, "utf8");
+}
+export function writeTimelineFile(contents, cwd, sessionId, tmpDir, extension) {
+    const safe = sessionId.replace(/[^A-Za-z0-9_-]+/g, "").slice(0, 48) || "session";
+    const file = path.join(tmpDir, `prtape-${safe}.${extension}`);
+    assertNotInsideProject(file, cwd);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, contents, { mode: 0o600 });
+    return file;
+}
+export function assertNotInsideProject(target, cwd) {
+    const file = path.resolve(target);
+    const root = path.resolve(cwd);
+    const relative = path.relative(root, file);
+    const inside = relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+    if (inside) {
+        throw new Error(`Refusing to write the timeline inside the project tree (${file}).`);
+    }
+}
+function gitBranch(cwd) {
+    const result = spawnSync("git", ["rev-parse", "--abbrev-ref", "HEAD"], { cwd, encoding: "utf8" });
+    if (result.status !== 0)
+        return undefined;
+    const name = result.stdout.trim();
+    if (!name || name === "HEAD")
+        return undefined;
+    return name;
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

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

package/dist/summary.d.ts

@@ -0,0 +1,7 @@
+import type { SessionDraft, SessionSummary, TestOutcome, TestRun } from "./types.js";
+export declare function withSteps(draft: SessionDraft): SessionSummary;
+export declare function addFile(files: SessionDraft["files"], filePath: string, action: SessionDraft["files"][number]["action"]): void;
+/** Keep every run, in order, so a later pass does not erase the earlier failure. */
+export declare function addTest(tests: TestRun[], command: string, outcome: TestOutcome): void;
+export declare function sessionIsEmpty(summary: SessionSummary): boolean;
+export declare function rollupTests(tests: TestRun[]): "pass" | "fail" | "unknown" | "none";

package/dist/summary.js

@@ -0,0 +1,134 @@
+import { displayTestCommand } from "./tests-detect.js";
+import { FALLBACK_DECISION, FALLBACK_TITLE } from "./types.js";
+const FILE_RANK = { edit: 1, delete: 2, write: 3 };
+export function withSteps(draft) {
+    const title = draft.title.trim() || FALLBACK_TITLE;
+    const decision = draft.decision.trim() || FALLBACK_DECISION;
+    const events = collapseIdenticalFails(draft.events ?? bucketEvents(draft.files, draft.tests));
+    const files = draft.events ? filesFrom(events) : draft.files;
+    const tests = draft.events ? testsFrom(events) : draft.tests;
+    const steps = [
+        { kind: "prompt", text: title },
+        ...events.map((event) => eventStep(event)),
+        { kind: "decision", text: decision },
+    ];
+    return {
+        ...draft,
+        title,
+        decision,
+        files,
+        tests,
+        events,
+        testsRun: tests.length > 0,
+        steps,
+    };
+}
+/**
+ * Drop a second record of the same failing command.
+ * Adjacent duplicates are one tool call stored twice.
+ * A failing test bundled with the inspection reads that follow an earlier
+ * failure of that same command is the same run, not a new attempt.
+ * A later failure after a separate read stays.
+ */
+function collapseIdenticalFails(events) {
+    const kept = [];
+    for (const event of events) {
+        if (isDuplicateFail(kept, event))
+            continue;
+        kept.push(event);
+    }
+    return kept;
+}
+function isDuplicateFail(kept, event) {
+    if (event.kind !== "test" || event.outcome !== "fail")
+        return false;
+    const command = displayTestCommand(event.command);
+    if (!command)
+        return false;
+    const previous = kept.at(-1);
+    if (previous?.kind === "test" && previous.outcome === "fail" && displayTestCommand(previous.command) === command) {
+        return true;
+    }
+    if (!event.batch)
+        return false;
+    let index = kept.length - 1;
+    while (index >= 0 && kept[index]?.kind === "read" && kept[index]?.batch === event.batch)
+        index -= 1;
+    if (index === kept.length - 1)
+        return false;
+    const earlier = kept[index];
+    return earlier?.kind === "test" && earlier.outcome === "fail" && displayTestCommand(earlier.command) === command;
+}
+/** Files then tests. Used when a parser has no interleaved event list. */
+function bucketEvents(files, tests) {
+    return [
+        ...files.map((file) => ({ kind: "edit", path: file.path, action: file.action })),
+        ...tests.map((test) => ({ kind: "test", command: test.command, outcome: test.outcome })),
+    ];
+}
+function filesFrom(events) {
+    const files = [];
+    for (const event of events) {
+        if (event.kind === "edit")
+            addFile(files, event.path, event.action);
+    }
+    return files;
+}
+function testsFrom(events) {
+    return events
+        .filter((event) => event.kind === "test")
+        .map((event) => ({
+        command: event.command,
+        outcome: event.outcome,
+        failed: event.failed,
+        passed: event.passed,
+        total: event.total,
+        failedName: event.failedName,
+    }));
+}
+function eventStep(event) {
+    switch (event.kind) {
+        case "read":
+            return { kind: "read", path: event.path };
+        case "edit":
+            return { kind: "edit", path: event.path, action: event.action };
+        case "test":
+            return { kind: "test", command: event.command, outcome: event.outcome };
+        case "commit":
+            return { kind: "commit" };
+        default: {
+            const never = event;
+            return never;
+        }
+    }
+}
+export function addFile(files, filePath, action) {
+    const existing = files.find((file) => file.path === filePath);
+    if (!existing) {
+        files.push({ path: filePath, action });
+        return;
+    }
+    if (FILE_RANK[action] > FILE_RANK[existing.action]) {
+        existing.action = action;
+    }
+}
+/** Keep every run, in order, so a later pass does not erase the earlier failure. */
+export function addTest(tests, command, outcome) {
+    const key = command.trim();
+    if (!key)
+        return;
+    tests.push({ command: key, outcome });
+}
+export function sessionIsEmpty(summary) {
+    return (summary.title === FALLBACK_TITLE &&
+        summary.decision === FALLBACK_DECISION &&
+        summary.files.length === 0 &&
+        summary.tests.length === 0);
+}
+export function rollupTests(tests) {
+    const last = tests.at(-1);
+    if (!last)
+        return "none";
+    return last.outcome;
+}
+//# sourceMappingURL=summary.js.map

package/dist/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../src/summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,SAAS,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAW,CAAC;AAE5D,MAAM,UAAU,SAAS,CAAC,KAAmB;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,cAAc,CAAC;IACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,iBAAiB,CAAC;IAC5D,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,MAAM,IAAI,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9F,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IAC7D,MAAM,KAAK,GAAW;QACpB,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE;QAC/B,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1C,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;KACrC,CAAC;IACF,OAAO;QACL,GAAG,KAAK;QACR,KAAK;QACL,QAAQ;QACR,KAAK;QACL,KAAK;QACL,MAAM;QACN,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC;QAC1B,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,sBAAsB,CAAC,MAAuB;IACrD,MAAM,IAAI,GAAoB,EAAE,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC;YAAE,SAAS;QAC3C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,eAAe,CAAC,IAAqB,EAAE,KAAoB;IAClE,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACpE,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,QAAQ,EAAE,IAAI,KAAK,MAAM,IAAI,QAAQ,CAAC,OAAO,KAAK,MAAM,IAAI,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,OAAO,EAAE,CAAC;QACjH,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAC/B,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5B,OAAO,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,KAAK,CAAC,KAAK;QAAE,KAAK,IAAI,CAAC,CAAC;IACpG,IAAI,KAAK,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,OAAO,EAAE,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,OAAO,KAAK,MAAM,IAAI,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC;AACnH,CAAC;AAED,0EAA0E;AAC1E,SAAS,YAAY,CAAC,KAA4B,EAAE,KAAgB;IAClE,OAAO;QACL,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACzF,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;KAClG,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,MAAuB;IACxC,MAAM,KAAK,GAA0B,EAAE,CAAC;IACxC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,MAAuB;IACxC,OAAO,MAAM;SACV,MAAM,CAAC,CAAC,KAAK,EAAqD,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;SAC3F,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAC,CAAC;AACR,CAAC;AAED,SAAS,SAAS,CAAC,KAAoB;IACrC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5C,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;QAClE,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAC1E,KAAK,QAAQ;YACX,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5B,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,KAAK,GAAU,KAAK,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,KAA4B,EAC5B,QAAgB,EAChB,MAA+C;IAE/C,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAC9D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACvC,OAAO;IACT,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,OAAO,CAAC,KAAgB,EAAE,OAAe,EAAE,OAAoB;IAC7E,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,OAAO,CACL,OAAO,CAAC,KAAK,KAAK,cAAc;QAChC,OAAO,CAAC,QAAQ,KAAK,iBAAiB;QACtC,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAgB;IAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IACzB,OAAO,IAAI,CAAC,OAAO,CAAC;AACtB,CAAC"}

package/dist/tests-detect.d.ts

@@ -0,0 +1,19 @@
+import type { TestOutcome } from "./types.js";
+export declare function isTestCommand(command: string): boolean;
+/**
+ * Node's built-in TAP reporter prints a summary even when the shell pipeline
+ * exits 0 (`npm test | tee log`). Those counts decide the outcome. A successful
+ * `tee` is not a passing suite.
+ */
+export declare function classifyNodeTap(output: string): TestOutcome | undefined;
+export declare function classifyTestOutput(output: string, isError: boolean, interrupted?: boolean): TestOutcome;
+export interface ParsedTestCounts {
+    failed?: number;
+    passed?: number;
+    total?: number;
+    failedName?: string;
+}
+/** Counts and the first failing name. Missing fields stay unset. Nothing is guessed. */
+export declare function parseTestCounts(output: string): ParsedTestCounts;
+/** The test invocation inside a pipeline, without tee or log paths. */
+export declare function displayTestCommand(command: string): string;

package/dist/tests-detect.js

@@ -0,0 +1,97 @@
+/**
+ * Commands that mean "the agent ran the test suite".
+ * Matched against a shell invocation, not against prose.
+ * Leading environment assignments (`FOO=bar npm test`) are ignored.
+ */
+const TEST_COMMAND = /^(?:npm(?:\s+run)?\s+test|pnpm(?:\s+run)?\s+test|yarn\s+test|bun\s+(?:run\s+)?test|npx\s+(?:vitest|jest|mocha)|vitest|jest|mocha|pytest|py\.test|python(?:3)?\s+-m\s+pytest|tox|cargo\s+test|go\s+test|mvn(?:\s+\S+)*\s+test|gradle(?:w)?(?:\s+\S+)*\s+test|ctest|make\s+test|rake\s+test|rspec|phpunit|mix\s+test|deno\s+test|dotnet\s+test)\b/;
+export function isTestCommand(command) {
+    const flat = command.replace(/\s+/g, " ").trim();
+    const parts = flat.split(/\s*(?:&&|\|\||[;&|])\s*/);
+    return parts.some((part) => {
+        const stripped = part.replace(/^(?:[A-Za-z_][A-Za-z0-9_]*=\S*\s+)+/, "");
+        return TEST_COMMAND.test(stripped);
+    });
+}
+/**
+ * Node's built-in TAP reporter prints a summary even when the shell pipeline
+ * exits 0 (`npm test | tee log`). Those counts decide the outcome. A successful
+ * `tee` is not a passing suite.
+ */
+export function classifyNodeTap(output) {
+    const fail = lastTapCount(output, "fail");
+    const pass = lastTapCount(output, "pass");
+    if (fail !== undefined && fail > 0)
+        return "fail";
+    if (pass !== undefined && pass > 0 && (fail === undefined || fail === 0))
+        return "pass";
+    if (/\bnot ok\b/i.test(output))
+        return "fail";
+    return undefined;
+}
+export function classifyTestOutput(output, isError, interrupted = false) {
+    if (interrupted)
+        return "fail";
+    const tap = classifyNodeTap(output);
+    if (tap)
+        return tap;
+    if (isError)
+        return "fail";
+    const failedCount = /(\d+)\s+failed\b/i.exec(output);
+    if (failedCount && Number(failedCount[1]) > 0)
+        return "fail";
+    if (/\b(FAIL|FAILED|FAILURES)\b/.test(output))
+        return "fail";
+    if (/\bexit code (?!0\b)\d+/i.test(output))
+        return "fail";
+    if (/\b(PASS|PASSED)\b/.test(output) ||
+        /\b\d+\s+passed\b/i.test(output) ||
+        /\bexit code 0\b/i.test(output) ||
+        (failedCount !== null && Number(failedCount[1]) === 0)) {
+        return "pass";
+    }
+    return "unknown";
+}
+/** Counts and the first failing name. Missing fields stay unset. Nothing is guessed. */
+export function parseTestCounts(output) {
+    const counts = {};
+    const failed = lastTapCount(output, "fail") ?? firstNumber(output, /(\d+)\s+failed\b/i);
+    const passed = lastTapCount(output, "pass") ?? firstNumber(output, /(\d+)\s+passed\b/i);
+    const total = lastTapCount(output, "tests") ?? firstNumber(output, /(\d+)\s+total\b/i);
+    if (failed !== undefined)
+        counts.failed = failed;
+    if (passed !== undefined)
+        counts.passed = passed;
+    if (total !== undefined)
+        counts.total = total;
+    const name = /^not ok \d+ - (.+)$/m.exec(output)?.[1]?.trim();
+    if (name)
+        counts.failedName = name;
+    return counts;
+}
+function firstNumber(output, pattern) {
+    const match = pattern.exec(output);
+    if (!match?.[1])
+        return undefined;
+    return Number(match[1]);
+}
+function lastTapCount(output, label) {
+    const pattern = new RegExp(`^\\s*#\\s+${label}\\s+(\\d+)\\s*$`, "gim");
+    let last;
+    for (const match of output.matchAll(pattern)) {
+        last = Number(match[1]);
+    }
+    return last;
+}
+/** The test invocation inside a pipeline, without tee or log paths. */
+export function displayTestCommand(command) {
+    const flat = command.replace(/\s+/g, " ").trim();
+    const parts = flat.split(/\s*(?:&&|\|\||[;&|])\s*/);
+    for (const part of parts) {
+        const stripped = part.replace(/^(?:[A-Za-z_][A-Za-z0-9_]*=\S*\s+)+/, "").replace(/\s+\d*>&\d+.*$/, "").trim();
+        const match = stripped.match(TEST_COMMAND);
+        if (match?.[0])
+            return match[0];
+    }
+    return "";
+}
+//# sourceMappingURL=tests-detect.js.map

package/dist/tests-detect.js.map

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

package/dist/text.d.ts

@@ -0,0 +1,8 @@
+/** Collapse whitespace into a single line. */
+export declare function oneLine(value: string): string;
+/** Shorten `value` to `max` characters, counting the ellipsis. */
+export declare function truncate(value: string, max: number): string;
+export declare function escapeXml(value: string): string;
+/** First sentence, used as the short "ask" on the visual timeline. */
+export declare function firstSentence(value: string): string;
+export declare function escapeMdCell(value: string): string;

package/dist/text.js

@@ -0,0 +1,31 @@
+/** Collapse whitespace into a single line. */
+export function oneLine(value) {
+    return value.replace(/\s+/g, " ").trim();
+}
+/** Shorten `value` to `max` characters, counting the ellipsis. */
+export function truncate(value, max) {
+    const text = oneLine(value);
+    if (text.length <= max)
+        return text;
+    if (max <= 1)
+        return "…";
+    return `${text.slice(0, max - 1).trimEnd()}…`;
+}
+export function escapeXml(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+/** First sentence, used as the short "ask" on the visual timeline. */
+export function firstSentence(value) {
+    const line = oneLine(value);
+    const match = /^(.+?[.!?])(?:\s|$)/.exec(line);
+    return match?.[1] ?? line;
+}
+export function escapeMdCell(value) {
+    return oneLine(value).replace(/\|/g, "\\|");
+}
+//# sourceMappingURL=text.js.map

package/dist/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,GAAW;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IACzB,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,KAAK;SACT,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC"}

package/dist/timeline/format.d.ts

@@ -0,0 +1,28 @@
+import type { SessionSummary, SourceKind, Step } from "../types.js";
+export declare function sourceLabel(source: SourceKind): string;
+/** `2026-11-01T15:04:22.000Z` → `2026-11-01 15:04 UTC`. Naive timestamps omit UTC. */
+export declare function formatWhen(value: string | undefined): string | undefined;
+export declare function filesDetail(summary: SessionSummary, maxNames?: number): string;
+/**
+ * Reviewer-facing test line.
+ * A fail-then-pass pair with counts is `6 failed → 13/13 pass`.
+ * One passing run with counts is `13/13 pass`.
+ * Otherwise the last command, such as `npm test · pass`.
+ */
+export declare function testsPhrase(summary: SessionSummary): string;
+/** One passing run, and no failure, when that run published both counts. */
+export declare function solePass(summary: SessionSummary): {
+    passed: number;
+    total: number;
+} | undefined;
+export declare function testsTransition(summary: SessionSummary): {
+    failed: number;
+    passed: number;
+    total: number;
+} | undefined;
+export declare function publicSteps(steps: Step[]): Step[];
+export declare function asciiFlow(summary: SessionSummary): string;
+export declare function footerLine(summary: SessionSummary): string;
+export declare function askLine(summary: SessionSummary, max?: number): string;
+export declare function decisionLine(summary: SessionSummary, max?: number): string;
+export declare function stepText(step: Step): string;