docs(memory): document session-start memory and config defaults

docs/architecture/AGENT_DIAGRAM.md

@@ -31,13 +31,13 @@ flowchart LR
     RT[Routing\ncreateMessageRouter()]
     PF[Preferences\n~/.local/share/flynn/preferences.json\nmodelTier + backendMode]
     SM[SessionManager\nSQLite]
-    OR[AgentOrchestrator]
-    NA[NativeAgent\n(tool loop)]
-    EB[Optional External Backends\nclaude_code/opencode/codex/gemini/pi_embedded]
-    MR[ModelRouter]
-    TP[ToolPolicy + ToolRegistry]
-    TE[ToolExecutor\nhooks + enforcement + audit]
-    MEM[Memory Store\nfiles + vector/keyword]
+  OR[AgentOrchestrator]
+  NA[NativeAgent\n(tool loop)]
+  EB[Optional External Backends\nclaude_code/opencode/codex/gemini/pi_embedded]
+  MR[ModelRouter]
+  TP[ToolPolicy + ToolRegistry]
+  TE[ToolExecutor\nhooks + enforcement + audit]
+  MEM[Memory Store\nfiles + vector/keyword\nuser/profile + user/working]
     AU[Audit Logger\nredacted]
     HS[Hooks/Autonomy\nconfirm/log/silent]
     GA[Google OAuth Runtime\nsrc/google/oauth.ts]
@@ -67,6 +67,7 @@ flowchart LR
   RT --> OR
   RT --> EB
   OR --> NA
+  OR -->|session-start memory| MEM
   EB --> MP
   NA --> MR
   MR --> MP
@@ -135,6 +136,10 @@ Tool Calls (inside NativeAgent loop)
                  |                                 v
                  +---------------------------> AuditLogger (redacted)
 
+Session start (when `memory.user_namespace` is set)
+  AgentOrchestrator -> MemoryStore (user/profile + user/working)
+  AgentOrchestrator -> System prompt (session context injection)
+
 Outbound Reply
   -> ChannelAdapter.send()  (text + optional attachments)
 ```

docs/architecture/GATEWAY_SESSIONS_AND_QUEUE.md

@@ -10,6 +10,7 @@ If you only want the protocol surface, see `docs/api/PROTOCOL.md`.
 - Each connection is attached to a `sessionId`.
 - Agent work is queued per `sessionId` (FIFO), not per connection.
 - Sessions persist in SQLite via `SessionManager` even if clients disconnect.
+- On the first message of a session, the orchestrator can inject session-start memory (`user/profile` + `user/working`) when `memory.user_namespace` is configured.
 - Once dequeued, message routing may execute the native orchestrator path or an optional external backend path (`claude_code`, `opencode`, `codex`, `gemini`, `pi_embedded`) depending on agent/backend config.
 - Runtime backend mode can be overridden manually via `/runtime` command fast-path (`status`, `activate pi`, `deactivate pi`, `use config`) and is persisted in preferences (`/backend` remains a compatibility alias).
 - `flynn tui` now attaches to this same gateway command path for `/runtime ...` and auto-starts/attaches daemon+gateway when needed.