@coldtea/pr-lens-cli 0.1.0

package/dist/commands/export.js

@@ -0,0 +1,44 @@
+import { expectOne, parseOptions, readString } from "../args.js";
+import { invalidDocument, readGraphDoc } from "../document.js";
+import { PrLensCliError, usageError } from "../errors.js";
+import { writeJsonFile } from "../io.js";
+import { toStoredMap } from "../snapshot.js";
+const DEFAULT_OUT = ".github/pr-lens.map.json";
+export const USAGE = `pr-lens export <graph.json> [options]
+
+Turns a pull-request document into the stored map of the system once that pull
+request has merged: elements the change deletes are dropped, the rest stops
+being annotated, and the result is stamped with the single commit it reflects.
+
+The map is a snapshot, not a source of truth — nothing reads it back into the
+pipeline. Committing it gives a repository something to read, to diff, and to
+hand an agent.
+
+  -o, --out <file>   where to write it (default ${DEFAULT_OUT})
+      --id <id>      map id, so a patch can name it (default <owner>/<name>)
+      --sha <sha>    the commit it reflects, in full (default the document's head)`;
+export const exportCommand = async (args, terminal) => {
+    const { values, positionals } = parseOptions(args, {
+        out: { type: "string", short: "o" },
+        id: { type: "string" },
+        sha: { type: "string" },
+    });
+    const source = expectOne(positionals, "one graph document to export");
+    if (/^https?:\/\//.test(source))
+        throw usageError("export reads a local graph document", "fetching a map from a hosted pipeline is not something the CLI does yet");
+    const graph = await readGraphDoc(source);
+    const out = readString(values.out, "out") ?? DEFAULT_OUT;
+    const stored = toStoredMap(graph, {
+        id: readString(values.id, "id") ?? `${graph.provenance.repo.owner}/${graph.provenance.repo.name}`,
+        sha: readString(values.sha, "sha") ?? graph.provenance.head.sha,
+        generatedAt: new Date().toISOString(),
+    });
+    if (!stored.ok) {
+        if (stored.error.code === "NOT_A_SNAPSHOT" || stored.error.code === "PATCH_CONFLICT")
+            throw new PrLensCliError("INVALID_DOCUMENT", `${source} cannot be exported as a stored map [${stored.error.code}]`, stored.error.message);
+        throw invalidDocument(source, "graph", stored.error);
+    }
+    const written = await writeJsonFile(out, stored.value);
+    terminal.out(`✓ ${written} — stored map of ${stored.value.provenance.repo.owner}/${stored.value.provenance.repo.name} at ${stored.value.provenance.head.sha.slice(0, 7)} · ${stored.value.nodes.length} nodes, ${stored.value.edges.length} edges`);
+};
+//# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,MAAM,WAAW,GAAG,0BAA0B,CAAC;AAE/C,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;kDAU6B,WAAW;;mFAEsB,CAAC;AAEpF,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,IAAuB,EAAE,QAAkB,EAAiB,EAAE;IAChG,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE;QACjD,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;QACnC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACtB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACxB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,EAAE,8BAA8B,CAAC,CAAC;IACtE,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;QAC7B,MAAM,UAAU,CACd,qCAAqC,EACrC,yEAAyE,CAC1E,CAAC;IAEJ,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,WAAW,CAAC;IAEzD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE;QAChC,EAAE,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE;QACjG,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG;QAC/D,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,gBAAgB;YAClF,MAAM,IAAI,cAAc,CACtB,kBAAkB,EAClB,GAAG,MAAM,wCAAwC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,EACrE,MAAM,CAAC,KAAK,CAAC,OAAO,CACrB,CAAC;QACJ,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACvD,QAAQ,CAAC,GAAG,CACV,KAAK,OAAO,oBAAoB,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,WAAW,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,QAAQ,CACtO,CAAC;AACJ,CAAC,CAAC"}

package/dist/commands/render.d.ts

@@ -0,0 +1,4 @@
+import type { Terminal } from "../terminal.js";
+export declare const USAGE = "pr-lens render <graph.json> [options]\n\nDraws the document as self-contained SVGs \u2014 one per drill-down section per\nlens, in light and dark \u2014 and writes the manifest describing them. A document\nwith no sections gets one diagram per lens it declares.\n\n  -o, --out <dir>      where the SVGs and the manifest go (default pr-lens/)\n      --theme <theme>  light | dark | both (default both)\n      --config <file>  corrections to draw with (default the repository's, if any)\n      --no-config      ignore the repository's corrections";
+export declare const renderCommand: (args: readonly string[], terminal: Terminal) => Promise<void>;
+//# sourceMappingURL=render.d.ts.map

package/dist/commands/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/commands/render.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAgB/C,eAAO,MAAM,KAAK,qiBASyC,CAAC;AA6B5D,eAAO,MAAM,aAAa,SAAgB,SAAS,MAAM,EAAE,YAAY,QAAQ,KAAG,OAAO,CAAC,IAAI,CA4D7F,CAAC"}

package/dist/commands/render.js

@@ -0,0 +1,108 @@
+import { applyCorrections, PrLensRenderError, renderAll, THEMES } from "@coldtea/pr-lens-renderer";
+import { safeParseGraphDoc } from "@coldtea/pr-lens-schema";
+import { join } from "node:path";
+import { expectOne, parseOptions, readBoolean, readString } from "../args.js";
+import { discoverConfig, loadConfig } from "../config-file.js";
+import { unmatchedCorrections } from "../corrections.js";
+import { readGraphDoc } from "../document.js";
+import { PrLensCliError, usageError } from "../errors.js";
+import { repositoryRoot } from "../git.js";
+import { writeJsonFile, writeTextFile } from "../io.js";
+const DEFAULT_OUT = "pr-lens";
+const MANIFEST = "manifest.json";
+/**
+ * The document as it was drawn, written beside the manifest.
+ *
+ * Corrections are applied here, so the document on the way in and the
+ * diagrams on the way out can describe different systems — a view whose every
+ * element was excluded is drawn by neither. Whatever composes the comment has
+ * to read the one the pictures came from, and it is a different file from the
+ * one analyze wrote so that neither overwrites the other.
+ */
+const DRAWN = "drawn.graph.json";
+export const USAGE = `pr-lens render <graph.json> [options]
+
+Draws the document as self-contained SVGs — one per drill-down section per
+lens, in light and dark — and writes the manifest describing them. A document
+with no sections gets one diagram per lens it declares.
+
+  -o, --out <dir>      where the SVGs and the manifest go (default ${DEFAULT_OUT}/)
+      --theme <theme>  light | dark | both (default both)
+      --config <file>  corrections to draw with (default the repository's, if any)
+      --no-config      ignore the repository's corrections`;
+const readThemes = (value) => {
+    const theme = readString(value, "theme") ?? "both";
+    switch (theme) {
+        case "light":
+        case "dark":
+            return [theme];
+        case "both":
+            return THEMES;
+        default:
+            throw usageError(`--theme takes light, dark or both, got ${JSON.stringify(theme)}`);
+    }
+};
+/**
+ * The overlay is applied here rather than by passing the config into
+ * `renderAll`, which would apply the same function to the same document — but
+ * out of reach, and the comment has to be composed from what was drawn.
+ */
+const correct = (graph, config) => {
+    try {
+        return applyCorrections(graph, config.map);
+    }
+    catch (error) {
+        if (!(error instanceof PrLensRenderError))
+            throw error;
+        throw new PrLensCliError("RENDER_FAILED", `${error.message} [${error.code}]`);
+    }
+};
+export const renderCommand = async (args, terminal) => {
+    const { values, positionals } = parseOptions(args, {
+        out: { type: "string", short: "o" },
+        theme: { type: "string" },
+        config: { type: "string" },
+        "no-config": { type: "boolean" },
+    });
+    const graph = await readGraphDoc(expectOne(positionals, "one graph document to render"));
+    const out = readString(values.out, "out") ?? DEFAULT_OUT;
+    const configPath = readString(values.config, "config");
+    const configured = readBoolean(values["no-config"])
+        ? undefined
+        : configPath === undefined
+            ? await discoverConfig(await repositoryRoot(process.cwd()).catch(() => process.cwd()))
+            : await loadConfig(configPath);
+    const themes = readThemes(values.theme);
+    const drawn = (() => {
+        if (configured === undefined)
+            return graph;
+        for (const warning of unmatchedCorrections(graph, configured.config))
+            terminal.err(`${configured.path}: ${warning}`);
+        const corrected = correct(graph, configured.config);
+        const parsed = safeParseGraphDoc(corrected);
+        if (!parsed.ok)
+            throw new PrLensCliError(`INVALID_DOCUMENT`, `${configured.path} leaves a document that no longer validates [${parsed.error.code}]`, parsed.error.message);
+        return parsed.value;
+    })();
+    const rendered = (() => {
+        try {
+            return renderAll(drawn, { themes });
+        }
+        catch (error) {
+            if (!(error instanceof PrLensRenderError))
+                throw error;
+            throw new PrLensCliError("RENDER_FAILED", `${error.message} [${error.code}]`);
+        }
+    })();
+    for (const drawing of rendered.assets) {
+        const { id, path } = drawing.asset;
+        if (path === undefined)
+            throw new PrLensCliError("RENDER_FAILED", `the render named no file for asset '${id}'`);
+        await writeTextFile(join(out, path), drawing.svg);
+    }
+    await writeJsonFile(join(out, DRAWN), drawn);
+    await writeJsonFile(join(out, MANIFEST), rendered.manifest);
+    const diagrams = new Set(rendered.assets.map((asset) => asset.asset.view ?? asset.lens));
+    terminal.out(`✓ ${join(out, MANIFEST)} — ${rendered.assets.length} SVGs across ${diagrams.size} ${diagrams.size === 1 ? "diagram" : "diagrams"}${configured === undefined ? "" : `, corrected by ${configured.path}`}`);
+};
+//# sourceMappingURL=render.js.map

package/dist/commands/render.js.map

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

package/dist/commands/validate.d.ts

@@ -0,0 +1,4 @@
+import type { Terminal } from "../terminal.js";
+export declare const USAGE = "pr-lens validate <file...>\n\nParses graph documents, patch documents, render manifests and configs \u2014 JSON or\nYAML \u2014 and reports every problem in each, rather than only the first. A file\nwithout a 'kind' field is read as a config.";
+export declare const validateCommand: (args: readonly string[], terminal: Terminal) => Promise<void>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AA0B/C,eAAO,MAAM,KAAK,uPAI0B,CAAC;AAE7C,eAAO,MAAM,eAAe,SAAgB,SAAS,MAAM,EAAE,YAAY,QAAQ,KAAG,OAAO,CAAC,IAAI,CAoB/F,CAAC"}

package/dist/commands/validate.js

@@ -0,0 +1,49 @@
+import { assertNever } from "@coldtea/pr-lens-schema";
+import { parseOptions } from "../args.js";
+import { validateDocumentFile } from "../document.js";
+import { formatError, PrLensCliError, usageError } from "../errors.js";
+const count = (n, singular) => `${n} ${n === 1 ? singular : `${singular}s`}`;
+const describe = (validated) => {
+    switch (validated.kind) {
+        case "graph": {
+            const { lanes, nodes, edges, flows, lenses } = validated.document;
+            return `graph document · ${count(lanes.length, "lane")}, ${count(nodes.length, "node")}, ${count(edges.length, "edge")}, ${count(flows.length, "flow")} · ${lenses.join(", ")}`;
+        }
+        case "patch":
+            return `patch document · ${count(validated.document.ops.length, "operation")} · ${validated.document.target.fromSha.slice(0, 7)} → ${validated.document.target.toSha.slice(0, 7)}`;
+        case "render-manifest":
+            return `render manifest · ${count(validated.document.assets.length, "asset")}`;
+        case "config": {
+            const { map, lenses } = validated.document;
+            const corrections = map.rename.length + map.exclude.length + map.lane.length + map.group.length;
+            return `config · ${lenses.join(", ")} · ${count(corrections, "correction")}`;
+        }
+        default:
+            return assertNever(validated, "Unhandled document");
+    }
+};
+export const USAGE = `pr-lens validate <file...>
+
+Parses graph documents, patch documents, render manifests and configs — JSON or
+YAML — and reports every problem in each, rather than only the first. A file
+without a 'kind' field is read as a config.`;
+export const validateCommand = async (args, terminal) => {
+    const { positionals } = parseOptions(args, {});
+    if (positionals.length === 0)
+        throw usageError("expected at least one file to validate");
+    let failed = 0;
+    for (const path of positionals) {
+        try {
+            terminal.out(`✓ ${path} — ${describe(await validateDocumentFile(path))}`);
+        }
+        catch (error) {
+            if (!(error instanceof PrLensCliError))
+                throw error;
+            failed += 1;
+            terminal.err(formatError(error));
+        }
+    }
+    if (failed > 0)
+        throw new PrLensCliError("INVALID_DOCUMENT", `${failed} of ${count(positionals.length, "document")} did not validate`);
+};
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

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

package/dist/comment.d.ts

@@ -0,0 +1,16 @@
+import type { GraphDoc, RenderManifest } from "@coldtea/pr-lens-schema";
+/**
+ * How the comment is recognised on a second run, so a pull request keeps one
+ * PR Lens comment instead of collecting one per push. Nothing else may spell
+ * this string: a marker that drifts orphans every comment already posted.
+ */
+export declare const COMMENT_MARKER = "<!-- pr-lens -->";
+export type CommentOptions = {
+    graph: GraphDoc;
+    manifest: RenderManifest;
+    /** Prefix for assets the manifest records as local paths, e.g. a raw content URL. */
+    assetBaseUrl: string | undefined;
+    branding: boolean;
+};
+export declare const composeComment: (options: CommentOptions) => string;
+//# sourceMappingURL=comment.d.ts.map

package/dist/comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.d.ts","sourceRoot":"","sources":["../src/comment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAqB,cAAc,EAAQ,MAAM,yBAAyB,CAAC;AAGjG;;;;GAIG;AACH,eAAO,MAAM,cAAc,qBAAqB,CAAC;AAKjD,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;IACzB,qFAAqF;IACrF,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AA8IF,eAAO,MAAM,cAAc,YAAa,cAAc,KAAG,MA2BxD,CAAC"}

package/dist/comment.js

@@ -0,0 +1,148 @@
+import { assertNever } from "@coldtea/pr-lens-schema";
+import { PrLensCliError } from "./errors.js";
+/**
+ * How the comment is recognised on a second run, so a pull request keeps one
+ * PR Lens comment instead of collecting one per push. Nothing else may spell
+ * this string: a marker that drifts orphans every comment already posted.
+ */
+export const COMMENT_MARKER = "<!-- pr-lens -->";
+const PROJECT_URL = "https://github.com/coldteadotai/pr-lens";
+const COLDTEA_URL = "https://coldtea.ai";
+const escape = (value) => value
+    .replaceAll("&", "&amp;")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;");
+/**
+ * Model-authored prose, rendered as the words it is.
+ *
+ * Every string in the document was written by a model reading a diff, and a
+ * pull request can carry whatever text an author likes into that diff. So
+ * none of it may reach GitHub as markup: escaping the HTML is only half the
+ * job, because markdown would still turn `[Security update](http://…)` into a
+ * link that looks like ours. Each string therefore lands inside an HTML
+ * element — inside one, markdown is not parsed at all — on a single line, so
+ * a blank line cannot end the block and let the rest through.
+ *
+ * The zero-width space after an @ or a # is the last piece: those are matched
+ * after markdown, on the rendered text, and would otherwise notify a person
+ * or cross-link an issue on the say-so of a diff.
+ */
+const text = (value) => escape(value.replace(/\s+/g, " ").trim()).replace(/([@#])(?=[\w-])/g, "$1&#8203;");
+const href = (asset, assetBaseUrl) => {
+    if (asset.url !== undefined)
+        return asset.url;
+    if (asset.path === undefined || assetBaseUrl === undefined)
+        throw new PrLensCliError("USAGE", `asset '${asset.id}' is a local file, so the comment has nowhere to point`, "pass --asset-base-url with the location the rendered SVGs are published at");
+    return `${assetBaseUrl.replace(/\/+$/, "")}/${asset.path.replace(/^\/+/, "")}`;
+};
+const pairsByLens = (assets) => {
+    const pairs = new Map();
+    for (const asset of assets) {
+        const pair = pairs.get(asset.lens) ?? { light: undefined, dark: undefined };
+        pairs.set(asset.lens, { ...pair, [asset.theme]: asset });
+    }
+    return pairs;
+};
+/**
+ * A `<picture>` is what makes one comment readable in both GitHub themes: the
+ * dark source is swapped in by the browser, with the light asset as the `img`
+ * every other reader — email, mobile, an old client — falls back to.
+ *
+ * The whole thing is a link to the image itself, because a comment column is
+ * about 830 pixels wide and a diagram of a system with several lanes is
+ * several times that. It arrives scaled to fit, which is right for scanning,
+ * and one click gives a reader the size the labels were drawn at.
+ */
+const picture = (pair, alt, assetBaseUrl) => {
+    const fallback = pair.light ?? pair.dark;
+    if (fallback === undefined)
+        return "";
+    const source = escape(href(fallback, assetBaseUrl));
+    const image = `<img alt="${text(alt)}" src="${source}" width="${fallback.width}">`;
+    const shown = pair.dark === undefined || pair.light === undefined
+        ? image
+        : [
+            "<picture>",
+            `  <source media="(prefers-color-scheme: dark)" srcset="${escape(href(pair.dark, assetBaseUrl))}">`,
+            `  ${image}`,
+            "</picture>",
+        ].join("\n");
+    return `<a href="${source}">${shown}</a>`;
+};
+const lensLabel = (lens) => {
+    switch (lens) {
+        case "architecture":
+            return "Architecture";
+        case "data-flow":
+            return "Data flow";
+        default:
+            return assertNever(lens, "Unhandled lens");
+    }
+};
+const statsLine = (graph) => {
+    const { stats } = graph;
+    if (stats === undefined)
+        return "";
+    const chips = [
+        stats.filesChanged === undefined
+            ? undefined
+            : `${stats.filesChanged} ${stats.filesChanged === 1 ? "file" : "files"}`,
+        stats.additions === undefined ? undefined : `+${stats.additions}`,
+        stats.deletions === undefined ? undefined : `−${stats.deletions}`,
+        ...stats.chips.map((chip) => `${chip.label} ${chip.value}`),
+    ].filter((chip) => chip !== undefined);
+    return `<p>${chips.map((chip) => `<code>${text(chip)}</code>`).join(" · ")}</p>`;
+};
+const viewSection = (view, assets, assetBaseUrl) => {
+    const own = assets.get(view.id) ?? [];
+    const pair = pairsByLens(own).get(view.lens);
+    const body = [
+        view.summary === undefined ? "" : `<p>${text(view.summary)}</p>`,
+        pair === undefined ? "" : picture(pair, view.title, assetBaseUrl),
+        ...view.children.map((child) => viewSection(child, assets, assetBaseUrl)),
+    ].filter((part) => part !== "");
+    return [
+        `<details${view.defaultOpen ? " open" : ""}>`,
+        `<summary><b>${text(view.title)}</b></summary>`,
+        "",
+        ...body.flatMap((part) => [part, ""]),
+        "</details>",
+    ].join("\n");
+};
+/** Assets keyed by the view they belong to; the root render has no view. */
+const ROOT = "";
+const byView = (manifest) => {
+    const grouped = new Map();
+    for (const asset of manifest.assets) {
+        const key = asset.view ?? ROOT;
+        grouped.set(key, [...(grouped.get(key) ?? []), asset]);
+    }
+    return grouped;
+};
+export const composeComment = (options) => {
+    const { graph, manifest, assetBaseUrl, branding } = options;
+    const assets = byView(manifest);
+    const roots = pairsByLens(assets.get(ROOT) ?? []);
+    const diagrams = graph.lenses.flatMap((lens) => {
+        const pair = roots.get(lens);
+        return pair === undefined ? [] : [picture(pair, `${graph.title} — ${lensLabel(lens)}`, assetBaseUrl)];
+    });
+    const footer = branding
+        ? `<sub>◈ Rendered by <a href="${PROJECT_URL}">PR Lens</a> · from the team behind <a href="${COLDTEA_URL}">Coldtea</a></sub>`
+        : "";
+    return [
+        COMMENT_MARKER,
+        `<h3>${text(graph.title)}</h3>`,
+        graph.summary === undefined ? "" : `<p>${text(graph.summary)}</p>`,
+        statsLine(graph),
+        ...diagrams,
+        ...graph.views.map((view) => viewSection(view, assets, assetBaseUrl)),
+        footer === "" ? "" : "---",
+        footer,
+    ]
+        .filter((block) => block !== "")
+        .join("\n\n")
+        .concat("\n");
+};
+//# sourceMappingURL=comment.js.map

package/dist/comment.js.map

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

package/dist/config-file.d.ts

@@ -0,0 +1,10 @@
+import type { Config } from "@coldtea/pr-lens-schema";
+/** Where a repository puts its corrections, in the order they are looked for. */
+export declare const CONFIG_PATHS: readonly [".github/pr-lens.yml", ".github/pr-lens.yaml"];
+export type LoadedConfig = {
+    path: string;
+    config: Config;
+};
+export declare const loadConfig: (path: string) => Promise<LoadedConfig>;
+export declare const discoverConfig: (root: string) => Promise<LoadedConfig | undefined>;
+//# sourceMappingURL=config-file.d.ts.map

package/dist/config-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file.d.ts","sourceRoot":"","sources":["../src/config-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAKtD,iFAAiF;AACjF,eAAO,MAAM,YAAY,YAAI,qBAAqB,EAAE,sBAAsB,CAAU,CAAC;AAErF,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,eAAO,MAAM,UAAU,SAAgB,MAAM,KAAG,OAAO,CAAC,YAAY,CAGlE,CAAC;AAEH,eAAO,MAAM,cAAc,SAAgB,MAAM,KAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAUnF,CAAC"}

package/dist/config-file.js

@@ -0,0 +1,19 @@
+import { access } from "node:fs/promises";
+import { join } from "node:path";
+import { readConfig } from "./document.js";
+/** Where a repository puts its corrections, in the order they are looked for. */
+export const CONFIG_PATHS = [".github/pr-lens.yml", ".github/pr-lens.yaml"];
+export const loadConfig = async (path) => ({
+    path,
+    config: await readConfig(path),
+});
+export const discoverConfig = async (root) => {
+    for (const candidate of CONFIG_PATHS) {
+        const path = join(root, candidate);
+        const found = await access(path).then(() => true, () => false);
+        if (found)
+            return loadConfig(path);
+    }
+    return undefined;
+};
+//# sourceMappingURL=config-file.js.map

package/dist/config-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file.js","sourceRoot":"","sources":["../src/config-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,iFAAiF;AACjF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,qBAAqB,EAAE,sBAAsB,CAAU,CAAC;AAIrF,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,IAAY,EAAyB,EAAE,CAAC,CAAC;IACxE,IAAI;IACJ,MAAM,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,IAAY,EAAqC,EAAE;IACtF,KAAK,MAAM,SAAS,IAAI,YAAY,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CACnC,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,KAAK,CACZ,CAAC;QACF,IAAI,KAAK;YAAE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

package/dist/corrections.d.ts

@@ -0,0 +1,16 @@
+import type { Config, GraphDoc } from "@coldtea/pr-lens-schema";
+/**
+ * Which of a repository's corrections match no node in this document.
+ *
+ * A selector that matches nothing is a config that has drifted since it was
+ * written — the file it named was moved or deleted — and saying so is the
+ * difference between a correction that stopped working and one that never
+ * did. It is never a reason to delete a correction that does match: that one
+ * is what keeps holding as the code moves.
+ *
+ * Which nodes a selector matches is the renderer's answer to give, so it is
+ * asked rather than recomputed. A second opinion about what a selector means
+ * is how the two drift apart.
+ */
+export declare const unmatchedCorrections: (graph: GraphDoc, config: Config) => string[];
+//# sourceMappingURL=corrections.d.ts.map

package/dist/corrections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corrections.d.ts","sourceRoot":"","sources":["../src/corrections.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAkB,MAAM,yBAAyB,CAAC;AAyDhF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB,UAAW,QAAQ,UAAU,MAAM,KAAG,MAAM,EAc5E,CAAC"}

package/dist/corrections.js

@@ -0,0 +1,80 @@
+import { applyCorrections, graphContentHash } from "@coldtea/pr-lens-renderer";
+const NOTHING = { rename: [], exclude: [], lane: [], group: [] };
+/**
+ * A label, lane id and group id that appear nowhere in this document.
+ *
+ * It is what makes the question answerable at all: a rename to the label a
+ * node already carries moves nothing, and so does a lane pin into the lane a
+ * node is already in. Asking with a value the document cannot already hold
+ * separates "no node matches this" from "every node it matches already agrees
+ * with it" — and the difference matters, because the second is a live
+ * correction holding the line against the next inference.
+ */
+const unusedEverywhere = (graph) => {
+    const taken = new Set([
+        ...graph.nodes.map((node) => node.label),
+        ...graph.nodes.flatMap((node) => (node.group === undefined ? [] : [node.group])),
+        ...graph.nodes.map((node) => node.lane),
+        ...graph.lanes.map((lane) => lane.id),
+    ]);
+    let candidate = "pr-lens-probe";
+    for (let suffix = 1; taken.has(candidate); suffix += 1)
+        candidate = `pr-lens-probe-${suffix}`;
+    return candidate;
+};
+/**
+ * Each correction on its own, aimed somewhere the document is not, so that
+ * matching it always shows. Excluding is the one that needs no probe: a node
+ * a rule matches is always removed.
+ */
+const probes = (map, probe) => [
+    ...map.rename.map((rule) => ({
+        what: "rename",
+        match: rule.match,
+        only: { ...NOTHING, rename: [{ match: rule.match, to: probe }] },
+    })),
+    ...map.exclude.map((selector) => ({
+        what: "exclude",
+        match: selector,
+        only: { ...NOTHING, exclude: [selector] },
+    })),
+    ...map.lane.map((rule) => ({
+        what: "lane",
+        match: rule.match,
+        only: { ...NOTHING, lane: [{ match: rule.match, lane: probe }] },
+    })),
+    ...map.group.map((rule) => ({
+        what: "group",
+        match: rule.match,
+        only: { ...NOTHING, group: [{ match: rule.match, group: probe }] },
+    })),
+];
+/**
+ * Which of a repository's corrections match no node in this document.
+ *
+ * A selector that matches nothing is a config that has drifted since it was
+ * written — the file it named was moved or deleted — and saying so is the
+ * difference between a correction that stopped working and one that never
+ * did. It is never a reason to delete a correction that does match: that one
+ * is what keeps holding as the code moves.
+ *
+ * Which nodes a selector matches is the renderer's answer to give, so it is
+ * asked rather than recomputed. A second opinion about what a selector means
+ * is how the two drift apart.
+ */
+export const unmatchedCorrections = (graph, config) => {
+    const before = graphContentHash(graph);
+    const probe = unusedEverywhere(graph);
+    return probes(config.map, probe).flatMap(({ what, match, only }) => {
+        try {
+            if (graphContentHash(applyCorrections(graph, only)) !== before)
+                return [];
+        }
+        catch {
+            // A correction that emptied the document is a correction that matched.
+            return [];
+        }
+        return [`${what} '${match}' changed nothing — no node in this document matches it`];
+    });
+};
+//# sourceMappingURL=corrections.js.map

package/dist/corrections.js.map

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

package/dist/document.d.ts

@@ -0,0 +1,23 @@
+import { type Config, type GraphDoc, type PatchDoc, type PrLensSchemaError, type RenderManifest } from "@coldtea/pr-lens-schema";
+import { PrLensCliError } from "./errors.js";
+export type DocumentKind = "graph" | "patch" | "render-manifest" | "config";
+export type ValidatedDocument = {
+    kind: "graph";
+    document: GraphDoc;
+} | {
+    kind: "patch";
+    document: PatchDoc;
+} | {
+    kind: "render-manifest";
+    document: RenderManifest;
+} | {
+    kind: "config";
+    document: Config;
+};
+export declare const describeDocumentKind: (kind: DocumentKind) => string;
+export declare const invalidDocument: (path: string, kind: DocumentKind, error: PrLensSchemaError) => PrLensCliError;
+export declare const readGraphDoc: (path: string) => Promise<GraphDoc>;
+export declare const readRenderManifest: (path: string) => Promise<RenderManifest>;
+export declare const readConfig: (path: string) => Promise<Config>;
+export declare const validateDocumentFile: (path: string) => Promise<ValidatedDocument>;
+//# sourceMappingURL=document.d.ts.map

package/dist/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,MAAM,EACX,KAAK,QAAQ,EAEb,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAE5E,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,eAAO,MAAM,oBAAoB,SAAU,YAAY,KAAG,MAazD,CAAC;AAEF,eAAO,MAAM,eAAe,SACpB,MAAM,QACN,YAAY,SACX,iBAAiB,KACvB,cAKA,CAAC;AAsBJ,eAAO,MAAM,YAAY,SAAgB,MAAM,KAAG,OAAO,CAAC,QAAQ,CACM,CAAC;AAEzE,eAAO,MAAM,kBAAkB,SAAgB,MAAM,KAAG,OAAO,CAAC,cAAc,CACU,CAAC;AAEzF,eAAO,MAAM,UAAU,SAAgB,MAAM,KAAG,OAAO,CAAC,MAAM,CACS,CAAC;AAsBxE,eAAO,MAAM,oBAAoB,SAAgB,MAAM,KAAG,OAAO,CAAC,iBAAiB,CAgBlF,CAAC"}