MVCC conflict analytics and observability infrastructure.
Provides shared types and utilities for conflict tracing, metrics aggregation, and diagnostic logging across the FrankenSQLite MVCC layer.
Design Principles
- Zero-cost when unused: All observation is opt-in via the
[
ConflictObserver] trait. When no observer is registered, conflict emission compiles to nothing (the default [NoOpObserver] is inlined). - Non-blocking: Observers MUST NOT acquire page locks or block writers. Conflict tracing is purely diagnostic.
- Shared foundation: Types defined here are reused by downstream observability beads (bd-t6sv2.2, .3, .5, .6, .8, .12).