@sledorze/cairn 0.1.0 → 0.3.0

package/dist/program/summaries/CheckSummaries.js

@@ -0,0 +1,302 @@
+// Effect programs for the hierarchical summary system.
+//  - `checkSummaries`   -> the plan (what is missing/stale, bottom-up order).
+//  - `stampSummaries`   -> (re)writes the freshness stamp of EXISTING summaries,
+//     bottom-up, into their `.cairn/**` sidecar (never into the summary's own
+//     content — see StampStore.ts).
+//  - `migrateStamps`    -> one-off: strips the legacy in-content stamp from
+//     every summary, then runs the sidecar stamp pass over the stripped tree.
+// Pure planning lives in ../../core/summaries/SummaryTree.ts; freshness
+// primitives in ../../core/summaries/DocSummaries.ts; sidecar path mapping +
+// (de)serialisation in ../../core/summaries/StampStore.ts.
+import { Effect } from 'effect';
+import { DEFAULT_STAMP_COMMAND } from '../../core/Config.js';
+import { countLines, isSummaryFile, stripSourceHash } from '../../core/summaries/DocSummaries.js';
+import { parseStamp, serializeStamp, STAMP_VERSION } from '../../core/summaries/StampStore.js';
+import { isDirSummary, nodeExpectedHash, planSummaries } from '../../core/summaries/SummaryTree.js';
+import { metaRootFor, nodePathForSidecar, sidecarPathFor } from '../../core/sidecar.js';
+import { DocsFs } from '../../io/DocsFs.js';
+import { enOnly, pick } from '../locale.js';
+export { DEFAULT_STAMP_COMMAND } from '../../core/Config.js';
+const EMPTY_STAMPS = new Map();
+const layoutFor = (base) => ({ base, metaRoot: metaRootFor(base) });
+/** Assemble the pure planner's arguments from the program args + file map.
+ * `stamps` defaults to empty — callers that don't need freshness status (the
+ * stamp-writing pass itself) can omit it entirely and skip loading it. */
+const toPlanArgs = (files, args, stamps = EMPTY_STAMPS) => ({
+    files,
+    ...(args.ignore === undefined ? {} : { ignore: args.ignore }),
+    ...(args.naming === undefined ? {} : { naming: args.naming }),
+    ...(args.requireDirSummaries === undefined ? {} : { requireDirSummaries: args.requireDirSummaries }),
+    roots: args.roots,
+    stamps,
+    ...(args.thresholdLines === undefined ? {} : { thresholdLines: args.thresholdLines }),
+});
+const readMarkdown = (roots) => Effect.gen(function* () {
+    const dfs = yield* DocsFs;
+    const all = yield* dfs.listFiles(roots);
+    const files = new Map();
+    for (const file of all) {
+        if (file.endsWith('.md')) {
+            files.set(file, yield* dfs.readFile(file));
+        }
+    }
+    return files;
+});
+/**
+ * Load every stamp recorded under `.cairn/**` into a `node path -> sha256` map.
+ * A sidecar that can't be mapped back to a node path, or whose content is
+ * corrupt/merge-conflicted/hand-edited (`parseStamp` returns `null`), is simply
+ * skipped — its node then reads as `stale`/`missing`, never a crash (see
+ * StampStore.ts's own contract). Absent `.cairn/` (first run) yields an empty
+ * map via `dfs.listFiles`, also without error.
+ */
+const readStamps = (layout) => Effect.gen(function* () {
+    const dfs = yield* DocsFs;
+    const sidecarPaths = yield* dfs.listFiles([layout.metaRoot]);
+    const stamps = new Map();
+    for (const sidecarPath of sidecarPaths) {
+        const nodeAtPath = nodePathForSidecar(sidecarPath, layout);
+        if (nodeAtPath === null) {
+            continue;
+        }
+        const record = parseStamp(yield* dfs.readFile(sidecarPath));
+        if (record !== null) {
+            stamps.set(nodeAtPath, record.sha256);
+        }
+    }
+    return stamps;
+});
+/** 0 when nothing is missing/stale, no orphan summaries, and no deleted-source
+ * stamps remain, 1 otherwise. */
+export const summaryExitCode = (plan) => plan.todo.length > 0 || plan.orphans.length > 0 || plan.orphanStamps.length > 0 ? 1 : 0;
+/** Report lines: methodology + the bottom-up update order, for a one-pass fix. */
+export const formatSummaryReport = (plan, options = {}) => {
+    const locale = options.locale ?? 'en';
+    const stampCommand = options.stampCommand ?? DEFAULT_STAMP_COMMAND;
+    const totalOrphans = plan.orphans.length + plan.orphanStamps.length;
+    if (plan.todo.length === 0 && totalOrphans === 0) {
+        return [
+            pick(locale, {
+                en: `✅ Hierarchical summaries OK (${plan.nodes.length} summary/ies checked).`,
+                fr: `✅ Résumés hiérarchiques OK (${plan.nodes.length} résumé(s) vérifié(s)).`,
+            }),
+        ];
+    }
+    const orphanLines = plan.orphans.map((p) => pick(locale, {
+        en: `  ✗ orphan summary (source gone): ${p}`,
+        fr: `  ✗ résumé orphelin (source disparue) : ${p}`,
+    }));
+    // A `.cairn/**` sidecar with no corresponding node — its source (and possibly
+    // its summary file too) was deleted; the sidecar, never touched by hand, is
+    // what caught it (see StampStore.ts / SummaryTree.ts's `findDeletedStamps`).
+    const orphanStampLines = plan.orphanStamps.map((p) => pick(locale, {
+        en: `  ✗ deleted-source stamp (sidecar left behind): ${p}`,
+        fr: `  ✗ tampon d'une source supprimée (fichier annexe orphelin) : ${p}`,
+    }));
+    if (plan.todo.length === 0) {
+        return [
+            pick(locale, {
+                en: `❌ ${totalOrphans} orphan summary/ies or stamp(s) (source doc deleted, renamed, or below threshold):`,
+                fr: `❌ ${totalOrphans} résumé(s) ou tampon(s) orphelin(s) (source supprimée, renommée, ou sous le seuil) :`,
+            }),
+            ...orphanLines,
+            ...orphanStampLines,
+        ];
+    }
+    const lines = pick(locale, {
+        en: [
+            `❌ ${plan.todo.length} summary/ies to (re)generate.`,
+            '',
+            'Methodology (a single, bottom-up pass):',
+            '  1. File summaries: one per doc over the line threshold, a fast-to-read version of the source.',
+            '  2. Directory summaries (_SUMMARY.md): aggregate the summaries of direct docs (or the doc itself when short) + the _SUMMARY.md of direct sub-directories.',
+            `  3. Process in THIS order (files, then deepest directories), then run \`${stampCommand}\` to stamp the hashes.`,
+            '',
+            'Update order:',
+        ],
+        fr: [
+            `❌ ${plan.todo.length} résumé(s) à (re)générer.`,
+            '',
+            'Méthodologie (une seule passe, de bas en haut) :',
+            '  1. Résumés de fichier : 1 par doc au-dessus du seuil de lignes, version rapide à lire de la source.',
+            "  2. Résumés de répertoire (_SUMMARY.md) : agrègent les résumés des docs directs (ou le doc s'il est court) + les _SUMMARY.md des sous-répertoires directs.",
+            `  3. Traiter dans CET ordre (fichiers puis répertoires les plus profonds), puis lancer \`${stampCommand}\` pour tamponner les hash.`,
+            '',
+            'Ordre de mise à jour :',
+        ],
+    });
+    for (const node of plan.todo) {
+        const tag = node.kind === 'dir'
+            ? pick(locale, { en: 'directory', fr: 'répertoire' })
+            : pick(locale, { en: 'file', fr: 'fichier' });
+        let reason = node.status === 'missing'
+            ? pick(locale, { en: 'missing', fr: 'manquant' })
+            : pick(locale, { en: 'stale (source changed)', fr: 'périmé (source modifiée)' });
+        if (node.missingLinks.length > 0) {
+            reason = pick(locale, {
+                en: `missing child links (${node.missingLinks.length})`,
+                fr: `liens enfants manquants (${node.missingLinks.length})`,
+            });
+        }
+        lines.push(`  - [${tag}] ${node.path} : ${reason}`);
+    }
+    if (totalOrphans > 0) {
+        lines.push('', pick(locale, {
+            en: `${totalOrphans} orphan summary/ies or stamp(s) (source doc deleted, renamed, or below threshold):`,
+            fr: `${totalOrphans} résumé(s) ou tampon(s) orphelin(s) (source supprimée, renommée, ou sous le seuil) :`,
+        }), ...orphanLines, ...orphanStampLines);
+    }
+    return lines;
+};
+const shortHash = (h) => (h === null ? 'none' : `${h.slice(0, 8)}…`);
+/** Markdown headings in `content`, in order, for a quick outline of what changed. */
+const headings = (content) => content
+    .split('\n')
+    .filter((line) => /^#{1,6}\s/.test(line))
+    .map((line) => line.trim());
+/**
+ * Explain why each `todo` node is not ok. cairn stores only a content hash, not
+ * prior source text, so this cannot diff against the previously-summarized
+ * version — it surfaces what IS derivable: the expected/recorded hash pair, the
+ * changed source's current outline (file summaries), or which stale/missing
+ * child is driving a directory summary stale (dir summaries).
+ */
+const explainPlan = (plan, files, options) => {
+    const locale = options.locale ?? 'en';
+    if (plan.todo.length === 0) {
+        return [pick(locale, enOnly('Nothing to explain — all summaries are fresh.'))];
+    }
+    const byPath = new Map(plan.nodes.map((n) => [n.path, n]));
+    const lines = [];
+    for (const node of plan.todo) {
+        lines.push(`${node.kind} ${node.path} (${node.status}):`, `  expected ${shortHash(node.expectedHash)}  recorded ${shortHash(node.recordedHash)}`);
+        if (node.kind === 'file') {
+            const source = node.inputs[0];
+            const content = source === undefined ? '' : (files.get(source) ?? '');
+            lines.push(`  source: ${source} (${countLines(content)} lines)`, ...headings(content).map((h) => `    ${h}`));
+        }
+        else {
+            const staleInputs = node.inputs.filter((input) => byPath.get(input)?.status !== 'ok');
+            if (staleInputs.length > 0) {
+                lines.push(`  driven by stale/missing child: ${staleInputs.join(', ')}`);
+            }
+            if (node.missingLinks.length > 0) {
+                lines.push(`  missing links to: ${node.missingLinks.join(', ')}`);
+            }
+        }
+        lines.push('');
+    }
+    return lines;
+};
+export const checkSummaries = (args) => Effect.gen(function* () {
+    const files = yield* readMarkdown(args.roots);
+    const stamps = yield* readStamps(layoutFor(args.base));
+    return planSummaries(toPlanArgs(files, args, stamps));
+});
+/** `--explain`: why each todo node is not ok (see `explainPlan` for what this can and cannot show). */
+export const explainSummaries = (args, options = {}) => Effect.gen(function* () {
+    const files = yield* readMarkdown(args.roots);
+    const stamps = yield* readStamps(layoutFor(args.base));
+    const plan = planSummaries(toPlanArgs(files, args, stamps));
+    return explainPlan(plan, files, options);
+});
+/**
+ * Stamp every EXISTING summary with its current source/manifest hash, bottom-up,
+ * into its `.cairn/**` sidecar — never into the summary's own content. Summaries
+ * whose content has not been authored yet are returned as `missing`.
+ *
+ * ALWAYS strips a legacy in-content `<!-- source-sha256 -->` stamp first, if one
+ * is still there, before computing any hash — not just when explicitly asked to
+ * migrate. This is the actual fix for the discoverability gap a one-off
+ * `--migrate-stamps` command alone would leave: an upgrading repo's EXISTING
+ * `stampCommand` (already `cairn check --summaries-only --stamp` in every
+ * `.cairnrc.json` this tool ever scaffolded) is what a user or CI already runs
+ * — making that command self-heal means there is no new command to discover,
+ * search for, or forget to run. `--migrate-stamps` (`migrateStamps`, below)
+ * still exists as an explicit, nameable entry point for anyone who wants to run
+ * the cleanup as its own reported step, but it is no longer load-bearing.
+ *
+ * Doesn't need to load `stamps` first: this loop writes every node's hash
+ * unconditionally (not just the stale ones), so `planSummaries`' ordering is all
+ * it needs from the planner — freshness status plays no role in stamping itself.
+ */
+const stampFiles = (files, args) => Effect.gen(function* () {
+    const dfs = yield* DocsFs;
+    const layout = layoutFor(args.base);
+    // Only ever strips a SUMMARY file's own legacy stamp — never a plain source
+    // doc. A source doc's prose can legitimately contain the literal
+    // `<!-- source-sha256: <64hex> -->` text (e.g. a doc that documents cairn's
+    // OWN former stamp format, with a real-looking example) — that text is the
+    // user's content, not tool metadata, and `stampFiles` must never touch it.
+    // Restricting to `isSummaryFile`/`isDirSummary` is what keeps "the tool
+    // never writes into content" true for every file it doesn't own.
+    let migrated = 0;
+    for (const [p, content] of files) {
+        if (!isSummaryFile(p, args.naming) && !isDirSummary(p, args.naming)) {
+            continue;
+        }
+        const stripped = stripSourceHash(content);
+        if (stripped !== content) {
+            files.set(p, stripped);
+            yield* dfs.writeFile(p, stripped);
+            migrated += 1;
+        }
+    }
+    const order = planSummaries(toPlanArgs(files, args)).nodes;
+    const missing = [];
+    let stamped = 0;
+    for (const node of order) {
+        if (!files.has(node.path)) {
+            missing.push(node);
+            continue;
+        }
+        // A node's `inputs` are structurally stable (only summary CONTENT changes
+        // during stamping, never which paths feed a node) — so its hash can be
+        // recomputed directly from `inputs` + their current content. Content no
+        // longer carries a stamp (that's the whole point of the sidecar), so —
+        // unlike the old in-content scheme — a child's just-written sidecar never
+        // changes ITS OWN content, and therefore never perturbs a parent's
+        // manifest hash; bottom-up order is preserved for a single-pass write, but
+        // no longer required for correctness of the hash itself.
+        const expectedHash = nodeExpectedHash({ files, inputs: node.inputs, kind: node.kind, path: node.path });
+        const sidecarContent = serializeStamp({ sha256: expectedHash, version: STAMP_VERSION });
+        yield* dfs.writeFile(sidecarPathFor(node.path, layout), sidecarContent);
+        stamped += 1;
+    }
+    return { migrated, missing, stamped };
+});
+export const stampSummaries = (args) => Effect.gen(function* () {
+    const files = yield* readMarkdown(args.roots);
+    return yield* stampFiles(files, args);
+});
+/**
+ * Explicit, nameable one-shot entry point (`--migrate-stamps`) for the SAME
+ * self-healing `stampFiles` already does unconditionally on every `--stamp` —
+ * kept for anyone who wants to run/report the cleanup as its own step, not
+ * because plain `--stamp` needs it to be correct.
+ */
+export const migrateStamps = (args) => Effect.gen(function* () {
+    const files = yield* readMarkdown(args.roots);
+    return yield* stampFiles(files, args);
+});
+/** Delete every orphan summary file (source doc gone) AND every orphan
+ * `.cairn/**` sidecar (deleted-source stamp — see `SummaryPlan.orphanStamps`),
+ * reporting the total count removed. */
+export const pruneOrphans = (args) => Effect.gen(function* () {
+    const dfs = yield* DocsFs;
+    const layout = layoutFor(args.base);
+    const files = yield* readMarkdown(args.roots);
+    const stamps = yield* readStamps(layout);
+    const plan = planSummaries(toPlanArgs(files, args, stamps));
+    for (const orphan of plan.orphans) {
+        yield* dfs.deleteFile(orphan);
+    }
+    for (const orphanStamp of plan.orphanStamps) {
+        yield* dfs.deleteFile(sidecarPathFor(orphanStamp, layout));
+    }
+    return plan.orphans.length + plan.orphanStamps.length;
+});
+// Re-exported so callers can recognise summary files without importing two modules.
+export { isSummaryFile } from '../../core/summaries/DocSummaries.js';
+export { isDirSummary } from '../../core/summaries/SummaryTree.js';
+//# sourceMappingURL=CheckSummaries.js.map

package/dist/program/summaries/CheckSummaries.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sledorze/cairn",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Hierarchical documentation summary consolidation with content-hash freshness (clone/CI-proof) and dead-link checking. Agent-agnostic CLI; scaffolds guidance for Claude Code and GitHub Copilot.",
   "keywords": [
     "documentation",
@@ -38,20 +38,19 @@
     "schema"
   ],
   "dependencies": {
-    "@effect/cli": "^0.76.0",
-    "@effect/platform": "^0.97.0",
-    "@effect/platform-node": "^0.108.0",
-    "effect": "^3.22.0"
+    "@effect/platform-node": "4.0.0-beta.100",
+    "effect": "4.0.0-beta.100",
+    "github-slugger": "^2.0.0"
   },
   "devDependencies": {
     "@changesets/cli": "^2.27.0",
-    "@types/node": "^25.3.3",
+    "@types/node": "^26.1.1",
     "esbuild": "^0.28.1",
     "lefthook": "^2.1.0",
-    "oxlint": "1.73.0",
+    "oxlint": "1.74.0",
     "prettier": "^3.8.1",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
+    "typescript": "^7.0.2",
     "vitest": "^4.0.18"
   },
   "publishConfig": {

package/schema/cairn.schema.json

@@ -1,23 +1,39 @@
 {
-  "$schema": "http://json-schema.org/draft-07/schema#",
   "$defs": {
+    "CairnChecksConfig": {
+      "type": "object",
+      "properties": {
+        "links": { "type": "boolean", "description": "Enable Markdown dead-link checking. Default true." },
+        "summaries": {
+          "type": "boolean",
+          "description": "Enable summary freshness checking (content-hash based). Default true."
+        }
+      },
+      "additionalProperties": false,
+      "description": "Which checks `cairn check` runs."
+    },
+    "CairnNamingConfig": {
+      "type": "object",
+      "properties": {
+        "dirSummary": { "type": "string", "description": "Directory summary filename. Default \"_SUMMARY.md\"." },
+        "fileSummarySuffix": { "type": "string", "description": "Suffix for file summaries. Default \".summary.md\"." }
+      },
+      "additionalProperties": false,
+      "description": "Configurable filenames for the summary system."
+    },
     "CairnConfig": {
       "type": "object",
-      "required": [],
       "properties": {
         "$schema": {
           "type": "string",
           "description": "JSON Schema URL for editor autocomplete/validation. Ignored by cairn."
         },
         "checks": { "$ref": "#/$defs/CairnChecksConfig" },
-        "extends": {
-          "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }],
-          "description": "One or more config files (paths, relative to this file) to inherit from. Local fields win over inherited ones."
-        },
+        "extends": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] },
         "ignore": {
           "type": "array",
-          "items": { "type": "string" },
-          "description": "Globs to exclude from scanning. Default [\"**/node_modules/**\"]."
+          "description": "Globs to exclude from scanning. Default [\"**/node_modules/**\"].",
+          "items": { "type": "string" }
         },
         "locale": {
           "type": "string",
@@ -31,8 +47,8 @@
         },
         "roots": {
           "type": "array",
-          "items": { "type": "string" },
-          "description": "Documentation roots to scan (globs allowed). Default [\"docs\"]."
+          "description": "Documentation roots to scan (globs allowed). Default [\"docs\"].",
+          "items": { "type": "string" }
         },
         "stampCommand": {
           "type": "string",
@@ -40,38 +56,19 @@
         },
         "thresholdLines": {
           "type": "integer",
-          "description": "Line count above which a file needs a summary. Non-negative integer. Default 30.",
-          "title": "nonNegative",
-          "minimum": 0
+          "allOf": [
+            {
+              "minimum": 0,
+              "description": "Line count above which a file needs a summary. Non-negative integer. Default 30."
+            }
+          ]
         }
       },
       "additionalProperties": false,
-      "description": "Configuration for the cairn CLI (.cairnrc.json, .cairnrc, or the \"cairn\" key of package.json).",
-      "title": "cairn configuration"
-    },
-    "CairnChecksConfig": {
-      "type": "object",
-      "required": [],
-      "properties": {
-        "links": { "type": "boolean", "description": "Enable Markdown dead-link checking. Default true." },
-        "summaries": {
-          "type": "boolean",
-          "description": "Enable summary freshness checking (content-hash based). Default true."
-        }
-      },
-      "additionalProperties": false,
-      "description": "Which checks `cairn check` runs."
-    },
-    "CairnNamingConfig": {
-      "type": "object",
-      "required": [],
-      "properties": {
-        "dirSummary": { "type": "string", "description": "Directory summary filename. Default \"_SUMMARY.md\"." },
-        "fileSummarySuffix": { "type": "string", "description": "Suffix for file summaries. Default \".summary.md\"." }
-      },
-      "additionalProperties": false,
-      "description": "Configurable filenames for the summary system."
+      "title": "cairn configuration",
+      "description": "Configuration for the cairn CLI (.cairnrc.json, .cairnrc, or the \"cairn\" key of package.json)."
     }
   },
+  "$schema": "http://json-schema.org/draft-07/schema#",
   "$ref": "#/$defs/CairnConfig"
 }

