@sledorze/cairn 0.1.0 → 0.3.0

package/dist/core/sidecar.d.ts

@@ -0,0 +1,45 @@
+import { Schema } from 'effect';
+/** The hidden directory name every metadata tree lives under, relative to `base`. */
+export declare const META_DIR = ".cairn";
+export interface MetaLayout {
+    /** The project root every node path and every sidecar is resolved under. */
+    readonly base: string;
+    /** `join(base, META_DIR)` — passed explicitly (not recomputed) so callers who
+     * already have it (e.g. after listing `.cairn/**`) don't rederive it. */
+    readonly metaRoot: string;
+}
+export declare const metaRootFor: (base: string) => string;
+/** True for any path inside the hidden metadata tree — used to keep `.cairn/**`
+ * out of the set of markdown source files a plan considers. */
+export declare const isSidecarPath: (candidate: string, metaRoot: string) => boolean;
+/**
+ * `<base>/docs/a.summary.md` -> `<metaRoot>/docs/a.summary.md.json`, or, with
+ * a `namespace` (e.g. `'refs'`), `<metaRoot>/refs/docs/a.summary.md.json` —
+ * the mechanism that keeps two DIFFERENT sidecar kinds for the SAME doc path
+ * from colliding (a doc's own freshness stamp vs its reference hashes; see
+ * `links/RefStore.ts`'s header for the real collision this closes). Throws
+ * if `nodeAtPath` isn't under `base`: every real node path is (roots are
+ * always resolved under the project root before a plan ever runs), so this
+ * signals a caller bug, not a runtime data condition to recover from.
+ */
+export declare const sidecarPathFor: (nodeAtPath: string, layout: MetaLayout, namespace?: string) => string;
+/**
+ * The inverse of `sidecarPathFor` (namespace-free form): given a sidecar's
+ * own path (e.g. found by listing `.cairn/**`), recover the node path it
+ * mirrors. Returns `null` for a path that isn't a well-formed sidecar under
+ * `metaRoot` (not `.json`, or outside the tree) rather than throwing —
+ * unlike `sidecarPathFor`, this reads data that could plausibly be malformed
+ * (a stray non-JSON file dropped into `.cairn/` by hand), so `null` is the
+ * right "not a sidecar" signal, not a crash.
+ */
+export declare const nodePathForSidecar: (sidecarPath: string, layout: MetaLayout) => string | null;
+export interface SidecarCodec<A> {
+    /** Read a sidecar's record back, or `null` if missing/corrupt/malformed —
+     * NEVER throws (see module header). */
+    readonly parse: (content: string) => A | null;
+    /** The sidecar's on-disk JSON form. Trailing newline for a clean git diff. */
+    readonly serialize: (record: A) => string;
+}
+/** Build a lenient JSON codec for one sidecar record shape from its `Schema`. */
+export declare const makeSidecarCodec: <S extends Parameters<typeof Schema.decodeUnknownResult>[0]>(schema: S) => SidecarCodec<S['Type']>;
+//# sourceMappingURL=sidecar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../src/core/sidecar.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAA;AAKvC,qFAAqF;AACrF,eAAO,MAAM,QAAQ,WAAW,CAAA;AAEhC,MAAM,WAAW,UAAU;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;6EACyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,eAAO,MAAM,WAAW,SAAU,MAAM,KAAG,MAAmC,CAAA;AAE9E;+DAC+D;AAC/D,eAAO,MAAM,aAAa,cAAe,MAAM,YAAY,MAAM,KAAG,OACJ,CAAA;AAEhE;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,eAAgB,MAAM,UAAU,UAAU,cAAc,MAAM,KAAG,MAO3F,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,gBAAiB,MAAM,UAAU,UAAU,KAAG,MAAM,GAAG,IASrF,CAAA;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B;2CACuC;IACvC,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,CAAC,GAAG,IAAI,CAAA;IAC7C,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,CAAA;CAC1C;AAED,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,UAAU,CAAC,OAAO,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,UACjF,CAAC,KACR,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAexB,CAAA"}

package/dist/core/sidecar.js

