@goodandready/dsh-remote-workspace 0.1.0 → 0.1.1

package/docs/design/DESIGN.md

@@ -1,62 +1,71 @@
 # DESIGN.md — dsh-remote-workspace
 
 ## Product / Purpose
-- **Назначение**: Полнофункциональный корпоративный плагин удалённой разработки для DeepSeek Harness (DSH). Позволяет подключаться к удалённым серверам по SSH, работать с файловой системой через SFTP, вести двустороннюю 3-way синхронизацию без конфликтов, пробрасывать порты и давать агенту LLM компактный набор инструментов для удалённого шелла и файлов.
+- **Назначение**: Полнофункциональный корпоративный плагин удалённой разработки для DeepSeek Harness (DSH). Обеспечивает подключение к удалённым серверам по SSH (ключ / пароль), SFTP-навигацию, 3-way синхронизацию локального зеркала, SSH-туннелирование (port forwarding) и компактный набор инструментов для LLM агента (
+emote_exec, 
+emote_fs, 
+emote_sync, 
+emote_tunnel).
 - **Аудитория**: Разработчики и инженеры, использующие DSH для работы с проектами на VPS, удаленных серверах, облачных инстансах и MiniPC.
-- **Статус**: В активной разработке (MVP).
+- **Статус**: В активной доработке (Стабильность, Тесты, Редизайн в стиле dsh-clinebot).
 
 ## User Surfaces
-- **Web/UI**: Нативная карточка настроек профилей хостов (Settings -> Remote Workspace), селектор удаленной рабочей папки, индикатор текущего подключения в статусе.
+- **Web/UI**: Нативная карточка настроек профилей хостов (settings.plugin.item), удаленный SFTP браузер каталогов, чип статуса подключения в шапке сессии (conversation.session.header.utilities).
 - **DSH UI / settings / slots**:
-  - Карточка настроек: `settings.plugin.item` для `@goodandready/dsh-remote-workspace`.
-  - Статусный чип/слот подключения в шапке / сайдбаре.
-- **API**: HTTP эндпоинты `/api/remote-workspace/hosts`, `/api/remote-workspace/test`, `/api/remote-workspace/browse`, `/api/remote-workspace/sync`, `/api/remote-workspace/tunnels`.
-- **CLI / Tools**:
-  - `remote_exec`: выполнение команд на сервере.
-  - `remote_fs`: чтение, атомарная запись, патч и stat файлов.
-  - `remote_sync`: запуск 3-way синхронизации с контролем конфликтов.
-  - `remote_tunnel`: создание/остановка туннелей port forwarding.
-- **Документация**: `README.md` (EN), `README.ru.md` (RU), `README.zh.md` (ZH), технические спецификации в `docs/`.
+  - Карточка плагина: settings.plugin.item для @goodandready/dsh-remote-workspace.
+  - Статусный чип сессии: conversation.session.header.utilities (order: 30).
+  - Запрещённые слоты: settings.section (запрещён стандартом authoring, все настройки только внутри settings.plugin.item).
+- **API маршруты**:
+  - GET /dsh-remote-workspace/state: получение профилей, активного хоста и туннелей.
+  - POST /dsh-remote-workspace/profiles/save: сохранение профиля (с валидацией и сбросом старых соединений).
+  - POST /dsh-remote-workspace/profiles/delete: удаление профиля.
+  - POST /dsh-remote-workspace/profiles/active: переключение активного профиля.
+  - POST /dsh-remote-workspace/test: live-проверка связи (Ping, OS, Latency).
+  - POST /dsh-remote-workspace/browse: чтение содержимого удалённой папки (SFTP).
+  - POST /dsh-remote-workspace/sync: запуск двусторонней 3-way синхронизации зеркала (pull/push).
+  - POST /dsh-remote-workspace/tunnels/start: создание локального SSH-туннеля.
+  - POST /dsh-remote-workspace/tunnels/stop: остановка активного SSH-туннеля.
+- **CLI / Model Tools**:
+  - 
+emote_exec: выполнение команд на сервере.
+  - 
+emote_fs: чтение, атомарная запись, stat, mkdir, remove.
+  - 
+emote_sync: запуск 3-way синхронизации с контролем конфликтов.
+  - 
+emote_tunnel: создание/остановка/листинг туннелей.
 
