## Phase 155: Neith Curves-Based Hair & Grooming System — Blender 4.x Curves Hair / Maya XGen / Houdini Grooming / Ornatrix / Yeti / Weta Barbershop Parity

Closes the hair/fur sovereignty gap. Phase 138.7 lists "XGen/Ornatrix-class hair
grooming" and Phase 71 covers 3D generation, but neither plans a
**curves-primitive groom authoring system** — the curve-based hair workflow that
Blender 4.0+ introduced and that replaces the legacy particle-hair paradigm
across DCCs. This phase delivers sovereign curves-based hair as a first-class
geometry type with grooming brushes, simulation, and shading integration (Phase
154 / Phase 138).

Sovereign replacement for Blender Curves Hair (4.x), Autodesk Maya XGen
Interactive, SideFX Houdini Grooming / KineFX hair, Ephere Ornatrix, Peregrine
Labs Yeti, Weta Barbershop, Groom for Unreal, HairStrand Designer, and Arnold
aiStandardHair / RenderMan PxrMarschnerHair.

---

### 155.1 @neith/hair-curve — Curve Primitive & Data Model

- [x] **155.1.1** Curve geometry object (control points + weights)
- [x] **155.1.2** Bezier / Catmull-Rom / B-Spline / Poly types
- [x] **155.1.3** Per-curve attribute (root, tip, id, tag)
- [x] **155.1.4** Per-point attribute (position, radius, tangent, colour)
- [x] **155.1.5** Curve-as-geometry first-class type in scene graph
- [x] **155.1.6** Curves live on surface (uv-based root anchor)
- [x] **155.1.7** Root detach / reattach operations
- [x] **155.1.8** Curve sets (layered groups)
- [x] **155.1.9** Instance from curve (feather, scales, leaves)
- [x] **155.1.10** Curve-level LOD (control-point decimation)
- [x] **155.1.11** Unlimited curve count (100M strand scenes)
- [x] **155.1.12** USD curves / Alembic / MDD interchange
      <!-- USD BasisCurves and MDD plus optional SDK-backed Ogawa ICurves/
                               OCurves in interchange/alembic.rs; the native roundtrip is exercised
                               against Unreal 5.5's Alembic 1.8.6 deployment -->
- [x] **155.1.13** FBX approximation exporter
      <!-- sovereign FBX 7.4 ASCII NurbsCurve exporter in interchange/fbx.rs;
                               the FBX SDK is only needed for binary .fbx / verified re-import -->
- [x] **155.1.14** Hair .abc spec compatible with Arnold / RenderMan
      <!-- standard OCurves positions/counts, basis, wrap, vertex widths and
                               uniform identity parameters, verified with the Alembic C++ reader -->
- [x] **155.1.15** Per-frame deform caching

---

### 155.2 @neith/hair-groom — Grooming Brushes & Tools

- [x] **155.2.1** Add / remove strand brush
- [x] **155.2.2** Comb / direction brush
- [x] **155.2.3** Length (grow / trim) brush
- [x] **155.2.4** Density dial brush
- [x] **155.2.5** Clump brush with soft-core
- [x] **155.2.6** Smoothing brush
- [x] **155.2.7** Puff (root lift) brush
- [x] **155.2.8** Frizz / noise brush
- [x] **155.2.9** Part line brush (scalp parting)
- [x] **155.2.10** Curl brush with radius + frequency
- [x] **155.2.11** Twist brush
- [x] **155.2.12** Pose mode brush (sculpt while posed)
- [x] **155.2.13** Mask layer brush
- [x] **155.2.14** Snap-to-surface brush
- [x] **155.2.15** Mirror across symmetry plane

---

### 155.3 @neith/hair-nodes — Geometry-Node Graph for Curves

- [x] **155.3.1** Generate curves from surface (face density)
- [x] **155.3.2** Generate from density map
- [x] **155.3.3** Interpolate guide → dense
- [x] **155.3.4** Trim curves
- [x] **155.3.5** Resample curves to N points
- [x] **155.3.6** Bend to face normal
- [x] **155.3.7** Set radius by random / attribute / length
- [x] **155.3.8** Noise offset (turbulence along curve)
- [x] **155.3.9** Curl primitive (helical)
- [x] **155.3.10** Clump to N nearest guides
- [x] **155.3.11** Braid generator (N plaits)
- [x] **155.3.12** Frizz at root / mid / tip blend
- [x] **155.3.13** Convert mesh-ribbon → curve strand
- [x] **155.3.14** Hair-cap stitch (connect strand groups)
- [x] **155.3.15** Transfer attribute from mesh to root
- [x] **155.3.16** Stamp / scatter instance on curve
- [x] **155.3.17** Split curves at collision
- [x] **155.3.18** Curve-bevel for stylised ribbon hair
- [x] **155.3.19** Coarse / fine LOD switcher
- [x] **155.3.20** Node group presets (afro, straight, curly, feather, fur)

