name: wiki-lint description: Performs a health check on the EBP wiki by auditing for orphan pages, stale content, broken wikilinks, missing cross-references, contradictions, and taxonomy gaps, then reports findings and applies safe fixes. Use when the user says "lint the wiki", "wiki health check", "audit the wiki", or asks to check wiki consistency.

Wiki Lint

Run a systematic health check over wiki/ following the pattern in llm-wiki.md and the conventions in .cursor/rules/wiki-maintainer.mdc.

The goal is to keep the wiki internally consistent, current, and well-linked as it grows.

Workflow

Work through each check in order. Collect findings first; apply fixes second; report last.

1. Inventory the wiki

• List all pages under wiki/ (exclude wiki/raw/).
• Read wiki/index.md and compare: every page should be listed, every listed page should exist.

2. Check for orphan pages

An orphan page has no inbound [[wikilinks]] from any other wiki page (and isn't a required top-level file like index.md, log.md, overview.md).

• Grep for [[page-name]] across wiki/ for each page.
• Record pages with zero inbound links.
• Fix: add inbound links from the natural parent page (entity, concept, or index), or merge the orphan into a canonical page if it duplicates existing content.

3. Check for broken wikilinks

• Grep for all [[...]] patterns in wiki pages.
• For each target, confirm a matching file exists (accounting for [[page|alias]] and [[folder/page]] forms).
• Record broken links.
• Fix: correct the target, rename the link, or create the missing page as a seed stub with status: seed.

4. Check for stale pages

• Read frontmatter last_updated on every page.
• Flag pages where last_updated is significantly older than the most recent ingest that mentions related topics in wiki/log.md.
• Fix: re-read recent relevant sources and refresh claims, or mark status: needs-review and note in the lint report.

5. Check for missing high-value pages

Scan page bodies for terms that appear repeatedly (especially capitalized entities, scheme names, component names) but lack their own page.

• Fix: create seed pages for concepts referenced 3+ times across the wiki without a dedicated page.

6. Check for contradictions

Compare overlapping claims across related pages (e.g. same parameter set described in source-* and entity pages; same workflow described in component-* and analysis-*).

• Record contradictions.
• Fix: reconcile on both pages, cite the authoritative source, and note the contradiction resolution in wiki/log.md.

7. Check frontmatter hygiene

• Every non-log page should have the required fields (title, type, status, last_updated, source_count, tags).
• Flag missing or malformed frontmatter.
• Fix: add missing fields with conservative defaults (status: needs-review when unsure).

8. Check taxonomy alignment

Per .cursor/rules/wiki-maintainer.mdc, the wiki should organize around:

• Cryptographic schemes, identity model, revocation, components, security/design tradeoffs, testing/release workflows.

Flag pages that don't fit the taxonomy or belong in a different category in index.md.

9. Report and log

Write a concise lint report summarizing:

• Counts per category (orphans, broken links, stale, missing, contradictions, frontmatter issues).
• What was fixed automatically.
• What needs human input.

Append to wiki/log.md at the top:

## [YYYY-MM-DD] lint | wiki-health-check

- Orphans: <n> (fixed: <n>)
- Broken wikilinks: <n> (fixed: <n>)
- Stale pages: <n>
- Missing pages created as seeds: <n>
- Contradictions: <n> (resolved: <n>)
- Frontmatter issues: <n> (fixed: <n>)
- Notes: <anything needing human follow-up>

Guardrails

• Never delete substantive content without a replacement. When in doubt, mark status: needs-review and report.
• Do not silently rewrite claims during lint — lint reconciles and flags; ingest is where new claims enter.
• Preserve log append-only semantics. The log grows; entries are not edited in place.
• Fix only low-risk issues automatically (broken link targets, missing frontmatter fields, orphan link additions). Surface ambiguous or substantive changes to the user for approval before applying.

Useful shell checks

Quick commands for spotting common issues (via the Grep tool, not raw grep):

• Find all wikilinks: pattern \[\[([^\]]+)\]\]
• Find pages without frontmatter: pattern ^--- on first line; flag files that don't match.
• Find log entry prefixes: pattern ^## \[\d{4}-\d{2}-\d{2}\] in wiki/log.md.

Verification checklist

• All nine checks run.
• Findings collected before any fixes applied.
• Low-risk fixes applied; ambiguous items surfaced to user.
• Lint entry appended at top of wiki/log.md with ## [YYYY-MM-DD] lint | wiki-health-check prefix.
• wiki/index.md updated if any pages were added, renamed, or recategorized.