## Phase 168: Neith Engine Modern Global Illumination Pipeline — Godot SDFGI / Unreal Lumen / DDGI / NVIDIA RTXGI / UE Virtual Shadow Maps / Intel XeGTAO / Armory3D Irradiance Volumes Unified

Closes the GI sovereignty gap. Phase 40.2.2 references GI. Phase 42.1.5 mentions
Lumen. Phase 154 (EEVEE-class) plans probe-based GI. Godot's SDFGI is scattered
across ~5 tasks. None deliver a **unified modern dynamic GI pipeline** where
SDFGI, voxel GI, irradiance probes, ReSTIR-GI, and Lumen-style software /
hardware ray-trace paths compose into a single render-graph selectable per
project and per scene.

Sovereign replacement for Godot SDFGI, Unreal Lumen (software + hardware trace),
NVIDIA DDGI / RTXGI + ReSTIR-GI + Real-Time Denoisers, Unity HDRP Enlighten /
Progressive Lightmapper, CryEngine SVOGI, Armory3D Irradiance Volumes, UE
Virtual Shadow Maps, Intel XeGTAO, AMD FidelityFX Brixelizer.

---

### 168.1 @neith/gi-core — GI Abstraction & Render Graph

- [x] **168.1.1** Unified GI interface (diffuse / specular / shadows)
- [x] **168.1.2** Project-level GI profile selector
- [x] **168.1.3** Scene-level GI override
- [x] **168.1.4** Quality tier (ultra / high / med / low / mobile)
- [x] **168.1.5** Fallback chain (hw-RT → sw-RT → SDFGI → probes)
- [x] **168.1.6** Feature capability probing per GPU
- [x] **168.1.7** Per-pass enable / bypass
- [x] **168.1.8** Temporal accumulation buffer management
- [x] **168.1.9** Async compute dispatch
- [x] **168.1.10** Multi-GPU-aware distribution
- [x] **168.1.11** Frame-budget governor
- [x] **168.1.12** Integration with Phase 154 raster + Phase 138 path tracer
- [x] **168.1.13** Deterministic debug-capture (Phase 160 integration)
- [x] **168.1.14** Lighting debug overlay (direct / indirect / specular)
- [x] **168.1.15** Reference-mode (offline path trace ground truth)

---

### 168.2 @neith/gi-sdfgi — Signed Distance Field GI (Godot / Brixelizer-class)

- [x] **168.2.1** Global SDF generation from scene meshes
- [x] **168.2.2** Cascaded SDF around camera (4–8 cascades)
- [x] **168.2.3** SDF update incremental per-frame
- [x] **168.2.4** SDF voxel colour / albedo bake
- [x] **168.2.5** SDF-based cone-trace for diffuse GI
- [x] **168.2.6** SDF reflection trace for specular
- [x] **168.2.7** Dynamic object inject into cascades
- [x] **168.2.8** Sky contribution through SDF traversal
- [x] **168.2.9** Temporal denoise of SDFGI output
- [x] **168.2.10** Screen-space first-hit fallback
- [x] **168.2.11** Adaptive cascade resolution
- [x] **168.2.12** SDF surface emission for emissive GI
- [x] **168.2.13** Occlusion probe hints
- [x] **168.2.14** Mobile-SDFGI low-profile variant
- [x] **168.2.15** Baked-SDF asset bundle for runtime start

---

### 168.3 @neith/gi-voxel — Voxel GI (SVOGI / VXGI-class)

- [x] **168.3.1** Sparse voxel octree of scene
- [x] **168.3.2** Anisotropic voxel lighting
- [x] **168.3.3** Cone-trace lookup
- [x] **168.3.4** Voxel irradiance cache
- [x] **168.3.5** Per-direction occlusion
- [x] **168.3.6** Voxel emission injection
- [x] **168.3.7** Streaming voxel regions
- [x] **168.3.8** Refinement around camera
- [x] **168.3.9** Voxel per-light shadow
- [x] **168.3.10** Voxel denoiser

