@cairn-tool/cairn 2.0.0

package/dist/audit-baseline.js

@@ -0,0 +1,124 @@
+import fs from "node:fs";
+import path from "node:path";
+/** The discriminator every document this module writes carries. */
+export const BASELINE_FORMAT = "cairn-md-audit-baseline";
+/** The pre-rename discriminator, still accepted on committed baselines. */
+export const LEGACY_BASELINE_FORMAT = "claude-cli-md-audit-baseline";
+/** True for a document either spelling of this tool wrote. */
+export function isBaselineFormat(value) {
+    return value === BASELINE_FORMAT || value === LEGACY_BASELINE_FORMAT;
+}
+/** The structure version of the baseline document, not the package version. */
+export const BASELINE_VERSION = "1";
+/**
+ * The finding identity a baseline is keyed on.
+ *
+ * Deliberately excludes the line number. A finding does not become a different
+ * finding because unrelated prose was inserted above it, and a line-sensitive
+ * key would turn every reflow into a wall of regressions and force a baseline
+ * refresh on commits that fixed nothing.
+ *
+ * The cost is that two identical findings in one file collapse to one entry;
+ * `count` carries the multiplicity so the second one is still reported.
+ */
+function key(checker, file, message) {
+    return `${checker}\0${file}\0${message}`;
+}
+/** Byte comparison, so ordering never depends on the runner's ICU build. */
+function byBytes(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+/**
+ * Workspace-relative, `/`-separated.
+ *
+ * A baseline holding absolute paths would match nothing after a checkout into
+ * a different directory, which is the normal case in CI.
+ */
+export function baselinePath(file, root) {
+    return path.relative(root, file).split(path.sep).join("/");
+}
+/**
+ * Reads a baseline document.
+ *
+ * A missing or unparseable file throws, matching how `agent audit --baseline`
+ * treats a path that is not there. A *foreign* document is reported as a
+ * finding by `applyBaseline` instead, because guessing at another tool's schema
+ * would produce suppression nobody can trust.
+ */
+export function readBaseline(file) {
+    if (!fs.existsSync(file))
+        throw new Error(`--baseline file does not exist: ${file}`);
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(file, "utf8"));
+    }
+    catch (cause) {
+        throw new Error(`--baseline is not valid JSON: ${file}`, { cause });
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+        throw new Error(`--baseline is not a baseline document: ${file}`);
+    return parsed;
+}
+/** Builds the document `--write-baseline` records. */
+export function buildBaseline(findings, root, generator) {
+    const counts = new Map();
+    for (const issue of findings) {
+        const file = baselinePath(issue.file, root);
+        const id = key(issue.checker, file, issue.message);
+        const entry = counts.get(id);
+        if (entry)
+            entry.count++;
+        else
+            counts.set(id, { checker: issue.checker, file, message: issue.message, count: 1 });
+    }
+    return {
+        baselineFormat: BASELINE_FORMAT,
+        version: BASELINE_VERSION,
+        generator,
+        entries: [...counts.values()].sort((a, b) => byBytes(a.checker, b.checker) || byBytes(a.file, b.file) || byBytes(a.message, b.message)),
+    };
+}
+/**
+ * Partitions findings into those the baseline already recorded and those it did
+ * not.
+ *
+ * Findings are consumed in the order given, so with a baseline `count` of one
+ * and two matching findings the first is suppressed and the second reported.
+ */
+export function applyBaseline(findings, document, root) {
+    if (!isBaselineFormat(document.baselineFormat))
+        return { kept: [...findings], suppressed: 0, matched: 0, stale: [], foreign: true };
+    const remaining = new Map();
+    const entries = new Map();
+    for (const entry of document.entries ?? []) {
+        const id = key(entry.checker, entry.file, entry.message);
+        remaining.set(id, (remaining.get(id) ?? 0) + Math.max(0, entry.count));
+        entries.set(id, entry);
+    }
+    const kept = [];
+    let suppressed = 0;
+    for (const issue of findings) {
+        const id = key(issue.checker, baselinePath(issue.file, root), issue.message);
+        const left = remaining.get(id) ?? 0;
+        if (left > 0) {
+            remaining.set(id, left - 1);
+            suppressed++;
+        }
+        else
+            kept.push(issue);
+    }
+    const stale = [...remaining]
+        .filter(([, left]) => left > 0)
+        .map(([id, left]) => ({ ...entries.get(id), count: left }))
+        .sort((a, b) => byBytes(a.checker, b.checker) || byBytes(a.file, b.file) || byBytes(a.message, b.message));
+    return { kept, suppressed, matched: suppressed, stale, foreign: false };
+}
+/** Writes a baseline document, replacing any existing one. */
+export function writeBaseline(file, document) {
+    const target = path.resolve(file);
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    const temporary = `${target}.${process.pid}.tmp`;
+    fs.writeFileSync(temporary, JSON.stringify(document, null, 2) + "\n");
+    fs.renameSync(temporary, target);
+}
+//# sourceMappingURL=audit-baseline.js.map

