@cairn-tool/cairn 2.0.0

package/dist/commands/graph.js

@@ -0,0 +1,122 @@
+import fs from "node:fs";
+import path from "node:path";
+import { buildWorkspaceGraph, focusGraph } from "../graph.js";
+import { outputPath, runtime } from "../runtime.js";
+import { requireDirectory } from "../input.js";
+import { terminate } from "../command-result.js";
+import { jsonPayload } from "../result.js";
+import { boundedInteger } from "../option-utils.js";
+function displayed(graph, opts, focus) {
+    const show = (file) => outputPath(file, opts);
+    return {
+        files: graph.nodes.length,
+        ...(focus ? { focus } : {}),
+        nodes: graph.nodes.map((node) => ({ ...node, file: show(node.file) })),
+        edges: graph.edges.map((edge) => ({
+            ...edge,
+            source: show(edge.source),
+            target: show(edge.target),
+        })),
+        broken: graph.broken.map((edge) => ({
+            ...edge,
+            source: show(edge.source),
+            resolved: show(edge.resolved),
+        })),
+        entries: graph.entries.map(show),
+        reachabilityEvaluated: graph.reachabilityEvaluated,
+        unreachable: graph.unreachable.map(show),
+        deadEnds: graph.nodes.filter((node) => node.deadEnd).map((node) => show(node.file)),
+        components: graph.components.map((group) => group.map(show)),
+        cycles: graph.cycles.map((group) => group.map(show)),
+    };
+}
+function rawGraph(graph, opts) {
+    const ids = new Map(graph.nodes.map((node, index) => [node.file, `n${index}`]));
+    const label = (file) => outputPath(file, opts).replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    if (opts.output === "mermaid") {
+        return [
+            "flowchart LR",
+            ...graph.nodes.map((node) => `  ${ids.get(node.file)}["${label(node.file)}"]`),
+            ...graph.edges.map((edge) => `  ${ids.get(edge.source)} --> ${ids.get(edge.target)}`),
+        ].join("\n");
+    }
+    return [
+        "digraph markdown {",
+        ...graph.nodes.map((node) => `  ${ids.get(node.file)} [label="${label(node.file)}"];`),
+        ...graph.edges.map((edge) => `  ${ids.get(edge.source)} -> ${ids.get(edge.target)};`),
+        "}",
+    ].join("\n");
+}
+export async function graphAction(directory, opts) {
+    if (!["report", "mermaid", "dot"].includes(opts.output)) {
+        throw new Error("--output must be report, mermaid, or dot");
+    }
+    const dir = requireDirectory(directory, opts);
+    const files = runtime().workspace.markdownFiles(dir, {
+        include: opts.include,
+        exclude: opts.exclude,
+    });
+    const entries = opts.entry.map((entry) => path.resolve(entry));
+    for (const entry of entries)
+        if (!fs.existsSync(entry) || !fs.statSync(entry).isFile())
+            throw new Error(`Entry point not found: ${entry}`);
+    const full = buildWorkspaceGraph(runtime().workspace, files, entries);
+    // The neighborhood is projected from the complete graph, so a link leaving
+    // the radius stays a resolved edge rather than becoming a fabricated broken
+    // target. See focusGraph.
+    let graph = full;
+    let focus;
+    if (opts.focus.length) {
+        const depth = boundedInteger(opts.depth, "depth", 6);
+        const selected = new Set(full.nodes.map((node) => node.file));
+        const roots = opts.focus.map((file) => path.resolve(file));
+        for (const root of roots)
+            if (!selected.has(root))
+                throw new Error(`Focus document not in the selected set: ${root}`);
+        graph = focusGraph(full, roots, depth);
+        focus = {
+            files: roots.map((file) => outputPath(file, opts)),
+            depth,
+            nodes: graph.nodes.length,
+            omitted: full.nodes.length - graph.nodes.length,
+        };
+    }
+    const actionable = graph.broken.length + graph.unreachable.length;
+    if (opts.output !== "report") {
+        process.stdout.write(rawGraph(graph, opts) + "\n");
+        if (actionable)
+            terminate(2);
+        return;
+    }
+    const report = displayed(graph, opts, focus);
+    if (opts.format === "json") {
+        (actionable ? process.stderr : process.stdout).write(jsonPayload("md graph", report, opts, {
+            exitCode: actionable ? 2 : 0,
+            summary: { broken: graph.broken.length, unreachable: graph.unreachable.length },
+        }));
+    }
+    else {
+        const value = report;
+        const lines = [
+            `Graph: ${value.files} document(s), ${graph.edges.length} edge(s)`,
+            ...(focus
+                ? [
+                    `Focus: ${focus.files.join(", ")} at depth ${focus.depth} (${focus.omitted} document(s) omitted)`,
+                ]
+                : []),
+            `Broken targets: ${value.broken.length}`,
+            `Reachability: ${value.reachabilityEvaluated ? `${value.unreachable.length} unreachable` : "not evaluated (no entry points)"}`,
+            `Dead ends: ${value.deadEnds.length}`,
+            `Weak components: ${value.components.length}`,
+            `Cycles: ${value.cycles.length}`,
+        ];
+        for (const edge of graph.broken)
+            lines.push(`  ${outputPath(edge.source, opts)}:${edge.line} [graph/broken] ${edge.target}`);
+        for (const file of graph.unreachable)
+            lines.push(`  ${outputPath(file, opts)} [graph/unreachable]`);
+        (actionable ? process.stderr : process.stdout).write(lines.join("\n") + "\n");
+    }
+    if (actionable)
+        terminate(2);
+}
+//# sourceMappingURL=graph.js.map

