docs: update documentation with v2.3.1 benchmark analysis and performance metrics

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

Author: doublegate

CHANGELOG.md

@@ -48,6 +48,18 @@ Complete frontend rewrite of `clients/wraith-redops/operator-client/src/` with 1
   - Dashboard split layout: network graph (60%) + live events feed (40%)
   - Enhanced settings: auto-refresh interval selector, auth token display/refresh, about section with version info and shortcut reference
 
+#### Benchmark Analysis Document (2026-01-28)
+
+- **`docs/testing/BENCHMARK-ANALYSIS-v2.3.1.md`** - Comprehensive benchmark analysis covering all protocol crates
+  - Frame parsing: 2.4 ns/frame (~563 GiB/s equivalent throughput)
+  - XChaCha20-Poly1305 AEAD: ~1.4 GiB/s encryption throughput
+  - Noise XX handshake: 345 us per full mutual authentication
+  - Elligator2 encoding: 29.5 us per key encoding operation
+  - BLAKE3 tree hashing: 4.71 GiB/s in-memory
+  - File chunking: 14.85 GiB/s, reassembly: 5.42 GiB/s, verification: 4.78 GiB/s
+  - Ring buffers: ~100M ops/sec (SPSC), ~20M ops/sec (MPSC)
+  - Updated README.md performance section with detailed benchmark table
+
 ### Fixed
 
 - **Console Clear/History buttons** (`Console.tsx:212-213`) - Added `onClick` handlers using existing `xtermRef`/`commandHistoryRef`; buttons were previously non-functional

README.md