package/dist/audit-baseline.js.map

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

package/dist/automation.d.ts

@@ -0,0 +1,16 @@
+import type { Issue, OutputFormat } from "./types.js";
+export interface DiagnosticSummary {
+    files: number;
+    findings: number;
+    [key: string]: unknown;
+}
+export declare function formatJsonl(issues: readonly Issue[], summary: DiagnosticSummary): string;
+/**
+ * SARIF for `md` diagnostics.
+ *
+ * `level` is `"error"` for every finding. That is the current published
+ * contract for these commands, not an oversight — `Issue` carries no severity,
+ * so changing it would be a breaking change for consumers gating on it.
+ */
+export declare function formatSarif(issues: readonly Issue[]): string;
+export declare function formatDiagnostics(issues: readonly Issue[], format: OutputFormat, summary: DiagnosticSummary): string | undefined;

package/dist/automation.js

@@ -0,0 +1,38 @@
+import { sarifDocument } from "./sarif.js";
+export function formatJsonl(issues, summary) {
+    return [
+        ...issues.map((issue) => JSON.stringify({ type: "finding", ...issue })),
+        JSON.stringify({ type: "summary", ...summary }),
+    ].join("\n");
+}
+/**
+ * SARIF for `md` diagnostics.
+ *
+ * `level` is `"error"` for every finding. That is the current published
+ * contract for these commands, not an oversight — `Issue` carries no severity,
+ * so changing it would be a breaking change for consumers gating on it.
+ */
+export function formatSarif(issues) {
+    const ids = [...new Set(issues.map((issue) => issue.checker))].sort();
+    return sarifDocument(ids.map((id) => ({ id, name: id })), issues.map((issue) => ({
+        ruleId: issue.checker,
+        level: "error",
+        message: { text: issue.message },
+        locations: [
+            {
+                physicalLocation: {
+                    artifactLocation: { uri: issue.file },
+                    region: { startLine: Math.max(1, issue.line) },
+                },
+            },
+        ],
+    })));
+}
+export function formatDiagnostics(issues, format, summary) {
+    if (format === "jsonl")
+        return formatJsonl(issues, summary);
+    if (format === "sarif")
+        return formatSarif(issues);
+    return undefined;
+}
+//# sourceMappingURL=automation.js.map

package/dist/automation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation.js","sourceRoot":"","sources":["../src/automation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAQ3C,MAAM,UAAU,WAAW,CAAC,MAAwB,EAAE,OAA0B;IAC9E,OAAO;QACL,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,CAAC;KAChD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,MAAwB;IAClD,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACtE,OAAO,aAAa,CAClB,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EACnC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrB,MAAM,EAAE,KAAK,CAAC,OAAO;QACrB,KAAK,EAAE,OAAgB;QACvB,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE;QAChC,SAAS,EAAE;YACT;gBACE,gBAAgB,EAAE;oBAChB,gBAAgB,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE;oBACrC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;iBAC/C;aACF;SACF;KACF,CAAC,CAAC,CACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,MAAwB,EACxB,MAAoB,EACpB,OAA0B;IAE1B,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5D,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;IACnD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/backlinks.d.ts