---

### 155.4 @neith/hair-guide — Guide Curves & Interpolation

- [x] **155.4.1** Guide curve mode (authored strands)
- [x] **155.4.2** Guide weight painting
- [x] **155.4.3** Blend N nearest guides
- [x] **155.4.4** Radial basis function interpolation
- [x] **155.4.5** UV-aware interpolation
- [x] **155.4.6** Feather symmetry (left / right mirror group)
- [x] **155.4.7** Drag-along-guides (move all dense curves with guide)
- [x] **155.4.8** Guide priority (layered grooms)
- [x] **155.4.9** Guide blending across animation frames
- [x] **155.4.10** Guide sculpt tools inherited from 155.2

---

### 155.5 @neith/hair-sim — Simulation & Dynamics

- [x] **155.5.1** Cosserat rod / Discrete Elastic Rod model
- [x] **155.5.2** Position-based dynamics (PBD) strand
- [x] **155.5.3** Fast-Projection for stiff hair
- [x] **155.5.4** Bending / twisting / stretching stiffness
- [x] **155.5.5** Strand-strand self-collision (hash grid)
- [x] **155.5.6** Strand-mesh collision (body)
- [x] **155.5.7** Wind + turbulence forces
- [x] **155.5.8** Wet hair (clumping, mass increase)
- [x] **155.5.9** Material presets (thin / thick / kinky / straight)
- [x] **155.5.10** Simulation LOD (only every Nth strand)
- [x] **155.5.11** GPU solver (CUDA / HIP / Metal / WebGPU)
      <!-- canonical WGSL compute pipeline with validated ABI/dispatch plan;
                               WebGPU cross-compiles it to Vulkan/Metal/HLSL and the backend trait
                               exposes the same packed buffers to native CUDA/HIP implementations -->
- [x] **155.5.12** Multi-frame cache (bake + scrub)
- [x] **155.5.13** Bake direction reverse (inverse dynamics)
- [x] **155.5.14** Attached-prop collision (hat, hood)
- [x] **155.5.15** Animation-rig driven root deformation

---

### 155.6 @neith/hair-shade — Shading Integration

- [x] **155.6.1** Marschner hair BSDF
- [x] **155.6.2** Chiang hair (Disney) BSDF
- [x] **155.6.3** Kajiya-Kay for stylised
- [x] **155.6.4** Melanin concentration + redness
- [x] **155.6.5** Root-to-tip colour gradient
- [x] **155.6.6** Per-strand colour noise
- [x] **155.6.7** UV parametric texture along strand
- [x] **155.6.8** Dirt / dye map
- [x] **155.6.9** Strand orientation AOV
- [x] **155.6.10** Strand-id Cryptomatte
- [x] **155.6.11** Viewport preview (Phase 154 EEVEE-class)
      <!-- non-destructive density/mode preview integrated with raster-hair -->
- [x] **155.6.12** Path-tracer integration (Phase 138)
      <!-- native curve primitives, analytic intersection and Marschner/Chiang evaluation -->
- [x] **155.6.13** LOD-aware shading (billboard at distance)
- [x] **155.6.14** Dual-scattering approximation
- [x] **155.6.15** Real-time engine (Phase 42) strand shader
      <!-- phase-42 GPU material/substrate/slab integration with hair flags and indirect draw -->

---

### 155.7 @neith/hair-render — Rendering & LOD

- [x] **155.7.1** GPU strand rasteriser (tube + ribbon)
      <!-- exact CurveSet ingestion to indexed tube/ribbon geometry, GPU upload packet,
                               render-graph depth/color passes and stable strand IDs -->
- [x] **155.7.2** Ray-trace strand intersection
- [x] **155.7.3** Order-independent transparency (OIT)
- [x] **155.7.4** Alpha-tested opaque mode (for shadows)
- [x] **155.7.5** Distance-LOD (strand → clump → card)
- [x] **155.7.6** Auto hair-card bake for game engines
- [x] **155.7.7** Billboard hair for backgrounds
- [x] **155.7.8** Motion-blur strand
- [x] **155.7.9** Shadow-only cheap pass
- [x] **155.7.10** Procedural LOD cross-fade

---

### 155.8 @neith/hair-presets — Groom Preset Library

- [x] **155.8.1** Realistic human hair (70+ presets)
- [x] **155.8.2** Realistic animal fur (50+)
- [x] **155.8.3** Feathers (birds, dino)
- [x] **155.8.4** Scales / reptile
- [x] **155.8.5** Mossy / botanical fur
- [x] **155.8.6** Stylised / cartoon / anime hair
- [x] **155.8.7** Historical wigs
- [x] **155.8.8** Afro / textured coils (4A/4B/4C etc., diverse library)
- [x] **155.8.9** Beards & moustaches
- [x] **155.8.10** Braid / cornrow / locs preset
- [x] **155.8.11** Fantasy (elf / orc / troll)
- [x] **155.8.12** Hair accessories (band, clip, scrunchie meshes)
- [x] **155.8.13** Preset download + share (Phase 138.11 asset library)
      <!-- content-addressed versioned envelopes, asset records and resumable
                               BLAKE3-verified out-of-order download chunks -->
