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. The viewer is at /graph, a 3D cloud you can orbit. The Atlas map on other pages draws the same positions from straight above. Source: UI implementation; Backlink Index Protocol; ui/src/app/graph/page.tsx
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 site's prebuild bundles the pages and their links (
ui/scripts/bundle-wiki.mjs). ui/scripts/build-graph-layout.mjsgives every public page a fixed 3D position, from public pages and public links only. Edges come from wikilinks, related frontmatter, and shared tags between linked pages./graphdraws those positions with WebGL2. The Atlas map draws them from above.
Positions stay put between builds: the committed ui/src/generated/atlas-positions.json pins every page, and only new pages are placed. If the graph looks stale, rebuild the index and the site. Source: ui/scripts/build-graph-layout.mjs; ui/src/components/atlas/SKILL.md
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 | the page's links light up |
| Click or tap | selects the page; a card shows its title and an Open link |
| Drag, wheel, pinch | orbit and zoom |
| Search | marks matching pages; Up and Down fly to each, Enter opens one |
| Keys | arrows orbit, + and - zoom, 0 resets, / or Cmd+K searches, Escape clears |
?focus=<slug> |
opens with that page selected |
Source: ui/src/components/graph/graph-island.tsx; ui/src/components/graph/graph-renderer.ts
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-11-11 | The viewer moved to
/graph: a static page with a WebGL2 cloud drawn from build-time positions, which the Atlas map shares./wiki/meta/knowledge-graph/viewredirects there. Updated How It Is Built and Interaction to match. Source: branch lane/ui-graph-20261104; ui/src/components/atlas/SKILL.md - 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