@@ -0,0 +1,15 @@
+export interface IncomingReference {
+    sourceFile: string;
+    line: number;
+    linkText: string;
+    rawTarget: string;
+    /** The reference's `#fragment`, decoded, when it carried one. */
+    fragment?: string;
+}
+/**
+ * Every local reference in `files` that resolves to `targetPath`.
+ *
+ * Paths are absolute on both sides; callers map them for display. External and
+ * anchor-only references are skipped, matching the workspace graph.
+ */
+export declare function documentsReferencing(files: readonly string[], targetPath: string): IncomingReference[];

package/dist/backlinks.js

@@ -0,0 +1,30 @@
+import { resolveLocalPath, splitLocalTarget } from "./link-target.js";
+import { runtime } from "./runtime.js";
+/**
+ * Every local reference in `files` that resolves to `targetPath`.
+ *
+ * Paths are absolute on both sides; callers map them for display. External and
+ * anchor-only references are skipped, matching the workspace graph.
+ */
+export function documentsReferencing(files, targetPath) {
+    const root = runtime().config.root;
+    const found = [];
+    for (const file of files) {
+        for (const reference of runtime().workspace.document(file).references) {
+            if (reference.isExternal || reference.isAnchorOnly)
+                continue;
+            const parsed = splitLocalTarget(reference.target);
+            if (resolveLocalPath(file, parsed.path, root) !== targetPath)
+                continue;
+            found.push({
+                sourceFile: file,
+                line: reference.line,
+                linkText: reference.linkText,
+                rawTarget: reference.target,
+                ...(parsed.fragment === undefined ? {} : { fragment: parsed.fragment }),
+            });
+        }
+    }
+    return found;
+}
+//# sourceMappingURL=backlinks.js.map

package/dist/backlinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlinks.js","sourceRoot":"","sources":["../src/backlinks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAWvC;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAwB,EACxB,UAAkB;IAElB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;IACnC,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;YACtE,IAAI,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,YAAY;gBAAE,SAAS;YAC7D,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAClD,IAAI,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,UAAU;gBAAE,SAAS;YACvE,KAAK,CAAC,IAAI,CAAC;gBACT,UAAU,EAAE,IAAI;gBAChB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,QAAQ,EAAE,SAAS,CAAC,QAAQ;gBAC5B,SAAS,EAAE,SAAS,CAAC,MAAM;gBAC3B,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;aACxE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/checkers/katex.d.ts

@@ -0,0 +1,3 @@
+import type { Issue } from "../types.js";
+import { type Root } from "../markdown-ast.js";
+export declare function checkKatex(filePath: string, content: string, issues: Issue[], tree?: Root): void;

package/dist/checkers/katex.js

