@sledorze/cairn 0.1.0 → 0.3.0

package/dist/init/content.d.ts

@@ -1,3 +1,3 @@
-export declare const CONVENTION_BODY = "# Documentation summary convention\n\nThis repo enforces a **hierarchical, content-hashed documentation summary** tree.\nCI runs `cairn check` and **fails the merge** if any summary is missing,\nstale, or a link is broken. Treat green `check` as a hard requirement, not a nicety.\n\n## The invariant\n\n1. **File summaries** \u2014 every Markdown file longer than the threshold (default 30\n   lines) has a sibling `X.summary.md`: a fast-to-read digest of the CURRENT content\n   of `X.md`.\n2. **Directory summaries** \u2014 every in-scope directory has a `_SUMMARY.md` that\n   aggregates its direct docs (each doc's `.summary.md` if the doc is big, else the\n   doc itself) plus the `_SUMMARY.md` of each direct sub-directory. It links to\n   **every** direct child file and sub-directory (link-completeness).\n3. **Freshness by content hash** \u2014 each summary's first line is\n   `<!-- source-sha256: <64-hex> -->`. The checker recomputes the source hash;\n   mismatch = stale, absent = missing. This survives git clone and CI (mtime does not).\n4. **Bottom-up in one pass** \u2014 a directory summary hashes a manifest of its children's\n   hashes (a Merkle tree), so (re)write leaves-first: file summaries, then directories\n   deepest-first, then stamp.\n\n## Workflow when you edit docs\n\nWhen you create or edit any doc:\n\n1. If the doc is longer than the threshold, create or update its `X.summary.md` to\n   reflect the new content.\n2. Update the `_SUMMARY.md` of every affected directory, walking **up** the tree\n   leaves-first, and keep a link to every child file and sub-directory.\n3. Run the stamp command to (re)write the `source-sha256` hashes bottom-up:\n   `npx cairn check --summaries-only --stamp`.\n4. Run `npx cairn check` and ensure it exits 0 (green) before you finish.\n\n## Commands\n\n- `npx cairn check` \u2014 check summaries + links (exit 1 on any problem).\n- `npx cairn check --summaries-only` / `--links-only`.\n- `npx cairn check --links-only --fix` \u2014 auto-repair unambiguous dead links.\n- `npx cairn check --summaries-only --stamp` \u2014 write stamps of EXISTING\n  summaries bottom-up. It does **not** author prose; you write the content, then stamp.\n\nYou author the prose. The tool only verifies and stamps.\n";
-export declare const SKILL_BODY = "# Writing good documentation summaries\n\nUse this when you author or refresh the summary tree that `cairn`\nenforces. It covers *how* to write summaries that are worth reading, and the exact\nmechanical order to (re)generate them so `check` goes green in one pass.\n\n## Two kinds of summary \u2014 do not conflate them\n\n**A file summary (`X.summary.md`) condenses ONE document.**\nGoal: a reader grasps what `X.md` says in ~10 seconds.\n\n- Faithful to the source \u2014 never invent, never contradict, never add claims the doc\n  doesn't make. It is a digest, not commentary.\n- Front-load the thesis and the hard numbers. Lead with the conclusion, the decision,\n  the metric \u2014 not the background.\n- Bullet-dense, no fluff. Drop hedging, transitions, and restated headings.\n- If the source changes, the summary changes. A summary that no longer matches its\n  source is a bug the checker will catch.\n\n**A directory summary (`_SUMMARY.md`) is a MAP, not a digest.**\nGoal: a reader knows what lives in this directory and where to go next.\n\n- A short orientation paragraph (1-3 sentences): what this directory is about.\n- Then one line per direct child \u2014 file **and** sub-directory \u2014 each with a Markdown\n  link and a few-word hook describing what's behind it.\n- For a big doc, link and hook its `.summary.md`; for a small doc, link the doc itself.\n- For a sub-directory, link its `_SUMMARY.md`.\n- **Link-completeness:** every direct child must appear as a link. A missing link fails\n  `check`. When you add or remove a child, update the parent's `_SUMMARY.md`.\n\n## Why leaves-first \u2014 the Merkle mental model\n\nEach summary is stamped with `<!-- source-sha256: <hex> -->` over its source. A\ndirectory summary's source is a **manifest of its children's hashes**, so a child's\nhash must be settled before its parent can be stamped. Think of it as a Merkle tree:\nchange a leaf and every hash on the path to the root must be recomputed. If you stamp\ntop-down, parents capture stale child hashes and `check` stays red.\n\n## The bottom-up procedure\n\n1. **Author leaves first.** For every doc over the threshold, write/refresh its\n   `X.summary.md`. Get the prose right before touching any directory.\n2. **Author directories deepest-first.** Walk from the deepest directories up to the\n   roots. For each, write its `_SUMMARY.md`: orientation paragraph, then a linked line\n   for every direct child (child `.summary.md` or doc, and each sub-dir's `_SUMMARY.md`).\n3. **Stamp mechanically.** Run `npx cairn check --summaries-only --stamp`.\n   It rewrites every `source-sha256` bottom-up. **Never hand-edit a sha256** \u2014 it is\n   computed, not authored; a hand-typed hash is always wrong.\n4. **Verify.** Run `npx cairn check` and confirm exit 0.\n\n## Tiny examples\n\nA **file summary** (`guides/getting-started.summary.md`):\n\n```markdown\n<!-- source-sha256: 0000...(stamped by the tool) -->\n# Getting started \u2014 summary\n\n- Install as a dev dependency, then run the init command.\n- Configure via a single rc file; every option has a sensible default.\n- First run scaffolds an example and prints the next command to run.\n```\n\nA **directory summary** (`guides/_SUMMARY.md`):\n\n```markdown\n<!-- source-sha256: 0000...(stamped by the tool) -->\n# Guides\n\nHow-to guides for everyday tasks, in reading order.\n\n- [getting-started](./getting-started.summary.md) \u2014 install, configure, first run\n- [configuration](./configuration.md) \u2014 every rc option, with its default\n- [advanced/](./advanced/_SUMMARY.md) \u2014 recipes for larger setups\n```\n\nKeep summaries short, keep links complete, stamp last, verify green.\n";
+export declare const CONVENTION_BODY = "# Documentation summary convention\n\nThis repo enforces a **hierarchical, content-hashed documentation summary** tree.\nCI runs `cairn check` and **fails the merge** if any summary is missing,\nstale, or a link is broken. Treat green `check` as a hard requirement, not a nicety.\n\n## The invariant\n\n1. **File summaries** \u2014 every Markdown file longer than the threshold (default 30\n   lines) has a sibling `X.summary.md`: a fast-to-read digest of the CURRENT content\n   of `X.md`.\n2. **Directory summaries** \u2014 every in-scope directory has a `_SUMMARY.md` that\n   aggregates its direct docs (each doc's `.summary.md` if the doc is big, else the\n   doc itself) plus the `_SUMMARY.md` of each direct sub-directory. It links to\n   **every** direct child file and sub-directory (link-completeness).\n3. **Freshness by content hash, tracked OUTSIDE your docs** \u2014 each summary's hash is\n   recorded in a hidden sidecar under `.cairn/`, one JSON file mirroring each summary's\n   path (e.g. `.cairn/docs/a.summary.md.json`). The checker recomputes the source hash\n   and compares it to the sidecar; mismatch = stale, absent = missing. This survives git\n   clone and CI (mtime does not), and it means the tracking system leaves **zero bytes**\n   in the docs you write \u2014 no stamp comment to see, ignore, or accidentally hand-edit.\n   Commit `.cairn/` alongside your docs; it's not gitignored.\n4. **Bottom-up in one pass** \u2014 a directory summary hashes a manifest of its children's\n   hashes (a Merkle tree), so (re)write leaves-first: file summaries, then directories\n   deepest-first, then stamp.\n5. **Deletions are caught too** \u2014 a sidecar left behind with no matching doc (its source\n   was deleted or renamed) is flagged as a deleted-source stamp; `--prune` removes both\n   the leftover summary and its sidecar.\n\n## Upgrading from an older cairn (legacy `<!-- source-sha256 -->` stamp)\n\n**Nothing special to do \u2014 do not go looking for a migration step.** If a summary still\ncarries the old in-content `<!-- source-sha256: ... -->` comment, the ordinary stamp\ncommand (`npx cairn check --summaries-only --stamp`) strips it and writes the\n`.cairn/` sidecar in the same run, automatically. There is no separate command to\ndiscover or remember: whatever `stampCommand` this repo already runs already does it.\n(`--migrate-stamps` also exists, purely as an optional explicit/reportable alias for\nthe same self-healing behaviour \u2014 never required.)\n\n## Workflow when you edit docs\n\nWhen you create or edit any doc:\n\n1. If the doc is longer than the threshold, create or update its `X.summary.md` to\n   reflect the new content.\n2. Update the `_SUMMARY.md` of every affected directory, walking **up** the tree\n   leaves-first, and keep a link to every child file and sub-directory.\n3. Run the stamp command to (re)write the sidecar hashes under `.cairn/` bottom-up:\n   `npx cairn check --summaries-only --stamp`.\n4. Run `npx cairn check` and ensure it exits 0 (green) before you finish.\n5. Commit your doc changes **together with** the `.cairn/` sidecar changes \u2014 a doc\n   edit without its matching sidecar update is exactly what `check` is designed to catch.\n\n## Commands\n\n- `npx cairn check` \u2014 check summaries + links (exit 1 on any problem).\n- `npx cairn check --summaries-only` / `--links-only`.\n- `npx cairn check --links-only --fix` \u2014 auto-repair unambiguous dead links.\n- `npx cairn check --summaries-only --stamp` \u2014 write the `.cairn/` sidecar hash of\n  EXISTING summaries bottom-up. It does **not** author prose; you write the content,\n  then stamp.\n- `npx cairn check --prune` \u2014 delete orphan summaries and orphan `.cairn/` sidecars\n  (source doc deleted, renamed, or below threshold).\n- `npx cairn check --migrate-stamps` \u2014 optional: the same self-healing `--stamp`\n  already does for a legacy in-content stamp, as its own named/reported step. Never\n  required.\n\nYou author the prose. The tool only verifies and stamps \u2014 and it never touches your prose to do it.\n";
+export declare const SKILL_BODY = "# Writing good documentation summaries\n\nUse this when you author or refresh the summary tree that `cairn`\nenforces. It covers *how* to write summaries that are worth reading, and the exact\nmechanical order to (re)generate them so `check` goes green in one pass.\n\n## Two kinds of summary \u2014 do not conflate them\n\n**A file summary (`X.summary.md`) condenses ONE document.**\nGoal: a reader grasps what `X.md` says in ~10 seconds.\n\n- Faithful to the source \u2014 never invent, never contradict, never add claims the doc\n  doesn't make. It is a digest, not commentary.\n- Front-load the thesis and the hard numbers. Lead with the conclusion, the decision,\n  the metric \u2014 not the background.\n- Bullet-dense, no fluff. Drop hedging, transitions, and restated headings.\n- If the source changes, the summary changes. A summary that no longer matches its\n  source is a bug the checker will catch.\n\n**A directory summary (`_SUMMARY.md`) is a MAP, not a digest.**\nGoal: a reader knows what lives in this directory and where to go next.\n\n- A short orientation paragraph (1-3 sentences): what this directory is about.\n- Then one line per direct child \u2014 file **and** sub-directory \u2014 each with a Markdown\n  link and a few-word hook describing what's behind it.\n- For a big doc, link and hook its `.summary.md`; for a small doc, link the doc itself.\n- For a sub-directory, link its `_SUMMARY.md`.\n- **Link-completeness:** every direct child must appear as a link. A missing link fails\n  `check`. When you add or remove a child, update the parent's `_SUMMARY.md`.\n\n## Why leaves-first \u2014 the Merkle mental model\n\nEach summary's hash is stamped into a hidden sidecar under `.cairn/` (never into the\nsummary's own content \u2014 that's what keeps the docs you write free of tool bytes). A\ndirectory summary's source is a **manifest of its children's hashes**, so a child's\nhash must be settled before its parent can be stamped. Think of it as a Merkle tree:\nchange a leaf and every hash on the path to the root must be recomputed. If you stamp\ntop-down, parents capture stale child hashes and `check` stays red.\n\n## The bottom-up procedure\n\n1. **Author leaves first.** For every doc over the threshold, write/refresh its\n   `X.summary.md`. Get the prose right before touching any directory.\n2. **Author directories deepest-first.** Walk from the deepest directories up to the\n   roots. For each, write its `_SUMMARY.md`: orientation paragraph, then a linked line\n   for every direct child (child `.summary.md` or doc, and each sub-dir's `_SUMMARY.md`).\n3. **Stamp mechanically.** Run `npx cairn check --summaries-only --stamp`.\n   It rewrites every `.cairn/` sidecar hash bottom-up. **Never hand-edit a sidecar** \u2014 it\n   is computed, not authored; a hand-typed hash is always wrong.\n4. **Verify.** Run `npx cairn check` and confirm exit 0.\n\n## Tiny examples\n\nA **file summary** (`guides/getting-started.summary.md`) \u2014 pure prose, no stamp inside it:\n\n```markdown\n# Getting started \u2014 summary\n\n- Install as a dev dependency, then run the init command.\n- Configure via a single rc file; every option has a sensible default.\n- First run scaffolds an example and prints the next command to run.\n```\n\nIts hash lives in `.cairn/guides/getting-started.summary.md.json` (stamped by the tool):\n\n```json\n{\"sha256\":\"0000...(stamped by the tool)\",\"version\":1}\n```\n\nA **directory summary** (`guides/_SUMMARY.md`) \u2014 also stamp-free:\n\n```markdown\n# Guides\n\nHow-to guides for everyday tasks, in reading order.\n\n- [getting-started](./getting-started.summary.md) \u2014 install, configure, first run\n- [configuration](./configuration.md) \u2014 every rc option, with its default\n- [advanced/](./advanced/_SUMMARY.md) \u2014 recipes for larger setups\n```\n\nKeep summaries short, keep links complete, stamp last, verify green.\n";
 //# sourceMappingURL=content.d.ts.map

