Architecture¶
Internal design notes. Not user-facing API documentation — for that, see Reference.
Pages¶
- Writer core — shared writer pipeline (
_writer_core). - Sharding — strategies (HASH / CEL / range / vector-CLUSTER / LSH / EXPLICIT).
- Routing —
SnapshotRouterand reader-side dispatch. - Manifest &
_CURRENT— two-phase publish. - Manifest stores — filesystem/S3 vs Postgres.
- Run registry — run lifecycle,
RunRecord, deferred cleanup. - Retry & cleanup —
shard_retry, framework retry stacking. - Adapters —
DbAdapterprotocol, factory contract. - Observability —
MetricsCollector,MetricEvent. - Error model — exception hierarchy.
- Optional imports — extras and lazy import patterns.
- SQLite B-tree sidecar —
shard.btreemetawriter-side artifact.