Function lint_wiki

skills/mini-context-graph/scripts/tools/wiki_store.py:248–294

Health-check the wiki as described in Karpathy's LLM Wiki pattern. Checks for: - Orphan pages (in directory but not in index) - Missing pages (in index but file deleted) - Broken wikilinks ([[slug]] pointing to non-existent file) - Pages with no wikilinks (isolated pages)

()

def lint_wiki() -> dict:
    """
    Health-check the wiki as described in Karpathy's LLM Wiki pattern.

    Checks for:
    - Orphan pages (in directory but not in index)
    - Missing pages (in index but file deleted)
    - Broken wikilinks ([[slug]] pointing to non-existent file)
    - Pages with no wikilinks (isolated pages)

    Returns:
        {
          "orphan_pages": [...],
          "missing_pages": [...],
          "broken_wikilinks": {slug: [broken_links]},
          "isolated_pages": [...],
        }
    """
    index_entries = {e["slug"] for e in _load_index()}
    file_slugs: dict[str, Path] = {}
    for d in _CATEGORY_DIRS.values():
        if d.exists():
            for p in d.glob("*.md"):
                file_slugs[p.stem] = p

    orphans = [s for s in file_slugs if s not in index_entries]
    missing = [s for s in index_entries if s not in file_slugs]

    broken_wikilinks: dict[str, list[str]] = {}
    isolated: list[str] = []
    all_slugs = set(file_slugs.keys())

    for slug, path in file_slugs.items():
        content = path.read_text()
        links = re.findall(r"\[\[([^\]]+)\]\]", content)
        if not links:
            isolated.append(slug)
        broken = [lnk for lnk in links if _slug(lnk) not in all_slugs]
        if broken:
            broken_wikilinks[slug] = broken

    return {
        "orphan_pages": orphans,
        "missing_pages": missing,
        "broken_wikilinks": broken_wikilinks,
        "isolated_pages": isolated,
    }