@cairn-tool/cairn 2.0.0

package/dist/input-selection.js

@@ -0,0 +1,122 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+import { minimatch } from "minimatch";
+import { runtime } from "./runtime.js";
+function hasMagic(value) {
+    return /[*?[\]{}]/.test(value);
+}
+function inside(root, candidate) {
+    const relative = path.relative(root, candidate);
+    return relative === "" || (relative !== ".." && !relative.startsWith(`..${path.sep}`));
+}
+export function changedMarkdownFiles(revision, root = runtime().config.root) {
+    try {
+        const absoluteRoot = path.resolve(root);
+        const realRoot = fs.realpathSync(absoluteRoot);
+        const repository = execFileSync("git", ["-C", root, "rev-parse", "--show-toplevel"], {
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "pipe"],
+        }).trim();
+        const changed = execFileSync("git", [
+            "-C",
+            repository,
+            "diff",
+            "--name-status",
+            "--find-renames",
+            "--find-copies",
+            revision,
+            "--",
+        ], { encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] });
+        const untracked = execFileSync("git", ["-C", repository, "ls-files", "--others", "--exclude-standard"], { encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] });
+        const names = [];
+        for (const line of changed.split(/\r?\n/)) {
+            if (!line)
+                continue;
+            const parts = line.split("\t");
+            if (parts[0].startsWith("D"))
+                continue;
+            names.push(parts[0].startsWith("R") || parts[0].startsWith("C") ? parts[2] : parts[1]);
+        }
+        names.push(...untracked.split(/\r?\n/).filter(Boolean));
+        return [...new Set(names)]
+            .filter((name) => /\.md(?:own)?$/i.test(name))
+            .map((name) => path.resolve(repository, name))
+            .filter((file) => inside(realRoot, file) && fs.existsSync(file) && fs.statSync(file).isFile())
+            .map((file) => path.resolve(absoluteRoot, path.relative(realRoot, file)))
+            .sort();
+    }
+    catch (error) {
+        const detail = error.stderr;
+        const message = detail ? String(detail).trim().split("\n")[0] : error.message;
+        throw new Error(`Unable to select files changed since ${revision}: ${message}`, {
+            cause: error,
+        });
+    }
+}
+export function resolveMarkdownInputs(inputs, options = {}) {
+    const workspace = runtime().workspace;
+    const root = workspace.root;
+    const include = options.include ?? runtime().config.files.include;
+    const exclude = options.exclude ?? runtime().config.files.exclude;
+    const all = () => workspace.markdownFiles(root, { include, exclude });
+    const files = new Set();
+    for (const input of inputs) {
+        if (input === "-") {
+            if (inputs.length !== 1)
+                throw new Error("stdin cannot be combined with file inputs");
+            if (options.requireStdinName && !options.stdinName) {
+                throw new Error("--stdin-name <path> is required when stdin needs file-relative resolution");
+            }
+            const name = path.resolve(options.stdinName ?? path.join(root, "stdin.md"));
+            if (!inside(root, name))
+                throw new Error(`stdin name is outside workspace root: ${name}`);
+            workspace.registerDocument(name, fs.readFileSync(0, "utf-8"));
+            files.add(name);
+            continue;
+        }
+        const resolved = path.resolve(input);
+        if (runtime().config.configPath && !inside(root, resolved)) {
+            throw new Error(`Input is outside configured workspace root: ${resolved}`);
+        }
+        if (fs.existsSync(resolved)) {
+            const stat = fs.statSync(resolved);
+            if (stat.isDirectory()) {
+                for (const file of workspace.markdownFiles(resolved, { include, exclude }))
+                    files.add(file);
+            }
+            else if (stat.isFile())
+                files.add(resolved);
+            else
+                throw new Error(`Path is not a file or directory: ${resolved}`);
+            continue;
+        }
+        if (hasMagic(input)) {
+            const normalized = path.isAbsolute(input)
+                ? path.relative(root, input).split(path.sep).join("/")
+                : path.relative(root, path.resolve(input)).split(path.sep).join("/");
+            for (const file of all()) {
+                const relative = path.relative(root, file).split(path.sep).join("/");
+                if (minimatch(relative, normalized, { dot: true, nonegate: true }))
+                    files.add(file);
+            }
+            continue;
+        }
+        throw new Error(`Path not found: ${resolved}`);
+    }
+    let selected = [...files].sort();
+    const matchesSelection = (file) => {
+        if (!runtime().config.configPath && !inside(root, file))
+            return true;
+        const relative = path.relative(root, file).split(path.sep).join("/");
+        const matches = (pattern) => minimatch(relative, pattern, { dot: true, nonegate: true });
+        return include.some(matches) && !exclude.some(matches);
+    };
+    selected = selected.filter(matchesSelection);
+    if (options.changedSince) {
+        const changed = new Set(changedMarkdownFiles(options.changedSince, root));
+        selected = (inputs.length ? selected : all()).filter((file) => changed.has(file));
+    }
+    return selected;
+}
+//# sourceMappingURL=input-selection.js.map

