@cairn-tool/cairn 2.0.0

package/dist/commands/describe.js

@@ -0,0 +1,62 @@
+import { BASE_FORMATS } from "../formats.js";
+import { buildDescription, selectCommands } from "../contract/describe.js";
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+const RESET = "\x1b[0m";
+function renderCommand(command, human) {
+    const name = human ? `${BOLD}${command.id}${RESET}` : command.id;
+    const lines = [name, `  ${command.description}`, `  usage: ${command.usage}`];
+    if (command.formats?.length)
+        lines.push(`  formats: ${command.formats.join(", ")} (default ${command.defaultFormat})`);
+    if (command.outputSchema)
+        lines.push(`  json schema: ${command.outputSchema}`);
+    if (command.jsonlSchema)
+        lines.push(`  jsonl schema: ${command.jsonlSchema}`);
+    if (command.stream)
+        lines.push(`  stream: ${command.stream.success} on success` +
+            (command.stream.findings ? `, ${command.stream.findings} on findings` : ""));
+    if (command.writes)
+        lines.push("  writes: may modify files");
+    for (const exit of command.exitCodes)
+        lines.push(`  exit ${exit.code}: ${exit.meaning}`);
+    if (command.stability === "undeclared")
+        lines.push(human ? `  ${DIM}contract: undeclared${RESET}` : "  contract: undeclared");
+    if (command.notes)
+        lines.push(`  note: ${command.notes}`);
+    return lines;
+}
+function renderText(result, human) {
+    const lines = [
+        `${result.tool.name} ${result.tool.version}`,
+        `contract schema version: ${result.schemaVersion}`,
+        `format shorthands: ${Object.entries(result.formatShorthands)
+            .map(([flag, value]) => `${flag} = ${value}`)
+            .join(", ")}`,
+        "",
+        `update notice: ${result.machineStreams.description}`,
+        ...result.machineStreams.suppressedWhen.map((condition) => `  suppressed when ${condition}`),
+        "",
+        `commands (${result.commands.length}):`,
+        "",
+    ];
+    for (const command of result.commands)
+        lines.push(...renderCommand(command, human), "");
+    return lines.join("\n").trimEnd() + "\n";
+}
+/**
+ * Describes the CLI contract. Reports the static contract: project
+ * configuration is deliberately not applied, so a consumer sees the same answer
+ * regardless of the directory it runs in.
+ */
+export async function describeAction(program, commandPath, opts) {
+    const format = opts.format || "llm";
+    // A contract command must not silently substitute a format it was not asked for.
+    if (!BASE_FORMATS.includes(format))
+        throw new Error(`Invalid output format: ${format}`);
+    const full = buildDescription(program, { name: opts.toolName, version: opts.toolVersion });
+    const result = commandPath.length ? selectCommands(full, commandPath) : full;
+    process.stdout.write(format === "json"
+        ? JSON.stringify(result, null, 2) + "\n"
+        : renderText(result, format === "human"));
+}
+//# sourceMappingURL=describe.js.map

package/dist/commands/describe.js.map

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

package/dist/commands/diff.d.ts

@@ -0,0 +1,11 @@
+interface DiffOptions {
+    envelope?: boolean;
+    format: string;
+    paths?: string;
+    since?: string;
+    summary: boolean;
+    include: string[];
+    exclude: string[];
+}
+export declare function diffAction(a: string | undefined, b: string | undefined, opts: DiffOptions): Promise<void>;
+export {};

package/dist/commands/diff.js

