Worldshaper/docs/kb/systems.json

{
  "schemaVersion": 1,
  "generatedFromRepoDate": "2026-06-26",
  "systems": [
    {
      "id": "launcher-home",
      "name": "Launcher Home",
      "docPath": "docs/kb/systems/launcher-home.md",
      "aliases": ["launcher", "main page", "home page", "landing page"],
      "tags": ["Launcher", "Request Board", "Website", "Polish"],
      "uiSurfaces": ["Launcher hero", "News tab", "Requests tab"],
      "keyFiles": ["src/WorldshaperLauncher.tsx", "src/index.css", "src/worldshaperStudio/windowing.ts"],
      "apiEndpoints": ["/api/world-default", "/api/launcher-requests"],
      "relatedSystems": ["request-board", "floating-window-shell"],
      "priorityForRequestTriage": "high"
    },
    {
      "id": "request-board",
      "name": "Request Board",
      "docPath": "docs/kb/systems/request-board.md",
      "aliases": ["requests", "request queue", "request intake", "request board"],
      "tags": ["Request Board", "Launcher", "UI / Workflow", "Website"],
      "uiSurfaces": ["Launcher Requests tab"],
      "keyFiles": ["src/WorldshaperLauncher.tsx", "server.js", "data/launcher_requests.json"],
      "apiEndpoints": ["/api/launcher-requests", "/api/launcher-requests/:requestId"],
      "relatedSystems": ["launcher-home"],
      "priorityForRequestTriage": "high"
    },
    {
      "id": "world-bootstrap",
      "name": "Studio Bootstrap",
      "docPath": "docs/kb/systems/world-bootstrap.md",
      "aliases": ["bootstrap", "startup", "world load", "initial load"],
      "tags": ["Worlds", "Chunks", "Launcher", "Persistence"],
      "uiSurfaces": ["Studio window"],
      "keyFiles": ["src/worldshaperStudio/bootstrap.ts", "src/worldshaperStudio/main.ts", "src/worldshaperStudio/runtime.ts"],
      "apiEndpoints": ["/api/world-default", "/api/world/:worldId", "/api/world/:worldId/bookmarks", "/api/world/:worldId/chunks"],
      "relatedSystems": ["chunk-storage-streaming", "floating-window-shell", "content-catalog-records"],
      "priorityForRequestTriage": "medium"
    },
    {
      "id": "chunk-storage-streaming",
      "name": "Chunk Storage And Streaming",
      "docPath": "docs/kb/systems/chunk-storage-streaming.md",
      "aliases": ["chunks", "chunk loading", "world streaming", "chunk cache", "world neighborhood"],
      "tags": ["Chunks", "Worlds", "Performance", "Persistence"],
      "uiSurfaces": ["World editor viewport", "World mode"],
      "keyFiles": ["server.js", "src/worldChunking.ts", "src/worldshaperStudio/bootstrap.ts", "src/worldshaperStudio/runtime.ts"],
      "apiEndpoints": ["/api/world/:worldId/chunk/:chunkX/:chunkY", "/api/world/:worldId/chunks", "/api/world/:worldId/chunks/batch-save"],
      "relatedSystems": ["world-bootstrap", "rendering-viewport", "persistence-save-pipeline", "world-overview"],
      "priorityForRequestTriage": "high"
    },
    {
      "id": "layers-tile-editing",
      "name": "Layers And Tile Editing",
      "docPath": "docs/kb/systems/layers-tile-editing.md",
      "aliases": ["layers", "tile painting", "height layers", "brushes", "eraser"],
      "tags": ["Layers", "Tiling", "UI / Workflow", "Worlds"],
      "uiSurfaces": ["Layers sidebar", "Canvas tools", "Viewport"],
      "keyFiles": ["src/worldshaperStudio/interactionController.ts", "src/worldshaperStudio/runtime.ts", "src/worldshaperStudio/sidebarController.ts", "src/worldshaperStudio/mapDocumentController.ts", "src/worldshaperStudio/popupSessionStore.ts"],
      "apiEndpoints": ["/api/world/:worldId/chunks/batch-save"],
      "relatedSystems": ["chunk-storage-streaming", "rendering-viewport", "content-catalog-records"],
      "priorityForRequestTriage": "high"
    },
    {
      "id": "graphics-painter",
      "name": "Graphics Painter",
      "docPath": "docs/kb/systems/graphics-painter.md",
      "aliases": ["graphic painter", "graphics painter", "tile art", "sprite painter", "animation painter"],
      "tags": ["Graphics Painter", "Animation", "Content", "Windows"],
      "uiSurfaces": ["Graphic Painter window", "Animation preview"],
      "keyFiles": ["src/worldshaperStudio/tileArtEditorWindowController.ts", "src/worldshaperStudio/graphicsDocumentHelpers.ts", "src/worldshaperStudio/importController.ts", "src/worldshaperStudio/dom.ts"],
      "apiEndpoints": ["/api/content/images", "/api/content/sprites", "/api/content/tiles", "/api/images", "/api/images/:filename"],
      "relatedSystems": ["content-catalog-records", "floating-window-shell", "rendering-viewport"],
      "priorityForRequestTriage": "high"
    },
    {
      "id": "rendering-viewport",
      "name": "Rendering And Viewport",
      "docPath": "docs/kb/systems/rendering-viewport.md",
      "aliases": ["renderer", "pixi", "viewport", "camera", "draw", "chunk culling"],
      "tags": ["Rendering", "Performance", "Worlds", "Chunks"],
      "uiSurfaces": ["World canvas", "Debug overlay"],
      "keyFiles": ["src/worldshaperStudio/renderController.ts", "src/worldshaperStudio/pixiTileStageController.ts", "src/worldshaperStudio/pixiSceneRebuildHelpers.ts", "src/worldshaperStudio/pixiChunkSurfaceHelpers.ts", "src/worldshaperStudio/overlayRenderer.ts"],
      "apiEndpoints": [],
      "relatedSystems": ["chunk-storage-streaming", "layers-tile-editing", "world-overview"],
      "priorityForRequestTriage": "high"
    },
    {
      "id": "world-overview",
      "name": "World Overview",
      "docPath": "docs/kb/systems/world-overview.md",
      "aliases": ["overview", "world overview", "chunk overview", "overview map"],
      "tags": ["World Overview", "Chunks", "Windows", "Worlds"],
      "uiSurfaces": ["World Overview window"],
      "keyFiles": ["src/worldshaperStudio/worldOverviewWindowController.ts", "src/worldshaperStudio/dom.ts", "server.js"],
      "apiEndpoints": ["/api/world/:worldId/overview", "/api/world/:worldId/bookmarks"],
      "relatedSystems": ["chunk-storage-streaming", "layers-tile-editing", "floating-window-shell"],
      "priorityForRequestTriage": "high"
    },
    {
      "id": "persistence-save-pipeline",
      "name": "Persistence And Save Pipeline",
      "docPath": "docs/kb/systems/persistence-save-pipeline.md",
      "aliases": ["save", "saving", "persist", "world save", "content save"],
      "tags": ["Persistence", "Content", "Chunks", "Worlds"],
      "uiSurfaces": ["Toolbar save flow", "Status messages"],
      "keyFiles": ["src/worldshaperStudio/persistenceController.ts", "src/worldshaperStudio/historyController.ts", "src/worldshaperStudio/historyStateStore.ts", "server.js"],
      "apiEndpoints": ["/api/world/:worldId/chunks/batch-save", "/api/content/:type", "/api/editor-settings", "/api/catalog-meta"],
      "relatedSystems": ["chunk-storage-streaming", "content-catalog-records"],
      "priorityForRequestTriage": "medium"
    },
    {
      "id": "floating-window-shell",
      "name": "Floating Window Shell",
      "docPath": "docs/kb/systems/floating-window-shell.md",
      "aliases": ["floating window", "popout", "windowing", "tool windows"],
      "tags": ["Windows", "Launcher", "UI / Workflow", "Graphics Painter"],
      "uiSurfaces": ["Studio popout", "Tool windows", "Overlay layer"],
      "keyFiles": ["src/worldshaperStudio/windowing.ts", "src/worldshaperStudio/floatingWindowUtils.ts", "src/worldshaperStudio/toolWindowController.ts", "src/worldshaperStudio/changelogSplashWindowController.ts", "src/worldshaperStudio/engineOverrideWindowController.ts"],
      "apiEndpoints": [],
      "relatedSystems": ["launcher-home", "graphics-painter", "world-overview"],
      "priorityForRequestTriage": "medium"
    },
    {
      "id": "content-catalog-records",
      "name": "Content Catalog And Records",
      "docPath": "docs/kb/systems/content-catalog-records.md",
      "aliases": ["content", "tiles", "sprites", "images", "catalog", "records"],
      "tags": ["Content", "Graphics Painter", "Tiling", "Persistence"],
      "uiSurfaces": ["Content records", "Graphic Painter inputs", "Tile palette"],
      "keyFiles": ["server.js", "src/App.tsx", "src/components/worldshaperShared.ts", "src/worldshaperStudio/graphicsDocumentHelpers.ts", "src/worldshaperStudio/importController.ts"],
      "apiEndpoints": ["/api/content/:type", "/api/content/tiles/:tileId/delete", "/api/content/sprites/:spriteId/delete", "/api/catalog-meta", "/api/images", "/api/images/:filename"],
      "relatedSystems": ["graphics-painter", "layers-tile-editing", "persistence-save-pipeline"],
      "priorityForRequestTriage": "medium"
    }
  ]
}