-## Visual Direction
-- **Атмосфера**: Премиальный инженерный интерфейс уровня VS Code Remote / Linear / JetBrains Gateway. Строгая типографика, мгновенный отклик, визуализация сетевого состояния (пинг, ОС, туннели).
-- **Утверждённые референсы**: Нативные CSS токены DSH (`--dsw-*`, `--dsw-color-*`), карточки с мягкими скруглениями (`rounded-xl`), моноширинные теги и статус-бэйджи.
-- **Не копировать**: Спагетти-интерфейс старого dsh-remote, не инжектить принудительно сторонние плагины в `cordis.patch.yml`.
-
-## Foundations
-- **Цвета и роли**:
-  - `Online / Connected`: Emerald/Green (`#10b981`).
-  - `Connecting / Syncing`: Amber/Yellow (`#f59e0b`).
-  - `Error / Disconnected`: Rose/Red (`#f43f5e`).
-  - `Tunnel active`: Sky/Cyan (`#0ea5e9`).
-- **Типографика**: Стандартный стек шрифтов DSH с `font-mono` для хостов, IP, портов и путей.
-- **Сетка и отступы**: 8pt grid, компактные формы с валидацией "на лету".
+## Visual Direction (Единый стиль dsh-clinebot)
+- **Атмосфера**: Премиальный инженерный интерфейс уровня VS Code Remote / Linear. Строгая типографика, плотные функциональные карточки, чистые переходы и отсутствие лишних теней.
+- **Токены ядра DSH**:
+  - Фоны: ar(--dsw-alias-bg-layer-3) (карточки), ar(--dsw-alias-bg-layer-2) (поля ввода, вложенные блоки, таблицы), ar(--dsw-alias-bg-layer-1) (сегменты, подложка).
+  - Границы: ar(--dsw-alias-border-l2).
+  - Текст: ar(--dsw-alias-label-primary), ar(--dsw-alias-label-secondary), ar(--dsw-alias-label-dimmed).
+  - Статусы: ar(--dsw-alias-state-success-primary), ar(--dsw-alias-state-warning-primary), ar(--dsw-alias-state-error-primary), ar(--dsw-alias-state-brand-primary).
+- **Шапка карточки**:
+  - Название плагина, подзаголовок, статусный аккордеонный шеврон.
+  - Статусные пилюли (Badges): Host online / Offline, Active Profile, Active Tunnels count.
 
 ## Components And States
-- **HostManagerCard**:
-  - Список настроенных машин с иконками ОС, пингом и статусом ключа.
-  - Модальное окно/форма добавления (Host, Port, User, Auth: Key / Password / Agent, JumpHost).
-  - Кнопка «Проверить подключение» с индикацией задержки (ping ms) и версии SSH.
-- **RemoteDirectoryPicker**:
-  - Дерево каталогов с навигацией по клику, breadcrumbs и кнопкой «Выбрать как Workspace».
-- **TunnelManager**:
-  - Таблица активных Local и Reverse туннелей с тумблерами включения/выключения.
-- **Loading / Empty / Error States**:
-  - Скелетоны при чтении SFTP дерева.
-  - Ясные подсказки при ошибках авторизации (HostKey mismatch, Auth fail, Timeout, Permission denied).
-
-## User Flows
-1. **Настройка**: Открыть настройки -> Добавить хост -> Нажать «Проверить» -> Зелёный статус -> Сохранить.
-2. **Открытие проекта**: Выбрать хост -> Открыть Remote Directory Picker -> Выбрать папку -> Активировать как Remote Workspace.
-3. **Работа агента**: LLM получает компактные инструменты `remote_*`, видит активный хост в system prompt и безопасно редактирует код.
+1. **Секция 1: Профили серверов (SSH Profiles)**:
+   - Таблица настроенных машин с бейджами типа аутентификации (🔑 key / 🔒 pwd), меткой активного сервера, кнопками «Сделать активным», «Редактировать», «Удалить».
+   - Пустое состояние: ясное сообщение и кнопка + Добавить хост.
+2. **Секция 2: Интерактивный редактор профиля**:
+   - Название, Хост/IP, Порт, Пользователь.
+   - Сегментированный переключатель авторизации (SSH-ключ vs Пароль).
+   - Поля авторизации: путь к приватному ключу, парольная фраза, либо пароль (маскированный).
+   - Директории: Удалённый каталог проекта (с кнопкой вызова SFTP браузера) и **Локальная папка зеркала** (с подсказкой назначения).
+   - Кнопки: «⚡ Проверить связь (Ping)», «Отмена», «Сохранить».
+   - Результат пинга: отображение Latency: X ms | OS: Y или понятный текст ошибки.
+3. **Секция 3: Диагностика активного подключения**:
+   - Четырёхколоночная сетка метрик активного сервера (Хост, Удалённая папка, Метод авторизации, Статус ядра).
+4. **Секция 4: Синхронизация зеркала (Mirror Sync)**:
+   - Кнопки Pull (Remote -> Local) и Push (Local -> Remote) с индикацией процесса, результатом и предупреждением при конфликтах.
+5. **Секция 5: SSH-туннели (Port Forwarding)**:
+   - Таблица активных туннелей (ID, Локальный порт -> Удалённый порт) с кнопкой закрытия.
+   - Форма создания нового туннеля (Local Port, Remote Port, кнопка «Открыть туннель»).
 