package/dist/input-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-selection.js","sourceRoot":"","sources":["../src/input-selection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAUvC,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,MAAM,CAAC,IAAY,EAAE,SAAiB;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAChD,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,IAAI,GAAG,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI;IACjF,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,iBAAiB,CAAC,EAAE;YACnF,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,OAAO,GAAG,YAAY,CAC1B,KAAK,EACL;YACE,IAAI;YACJ,UAAU;YACV,MAAM;YACN,eAAe;YACf,gBAAgB;YAChB,eAAe;YACf,QAAQ;YACR,IAAI;SACL,EACD,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CACzD,CAAC;QACF,MAAM,SAAS,GAAG,YAAY,CAC5B,KAAK,EACL,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,oBAAoB,CAAC,EAChE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CACzD,CAAC;QACF,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YACvC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACzF,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;aACvB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aAC7C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;aAC7C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;aAC7F,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;aACxE,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAI,KAAsC,CAAC,MAAM,CAAC;QAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,KAAe,CAAC,OAAO,CAAC;QACzF,MAAM,IAAI,KAAK,CAAC,wCAAwC,QAAQ,KAAK,OAAO,EAAE,EAAE;YAC9E,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAyB,EACzB,UAA4B,EAAE;IAE9B,MAAM,SAAS,GAAG,OAAO,EAAE,CAAC,SAAS,CAAC;IACtC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;IAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;IAClE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;IAClE,MAAM,GAAG,GAAG,GAAa,EAAE,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAClB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YACtF,IAAI,OAAO,CAAC,gBAAgB,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBACnD,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;YAC5E,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,IAAI,EAAE,CAAC,CAAC;YAC1F,SAAS,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;YAC9D,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChB,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,OAAO,EAAE,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,+CAA+C,QAAQ,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACnC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACvB,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;oBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9F,CAAC;iBAAM,IAAI,IAAI,CAAC,MAAM,EAAE;gBAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;;gBACzC,MAAM,IAAI,KAAK,CAAC,oCAAoC,QAAQ,EAAE,CAAC,CAAC;YACrE,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;gBACvC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBACtD,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvE,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,EAAE,CAAC;gBACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACrE,IAAI,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;oBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtF,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAW,EAAE;QACjD,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,CAAC,OAAe,EAAE,EAAE,CAClC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC,CAAC;IACF,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC7C,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,oBAAoB,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1E,QAAQ,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/input.d.ts

@@ -0,0 +1,2 @@
+export declare function requireFile(value: string, options: object): string;
+export declare function requireDirectory(value: string, options: object): string;

package/dist/input.js

