@svp-labs/talos 0.0.0 → 0.1.1

package/dist/checks/docs/cspell.js

@@ -0,0 +1,138 @@
+import { relative, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { z } from 'zod';
+import { excludeGlobs } from './markdownlint.js';
+import { generatedHeader } from '../../configs/header.js';
+import { EngineError } from '../../core/check.js';
+import { KIT_BEGIN, KIT_END } from '../../docs/claude.js';
+export const CSPELL_CONFIG = 'cspell.config.yaml';
+/** The project's own words: the extension, which only adds what the dictionaries lack. */
+export const WORDS_FILE = '.cspell/words.txt';
+/** Docs, code, scripts and CI. */
+const SPELLING_GLOBS = [
+    '**/*.{md,markdown}',
+    '**/*.{ts,tsx,mts,cts,js,jsx,mjs,cjs}',
+    '**/*.{py,pyi,php,lua,rs}',
+    '**/*.{sh,bash,ps1,psm1,psd1}',
+    '**/*.{yml,yaml,toml,jsonc}',
+    '**/Dockerfile',
+    '**/*.Dockerfile',
+    '.githooks/*',
+];
+const NOT_SPELLED = ['**/pnpm-lock.yaml', '**/*.lock'];
+/** Where Talos keeps its local reports and cache, in every repository. */
+const TALOS_OUTPUT = '.talos';
+/** What each language's tools write into a checkout: reports, sandboxes and installed packages. */
+const TOOL_OUTPUT = [
+    ['ts', ['coverage', 'reports', '.stryker-tmp']],
+    ['py', ['.venv', 'htmlcov', 'mutants']],
+    ['php', ['vendor']],
+    ['lua', ['.lua']],
+    ['rust', ['target', 'mutants.out']],
+];
+/** The directories Talos and the tools of these languages write output into, anywhere. */
+export function outputGlobs(langs) {
+    const dirs = TOOL_OUTPUT.filter(([lang]) => langs.includes(lang)).flatMap(([, list]) => list);
+    return [TALOS_OUTPUT, ...dirs].map((dir) => `**/${dir}/**`);
+}
+/** Words of the text Talos writes into every repository and the project keeps. */
+export const KIT_WORDS = ['talos'];
+function escapeRegExp(text) {
+    return text.replaceAll(/[.*+?^${}()|[\]\\]/g, String.raw `\$&`);
+}
+/** What isn't prose: Talos's block in `CLAUDE.md`, advisory IDs, digests, commit SHAs. */
+export const IGNORED_PATTERNS = [
+    `/${escapeRegExp(KIT_BEGIN)}[\\s\\S]*?${escapeRegExp(KIT_END)}/g`,
+    '/GHSA(-[0-9a-z]{4}){3}/g',
+    '/sha256:[0-9a-f]{64}/g',
+    String.raw `/\b[0-9a-f]{40}\b/g`,
+    String.raw `/\[[A-Za-z0-9#^-]{8,}\]/g`,
+    // mutmut names a mutant after its function, joined by `ǁ`: an identifier, not prose.
+    '/xǁ[\\wǁ]*/gu',
+];
+const LANGUAGE = 'en,en-GB';
+function yamlList(items) {
+    return items.map((item) => `  - '${item.replaceAll("'", "''")}'`);
+}
+/**
+ * The base for editors and `cspell`, written as Prettier writes it. It skips what Talos and the
+ * tools of the repository's languages write into a checkout, which `cspell` over every file
+ * would otherwise read.
+ */
+export function renderCspellBase(version, exclude, langs) {
+    const ignored = [
+        '**/node_modules/**',
+        ...outputGlobs(langs),
+        '.cspell/**',
+        ...NOT_SPELLED,
+        ...excludeGlobs(exclude),
+    ];
+    return [
+        generatedHeader('#', version).trimEnd(),
+        '# Spelling in docs, code, scripts and CI, in British or American English. Words the',
+        `# dictionaries don't know go in ${WORDS_FILE}, one per line.`,
+        "version: '0.2'",
+        `language: ${LANGUAGE}`,
+        'dictionaryDefinitions:',
+        '  - name: project',
+        `    path: ./${WORDS_FILE}`,
+        '    addWords: true',
+        'dictionaries: [project]',
+        `words: [${KIT_WORDS.join(', ')}]`,
+        'ignoreRegExpList:',
+        ...yamlList(IGNORED_PATTERNS),
+        'ignorePaths:',
+        ...yamlList(ignored),
+        '',
+    ].join('\n');
+}
+/**
+ * The settings the gate runs with: the base's, the project's word list and the glossary's
+ * terms, and no configuration file found anywhere else in the checkout.
+ */
+export function gateSettings(dictionaries) {
+    const definitions = [
+        ...(dictionaries.words === undefined
+            ? []
+            : [{ name: 'project', path: dictionaries.words, addWords: true }]),
+        { name: 'glossary', path: dictionaries.glossary },
+    ];
+    return {
+        version: '0.2',
+        language: LANGUAGE,
+        dictionaryDefinitions: definitions,
+        dictionaries: definitions.map((definition) => definition.name),
+        words: KIT_WORDS,
+        ignoreRegExpList: IGNORED_PATTERNS,
+        noConfigSearch: true,
+    };
+}
+/** The tracked files the spelling check reads. */
+export function spellingFiles(facts) {
+    const skipped = new Set(facts.matching(...NOT_SPELLED));
+    return facts.matching(...SPELLING_GLOBS).filter((file) => !skipped.has(file));
+}
+const issueSchema = z.object({
+    text: z.string(),
+    row: z.number().int().positive(),
+    col: z.number().int().positive(),
+    uri: z.string(),
+    isFlagged: z.boolean().optional(),
+});
+/** A finding from one cspell issue; `root` is the checkout the paths are relative to. */
+export function spellingFinding(root, issue) {
+    const parsed = issueSchema.safeParse(issue);
+    if (!parsed.success)
+        throw new EngineError('cspell reported an issue Talos cannot read');
+    const { text, row, col, uri } = parsed.data;
+    const file = relative(root, uri.startsWith('file:') ? fileURLToPath(uri) : uri)
+        .split(sep)
+        .join('/');
+    const what = parsed.data.isFlagged === true ? 'Forbidden word' : 'Unknown word';
+    return {
+        rule: 'cspell/unknown-word',
+        message: `${what} "${text}": correct it, or add it to ${WORDS_FILE}.`,
+        location: { file, line: row, column: col },
+    };
+}
+//# sourceMappingURL=cspell.js.map

package/dist/checks/docs/cspell.js.map

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

package/dist/checks/docs/decisions.js

@@ -0,0 +1,30 @@
+import { decisionFiles, decisionTexts, MARKDOWN_GLOBS, readOwnTexts } from './files.js';
+import { APPLIES, skip } from '../../core/check.js';
+import { judgeDecisions } from '../../docs/decisions.js';
+/**
+ * Decision IDs are unique across `DECISIONS.md` and the briefs, every reference in the
+ * repository's Markdown resolves, and every reversal is linked both ways.
+ */
+export const decisionsCheck = {
+    id: 'docs/decisions',
+    tier: 'head',
+    scope: 'repo',
+    title: 'decision IDs, references and reversals',
+    applies: (ctx) => decisionFiles(ctx).length > 0
+        ? APPLIES
+        : skip('the repository has no DECISIONS.md and no briefs'),
+    run: async (ctx) => {
+        const definitions = await decisionTexts(ctx);
+        const documents = await readOwnTexts(ctx, ctx.facts.matching(...MARKDOWN_GLOBS));
+        return judgeDecisions(definitions, documents).map((problem) => ({
+            rule: problem.rule,
+            message: problem.message,
+            location: {
+                file: problem.file,
+                line: problem.line,
+                ...(problem.column === undefined ? {} : { column: problem.column }),
+            },
+        }));
+    },
+};
+//# sourceMappingURL=decisions.js.map

package/dist/checks/docs/decisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.js","sourceRoot":"","sources":["../../../src/checks/docs/decisions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,OAAO,EAAc,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAU;IACnC,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,wCAAwC;IAC/C,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CACf,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC;QAC3B,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,IAAI,CAAC,kDAAkD,CAAC;IAC9D,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACjB,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC;QACjF,OAAO,cAAc,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAW,EAAE,CAAC,CAAC;YACvE,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE;gBACR,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;aACpE;SACF,CAAC,CAAC,CAAC;IACN,CAAC;CACF,CAAC"}

package/dist/checks/docs/files.js

@@ -0,0 +1,64 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { GENERATED_MARKER } from '../../configs/header.js';
+import { KIT_BEGIN, KIT_END } from '../../docs/claude.js';
+export const MARKDOWN_GLOBS = ['**/*.md', '**/*.markdown'];
+const DECISIONS_FILE = 'DECISIONS.md';
+/** A path without the slashes it ends with. */
+export function withoutTrailingSlashes(path) {
+    let end = path.length;
+    while (end > 0 && path[end - 1] === '/')
+        end -= 1;
+    return path.slice(0, end);
+}
+/** Files read at once, so a large repository doesn't run out of file handles. */
+const BATCH = 64;
+/** A file of the checkout, or undefined when it isn't there (deleted in a working tree). */
+export async function readText(ctx, file) {
+    try {
+        return await readFile(join(ctx.root, file), 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+/** A tool config Talos rendered: its text is Talos's, not the project's. */
+function isGenerated(text) {
+    const head = text.slice(0, 600).split('\n', 3);
+    return ((head[0] ?? '').includes(GENERATED_MARKER) ||
+        head.some((line) => line.trimStart().startsWith(`"//": "${GENERATED_MARKER}`)));
+}
+/** Blanks `CLAUDE.md`'s kit block, Talos's own text, keeping every line where it was. */
+function withoutKitBlock(text) {
+    const begin = text.indexOf(KIT_BEGIN);
+    const end = begin === -1 ? -1 : text.indexOf(KIT_END, begin);
+    if (end === -1)
+        return text;
+    const stop = end + KIT_END.length;
+    return (text.slice(0, begin) + text.slice(begin, stop).replaceAll(/[^\n]/g, ' ') + text.slice(stop));
+}
+/** The project's own text in each file, skipping missing and generated files. */
+export async function readOwnTexts(ctx, files) {
+    const docs = [];
+    for (let start = 0; start < files.length; start += BATCH) {
+        const batch = files.slice(start, start + BATCH);
+        const texts = await Promise.all(batch.map((file) => readText(ctx, file)));
+        for (const [index, text] of texts.entries()) {
+            const file = batch[index];
+            if (file === undefined || text === undefined || isGenerated(text))
+                continue;
+            docs.push({ file, text: withoutKitBlock(text) });
+        }
+    }
+    return docs;
+}
+/** `DECISIONS.md` and every brief: where decisions are defined. */
+export function decisionFiles(ctx) {
+    const briefs = withoutTrailingSlashes(ctx.config.docs.briefs);
+    return ctx.facts.matching(DECISIONS_FILE, `${briefs}/**/*.md`);
+}
+/** The texts of `DECISIONS.md` and the briefs, read once per run. */
+export async function decisionTexts(ctx) {
+    return ctx.memo('docs/decision-texts', () => readOwnTexts(ctx, decisionFiles(ctx)));
+}
+//# sourceMappingURL=files.js.map

package/dist/checks/docs/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../../src/checks/docs/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG1D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;AAC3D,MAAM,cAAc,GAAG,cAAc,CAAC;AAEtC,+CAA+C;AAC/C,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;IACtB,OAAO,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG;QAAE,GAAG,IAAI,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,iFAAiF;AACjF,MAAM,KAAK,GAAG,EAAE,CAAC;AAEjB,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAiB,EAAE,IAAY;IAC5D,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/C,OAAO,CACL,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,UAAU,gBAAgB,EAAE,CAAC,CAAC,CAC/E,CAAC;AACJ,CAAC;AAED,yFAAyF;AACzF,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7D,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,IAAI,GAAG,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAClC,OAAO,CACL,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAC5F,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAiB,EACjB,KAAwB;IAExB,MAAM,IAAI,GAAc,EAAE,CAAC;IAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,KAAK,EAAE,CAAC;QACzD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1E,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,IAAI,WAAW,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC5E,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,aAAa,CAAC,GAAiB;IAC7C,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9D,OAAO,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,EAAE,GAAG,MAAM,UAAU,CAAC,CAAC;AACjE,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAiB;IACnD,OAAO,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC"}

package/dist/checks/docs/glossary.js

@@ -0,0 +1,99 @@
+import { decisionFiles, MARKDOWN_GLOBS, readOwnTexts, readText } from './files.js';
+import { APPLIES, skip } from '../../core/check.js';
+import { SOURCE_GLOBS } from '../../docs/comments/index.js';
+import { avoidedInCode, avoidedWords, parseGlossary, } from '../../docs/glossary.js';
+import { maskCode } from '../../docs/markdown.js';
+const MARKDOWN = /\.(?:md|markdown)$/;
+/** A line that lists the words a glossary entry avoids, as the glossary's parser reads it. */
+const AVOID_LINE = /^\s*avoid:/i;
+const HEADING = /^ {0,3}#{1,6}(?:[ \t]|$)/;
+/** A bold label opening a paragraph of a decision: `**Decision:**`, `**Rejected:**`. */
+const LABEL = /^\*\*([^*\n:]+)(?::\*\*|\*\*:)/;
+const LIST_ITEM = /^\s*(?:[-*+]|\d+[.)])[ \t]/;
+/** A word in double quotes, straight or curly, on one line: named, not used. */
+const QUOTED = /"[^"\n]*"|“[^“”\n]*”/g;
+function blank(text) {
+    return text.replaceAll(/[^\n]/g, ' ');
+}
+/** The glossary without its `Avoid:` lines, which list the words rather than use them. */
+function withoutAvoidLines(text) {
+    return text
+        .split('\n')
+        .map((line) => (AVOID_LINE.test(line) ? blank(line) : line))
+        .join('\n');
+}
+/**
+ * Whether a line still belongs to the `**Rejected:**` paragraph or list before it: a heading
+ * ends it, and so does a paragraph after a blank line that is neither a list item nor indented.
+ */
+function continuesRejection(line, previous) {
+    if (HEADING.test(line))
+        return false;
+    if (line.trim() === '' || previous.trim() !== '')
+        return true;
+    return LIST_ITEM.test(line) || /^\s/.test(line);
+}
+/**
+ * A decision record without what it names but doesn't use: each `**Rejected:**` paragraph or
+ * list, where the alternatives that lost are named by design, and words in double quotes.
+ * Everything else a decision says still counts.
+ */
+function withoutRejections(text) {
+    const lines = text.split('\n');
+    let rejecting = false;
+    return lines
+        .map((line, index) => {
+        const label = LABEL.exec(line)?.[1];
+        if (label !== undefined)
+            rejecting = label.trim().toLowerCase() === 'rejected';
+        else if (rejecting)
+            rejecting = continuesRejection(line, lines[index - 1] ?? '');
+        return rejecting ? blank(line) : line.replaceAll(QUOTED, blank);
+    })
+        .join('\n');
+}
+/** The text of a file the avoided words are matched in, its line and column kept. */
+function judged(file, text, files) {
+    if (!MARKDOWN.test(file))
+        return text;
+    const prose = maskCode(text);
+    if (file === files.glossary)
+        return withoutAvoidLines(prose);
+    return files.decisions.has(file) ? withoutRejections(prose) : prose;
+}
+function hitsIn(entries, file, text) {
+    const markdown = MARKDOWN.test(file);
+    return text.split('\n').flatMap((line, index) => {
+        const hits = markdown ? avoidedWords(entries, line) : avoidedInCode(entries, line);
+        return hits.map((hit) => ({
+            rule: 'glossary/avoid',
+            message: `"${hit.word}" is a word the glossary avoids: write "${hit.instead}" instead.`,
+            location: { file, line: index + 1, column: hit.index + 1 },
+        }));
+    });
+}
+async function avoided(ctx) {
+    const glossary = ctx.config.docs.glossary;
+    const text = await readText(ctx, glossary);
+    const entries = text === undefined ? [] : parseGlossary(text).filter((e) => e.avoid.length > 0);
+    if (entries.length === 0)
+        return [];
+    const files = { glossary, decisions: new Set(decisionFiles(ctx)) };
+    const docs = await readOwnTexts(ctx, ctx.facts.matching(...MARKDOWN_GLOBS, ...SOURCE_GLOBS));
+    return docs.flatMap((doc) => hitsIn(entries, doc.file, judged(doc.file, doc.text, files)));
+}
+/**
+ * The words the glossary lists under `Avoid:` fail in docs and in code, the glossary's own
+ * definitions included. A decision record may name one where it rejects it, or in quotes.
+ */
+export const glossaryCheck = {
+    id: 'docs/glossary',
+    tier: 'head',
+    scope: 'repo',
+    title: 'words the glossary avoids',
+    applies: (ctx) => ctx.facts.files.includes(ctx.config.docs.glossary)
+        ? APPLIES
+        : skip(`the repository has no glossary at ${ctx.config.docs.glossary}`),
+    run: avoided,
+};
+//# sourceMappingURL=glossary.js.map

package/dist/checks/docs/glossary.js.map

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

package/dist/checks/docs/index.js

@@ -0,0 +1,25 @@
+import { claudeMdCheck } from './claude-md.js';
+import { commentsCheck } from './comments.js';
+import { decisionsCheck } from './decisions.js';
+import { glossaryCheck } from './glossary.js';
+import { markdownCheck, markdownlintBase } from './markdown.js';
+import { referencesCheck } from './references.js';
+import { cspellBase, spellingCheck } from './spelling.js';
+/**
+ * The documentation rules: Markdown style, spelling, decision records, the glossary's avoided
+ * words, links, what code comments may say, and `CLAUDE.md`.
+ */
+export const docsPack = {
+    name: 'docs',
+    checks: [
+        commentsCheck,
+        markdownCheck,
+        spellingCheck,
+        decisionsCheck,
+        glossaryCheck,
+        referencesCheck,
+        claudeMdCheck,
+    ],
+    generated: [markdownlintBase, cspellBase],
+};
+//# sourceMappingURL=index.js.map

package/dist/checks/docs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/checks/docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG1D;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAS;IAC5B,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE;QACN,aAAa;QACb,aAAa;QACb,aAAa;QACb,cAAc;QACd,aAAa;QACb,eAAe;QACf,aAAa;KACd;IACD,SAAS,EAAE,CAAC,gBAAgB,EAAE,UAAU,CAAC;CAC1C,CAAC"}

package/dist/checks/docs/markdown.js

@@ -0,0 +1,39 @@
+import { lint } from 'markdownlint-cli2/markdownlint/promise';
+import { MARKDOWN_GLOBS, readText } from './files.js';
+import { MARKDOWNLINT_CONFIG, MARKDOWNLINT_RULES, markdownlintFindings, NOT_LINTED, renderMarkdownlintBase, } from './markdownlint.js';
+import { APPLIES, skip } from '../../core/check.js';
+/** The tracked Markdown files markdownlint reads: those the base doesn't ignore. */
+function lintedFiles(facts) {
+    const skipped = new Set(facts.matching(...NOT_LINTED));
+    return facts.matching(...MARKDOWN_GLOBS).filter((file) => !skipped.has(file));
+}
+/** The repository's Markdown through markdownlint, with the base's rules and nothing else. */
+export const markdownCheck = {
+    id: 'docs/markdown',
+    tier: 'head',
+    scope: 'repo',
+    title: 'markdownlint',
+    applies: (ctx) => lintedFiles(ctx.facts).length > 0 ? APPLIES : skip('the repository has no Markdown to lint'),
+    run: async (ctx) => {
+        const strings = {};
+        for (const file of lintedFiles(ctx.facts)) {
+            const text = await readText(ctx, file);
+            if (text !== undefined)
+                strings[file] = text;
+        }
+        const results = await lint({
+            strings,
+            config: MARKDOWNLINT_RULES,
+            noInlineConfig: true,
+            handleRuleFailures: true,
+        });
+        return markdownlintFindings(results);
+    },
+};
+export const markdownlintBase = {
+    path: MARKDOWNLINT_CONFIG,
+    scope: 'repo',
+    applies: (ctx) => ctx.facts.has(...MARKDOWN_GLOBS),
+    render: (ctx) => renderMarkdownlintBase(ctx.version, ctx.config.exclude),
+};
+//# sourceMappingURL=markdown.js.map

package/dist/checks/docs/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../src/checks/docs/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,wCAAwC,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAc,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAIhE,oFAAoF;AACpF,SAAS,WAAW,CAAC,KAAgB;IACnC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IACvD,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,8FAA8F;AAC9F,MAAM,CAAC,MAAM,aAAa,GAAU;IAClC,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,cAAc;IACrB,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CACf,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,wCAAwC,CAAC;IAC9F,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACjB,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACvC,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAC/C,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC;YACzB,OAAO;YACP,MAAM,EAAE,kBAAkB;YAC1B,cAAc,EAAE,IAAI;YACpB,kBAAkB,EAAE,IAAI;SACzB,CAAC,CAAC;QACH,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAc;IACzC,IAAI,EAAE,mBAAmB;IACzB,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC;IAClD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,sBAAsB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;CACzE,CAAC"}

package/dist/checks/docs/markdownlint.js

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+import { withoutTrailingSlashes } from './files.js';
+import { generatedHeader } from '../../configs/header.js';
+import { EngineError } from '../../core/check.js';
+export const MARKDOWNLINT_CONFIG = '.markdownlint-cli2.jsonc';
+/** markdownlint's rules, every one on, with prose lines up to 100 outside tables and code. */
+export const MARKDOWNLINT_RULES = {
+    default: true,
+    MD013: { line_length: 100, tables: false, code_blocks: false },
+};
+/**
+ * What markdownlint skips, in the gate and in the base alike: installed packages, and PR
+ * templates, which are forms of HTML comments to fill in rather than documents.
+ */
+export const NOT_LINTED = ['**/node_modules/**', '**/pull_request_template.md'];
+/** Globs for what `talos.yml` excludes: each entry as a file and as a directory. */
+export function excludeGlobs(exclude) {
+    return exclude.flatMap((entry) => {
+        const trimmed = withoutTrailingSlashes(entry);
+        return [trimmed, `${trimmed}/**`];
+    });
+}
+/** A JSON array on one line when it fits in `width` after `prefix`, else one item a line. */
+function jsonArray(prefix, items, width = 100) {
+    const inline = `${prefix}[${items.map((item) => JSON.stringify(item)).join(', ')}],`;
+    if (inline.length <= width)
+        return inline;
+    const indent = /^\s*/.exec(prefix)?.[0] ?? '';
+    const lines = items.map((item) => `${indent}  ${JSON.stringify(item)},`);
+    return [`${prefix}[`, ...lines, `${indent}],`].join('\n');
+}
+function inlineObject(value) {
+    const entries = Object.entries(value).map(([key, item]) => `"${key}": ${JSON.stringify(item)}`);
+    return `{ ${entries.join(', ')} }`;
+}
+/**
+ * The base for editors and `markdownlint-cli2`, written as Prettier writes it. Inline
+ * `markdownlint-disable` comments do nothing. It has no extension file: every rule is already
+ * on, and the line length is the kit's.
+ */
+export function renderMarkdownlintBase(version, exclude) {
+    const ignores = [...NOT_LINTED, ...excludeGlobs(exclude)];
+    return [
+        generatedHeader('//', version).trimEnd(),
+        "// markdownlint's rules for every Markdown file, lines up to 100 outside tables and code.",
+        '{',
+        '  "config": {',
+        '    "default": true,',
+        `    "MD013": ${inlineObject(MARKDOWNLINT_RULES.MD013)},`,
+        '  },',
+        jsonArray('  "globs": ', ['**/*.md']),
+        jsonArray('  "ignores": ', ignores),
+        '  "gitignore": true,',
+        '  "noInlineConfig": true,',
+        '}',
+        '',
+    ].join('\n');
+}
+const lintError = z.object({
+    lineNumber: z.number().int().positive(),
+    ruleNames: z.array(z.string()).min(1),
+    ruleDescription: z.string(),
+    errorDetail: z.string().nullable(),
+    errorRange: z.tuple([z.number(), z.number()]).nullable(),
+});
+const lintResults = z.record(z.string(), z.array(lintError));
+function sentence(description, detail) {
+    const text = detail === null || detail === '' ? description : `${description} (${detail})`;
+    return /[.!?]$/.test(text) ? text : `${text}.`;
+}
+/** Findings from markdownlint's results, keyed by repository-relative file. */
+export function markdownlintFindings(results) {
+    const parsed = lintResults.safeParse(results);
+    if (!parsed.success)
+        throw new EngineError('markdownlint returned results Talos cannot read');
+    return Object.entries(parsed.data).flatMap(([file, errors]) => errors.map((error) => ({
+        rule: `markdownlint/${error.ruleNames[0] ?? 'unknown'}`,
+        message: sentence(error.ruleDescription, error.errorDetail),
+        location: {
+            file,
+            line: error.lineNumber,
+            ...(error.errorRange === null ? {} : { column: error.errorRange[0] }),
+        },
+    })));
+}
+//# sourceMappingURL=markdownlint.js.map

package/dist/checks/docs/markdownlint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownlint.js","sourceRoot":"","sources":["../../../src/checks/docs/markdownlint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,MAAM,CAAC,MAAM,mBAAmB,GAAG,0BAA0B,CAAC;AAE9D,8FAA8F;AAC9F,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE;CACtD,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,oBAAoB,EAAE,6BAA6B,CAAC,CAAC;AAEhF,oFAAoF;AACpF,MAAM,UAAU,YAAY,CAAC,OAA0B;IACrD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QAC/B,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,CAAC,OAAO,EAAE,GAAG,OAAO,KAAK,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,6FAA6F;AAC7F,SAAS,SAAS,CAAC,MAAc,EAAE,KAAwB,EAAE,KAAK,GAAG,GAAG;IACtE,MAAM,MAAM,GAAG,GAAG,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACrF,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,MAAM,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,MAAM,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,YAAY,CAAC,KAAwC;IAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChG,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,OAA0B;IAChF,MAAM,OAAO,GAAG,CAAC,GAAG,UAAU,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,OAAO;QACL,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE;QACxC,2FAA2F;QAC3F,GAAG;QACH,eAAe;QACf,sBAAsB;QACtB,gBAAgB,YAAY,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG;QACzD,MAAM;QACN,SAAS,CAAC,aAAa,EAAE,CAAC,SAAS,CAAC,CAAC;QACrC,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC;QACnC,sBAAsB;QACtB,2BAA2B;QAC3B,GAAG;QACH,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACvC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;AAE7D,SAAS,QAAQ,CAAC,WAAmB,EAAE,MAAqB;IAC1D,MAAM,IAAI,GAAG,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,KAAK,MAAM,GAAG,CAAC;IAC3F,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;AACjD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,IAAI,WAAW,CAAC,iDAAiD,CAAC,CAAC;IAC9F,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAC5D,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrB,IAAI,EAAE,gBAAgB,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE;QACvD,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,WAAW,CAAC;QAC3D,QAAQ,EAAE;YACR,IAAI;YACJ,IAAI,EAAE,KAAK,CAAC,UAAU;YACtB,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;SACtE;KACF,CAAC,CAAC,CACJ,CAAC;AACJ,CAAC"}

package/dist/checks/docs/references.js

@@ -0,0 +1,82 @@
+import { stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { MARKDOWN_GLOBS, readOwnTexts, readText } from './files.js';
+import { APPLIES, skip } from '../../core/check.js';
+import { markdownLinks, resolveLink } from '../../docs/links.js';
+import { anchors } from '../../docs/markdown.js';
+const MARKDOWN = /\.(?:md|markdown)$/;
+/** GitHub's line anchors on a code file, `#L10` or `#L10-L20`. */
+const LINE_ANCHOR = /^L\d+(?:-L\d+)?$/;
+function lookup(ctx, docs) {
+    const own = new Map(docs.map((doc) => [doc.file, doc.text]));
+    const known = new Map();
+    const found = new Map();
+    return {
+        exists: (path) => {
+            let result = known.get(path);
+            if (result === undefined) {
+                result = stat(join(ctx.root, path)).then(() => true, () => false);
+                known.set(path, result);
+            }
+            return result;
+        },
+        anchorsOf: (path) => {
+            let result = found.get(path);
+            if (result === undefined) {
+                const text = own.get(path);
+                const read = text === undefined ? readText(ctx, path) : Promise.resolve(text);
+                result = read.then((value) => value === undefined
+                    ? undefined
+                    : new Set([...anchors(value)].map((a) => a.toLowerCase())));
+                found.set(path, result);
+            }
+            return result;
+        },
+    };
+}
+function broken(file, link, message) {
+    return {
+        rule: 'docs/broken-link',
+        message,
+        location: { file, line: link.line, column: link.column },
+    };
+}
+async function judgeLink(doc, link, look) {
+    if (/\{\{|\$\{/.test(link.target))
+        return [];
+    const target = resolveLink(doc.file, link.target);
+    if (target.kind !== 'local')
+        return [];
+    const path = target.path === '' ? doc.file : target.path;
+    if (target.path !== '' && !(await look.exists(path))) {
+        return [broken(doc.file, link, `The link to ${link.target} names no file in the repository.`)];
+    }
+    const anchor = target.anchor;
+    if (anchor === undefined || !MARKDOWN.test(path) || LINE_ANCHOR.test(anchor))
+        return [];
+    const known = await look.anchorsOf(path);
+    if (known === undefined || known.has(anchor.toLowerCase()))
+        return [];
+    return [broken(doc.file, link, `The link to ${link.target} names no heading in ${path}.`)];
+}
+async function brokenLinks(ctx) {
+    const docs = await readOwnTexts(ctx, ctx.facts.matching(...MARKDOWN_GLOBS));
+    const look = lookup(ctx, docs);
+    const findings = [];
+    for (const doc of docs) {
+        for (const link of markdownLinks(doc.text)) {
+            findings.push(...(await judgeLink(doc, link, look)));
+        }
+    }
+    return findings;
+}
+/** Markdown links to files and headings of the repository resolve. */
+export const referencesCheck = {
+    id: 'docs/references',
+    tier: 'head',
+    scope: 'repo',
+    title: 'links to files and headings',
+    applies: (ctx) => ctx.facts.has(...MARKDOWN_GLOBS) ? APPLIES : skip('the repository has no Markdown'),
+    run: brokenLinks,
+};
+//# sourceMappingURL=references.js.map

package/dist/checks/docs/references.js.map

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