-## Do / Don't
-- **Do**:
-  - Использовать строгие типы Schemastery для настроек и аргументов тулов.
-  - Всегда проверять TOFU known_hosts для защиты от спуфинга.
-  - Делать атомарную запись файлов во избежание повреждения кода при сетевых разрывах.
-  - Поддерживать три языка (EN, RU, ZH) в интерфейсе.
-- **Don't**:
-  - Забивать контекст LLM десятками однотипных функций `rw_*`.
-  - Блокировать Event Loop Node.js долгими SFTP операциями — использовать потоки и Promise pool.
-  - Хранить пароли в открытых логах.
+## Security & Reliability
+- Защита всех мутирующих эндпоинтов проверкой isTrustedSettingsRequest(req) (защита от cross-site атак).
+- Безопасное чтение Cordis сервисов через .get() с fallback.
+- Изоляция жизненного цикла стримов в TunnelService (прослушивание сокетных и потоковых ошибок).

package/docs/plans/findings.md

@@ -2,6 +2,18 @@
 
 ## Ключевые выводы анализа dsh-remote
 1. Преимущество 3-way sync: snapshot хешей предотвращает перезапись изменений при одновременном редактировании на сервере и локально.
-2. Проблема 21 инструмента rw_*: перегружает LLM prompt. В новом плагине объединяем в 4 сбалансированных инструмента: `remote_exec`, `remote_fs`, `remote_sync`, `remote_tunnel`.
-3. Модульность: вместо спагетти в `index.js` реализуем 4 отдельных Cordis сервиса.
+2. Проблема 21 инструмента rw_*: перегружает LLM prompt. В новом плагине объединяем в 4 сбалансированных инструмента: 
+emote_exec, 
+emote_fs, 
+emote_sync, 
+emote_tunnel.
+3. Модульность: вместо спагетти в index.js реализуем 4 отдельных Cordis сервиса.
 4. UI: использование нативных CSS переменных DSH, чистый React, поддержка i18n (EN/RU/ZH).
+
+## Результаты аудита стабильности и UI (Фаза 8)
+1. **Баг localMirrorPath**: в форме профиля отсутствовало поле ввода localMirrorPath, что блокировало синхронизацию зеркала (400 Error).
+2. **Баг рассинхронизации полей testConnection**: бэкенд отдавал latency/os, клиент ожидал latencyMs/
+emoteOs.
+3. **Утечка кэшированных SSH-соединений**: при смене хоста или ключа/пароля в профиле старое соединение с тем же id не сбрасывалось из пула SshService.
+4. **Отсутствие UI для SSH-туннелей**: туннели были поддержаны на бэкенде, но не имели интерфейса в карточке настроек.
+5. **Безопасность API**: отсутствовал фильтр isTrustedSettingsRequest(req) на мутирующих маршрутах.

package/docs/plans/progress.md

@@ -2,13 +2,14 @@
 
 ## Журнал выполнения
 - **2026-09-08**:
-  - Создан репозиторий `goodandready/dsh-remote-workspace` в Gitea.
-  - Создана задача Issue #1: `[critical] Initial implementation of dsh-remote-workspace plugin`.
-  - Создано worktree `issue-1-remote-workspace`.
-  - Оформлен обязательный дизайн-контракт `docs/design/DESIGN.md`.
-  - Реализованы 4 ключевых сервиса: `SshService`, `RemoteFsService`, `MirrorSyncService`, `TunnelService`.
-  - Зарегистрированы инструменты модели: `remote_exec`, `remote_fs`, `remote_sync`, `remote_tunnel`.
-  - Созданы API маршруты и клиентский компонент с поддержкой `i18n` (RU, EN, ZH).
-  - Написаны и успешно пройдены 12 тестов (юнит + интеграция SSH + интеграция туннелей + SFTP).
-  - Проверена упаковка `npm pack --dry-run`.
-  - Все изменения синхронизированы с веткой `feat/issue-1-remote-workspace` и PR #2.
+  - Создан репозиторий goodandready/dsh-remote-workspace в Gitea.
+  - Создана задача Issue #1: [critical] Initial implementation of dsh-remote-workspace plugin.
+  - Оформлен дизайн-контракт docs/design/DESIGN.md.
+  - Реализованы 4 сервиса и 4 инструмента модели.
+  - Пройдены первые 12 тестов.
+- **2026-09-09**:
+  - Обогащена документация по стандарту dsh-documentation-standard (EN/RU/ZH).
+- **2026-09-10**:
+  - Создано worktree stability-and-clinebot-ui для реализации Фазы 8.
+  - Выполнен детальный аудит стабильности кода и визуального слоя.
+  - Подготовлен и утвержден комплексный план.

