GameCult/Fensalir
Watch
9
0
Fork
You've already forked Fensalir
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
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

2.7 KiB
Raw Permalink Blame History

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/.