package/dist/core/DocSummaries.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DocSummaries.d.ts","sourceRoot":"","sources":["../../src/core/DocSummaries.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAA;AAEtD,qDAAqD;AACrD,MAAM,WAAW,MAAM;IACrB,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,sFAAsF;IACtF,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CACnC;AAED,4DAA4D;AAC5D,eAAO,MAAM,cAAc,EAAE,MAG5B,CAAA;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;CAChC;AAED,sEAAsE;AACtE,eAAO,MAAM,uBAAuB,KAAK,CAAA;AAIzC,uDAAuD;AACvD,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,KAAG,MAM5C,CAAA;AAED,uDAAuD;AACvD,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,SAAQ,MAAuB,KAAG,OACrC,CAAA;AAEzC,wEAAwE;AACxE,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,SAAQ,MAAuB,KAAG,MAC9B,CAAA;AAEjD,iFAAiF;AACjF,eAAO,MAAM,YAAY,GAAI,8CAK1B,gBAAgB,KAAG,OAQrB,CAAA;AAMD,qEAAqE;AACrE,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,MAA2C,CAAA;AAEzF,uFAAuF;AACvF,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAA2C,CAAA;AAExF,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,GAAI,gBAAgB,MAAM,KAAG,MAAM,GAAG,IAAiD,CAAA;AAErH,qFAAqF;AACrF,eAAO,MAAM,cAAc,GAAI,gBAAgB,MAAM,EAAE,MAAM,MAAM,KAAG,MAMrE,CAAA;AAED,4EAA4E;AAC5E,eAAO,MAAM,eAAe,GAAI,6CAA6C,YAAY,KAAG,aAQ3F,CAAA"}

