feat(deploy): platform handoff — agent routing, persistence, docs cleanup

Agent routing:
- Remove !agent command and manual agent selection flow
- Registry auto-assigns agent from user_agents mapping (fallback: agents[0])
- provision_workspace_chat and !new both write agent_id to room_meta
- Reconciliation backfills agent_id from registry on cold start
- Fix duplicate agent_id block in auth.py

Deployment stability:
- Add bot-state named volume to persist lambda_matrix.db and matrix_store
- Fix docker-compose.prod.yml duplicate environment: key (was silently losing all Matrix credentials)
- Fix MATRIX_AGENT_REGISTRY_PATH to use absolute container path /app/config/...
- Add bot-state volume declaration to docker-compose.fullstack.yml

Docs and config:
- Rewrite README.md for platform handoff (deploy table, working commands only)
- Rewrite docs/matrix-prototype.md (remove stale commands and mock descriptions)
- Remove !save/!load/!context/!agent from help text and welcome message
- Add !clear, !list, !remove, !yes/!no to help text
- Clean up .env.example (remove Telegram token, internal vars, real URLs)
- Update config/matrix-agents.example.yaml with user_agents section and comments
- Add explanatory comment to Dockerfile for --ignore-requires-python
- Remove silent uv sync fallbacks in Dockerfile

adapter/matrix/bot.py

@@ -45,7 +45,6 @@ from adapter.matrix.store import (
     clear_staged_attachments,
     get_load_pending,
     get_room_meta,
-    get_selected_agent_id,
     get_staged_attachments,
     next_platform_chat_id,
     remove_staged_attachment_at,
@@ -89,6 +88,7 @@ class MatrixRuntime:
     settings_mgr: SettingsManager
     dispatcher: EventDispatcher
     agent_routing_enabled: bool = False
+    registry: AgentRegistry | None = None
 
 
 def build_event_dispatcher(platform: PlatformClient, store: StateStore) -> EventDispatcher:
@@ -197,6 +197,7 @@ def build_runtime(
         settings_mgr=settings_mgr,
         dispatcher=dispatcher,
         agent_routing_enabled=isinstance(platform, RoutedPlatformClient),
+        registry=registry,
     )
 
 
@@ -261,10 +262,7 @@ class MatrixBot:
             )
             return
         if not body.startswith("!") and self.runtime.agent_routing_enabled:
-            block = await self._check_agent_routing(room.room_id, sender, room_meta)
-            if block is not None:
-                await self._send_all(room.room_id, block)
-                return
+            pass
 
         local_chat_id = await resolve_chat_id(self.runtime.store, room.room_id, sender)
         incoming = from_room_event(event, room_id=room.room_id, chat_id=local_chat_id)
@@ -485,6 +483,7 @@ class MatrixBot:
                 self.runtime.store,
                 self.runtime.auth_mgr,
                 self.runtime.chat_mgr,
+                registry=self.runtime.registry,
             )
         except Exception as exc:
             logger.warning(
@@ -594,40 +593,9 @@ class MatrixBot:
                 self.runtime.store,
                 self.runtime.auth_mgr,
                 self.runtime.chat_mgr,
+                self.runtime.registry,
             )
 
-    async def _check_agent_routing(
-        self,
-        room_id: str,
-        sender: str,
-        room_meta: dict,
-    ) -> list[OutgoingEvent] | None:
-        selected_agent_id = await get_selected_agent_id(self.runtime.store, sender)
-        if not selected_agent_id:
-            return [
-                OutgoingMessage(
-                    chat_id=room_id,
-                    text="Выбери агент через !agent прежде чем отправлять сообщения.",
-                )
-            ]
-        room_agent_id = room_meta.get("agent_id")
-        if room_agent_id and room_agent_id != selected_agent_id:
-            return [
-                OutgoingMessage(
-                    chat_id=room_id,
-                    text=(
-                        f"Этот чат привязан к агенту «{room_agent_id}». "
-                        "Создай новый чат командой !new."
-                    ),
-                )
-            ]
-        if not room_agent_id:
-            await set_room_agent_id(self.runtime.store, room_id, selected_agent_id)
-            await self._ensure_platform_chat_id(
-                room_id, await get_room_meta(self.runtime.store, room_id)
-            )
-        return None
-
     async def _send_all(self, room_id: str, outgoing: list[OutgoingEvent]) -> None:
         for event in outgoing:
             await send_outgoing(self.client, room_id, event, store=self.runtime.store)