@cairn-tool/cairn 2.0.0

package/dist/commands/orphans.d.ts

@@ -0,0 +1,10 @@
+interface OrphansOptions {
+    envelope?: boolean;
+    format: string;
+    ignore: string[];
+    entry: string[];
+    include: string[];
+    exclude: string[];
+}
+export declare function orphansAction(directory: string, opts: OrphansOptions): Promise<void>;
+export {};

package/dist/commands/orphans.js

@@ -0,0 +1,74 @@
+import path from "node:path";
+import { findMarkdownFiles } from "../lint.js";
+import { outputPath, runtime } from "../runtime.js";
+import { terminate } from "../command-result.js";
+import { requireDirectory } from "../input.js";
+import { buildWorkspaceGraph } from "../graph.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 globToRegex(pattern) {
+    const escaped = pattern
+        .replace(/[.+^${}()|[\]\\]/g, "\\$&")
+        .replace(/\*\*/g, "{{GLOBSTAR}}")
+        .replace(/\*/g, "[^/]*")
+        .replace(/\?/g, "[^/]")
+        .replace(/\{\{GLOBSTAR\}\}/g, ".*");
+    return new RegExp(`^${escaped}$`);
+}
+export async function orphansAction(directory, opts) {
+    const format = resolveFormat(opts);
+    const dirPath = requireDirectory(directory, opts);
+    const shownDir = outputPath(dirPath, opts);
+    let files = findMarkdownFiles(dirPath, { include: opts.include, exclude: opts.exclude });
+    // Apply ignore patterns
+    if (opts.ignore.length > 0) {
+        const patterns = opts.ignore.map(globToRegex);
+        files = files.filter((f) => {
+            const rel = path.relative(dirPath, f);
+            return !patterns.some((p) => p.test(rel));
+        });
+    }
+    // Resolve entry files
+    const entryFiles = new Set(opts.entry.map((e) => path.resolve(dirPath, e)));
+    const graph = buildWorkspaceGraph(runtime().workspace, files);
+    const referencedFiles = new Set(graph.nodes.filter((node) => node.inbound > 0).map((node) => node.file));
+    // Find orphans
+    const orphans = files.filter((f) => !referencedFiles.has(f) && !entryFiles.has(f));
+    if (format === "json") {
+        const json = jsonPayload("md orphans", {
+            directory: shownDir,
+            totalFiles: files.length,
+            orphans: orphans.map((file) => outputPath(file, opts)),
+        }, opts, { exitCode: orphans.length ? 2 : 0, summary: { orphans: orphans.length } });
+        if (orphans.length > 0) {
+            process.stderr.write(json);
+            terminate(2);
+        }
+        process.stdout.write(json);
+        return;
+    }
+    const isHuman = format === "human";
+    const bold = (s) => (isHuman ? `\x1b[1m${s}\x1b[0m` : s);
+    if (orphans.length === 0) {
+        if (isHuman) {
+            process.stdout.write(`\x1b[32m✔ No orphans found in ${shownDir} (${files.length} files scanned)\x1b[0m\n`);
+        }
+        else {
+            process.stdout.write(`No orphans found in ${shownDir} (${files.length} files scanned)\n`);
+        }
+        return;
+    }
+    const lines = [];
+    lines.push(bold(`${orphans.length} orphan(s) found in ${shownDir} (${files.length} files scanned):`));
+    for (const o of orphans) {
+        lines.push(`  ${outputPath(o, opts)}`);
+    }
+    process.stderr.write(lines.join("\n") + "\n");
+    terminate(2);
+}
+//# sourceMappingURL=orphans.js.map

package/dist/commands/orphans.js.map

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

package/dist/commands/outline.d.ts

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

package/dist/commands/outline.js

