Fensalir/docs/README.md
2026-07-12 19:39:33 +01:00

59 lines
3 KiB
Markdown

# Fensalir Docs
Start here if you are trying to understand the engine rather than a specific
historical branch scar.
## Core Runtime
- `engine-client-boundary.md`: what Fensalir owns versus what client repos own.
- `hlsl-renderer.md`: current D3D12/HLSL frame path.
- `vortice-spine.md`: native host and renderer spine.
- `cult-runtime-surface.md`: cache-path and typed-state boundary.
- `input.md`: input and camera contracts.
## Fields, Reservoirs, And Fractals
- `stateless-planetary-erosion-rendering-plan.md`: authority map and staged
implementation plan for spherical erosion, cube-sphere pages, LOD,
intersection, differential shading, and verification.
- `../src/Saga/README.md`: studio-facing Saga middleware pitch and subproject
overview for stochastic planetary flow.
- `papers/fensalir-pipeline.tex`: living MiKTeX paper for the Fensalir
pipeline, research spine, domain reservoir model, and evaluation plan.
- `papers/fensalir-native-domain-reservoirs.tex`: focused SIGGRAPH-shaped
draft around the single testable invariant that reusable mixed-field samples
must carry native-domain coordinates, support, and legal shift metadata.
- `perfect-fensalir-machine-roadmap.md`: implementation roadmap from the
focused native-domain reservoir proof through fractal hierarchy, residency,
sensor/flow organs, and learned priority.
- `perfect-machine-architecture.md`: end-to-end map for authored/sensor field
input, domain binding, evidence candidates, reservoir reuse, residency, and
renderer lowering.
- `rendering-teardown-rebuild-protocol.md`: current teardown/rebuild authority
map for collapsing renderer-era paths into one field-evidence machine.
- `temporal-spatial-evidence-reservoir.md`: stable-key temporal evidence cache
for fractal rendering, Mimir-style sensor fusion, direct SDF contributors,
and mesh-backed field evidence.
- `fractal-domain-reservoir.md`: Area ReSTIR/TSR reorientation for the Perfect
Machine reservoir as a domain-native evidence organ rather than a
screen-space texel cache.
- `temporal-sdf-gaussian-field.md`: temporal Form-field evidence lane.
- `tsr-inspired-taa-spec.md`: temporal resolve design and guide-buffer intent.
- `stochastic-transparent-surface-pipeline.md`: density/extinction and
transparent field rendering notes.
- `planetary-flow-organ.md`: architecture and ownership map for reusable
cube-sphere stochastic ocean/atmosphere flow fields.
- `planetary-flow-nn-architecture.md`: concrete neural-network parameter
budgets, layers, losses, training curriculum, and runtime export shape.
- `planetary-flow-implementation-plan.md`: staged execution plan for dataset
provenance, cube-sphere bakes, model training, and runtime integration.
## Migration And Demo Context
- `d3d12-best-practices-audit.md` and `d3d12-migration.md`: D3D12 migration and
audit notes.
- `zyphos-eusocial-sync.md`: Zyphos demo worldbuilding boundary.
Fractal DSL and rendering research starts in
`../research/rendering/fractal-brush-architecture-plan.md`. Persistent agent
state lives under `../state/`.