gamecult-site/docs/face-artifacts/vn-space-map.md
2026-05-31 15:28:59 +01:00

3.5 KiB

VN Space Map

The GameCult homepage VN is becoming the primary spatial navigation layer for the site, not a decorative prelude.

The authority split is:

  • Quartz pages remain the canonical documents.
  • The visual manifest owns the website-compound map: spaces, scenes, hosts, sprite assets, and DOM card bindings.
  • Ink owns guided conversation, pacing, and temporary visited-state.
  • Sai owns rendering: background, sprites, dialogue, choices, and DOM-card staging.
  • scripts/generate-vn-repo-doc-tree.mjs owns the generated repository documentation substrate. It scans local GameCult repos, writes the lightweight index at GameCult/static/interactive/gamecult-compound/repo-doc-tree.json, and shards per-repo document lists under repo-doc-tree/ so the homepage does not fetch the whole archive before a visitor asks for it.

Current first-ring spaces:

Space Kind Host Scene Canonical URL
Front Gate hub Void compound /
Project Atlas project atlas Void project_atlas /Projects/
Docs Shelf docs shelf Void docs_shelf /Docs/
Blog Lane blog lane Void blog_lane /Blog/
Norn Graph Loom graph/map host Norn graph_loom https://github.com/GameCult/Norn
Sai VN Stage public interface Sai vn_stage /
Eve Surface Web Atrium surface web Eve surface_web https://github.com/GameCult/Eve
EpiphanyAgent Forge repo/tool Epiphany forge /Projects/EpiphanyAgent/
Bifrost Ledger Hall repo/tool Void ledger /Projects/Bifrost/
VoidBot Archive Room repo/tool Void archive /Projects/VoidBot/
CultLib Library repo/tool Libby library /Projects/CultLib/
Heimdall Gatehouse repo/tool Heimdall gate /Projects/Heimdall/
Mimir Machine Room realtime field Mimir machine_room https://github.com/GameCult/Mimir
Ghostlight Hall social state Ghostlight ghost_hall https://github.com/GameCult/Ghostlight
Proof Walk receipt surface Void receipts /Docs/
Aetheria Setting Vault setting Nibu nibu_ship /Aetheria/
Zyphos / Eusocial Interbeing Vault setting Druzkai zyphos_vault /Projects/Eusocial-Interbeing/
Weksa Language Lab tool Weksa weksa_lab /Projects/weksa/
StreamPixels Overlay Studio tool Kiko overlay_studio /Projects/StreamPixels/
AquaSynth Voice Lab audio/tool Aqua synth_lab https://github.com/GameCult/AquaSynth
Pixel Workshop visual tool Void pixel_workshop /Projects/repixelizer
Geometry Bench visual tool Void geometry_bench /Projects/VibeGeometry
CultPong Arena game Nibu arena /Projects/CultPong
CultCacheTS Inspection Desk repo/tool Huginn inspection_desk /Projects/CultCacheTS/
Repository Swarm Docs generated docs tree Norn graph_loom /static/interactive/gamecult-compound/repo-doc-tree.json

The current Ink tour now exposes the first real swarm graph rather than only the first-ring doors. Norn is the map host, Sai explains the renderer, Eve explains shared surfaces, Epiphany/VoidBot/Mimir/Ghostlight cover the agent-memory and social-state cluster, Bifrost/Heimdall/Libby cover governance and substrate, and the world/tool routes cover Aetheria, Zyphos, Weksa, StreamPixels, AquaSynth, Repixelizer, VibeGeometry, and CultPong. The repository swarm room now hydrates a generated tree of every local GameCult documentation file, plus pitch-mode dossier and SVG assets, without making Ink or the visual manifest carry that archive by hand.