@goodandready/dsh-moa 0.2.15 → 0.2.17

package/docs/design/DESIGN.md

@@ -1,79 +0,0 @@
-# DESIGN.md — dsh-moa
-
-## Product / Purpose
-- Назначение: Плагин для DeepSeek Harness, реализующий архитектуру Mixture of Agents (MoA) через команду `/moa <prompt>`. Позволяет параллельно генерировать варианты решения задачи несколькими моделями-кандидатами (proposers / reference models), после чего ведущая модель-агрегатор (judge / aggregator) оценивает ответы, отбирает лучшее, устраняет ошибки, продвигает созданные файлы в корень проекта и синтезирует итоговый результат. После завершения команды агент автоматически возвращается к основной модели текущей сессии.
-- Аудитория: Пользователи DeepSeek Harness, решающие сложные инженерные, исследовательские, математические и архитектурные задачи, требующие ансамбля моделей и перекрёстной валидации.
-- Статус: Active Development / Production Ready (quality-audit batch 2026-09-11: честная аналитика, English-canonical UI, безопасность сбора контекста)
-
-## User Surfaces
-- 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` (payload валидируется схемой; принимает `enabled`), `GET /dsh-moa/models`, `GET /dsh-moa/history`, `GET /dsh-moa/leaderboard`, `GET /dsh-moa/runs/<id>`, `POST /dsh-moa/run` (400 при `enabled: false`).
-- CLI / Slash Commands: Команда `/moa <prompt>` и `/moa [preset] <prompt>` в строке ввода DSH.
-- Документация: `docs/design/DESIGN.md`, `README.md`, `README.ru.md`.
-
-## Visual Direction & ClineBot Alignment
-- Атмосфера: Строгий нативный UI ядра DeepSeek Harness, гармонично встроенный в существующий интерфейс без визуального шума.
-- Утверждённый эталонный стиль: `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-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. `MoACard` / `MoAEditor` — панель настройки плагина со статусной строкой, секциями пресетов, советников, судьи, телеметрией и переключателем `enabled`.
-  2. `SearchableModelPicker` — быстрый выпадающий поиск моделей по провайдеру/названию с фильтрацией и поддержкой произвольных моделей.
-  3. `MoAErrorBoundary` — изоляция UI-ошибок с кнопкой повторной попытки.
-- Loading / empty / error / success:
-  - `loading` — состояние инициализации настроек и загрузки списка доступных моделей.
-  - `ready` — активная конфигурация с валидным списком моделей; статусный бейдж отражает фактический ответ `GET /dsh-moa/status` (online / offline / disabled), а не рисуется безусловно.
-  - `unavailable` — хост недоступен с кнопкой повторного подключения.
-  - `error` — индикация ошибки валидации или сохранения в `moa-alert-err`; невалидный payload `POST /dsh-moa/presets` отклоняется с 400.
-- Телеметрия: сетка статистики показывает Total Runs, Avg Run Cost (из `GET /dsh-moa/history`), Configured Models и Total Presets; при отсутствии данных — «—».
-- Формы, валидация и действия: Валидация наличия хотя бы одного советника и одного агрегатора.
-
-## User Flows
-- Критические сценарии:
-  1. Пользователь вводит `/moa <вопрос>` в composer:
-     - При вводе `/` отображается пункт `moa` в списке слэш-команд.
-     - После отправки запускается parallel fan-out на советников с живым отображением прогресса в чате.
-     - Агрегатор оценивает варианты, отбирает лучший код и синтезирует результат.
-     - Следующее сообщение автоматически выполняется на основной модели сессии.
-  2. Пользователь настраивает пресет в «Настройки -> Плагины -> Настройки плагинов -> Mixture of Agents»:
-     - Выбор кандидатов из доступных в `ctx.llm`.
-     - Выбор агрегатора и настройка температуры.
-     - Включение/отключение опросника уточняющих вопросов.
-     - Сохранение настроек через `settingsScope` / REST без перезапуска сервера.
-
-## Locked Design Decisions
-- 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-*`, глубокий аудит устойчивости).
-- 2026-09-11 — English-canonical пользовательские строки (сервер и клиент); ru-перевод предоставляет translation-плагин, собственный ru-дубль из пакета удалён. Причина: стандарт DSH (dsh-plugin-authoring); пересмотр — только по явному решению владельца.
-- 2026-09-11 — Заглушка Live Canvas удалена (фабрикация `http://localhost:3000/preview/...`); заявления README сняты. Реальная интеграция с `dsh-live-canvas` — отдельная задача (Gitea #46). Changed: прежний пункт про автопревью больше не действует.
-- 2026-09-12 — Реализован режим слепого судейства (`blind_evaluation: boolean`), гарантированное зеркалирование языка запроса (Language Mirroring Guard в промптах судьи и куратора), интерактивный лидерборд моделей (винрейт, запуски, победы, средняя стоимость) в секции аналитики UI и раздельные настройки таймаутов кандидатов и судьи в карточке настроек (Gitea Issue #57).
-- 2026-09-11 — Статусный бейдж карточки отражает фактический `GET /dsh-moa/status` (online / offline / disabled); телеметрия Total Runs / Avg Run Cost берётся из `GET /dsh-moa/history`. Причина: карточка не должна показывать состояния, которые она не проверяла.
-- 2026-09-11 — Переключатель `enabled` в карточке сохраняется через `settingsScope`/REST и влияет на `/moa`-turn и `POST /dsh-moa/run`.
-- 2026-09-11 (вечер) — Интеграция с Live Canvas реализована через собственный REST-контракт `@goodandready/dsh-live-canvas` (`POST /dsh-live-canvas/api/preview`, self-call на порт хоста `ctx.webServer.port`) с тихой деградацией при отсутствии плагина (любая ошибка → ответ без preview-ссылки). Заменяет прежнее решение об удалении фабрикованной заглушки: ссылка `/dsh-live-canvas/sandbox/<id>` теперь создаётся реальной песочницей.
-
-
-- 2026-09-12 — Реализация кураторского синтеза (`curator_synthesis`), строгой рубрики антипаттернов (`ANTIPATTERNS_RUBRIC`), живого потокового стриминга куратора (`stream_aggregator`), кворума кандидатов с льготным периодом (`quorum_enabled`, `grace_period_sec`), авторетрая транзиентных ошибок (`callWithTransientRetry`) и цепочки запасных судей (`aggregator_fallbacks`). Все опции конфигурируются в пресетах с сохранением 100% обратной совместимости.
-
-- 2026-09-12 (вечер) — Декомпозиция lib/moa-runner.js на специализированные модули (`lib/moa-prompts.js`, `lib/moa-parser.js`, `lib/moa-runner.js`) с соблюдением канонического лимита <= 800 строк. Реализация автоматической ротации истории при превышении 10 МБ (`rotateHistoryFileIfNeeded`) и неблокирующего асинхронного сохранения (`recordMoaRunAsync`). Настраиваемые таймауты кандидатов и агрегатора (`reference_timeout_sec`, `aggregator_timeout_sec`).
-
-- 2026-09-13 — Расширение функционала MoA (Gitea Issue #59): интерактивный селектор альтернативного кандидата в чате (User Candidate Override: allow_candidate_override), пакет из 10 специализированных пресетов с ролями кандидатов (role_persona), локальный гейт синтаксической проверки (Syntax Pre-check Gate) с директивой автоисправления синтаксиса судьёй, режим взаимного рецензирования («Консилиум» / Peer Critique Round 2: peer_critique_enabled), фильтрация лидерборда по пресетам и выгрузка телеметрии в CSV/JSON.
-
-- 2026-09-13 — Приведение локализации плагина в строгое соответствие со стандартами dhs-plugin-release-workflow и dsh-plugin-authoring (Gitea Issue #61): добавление полного китайского словаря (zh) в lib/client.js наряду с каноническим английским (en), удаление захардкоженных русских строк в серверной части (lib/moa-parser.js, lib/moa-runner.js), интернационализация эвристик в lib/file-workspace.js и lib/moa-prompts.js (en + zh), создание issue в goodandready/dsh-russian-lang для русификации.
-
-## 2026-09-15: Pipeline Stability & Quality Polish (#63)
-- **Refinement Context**: `formatProjectContext(files)` serializes workspace files as fenced Markdown code blocks. `moa-runner.js` passes collected files into `isRefinementTask(prompt, files)`.
-- **Round 2 Persistence**: Candidate file refinements from Round 2 are persisted to `.moa/candidate-N/` via `writeCandidateWorkspace`.
-- **AbortSignal Lifecycle**: `signal` is propagated end-to-end to terminate parallel LLM calls immediately when user aborts or disconnects.
-- **Token Protection**: Peer critique prompts summarize oversized competitor code blocks (>3000 chars) to prevent context window exhaustion.

package/docs/plans/47-client-js-split-plan.md

@@ -1,57 +0,0 @@
-# План: разбиение lib/client.js (issue #47)
-
-Статус: принято решение, реализация отложена до появления подтверждённой механики бандлера.
-Дата: 2026-09-11. Исполнитель: zcode. Связанная issue: #47.
-
-## Контекст
-
-Корневой чек-лист code review требует файл ≤800 строк; `lib/client.js` — ~1240 строк
-после батча качества. `MoAEditor` ≈500 строк, словари ≈110 строк, CSS ≈85 строк.
-Прямое разбиение упирается в механику клиентского бандлера DSH.
-
-## Собранный evidence (2026-09-11)
-
-1. **Харнесс отдаёт ровно один модуль на пакет**: на тест-контуре (DSH 0.1.5-rc.2)
-   клиент плагина обслуживается по единому URL
-   `/plugins/??@goodandready/dsh-moa/client.js&rev=<hash>` (combo-загрузчик);
-   реестр модулей в индекс-странице ссылается только на `client.js` пакета.
-2. **Ни один плагин семейства не использует относительный require в клиентском
-   коде**: dsh-lanmode (23 файла в lib/), dsh-tts (client.js 1851 строка),
-   dsh-model-sync (17 файлов), dsh-clinebot (5 файлов), dsh-grok-xsearch (14
-   файлов) — везде `require('./...')` в client.js отсутствует. Многофайловость
-   живёт только в серверной половине.
-3. Клиентская factory получает `require` (пакетные зависимости: `react`,
-   `@deepseek-ai/dsh-client-ui-primitives`) — документированных свидетельств
-   поддержки относительных require внутри клиентского модуля нет.
-
-## Варианты
-
-- **A. Оставить один файл (принято сейчас).** Нулевой риск для загрузки карточки;
-  известный компромисс с чек-листом зафиксирован в issue.
-- **B. Сборочная склейка (concat/минимальный bundler перед `npm pack`).** С.Split
-  исходников на части + prepublish-скрипт, собирающий `lib/client.js`.
-  Плюс: файлы в репозитории маленькие, публикуется по-прежнему один модуль.
-  Минус: в семействе нет ни одного плагина со сборочным шагом — вводит новую
-  конвенцию, усложняет publish-пайплайн и локальную отладку.
-- **C. Относительный require в клиенте.** Самый чистый вариант, но требует
-  подтверждённой поддержки в бандлере харнесса (эксперимент на тест-контуре).
-
-## Решение и критерии пересмотра
-
-- Сейчас — вариант A: риск поломки загрузки карточки выше пользы, а файл после
-  батча качества сократился (1240 строк против 1311) и остаётся цельным по смыслу.
-- Пересмотреть к варианту C, если появится подтверждённый пример относительного
-  require в клиентском модуле любого плагина семейства (эксперимент: маленький
-  пакет-проба `require('./client-part.js')` на тест-контуре + проверка загрузки
-  карточки без ошибок в консоли).
-- Пересмотреть к варианту B, если файл превысит ~1800 строк или в семействе
-  появится первый плагин со сборочным шагом.
-
-## Чек-лист разбиения (когда механика подтверждена)
-
-1. Вынести словари и `makeT` в `lib/client-dict.js`, стили — в `lib/client-styles.js`,
-   `SearchableModelPicker` — в `lib/client-picker.js`.
-2. `lib/client.js` остаётся единственной точкой входа `__ModuleLoader__.load`.
-3. Проверки: клиентский модуль отдаётся 200 по per-plugin URL; карточка
-   рендерится (settings.plugin.item) без ошибок в консоли; локали регистрируются;
-   HMR/обновление соседнего плагина не ломает стили (атрибут data-dsh-plugin).

package/docs/plans/55-resilience-plan.md

@@ -1,33 +0,0 @@
-# Task Plan: MoA Resilience, Async I/O, Configurable Timeouts and Modularization
-
-Issue: #55
-Branch: `feat/moa-resilience-refactor`
-Worktree: `/mnt/external/Project/DEV/dhsplugins/dsh-moa/.worktrees/feat/moa-resilience-refactor`
-
-## Objectives
-1. Modularize `lib/moa-runner.js` into clean, focused modules under 800 lines:
-   - `lib/moa-prompts.js`: Rubric, system prompts, synthesis and questionnaire prompts.
-   - `lib/moa-parser.js`: Output parsing, winner extraction, recommended assembler, file block extraction.
-   - `lib/moa-runner.js`: Focused pipeline orchestrator.
-2. Optimize storage in `lib/history.js`:
-   - Non-blocking async append via `fs.promises.appendFile`.
-   - File size rotation (>10MB or >5000 lines -> `.jsonl.1` backup).
-   - Fast tail reader for paginated history to avoid loading gigantic files in memory.
-3. Configurable timeouts in `lib/index.js` and `PresetSchema`:
-   - `reference_timeout_sec` (default: 60s).
-   - `aggregator_timeout_sec` (default: 180s).
-   - Forward timeouts into `callLlm` and `AbortController`.
-4. Fallback recovery on malformed judge output:
-   - When judge output is empty or truncated, cleanly fall back to `aggregator_fallbacks` before degrading.
-5. Verification & Tests:
-   - Add unit tests in `test/moa-resilience.test.mjs`.
-   - Verify existing 60/60 tests pass without regression.
-   - Update `docs/design/DESIGN.md` and README files.
-
-## Phases
-- [x] Phase 1: Planning & Setup (Issue #55, isolated worktree created, test suite verified)
-- [ ] Phase 2: Modularization of moa-runner (`lib/moa-prompts.js`, `lib/moa-parser.js`)
-- [ ] Phase 3: History Storage Rotation & Async I/O (`lib/history.js`)
-- [ ] Phase 4: Configurable Timeouts & Fallback Recovery (`lib/index.js`, `lib/moa-runner.js`)
-- [ ] Phase 5: Test Coverage & Verification (`test/moa-resilience.test.mjs`)
-- [ ] Phase 6: Documentation, PR, Merge, Release & Deploy

package/docs/plans/59-power-pack-plan.md

@@ -1,73 +0,0 @@
-# Plan 59: MoA Power Pack v0.2.13
-
-## Objectives
-Implement the 5 approved feature expansions for `@goodandready/dsh-moa`:
-1. User Candidate Override (`allow_candidate_override: boolean`).
-2. 10 specialized built-in presets + candidate role personas (`role_persona`).
-3. Syntax Pre-check Gate with Judge Auto-Fix Directive.
-4. Consilium / Peer Critique Round 2 (`peer_critique_enabled: boolean`).
-5. Analytics filtering by preset and CSV/JSON export.
-
----
-
-## Technical Specifications
-
-### 1. User Candidate Override
-- **Schema**: `PresetSchema` field `allow_candidate_override: z.boolean().default(false)`.
-- **Backend**:
-  - `writeCandidateWorkspace` stores candidates in `.moa-workspaces/<runId>/candidate-<index>`.
-  - Add API route `POST /dsh-moa/promote` with `{ runId, candidateIndex }` that promotes specified candidate files to the project root.
-  - In `formatMoAResponse`, if enabled, render interactive action hints:
-    `🔄 Alternative Candidate Override: /moa promote <runId> <candidateIndex>`
-- **Client**: Add toggle in Section 1 / Section 3 of `lib/client.js`.
-
-### 2. 10 Built-in Presets & Candidate Role Personas
-- **Presets**:
-  1. `default`: General MoA ensemble.
-  2. `code-review`: Zero regressions, backward compatibility, edge cases.
-  3. `fast-audit`: Quorum mitigation, low latency.
-  4. `deep-architect`: System architecture, API contracts, curator synthesis.
-  5. `bug-hunter`: Concurrency, race conditions, memory leaks, null safety.
-  6. `refactor-cleanup`: Ponytail minimalism, stdlib first, zero external dependencies.
-  7. `frontend-ui`: Ergonomics, DSH design tokens, responsive layout, no AI slop.
-  8. `security-audit`: OWASP Top 10, input sanitization, safe error handling.
-  9. `math-logic`: Algorithmic correctness, asymptotic proofs.
-  10. `creative-brainstorm`: High divergence, alternative architectures.
-- **Candidate Roles (`role_persona`)**:
-  - `minimalist`: Ponytail style, stdlib only, fewest lines.
-  - `robustness`: Paranoid validation, edge cases, defensive typing.
-  - `performance`: Memory efficiency, asymptotic complexity.
-  - `tester`: TDD, unit test coverage, mock isolation.
-  - `general`: Standard expert proposer.
-
-### 3. Syntax Pre-check Gate with Judge Auto-fix Directive
-- **Checker**:
-  - JS/MJS/CJS: `new vm.Script(code)` from built-in `node:vm` (instant, memory-safe).
-  - JSON: `JSON.parse(code)`.
-  - Python: `python3 -m py_compile`.
-- **Judge Directive**:
-  - If a candidate has a syntax warning, inform the judge:
-    `CRITICAL JUDGE DIRECTIVE: If Candidate X has the best overall architecture or solution despite this syntax error, DO NOT reject them! You MUST correct the syntax error directly during final code synthesis and declare Candidate X the winner.`
-
-### 4. Consilium / Peer Critique Round 2
-- **Schema**: `peer_critique_enabled: z.boolean().default(false)`.
-- **Pipeline**:
-  - If enabled and `candidates.length >= 2`, run Round 2:
-    - Pass anonymized candidate proposals to each proposer.
-    - Collect refined solutions with peer critique.
-    - Supply improved proposals to Judge/Curator.
-
-### 5. Analytics Filtering & CSV/JSON Export
-- **Leaderboard Filter**: `getMoaLeaderboard(historyFilePath, limit, filterPreset)`.
-- **Export Endpoints**:
-  - `GET /dsh-moa/leaderboard?preset=<name>&format=json|csv`.
-- **Client UI**:
-  - Dropdown filter by preset in Section 4.
-  - `Export CSV` / `Export JSON` action buttons.
-
----
-
-## Verification
-- Unit tests for all 5 features in `test/moa-power-pack.test.mjs`.
-- Total test suite passing with 0 regressions.
-- Live deployment to `/home/vadim/.dsh/profiles/web` on MiniPC and endpoint verification.

package/docs/plans/63-stability-polish-plan.md

@@ -1,15 +0,0 @@
-# Implementation Plan - Issue #63: Pipeline Stability and Quality Polish
-
-## 1. Context & Objectives
-Polish runtime stability, error recovery, token efficiency, and file generation integrity across `@goodandready/dsh-moa`:
-1. **Refinement Context & Heuristic**: Fix `isRefinementTask` parameter handling in `moa-runner.js` and format collected files into Markdown code fences via `formatProjectContext(files)`, preventing `[object Object]` prompt injection.
-2. **Round 2 Workspace Sync**: Save refined files to `.moa/candidate-N/` in Consilium Round 2 so promoted winner files contain peer-critiqued code rather than stale Round 1 drafts.
-3. **End-to-End AbortSignal Propagation**: Propagate `signal` from `streamMoATurn` through `runMoAPipeline`, `runReferencesParallel`, Round 2 calls, and judge synthesis, cancelling in-flight requests and preventing token waste.
-4. **Context Window Protection**: Apply `stripOrSummarizeCode` in Round 2 peer review and judge synthesis prompts when candidate outputs exceed threshold.
-5. **Architectural Standard**: Maintain file size of `lib/moa-runner.js` strictly under 800 lines.
-
-## 2. Modules Impacted
-- `lib/file-workspace.js`: Add `formatProjectContext`, enhance `isRefinementTask`.
-- `lib/moa-prompts.js`: Context protection in `buildPeerCritiquePrompt` & `buildSynthesisPrompt`.
-- `lib/moa-runner.js`: `signal` propagation, Round 2 workspace persistence, refinement context formatting.
-- `test/`: Add regression tests for all fixes.