@@ -0,0 +1,32 @@
+import fs from "node:fs";
+import path from "node:path";
+import { terminate } from "./command-result.js";
+import { outputPath, runtime } from "./runtime.js";
+export function requireFile(value, options) {
+    if (value === "-") {
+        const opts = options;
+        if (opts.write) {
+            process.stderr.write("Error: stdin cannot be used with a command that writes files\n");
+            terminate(1);
+        }
+        const filePath = path.resolve(opts.stdinName ?? path.join(runtime().config.root, "stdin.md"));
+        const content = fs.readFileSync(0, "utf-8");
+        runtime().workspace.registerDocument(filePath, content);
+        return filePath;
+    }
+    const filePath = path.resolve(value);
+    if (!fs.existsSync(filePath) || !fs.statSync(filePath).isFile()) {
+        process.stderr.write(`Error: File not found: ${outputPath(filePath, options)}\n`);
+        terminate(1);
+    }
+    return filePath;
+}
+export function requireDirectory(value, options) {
+    const directory = path.resolve(value);
+    if (!fs.existsSync(directory) || !fs.statSync(directory).isDirectory()) {
+        process.stderr.write(`Error: Directory not found: ${outputPath(directory, options)}\n`);
+        terminate(1);
+    }
+    return directory;
+}
+//# sourceMappingURL=input.js.map

package/dist/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,OAAe;IACxD,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,OAAkD,CAAC;QAChE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;YACvF,SAAS,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;QAC9F,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,EAAE,CAAC,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACxD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAClF,SAAS,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,OAAe;IAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACxF,SAAS,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/link-target.d.ts

@@ -0,0 +1,39 @@
+export interface LocalTarget {
+    rawPath: string;
+    path: string;
+    query: string;
+    rawFragment?: string;
+    fragment?: string;
+}
+export declare function splitLocalTarget(target: string): LocalTarget;
+export declare function resolveLocalPath(sourceFile: string, targetPath: string, workspaceRoot: string): string;
+/** Percent-encodes a path, including the `#` that `encodeURI` leaves literal. */
+export declare function encodePath(value: string, encoded: boolean): string;
+/**
+ * How a link target was spelled, so a rewrite can preserve it.
+ *
+ * Whether a target is written `./x.md` or `x.md`, and whether it is
+ * percent-encoded, are authoring choices rather than correctness properties.
+ * Normalizing them would rewrite every link in a repository on first run.
+ */
+export interface TargetStyle {
+    /** The path contained `%`, so a rewrite re-encodes. */
+    encoded: boolean;
+    /** The raw destination text contained `\`, so `(` and `)` are re-escaped. */
+    escapedParens: boolean;
+    /** The path began with `/` and is therefore workspace-root-relative. */
+    rootRelative: boolean;
+    /** The path began with `./`. */
+    dotSlash: boolean;
+}
+export declare function targetStyle(rawTarget: string, rawDestinationText?: string): TargetStyle;
+/** Rebuilds `<path><query>[#fragment]` in the original target's style. */
+export declare function composeTarget(nextPath: string, split: LocalTarget, style: TargetStyle): string;
+/**
+ * Re-escapes parentheses when the original destination was written escaped.
+ *
+ * Applied after any comparison against the original target, since the escaping
+ * is a property of the surrounding link syntax rather than of the target itself.
+ */
+export declare function escapeTargetParens(value: string, style: TargetStyle): string;
+export declare function replaceFragment(target: string, newFragment: string): string;

package/dist/link-target.js

