@nanonets/graft 0.10.0 → 0.12.0

package/dist/blast/diff.js

@@ -0,0 +1,193 @@
+/**
+ * What a PR touched, read from git: changed files plus the *line ranges* inside
+ * them, which is what turns a diff into graph seeds (an enclosing-symbol lookup
+ * per changed line, see `blast.ts`).
+ *
+ * Git is shelled out to rather than parsed from a library because the CI job
+ * this feeds already has git — and `--unified=0` gives exactly the post-image
+ * line ranges we need, with no context lines to subtract back out.
+ */
+import { spawnSync } from "node:child_process";
+import { resolve } from "node:path";
+const HUNK_RE = /^@@ -\d+(?:,\d+)? \+(\d+)(?:,(\d+))? @@/;
+/** Text kept per hunk, and per file. A regenerated lockfile is one hunk of 40,000
+ * lines: the ranges still matter (they seed the graph), the text does not, and it
+ * would otherwise ride along in `--format json` and in every exported page. */
+const MAX_HUNK_LINES = 24;
+const MAX_FILE_LINES = 200;
+/** Run git in `root`, or return null when git fails (not a repo, unknown ref). */
+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;
+}
+/** True when `ref` names something git can resolve — checked before diffing so
+ * an unknown `--base` fails with a caller-facing message, not a git stack. */
+export function refExists(root, ref) {
+    return git(resolve(root), ["rev-parse", "--verify", "--quiet", `${ref}^{commit}`]) !== null;
+}
+/**
+ * The diff arguments for a base ref, and the label to show for it.
+ *
+ * `<base>...HEAD` (three dots) diffs against the MERGE BASE, not the tip of the
+ * base branch — the difference matters on every PR whose base branch moved after
+ * it was cut: two-dot would attribute other people's merges to this PR and
+ * inflate the blast radius with files the author never touched.
+ */
+function rangeArgs(base) {
+    return { args: [`${base}...HEAD`], basis: `${base}...HEAD` };
+}
+/**
+ * Changed files + post-image line ranges.
+ *
+ * With no `base` this reports the working tree against HEAD (the local
+ * "what am I about to push" case), falling back to the last commit when the
+ * tree is clean — so the command answers something useful when run by hand,
+ * and CI passes `--base` for the real PR range.
+ */
+export function changedFiles(root, base) {
+    const dir = resolve(root);
+    if (base !== undefined) {
+        const { args, basis } = rangeArgs(base);
+        const files = diffFiles(dir, args);
+        return files === null ? null : { basis, files };
+    }
+    const working = diffFiles(dir, ["HEAD"]);
+    if (working === null)
+        return null;
+    if (working.length > 0)
+        return { basis: "working tree vs HEAD", files: working };
+    const last = diffFiles(dir, ["HEAD~1...HEAD"]);
+    if (last === null)
+        return { basis: "working tree vs HEAD", files: [] };
+    return { basis: "HEAD~1...HEAD", files: last };
+}
+/** Both git passes for one range: name-status (statuses, renames) then hunks. */
+function diffFiles(dir, range) {
+    const status = git(dir, ["diff", "--name-status", "--find-renames", "-z", ...range, "--"]);
+    if (status === null)
+        return null;
+    const files = parseNameStatus(status);
+    if (files.length === 0)
+        return files;
+    const patch = git(dir, [
+        "diff",
+        "--unified=0",
+        "--no-color",
+        "--no-ext-diff",
+        "--find-renames",
+        ...range,
+        "--",
+    ]);
+    if (patch !== null)
+        applyHunks(files, patch);
+    return files;
+}
+/**
+ * `--name-status -z` output: NUL-separated fields, where a rename spends THREE
+ * fields (`R096`, old, new) and everything else spends two. Splitting on NUL and
+ * walking with a cursor is the only way to read it — a line-oriented parse
+ * silently pairs a rename's old path with the next file's status.
+ */
+function parseNameStatus(out) {
+    const fields = out.split("\0").filter((f) => f !== "");
+    const files = [];
+    for (let i = 0; i < fields.length;) {
+        const code = fields[i++];
+        if (code.startsWith("R") || code.startsWith("C")) {
+            const oldPath = fields[i++];
+            const path = fields[i++];
+            if (path === undefined)
+                break;
+            files.push({ path, status: "renamed", oldPath, ranges: [], hunks: [] });
+            continue;
+        }
+        const path = fields[i++];
+        if (path === undefined)
+            break;
+        if (code.startsWith("A"))
+            files.push({ path, status: "added", ranges: [], hunks: [] });
+        else if (code.startsWith("D"))
+            files.push({ path, status: "deleted", ranges: [], hunks: [] });
+        else
+            files.push({ path, status: "modified", ranges: [], hunks: [] });
+    }
+    return files;
+}
+/** Attach each hunk's post-image range — and its text — to its file. */
+function applyHunks(files, patch) {
+    const byPath = new Map(files.map((f) => [f.path, f]));
+    let current;
+    let hunk;
+    /** Post-image number for the next `+` line of the open hunk. */
+    let next = 0;
+    let kept = 0;
+    for (const line of patch.split("\n")) {
+        // Every file starts with this, and a content line cannot: a deleted one begins
+        // with `-`. Closing the open hunk here is what stops the NEXT file's `--- a/x`
+        // header being absorbed as a deleted line of the previous hunk.
+        if (line.startsWith("diff --git ")) {
+            current = undefined;
+            hunk = undefined;
+            continue;
+        }
+        if (line.startsWith("+++ ")) {
+            const raw = line.slice(4);
+            current = raw === "/dev/null" ? undefined : byPath.get(stripPrefix(raw));
+            hunk = undefined;
+            kept = 0;
+            continue;
+        }
+        if (line.startsWith("@@")) {
+            hunk = undefined;
+            if (!current)
+                continue;
+            const m = HUNK_RE.exec(line);
+            if (!m)
+                continue;
+            const start = Number(m[1]);
+            // `+N,0` is a pure deletion: nothing survives in the post-image, and git
+            // reports the line BEFORE the gap. Recording that single line is what keeps
+            // "the body of foo() lost 10 lines" attributable to foo() at all.
+            const count = m[2] === undefined ? 1 : Number(m[2]);
+            const range = count === 0 ? { start, end: start } : { start, end: start + count - 1 };
+            hunk = { ...range, lines: [], dropped: 0 };
+            current.ranges.push(range);
+            current.hunks.push(hunk);
+            next = start;
+            continue;
+        }
+        if (!hunk)
+            continue;
+        // With `--unified=0` every line inside a hunk is an edit, so there is no
+        // context to skip. `+++`/`---` headers are already consumed above; a bare
+        // `--- a/x` for the next file arrives before its `+++`, and the `!hunk`
+        // guard on a fresh file keeps it out.
+        if (line.startsWith("+")) {
+            pushLine(hunk, { n: next, sign: "+", text: line.slice(1) }, kept++ < MAX_FILE_LINES);
+            next += 1;
+        }
+        else if (line.startsWith("-")) {
+            pushLine(hunk, { n: null, sign: "-", text: line.slice(1) }, kept++ < MAX_FILE_LINES);
+        }
+    }
+}
+function pushLine(hunk, line, withinFile) {
+    if (!withinFile || hunk.lines.length >= MAX_HUNK_LINES) {
+        hunk.dropped += 1;
+        return;
+    }
+    hunk.lines.push(line);
+}
+/** `b/src/x.ts` → `src/x.ts`, minus any trailing tab-separated timestamp. */
+function stripPrefix(raw) {
+    const untabbed = raw.split("\t")[0];
+    return untabbed.startsWith("b/") ? untabbed.slice(2) : untabbed;
+}
+//# sourceMappingURL=diff.js.map