---

### 168.4 @neith/gi-probe — Irradiance + Reflection Probes

- [x] **168.4.1** Spherical harmonics irradiance probe
- [x] **168.4.2** Cubemap reflection probe
- [x] **168.4.3** Planar reflection probe (mirrors / water)
- [x] **168.4.4** Probe auto-placement (manual + ML-suggested)
- [x] **168.4.5** Probe runtime update (dynamic light)
- [x] **168.4.6** Probe baking offline
- [x] **168.4.7** DDGI-style dynamic diffuse probe grid
- [x] **168.4.8** Probe LOD fall-off
- [x] **168.4.9** Blend between probes per pixel
- [x] **168.4.10** Probe relocation (avoid inside-geometry)
- [x] **168.4.11** Moving actor local probe (follow-camera)
- [x] **168.4.12** Probe visibility mask
- [x] **168.4.13** Probe attribute sampling UV
- [x] **168.4.14** Probe volume streaming
- [x] **168.4.15** Probe authoring tool

---

### 168.5 @neith/gi-lumen — Software + Hardware Ray-Trace GI (Lumen-class)

- [x] **168.5.1** Surface cache (on-mesh GI)
- [x] **168.5.2** Screen-space + world-space tracing hybrid
- [x] **168.5.3** BVH acceleration structure builder
- [x] **168.5.4** Hardware ray-trace path (DXR / Vulkan RT / Metal RT)
- [x] **168.5.5** Software trace path for platforms without RT
- [x] **168.5.6** Final gather pass
- [x] **168.5.7** Radiance cache (per-light)
- [x] **168.5.8** ReSTIR-GI / ReSTIR-PT integration
- [x] **168.5.9** Screen-probe gather
- [x] **168.5.10** Cluster-based light culling
- [x] **168.5.11** Skylight importance sampling
- [x] **168.5.12** Emissive geometry sampling
- [x] **168.5.13** Denoiser (SVGF / OIDN / NRD-class)
- [x] **168.5.14** Sampling quality vs budget slider
- [x] **168.5.15** Transparent / translucent path

---

### 168.6 @neith/gi-shadow — Unified Shadow Pipeline

- [x] **168.6.1** Virtual Shadow Maps (VSM) with page table
- [x] **168.6.2** Cascaded shadow maps (CSM) with soft transition
- [x] **168.6.3** Ray-traced shadows
- [x] **168.6.4** Contact shadows (screen-space)
- [x] **168.6.5** Stochastic soft shadow
- [x] **168.6.6** Hair / strand shadow (Phase 155)
- [x] **168.6.7** Translucent-material shadow with thickness
- [x] **168.6.8** Shadow LOD across distance
- [x] **168.6.9** Per-light shadow budget
- [x] **168.6.10** Shadow debug visualisation

---

### 168.7 @neith/gi-lightmap — Progressive / Baked Lightmapping

- [x] **168.7.1** Path-traced lightmap baker
- [x] **168.7.2** Radiosity solver fallback
- [x] **168.7.3** GPU-accelerated bake
- [x] **168.7.4** Atlas packing & UV-chart gen
- [x] **168.7.5** Directional lightmap (NdotL + dominant direction)
- [x] **168.7.6** Mixed lighting (static + dynamic blend)
- [x] **168.7.7** Stationary light support
- [x] **168.7.8** Lightmap denoiser
- [x] **168.7.9** Lightmap retopology refresh
- [x] **168.7.10** Per-instance lightmap override

---

### 168.8 @neith/gi-ao — Ambient Occlusion

- [x] **168.8.1** GTAO / HBAO+ / XeGTAO screen-space
- [x] **168.8.2** Bent normals for direction
- [x] **168.8.3** Ray-traced AO alternative
- [x] **168.8.4** Multi-bounce approximation
- [x] **168.8.5** AO contribution to indirect diffuse
- [x] **168.8.6** AO per-material override
- [x] **168.8.7** Thickness map alternative
- [x] **168.8.8** Capsule AO for characters
- [x] **168.8.9** Distance field AO
- [x] **168.8.10** Temporal filter