@@ -0,0 +1,68 @@
+import path from "node:path";
+function decode(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return value;
+    }
+}
+export function splitLocalTarget(target) {
+    const hash = target.indexOf("#");
+    const beforeFragment = hash === -1 ? target : target.slice(0, hash);
+    const rawFragment = hash === -1 ? undefined : target.slice(hash + 1);
+    const question = beforeFragment.indexOf("?");
+    const rawPath = question === -1 ? beforeFragment : beforeFragment.slice(0, question);
+    const query = question === -1 ? "" : beforeFragment.slice(question);
+    return {
+        rawPath,
+        path: decode(rawPath),
+        query,
+        ...(rawFragment === undefined ? {} : { rawFragment, fragment: decode(rawFragment) }),
+    };
+}
+export function resolveLocalPath(sourceFile, targetPath, workspaceRoot) {
+    if (targetPath.startsWith("/"))
+        return path.resolve(workspaceRoot, `.${targetPath}`);
+    return path.resolve(path.dirname(sourceFile), targetPath);
+}
+/** Percent-encodes a path, including the `#` that `encodeURI` leaves literal. */
+export function encodePath(value, encoded) {
+    return encoded ? encodeURI(value).replace(/#/g, "%23") : value;
+}
+export function targetStyle(rawTarget, rawDestinationText = rawTarget) {
+    const { rawPath } = splitLocalTarget(rawTarget);
+    return {
+        encoded: rawPath.includes("%"),
+        escapedParens: rawDestinationText.includes("\\"),
+        rootRelative: rawPath.startsWith("/"),
+        dotSlash: rawPath.startsWith("./"),
+    };
+}
+/** Rebuilds `<path><query>[#fragment]` in the original target's style. */
+export function composeTarget(nextPath, split, style) {
+    let value = nextPath;
+    if (!style.rootRelative && style.dotSlash && !value.startsWith("."))
+        value = `./${value}`;
+    value = encodePath(value, style.encoded);
+    const suffix = split.query + (split.rawFragment === undefined ? "" : `#${split.rawFragment}`);
+    return value + suffix;
+}
+/**
+ * Re-escapes parentheses when the original destination was written escaped.
+ *
+ * Applied after any comparison against the original target, since the escaping
+ * is a property of the surrounding link syntax rather than of the target itself.
+ */
+export function escapeTargetParens(value, style) {
+    return style.escapedParens ? value.replace(/[()]/g, (character) => `\\${character}`) : value;
+}
+export function replaceFragment(target, newFragment) {
+    const hash = target.indexOf("#");
+    if (hash === -1)
+        return target;
+    const old = target.slice(hash + 1);
+    const replacement = old.includes("%") ? encodeURIComponent(newFragment) : newFragment;
+    return `${target.slice(0, hash + 1)}${replacement}`;
+}
+//# sourceMappingURL=link-target.js.map

package/dist/link-target.js.map

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

package/dist/lint.d.ts

@@ -0,0 +1,13 @@
+import type { Issue } from "./types.js";
+import type { MarkdownDocument } from "./workspace.js";
+export interface LintFileOptions {
+    style?: boolean;
+    mermaid?: boolean;
+    katex?: boolean;
+    references?: boolean;
+}
+export declare function lintFile(filePath: string, options?: LintFileOptions, document?: MarkdownDocument): Promise<Issue[]>;
+export declare function findMarkdownFiles(dir: string, selection?: {
+    include?: string[];
+    exclude?: string[];
+}): string[];

package/dist/lint.js

@@ -0,0 +1,27 @@
+import { checkMarkdownLint } from "./checkers/markdown-lint.js";
+import { checkMermaid } from "./checkers/mermaid.js";
+import { checkKatex } from "./checkers/katex.js";
+import { checkReferences } from "./checkers/references.js";
+import { runtime } from "./runtime.js";
+export async function lintFile(filePath, options = {}, document) {
+    const active = runtime();
+    const doc = document ?? active.workspace.document(filePath);
+    const { content, tree } = doc;
+    const issues = [];
+    if (options.style) {
+        await checkMarkdownLint(filePath, content, issues, active.config.markdownlint.config);
+    }
+    if (options.mermaid ?? active.config.checks.mermaid) {
+        await checkMermaid(filePath, content, issues, tree);
+    }
+    if (options.katex ?? active.config.checks.katex)
+        checkKatex(filePath, content, issues, tree);
+    if (options.references ?? active.config.checks.references) {
+        checkReferences(filePath, content, issues, tree);
+    }
+    return issues;
+}
+export function findMarkdownFiles(dir, selection) {
+    return runtime().workspace.markdownFiles(dir, selection);
+}
+//# sourceMappingURL=lint.js.map

package/dist/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../src/lint.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAUvC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAgB,EAChB,UAA2B,EAAE,EAC7B,QAA2B;IAE3B,MAAM,MAAM,GAAG,OAAO,EAAE,CAAC;IACzB,MAAM,GAAG,GAAG,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5D,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC;IAC9B,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpD,MAAM,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK;QAAE,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7F,IAAI,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1D,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,GAAW,EACX,SAAsD;IAEtD,OAAO,OAAO,EAAE,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAC3D,CAAC"}

package/dist/markdown-ast.d.ts

@@ -0,0 +1,73 @@
+import type { Root } from "mdast";
+import type { Node } from "unist";
+export type { Root } from "mdast";
+export interface MdLink {
+    line: number;
+    linkText: string;
+    target: string;
+    isImage: boolean;
+    isExternal: boolean;
+    isAnchorOnly: boolean;
+    referenceType: "inline" | "full" | "collapsed" | "shortcut";
+    definitionIdentifier?: string;
+    destinationLine: number;
+    destinationStart?: number;
+    destinationEnd?: number;
+}
+export interface MdHeading {
+    line: number;
+    depth: number;
+    text: string;
+    slug: string;
+}
+export interface MdCodeBlock {
+    line: number;
+    endLine: number;
+    lang: string | null;
+    /**
+     * The fence info string after the language, or null.
+     *
+     * Internal only: no command projects this into a payload. Emitting it
+     * unconditionally would change `md code-blocks --format json`, the MCP
+     * `list_code_blocks` tool, and `md query code-blocks` for every consumer,
+     * for a field that is null on almost every fence.
+     */
+    meta: string | null;
+    value: string;
+    /** UTF-16 code-unit offset of the opening fence, or of the first indented line. */
+    start: number;
+    /** Exclusive. Offsets rather than lines, so a caller can express a scoped edit. */
+    end: number;
+}
+export declare function parseMarkdown(content: string): Root;
+/**
+ * @deprecated Retained so an existing import keeps resolving. {@link parseMarkdown}
+ * has handled frontmatter since the phantom-heading fix; this is now an alias.
+ */
+export declare function parseMarkdownWithFrontmatter(content: string): Root;
+export declare function slugify(text: string): string;
+export declare function extractText(node: Node): string;
+export declare function extractLinks(tree: Root, source?: string): MdLink[];
+export declare function extractHeadings(tree: Root): MdHeading[];
+export declare function extractCodeBlocks(tree: Root): MdCodeBlock[];
+/** Takes only what it reads, so a caller can pass any block-shaped record. */
+export declare function isLineInCodeBlock(line: number, codeBlocks: readonly {
+    line: number;
+    endLine: number;
+}[]): boolean;
+export interface MdTask {
+    line: number;
+    checked: boolean;
+    text: string;
+}
+export declare function extractTasks(tree: Root): MdTask[];
+export interface MdTable {
+    line: number;
+    endLine: number;
+    columns: number;
+    rows: number;
+    align: (string | null)[];
+    headers: string[];
+    data: string[][];
+}
+export declare function extractTables(tree: Root): MdTable[];

package/dist/markdown-ast.js

@@ -0,0 +1,187 @@
+import { unified } from "unified";
+import remarkParse from "remark-parse";
+import remarkGfm from "remark-gfm";
+import remarkFrontmatter from "remark-frontmatter";
+import { visit } from "unist-util-visit";
+import GithubSlugger from "github-slugger";
+/**
+ * One parser, and it is frontmatter-aware.
+ *
+ * Without `remark-frontmatter`, a leading `---\nkey: value\n---` is not a
+ * frontmatter block at all: the closing `---` reads as a setext underline, so
+ * the YAML body becomes an `<h2>` whose text is the raw keys. Every consumer of
+ * this module then inherited that phantom heading — `md headers`, `md outline`,
+ * `md stats`, and `md structure` reported it, and `md toc` emitted a link label
+ * containing a literal newline, which is not valid Markdown.
+ *
+ * The plugin only treats `---` at the very start of a document as frontmatter,
+ * so a mid-document thematic break or a real setext heading is unaffected, and
+ * the `yaml` node holds the block's position so every later node keeps its
+ * original line numbers.
+ */
+const parser = unified().use(remarkParse).use(remarkGfm).use(remarkFrontmatter, ["yaml"]);
+export function parseMarkdown(content) {
+    return parser.parse(content);
+}
+/**
+ * @deprecated Retained so an existing import keeps resolving. {@link parseMarkdown}
+ * has handled frontmatter since the phantom-heading fix; this is now an alias.
+ */
+export function parseMarkdownWithFrontmatter(content) {
+    return parser.parse(content);
+}
+export function slugify(text) {
+    return new GithubSlugger().slug(text);
+}
+export function extractText(node) {
+    const parts = [];
+    visit(node, (child) => {
+        // Inline code is a literal: its content lives in `value`, not in text children.
+        // Include it so rendered labels and GitHub heading slugs retain backtick spans.
+        if (child.type === "text" || child.type === "inlineCode") {
+            parts.push(child.value);
+        }
+    });
+    return parts.join("");
+}
+function isExternalTarget(target) {
+    if (/^[a-z]:[\\/]/i.test(target))
+        return false;
+    return /^(?:[a-z][a-z\d+.-]*:|\/\/)/i.test(target);
+}
+function destinationSpan(node, target, source, kind) {
+    const start = node.position?.start.offset;
+    const end = node.position?.end.offset;
+    const line = node.position?.start.line ?? 0;
+    if (source === undefined || start === undefined || end === undefined)
+        return { line };
+    const raw = source.slice(start, end);
+    const searchFrom = kind === "definition" ? raw.indexOf(":") + 1 : raw.lastIndexOf("]") + 1;
+    let relative = raw.indexOf(target, Math.max(0, searchFrom));
+    if (relative === -1) {
+        const escaped = target.replace(/[()]/g, (char) => `\\${char}`);
+        relative = raw.indexOf(escaped, Math.max(0, searchFrom));
+        if (relative !== -1) {
+            return { start: start + relative, end: start + relative + escaped.length, line };
+        }
+        return { line };
+    }
+    return { start: start + relative, end: start + relative + target.length, line };
+}
+function makeLink(line, linkText, target, isImage, referenceType, destination, definitionIdentifier) {
+    return {
+        line,
+        linkText,
+        target,
+        isImage,
+        isExternal: isExternalTarget(target),
+        isAnchorOnly: target.startsWith("#"),
+        referenceType,
+        definitionIdentifier,
+        destinationLine: destination.line,
+        destinationStart: destination.start,
+        destinationEnd: destination.end,
+    };
+}
+export function extractLinks(tree, source) {
+    const links = [];
+    const definitions = new Map();
+    visit(tree, "definition", (node) => {
+        if (!definitions.has(node.identifier))
+            definitions.set(node.identifier, node);
+    });
+    visit(tree, "link", (node) => {
+        const line = node.position?.start.line ?? 0;
+        const linkText = extractText(node);
+        const target = node.url;
+        links.push(makeLink(line, linkText, target, false, "inline", destinationSpan(node, target, source, "inline")));
+    });
+    visit(tree, "image", (node) => {
+        const line = node.position?.start.line ?? 0;
+        const linkText = node.alt ?? "";
+        const target = node.url;
+        links.push(makeLink(line, linkText, target, true, "inline", destinationSpan(node, target, source, "inline")));
+    });
+    const addReference = (node, isImage) => {
+        const definition = definitions.get(node.identifier);
+        if (!definition)
+            return;
+        const line = node.position?.start.line ?? 0;
+        const linkText = isImage ? (node.alt ?? "") : extractText(node);
+        links.push(makeLink(line, linkText, definition.url, isImage, node.referenceType, destinationSpan(definition, definition.url, source, "definition"), node.identifier));
+    };
+    visit(tree, "linkReference", (node) => {
+        addReference(node, false);
+    });
+    visit(tree, "imageReference", (node) => {
+        addReference(node, true);
+    });
+    // Sort by line number to maintain document order
+    links.sort((a, b) => a.line - b.line);
+    return links;
+}
+export function extractHeadings(tree) {
+    const headings = [];
+    const slugger = new GithubSlugger();
+    visit(tree, "heading", (node) => {
+        const line = node.position?.start.line ?? 0;
+        const text = extractText(node);
+        headings.push({ line, depth: node.depth, text, slug: slugger.slug(text) });
+    });
+    return headings;
+}
+export function extractCodeBlocks(tree) {
+    const blocks = [];
+    visit(tree, "code", (node) => {
+        const line = node.position?.start.line ?? 0;
+        const endLine = node.position?.end.line ?? 0;
+        blocks.push({
+            line,
+            endLine,
+            lang: node.lang ?? null,
+            meta: node.meta ?? null,
+            value: node.value,
+            start: node.position?.start.offset ?? 0,
+            end: node.position?.end.offset ?? 0,
+        });
+    });
+    return blocks;
+}
+/** Takes only what it reads, so a caller can pass any block-shaped record. */
+export function isLineInCodeBlock(line, codeBlocks) {
+    return codeBlocks.some((b) => line >= b.line && line <= b.endLine);
+}
+export function extractTasks(tree) {
+    const tasks = [];
+    visit(tree, "listItem", (node) => {
+        if (node.checked === null || node.checked === undefined)
+            return;
+        const line = node.position?.start.line ?? 0;
+        const text = extractText(node);
+        tasks.push({ line, checked: node.checked, text });
+    });
+    return tasks;
+}
+export function extractTables(tree) {
+    const tables = [];
+    visit(tree, "table", (node) => {
+        const line = node.position?.start.line ?? 0;
+        const endLine = node.position?.end.line ?? 0;
+        const align = node.align ?? [];
+        const headerRow = node.children[0];
+        const headers = headerRow?.children.map((cell) => extractText(cell)) ?? [];
+        const dataRows = node.children.slice(1);
+        const data = dataRows.map((row) => row.children.map((cell) => extractText(cell)));
+        tables.push({
+            line,
+            endLine,
+            columns: headers.length,
+            rows: dataRows.length,
+            align,
+            headers,
+            data,
+        });
+    });
+    return tables;
+}
+//# sourceMappingURL=markdown-ast.js.map

package/dist/markdown-ast.js.map

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

package/dist/object-path.d.ts

@@ -0,0 +1,14 @@
+export interface NestedValueOptions {
+    /**
+     * Whether a path segment may index into an array.
+     *
+     * The two call sites this replaces disagree, and both shapes are published:
+     * `md frontmatter --key items.0` has always resolved, while
+     * `md query duplicates --field frontmatter:items.0` has always returned
+     * nothing. Preserved as a flag rather than unified — changing either is a
+     * behavior change on a shipped command.
+     */
+    arrays?: boolean;
+}
+/** Resolves a dotted path against parsed frontmatter. */
+export declare function nestedValue(value: unknown, keyPath: string, options?: NestedValueOptions): unknown;

package/dist/object-path.js

@@ -0,0 +1,14 @@
+/** Resolves a dotted path against parsed frontmatter. */
+export function nestedValue(value, keyPath, options = {}) {
+    const arrays = options.arrays ?? true;
+    let current = value;
+    for (const part of keyPath.split(".")) {
+        if (current === null || current === undefined || typeof current !== "object")
+            return undefined;
+        if (!arrays && Array.isArray(current))
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+//# sourceMappingURL=object-path.js.map

package/dist/object-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-path.js","sourceRoot":"","sources":["../src/object-path.ts"],"names":[],"mappings":"AAaA,yDAAyD;AACzD,MAAM,UAAU,WAAW,CACzB,KAAc,EACd,OAAe,EACf,UAA8B,EAAE;IAEhC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;IACtC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC/F,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,OAAO,SAAS,CAAC;QACxD,OAAO,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}