@@ -0,0 +1,83 @@
+// The shared low-level primitive under every hidden `.cairn/**` metadata
+// sidecar: path mapping (a node's real path -> its sidecar's path, and back)
+// and a lenient JSON codec factory. Used by BOTH `summaries/StampStore.ts`
+// (doc-freshness records) and `links/RefStore.ts` (reference content-hash
+// records) — genuinely shared mechanics, kept deliberately separate from
+// either domain's own record shape (`StampRecord` vs `RefsRecord`), which
+// stay domain-owned: forcing one schema to serve two different sidecar
+// kinds would leave one half always meaningless for any given sidecar.
+//
+// Two invariants this module enforces:
+//  - every node path handed to `sidecarPathFor` must live under `base` (real
+//    usage: `base` is the project root, every root/node resolved under it) —
+//    violating this is a programming error, not a data error, so it throws;
+//  - a codec's `parse` decodes LENIENTLY: unknown keys are ignored rather
+//    than rejected (forward-compatible), and a corrupt/hand-edited/merge-
+//    conflicted sidecar reads as `null` — exactly equivalent to no record at
+//    all, never a crash.
+import * as nodePath from 'node:path';
+import { Result, Schema } from 'effect';
+// POSIX path semantics so sidecar paths are identical on every OS.
+const path = nodePath.posix;
+/** The hidden directory name every metadata tree lives under, relative to `base`. */
+export const META_DIR = '.cairn';
+export const metaRootFor = (base) => path.join(base, META_DIR);
+/** True for any path inside the hidden metadata tree — used to keep `.cairn/**`
+ * out of the set of markdown source files a plan considers. */
+export const isSidecarPath = (candidate, metaRoot) => candidate === metaRoot || candidate.startsWith(`${metaRoot}/`);
+/**
+ * `<base>/docs/a.summary.md` -> `<metaRoot>/docs/a.summary.md.json`, or, with
+ * a `namespace` (e.g. `'refs'`), `<metaRoot>/refs/docs/a.summary.md.json` —
+ * the mechanism that keeps two DIFFERENT sidecar kinds for the SAME doc path
+ * from colliding (a doc's own freshness stamp vs its reference hashes; see
+ * `links/RefStore.ts`'s header for the real collision this closes). Throws
+ * if `nodeAtPath` isn't under `base`: every real node path is (roots are
+ * always resolved under the project root before a plan ever runs), so this
+ * signals a caller bug, not a runtime data condition to recover from.
+ */
+export const sidecarPathFor = (nodeAtPath, layout, namespace) => {
+    const rel = path.relative(layout.base, nodeAtPath);
+    if (rel.startsWith('..') || path.isAbsolute(rel)) {
+        throw new Error(`sidecarPathFor: "${nodeAtPath}" is not under base "${layout.base}"`);
+    }
+    const root = namespace === undefined ? layout.metaRoot : path.join(layout.metaRoot, namespace);
+    return `${path.join(root, rel)}.json`;
+};
+/**
+ * The inverse of `sidecarPathFor` (namespace-free form): given a sidecar's
+ * own path (e.g. found by listing `.cairn/**`), recover the node path it
+ * mirrors. Returns `null` for a path that isn't a well-formed sidecar under
+ * `metaRoot` (not `.json`, or outside the tree) rather than throwing —
+ * unlike `sidecarPathFor`, this reads data that could plausibly be malformed
+ * (a stray non-JSON file dropped into `.cairn/` by hand), so `null` is the
+ * right "not a sidecar" signal, not a crash.
+ */
+export const nodePathForSidecar = (sidecarPath, layout) => {
+    if (!isSidecarPath(sidecarPath, layout.metaRoot) || !sidecarPath.endsWith('.json')) {
+        return null;
+    }
+    const rel = path.relative(layout.metaRoot, sidecarPath);
+    if (rel.startsWith('..')) {
+        return null;
+    }
+    return path.join(layout.base, rel.slice(0, -'.json'.length));
+};
+/** Build a lenient JSON codec for one sidecar record shape from its `Schema`. */
+export const makeSidecarCodec = (schema) => {
+    const decode = Schema.decodeUnknownResult(schema);
+    return {
+        parse: (content) => {
+            let json;
+            try {
+                json = JSON.parse(content);
+            }
+            catch {
+                return null;
+            }
+            const decoded = decode(json);
+            return Result.isSuccess(decoded) ? decoded.success : null;
+        },
+        serialize: (record) => `${JSON.stringify(record, null, 2)}\n`,
+    };
+};
+//# sourceMappingURL=sidecar.js.map

package/dist/core/sidecar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar.js","sourceRoot":"","sources":["../../src/core/sidecar.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,6EAA6E;AAC7E,2EAA2E;AAC3E,0EAA0E;AAC1E,yEAAyE;AACzE,0EAA0E;AAC1E,uEAAuE;AACvE,uEAAuE;AACvE,EAAE;AACF,uCAAuC;AACvC,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,0EAA0E;AAC1E,0EAA0E;AAC1E,6EAA6E;AAC7E,yBAAyB;AAEzB,OAAO,KAAK,QAAQ,MAAM,WAAW,CAAA;AAErC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEvC,mEAAmE;AACnE,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAA;AAE3B,qFAAqF;AACrF,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAA;AAUhC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AAE9E;+DAC+D;AAC/D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAiB,EAAE,QAAgB,EAAW,EAAE,CAC5E,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAA;AAEhE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAkB,EAAE,MAAkB,EAAE,SAAkB,EAAU,EAAE;IACnG,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IAClD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,oBAAoB,UAAU,wBAAwB,MAAM,CAAC,IAAI,GAAG,CAAC,CAAA;IACvF,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;IAC9F,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAA;AACvC,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,WAAmB,EAAE,MAAkB,EAAiB,EAAE;IAC3F,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACnF,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;IACvD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;AAC9D,CAAC,CAAA;AAUD,iFAAiF;AACjF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,MAAS,EACgB,EAAE;IAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAA;IACjD,OAAO;QACL,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;YACjB,IAAI,IAAa,CAAA;YACjB,IAAI,CAAC;gBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAA;YACb,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YAC5B,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;QAC3D,CAAC;QACD,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;KAC9D,CAAA;AACH,CAAC,CAAA"}

