Стабилизация на storage слоя — 6 фази

Фаза 1: SSTable Integrity
- SSTable v3 формат с CRC32 footer (data/index/bloom CRC)
- Нов модул storage/crc32.nim (zero-dep, IEEE 802.3)
- verifySSTable() — проверка на magic, version, CRC
- loadSSTable strict mode — отхвърля корумпирани файлове
- newLSMTree логва [WARN] при corrupt SSTables

Фаза 2: baradb repair
- Нов модул tools/repair.nim
- Сканира SSTables, проверява CRC, премества битите в corrupt/
- WAL replay (CrashRecovery) за възстановяване на данни
- CLI: ./baradadb repair --data-dir=... [--dry-run]

Фаза 3: MANIFEST File
- Atomic write MANIFEST (tmp + rename)
- newLSMTree зарежда от MANIFEST, fallback към walkDir
- checkStorageConsistency() — orphan/missing detection
- flushUnsafe и compaction записват MANIFEST

Фаза 4: WAL Rotation & Incremental Backup
- WAL segment rotation при 64MB (wal_archive/wal.000NNN.log)
- maybeRotate() на всеки 1000 записа + при flush
- backup incremental — архивира MANIFEST + SSTables + WAL
- CRC verification на SSTables преди архивиране

Фаза 5: Online Consistent Backup
- checkpoint() — freeze memtable + flush + WAL rotate
- ./baradadb checkpoint — offline consistent snapshot
- backup --online — checkpoint + incremental backup

Фаза 6: SSTable Version Migration
- SSTable.fileVersion поле
- listLegacySSTables() — намира v1/v2 файлове
- migrateSSTable() — пренаписва към v3 (tmp + rename)
- ./baradadb migrate [--dry-run] — offline migration

Документация:
- Обновени docs/en/backup.md, docs/bg/backup.md
- Обновени docs/en/storage.md, docs/bg/storage.md
- Добавени тестове в tests/test_all.nim

docs/bg/storage.md

@@ -21,11 +21,105 @@ db.close()
 
 - **MemTable**: В-памет сортиран буфер
 - **WAL**: Write-ahead log за устойчивост
-- **SSTable**: Сортирани string таблици на диска
+- **SSTable**: Сортирани string таблици на диска (v3 с CRC footer)
 - **Bloom Filter**: Вероятностна проверка за принадлежност
 - **Compaction**: Size-tiered стратегия с управление на нива
+- **MANIFEST**: Атомичен каталог на активните SSTables
 - **Page Cache**: LRU кеш с проследяване на hit rate
 
+### SSTable Формат (v3)
+
+```
+[Header] 36 байта
+  magic:       uint32  (0x53535442 = "SSTB")
+  version:     uint32  (3 = текуща)
+  entryCount:  uint32
+  level:       uint32
+  indexOffset: uint64
+  bloomOffset: uint64
+  footerOffset: uint64
+
+[Data Block]
+  keyLen: uint32
+  key:    bytes[keyLen]
+  valueLen: uint32
+  value:  bytes[valueLen]
+  timestamp: uint64
+  deleted: uint8
+
+[Index Block]
+  keyLen: uint32
+  key:    bytes[keyLen]
+  dataOffset: uint64
+
+[Bloom Filter Block]
+  bloomSize: uint32
+  bloomData: bytes[bloomSize]
+
+[Footer] 16 байта
+  dataCrc32:  uint32  (CRC32 на Data Block)
+  indexCrc32: uint32  (CRC32 на Index Block)
+  bloomCrc32: uint32  (CRC32 на Bloom Block)
+  reserved:   uint32  (трябва да е 0)
+```
+
+CRC footer-ът позволява независима проверка на всеки SSTable файл чрез `verifySSTable(path)`.
+
+### MANIFEST Каталог
+
+Файлът `MANIFEST` проследява всички активни SSTables атомично:
+
+```json
+{
+  "version": 1,
+  "sequence": 42,
+  "createdAt": 1779103266,
+  "sstables": [
+    {"id": 1, "path": "sstables/1.sst", "level": 0, "minKey": "a", "maxKey": "z", "entryCount": 100}
+  ]
+}
+```
+
+- Записва се атомично чрез `MANIFEST.tmp` + rename
+- Чете се при стартиране за бързо зареждане
+- Обновява се след всеки flush и compaction
+
+### WAL Ротация
+
+Write-Ahead Log се ротира при достигане на 64MB:
+
+```
+wal/
+  ├── wal.log          (активен сегмент)
+  └── wal_archive/
+      ├── wal.000001.log
+      └── wal.000002.log
+```
+
+Ротацията се задейства:
+- На всеки 1000 записа (лека проверка)
+- При всеки `flush()` или `checkpoint()`
+
+### Storage Repair
+
+Проверка и ремонт на storage:
+
+```bash
+# Проверка на всички SSTables
+./build/baradadb repair --data-dir=./data --dry-run
+
+# Пълен ремонт
+./build/baradadb repair --data-dir=./data
+```
+
+### Миграция на SSTable Версии
+
+Пренаписване на legacy v1/v2 SSTables към v3:
+
+```bash
+./build/baradadb migrate --data-dir=./data
+```
+
 ## B-Tree Индекс
 
 Подреден индекс за range сканиране и точково търсене.
@@ -43,14 +137,14 @@ let range = btree.scan("key_a", "key_z")
 
 ## Write-Ahead Log (WAL)
 
-Осигурява устойчивост на операциите за запис.
+Осигурява устойчивост на операциите за запис със сегментна ротация.
 
 ```nim
 import barabadb/storage/wal
 
-var wal = newWAL("./wal")
-wal.append("txn1", "SET key1 value1")
-wal.flush()
+var wal = newWriteAheadLog("./wal")
+wal.writePut(key, value, timestamp)
+wal.sync()
 ```
 
 ## Bloom Filter
@@ -73,6 +167,6 @@ if filter.mightContain("key1"):
 ```nim
 import barabadb/storage/mmap
 
-var mapped = mmapFile("./data/file.dat")
-let data = mapped.read(0, 100)
+var mapped = openMmap("./data/file.dat")
+let val = mapped.readUint32(0)
 ```