@@ -348,18 +348,23 @@ For detailed architecture documentation, see [Protocol Overview](docs/architectu
 | Memory per Session  | <10 MB    | Including buffers     |
 | CPU @ 10 Gbps       | <50%      | 8-core system         |
 
-### Benchmarks
-
-| Component          | Measured Performance                      |
-| ------------------ | ----------------------------------------- |
-| Ring Buffers       | ~100M ops/sec (SPSC), ~20M ops/sec (MPSC) |
-| Frame Parsing      | 172M frames/sec (SIMD: AVX2/SSE4.2/NEON)  |
-| AEAD Encryption    | 3.2 GB/s (XChaCha20-Poly1305)             |
-| BLAKE3 Hashing     | 8.5 GB/s (parallelized)                   |
-| File Chunking      | 14.85 GiB/s                               |
-| Tree Hashing       | 4.71 GiB/s in-memory                      |
-| Chunk Verification | 4.78 GiB/s                                |
-| File Reassembly    | 5.42 GiB/s                                |
+### Benchmarks (v2.3.1)
+
+Measured on production hardware with `cargo bench --workspace`. See [Benchmark Analysis](docs/testing/BENCHMARK-ANALYSIS-v2.3.1.md) for full methodology and results.
+
+| Component            | Measured Performance                        | Details                                    |
+| -------------------- | ------------------------------------------- | ------------------------------------------ |
+| Frame Parsing        | 2.4 ns/frame (~563 GiB/s equivalent)       | SIMD: AVX2/SSE4.2/NEON, 172M frames/sec   |
+| AEAD Encryption      | ~1.4 GiB/s (XChaCha20-Poly1305)            | 256-bit key, 192-bit nonce                 |
+| Noise XX Handshake   | 345 us per handshake                        | Full mutual authentication                 |
+| Elligator2 Encoding  | 29.5 us per encoding                        | Key indistinguishability from random       |
+| BLAKE3 Hashing       | 4.71 GiB/s (tree), 8.5 GB/s (parallel)     | rayon + SIMD acceleration                  |
+| File Chunking        | 14.85 GiB/s                                 | io_uring async I/O                         |
+| Tree Hashing         | 4.71 GiB/s in-memory, 3.78 GiB/s from disk | Merkle tree with BLAKE3                    |
+| Chunk Verification   | 4.78 GiB/s                                  | <1 us per 256 KiB chunk                    |
+| File Reassembly      | 5.42 GiB/s                                  | O(m) algorithm, zero-copy                  |
+| Ring Buffers (SPSC)  | ~100M ops/sec                               | Cache-line padded, lock-free               |
+| Ring Buffers (MPSC)  | ~20M ops/sec                                | CAS-based, 4 producers                     |
 
 ---
 
@@ -623,7 +628,7 @@ See [CI Workflow](.github/workflows/ci.yml) and [Release Workflow](.github/workf
 
 ### Completed
 
-WRAITH Protocol v2.3.0 represents 2,740+ story points across 24 development phases:
+WRAITH Protocol v2.3.1 represents 2,740+ story points across 24 development phases:
 
 - Core protocol implementation (cryptography, transport, obfuscation, discovery)
 - 12 production-ready client applications (9 desktop + 2 mobile + 1 server platform)
@@ -708,6 +713,6 @@ WRAITH Protocol builds on excellent projects and research:
 
 **WRAITH Protocol** - _Secure. Fast. Invisible._
 
-**Version:** 2.3.0 | **License:** MIT | **Language:** Rust 2024 (MSRV 1.88) | **Tests:** 2,148 passing (2,123 workspace + 11 spectre-implant + 14 doc) | **Clients:** 12 applications (9 desktop + 2 mobile + 1 server)
+**Version:** 2.3.1 | **License:** MIT | **Language:** Rust 2024 (MSRV 1.88) | **Tests:** 2,148 passing (2,123 workspace + 11 spectre-implant + 14 doc) | **Clients:** 12 applications (9 desktop + 2 mobile + 1 server)
 
 **Last Updated:** 2026-01-28

docs/archive/README_Clients-DEV.md

@@ -33,7 +33,7 @@ For protocol development history, see [README_Protocol-DEV.md](README_Protocol-D
 - **Tier 4:** Security Testing (RedOps - COMPLETE)
 
 **Current Status (2026-01-28):**
-- Protocol v2.3.0 complete (all 24 phases + infrastructure sprints delivered)
+- Protocol v2.3.1 complete (all 24 phases + infrastructure sprints delivered)
 - **All 12 Client Applications:** ✅ **COMPLETE** (1,292 SP total)
   - WRAITH-Transfer: Desktop P2P file transfer (6 tests)
   - WRAITH-Chat: E2EE messaging with voice/video/groups (107 tests)
@@ -1192,7 +1192,7 @@ RedOps                                                          [=============]
 - ✅ 2,134 tests passing (2,123 workspace + 11 spectre-implant, 16 ignored) - 100% pass rate
 - ✅ Zero vulnerabilities, zero clippy warnings
 - ✅ Grade A+ quality (98/100), TDR ~2.5%
-- ✅ Production-ready architecture with v2.3.0 release
+- ✅ Production-ready architecture with v2.3.1 release
 - ✅ WRAITH-RedOps workspace integration: team-server and operator-client as Cargo workspace members
 - ✅ WRAITH-RedOps gap analysis v7.0.0: ~97% completion, 87% MITRE ATT&CK (35/40), 0 P0 critical, 21 modules, 32 RPCs 100% IPC, 59 SP remaining across 13 findings
 - ✅ WRAITH-RedOps Operator Client UI/UX Enhancement: 34/34 IPC commands wired (was 19/34), 17 new files, 7 modified, zustand stores, toast/modal/context menu system, 6 new feature sections (listener CRUD, implant detail, campaign edit, implant generator, playbook browser, event log)
@@ -1325,7 +1325,7 @@ RedOps                                                          [=============]
 
 ---
 
-**WRAITH Protocol Client Applications Development History** - *From Planning to v2.3.0*
+**WRAITH Protocol Client Applications Development History** - *From Planning to v2.3.1*
 
 **Status:** Phases 15-24 Complete (All 12 Clients) | **Total Scope:** 12 clients, 1,292 SP | **Delivered:** 1,292 SP (100%) | **Protocol:** v2.3.1 Complete | **Tests:** 2,148 total (2,123 workspace + 11 spectre-implant + 14 doc, 663+ client tests) | **Workspace:** 22 members (team-server + operator-client integrated) | **TDR:** ~2.5% (Grade A) | **CI/CD:** Optimized workflows with reusable setup, path filters, and cross-compilation via Cross.toml | **RedOps:** Gap analysis v7.0.0 (~98% complete, 87% MITRE ATT&CK (35/40), 0 P0 critical, 21 modules, 34/34 IPC wired, operator UI/UX overhauled with zustand/toast/modal/context menus) | **Conductor:** Project management system with code style guides
 

docs/archive/README_Protocol-DEV.md

@@ -4,7 +4,7 @@
 
 This document captures the complete development journey of WRAITH Protocol from inception through version 2.0.0, including detailed phase accomplishments, sprint summaries, and implementation milestones.
 
-[![Version](https://img.shields.io/badge/version-2.3.0-blue.svg)](https://github.com/doublegate/WRAITH-Protocol/releases)
+[![Version](https://img.shields.io/badge/version-2.3.1-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.88%2B-orange.svg)](https://www.rust-lang.org/)
 
@@ -1242,18 +1242,20 @@ Red team operations platform for authorized adversary emulation:
 
 ## Performance Evolution
 
-**Phase 13 Benchmarks (Final Measurements):**
+**Benchmark Results (v2.3.1 - see [BENCHMARK-ANALYSIS-v2.3.1.md](../testing/BENCHMARK-ANALYSIS-v2.3.1.md)):**
+- **Frame Parsing:** 2.4 ns/frame (~563 GiB/s equivalent), 172M frames/sec with SIMD (AVX2/SSE4.2/NEON)
+- **AEAD Encryption:** ~1.4 GiB/s (XChaCha20-Poly1305, 256-bit key, 192-bit nonce)
+- **Noise XX Handshake:** 345 us per full mutual authentication handshake
+- **Elligator2 Encoding:** 29.5 us per key encoding operation
+- **BLAKE3 Hashing:** 4.71 GiB/s tree hashing, 8.5 GB/s with rayon parallelization and SIMD
+- **File Chunking:** 14.85 GiB/s with io_uring async I/O
+- **Tree Hashing:** 4.71 GiB/s in-memory, 3.78 GiB/s from disk
+- **Chunk Verification:** 4.78 GiB/s (51.1 us per 256 KiB chunk)
+- **File Reassembly:** 5.42 GiB/s with O(m) algorithm
 - **Ring Buffers:** ~100M ops/sec (SPSC), ~20M ops/sec (MPSC with 4 producers)
   - Sub-microsecond latency for small batches
   - Zero allocations after initialization
   - Cache-line padding eliminates false sharing
-- **Frame Parsing:** 172M frames/sec with SIMD (AVX2/SSE4.2/NEON)
-- **AEAD Encryption:** 3.2 GB/s (XChaCha20-Poly1305)
-- **BLAKE3 Hashing:** 8.5 GB/s with rayon parallelization and SIMD
-- **File Chunking:** 14.85 GiB/s
-- **Tree Hashing:** 4.71 GiB/s in-memory, 3.78 GiB/s from disk
-- **Chunk Verification:** 4.78 GiB/s (51.1 µs per 256 KiB chunk)
-- **File Reassembly:** 5.42 GiB/s
 - **Connection Health:** Lock-free (AtomicU32), O(1) staleness detection
 
 **Performance Targets vs Achieved:**
@@ -1371,7 +1373,7 @@ Red team operations platform for authorized adversary emulation:
 
 ## Current Status & Next Steps
 
-**Version 2.3.0 Status (2026-01-28):**
+**Version 2.3.1 Status (2026-01-28):**
 - ✅ All 24 development phases complete (2,740+ SP delivered)
 - ✅ 2,134 tests (2,123 workspace + 11 spectre-implant, 16 ignored) - 100% pass rate
 - ✅ Zero vulnerabilities, zero warnings
@@ -1452,7 +1454,7 @@ See [../../to-dos/ROADMAP.md](../../to-dos/ROADMAP.md) for detailed future plann
 
 ---
 
-**WRAITH Protocol Development History** - *From Foundation to v2.3.0 (Phases 1-24 + Infrastructure Sprints)*
+**WRAITH Protocol Development History** - *From Foundation to v2.3.1 (Phases 1-24 + Infrastructure Sprints)*
 
 **Development Period:** 2024 - 2026-01-28 | **Total Effort:** 2,740+ story points delivered across 24 phases + infrastructure sprints | **Quality:** Production-ready (98/100), 2,148 tests (2,123 workspace + 11 spectre-implant + 14 doc, 100% pass rate), 0 vulnerabilities, Grade A+ security | **Clients:** 12 applications (9 desktop + 2 mobile + 1 server) | **Workspace:** 22 members + 2 excluded (team-server and operator-client integrated) | **TDR:** ~2.5% (Grade A - Excellent) | **CI/CD:** Optimized workflows with reusable setup, path filters, and cross-compilation via Cross.toml | **v2.3.1:** MSRV 1.88, WRAITH-RedOps ~98% complete (gap analysis v7.0.0 + UI/UX overhaul), 87% MITRE ATT&CK coverage (35/40), 0 P0 critical issues, 21 modules, 34/34 IPC wired, operator client UI/UX overhauled (~5,800 lines, zustand/toast/modal/context menus, 6 new feature sections) | **Conductor:** Project management system with code style guides