Health check the knowledge base. Finds contradictions, orphans, stale info, missing pages, and completed actions. Use when the user wants to maintain wiki quality.
Health check the knowledge base. Find and fix issues.
/lint — run all checks/lint --dry-run — report issues without fixingWiki pages with no inbound links from other wiki pages or index files.
How to check:
.md file in wiki/concepts/, wiki/entities/, wiki/syntheses/_index.md), flag as orphanFix: Add the page to relevant related: fields in connected pages, or remove if truly irrelevant.
Pages referenced in related: frontmatter or markdown links that don't exist.
How to check:
related: paths from wiki pagesFix: Create stub pages for important missing references, or remove broken links.
Different pages making conflicting claims about the same topic.
How to check:
Report: List the conflicting pages and the specific claims.
Pages whose source material has been superseded by newer sources.
How to check:
sources: file has a newer version in raw/updated date is significantly older than related pagesReport: List stale pages with suggestions.
Checked-off items in wiki/actions/ files older than 30 days.
How to check:
- [x] itemscompleted: dateFix: Remove items completed more than 30 days ago.
Projects in raw/projects/ with no ingest activity in the past 30 days.
How to check:
raw/projects/log.jsonl for recent ingest entries with matching dest pathReport: List candidates for human decision.
Print a report:
Lint Report — YYYY-MM-DD
========================
Orphan pages: N found, N fixed
Missing pages: N found, N fixed
Contradictions: N found (requires human review)
Stale info: N found
Completed actions: N cleaned
Archival candidates: N found
Details:
[... specifics for each issue ...]
{"ts":"<now>","op":"lint","title":"Lint YYYY-MM-DD","stats":{"orphans":N,"missing":N,"contradictions":N,"stale":N,"cleaned_actions":N,"archival_candidates":N},"updated":["wiki/actions/next.md"]}
Only commit if changes were made (not for --dry-run):
git add wiki/ log.jsonl
git commit -m "[lint] fix <summary>
- updated: wiki/actions/next.md, ...
- fixed: N orphans, N missing links, N completed actions"