## Phase 157: Neith Mantaflow-Class Fluid / Smoke / Fire / Pyro / Particles Simulation — Blender Mantaflow / Houdini Pyro + FLIP + Whitewater / Maya Bifrost / RealFlow / TurbulenceFD / Phoenix FD Parity

Closes the offline fluid/smoke/fire sovereignty gap. Phase 40.3.3 and Phase
42.2.7 ship Niagara Fluids-class real-time GPU fluids for games. Phase 112
covers classical fluid physics in Kalika. Neither delivers a **production-grade
DCC simulation framework** with FLIP / APIC liquid, Eulerian pyro, combustion,
whitewater, secondary particles, and domain-to-domain transfer that VFX and
animation teams need for feature film.

Sovereign replacement for Blender Mantaflow (fluid, smoke, fire, particles),
SideFX Houdini Pyro + FLIP + Whitewater + POP + Vellum (fluid portion), Autodesk
Bifrost (Aero / Liquid), Autodesk Maya Fluids, Next Limit RealFlow / Dyverso,
Jawset TurbulenceFD, Chaos Phoenix FD, EmberGen (for offline quality), Nomad
Sculpt's FX add-ons, and XSI ICE fluids.

---

### 157.1 @neith/sim-core — Solver Core & Domain Model

- [x] **157.1.1** Simulation domain object (adaptive grid or mesh)
- [x] **157.1.2** Sparse grid backend (OpenVDB / NanoVDB / sovereign)
- [x] **157.1.3** Adaptive-level-set representation
- [x] **157.1.4** Multi-resolution nested domain
- [x] **157.1.5** Narrow-band representation for liquid
- [x] **157.1.6** Cache directory + versioned naming
- [x] **157.1.7** Bake / simulate / resume / clear operators
- [x] **157.1.8** Cross-frame checkpoint
- [x] **157.1.9** Deterministic RNG per sim
- [x] **157.1.10** Per-frame .vdb + .bphys + .vdb sequence cache
- [x] **157.1.11** OpenVDB SPGrid IO compatibility
- [x] **157.1.12** Incremental bake (only changed frames)
- [x] **157.1.13** Scene-wide sim time step controller
- [x] **157.1.14** Substep adaptive (CFL-based)
- [x] **157.1.15** Farm-distribute bake (Phase 138 farm)

---

### 157.2 @neith/sim-liquid — FLIP / APIC / PIC Liquid Solver

- [x] **157.2.1** Fluid Implicit Particle (FLIP) solver
- [x] **157.2.2** Affine Particle-In-Cell (APIC)
- [x] **157.2.3** PolyPIC / MLS-MPM option
- [x] **157.2.4** Position-based-fluids (PBF) quick preview
- [x] **157.2.5** Narrow-band FLIP for ocean / large volumes
- [x] **157.2.6** Pressure projection (multigrid / PCG)
- [x] **157.2.7** Viscous stress tensor solver
- [x] **157.2.8** Surface tension (CSF)
- [x] **157.2.9** Non-Newtonian (honey / paint) rheology
- [x] **157.2.10** Foam / spray / bubble / whitewater secondary
- [x] **157.2.11** Diffuse particle emission (curvature, vorticity,
      kinetic-energy)
- [x] **157.2.12** Adaptive particle density (seed / sink)
- [x] **157.2.13** Multi-fluid mixing (density / viscosity blend)
- [x] **157.2.14** Droplets / splashes / mist sub-solver
- [x] **157.2.15** Narrow-band + adaptive surface reconstruction

---

### 157.3 @neith/sim-gas — Eulerian Pyro / Gas Solver

- [x] **157.3.1** MAC grid solver
- [x] **157.3.2** Semi-Lagrangian advection
- [x] **157.3.3** MacCormack / BFECC high-order advection
- [x] **157.3.4** Pressure-Poisson with deflated PCG
- [x] **157.3.5** Vorticity confinement
- [x] **157.3.6** Upres (macro + micro) simulation
- [x] **157.3.7** Combustion (fuel → flame → smoke) model
- [x] **157.3.8** Black-body emission shader
- [x] **157.3.9** Sooting model
- [x] **157.3.10** Heat / temperature scalar field
- [x] **157.3.11** Turbulence injection with noise field
- [x] **157.3.12** Dissipation / cooling curve
- [x] **157.3.13** Buoyancy force
- [x] **157.3.14** Wind fields with gradient
- [x] **157.3.15** Explosion preset library

---

### 157.4 @neith/sim-mpm — Material-Point Method (Snow / Sand / Goo)

