daftari 1.12.6 → 1.13.1

package/dist/audit/config.js

@@ -0,0 +1,174 @@
+// src/audit/config.ts
+// Parses CLI argv + an optional audit.yaml into an AuditConfig. CLI wins on
+// overlap with YAML; for --output flags only, a stderr warning is emitted so
+// operators see when the file they expected to be written has been displaced.
+import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+import yaml from "js-yaml";
+import { err, ok } from "../frontmatter/types.js";
+import { configError } from "./types.js";
+// Inner helpers throw tagged AuditError objects (not class instances). The
+// top-level parseAuditConfig wraps in try/catch and converts to Result.
+function isAuditError(e) {
+    return (typeof e === "object" &&
+        e !== null &&
+        (e.kind === "config" || e.kind === "runtime"));
+}
+const DEFAULTS = {
+    docsGlob: "**/*.md",
+    thresholdDays: 540,
+    failOn: { brokenRefs: 1, transitiveStaleness: 100 },
+};
+function readArg(argv, flag) {
+    for (let i = 0; i < argv.length; i++) {
+        if (argv[i] === flag)
+            return argv[i + 1];
+        const prefix = `${flag}=`;
+        if (argv[i]?.startsWith(prefix))
+            return argv[i]?.slice(prefix.length);
+    }
+    return undefined;
+}
+function readMulti(argv, flag) {
+    const out = [];
+    for (let i = 0; i < argv.length; i++) {
+        if (argv[i] === flag && argv[i + 1] !== undefined) {
+            out.push(argv[i + 1]);
+            i++;
+        }
+        else {
+            const prefix = `${flag}=`;
+            if (argv[i]?.startsWith(prefix))
+                out.push(argv[i].slice(prefix.length));
+        }
+    }
+    return out;
+}
+function validateRepoPath(p, label) {
+    if (!existsSync(p)) {
+        throw configError(`${label}: path does not exist: ${p}`);
+    }
+    if (!statSync(p).isDirectory()) {
+        throw configError(`${label}: not a directory: ${p}`);
+    }
+    return realpathSync(p);
+}
+function parseYamlRepos(raw) {
+    if (!raw)
+        return [];
+    return raw.map((r, i) => {
+        if (typeof r.name !== "string" || r.name.length === 0) {
+            throw configError(`repos[${i}]: missing name`);
+        }
+        if (typeof r.path !== "string" || r.path.length === 0) {
+            throw configError(`repos[${i}] (${r.name}): missing path`);
+        }
+        const path = validateRepoPath(resolve(r.path), `repos[${i}] (${r.name})`);
+        const docsGlob = typeof r.docs_glob === "string" ? r.docs_glob : DEFAULTS.docsGlob;
+        const urls = Array.isArray(r.urls)
+            ? r.urls.filter((u) => typeof u === "string")
+            : [];
+        return { name: r.name, path, docsGlob, urls };
+    });
+}
+function ensureUnique(repos) {
+    const seenName = new Set();
+    const seenPath = new Set();
+    for (const r of repos) {
+        if (seenName.has(r.name)) {
+            throw configError(`duplicate repo name: ${r.name}`);
+        }
+        if (seenPath.has(r.path)) {
+            throw configError(`duplicate repo path: ${r.path}`);
+        }
+        seenName.add(r.name);
+        seenPath.add(r.path);
+    }
+}
+function warn(msg) {
+    process.stderr.write(`daftari audit: warning: ${msg}\n`);
+}
+export function parseAuditConfig(argv, yamlLoader) {
+    try {
+        const configPath = readArg(argv, "--config");
+        let yamlRaw = {};
+        if (configPath !== undefined) {
+            const load = yamlLoader ?? ((p) => readFileSync(p, "utf-8"));
+            let text;
+            try {
+                text = load(configPath);
+            }
+            catch (e) {
+                const reason = e instanceof Error ? e.message : String(e);
+                throw configError(`cannot read --config ${configPath}: ${reason}`);
+            }
+            try {
+                const raw = yaml.load(text);
+                if (raw === null || raw === undefined) {
+                    yamlRaw = {};
+                }
+                else if (typeof raw !== "object" || Array.isArray(raw)) {
+                    throw configError(`${configPath}: expected a YAML map at top level, got ${Array.isArray(raw) ? "array" : typeof raw}`);
+                }
+                else {
+                    yamlRaw = raw;
+                }
+            }
+            catch (e) {
+                if (isAuditError(e))
+                    throw e;
+                const reason = e instanceof Error ? e.message : String(e);
+                throw configError(`malformed YAML in ${configPath}: ${reason}`);
+            }
+        }
+        const yamlRepos = parseYamlRepos(yamlRaw.repos);
+        const cliRepoPaths = readMulti(argv, "--repo");
+        const cliRepos = cliRepoPaths.map((rawPath, i) => {
+            const path = validateRepoPath(resolve(rawPath), `--repo ${rawPath}`);
+            return {
+                name: `repo-${i}`,
+                path,
+                docsGlob: DEFAULTS.docsGlob,
+                urls: [],
+            };
+        });
+        const repos = [...yamlRepos, ...cliRepos];
+        if (repos.length === 0) {
+            throw configError("no repos configured: pass --repo or --config");
+        }
+        ensureUnique(repos);
+        // Output handling: CLI wins, warn if it displaces YAML.
+        const yamlMd = typeof yamlRaw.output?.markdown === "string" ? yamlRaw.output.markdown : undefined;
+        const yamlJson = typeof yamlRaw.output?.json === "string" ? yamlRaw.output.json : undefined;
+        const cliMd = readArg(argv, "--output");
+        const cliJson = readArg(argv, "--output-json");
+        if (cliMd && yamlMd && cliMd !== yamlMd) {
+            warn(`--output overrides output.markdown from config (${yamlMd} → ${cliMd})`);
+        }
+        if (cliJson && yamlJson && cliJson !== yamlJson) {
+            warn(`--output-json overrides output.json from config (${yamlJson} → ${cliJson})`);
+        }
+        const output = {
+            markdown: cliMd ?? yamlMd,
+            json: cliJson ?? yamlJson,
+        };
+        const thresholdDays = typeof yamlRaw.staleness?.threshold_days === "number"
+            ? yamlRaw.staleness.threshold_days
+            : DEFAULTS.thresholdDays;
+        const failOn = {
+            brokenRefs: typeof yamlRaw.fail_on?.broken_refs === "number"
+                ? yamlRaw.fail_on.broken_refs
+                : DEFAULTS.failOn.brokenRefs,
+            transitiveStaleness: typeof yamlRaw.fail_on?.transitive_staleness === "number"
+                ? yamlRaw.fail_on.transitive_staleness
+                : DEFAULTS.failOn.transitiveStaleness,
+        };
+        return ok({ repos, output, staleness: { thresholdDays }, failOn });
+    }
+    catch (e) {
+        if (isAuditError(e))
+            return err(e);
+        throw e; // not ours; let it propagate
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/audit/config.js.map

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

package/dist/audit/exit.d.ts

@@ -0,0 +1,6 @@
+import type { AuditReport } from "./types.js";
+export declare function computeExitCode(report: AuditReport, failOn: {
+    brokenRefs: number;
+    transitiveStaleness: number;
+}): 0 | 1;
+//# sourceMappingURL=exit.d.ts.map

package/dist/audit/exit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit.d.ts","sourceRoot":"","sources":["../../src/audit/exit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,GAC1D,CAAC,GAAG,CAAC,CAIP"}

package/dist/audit/exit.js

@@ -0,0 +1,8 @@
+export function computeExitCode(report, failOn) {
+    if (report.totals.brokenRefs >= failOn.brokenRefs)
+        return 1;
+    if (report.totals.transitivelyStale >= failOn.transitiveStaleness)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=exit.js.map

package/dist/audit/exit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit.js","sourceRoot":"","sources":["../../src/audit/exit.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAC7B,MAAmB,EACnB,MAA2D;IAE3D,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU;QAAE,OAAO,CAAC,CAAC;IAC5D,IAAI,MAAM,CAAC,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,mBAAmB;QAAE,OAAO,CAAC,CAAC;IAC5E,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/audit/index.d.ts

@@ -0,0 +1,2 @@
+export declare function runAudit(argv: string[]): Promise<number>;
+//# sourceMappingURL=index.d.ts.map

package/dist/audit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audit/index.ts"],"names":[],"mappings":"AA2CA,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyD9D"}

package/dist/audit/index.js

@@ -0,0 +1,93 @@
+// src/audit/index.ts
+// Top-level entry for `daftari audit`. Loads config, runs the pipeline,
+// emits reports, and translates AuditError.kind to exit codes:
+//   0 — clean run within thresholds
+//   1 — clean run, thresholds exceeded
+//   2 — config error
+//   3 — runtime error
+import { writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { checkBrokenRefs } from "./checks/broken_refs.js";
+import { checkStaleness } from "./checks/staleness.js";
+import { collectRepos } from "./collect.js";
+import { parseAuditConfig } from "./config.js";
+import { computeExitCode } from "./exit.js";
+import { classifyEdges } from "./links.js";
+import { renderJson, renderMarkdown } from "./report.js";
+const HELP = `daftari audit — coherence checks across markdown repos.
+
+Usage:
+  daftari audit --repo <path> [--repo <path> ...] [--output <md>]
+  daftari audit --config audit.yaml [--repo <path> ...]
+  daftari audit --help
+
+Flags:
+  --repo <path>          Add a repo to the audit. May be repeated. Anonymous
+                         CLI repos get no URL patterns — URL-based cross-repo
+                         references to them will not be detected. Use --config
+                         to declare urls explicitly.
+  --config <path>        Load an audit.yaml. CLI flags override its values for
+                         output paths (a warning is printed to stderr).
+  --output <md>          Markdown report destination (default: stdout).
+  --output-json <json>   JSON report destination (default: not written).
+
+Exit codes:
+  0  — run succeeded, all findings under configured thresholds
+  1  — run succeeded but a fail_on threshold was exceeded
+  2  — config error (missing fields, bad paths, malformed YAML)
+  3  — runtime error (IO failure during collection)
+`;
+export async function runAudit(argv) {
+    if (argv.length === 0 || argv.includes("--help") || argv.includes("-h")) {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    const parsed = parseAuditConfig(argv);
+    if (!parsed.ok) {
+        process.stderr.write(`daftari audit: ${parsed.error.message}\n`);
+        return parsed.error.kind === "config" ? 2 : 3;
+    }
+    const config = parsed.value;
+    const collected = await collectRepos(config);
+    if (!collected.ok) {
+        process.stderr.write(`daftari audit: ${collected.error.message}\n`);
+        return collected.error.kind === "config" ? 2 : 3;
+    }
+    const snapshots = collected.value;
+    const edges = classifyEdges(snapshots);
+    const brokenRefs = checkBrokenRefs(snapshots, edges);
+    const staleness = checkStaleness(snapshots, edges, config.staleness.thresholdDays, new Date());
+    const totals = {
+        reposScanned: snapshots.length,
+        docsScanned: snapshots.reduce((n, s) => n + s.docs.size, 0),
+        brokenRefs: brokenRefs.length,
+        directlyStale: staleness.filter((f) => f.kind === "direct").length,
+        transitivelyStale: staleness.filter((f) => f.kind === "transitive").length,
+    };
+    const report = {
+        generatedAt: new Date().toISOString(),
+        config,
+        totals,
+        brokenRefs,
+        staleness,
+    };
+    const md = renderMarkdown(report);
+    try {
+        if (config.output.markdown) {
+            await writeFile(resolve(config.output.markdown), md, "utf-8");
+        }
+        else {
+            process.stdout.write(md);
+        }
+        if (config.output.json) {
+            await writeFile(resolve(config.output.json), renderJson(report), "utf-8");
+        }
+    }
+    catch (e) {
+        const reason = e instanceof Error ? e.message : String(e);
+        process.stderr.write(`daftari audit: write failed: ${reason}\n`);
+        return 3;
+    }
+    return computeExitCode(report, config.failOn);
+}
+//# sourceMappingURL=index.js.map

package/dist/audit/index.js.map

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

package/dist/audit/links.d.ts

@@ -0,0 +1,4 @@
+import type { LinkEdge, LinkRef, RepoSnapshot } from "./types.js";
+export declare function extractLinksFromBody(body: string): LinkRef[];
+export declare function classifyEdges(snapshots: RepoSnapshot[]): LinkEdge[];
+//# sourceMappingURL=links.d.ts.map

package/dist/audit/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/audit/links.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAalE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAe5D;AAmED,wBAAgB,aAAa,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,QAAQ,EAAE,CA4DnE"}

package/dist/audit/links.js

@@ -0,0 +1,156 @@
+// src/audit/links.ts
+// Link extraction + classification. Regex-only (no markdown parser dep — v1
+// scope per plan resolution #1). Edges are classified by URL pattern match
+// (with prefix-boundary check, resolution #6) or relative-path escape into
+// another configured repo.
+import { relative as nodeRelative, resolve as nodeResolve, posix } from "node:path";
+const MD_LINK_RE = /\[([^\]]*)\]\(([^)\s]+)\)/g;
+function splitAnchor(rawHref) {
+    const hashIdx = rawHref.indexOf("#");
+    if (hashIdx === -1)
+        return { href: rawHref, anchor: null };
+    return {
+        href: rawHref.slice(0, hashIdx),
+        anchor: rawHref.slice(hashIdx + 1) || null,
+    };
+}
+export function extractLinksFromBody(body) {
+    const out = [];
+    for (const m of body.matchAll(MD_LINK_RE)) {
+        const rawHref = m[2].trim();
+        if (!rawHref)
+            continue;
+        const { href, anchor } = splitAnchor(rawHref);
+        const isUrl = /^https?:\/\//i.test(rawHref);
+        const isRelative = !isUrl &&
+            !rawHref.startsWith("#") &&
+            !rawHref.startsWith("/") &&
+            !/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(rawHref); // any scheme like mailto:
+        out.push({ rawHref, href, anchor, isUrl, isRelative });
+    }
+    return out;
+}
+// A URL pattern matches a URL iff the URL's host+path starts with the pattern
+// AND the next char in the URL is /, #, ?, or end-of-string. This rejects
+// substring matches like `github.com/org/service-a-tools` against pattern
+// `github.com/org/service-a`.
+function urlMatchesPattern(url, pattern) {
+    const stripped = url.replace(/^https?:\/\//i, "");
+    if (!stripped.startsWith(pattern))
+        return false;
+    const next = stripped.charAt(pattern.length);
+    return next === "" || next === "/" || next === "#" || next === "?";
+}
+// Pulls the path-after-pattern out of a known-matching URL: strips scheme,
+// pattern, and the GitHub blob/tree/... prefix when present. Returns relPath
+// + optional anchor.
+function extractTargetPathFromUrl(url, pattern) {
+    const stripped = url.replace(/^https?:\/\//i, "");
+    const rest = stripped.slice(pattern.length); // starts with "/" or ""
+    if (rest === "")
+        return null; // pattern alone, no file
+    // strip leading "/"
+    let tail = rest.startsWith("/") ? rest.slice(1) : rest;
+    // Split anchor / query
+    const queryIdx = tail.indexOf("?");
+    if (queryIdx !== -1)
+        tail = tail.slice(0, queryIdx);
+    const hashIdx = tail.indexOf("#");
+    const anchor = hashIdx !== -1 ? tail.slice(hashIdx + 1) || null : null;
+    if (hashIdx !== -1)
+        tail = tail.slice(0, hashIdx);
+    if (!tail)
+        return null;
+    // GitHub URLs: /blob/<branch>/<path> or /tree/<branch>/<path>.
+    // Strip if present; otherwise treat `tail` as the relPath directly.
+    const ghMatch = tail.match(/^(blob|tree|raw)\/[^/]+\/(.+)$/);
+    const relPath = ghMatch ? ghMatch[2] : tail;
+    return { relPath: posix.normalize(relPath), anchor };
+}
+// Note: repo.config.path values are always real (symlink-resolved) paths —
+// config.ts#validateRepoPath calls realpathSync() before storing them. The
+// containment check below (`rel.startsWith("..")`) is therefore symlink-safe
+// for the source side. The resolved href target itself is not realpathSync'd
+// because it may not exist on disk (that's what broken_refs.ts catches).
+// Reference-style links `[text][ref]` are intentionally NOT extracted in v1
+// (audit operates on arbitrary markdown repos without needing full AST parsing;
+// mention here per plan resolution #1).
+function resolveRelative(fromRepoPath, fromRelPath, href, repos) {
+    const fromAbs = nodeResolve(fromRepoPath, fromRelPath);
+    const fromDir = nodeResolve(fromAbs, "..");
+    const resolvedAbs = nodeResolve(fromDir, href);
+    for (const repo of repos) {
+        const rel = nodeRelative(repo.config.path, resolvedAbs);
+        if (!rel.startsWith("..") && !nodeResolve(repo.config.path, rel).startsWith("..")) {
+            // posix-normalize for cross-platform sanity
+            const posixRel = rel.split(/[\\/]/).join("/");
+            return { repo: repo.config.name, relPath: posixRel };
+        }
+    }
+    return null;
+}
+export function classifyEdges(snapshots) {
+    const edges = [];
+    for (const snap of snapshots) {
+        const sourceRepo = snap.config.name;
+        for (const doc of snap.docs.values()) {
+            for (const link of doc.links) {
+                if (link.isUrl) {
+                    // Try each repo's url patterns. First match wins.
+                    let matched = false;
+                    for (const targetSnap of snapshots) {
+                        for (const pattern of targetSnap.config.urls) {
+                            if (!urlMatchesPattern(link.href, pattern))
+                                continue;
+                            const target = extractTargetPathFromUrl(link.href, pattern);
+                            if (!target)
+                                continue;
+                            edges.push({
+                                sourceRepo,
+                                sourcePath: doc.relPath,
+                                targetRepo: targetSnap.config.name,
+                                targetPath: target.relPath,
+                                targetAnchor: target.anchor ?? link.anchor,
+                                rawHref: link.rawHref,
+                            });
+                            matched = true;
+                            break;
+                        }
+                        if (matched)
+                            break;
+                    }
+                    // Unmatched URLs are external (no configured repo owns them); drop.
+                    // Per plan resolution #3: anonymous repos get no urls[], and URLs
+                    // targeting unconfigured repos go silently unflagged in v1.
+                    continue;
+                }
+                if (!link.isRelative)
+                    continue; // anchors-only, mailto:, etc.
+                const resolved = resolveRelative(snap.config.path, doc.relPath, link.href, snapshots);
+                if (!resolved) {
+                    // Escaped to an unconfigured location; record as edge into sourceRepo
+                    // with an unresolvable path so broken_refs flags it.
+                    edges.push({
+                        sourceRepo,
+                        sourcePath: doc.relPath,
+                        targetRepo: sourceRepo,
+                        targetPath: link.href, // unresolved sentinel
+                        targetAnchor: link.anchor,
+                        rawHref: link.rawHref,
+                    });
+                    continue;
+                }
+                edges.push({
+                    sourceRepo,
+                    sourcePath: doc.relPath,
+                    targetRepo: resolved.repo,
+                    targetPath: resolved.relPath,
+                    targetAnchor: link.anchor,
+                    rawHref: link.rawHref,
+                });
+            }
+        }
+    }
+    return edges;
+}
+//# sourceMappingURL=links.js.map

package/dist/audit/links.js.map

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

package/dist/audit/report.d.ts

@@ -0,0 +1,4 @@
+import type { AuditReport } from "./types.js";
+export declare function renderMarkdown(report: AuditReport): string;
+export declare function renderJson(report: AuditReport): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/audit/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/audit/report.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAsC,MAAM,YAAY,CAAC;AAyBlF,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CA8B1D;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEtD"}

package/dist/audit/report.js

@@ -0,0 +1,58 @@
+// src/audit/report.ts
+// Pure formatters over AuditReport. No IO.
+function renderBrokenRefs(rows) {
+    if (rows.length === 0)
+        return "_no broken cross-repo references._\n";
+    const lines = ["| kind | source | target | href |", "|---|---|---|---|"];
+    for (const r of rows) {
+        const targetAnchor = r.target.anchor ? `#${r.target.anchor}` : "";
+        lines.push(`| ${r.kind} | ${r.source.repo}/${r.source.path} | ` +
+            `${r.target.repo}/${r.target.path}${targetAnchor} | \`${r.rawHref}\` |`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+function renderStaleness(rows) {
+    if (rows.length === 0)
+        return "_no staleness findings._\n";
+    const lines = ["| kind | doc | mtime | chain |", "|---|---|---|---|"];
+    for (const r of rows) {
+        const chain = r.staleChain ? r.staleChain.map((n) => `${n.repo}/${n.path}`).join(" → ") : "—";
+        lines.push(`| ${r.kind} | ${r.repo}/${r.path} | ${r.mtime} | ${chain} |`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+export function renderMarkdown(report) {
+    const t = report.totals;
+    const empty = t.brokenRefs === 0 && t.directlyStale === 0 && t.transitivelyStale === 0;
+    const head = [
+        "# Coherence Audit Report",
+        "",
+        `_generated: ${report.generatedAt}_`,
+        "",
+        "## Totals",
+        "",
+        `- repos scanned: **${t.reposScanned}**`,
+        `- docs scanned: **${t.docsScanned}**`,
+        `- broken cross-repo refs: **${t.brokenRefs}**`,
+        `- directly stale docs: **${t.directlyStale}**`,
+        `- transitively stale docs: **${t.transitivelyStale}**`,
+        "",
+    ];
+    if (empty) {
+        head.push("_no findings — coherence checks passed._\n");
+        return head.join("\n");
+    }
+    return [
+        ...head,
+        "## Broken cross-repo references",
+        "",
+        renderBrokenRefs(report.brokenRefs),
+        "## Staleness",
+        "",
+        renderStaleness(report.staleness),
+    ].join("\n");
+}
+export function renderJson(report) {
+    return JSON.stringify(report, null, 2);
+}
+//# sourceMappingURL=report.js.map

package/dist/audit/report.js.map

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