@nanonets/graft 0.12.1 → 0.15.0

package/dist/blast/evidence.js

@@ -0,0 +1,162 @@
+/**
+ * Turning a report into code a reader can see.
+ *
+ * `blast` knows which lines changed (git's hunks) and which symbols reach them
+ * (the walk), and both the hosted panel and the PR comment want to SHOW that
+ * rather than cite a line number the reader has to go and look up. The shaping
+ * lives here so the two surfaces quote the same lines: a comment that disagreed
+ * with the page it links to would be worse than one that said less.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+const plural = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
+/** Symbols given their own snippet per node. Past this the panel is a file listing
+ * rather than a summary — the rest are still counted in the headline. */
+export const MAX_EVIDENCE = 4;
+/** Lines shown per snippet before it folds. A handful is a hunk you can read at a
+ * glance; a 30-line refactor is a diff view's job, not a panel's. */
+const MAX_LINES = 6;
+/** `L12-L34` → the numbers, so a label is something a reader can type. */
+export function spanRange(span) {
+    const m = /^L(\d+)(?:-L(\d+))?$/.exec(span);
+    if (!m)
+        return null;
+    const start = Number(m[1]);
+    return { start, end: m[2] === undefined ? start : Number(m[2]) };
+}
+function labelFor(name, path, span) {
+    const r = spanRange(span);
+    return r ? `${name} · ${path}:${r.start}-${r.end}` : `${name} · ${path}`;
+}
+/** Keep the first {@link MAX_LINES}, and say how many were left. */
+function fold(lines) {
+    if (lines.length <= MAX_LINES)
+        return { lines };
+    return { lines: lines.slice(0, MAX_LINES), more: lines.length - MAX_LINES };
+}
+const asEvidenceLines = (lines) => lines.map((l) => ({ n: l.n, sign: l.sign, text: l.text }));
+/**
+ * The hunks of `file` that fall inside `span`.
+ *
+ * A file's diff is split by symbol rather than shown whole, because two unrelated
+ * edits in one file are two answers — a panel that merges them makes the reader do
+ * the separating.
+ */
+function hunksIn(file, span) {
+    const out = [];
+    let dropped = 0;
+    for (const h of file.hunks) {
+        if (span && (h.end < span.start || h.start > span.end))
+            continue;
+        out.push(...asEvidenceLines(h.lines));
+        dropped += h.dropped;
+    }
+    return { lines: out, dropped };
+}
+/** Evidence for one changed symbol: what this PR did to it. */
+export function seedEvidence(seed, file) {
+    if (!file)
+        return null;
+    const span = seed.wholeFile ? null : spanRange(seed.span);
+    const { lines, dropped } = hunksIn(file, span);
+    if (lines.length === 0 && dropped === 0)
+        return null;
+    const folded = fold(lines);
+    const more = (folded.more ?? 0) + dropped;
+    return {
+        label: seed.wholeFile ? seed.path : labelFor(seed.name, seed.path, seed.span),
+        note: file.status === "added" ? "new file" : seed.wholeFile ? "outside any symbol" : undefined,
+        lines: folded.lines,
+        more: more > 0 ? more : undefined,
+    };
+}
+const escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/**
+ * The first line inside a span that mentions one of `needles`, with its number.
+ *
+ * This is the whole trick behind "why is this symbol here": the edge says A calls
+ * B, and this finds the line where it does it. Shared so `blast`'s panel, its
+ * comment and `graft callers` all quote the same line for the same edge.
+ */
+export function referenceLine(path, span, needles, read) {
+    const range = spanRange(span);
+    const lines = read(path);
+    if (!range || !lines)
+        return null;
+    for (const [i, text] of lines.slice(range.start - 1, range.end).entries()) {
+        if (needles.some((re) => re.test(text)))
+            return { n: range.start + i, text };
+    }
+    return null;
+}
+/** A symbol name, matched as a whole word — `export` must not hit `exportViz`. */
+export const wordRe = (name) => new RegExp(`\\b${escapeRe(name)}\\b`);
+/**
+ * Evidence for one dependent symbol: the line that reaches the diff.
+ *
+ * Nothing changed here, so there is no hunk to show — the useful line is the one
+ * naming a changed symbol or module, which answers "why am I in this blast radius
+ * at all". Found by reading the symbol's span off disk.
+ *
+ * When no line names the diff, this returns nothing rather than quoting the span's
+ * first line: for a file-level dependent that first line is `/**`, and a panel that
+ * shows it has spent a code block to say nothing.
+ */
+export function impactedEvidence(sym, reach, read) {
+    // A changed symbol's own name is the strongest signal; a file-level dependent
+    // usually reaches the diff through its import line, which names a MODULE
+    // instead, so both are tried in that order.
+    const byName = referenceLine(sym.path, sym.span, reach.names.map(wordRe), read);
+    if (byName) {
+        const hit = reach.names.find((n) => wordRe(n).test(byName.text));
+        return {
+            label: labelFor(sym.name, sym.path, sym.span),
+            note: `${sym.relation} ${hit}`,
+            lines: [{ n: byName.n, sign: " ", text: byName.text }],
+        };
+    }
+    const byModule = referenceLine(sym.path, sym.span, reach.modules, read);
+    if (byModule) {
+        return {
+            label: labelFor(sym.name, sym.path, sym.span),
+            note: sym.relation,
+            lines: [{ n: byModule.n, sign: " ", text: byModule.text }],
+        };
+    }
+    // No line names the diff — an indirect reach (a dynamic import, a re-export),
+    // or a symbol whose whole file is the span. Quoting its first line means
+    // quoting `/**`, so the block is dropped instead: the path stays in `sources`
+    // and the panel simply says less.
+    return null;
+}
+export function reachTerms(seeds, changed) {
+    const names = [...new Set(seeds.filter((s) => !s.wholeFile).map((s) => s.name))].sort((a, b) => b.length - a.length);
+    const stems = [...new Set(changed.map((f) => f.path.replace(/\.[^./]+$/, "").split("/").pop() ?? ""))].filter(Boolean);
+    return {
+        names,
+        modules: stems.map((stem) => new RegExp(`["'\`][^"'\`]*\\b${escapeRe(stem)}(\\.[a-z]+)?["'\`]`)),
+    };
+}
+/** Read each file once, and never fail: a snippet is a nicety, and a symbol whose
+ * file moved under us must not take the whole page down. */
+export function fileReader(root) {
+    const cache = new Map();
+    return (path) => {
+        if (root === undefined)
+            return null;
+        const hit = cache.get(path);
+        if (hit !== undefined)
+            return hit;
+        let lines = null;
+        try {
+            lines = readFileSync(join(root, path), "utf8").split("\n");
+        }
+        catch {
+            // Deleted, renamed under us, or unreadable: no snippet, no failure.
+            lines = null;
+        }
+        cache.set(path, lines);
+        return lines;
+    };
+}
+//# sourceMappingURL=evidence.js.map

