GameCult/CultLib
Watch
9
0
Fork
You've already forked CultLib
 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions
CultLib/docs/parked-features.md
Meta Vens b26c98f185 Note that CultManagedDocument is parked with SoA; state the page load rule 
The parked/cultcache-soa tag message says the managed document was deleted
separately. parked-features.md now supersedes that; the tag is unchanged.
The directory store gains its design statement and a comment that only
manifest-named pages are loaded.

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

1.8 KiB
Raw Permalink Blame History

Parked Features

A parked feature was built for a stated reason, has no consumer, and was removed from the tree. Its last working form lives at an annotated tag so it can be restored instead of reinvented.

CultCache SoA table

  • Tag: parked/cultcache-soa
  • Intent: ECS-style structure-of-arrays columns over cached documents, for hot-loop performance without giving up POCO document ergonomics.
  • Span at the tag: src/GameCult.Caching/CultManagedDocument.cs:133-414 (CultSoaTable<T>, CultSoaColumn<T>, CultCacheSoaStore, CultCacheSoaTypeTable, CultCacheSoaMember); CultCache.Soa<T>() and the _soa field with its upsert/remove hooks in CultCache.cs; the SoA tests in tests/GameCult.Caching.Tests/BackingStoreTests.cs and tests/GameCult.Mesh.Tests/CultMeshStreamingTests.cs.
  • Managed document: CultManagedDocument<T> (CultManagedDocument.cs:72-131 at the tag) with CultCache.Document<T> and CultNetDatabase.Document<T>, the reactive POCO handle added with the SoA storage in 5428870 "Make SoA cache-managed document storage". Same tag, same intent: the document stays a POCO while the cache owns its columnar storage.
  • Tag message correction: the parked/cultcache-soa tag message says CultManagedDocument<T> was "deleted separately, not parked". This note supersedes it: CultManagedDocument<T> is parked under the same tag and is restored alongside SoA. The tag itself is left as written.
  • Consumers when parked: none outside tests.
  • Restore: git show parked/cultcache-soa:src/GameCult.Caching/CultManagedDocument.cs, take the SoA types and CultManagedDocument<T>, restore both Document<T> openers from CultCache.cs and CultNetDatabase.cs at the tag, and re-hook a CultCacheSoaStore into the cache's single admission and eviction paths (Admit/Evict).