What it does
The pipeline crate is a persisted, resumable stage machine: snapshot, tail, verify, shadow-read, cutover, complete and release. It needs an empty target, copies full content, replays the source's log tail, and re-verifies parity inside a write pause. It is a library; no route or command starts it.
How it works
Begin requires an empty target. The snapshot copies every source entity from a pinned root, one bounded page at a time, and restarts from scratch if interrupted. The tail then reads the source's public log range and applies each put and delete to the target, replaying transaction envelopes atomically and in order, and advances its mark past a record solely once all of that record's effects are applied.
Verify and shadow-read compare full content in both directions, exactly under concurrent writes, by pinning a source snapshot and applying the tail up to it. Cutover is supplied a write gate by the caller. It pauses writes, drains the tail, re-verifies parity against a snapshot pinned after the drain, rechecks the lag, and records completion with the target as authority. The pause is measured and reported as evidence.
No routing flip happens inside the crate: after cutover the source stays write-closed, the caller flips client routing and then releases the source. Before release, rollback reopens the source and restores source authority, and it refuses if the target accepted writes since cutover.
Where you reach it
- Library
kynetra_pipeline stage machine (engine library, not wired to the server)
Limits
- Not reachable from the server or the command line. For a move that works today, see the project migration entry.
- The caller supplies the write gate and the routing flip. The crate does neither.
Evidence
- TestsCovered in the engine repository by more than 40 tests for the stage machine and forged-ledger-row refusals
Test coverage is listed as present in the engine repository at this edition. This page does not report test results.
KynetraDB is in private preview
This is not available in the preview. Request a preview to discuss the current scope.