@@ -0,0 +1,54 @@
+import { buildOutline } from "../outline.js";
+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";
+}
+function renderOutlineText(nodes, indent, format) {
+    const lines = [];
+    for (const node of nodes) {
+        const padding = "  ".repeat(indent);
+        if (format === "human") {
+            lines.push(`${padding}\x1b[33m${node.text}\x1b[0m`);
+        }
+        else {
+            lines.push(`${padding}${node.text}`);
+        }
+        lines.push(...renderOutlineText(node.children, indent + 1, format));
+    }
+    return lines;
+}
+export async function outlineAction(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 (headings.length === 0) {
+        if (format === "human") {
+            process.stdout.write(`\x1b[33mNo headings found in ${shownPath}\x1b[0m\n`);
+        }
+        else if (format === "json") {
+            process.stdout.write("[]\n");
+        }
+        else {
+            process.stdout.write(`No headings found in ${shownPath}\n`);
+        }
+        return;
+    }
+    if (format === "json") {
+        const outlineTree = buildOutline(headings);
+        process.stdout.write(jsonPayload("md outline", outlineTree, opts));
+        return;
+    }
+    const outlineTree = buildOutline(headings);
+    const lines = renderOutlineText(outlineTree, 0, format);
+    process.stdout.write(lines.join("\n") + "\n");
+}
+//# sourceMappingURL=outline.js.map

package/dist/commands/outline.js.map

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

package/dist/commands/query.d.ts

@@ -0,0 +1,18 @@
+interface QueryOptions {
+    envelope?: boolean;
+    format: string;
+    include: string[];
+    exclude: string[];
+    target?: string;
+    field: string;
+    lang?: string;
+    content: boolean;
+    status: string;
+    summary: boolean;
+    assetExtension: string[];
+    where: string[];
+    select: string[];
+    groupBy?: string;
+}
+export declare function queryAction(kindValue: string, directory: string, opts: QueryOptions): Promise<void>;
+export {};

package/dist/commands/query.js

