2 min read
Knowledge Graph
The knowledge graph is a visual inspection surface for wiki connectivity, not the source of truth.
The graph visualizes pages and cross-references built from the same wiki index that powers search and navigation. It helps agents and Kevin spot isolated pages, dense hubs, and unexpected clusters. Source: UI implementation; Backlink Index Protocol
What It Shows
| Element | Meaning |
|---|---|
| Node | Wiki page |
| Edge | Wikilink, related frontmatter, typed relationship, or tag-derived connection |
| Node size | Connection count / centrality |
| Edge strength | Link frequency or relationship weight |
| Filtered nodes | Private/gated categories hidden by server-side visibility rules |
How It Is Built
npx tsx scripts/build-index.tsregenerates page metadata and backlinks.- The UI reads the page index.
- The graph builds nodes from visible pages.
- Edges come from wikilinks, frontmatter, and shared metadata.
There is no separate graph export step. If the graph looks stale, rebuild the index first.
Agent Uses
- Find orphan pages after a capture or migration.
- Spot over-broad hubs that may need splitting.
- Inspect whether new pages connected to the expected cluster.
- Verify that important meta pages point to each other.
- Explain wiki structure to Kevin when the graph itself is the topic.
Interaction
| Action | Result |
|---|---|
| Hover | title, category, connection count |
| Click | camera focuses on node |
| Right-click | open article |
| Controls | auto-rotate, reset, labels |
Maintenance
Graph quality depends on link quality. Do not "fix the graph" by adding meaningless links. Fix the underlying pages: related frontmatter, inline wikilinks, and entity backlinks. Then rebuild the derived graph surfaces through Generated Surface Contract.
Timeline
- 2026-07-01 | Added generated-surface closeout so graph fixes route through source pages and derived index rebuilds instead of visual-only edits. Source: User request, 2026-07-01
- 2026-06-18 | Expanded graph page with construction model, agent uses, and maintenance warning. Source: User request, 2026-06-18; UI implementation
- 2026-06-07 | Knowledge graph moved from standalone
/graphto wiki-native routes: article atmeta/knowledge-graph, viewer atmeta/knowledge-graph/view, dynamic build from page index. Source: User, 2026-06-07