package/dist/blast/diff.js.map

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

package/dist/blast/modules.d.ts

@@ -0,0 +1,33 @@
+export interface ModuleIndex {
+    /** Label for a repo-relative path — a concept name when one claims the file. */
+    labelOf(path: string): string;
+    /** The claiming concept's name, or null when only the directory fallback applies.
+     * Callers that group files need to tell the two apart: a shared concept is a real
+     * grouping signal, a shared directory is only a shared directory. */
+    conceptOf(path: string): string | null;
+    /** True when at least one concept node was read (i.e. a --deep graph). */
+    hasConcepts: boolean;
+}
+/**
+ * Build the path → module-label lookup for a context dir.
+ *
+ * A file can be cited by several concepts; the SMALLEST claiming concept wins.
+ * A concept grounded in three files says something specific about those three,
+ * while a forty-file concept is closer to "the codebase" — picking the tighter
+ * one keeps the diagram's boxes meaningful.
+ */
+export declare function moduleIndex(contextDir: string): ModuleIndex;
+/**
+ * A concept name trimmed to fit a node.
+ *
+ * Concept names are written for a reader with the whole file in front of them, so
+ * they run long and some carry a `Concept: ` prefix from the synthesis prompt.
+ * "Reciprocal-Rank Fusion for Workspace Federation" is a fine node title in `graft
+ * viz` and unreadable inside a circle.
+ */
+export declare function shortLabel(label: string): string;
+/** The parent directory of a directory label, or "" at the top level. */
+export declare function parentDir(dir: string): string;
+/** Fallback label: the file's directory, or `(root)` for a top-level file. */
+export declare function dirLabel(path: string): string;
+//# sourceMappingURL=modules.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../src/blast/modules.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,WAAW;IAC1B,gFAAgF;IAChF,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B;;yEAEqE;IACrE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACvC,0EAA0E;IAC1E,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAiB3D;AAeD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWhD;AAED,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C"}

