trail-code 0.0.0-stage → 0.28.0-semantic.3

package/dist/blast/name.js

@@ -0,0 +1,269 @@
+/**
+ * Naming the clusters a diff reaches — the rung of the ladder between a concept
+ * node and the symbol backstop (see {@link LabelSource}).
+ *
+ * The point is scope. Getting labels from `build --deep` means summarising every
+ * file in the repo — 356 calls and thirteen minutes on graft's own repo — to put
+ * names on the six clusters a PR actually touches, and it still misses: only 40% of
+ * this repo's files are claimed by a concept, so the rest fall back to a path. Here
+ * the unit of work is the cluster, not the file: one request names all of them from
+ * data the graph already holds (paths and symbol names — no file reads), and the
+ * answer is cached by content hash so the next PR pays nothing for a cluster whose
+ * files did not change.
+ *
+ * Two rules keep it honest:
+ *   - a cluster spanning unrelated features must come back "mixed", and then keeps
+ *     its symbol backstop rather than a flattering name;
+ *   - a failure of any kind — no key, spent quota, refused call, malformed answer —
+ *     leaves every label exactly as it was and never fails the caller.
+ */
+import { createHash } from "node:crypto";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { CACHE_DIR } from "../context/node-file.js";
+import { shortLabel } from "./modules.js";
+const SYSTEM_PROMPT = `You name parts of a codebase for a pull-request reviewer.
+
+You are given clusters of files that a change can affect. For each cluster, answer with the FEATURE or SUBSYSTEM those files implement, as a developer on the team would refer to it in conversation.
+
+Rules:
+- 2 to 4 words, Title Case. No trailing "Module", "System", "Layer", "Manager" or "Handler" unless the team would genuinely say it.
+- Name the RESPONSIBILITY, not the mechanics: "Query Freshness Gate", "Workspace Federation", "Asset Bundling". Never restate a path or a directory name, and never name it after the language or the file type.
+- If the files in a cluster serve two or more unrelated responsibilities, answer exactly "mixed" for that cluster. A wrong name is worse than no name, because a reviewer will trust it.
+- Answer for every cluster key you are given, and invent no other keys.`;
+const NAMES_SCHEMA = {
+    type: "object",
+    properties: {
+        names: {
+            type: "array",
+            items: {
+                type: "object",
+                properties: {
+                    key: { type: "string", description: "the cluster key, copied verbatim" },
+                    name: { type: "string", description: '2-4 word Title Case name, or "mixed"' },
+                },
+                required: ["key", "name"],
+                additionalProperties: false,
+            },
+        },
+    },
+    required: ["names"],
+    additionalProperties: false,
+};
+/** Symbols shown per cluster. Enough to characterise it; not a file listing. */
+const SYMBOLS_PER_CLUSTER = 8;
+/**
+ * Clusters per request. A PR's diagram needs six, so one batch covers it — the cap
+ * is for the cache-priming job, which deliberately walks a wide diff and can hand
+ * over fifty clusters at once. Past a dozen the prompt stops being a list and the
+ * model starts dropping keys.
+ */
+const CLUSTERS_PER_CALL = 12;
+function clusterPrompt(clusters) {
+    return clusters
+        .map((c) => {
+        const files = c.files.slice(0, 10).join(", ");
+        const symbols = c.symbols.slice(0, SYMBOLS_PER_CLUSTER).join(", ");
+        return `key: ${c.key}\n  files: ${files}\n  symbols: ${symbols || "(none extracted)"}`;
+    })
+        .join("\n\n");
+}
+/** The production namer: one forced-tool call for every cluster at once. */
+export class ChatNamer {
+    model;
+    constructor(model) {
+        this.model = model;
+    }
+    async name(clusters) {
+        const res = await this.model.create({
+            messages: [
+                { role: "system", content: SYSTEM_PROMPT },
+                { role: "user", content: clusterPrompt(clusters) },
+            ],
+            tools: [{ name: "record_names", description: "Record one name per cluster.", parameters: NAMES_SCHEMA }],
+            responseFormat: { kind: "tool", name: "record_names" },
+            temperature: 0,
+            maxTokens: 1024,
+        });
+        const out = new Map();
+        const call = res.toolCalls[0]?.args;
+        for (const row of call?.names ?? []) {
+            if (!row?.key || !row?.name)
+                continue;
+            const clean = sanitize(row.name);
+            // "mixed" is an answer, not a name: the cluster keeps its backstop.
+            if (!clean || /^mixed$/i.test(clean))
+                continue;
+            out.set(row.key, clean);
+        }
+        return out;
+    }
+}
+/**
+ * A model-written string on its way into a Mermaid label and a markdown table.
+ *
+ * Symbol names from a fork's diff reach the prompt, so the answer is untrusted
+ * input: anything that could close a label, open a tag or start a table cell is
+ * stripped here rather than at each render site.
+ */
+export function sanitize(raw) {
+    const flat = raw.replace(/[\r\n]+/g, " ").replace(/[<>"'`|(){}[\]#]/g, "").replace(/\s+/g, " ").trim();
+    return shortLabel(flat);
+}
+/**
+ * The cache key for a cluster: what it contains, not what it is called.
+ *
+ * Member paths pin the shape and each member's `body_hash` pins the content, so a
+ * cluster is renamed only when the code in it actually changes. Without this the
+ * same area gets a slightly different name on every PR and two comments stop being
+ * comparable — the failure the cache exists to prevent.
+ */
+export function clusterHash(files, hashes) {
+    const parts = [...files].sort().map((f) => `${f}:${hashes.get(f) ?? "?"}`);
+    return createHash("sha256").update(parts.join("\n")).digest("hex").slice(0, 16);
+}
+function cachePath(contextDir) {
+    return join(contextDir, CACHE_DIR, "areas.json");
+}
+export function loadNameCache(contextDir) {
+    try {
+        const raw = JSON.parse(readFileSync(cachePath(contextDir), "utf8"));
+        return raw && typeof raw === "object" ? raw : {};
+    }
+    catch {
+        // A missing or corrupt cache is a cache miss, never an error: the names are
+        // derivable again, and refusing to run because a cache file is bad is worse.
+        return {};
+    }
+}
+export function saveNameCache(contextDir, names) {
+    const path = cachePath(contextDir);
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, `${JSON.stringify(names, null, 2)}\n`);
+    }
+    catch {
+        // Best-effort: an unwritable cache costs a call next time, nothing more.
+    }
+}
+/** File-node content hashes, which is what a cluster's identity is built from. */
+function fileHashes(graph) {
+    const out = new Map();
+    for (const n of graph.nodes)
+        if (n.kind === "file")
+            out.set(n.path, n.body_hash ?? "");
+    return out;
+}
+function symbolsOf(c) {
+    return "symbols" in c ? c.symbols.map((s) => s.name) : c.seedNames;
+}
+/**
+ * Fill in labels for every cluster still sitting on its symbol backstop.
+ *
+ * Clusters already named by a concept node are left alone: a concept was written
+ * from whole file bodies, which is strictly more than the paths and symbol names
+ * this pass can see.
+ */
+export async function applyNames(graph, report, opts) {
+    const stats = { cached: 0, named: 0, declined: 0 };
+    // `testModules` are deliberately absent: the comment shows them as a file count in
+    // one collapsed line and nowhere else, so naming them buys nothing and can push a
+    // normal PR over CLUSTERS_PER_CALL into a second request.
+    const targets = [...report.modules, ...report.areas]
+        .filter((c) => c.labelSource === "symbol");
+    if (targets.length === 0)
+        return stats;
+    const hashes = fileHashes(graph);
+    const cache = loadNameCache(opts.contextDir);
+    const pending = [];
+    /** Clusters sharing a hash share a name — and one call, not several. */
+    const byHash = new Map();
+    for (const t of targets) {
+        const hash = clusterHash(t.files, hashes);
+        byHash.set(hash, [...(byHash.get(hash) ?? []), t]);
+    }
+    for (const [hash, group] of byHash) {
+        const hit = cache[hash];
+        if (hit) {
+            for (const t of group) {
+                t.label = hit;
+                t.labelSource = "named";
+            }
+            stats.cached++;
+            continue;
+        }
+        pending.push({
+            cluster: { key: hash, files: group[0].files, symbols: symbolsOf(group[0]) },
+            targets: group,
+        });
+    }
+    if (pending.length === 0 || !opts.namer)
+        return stats;
+    const named = new Map();
+    for (let i = 0; i < pending.length; i += CLUSTERS_PER_CALL) {
+        const batch = pending.slice(i, i + CLUSTERS_PER_CALL);
+        try {
+            for (const [k, v] of await opts.namer.name(batch.map((p) => p.cluster)))
+                named.set(k, v);
+        }
+        catch (err) {
+            // Every label already holds its backstop, so there is nothing to undo — and a
+            // later batch failing must not discard the names an earlier one returned.
+            stats.error = err instanceof Error ? err.message : String(err);
+            break;
+        }
+    }
+    for (const p of pending) {
+        const name = named.get(p.cluster.key);
+        if (!name) {
+            stats.declined++;
+            continue;
+        }
+        for (const t of p.targets) {
+            t.label = name;
+            t.labelSource = "named";
+        }
+        cache[p.cluster.key] = name;
+        stats.named++;
+    }
+    if (stats.named > 0)
+        saveNameCache(opts.contextDir, cache);
+    return stats;
+}
+/**
+ * Name the clusters left on their symbol backstop, and say what it cost.
+ *
+ * Everything here is best-effort by construction: no key, a spent quota or a
+ * refused call leaves the backstop labels in place, because neither a PR check
+ * nor a review comment should fail over a cosmetic layer. The note comes back
+ * rather than going to a stream, so `graft blast --name` can prefix it and the
+ * App can log it against the pull request it belongs to.
+ */
+export async function nameReport(graph, report, contextDir) {
+    const { resolveConfig } = await import("../ai/providers.js");
+    const cfg = resolveConfig({ contextDir });
+    let namer;
+    if (cfg.chatModel) {
+        namer = new ChatNamer(cfg.chatModel);
+    }
+    else if (cfg.apiKey) {
+        const { createChatModel } = await import("../ai/llm/factory.js");
+        namer = new ChatNamer(createChatModel({
+            provider: cfg.provider, apiKey: cfg.apiKey, model: cfg.model,
+            baseUrl: cfg.baseUrl, headers: cfg.headers,
+        }));
+    }
+    const stats = await applyNames(graph, report, { namer, contextDir });
+    if (!namer)
+        return { stats, note: "no API key (GRAFT_API_KEY), so areas keep their symbol names" };
+    if (stats.error)
+        return { stats, note: `naming failed (${stats.error}) — areas keep their symbol names` };
+    if (stats.named + stats.cached + stats.declined > 0) {
+        const bits = [`${stats.named} named`, `${stats.cached} cached`];
+        if (stats.declined > 0)
+            bits.push(`${stats.declined} left as symbols (mixed)`);
+        return { stats, note: bits.join(", ") };
+    }
+    return { stats, note: null };
+}
+//# sourceMappingURL=name.js.map

package/dist/blast/name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"name.js","sourceRoot":"","sources":["../../src/blast/name.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":"AA2BA,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;AAkBD;;;;;;;;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 { WINHIDE } from "../util/child-process.js";
+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], { ...WINHIDE, 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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"}