package/dist/core/{DocSummaries.d.ts → summaries/DocSummaries.d.ts}

@@ -29,14 +29,24 @@ export declare const isSummaryFile: (path: string, naming?: Naming) => boolean;
 export declare const summaryPathFor: (path: string, naming?: Naming) => string;
 /** A non-summary Markdown file longer than the threshold must have a summary. */
 export declare const needsSummary: ({ lineCount, naming, path, thresholdLines, }: NeedsSummaryArgs) => boolean;
-/** Deterministic content hash used to stamp and verify summaries. */
-export declare const hashContent: (content: string) => string;
 /** The HTML-comment stamp a summary must carry to declare which source it reflects. */
 export declare const sourceHashTag: (hash: string) => string;
 /** Read back the source hash recorded in a summary, or null if absent. */
 export declare const extractSourceHash: (summaryContent: string) => string | null;
-/** Return the summary content stamped with `hash` (replacing any existing stamp). */
+/** Return the summary content stamped with `hash` (replacing any existing stamp).
+ * Retained only for the one-off `--migrate-stamps` path (`CheckSummaries.ts`),
+ * which needs to recognise the OLD in-content form while migrating a repo off
+ * it — the ongoing stamp mechanism now lives in a `.cairn/**` sidecar
+ * (`StampStore.ts`), never in a summary's own content. */
 export declare const withSourceHash: (summaryContent: string, hash: string) => string;
+/**
+ * Remove a legacy in-content stamp (and the blank line `withSourceHash` used to
+ * insert after it), leaving pure authored prose. The one-time migration step:
+ * `--migrate-stamps` calls this on every summary that still carries the old
+ * comment, before writing the hash to its `.cairn/**` sidecar instead. A no-op
+ * (returns `summaryContent` unchanged) when no stamp is present.
+ */
+export declare const stripSourceHash: (summaryContent: string) => string;
 /** Classify a summary: missing, stale (hash absent or mismatched) or ok. */
 export declare const classifySummary: ({ recordedHash, sourceHash, summaryExists }: ClassifyArgs) => SummaryStatus;
 //# sourceMappingURL=DocSummaries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DocSummaries.d.ts","sourceRoot":"","sources":["../../../src/core/summaries/DocSummaries.ts"],"names":[],"mappings":"AAyBA,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,YAAa,MAAM,KAAG,MAM5C,CAAA;AAED,uDAAuD;AACvD,eAAO,MAAM,aAAa,SAAU,MAAM,WAAU,MAAM,KAAoB,OACrC,CAAA;AAEzC,wEAAwE;AACxE,eAAO,MAAM,cAAc,SAAU,MAAM,WAAU,MAAM,KAAoB,MAC9B,CAAA;AAEjD,iFAAiF;AACjF,eAAO,MAAM,YAAY,iDAKtB,gBAAgB,KAAG,OAQrB,CAAA;AAED,uFAAuF;AACvF,eAAO,MAAM,aAAa,SAAU,MAAM,KAAG,MAA2C,CAAA;AAExF,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,mBAAoB,MAAM,KAAG,MAAM,GAAG,IAAiD,CAAA;AAErH;;;;0DAI0D;AAC1D,eAAO,MAAM,cAAc,mBAAoB,MAAM,QAAQ,MAAM,KAAG,MAMrE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,mBAAoB,MAAM,KAAG,MAKxD,CAAA;AAED,4EAA4E;AAC5E,eAAO,MAAM,eAAe,gDAAiD,YAAY,KAAG,aAQ3F,CAAA"}

package/dist/core/{DocSummaries.js → summaries/DocSummaries.js}

@@ -6,13 +6,22 @@
 // Freshness is enforced by a content hash, NOT by filesystem mtime: git does not
 // preserve mtimes, so after a clone/checkout (e.g. in CI) every file shares the
 // same timestamp and a time-based check silently passes on stale summaries.
-// Each summary embeds `<!-- source-sha256: ... -->`; the checker recomputes the
-// source hash and flags any mismatch. Deterministic and clone-independent.
+// The recorded hash lives in a hidden `.cairn/**` sidecar (StampStore.ts), never
+// inside the summary's own content — the checker recomputes the source hash and
+// flags any mismatch against whatever the sidecar last recorded. Deterministic
+// and clone-independent. `extractSourceHash`/`withSourceHash`/`HASH_RE` below
+// recognise the OLD in-content `<!-- source-sha256: ... -->` form; they're kept
+// only for `stripSourceHash` and the one-off `--migrate-stamps` path that moves
+// an existing repo off it.
 //
 // Naming (directory-summary filename, file-summary suffix) is configurable; the
 // defaults below reproduce the original behaviour. Unit-tested in
