@goodandready/dsh-moa 0.2.8 → 0.2.9

package/docs/design/DESIGN.md

@@ -1,64 +1,58 @@
 # DESIGN.md — dsh-moa
 
 ## Product / Purpose
-- Назначение: Плагин для DeepSeek Harness, реализующий архитектуру Mixture of Agents (MoA) через команду /moa <prompt>. Позволяет параллельно генерировать варианты решения задачи несколькими моделями-кандидатами (proposers / reference models), после чего ведущая модель-агрегатор (judge / aggregator) оценивает ответы, отбирает лучшее, устраняет ошибки и синтезирует итоговый результат. После завершения команды агент автоматически возвращается к основной модели текущей сессии.
+- Назначение: Плагин для DeepSeek Harness, реализующий архитектуру Mixture of Agents (MoA) через команду `/moa <prompt>`. Позволяет параллельно генерировать варианты решения задачи несколькими моделями-кандидатами (proposers / reference models), после чего ведущая модель-агрегатор (judge / aggregator) оценивает ответы, отбирает лучшее, устраняет ошибки, продвигает созданные файлы в корень проекта и синтезирует итоговый результат. После завершения команды агент автоматически возвращается к основной модели текущей сессии.
 - Аудитория: Пользователи DeepSeek Harness, решающие сложные инженерные, исследовательские, математические и архитектурные задачи, требующие ансамбля моделей и перекрёстной валидации.
-- Статус: Active Development
+- Статус: Active Development / Production Ready
 
 ## User Surfaces
-- Web/UI: Выпадающее меню composer при вводе /moa с подсказкой и описанием; отображение индикации MoA-хода в чате; DSH Settings Card в разделе плагинов.
-- DSH UI / settings / slots: слот settings.plugin.item ядра DSH, ключ dsh-moa. Сворачиваемая карточка настроек пресетов, советников, агрегатора и параметров генерации.
-- API: HTTP endpoints хоста: GET /dsh-moa/status, GET /dsh-moa/presets, PUT /dsh-moa/presets, POST /dsh-moa/run.
-- CLI / Slash Commands: Команда /moa <prompt> и /moa [preset] <prompt> в строке ввода DSH.
-- Документация: docs/design/DESIGN.md, README.md, README.ru.md.
+- Web/UI: Выпадающее меню composer при вводе `/moa` с подсказкой и описанием; отображение стриминга MoA-хода в чате в реальном времени с индикаторами кандидатов; карточка настроек плагина в DSH Settings Card (слот `settings.plugin.item`, ключ `dsh-moa`).
+- DSH UI / settings / slots: слот `settings.plugin.item` ядра DSH. Сворачиваемая карточка настроек пресетов, советников, агрегатора, опросника и параметров генерации, оформленная в едином стиле с `dsh-clinebot`.
+- API: HTTP endpoints хоста: `GET /dsh-moa/status`, `GET /dsh-moa/presets`, `POST /dsh-moa/presets`, `GET /dsh-moa/models`, `GET /dsh-moa/history`, `GET /dsh-moa/leaderboard`, `POST /dsh-moa/run`.
+- CLI / Slash Commands: Команда `/moa <prompt>` и `/moa [preset] <prompt>` в строке ввода DSH.
+- Документация: `docs/design/DESIGN.md`, `README.md`, `README.ru.md`.
 
-## Visual Direction
+## Visual Direction & ClineBot Alignment
 - Атмосфера: Строгий нативный UI ядра DeepSeek Harness, гармонично встроенный в существующий интерфейс без визуального шума.
-- Утверждённые референсы и что из них берём: Карточки настроек ядра («Консоль», «Цикл агента», «Поиск в вебе»); слэш-меню ядра DSH.
+- Утверждённый эталонный стиль: `dsh-clinebot` — чистые карточки секций `.moa-section-card`, информативная шапка `.moa-header` со статусными бейджами реального времени (`.moa-badge-ok`, `.moa-badge-brand`), сегментированные группы переключателей `.moa-seg-group`, ползунки температуры с числовыми бейджами `.moa-slider-badge`, сетка статистики `.moa-stat-box`.
 - Не копировать: Сторонние UI-библиотеки, неродные шрифты, кастомные акцентные цвета.
 
 ## Foundations
-- Цвета и роли: Исключительно переменные темы DSH (--dsw-alias-border-l2, --dsw-alias-bg-layer-3, --dsw-alias-label-primary, --dsw-alias-label-secondary, --dsw-alias-label-tertiary).
-- Типографика: Системный стек шрифтов DSH, заголовок карточки 15px/600, пояснения 13px, поля 13px.
-- Сетка, отступы, responsive: Карточка 12px border-radius, шапка padding 14px 16px, поля padding 12px 0.
-- Accessibility: aria-expanded для раскрытия карточки, семантические кнопки, клавиатурный фокус, контрастные лейблы полей.
+- Цвета и роли: Исключительно переменные темы DSH (`--dsw-alias-border-l2`, `--dsw-alias-bg-layer-2`, `--dsw-alias-bg-layer-3`, `--dsw-alias-label-primary`, `--dsw-alias-label-secondary`, `--dsw-alias-label-tertiary`, `--dsw-alias-state-brand-primary`, `--dsw-alias-state-success-primary`, `--dsw-alias-state-warning-primary`, `--dsw-alias-state-error-primary`).
+- Типографика: Системный стек шрифтов DSH, заголовок карточки 20px/700, заголовки секций 15px/600, пояснения 13px, поля 13px.
+- Сетка, отступы, responsive: Карточка 12px border-radius, шапка padding 14px 18px, секции padding 18px 20px, адаптивная сетка `grid-template-columns: repeat(auto-fit, minmax(200px, 1fr))`.
+- Accessibility: `aria-expanded` для раскрытия карточки, семантические кнопки, клавиатурный фокус, контрастные лейблы полей, встроенный `MoAErrorBoundary`.
 
 ## Components And States
 - Компоненты:
