lint

name	lint
description	Health check the knowledge base. Finds contradictions, orphans, stale info, missing pages, and completed actions. Use when the user wants to maintain wiki quality.

/lint

Health check the knowledge base. Find and fix issues.

Usage

• /lint — run all checks
• /lint --dry-run — report issues without fixing

Checks

1. Orphan pages

Wiki pages with no inbound links from other wiki pages or index files.

How to check:

• For each .md file in wiki/concepts/, wiki/entities/, wiki/syntheses/
• Search all other wiki files for references to this file's path
• If no references found (other than _index.md), flag as orphan

Fix: Add the page to relevant related: fields in connected pages, or remove if truly irrelevant.

2. Missing pages

Pages referenced in related: frontmatter or markdown links that don't exist.

How to check:

• Extract all internal links and related: paths from wiki pages
• Check if each referenced file exists

Fix: Create stub pages for important missing references, or remove broken links.

3. Contradictions

Different pages making conflicting claims about the same topic.

How to check:

• For each concept, read all pages that reference it
• Look for conflicting dates, definitions, or claims
• Flag for human review (do not auto-fix)

Report: List the conflicting pages and the specific claims.

4. Stale information

Pages whose source material has been superseded by newer sources.

How to check:

• For each wiki page, check if any sources: file has a newer version in raw/
• Check if updated date is significantly older than related pages

Report: List stale pages with suggestions.

5. Completed actions

Checked-off items in wiki/actions/ files older than 30 days.

How to check:

• Parse action files for - [x] items
• Check the completed: date

Fix: Remove items completed more than 30 days ago.

6. Archival candidates

Projects in raw/projects/ with no ingest activity in the past 30 days.

How to check:

• For each directory in raw/projects/
• Search log.jsonl for recent ingest entries with matching dest path

Report: List candidates for human decision.

Output

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 ...]

Log

{"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"]}

Git commit

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"