docs: comprehensive documentation update for v1.7.0

- Update CHANGELOG.md with detailed v1.7.0 release notes
  - Added WRAITH-Sync client details (delta sync, conflict resolution, 17 tests)
  - Updated test counts to 1,712 (was 1,695)
  - Updated code volume metrics (~18,000 lines in clients)
  - Version bump from 1.6.3 to 1.7.0
- Update README_Protocol-DEV.md with v1.7.0 status
  - Version badge updated to 1.7.0
  - Test coverage updated to include wraith-sync (17 tests)
  - Story points updated to 2,577 delivered
  - Added 5th client application reference
- Update README_Clients-DEV.md with v1.7.0 status
  - Added WRAITH-Sync to Tier 1 complete applications
  - Updated all version references from 1.6.3 to 1.7.0
  - Updated story points (860 SP delivered, 608 SP remaining)
  - Updated test coverage to 250 client tests
  - Added WRAITH-Sync feature details

Phase 17 v1.7.0 highlights:
- 5 production-ready client applications
- 1,712+ tests passing (100% pass rate)
- WRAITH-Sync: delta sync, conflict resolution, version history
- Full mobile protocol integration
- Voice/video calling with Opus/VP8/VP9
- Group messaging with Sender Keys protocol

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: doublegate

CHANGELOG.md

@@ -11,11 +11,20 @@ No unreleased changes yet.
 
 ---
 
-## [1.6.3] - 2026-01-21 - Phase 17 Complete: Full Mobile Integration & Real-Time Communications
+## [1.7.0] - 2026-01-21 - Phase 17 Complete: Full Mobile Integration, Real-Time Communications & WRAITH-Sync
 
-### Phase 17 - Mobile Protocol Integration, Push Notifications, Voice/Video Calling, Group Messaging
+### Phase 17 - Mobile Protocol Integration, Push Notifications, Voice/Video Calling, Group Messaging, WRAITH-Sync
 
-This release completes the mobile ecosystem by replacing placeholder implementations with actual WRAITH protocol bindings, adding secure native storage, push notifications, encrypted voice/video calling, and efficient group messaging using the Sender Keys protocol.
+This major release completes the mobile ecosystem by replacing placeholder implementations with actual WRAITH protocol bindings, adding secure native storage, push notifications, encrypted voice/video calling, efficient group messaging using the Sender Keys protocol, and introduces WRAITH-Sync for desktop file synchronization.
+
+### Highlights
+
+- **5 Production-Ready Client Applications**: Transfer, Chat, Android, iOS, Sync
+- **1,695+ Tests Passing**: 100% pass rate across all crates and clients
+- **Full Mobile Protocol Integration**: Android JNI and iOS UniFFI with actual WRAITH protocol
+- **Voice/Video Calling**: Opus/VP8/VP9 codecs with noise suppression and echo cancellation
+- **Group Messaging**: Sender Keys protocol for O(1) encryption efficiency
+- **WRAITH-Sync**: Desktop file synchronization with delta sync and conflict resolution
 
 ### Added
 
@@ -145,24 +154,52 @@ This release completes the mobile ecosystem by replacing placeholder implementat
   - Group messaging across platforms
   - 130 new interoperability tests
 
+#### WRAITH-Sync Client (17 new tests)
+- **Desktop File Synchronization Application (Tauri 2.0 + React 18):**
+  - Delta synchronization with rsync-style rolling checksums
+  - Conflict resolution strategies (LastWriterWins, KeepBoth, Manual)
+  - Version history with configurable retention (30 days default, 10 versions)
+  - SQLite metadata database for file tracking
+  - File system watcher with debounced events
+  - Glob pattern support for include/exclude rules
+- **Rust Backend (~4,400 lines):**
+  - delta.rs: Rolling checksum algorithm with BLAKE3 strong hashing
+  - sync_engine.rs: Core sync logic with conflict detection
+  - database.rs: SQLite persistence for metadata and history
+  - watcher.rs: Cross-platform file system monitoring
+  - commands.rs: 8 Tauri IPC commands
+- **React Frontend (~2,100 lines):**
+  - Zustand stores for sync state management
+  - Folder configuration UI with add/remove
+  - Sync status display with progress indicators
+  - Conflict resolution dialog
+- **IPC Commands:**
+  - add_sync_folder, remove_sync_folder, list_sync_folders
+  - start_sync, stop_sync, get_sync_status
+  - resolve_conflict, get_file_history
+
 ### Changed