package/dist/blast/evidence.js.map

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

package/dist/blast/owners.d.ts

@@ -0,0 +1,85 @@
+import type { BlastReport } from "./blast.js";
+/** One person's claim on one area. */
+export interface Owner {
+    /** Display name as git reports it, with `.mailmap` already applied. */
+    name: string;
+    /** GitHub handle, when the commit email carries one. Never guessed. */
+    handle?: string;
+    /** Commits of theirs that touched this area's files. */
+    commits: number;
+    /** Recency-weighted weight of those commits — the ranking key. */
+    score: number;
+    /** Their most recent commit here, ms since the epoch. */
+    last: number;
+}
+/** One person's claim across the whole report: what the tag line prints. */
+export interface Reviewer extends Owner {
+    /** Area labels they own, heaviest first. */
+    areas: string[];
+}
+export interface OwnerOptions {
+    /** Logins, names or emails to drop — the PR author, so they are not told to
+     * tag themselves. Matched case-insensitively against all three. */
+    exclude?: string[];
+    /** Clock, so a test can plant history at a fixed distance from "now". */
+    now?: number;
+}
+/** Names listed per area, and in the tag line. */
+export declare const MAX_PER_AREA = 2;
+export declare const MAX_REVIEWERS = 3;
+/**
+ * A GitHub handle out of a commit email, or null.
+ *
+ * Both noreply forms are accepted: the modern `12345+name@` and the legacy bare
+ * `name@`. The character class is GitHub's own username rule (alphanumerics and
+ * interior hyphens, 39 max) so an address that merely ends in the right domain
+ * cannot smuggle something unmentionable into a comment body.
+ */
+export declare function githubHandle(email: string): string | null;
+/**
+ * The people behind `files`, best first.
+ *
+ * `--no-merges` because a merge commit's author is whoever pressed the button,
+ * not whoever wrote the code. `%aN`/`%aE` rather than `%an`/`%ae` so git applies
+ * the repository's `.mailmap` for us — which is the supported way to give a
+ * contributor whose work address has no handle a noreply one, at no new config
+ * cost to graft.
+ */
+export declare function ownersFor(root: string, files: string[], opts?: OwnerOptions): Owner[];
+/**
+ * Everyone who authored a commit in `base...HEAD` — the people whose work this
+ * pull request IS.
+ *
+ * This is the exclusion that actually fires in CI. The obvious source for "who
+ * opened this" is `pull_request.user.email` from the webhook, but GitHub almost
+ * never populates it, so excluding on the login alone leaves anyone whose commits
+ * carry a work address being suggested as a reviewer of their own PR. The commits
+ * in the range carry exactly the name and email git will match on later.
+ *
+ * Co-authors count too: a pair-programmed commit has two people on it and neither
+ * of them is a reviewer of it.
+ */
+export declare function diffAuthors(root: string, base: string): string[];
+/**
+ * Whoever git would sign a commit as, here and now.
+ *
+ * The local counterpart of {@link diffAuthors}. `graft blast` with no `--base`
+ * compares the working tree against HEAD, so there is no commit range to read
+ * authors from — and without this, the one person guaranteed to have written the
+ * change being examined is also the top name in its own "who to tag" list.
+ */
+export declare function localIdentity(root: string): string[];
+/**
+ * Fill in `owners` on every area and module, and rank the report's `reviewers`.
+ *
+ * Called AFTER `--name`, because a reviewer's reason cites area labels and the
+ * naming pass is what gives an area its final label.
+ */
+export declare function attachOwners(root: string, report: BlastReport, opts?: OwnerOptions): void;
+/** `9d ago`, `3mo ago` — how a comment says when someone was last in here. */
+export declare function sinceLabel(last: number, now?: number): string;
+/** `@handle`, or the bare name when git carries no handle for them. */
+export declare function mention(o: Owner): string;
+/** ISO day, for an exported page that has to stay truthful when opened later. */
+export declare function isoDay(ms: number): string;
+//# sourceMappingURL=owners.d.ts.map