- [x] **157.4.1** MLS-MPM solver
- [x] **157.4.2** Elastoplastic material model
- [x] **157.4.3** Sand (Drucker-Prager) constitutive model
- [x] **157.4.4** Snow (Stomakhin) plasticity
- [x] **157.4.5** Cookie-dough viscoelastic
- [x] **157.4.6** Two-way MPM ↔ rigid body
- [x] **157.4.7** MPM ↔ liquid coupling
- [x] **157.4.8** Fracture criteria on MPM surface
- [x] **157.4.9** Grain-level render (mesh / sprite)
- [x] **157.4.10** Cross-domain contact resolution

---

### 157.5 @neith/sim-particles — Particle System (POPs)

- [x] **157.5.1** Point particle primitive
- [x] **157.5.2** Emitter (point / surface / volume / curve)
- [x] **157.5.3** Force fields (gravity / wind / turbulence / noise / drag)
- [x] **157.5.4** Attraction / repulsion point forces
- [x] **157.5.5** Life / age / birth-frame per particle
- [x] **157.5.6** Collision with mesh (SDF / BVH)
- [x] **157.5.7** Inter-particle collision
- [x] **157.5.8** Flocking / boids rule-set
- [x] **157.5.9** Sprite / instance render per particle
- [x] **157.5.10** Per-particle attribute (size / velocity / id / colour)
- [x] **157.5.11** Particle → mesh surfacing (metaballs / marching cubes)
- [x] **157.5.12** Disintegration effect (mesh → particles)
- [x] **157.5.13** Granular crowd-seed particles
- [x] **157.5.14** GPU-accelerated solver
      <!-- real wgpu compute integrator (integrate.wgsl) behind the `gpu` feature; parity test vs CPU integrate_chunked passes on the on-box llvmpipe adapter; naga validates the WGSL in every build -->
- [x] **157.5.15** Spawn-from-simulation (inherit fluid velocity)

---

### 157.6 @neith/sim-cloth — Cloth & Soft-Body (DCC Quality)

- [x] **157.6.1** XPBD cloth solver
- [x] **157.6.2** Bending constraints (Gauss-Seidel + dihedral)
- [x] **157.6.3** Tearing / ripping threshold
- [x] **157.6.4** Self-collision with signed-distance thickness
- [x] **157.6.5** Cloth-vs-body tight contact
- [x] **157.6.6** Air-drag / wind interaction with gas
- [x] **157.6.7** Stitch / seam model (garment authoring)
- [x] **157.6.8** Pressure / inflation (balloon / airbag)
- [x] **157.6.9** Finite element shell (for rubber / skin)
- [x] **157.6.10** Two-way rigid-body coupling
- [x] **157.6.11** Volume-preservation soft body
- [x] **157.6.12** Phase-resolved cloth cache
- [x] **157.6.13** Retime / warp cache
- [x] **157.6.14** Cache transfer to Phase 155 hair / Phase 44 garment
- [x] **157.6.15** Marvelous-Designer garment import

---

### 157.7 @neith/sim-rigid — Rigid / Constraint / Fracture

- [x] **157.7.1** Rigid-body solver (sequential impulse / PBD)
- [x] **157.7.2** Constraint types (hinge / fixed / ball / slider / cone)
- [x] **157.7.3** Motor + spring constraints
- [x] **157.7.4** Pre-fracture tool (Voronoi / Boolean cells)
- [x] **157.7.5** Dynamic fracture during sim
- [x] **157.7.6** Cluster / glue constraint for packs
- [x] **157.7.7** Compound body hierarchy
- [x] **157.7.8** Stabilised island solver
- [x] **157.7.9** Rigid-fluid two-way coupling
- [x] **157.7.10** Destructible building library

---

### 157.8 @neith/sim-ocean — Ocean, Waves, Whitecaps

- [x] **157.8.1** Gerstner + FFT ocean surface
- [x] **157.8.2** Beaufort wind scale presets
- [x] **157.8.3** Swell + chop + spectrum control
- [x] **157.8.4** Shore breaking (procedural + FLIP boundary)
- [x] **157.8.5** Foam / whitecap distribution
- [x] **157.8.6** Jacobian displacement map export
- [x] **157.8.7** Ocean tile tileable for vast scene
- [x] **157.8.8** Wake from mesh (boat / duck) into FFT ocean
- [x] **157.8.9** Caustic pattern generator
- [x] **157.8.10** Shallow-water coupling

---

### 157.9 @neith/sim-surface — Surface Reconstruction & Meshing

- [x] **157.9.1** Anisotropic kernel surface (Yu–Turk)
- [x] **157.9.2** Marching-cubes / dual-contour
- [x] **157.9.3** Narrow-band mesh generation
- [x] **157.9.4** Smoothing + filter
- [x] **157.9.5** UV automatic generation
- [x] **157.9.6** Velocity-transfer to mesh for motion blur
- [x] **157.9.7** Mesh subdivision refinement
- [x] **157.9.8** Displacement from particle foam
- [x] **157.9.9** Mesh cache export (.bobj / .abc / .vdb / .usd)
- [x] **157.9.10** Retopology for hero shots

