Fensalir/docs/README.md
Meta Vens d755d9c5e0 Remove dead Saga library, obsolete AquaSynth alpha packages, closed scratch note
REC-109 / REC-019 dead-code subtraction pass on Fensalir.

Deleted, all re-verified fresh against origin/main (dc35ecc) and against
every other repo under F:/Projects, not just Fensalir:

- src/Saga/ (SagaOrgan.cs, Saga.csproj, README.md) and its Fensalir.sln
  project entry (GUID 30324495-56BE-4D45-80E8-CE03C24726C8, including its
  ProjectConfigurationPlatforms and NestedProjects lines). `rg -n
  'SagaOrgan|SagaFlowRequest|SagaCoriolisFrame|SagaForcingSource|
  SagaAdvectionSample|SagaCovariance2D' --glob '!src/Saga/SagaOrgan.cs' .`
  found zero consumers inside Fensalir; the same pattern run across the rest
  of F:/Projects (excluding Fensalir and this census doc) found only the
  census's own prose, no other repo referencing these symbols.

- packages/AquaSynth.Core.0.1.0-alpha.2.nupkg,
  packages/AquaSynth.Faust.0.1.0-alpha.2.nupkg,
  packages/AquaSynth.Faust.0.1.0-alpha.3.nupkg. Confirmed
  src/Aquarium.Engine/Aquarium.Engine.csproj:15 references only
  AquaSynth.Faust 0.1.0-alpha.4, whose nuspec pins Core alpha.3 (both kept).
  Verified by building Aquarium.Engine.csproj (with -p:CultLibRoot pointed
  at the sibling CultLib checkout, since the CultMath project reference is
  otherwise only resolvable from Fensalir's normal on-disk location next to
  CultLib) against the trimmed packages/ feed: restore and build succeeded,
  proving alpha.4/alpha.3 satisfy the manifest with the three obsolete
  files gone.

- state/scratch-fractal-surface-visible.md. `rg -n -F
  'scratch-fractal-surface-visible.md' .` found zero references inside
  Fensalir; the one repo-wide hit (gamecult-site's generated
  repo-doc-tree/fensalir.json) is a static catalog listing, not a code or
  build consumer. Content read in full: a closed "Kept/Changed/Still not
  good enough" retrospective note, not an open TODO, with no admission path
  into any durable doc.

Verification: dotnet build succeeded post-deletion for
Aquarium.Engine.Contracts, Aquarium.Engine (exercises the trimmed AquaSynth
package feed and the CultMath sibling reference), Aquarium.Engine.Fractal,
and Aquarium.Engine.Fractal.Tests (which also restores Aquarium.Zyphos and
Aquarium.Fensalir). `dotnet restore Fensalir.sln` itself fails in this
worktree because CultMath is a relative sibling-path reference
(../../../CultLib) that does not exist next to a temp worktree — a
pre-existing property of the manifest, not something this change caused;
per-project builds above cover the touched surfaces instead.

Not touched, out of scope for this pass: the inert render-graph
pass/camera/debug-view surface, Clear() no-ops, GetResource/GetRenderTarget
— all flagged in the same census section but requiring broader review.

Collision check: primary checkout (codex/cultmath-monorepo) has zero diff
against origin/main on every touched path. Executed in worktree
claude/dross-2026-09-13 off origin/main, not the primary checkout.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-13 14:38:54 +02:00

54 lines
2.7 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
- `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/`.