-- Updated all crate versions to 1.6.3
+- Updated all crate versions to 1.7.0
 - Android client expanded from ~2,800 to ~3,800 lines (96 tests)
 - iOS client expanded from ~1,650 to ~2,650 lines (93 tests)
 - WRAITH-Chat expanded from ~2,650 to ~5,200 lines (49 IPC commands, 38 tests)
-- Total client application code: ~11,650 lines (was ~7,100)
-- Total tests: 1,695 passing (was ~1,630)
+- Added WRAITH-Sync client: ~6,500 lines (4,400 Rust, 2,100 TypeScript)
+- Total client application code: ~18,150 lines (was ~11,650)
+- Total tests: 1,712 passing (was 1,695)
+- 5 production-ready client applications (was 4)
 - Dependencies increased to 295 audited packages
 
 ### Technical Details
-- **Test Count**: 1,695 tests passing (16 ignored) - 100% pass rate
-- **Code Volume**: ~68,000 lines of Rust + ~12,000 lines in clients
+- **Test Count**: 1,712 tests passing (16 ignored) - 100% pass rate
+- **Code Volume**: ~68,000 lines of Rust + ~18,000 lines in clients
 - **New Dependencies**:
   - opus (Opus codec bindings)
   - rnnoise (RNNoise noise suppression)
   - vpx-sys (VP8/VP9 codec bindings)
   - firebase-admin (FCM integration)
   - apns2 (APNs integration)
+  - notify (File system watching)
+  - globset (Glob pattern matching)
 - **Zero clippy warnings** with -D warnings flag
 - **All quality gates passing** (fmt, clippy, test)
 - **Technical debt ratio**: 3.5% (reduced from 3.8%)
@@ -172,6 +209,7 @@ This release completes the mobile ecosystem by replacing placeholder implementat
 - Keystore/Keychain integration requires device security (PIN/biometric)
 - Voice/video calling requires microphone/camera permissions
 - Push notifications require FCM/APNs configuration
+- WRAITH-Sync requires SQLite for metadata storage
 
 ---
 

docs/archive/README_Clients-DEV.md

@@ -1,12 +1,12 @@
 # WRAITH Protocol - Client Applications Development History
 
-**Development Timeline:** Phase 15-17 (2026-01-21) - 4 Client Applications Complete with Full Integration
+**Development Timeline:** Phase 15-17 (2026-01-21) - 5 Client Applications Complete with Full Integration
 
-This document tracks the development journey of WRAITH Protocol client applications, from planning through implementation and release. Phase 15 delivered WRAITH-Transfer desktop application, Phase 16 delivered Android/iOS mobile clients plus WRAITH-Chat E2EE messaging, and Phase 17 completes the mobile ecosystem with full protocol integration, voice/video calling, and group messaging.
+This document tracks the development journey of WRAITH Protocol client applications, from planning through implementation and release. Phase 15 delivered WRAITH-Transfer desktop application, Phase 16 delivered Android/iOS mobile clients plus WRAITH-Chat E2EE messaging, and Phase 17 completes the mobile ecosystem with full protocol integration, voice/video calling, group messaging, and WRAITH-Sync for file synchronization.
 