@@ -0,0 +1,341 @@
+import path from "node:path";
+import { extractCodeBlocks, extractTasks } from "../markdown-ast.js";
+import { resolveLocalPath, splitLocalTarget } from "../link-target.js";
+import { requireDirectory } from "../input.js";
+import { outputPath, runtime } from "../runtime.js";
+import { jsonPayload } from "../result.js";
+import { nestedValue } from "../object-path.js";
+import { frontmatterValueType } from "../query/entities.js";
+import { QueryUsageError, buildPlan } from "../query/plan.js";
+import { executePlan } from "../query/execute.js";
+import { renderQueryText } from "../query/render.js";
+import { explicitOptionKeys } from "../runtime.js";
+function primitive(value) {
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    return undefined;
+}
+function duplicateResults(files, field, opts) {
+    if (!["title", "slug", "heading-slug"].includes(field) && !field.startsWith("frontmatter:")) {
+        throw new Error("--field must be title, slug, heading-slug, or frontmatter:<key>");
+    }
+    const groups = new Map();
+    const add = (value, file, line) => {
+        const key = value.toLocaleLowerCase();
+        const group = groups.get(key) ?? { value, occurrences: [] };
+        group.occurrences.push({ file: outputPath(file, opts), line });
+        groups.set(key, group);
+    };
+    for (const file of files) {
+        const document = runtime().workspace.document(file);
+        if (field === "heading-slug") {
+            for (const heading of document.headings)
+                add(heading.slug, file, heading.line);
+            continue;
+        }
+        const data = document.frontmatter.status === "valid" ? document.frontmatter.data : {};
+        if (field === "title") {
+            const frontmatterTitle = primitive(data.title);
+            const heading = document.headings.find((item) => item.depth === 1);
+            if (frontmatterTitle !== undefined)
+                add(frontmatterTitle, file, 1);
+            else if (heading)
+                add(heading.text, file, heading.line);
+            continue;
+        }
+        const key = field === "slug" ? "slug" : field.slice("frontmatter:".length);
+        if (!key)
+            throw new Error("frontmatter duplicate fields require a key");
+        // `arrays: false` preserves this command's long-standing refusal to index
+        // into a frontmatter list; `md frontmatter --key` allows it.
+        const value = primitive(nestedValue(data, key, { arrays: false }));
+        if (value !== undefined)
+            add(value, file, 1);
+    }
+    return [...groups.values()]
+        .filter((group) => group.occurrences.length > 1)
+        .sort((a, b) => a.value.localeCompare(b.value));
+}
+function linksToResults(files, target, opts) {
+    const parsedTarget = splitLocalTarget(target);
+    const targetFile = path.resolve(parsedTarget.path);
+    const targetFragment = parsedTarget.fragment;
+    const results = [];
+    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);
+            const resolved = resolveLocalPath(file, parsed.path, runtime().workspace.root);
+            if (resolved !== targetFile)
+                continue;
+            const fragment = parsed.fragment;
+            if (targetFragment !== undefined && fragment !== targetFragment)
+                continue;
+            results.push({
+                sourceFile: outputPath(file, opts),
+                line: reference.line,
+                linkText: reference.linkText,
+                rawTarget: reference.target,
+            });
+        }
+    }
+    return results;
+}
+function unusedAssetResults(files, directory, opts) {
+    const referenced = new Set();
+    for (const file of files) {
+        for (const reference of runtime().workspace.document(file).references) {
+            if (reference.isExternal || reference.isAnchorOnly)
+                continue;
+            const target = splitLocalTarget(reference.target).path;
+            referenced.add(resolveLocalPath(file, target, runtime().workspace.root));
+        }
+    }
+    const extensions = opts.assetExtension.length
+        ? opts.assetExtension
+        : runtime().config.assets.extensions;
+    return runtime()
+        .workspace.assetFiles(directory, extensions, opts.exclude)
+        .filter((file) => !referenced.has(file))
+        .map((file) => ({ file: outputPath(file, opts), extension: path.extname(file).toLowerCase() }));
+}
+function codeBlockResults(files, opts) {
+    const groups = new Map();
+    for (const file of files) {
+        for (const block of extractCodeBlocks(runtime().workspace.document(file).tree)) {
+            const language = block.lang ?? "(none)";
+            if (opts.lang && language !== opts.lang)
+                continue;
+            const occurrence = {
+                file: outputPath(file, opts),
+                line: block.line,
+                endLine: block.endLine,
+                ...(opts.content ? { content: block.value } : {}),
+            };
+            groups.set(language, [...(groups.get(language) ?? []), occurrence]);
+        }
+    }
+    return [...groups]
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([language, occurrences]) => ({ language, count: occurrences.length, occurrences }));
+}
+function taskResults(files, opts) {
+    if (!["all", "done", "pending"].includes(opts.status)) {
+        throw new Error("--status must be all, done, or pending");
+    }
+    const results = [];
+    let done = 0;
+    let pending = 0;
+    let matched = 0;
+    for (const file of files) {
+        for (const task of extractTasks(runtime().workspace.document(file).tree)) {
+            if (task.checked)
+                done++;
+            else
+                pending++;
+            if (opts.status === "done" && !task.checked)
+                continue;
+            if (opts.status === "pending" && task.checked)
+                continue;
+            matched++;
+            if (!opts.summary) {
+                results.push({
+                    file: outputPath(file, opts),
+                    line: task.line,
+                    checked: task.checked,
+                    text: task.text,
+                });
+            }
+        }
+    }
+    return { results, summary: { total: done + pending, done, pending, matched }, count: matched };
+}
+/**
+ * Inventories top-level frontmatter key adoption across the workspace.
+ *
+ * An aggregate rather than a composable entity: the `frontmatter` entity emits
+ * one row per key *per document*, while this emits one row per key with a
+ * count, which the projection model has no way to express.
+ */
+function frontmatterKeyResults(files) {
+    let withFrontmatter = 0;
+    const keys = new Map();
+    for (const file of files) {
+        const { frontmatter } = runtime().workspace.document(file);
+        if (frontmatter.status !== "valid")
+            continue;
+        withFrontmatter++;
+        for (const [key, value] of Object.entries(frontmatter.data)) {
+            const seen = keys.get(key) ?? { documents: 0, types: new Set() };
+            seen.documents++;
+            seen.types.add(frontmatterValueType(value));
+            keys.set(key, seen);
+        }
+    }
+    // Byte comparison, not localeCompare: the ordering must not depend on the
+    // ICU build of whichever machine ran the query.
+    const byBytes = (a, b) => (a < b ? -1 : a > b ? 1 : 0);
+    const results = [...keys]
+        .sort(([a], [b]) => byBytes(a, b))
+        .map(([key, seen]) => ({
+        key,
+        documents: seen.documents,
+        // Share of documents that *have* frontmatter, so adding an unrelated
+        // frontmatter-less file does not depress every key's coverage.
+        coverage: withFrontmatter
+            ? Math.round((seen.documents / withFrontmatter) * 10000) / 10000
+            : 0,
+        types: [...seen.types].sort(byBytes),
+    }));
+    return {
+        results,
+        summary: { documents: files.length, withFrontmatter, keys: results.length },
+        count: results.length,
+    };
+}
+function textOutput(envelope, human) {
+    const heading = `${envelope.kind}: ${envelope.count} result(s) in ${envelope.directory}`;
+    const lines = [human ? `\x1b[1m${heading}\x1b[0m` : heading];
+    if (envelope.summary) {
+        const summary = envelope.summary;
+        lines.push(
+        // `tasks` keeps its historical wording; anything else renders generically.
+        envelope.kind === "tasks"
+            ? `  total=${summary.total} done=${summary.done} pending=${summary.pending}`
+            : `  ${Object.entries(summary)
+                .map(([key, value]) => `${key}=${value}`)
+                .join(" ")}`);
+    }
+    for (const result of envelope.results)
+        lines.push(`  ${JSON.stringify(result)}`);
+    return lines.join("\n");
+}
+const LEGACY_KINDS = [
+    "links-to",
+    "duplicates",
+    "unused-assets",
+    "code-blocks",
+    "tasks",
+    "missing-h1",
+    "frontmatter-keys",
+];
+/** Options that belong to a shortcut kind and have no composable meaning. */
+const LEGACY_OPTIONS = [
+    "target",
+    "field",
+    "lang",
+    "content",
+    "status",
+    "summary",
+    "assetExtension",
+];
+/**
+ * Runs a composable query.
+ *
+ * Reached only when `--where`, `--select`, or `--group-by` was typed, so every
+ * shortcut kind keeps its historical payload byte for byte.
+ */
+function composableQuery(kindValue, directory, opts) {
+    // Detected from argv rather than by comparing against defaults, so a
+    // `.cairn.yml` setting `commands.query.status` does not look like a
+    // conflicting flag on every composable tasks query.
+    const typed = explicitOptionKeys(opts);
+    const conflicting = LEGACY_OPTIONS.filter((name) => typed.has(name));
+    if (conflicting.length) {
+        throw new QueryUsageError(`--${conflicting[0]} belongs to a shortcut kind and cannot be combined with --where, --select, or --group-by`);
+    }
+    const dir = requireDirectory(directory, opts);
+    const files = runtime().workspace.markdownFiles(dir, {
+        include: opts.include,
+        exclude: opts.exclude,
+    });
+    const plan = buildPlan({
+        kind: kindValue,
+        where: opts.where,
+        select: opts.select,
+        ...(opts.groupBy === undefined ? {} : { groupBy: opts.groupBy }),
+    });
+    const result = executePlan(plan, {
+        workspace: runtime().workspace,
+        files,
+        displayPath: (file) => outputPath(file, opts),
+    });
+    return {
+        plan,
+        result,
+        envelope: {
+            kind: plan.entity,
+            directory: outputPath(dir, opts),
+            count: result.groups ? result.groups.length : result.rows.length,
+            results: result.groups ?? result.rows,
+            fields: result.fields,
+            ...(plan.groupBy ? { groupBy: plan.groupBy } : {}),
+            ...(result.groups
+                ? { summary: { matched: result.matched, groups: result.groups.length } }
+                : {}),
+        },
+    };
+}
+export async function queryAction(kindValue, directory, opts) {
+    const composable = opts.where.length > 0 || opts.select.length > 0 || Boolean(opts.groupBy);
+    if (composable) {
+        const { envelope, plan, result } = composableQuery(kindValue, directory, opts);
+        process.stdout.write(opts.format === "json"
+            ? jsonPayload("md query", envelope, opts)
+            : renderQueryText(result, plan, envelope.directory, opts.format === "human") + "\n");
+        return;
+    }
+    if (!LEGACY_KINDS.includes(kindValue)) {
+        throw new Error(`Unknown query kind: ${kindValue}`);
+    }
+    const kind = kindValue;
+    const dir = requireDirectory(directory, opts);
+    const files = runtime().workspace.markdownFiles(dir, {
+        include: opts.include,
+        exclude: opts.exclude,
+    });
+    let results;
+    let summary;
+    let resultCount;
+    if (kind === "links-to") {
+        if (!opts.target)
+            throw new Error("links-to requires --target <path[#heading]>");
+        results = linksToResults(files, opts.target, opts);
+    }
+    else if (kind === "duplicates") {
+        results = duplicateResults(files, opts.field, opts);
+    }
+    else if (kind === "unused-assets") {
+        results = unusedAssetResults(files, dir, opts);
+    }
+    else if (kind === "code-blocks") {
+        results = codeBlockResults(files, opts);
+    }
+    else if (kind === "tasks") {
+        ({ results, summary, count: resultCount } = taskResults(files, opts));
+    }
+    else if (kind === "frontmatter-keys") {
+        ({ results, summary, count: resultCount } = frontmatterKeyResults(files));
+    }
+    else {
+        results = files
+            .filter((file) => !runtime()
+            .workspace.document(file)
+            .headings.some((heading) => heading.depth === 1))
+            .map((file) => ({ file: outputPath(file, opts) }));
+    }
+    const envelope = {
+        kind,
+        directory: outputPath(dir, opts),
+        count: resultCount ?? results.length,
+        results,
+        ...(summary ? { summary } : {}),
+    };
+    process.stdout.write(opts.format === "json"
+        ? jsonPayload("md query", envelope, opts)
+        : textOutput(envelope, opts.format === "human") + "\n");
+}
+//# sourceMappingURL=query.js.map

