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

docs/bg/known-limitations.md

@@ -1,4 +1,4 @@
-# Известни ограничения — v1.2.0 Production GA
+# Известни ограничения — v1.3.0
 
 | Ниво | Значение |
 |------|----------|
@@ -8,25 +8,33 @@
 
 ## Матрица
 
-| Област | GA (v1.2.0) | Experimental / по-късно |
-|--------|-------------|-------------------------|
+| Област | v1.3.0 | Experimental / по-късно |
+|--------|--------|-------------------------|
 | Single-node SQL + LSM | **Supported** | — |
 | Schema / FTS / HNSW / graphs persist | **Supported** | — |
 | Auth + JWT (когато е конфигуриран) | **Supported** | — |
 | Backup / restore | **Supported** | — |
 | Multi-DB (без Raft) | **Supported** | — |
-| Raft 3-node + SQL/DDL | **Experimental** | InstallSnapshot, membership |
+| Raft 3-node (само `default` DB) | **Supported** | failover под товар, TLS, InstallSnapshot — e2e |
 | Raft multi-DB | **Not supported** | само `default` |
+| `CREATE`/`DROP DATABASE` репликация | **Not supported** | per node |
+| Raft membership промени (join/leave) | **Not supported** | фиксиран `BARADB_RAFT_PEERS` |
 | Follower linearizable reads | **Not supported** | best-effort след apply |
+| Rolling upgrades | **Not supported** | рестарт на всички възли заедно — смесени v1.2/v1.3 binaries не трябва да работят в един клъстер |
 | ORC multi-thread shared LSM | **Not supported** | ARC по подразбиране |
 
 ## GA (single-node)
 
 Crash recovery с WAL, schema/index persist, `/health` + `/metrics`, offline backup/restore.
 
-## Raft
+## Raft (supported)
 
-Виж [distributed.md](distributed.md). Staging/ops, **не** v1.2.0 HA продукт.
+Виж [distributed.md](distributed.md). Поддържан обхват: 3-node, DML/DDL само върху `default`, failover под товар (acked writes оцеляват; in-flight writes → грешка, retry), raft TLS, cold-node recovery чрез InstallSnapshot.
+
+## Нови ограничения
+
+- **Legacy REP replication (без raft)** — пътят още извежда delete от празна стойност; insert в PK-only таблица се прилага грешно по него (редът изчезва). Използвай raft.
+- **Snapshot-restore ctx** — след InstallSnapshot restore HTTP endpoints със startup-captured ctx може да сервират стари данни до рестарт (`/query` е свеж per-request); съществуващите клиентски връзки виждат pre-restore състояние — reconnect след restore.
 
 ## Виж също