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 — SnapshotRouter and 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 — DbAdapter protocol, factory contract.
• Observability — MetricsCollector, MetricEvent.
• Error model — exception hierarchy.
• Optional imports — extras and lazy import patterns.
• SQLite B-tree sidecar — shard.btreemeta writer-side artifact.