---

### 157.10 @neith/sim-forces — Force Field & Object Interaction

- [x] **157.10.1** Obstacle (static / kinematic / deforming)
- [x] **157.10.2** Moving obstacle velocity transfer
- [x] **157.10.3** Collider SDF auto-generation
- [x] **157.10.4** Inflow / outflow objects
- [x] **157.10.5** Source temperature / velocity driver
- [x] **157.10.6** Negative source (sink) remover
- [x] **157.10.7** Guide fluid from low-res sim
- [x] **157.10.8** Channel-driven forces (keyframe)
- [x] **157.10.9** Procedural noise force
- [x] **157.10.10** Character-animated force (actor drives wind)

---

### 157.11 @neith/sim-render — Render & Shading Integration

- [x] **157.11.1** Density / temperature / velocity VDB AOV
- [x] **157.11.2** Volume shader with absorption / scattering / emission
- [x] **157.11.3** Henyey-Greenstein phase function
- [x] **157.11.4** Multi-scattering approximation
- [x] **157.11.5** Black-body fire shader with physically-based temperature
- [x] **157.11.6** Light-linking per volume
- [x] **157.11.7** Render-ready LOD (low-res for preview)
- [x] **157.11.8** Denoiser for volumes (Phase 138 OIDN / OptiX)
- [x] **157.11.9** Motion blur from velocity field
- [x] **157.11.10** Viewport preview (Phase 154 EEVEE-class)

---

### 157.12 @neith/sim-games — Real-Time Baking for Game Runtime

- [x] **157.12.1** Bake to flipbook (2D/3D texture)
- [x] **157.12.2** Bake to VAT (vertex animation texture)
- [x] **157.12.3** Bake to Alembic sequence
- [x] **157.12.4** Bake to GPU particle seed data
- [x] **157.12.5** Export to Neith Engine Phase 42 / Phase 161 Niagara-class
- [x] **157.12.6** Loop-friendly bake with phase-align
- [x] **157.12.7** Impostor card generation
- [x] **157.12.8** Tile-able fluid loop
- [x] **157.12.9** LOD chain per sim
- [x] **157.12.10** Runtime playback shader

---

### 157.13 @neith/sim-farm — Distributed Simulation

- [x] **157.13.1** Frame-range splitter
- [x] **157.13.2** Spatial domain decomposition (MPI / NCCL)
- [x] **157.13.3** Multi-GPU scaling for grid solvers
      <!-- executable multi_gpu coordinator partitions grids, materialises exact halos, dispatches ranks concurrently, and assembles results; optional wgpu backend enumerates adapters through one selected compute API and runs the Jacobi stencil on one logical device/queue per adapter; CPU rank parity + on-box llvmpipe wgpu runtime parity pass. Physical multi-adapter throughput remains covered honestly by 157.14.10. -->
- [x] **157.13.4** Dependency scheduler (low-res guide → hi-res upres)
- [x] **157.13.5** Deadline-compatible farm submission (Phase 138 farm)
- [x] **157.13.6** Checkpoint retry on node failure
- [x] **157.13.7** Result-review proxy before final
- [x] **157.13.8** Cost estimator per sim
- [x] **157.13.9** Cache pinning / retention policy
- [x] **157.13.10** Metrics (kernel-time, grid-count, particle-count)

---

### 157.14 Testing & Validation

- [x] **157.14.1** Dam-break benchmark vs analytic
- [x] **157.14.2** Rising-bubble benchmark
- [x] **157.14.3** Rayleigh-Taylor instability test
- [x] **157.14.4** Kelvin-Helmholtz instability test
- [x] **157.14.5** Pyro vs Houdini reference (qualitative corpus)
- [x] **157.14.6** Mantaflow .bobj round-trip
- [x] **157.14.7** OpenVDB SPGrid interop
- [x] **157.14.8** Cloth swing / flag benchmark
- [x] **157.14.9** MPM snow-ball vs Stomakhin reference
- [ ] **157.14.10** Multi-GPU scaling efficiency ≥ 80 % `blocked:gpu`
      <!-- a measured median-sample release gate now rejects single-device evidence and calculates real speedup/efficiency; this host exposes one Virtio display device and only one llvmpipe wgpu compute adapter, so the >=80% multi-GPU measurement still requires external multi-GPU hardware -->
      Re-measured on the Linux dev server 2026-09-18, because a blocker tag is a
      claim like any other: `nvidia-smi` is not installed (`command not found`),
      `lspci` reports one display device — `Red Hat, Inc. Virtio 1.0 GPU` — and
      `/dev/dri` holds a single render node, `renderD128`. An efficiency figure
      across N devices cannot be produced on one paravirtual adapter, and the
      gate above is right to reject single-device evidence rather than report a
      speedup of 1.0 as a pass.
