Skip to content

Latest commit

 

History

History
23 lines (18 loc) · 1.12 KB

AGENTS.md

File metadata and controls

23 lines (18 loc) · 1.12 KB

Library Domain Models

Parent scope: package runtime.

This scope owns exported dataclasses and allocator enums. It is separate from core/models.py service payloads and snapshot/base/entities.py replay objects.

File Contract
_enums.py Library event actions and block states
block.py MemoryBlock; negative IDs are historical; free_event_id of None or -1 is active
event.py MemoryEvent; negative IDs are virtual, nonnegative IDs are runtime events
__init__.py Public exports

Preserve sentinel meanings and optional-field defaults when changing models. Library snake_case attributes and SnapshotDB/query column spellings are different boundaries; do not rename one by assuming every consumer uses the same shape. Query ResultMapper conversions/model factories are in query/mapper.py.

From the repository root, run pytest tests/models tests/test_models.py for model/enum changes and pytest tests/query/test_mapper.py for mapping changes. Review __init__.py exports and both ResultMapper API guides when changing public construction or conversion behavior.