package/dist/blast/modules.js

@@ -0,0 +1,83 @@
+/**
+ * Module labels for the blast diagram — the "what part of the system is this?"
+ * layer, so a reviewer reads `Graph Extraction and Loading` instead of eleven
+ * file paths.
+ *
+ * Two sources, best first:
+ *   1. the deep tier's concept nodes (`graft/*.md`), whose frontmatter lists the
+ *      source files each concept was synthesized from. This is why `blast` is
+ *      worth running on a `build --deep` graph: the grouping is the product.
+ *   2. the file's directory, when no concept claims it (a breadth-tier graph, or
+ *      a file added by this very PR and therefore absent from the concept layer).
+ */
+import { readNodes } from "../context/node-file.js";
+/**
+ * Build the path → module-label lookup for a context dir.
+ *
+ * A file can be cited by several concepts; the SMALLEST claiming concept wins.
+ * A concept grounded in three files says something specific about those three,
+ * while a forty-file concept is closer to "the codebase" — picking the tighter
+ * one keeps the diagram's boxes meaningful.
+ */
+export function moduleIndex(contextDir) {
+    const claims = new Map();
+    const nodes = readNodes(contextDir);
+    for (const node of nodes) {
+        if (!node.name)
+            continue;
+        for (const src of node.sources) {
+            const prev = claims.get(src.path);
+            if (!prev || node.sources.length < prev.size) {
+                claims.set(src.path, { label: node.name, size: node.sources.length });
+            }
+        }
+    }
+    return {
+        hasConcepts: nodes.length > 0,
+        labelOf: (path) => shortLabel(claims.get(path)?.label ?? dirLabel(path)),
+        conceptOf: (path) => claims.get(path)?.label ?? null,
+    };
+}
+/** Longest label a circle can hold before the text overruns it. */
+const MAX_LABEL = 30;
+/**
+ * Clause breaks a long concept name can be cut at.
+ *
+ * A concept name is a sentence fragment, so it has real joints: everything after
+ * "via", "and", a colon or an opening parenthesis is elaboration. Cutting there
+ * leaves a phrase that still reads as a name — "Incremental Build" rather than
+ * "Incremental Build via…" — which is why these cuts take no ellipsis.
+ */
+const CLAUSE_BREAK = /\s(?:\(|—|-\s)|:\s|\s(?:via|and|for|with|using|in|across|over|from|of|by|to)\s/i;
+/**
+ * A concept name trimmed to fit a node.
+ *
+ * Concept names are written for a reader with the whole file in front of them, so
+ * they run long and some carry a `Concept: ` prefix from the synthesis prompt.
+ * "Reciprocal-Rank Fusion for Workspace Federation" is a fine node title in `graft
+ * viz` and unreadable inside a circle.
+ */
+export function shortLabel(label) {
+    const bare = label.replace(/^concepts?:\s*/i, "").trim();
+    if (bare.length <= MAX_LABEL)
+        return bare;
+    const at = CLAUSE_BREAK.exec(bare);
+    if (at && at.index >= 8 && at.index <= MAX_LABEL)
+        return bare.slice(0, at.index).trimEnd();
+    // No usable joint: a word-boundary cut, marked, because this one really does stop
+    // mid-phrase and a reader must not take the fragment for the whole name.
+    const cut = bare.lastIndexOf(" ", MAX_LABEL);
+    return `${bare.slice(0, cut > MAX_LABEL / 2 ? cut : MAX_LABEL).trimEnd()}…`;
+}
+/** The parent directory of a directory label, or "" at the top level. */
+export function parentDir(dir) {
+    const trimmed = dir.replace(/\/$/, "");
+    const cut = trimmed.lastIndexOf("/");
+    return cut === -1 ? "" : `${trimmed.slice(0, cut)}/`;
+}
+/** Fallback label: the file's directory, or `(root)` for a top-level file. */
+export function dirLabel(path) {
+    const cut = path.lastIndexOf("/");
+    return cut === -1 ? "(root)" : path.slice(0, cut) + "/";
+}
+//# sourceMappingURL=modules.js.map

package/dist/blast/modules.js.map

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

package/dist/blast/name.d.ts

@@ -0,0 +1,61 @@
+import type { ChatModel } from "../ai/llm/types.js";
+import type { GraphV1 } from "../graph/types.js";
+import type { BlastReport } from "./blast.js";
+/** One cluster to name: its identity, its files and the symbols inside it. */
+export interface Cluster {
+    key: string;
+    files: string[];
+    symbols: string[];
+}
+/** Anything that can turn clusters into names. A model in production, a stub in tests. */
+export interface Namer {
+    /** Names by cluster key. A key the namer chose not to name is simply absent. */
+    name(clusters: Cluster[]): Promise<Map<string, string>>;
+}
+export interface NameStats {
+    /** Labels taken from the cache, and labels that cost a call. */
+    cached: number;
+    named: number;
+    /** Clusters the namer declined ("mixed") or could not answer for. */
+    declined: number;
+    /** Set when naming was attempted and failed outright; the reason, for one line
+     * in the report. Never thrown: a comment without names still beats no comment. */
+    error?: string;
+}
+/** The production namer: one forced-tool call for every cluster at once. */
+export declare class ChatNamer implements Namer {
+    private readonly model;
+    constructor(model: ChatModel);
+    name(clusters: Cluster[]): Promise<Map<string, string>>;
+}
+/**
+ * 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 declare function sanitize(raw: string): string;
+/**
+ * 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 declare function clusterHash(files: string[], hashes: Map<string, string>): string;
+export declare function loadNameCache(contextDir: string): Record<string, string>;
+export declare function saveNameCache(contextDir: string, names: Record<string, string>): void;
+/**
+ * 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 declare function applyNames(graph: GraphV1, report: BlastReport, opts: {
+    namer?: Namer;
+    contextDir: string;
+}): Promise<NameStats>;
+//# sourceMappingURL=name.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"name.d.ts","sourceRoot":"","sources":["../../src/blast/name.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAA+B,MAAM,YAAY,CAAC;AAG3E,8EAA8E;AAC9E,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,0FAA0F;AAC1F,MAAM,WAAW,KAAK;IACpB,gFAAgF;IAChF,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,SAAS;IACxB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB;sFACkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqDD,4EAA4E;AAC5E,qBAAa,SAAU,YAAW,KAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,SAAS;IAEvC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAuB9D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAGhF;AAMD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxE;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAQrF;AAeD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,SAAS,CAAC,CAwDpB"}

package/dist/blast/name.js

@@ -0,0 +1,233 @@
+/**
+ * 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;
+}
+//# 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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"}