-[![Version](https://img.shields.io/badge/clients-4%20complete-green.svg)](https://github.com/doublegate/WRAITH-Protocol/releases)
-[![Protocol](https://img.shields.io/badge/protocol-v1.6.3-blue.svg)](../../README.md)
-[![Clients](https://img.shields.io/badge/clients-6%20planned-orange.svg)](../../to-dos/ROADMAP-clients.md)
+[![Version](https://img.shields.io/badge/clients-5%20complete-green.svg)](https://github.com/doublegate/WRAITH-Protocol/releases)
+[![Protocol](https://img.shields.io/badge/protocol-v1.7.0-blue.svg)](../../README.md)
+[![Clients](https://img.shields.io/badge/clients-5%20planned-orange.svg)](../../to-dos/ROADMAP-clients.md)
 
 ---
 
@@ -23,50 +23,52 @@ For protocol development history, see [README_Protocol-DEV.md](README_Protocol-D
 
 **Total Development Scope:**
 - **10 Client Applications** (8 standard + 2 security testing)
-- **1,468 Story Points** total (724 SP delivered + 744 SP remaining)
-- **~40 weeks remaining** (parallel development across tiers)
+- **1,468 Story Points** total (860 SP delivered + 608 SP remaining)
+- **~32 weeks remaining** (parallel development across tiers)
 - **26 development phases** across all clients
 
 **Development Strategy:**
-- **Tier 1:** High-priority core applications (Transfer ✅, Android ✅, iOS ✅, Chat ✅ Complete with full integration)
-- **Tier 2:** Specialized productivity tools (Sync, Share)
+- **Tier 1:** High-priority core applications (Transfer ✅, Android ✅, iOS ✅, Chat ✅, Sync ✅ Complete with full integration)
+- **Tier 2:** Specialized productivity tools (Share)
 - **Tier 3:** Advanced use cases (Stream, Mesh, Publish, Vault)
 - **Security Testing:** Authorized assessment tools (Recon, RedOps)
 
 **Current Status (2026-01-21):**
-- Protocol v1.6.3 complete (all prerequisites available)
-- **Phase 15 - WRAITH-Transfer v1.6.3:** ✅ **COMPLETE** (102 SP)
+- Protocol v1.7.0 complete (all prerequisites available)
+- **Phase 15 - WRAITH-Transfer v1.7.0:** ✅ **COMPLETE** (102 SP)
   - Cross-platform desktop P2P file transfer
   - Tauri 2.0 + React 18 + TypeScript
   - 62 frontend tests with Vitest (100% pass rate)
 - **Phase 16 - Mobile & Chat v1.6.0:** ✅ **COMPLETE** (302 SP)
   - **WRAITH-Android:** Native Kotlin + Jetpack Compose (~60 SP)
   - **WRAITH-iOS:** Native Swift + SwiftUI (~60 SP)
   - **WRAITH-Chat:** E2EE messaging with Double Ratchet (182 SP)
-- **Phase 17 - Full Mobile Integration & Real-Time Comms:** ✅ **COMPLETE** (320 SP)
+- **Phase 17 - Full Mobile Integration & Real-Time Comms + Sync:** ✅ **COMPLETE** (456 SP)
   - **Mobile Protocol Integration:** Android JNI and iOS UniFFI with actual WRAITH protocol
   - **Mobile Secure Storage:** Android Keystore and iOS Keychain integration
   - **Mobile Discovery:** DHT and NAT traversal for mobile networks
   - **Push Notifications:** FCM (Android) and APNs (iOS)
   - **Voice Calling:** Opus codec, RNNoise noise suppression, echo cancellation
   - **Video Calling:** VP8/VP9 codecs, adaptive bitrate
   - **Group Messaging:** Sender Keys protocol for O(1) encryption
-- **Development Status:** 4 of 10 Tier 1 clients complete (724 SP delivered, 744 SP remaining)
+  - **WRAITH-Sync:** Desktop file synchronization with delta sync (136 SP)
+- **Development Status:** 5 of 10 clients complete (860 SP delivered, 608 SP remaining)
 - **CI/CD:** GitHub Actions updated (upload-artifact v6, download-artifact v7, cache v5)
-- **Test Coverage:** 233 client tests (6 transfer + 96 android + 93 ios + 38 chat)
+- **Test Coverage:** 250 client tests (6 transfer + 96 android + 93 ios + 38 chat + 17 sync)
 
 ---
 
 ## Client Applications Overview
 
-### Tier 1: Core Applications (High Priority - 724 SP)
+### Tier 1: Core Applications (High Priority - 860 SP)
 
 | # | Client | Description | Platform | Story Points | Status |
 |---|--------|-------------|----------|--------------|--------|
-| 1 | **WRAITH-Transfer** | Direct P2P file transfer with drag-and-drop GUI | Desktop (Linux/macOS/Windows) | 102 | ✅ **Complete (v1.6.3)** |
-| 2 | **WRAITH-Android** | Native Android mobile client with full protocol integration | Android 8.0+ | ~135 | ✅ **Complete (v1.6.3)** |
-| 3 | **WRAITH-iOS** | Native iOS mobile client with full protocol integration | iOS 16.0+ | ~130 | ✅ **Complete (v1.6.3)** |
-| 4 | **WRAITH-Chat** | E2EE messaging with voice/video calling and group messaging | Desktop | 357 | ✅ **Complete (v1.6.3)** |
+| 1 | **WRAITH-Transfer** | Direct P2P file transfer with drag-and-drop GUI | Desktop (Linux/macOS/Windows) | 102 | ✅ **Complete (v1.7.0)** |
+| 2 | **WRAITH-Android** | Native Android mobile client with full protocol integration | Android 8.0+ | ~135 | ✅ **Complete (v1.7.0)** |
+| 3 | **WRAITH-iOS** | Native iOS mobile client with full protocol integration | iOS 16.0+ | ~130 | ✅ **Complete (v1.7.0)** |
+| 4 | **WRAITH-Chat** | E2EE messaging with voice/video calling and group messaging | Desktop | 357 | ✅ **Complete (v1.7.0)** |
+| 5 | **WRAITH-Sync** | Desktop file synchronization with delta sync and conflict resolution | Desktop (Linux/macOS/Windows) | 136 | ✅ **Complete (v1.7.0)** |
 
 **WRAITH Transfer Delivered (2025-12-11):**
 - Tauri 2.0 desktop application with full wraith-core integration
@@ -80,7 +82,7 @@ For protocol development history, see [README_Protocol-DEV.md](README_Protocol-D
 - v1.5.8: Wayland compatibility fix (resolves KDE Plasma 6 crashes)
 - v1.5.9: Tauri 2.0 capability-based permissions (dialog, fs, shell plugins working)
 
-**WRAITH-Android (v1.6.3) - Full Protocol Integration:**
+**WRAITH-Android (v1.7.0) - Full Protocol Integration:**
 - Native Android with Kotlin + Jetpack Compose (Material Design 3)
 - Full WRAITH protocol integration via JNI bindings (replacing placeholders)
 - Android Keystore for hardware-backed secure key storage
@@ -90,7 +92,7 @@ For protocol development history, see [README_Protocol-DEV.md](README_Protocol-D
 - ~3,800 lines (1,200 Rust, 2,400 Kotlin, 200 Gradle)
 - 96 tests covering protocol integration, Keystore, and FCM
 
-**WRAITH-iOS (v1.6.3) - Full Protocol Integration:**
+**WRAITH-iOS (v1.7.0) - Full Protocol Integration:**
 - Native iOS with Swift + SwiftUI (iOS 16.0+)
 - Full WRAITH protocol integration via UniFFI bindings (replacing placeholders)
 - iOS Keychain for Secure Enclave key storage
@@ -100,7 +102,7 @@ For protocol development history, see [README_Protocol-DEV.md](README_Protocol-D
 - ~2,650 lines (750 Rust UniFFI, 1,900 Swift)
 - 93 tests covering protocol integration, Keychain, and APNs
 
-**WRAITH-Chat (v1.6.3) - Voice/Video/Groups:**
+**WRAITH-Chat (v1.7.0) - Voice/Video/Groups:**
 - Signal Protocol Double Ratchet for E2EE messaging
 - SQLCipher encrypted database (AES-256, 64K PBKDF2 iterations)
 - **Voice Calling:** Opus codec (48kHz), RNNoise noise suppression, WebRTC echo cancellation
@@ -110,16 +112,26 @@ For protocol development history, see [README_Protocol-DEV.md](README_Protocol-D
 - ~5,200 lines (2,800 Rust backend, 2,400 TypeScript/React frontend)
 - 38 tests covering messaging, voice, video, and groups
 
+**WRAITH-Sync (v1.7.0) - Desktop File Synchronization:**
+- Delta synchronization with rsync-style rolling checksums
+- Conflict resolution strategies (LastWriterWins, KeepBoth, Manual)
+- Version history with configurable retention (30 days default, 10 versions)
+- SQLite metadata database for file tracking
+- File system watcher with debounced events
+- Glob pattern support for include/exclude rules
+- 8 IPC commands (add/remove folder, start/stop sync, resolve conflict, get history)
+- ~6,500 lines (4,400 Rust backend, 2,100 TypeScript/React frontend)
+- 17 tests covering sync engine, delta algorithm, and database
+
 ---
 
-### Tier 2: Specialized Applications (Medium Priority - 259 SP)
+### Tier 2: Specialized Applications (Medium Priority - 123 SP)
 
 | # | Client | Description | Platform | Story Points | Status |
 |---|--------|-------------|----------|--------------|--------|
-| 3 | **WRAITH-Sync** | Decentralized backup synchronization (Dropbox alternative) | Desktop + CLI | 136 | Planned |
-| 4 | **WRAITH-Share** | Distributed anonymous file sharing (BitTorrent-like) | Desktop + Web UI | 123 | Planned |
+| 6 | **WRAITH-Share** | Distributed anonymous file sharing (BitTorrent-like) | Desktop + Web UI | 123 | Planned |
 
-**Timeline:** Planned Q2-Q3 2026 (20 weeks parallel development)
+**Timeline:** Planned Q2-Q3 2026 (12 weeks development)
 **Prerequisites:** Protocol Phase 5 (Discovery) - ✅ Complete
 
 ---

docs/archive/README_Protocol-DEV.md

@@ -2,9 +2,9 @@
 
 **Development Timeline:** Phase 1 (2024) through Phase 17 (2026-01-21)
 
-This document captures the complete development journey of WRAITH Protocol from inception through version 1.6.3, including detailed phase accomplishments, sprint summaries, and implementation milestones.
+This document captures the complete development journey of WRAITH Protocol from inception through version 1.7.0, including detailed phase accomplishments, sprint summaries, and implementation milestones.
 
-[![Version](https://img.shields.io/badge/version-1.6.3-blue.svg)](https://github.com/doublegate/WRAITH-Protocol/releases)
+[![Version](https://img.shields.io/badge/version-1.7.0-blue.svg)](https://github.com/doublegate/WRAITH-Protocol/releases)
 [![Security](https://img.shields.io/badge/security-audited-green.svg)](../security/DPI_EVASION_REPORT.md)
 [![Rust](https://img.shields.io/badge/rust-1.85%2B-orange.svg)](https://www.rust-lang.org/)
 
@@ -20,20 +20,20 @@ For the current production README, see [../../README.md](../../README.md).
 
 ## Development Metrics Summary
 
-**Total Development Effort:** 2,257 story points delivered across 17 phases
+**Total Development Effort:** 2,577 story points delivered across 17 phases
 
 **Project Metrics (2026-01-21):**
-- **Code Volume:** ~68,000 lines of Rust code across protocol crates + ~12,000 lines in client applications (Kotlin/Swift/TypeScript)
-- **Test Coverage:** 1,695 tests passing (16 ignored) - 100% pass rate
+- **Code Volume:** ~68,000 lines of Rust code across protocol crates + ~18,000 lines in client applications (Kotlin/Swift/TypeScript)
+- **Test Coverage:** 1,712 tests passing (16 ignored) - 100% pass rate
 - **Documentation:** 120+ markdown files, ~72,000+ lines of comprehensive documentation
 - **Dependencies:** 295 audited packages (zero vulnerabilities via cargo-audit)
 - **Security:** Grade A+ (EXCELLENT) - zero vulnerabilities, 100% unsafe documentation, comprehensive audits
-- **Client Applications:** 4 production-ready Tier 1 applications with full protocol integration, voice/video calling, group messaging
+- **Client Applications:** 5 production-ready Tier 1 applications with full protocol integration, voice/video calling, group messaging, file synchronization
 - **CI/CD:** GitHub Actions updated (upload-artifact v6, download-artifact v7, cache v5)
 
 **Quality Metrics:**
 - **Quality Grade:** 98/100 (Production-ready)
-- **Test Coverage:** 1,695 tests passing (16 ignored) - 100% pass rate
+- **Test Coverage:** 1,712 tests passing (16 ignored) - 100% pass rate
   - 414 wraith-core - frame parsing (SIMD), sessions, streams, BBR, migration, ring buffers, Node API
   - 179 wraith-crypto - Ed25519, X25519+Elligator2, AEAD, Noise_XX, Double Ratchet (+ test vectors + zeroization)
   - 44 wraith-files - chunking, reassembly, BLAKE3 tree hashing, io_uring I/O
@@ -45,6 +45,7 @@ For the current production README, see [../../README.md](../../README.md).
   - 323 integration tests - end-to-end flows, multi-peer transfers, cross-crate integration, property tests
   - 6 wraith-transfer backend - Desktop application (Tauri IPC commands)
   - 38 wraith-chat backend - E2EE messaging + voice/video/groups (49 IPC commands)
+  - 17 wraith-sync backend - Desktop file synchronization (delta sync, conflict resolution)
   - 96 wraith-android tests - Mobile protocol integration, Keystore, FCM
   - 93 wraith-ios tests - Mobile protocol integration, Keychain, APNs
   - 62 wraith-transfer frontend - React UI component tests (Vitest)