docs(protocol): Session 27 — FreeRTOS Architecture Investigation

SESSION 27 (Feb 14-15, 2026):
  Phase 1: Folder restructure ✅
  Phase 2: FreeRTOS tasks ❌ (90KB RAM at boot broke TLS/WiFi)

ROOT CAUSE: Tasks started at boot, starved TLS/WiFi
SOLUTION: Start tasks AFTER connection, not at boot

sdkconfig fixes found:
  - CONFIG_MBEDTLS_SSL_OUT_CONTENT_LEN=16384
  - CONFIG_LWIP_TCP_SND_BUF_DEFAULT=32768

DOCUMENTATION:
  - NEW: 26_PART24_SESSION_27.md
  - Updated: INDEX, STATUS, README, BUG_TRACKER, QUICK_REFERENCE
  - Updated: 03_PART1 (minor)
  - 17 new lessons (#121-137), 137 total

GRAPHICS:
  - logo.png
  - sg_multi_agent_ft_header.ai

Multi-Agent Team: Mausi, Hasi, Claude Code, Cannatoshi

Author: cannatoshi

docs/protocol-analysis/01_SIMPLEX_PROTOCOL_INDEX.md

@@ -4,25 +4,27 @@
 
 **Project:** SimpleGo - Native ESP32 SMP Implementation  
 **Version:** v0.1.18-alpha  
-**Last Updated:** 2026-02-14 (Session 26 — 🗄️ Persistence!)
+**Last Updated:** 2026-02-15 (Session 27 — ⚠️ FreeRTOS Architecture Investigation)
 
 ---
 
-## 🗄️ LATEST: Ratchet State Persistence! (Session 26)
+## ⚠️ LATEST: Architecture Investigation (Session 27)
 
-On February 14, 2026, Session 26 achieved **Milestone 6**:
+On February 14-15, 2026, Session 27 investigated FreeRTOS multi-task architecture:
 
-- **Milestone 6:** ESP32 survives reboot without losing crypto state!
-- **Write-Before-Send:** Evgeny's golden rule implemented (7.5ms)
-- **NVS Storage:** 128KB partition, 150+ contacts supported
+- **Phase 1:** Folder restructure ✅ Works
+- **Phase 2:** FreeRTOS Tasks ❌ Broke main (90KB RAM at boot)
+- **Root Cause:** Tasks started at boot, starved TLS/WiFi
+- **Solution:** Start tasks AFTER connection, not at boot
 
-**Lessons Learned:** 120 total (8 new in S26)
+**sdkconfig fixes:** OUT_CONTENT_LEN=16384, TCP_SND_BUF=32768  
+**Lessons Learned:** 137 total (17 new in S27)
 
 ---
 
 ## Documentation Structure
 
-The complete protocol analysis (~21,000+ lines, 457+ sections) is split into 23 parts:
+The complete protocol analysis (~22,000+ lines, 473+ sections) is split into 24 parts:
 
 | Part | File | Lines | Content |
 |------|------|-------|---------|
@@ -49,17 +51,18 @@ The complete protocol analysis (~21,000+ lines, 457+ sections) is split into 23
 | 21 | [23_PART21_SESSION_24.md](23_PART21_SESSION_24.md) | ~600 | 🏆 First Chat Message! Milestone #2! |
 | **22** | [**24_PART22_SESSION_25.md**](24_PART22_SESSION_25.md) | **~480** | **🎯 Bidirectional + Receipts! M3,4,5!** |
 | **23** | [**25_PART23_SESSION_26.md**](25_PART23_SESSION_26.md) | **~600** | **🗄️ Persistence! Milestone 6!** |
-| **Total** | | **~21,000+** | **457+ Sections** |
+| **24** | [**26_PART24_SESSION_27.md**](26_PART24_SESSION_27.md) | **~650** | **⚠️ FreeRTOS Architecture Investigation** |
+| **Total** | | **~22,000+** | **473+ Sections** |
 
 ---
 
 ## Quick Reference Documents
 
 | Document | Lines | Description |
 |----------|-------|-------------|
-| [README.md](README.md) | ~560 | Project overview and navigation |
-| [BUG_TRACKER.md](BUG_TRACKER.md) | ~1,350 | All 39 bugs documented, 120 lessons |
-| [QUICK_REFERENCE.md](QUICK_REFERENCE.md) | ~1,200 | Constants, wire formats, verified values |
+| [README.md](README.md) | ~620 | Project overview and navigation |
+| [BUG_TRACKER.md](BUG_TRACKER.md) | ~1,400 | All 39 bugs documented, 137 lessons |
+| [QUICK_REFERENCE.md](QUICK_REFERENCE.md) | ~1,280 | Constants, wire formats, verified values |
 
 ---
 
@@ -90,6 +93,7 @@ The complete protocol analysis (~21,000+ lines, 457+ sections) is split into 23
 | **24** | **Feb 11-13, 2026** | **FIRST A_MSG** | **🏆 First Chat Message!** |
 | **25** | **Feb 13-14, 2026** | **BIDIRECTIONAL** | **🎯 Chat + Receipts! (8 bugs)** |
 | **26** | **Feb 14, 2026** | **PERSISTENCE** | **🗄️ Milestone 6! Ratchet State Persistence** |
+| **27** | **Feb 14-15, 2026** | **ARCHITECTURE** | **⚠️ FreeRTOS Investigation (17 lessons)** |
 
 ---
 

docs/protocol-analysis/02_SIMPLEX_STATUS.md

@@ -1,12 +1,40 @@
-# SimpleGo - Current Status (2026-02-14)
+![SimpleGo](../gfx/sg_multi_agent_ft_header.png)
+
+# SimpleGo - Current Status (2026-02-15)
 
 **Project:** Native SimpleX SMP Client for ESP32  
 **Version:** v0.1.18-alpha  
-**Archive:** See `01_SIMPLEX_PROTOCOL_INDEX.md` for complete documentation (457+ sections, 23 parts)
+**Archive:** See `01_SIMPLEX_PROTOCOL_INDEX.md` for complete documentation (473+ sections, 24 parts)
+
+---
+
+## ⚠️ LATEST: Architecture Investigation (2026-02-15 Session 27)
+
+```
+═══════════════════════════════════════════════════════════════════════════════
+
+  ⚠️⚠️⚠️ FREERTOS ARCHITECTURE INVESTIGATION ⚠️⚠️⚠️
+
+  ┌─────────────────────────────────────────────────────────────────────────┐
+  │                                                                         │
+  │   Phase 1: Folder restructure ✅ WORKS                                 │
+  │   Phase 2: FreeRTOS Tasks ❌ BROKE main (90KB RAM at boot)             │
+  │   Phase 3: Network Task Migration — branch polluted                    │
+  │                                                                         │
+  │   ROOT CAUSE: Tasks started at boot, starved TLS/WiFi                  │
+  │   SOLUTION: Start tasks AFTER connection, not at boot                  │
+  │                                                                         │
+  │   Date: February 14-15, 2026                                           │
+  │   Lessons Learned: 17 new (137 total)                                  │
+  │                                                                         │
+  └─────────────────────────────────────────────────────────────────────────┘
+
+═══════════════════════════════════════════════════════════════════════════════
+```
 
 ---
 
-## 🗄️ LATEST: MILESTONE 6! (2026-02-14 Session 26)
+## 🗄️ SESSION 26: Persistence! (2026-02-14)
 
 ```
 ═══════════════════════════════════════════════════════════════════════════════
@@ -342,15 +370,15 @@ Bytes 80-95: HEADER_IV (iv2)   ← FOR HEADER!
 
 ---
 
-## 🎯 Next Steps (Session 27)
+## 🎯 Next Steps (Session 28)
 
-1. **Fix "bad message ID"** — Persist send counter in NVS
-2. **Multi-Task Architecture** — SMP Receive, SMP Send, LVGL UI tasks
-3. **Complete Chat UI** — Connect keyboard to chat screen
-4. **Message bridge** — SMP ↔ LVGL task communication
-5. **Post-quantum upgrade** — Full SNTRUP761 KEM implementation
+1. **Revert Phase 2 commit on main** — Restore working state
+2. **Keep sdkconfig fixes** — OUT_CONTENT_LEN=16384, TCP_SND_BUF=32768
+3. **Redesign task startup** — Tasks AFTER connection, not at boot
+4. **Phase 3 restart** — Fresh branch from working main
+5. **Multi-task architecture** — Proper implementation this time
 
 ---
 
-*Status updated: 2026-02-14 Session 26 — 🗄️ RATCHET STATE PERSISTENCE!*  
-*History: S8 Breakthrough → S23 CONNECTED → S24 First MSG → S25 Bidirectional → S26 Persistence!*
+*Status updated: 2026-02-15 Session 27 — ⚠️ FreeRTOS Architecture Investigation*  
+*History: S8 Breakthrough → S23 CONNECTED → S24 First MSG → S25 Bidirectional → S26 Persistence → S27 Architecture*

docs/protocol-analysis/03_PART1_INTRO_SESSIONS_1-2.md

@@ -1,5 +1,6 @@
 ![SimpleGo](../gfx/sg_multi_agent_ft_header.png)
 
+
 # SimpleX Protocol Analysis - A_VERSION Error Debugging
 
 ## 🚀 WE ARE THE FIRST! 🚀