second-brain-lint

1# Lint the vault
2 
3Structural rot is silent. Nothing errors, nothing crashes, the vault just
4slowly stops answering questions well because a third of its pages are
5unreachable. Linting is the only thing that catches it before the owner does.
6 
7## Core rule
8 
9Report before repairing. Fix the mechanical problems automatically, but never
10delete or merge a page without listing it first and getting a yes, because the
11owner may have written it by hand.
12 
13## Workflow
14 
151. **Inventory.** Count pages by type. Build the link graph by parsing every
16   `[[wikilink]]`.
172. **Broken links.** Links pointing at pages that do not exist. Distinguish
18   two cases: a typo or rename, which you fix, and a genuine gap, which goes
19   into `index.md` under Gaps.
203. **Orphans.** Pages with no inbound links. For each, either find where it
21   should be linked from and add the link, or flag it as a candidate for
22   deletion.
234. **Stubs.** Pages under roughly 40 words with no links. Usually a failed
24   ingest. Flag for re-ingest from the original source in `raw/`.
255. **Schema.** Missing or malformed frontmatter, wrong `type`, missing dates,
26   tags outside the existing vocabulary.
276. **Near-duplicates.** Pages with very similar titles or aliases. Propose
28   merges; do not perform them unsolicited.
297. **Index drift.** Pages missing from `index.md`, index entries pointing
30   nowhere.
318. **Repair**, then append the run to `log.md`.
32 
33## Output format
34 
35```
36…