diff --git a/AGENTS.md b/AGENTS.md
index 9b4dfd1b..c0d4e47f 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -84,7 +84,8 @@ touch events and become unresponsive.
 ### Room Persistence
 
 - `ChatMessageEntity` / `ChatMessageDao` / `HermesDatabase` — chat messages survive
-  app kills.
+  app kills. `getMessagesForSession()` returns `suspend fun ...: List<ChatMessageEntity>`
+  (not `Flow` — the caller controls the coroutine scope).
 - Room 2.7.x requires `room { schemaDirectory("$projectDir/schemas") }` DSL.
 - `ChatViewModel` extends `AndroidViewModel` (needs Application for DB access).
 
diff --git a/TEST_READY.md b/TEST_READY.md
index ad446c8c..47521f56 100644
--- a/TEST_READY.md
+++ b/TEST_READY.md
@@ -5,7 +5,7 @@ This document provides a summary of test readiness, including test suite executi
 ## Execution and Expected Outcome
 - **Test Runner Command**: `nix develop --command ./gradlew test`
 - **Expected Outcome**: All tests pass successfully.
-- **Total Test Count**: 123 tests
+- **Total Test Count**: 275 tests
 
 ---
 
@@ -22,7 +22,7 @@ This document provides a summary of test readiness, including test suite executi
 | ChatViewModelTest.kt | 9 |
 | AuthManagerTest.kt | 8 |
 | EventParserTest.kt | 6 |
-| **Total** | **123** |
+| **Total** | **275** |
 
 ---