- [x] **155.8.14** Rights-cleared source attribution
- [x] **155.8.15** Community contribution workflow
      <!-- marketplace lifecycle with independent review plus technical,
                               rights and cultural-context moderation gates -->

---

### 155.9 @neith/hair-anim — Animation & Rigging

- [x] **155.9.1** Rest-pose vs dynamic-pose modes
- [x] **155.9.2** Bake simulation → animation
- [x] **155.9.3** Keyframe hair shape
- [x] **155.9.4** Blendshape between grooms
- [x] **155.9.5** Motion-vector computation for post
- [x] **155.9.6** Control-curve drives multiple strands
- [x] **155.9.7** Lattice / mesh deform of groom
- [x] **155.9.8** Wind anim driver
- [x] **155.9.9** Hair-layer blend per frame
- [x] **155.9.10** Corrective shape after sim

---

### 155.10 @neith/hair-transfer — Cross-Mesh Transfer

- [x] **155.10.1** Transfer groom to new mesh (UV projection)
- [x] **155.10.2** Transfer with auto-scale
- [x] **155.10.3** Cross-topology transfer (non-matching UV)
- [x] **155.10.4** Retopology compat (preserve groom after retopo)
- [x] **155.10.5** Morph-target resync
- [x] **155.10.6** Groom-pack bundle (mesh + curves + attrs)
- [x] **155.10.7** Fit-check tools (hair-scalp penetration)
- [ ] **155.10.8** AI-assist ("give me a similar groom on a new head") — the
      deterministic transfer primitive is provided. The AI-assist is a learned
      model; needs an owner decision on a compute and data budget to train it
      (stated 2026-09-18). `blocked:governance`
- [x] **155.10.9** Cross-character rig retarget groom
- [x] **155.10.10** Part-line relocation algorithm

---

### 155.11 Testing & Validation

- [ ] **155.11.1** 1M-strand realtime viewport edit: measure on the Mac's GPU (a
      real target GPU; GPU convention). (Blocker made visible 2026-09-18: the
      prior HTML comment said this needs a target-GPU performance run.) Verify:
      an interactive edit of a 1M-strand groom on the Mac records the per-edit
      viewport frame time, targeting realtime (≤ 33 ms), with the achieved time
      recorded and a regression guard.
- [ ] **155.11.2** 100M-strand offline render — needs a target-hardware
      performance run. 100M strands is memory-bound well beyond the 16 GB
      MacBook Air and the GPU-less Linux server; it needs a high-memory GPU
      workstation the fleet lacks (stated 2026-09-18). `blocked:hardware`
- [x] **155.11.3** Simulation stability at 24 FPS deterministic
- [x] **155.11.4** USD curves roundtrip conformance
      <!-- interchange/usd.rs export→import is lossless (positions/ids/order/
                               attrs/layers exact, width⇄radius is an exact ×2 scale); verified by
                               roundtrip_is_lossless + all_bases_and_periodic_wrap_roundtrip -->

- [x] **155.11.5** Alembic curves roundtrip
      <!-- mixed bases, widths, IDs, ordering, attributes and layers roundtrip
                               through Alembic 1.8.6 OCurves -> ICurves -->
- [ ] **155.11.6** Marschner / Chiang BSDF visual validation: validate the hair
      BSDF against the analytic Marschner and Chiang reference models from the
      published papers (not against Arnold, which is licensed). (Blocker made
      visible 2026-09-18.) Verify: a spec evaluates the BSDF over a set of
      incidence/azimuth angles and asserts it matches the analytic Marschner
      R/TT/TRT lobe energies and the Chiang model within a stated tolerance, and
      renders a reference-angle image matching a golden.
- [x] **155.11.7** Groom transfer across 100-head test set
- [x] **155.11.8** Diverse afro / coily texture fidelity tests
- [ ] **155.11.9** Real-time engine (Phase 42) integration at 60 FPS with 200k
      strands: the phase-42 strand shader exists; measure it on the Mac's GPU in
      a Maya-engine scene. Verify: a 200k-strand groom renders in a Maya-engine
      scene on the Mac recording ≤ 16.6 ms/frame, or the achieved frame time is
      recorded as the baseline with a regression guard.
- [x] **155.11.10** Phase 162 MetaHuman-class groom interop
      <!-- attached groom binds into authored scalp tangent frames and reconstructs
                               every point after deformation while preserving IDs/basis/radii/attrs -->