package/dist/commands/graph.js.map

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

package/dist/commands/headers.d.ts

@@ -0,0 +1,7 @@
+interface HeadersOptions {
+    envelope?: boolean;
+    format: string;
+    maxDepth: string;
+}
+export declare function headersAction(file: string, opts: HeadersOptions): Promise<void>;
+export {};

package/dist/commands/headers.js

@@ -0,0 +1,48 @@
+import { outputPath, runtime } from "../runtime.js";
+import { requireFile } from "../input.js";
+import { jsonPayload } from "../result.js";
+function resolveFormat(opts) {
+    const fmt = opts.format;
+    if (fmt === "llm" || fmt === "human" || fmt === "json")
+        return fmt;
+    return "llm";
+}
+export async function headersAction(file, opts) {
+    const format = resolveFormat(opts);
+    const filePath = requireFile(file, opts);
+    const shownPath = outputPath(filePath, opts);
+    const maxDepth = Math.min(6, Math.max(1, parseInt(opts.maxDepth, 10) || 6));
+    const headings = runtime()
+        .workspace.document(filePath)
+        .headings.filter((heading) => heading.depth <= maxDepth);
+    if (format === "json") {
+        process.stdout.write(jsonPayload("md headers", headings, opts));
+        return;
+    }
+    if (headings.length === 0) {
+        if (format === "human") {
+            process.stdout.write(`\x1b[33mNo headings found in ${shownPath}\x1b[0m\n`);
+        }
+        else {
+            process.stdout.write(`No headings found in ${shownPath}\n`);
+        }
+        return;
+    }
+    const lines = [];
+    if (format === "human") {
+        lines.push(`\n\x1b[1m${headings.length} heading(s) in ${shownPath}\x1b[0m\n`);
+        for (const h of headings) {
+            const prefix = "#".repeat(h.depth);
+            lines.push(`  \x1b[36mL${h.line}\x1b[0m  \x1b[33m${prefix}\x1b[0m ${h.text}`);
+        }
+    }
+    else {
+        lines.push(`${headings.length} heading(s) in ${shownPath}:`);
+        for (const h of headings) {
+            const prefix = "#".repeat(h.depth);
+            lines.push(`  L${h.line}  ${prefix} ${h.text}`);
+        }
+    }
+    process.stdout.write(lines.join("\n") + "\n");
+}
+//# sourceMappingURL=headers.js.map

