geronimo-iia/llm-wiki-skills/stats

Stats

Wiki health dashboard. One call returns all metrics — page counts, graph shape, staleness buckets, community clusters, structural topology, and index health.

wiki_stats()

Target a specific wiki:

wiki_stats(wiki: "research")

Include the full center slug list (default returns center_count only):

wiki_stats(detail: "full")
wiki_stats(wiki: "research", detail: "full")

Reading the output

Page counts

pages — total indexed pages. If lower than expected, the index may be stale: check index.stale. Rebuild with wiki_index_rebuild if needed.

sections — section index pages. Excluded from most metrics (orphan check, staleness, structural rules) to avoid noise.

types / status — facet distributions (keyword FAST fields — computed per segment, no stored-doc fetch). High draft count → run wiki_lint(rules: "stale") or audit drafts manually.

Orphans and connectivity

orphans — pages with zero inbound edges. Any orphan is a candidate for a new link or deletion. Run wiki_lint(rules: "orphan") for the full list with paths.

avg_connections — mean edges per node. Below ~1.5 on a wiki with many pages signals sparse linking. Run wiki_suggest on isolated pages.

graph_density — edges / (n·(n-1)). Low density is expected on large wikis. Only concerning when combined with high orphan count and low avg_connections.

Triage rule: orphans / pages > 0.2 → link audit needed.

Staleness

"staleness": { "fresh": 30, "stale_7d": 8, "stale_30d": 4 }

• fresh — updated within 7 days
• stale_7d — updated 7–30 days ago
• stale_30d — older than 30 days or no date

High stale_30d alone is not a problem — stable knowledge doesn't need frequent updates. It becomes a problem when combined with low confidence on those pages. Run wiki_lint(rules: "stale") to find pages that are both old AND low-confidence.

Index health

"index": { "stale": false, "built": "2026-05-04T10:00:00Z" }

stale: true means wiki files have changed since the last index build. Rebuild before relying on any other metric:

wiki_index_rebuild(wiki: "research")

Community clusters

communities is null when the wiki has fewer than graph.min_nodes_for_communities pages (default 30).

{
  "count": 7,
  "largest": 34,
  "smallest": 3
}

Structural topology

diameter, radius, center, structural_note — present when graph.structural_algorithms = true (default) and wiki is below graph.max_nodes_for_diameter (default 2000 nodes).

{
  "diameter": 6.0,
  "radius": 3.0,
  "center_count": 1,
  "structural_note": null
}

Use detail: "full" to retrieve hub slugs by name:

wiki_stats(detail: "full")

diameter ≈ radius (within 1–2) on a well-connected wiki. Large gap means the graph has a tight core and a long tail of peripheral pages. Run wiki_lint(rules: "periphery") to identify those tail pages.

When structural_note is set, disable-or-raise max_nodes_for_diameter in config, or accept that topology fields are unavailable at that scale.

Triage decision tree

index.stale = true          → wiki_index_rebuild first, then re-run stats
orphans / pages > 0.2       → wiki_lint(rules: "orphan")
stale_30d / pages > 0.3     → wiki_lint(rules: "stale")
count high, smallest small  → wiki_lint(rules: "periphery") + wiki_suggest on findings
diameter >> radius          → wiki_lint(rules: "periphery")
articulation points likely  → wiki_lint(rules: "articulation-point,bridge")

CI health gate pattern

Exit non-zero when the index is stale or orphan ratio is high:

llm-wiki stats --wiki research --format json \
  | jq 'if .index.stale or (.orphans / .pages > 0.2) then error else . end'