package/dist/blast/owners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owners.d.ts","sourceRoot":"","sources":["../../src/blast/owners.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,sCAAsC;AACtC,MAAM,WAAW,KAAK;IACpB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4EAA4E;AAC5E,MAAM,WAAW,QAAS,SAAQ,KAAK;IACrC,4CAA4C;IAC5C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B;uEACmE;IACnE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA4BD,kDAAkD;AAClD,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,aAAa,IAAI,CAAC;AAW/B;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzD;AAmBD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,YAAiB,GAAG,KAAK,EAAE,CAuEzF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBhE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAIpD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,GAAE,YAAiB,GAAG,IAAI,CA+B7F;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAOzE;AAED,uEAAuE;AACvE,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAExC;AAED,iFAAiF;AACjF,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEzC"}

package/dist/blast/owners.js

@@ -0,0 +1,272 @@
+/**
+ * Who to tag on a pull request: the people whose fingerprints are on the areas
+ * this diff changes or can affect.
+ *
+ * The blast report already answers "what does this reach"; the author's next
+ * question is "who do I ask about it", and git has the answer without a single
+ * API call. One `git log` per area over that area's OWN files, scored by recency,
+ * ranked, capped.
+ *
+ * Two rules keep the output honest, and both exist because a wrong name here is
+ * worse than no name:
+ *
+ *  - A handle is only ever printed when git actually carries one (the GitHub
+ *    noreply address, which anything merged through the web UI has). With no
+ *    handle the display name is printed unlinked — a guessed `@mention` pings a
+ *    stranger, and there is no cheap way to verify a guess.
+ *  - An owner has to hold {@link MIN_SHARE} of an area's weight to be named. That
+ *    drops a drive-by typo fix next to a real owner, and keeps it when the
+ *    drive-by is all the history there is.
+ *
+ * Everything here is best-effort: no git, no repository, a detached tarball
+ * checkout or a shallow clone leaves the report exactly as it was and the comment
+ * simply says nothing about people.
+ */
+import { spawnSync } from "node:child_process";
+import { resolve } from "node:path";
+/**
+ * Recency half-life. A commit from four months ago counts half as much as one
+ * from today, so the person who rewrote a module last month outranks the person
+ * who created it two years ago and moved on — which is the reviewer an author
+ * actually wants.
+ */
+const HALF_LIFE_MS = 120 * 24 * 60 * 60 * 1000;
+/**
+ * History window and commit cap, per area.
+ *
+ * Both are bounds on the walk, not on the answer: at 36 months a commit is worth
+ * 0.002 of a fresh one, so nothing outside the window could survive the share
+ * floor anyway, and the pair keeps one `git log` off a large repo's full history.
+ */
+const SINCE = "36.months";
+const MAX_COMMITS = 400;
+/** Files passed to one `git log`. A very wide area is sampled rather than blowing
+ * the argument list; the sample is the area's own sorted file list, so it is
+ * stable between runs rather than whichever files git happened to yield. */
+const MAX_PATHSPEC = 80;
+/** Share of an area's total weight an owner must hold to be named. */
+const MIN_SHARE = 0.15;
+/** Names listed per area, and in the tag line. */
+export const MAX_PER_AREA = 2;
+export const MAX_REVIEWERS = 3;
+/**
+ * Weight of an area a diff only *reaches*, against one it edits.
+ *
+ * Not zero, because the person whose code your change can break is exactly the
+ * reviewer the diff alone would never surface — that is what the blast radius is
+ * for. Not one either: the author of the code you edited knows it better.
+ */
+const AFFECTED_WEIGHT = 0.6;
+/**
+ * A GitHub handle out of a commit email, or null.
+ *
+ * Both noreply forms are accepted: the modern `12345+name@` and the legacy bare
+ * `name@`. The character class is GitHub's own username rule (alphanumerics and
+ * interior hyphens, 39 max) so an address that merely ends in the right domain
+ * cannot smuggle something unmentionable into a comment body.
+ */
+export function githubHandle(email) {
+    const m = /^(?:\d+\+)?([A-Za-z0-9](?:-?[A-Za-z0-9]){0,38})@users\.noreply\.github\.com$/i.exec(email.trim());
+    return m ? m[1] : null;
+}
+/** Bots write commits and are never reviewers. */
+function isBot(name, email) {
+    return /\[bot\]/i.test(name) || /\[bot\]@/i.test(email) || /^(github-actions|dependabot|renovate)(\[bot\])?$/i.test(name.trim());
+}
+/** Run git in `root`, or null when git fails — not a repo, no git, no history. */
+function git(root, args) {
+    const res = spawnSync("git", ["-c", "core.quotePath=false", ...args], {
+        cwd: root,
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "pipe"],
+        maxBuffer: 64 * 1024 * 1024,
+    });
+    if (res.error || res.status !== 0 || typeof res.stdout !== "string")
+        return null;
+    return res.stdout;
+}
+/**
+ * The people behind `files`, best first.
+ *
+ * `--no-merges` because a merge commit's author is whoever pressed the button,
+ * not whoever wrote the code. `%aN`/`%aE` rather than `%an`/`%ae` so git applies
+ * the repository's `.mailmap` for us — which is the supported way to give a
+ * contributor whose work address has no handle a noreply one, at no new config
+ * cost to graft.
+ */
+export function ownersFor(root, files, opts = {}) {
+    const paths = [...files].sort().slice(0, MAX_PATHSPEC);
+    if (paths.length === 0)
+        return [];
+    const now = opts.now ?? Date.now();
+    const out = git(resolve(root), [
+        "log",
+        "--no-merges",
+        `--since=${SINCE}`,
+        "-n",
+        String(MAX_COMMITS),
+        "--format=\x01%H\x02%aI\x02%aN\x02%aE",
+        "--name-only",
+        "--",
+        ...paths,
+    ]);
+    if (out === null)
+        return [];
+    const wanted = new Set(paths);
+    const people = new Map();
+    let commit = null;
+    for (const line of out.split("\n")) {
+        if (line.startsWith("\x01")) {
+            const [hash, iso, name, email] = line.slice(1).split("\x02");
+            const at = Date.parse(iso ?? "");
+            commit = Number.isFinite(at)
+                ? { hash, at, weight: Math.pow(0.5, (now - at) / HALF_LIFE_MS), name: name ?? "", email: email ?? "" }
+                : null;
+            continue;
+        }
+        // A pathspec'd `git log --name-only` already lists only matching files, but
+        // the set is re-checked here so a future flag change cannot silently start
+        // crediting whoever touched an unrelated file in the same commit.
+        if (commit === null || !wanted.has(line))
+            continue;
+        if (isBot(commit.name, commit.email))
+            continue;
+        const handle = githubHandle(commit.email) ?? undefined;
+        const key = (handle ?? commit.email).toLowerCase();
+        const prev = people.get(key);
+        if (!prev) {
+            people.set(key, {
+                name: commit.name, handle, commits: 1, score: commit.weight, last: commit.at,
+                seen: new Set([commit.hash]),
+            });
+            continue;
+        }
+        // One commit touching six files in the area is one commit, not six.
+        if (prev.seen.has(commit.hash))
+            continue;
+        prev.seen.add(commit.hash);
+        prev.commits += 1;
+        prev.score += commit.weight;
+        prev.last = Math.max(prev.last, commit.at);
+    }
+    const excluded = new Set((opts.exclude ?? []).map((e) => e.trim().toLowerCase()).filter(Boolean));
+    const isExcluded = (o, email) => excluded.has(email.toLowerCase()) ||
+        excluded.has(o.name.toLowerCase()) ||
+        (o.handle !== undefined && excluded.has(o.handle.toLowerCase()));
+    const kept = [...people].filter(([email, o]) => !isExcluded(o, email)).map(([, o]) => o);
+    // The floor is a SHARE of what is left after the author is dropped, not of the
+    // whole area. On a repo where one person wrote everything, their own PR would
+    // otherwise leave every remaining contributor under the floor and report nobody.
+    const total = kept.reduce((n, o) => n + o.score, 0);
+    return kept
+        .filter((o) => total === 0 || o.score / total >= MIN_SHARE)
+        .sort((a, b) => b.score - a.score || b.commits - a.commits || a.name.localeCompare(b.name))
+        .slice(0, MAX_PER_AREA)
+        .map(({ name, handle, commits, score, last }) => ({ name, handle, commits, score, last }));
+}
+/**
+ * Everyone who authored a commit in `base...HEAD` — the people whose work this
+ * pull request IS.
+ *
+ * This is the exclusion that actually fires in CI. The obvious source for "who
+ * opened this" is `pull_request.user.email` from the webhook, but GitHub almost
+ * never populates it, so excluding on the login alone leaves anyone whose commits
+ * carry a work address being suggested as a reviewer of their own PR. The commits
+ * in the range carry exactly the name and email git will match on later.
+ *
+ * Co-authors count too: a pair-programmed commit has two people on it and neither
+ * of them is a reviewer of it.
+ */
+export function diffAuthors(root, base) {
+    const out = git(resolve(root), ["log", "--format=%aN%n%aE%n%(trailers:key=Co-authored-by,valueonly)", `${base}...HEAD`]);
+    if (out === null)
+        return [];
+    const names = new Set();
+    for (const raw of out.split("\n")) {
+        const line = raw.trim();
+        if (line === "")
+            continue;
+        // A co-author trailer is `Name <email>`; both halves are worth excluding.
+        const m = /^(.*?)\s*<([^>]+)>$/.exec(line);
+        if (m) {
+            if (m[1])
+                names.add(m[1]);
+            names.add(m[2]);
+            continue;
+        }
+        names.add(line);
+    }
+    return [...names];
+}
+/**
+ * Whoever git would sign a commit as, here and now.
+ *
+ * The local counterpart of {@link diffAuthors}. `graft blast` with no `--base`
+ * compares the working tree against HEAD, so there is no commit range to read
+ * authors from — and without this, the one person guaranteed to have written the
+ * change being examined is also the top name in its own "who to tag" list.
+ */
+export function localIdentity(root) {
+    const dir = resolve(root);
+    const out = [git(dir, ["config", "user.name"]), git(dir, ["config", "user.email"])];
+    return out.map((v) => v?.trim() ?? "").filter((v) => v !== "");
+}
+/**
+ * Fill in `owners` on every area and module, and rank the report's `reviewers`.
+ *
+ * Called AFTER `--name`, because a reviewer's reason cites area labels and the
+ * naming pass is what gives an area its final label.
+ */
+export function attachOwners(root, report, opts = {}) {
+    const ranked = new Map();
+    const visit = (label, files, weight) => {
+        const owners = ownersFor(root, files, opts);
+        for (const o of owners) {
+            const key = (o.handle ?? o.name).toLowerCase();
+            const prev = ranked.get(key);
+            if (!prev) {
+                ranked.set(key, { ...o, areas: [label], weighted: o.score * weight });
+                continue;
+            }
+            prev.areas.push(label);
+            prev.commits += o.commits;
+            prev.score += o.score;
+            prev.weighted += o.score * weight;
+            prev.last = Math.max(prev.last, o.last);
+            // A handle found on any one area is the handle: a contributor who has some
+            // commits from the web UI and some from a laptop should still be taggable.
+            if (prev.handle === undefined && o.handle !== undefined)
+                prev.handle = o.handle;
+        }
+        return owners;
+    };
+    for (const area of report.areas)
+        area.owners = visit(area.label, area.files, 1);
+    for (const mod of report.modules)
+        mod.owners = visit(mod.label, mod.files, AFFECTED_WEIGHT);
+    report.reviewers = [...ranked.values()]
+        .sort((a, b) => b.weighted - a.weighted || b.commits - a.commits || a.name.localeCompare(b.name))
+        .slice(0, MAX_REVIEWERS)
+        .map(({ weighted: _weighted, ...r }) => r);
+}
+/** `9d ago`, `3mo ago` — how a comment says when someone was last in here. */
+export function sinceLabel(last, now = Date.now()) {
+    const days = Math.max(0, Math.round((now - last) / (24 * 60 * 60 * 1000)));
+    if (days < 1)
+        return "today";
+    if (days === 1)
+        return "yesterday";
+    if (days < 31)
+        return `${days}d ago`;
+    const months = Math.round(days / 30);
+    return months < 24 ? `${months}mo ago` : `${Math.round(days / 365)}y ago`;
+}
+/** `@handle`, or the bare name when git carries no handle for them. */
+export function mention(o) {
+    return o.handle !== undefined ? `@${o.handle}` : o.name;
+}
+/** ISO day, for an exported page that has to stay truthful when opened later. */
+export function isoDay(ms) {
+    return new Date(ms).toISOString().slice(0, 10);
+}
+//# sourceMappingURL=owners.js.map