-  1. MoASettingsCard — карточка настройки плагина в списке настроек плагинов.
-  2. PresetEditor — редактор моделей-советников и агрегатора.
-  3. SlashTrigger — интеграция /moa в inputTriggers.
+  1. `MoACard` / `MoAEditor` — панель настройки плагина со статусной строкой, секциями пресетов, советников, судьи и телеметрией.
+  2. `SearchableModelPicker` — быстрый выпадающий поиск моделей по провайдеру/названию с фильтрацией и поддержкой произвольных моделей.
+  3. `MoAErrorBoundary` — изоляция UI-ошибок с кнопкой повторной попытки.
 - Loading / empty / error / success:
-  - loading — состояние инициализации настроек и загрузки списка доступных моделей.
-  - ready — активная конфигурация с валидным списком моделей.
-  - unavailable — хост недоступен или модуль не инициализирован.
-  - error — индикация ошибки при валидации или сохранении.
+  - `loading` — состояние инициализации настроек и загрузки списка доступных моделей.
+  - `ready` — активная конфигурация с валидным списком моделей и бейджем готовности.
+  - `unavailable` — хост недоступен с кнопкой повторного подключения.
+  - `error` — индикация ошибки валидации или сохранения в `moa-alert-err`.
 - Формы, валидация и действия: Валидация наличия хотя бы одного советника и одного агрегатора.
 
 ## User Flows
 - Критические сценарии:
-  1. Пользователь вводит /moa <вопрос> в composer:
-     - При вводе / отображается пункт moa в списке слэш-команд.
-     - После отправки запускается parallel fan-out на советников.
-     - Агрегатор синтезирует результат.
+  1. Пользователь вводит `/moa <вопрос>` в composer:
+     - При вводе `/` отображается пункт `moa` в списке слэш-команд.
+     - После отправки запускается parallel fan-out на советников с живым отображением прогресса в чате.
+     - Агрегатор оценивает варианты, отбирает лучший код и синтезирует результат.
      - Следующее сообщение автоматически выполняется на основной модели сессии.
   2. Пользователь настраивает пресет в «Настройки -> Плагины -> Настройки плагинов -> Mixture of Agents»:
-     - Выбор кандидатов из доступных в ctx.llm.
-     - Выбор агрегатора.
-     - Сохранение настроек без перезапуска сервера.
-
-## Do / Don't
-- Do:
-  - Использовать нативные переменные DSH --dsw-alias-*.
-  - Префикс moa- для всех CSS-классов.
-  - Обязательно восстанавливать модель сессии в блоке finally.
-  - Стрипать служебные tool-результаты перед отправкой советникам.
-- Don't:
-  - Не оставлять модель агрегатора активной после выполнения хода /moa.
-  - Не заводить отдельный раздел верхнего уровня в сайдбаре.
-  - Не передавать советникам системный промпт агента с инструментами.
+     - Выбор кандидатов из доступных в `ctx.llm`.
+     - Выбор агрегатора и настройка температуры.
+     - Включение/отключение опросника уточняющих вопросов.
+     - Сохранение настроек через `settingsScope` / REST без перезапуска сервера.
 
 ## Locked Design Decisions
-- 2026-09-03 — Реализация команды /moa как one-shot модификатора сессии с автовозвратом к базовой модели в finally.
-- 2026-09-03 — Использование settings.plugin.item со сворачиваемой карточкой вместо отдельной вкладки настроек.
-- 2026-09-03 — Поддержка именованных пресетов (default, code-review, deep-reasoning).
+- 2026-09-03 — Реализация команды `/moa` как one-shot модификатора сессии с автовозвратом к базовой модели в `finally`.
+- 2026-09-03 — Использование `settings.plugin.item` со сворачиваемой карточкой вместо отдельной вкладки настроек.
+- 2026-09-03 — Поддержка именованных пресетов (`default`, `fast`, `deep-reasoning`).
+- 2026-09-07 — Маршрутизация на реальные модели провайдеров (`targetPreset.aggregator`) без фиктивных сущностей.
+- 2026-09-08 — Опциональный опросник (`ask_clarifying_questions`), zero-latency live delta queue streaming.
+- 2026-09-10 — Унификация UI с дизайн-стандартом `dsh-clinebot` (статусные чипы в header, секционные карточки, дизайн-токены `--dsw-alias-*`, глубокий аудит устойчивости).
+