Report read-only paths after a session; known issues document

- run (on exit) and doctor scan the OpenCode log for 'Read-only file system' / EROFS, map
  the agent's XDG mirror back to the home directory and print a ready OCSB_RW_HOME line;
  writable, hidden and protected project paths are skipped
- docs/known-issues.md: open gaps and planned work (Docker, blocklist egress, DNS, shared
  network namespace, resource limits, undo, planted repos, credentials, agents working
  around guards); linked from both READMEs

README.ru.md

@@ -270,6 +270,8 @@ opencode-sandbox run
 
 ## Модель безопасности и ограничения
 
+Открытые проблемы и планы (на английском): [docs/known-issues.md](docs/known-issues.md).
+
 Цель — удержать агента, который ошибается (не тот путь, `rm -rf` не там, запрос в прод), а
 не остановить целенаправленного злоумышленника.
 
@@ -296,7 +298,7 @@ opencode-sandbox run
 
 | Симптом | Причина и что делать |
 |---|---|
-| `Read-only file system` | путь вне разрешённых на запись. Если агенту он правда нужен — добавьте в `OCSB_RW` |
+| `Read-only file system`, не стартует MCP-сервер или инструмент | путь вне разрешённых на запись. После каждой сессии (и в `doctor`) `run` перечисляет пути, упёршиеся в «только чтение», из лога OpenCode с готовой строкой, например `OCSB_RW_HOME+=(.local/share/pnpm)`; добавьте её в `sandbox.conf` (или `local/sandbox.conf`) и перезапустите. Остальное — `OCSB_RW`, если агенту путь правда нужен |
 | `403` от прокси, `CONNECT tunnel failed` | хост не разрешён: добавьте `allow` (или `connect host:port` для порта не 443) в `egress.conf`, выполните `opencode-sandbox egress up` |
 | git по SSH: `Permission denied (publickey)` | в ssh-agent нет ключей: `ssh-add` перед `run` |
 | git по SSH: `403` | добавьте `connect <хост>:<порт>` в `egress.conf` |