package/dist/commands/query.js.map

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

package/dist/commands/refs-to.d.ts

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

package/dist/commands/refs-to.js

@@ -0,0 +1,65 @@
+import path from "node:path";
+import { findMarkdownFiles } from "../lint.js";
+import { documentsReferencing } from "../backlinks.js";
+import { outputPath } from "../runtime.js";
+import { requireDirectory } 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 formatResults(refs, targetFile, format, opts) {
+    if (format === "json") {
+        return jsonPayload("md refs-to", refs, opts).trimEnd();
+    }
+    if (refs.length === 0) {
+        if (format === "human") {
+            return `\x1b[33mNo references found to ${targetFile}\x1b[0m`;
+        }
+        return `No references found to ${targetFile}`;
+    }
+    // Group by source file
+    const byFile = new Map();
+    for (const r of refs) {
+        const existing = byFile.get(r.sourceFile) ?? [];
+        existing.push(r);
+        byFile.set(r.sourceFile, existing);
+    }
+    const lines = [];
+    if (format === "human") {
+        lines.push(`\n\x1b[1m${refs.length} reference(s) to ${targetFile} across ${byFile.size} file(s)\x1b[0m\n`);
+        for (const [file, fileRefs] of byFile) {
+            lines.push(`  \x1b[36m${file}\x1b[0m`);
+            for (const r of fileRefs) {
+                lines.push(`    line ${r.line}: \x1b[33m${r.rawTarget}\x1b[0m`);
+            }
+        }
+    }
+    else {
+        lines.push(`${refs.length} reference(s) to ${targetFile} across ${byFile.size} file(s):`);
+        for (const [file, fileRefs] of byFile) {
+            lines.push(`  ${file}`);
+            for (const r of fileRefs) {
+                lines.push(`    ${file}:${r.line} ${r.rawTarget}`);
+            }
+        }
+    }
+    return lines.join("\n");
+}
+export async function refsToAction(file, directory, opts) {
+    const format = resolveFormat(opts);
+    const targetPath = path.resolve(file);
+    const searchDir = requireDirectory(directory ?? ".", opts);
+    const mdFiles = findMarkdownFiles(searchDir, { include: opts.include, exclude: opts.exclude });
+    const shownRefs = documentsReferencing(mdFiles, targetPath).map((ref) => ({
+        sourceFile: outputPath(ref.sourceFile, opts),
+        line: ref.line,
+        linkText: ref.linkText,
+        rawTarget: ref.rawTarget,
+    }));
+    const output = formatResults(shownRefs, outputPath(targetPath, opts), format, opts);
+    process.stdout.write(output + "\n");
+}
+//# sourceMappingURL=refs-to.js.map

package/dist/commands/refs-to.js.map

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

package/dist/commands/refs.d.ts

@@ -0,0 +1,10 @@
+interface RefsOptions {
+    envelope?: boolean;
+    format: string;
+    external: boolean;
+    anchors: boolean;
+    images: boolean;
+    stdinName?: string;
+}
+export declare function refsAction(file: string, opts: RefsOptions): Promise<void>;
+export {};