package/dist/init/content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/init/content.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe,8tEA2C3B,CAAA;AAED,eAAO,MAAM,UAAU,gnHA6EtB,CAAA"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/init/content.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe,kgIAoE3B,CAAA;AAED,eAAO,MAAM,UAAU,i1HAkFtB,CAAA"}

package/dist/init/content.js

@@ -17,12 +17,29 @@ stale, or a link is broken. Treat green \`check\` as a hard requirement, not a n
    aggregates its direct docs (each doc's \`.summary.md\` if the doc is big, else the
    doc itself) plus the \`_SUMMARY.md\` of each direct sub-directory. It links to
    **every** direct child file and sub-directory (link-completeness).
-3. **Freshness by content hash** — each summary's first line is
-   \`<!-- source-sha256: <64-hex> -->\`. The checker recomputes the source hash;
-   mismatch = stale, absent = missing. This survives git clone and CI (mtime does not).
+3. **Freshness by content hash, tracked OUTSIDE your docs** — each summary's hash is
+   recorded in a hidden sidecar under \`.cairn/\`, one JSON file mirroring each summary's
+   path (e.g. \`.cairn/docs/a.summary.md.json\`). The checker recomputes the source hash
+   and compares it to the sidecar; mismatch = stale, absent = missing. This survives git
+   clone and CI (mtime does not), and it means the tracking system leaves **zero bytes**
+   in the docs you write — no stamp comment to see, ignore, or accidentally hand-edit.
+   Commit \`.cairn/\` alongside your docs; it's not gitignored.
 4. **Bottom-up in one pass** — a directory summary hashes a manifest of its children's
    hashes (a Merkle tree), so (re)write leaves-first: file summaries, then directories
    deepest-first, then stamp.
+5. **Deletions are caught too** — a sidecar left behind with no matching doc (its source
+   was deleted or renamed) is flagged as a deleted-source stamp; \`--prune\` removes both
+   the leftover summary and its sidecar.
+
+## Upgrading from an older cairn (legacy \`<!-- source-sha256 -->\` stamp)
+
+**Nothing special to do — do not go looking for a migration step.** If a summary still
+carries the old in-content \`<!-- source-sha256: ... -->\` comment, the ordinary stamp
+command (\`npx cairn check --summaries-only --stamp\`) strips it and writes the
+\`.cairn/\` sidecar in the same run, automatically. There is no separate command to
+discover or remember: whatever \`stampCommand\` this repo already runs already does it.
+(\`--migrate-stamps\` also exists, purely as an optional explicit/reportable alias for
+the same self-healing behaviour — never required.)
 
 ## Workflow when you edit docs
 
@@ -32,19 +49,27 @@ When you create or edit any doc:
    reflect the new content.
 2. Update the \`_SUMMARY.md\` of every affected directory, walking **up** the tree
    leaves-first, and keep a link to every child file and sub-directory.
-3. Run the stamp command to (re)write the \`source-sha256\` hashes bottom-up:
+3. Run the stamp command to (re)write the sidecar hashes under \`.cairn/\` bottom-up:
    \`npx cairn check --summaries-only --stamp\`.
 4. Run \`npx cairn check\` and ensure it exits 0 (green) before you finish.
+5. Commit your doc changes **together with** the \`.cairn/\` sidecar changes — a doc
+   edit without its matching sidecar update is exactly what \`check\` is designed to catch.
 
 ## Commands
 
 - \`npx cairn check\` — check summaries + links (exit 1 on any problem).
 - \`npx cairn check --summaries-only\` / \`--links-only\`.
 - \`npx cairn check --links-only --fix\` — auto-repair unambiguous dead links.
-- \`npx cairn check --summaries-only --stamp\` — write stamps of EXISTING
-  summaries bottom-up. It does **not** author prose; you write the content, then stamp.
-
-You author the prose. The tool only verifies and stamps.
+- \`npx cairn check --summaries-only --stamp\` — write the \`.cairn/\` sidecar hash of
+  EXISTING summaries bottom-up. It does **not** author prose; you write the content,
+  then stamp.
+- \`npx cairn check --prune\` — delete orphan summaries and orphan \`.cairn/\` sidecars
+  (source doc deleted, renamed, or below threshold).
+- \`npx cairn check --migrate-stamps\` — optional: the same self-healing \`--stamp\`
+  already does for a legacy in-content stamp, as its own named/reported step. Never
+  required.
+
+You author the prose. The tool only verifies and stamps — and it never touches your prose to do it.
 `;
 export const SKILL_BODY = `# Writing good documentation summaries
 
@@ -78,7 +103,8 @@ Goal: a reader knows what lives in this directory and where to go next.
 
 ## Why leaves-first — the Merkle mental model
 
-Each summary is stamped with \`<!-- source-sha256: <hex> -->\` over its source. A
+Each summary's hash is stamped into a hidden sidecar under \`.cairn/\` (never into the
+summary's own content — that's what keeps the docs you write free of tool bytes). A
 directory summary's source is a **manifest of its children's hashes**, so a child's
 hash must be settled before its parent can be stamped. Think of it as a Merkle tree:
 change a leaf and every hash on the path to the root must be recomputed. If you stamp
@@ -92,16 +118,15 @@ top-down, parents capture stale child hashes and \`check\` stays red.
    roots. For each, write its \`_SUMMARY.md\`: orientation paragraph, then a linked line
    for every direct child (child \`.summary.md\` or doc, and each sub-dir's \`_SUMMARY.md\`).
 3. **Stamp mechanically.** Run \`npx cairn check --summaries-only --stamp\`.
-   It rewrites every \`source-sha256\` bottom-up. **Never hand-edit a sha256** — it is
-   computed, not authored; a hand-typed hash is always wrong.
+   It rewrites every \`.cairn/\` sidecar hash bottom-up. **Never hand-edit a sidecar** — it
+   is computed, not authored; a hand-typed hash is always wrong.
 4. **Verify.** Run \`npx cairn check\` and confirm exit 0.
 
 ## Tiny examples
 
-A **file summary** (\`guides/getting-started.summary.md\`):
+A **file summary** (\`guides/getting-started.summary.md\`) — pure prose, no stamp inside it:
 
 \`\`\`markdown
-<!-- source-sha256: 0000...(stamped by the tool) -->
 # Getting started — summary
 
 - Install as a dev dependency, then run the init command.
@@ -109,10 +134,15 @@ A **file summary** (\`guides/getting-started.summary.md\`):
 - First run scaffolds an example and prints the next command to run.
 \`\`\`
 
-A **directory summary** (\`guides/_SUMMARY.md\`):
+Its hash lives in \`.cairn/guides/getting-started.summary.md.json\` (stamped by the tool):
+
+\`\`\`json
+{"sha256":"0000...(stamped by the tool)","version":1}
+\`\`\`
+
+A **directory summary** (\`guides/_SUMMARY.md\`) — also stamp-free:
 
 \`\`\`markdown
-<!-- source-sha256: 0000...(stamped by the tool) -->
 # Guides
 
 How-to guides for everyday tasks, in reading order.

package/dist/init/content.js.map

@@ -1 +1 @@
-{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/init/content.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,oEAAoE;AACpE,4EAA4E;AAC5E,iCAAiC;AAEjC,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2C9B,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6EzB,CAAA"}
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/init/content.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,oEAAoE;AACpE,4EAA4E;AAC5E,iCAAiC;AAEjC,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoE9B,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkFzB,CAAA"}

package/dist/init/generate.d.ts

@@ -1,4 +1,4 @@
-export declare const AGENT_TARGETS: readonly ["agents", "all", "claude", "copilot", "opencode"];
+export declare const AGENT_TARGETS: readonly ['agents', 'all', 'claude', 'copilot', 'opencode'];
 export type AgentTarget = (typeof AGENT_TARGETS)[number];
 export interface InitArgs {
     readonly agent: AgentTarget;

package/dist/init/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/init/generate.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,aAAa,6DAA8D,CAAA;AACxF,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AA2FD,4EAA4E;AAC5E,eAAO,MAAM,OAAO,GAAI,uBAAuB,QAAQ,KAAG,UA6BzD,CAAA"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/init/generate.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,aAAa,YAAI,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAU,CAAA;AACxF,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AA2FD,4EAA4E;AAC5E,eAAO,MAAM,OAAO,0BAA2B,QAAQ,KAAG,UA6BzD,CAAA"}

package/dist/init/generate.js

@@ -12,7 +12,7 @@
 // Plus a starter .cairnrc.json (only when absent).
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import { CONVENTION_BODY, SKILL_BODY } from "./content.js";
+import { CONVENTION_BODY, SKILL_BODY } from './content.js';
 // Single source of truth for valid `--agent` values, so the CLI's choice list
 // (src/cli.ts) can never drift from what `runInit` actually understands.
 export const AGENT_TARGETS = ['agents', 'all', 'claude', 'copilot', 'opencode'];

package/dist/io/DocsFs.d.ts

@@ -1,5 +1,4 @@
-import { FileSystem, Path } from '@effect/platform';
-import { Context, Effect, Layer } from 'effect';
+import { Context, Effect, FileSystem, Layer, Path } from 'effect';
 export interface FileStat {
     readonly mtimeMs: number;
     readonly sizeBytes: number;
@@ -12,7 +11,7 @@ export interface DocsFsService {
     readonly stat: (abs: string) => Effect.Effect<FileStat>;
     readonly writeFile: (abs: string, content: string) => Effect.Effect<void>;
 }
-declare const DocsFs_base: Context.TagClass<DocsFs, "DocsFs", DocsFsService>;
+declare const DocsFs_base: Context.ServiceClass<DocsFs, "DocsFs", DocsFsService>;
 export declare class DocsFs extends DocsFs_base {
 }
 /** Live implementation bound to the Node filesystem. */

package/dist/io/DocsFs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DocsFs.d.ts","sourceRoot":"","sources":["../../src/io/DocsFs.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAU,MAAM,QAAQ,CAAA;AAIvD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACzD,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACxD,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,CAAC,CAAA;IAClF,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACzD,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACvD,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAC1E;;AAED,qBAAa,MAAO,SAAQ,WAA8C;CAAG;AAE7E,wDAAwD;AACxD,eAAO,MAAM,UAAU,+DA2DtB,CAAA;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CA2ClF,CAAA"}
+{"version":3,"file":"DocsFs.d.ts","sourceRoot":"","sources":["../../src/io/DocsFs.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAU,IAAI,EAAE,MAAM,QAAQ,CAAA;AAIzE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACzD,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACxD,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,CAAC,CAAA;IAClF,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACzD,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACvD,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAC1E;;AAED,qBAAa,MAAO,SAAQ,WAAkD;CAAG;AAEjF,wDAAwD;AACxD,eAAO,MAAM,UAAU,+DAwEtB,CAAA;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,UAAW,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CA2ClF,CAAA"}

package/dist/io/DocsFs.js

@@ -1,10 +1,9 @@
 // Filesystem capability for the docs checkers, expressed as an Effect service
 // so programs stay testable. `DocsFsLive` binds it to the real Node platform
 // (via @effect/platform-node); `makeTestDocsFs` provides an in-memory layer.
-import { FileSystem, Path } from '@effect/platform';
-import { Context, Effect, Layer, Option } from 'effect';
-import { toPosix } from "../core/paths.js";
-export class DocsFs extends Context.Tag('DocsFs')() {
+import { Context, Effect, FileSystem, Layer, Option, Path } from 'effect';
+import { toPosix } from '../core/paths.js';
+export class DocsFs extends Context.Service()('DocsFs') {
 }
 /** Live implementation bound to the Node filesystem. */
 export const DocsFsLive = Layer.effect(DocsFs, Effect.gen(function* () {
@@ -42,13 +41,24 @@ export const DocsFsLive = Layer.effect(DocsFs, Effect.gen(function* () {
         mtimeMs: Option.match(info.mtime, { onNone: () => 0, onSome: (d) => d.getTime() }),
         sizeBytes: Number(info.size),
     })), Effect.orDie);
+    // Every existing caller wrote into a directory that was already there (a doc's
+    // own directory, always present since the doc itself lives in it). That
+    // invariant broke the moment sidecar writes started targeting a brand-new
+    // `.cairn/**` tree (StampStore.ts / CheckSummaries.ts) — the FIRST sidecar
+    // under a given directory has no directory to write into yet. `recursive:
+    // true` makes this a no-op when the directory already exists, so it's safe
+    // to do unconditionally rather than only for `.cairn/**` paths.
+    const writeFile = (abs, content) => Effect.gen(function* () {
+        yield* fs.makeDirectory(path.dirname(abs), { recursive: true });
+        yield* fs.writeFileString(abs, content);
+    }).pipe(Effect.orDie);
     return {
         deleteFile: (abs) => fs.remove(abs).pipe(Effect.orDie),
         exists: (abs) => fs.exists(abs).pipe(Effect.orDie),
         listFiles,
         readFile: (abs) => fs.readFileString(abs).pipe(Effect.orDie),
         stat,
-        writeFile: (abs, content) => fs.writeFileString(abs, content).pipe(Effect.orDie),
+        writeFile,
     };
 }));
 /**

package/dist/io/DocsFs.js.map

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

package/dist/program/JsonReport.d.ts

@@ -1,5 +1,5 @@
-import type { SummaryPlan } from '../core/SummaryTree.ts';
-import type { LinkCheckResult } from './CheckLinks.ts';
+import type { SummaryPlan } from '../core/summaries/SummaryTree.ts';
+import type { LinkCheckResult } from './links/CheckLinks.ts';
 export interface JsonReport {
     readonly exitCode: number;
     readonly links: LinkCheckResult | null;

package/dist/program/JsonReport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JsonReport.d.ts","sourceRoot":"","sources":["../../src/program/JsonReport.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAItD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAA;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAA;CACvC;AAED,sGAAsG;AACtG,eAAO,MAAM,eAAe,GAAI,sBAAsB,cAAc,KAAG,UAItE,CAAA"}
+{"version":3,"file":"JsonReport.d.ts","sourceRoot":"","sources":["../../src/program/JsonReport.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAI5D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAA;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAA;CACvC;AAED,sGAAsG;AACtG,eAAO,MAAM,eAAe,yBAA0B,cAAc,KAAG,UAItE,CAAA"}

package/dist/program/JsonReport.js

@@ -1,8 +1,8 @@
 // `--json`: a single combined, machine-readable result for `cairn check`.
 // Wraps the already-structured `SummaryPlan`/`LinkCheckResult` — no new
 // computation, just packaging + the same exit-code rules as the text report.
-import { linkExitCode } from "./CheckLinks.js";
-import { summaryExitCode } from "./CheckSummaries.js";
+import { linkExitCode } from './links/CheckLinks.js';
+import { summaryExitCode } from './summaries/CheckSummaries.js';
 /** `summaries`/`links` are `null` when that check was skipped (`--links-only`/`--summaries-only`). */
 export const buildJsonReport = ({ links, summaries }) => {
     const summaryCode = summaries === null ? 0 : summaryExitCode(summaries);

package/dist/program/JsonReport.js.map

@@ -1 +1 @@
-{"version":3,"file":"JsonReport.js","sourceRoot":"","sources":["../../src/program/JsonReport.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,wEAAwE;AACxE,6EAA6E;AAI7E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAarD,sGAAsG;AACtG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,EAAkB,EAAc,EAAE;IAClF,MAAM,WAAW,GAAG,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC,CAAA;IACvE,MAAM,QAAQ,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;IACzD,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;AACxE,CAAC,CAAA"}
+{"version":3,"file":"JsonReport.js","sourceRoot":"","sources":["../../src/program/JsonReport.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,wEAAwE;AACxE,6EAA6E;AAI7E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAa/D,sGAAsG;AACtG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,EAAkB,EAAc,EAAE;IAClF,MAAM,WAAW,GAAG,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC,CAAA;IACvE,MAAM,QAAQ,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;IACzD,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAA;AACxE,CAAC,CAAA"}

package/dist/program/{CheckLinks.d.ts → links/CheckLinks.d.ts}

@@ -1,7 +1,7 @@
 import { Effect } from 'effect';
-import type { BrokenLink } from '../core/MarkdownLinks.ts';
-import { DocsFs } from '../io/DocsFs.ts';
-import type { Locale } from './locale.ts';
+import type { BrokenLink } from '../../core/links/MarkdownLinks.ts';
+import { DocsFs } from '../../io/DocsFs.ts';
+import type { Locale } from '../locale.ts';
 export interface FileBroken {
     readonly file: string;
     readonly links: readonly BrokenLink[];
@@ -12,6 +12,11 @@ export interface LinkCheckResult {
     readonly fixed: number;
 }
 export interface CheckLinksArgs {
+    /** The repository checkout root — the hard boundary a target outside
+     * `roots` may still be verified within (issue #39's security requirement:
+     * nothing outside `base` is ever stat'd, so cairn can't be turned into a
+     * filesystem-existence oracle by an untrusted PR's link targets). */
+    readonly base: string;
     readonly fix: boolean;
     readonly ignore?: readonly string[];
     readonly roots: readonly string[];
@@ -23,5 +28,5 @@ export interface LinkReportOptions {
 export declare const linkExitCode: (result: LinkCheckResult) => number;
 /** Human-readable report lines (pure, so it can be unit-tested). */
 export declare const formatLinkReport: (result: LinkCheckResult, options?: LinkReportOptions) => string[];
-export declare const checkLinks: ({ fix, ignore, roots, }: CheckLinksArgs) => Effect.Effect<LinkCheckResult, never, DocsFs>;
+export declare const checkLinks: ({ base, fix, ignore, roots, }: CheckLinksArgs) => Effect.Effect<LinkCheckResult, never, DocsFs>;
 //# sourceMappingURL=CheckLinks.d.ts.map

package/dist/program/links/CheckLinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckLinks.d.ts","sourceRoot":"","sources":["../../../src/program/links/CheckLinks.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAS/B,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,mCAAmC,CAAA;AAKjF,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAM1C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAA;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAA;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B;;;yEAGqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AA+CD,kDAAkD;AAClD,eAAO,MAAM,YAAY,WAAY,eAAe,KAAG,MAA4C,CAAA;AAEnG,oEAAoE;AACpE,eAAO,MAAM,gBAAgB,WAAY,eAAe,YAAW,iBAAiB,KAAQ,MAAM,EA0BjG,CAAA;AAwHD,eAAO,MAAM,UAAU,kCAKpB,cAAc,KAAG,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,CAiF5D,CAAA"}

package/dist/program/links/CheckLinks.js

@@ -0,0 +1,243 @@
+// Effect program: scan Markdown files for dead relative links and, when
+// `fix` is set, auto-repair the unambiguous ones. Pure link logic lives in
+// ../../core/links/MarkdownLinks.ts; filesystem access goes through the DocsFs service.
+import * as nodePath from 'node:path';
+import { Effect } from 'effect';
+import { describeAnchors, extractAnchors, isValidLineAnchor, normalizeAnchor, parseLineAnchor, } from '../../core/links/Anchors.js';
+import { buildBasenameIndex, checkContent, stripCode, suggestFix } from '../../core/links/MarkdownLinks.js';
+import { matchesAny } from '../../core/glob.js';
+import { isWithinBase } from '../../core/paths.js';
+import { DocsFs } from '../../io/DocsFs.js';
+import { pick } from '../locale.js';
+// POSIX path semantics (inputs are normalised to `/` at the IO boundary).
+const path = nodePath.posix;
+const withAncestors = (files) => {
+    const set = new Set(files);
+    for (const file of files) {
+        let dir = path.dirname(file);
+        while (!set.has(dir)) {
+            set.add(dir);
+            const parent = path.dirname(dir);
+            if (parent === dir) {
+                break;
+            }
+            dir = parent;
+        }
+    }
+    return set;
+};
+/** Occurrences of `token` in `text`. */
+const countOccurrences = (text, token) => (token === '' ? 0 : text.split(token).length - 1);
+/**
+ * Replace a broken link/definition target with its suggestion, but ONLY when the
+ * target does not also appear inside a code span — replacing it there would
+ * corrupt a code example. Returns the new content and whether a change was made.
+ */
+const applyFix = (content, target, suggestion) => {
+    const masked = stripCode(content);
+    let next = content;
+    let changed = false;
+    for (const [from, to] of [
+        [`](${target})`, `](${suggestion})`],
+        [`]: ${target}`, `]: ${suggestion}`],
+    ]) {
+        if (countOccurrences(content, from) === 0) {
+            continue;
+        }
+        // Every occurrence must be outside code (full count === masked count).
+        if (countOccurrences(masked, from) !== countOccurrences(content, from)) {
+            continue;
+        }
+        next = next.split(from).join(to);
+        changed = true;
+    }
+    return { changed, content: next };
+};
+/** 0 when no broken links remain, 1 otherwise. */
+export const linkExitCode = (result) => (result.broken.length > 0 ? 1 : 0);
+/** Human-readable report lines (pure, so it can be unit-tested). */
+export const formatLinkReport = (result, options = {}) => {
+    const locale = options.locale ?? 'en';
+    const lines = [];
+    if (result.fixed > 0) {
+        lines.push(pick(locale, { en: `🔧 Auto-repaired ${result.fixed} link(s).`, fr: `🔧 Auto-réparé ${result.fixed} lien(s).` }));
+    }
+    if (result.broken.length === 0) {
+        lines.push(pick(locale, {
+            en: `✅ Markdown links OK (${result.checked} file(s) checked).`,
+            fr: `✅ Liens Markdown OK (${result.checked} fichier(s) vérifié(s)).`,
+        }));
+        return lines;
+    }
+    const total = result.broken.reduce((n, f) => n + f.links.length, 0);
+    lines.push(pick(locale, { en: `❌ ${total} dead link(s):`, fr: `❌ ${total} lien(s) mort(s) :` }));
+    for (const { file, links } of result.broken) {
+        lines.push(`  ${file}`);
+        for (const link of links) {
+            lines.push(`    ✗ [${link.text}](${link.target})${linkHint(locale, link)}`);
+        }
+    }
+    return lines;
+};
+/**
+ * Why a link is broken, for a human — distinct from `(no unique target)`
+ * (a *path* with no unambiguous fix) so an anchor/line failure never reads as
+ * a missing-file problem: the target resolves fine, only its `#fragment` doesn't.
+ */
+const linkHint = (locale, link) => {
+    if (link.suggestion !== undefined) {
+        return pick(locale, { en: ` → suggestion: ${link.suggestion}`, fr: ` → suggestion : ${link.suggestion}` });
+    }
+    const detail = link.detail !== undefined ? ` — ${link.detail}` : '';
+    if (link.reason === 'anchor') {
+        return pick(locale, { en: ` (heading/anchor not found${detail})`, fr: ` (ancre introuvable${detail})` });
+    }
+    if (link.reason === 'line') {
+        return pick(locale, { en: ` (line number out of range${detail})`, fr: ` (numéro de ligne hors limites${detail})` });
+    }
+    return pick(locale, { en: ' (no unique target)', fr: ' (aucune cible unique)' });
+};
+/**
+ * Resolve one deferred `PendingCheck` with real IO, bounded by `base`
+ * (issue #39's security requirement — a target outside `base` is never
+ * stat'd, existence-oracle risk closed regardless of what's actually there).
+ * `existsCache`/`contentCache`/`anchorCache` are shared across every pending
+ * check in a run so a file referenced by many links is only ever stat'd/
+ * read/slugged once. Content is fetched only when an anchor actually needs
+ * validating — a plain out-of-root existence check (no `#fragment`) never
+ * reads the target's full body just to confirm it's there.
+ */
+const resolvePendingCheck = ({ base, existsCache, contentCache, anchorCache, dfs, index, item, known, }) => Effect.gen(function* () {
+    let exists = existsCache.get(item.targetAbs);
+    if (exists === undefined) {
+        if (known.has(item.targetAbs)) {
+            exists = true;
+        }
+        else if (isWithinBase(item.targetAbs, base)) {
+            exists = yield* dfs.exists(item.targetAbs);
+        }
+        else {
+            // Outside the checkout root entirely: never touched, unconditionally
+            // "cannot verify" — the observable signal stays constant regardless
+            // of what's actually on disk there.
+            exists = false;
+        }
+        existsCache.set(item.targetAbs, exists);
+    }
+    if (!exists) {
+        const suggestion = suggestFix({ fromDir: item.fromDir, index, target: item.target });
+        return suggestion
+            ? { reason: 'path', suggestion, target: item.target, text: item.text }
+            : { reason: 'path', target: item.target, text: item.text };
+    }
+    if (item.anchor === null) {
+        return null;
+    }
+    let content = contentCache.get(item.targetAbs);
+    if (content === undefined) {
+        // `exists` only proves the path resolves to SOMETHING — a directory
+        // (from `known`'s ancestor-dir entries, or from a real out-of-root
+        // directory) also "exists" but isn't readable as text, and would
+        // otherwise die here (Effect.orDie) and take the whole run down over
+        // one malformed/unusual link. Existence already holds, so this is
+        // genuinely unverifiable, not broken and not a crash.
+        content = yield* dfs.readFile(item.targetAbs).pipe(Effect.catchDefect(() => Effect.succeed(null)));
+        contentCache.set(item.targetAbs, content);
+    }
+    if (content === null) {
+        return null;
+    }
+    const normalized = normalizeAnchor(item.anchor);
+    const lineRange = parseLineAnchor(normalized);
+    if (lineRange) {
+        const lineCount = content.split('\n').length;
+        if (isValidLineAnchor(lineRange, lineCount)) {
+            return null;
+        }
+        const detail = `target has ${lineCount} line${lineCount === 1 ? '' : 's'}`;
+        return { detail, reason: 'line', target: item.target, text: item.text };
+    }
+    if (!item.targetAbs.toLowerCase().endsWith('.md')) {
+        // A non-line, non-md fragment is a symbol anchor (`x.ts#someExport`) —
+        // explicitly out of v1 scope (issue #39, scenario G): unverifiable, so
+        // never flagged broken rather than risk a false positive.
+        return null;
+    }
+    let anchors = anchorCache.get(item.targetAbs);
+    if (!anchors) {
+        anchors = extractAnchors(content);
+        anchorCache.set(item.targetAbs, anchors);
+    }
+    return anchors.has(normalized)
+        ? null
+        : { detail: describeAnchors(anchors), reason: 'anchor', target: item.target, text: item.text };
+});
+export const checkLinks = ({ base, fix, ignore = [], roots, }) => Effect.gen(function* () {
+    const dfs = yield* DocsFs;
+    // The existence universe stays complete (so links to ignored files still
+    // resolve); `ignore` only removes files from the set we scan as sources.
+    const allFiles = yield* dfs.listFiles(roots);
+    const index = buildBasenameIndex(allFiles);
+    const known = withAncestors(allFiles);
+    const existsAbs = (p) => known.has(p);
+    const inRoots = (p) => roots.some((root) => p === root || p.startsWith(`${root}/`));
+    const mdFiles = allFiles.filter((file) => file.endsWith('.md') && !matchesAny(file, ignore));
+    const scans = [];
+    for (const file of mdFiles) {
+        const content = yield* dfs.readFile(file);
+        const { broken: syncBroken, pending } = checkContent({ content, existsAbs, fileAbs: file, inRoots, index });
+        scans.push({ content, file, pending, resolvedExtra: [], syncBroken });
+    }
+    // Resolve every deferred anchor/cross-hierarchy check once, sharing
+    // per-target caches across the whole run.
+    const existsCache = new Map();
+    const contentCache = new Map();
+    const anchorCache = new Map();
+    for (const scan of scans) {
+        for (const item of scan.pending) {
+            const result = yield* resolvePendingCheck({
+                anchorCache,
+                base,
+                contentCache,
+                dfs,
+                existsCache,
+                index,
+                item,
+                known,
+            });
+            if (result) {
+                scan.resolvedExtra.push(result);
+            }
+        }
+    }
+    const broken = [];
+    let fixed = 0;
+    for (const scan of scans) {
+        let content = scan.content;
+        const links = [...scan.syncBroken, ...scan.resolvedExtra];
+        if (links.length === 0) {
+            continue;
+        }
+        const remaining = [];
+        let changed = false;
+        for (const link of links) {
+            const repair = fix && link.suggestion !== undefined ? applyFix(content, link.target, link.suggestion) : undefined;
+            if (repair?.changed) {
+                content = repair.content;
+                changed = true;
+                fixed += 1;
+            }
+            else {
+                remaining.push(link);
+            }
+        }
+        if (changed) {
+            yield* dfs.writeFile(scan.file, content);
+        }
+        if (remaining.length > 0) {
+            broken.push({ file: scan.file, links: remaining });
+        }
+    }
+    return { broken, checked: mdFiles.length, fixed };
+});
+//# sourceMappingURL=CheckLinks.js.map

package/dist/program/links/CheckLinks.js.map

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