prtape-cli 0.0.0-stage → 0.1.0

package/dist/display.js

@@ -0,0 +1,311 @@
+import { decisionFromEvents } from "./decision.js";
+import { redact } from "./redact.js";
+import { hasPrivatePath, stripPrivatePaths } from "./privacy.js";
+import { rollupTests, withSteps } from "./summary.js";
+import { displayTestCommand } from "./tests-detect.js";
+import { oneLine } from "./text.js";
+const MARKER = /\[REDACTED_[A-Z0-9_]+\]/;
+/** Locked KEY DECISION copy. The short form drops the second clause. */
+export const LOCKED_DECISION = "Ship the redacted timeline; secrets stay off the PR.";
+/**
+ * Reviewer-facing copy. Sentences and shell assignments that contain a secret
+ * are deleted. Nothing is replaced with a `[REDACTED_*]` token.
+ */
+export function presentSummary(input, options = {}) {
+    const probed = [input.title, input.decision, ...input.files.map((file) => file.path), ...input.tests.map((test) => test.command)].join("\n");
+    const maskedCount = redact(probed, options).match(/\[REDACTED_[A-Z0-9_]+\]/g)?.length ?? 0;
+    const secretsStripped = maskedCount > 0;
+    const decision = scrubDecision(input.decision, input, options);
+    const title = scrubTitle(input.title, options);
+    const events = input.events.map((event) => scrubEvent(event, options)).filter((event) => event !== undefined);
+    return {
+        secretsStripped,
+        maskedCount,
+        summary: withSteps({
+            ...input,
+            title: title || "Coding-agent session",
+            decision,
+            cwd: publicCwd(input.cwd),
+            branch: input.branch ? stripPrivatePaths(input.branch) || undefined : undefined,
+            events,
+        }),
+    };
+}
+const FENCE_LANG = /^(?:text|bash|sh|shell|md|markdown|json|javascript|js|ts|typescript|python|py|diff|plaintext)\s+/i;
+export function scrubTitle(text, options = {}) {
+    // Emails never lead the title. A sentence that is only an address is dropped.
+    const clean = scrubProse(stripFenceLang(stripPastedWrappers(text)), { ...options, emails: true });
+    const sentences = splitSentences(clean)
+        .map((sentence) => stripFenceLang(sentence))
+        .filter((sentence) => sentence && !isOnlyEmail(sentence));
+    const task = sentences.find((sentence) => isTaskSentence(sentence)) ??
+        sentences.find((sentence) => !isMetaInstruction(sentence) && !isConstraintSentence(sentence)) ??
+        sentences[0] ??
+        "";
+    return task;
+}
+const TASK_VERBS = /^(?:fix|make|add|find|implement|update|run|change|correct|strip|remove|keep|請|修正|修|新增|實作|更新|執行|找出|改)/i;
+function stripFenceLang(text) {
+    return text.replace(FENCE_LANG, "").trim();
+}
+function isConstraintSentence(sentence) {
+    if (isTaskSentence(sentence))
+        return false;
+    return /不要|別[刪跳]|don't\b|do not\b|must not\b|\bnever\b/i.test(sentence);
+}
+function isTaskSentence(sentence) {
+    return TASK_VERBS.test(sentence.trim());
+}
+/** Language, format, and disclaimer lines Claude Code puts ahead of the task. */
+function isMetaInstruction(sentence) {
+    const text = sentence.trim().replace(/[.!?。]+$/g, "");
+    return (/^(?:respond|answer|reply)\b(?:\s+\w+){0,6}\s+in\b/i.test(text) ||
+        /^be concise\b/i.test(text) ||
+        /^keep (?:it|this|your (?:answer|response)) (?:brief|short|concise)\b/i.test(text) ||
+        /^this is an intentional\b/i.test(text) ||
+        /\bnot a real\b.+\b(?:incident|customer|bug|session)\b/i.test(text) ||
+        /^(?:note|context)\s*:/i.test(text));
+}
+/** Drop Claude Code wrappers such as `<pasted_content id="...">...</pasted_content>`. */
+export function stripPastedWrappers(text) {
+    let current = text;
+    for (let pass = 0; pass < 4; pass += 1) {
+        const next = current.replace(/<([A-Za-z][\w:-]*)\b[^>]*>[\s\S]*?<\/\1>/g, (full) => full.replace(/^<[^>]*>/, "").replace(/<\/[^>]*>$/, ""));
+        if (next === current)
+            break;
+        current = next;
+    }
+    return current
+        .replace(/<\/?[A-Za-z][\w:-]*\b[^>]*>/g, " ")
+        .replace(/[ \t]{2,}/g, " ")
+        .trim();
+}
+export function scrubProse(text, options = {}) {
+    const withoutFences = text.replace(/```[\s\S]*?```/g, "\n").replace(/~~~[\s\S]*?~~~/g, "\n");
+    const kept = splitSentences(withoutFences)
+        .filter((sentence) => !isPathReferenceSentence(sentence))
+        .map((sentence) => cleanDisplayMarkdown(stripPrivatePaths(sentence)).trim())
+        .filter((sentence) => sentence && !isPathReferenceSentence(sentence) && !sentenceHasSecret(sentence, options));
+    return oneLine(kept.join(" "));
+}
+function splitSentences(text) {
+    const sentences = [];
+    for (const line of text.split(/\n+/)) {
+        let current = "";
+        const chars = [...line];
+        for (let index = 0; index < chars.length; index += 1) {
+            const ch = chars[index] ?? "";
+            current += ch;
+            const next = chars[index + 1];
+            const cjkEnd = ch === "。" || ch === "！" || ch === "？";
+            const enEnd = (ch === "." || ch === "!" || ch === "?") && (next === undefined || /\s/.test(next));
+            if (!cjkEnd && !enEnd)
+                continue;
+            const trimmed = current.trim();
+            if (trimmed)
+                sentences.push(trimmed);
+            current = "";
+            if (next && /\s/.test(next))
+                index += 1;
+        }
+        const rest = current.trim();
+        if (rest)
+            sentences.push(rest);
+    }
+    return sentences;
+}
+/**
+ * A sentence whose job is to point at a private path. Drop the whole sentence
+ * so deletion does not leave "完整輸出存在 。" or "The full output is saved at ."
+ */
+export function isPathReferenceSentence(sentence) {
+    const hadPath = hasPrivatePath(sentence) || /`{2,}|`\s*`/.test(sentence);
+    const core = locatorCore(sentence);
+    if (!core)
+        return hadPath;
+    if (!isLocatorCore(core))
+        return false;
+    return hadPath || isLocatorCore(core);
+}
+function locatorCore(sentence) {
+    return cleanDisplayMarkdown(stripPrivatePaths(sentence))
+        .replace(/`+/g, "")
+        .replace(/[。！？.!?]+/g, "")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+const LOCATOR_WORDS = new Set([
+    "the",
+    "a",
+    "an",
+    "full",
+    "output",
+    "outputs",
+    "log",
+    "logs",
+    "file",
+    "files",
+    "checkout",
+    "note",
+    "notes",
+    "is",
+    "are",
+    "was",
+    "were",
+    "saved",
+    "written",
+    "stored",
+    "located",
+    "kept",
+    "live",
+    "lives",
+    "at",
+    "in",
+    "under",
+    "to",
+    "on",
+    "and",
+    "of",
+]);
+function isLocatorCore(core) {
+    if (/^(?:完整|修正前的|修正後的)?輸出存在$/.test(core))
+        return true;
+    if (/^(?:日誌|日志|記錄|檔案)(?:在|位於|存在)$/.test(core))
+        return true;
+    const words = core
+        .replace(/\/[^\s]+/g, " ")
+        .split(/\s+/)
+        .map((word) => word.trim())
+        .filter(Boolean);
+    if (words.length === 0 || words.length > 12)
+        return false;
+    if (words.some((word) => /[\u3400-\u9fff]/.test(word)))
+        return false;
+    return words.every((word) => LOCATOR_WORDS.has(word.toLowerCase().replace(/^[("']+|[)"',]+$/g, "")));
+}
+/** Drop markdown markers and empty code spans left behind when a path was deleted. */
+export function cleanDisplayMarkdown(text) {
+    return text
+        .replace(/```[\s\S]*?```/g, " ")
+        .replace(/~~~[\s\S]*?~~~/g, " ")
+        .replace(/`{1,3}\s*`{1,3}/g, "")
+        .replace(/\*\*([^*]+)\*\*/g, "$1")
+        .replace(/__([^_]+)__/g, "$1")
+        .replace(/(^|[^\w*])\*([^*\n]+)\*(?!\*)/g, "$1$2")
+        .replace(/`([^`]+)`/g, "$1")
+        .replace(/`+/g, "")
+        .replace(/^\s{0,3}#{1,6}\s+/gm, "")
+        .replace(/[ \t]{2,}/g, " ")
+        .trim();
+}
+export function scrubCommand(command, options = {}) {
+    const displayed = displayTestCommand(command);
+    const source = displayed || command;
+    const pieces = source.split(/\s*(?:&&|\|\||;)\s*/);
+    const kept = pieces.map((piece) => scrubCommandPiece(piece, options)).filter((piece) => piece.length > 0);
+    return oneLine(stripPrivatePaths(kept.join(" && ")));
+}
+function scrubDecision(text, summary, options) {
+    const prose = scrubProse(text, options);
+    const explicit = explicitSentence(prose);
+    if (explicit && explicit.replace(/[。．.]$/u, "") === "Ship the redacted timeline")
+        return LOCKED_DECISION;
+    if (explicit && !isStatusBoilerplate(explicit))
+        return finishSentence(explicit);
+    const derived = decisionFromEvents(summary);
+    if (derived)
+        return derived;
+    return fallbackDecision(summary);
+}
+/** One short statement. A multi-sentence status report is not a decision. */
+function explicitSentence(prose) {
+    const sentences = splitSentences(prose).filter((sentence) => sentence.length >= 12 && sentence.length <= 180);
+    if (sentences.length !== 1)
+        return undefined;
+    return sentences[0];
+}
+function isStatusBoilerplate(sentence) {
+    return (/^(?:修好了|完成了|done\b)/i.test(sentence) ||
+        /全部通過|測試通過/.test(sentence) ||
+        /\b(?:tests?|suite) (?:passed|passes|pass)\b/i.test(sentence) ||
+        /^fixed the .+ so the (?:suite|tests)/i.test(sentence) ||
+        /^the tests passed\b/i.test(sentence) ||
+        /^原因與修正[:：]?$/.test(sentence) ||
+        /^修正前的失敗結果/.test(sentence));
+}
+function finishSentence(sentence) {
+    const trimmed = sentence.trim();
+    if (/[。！？.!?]$/.test(trimmed))
+        return trimmed;
+    return `${trimmed}.`;
+}
+function fallbackDecision(summary) {
+    const count = summary.files.length;
+    const files = count === 0 ? "" : `Edited ${count} file${count === 1 ? "" : "s"}`;
+    const outcome = rollupTests(summary.tests);
+    if (files && outcome === "pass")
+        return `${files} and the tests passed.`;
+    if (files && outcome === "fail")
+        return `${files}, and the tests failed.`;
+    if (files)
+        return `${files}.`;
+    if (outcome === "pass")
+        return "The tests passed.";
+    if (outcome === "fail")
+        return "The tests failed.";
+    return "The session is ready for review.";
+}
+function scrubCommandPiece(piece, options) {
+    let rest = piece.trim();
+    const kept = [];
+    const env = /^([A-Za-z_][A-Za-z0-9_]*)=(?:"([^"]*)"|'([^']*)'|(\S+))\s*/;
+    let match = env.exec(rest);
+    while (match) {
+        const key = match[1] ?? "";
+        const value = match[2] ?? match[3] ?? match[4] ?? "";
+        if (!sentenceHasSecret(`${key}=${value}`, options))
+            kept.push(`${key}=${value}`);
+        rest = rest.slice(match[0].length);
+        match = env.exec(rest);
+    }
+    const words = rest.split(/\s+/).filter((word) => word && !sentenceHasSecret(word, options));
+    return [...kept, ...words].join(" ").trim();
+}
+function scrubPiece(text, options) {
+    const stripped = stripPrivatePaths(text).replace(/^\/+/, "");
+    if (!stripped || sentenceHasSecret(stripped, options))
+        return "";
+    return oneLine(stripped);
+}
+function scrubEvent(event, options) {
+    if (event.kind === "read") {
+        const path = event.path ? scrubPiece(event.path, options) : "";
+        return { kind: "read", path: path || undefined };
+    }
+    if (event.kind === "edit") {
+        const path = scrubPiece(event.path, options);
+        if (!path)
+            return undefined;
+        return { kind: "edit", path, action: event.action };
+    }
+    if (event.kind === "test") {
+        const command = scrubCommand(event.command, options);
+        if (!command)
+            return undefined;
+        return { ...event, command };
+    }
+    return event;
+}
+function publicCwd(cwd) {
+    if (!cwd)
+        return undefined;
+    const stripped = stripPrivatePaths(cwd).trim();
+    return stripped || undefined;
+}
+function sentenceHasSecret(text, options) {
+    return MARKER.test(redact(text, options));
+}
+function isOnlyEmail(text) {
+    return /^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\.?$/.test(text.trim());
+}
+//# sourceMappingURL=display.js.map

package/dist/display.js.map

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

package/dist/env.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Current names are PRTAPE_*. AGENTTAPE_* still works.
+ * When the new name is set, even to an empty string, it wins.
+ */
+export declare function envValue(suffix: string, env?: NodeJS.ProcessEnv): string | undefined;

package/dist/env.js

@@ -0,0 +1,11 @@
+/**
+ * Current names are PRTAPE_*. AGENTTAPE_* still works.
+ * When the new name is set, even to an empty string, it wins.
+ */
+export function envValue(suffix, env = process.env) {
+    const current = `PRTAPE_${suffix}`;
+    if (env[current] !== undefined)
+        return env[current];
+    return env[`AGENTTAPE_${suffix}`];
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,MAAyB,OAAO,CAAC,GAAG;IAC3E,MAAM,OAAO,GAAG,UAAU,MAAM,EAAE,CAAC;IACnC,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC;IACpD,OAAO,GAAG,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/gh.d.ts

@@ -0,0 +1,46 @@
+export interface CommandResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+export interface CommandRunner {
+    (command: string, args: string[], options: {
+        cwd: string;
+        input?: string;
+    }): Promise<CommandResult>;
+}
+export interface PrRef {
+    number: number;
+    url: string;
+    commentId: number;
+    /** True when an existing PRtape or AgentTape comment was edited instead of created. */
+    updated: boolean;
+}
+export declare class GhError extends Error {
+    constructor(message: string);
+}
+/**
+ * The only network path in PRtape. `gh` talks to GitHub when the user
+ * runs `prtape pr` without `--dry-run`. There is no telemetry.
+ */
+export declare function defaultRunner(command: string, args: string[], options: {
+    cwd: string;
+    input?: string;
+}): Promise<CommandResult>;
+export declare function explainGhFailure(result: CommandResult): string;
+/**
+ * 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 declare function isPrtapeComment(body: string): boolean;
+/** @deprecated Use isPrtapeComment. Kept so older imports still find both markers. */
+export declare function isAgentTapeComment(body: string): boolean;
+/**
+ * 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 declare function pullRequestHead(cwd: string, runner?: CommandRunner, prNumber?: number): Promise<string | undefined>;
+export declare function postComment(cwd: string, body: string, runner?: CommandRunner, prNumber?: number): Promise<PrRef>;

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;