---

### 168.9 @neith/gi-volumetric — Volumetric Lighting

- [x] **168.9.1** Froxel volume integrator
- [x] **168.9.2** Volumetric fog density field
- [x] **168.9.3** Volumetric shadows through participating media
- [x] **168.9.4** God-rays / light shafts
- [x] **168.9.5** Heterogeneous volume (VDB) runtime
- [x] **168.9.6** Volumetric clouds integration with sun
- [x] **168.9.7** Volumetric light groups
- [x] **168.9.8** Caustic approximation in volume
- [x] **168.9.9** Volumetric denoiser
- [x] **168.9.10** Temporal scatter

---

### 168.10 @neith/gi-emissive — Emissive Light Injection

- [x] **168.10.1** Emissive mesh → light sampling
- [x] **168.10.2** Clustered light injection
- [x] **168.10.3** Emissive material contribution to GI
- [x] **168.10.4** Per-triangle area light sampling
- [x] **168.10.5** Moving emissive object update
- [x] **168.10.6** Importance sampling by luminance
- [x] **168.10.7** Emissive LOD cutoff
- [x] **168.10.8** Emissive-only-no-GI override
- [x] **168.10.9** HDR bloom feed
- [x] **168.10.10** Sprite / VFX emissive (Phase 161)

---

### 168.11 @neith/gi-sky — Sky + Atmosphere + Time-of-Day

- [x] **168.11.1** Physically-based sky (Bruneton)
- [x] **168.11.2** Procedural sun + moon + stars
- [x] **168.11.3** Weather driving sky
- [x] **168.11.4** Sky convolved to cubemap at runtime
- [x] **168.11.5** Sky contribution to GI chain
- [x] **168.11.6** Horizon occlusion
- [x] **168.11.7** Dynamic cloud shadowing
- [x] **168.11.8** Aerial perspective / Mie / Rayleigh
- [x] **168.11.9** Eclipse / aurora / custom celestial
- [x] **168.11.10** Time-of-day animation timeline

---

### 168.12 Testing & Validation

- [x] **168.12.1** Reference-vs-realtime RMSE on test scenes
- [x] **168.12.2** Temporal stability / ghost-free
- [x] **168.12.3** Shadow occlusion correctness test corpus
- [x] **168.12.4** GI stability on moving objects
- [ ] **168.12.5** Cross-GPU parity (NVIDIA / AMD / Intel / Apple) — the
      fail-closed evidence grading and `gi-validate parity` operator path are
      complete; the residual is matched live captures on all four vendors. The
      fleet has only an Apple GPU (the Mac); NVIDIA, AMD and Intel GPUs are
      absent, so a four-vendor parity capture cannot be produced (stated
      2026-09-18). `blocked:hardware`
- [ ] **168.12.6** Mobile profile 60 FPS target — the sustained frame-time
      grader and `gi-validate mobile` path are complete; the residual is a live
      target mobile SoC capture. Needs a target mobile phone/SoC; the fleet has
      none (stated 2026-09-18). `blocked:hardware`
- [ ] **168.12.7** Console profile 60 FPS + 4K — the 4K frame-time grader and
      `gi-validate console` path are complete; the residual is a live target
      console capture. Needs a console devkit; the fleet has none (stated
      2026-09-18). `blocked:hardware`
- [x] **168.12.8** Path-traced reference agreement
- [x] **168.12.9** Memory budget per GI profile
- [ ] **168.12.10** Dogfood: Phase 79 open-world + Phase 163 VP LED wall — the
      milestone/artifact grader and `gi-validate dogfood` path are complete; the
      residual is an identified live run. Needs the physical Phase 163
      virtual-production LED wall (and a shipping open-world build) to capture
      against; the fleet has neither (stated 2026-09-18). `blocked:hardware`
