graph TB
subgraph CLI["CLI Layer"]
CLAP["clap CLI Parser
init | run | test | build | demo | submit-log"]
MAIN["main.rs
Entry Point"]
DEMO_CMD["Demo Browser
demos.rs — 19 embedded demos"]
DEVLOG_CMD["Submit Log
dev_log.rs — GitHub Issues API"]
end
subgraph ENGINE["Engine Core (engine.rs)"]
EL["winit Event Loop
ApplicationHandler"]
DT["Delta Time"]
PAUSE["Pause State"]
end
subgraph ECS["ECS World (hecs)"]
SW["SceneWorld
world + entity_registry"]
TRANSFORM["Transform"]
MESH_R["MeshRenderer"]
PL["PointLight"]
PLAYER["Player"]
CAM["Camera"]
SCRIPT_C["Script"]
TAGS["Tags / EntityId"]
CC["CharacterController"]
GS["GaussianSplat"]
HIDDEN["Hidden
visibility marker"]
MAT_OVR["MaterialOverride
runtime emission/roughness"]
end
subgraph SCENE["Scene System"]
YAML_P["YAML Parser
serde_yaml"]
SCENE_F["SceneFile
entities + settings"]
SPAWN["spawn_all_entities()"]
RECONCILE["reconcile_scene()
hot-reload diff"]
end
subgraph RENDER["Rendering Pipeline"]
GPU["GpuState
wgpu device/queue/surface"]
PIPE_YAML["Pipeline YAML
DAG of passes"]
COMPILED["CompiledPipeline
resources + passes"]
SHADOW["Shadow Pass
directional shadow map"]
GBUF["G-Buffer Pass
albedo + normal + depth"]
LIGHT["Lighting Pass
Cook-Torrance GGX + shadows"]
BLOOM_P["Bloom Pass
HDR glow extraction"]
TONE["Tonemap Pass
HDR → SDR"]
FXAA_P["FXAA Pass
anti-aliasing"]
SPLAT_P["Splat Pass
Gaussian billboards"]
FWD["Forward Fallback"]
end
subgraph UI["UI Overlay (Phase 16)"]
FONT["BitmapFont
6×8 pixel atlas, 95 glyphs"]
UI_R["UiRenderer
immediate-mode 2D"]
UI_TEXT["ui.text()
screen-space text"]
UI_RECT["ui.rect()
colored rectangles"]
UI_FLASH["ui.flash()
screen effects"]
ENT_CMD["EntityCommandQueue
deferred spawn/destroy"]
end
subgraph SHADER["Shader System"]
SLANG["SLANG Compiler
shader-slang crate"]
WGSL["WGSL Fallback"]
REFLECT["Reflection API
auto bind group layouts"]
end
subgraph PHYSICS["Physics (Rapier 3D)"]
PW["PhysicsWorld
rigid bodies + colliders"]
CHAR["Character Controller
move_character()"]
STEP["step() + sync_to_ecs()"]
end
subgraph SCRIPTING["Lua Scripting (mlua)"]
LUA["ScriptRuntime
single Lua VM"]
ENV["Per-Entity Environments
self table + metatable"]
HOOKS["Lifecycle Hooks
init / update / on_reload"]
API_IN["input API
pressed / just_pressed"]
API_ENT["entity API
position/rotation/light/scale/visible"]
API_CMD["entity commands
spawn / destroy"]
API_UI["ui API
text / rect / flash / screen_size"]
API_EVT["events API
events.emit()"]
API_PHY["physics API
raycast / overlap"]
API_AUD["audio API
play_sfx / play_music"]
GAME_T["game table
shared state"]
end
subgraph INPUT["Input System"]
BINDINGS["bindings.yaml
action → key mapping"]
IS["InputState
held / just_pressed / delta"]
SYNTH["Synthetic Injection
inject_key_press()"]
CURSOR["Cursor Capture
FPS mouse lock"]
end
subgraph EVENTS["Event System"]
EB["EventBus
ring buffer log"]
SCHEMA["events/schema.yaml
validation"]
EMIT["emit() / flush() / tick()"]
end
subgraph ASSETS["Asset System"]
MESH_C["MeshCache
procedural cube fallback"]
MAT_C["MaterialCache
YAML materials"]
SPLAT_C["SplatCache
PLY parser + GPU buffers"]
end
subgraph HOT["Hot-Reload (notify)"]
WATCH["File Watcher"]
W_SHADER["Shader Changed"]
W_SCENE["Scene Changed"]
W_MAT["Material Changed"]
W_PIPE["Pipeline Changed"]
W_SCRIPT["Script Changed"]
W_SPLAT["Splat Changed"]
end
subgraph IPC["External Control"]
SOCK["Unix Domain Socket
/tmp/naive-runtime.sock"]
CMD["Command Protocol
JSON request/response"]
MCP["MCP Server Binary
naive_mcp"]
end
subgraph AUDIO["Audio (Kira)"]
AUDIO_S["AudioSystem
spatial audio"]
end
subgraph TWEEN["Animation"]
TW["TweenSystem
property animation"]
end
subgraph FEEDBACK["Dev Feedback Loop"]
DEVLOG["dev.log
structured feedback template"]
GITHUB["GitHub Issues API
ureq POST"]
LABEL["dev-log label
searchable record"]
end
subgraph DEMOS["Demo System"]
REGISTRY["DemoEntry Registry
19 demos × 6 categories"]
EMBED["include_str! Embedded
scenes + Lua + materials"]
TMPDIR["$TMPDIR/naive-demo/
extraction target"]
MENU["Interactive Menu
ANSI + stdin"]
end
CLAP --> MAIN
MAIN -->|"run"| EL
MAIN -->|"demo"| DEMO_CMD
MAIN -->|"submit-log"| DEVLOG_CMD
DEMO_CMD -->|"extract + CliArgs"| EL
DEVLOG_CMD -->|"POST dev.log"| GITHUB
EL -->|"WindowEvent"| IS
EL -->|"DeviceEvent"| IS
EL -->|"RedrawRequested"| DT
DT --> CHAR
DT --> HOOKS
DT --> EMIT
DT --> TW
YAML_P --> SCENE_F
SCENE_F --> SPAWN
SPAWN --> SW
SPAWN --> MESH_C
SPAWN --> MAT_C
SW --> TRANSFORM
SW --> MESH_R
SW --> PL
SW --> PLAYER
SW --> CAM
SW --> SCRIPT_C
SW --> CC
SW --> GS
IS -->|"raw ptr"| API_IN
SW -->|"raw mut ptr"| API_ENT
ENT_CMD -->|"raw mut ptr"| API_CMD
UI_R -->|"raw mut ptr"| API_UI
EB -->|"raw mut ptr"| API_EVT
PW -->|"raw ptr"| API_PHY
AUDIO_S -->|"raw mut ptr"| API_AUD
LUA --> ENV
ENV --> HOOKS
ENV --> GAME_T
CHAR --> PW
STEP --> SW
PIPE_YAML --> COMPILED
COMPILED --> SHADOW
COMPILED --> GBUF
COMPILED --> LIGHT
COMPILED --> BLOOM_P
COMPILED --> TONE
COMPILED --> FXAA_P
COMPILED --> SPLAT_P
SLANG --> WGSL
SLANG --> REFLECT
FONT --> UI_R
UI_R --> UI_TEXT
UI_R --> UI_RECT
UI_R --> UI_FLASH
ENT_CMD -->|"deferred"| SW
WATCH --> W_SHADER
WATCH --> W_SCENE
WATCH --> W_SCRIPT
WATCH --> W_PIPE
SOCK --> CMD
CMD -->|"inject_input"| SYNTH
CMD -->|"emit_event"| EB
CMD -->|"query/modify"| SW
MCP --> SOCK
SYNTH --> IS
REGISTRY --> EMBED
EMBED -->|"write to disk"| TMPDIR
MENU -->|"select demo"| REGISTRY
DEVLOG -->|"naive submit-log"| GITHUB
GITHUB --> LABEL
classDef core fill:#e94560,stroke:#0f3460,color:#fff
classDef ecs fill:#0f3460,stroke:#e94560,color:#fff
classDef render fill:#533483,stroke:#e94560,color:#fff
classDef script fill:#1a5276,stroke:#e94560,color:#fff
classDef input fill:#1e8449,stroke:#fff,color:#fff
classDef event fill:#b7950b,stroke:#fff,color:#000
classDef ui fill:#7b2d8e,stroke:#e94560,color:#fff
classDef feedback fill:#c0392b,stroke:#fff,color:#fff
classDef demo fill:#2980b9,stroke:#fff,color:#fff
class EL,DT,PAUSE core
class SW,TRANSFORM,MESH_R,PL,PLAYER,CAM,SCRIPT_C,CC,GS,TAGS,HIDDEN,MAT_OVR ecs
class GPU,COMPILED,SHADOW,GBUF,LIGHT,BLOOM_P,TONE,FXAA_P,SPLAT_P,FWD render
class LUA,ENV,HOOKS,API_IN,API_ENT,API_CMD,API_UI,API_EVT,API_PHY,API_AUD,GAME_T script
class IS,BINDINGS,SYNTH,CURSOR input
class EB,SCHEMA,EMIT event
class FONT,UI_R,UI_TEXT,UI_RECT,UI_FLASH,ENT_CMD ui
class DEVLOG,GITHUB,LABEL,DEVLOG_CMD feedback
class REGISTRY,EMBED,TMPDIR,MENU,DEMO_CMD demo
flowchart LR
subgraph Shadow["Shadow Pass"]
SH1["Directional Light View"]
SH2["Depth-only Render
shadow_depth texture"]
end
subgraph GBuf["G-Buffer Pass"]
G1["Vertex Shader
MVP transform"]
G2["Fragment Shader
output albedo, normal, depth"]
end
subgraph Splat["Splat Pass (optional)"]
S1["Billboard Quads
sorted back-to-front"]
S2["2D Gaussian
alpha blending"]
end
subgraph Light["Lighting Pass"]
L1["Fullscreen Quad"]
L2["Reconstruct world pos
inv_view_projection × depth"]
L3["Cook-Torrance GGX
D·F·G / (4·NdotL·NdotV)"]
L4["Shadow Sampling
PCF soft shadows"]
L5["Depth Composite
mesh vs splat"]
end
subgraph Bloom["Bloom Pass"]
BL1["HDR Threshold
extract bright pixels"]
BL2["Gaussian Blur
separable kernel"]
BL3["Additive Blend
bloom + scene"]
end
subgraph Tone["Tonemap Pass"]
T1["Reinhard Tonemap"]
T2["Gamma Correction"]
end
subgraph FXAA["FXAA Pass"]
FX1["Edge Detection
luma contrast"]
FX2["Subpixel Blend
anti-aliased output"]
end
subgraph UIPass["UI Overlay Pass"]
UI1["Colored Rects Pipeline
solid quads, alpha blend"]
UI2["Textured Text Pipeline
6×8 bitmap font atlas"]
UI3["Screen Flash
fullscreen fade effect"]
end
Shadow -->|"shadow_depth"| Light
GBuf -->|"albedo_rt
normal_rt
depth"| Light
Splat -->|"splat_color
splat_depth"| Light
Light -->|"hdr_rt"| Bloom
Bloom -->|"bloom_rt"| Tone
Tone -->|"ldr_rt"| FXAA
FXAA -->|"swapchain"| UIPass
UIPass -->|"LoadOp::Load"| SCREEN["Display"]
style Shadow fill:#2c3e50,color:#fff
style GBuf fill:#0f3460,color:#fff
style Splat fill:#533483,color:#fff
style Light fill:#1a5276,color:#fff
style Bloom fill:#8e44ad,color:#fff
style Tone fill:#e94560,color:#fff
style FXAA fill:#27ae60,color:#fff
style UIPass fill:#7b2d8e,color:#fff
flowchart TB
USER["User / AI Agent"] -->|"naive ..."| CLI["clap Parser"]
CLI -->|"init name"| INIT["create_project()
Scaffold dirs, YAML, Lua,
CLAUDE.md, dev.log"]
CLI -->|"run [--scene]"| RUN["Load naive.yaml
→ run_engine()"]
CLI -->|"test [file]"| TEST["test_runner
Headless Lua tests"]
CLI -->|"build [--target]"| BUILD["bundle_project()
Standalone distribution"]
CLI -->|"demo [selector]"| DEMO["demos.rs"]
CLI -->|"submit-log"| SUBMIT["dev_log.rs"]
CLI -->|"publish"| PUB["publish.rs
World server"]
DEMO -->|"no selector"| MENU["Interactive Menu
ANSI terminal"]
DEMO -->|"number"| LOOKUP["Lookup by index"]
DEMO -->|"name"| FUZZY["Fuzzy match slug/name"]
MENU --> EXTRACT
LOOKUP --> EXTRACT
FUZZY --> EXTRACT
EXTRACT["Extract to $TMPDIR
scenes + Lua + materials"] -->|"CliArgs"| ENGINE["run_engine()"]
SUBMIT -->|"Read dev.log"| VALIDATE["Validate content
+ NAIVE_GITHUB_TOKEN"]
VALIDATE -->|"POST"| GHAPI["GitHub Issues API
poro/nAIVE/issues"]
GHAPI -->|"Created"| RECORD["Append submission
record to dev.log"]
style INIT fill:#27ae60,color:#fff
style RUN fill:#e94560,color:#fff
style TEST fill:#2980b9,color:#fff
style DEMO fill:#2980b9,color:#fff
style SUBMIT fill:#c0392b,color:#fff
style ENGINE fill:#e94560,color:#fff
style GHAPI fill:#c0392b,color:#fff
flowchart LR
subgraph SCAFFOLD["Project Scaffold"]
INIT2["naive init my-game"]
DEVLOG2["dev.log template
What Worked / Pain Points
Workarounds / Missing Features"]
CLAUDE_MD["CLAUDE.md
Instructs AI agents
to maintain dev.log"]
end
subgraph DEV["Development Phase"]
AGENT["AI Agent
(Claude, GPT, etc.)"]
GAME["Game Code
YAML + Lua"]
LOG_WRITE["Update dev.log
as issues arise"]
end
subgraph SUBMIT2["Submission"]
CLI2["naive submit-log"]
POST2["POST to GitHub
Issues API"]
ISSUE["GitHub Issue
[Dev Log] my-game
label: dev-log"]
end
subgraph TRIAGE["Engine Triage"]
REVIEW["Review dev-log issues"]
PATTERN["Identify patterns
across projects"]
ROADMAP["Update engine
roadmap priorities"]
end
subgraph ENGINE2["Engine Release"]
FIX["Fix pain points
Add missing features"]
RELEASE["New nAIVE version"]
end
INIT2 --> DEVLOG2
INIT2 --> CLAUDE_MD
CLAUDE_MD -->|"AI reads instructions"| AGENT
AGENT --> GAME
AGENT --> LOG_WRITE
LOG_WRITE --> DEVLOG2
DEVLOG2 -->|"naive submit-log"| CLI2
CLI2 --> POST2
POST2 --> ISSUE
ISSUE --> REVIEW
REVIEW --> PATTERN
PATTERN --> ROADMAP
ROADMAP --> FIX
FIX --> RELEASE
RELEASE -->|"Updated engine
+ demo catalog"| INIT2
style INIT2 fill:#27ae60,color:#fff
style AGENT fill:#2980b9,color:#fff
style ISSUE fill:#c0392b,color:#fff
style RELEASE fill:#e94560,color:#fff
style PATTERN fill:#b7950b,color:#000