Synclave — Encrypted Multi-Node Backup, Sync & Agent Mesh

Şifreli, non-destructive, versiyonlu çok-makine senkron + restic yedek + A2A ajan mesh motoru. Hermes / OpenClaw / bağımsız ajan ağları için. Çekirdek MIT, kurumsal katman ayrı lisanslı.

Önceki adı hermes-sync (v2.3.1) → rebrand Synclave (v2.4.0).

Ne yapar?

Güvenlik

• Kimlik: her runtime kendi Ed25519 kimliğini üretir; agent_id = pubkey özeti (hx- / oc-), donanım parmak izine bağlı. Klon şüphesi → mesh 403 (fail-closed). Meşru taşıma rekey --confirm.
• Uçtan uca şifre: X25519 ECDH + AES-GCM (her mesaj ephemeral → PFS) + Ed25519 imza + ts/nonce replay koruması.
• Secret tarama: .env/*.key/id_rsa + sk-/cr_/ghp_ prefix'leri içeren config/dosyalar manifest'e asla girmez (ad + içerik katmanı).
• Path traversal koruması: 3 katman (_safe_target, _is_safe_path, _safe_tar_member) — ../, mutlak yol, Windows sürücü harfi yasak.
• Rate limiting: 429 (120 req/60s), brute-force koruması.
• Concurrency: flock kilit — üst üste mutating koşu reddedilir (exit 0, 'ATLANDI').

Kurulum

pip install synclave==2.4.0          # PyPI
# veya kaynaktan
git clone https://github.com/yolgezerahmet/synclave && cd synclave && pip install -e .

synclave status                      # durum (JSON: synclave status --json)
synclave both --skip-unchanged       # tam eşitleme
synclave mesh status                 # makineleri gör
synclave backup                      # restic yedek
synclave memory export               # ortak hafıza

Hızlı başlangıç (yeni makine)

synclave init                        # ilk config
synclave add-node <ad> --path <dizin> --include "*" --max-kb 1024
synclave both                        # ilk eşitleme

Hermes entegrasyonu (tam eklenti)

Synclave artık Hermes Agent'a 3 kanaldan bağlı:

1. MCP (config.yaml → mcp_servers.synclave): 8 tool — sync_status, sync_push, sync_pull, sync_both, mesh_status, agent_status, sync_conflicts, backup_now.
2. Plugin (plugins/synclave_sync): synclave_status(), synclave_both(), synclave_mesh(), synclave_backup(), synclave_conflicts().
3. Skill (synclave): iş kuralları + sorun giderme rehberi.

Hermes ajanına "sync yap" / "mesh durumu göster" demeniz yeterli.

Karşılaştırma

Sürüm geçmişi

• v2.4.0 (9 Eyl 2026): Hermes MCP + plugin + skill (tam eklenti); --json çıktı; UTC zaman standardı; sync_events.log olay akışı; hash önbelleği; secret tarama gerçek-bug fix'leri (.env.* + config.yaml içerik).
• v2.3 (30 Ağu): kriptografik kimlik + şifreli mesh + sohbet köprüsü.
• v2.1 (29 Ağu): ajan mesh + restic + 3 katmanlı akıllı kanal.

Kurumsal katman (ayrı lisans)

Çekirdek motor MIT. Kurumsal destek (SLA, öncelikli düzeltme, özel transport adaptörleri, SSO/audit log) support@cumulusnet.io üzerinden ayrıca lisanslanır.

Windows

# 1) Python 3.10+ (PATH'e ekle) + git
pip install synclave
synclave init --machine H2
synclave both

Detaylı kurulum: docs/windows.md (yakında).

Lisans

Core: MIT. Enterprise: ayrı sözleşme — support@cumulusnet.io.