package/dist/core/DocSummaries.js.map

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

package/dist/core/MarkdownLinks.bench.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MarkdownLinks.bench.d.ts","sourceRoot":"","sources":["../../src/core/MarkdownLinks.bench.ts"],"names":[],"mappings":""}

package/dist/core/MarkdownLinks.bench.js.map

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

package/dist/core/MarkdownLinks.d.ts

@@ -1,51 +0,0 @@
-export interface MarkdownLink {
-    readonly target: string;
-    readonly text: string;
-}
-export interface MarkdownLinkDef {
-    readonly label: string;
-    readonly target: string;
-}
-export interface BrokenLink {
-    readonly suggestion?: string;
-    readonly target: string;
-    readonly text: string;
-}
-export interface SuggestFixArgs {
-    readonly fromDir: string;
-    readonly index: ReadonlyMap<string, readonly string[]>;
-    readonly target: string;
-}
-export interface CheckContentArgs {
-    readonly content: string;
-    readonly existsAbs: (absPath: string) => boolean;
-    readonly fileAbs: string;
-    readonly index?: ReadonlyMap<string, readonly string[]>;
-}
-/**
- * Blank out fenced (``` / ~~~) and inline (`code`) spans so links that only
- * appear inside code examples are NOT treated as real links. Newlines are kept
- * so line-based reasoning is unaffected; other characters become spaces.
- */
-export declare const stripCode: (content: string) => string;
-/** Extract inline Markdown links/images as `{ target, text }`. */
-export declare const extractLinks: (content: string) => MarkdownLink[];
-/** Extract reference-style link definitions (`[label]: ./path "title"`). */
-export declare const extractLinkDefinitions: (content: string) => MarkdownLinkDef[];
-/** True only for relative paths we can resolve on disk. */
-export declare const isCheckableTarget: (target: string) => boolean;
-/** Drop `#anchor` and `?query` from a target. */
-export declare const stripAnchor: (target: string) => string;
-/** Map basename -> list of absolute paths, for ambiguity-aware fixing. */
-export declare const buildBasenameIndex: (absPaths: readonly string[]) => Map<string, string[]>;
-/**
- * Suggest a repaired relative path for a broken target. Returns a path only
- * when exactly one indexed file matches the basename (no ambiguity); else null.
- */
-export declare const suggestFix: ({ fromDir, index, target }: SuggestFixArgs) => string | null;
-/**
- * Check one file's content for broken relative links. Returns the broken ones,
- * each with an optional `suggestion` when an `index` is supplied.
- */
-export declare const checkContent: ({ content, existsAbs, fileAbs, index }: CheckContentArgs) => BrokenLink[];
-//# sourceMappingURL=MarkdownLinks.d.ts.map

package/dist/core/MarkdownLinks.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MarkdownLinks.d.ts","sourceRoot":"","sources":["../../src/core/MarkdownLinks.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAA;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAA;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAA;CACxD;AAMD;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,KAAG,MAGwB,CAAA;AAIpE,kEAAkE;AAClE,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,YAAY,EAM1D,CAAA;AAED,4EAA4E;AAC5E,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,KAAG,eAAe,EAMvE,CAAA;AAED,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,KAAG,OAclD,CAAA;AAED,iDAAiD;AACjD,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,KAAG,MAAuC,CAAA;AAEpF,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,GAAI,UAAU,SAAS,MAAM,EAAE,KAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAYpF,CAAA;AAOD;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,4BAA4B,cAAc,KAAG,MAAM,GAAG,IAOhF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,wCAAwC,gBAAgB,KAAG,UAAU,EA2BjG,CAAA"}