wiki-maintain

Wiki Maintain

Comprehensive wiki maintenance: lint, deduplicate, upgrade, and analyze.

Resolve .wiki/ from plugin install scope. If not found, say "No wiki found."

Arguments

• /wiki-maintain — run full maintenance (all steps below)
• /wiki-maintain lint — only fix broken links, missing frontmatter, orphans
• /wiki-maintain dedup — only find and merge near-duplicate pages
• /wiki-maintain gaps — only analyze knowledge gaps and missing coverage

Full Maintenance Steps

1. Lint

Launch wiki-auditor agent to:

• Find [[wiki-links]] that point to non-existent pages — list for user
• Fix missing frontmatter fields (add defaults)
• Find orphan pages (no incoming links) — suggest connections
• Remove dead index entries
• Fix stale updated: dates on pages that were modified but not date-bumped

2. Deduplicate

Find pages with >60% slug token overlap (Jaccard similarity on slug words split by -):

• Report pairs for review
• For confirmed duplicates: auto-merge into one page, update all backlinks, add redirect note to absorbed page

3. Confidence Upgrade

Pages with 3+ independent sources in frontmatter get upgraded:

• low → medium (if 2+ sources)
• medium → high (if 3+ corroborating sources)
• Run fact-checker agent on high-confidence pages to verify claims against external sources
• Write the reason in log.md

4. Stale Detection (Freshness Tiers)

Pages are evaluated against an intelligent freshness system — not a flat threshold. Each page has a TTL based on its content type:

Tier	TTL	Examples
live	15 min	stock prices, live scores, server status, deployment state
breaking	1-6 hours	breaking news, incident updates, release announcements
current	1-3 days	news articles, current events, trending topics
fast	1-4 weeks	AI/LLM/MCP, API changes, model benchmarks
moderate	1-3 months	software versions, frameworks, libraries, tools
standard	6 months	general knowledge, how-to guides (default)
academic	1 year	research papers, studies, formal publications
evergreen	5 years	history, biographies, foundational concepts, laws, theorems
permanent	never	personal notes, ideas, memories, journal entries

Resolution order:

1. Explicit freshness_tier: in page frontmatter (user override)
2. Explicit ttl: in frontmatter (custom duration like ttl: 30m or ttl: 2d)
3. Auto-classification from tags, type, and content keywords

For stale pages:

• Add stale: true to frontmatter
• Suggest running /wiki-write --refresh-stale or /wiki-read to refresh

5. Concept Auto-Generation

Detect patterns spanning 3+ pages:

• Find groups of pages that share 3+ common [[wiki-links]] targets
• For each cluster: suggest a synthesis article that connects the concepts
• If user approves: generate the synthesis page via wiki-writer agent

6. Regenerate Index

Rebuild .wiki/index.md from all pages:

• Group by type: field (concept, entity, source, idea, status, etc.)
• Alphabetical within each group
• Include confidence badge and one-line description

7. Report

Print summary: broken links fixed, duplicates found, confidence upgrades, stale flags, concepts suggested, index updated.