@descent-vtt/spec-guard 0.11.0 → 0.12.0

package/dist/cites.js

@@ -0,0 +1,599 @@
+/**
+ * `spec-guard cites`: the specs a codebase's comments cite, and whether each is
+ * still there and still in force. ADR-0017.
+ *
+ * A comment such as `// ADR-0011: the domain imports no infrastructure` is a
+ * claim about the codebase: that a decision exists, and governs this code.
+ * When the document is gone, or superseded, the comment sends the next reader
+ * to a decision that is not the one in force, and nothing notices - spec-graph
+ * reads only Markdown, and a run only the directives. This reads the other
+ * side: comment text, as ADR-0006's classifier finds it, for ids a project
+ * names.
+ *
+ * An id is found by a small scanner, never by a regular expression built from
+ * the template a project wrote: its literal text, a run of digits, and a word
+ * boundary on each side. The digits are a number, so `ADR-7`, `ADR-007` and a
+ * file called `0007-x.md` are one document.
+ */
+import path from 'node:path';
+import { lexRanges, syntaxFor } from './comments.js';
+import { comparePaths, MAX_CONCURRENT_READS, withinSizeLimit } from './engine.js';
+import { createExcludeMatcher, createPathMatcher, globBase, isGlob, pathPatternError, toPosix, walkPaths } from './glob.js';
+import { nodeIo } from './io.js';
+import { INACTIVE_STATUSES, parseStatus, parseTitle } from './parser.js';
+import { createScope, isBinary } from './scope.js';
+import { readSpecs } from './specs.js';
+import { lineStarts, locate } from './text.js';
+/* ---------------------------------------------------------------- templates */
+/** Where the number goes, in an id template and in a file name. */
+export const NUMBER = '{n}';
+// A letter or digit in any script, or an underscore: what a word boundary
+// separates. Fixed here, and never built from anything a project wrote.
+const WORD = /^[\p{L}\p{N}_]$/u;
+// Both are asked about the character past either end of a text too, which is
+// undefined, and neither takes it for a digit or a letter, so there is no end
+// of the text to test for first: `test` reads it as the word "undefined",
+// which no pattern of one character matches.
+function isDigit(char) {
+    // Compared as strings, so undefined is no digit either.
+    return char >= '0' && char <= '9';
+}
+function isWord(char) {
+    return WORD.test(char);
+}
+/** How many times `{n}` occurs in a template. */
+function numbers(template) {
+    return template.split(NUMBER).length - 1;
+}
+/**
+ * Why an id template cannot be used, or null.
+ *
+ * The text around `{n}` is literal, and it has to be there: `{n}` alone would
+ * make every number in every comment a citation. It may not be a digit where
+ * it meets the number, or the two would run together - `A1{n}` would never
+ * know where `A1` ended.
+ */
+export function citeIdError(template) {
+    const count = numbers(template);
+    if (count !== 1) {
+        return count === 0
+            ? `"${template}" has no ${NUMBER}: an id template says where the number goes, as in ADR-${NUMBER}`
+            : `"${template}" has ${NUMBER} more than once, and an id holds one number`;
+    }
+    const [prefix, suffix] = template.split(NUMBER);
+    if (/[{}]/.test(prefix + suffix))
+        return `"${template}" holds a brace other than ${NUMBER}, and the rest of an id is literal`;
+    if (prefix.trim() === '')
+        return `"${template}" has nothing before ${NUMBER}, so every number in every comment would be a citation`;
+    if (isDigit(prefix[prefix.length - 1]) || isDigit(suffix[0])) {
+        return `"${template}" has a digit beside ${NUMBER}, where it would run into the number`;
+    }
+    return null;
+}
+/** An id template, read. Only ever given one `citeIdError` accepted. */
+export function parseIdTemplate(template) {
+    const [prefix, suffix] = template.split(NUMBER);
+    return { prefix, suffix };
+}
+/**
+ * Why a files template cannot be used, or null.
+ *
+ * The number is read from a document's file name, so `{n}` has to be in the
+ * last segment, and what comes before it there has to be literal: that is
+ * what says where in `0007-ledger.md` or `rfc-12.md` the number starts.
+ */
+export function citeFilesError(template) {
+    const count = numbers(template);
+    if (count !== 1) {
+        return count === 0
+            ? `"${template}" has no ${NUMBER}: a files template says where the number is, as in docs/adr/${NUMBER}-*.md`
+            : `"${template}" has ${NUMBER} more than once, and a file name holds one number`;
+    }
+    const posix = toPosix(template);
+    const name = posix.slice(posix.lastIndexOf('/') + 1);
+    if (!name.includes(NUMBER))
+        return `"${template}" has ${NUMBER} in a directory, and the number is read from the file name`;
+    const [before, after] = name.split(NUMBER);
+    if (isGlob(before))
+        return `"${template}" has glob syntax before ${NUMBER} in the file name, which has to be literal to say where the number starts`;
+    if (isDigit(before[before.length - 1]) || isDigit(after[0])) {
+        return `"${template}" has a digit beside ${NUMBER}, where it would run into the number`;
+    }
+    const error = pathPatternError(numberGlob(posix));
+    return error === null ? null : `"${template}": ${error}`;
+}
+/**
+ * A template with its number read as `*`.
+ *
+ * A `*` just after `{n}` is taken in, since digits and then anything is
+ * anything: `{n}*.md`, the shape `deriveFamilies` writes, is `*.md`. Replaced
+ * alone, it would be `**.md`, which spec-core refuses, as two stars inside a
+ * name are read three ways. A second star after it is still refused.
+ */
+function numberGlob(posix) {
+    return posix.replace(posix.includes(`${NUMBER}*`) ? `${NUMBER}*` : NUMBER, '*');
+}
+/** A files template, read. Only ever given one `citeFilesError` accepted. */
+export function parseFilesTemplate(template) {
+    const posix = toPosix(template);
+    const name = posix.slice(posix.lastIndexOf('/') + 1);
+    const [before, after] = name.split(NUMBER);
+    return { glob: numberGlob(posix), before, after };
+}
+/** A number as a comparable key: its digits without leading zeros, and `0` for none. */
+export function numberKey(digits) {
+    return digits.replace(/^0+(?=.)/, '');
+}
+/**
+ * The number a document's path gives it under a files template - its digits
+ * as the file name spells them - or null when the path is not one of the
+ * template's documents.
+ *
+ * The whole path is matched against the glob, and then the file name is read:
+ * the literal text before the number, a run of digits as long as it goes, and
+ * a rest that the text after the number must match exactly. So `{n}-*.md`
+ * reads `0007` from `0007-x.md`, and nothing from `0007x.md` or `x-0007.md`.
+ */
+export function documentNumber(template) {
+    const { glob, before, after } = parseFilesTemplate(template);
+    const matches = createPathMatcher(glob);
+    const rest = after === '' ? (text) => text === '' : createPathMatcher(after);
+    return (relativePath) => {
+        // A name the glob matched starts with the literal before the number.
+        if (!matches(relativePath))
+            return null;
+        const name = relativePath.slice(relativePath.lastIndexOf('/') + 1);
+        let end = before.length;
+        while (isDigit(name[end]))
+            end += 1;
+        const digits = name.slice(before.length, end);
+        return digits !== '' && rest(name.slice(end)) ? digits : null;
+    };
+}
+/**
+ * Every id in a text, in order of position; the ids of one template before
+ * another's where two begin at one place.
+ *
+ * For each template: its literal prefix, then a run of digits, then its
+ * suffix, with no letter, digit or underscore running into either end - so
+ * `XADR-1` and `ADR-12a` are not `ADR-{n}` citations, and `ADR-12.` is. The
+ * whole text is read, once per template; which ids lie in a comment is
+ * `inComments`'s question.
+ */
+export function scanCitations(text, templates) {
+    const found = [];
+    templates.forEach(({ prefix, suffix }, family) => {
+        const needsBoundaryBefore = isWord(prefix[0]);
+        for (let at = text.indexOf(prefix); at !== -1; at = text.indexOf(prefix, at + 1)) {
+            if (needsBoundaryBefore && isWord(text[at - 1]))
+                continue;
+            const digitsStart = at + prefix.length;
+            let digitsEnd = digitsStart;
+            while (isDigit(text[digitsEnd]))
+                digitsEnd += 1;
+            if (digitsEnd === digitsStart || !text.startsWith(suffix, digitsEnd))
+                continue;
+            const end = digitsEnd + suffix.length;
+            if (isWord(text[end - 1]) && isWord(text[end]))
+                continue;
+            found.push({ family, start: at, end, number: numberKey(text.slice(digitsStart, digitsEnd)), written: text.slice(at, end) });
+        }
+    });
+    // Stable, so ids at one place keep the order of their templates.
+    return found.sort((a, b) => a.start - b.start);
+}
+/** Words whose `'s` is `is` or `us` rather than a possessive: `it's ADR-7` is this project's. */
+const CONTRACTED = new Set(['it', 'that', 'this', 'there', 'here', 'what', 'who', 'where', 'how', 'when', 'why', 'he', 'she', 'let']);
+/** The characters a name before an id is made of: a project's, a package's, a repository's. */
+const NAME = /^[\p{L}\p{N}_\-/'’]$/u;
+/** What comes just before an id that is part of a path, an anchor or a query. */
+const LINKED = new Set(['/', '#', '=', '?']);
+/** Whether an id is written after a `://` with no whitespace between: in a URL, whatever comes just before it. */
+function inUrl(text, start) {
+    let begin = start;
+    while (begin > 0 && !/\s/.test(text[begin - 1]))
+        begin -= 1;
+    return text.slice(begin, start).includes('://');
+}
+/**
+ * Whether an id is qualified by another owner, and so names that owner's
+ * document rather than one of this project's.
+ *
+ * `spec-core's ADR-0005`, `spec-graph ADR-0017`, `its ADR-0012` and
+ * `org/repo ADR-9` each cite a document in another repository, which only has
+ * the same number as one here by coincidence: read as this project's, it is a
+ * ghost when the number is not used here, and quietly the wrong document when
+ * it is. So the word just before an id - past one run of spaces - is read,
+ * and the id is another owner's when that word is a possessive (`'s`, `its`,
+ * `their`) or a name with a `-` or `/` inside it. `see ADR-7`, `per ADR-7`,
+ * `(ADR-7)`, `e.g. ADR-7` and `it's ADR-7` are this project's. What that
+ * costs is a hyphenated word used as an ordinary one, `re-read ADR-7`, which
+ * is read as a qualifier and not checked: a citation missed, rather than one
+ * reported that is not wrong.
+ *
+ * An id in a link is another owner's too: one just after a `/`, `#`, `=` or
+ * `?`, which is a path, an anchor or a query, or in a run of text holding
+ * `://`. `https://github.com/org/repo/blob/main/docs/adr/ADR-0042.md` names a
+ * document wherever that repository keeps it, and `docs/ADR-0099.html` a page
+ * built from one - neither is a document this template finds.
+ */
+export function qualified(text, start) {
+    if (LINKED.has(text[start - 1]) || inUrl(text, start))
+        return true;
+    // Neither loop needs to stop at the start of the text: before it is
+    // undefined, which is no space and no character of a name.
+    let end = start;
+    while (text[end - 1] === ' ' || text[end - 1] === '\t')
+        end -= 1;
+    if (end === start)
+        return false;
+    let begin = end;
+    while (NAME.test(text[begin - 1]))
+        begin -= 1;
+    const word = text.slice(begin, end);
+    if (/^(?:its|their)$/i.test(word))
+        return true;
+    const possessive = /^(.*\p{L})['’]s$/u.exec(word);
+    if (possessive !== null && !CONTRACTED.has(possessive[1].toLowerCase()))
+        return true;
+    return /\p{L}[-/]\p{L}/u.test(word);
+}
+/**
+ * The citations that lie wholly inside a comment. Both lists are in order of
+ * position, so one walk through each answers every question: the file is
+ * searched once for each template, rather than once per comment - which on a
+ * file of many comments and no citations would search to its end each time.
+ */
+export function inComments(citations, comments) {
+    const kept = [];
+    let index = 0;
+    for (const citation of citations) {
+        while (index < comments.length && comments[index][1] <= citation.start)
+            index += 1;
+        const comment = comments[index];
+        if (comment !== undefined && comment[0] <= citation.start && citation.end <= comment[1])
+            kept.push(citation);
+    }
+    return kept;
+}
+/* ---------------------------------------------------------------- documents */
+/**
+ * Words that retire a document for anyone citing it.
+ *
+ * ADR-0010's closed list, less the two that mean "not yet": a proposal cited
+ * from the code that implements it is how a proposal gets built. One list, so
+ * a word added to it reaches this too.
+ */
+const NOT_YET = new Set(['draft', 'proposed']);
+export function isStale(status) {
+    // A document with no status is in no list, so there is nothing to test first.
+    return INACTIVE_STATUSES.has(status) && !NOT_YET.has(status);
+}
+/** The id a family writes for a document: `ADR-0007`. */
+function idOf(family, spelled) {
+    return `${family.template.prefix}${spelled}${family.template.suffix}`;
+}
+/** Reads files in batches of the engine's read limit, as `readSpecs` does, keeping each failure. */
+async function readAll(io, files) {
+    const read = [];
+    while (read.length < files.length) {
+        const batch = files.slice(read.length, read.length + MAX_CONCURRENT_READS);
+        read.push(...(await Promise.all(batch.map((file) => io.readFile(file).catch((error) => error)))));
+    }
+    return read;
+}
+/**
+ * The documents a files template names, by number.
+ *
+ * Walked from the template's literal base, skipping what a run skips. The
+ * project's `exclude` is not applied: it says what no rule reads, and a
+ * document it leaves out of the rules still exists to be cited. A document
+ * that cannot be read is still a document, with no status.
+ */
+export async function findDocuments(family, root, io, defaultSkips) {
+    const numberOf = documentNumber(family.files);
+    const { base } = globBase(parseFilesTemplate(family.files).glob);
+    const found = [];
+    for await (const entry of walkPaths(path.resolve(root, base), { io, scope: createScope(defaultSkips) })) {
+        const file = base === '' ? entry.relativePath : `${base}/${entry.relativePath}`;
+        const spelled = numberOf(file);
+        if (spelled !== null)
+            found.push({ file, absolute: entry.absolutePath, spelled });
+    }
+    const sources = await readAll(io, found.map(({ absolute }) => absolute));
+    const documents = new Map();
+    found.forEach(({ file, spelled }, index) => {
+        const source = sources[index];
+        // A document that cannot be read is read as one with no title and no
+        // status, which the empty text is.
+        const text = source instanceof Error ? '' : source.toString('utf8');
+        const key = numberKey(spelled);
+        documents.set(key, [...(documents.get(key) ?? []), { file, spelled, title: parseTitle(text), status: parseStatus(text) }]);
+    });
+    return documents;
+}
+/* ----------------------------------------------------------------- defaults */
+/** The extensions Markdown is written in, which spec-graph reads and this does not. */
+const MARKDOWN = new Set(['.md', '.markdown', '.mdx']);
+/**
+ * The families a project's specs imply, when it names none.
+ *
+ * A directory of spec files whose names begin with a number is a numbered
+ * series, and a series whose documents all title themselves with one id and
+ * that same number - `# ADR-0007: ...` in `0007-x.md` - says how it is cited.
+ * Anything short of that is not guessed at: a series whose titles disagree, or
+ * do not begin with an id, gets a note saying to configure `cites`.
+ */
+export function deriveFamilies(documents) {
+    const series = new Map();
+    for (const { file, title } of documents) {
+        const slash = file.lastIndexOf('/');
+        const name = file.slice(slash + 1);
+        const digits = /^[0-9]+/.exec(name)?.[0];
+        if (digits === undefined)
+            continue;
+        const directory = file.slice(0, Math.max(slash, 0));
+        series.set(directory, [...(series.get(directory) ?? []), { name, digits, title }]);
+    }
+    const families = [];
+    const notes = [];
+    for (const [directory, members] of [...series].sort(([a], [b]) => comparePaths(a, b))) {
+        const prefixes = new Set(members.map(({ digits, title }) => {
+            const titled = /^([A-Za-z]+-)([0-9]+)(?![0-9A-Za-z_])/.exec(title ?? '');
+            return titled !== null && numberKey(titled[2]) === numberKey(digits) ? titled[1] : null;
+        }));
+        const where = directory === '' ? 'the root' : directory;
+        // A series has a member, so the set has at least one entry.
+        const prefix = [...prefixes][0];
+        if (prefixes.size !== 1 || prefix === null) {
+            notes.push(`${where} holds numbered specs whose titles do not all begin with one id and their own number, such as ADR-0001 in 0001-x.md, so how they are cited is not guessed; name them in "cites" to check citations of them`);
+            continue;
+        }
+        const extensions = new Set(members.map(({ name }) => path.posix.extname(name)));
+        const [extension] = extensions;
+        const glob = `${directory === '' ? '' : `${directory}/`}${NUMBER}*${extensions.size === 1 ? extension : ''}`;
+        families.push({ id: `${prefix}${NUMBER}`, files: glob });
+    }
+    return { families, notes };
+}
+/** A configuration no answer can be trusted under: the report is not written, and the command exits 2. */
+export class CitesError extends Error {
+}
+/** The nearest ids a family has on either side of a number: what a typo most likely meant. */
+function nearest(family, number) {
+    const wanted = BigInt(number);
+    // Numbers as big as a comment writes them, so compared as BigInt; the
+    // difference's sign is all a sort needs, and Number keeps it.
+    const values = [...family.documents.keys()].map((key) => BigInt(key)).sort((a, b) => Number(a - b));
+    // The cited number is no document's, so nothing equals it.
+    const sides = [values.filter((value) => value < wanted).pop(), values.find((value) => value > wanted)];
+    return sides
+        .filter((side) => side !== undefined)
+        .map((side) => idOf(family, family.documents.get(side.toString())[0].spelled));
+}
+/** Where a stale document's status line points, followed until a document in force, or null. */
+function successorOf(document, own, families) {
+    const templates = families.map(({ template }) => template);
+    const seen = new Set([`${own.family}\u0000${own.number}`]);
+    const chain = [];
+    let current = document;
+    for (;;) {
+        // Only a stale document is followed, and a stale document has a status.
+        const label = current.status.label;
+        const next = scanCitations(label, templates).find((citation) => !seen.has(`${citation.family}\u0000${citation.number}`));
+        if (next === undefined)
+            return null;
+        seen.add(`${next.family}\u0000${next.number}`);
+        const family = families[next.family];
+        const [target] = family.documents.get(next.number) ?? [];
+        if (target === undefined)
+            return null;
+        const id = idOf(family, target.spelled);
+        chain.push(id);
+        if (!isStale(target.status?.value))
+            return { id, chain };
+        current = target;
+    }
+}
+/**
+ * Reads the comments of every source file in scope and reports each citation
+ * of a document that does not exist or is no longer in force.
+ *
+ * Throws `CitesError` when the answer could not be trusted: a family whose
+ * files match no document, which would make every citation of it a ghost.
+ */
+export async function findCitations(options) {
+    const startedAt = performance.now();
+    const io = options.io ?? nodeIo;
+    const root = options.root;
+    const defaultSkips = options.defaultSkips ?? true;
+    const exclude = [...(options.exclude ?? [])];
+    const specs = await readSpecs(options.patterns, root, io);
+    const specFiles = new Set(specs.files);
+    const derived = options.families === undefined ? deriveFamilies(specs.documents.map(({ relativeFile, title }) => ({ file: relativeFile, title }))) : null;
+    const declared = options.families ?? derived.families;
+    const notes = derived === null ? [] : [...derived.notes];
+    const source = derived === null ? 'config' : 'derived';
+    const families = [];
+    for (const family of declared) {
+        const documents = await findDocuments(family, root, io, defaultSkips);
+        if (documents.size === 0) {
+            throw new CitesError(`no document matches ${family.files}, so every citation of ${family.id} would be reported as a ghost; check the files pattern against the documents' names`);
+        }
+        families.push({ ...family, source, template: parseIdTemplate(family.id), documents });
+    }
+    if (families.length === 0) {
+        notes.push(options.families === undefined
+            ? 'nothing to look for: "cites" names no documents, and no directory of numbered specs titles them with an id such as ADR-0001, so no citation was read; name them in "cites"'
+            : 'nothing to look for: "cites" is an empty list');
+    }
+    const cited = new Set(families.flatMap((family) => [...family.documents.values()].flat().map(({ file }) => file)));
+    const excluded = createExcludeMatcher(exclude);
+    const templates = families.map(({ template }) => template);
+    const scope = createScope(defaultSkips);
+    const unclassified = new Map();
+    const candidates = [];
+    const starts = options.paths?.map((entry) => (entry === '.' ? '' : entry)) ?? [''];
+    const seen = new Set();
+    // With nothing to look for, no path is walked, and every count stays at zero.
+    if (families.length > 0) {
+        for (const start of starts) {
+            const absoluteStart = path.resolve(root, start);
+            const stats = await io.stat(absoluteStart);
+            const entries = [];
+            if (stats?.isFile())
+                entries.push({ relativePath: start, absolutePath: absoluteStart });
+            else {
+                for await (const entry of walkPaths(absoluteStart, { io, scope })) {
+                    entries.push({ relativePath: start === '' ? entry.relativePath : `${start}/${entry.relativePath}`, absolutePath: entry.absolutePath });
+                }
+            }
+            for (const { relativePath, absolutePath } of entries) {
+                if (seen.has(relativePath))
+                    continue;
+                seen.add(relativePath);
+                const extension = path.posix.extname(relativePath).toLowerCase();
+                if (MARKDOWN.has(extension) || specFiles.has(absolutePath) || cited.has(relativePath) || excluded(relativePath))
+                    continue;
+                const syntax = syntaxFor(relativePath);
+                if (syntax === null) {
+                    const name = extension === '' ? '(none)' : extension;
+                    unclassified.set(name, (unclassified.get(name) ?? 0) + 1);
+                    continue;
+                }
+                // A format known to have no comments has no citations to read.
+                if (syntax.line.length === 0 && syntax.block.length === 0)
+                    continue;
+                candidates.push({ file: relativePath, absolute: absolutePath });
+            }
+        }
+    }
+    candidates.sort((a, b) => comparePaths(a.file, b.file));
+    const strict = options.strict ?? false;
+    const findings = [];
+    const gaps = [];
+    let read = 0;
+    let citations = 0;
+    let others = 0;
+    const scan = (file, bytes) => {
+        if (bytes instanceof Error) {
+            gaps.push({ file, reason: 'unreadable', detail: `could not be read: ${bytes.message}` });
+            return;
+        }
+        if (!withinSizeLimit(bytes.length)) {
+            gaps.push({ file, reason: 'too-large', detail: 'is larger than 20 MB, which no search reads' });
+            return;
+        }
+        if (isBinary(bytes)) {
+            gaps.push({ file, reason: 'binary', detail: 'holds a NUL byte, so it is not text' });
+            return;
+        }
+        read += 1;
+        const text = bytes.toString('utf8');
+        const lexed = lexRanges(text, syntaxFor(file));
+        if (lexed.unterminated) {
+            gaps.push({ file, reason: 'lost-scan', detail: 'a string or comment was never closed, so what follows it may be misread' });
+        }
+        let lines;
+        const once = new Set();
+        for (const citation of inComments(scanCitations(text, templates), lexed.comments)) {
+            if (qualified(text, citation.start)) {
+                others += 1;
+                continue;
+            }
+            lines ??= lineStarts(text);
+            const { line, column } = locate(lines, citation.start);
+            const key = `${line}\u0000${citation.family}\u0000${citation.number}`;
+            if (once.has(key))
+                continue;
+            once.add(key);
+            citations += 1;
+            const finding = judge(citation, families, { file, line, column }, strict);
+            if (finding !== null)
+                findings.push(finding);
+        }
+    };
+    // A batch at a time, each scanned as soon as it is read, so that no more
+    // than one batch of a large tree is held in memory at once.
+    for (const pending = [...candidates]; pending.length > 0;) {
+        const batch = pending.splice(0, MAX_CONCURRENT_READS);
+        const sources = await readAll(io, batch.map(({ absolute }) => absolute));
+        batch.forEach(({ file }, index) => scan(file, sources[index]));
+    }
+    const ghosts = findings.filter((finding) => finding.rule === 'ghost-citation').length;
+    const stale = findings.length - ghosts;
+    const familyReports = families.map(({ id, files, source: from, documents }) => ({
+        id,
+        files,
+        source: from,
+        documents: [...documents.values()].reduce((total, list) => total + list.length, 0),
+    }));
+    return {
+        // Under --strict, anything short of every comment read and every citation
+        // in force fails: a stale citation, a file read in part, and a check that
+        // read nothing - which one that looked for nothing did not - since the
+        // family contract says a strict run refuses that rather than reports clean.
+        ok: ghosts === 0 && !(strict && (stale > 0 || gaps.length > 0 || read === 0)),
+        root: toPosix(root),
+        durationMs: performance.now() - startedAt,
+        families: familyReports,
+        summary: {
+            files: read,
+            citations,
+            ghosts,
+            stale,
+            qualified: others,
+            unclassified: [...unclassified.values()].reduce((total, count) => total + count, 0),
+        },
+        findings,
+        gaps,
+        unclassified: [...unclassified]
+            .map(([extension, files]) => ({ extension, files }))
+            .sort((a, b) => b.files - a.files || comparePaths(a.extension, b.extension)),
+        notes,
+        exclude,
+    };
+}
+/** What one citation found: nothing wrong, a ghost, or a stale document. */
+function judge(citation, families, where, strict) {
+    const family = families[citation.family];
+    const documents = family.documents.get(citation.number);
+    const at = `${where.file}:${where.line}`;
+    if (documents === undefined) {
+        const near = nearest(family, citation.number);
+        return {
+            rule: 'ghost-citation',
+            severity: 'error',
+            ...where,
+            cited: citation.written,
+            family: family.id,
+            message: `${at} cites ${citation.written}, which no document defines`,
+            hint: `no document matching ${family.files} has the number ${citation.number}; the nearest ${near.length === 1 ? 'is' : 'are'} ${near.join(' and ')}`,
+        };
+    }
+    // Two documents with one number are one id, and it is in force while either is.
+    const document = documents.find((candidate) => !isStale(candidate.status?.value));
+    if (document !== undefined)
+        return null;
+    const stale = documents[0];
+    const status = stale.status.value;
+    const successor = successorOf(stale, citation, families);
+    const said = `${stale.file} says "${stale.status.label}"`;
+    return {
+        rule: 'stale-citation',
+        severity: strict ? 'error' : 'warning',
+        ...where,
+        cited: citation.written,
+        family: family.id,
+        document: stale.file,
+        status,
+        ...(successor === null ? {} : { successor: successor.id }),
+        message: `${at} cites ${citation.written}, which is ${status}${successor === null ? '' : ` - cite ${successor.id} instead`}`,
+        hint: successor === null
+            ? `${said}, and names no successor in force; cite the decision in force instead, or take the citation out`
+            : successor.chain.length > 1
+                ? `${said}; it was followed through ${successor.chain.slice(0, -1).join(', ')}, which ${successor.chain.length === 2 ? 'is' : 'are'} not in force either, to ${successor.id}`
+                : `${said}`,
+    };
+}
+//# sourceMappingURL=cites.js.map

package/dist/cites.js.map

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