@goodandready/dsh-moa 0.2.15 → 0.2.16

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.