pr-merge-queue 0.0.0-stage → 0.0.0

package/dist/pr-report/linked-issues.mjs

@@ -0,0 +1,39 @@
+
+import { outsideCodeFences } from 'pr-report-core';
+import { Arr, Num, Result } from 'ts-data-forge';
+
+
+
+
+
+
+
+
+const CLOSING_REFERENCE = /\b(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)\b[^\S\n]*:?[^\S\n]*(?:#(?<number>\d+)|https:\/\/github\.com\/(?<owner>[\w.-]+)\/(?<repo>[\w.-]+)\/issues\/(?<urlNumber>\d+))\b/giu;
+
+
+
+
+
+
+
+
+
+
+
+export const parseClosingIssueRefs = (body, repo) => Arr.uniq(outsideCodeFences(body)
+    .matchAll(CLOSING_REFERENCE)
+    .flatMap((match) => {
+    const { number, owner, repo: name, urlNumber } = match.groups ?? {};
+    return number !== undefined
+        ? readNumber(number)
+        : owner === repo.owner && name === repo.name
+            ? readNumber(urlNumber ?? '')
+            : [];
+})
+    .toArray());
+const readNumber = (raw) => {
+    const parsed = Num.safeParseInt(raw);
+    return Result.isOk(parsed) ? [parsed.value] : [];
+};
+//# sourceMappingURL=linked-issues.mjs.map

package/dist/pr-report/linked-issues.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked-issues.mjs","sourceRoot":"","sources":["../../src/pr-report/linked-issues.mts"],"names":[],"mappings":"AAAA,qDAAqD;AAErD,OAAO,EAAE,iBAAiB,EAAgB,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,iBAAiB,GACrB,+KAA+K,CAAC;AAElL;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,IAAY,EACZ,IAAa,EACM,EAAE,CACrB,GAAG,CAAC,IAAI,CACN,iBAAiB,CAAC,IAAI,CAAC;KACpB,QAAQ,CAAC,iBAAiB,CAAC;KAC3B,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;IACjB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;IAEpE,OAAO,MAAM,KAAK,SAAS;QACzB,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;QACpB,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI;YAC1C,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,EAAE,CAAC;YAC7B,CAAC,CAAC,EAAE,CAAC;AACX,CAAC,CAAC;KACD,OAAO,EAAE,CACb,CAAC;AAEJ,MAAM,UAAU,GAAG,CAAC,GAAW,EAAqB,EAAE;IACpD,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAErC,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACnD,CAAC,CAAC"}

package/dist/pr-report/main.d.mts

@@ -0,0 +1,42 @@
+import { Result } from 'ts-data-forge';
+import type { Options } from './options.mjs';
+/**
+ * Reports the state of every open pull request, in one page.
+ *
+ * What it answers, and why each part is here rather than a click away on
+ * GitHub:
+ *
+ * - **The merge order.** The `Merge-After:` trailers and the stacks — a pull
+ *   request onto another's branch — describe a graph that the pull request
+ *   list cannot show at all; a stack of four reads as four unrelated rows
+ *   there. Drawn as a tree, the one at the top is the one to look at.
+ * - **The issues each pull request closes**, so that "what is this for" does
+ *   not need the body opened.
+ * - **The labels**, because `skip-ci` and `merge-queued` are how this
+ *   repository says "not yet" and "ready", and neither means anything until
+ *   someone reads them.
+ * - **The verdict of the checks the ruleset requires**, which is not the same
+ *   as the checks that ran: a required context with nothing reported sits as
+ *   "Expected — waiting" forever, and a red aggregate does not name what
+ *   failed. Both are said here by name.
+ * - **How far ahead and behind the branch is.** A branch behind its base runs
+ *   nothing and merges nothing, and the pull request page states it only as
+ *   a sentence, without the size of the gap. For a stacked pull request the
+ *   base is the layer below, and behind it means the layer below has moved
+ *   and this one has not been restacked onto it.
+ * - **What landed recently.** The one section that is not about the queue,
+ *   and the first question a reader of a daily report has: did the thing I
+ *   queued yesterday go in.
+ * - **What is open that is not a pull request** — the open issues, so that
+ *   "what is there to do" does not need a second tab.
+ * - **In the JSON only, whether `unblock-prs` set each one aside, who has
+ *   claimed it** (`pr-report-core`'s `queue-comments.mts`), **and who moves
+ *   it next** (`owner`: `worker`, `skill`, `human` or `none`; `queue.mts`),
+ *   which is how a session working the queue picks what to fix.
+ *
+ * It reads and prints. Nothing here labels, rebases, merges or comments —
+ * that is `unblock-prs`, and keeping the report incapable of it is what makes
+ * it safe to run anywhere, on a schedule, with a read-only token or none.
+ */
+export declare const prReport: (options: Options) => Promise<Result<string, string>>;
+//# sourceMappingURL=main.d.mts.map

package/dist/pr-report/main.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.mts","sourceRoot":"","sources":["../../src/pr-report/main.mts"],"names":[],"mappings":"AAUA,OAAO,EAAO,MAAM,EAAE,MAAM,eAAe,CAAC;AAQ5C,OAAO,KAAK,EAAU,OAAO,EAAE,MAAM,eAAe,CAAC;AAKrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,QAAQ,YACV,OAAO,KACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA+FhC,CAAC"}

package/dist/pr-report/main.mjs

@@ -0,0 +1,163 @@
+import { buildReport, } from 'pr-report-core';
+import { Arr, Result } from 'ts-data-forge';
+import { currentEpochMs, isoSeconds, resolveRepo, tokenFromEnv, } from '../lib/index.mjs';
+import { createClient } from './github.mjs';
+import { ownersOf } from './queue.mjs';
+import { renderMarkdown, renderTerminal } from './render.mjs';
+import { readRequiredContexts } from './repo-settings.mjs';
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export const prReport = async (options) => {
+    const repo = await resolveRepo(options.repo);
+    if (Result.isErr(repo)) {
+        return repo;
+    }
+    const client = createClient(tokenFromEnv());
+    const defaultBranch = await client.defaultBranch(repo.value);
+    if (Result.isErr(defaultBranch)) {
+        return defaultBranch;
+    }
+    const required = await readRequiredContexts(client, repo.value, defaultBranch.value);
+    if (Result.isErr(required)) {
+        return required;
+    }
+    const facts = await client.facts(repo.value);
+    if (Result.isErr(facts)) {
+        return facts;
+    }
+
+
+
+
+    const merged = await client.merged(repo.value, options.mergedDays, options.mergedLimit);
+    if (Result.isErr(merged)) {
+        return merged;
+    }
+
+
+    const issues = await client.issues(repo.value, options.issuesLimit);
+    if (Result.isErr(issues)) {
+        return issues;
+    }
+
+
+
+    const issueDeclarations = await declarationsOf(client, repo.value, facts.value, issues.value);
+
+
+    const references = await client.references(repo.value, namedBeyond(facts.value, issues.value));
+
+
+    const queue = options.format === 'json'
+        ? await client.queueComments(repo.value, defaultBranch.value, facts.value)
+        : new Map();
+    const report = buildReport({
+        repo: repo.value,
+        defaultBranch: defaultBranch.value,
+        generatedAt: isoSeconds(currentEpochMs()),
+        required: required.value,
+        authenticated: client.authenticated,
+        pulls: facts.value,
+        merged: merged.value,
+        mergedWithinDays: options.mergedDays,
+        issues: issues.value,
+        issuesLimit: options.issuesLimit,
+        issueDeclarations,
+        references,
+    });
+    const owners = ownersOf(report, queue, defaultBranch.value, currentEpochMs());
+    return Result.ok(print(report, queue, owners, options.format));
+};
+
+
+
+
+
+const declarationsOf = async (client, repo, pulls, issues) => {
+    const listed = new Set(issues.map(({ number }) => number));
+    const beyond = Arr.uniq(pulls.flatMap(({ linkedIssues }) => linkedIssues
+        .filter(({ number, state }) => state !== 'closed' && !listed.has(number))
+        .map(({ number }) => number))).toSorted((a, b) => a - b);
+    const read = await client.issueBodies(repo, beyond);
+    const mut_startAfter = new Map(issues.map(({ number, startAfter }) => [number, startAfter]));
+    const mut_open = new Set(listed);
+    for (const [number, { open, startAfter }] of read) {
+        mut_startAfter.set(number, startAfter);
+        if (open) {
+            mut_open.add(number);
+        }
+    }
+    return { startAfter: mut_startAfter, open: mut_open };
+};
+
+const namedBeyond = (pulls, issues) => {
+    const known = new Set(pulls
+        .map(({ number }) => number)
+        .concat(issues.map(({ number }) => number)));
+    return Arr.uniq(issues.flatMap(({ startAfter }) => startAfter))
+        .filter((number) => !known.has(number))
+        .toSorted((a, b) => a - b);
+};
+const print = (report, queue, owners, format) => {
+    switch (format) {
+        case 'json':
+            return JSON.stringify(serializable(report, queue, owners), undefined, 2);
+        case 'markdown':
+            return renderMarkdown(report);
+        case 'terminal':
+            return renderTerminal(report);
+    }
+};
+
+
+
+
+
+
+
+const serializable = (report, queue, owners) => ({
+    ...report,
+    entries: report.entries.map((entry) => ({
+        ...entry,
+        reported: Object.fromEntries(entry.reported),
+        ...queue.get(entry.number),
+        owner: owners.get(entry.number),
+    })),
+});
+//# sourceMappingURL=main.mjs.map

package/dist/pr-report/main.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.mjs","sourceRoot":"","sources":["../../src/pr-report/main.mts"],"names":[],"mappings":"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"}

package/dist/pr-report/options.d.mts

@@ -0,0 +1,36 @@
+/** What the command line says, and how it is read. */
+import { Result } from 'ts-data-forge';
+export declare const FORMATS: readonly ['json', 'markdown', 'terminal'];
+export type Format = (typeof FORMATS)[number];
+export type Options = Readonly<{
+    format: Format;
+    /** `owner/name`; the repository this checkout is of when not given. */
+    repo: string | undefined;
+    /** How far back the "recently merged" section goes. */
+    mergedDays: number;
+    /** And how many of them it lists, whatever the window turns up. */
+    mergedLimit: number;
+    /** How many open issues it lists, most recently updated first. */
+    issuesLimit: number;
+}>;
+/**
+ * A week, so that a report read on a Monday still covers the Friday. Long
+ * enough to answer "what landed since I last looked" and short enough that
+ * the section stays a list rather than an archive.
+ */
+export declare const DEFAULT_MERGED_DAYS = 7;
+/**
+ * A cap as well as a window, and a matter of reading rather than of
+ * fitting. Twenty is more than enough to answer "did the thing I queued go in", which is what
+ * the section is for, and past that the section stops being a list and
+ * starts being an archive.
+ */
+export declare const DEFAULT_MERGED_LIMIT = 20;
+/**
+ * Enough to see what is open without the section becoming the report. The
+ * page asks for the same number.
+ */
+export declare const DEFAULT_ISSUES_LIMIT = 30;
+export declare const HELP: string;
+export declare const parseOptions: (args: readonly string[]) => Result<Options | 'help', string>;
+//# sourceMappingURL=options.d.mts.map

package/dist/pr-report/options.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.mts","sourceRoot":"","sources":["../../src/pr-report/options.mts"],"names":[],"mappings":"AAAA,sDAAsD;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvC,eAAO,MAAM,OAAO,YAAI,MAAM,EAAE,UAAU,EAAE,UAAU,CAAU,CAAC;AAEjE,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9C,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,eAAO,MAAM,IAAI,QAmBL,CAAC;AAEb,eAAO,MAAM,YAAY,SACjB,SAAS,MAAM,EAAE,KACtB,MAAM,CAAC,OAAO,GAAG,MAAM,EAAE,MAAM,CAgEjC,CAAC"}

package/dist/pr-report/options.mjs

@@ -0,0 +1,90 @@
+
+import { Result } from 'ts-data-forge';
+import { parseCommandArgs, positiveInteger } from '../lib/index.mjs';
+export const FORMATS = ['json', 'markdown', 'terminal'];
+
+
+
+
+
+export const DEFAULT_MERGED_DAYS = 7;
+
+
+
+
+
+
+export const DEFAULT_MERGED_LIMIT = 20;
+
+
+
+
+export const DEFAULT_ISSUES_LIMIT = 30;
+export const HELP = [
+    'Usage: pr-report [options]',
+    '',
+    'Reports every open pull request: the order they declare with',
+    '`Merge-After:`, the issues they close, their labels, the verdict of the',
+    'checks the ruleset requires, and how far each branch is from its base.',
+    '',
+    'Options:',
+    `  --format <${FORMATS.join('|')}>  how to print it (default terminal)`,
+    '                                   `json` is the whole report, bodies and all',
+    '  --repo <owner/name>              which repository (default: this one)',
+    `  --merged-days <n>                how far back "recently merged" goes (default ${DEFAULT_MERGED_DAYS})`,
+    `  --merged-limit <n>               how many it lists at most (default ${DEFAULT_MERGED_LIMIT})`,
+    `  --issues-limit <n>               how many open issues it lists (default ${DEFAULT_ISSUES_LIMIT})`,
+    '  -h, --help                       show this help',
+    '',
+    'Reads GH_TOKEN or GITHUB_TOKEN when one is set. Without it the public API',
+    'allows 60 requests an hour, which is about twenty pull requests, and the',
+    'issue links are the ones the bodies declare rather than GitHub’s own list.',
+].join('\n');
+export const parseOptions = (args) => {
+    const parsed = parseCommandArgs(args, {
+        format: { type: 'string' },
+        repo: { type: 'string' },
+        'merged-days': { type: 'string' },
+        'merged-limit': { type: 'string' },
+        'issues-limit': { type: 'string' },
+    });
+    if (Result.isErr(parsed)) {
+        return parsed;
+    }
+    if (parsed.value === 'help') {
+        return Result.ok('help');
+    }
+    const values = parsed.value;
+    const format = values.format ?? 'terminal';
+    if (!isFormat(format)) {
+        return Result.err(`--format must be one of ${FORMATS.join(', ')}, got ${JSON.stringify(format)}`);
+    }
+    const mergedDays = positiveInteger('merged-days', values['merged-days'], DEFAULT_MERGED_DAYS);
+    if (Result.isErr(mergedDays)) {
+        return mergedDays;
+    }
+    const mergedLimit = positiveInteger('merged-limit', values['merged-limit'], DEFAULT_MERGED_LIMIT);
+    if (Result.isErr(mergedLimit)) {
+        return mergedLimit;
+    }
+    const issuesLimit = positiveInteger('issues-limit', values['issues-limit'], DEFAULT_ISSUES_LIMIT);
+    if (Result.isErr(issuesLimit)) {
+        return issuesLimit;
+    }
+    return Result.ok({
+        format,
+        repo: values.repo,
+        mergedDays: mergedDays.value,
+        mergedLimit: mergedLimit.value,
+        issuesLimit: issuesLimit.value,
+    });
+};
+
+
+
+
+
+
+const FORMAT_SET = new Set(FORMATS);
+const isFormat = (value) => FORMAT_SET.has(value);
+//# sourceMappingURL=options.mjs.map

package/dist/pr-report/options.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.mjs","sourceRoot":"","sources":["../../src/pr-report/options.mts"],"names":[],"mappings":"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"}

package/dist/pr-report/queue.d.mts

@@ -0,0 +1,28 @@
+import { type DecidedEntries, type QueueComments, type QueueOwner, type RepoRef } from 'pr-report-core';
+import { Result } from 'ts-data-forge';
+/**
+ * Who moves each open pull request in the queue next (`pr-report-core`'s
+ * `queue-owner.mts`), from what `pr-report` reads.
+ *
+ * Every command a session runs on the queue decides through here — the
+ * `owner` in `pr-report --format json`, `claim-pr`, `push-fixed-pr`,
+ * `rebuild-pnpm-update` and `report-unowned-prs` — so none of them can come
+ * to a different answer from the others, and the worker asks the same
+ * function with the same facts read through `gh`.
+ */
+export declare const ownersOf: (decided: DecidedEntries, queue: ReadonlyMap<number, QueueComments>, defaultBranch: string, nowEpochMs: number) => ReadonlyMap<number, QueueOwner>;
+export type QueueState = Readonly<{
+    repo: RepoRef;
+    defaultBranch: string;
+    decided: DecidedEntries;
+    queue: ReadonlyMap<number, QueueComments>;
+    owners: ReadonlyMap<number, QueueOwner>;
+}>;
+/**
+ * Reads the open pull requests, this account's comments on them and the
+ * owner of each, for a command that acts on the queue. It needs a token
+ * whose account is the one `unblock-prs` writes as: without one no comment
+ * is trusted, and there is no owner to read.
+ */
+export declare const readQueueState: (repoOption?: string) => Promise<Result<QueueState, string>>;
+//# sourceMappingURL=queue.d.mts.map

package/dist/pr-report/queue.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.mts","sourceRoot":"","sources":["../../src/pr-report/queue.mts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,OAAO,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAO,MAAM,EAAE,MAAM,eAAe,CAAC;AAK5C;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,YACV,cAAc,SAChB,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,iBAC1B,MAAM,cACT,MAAM,KACjB,WAAW,CAAC,MAAM,EAAE,UAAU,CAsB9B,CAAC;AAEJ,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1C,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACzC,CAAC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,cAAc,gBACZ,MAAM,KAClB,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAwDpC,CAAC"}

package/dist/pr-report/queue.mjs

@@ -0,0 +1,74 @@
+import { buildEntries, queueOwnerOfEntry, } from 'pr-report-core';
+import { Arr, Result } from 'ts-data-forge';
+import { currentEpochMs, resolveRepo, tokenFromEnv } from '../lib/index.mjs';
+import { createClient } from './github.mjs';
+import { readRequiredContexts } from './repo-settings.mjs';
+
+
+
+
+
+
+
+
+
+
+export const ownersOf = (decided, queue, defaultBranch, nowEpochMs) => new Map(Arr.generate(function* () {
+    for (const entry of decided.entries) {
+
+
+        const comments = queue.get(entry.number);
+        const owner = comments === undefined
+            ? undefined
+            : queueOwnerOfEntry(entry, comments, {
+                defaultBranch,
+                cycles: decided.cycles,
+                nowEpochMs,
+            });
+        if (owner !== undefined) {
+            yield [entry.number, owner];
+        }
+    }
+}));
+
+
+
+
+
+
+export const readQueueState = async (repoOption) => {
+    const repo = await resolveRepo(repoOption);
+    if (Result.isErr(repo)) {
+        return repo;
+    }
+    const client = createClient(tokenFromEnv());
+    if (!client.authenticated) {
+        return Result.err('no GH_TOKEN or GITHUB_TOKEN: the queue comments, and so the owners, cannot be read');
+    }
+    const defaultBranch = await client.defaultBranch(repo.value);
+    if (Result.isErr(defaultBranch)) {
+        return defaultBranch;
+    }
+    const required = await readRequiredContexts(client, repo.value, defaultBranch.value);
+    if (Result.isErr(required)) {
+        return required;
+    }
+    const facts = await client.facts(repo.value);
+    if (Result.isErr(facts)) {
+        return facts;
+    }
+    const queue = await client.queueComments(repo.value, defaultBranch.value, facts.value);
+    const decided = buildEntries({
+        required: required.value,
+        defaultBranch: defaultBranch.value,
+        pulls: facts.value,
+    });
+    return Result.ok({
+        repo: repo.value,
+        defaultBranch: defaultBranch.value,
+        decided,
+        queue,
+        owners: ownersOf(decided, queue, defaultBranch.value, currentEpochMs()),
+    });
+};
+//# sourceMappingURL=queue.mjs.map

package/dist/pr-report/queue.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.mjs","sourceRoot":"","sources":["../../src/pr-report/queue.mts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,iBAAiB,GAKlB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,OAAuB,EACvB,KAAyC,EACzC,aAAqB,EACrB,UAAkB,EACe,EAAE,CACnC,IAAI,GAAG,CACL,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACpB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,sEAAsE;QACtE,4DAA4D;QAC5D,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEzC,MAAM,KAAK,GACT,QAAQ,KAAK,SAAS;YACpB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE;gBACjC,aAAa;gBACb,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,UAAU;aACX,CAAC,CAAC;QAET,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAU,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC,CAAC,CACH,CAAC;AAUJ;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,UAAmB,EACkB,EAAE;IACvC,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;IAE3C,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,EAAE,CAAC,CAAC;IAE5C,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,GAAG,CACf,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE7D,IAAI,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;QAChC,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CACzC,MAAM,EACN,IAAI,CAAC,KAAK,EACV,aAAa,CAAC,KAAK,CACpB,CAAC;IAEF,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE7C,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,aAAa,CACtC,IAAI,CAAC,KAAK,EACV,aAAa,CAAC,KAAK,EACnB,KAAK,CAAC,KAAK,CACZ,CAAC;IAEF,MAAM,OAAO,GAAG,YAAY,CAAC;QAC3B,QAAQ,EAAE,QAAQ,CAAC,KAAK;QACxB,aAAa,EAAE,aAAa,CAAC,KAAK;QAClC,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,EAAE,CAAC;QACf,IAAI,EAAE,IAAI,CAAC,KAAK;QAChB,aAAa,EAAE,aAAa,CAAC,KAAK;QAClC,OAAO;QACP,KAAK;QACL,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC;KACxE,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/pr-report/render.d.mts

@@ -0,0 +1,14 @@
+/** The report as text: Markdown for GitHub and Claude, plain for a terminal. */
+import { type PrReport } from 'pr-report-core';
+/**
+ * The report as Markdown, for pasting into GitHub or a conversation with
+ * Claude.
+ *
+ * The merge order is a nested list rather than a table because the nesting
+ * *is* the information — a table would have to spell the tree back out in a
+ * column, and a reader would have to rebuild it.
+ */
+export declare const renderMarkdown: (report: PrReport) => string;
+/** The same report drawn with box characters, for a terminal. */
+export declare const renderTerminal: (report: PrReport) => string;
+//# sourceMappingURL=render.d.mts.map

package/dist/pr-report/render.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.mts","sourceRoot":"","sources":["../../src/pr-report/render.mts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,EAIL,KAAK,QAAQ,EAKd,MAAM,gBAAgB,CAAC;AAiBxB;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,WAAY,QAAQ,KAAG,MA8CjD,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,cAAc,WAAY,QAAQ,KAAG,MAwDjD,CAAC"}