package/dist/commands/headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.js","sourceRoot":"","sources":["../../src/commands/headers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQ3C,SAAS,aAAa,CAAC,IAAoB;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;IACxB,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,GAAG,CAAC;IACnE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,IAAoB;IACpE,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE5E,MAAM,QAAQ,GAAG,OAAO,EAAE;SACvB,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;SAC5B,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC,CAAC;IAE3D,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QAChE,OAAO;IACT,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,SAAS,WAAW,CAAC,CAAC;QAC7E,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,SAAS,IAAI,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,YAAY,QAAQ,CAAC,MAAM,kBAAkB,SAAS,WAAW,CAAC,CAAC;QAC9E,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,oBAAoB,MAAM,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,kBAAkB,SAAS,GAAG,CAAC,CAAC;QAC7D,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AAChD,CAAC"}

package/dist/commands/index.d.ts

@@ -0,0 +1,8 @@
+interface IndexOptions {
+    envelope?: boolean;
+    format: string;
+    include: string[];
+    exclude: string[];
+}
+export declare function indexAction(action: string, directory: string, opts: IndexOptions): Promise<void>;
+export {};

package/dist/commands/index.js

@@ -0,0 +1,32 @@
+import { requireDirectory } from "../input.js";
+import { outputPath, runtime } from "../runtime.js";
+import { jsonPayload } from "../result.js";
+export async function indexAction(action, directory, opts) {
+    if (!["status", "build", "clear"].includes(action)) {
+        throw new Error("Index action must be status, build, or clear");
+    }
+    const dir = requireDirectory(directory, opts);
+    if (action === "clear") {
+        runtime().workspace.clearIndex();
+        const result = { action, directory: outputPath(dir, opts), cleared: true };
+        process.stdout.write(opts.format === "json"
+            ? jsonPayload("md index", result, opts)
+            : `Cleared workspace index for ${result.directory}\n`);
+        return;
+    }
+    const files = runtime().workspace.markdownFiles(dir, {
+        include: opts.include,
+        exclude: opts.exclude,
+    });
+    const status = action === "build"
+        ? runtime().workspace.rebuildIndex(dir, files)
+        : runtime().workspace.indexStatus(files);
+    const result = { action, directory: outputPath(dir, opts), ...status };
+    if (opts.format === "json") {
+        process.stdout.write(jsonPayload("md index", result, opts));
+        return;
+    }
+    const prefix = action === "build" ? "Built" : "Workspace index";
+    process.stdout.write(`${prefix} for ${result.directory}: ${status.current} current, ${status.stale} stale, ${status.missing} missing (${status.indexed} indexed)\nCache: ${status.cachePath}\n`);
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAS3C,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAc,EACd,SAAiB,EACjB,IAAkB;IAElB,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,GAAG,GAAG,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC9C,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3E,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,MAAM,KAAK,MAAM;YACpB,CAAC,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC;YACvC,CAAC,CAAC,+BAA+B,MAAM,CAAC,SAAS,IAAI,CACxD,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE;QACnD,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAC;IACH,MAAM,MAAM,GACV,MAAM,KAAK,OAAO;QAChB,CAAC,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC;QAC9C,CAAC,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;IACvE,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5D,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,MAAM,QAAQ,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,OAAO,aAAa,MAAM,CAAC,KAAK,WAAW,MAAM,CAAC,OAAO,aAAa,MAAM,CAAC,OAAO,qBAAqB,MAAM,CAAC,SAAS,IAAI,CAC3K,CAAC;AACJ,CAAC"}

package/dist/commands/links.d.ts

@@ -0,0 +1,9 @@
+interface LinksOptions {
+    envelope?: boolean;
+    format: string;
+    brokenOnly: boolean;
+    type?: string;
+    stdinName?: string;
+}
+export declare function linksAction(file: string, opts: LinksOptions): Promise<void>;
+export {};

package/dist/commands/links.js

@@ -0,0 +1,123 @@
+import fs from "node:fs";
+import { splitLocalTarget, resolveLocalPath } from "../link-target.js";
+import { outputPath, runtime } from "../runtime.js";
+import { terminate } from "../command-result.js";
+import { requireFile } from "../input.js";
+import { jsonPayload } from "../result.js";
+function resolveFormat(opts) {
+    const fmt = opts.format;
+    if (fmt === "llm" || fmt === "human" || fmt === "json")
+        return fmt;
+    return "llm";
+}
+function classifyLink(link) {
+    if (link.isImage)
+        return "image";
+    if (link.isExternal)
+        return "external";
+    if (link.isAnchorOnly)
+        return "anchor";
+    return "internal";
+}
+function checkExists(link, sourceFile) {
+    if (link.isExternal || link.isAnchorOnly)
+        return null;
+    const targetFile = splitLocalTarget(link.target).path;
+    const resolvedPath = resolveLocalPath(sourceFile, targetFile, runtime().config.root);
+    return fs.existsSync(resolvedPath);
+}
+export async function linksAction(file, opts) {
+    if (file === "-" && !opts.stdinName)
+        throw new Error("--stdin-name is required for links with stdin");
+    const format = resolveFormat(opts);
+    const filePath = requireFile(file, opts);
+    const shownPath = outputPath(filePath, opts);
+    const document = runtime().workspace.document(filePath);
+    const contentLines = document.lines;
+    let links = document.references;
+    // Filter by type
+    if (opts.type) {
+        links = links.filter((l) => classifyLink(l) === opts.type);
+    }
+    // Check existence and optionally filter to broken only
+    const resolved = links.map((l) => ({
+        line: l.line,
+        linkText: l.linkText,
+        target: l.target,
+        isImage: l.isImage,
+        isExternal: l.isExternal,
+        isAnchorOnly: l.isAnchorOnly,
+        type: classifyLink(l),
+        exists: checkExists(l, filePath),
+        context: contentLines[l.line - 1]?.trim() ?? "",
+    }));
+    const filtered = opts.brokenOnly ? resolved.filter((r) => r.exists === false) : resolved;
+    if (format === "json") {
+        process.stdout.write(jsonPayload("md links", filtered, opts));
+        return;
+    }
+    if (filtered.length === 0) {
+        if (format === "human") {
+            const msg = opts.brokenOnly ? "No broken links" : "No links";
+            process.stdout.write(`\x1b[32m✔ ${msg} found in ${shownPath}\x1b[0m\n`);
+        }
+        else {
+            const msg = opts.brokenOnly ? "No broken links" : "No links";
+            process.stdout.write(`${msg} found in ${shownPath}\n`);
+        }
+        return;
+    }
+    // Group by type
+    const groups = new Map();
+    for (const l of filtered) {
+        const existing = groups.get(l.type) ?? [];
+        existing.push(l);
+        groups.set(l.type, existing);
+    }
+    const lines = [];
+    const isHuman = format === "human";
+    if (isHuman) {
+        lines.push(`\n\x1b[1m${filtered.length} link(s) in ${shownPath}\x1b[0m\n`);
+    }
+    else {
+        lines.push(`${filtered.length} link(s) in ${shownPath}:`);
+    }
+    for (const [type, groupLinks] of groups) {
+        if (isHuman) {
+            lines.push(`  \x1b[1;33m${type}\x1b[0m (${groupLinks.length})`);
+        }
+        else {
+            lines.push(`  ${type} (${groupLinks.length}):`);
+        }
+        for (const l of groupLinks) {
+            const status = l.exists === null
+                ? isHuman
+                    ? "\x1b[90m—\x1b[0m"
+                    : " "
+                : l.exists
+                    ? isHuman
+                        ? "\x1b[32m✔\x1b[0m"
+                        : "[exists]"
+                    : isHuman
+                        ? "\x1b[1;31m✖\x1b[0m"
+                        : "[MISSING]";
+            if (isHuman) {
+                lines.push(`    ${status} \x1b[36mL${l.line}\x1b[0m ${l.target}`);
+                lines.push(`       ${l.context}`);
+            }
+            else {
+                lines.push(`    L${l.line} ${status} ${l.target}`);
+                lines.push(`      ${l.context}`);
+            }
+        }
+    }
+    const broken = filtered.filter((l) => l.exists === false);
+    if (broken.length > 0) {
+        process.stderr.write(lines.join("\n") + "\n");
+        terminate(2);
+    }
+    else {
+        process.stdout.write(lines.join("\n") + "\n");
+    }
+}
+//# sourceMappingURL=links.js.map

package/dist/commands/links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../../src/commands/links.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAGzB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAU3C,SAAS,aAAa,CAAC,IAAkB;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;IACxB,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,GAAG,CAAC;IACnE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,IAAI,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC;IACjC,IAAI,IAAI,CAAC,UAAU;QAAE,OAAO,UAAU,CAAC;IACvC,IAAI,IAAI,CAAC,YAAY;QAAE,OAAO,QAAQ,CAAC;IACvC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,UAAkB;IACnD,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;IACtD,MAAM,YAAY,GAAG,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrF,OAAO,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,IAAkB;IAChE,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS;QACjC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAE7C,MAAM,QAAQ,GAAG,OAAO,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC;IACpC,IAAI,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC;IAEhC,iBAAiB;IACjB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,uDAAuD;IACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACjC,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;QACrB,MAAM,EAAE,WAAW,CAAC,CAAC,EAAE,QAAQ,CAAC;QAChC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;KAChD,CAAC,CAAC,CAAC;IAEJ,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAEzF,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,UAAU,CAAC;YAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,GAAG,aAAa,SAAS,WAAW,CAAC,CAAC;QAC1E,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,UAAU,CAAC;YAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,aAAa,SAAS,IAAI,CAAC,CAAC;QACzD,CAAC;QACD,OAAO;IACT,CAAC;IAED,gBAAgB;IAChB,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,MAAM,KAAK,OAAO,CAAC;IAEnC,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,YAAY,QAAQ,CAAC,MAAM,eAAe,SAAS,WAAW,CAAC,CAAC;IAC7E,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,eAAe,SAAS,GAAG,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,EAAE,CAAC;QACxC,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,YAAY,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC;QAClD,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,MAAM,MAAM,GACV,CAAC,CAAC,MAAM,KAAK,IAAI;gBACf,CAAC,CAAC,OAAO;oBACP,CAAC,CAAC,kBAAkB;oBACpB,CAAC,CAAC,GAAG;gBACP,CAAC,CAAC,CAAC,CAAC,MAAM;oBACR,CAAC,CAAC,OAAO;wBACP,CAAC,CAAC,kBAAkB;wBACpB,CAAC,CAAC,UAAU;oBACd,CAAC,CAAC,OAAO;wBACP,CAAC,CAAC,oBAAoB;wBACtB,CAAC,CAAC,WAAW,CAAC;YAEtB,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,aAAa,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;gBAClE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,MAAM,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;gBACnD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QAC9C,SAAS,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/commands/lint-dir.d.ts

@@ -0,0 +1,15 @@
+interface LintDirOptions {
+    envelope?: boolean;
+    format: string;
+    style: boolean;
+    summary: boolean;
+    concurrency: string;
+    include: string[];
+    exclude: string[];
+    mermaid: boolean;
+    katex: boolean;
+    references: boolean;
+    changedSince?: string;
+}
+export declare function lintDirAction(directory: string, opts: LintDirOptions): Promise<void>;
+export {};

package/dist/commands/lint-dir.js

@@ -0,0 +1,156 @@
+import { lintFile, findMarkdownFiles } from "../lint.js";
+import { formatIssues } from "../formatters.js";
+import { outputPath, runtime } from "../runtime.js";
+import { terminate } from "../command-result.js";
+import { requireDirectory } from "../input.js";
+import { changedMarkdownFiles } from "../input-selection.js";
+import { jsonPayload } from "../result.js";
+function resolveFormat(opts) {
+    const fmt = opts.format;
+    if (["llm", "human", "json", "jsonl", "sarif"].includes(fmt))
+        return fmt;
+    return "llm";
+}
+export async function lintDirAction(directory, opts) {
+    const format = resolveFormat(opts);
+    const dirPath = requireDirectory(directory, opts);
+    const shownDir = outputPath(dirPath, opts);
+    let mdFiles;
+    try {
+        mdFiles = findMarkdownFiles(dirPath, { include: opts.include, exclude: opts.exclude });
+        if (opts.changedSince) {
+            const changed = new Set(changedMarkdownFiles(opts.changedSince));
+            mdFiles = mdFiles.filter((file) => changed.has(file));
+        }
+    }
+    catch (error) {
+        process.stderr.write(`Error: ${error.message}\n`);
+        terminate(1);
+    }
+    if (mdFiles.length === 0) {
+        if (format === "json") {
+            process.stdout.write(jsonPayload("md lint-dir", [], opts, { summary: { findings: 0 } }));
+        }
+        else if (format === "jsonl" || format === "sarif") {
+            process.stdout.write(formatIssues([], shownDir, format, { files: 0 }) + "\n");
+        }
+        else {
+            process.stdout.write(`No .md files found in ${shownDir}\n`);
+        }
+        return;
+    }
+    const allIssues = [];
+    const issuesByFile = {};
+    const concurrency = Math.max(1, parseInt(opts.concurrency, 10) || 1);
+    const results = new Array(mdFiles.length);
+    let next = 0;
+    const worker = async () => {
+        while (next < mdFiles.length) {
+            const index = next++;
+            const filePath = mdFiles[index];
+            const document = runtime().workspace.document(filePath);
+            results[index] = await lintFile(filePath, {
+                style: opts.style,
+                mermaid: opts.mermaid,
+                katex: opts.katex,
+                references: opts.references,
+            }, document);
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(concurrency, mdFiles.length) }, worker));
+    for (let index = 0; index < mdFiles.length; index++) {
+        const filePath = mdFiles[index];
+        const issues = results[index];
+        allIssues.push(...issues);
+        if (issues.length > 0)
+            issuesByFile[filePath] = issues;
+    }
+    if (opts.summary) {
+        const isHuman = format === "human";
+        const green = (s) => (isHuman ? `\x1b[32m${s}\x1b[0m` : s);
+        const red = (s) => (isHuman ? `\x1b[1;31m${s}\x1b[0m` : s);
+        const bold = (s) => (isHuman ? `\x1b[1m${s}\x1b[0m` : s);
+        if (format === "json") {
+            const results = mdFiles.map((f) => ({
+                file: outputPath(f, opts),
+                issues: (issuesByFile[f] ?? []).length,
+                ok: !(f in issuesByFile),
+            }));
+            const output = jsonPayload("md lint-dir", results, opts, {
+                exitCode: allIssues.length ? 2 : 0,
+                summary: { findings: allIssues.length, files: mdFiles.length },
+            });
+            if (allIssues.length > 0) {
+                process.stderr.write(output);
+                terminate(2);
+            }
+            process.stdout.write(output);
+            return;
+        }
+        if (format === "jsonl" || format === "sarif") {
+            const shown = allIssues.map((issue) => ({ ...issue, file: outputPath(issue.file, opts) }));
+            const output = formatIssues(shown, shownDir, format, { files: mdFiles.length }) + "\n";
+            if (allIssues.length) {
+                process.stderr.write(output);
+                terminate(2);
+            }
+            process.stdout.write(output);
+            return;
+        }
+        const lines = [];
+        for (const filePath of mdFiles) {
+            const count = (issuesByFile[filePath] ?? []).length;
+            if (count > 0) {
+                lines.push(`  ${red("✖")} ${outputPath(filePath, opts)}  ${count} issue(s)`);
+            }
+            else {
+                lines.push(`  ${green("✔")} ${outputPath(filePath, opts)}`);
+            }
+        }
+        const failedCount = Object.keys(issuesByFile).length;
+        const passedCount = mdFiles.length - failedCount;
+        lines.push("");
+        lines.push(bold(`${mdFiles.length} file(s): ${passedCount} passed, ${failedCount} failed, ${allIssues.length} total issue(s)`));
+        if (allIssues.length > 0) {
+            process.stderr.write(lines.join("\n") + "\n");
+            terminate(2);
+        }
+        process.stdout.write(lines.join("\n") + "\n");
+        return;
+    }
+    if (allIssues.length > 0) {
+        if (format === "json") {
+            process.stderr.write(jsonPayload("md lint-dir", allIssues.map((issue) => ({ ...issue, file: outputPath(issue.file, opts) })), opts, { exitCode: 2, summary: { findings: allIssues.length, files: mdFiles.length } }));
+        }
+        else if (format === "jsonl" || format === "sarif") {
+            process.stderr.write(formatIssues(allIssues.map((issue) => ({ ...issue, file: outputPath(issue.file, opts) })), shownDir, format, { files: mdFiles.length }) + "\n");
+        }
+        else {
+            for (const [file, issues] of Object.entries(issuesByFile)) {
+                const shownFile = outputPath(file, opts);
+                process.stderr.write(formatIssues(issues.map((issue) => ({ ...issue, file: shownFile })), shownFile, format) + "\n");
+            }
+            const fileCount = Object.keys(issuesByFile).length;
+            const summary = format === "human"
+                ? `\n\x1b[1;31m✖ ${allIssues.length} total issue(s) across ${fileCount} file(s)\x1b[0m\n`
+                : `${allIssues.length} total issue(s) across ${fileCount} file(s)`;
+            process.stderr.write(summary + "\n");
+        }
+        terminate(2);
+    }
+    else {
+        if (format === "json") {
+            process.stdout.write(jsonPayload("md lint-dir", [], opts, { summary: { findings: 0 } }));
+        }
+        else if (format === "jsonl" || format === "sarif") {
+            process.stdout.write(formatIssues([], shownDir, format, { files: mdFiles.length }) + "\n");
+        }
+        else if (format === "human") {
+            process.stdout.write(`\x1b[32m✔ No issues found across ${mdFiles.length} file(s) in ${shownDir}\x1b[0m\n`);
+        }
+        else {
+            process.stdout.write(`No issues found across ${mdFiles.length} file(s) in ${shownDir}\n`);
+        }
+    }
+}
+//# sourceMappingURL=lint-dir.js.map