-// DocSummaries.unit.test.ts; the Effect program is in ../program/CheckSummaries.ts.
-import { hash as hashHex } from 'node:crypto';
+// DocSummaries.unit.test.ts; the Effect program is in ../../program/summaries/CheckSummaries.ts.
+//
+// `hashContent` itself lives in `../hashing.ts`, not here — it's genuinely
+// shared (links/CheckRefs.ts hashes REFERENCED targets with the exact same
+// function), not summary-specific; found via an import-graph audit that
+// this file was the one summaries/ module a links/ program also depended on.
 /** Defaults matching the original hard-coded convention. */
 export const DEFAULT_NAMING = {
     dirSummary: '_SUMMARY.md',
@@ -43,17 +52,15 @@ export const needsSummary = ({ lineCount, naming = DEFAULT_NAMING, path, thresho
     }
     return lineCount > thresholdLines;
 };
-// One-shot `crypto.hash` (Node >=20.12) skips the streaming Hash object's
-// internal state entirely — faster than `createHash().update().digest()` for
-// the KB-sized markdown content this hashes, at the scale this runs at (once
-// per file/manifest per plan).
-/** Deterministic content hash used to stamp and verify summaries. */
-export const hashContent = (content) => hashHex('sha256', content, 'hex');
 /** The HTML-comment stamp a summary must carry to declare which source it reflects. */
 export const sourceHashTag = (hash) => `<!-- source-sha256: ${hash} -->`;
 /** Read back the source hash recorded in a summary, or null if absent. */
 export const extractSourceHash = (summaryContent) => HASH_RE.exec(summaryContent)?.[1] ?? null;
-/** Return the summary content stamped with `hash` (replacing any existing stamp). */
+/** Return the summary content stamped with `hash` (replacing any existing stamp).
+ * Retained only for the one-off `--migrate-stamps` path (`CheckSummaries.ts`),
+ * which needs to recognise the OLD in-content form while migrating a repo off
+ * it — the ongoing stamp mechanism now lives in a `.cairn/**` sidecar
+ * (`StampStore.ts`), never in a summary's own content. */
 export const withSourceHash = (summaryContent, hash) => {
     const tag = sourceHashTag(hash);
     if (HASH_RE.test(summaryContent)) {
@@ -61,6 +68,19 @@ export const withSourceHash = (summaryContent, hash) => {
     }
     return `${tag}\n\n${summaryContent}`;
 };
+/**
+ * Remove a legacy in-content stamp (and the blank line `withSourceHash` used to
+ * insert after it), leaving pure authored prose. The one-time migration step:
+ * `--migrate-stamps` calls this on every summary that still carries the old
+ * comment, before writing the hash to its `.cairn/**` sidecar instead. A no-op
+ * (returns `summaryContent` unchanged) when no stamp is present.
+ */
+export const stripSourceHash = (summaryContent) => {
+    if (!HASH_RE.test(summaryContent)) {
+        return summaryContent;
+    }
+    return summaryContent.replace(HASH_RE, '').replace(/^\n+/, '');
+};
 /** Classify a summary: missing, stale (hash absent or mismatched) or ok. */
 export const classifySummary = ({ recordedHash, sourceHash, summaryExists }) => {
     if (!summaryExists) {

package/dist/core/summaries/DocSummaries.js.map

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

package/dist/core/summaries/StampStore.d.ts

@@ -0,0 +1,19 @@
+export interface StampRecord {
+    readonly sha256: string;
+    readonly version: number;
+}
+/** Bumped only if the sidecar's own shape changes incompatibly (never for adding
+ * an optional field — the codec already tolerates unknown keys, forward-compatible
+ * with a future, richer sidecar). */
+export declare const STAMP_VERSION = 1;
+/** The sidecar's on-disk JSON form. Trailing newline for a clean git diff. */
+export declare const serializeStamp: (record: StampRecord) => string;
+/**
+ * Read a sidecar's `StampRecord` back, or `null` if it's missing/corrupt/
+ * malformed/hand-edited/merge-conflicted — this must NEVER throw. A stamp that
+ * can't be trusted is exactly equivalent to no stamp: the node it covers reads
+ * as stale, not as a crash (see AGENTS.md's note on treating an unparsable
+ * stamp the same as a missing one).
+ */
+export declare const parseStamp: (content: string) => StampRecord | null;
+//# sourceMappingURL=StampStore.d.ts.map

package/dist/core/summaries/StampStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StampStore.d.ts","sourceRoot":"","sources":["../../../src/core/summaries/StampStore.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED;;qCAEqC;AACrC,eAAO,MAAM,aAAa,IAAI,CAAA;AAS9B,8EAA8E;AAC9E,eAAO,MAAM,cAAc,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,MAA6B,CAAA;AAEnF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,WAAW,GAAG,IAAuB,CAAA"}

package/dist/core/summaries/StampStore.js

@@ -0,0 +1,34 @@
+// The hidden, hierarchy-mirroring metadata tree that replaces the in-content
+// `<!-- source-sha256: H -->` stamp (see AGENTS.md / issue #35). Every
+// summarizable node keeps its authored prose stamp-free; instead, a sidecar
+// JSON file under `<base>/.cairn/` mirrors the node's path 1:1 and carries the
+// freshness hash. This module is pure (no IO): the `StampRecord` shape only.
+// `../../program/summaries/CheckSummaries.ts` is the impure edge that reads/
+// writes sidecars via `DocsFs`.
+//
+// Path mapping and the lenient-decode codec mechanics live in `../sidecar.ts`
+// — genuinely shared with `../links/RefStore.ts` (both are `.cairn/**`
+// sidecars), kept out of this file so it stays about ONE thing: what a
+// summary-freshness record actually contains.
+import { Schema } from 'effect';
+import { makeSidecarCodec } from '../sidecar.js';
+/** Bumped only if the sidecar's own shape changes incompatibly (never for adding
+ * an optional field — the codec already tolerates unknown keys, forward-compatible
+ * with a future, richer sidecar). */
+export const STAMP_VERSION = 1;
+const StampRecordSchema = Schema.Struct({
+    sha256: Schema.String,
+    version: Schema.Number,
+});
+const stampCodec = makeSidecarCodec(StampRecordSchema);
+/** The sidecar's on-disk JSON form. Trailing newline for a clean git diff. */
+export const serializeStamp = stampCodec.serialize;
+/**
+ * Read a sidecar's `StampRecord` back, or `null` if it's missing/corrupt/
+ * malformed/hand-edited/merge-conflicted — this must NEVER throw. A stamp that
+ * can't be trusted is exactly equivalent to no stamp: the node it covers reads
+ * as stale, not as a crash (see AGENTS.md's note on treating an unparsable
+ * stamp the same as a missing one).
+ */
+export const parseStamp = stampCodec.parse;
+//# sourceMappingURL=StampStore.js.map

package/dist/core/summaries/StampStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StampStore.js","sourceRoot":"","sources":["../../../src/core/summaries/StampStore.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,uEAAuE;AACvE,4EAA4E;AAC5E,+EAA+E;AAC/E,6EAA6E;AAC7E,6EAA6E;AAC7E,gCAAgC;AAChC,EAAE;AACF,8EAA8E;AAC9E,uEAAuE;AACvE,uEAAuE;AACvE,8CAA8C;AAE9C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAOhD;;qCAEqC;AACrC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAA;AAE9B,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC,MAAM;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC,CAAA;AAEF,MAAM,UAAU,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,CAAA;AAEtD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,cAAc,GAAoC,UAAU,CAAC,SAAS,CAAA;AAEnF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAA4C,UAAU,CAAC,KAAK,CAAA"}

package/dist/core/summaries/SummaryTree.bench.d.ts.map

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

package/dist/core/{SummaryTree.bench.js → summaries/SummaryTree.bench.js}

@@ -1,13 +1,19 @@
 import * as nodePath from 'node:path';
 import { bench, describe } from 'vitest';
-import { hashContent, isSummaryFile, sourceHashTag, summaryPathFor } from "./DocSummaries.js";
-import { DIR_SUMMARY, isDirSummary, planSummaries } from "./SummaryTree.js";
+import { hashContent } from '../hashing.js';
+import { isSummaryFile, summaryPathFor } from './DocSummaries.js';
+import { DIR_SUMMARY, isDirSummary, planSummaries } from './SummaryTree.js';
 const path = nodePath.posix;
 const bigContent = (seed) => Array.from({ length: 40 }, (_, i) => `${seed} body line ${i} with some representative prose content`).join('\n');
 const smallContent = (seed) => `${seed} short note`;
-/** A fully stamped, link-complete tree: `planSummaries` on it reports every node `ok`. */
-const buildFreshTree = ({ depth, dirsPerLevel, filesPerDir, root }) => {
+/** A fully link-complete tree (no stamps embedded — freshness lives in a
+ * separate `stamps` map now, see `StampStore.ts` / `SummaryTree.ts`'s
+ * `PlanArgs.stamps`), plus the stamps map a real `.cairn/**` sidecar store
+ * would hold for it. `planSummaries({files, stamps, ...})` on the pair reports
+ * every node `ok` — this is `buildFreshTree`'s "steady state" fixture. */
+const buildFreshTree = ({ depth, dirsPerLevel, filesPerDir, root, }) => {
     const files = new Map();
+    const stamps = new Map();
     const visit = (dir, level) => {
         const docTargets = [];
         const inputs = [];
@@ -19,7 +25,9 @@ const buildFreshTree = ({ depth, dirsPerLevel, filesPerDir, root }) => {
             docTargets.push(docPath);
             if (big) {
                 const sp = summaryPathFor(docPath);
-                files.set(sp, `${sourceHashTag(hashContent(content))}\n\n# summary\n\nSee [source](./${path.basename(docPath)}).`);
+                const summaryContent = `# summary\n\nSee [source](./${path.basename(docPath)}).`;
+                files.set(sp, summaryContent);
+                stamps.set(sp, hashContent(content));
                 inputs.push(sp);
             }
             else {
@@ -40,31 +48,33 @@ const buildFreshTree = ({ depth, dirsPerLevel, filesPerDir, root }) => {
             .toSorted()
             .join('\n');
         const links = [...docTargets, ...dirTargets].map((t) => `- [link](${path.relative(dir, t)})`).join('\n');
-        files.set(`${dir}/${DIR_SUMMARY}`, `${sourceHashTag(hashContent(manifest))}\n\n${links}`);
+        files.set(`${dir}/${DIR_SUMMARY}`, links);
+        stamps.set(`${dir}/${DIR_SUMMARY}`, hashContent(manifest));
     };
     visit(root, 0);
-    return files;
+    return { files, stamps };
 };
-/** Same source docs, no summaries anywhere yet — the "first run" worst case. */
+/** Same source docs, no summaries anywhere yet — the "first run" worst case
+ * (no stamps either, matching an empty/not-yet-populated `.cairn/**`). */
 const sourceOnly = (files) => new Map([...files].filter(([p]) => !isSummaryFile(p) && !isDirSummary(p)));
 const SMALL = { depth: 1, dirsPerLevel: 9, filesPerDir: 10, root: '/repo/docs' };
 const LARGE = { depth: 4, dirsPerLevel: 3, filesPerDir: 16, root: '/repo/docs' };
 const smallFresh = buildFreshTree(SMALL);
-const smallRaw = sourceOnly(smallFresh);
+const smallRaw = sourceOnly(smallFresh.files);
 const largeFresh = buildFreshTree(LARGE);
-const largeRaw = sourceOnly(largeFresh);
+const largeRaw = sourceOnly(largeFresh.files);
 describe('planSummaries()', () => {
-    bench('~100 files, flat/shallow, first run (no summaries)', () => {
+    bench('~100 files, flat/shallow, first run (no summaries, no stamps)', () => {
         planSummaries({ files: smallRaw, roots: [SMALL.root] });
     });
     bench('~100 files, flat/shallow, steady state (fully stamped)', () => {
-        planSummaries({ files: smallFresh, roots: [SMALL.root] });
+        planSummaries({ files: smallFresh.files, roots: [SMALL.root], stamps: smallFresh.stamps });
     });
-    bench('~2000 files, deep/nested, first run (no summaries)', () => {
+    bench('~2000 files, deep/nested, first run (no summaries, no stamps)', () => {
         planSummaries({ files: largeRaw, roots: [LARGE.root] });
     });
     bench('~2000 files, deep/nested, steady state (fully stamped)', () => {
-        planSummaries({ files: largeFresh, roots: [LARGE.root] });
+        planSummaries({ files: largeFresh.files, roots: [LARGE.root], stamps: largeFresh.stamps });
     });
 });
 //# sourceMappingURL=SummaryTree.bench.js.map

package/dist/core/summaries/SummaryTree.bench.js.map

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

package/dist/core/{SummaryTree.d.ts → summaries/SummaryTree.d.ts}

@@ -16,11 +16,20 @@ export interface PlanArgs {
     readonly naming?: Naming;
     readonly requireDirSummaries?: boolean;
     readonly roots: readonly string[];
+    /** Node path -> recorded hash, loaded from `.cairn/**` sidecars. Optional and
+     * defaults to empty — an absent/not-yet-populated stamp store degrades every
+     * node to `stale`/`missing`, the correct first-run behaviour, never a crash. */
+    readonly stamps?: ReadonlyMap<string, string>;
     readonly thresholdLines?: number;
 }
 export interface SummaryPlan {
     readonly nodes: readonly PlanNode[];
     readonly orphans: readonly string[];
+    /** A `.cairn/**` sidecar whose node no longer exists — its source doc (and
+     * possibly its summary file too) was deleted, renamed, or dropped below the
+     * size threshold. See `findDeletedStamps` for why this is distinct from
+     * `orphans`. */
+    readonly orphanStamps: readonly string[];
     readonly todo: readonly PlanNode[];
 }
 /** True when `p` is a directory summary under the configured naming. */
@@ -41,5 +50,5 @@ export interface NodeHashArgs {
  */
 export declare const nodeExpectedHash: ({ files, inputs, kind, path: nodeAtPath }: NodeHashArgs) => string;
 /** Compute the full hierarchical summary plan from the current file contents. */
-export declare const planSummaries: ({ files, ignore, naming, requireDirSummaries, roots, thresholdLines, }: PlanArgs) => SummaryPlan;
+export declare const planSummaries: ({ files, ignore, naming, requireDirSummaries, roots, stamps, thresholdLines, }: PlanArgs) => SummaryPlan;
 //# sourceMappingURL=SummaryTree.d.ts.map

package/dist/core/summaries/SummaryTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SummaryTree.d.ts","sourceRoot":"","sources":["../../../src/core/summaries/SummaryTree.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAO9D,6CAA6C;AAC7C,eAAO,MAAM,WAAW,QAA4B,CAAA;AAEpD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAC/B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC;;oFAEgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC;;;oBAGgB;IAChB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,QAAQ,CAAC,IAAI,EAAE,SAAS,QAAQ,EAAE,CAAA;CACnC;AAMD,wEAAwE;AACxE,eAAO,MAAM,YAAY,MAAO,MAAM,WAAU,MAAM,KAAoB,OACV,CAAA;AA2BhE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,8CAA+C,YAAY,KAAG,MAU1F,CAAA;AAED,iFAAiF;AACjF,eAAO,MAAM,aAAa,mFAQvB,QAAQ,KAAG,WA2Hb,CAAA"}

package/dist/core/{SummaryTree.js → summaries/SummaryTree.js}

@@ -6,10 +6,15 @@
 //    direct docs (or their summary when the doc is big) AND the `_SUMMARY.md`
 //    of its direct sub-directories.
 //
-// Freshness is content-hash based (clone/CI-proof, unlike mtime). Each summary
-// embeds `<!-- source-sha256: H -->`:
+// Freshness is content-hash based (clone/CI-proof, unlike mtime). Each summary's
+// hash H is recorded in a hidden sidecar under `.cairn/` (see StampStore.ts),
+// never inside the summary's own content:
 //  - file summary  -> H = hash(source doc content)
 //  - dir summary   -> H = hash(manifest of its inputs' relative-path:content-hash)
+// `planSummaries` never reads or writes a sidecar itself — it's handed the
+// already-loaded `stamps` map (node path -> recorded hash) as a plain value, so
+// this whole module stays pure and storage-agnostic; `program/CheckSummaries.ts`
+// is the impure edge that loads `stamps` from `.cairn/**` via `DocsFs`.
 //
 // `planSummaries` returns every expected summary with its status and, crucially,
 // the bottom-up order in which to (re)generate them so a single pass converges:
@@ -19,14 +24,16 @@
 // Filenames (`naming`), the line threshold, ignored globs and whether directory
 // summaries are required are all configurable; defaults reproduce the original.
 import * as nodePath from 'node:path';
-import { countLines, DEFAULT_NAMING, extractSourceHash, hashContent, isSummaryFile, summaryPathFor, } from "./DocSummaries.js";
-import { matchesAny } from "./glob.js";
-import { extractLinks, isCheckableTarget, stripAnchor, stripCode } from "./MarkdownLinks.js";
+import { extractLinks, isCheckableTarget, stripAnchor, stripCode } from '../links/MarkdownLinks.js';
+import { matchesAny } from '../glob.js';
+import { hashContent } from '../hashing.js';
+import { countLines, DEFAULT_NAMING, isSummaryFile, summaryPathFor } from './DocSummaries.js';
 // POSIX path semantics so the plan is identical on every OS (inputs normalised
 // to `/` at the IO boundary).
 const path = nodePath.posix;
 /** Default per-directory digest filename. */
 export const DIR_SUMMARY = DEFAULT_NAMING.dirSummary;
+const EMPTY_STAMPS = new Map();
 const DEFAULT_THRESHOLD_LINES = 30;
 /** True when `p` is a directory summary under the configured naming. */
 export const isDirSummary = (p, naming = DEFAULT_NAMING) => p === naming.dirSummary || p.endsWith(`/${naming.dirSummary}`);
@@ -73,9 +80,9 @@ export const nodeExpectedHash = ({ files, inputs, kind, path: nodeAtPath }) => {
     return hashContent(manifest);
 };
 /** Compute the full hierarchical summary plan from the current file contents. */
-export const planSummaries = ({ files, ignore = [], naming = DEFAULT_NAMING, requireDirSummaries = true, roots, thresholdLines = DEFAULT_THRESHOLD_LINES, }) => {
+export const planSummaries = ({ files, ignore = [], naming = DEFAULT_NAMING, requireDirSummaries = true, roots, stamps = EMPTY_STAMPS, thresholdLines = DEFAULT_THRESHOLD_LINES, }) => {
     const allPaths = [...files.keys()];
-    const recorded = (p) => (files.has(p) ? extractSourceHash(files.get(p) ?? '') : null);
+    const recorded = (p) => stamps.get(p) ?? null;
     const sourceDocs = allPaths.filter((p) => p.endsWith('.md') && !isSummaryFile(p, naming) && !isDirSummary(p, naming) && !matchesAny(p, ignore));
     // Computed once per doc up front (a Set lookup below) rather than via a
     // countLines() call at each of the two sites that ask "is this doc big" — the
@@ -103,7 +110,12 @@ export const planSummaries = ({ files, ignore = [], naming = DEFAULT_NAMING, req
     }
     if (!requireDirSummaries) {
         const orphans = findOrphans({ files, ignore, naming, nodes: fileNodes, requireDirSummaries });
-        return { nodes: fileNodes, orphans, todo: fileNodes.filter((n) => n.status !== 'ok') };
+        const orphanStamps = findDeletedStamps({
+            expectedNodePaths: new Set(fileNodes.map((n) => n.path)),
+            ignore,
+            stampNodePaths: stamps.keys(),
+        });
+        return { nodes: fileNodes, orphanStamps, orphans, todo: fileNodes.filter((n) => n.status !== 'ok') };
     }
     // --- directories in scope ---
     const inScope = (d) => roots.some((r) => d === r || d.startsWith(`${r}/`));
@@ -177,8 +189,22 @@ export const planSummaries = ({ files, ignore = [], naming = DEFAULT_NAMING, req
     dirNodes.sort((a, b) => depth(b.path) - depth(a.path) || a.path.localeCompare(b.path));
     const nodes = [...fileNodes, ...dirNodes];
     const orphans = findOrphans({ files, ignore, naming, nodes, requireDirSummaries });
-    return { nodes, orphans, todo: nodes.filter((n) => n.status !== 'ok') };
+    const orphanStamps = findDeletedStamps({
+        expectedNodePaths: new Set(nodes.map((n) => n.path)),
+        ignore,
+        stampNodePaths: stamps.keys(),
+    });
+    return { nodes, orphanStamps, orphans, todo: nodes.filter((n) => n.status !== 'ok') };
 };
+/**
+ * A `.cairn/**` sidecar (see StampStore.ts) whose node no longer corresponds to
+ * any expected node. Unlike `findOrphans` (which only sees a leftover summary
+ * FILE still on disk), a sidecar is written exclusively by the tool and never
+ * touched by hand — so it remains as evidence even when the summary file
+ * itself was deleted alongside its source, catching a deletion `findOrphans`
+ * alone would miss entirely.
+ */
+const findDeletedStamps = ({ expectedNodePaths, ignore, stampNodePaths }) => [...stampNodePaths].filter((p) => !expectedNodePaths.has(p) && !matchesAny(p, ignore)).toSorted();
 /**
  * A `.summary.md`/`_SUMMARY.md` on disk that no longer corresponds to any
  * expected node — its source doc was deleted, renamed, or (for file summaries)

package/dist/core/summaries/SummaryTree.js.map

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

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-export * from './core/DocSummaries.ts';
+export * from './core/summaries/DocSummaries.ts';
 export * from './core/glob.ts';
-export * from './core/MarkdownLinks.ts';
-export * from './core/SummaryTree.ts';
+export * from './core/links/MarkdownLinks.ts';
+export * from './core/summaries/SummaryTree.ts';
 export * from './io/DocsFs.ts';
-export * from './program/CheckLinks.ts';
-export * from './program/CheckSummaries.ts';
+export * from './program/links/CheckLinks.ts';
+export * from './program/summaries/CheckSummaries.ts';
 export * from './program/locale.ts';
 export * from './config.ts';
 export type { AgentTarget, InitArgs, InitResult } from './init/generate.ts';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA;AAC3B,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,kCAAkC,CAAA;AAChD,cAAc,gBAAgB,CAAA;AAC9B,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,gBAAgB,CAAA;AAC9B,cAAc,+BAA+B,CAAA;AAC7C,cAAc,uCAAuC,CAAA;AACrD,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA;AAC3B,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -1,13 +1,13 @@
 // Public API surface. The CLI (`cairn`) is the primary entrypoint, but the pure
 // planners and Effect programs are exported for programmatic use and testing.
-export * from "./core/DocSummaries.js";
-export * from "./core/glob.js";
-export * from "./core/MarkdownLinks.js";
-export * from "./core/SummaryTree.js";
-export * from "./io/DocsFs.js";
-export * from "./program/CheckLinks.js";
-export * from "./program/CheckSummaries.js";
-export * from "./program/locale.js";
-export * from "./config.js";
-export { runInit } from "./init/generate.js";
+export * from './core/summaries/DocSummaries.js';
+export * from './core/glob.js';
+export * from './core/links/MarkdownLinks.js';
+export * from './core/summaries/SummaryTree.js';
+export * from './io/DocsFs.js';
+export * from './program/links/CheckLinks.js';
+export * from './program/summaries/CheckSummaries.js';
+export * from './program/locale.js';
+export * from './config.js';
+export { runInit } from './init/generate.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,8EAA8E;AAE9E,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA;AAE3B,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,8EAA8E;AAE9E,cAAc,kCAAkC,CAAA;AAChD,cAAc,gBAAgB,CAAA;AAC9B,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,gBAAgB,CAAA;AAC9B,cAAc,+BAA+B,CAAA;AAC7C,cAAc,uCAAuC,CAAA;AACrD,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA;AAE3B,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA"}