- Add frozen flag to separate data immutability from performance optimizations
- readOnly: prevents data mutations but allows index optimizations (default behavior)
- frozen: prevents ALL changes including statistics and index updates
- Smart default: frozen=false when readOnly=true for optimal performance
- Add comprehensive documentation for read-only and frozen modes
- Created docs/guides/readonly-frozen-modes.md with detailed guide
- Added examples for compliance, forensics, and testing use cases
- Updated all documentation indexes with new guide links
- Simplify README.md to emphasize unified API
- Clearer demonstration that same code works everywhere
- Simplified framework examples showing consistent API
- Better noun/verb examples for entities and relationships
- Collapsible sections for cloud platform examples
- Environment auto-detection table
- Add tests for frozen flag behavior
- Test readOnly without frozen (allows optimizations)
- Test frozen mode (complete immutability)
- Test dynamic mode switching
BREAKING CHANGE: readOnly behavior changed - now allows optimizations by default.
To get old behavior (complete immutability), use readOnly: true with frozen: true.