orion-ecs / keen-eye / 19994302530

65%

push

github

Implement archetype chunk pooling for large-scale entity support (Issue #90)

Phase 2 - Performance & Storage implementation:

Core Architecture:
- Add Archetype, ArchetypeChunk, and ArchetypeId for type-based entity storage
- Add ArchetypeManager for archetype lifecycle and entity location tracking
- Add ComponentArray with ArrayPool integration for cache-friendly storage
- Add ChunkPool for reusing archetype chunks across entity lifecycle
- Add EntityPool for entity ID recycling with version tracking
- Add QueryManager and QueryDescriptor for efficient query caching

Performance Features:
- Chunk-based storage with configurable size (default 256 entities/chunk)
- Memory pooling reduces GC pressure for 100k+ entities
- O(1) component access via archetype-based lookups
- Query result caching with automatic invalidation

New Samples & Benchmarks:
- MassSimulation sample demonstrating 100k+ entities
- ChunkPoolingBenchmarks for performance validation

Testing:
- Comprehensive test coverage for all new components
- Edge case tests for error paths and boundary conditions
- Internal API tests for framework internals

Documentation:
- Add code coverage requirements to CLAUDE.md
- Add test quality standards and naming conventions

806 of 824 new or added lines in 14 files covered. (97.82%)

1574 of 1608 relevant lines covered (97.89%)

0.98 hits per line