Skip to content
Kevin Liu's WikiSearch

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

  1. npx tsx scripts/build-index.ts regenerates page metadata and backlinks.
  2. The site's prebuild bundles the pages and their links (ui/scripts/bundle-wiki.mjs).
  3. ui/scripts/build-graph-layout.mjs gives 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.
  4. /graph draws 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