docs: v1.3.0 raft-supported docs, limitations, runbook updates

This commit is contained in:
2026-07-31 04:16:11 +03:00
parent ad90ebcd5e
commit d303cc5658
8 changed files with 910 additions and 25 deletions
@@ -1,9 +1,38 @@
# Raft Cluster Status — C3a / C3b / post-C3b
# Raft Cluster Status — C3a / C3b / post-C3b / v1.3.0
Date: 2026-07-30
Status: **Shipped on `main`** (tip includes metrics).
Status: **v1.3.0 — Supported** for the single-`default`-DB scope (see the v1.3.0 section below).
Branch: all work merged to `main` only (feature branch removed).
## v1.3.0 — raft-supported (2026-07-30)
Raft moves from Experimental to **Supported** for a 3-node cluster on the
`default` database. Landed on top of the C3a/C3b base:
- **Failover under load** — `tests/raft_failover_load_e2e_test.nim`: leader
killed under sustained writes; every acked write survives (client contract:
in-flight writes fail fast, retry).
- **Mandatory CI gate** — dedicated `raft-e2e` job runs all five raft e2e
suites; missing binary is a hard FAIL under CI.
- **Raft TLS** — `BARADB_RAFT_TLS_*` config, fail-closed startup, optional
mutual auth, TLS on follower→leader forwarding;
`tests/raft_tls_e2e_test.nim` (plaintext node excluded).
- **InstallSnapshot** — backward-compatible wire protocol, leader chunk send
(`BARADB_RAFT_SNAP_CHUNK_KB`, default 256), follower restore via
backup/restore, compaction unpinned from stale peers
(`BARADB_RAFT_PEER_STALE_MS`, default 30000);
`tests/raft_coldnode_e2e_test.nim` (returning + wiped node converge).
- **Fixes** — put/delete encoding (`deleted` flag), rejoin livelock (cached
peer sockets dropped on leadership), post-restore ctx repoint.
Resolved non-goals from the list below: raft-port TLS, InstallSnapshot with
full SM payload. Still open: multi-database raft, `CREATE`/`DROP DATABASE`
replication, membership changes, linearizable follower reads, rolling
upgrades (restart all nodes together).
Plan: `docs/superpowers/plans/2026-07-30-v1.3.0-raft-supported.md` ·
Design: `docs/superpowers/specs/2026-07-30-raft-supported-design.md`
## Phase map
| Phase | Spec / plan | Status | What landed |