package/dist/blast/owners.js.map

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

package/dist/blast/render.d.ts

@@ -30,8 +30,17 @@ import type { BlastReport } from "./blast.js";
  * broken renderer, and the caller has a sentence for "no dependents found".
  */
 export declare function mermaidDiagram(r: BlastReport): string | null;
-/** The PR-comment body: diagram, then one table, then everything else collapsed. */
-export declare function markdownReport(r: BlastReport): string;
+/**
+ * The PR-comment body: diagram, then one table, then everything else collapsed.
+ *
+ * `root` is the repository the report was taken in. With it, the collapsed symbol
+ * list quotes the line that reaches the diff — the same line the hosted page shows,
+ * from the same helper. Without it the list is unchanged, so a caller that has no
+ * checkout (a test, a piped report) loses nothing but the snippet.
+ */
+export declare function markdownReport(r: BlastReport, opts?: {
+    root?: string;
+}): string;
 /** Terminal report: same content, no markdown scaffolding. */
 export declare function textReport(r: BlastReport): string;
 //# sourceMappingURL=render.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/blast/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AA8C1D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAsB5D;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAiCrD;AA+JD,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CA8BjD"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/blast/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,WAAW,EAAqD,MAAM,YAAY,CAAC;AAoDjG;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAsB5D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CA6CnF;AA0PD,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAuCjD"}