prtape-cli 0.0.0-stage → 0.1.1

package/dist/gh.js

@@ -0,0 +1,190 @@
+import { spawn } from "node:child_process";
+export class GhError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "GhError";
+    }
+}
+/**
+ * The only network path in PRtape. `gh` talks to GitHub when the user
+ * runs `prtape pr` without `--dry-run`. There is no telemetry.
+ */
+export function defaultRunner(command, args, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, { cwd: options.cwd, stdio: ["pipe", "pipe", "pipe"] });
+        const stdout = [];
+        const stderr = [];
+        child.stdout.on("data", (chunk) => stdout.push(chunk));
+        child.stderr.on("data", (chunk) => stderr.push(chunk));
+        child.on("error", (error) => {
+            if (error.code === "ENOENT") {
+                resolve({ code: 127, stdout: "", stderr: `${command} not found` });
+                return;
+            }
+            reject(error);
+        });
+        child.on("close", (code) => {
+            resolve({
+                code: code ?? 1,
+                stdout: Buffer.concat(stdout).toString("utf8"),
+                stderr: Buffer.concat(stderr).toString("utf8"),
+            });
+        });
+        if (options.input !== undefined)
+            child.stdin.end(options.input);
+        else
+            child.stdin.end();
+    });
+}
+export function explainGhFailure(result) {
+    const text = `${result.stderr}\n${result.stdout}`;
+    if (result.code === 127 || /not found|ENOENT/i.test(text)) {
+        return "gh is not installed.";
+    }
+    if (/not logged into|gh auth login|GH_TOKEN|GITHUB_TOKEN|HTTP 401|HTTP 403|authentication required|set up authentication/i.test(text)) {
+        return "gh is not authenticated.";
+    }
+    if (/no pull requests? found|no prs? found/i.test(text)) {
+        return "No pull request for this branch.";
+    }
+    const detail = result.stderr.trim().split("\n").find((line) => line.trim()) ?? "gh failed.";
+    return detail;
+}
+/**
+ * PNG comments and the mermaid fallback both match. Other review chatter does not.
+ * `<!-- prtape -->` is the marker id. Visible headings say PRtape.
+ * Older AgentTape comments still match so a rerun updates them.
+ */
+export function isPrtapeComment(body) {
+    return (body.includes("<!-- prtape -->") ||
+        body.includes("![PRtape timeline](") ||
+        body.includes("### PRtape") ||
+        body.includes("Redacted locally by PRtape") ||
+        body.includes("![AgentTape timeline](") ||
+        body.includes("### AgentTape") ||
+        body.includes("Redacted locally by AgentTape"));
+}
+/** @deprecated Use isPrtapeComment. Kept so older imports still find both markers. */
+export function isAgentTapeComment(body) {
+    return isPrtapeComment(body);
+}
+/**
+ * Create or update one PRtape comment on the pull request.
+ * A second run PATCHes the latest matching comment from the current `gh` user
+ * instead of calling `gh pr comment` again.
+ */
+/** Head branch of the pull request that will receive the comment. Undefined when gh cannot answer. */
+export async function pullRequestHead(cwd, runner = defaultRunner, prNumber) {
+    const selector = prNumber !== undefined ? [String(prNumber)] : [];
+    const view = await runner("gh", ["pr", "view", ...selector, "--json", "headRefName"], { cwd });
+    if (view.code !== 0)
+        return undefined;
+    try {
+        const parsed = JSON.parse(view.stdout);
+        return typeof parsed.headRefName === "string" && parsed.headRefName.trim() ? parsed.headRefName.trim() : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function postComment(cwd, body, runner = defaultRunner, prNumber) {
+    const selector = prNumber !== undefined ? [String(prNumber)] : [];
+    const view = await runner("gh", ["pr", "view", ...selector, "--json", "number,url,title"], { cwd });
+    if (view.code !== 0)
+        throw new GhError(explainGhFailure(view));
+    let parsed;
+    try {
+        parsed = JSON.parse(view.stdout);
+    }
+    catch {
+        throw new GhError("gh pr view did not return JSON.");
+    }
+    if (typeof parsed.number !== "number") {
+        throw new GhError("No pull request for this branch.");
+    }
+    const url = typeof parsed.url === "string" ? parsed.url : "";
+    const repo = ownerRepo(url) ?? (await repoSlug(cwd, runner));
+    if (!repo)
+        throw new GhError("Could not resolve owner/repo for the pull request comment.");
+    const login = await currentLogin(cwd, runner);
+    const existing = login ? await latestAgentTapeComment(cwd, runner, repo, parsed.number, login) : undefined;
+    const payload = JSON.stringify({ body });
+    if (existing) {
+        const patched = await runner("gh", ["api", "--method", "PATCH", `repos/${repo}/issues/comments/${existing.id}`, "--input", "-"], { cwd, input: payload });
+        if (patched.code !== 0)
+            throw new GhError(explainGhFailure(patched));
+        return { number: parsed.number, url, commentId: existing.id, updated: true };
+    }
+    const created = await runner("gh", ["api", "--method", "POST", `repos/${repo}/issues/${parsed.number}/comments`, "--input", "-"], { cwd, input: payload });
+    if (created.code !== 0)
+        throw new GhError(explainGhFailure(created));
+    let commentId = 0;
+    try {
+        const createdBody = JSON.parse(created.stdout);
+        if (typeof createdBody.id === "number")
+            commentId = createdBody.id;
+    }
+    catch {
+        commentId = 0;
+    }
+    return { number: parsed.number, url, commentId, updated: false };
+}
+function ownerRepo(url) {
+    const match = /^https:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?\/pull\/\d+/.exec(url);
+    if (!match?.[1] || !match[2])
+        return undefined;
+    return `${match[1]}/${match[2]}`;
+}
+async function repoSlug(cwd, runner) {
+    const view = await runner("gh", ["repo", "view", "--json", "nameWithOwner"], { cwd });
+    if (view.code !== 0)
+        return undefined;
+    try {
+        const parsed = JSON.parse(view.stdout);
+        return typeof parsed.nameWithOwner === "string" ? parsed.nameWithOwner : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function currentLogin(cwd, runner) {
+    const user = await runner("gh", ["api", "user"], { cwd });
+    if (user.code !== 0)
+        return undefined;
+    try {
+        const parsed = JSON.parse(user.stdout);
+        return typeof parsed.login === "string" ? parsed.login : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function latestAgentTapeComment(cwd, runner, repo, prNumber, login) {
+    const listed = await runner("gh", ["api", "--paginate", `repos/${repo}/issues/${prNumber}/comments`], { cwd });
+    if (listed.code !== 0)
+        throw new GhError(explainGhFailure(listed));
+    let comments = [];
+    try {
+        const parsed = JSON.parse(listed.stdout);
+        if (Array.isArray(parsed))
+            comments = parsed;
+    }
+    catch {
+        throw new GhError("gh api did not return pull request comments as JSON.");
+    }
+    const mine = comments.filter((comment) => {
+        return (comment.user?.login === login &&
+            typeof comment.body === "string" &&
+            isPrtapeComment(comment.body) &&
+            typeof comment.id === "number");
+    });
+    mine.sort((a, b) => {
+        const byTime = String(b.created_at ?? "").localeCompare(String(a.created_at ?? ""));
+        if (byTime !== 0)
+            return byTime;
+        return Number(b.id) - Number(a.id);
+    });
+    const latest = mine[0];
+    return typeof latest?.id === "number" ? { id: latest.id } : undefined;
+}
+//# sourceMappingURL=gh.js.map

package/dist/gh.js.map

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

package/dist/glance.d.ts

@@ -0,0 +1,15 @@
+/**
+ * One-glance failures: what broke, how to fix it, and the text-timeline fallback.
+ * These strings are the product contract. Do not shorten them into a bare exit code.
+ */
+/** Custom ref namespace. Never a branch under refs/heads, so it cannot merge into main. */
+export declare const ORPHAN_REF_PREFIX = "refs/prtape";
+export declare function orphanRef(anchor: string): string;
+export declare function glanceMissingGh(): string;
+export declare function glanceUnauth(): string;
+export declare function glancePushDenied(): string;
+export declare function glancePushOther(detail: string): string;
+export declare function glanceNoOrigin(): string;
+export declare function glanceRaster(): string;
+export declare function glanceRepoUnreadable(detail: string): string;
+export declare function isPermissionFailure(text: string): boolean;

package/dist/glance.js

@@ -0,0 +1,75 @@
+/**
+ * One-glance failures: what broke, how to fix it, and the text-timeline fallback.
+ * These strings are the product contract. Do not shorten them into a bare exit code.
+ */
+/** Custom ref namespace. Never a branch under refs/heads, so it cannot merge into main. */
+export const ORPHAN_REF_PREFIX = "refs/prtape";
+export function orphanRef(anchor) {
+    const safe = anchor.replace(/[^A-Za-z0-9._-]/g, "").slice(0, 64);
+    if (!safe) {
+        throw new Error("Refusing to build an orphan ref without an anchor.");
+    }
+    const ref = `${ORPHAN_REF_PREFIX}/${safe}`;
+    if (!ref.startsWith(`${ORPHAN_REF_PREFIX}/`)) {
+        throw new Error(`Refusing to push outside ${ORPHAN_REF_PREFIX}/.`);
+    }
+    return ref;
+}
+export function glanceMissingGh() {
+    return [
+        "Image not posted: gh is not installed.",
+        "Fix: install GitHub CLI from https://cli.github.com, then run `gh auth login`.",
+        "Fell back to the text timeline (ASCII + mermaid).",
+    ].join("\n");
+}
+export function glanceUnauth() {
+    return [
+        "Image not posted: gh is not authenticated.",
+        "Fix: run `gh auth login`.",
+        "Fell back to the text timeline (ASCII + mermaid).",
+    ].join("\n");
+}
+export function glancePushDenied() {
+    return [
+        `Image not posted: push to orphan ref ${ORPHAN_REF_PREFIX}/<sha> was denied.`,
+        "Fix: give this account write access to the repo, then rerun `prtape pr`.",
+        "Fell back to the text timeline (ASCII + mermaid).",
+    ].join("\n");
+}
+export function glancePushOther(detail) {
+    const line = detail.trim().split("\n").find((item) => item.trim()) ?? "git push failed.";
+    return [
+        `Image not posted: could not push the PNG to orphan ref ${ORPHAN_REF_PREFIX}/<sha>.`,
+        line,
+        "Fix: run `gh auth status`, confirm you can push to origin, then rerun `prtape pr`.",
+        "Fell back to the text timeline (ASCII + mermaid).",
+    ].join("\n");
+}
+export function glanceNoOrigin() {
+    return [
+        "Image not posted: this repo has no origin remote.",
+        "Fix: `git remote add origin <github-url>`, then rerun `prtape pr`.",
+        "Fell back to the text timeline (ASCII + mermaid).",
+    ].join("\n");
+}
+export function glanceRaster() {
+    return [
+        "Image not posted: the timeline PNG could not be rendered.",
+        "Fix: reinstall prtape-cli so the SVG rasterizer is available, then rerun `prtape pr`.",
+        "Fell back to the text timeline (ASCII + mermaid).",
+    ].join("\n");
+}
+export function glanceRepoUnreadable(detail) {
+    const line = detail.trim().split("\n").find((item) => item.trim()) ?? "gh repo view failed.";
+    return [
+        "Image not posted: gh could not read this repository.",
+        line,
+        "Fix: run `gh repo view` from the project, then rerun `prtape pr`.",
+        "Fell back to the text timeline (ASCII + mermaid).",
+    ].join("\n");
+}
+const PERMISSION = /permission denied|HTTP 401|HTTP 403|403 Forbidden|authentication failed|could not read Username|denied to|not authorized|write access|GH006|GH013|protected branch/i;
+export function isPermissionFailure(text) {
+    return PERMISSION.test(text);
+}
+//# sourceMappingURL=glance.js.map

package/dist/glance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glance.js","sourceRoot":"","sources":["../src/glance.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,2FAA2F;AAC3F,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAE/C,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,iBAAiB,IAAI,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,iBAAiB,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,4BAA4B,iBAAiB,IAAI,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,wCAAwC;QACxC,gFAAgF;QAChF,mDAAmD;KACpD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,4CAA4C;QAC5C,2BAA2B;QAC3B,mDAAmD;KACpD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,wCAAwC,iBAAiB,oBAAoB;QAC7E,0EAA0E;QAC1E,mDAAmD;KACpD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,kBAAkB,CAAC;IACzF,OAAO;QACL,0DAA0D,iBAAiB,SAAS;QACpF,IAAI;QACJ,oFAAoF;QACpF,mDAAmD;KACpD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,mDAAmD;QACnD,oEAAoE;QACpE,mDAAmD;KACpD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,2DAA2D;QAC3D,uFAAuF;QACvF,mDAAmD;KACpD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,sBAAsB,CAAC;IAC7F,OAAO;QACL,sDAAsD;QACtD,IAAI;QACJ,mEAAmE;QACnE,mDAAmD;KACpD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,GACd,qKAAqK,CAAC;AAExK,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { parseClaude } from "./adapters/claude.js";
+export { findSession, NoSessionError, type SourceChoice } from "./discover.js";
+export { postComment, GhError } from "./gh.js";
+export { redact, redactSession, type RedactOptions } from "./redact.js";
+export { runPr, toPublicJson, type RunOptions, type RunResult } from "./run.js";
+export { hostTimelinePng, ORPHAN_FILE, rawPngUrl } from "./orphan.js";
+export { ORPHAN_REF_PREFIX, orphanRef } from "./glance.js";
+export { renderPng } from "./png.js";
+export { renderComment } from "./timeline/md.js";
+export { renderSvg } from "./timeline/svg.js";
+export type { SessionSummary, SourceKind } from "./types.js";
+export { VERSION } from "./version.js";

package/dist/index.js

@@ -0,0 +1,12 @@
+export { parseClaude } from "./adapters/claude.js";
+export { findSession, NoSessionError } from "./discover.js";
+export { postComment, GhError } from "./gh.js";
+export { redact, redactSession } from "./redact.js";
+export { runPr, toPublicJson } from "./run.js";
+export { hostTimelinePng, ORPHAN_FILE, rawPngUrl } from "./orphan.js";
+export { ORPHAN_REF_PREFIX, orphanRef } from "./glance.js";
+export { renderPng } from "./png.js";
+export { renderComment } from "./timeline/md.js";
+export { renderSvg } from "./timeline/svg.js";
+export { VERSION } from "./version.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAqB,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,aAAa,EAAsB,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAmC,MAAM,UAAU,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/orphan.d.ts

@@ -0,0 +1,44 @@
+import type { CommandRunner } from "./gh.js";
+export declare const ORPHAN_FILE = "timeline.png";
+export interface HostedPng {
+    ok: true;
+    url: string;
+    sha: string;
+    ref: string;
+    isPrivate: boolean;
+}
+export interface HostFailure {
+    ok: false;
+    glance: string;
+}
+export type HostResult = HostedPng | HostFailure;
+export interface GitResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+export type GitRunner = (args: string[], cwd: string, input?: string) => GitResult;
+export declare function defaultGit(args: string[], cwd: string, input?: string): GitResult;
+export interface HostInput {
+    cwd: string;
+    png: Buffer;
+    runner?: CommandRunner;
+    git?: GitRunner;
+    tmpRoot?: string;
+}
+/**
+ * Build a parentless commit whose tree is exactly `timeline.png`, then push
+ * it to `refs/prtape/<head-sha>`. No other blobs. The user's index, HEAD,
+ * branch, and working tree are not modified. The comment URL is
+ * `https://github.com/{owner}/{repo}/raw/{commit}/timeline.png`.
+ */
+export declare function hostTimelinePng(input: HostInput): Promise<HostResult>;
+export declare function rawPngUrl(nameWithOwner: string, sha: string): string;
+export declare function pushOrphanPng(input: {
+    remote: string;
+    png: Buffer;
+    anchor?: string;
+    git?: GitRunner;
+    tmpRoot?: string;
+    useGhCredential?: boolean;
+}): (HostedPng) | HostFailure;

package/dist/orphan.js

@@ -0,0 +1,152 @@
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { envValue } from "./env.js";
+import { defaultRunner } from "./gh.js";
+import { glanceMissingGh, glanceNoOrigin, glancePushDenied, glancePushOther, glanceRepoUnreadable, glanceUnauth, isPermissionFailure, orphanRef, } from "./glance.js";
+export const ORPHAN_FILE = "timeline.png";
+export function defaultGit(args, cwd, input) {
+    const result = spawnSync("git", args, {
+        cwd,
+        encoding: "utf8",
+        input,
+        env: { ...process.env, GIT_TERMINAL_PROMPT: "0" },
+    });
+    return {
+        code: result.status ?? 1,
+        stdout: result.stdout ?? "",
+        stderr: result.stderr ?? "",
+    };
+}
+/**
+ * Build a parentless commit whose tree is exactly `timeline.png`, then push
+ * it to `refs/prtape/<head-sha>`. No other blobs. The user's index, HEAD,
+ * branch, and working tree are not modified. The comment URL is
+ * `https://github.com/{owner}/{repo}/raw/{commit}/timeline.png`.
+ */
+export async function hostTimelinePng(input) {
+    const runner = input.runner ?? defaultRunner;
+    const git = input.git ?? defaultGit;
+    const auth = await runner("gh", ["auth", "status"], { cwd: input.cwd });
+    const authGlance = glanceForAuth(auth);
+    if (authGlance)
+        return { ok: false, glance: authGlance };
+    const repo = await runner("gh", ["repo", "view", "--json", "nameWithOwner,isPrivate,url"], { cwd: input.cwd });
+    if (repo.code !== 0) {
+        const text = `${repo.stderr}\n${repo.stdout}`;
+        if (isPermissionFailure(text) || /auth|not logged/i.test(text))
+            return { ok: false, glance: glanceUnauth() };
+        return { ok: false, glance: glanceRepoUnreadable(repo.stderr || repo.stdout) };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(repo.stdout);
+    }
+    catch {
+        return { ok: false, glance: glanceRepoUnreadable("gh repo view did not return JSON.") };
+    }
+    if (typeof parsed.nameWithOwner !== "string" || !parsed.nameWithOwner.includes("/")) {
+        return { ok: false, glance: glanceRepoUnreadable("gh repo view did not return nameWithOwner.") };
+    }
+    const remote = git(["remote", "get-url", "origin"], input.cwd);
+    const remoteUrl = remote.stdout.trim();
+    if (remote.code !== 0 || !remoteUrl)
+        return { ok: false, glance: glanceNoOrigin() };
+    const head = git(["rev-parse", "HEAD"], input.cwd).stdout.trim();
+    const pushed = pushOrphanPng({
+        remote: remoteUrl,
+        png: input.png,
+        anchor: /^[0-9a-f]{7,64}$/i.test(head) ? head : undefined,
+        git,
+        tmpRoot: input.tmpRoot,
+        useGhCredential: /^https:\/\/([^/]+\.)?github\.com\//i.test(remoteUrl),
+    });
+    if (!pushed.ok)
+        return pushed;
+    return {
+        ok: true,
+        sha: pushed.sha,
+        ref: pushed.ref,
+        isPrivate: parsed.isPrivate === true,
+        url: rawPngUrl(parsed.nameWithOwner, pushed.sha),
+    };
+}
+export function rawPngUrl(nameWithOwner, sha) {
+    return `https://github.com/${nameWithOwner}/raw/${sha}/${ORPHAN_FILE}`;
+}
+export function pushOrphanPng(input) {
+    if (envValue("DENY_PUSH") === "1") {
+        return { ok: false, glance: glancePushDenied() };
+    }
+    const git = input.git ?? defaultGit;
+    const tmp = fs.mkdtempSync(path.join(input.tmpRoot ?? os.tmpdir(), "prtape-orphan-"));
+    const identity = gitIdentity(git);
+    const init = git(["init", "-q"], tmp);
+    if (init.code !== 0)
+        return { ok: false, glance: glancePushOther(init.stderr || init.stdout) };
+    git(["config", "user.name", identity.name], tmp);
+    git(["config", "user.email", identity.email], tmp);
+    const pngPath = path.join(tmp, ORPHAN_FILE);
+    fs.writeFileSync(pngPath, input.png, { mode: 0o600 });
+    const pngBlob = git(["hash-object", "-w", pngPath], tmp).stdout.trim();
+    if (!/^[0-9a-f]{40}$/i.test(pngBlob)) {
+        return { ok: false, glance: glancePushOther("git hash-object did not return a blob id.") };
+    }
+    const anchor = input.anchor && /^[0-9a-f]{7,64}$/i.test(input.anchor) ? input.anchor : pngBlob;
+    let ref;
+    try {
+        ref = orphanRef(anchor);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { ok: false, glance: glancePushOther(message) };
+    }
+    const treeSpec = `100644 blob ${pngBlob}\t${ORPHAN_FILE}\n`;
+    const tree = git(["mktree"], tmp, treeSpec);
+    const treeSha = tree.stdout.trim();
+    if (tree.code !== 0 || !/^[0-9a-f]{40}$/i.test(treeSha)) {
+        return { ok: false, glance: glancePushOther(tree.stderr || tree.stdout || "git mktree failed.") };
+    }
+    const commit = git(["commit-tree", treeSha, "-m", "PRtape timeline"], tmp);
+    const commitSha = commit.stdout.trim();
+    if (commit.code !== 0 || !/^[0-9a-f]{40}$/i.test(commitSha)) {
+        return { ok: false, glance: glancePushOther(commit.stderr || commit.stdout || "git commit-tree failed.") };
+    }
+    const added = git(["remote", "add", "origin", input.remote], tmp);
+    if (added.code !== 0)
+        return { ok: false, glance: glancePushOther(added.stderr || added.stdout) };
+    const prefix = input.useGhCredential
+        ? ["-c", "credential.helper=", "-c", "credential.helper=!gh auth git-credential"]
+        : [];
+    // `+` forces only this refspec. The destination is refs/prtape/*, never a branch.
+    const push = git([...prefix, "push", "origin", `+${commitSha}:${ref}`], tmp);
+    if (push.code !== 0) {
+        const text = `${push.stderr}\n${push.stdout}`;
+        return { ok: false, glance: isPermissionFailure(text) ? glancePushDenied() : glancePushOther(text) };
+    }
+    return {
+        ok: true,
+        sha: commitSha,
+        ref,
+        url: "",
+        isPrivate: false,
+    };
+}
+function glanceForAuth(result) {
+    if (result.code === 0)
+        return null;
+    const text = `${result.stderr}\n${result.stdout}`;
+    if (result.code === 127 || /not found|ENOENT/i.test(text))
+        return glanceMissingGh();
+    return glanceUnauth();
+}
+function gitIdentity(git) {
+    const name = git(["config", "--global", "user.name"], os.tmpdir()).stdout.trim();
+    const email = git(["config", "--global", "user.email"], os.tmpdir()).stdout.trim();
+    return {
+        name: name || "PRtape",
+        email: email || "prtape@example.invalid",
+    };
+}
+//# sourceMappingURL=orphan.js.map

package/dist/orphan.js.map

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

package/dist/png.d.ts

@@ -0,0 +1,2 @@
+/** Rasterize the timeline SVG. System fonts supply Inter and JetBrains Mono when installed. */
+export declare function renderPng(svg: string): Buffer;

package/dist/png.js

@@ -0,0 +1,13 @@
+import { Resvg } from "@resvg/resvg-js";
+/** Rasterize the timeline SVG. System fonts supply Inter and JetBrains Mono when installed. */
+export function renderPng(svg) {
+    const resvg = new Resvg(svg, {
+        fitTo: { mode: "width", value: 1920 },
+        font: {
+            loadSystemFonts: true,
+            defaultFontFamily: "Inter",
+        },
+    });
+    return Buffer.from(resvg.render().asPng());
+}
+//# sourceMappingURL=png.js.map

package/dist/png.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"png.js","sourceRoot":"","sources":["../src/png.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,+FAA+F;AAC/F,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,GAAG,EAAE;QAC3B,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE;QACrC,IAAI,EAAE;YACJ,eAAe,EAAE,IAAI;YACrB,iBAAiB,EAAE,OAAO;SAC3B;KACF,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;AAC7C,CAAC"}

package/dist/privacy.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Delete macOS and Linux home prefixes and Claude scratch paths from text a
+ * reviewer might read. Spans are removed, not replaced with a token.
+ */
+export declare function hasPrivatePath(text: string): boolean;
+export declare function stripPrivatePaths(text: string): string;
+export declare function isScratchPath(filePath: string): boolean;

package/dist/privacy.js

@@ -0,0 +1,39 @@
+/**
+ * Delete macOS and Linux home prefixes and Claude scratch paths from text a
+ * reviewer might read. Spans are removed, not replaced with a token.
+ */
+const SCRATCH_TOKEN = /(?:\/private)?\/tmp\/claude-[A-Za-z0-9._-]+(?:\/[^\s"'`|;&<>]*)?|\/var\/folders\/[^\s"'`|;&<>]+/g;
+const HOME_PREFIX = /\/Users\/[^\s/"'`|;&<>]+|\/home\/[^\s/"'`|;&<>]+/g;
+/** Claude's project slug encodes `/Users/<name>/` as `-Users-<name>-`. */
+const ENCODED_HOME = /-(?:Users|home)-[A-Za-z0-9._]+-/g;
+export function hasPrivatePath(text) {
+    return (/(?:\/private)?\/tmp\/claude-[A-Za-z0-9._-]+/.test(text) ||
+        /\/var\/folders\//.test(text) ||
+        /\/Users\/[^\s/"'`|;&<>]+/.test(text) ||
+        /\/home\/[^\s/"'`|;&<>]+/.test(text) ||
+        /-(?:Users|home)-[A-Za-z0-9._]+-/.test(text));
+}
+export function stripPrivatePaths(text) {
+    return text
+        .replace(SCRATCH_TOKEN, "")
+        .replace(ENCODED_HOME, "")
+        .replace(HOME_PREFIX, "")
+        .replace(/[ \t]{2,}/g, " ")
+        .replace(/[ \t]+$/g, "")
+        .replace(/^[ \t]+/g, "");
+}
+export function isScratchPath(filePath) {
+    const value = filePath.replace(/\\/g, "/").trim();
+    if (!value || value === "/dev/null" || value === "nul")
+        return true;
+    if (/^(?:\/private)?\/tmp\//.test(value))
+        return true;
+    if (value.startsWith("/var/folders/"))
+        return true;
+    if (/(?:^|\/)scratchpad(?:\/|$)/.test(value))
+        return true;
+    if (/(?:^|\/)\.claude(?:\/|$)/.test(value))
+        return true;
+    return false;
+}
+//# sourceMappingURL=privacy.js.map

package/dist/privacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy.js","sourceRoot":"","sources":["../src/privacy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,aAAa,GACjB,kGAAkG,CAAC;AAErG,MAAM,WAAW,GAAG,mDAAmD,CAAC;AAExE,0EAA0E;AAC1E,MAAM,YAAY,GAAG,kCAAkC,CAAC;AAExD,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,CACL,6CAA6C,CAAC,IAAI,CAAC,IAAI,CAAC;QACxD,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;QAC7B,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC;QACrC,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC;QACpC,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI;SACR,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;SACzB,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC;SAC1B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACpE,IAAI,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,KAAK,CAAC,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1D,IAAI,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACxD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/redact.d.ts

@@ -0,0 +1,17 @@
+import type { SessionDraft, SessionSummary } from "./types.js";
+export interface RedactOptions {
+    /** Emails stay visible unless this is set. */
+    emails?: boolean;
+}
+/**
+ * Replacement tokens. They are stable on purpose so a second pass is a no-op
+ * and tests can assert on them.
+ */
+export declare const REDACTED_API_KEY = "[REDACTED_API_KEY]";
+export declare const REDACTED_GITHUB_TOKEN = "[REDACTED_GITHUB_TOKEN]";
+export declare const REDACTED_AWS_KEY = "[REDACTED_AWS_KEY]";
+export declare const REDACTED_IP = "[REDACTED_IP]";
+export declare const REDACTED_HOST = "[REDACTED_HOST]";
+export declare const REDACTED_EMAIL = "[REDACTED_EMAIL]";
+export declare function redact(value: string, options?: RedactOptions): string;
+export declare function redactSession(summary: SessionSummary | SessionDraft, options?: RedactOptions): SessionSummary;