package/docs/plans/task_plan.md

@@ -1,26 +1,23 @@
 # task_plan.md — dsh-remote-workspace
 
 ## Цель
-Создать высоконадежный корпоративный плагин удаленной разработки `dsh-remote-workspace` для DeepSeek Harness с современным UI, сервисной архитектурой Cordis, 3-way mirror sync, SSH port forwarding и компактным набором инструментов LLM.
+Создать высоконадежный корпоративный плагин удаленной разработки dsh-remote-workspace для DeepSeek Harness с современным UI, сервисной архитектурой Cordis, 3-way mirror sync, SSH port forwarding и компактным набором инструментов LLM.
 
 ## Фазы реализации
 - [x] **Фаза 1**: Анализ dsh-remote, формирование архитектуры, инициализация репозитория Gitea и worktree.
-- [x] **Фаза 2**: Конфигурация сборки и репозитория (`package.json`, `.gitignore`, `cordis.patch.yml`).
-- [x] **Фаза 3**: Ядро backend сервисов (`SshService`, `RemoteFsService`, `MirrorSyncService`, `TunnelService`).
-- [x] **Фаза 4**: Инструменты модели (`remote_exec`, `remote_fs`, `remote_sync`, `remote_tunnel`) и API маршруты.
+- [x] **Фаза 2**: Конфигурация сборки и репозитория (package.json, .gitignore, cordis.patch.yml).
+- [x] **Фаза 3**: Ядро backend сервисов (SshService, RemoteFsService, MirrorSyncService, TunnelService).
+- [x] **Фаза 4**: Инструменты модели (
+emote_exec, 
+emote_fs, 
+emote_sync, 
+emote_tunnel) и API маршруты.
 - [x] **Фаза 5**: Клиентская часть (i18n RU/EN/ZH, UI слоты).
-- [x] **Фаза 6**: Комплексное тестирование модулей:
-  - Модульные тесты `SshService` (парсинг ключей, disconnectAll).
-  - Краевые случаи 3-way sync (обнаружение конфликтов при одновременной правке, чистый pull).
-  - SFTP операции (потоковое чтение, атомарная запись через `.dsh-tmp`, posix stat).
-  - Сквозной интеграционный тест SSH-сервера (подключение, замер пинга, ОС, exec, обработка неверных паролей).
-  - Сквозной интеграционный тест SSH Port Forwarding (туннелирование HTTP-трафика через виртуальный зашифрованный канал).
-  - Синтаксический аудит файлов (`node --check`).
-  - Упаковка пакета (`npm pack --dry-run`).
-- [ ] **Фаза 7**: Дополнительные ручные сценарии и доводка по обратной связи пользователя (БЕЗ релиза и публикации).
-
-## Критерии приемки (DoD)
-1. Все 12 модульных и интеграционных тестов проходят стабильно (12/12 pass).
-2. Все файлы production-кода валидны по синтаксису Node.js.
-3. Пакет упаковывается чисто (размер ~15 КБ).
-4. Релиз заблокирован до отдельного явного подтверждения пользователя.
+- [x] **Фаза 6**: Комплексное тестирование базовых модулей (12/12 pass).
+- [x] **Фаза 7**: Дополнительные ручные сценарии и документация (Docs standard EN/RU/ZH).
+- [/] **Фаза 8**: Стабильность, аудит багов, расширение тестов и дизайн в едином стиле dsh-clinebot:
+  - [ ] 8.1. Исправление стабильности: безопасный доступ к Cordis сервисам (ctx.get), сброс соединений при смене реквизитов профиля, нормализация полей в 	estConnection (latencyMs / remoteOs).
+  - [ ] 8.2. Безопасность и отказоустойчивость: фильтрация isTrustedSettingsRequest на API маршрутах, обработка ошибок стримов в TunnelService, автосоздание папок в MirrorSyncService.
+  - [ ] 8.3. Редизайн UI в едином стиле dsh-clinebot: модульные карточки, статусные бейджи в шапке, добавление поля localMirrorPath, секция управления туннелями в интерфейсе.
+  - [ ] 8.4. Расширение набора тестов (тесты API routes, tools, store/apply, client registration).
+  - [ ] 8.5. Тестирование на изолированном MiniPC сервере (dsh-test-plugin).