@@ -0,0 +1,71 @@
+import katex from "katex";
+import { parseMarkdown, extractCodeBlocks, isLineInCodeBlock } from "../markdown-ast.js";
+function validateKatexExpression(filePath, lineNum, expr, displayMode, issues) {
+    if (!expr.trim())
+        return;
+    try {
+        katex.renderToString(expr, {
+            throwOnError: true,
+            strict: "error",
+            displayMode,
+        });
+    }
+    catch (err) {
+        issues.push({
+            file: filePath,
+            line: lineNum,
+            checker: "katex",
+            message: `Invalid ${displayMode ? "display" : "inline"} math: ${err.message}`,
+        });
+    }
+}
+export function checkKatex(filePath, content, issues, tree) {
+    const parsedTree = tree ?? parseMarkdown(content);
+    const codeBlocks = extractCodeBlocks(parsedTree);
+    const lines = content.split("\n");
+    let inDisplayMath = false;
+    let displayMathStart = 0;
+    let displayMathBuffer = "";
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNum = i + 1;
+        if (isLineInCodeBlock(lineNum, codeBlocks))
+            continue;
+        // Handle display math blocks ($$...$$)
+        if (inDisplayMath) {
+            if (line.includes("$$")) {
+                displayMathBuffer += "\n" + line.substring(0, line.indexOf("$$"));
+                validateKatexExpression(filePath, displayMathStart, displayMathBuffer.trim(), true, issues);
+                inDisplayMath = false;
+                displayMathBuffer = "";
+            }
+            else {
+                displayMathBuffer += "\n" + line;
+            }
+            continue;
+        }
+        // Check for display math start
+        const displayStart = line.indexOf("$$");
+        if (displayStart !== -1) {
+            const afterStart = line.substring(displayStart + 2);
+            const displayEnd = afterStart.indexOf("$$");
+            if (displayEnd !== -1) {
+                const expr = afterStart.substring(0, displayEnd);
+                validateKatexExpression(filePath, lineNum, expr, true, issues);
+            }
+            else {
+                inDisplayMath = true;
+                displayMathStart = lineNum;
+                displayMathBuffer = afterStart;
+            }
+            continue;
+        }
+        // Check for inline math ($...$) — avoid matching escaped \$ and $$
+        const inlineRe = /(?<![\\$])\$(?!\$)(.+?)(?<![\\$])\$/g;
+        let inlineMatch;
+        while ((inlineMatch = inlineRe.exec(line)) !== null) {
+            validateKatexExpression(filePath, lineNum, inlineMatch[1], false, issues);
+        }
+    }
+}
+//# sourceMappingURL=katex.js.map

package/dist/checkers/katex.js.map

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

package/dist/checkers/markdown-lint.d.ts

@@ -0,0 +1,28 @@
+import type { Issue } from "../types.js";
+/** A markdownlint autofix, as the library describes it. */
+export interface MarkdownlintFixInfo {
+    /** Defaults to the finding's own line. */
+    lineNumber?: number;
+    /** 1-based column on the terminator-stripped line. */
+    editColumn?: number;
+    /** Characters to remove; -1 means the whole line, including its terminator. */
+    deleteCount?: number;
+    insertText?: string;
+}
+export interface MarkdownlintError {
+    lineNumber: number;
+    ruleNames: string[];
+    ruleDescription: string;
+    errorDetail?: string;
+    /** Present only for rules that know how to repair themselves. */
+    fixInfo?: MarkdownlintFixInfo | null;
+}
+export declare function loadMarkdownlintConfig(userConfigPath?: string): Promise<Record<string, unknown>>;
+/**
+ * Lints in-memory content, returning markdownlint's own findings.
+ *
+ * Exposed separately from `checkMarkdownLint` so `md fix` can read `fixInfo`,
+ * which the `Issue` shape has nowhere to carry.
+ */
+export declare function lintContent(filePath: string, content: string, config: Record<string, unknown>): Promise<MarkdownlintError[]>;
+export declare function checkMarkdownLint(filePath: string, content: string, issues: Issue[], userConfigPath?: string): Promise<void>;

package/dist/checkers/markdown-lint.js

