wiki-lint

name	wiki-lint
description	Health check the knowledge graph. Finds orphan nodes, missing cross-references, stale claims, unresolved contradictions, and knowledge gaps. Triggers on: "lint the wiki", "knowledge health", "check knowledge base", "wiki lint", "find orphans".
allowed-tools	mcp__codescope__knowledge_search mcp__codescope__knowledge_lint mcp__codescope__raw_query mcp__codescope__graph_stats
user-invocable	true

wiki-lint: Knowledge Graph Health Check

Audit the knowledge graph and report issues. Fix what you can automatically, flag what needs human attention.

Checks

1. Orphan nodes

Knowledge entities with no incoming or outgoing edges:

knowledge_lint(check: "orphans")

Auto-fix: search for related entities and suggest links.

2. Unresolved contradictions

Claims flagged as contradictions that haven't been resolved:

knowledge_search(query: "contradiction")

Report: list each with both sides and ask human to resolve.

3. Low-confidence clusters

Groups of claims all at "low" confidence:

knowledge_lint(check: "low_confidence")

Suggest: "/autoresearch [topic]" to find corroborating sources.

4. Code-knowledge gaps

Code entities (functions, classes) with no knowledge context:

knowledge_lint(check: "unlinked_code")

Report: "These 5 most-called functions have no knowledge context. Consider ingesting their design docs."

5. Stale sources

Sources older than 6 months with no recent corroboration:

knowledge_lint(check: "stale")

Report: "These claims may be outdated — consider re-researching."

Output

## Knowledge Graph Health Report

**Total nodes:** 142 (67 entities, 35 concepts, 25 sources, 15 claims)
**Total edges:** 384

### Issues Found

| Check | Count | Severity |
|-------|-------|----------|
| Orphan nodes | 3 | low |
| Unresolved contradictions | 1 | high |
| Low-confidence clusters | 2 | medium |
| Code-knowledge gaps | 8 | medium |
| Stale sources | 0 | — |

### Actions Needed
1. **[high]** Resolve contradiction: "token expiry" — Source A vs Source B
2. **[medium]** Run `/autoresearch OAuth2` to corroborate 4 low-confidence claims
3. **[medium]** Ingest design docs for: handle_auth, parse_config, db_connect...
4. **[low]** 3 orphan knowledge nodes — suggest links below

**Health score: 7/10**