project: name: Fensalir root: E:\Projects\Fensalir upstream: https://github.com/GameCult/Fensalir.git purpose: > Native C# runtime and renderer dependency for Aquarium-style clients. The engine owns Win32 hosting, D3D12 rendering, input, hot reload, debug UI, audio output, client contracts, fractal/field machinery, and engine demos. current_model: solution: Fensalir.sln host: implementation: src/Aquarium.Engine contracts: src/Aquarium.Engine.Contracts renderer: src/Aquarium.Engine/Render shaders: src/Aquarium.Engine/Render/Shaders assets: src/Aquarium.Engine/Assets scripts: scripts fractal: implementation: src/Aquarium.Engine.Fractal tests: tests/Aquarium.Engine.Fractal.Tests receipt_tool: tools/Aquarium.Fractal.Receipt demos: fensalir_splash: src/Aquarium.Fensalir minimal: src/Aquarium.Sample.Minimal zyphos: src/Aquarium.Zyphos external_clients: epiphany_aquarium: E:\Projects\Aquarium-Engine mimir: owns the sensor-fusion app/adapter surface formerly prototyped here dependencies: cult_math: E:\Projects\CultMath cult_lib: E:\Projects\CultLib aqua_synth_faust: repo-local NuGet package feed under packages invariants: - Fensalir owns reusable host, renderer, audio, reload, contracts, and engine mechanisms. - Fensalir is not a traditional rendering pipeline. It is a field/evidence machine: contributors emit bounded Form, Appearance, and Transport claims with identity, travel/depth, metadata, control, and reservoir-guide lanes. Treating a pass as "just drawing pixels" violates the engine invariant unless it is explicitly marked as a fallback/debug draw with no authority. - Client repos own policy, role names, narrative semantics, app state, and client shaders. - Epiphany Aquarium depends on Fensalir; Fensalir must not depend on Epiphany. - Demo projects inside this repo are allowed to exercise engine features but must not become hidden engine policy. - Public `Aquarium.*` assembly names remain for continuity until a deliberate namespace/package migration. - Spline/tube visibility is owned by shader SDF evaluation. CPU geometry may place conservative sampling envelopes and endpoint/neighbor packets, but quad-local strip UVs must not decide visible line coverage. - Reservoir splat rendering must not impose large minimum billboard radii on transparent buffer-field/tube samples. Sample envelopes should stay tied to authored field radius so clients can reduce reservoir sample count without turning sparse probes into visible plates. - Reservoir contents are not forced to be pixel-sized. Pixel-level resolve samples bounded claims; it does not define their native support. Broad, smooth surfaces may be represented by few large surface claims. Heightfield terrain should be a quadtree of brush-painted surface tiles, subdivided by projected footprint, curvature, brush/material detail, silhouettes, and temporal uncertainty before SDF probes emit detail-adaptive surface splats. - Rendering backends are lowerings, not truth owners. Heightfields, splines, direct SDF proxies, meshes, volumes, fractal probes, and Mimir sensor observations must publish bounded Form/Appearance/Transport field claims before they can participate in reusable field evidence. - Field packet payload handles are not authority. Resource-backed claims and packets must reference declared AquariumFieldResourceDeclaration rows with kind, GPU residency, shader access, format, shape, validity, version, and native handle metadata. Missing, CPU-only, or backend-incompatible resources defer lowering instead of becoming visible evidence. - Rendering-relevant field buffers move to GPU residency as early as possible and stay there. Fensalir must pass GPU resource handles/SRVs/UAVs between compute and render lowerings; CPU readback or CPU tessellation is a diagnostic-only escape hatch, not the live TubeField path. next_actions: - Keep origin pointed at https://github.com/GameCult/Fensalir.git. - Keep `dotnet build Fensalir.sln` green after the split. - Cut the rendering rebuild through explicit field-domain/field-claim contracts before adding another backend-specific visual path. - Extend the D3D12 field packet/resource resolver beyond its first structured/curve-buffer cut. Current contracts, DSL, and renderer registry can validate and plan resource-backed TubeField packets, import shared GPU structured buffers by handle, and allocate Fensalir-owned GPU-resident slots only when Fensalir is the producer. The TubeField DSL can now express a 2D rolling float buffer as Catmull-Rom XY tubes with modulo column addressing, amplitude power/normalization, radius, ramp texture path, and emission scale. Visible rendering is blocked on shader-side expansion and binding of those GPU-resident slots, not CPU conversion to spline vertices. - Move any remaining client-only Epiphany state found here back to `E:\Projects\Aquarium-Engine`. - Keep Mimir app/adapters out of this repo; Fensalir may expose generic sensor-fusion contracts only. - Package contracts/host deliberately before replacing sibling source references in client repos.