ctxr-cli 0.23.0 → 0.24.0

package/dist/core/graph/diff-block.js

@@ -0,0 +1,54 @@
+import { packagedTemplate, substituteBlock } from '../templates.js';
+import { isEmptyDelta } from './diff.js';
+/**
+ * review-the-knowledge-diff (D9): the **Knowledge changes** block a pull
+ * request body carries verbatim, written by the command so the party under
+ * review writes none of it. It names both commits in full and the command
+ * that reproduces it, gives every kind as a count, and lists in full the two
+ * kinds most likely to be silent losses: introduced dangling links and
+ * archived notes. It carries no diagram and no judgment the delta does not
+ * make.
+ *
+ * Every fixed sentence lives in `templates/graph/knowledge-changes/`; this
+ * module fills in values only.
+ */
+function template(name) {
+    return packagedTemplate('graph/knowledge-changes', name);
+}
+const REASON_TEXT = { not_found: 'not found', ambiguous: 'ambiguous' };
+function code(text) {
+    const longest = Math.max(0, ...[...text.matchAll(/`+/g)].map((match) => match[0].length));
+    const fence = '`'.repeat(longest + 1);
+    return `${fence}${text.startsWith('`') || text.endsWith('`') ? ` ${text} ` : text}${fence}`;
+}
+function bodyLines(delta) {
+    if (isEmptyDelta(delta))
+        return template('empty').split('\n');
+    const counts = Object.entries(delta.counts).reduce((text, [key, count]) => text.replaceAll(`__${key.toUpperCase()}__`, String(count)), template('counts'));
+    const lines = counts.split('\n');
+    if (delta.dangling.introduced.length > 0) {
+        lines.push('', ...template('dangling').split('\n'), '');
+        for (const d of delta.dangling.introduced)
+            lines.push(`- ${code(d.from)} → ${code(d.target)} (${REASON_TEXT[d.reason] ?? d.reason})`);
+    }
+    if (delta.notes.archived.length > 0) {
+        lines.push('', ...template('archived').split('\n'), '');
+        for (const r of delta.notes.archived)
+            lines.push(`- ${code(r.from)} → ${code(r.to)}`);
+    }
+    return lines;
+}
+/** The review address with its reachability line, and the bare-route line when no base URL is declared; empty without an address. */
+export function reviewLines(review) {
+    if (review === null)
+        return [];
+    const text = template('review').replace('__ADDRESS__', () => review.url ?? review.route);
+    return ['', ...substituteBlock(text, '__BARE_ROUTE__', review.url === null ? template('bare-route').split('\n') : []).split('\n')];
+}
+export function renderKnowledgeChangesBlock(delta, review) {
+    let text = template('block').replaceAll('__BASE__', delta.base).replaceAll('__HEAD__', delta.head);
+    text = substituteBlock(text, '__BODY__', bodyLines(delta));
+    text = substituteBlock(text, '__REVIEW__', reviewLines(review));
+    return `${text}\n`;
+}
+//# sourceMappingURL=diff-block.js.map

package/dist/core/graph/diff-block.js.map

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

package/dist/core/graph/diff-document.d.ts

@@ -0,0 +1,37 @@
+import { type GraphEdge } from './model.js';
+import { type GraphDelta } from './diff.js';
+/**
+ * review-the-knowledge-diff (D5): one render of a delta, used by the command's
+ * human summary and by the review view — one derivation, two renders, the
+ * same pattern as `graph.json` / `graph.md`. It carries only what the delta
+ * carries: paths, link targets, edge types, counts and source entries, never a
+ * note body, and no text an agent wrote about the change.
+ *
+ * The document is a list of parts rather than one string because the review
+ * view renders markdown with `html: false`: a `<details>` group is emitted by
+ * the caller around its rendered markdown, not parsed out of it. `toMarkdown`
+ * joins the parts with literal `<details>` tags for a markdown reader.
+ */
+export type DiffDocumentPart = {
+    kind: 'markdown';
+    text: string;
+} | {
+    kind: 'details';
+    summary: string;
+    text: string;
+};
+export interface DiffDocumentOptions {
+    /** The href for a path the caller can serve, or null to leave it as text. Absent: no path is linked. */
+    linkFor?: (notePath: string) => string | null;
+    /** Append the link-delta diagram (D8). The human summary omits it. */
+    diagram?: boolean;
+}
+/** D8: past this many changed links the diagram is replaced by one line, so it never becomes unreadable. */
+export declare const MAX_DIAGRAM_EDGES = 50;
+/** D8: added links solid, removed links dashed, nodes labelled by stem; edge types label a typed link. */
+export declare function renderDiagram(added: readonly GraphEdge[], removed: readonly GraphEdge[]): string | null;
+export declare function renderDiffParts(delta: GraphDelta, options?: DiffDocumentOptions): DiffDocumentPart[];
+/** The parts as one markdown document, `<details>` groups written as literal tags. */
+export declare function toMarkdown(parts: readonly DiffDocumentPart[]): string;
+export declare function renderDiffDocument(delta: GraphDelta, options?: DiffDocumentOptions): string;
+//# sourceMappingURL=diff-document.d.ts.map

package/dist/core/graph/diff-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-document.d.ts","sourceRoot":"","sources":["../../../src/core/graph/diff-document.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvH,MAAM,WAAW,mBAAmB;IAClC,wGAAwG;IACxG,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC9C,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,4GAA4G;AAC5G,eAAO,MAAM,iBAAiB,KAAK,CAAC;AA8BpC,0GAA0G;AAC1G,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,GAAG,IAAI,CAsBvG;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,mBAAwB,GAAG,gBAAgB,EAAE,CAuExG;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,CAMrE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAE/F"}

package/dist/core/graph/diff-document.js

@@ -0,0 +1,119 @@
+import path from 'node:path';
+import { LINK_EDGE_TYPE } from './model.js';
+import { isEmptyDelta } from './diff.js';
+/** D8: past this many changed links the diagram is replaced by one line, so it never becomes unreadable. */
+export const MAX_DIAGRAM_EDGES = 50;
+/** A code span that survives any backtick run in the text, with table pipes escaped. */
+function code(text) {
+    const longest = Math.max(0, ...[...text.matchAll(/`+/g)].map((match) => match[0].length));
+    const fence = '`'.repeat(longest + 1);
+    const padded = text.startsWith('`') || text.endsWith('`') ? ` ${text} ` : text;
+    return `${fence}${padded.replace(/\|/g, '\\|')}${fence}`;
+}
+function pathCell(notePath, options) {
+    const href = options.linkFor?.(notePath) ?? null;
+    return href === null ? code(notePath) : `[${code(notePath)}](${href})`;
+}
+function table(header, rows) {
+    return [`| ${header.join(' | ')} |`, `|${header.map(() => '---').join('|')}|`, ...rows.map((row) => `| ${row.join(' | ')} |`)].join('\n');
+}
+const REASON_TEXT = { not_found: 'not found', ambiguous: 'ambiguous' };
+function stemOf(notePath) {
+    return path.posix.basename(notePath, '.md');
+}
+/** Mermaid's entity form, so a label's quotes, brackets and pipes cannot end the label early. */
+function mermaidLabel(text) {
+    return text.replace(/[#"<>|[\]{}()]/g, (ch) => `#${ch.charCodeAt(0)};`);
+}
+/** D8: added links solid, removed links dashed, nodes labelled by stem; edge types label a typed link. */
+export function renderDiagram(added, removed) {
+    const changed = added.length + removed.length;
+    if (changed === 0)
+        return null;
+    if (changed > MAX_DIAGRAM_EDGES) {
+        return `The link delta has ${changed} changed links, more than the diagram draws (${MAX_DIAGRAM_EDGES}); the tables above list every one.`;
+    }
+    const ids = new Map();
+    for (const edge of [...added, ...removed]) {
+        for (const notePath of [edge.src, edge.dst])
+            if (!ids.has(notePath))
+                ids.set(notePath, `n${ids.size}`);
+    }
+    const arrow = (edge, solid) => {
+        const label = edge.type === LINK_EDGE_TYPE ? '' : `|${mermaidLabel(edge.type)}|`;
+        return `  ${ids.get(edge.src)} ${solid ? '-->' : '-.->'}${label} ${ids.get(edge.dst)}`;
+    };
+    return [
+        '```mermaid',
+        'flowchart LR',
+        ...[...ids].map(([notePath, id]) => `  ${id}["${mermaidLabel(stemOf(notePath))}"]`),
+        ...added.map((edge) => arrow(edge, true)),
+        ...removed.map((edge) => arrow(edge, false)),
+        '```',
+    ].join('\n');
+}
+export function renderDiffParts(delta, options = {}) {
+    const cell = (notePath) => pathCell(notePath, options);
+    const parts = [
+        {
+            kind: 'markdown',
+            text: ['# Knowledge changes', '', `- Base commit: ${code(delta.base)}`, `- Head commit: ${code(delta.head)}`].join('\n'),
+        },
+    ];
+    if (isEmptyDelta(delta)) {
+        parts.push({ kind: 'markdown', text: 'No knowledge changes: this range changes no note.' });
+        return parts;
+    }
+    const c = delta.counts;
+    parts.push({
+        kind: 'markdown',
+        text: table(['Kind', 'Count'], [
+            ['Notes added', String(c.notes_added)],
+            ['Notes removed', String(c.notes_removed)],
+            ['Notes modified', String(c.notes_modified)],
+            ['Notes moved', String(c.notes_moved)],
+            ['Notes archived', String(c.notes_archived)],
+            ['Links added', String(c.links_added)],
+            ['Links removed', String(c.links_removed)],
+            ['Dangling links introduced', String(c.dangling_introduced)],
+            ['Dangling links resolved', String(c.dangling_resolved)],
+            ['Notes whose inbound links changed', String(c.inbound_changed)],
+            ['Rollups touched', String(c.rollups_touched)],
+            ['Notes citing new sources', String(c.sources_cited)],
+        ]),
+    });
+    const group = (summary, count, text) => {
+        if (count > 0)
+            parts.push({ kind: 'details', summary: `${summary} (${count})`, text });
+    };
+    const edgeRows = (edges) => edges.map((e) => [cell(e.src), cell(e.dst), code(e.type)]);
+    const danglingRows = (links) => links.map((d) => [cell(d.from), code(d.target), REASON_TEXT[d.reason] ?? d.reason]);
+    group('Notes added', c.notes_added, table(['Note'], delta.notes.added.map((p) => [cell(p)])));
+    group('Notes removed', c.notes_removed, table(['Note'], delta.notes.removed.map((p) => [code(p)])));
+    group('Notes modified', c.notes_modified, table(['Note'], delta.notes.modified.map((p) => [cell(p)])));
+    group('Notes moved', c.notes_moved, table(['From', 'To'], delta.notes.moved.map((r) => [code(r.from), cell(r.to)])));
+    group('Notes archived', c.notes_archived, table(['From', 'To'], delta.notes.archived.map((r) => [code(r.from), cell(r.to)])));
+    group('Links added', c.links_added, table(['From', 'To', 'Type'], edgeRows(delta.links.added)));
+    group('Links removed', c.links_removed, table(['From', 'To', 'Type'], edgeRows(delta.links.removed)));
+    group('Dangling links introduced', c.dangling_introduced, table(['From', 'Target', 'Reason'], danglingRows(delta.dangling.introduced)));
+    group('Dangling links resolved', c.dangling_resolved, table(['From', 'Target', 'Reason'], danglingRows(delta.dangling.resolved)));
+    group('Notes whose inbound links changed', c.inbound_changed, table(['Note', 'Gained from', 'Lost from', 'Has rollup'], delta.inbound.map((i) => [cell(i.path), i.gained.map(code).join(', '), i.lost.map(code).join(', '), i.rollup ? 'yes' : 'no'])));
+    group('Rollups touched', c.rollups_touched, table(['Note', 'Region'], delta.rollups.map((r) => [cell(r.path), r.change])));
+    group('Sources newly cited', c.sources_cited, table(['Note', 'Sources'], delta.sources.map((s) => [cell(s.path), s.cited.map(code).join(', ')])));
+    if (options.diagram) {
+        const diagram = renderDiagram(delta.links.added, delta.links.removed);
+        if (diagram !== null)
+            parts.push({ kind: 'markdown', text: ['## Link delta', '', diagram].join('\n') });
+    }
+    return parts;
+}
+/** The parts as one markdown document, `<details>` groups written as literal tags. */
+export function toMarkdown(parts) {
+    return parts
+        .map((part) => part.kind === 'markdown' ? part.text : ['<details>', `<summary>${part.summary}</summary>`, '', part.text, '', '</details>'].join('\n'))
+        .join('\n\n');
+}
+export function renderDiffDocument(delta, options = {}) {
+    return `${toMarkdown(renderDiffParts(delta, options))}\n`;
+}
+//# sourceMappingURL=diff-document.js.map

package/dist/core/graph/diff-document.js.map

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

package/dist/core/graph/diff.d.ts

@@ -0,0 +1,123 @@
+import type { StoreConfig } from '../../config/schema.js';
+import type { GitRunner } from '../git/exec.js';
+import { type DanglingLink, type GraphBuildResult, type GraphEdge } from './model.js';
+import { type CommitNote } from './tree.js';
+/**
+ * review-the-knowledge-diff: how the store's knowledge changed between two
+ * commits — facts only, with no severity, score or ranking (D10). Every list
+ * is sorted by path and then by its remaining fields, and nothing here reads
+ * the clock, so the same two commits and configuration give the same value.
+ */
+export interface NoteRename {
+    from: string;
+    to: string;
+}
+export interface InboundChange {
+    path: string;
+    gained: string[];
+    lost: string[];
+    /** Whether the note carries a rollup region on the head side. */
+    rollup: boolean;
+}
+export type RollupChange = 'added' | 'removed' | 'changed';
+export interface RollupTouched {
+    path: string;
+    change: RollupChange;
+}
+export interface SourcesCited {
+    path: string;
+    cited: string[];
+}
+export interface GraphDeltaCounts {
+    notes_added: number;
+    notes_removed: number;
+    notes_modified: number;
+    notes_moved: number;
+    notes_archived: number;
+    links_added: number;
+    links_removed: number;
+    dangling_introduced: number;
+    dangling_resolved: number;
+    inbound_changed: number;
+    rollups_touched: number;
+    sources_cited: number;
+}
+export interface GraphDelta {
+    /** The full id of the base commit: the merge base of `--since` and the head. */
+    base: string;
+    /** The full id of the head commit. */
+    head: string;
+    counts: GraphDeltaCounts;
+    notes: {
+        added: string[];
+        removed: string[];
+        modified: string[];
+        moved: NoteRename[];
+        archived: NoteRename[];
+    };
+    links: {
+        added: GraphEdge[];
+        removed: GraphEdge[];
+    };
+    dangling: {
+        introduced: DanglingLink[];
+        resolved: DanglingLink[];
+    };
+    inbound: InboundChange[];
+    rollups: RollupTouched[];
+    sources: SourcesCited[];
+}
+/** One side of the comparison: a commit, the notes it holds, and the graph built from them. */
+export interface GraphSide {
+    commit: string;
+    notes: readonly CommitNote[];
+    graph: GraphBuildResult;
+}
+/** A rename git's rename detection reported between the two commits, store-relative. */
+export type RenameTable = readonly NoteRename[];
+export declare function isEmptyDelta(delta: GraphDelta): boolean;
+/**
+ * review-the-knowledge-diff (D3): the delta between two built sides. Every
+ * base-side path is carried through the moves and archives first, so a note
+ * that moved with its links still resolving reports no link change, and edges
+ * compare as distinct `(src, dst, type)` triples, so a link written twice
+ * counts once.
+ *
+ * A rename into `organize.archive_destination` from outside it is an archive,
+ * whether or not the destination is admitted; any other rename between two
+ * admitted paths is a move. A rename that leaves the admitted set is a removal
+ * and one that enters it is an addition, which is what each side shows.
+ */
+export declare function diffGraphs(base: GraphSide, head: GraphSide, renames: RenameTable, config: StoreConfig): GraphDelta;
+/** The full id of the commit `ref` names, or the error naming it. */
+export declare function resolveCommit(git: GitRunner, cwd: string, ref: string, flag: '--since' | '--until'): Promise<string>;
+/**
+ * review-the-knowledge-diff (D1): the head is `until` (HEAD when absent) and
+ * the base is the merge base of `since` and the head — the `<ref>...HEAD`
+ * meaning `publish urls --since` uses, so both pull-request sections describe
+ * one change set. A base id and a head id that descends from it resolve back
+ * to themselves, which is what makes the reported range re-runnable.
+ */
+export declare function resolveRange(git: GitRunner, cwd: string, since: string, until: string | undefined): Promise<{
+    base: string;
+    head: string;
+}>;
+/**
+ * review-the-knowledge-diff (D3): git's renames between the two commits, with
+ * every knob that could change them pinned on the command line, so a user's
+ * `diff.renames`, `diff.renameLimit`, external diff driver or textconv filter
+ * cannot change the report. `--relative` makes the paths store-relative for a
+ * store rooted below the repository's top level.
+ */
+export declare function readRenames(git: GitRunner, storeRoot: string, base: string, head: string): Promise<NoteRename[]>;
+/**
+ * Both sides read from git's object store under the CURRENT configuration
+ * (D2), so a path that configuration excludes appears on neither side. No
+ * checkout, no stash, and nothing written — the per-checkout graph artifact is
+ * neither read nor rebuilt.
+ */
+export declare function computeGraphDelta(git: GitRunner, storeRoot: string, range: {
+    base: string;
+    head: string;
+}, config: StoreConfig): Promise<GraphDelta>;
+//# sourceMappingURL=diff.d.ts.map

package/dist/core/graph/diff.d.ts.map

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

package/dist/core/graph/diff.js

@@ -0,0 +1,253 @@
+import { GraphDiffNoMergeBaseError, GraphDiffRefNotFoundError } from '../errors.js';
+import { isStrictlyUnderPrefix, isUnderPrefix } from '../fs/prefix.js';
+import { readFencedRegion } from '../fs/fenced-region.js';
+import { SOURCES_FIELD } from '../ingest/identity.js';
+import { hasRollupSection, ROLLUP_FENCE } from '../rollup.js';
+import { buildGraphFromNotes, graphBuildOptions } from './model.js';
+import { listNotesAtCommit } from './tree.js';
+export function isEmptyDelta(delta) {
+    return Object.values(delta.counts).every((count) => count === 0);
+}
+function compareStrings(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+function compareTuples(a, b) {
+    for (let i = 0; i < Math.min(a.length, b.length); i++) {
+        const order = compareStrings(a[i], b[i]);
+        if (order !== 0)
+            return order;
+    }
+    return a.length - b.length;
+}
+function sortBy(items, key) {
+    return items.sort((a, b) => compareTuples(key(a), key(b)));
+}
+const edgeKey = (edge) => [edge.src, edge.dst, edge.type].join('\0');
+const danglingKey = (link) => [link.from, link.target, link.reason].join('\0');
+/** The rollup region's text, or null when the note has none. A malformed fence reads as its whole body, so any edit to it still shows. */
+function rollupRegion(note) {
+    if (note === undefined || !hasRollupSection(note))
+        return null;
+    try {
+        return readFencedRegion(note.body, ROLLUP_FENCE).join('\n');
+    }
+    catch {
+        return note.body;
+    }
+}
+/** The provenance field's entries; a lone string is one entry, anything else none. */
+function sourcesOf(note) {
+    const value = note?.frontmatter?.[SOURCES_FIELD];
+    if (Array.isArray(value))
+        return value.map((entry) => String(entry));
+    if (typeof value === 'string')
+        return [value];
+    return [];
+}
+function inboundOf(edges) {
+    const inbound = new Map();
+    for (const edge of edges) {
+        const sources = inbound.get(edge.dst) ?? new Set();
+        sources.add(edge.src);
+        inbound.set(edge.dst, sources);
+    }
+    return inbound;
+}
+/**
+ * review-the-knowledge-diff (D3): the delta between two built sides. Every
+ * base-side path is carried through the moves and archives first, so a note
+ * that moved with its links still resolving reports no link change, and edges
+ * compare as distinct `(src, dst, type)` triples, so a link written twice
+ * counts once.
+ *
+ * A rename into `organize.archive_destination` from outside it is an archive,
+ * whether or not the destination is admitted; any other rename between two
+ * admitted paths is a move. A rename that leaves the admitted set is a removal
+ * and one that enters it is an addition, which is what each side shows.
+ */
+export function diffGraphs(base, head, renames, config) {
+    const baseNotes = new Map(base.notes.map((note) => [note.path, note]));
+    const headNotes = new Map(head.notes.map((note) => [note.path, note]));
+    const destination = config.organize.archive_destination;
+    const moved = [];
+    const archived = [];
+    for (const rename of renames) {
+        if (!baseNotes.has(rename.from))
+            continue;
+        if (isStrictlyUnderPrefix(rename.to, destination) && !isUnderPrefix(rename.from, destination))
+            archived.push(rename);
+        else if (headNotes.has(rename.to))
+            moved.push(rename);
+    }
+    const forward = new Map([...moved, ...archived].map((rename) => [rename.from, rename.to]));
+    const backward = new Map([...moved, ...archived].map((rename) => [rename.to, rename.from]));
+    const mapPath = (basePath) => forward.get(basePath) ?? basePath;
+    const baseOf = (headPath) => baseNotes.get(backward.get(headPath) ?? headPath);
+    const mappedBasePaths = new Set(base.notes.map((note) => mapPath(note.path)));
+    const added = head.notes.map((note) => note.path).filter((notePath) => !mappedBasePaths.has(notePath));
+    const removed = base.notes
+        .map((note) => note.path)
+        .filter((notePath) => !forward.has(notePath) && !headNotes.has(notePath));
+    const modified = head.notes
+        .filter((note) => mappedBasePaths.has(note.path) && baseOf(note.path).blob !== note.blob)
+        .map((note) => note.path);
+    const baseEdges = new Map();
+    for (const edge of base.graph.edges) {
+        const mapped = { src: mapPath(edge.src), dst: mapPath(edge.dst), type: edge.type };
+        baseEdges.set(edgeKey(mapped), mapped);
+    }
+    const headEdges = new Map(head.graph.edges.map((edge) => [edgeKey(edge), { ...edge }]));
+    const linksAdded = [...headEdges].filter(([key]) => !baseEdges.has(key)).map(([, edge]) => edge);
+    const linksRemoved = [...baseEdges].filter(([key]) => !headEdges.has(key)).map(([, edge]) => edge);
+    const baseDangling = new Map(base.graph.dangling.map((link) => {
+        const mapped = { ...link, from: mapPath(link.from) };
+        return [danglingKey(mapped), mapped];
+    }));
+    const headDangling = new Map(head.graph.dangling.map((link) => [danglingKey(link), { ...link }]));
+    const introduced = [...headDangling].filter(([key]) => !baseDangling.has(key)).map(([, link]) => link);
+    // A dangling link that left with its note was removed, not resolved: only a source still present can resolve one.
+    const resolved = [...baseDangling]
+        .filter(([key, link]) => !headDangling.has(key) && headNotes.has(link.from))
+        .map(([, link]) => link);
+    const baseInbound = inboundOf(baseEdges.values());
+    const headInbound = inboundOf(headEdges.values());
+    const inbound = [];
+    for (const target of new Set([...baseInbound.keys(), ...headInbound.keys()])) {
+        const before = baseInbound.get(target) ?? new Set();
+        const after = headInbound.get(target) ?? new Set();
+        const gained = [...after].filter((source) => !before.has(source)).sort(compareStrings);
+        const lost = [...before].filter((source) => !after.has(source)).sort(compareStrings);
+        if (gained.length === 0 && lost.length === 0)
+            continue;
+        const headNote = headNotes.get(target);
+        inbound.push({ path: target, gained, lost, rollup: headNote !== undefined && hasRollupSection(headNote) });
+    }
+    const rollups = [];
+    for (const note of head.notes) {
+        const before = rollupRegion(baseOf(note.path));
+        const after = rollupRegion(note);
+        if (before === after)
+            continue;
+        rollups.push({ path: note.path, change: before === null ? 'added' : after === null ? 'removed' : 'changed' });
+    }
+    for (const note of base.notes) {
+        if (headNotes.has(mapPath(note.path)) || rollupRegion(note) === null)
+            continue;
+        rollups.push({ path: note.path, change: 'removed' });
+    }
+    const sources = [];
+    for (const notePath of [...added, ...modified]) {
+        const before = new Set(sourcesOf(baseOf(notePath)));
+        const cited = [...new Set(sourcesOf(headNotes.get(notePath)))].filter((entry) => !before.has(entry)).sort(compareStrings);
+        if (cited.length > 0)
+            sources.push({ path: notePath, cited });
+    }
+    const delta = {
+        base: base.commit,
+        head: head.commit,
+        counts: {
+            notes_added: added.length,
+            notes_removed: removed.length,
+            notes_modified: modified.length,
+            notes_moved: moved.length,
+            notes_archived: archived.length,
+            links_added: linksAdded.length,
+            links_removed: linksRemoved.length,
+            dangling_introduced: introduced.length,
+            dangling_resolved: resolved.length,
+            inbound_changed: inbound.length,
+            rollups_touched: rollups.length,
+            sources_cited: sources.length,
+        },
+        notes: {
+            added: added.sort(compareStrings),
+            removed: removed.sort(compareStrings),
+            modified: modified.sort(compareStrings),
+            moved: sortBy(moved, (r) => [r.from, r.to]),
+            archived: sortBy(archived, (r) => [r.from, r.to]),
+        },
+        links: {
+            added: sortBy(linksAdded, (e) => [e.src, e.dst, e.type]),
+            removed: sortBy(linksRemoved, (e) => [e.src, e.dst, e.type]),
+        },
+        dangling: {
+            introduced: sortBy(introduced, (d) => [d.from, d.target, d.reason]),
+            resolved: sortBy(resolved, (d) => [d.from, d.target, d.reason]),
+        },
+        inbound: sortBy(inbound, (i) => [i.path]),
+        rollups: sortBy(rollups, (r) => [r.path, r.change]),
+        sources: sortBy(sources, (s) => [s.path]),
+    };
+    return delta;
+}
+/** The full id of the commit `ref` names, or the error naming it. */
+export async function resolveCommit(git, cwd, ref, flag) {
+    const result = await git.run(['rev-parse', '--verify', '--quiet', '--end-of-options', `${ref}^{commit}`], { cwd, allowFailure: true });
+    if (result.exitCode !== 0)
+        throw new GraphDiffRefNotFoundError(flag, ref);
+    return result.stdout.trim();
+}
+/**
+ * review-the-knowledge-diff (D1): the head is `until` (HEAD when absent) and
+ * the base is the merge base of `since` and the head — the `<ref>...HEAD`
+ * meaning `publish urls --since` uses, so both pull-request sections describe
+ * one change set. A base id and a head id that descends from it resolve back
+ * to themselves, which is what makes the reported range re-runnable.
+ */
+export async function resolveRange(git, cwd, since, until) {
+    const sinceCommit = await resolveCommit(git, cwd, since, '--since');
+    const head = await resolveCommit(git, cwd, until ?? 'HEAD', '--until');
+    const result = await git.run(['merge-base', sinceCommit, head], { cwd, allowFailure: true });
+    if (result.exitCode !== 0)
+        throw new GraphDiffNoMergeBaseError(since, until ?? 'HEAD');
+    return { base: result.stdout.trim(), head };
+}
+/**
+ * review-the-knowledge-diff (D3): git's renames between the two commits, with
+ * every knob that could change them pinned on the command line, so a user's
+ * `diff.renames`, `diff.renameLimit`, external diff driver or textconv filter
+ * cannot change the report. `--relative` makes the paths store-relative for a
+ * store rooted below the repository's top level.
+ */
+export async function readRenames(git, storeRoot, base, head) {
+    const { stdout } = await git.run([
+        '-c', 'diff.renameLimit=0',
+        '-c', 'diff.renames=true',
+        'diff', '--name-status', '-z', '--relative', '-M50%', '--no-ext-diff', '--no-textconv',
+        base, head, '--',
+    ], { cwd: storeRoot });
+    const fields = stdout.split('\0');
+    const renames = [];
+    for (let i = 0; i < fields.length; i++) {
+        const code = fields[i];
+        if (code === '')
+            continue;
+        if (code.startsWith('R') || code.startsWith('C')) {
+            if (code.startsWith('R'))
+                renames.push({ from: fields[i + 1], to: fields[i + 2] });
+            i += 2;
+            continue;
+        }
+        i += 1;
+    }
+    return renames;
+}
+async function readSide(git, storeRoot, commit, config) {
+    const notes = await listNotesAtCommit(git, storeRoot, commit, config);
+    return { commit, notes, graph: buildGraphFromNotes(notes, graphBuildOptions(config)) };
+}
+/**
+ * Both sides read from git's object store under the CURRENT configuration
+ * (D2), so a path that configuration excludes appears on neither side. No
+ * checkout, no stash, and nothing written — the per-checkout graph artifact is
+ * neither read nor rebuilt.
+ */
+export async function computeGraphDelta(git, storeRoot, range, config) {
+    const [base, head, renames] = await Promise.all([
+        readSide(git, storeRoot, range.base, config),
+        readSide(git, storeRoot, range.head, config),
+        readRenames(git, storeRoot, range.base, range.head),
+    ]);
+    return diffGraphs(base, head, renames, config);
+}
+//# sourceMappingURL=diff.js.map