@@ -0,0 +1,53 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { lint } from "markdownlint/async";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const configPath = path.join(__dirname, "..", "..", ".markdownlintrc");
+export async function loadMarkdownlintConfig(userConfigPath) {
+    let config = {};
+    if (fs.existsSync(configPath)) {
+        config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    }
+    if (userConfigPath) {
+        if (!fs.existsSync(userConfigPath)) {
+            throw new Error(`Markdownlint configuration not found: ${userConfigPath}`);
+        }
+        const extension = path.extname(userConfigPath).toLowerCase();
+        const raw = fs.readFileSync(userConfigPath, "utf-8");
+        const userConfig = extension === ".json"
+            ? JSON.parse(raw)
+            : (await import("yaml")).parse(raw);
+        config = { ...config, ...userConfig };
+    }
+    return config;
+}
+/**
+ * Lints in-memory content, returning markdownlint's own findings.
+ *
+ * Exposed separately from `checkMarkdownLint` so `md fix` can read `fixInfo`,
+ * which the `Issue` shape has nowhere to carry.
+ */
+export async function lintContent(filePath, content, config) {
+    const results = await new Promise((resolve, reject) => {
+        lint({ strings: { [filePath]: content }, config }, (err, result) => {
+            if (err)
+                reject(err);
+            else
+                resolve(result);
+        });
+    });
+    return results[filePath] || [];
+}
+export async function checkMarkdownLint(filePath, content, issues, userConfigPath) {
+    const config = await loadMarkdownlintConfig(userConfigPath);
+    for (const r of await lintContent(filePath, content, config)) {
+        issues.push({
+            file: filePath,
+            line: r.lineNumber,
+            checker: `markdownlint/${r.ruleNames[0]}`,
+            message: `${r.ruleDescription}${r.errorDetail ? ": " + r.errorDetail : ""}`,
+        });
+    }
+}
+//# sourceMappingURL=markdown-lint.js.map

package/dist/checkers/markdown-lint.js.map

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

package/dist/checkers/mermaid.d.ts

@@ -0,0 +1,6 @@
+import type { Issue } from "../types.js";
+import { type Root } from "../markdown-ast.js";
+type Mermaid = (typeof import("mermaid"))["default"];
+export declare function loadMermaid(): Promise<Mermaid>;
+export declare function checkMermaid(filePath: string, content: string, issues: Issue[], tree?: Root, loader?: () => Promise<Mermaid>): Promise<void>;
+export {};

package/dist/checkers/mermaid.js

@@ -0,0 +1,53 @@
+import { parseMarkdown, extractCodeBlocks } from "../markdown-ast.js";
+let mermaidPromise;
+let parseQueue = Promise.resolve();
+export function loadMermaid() {
+    mermaidPromise ??= (async () => {
+        const { JSDOM } = await import("jsdom");
+        const dom = new JSDOM("<!DOCTYPE html><html><body></body></html>");
+        globalThis.window = dom.window;
+        globalThis.document = dom.window.document;
+        Object.defineProperty(globalThis, "navigator", {
+            value: dom.window.navigator,
+            writable: true,
+            configurable: true,
+        });
+        globalThis.DOMParser = dom.window.DOMParser;
+        globalThis.XMLSerializer = dom.window.XMLSerializer;
+        const mermaid = (await import("mermaid")).default;
+        mermaid.initialize({ startOnLoad: false });
+        return mermaid;
+    })();
+    return mermaidPromise;
+}
+async function serializedParse(mermaid, value) {
+    const work = parseQueue.then(async () => {
+        await mermaid.parse(value);
+    });
+    parseQueue = work.catch(() => undefined);
+    return work;
+}
+export async function checkMermaid(filePath, content, issues, tree, loader = loadMermaid) {
+    const parsedTree = tree ?? parseMarkdown(content);
+    const mermaidBlocks = extractCodeBlocks(parsedTree).filter((b) => b.lang === "mermaid");
+    if (mermaidBlocks.length === 0)
+        return;
+    const mermaid = await loader();
+    for (const block of mermaidBlocks) {
+        // Line of actual content (skip the opening fence)
+        const blockStartLine = block.line + 1;
+        try {
+            await serializedParse(mermaid, block.value);
+        }
+        catch (err) {
+            const msg = err.message || String(err);
+            issues.push({
+                file: filePath,
+                line: blockStartLine,
+                checker: "mermaid",
+                message: `Mermaid syntax error: ${msg.split("\n")[0]}`,
+            });
+        }
+    }
+}
+//# sourceMappingURL=mermaid.js.map