@@ -0,0 +1,185 @@
+import fs from "node:fs";
+import path from "node:path";
+import { minimatch } from "minimatch";
+import { diffDocuments, summarize, } from "../diff.js";
+import { changesSince, readAtRevision, repositoryFor, repositoryRelative, resolveCommit, worktreePath, } from "../git.js";
+import { buildDocument } from "../workspace.js";
+import { requireFile } from "../input.js";
+import { outputPath, runtime } from "../runtime.js";
+import { jsonPayload } from "../result.js";
+function resolveFormat(opts) {
+    const fmt = opts.format;
+    if (fmt === "llm" || fmt === "human" || fmt === "json")
+        return fmt;
+    return "llm";
+}
+/** Parses a document at a revision without letting it into the workspace cache. */
+function baseDocument(repository, revision, repoRelativePath) {
+    const content = readAtRevision(repository, revision, repoRelativePath);
+    if (content === undefined)
+        return null;
+    return buildDocument(worktreePath(repository, repoRelativePath), content);
+}
+function worktreeDocument(file) {
+    if (!fs.existsSync(file) || !fs.statSync(file).isFile())
+        return null;
+    return runtime().workspace.document(file);
+}
+function revisionReport(target, opts) {
+    const root = runtime().config.root;
+    const revision = opts.since;
+    const repository = repositoryFor(root);
+    const scope = path.resolve(target ?? root);
+    const scopeIsFile = fs.existsSync(scope) && fs.statSync(scope).isFile();
+    const scopePrefix = scopeIsFile ? repositoryRelative(repository, scope) : undefined;
+    const scopeDirectory = scopeIsFile ? undefined : repositoryRelative(repository, scope);
+    // A deleted file has no worktree entry, so include/exclude are matched
+    // against the path string rather than resolved through the workspace walker.
+    const selected = (change) => {
+        const absolute = worktreePath(repository, change.newPath ?? change.oldPath ?? "");
+        const relative = path.relative(root, absolute).split(path.sep).join("/");
+        const matches = (pattern) => minimatch(relative, pattern, { dot: true, nonegate: true });
+        return opts.include.some(matches) && !opts.exclude.some(matches);
+    };
+    const inScope = (change) => {
+        const name = change.newPath ?? change.oldPath ?? "";
+        if (scopePrefix !== undefined)
+            return name === scopePrefix;
+        if (scopeDirectory) {
+            if (name !== scopeDirectory && !name.startsWith(`${scopeDirectory}/`))
+                return false;
+        }
+        return selected(change);
+    };
+    const files = [];
+    for (const change of changesSince(repository, revision).filter(inScope)) {
+        const newPath = change.newPath;
+        const oldPath = change.oldPath;
+        const before = oldPath ? baseDocument(repository, revision, oldPath) : null;
+        const after = newPath ? worktreeDocument(worktreePath(repository, newPath)) : null;
+        if (!before && !after)
+            continue;
+        const shownFile = outputPath(worktreePath(repository, newPath ?? oldPath ?? ""), opts);
+        files.push(diffDocuments(before, after, {
+            root,
+            file: shownFile,
+            ...(oldPath && newPath && oldPath !== newPath
+                ? { oldPath: outputPath(worktreePath(repository, oldPath), opts) }
+                : {}),
+            ...(change.similarity === undefined ? {} : { similarity: change.similarity }),
+        }));
+    }
+    files.sort((a, b) => (a.file < b.file ? -1 : a.file > b.file ? 1 : 0));
+    return summarize(files, {
+        mode: "revision",
+        base: revision,
+        baseCommit: resolveCommit(repository, revision),
+    });
+}
+function filesReport(from, to, opts) {
+    const before = requireFile(from, opts);
+    const after = requireFile(to, opts);
+    const workspace = runtime().workspace;
+    const diff = diffDocuments(workspace.document(before), workspace.document(after), {
+        root: runtime().config.root,
+        file: outputPath(after, opts),
+        oldPath: outputPath(before, opts),
+    });
+    return summarize([diff], {
+        mode: "files",
+        from: outputPath(before, opts),
+        to: outputPath(after, opts),
+    });
+}
+function headingLine(change) {
+    const where = change.newLine ?? change.oldLine;
+    if (change.kind === "added")
+        return `"${change.newText}" L${where}`;
+    if (change.kind === "removed")
+        return `"${change.oldText}" L${where}`;
+    if (change.kind === "renamed") {
+        return (`"${change.oldText}" -> "${change.newText}" (L${where}` +
+            (change.heuristic ? ", heuristic)" : ")"));
+    }
+    if (change.kind === "moved")
+        return `"${change.newText}" L${change.oldLine} -> L${change.newLine}`;
+    return `"${change.newText}" L${where} body changed`;
+}
+function renderText(report, view) {
+    const { human, summary } = view;
+    const bold = (value) => (human ? `\x1b[1m${value}\x1b[0m` : value);
+    const dim = (value) => (human ? `\x1b[2m${value}\x1b[0m` : value);
+    const colored = (value, code) => (human ? `\x1b[${code}m${value}\x1b[0m` : value);
+    const paint = (kind) => colored(kind.padEnd(7), kind === "added" ? "32" : kind === "removed" ? "31" : kind === "changed" ? "36" : "33");
+    const head = report.mode === "revision"
+        ? `Diff: ${report.base} (${report.baseCommit?.slice(0, 7)}) -> worktree`
+        : `Diff: ${report.from} -> ${report.to}`;
+    const lines = [
+        bold(head),
+        `${report.totals.filesChanged} file(s) changed of ${report.totals.files}, ` +
+            `${report.totals.headings + report.totals.frontmatter + report.totals.links + report.totals.tasks + report.totals.codeBlocks + report.totals.tables} change(s)`,
+    ];
+    for (const file of report.files) {
+        if (file.status === "unchanged" && !summary)
+            continue;
+        const name = file.oldPath ? `${file.oldPath} -> ${file.file}` : file.file;
+        lines.push("", bold(`${name} [${file.status}]`) + ` ${file.totals.changes} change(s)`);
+        if (summary)
+            continue;
+        for (const change of file.headings) {
+            lines.push(`  heading      ${paint(change.kind)} ${headingLine(change)}`);
+        }
+        for (const change of file.frontmatter) {
+            const key = change.key ?? "(block)";
+            const detail = change.key === null
+                ? `${change.oldStatus} -> ${change.newStatus}`
+                : `${JSON.stringify(change.oldValue) ?? ""} -> ${JSON.stringify(change.newValue) ?? ""}`;
+            lines.push(`  frontmatter  ${paint(change.kind)} ${key}: ${detail}`);
+        }
+        for (const change of file.links) {
+            const detail = change.kind === "changed"
+                ? `${change.oldTarget} -> ${change.newTarget}${change.fragmentChanged ? " (anchor only)" : ""}`
+                : (change.newTarget ?? change.oldTarget);
+            lines.push(`  link         ${paint(change.kind)} ${detail} (L${change.newLine ?? change.oldLine})`);
+        }
+        for (const change of file.tasks) {
+            const state = change.kind === "changed"
+                ? `[${change.oldChecked ? "x" : " "}] -> [${change.newChecked ? "x" : " "}]`
+                : `[${(change.newChecked ?? change.oldChecked) ? "x" : " "}]`;
+            lines.push(`  task         ${paint(change.kind)} ${state} "${change.text}" (L${change.newLine ?? change.oldLine})`);
+        }
+        for (const change of file.codeBlocks) {
+            const detail = change.langChanged
+                ? `lang ${change.oldLang ?? "(none)"} -> ${change.newLang ?? "(none)"}`
+                : `${change.newLang ?? change.oldLang ?? "(none)"}${change.contentChanged ? " body changed" : ""}`;
+            lines.push(`  ${change.mermaid ? "diagram   " : "code-block"}   ${paint(change.kind)} ${detail} (L${change.newLine ?? change.oldLine})`);
+        }
+        for (const change of file.tables) {
+            lines.push(`  table        ${paint(change.kind)} ${change.newColumns ?? change.oldColumns} column(s), ` +
+                `${change.newRows ?? change.oldRows} row(s)${change.headersChanged ? ", headers changed" : ""} ` +
+                `(L${change.newLine ?? change.oldLine})`);
+        }
+    }
+    if (!report.totals.filesChanged)
+        lines.push("", "No Markdown changes.");
+    if (report.totals.heuristicRenames) {
+        lines.push("", dim(`${report.totals.heuristicRenames} rename(s) were matched by position and are a heuristic, not a fact.`));
+    }
+    return lines.join("\n");
+}
+export async function diffAction(a, b, opts) {
+    const format = resolveFormat(opts);
+    if (b !== undefined && opts.since) {
+        throw new Error("--since cannot be combined with two paths");
+    }
+    if (b === undefined && !opts.since) {
+        throw new Error("md diff needs two paths, or --since <revision> to compare against");
+    }
+    if (a === "-" || b === "-")
+        throw new Error("md diff does not accept stdin");
+    const report = b !== undefined ? filesReport(a, b, opts) : revisionReport(a, opts);
+    process.stdout.write(format === "json"
+        ? jsonPayload("md diff", report, opts)
+        : renderText(report, { human: format === "human", summary: opts.summary }) + "\n");
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

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

package/dist/commands/fix.d.ts

@@ -0,0 +1,59 @@
+import { type UnfixableFinding } from "../fix/registry.js";
+export type FixMode = "check" | "dry-run" | "write";
+interface FixOptions {
+    envelope?: boolean;
+    format: string;
+    paths?: string;
+    rule: string[];
+    check?: boolean;
+    write?: boolean;
+    dryRun?: boolean;
+    include: string[];
+    exclude: string[];
+    changedSince?: string;
+    maxDepth: string;
+    minDepth: string;
+    ordered: boolean;
+}
+export interface FixEditJson {
+    /** UTF-16 code-unit offset of the first replaced character. */
+    start: number;
+    /** Exclusive. `start === end` is an insertion. */
+    end: number;
+    /** 1-based line containing `start`. */
+    line: number;
+    /** The exact text currently at `[start, end)`. */
+    expected: string;
+    replacement: string;
+    diagnostic: {
+        rule: string;
+        line: number;
+        message: string;
+    };
+}
+export interface FixFileJson {
+    file: string;
+    edits: FixEditJson[];
+    /** Present only in --write mode: whether the file's bytes changed. */
+    applied?: boolean;
+}
+export interface FixPayload {
+    mode: FixMode;
+    /** The fixers that ran, sorted. */
+    rules: string[];
+    filesScanned: number;
+    filesWithEdits: number;
+    edits: number;
+    /** Files whose bytes changed. Always 0 outside --write. */
+    applied: number;
+    files: FixFileJson[];
+    conflicts: Array<{
+        kind: string;
+        file: string;
+        message: string;
+        rules: string[];
+    }>;
+    unfixable: UnfixableFinding[];
+}
+export declare function fixAction(inputs: string[], opts: FixOptions): Promise<void>;
+export {};

package/dist/commands/fix.js

@@ -0,0 +1,173 @@
+import { applyPlan, buildPlan, containmentRoot, snapshot, } from "../edit-plan.js";
+import { selectFixers } from "../fix/registry.js";
+import { resolveMarkdownInputs } from "../input-selection.js";
+import { outputPath, runtime } from "../runtime.js";
+import { terminate } from "../command-result.js";
+import { jsonPayload } from "../result.js";
+function resolveFormat(opts) {
+    const fmt = opts.format;
+    if (fmt === "llm" || fmt === "human" || fmt === "json")
+        return fmt;
+    return "llm";
+}
+/**
+ * Which of check, dry-run, and write was asked for.
+ *
+ * A plain guard is enough here, unlike `md toc`, because those three keys are
+ * deliberately absent from `COMMAND_OPTIONS.fix`: the mutation mode is
+ * CLI-only, so a checked-in config file can never turn `md fix` into a writer
+ * and there is no config-versus-CLI ambiguity to disentangle.
+ */
+function resolveMode(opts) {
+    const requested = [
+        ["check", opts.check],
+        ["write", opts.write],
+        ["dry-run", opts.dryRun],
+    ]
+        .filter(([, enabled]) => enabled)
+        .map(([name]) => name);
+    if (requested.length > 1) {
+        throw new Error("--check, --write, and --dry-run cannot be used together");
+    }
+    return requested[0] ?? "check";
+}
+function truncate(value, limit = 120) {
+    const flat = value.replace(/\n/g, "\\n");
+    return flat.length > limit ? `${flat.slice(0, limit)}…` : flat;
+}
+function renderText(payload, human) {
+    const bold = (value) => (human ? `\x1b[1m${value}\x1b[0m` : value);
+    const red = (value) => (human ? `\x1b[31m${value}\x1b[0m` : value);
+    const green = (value) => (human ? `\x1b[32m${value}\x1b[0m` : value);
+    const cyan = (value) => (human ? `\x1b[36m${value}\x1b[0m` : value);
+    const rules = payload.rules.join(", ");
+    const lines = [];
+    if (payload.mode === "check") {
+        lines.push(payload.edits
+            ? bold(`${payload.edits} pending fix(es) in ${payload.filesWithEdits} file(s) [rules: ${rules}]`)
+            : `No pending fixes in ${payload.filesScanned} file(s) [rules: ${rules}]`);
+        for (const file of payload.files) {
+            for (const item of file.edits) {
+                lines.push(`  ${cyan(`${file.file}:L${item.line}`)}  ${item.diagnostic.rule}  ${item.diagnostic.message}`);
+            }
+        }
+        if (payload.edits)
+            lines.push("Run with --dry-run to see the full plan, or --write to apply.");
+    }
+    else if (payload.mode === "dry-run") {
+        for (const file of payload.files) {
+            lines.push(bold(file.file));
+            for (const item of file.edits) {
+                lines.push(`  L${item.line}  ${item.diagnostic.rule}  [${item.start},${item.end})`, `    ${red(`- ${truncate(item.expected)}`)}`, `    ${green(`+ ${truncate(item.replacement)}`)}`);
+            }
+        }
+        lines.push(payload.edits
+            ? `${payload.edits} edit(s) across ${payload.filesWithEdits} file(s). (dry run — no files modified)`
+            : `No pending fixes in ${payload.filesScanned} file(s).`);
+    }
+    else {
+        for (const file of payload.files) {
+            lines.push(`${file.file}  ${file.edits.length} edit(s)`);
+        }
+        lines.push(payload.applied
+            ? `Applied ${payload.edits} edit(s) across ${payload.applied} file(s).`
+            : `No pending fixes in ${payload.filesScanned} file(s).`);
+    }
+    if (payload.conflicts.length) {
+        lines.push("", bold("Conflicts (nothing will be written):"));
+        for (const conflict of payload.conflicts) {
+            lines.push(`  ${conflict.file}  ${conflict.kind}  ${conflict.message}`);
+        }
+    }
+    if (payload.unfixable.length) {
+        lines.push("", bold("Not fixable automatically:"));
+        for (const item of payload.unfixable) {
+            lines.push(`  ${item.file}:L${item.line}  ${item.rule}  ${item.message} (${item.reason})`);
+        }
+    }
+    return lines.join("\n");
+}
+function toPayload(mode, rules, filesScanned, plan, unfixable, applied, opts) {
+    const files = plan.files.map((entry) => ({
+        file: outputPath(entry.file, opts),
+        edits: entry.edits.map((item) => ({
+            start: item.start,
+            end: item.end,
+            line: item.diagnostic.line,
+            expected: item.expected,
+            replacement: item.replacement,
+            diagnostic: { ...item.diagnostic },
+        })),
+        ...(applied ? { applied: applied.has(entry.file) } : {}),
+    }));
+    return {
+        mode,
+        rules,
+        filesScanned,
+        filesWithEdits: plan.files.length,
+        edits: plan.files.reduce((total, entry) => total + entry.edits.length, 0),
+        applied: applied?.size ?? 0,
+        files,
+        conflicts: plan.conflicts.map((conflict) => ({
+            ...conflict,
+            file: outputPath(conflict.file, opts),
+        })),
+        unfixable: unfixable.map((item) => ({ ...item, file: outputPath(item.file, opts) })),
+    };
+}
+export async function fixAction(inputs, opts) {
+    const format = resolveFormat(opts);
+    const mode = resolveMode(opts);
+    // md fix writes, and stdin has no path to write back to.
+    if (inputs.includes("-"))
+        throw new Error("md fix does not accept stdin");
+    const fixers = selectFixers(opts.rule);
+    const files = resolveMarkdownInputs(inputs, {
+        include: opts.include,
+        exclude: opts.exclude,
+        changedSince: opts.changedSince,
+    });
+    const root = containmentRoot(files, runtime().config);
+    const snapshots = new Map();
+    const context = {
+        root,
+        snapshot: (file) => {
+            const cached = snapshots.get(file);
+            if (cached)
+                return cached;
+            const taken = snapshot(file);
+            snapshots.set(file, taken);
+            return taken;
+        },
+        toc: { maxDepth: opts.maxDepth, minDepth: opts.minDepth, ordered: opts.ordered },
+    };
+    const edits = [];
+    const unfixable = [];
+    for (const fixer of fixers) {
+        const result = await fixer.plan(files, context);
+        edits.push(...result.edits);
+        unfixable.push(...result.unfixable);
+    }
+    const plan = buildPlan(root, edits, snapshots);
+    let applied;
+    if (mode === "write" && !plan.conflicts.length) {
+        const result = applyPlan(plan, { invalidate: (file) => runtime().workspace.invalidate(file) });
+        applied = new Set(result.files.filter((file) => file.changed).map((file) => file.file));
+    }
+    const payload = toPayload(mode, fixers.map((fixer) => fixer.name).sort(), files.length, plan, unfixable, mode === "write" ? (applied ?? new Set()) : undefined, opts);
+    // A conflict means --write cannot succeed, so it fails every mode: otherwise
+    // `md fix --dry-run && md fix --write` would be a lie. A pending edit only
+    // fails --check, which is the mode meant for CI. Unfixable findings never
+    // change the exit code — there is no fix available to make them go away.
+    const actionable = payload.conflicts.length > 0 || (mode === "check" && payload.edits > 0);
+    const rendered = format === "json"
+        ? jsonPayload("md fix", payload, opts, {
+            exitCode: actionable ? 2 : 0,
+            summary: { edits: payload.edits, conflicts: payload.conflicts.length },
+        }).trimEnd()
+        : renderText(payload, format === "human");
+    (actionable ? process.stderr : process.stdout).write(rendered + "\n");
+    if (actionable)
+        terminate(2);
+}
+//# sourceMappingURL=fix.js.map

package/dist/commands/fix.js.map

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

package/dist/commands/frontmatter.d.ts

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

package/dist/commands/frontmatter.js

@@ -0,0 +1,84 @@
+import { outputPath, runtime } from "../runtime.js";
+import { terminate } from "../command-result.js";
+import { requireFile } from "../input.js";
+import { jsonPayload } from "../result.js";
+import { nestedValue } from "../object-path.js";
+function resolveFormat(opts) {
+    const fmt = opts.format;
+    if (fmt === "llm" || fmt === "human" || fmt === "json")
+        return fmt;
+    return "llm";
+}
+function formatYamlLike(data, indent = 2) {
+    if (data === null || data === undefined)
+        return "null";
+    if (typeof data !== "object")
+        return String(data);
+    if (Array.isArray(data)) {
+        return ("[" +
+            data.map((v) => (typeof v === "object" ? JSON.stringify(v) : String(v))).join(", ") +
+            "]");
+    }
+    const lines = [];
+    const prefix = " ".repeat(indent);
+    for (const [key, value] of Object.entries(data)) {
+        if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+            lines.push(`${prefix}${key}:`);
+            lines.push(formatYamlLike(value, indent + 2));
+        }
+        else {
+            const formatted = Array.isArray(value)
+                ? "[" +
+                    value.map((v) => (typeof v === "object" ? JSON.stringify(v) : String(v))).join(", ") +
+                    "]"
+                : String(value);
+            lines.push(`${prefix}${key}: ${formatted}`);
+        }
+    }
+    return lines.join("\n");
+}
+export async function frontmatterAction(file, opts) {
+    const format = resolveFormat(opts);
+    const filePath = requireFile(file, opts);
+    const shownPath = outputPath(filePath, opts);
+    const frontmatter = runtime().workspace.document(filePath).frontmatter;
+    if (frontmatter.status === "missing") {
+        if (opts.key) {
+            process.stderr.write(`Error: Key not found: ${opts.key} (no frontmatter in file)\n`);
+            terminate(1);
+        }
+        if (format === "json") {
+            process.stdout.write("null\n");
+        }
+        else {
+            process.stdout.write(`No frontmatter in ${shownPath}\n`);
+        }
+        return;
+    }
+    if (frontmatter.status === "malformed") {
+        throw new Error(`${shownPath}: ${frontmatter.message}`);
+    }
+    const data = frontmatter.data;
+    if (opts.key) {
+        const value = nestedValue(data, opts.key);
+        if (value === undefined) {
+            process.stderr.write(`Error: Key not found: ${opts.key}\n`);
+            terminate(1);
+        }
+        if (format === "json") {
+            process.stdout.write(jsonPayload("md frontmatter", value, opts));
+        }
+        else {
+            process.stdout.write(String(value) + "\n");
+        }
+        return;
+    }
+    if (format === "json") {
+        process.stdout.write(jsonPayload("md frontmatter", data, opts));
+        return;
+    }
+    const isHuman = format === "human";
+    const bold = (s) => (isHuman ? `\x1b[1m${s}\x1b[0m` : s);
+    process.stdout.write(bold(`Frontmatter in ${shownPath}:`) + "\n" + formatYamlLike(data) + "\n");
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/commands/frontmatter.js.map

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

package/dist/commands/graph.d.ts

@@ -0,0 +1,12 @@
+interface GraphOptions {
+    envelope?: boolean;
+    format: string;
+    output: "report" | "mermaid" | "dot";
+    entry: string[];
+    focus: string[];
+    depth: string;
+    include: string[];
+    exclude: string[];
+}
+export declare function graphAction(directory: string, opts: GraphOptions): Promise<void>;
+export {};