docs(protocol): Session 34 — Multi-Contact Architecture: Singleton to Per-Contact

SESSION 34 (Feb 23, 2026):
  Multi-Contact Architecture — From Singleton to Per-Contact Reply Queue
  8 Commits — most productive session yet
  Phase 1: Production Cleanup (stripped private keys, -200+ lines)
  Phase 2: Runtime Add-Contact (NET_CMD via Ring Buffer)
  Phase 3: Per-Contact 42d Tracking (128-bit bitmap)
  Phase 4: UI Contact List ([+ New Contact] with auto-naming)
  Phase 5: Per-Contact Reply Queue (128 PSRAM slots, ~49KB)
  Phase 6: SMP v7 Signing Fix (1-byte session prefix)
  PSRAM Total: ~158KB / 8MB (1.9%)
  Open Bug: KEY Command rejected — handover to Claude Code
  MILESTONE 9: Multi-Contact Architecture

DOCUMENTATION:
  - NEW: 32_PART30_SESSION_34.md (473 lines)
  - Updated: INDEX, STATUS, README, BUG_TRACKER, QUICK_REFERENCE
  - 7 new lessons (#169-175), 175 total
  - 30 parts, 567+ sections

Author: cannatoshi

docs/protocol-analysis/01_SIMPLEX_PROTOCOL_INDEX.md

@@ -4,28 +4,28 @@
 
 **Project:** SimpleGo - Native ESP32 SMP Implementation  
 **Version:** v0.1.18-alpha  
-**Last Updated:** 2026-02-20 (Session 32 — 🖥️ "The Demonstration" - From Protocol to Messenger)
+**Last Updated:** 2026-02-23 (Session 34 — 🏗️ Multi-Contact Architecture: From Singleton to Per-Contact)
 
 ---
 
-## 🖥️ LATEST: "The Demonstration" (Session 32)
+## 🏗️ LATEST: Multi-Contact Architecture (Session 34)
 
-On February 19-20, 2026, Session 32 transformed SimpleGo from protocol to messenger:
+On February 23, 2026, Session 34 transformed SimpleGo from singleton to multi-contact:
 
-- **Keyboard-to-Chat:** ✅ 7-step integration, hardware keyboard to displayed bubbles
-- **Delivery Status:** ✅ Professional "..." → "✓" → "✓✓" → "✗" system
-- **LVGL Display Fix:** ✅ Invisible bubbles bug resolved
-- **Multi-Contact Analysis:** ✅ 128-contact PSRAM architecture planned (68KB)
-- **Navigation Stack:** ✅ prev_screen → 8-deep stack (bug fixed)
-- **Stability:** 2+ hours without crash
+- **Production Cleanup:** ✅ Stripped all private keys from logs (-200+ lines)
+- **Runtime Add-Contact:** ✅ NET_CMD_ADD_CONTACT via Ring Buffer
+- **Per-Contact 42d:** ✅ 128-bit bitmap replaces boolean
+- **Per-Contact Reply Queue:** ✅ 128 slots in PSRAM (~49KB)
+- **SMP v7 Signing Fix:** ✅ 1-byte session prefix (was 2-byte)
+- **Open Bug:** KEY Command rejected by server (handover to Claude Code)
 
-**Lessons Learned:** 168 total (7 new in S32)
+**Lessons Learned:** 175 total (7 new in S34)
 
 ---
 
 ## Documentation Structure
 
-The complete protocol analysis (~26,500+ lines, 550+ sections) is split into 29 parts:
+The complete protocol analysis (~27,000+ lines, 567+ sections) is split into 30 parts:
 
 | Part | File | Lines | Content |
 |------|------|-------|---------|
@@ -58,7 +58,8 @@ The complete protocol analysis (~26,500+ lines, 550+ sections) is split into 29
 | **27** | [**29_PART27_SESSION_30.md**](29_PART27_SESSION_30.md) | **~660** | **🔍 Intensive Debug — 10 Hypotheses, 14 Fixes** |
 | **28** | [**30_PART28_SESSION_31.md**](30_PART28_SESSION_31.md) | **~850** | **🎉 Bidirectional Chat Restored! Milestone 7!** |
 | **29** | [**31_PART29_SESSION_32.md**](31_PART29_SESSION_32.md) | **~500** | **🖥️ "The Demonstration" — From Protocol to Messenger** |
-| **Total** | | **~26,500+** | **550+ Sections** |
+| **30** | [**32_PART30_SESSION_34.md**](32_PART30_SESSION_34.md) | **~473** | **🏗️ Multi-Contact Architecture — Per-Contact Reply Queue** |
+| **Total** | | **~27,000+** | **567+ Sections** |
 
 ---
 
@@ -67,8 +68,8 @@ The complete protocol analysis (~26,500+ lines, 550+ sections) is split into 29
 | Document | Lines | Description |
 |----------|-------|-------------|
 | [README.md](README.md) | ~820 | Project overview and navigation |
-| [BUG_TRACKER.md](BUG_TRACKER.md) | ~1,750 | All 39 bugs documented, 168 lessons |
-| [QUICK_REFERENCE.md](QUICK_REFERENCE.md) | ~1,750 | Constants, wire formats, verified values |
+| [BUG_TRACKER.md](BUG_TRACKER.md) | ~1,800 | All 39 bugs documented, 175 lessons |
+| [QUICK_REFERENCE.md](QUICK_REFERENCE.md) | ~1,850 | Constants, wire formats, verified values |
 
 ---
 
@@ -105,6 +106,7 @@ The complete protocol analysis (~26,500+ lines, 550+ sections) is split into 29
 | **30** | **Feb 16-18, 2026** | **DEBUG** | **🔍 10 Hypotheses, 14 Fixes, Awaiting Evgeny** |
 | **31** | **Feb 18, 2026** | **RESOLVED** | **🎉 Bidirectional Restored! Milestone 7!** |
 | **32** | **Feb 19-20, 2026** | **UI** | **🖥️ "The Demonstration" — Full Messenger UI** |
+| **34** | **Feb 23, 2026** | **ARCHITECTURE** | **🏗️ Multi-Contact — Per-Contact Reply Queue** |
 
 ---
 
@@ -139,6 +141,12 @@ The complete protocol analysis (~26,500+ lines, 550+ sections) is split into 29
 - **Receipt Parsing (inner_tag 'V')** 🖥️
 - **UI Event Queue (app_to_ui_queue)** 🖥️
 - **128-Contact PSRAM Architecture** 🖥️
+- **Production Cleanup (zero private keys in logs)** 🏗️
+- **Runtime Add-Contact (NET_CMD via Ring Buffer)** 🏗️
+- **Per-Contact 42d Tracking (128-bit bitmap)** 🏗️
+- **Per-Contact Reply Queue (128 slots, ~49KB PSRAM)** 🏗️
+- **SMP v7 Signing Fix (1-byte session prefix)** 🏗️
+- **PSRAM Total: ~158KB / 8MB (1.9%)** 🏗️
 
 ### ✅ Session 23: The 7-Step Handshake
 ```
@@ -176,14 +184,26 @@ The complete protocol analysis (~26,500+ lines, 550+ sections) is split into 29
 | E2E Version/KEM/NHK bugs | 5 | S22 |
 | Bidirectional + Receipt bugs | 8 | S25 |
 
-**Lessons Learned: 168** (documented in BUG_TRACKER.md)
+**Lessons Learned: 175** (documented in BUG_TRACKER.md)
 
-**Session 32: ZERO new protocol bugs! Pure UI/architecture work.**
+**Session 34: Zero new protocol bugs! Architecture + signing fix only.**
 
 ---
 
 ## Protocol Discoveries
 
+### Session 34: SMP v7 Signing Format (1-Byte Session Prefix)
+```
+SMP command signing concatenates: corrId + entityId + command
+Length prefixes in signing buffer MUST be 1-byte (not 2-byte Large):
+
+WRONG:  [2B corrLen][corrId][2B entLen][entityId][command]
+RIGHT:  [1B corrLen][corrId][1B entLen][entityId][command]
+
+2-byte prefix causes signature verification failure on server.
+Affected: SUB, KEY, NEW commands simultaneously.
+```
+
 ### Session 32: Delivery Receipt Wire Format (inner_tag 'V')
 ```
 After Double Ratchet body decrypt:
@@ -328,25 +348,19 @@ SimpleGo is confirmed as the **FIRST native SMP protocol implementation** outsid
 
 ---
 
-## Next Steps (Session 33)
-
-### Phase 1: Navigation & Multi-Contact
-```
-P0: Navigation Stack implementation (ui_manager.c rewrite)
-P1: Active Contact routing (smp_set_active_contact)
-P2: Contact selection passes index (ui_contacts.c)
-```
+## Next Steps (Session 35)
 
-### Phase 2: UI & Scale
+### Phase 1: KEY Command Fix
 ```
-P3: Cyberpunk UI redesign integration (from Design Chat)
-P4: 128-contact PSRAM array implementation (ratchet refactor)
+P0: KEY Command fix (Claude Code Haskell line-by-line analysis)
+P1: Stack overflow test (32KB Network Task)
 ```
 
-### Assessment
+### Phase 2: Complete Multi-Contact
 ```
-"Eine Kontaktliste mit mindestens 100 Usern, sonst brauchen
- wir gar nicht auf Kickstarter antanzen." — Cannatoshi
+P2: Drain-Loop MSG forwarding (after KEY fix)
+P3: Cleanup Phase 3 (smp_agent.c, smp_peer.c, smp_e2e.c)
+P4: Keep-Alive PING/PONG stabilization (Evgeny Session 30)
 ```
 
 ---
@@ -363,8 +377,9 @@ P4: 128-contact PSRAM array implementation (ratchet refactor)
 | 5 | ✓✓ Delivery Receipts | 2026-02-14 | 25 |
 | 6 | 🗄️ Ratchet Persistence | 2026-02-14 | 26 |
 | 7 | 🎉 Multi-Task Bidirectional | 2026-02-18 | 31 |
-| **8** | **🖥️ Full Messenger UI** | **2026-02-19** | **32** |
+| 8 | 🖥️ Full Messenger UI | 2026-02-19 | 32 |
+| **9** | **🏗️ Multi-Contact Architecture** | **2026-02-23** | **34** |
 
 ---
 
-*Index updated: 2026-02-20 Session 32 — 🖥️ "The Demonstration" — From Protocol to Messenger!*
+*Index updated: 2026-02-23 Session 34 — 🏗️ Multi-Contact Architecture — Per-Contact Reply Queue*

docs/protocol-analysis/02_SIMPLEX_STATUS.md

@@ -1,14 +1,45 @@
 ![SimpleGo](../gfx/sg_multi_agent_ft_header.png)
 
-# SimpleGo - Current Status (2026-02-20)
+# SimpleGo - Current Status (2026-02-23)
 
 **Project:** Native SimpleX SMP Client for ESP32  
 **Version:** v0.1.17-alpha  
-**Archive:** See `01_SIMPLEX_PROTOCOL_INDEX.md` for complete documentation (550+ sections, 29 parts)
+**Archive:** See `01_SIMPLEX_PROTOCOL_INDEX.md` for complete documentation (567+ sections, 30 parts)
 
 ---
 
-## 🖥️ LATEST: "The Demonstration" (2026-02-20 Session 32)
+## 🏗️ LATEST: Multi-Contact Architecture (2026-02-23 Session 34)
+
+```
+═══════════════════════════════════════════════════════════════════════════════
+
+  🏗️🏗️🏗️ MULTI-CONTACT — FROM SINGLETON TO PER-CONTACT 🏗️🏗️🏗️
+
+  ┌─────────────────────────────────────────────────────────────────────────┐
+  │                                                                         │
+  │   8 Commits — most productive session yet                              │
+  │                                                                         │
+  │   Production Cleanup: zero private keys in logs                        │
+  │   Runtime Add-Contact: NET_CMD via Ring Buffer                         │
+  │   Per-Contact 42d: 128-bit bitmap                                      │
+  │   UI: [+ New Contact] with auto-naming                                 │
+  │   Reply Queue Array: 128 slots, ~49KB PSRAM                           │
+  │   SMP v7 Signing Fix: 1-byte session prefix                           │
+  │   PSRAM Total: ~158KB / 8MB (1.9%)                                    │
+  │                                                                         │
+  │   Open Bug: KEY Command rejected by server                             │
+  │   Handover: Claude Code for Haskell analysis                           │
+  │                                                                         │
+  │   Date: February 23, 2026                                              │
+  │                                                                         │
+  └─────────────────────────────────────────────────────────────────────────┘
+
+═══════════════════════════════════════════════════════════════════════════════
+```
+
+---
+
+## 🖥️ SESSION 32: "The Demonstration" (2026-02-20)
 
 ```
 ═══════════════════════════════════════════════════════════════════════════════
@@ -492,9 +523,9 @@ Bytes 80-95: HEADER_IV (iv2)   ← FOR HEADER!
 | `01_SIMPLEX_PROTOCOL_INDEX.md` | Navigation index |
 | `02_SIMPLEX_STATUS.md` | This file - quick status |
 | `README.md` | Project overview |
-| `BUG_TRACKER.md` | All 39 bugs, 168 lessons |
+| `BUG_TRACKER.md` | All 39 bugs, 175 lessons |
 | `QUICK_REFERENCE.md` | Constants, wire formats |
-| `03-31_PART*.md` | Sessions 1-32 documentation |
+| `03-32_PART*.md` | Sessions 1-34 documentation |
 
 ---
 
@@ -511,20 +542,21 @@ Bytes 80-95: HEADER_IV (iv2)   ← FOR HEADER!
 | **6** | **🗄️ Ratchet Persistence** | **2026-02-14** | **26** |
 | **7** | **🎉 Multi-Task Bidirectional** | **2026-02-18** | **31** |
 | **8** | **🖥️ Full Messenger UI** | **2026-02-19** | **32** |
+| **9** | **🏗️ Multi-Contact Architecture** | **2026-02-23** | **34** |
 
 ---
 
-## 🎯 Next Steps (Session 33)
+## 🎯 Next Steps (Session 35)
 
-1. **P0:** Navigation Stack implementation (ui_manager.c rewrite)
-2. **P1:** Active Contact routing (smp_set_active_contact)
-3. **P2:** Contact selection passes index (ui_contacts.c)
-4. **P3:** Cyberpunk UI redesign integration (from Design Chat)
-5. **P4:** 128-contact PSRAM array implementation (ratchet refactor)
+1. **P0:** KEY Command fix (Claude Code Haskell line-by-line analysis)
+2. **P1:** Stack overflow test (32KB Network Task)
+3. **P2:** Drain-Loop MSG forwarding (after KEY fix)
+4. **P3:** Cleanup Phase 3 (smp_agent.c, smp_peer.c, smp_e2e.c)
+5. **P4:** Keep-Alive PING/PONG stabilization (Evgeny Session 30)
 
-**Assessment:** "Eine Kontaktliste mit mindestens 100 Usern, sonst brauchen wir gar nicht auf Kickstarter antanzen."
+**Open Bug:** KEY Command rejected by server. Handover to Claude Code.
 
 ---
 
-*Status updated: 2026-02-20 Session 32 — 🖥️ "THE DEMONSTRATION" — From Protocol to Messenger*  
-*History: S8 Breakthrough → S23 CONNECTED → S24 First MSG → S25 Bidirectional → S26 Persistence → S27 Architecture → S28 Tasks → S29 Multi-Task → S30 Debug → S31 RESOLVED → S32 Messenger UI!*
+*Status updated: 2026-02-23 Session 34 — 🏗️ Multi-Contact Architecture — Per-Contact Reply Queue*  
+*History: S8 Breakthrough → S23 CONNECTED → S24 First MSG → S25 Bidirectional → S26 Persistence → S27 Architecture → S28 Tasks → S29 Multi-Task → S30 Debug → S31 RESOLVED → S32 Messenger UI → S34 Multi-Contact!*