package/dist/checkers/mermaid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.js","sourceRoot":"","sources":["../../src/checkers/mermaid.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAa,MAAM,oBAAoB,CAAC;AAGjF,IAAI,cAA4C,CAAC;AACjD,IAAI,UAAU,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;AAElD,MAAM,UAAU,WAAW;IACzB,cAAc,KAAK,CAAC,KAAK,IAAI,EAAE;QAC7B,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACnE,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,MAA+C,CAAC;QACxE,UAAU,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC1C,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,WAAW,EAAE;YAC7C,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,UAAU,CAAC,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,SAAwC,CAAC;QAC3E,UAAU,CAAC,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,aAAgD,CAAC;QACvF,MAAM,OAAO,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;QAClD,OAAO,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3C,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,EAAE,CAAC;IACL,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,OAAgB,EAAE,KAAa;IAC5D,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;QACtC,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IACH,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,OAAe,EACf,MAAe,EACf,IAAW,EACX,SAAiC,WAAW;IAE5C,MAAM,UAAU,GAAG,IAAI,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,aAAa,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IACxF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACvC,MAAM,OAAO,GAAG,MAAM,MAAM,EAAE,CAAC;IAE/B,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,kDAAkD;QAClD,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QAEtC,IAAI,CAAC;YACH,MAAM,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAI,GAAa,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,SAAS;gBAClB,OAAO,EAAE,yBAAyB,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;aACvD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/checkers/references.d.ts

@@ -0,0 +1,3 @@
+import type { Issue } from "../types.js";
+import { type Root } from "../markdown-ast.js";
+export declare function checkReferences(filePath: string, content: string, issues: Issue[], tree?: Root): void;

package/dist/checkers/references.js

@@ -0,0 +1,55 @@
+import fs from "node:fs";
+import { extractReferences } from "../refs.js";
+import { parseMarkdown, extractHeadings } from "../markdown-ast.js";
+import { splitLocalTarget, resolveLocalPath } from "../link-target.js";
+import { runtime } from "../runtime.js";
+function checkAnchor(sourceFile, targetContent, lineNum, anchor, issues) {
+    const tree = typeof targetContent === "string" ? parseMarkdown(targetContent) : targetContent;
+    const headingSlugs = new Set(extractHeadings(tree).map((h) => h.slug));
+    if (!headingSlugs.has(anchor)) {
+        issues.push({
+            file: sourceFile,
+            line: lineNum,
+            checker: "ref/anchor",
+            message: `Heading anchor not found: #${anchor}`,
+        });
+    }
+}
+export function checkReferences(filePath, content, issues, tree) {
+    const parsedTree = tree ?? parseMarkdown(content);
+    const refs = extractReferences(parsedTree);
+    for (const ref of refs) {
+        if (ref.isExternal)
+            continue;
+        if (ref.isAnchorOnly) {
+            const target = splitLocalTarget(ref.target);
+            checkAnchor(filePath, parsedTree, ref.line, target.fragment ?? "", issues);
+            continue;
+        }
+        const target = splitLocalTarget(ref.target);
+        const targetFile = target.path;
+        const anchor = target.fragment;
+        if (targetFile) {
+            const resolvedPath = resolveLocalPath(filePath, targetFile, runtime().config.root);
+            if (!fs.existsSync(resolvedPath)) {
+                issues.push({
+                    file: filePath,
+                    line: ref.line,
+                    checker: ref.isImage ? "ref/image" : "ref/link",
+                    message: `${ref.isImage ? "Image" : "Link"} target not found: ${targetFile}`,
+                });
+                continue;
+            }
+            if (anchor) {
+                try {
+                    const targetDocument = runtime().workspace.document(resolvedPath);
+                    checkAnchor(filePath, targetDocument.tree, ref.line, anchor, issues);
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=references.js.map

package/dist/checkers/references.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};