package/dist/commands/lint-dir.js.map

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

package/dist/commands/lint.d.ts

@@ -0,0 +1,14 @@
+interface LintOptions {
+    envelope?: boolean;
+    format: string;
+    style: boolean;
+    mermaid: boolean;
+    katex: boolean;
+    references: boolean;
+    include: string[];
+    exclude: string[];
+    stdinName?: string;
+    changedSince?: string;
+}
+export declare function lintAction(input: string | string[], opts: LintOptions): Promise<void>;
+export {};

package/dist/commands/lint.js

@@ -0,0 +1,45 @@
+import { lintFile } from "../lint.js";
+import { formatIssues } from "../formatters.js";
+import { outputPath, runtime } from "../runtime.js";
+import { terminate } from "../command-result.js";
+import { resolveMarkdownInputs } from "../input-selection.js";
+import { jsonPayload } from "../result.js";
+function resolveFormat(opts) {
+    return ["llm", "human", "json", "jsonl", "sarif"].includes(opts.format)
+        ? opts.format
+        : "llm";
+}
+export async function lintAction(input, opts) {
+    const format = resolveFormat(opts);
+    const inputs = Array.isArray(input) ? input : [input];
+    const files = resolveMarkdownInputs(inputs, { ...opts, requireStdinName: opts.references });
+    if (!files.length && !opts.changedSince)
+        throw new Error("No Markdown input files matched");
+    const issues = [];
+    for (const file of files) {
+        issues.push(...(await lintFile(file, {
+            style: opts.style,
+            mermaid: opts.mermaid,
+            katex: opts.katex,
+            references: opts.references,
+        }, runtime().workspace.document(file))));
+    }
+    const shown = issues.map((issue) => ({ ...issue, file: outputPath(issue.file, opts) }));
+    const label = files.length === 1 ? outputPath(files[0], opts) : `${files.length} files`;
+    if (issues.length) {
+        process.stderr.write(formatIssues(shown, label, format, { files: files.length }, {
+            command: "md lint",
+            envelope: opts.envelope,
+        }) + "\n");
+        terminate(2);
+    }
+    if (format === "json")
+        process.stdout.write(jsonPayload("md lint", [], opts, { summary: { findings: 0 } }));
+    else if (format === "jsonl" || format === "sarif")
+        process.stdout.write(formatIssues([], label, format, { files: files.length }) + "\n");
+    else if (format === "human")
+        process.stdout.write(`\x1b[32m✔ No issues found in ${label}\x1b[0m\n`);
+    else
+        process.stdout.write(`No issues found in ${label}\n`);
+}
+//# sourceMappingURL=lint.js.map

package/dist/commands/lint.js.map

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