dsh-desktop-kit 2.2.0 → 2.7.2

package/docs/ROADMAP-3.0.md

@@ -0,0 +1,353 @@
+# DSH Memory Fabric — программа развития kit и плагинов
+
+**Дата:** 2026-11-09  
+**Статус:** предложение к утверждению (v1)  
+**Область:** `dsh-desktop-kit` 3.x, `dsh-memory-bridge` 3.x, `dsh-project-memory` 2.x,
+`dsh-profile-transfer` 2.x и остальные семь плагинов kit.
+
+---
+
+## 1. Коротко
+
+Сейчас это четырнадцать хороших локальных плагинов, которые работают по отдельности. Следующий уровень —
+**единая локальная «Memory Fabric»**: локальный Markdown остаётся источником истины, к нему
+добавляются проверяемые метаданные (происхождение, уверенность, время), локальный поиск и
+семантическое слияние, а GitHub остаётся транспортом и резервной копией. Сверху — один
+«Memory Hub» с диагностикой, историей, конфликтами и переносом между машинами.
+
+Цель программы:
+
+1. **Ноль молчаливых потерь данных** при синхронизации и переносах.
+2. **Память, которая умеет выбирать, что важно**, а не просто хранить всё (LongMemEval:
+   извлечение, многосессионные выводы, время, обновления, abstention).
+3. **Ноль обязательных токенов** для синхронизации и базовой памяти; LLM — только
+   по явному действию пользователя.
+4. **Промышленный релиз**: CI, тесты, безопасность, npm trusted publishing, документация.
+
+---
+
+## 2. Что уже есть (аудит на 2026-11-09)
+
+| Компонент | Версия | Сильные стороны | Ограничения |
+|---|---:|---|---|
+| `dsh-desktop-kit` | 2.7.2 | 14 плагинов, 30 навыков, сборка, update-safe, doctor, CI | 8.5 MB пакет, нет единого хаба и сквозной диагностики |
+| `dsh-project-memory` | 1.1.3 | локальный автоскан, дайджест ≤ 2800 символов, redaction, `/memory`, принятие синхронизированного досье | нет индекса/поиска, provenance/confidence, temporal, дедупликации, health-метрик |
+| `dsh-memory-bridge` | 2.2.1 | приватный GitHub, 3-way merge, конфликты, история/откат, проверка приватности, 0 токенов | нужен `gh`, merge по строкам, нет per-project controls, backoff, semantic merge, device flow |
+| `dsh-profile-transfer` | 1.3.1 | профиль, навыки, workspace, локальные плагины, bootstrap | архив `.tar.gz` без шифрования/подписи, нет preview/delta/rollback |
+| `dsh-gkb-ru-ui` | 2.0.1 | русская локализация | нет полного QA локали и глоссария |
+| `dsh-token-lab` | 1.0.0 | замер контекста, состав | нет прогноза бюджета, ROI навыков, алертов |
+| `dsh-peak-guard` | 1.2.0 | защита от пиков контекста | нет прогноза и per-model окон |
+| `dsh-session-move` | 1.0.0 | перенос сессий | нет транзакционности/rollback/bulk |
+| `dsh-skill-autopilot` | 1.0.1 | подсказка навыков | нет explainability, метрик успеха, семантического роутинга |
+
+Текущая проверка: kit `npm test` — exit 0; smoke 49/49, bridge 35/35,
+transfer 49/49; `check-client`, `validate-skills`, `build-client` — OK;
+kit установлен локально в профиль, bridge-маршруты живы.
+
+---
+
+## 3. Что говорит исследование (актуально на 2026-11-09)
+
+- **DSH-плагины — это Cordis Fiber.** `inject` ждёт сервисы; при исчезновении сервиса плагин
+  выгружается и загружается снова, HMR перезапускает `apply` и снимает старые регистрации.
+  Значит архитектуру нужно строить на `ctx.effect`, дочерних `ctx.plugin()` и явных `inject`,
+  не полагаясь на «вечные» глобальные объекты. ([DeepSeek Harness: plugins and lifecycle](https://github.com/deepseek-ai/DeepSeek-Harness/blob/master/docs/user/develop/framework/index.md?plain=1))
+- **LongMemEval (ICLR 2025)** измеряет пять способностей: извлечение информации,
+  многосессионное рассуждение, временное рассуждение, обновление знаний и abstention; у
+  коммерческих ассистентов и long-context LLM падение до 30%. Ключевые оптимизации —
+  сессионная декомпозиция, расширение ключей фактами и time-aware query expansion; стадии —
+  индексация, извлечение, чтение. ([LongMemEval, arXiv:2410.10813](https://arxiv.org/abs/2410.10813))
+- **Память — это не склад, а работа с решениями.** Обзоры бенчмарков показывают, что самые
+  сложные вопросы проверяют, что сохранить, что устарело, чему нельзя доверять и когда
+  воздержаться. ([What Do Memory Benchmarks Actually Measure?](https://huggingface.co/blog/mjfk/agentic-memory-benchmark))
+- **Mem0** строит память как pipeline `ADD/UPDATE/DELETE/NOOP`, но известны риски
+  галлюцинированных записей и потери истории при агрессивном update; **MemGPT** управляет
+  памятью через pressure-триггеры и дорогие LLM-вызовы. Вывод: нужна детерминированная база
+  с provenance/confidence и опциональная LLM-консолидация, а не постоянная LLM-запись.
+  ([Mem0, arXiv:2504.19413](https://arxiv.org/abs/2504.19413),
+  [MemGPT, arXiv:2310.08560](https://arxiv.org/abs/2310.08560))
+- **Local-first** — семь принципов: быстро, мультиустройство, офлайн, коллаборация, долговечность,
+  приватность, контроль пользователя; Git — хороший асинхронный транспорт, но не real-time
+  merge. ([Ink & Switch: Local-first software](https://www.inkandswitch.com/local-first/))
+- **CRDT (Yjs/Automerge)** дают автоматическое слияние, но хранят всю историю и могут давать
+  синтаксически невалидный Markdown при конкурентных правках; для асинхронной памяти одного
+  пользователя семантический блочный merge выгоднее. ([Yjs docs](https://docs.yjs.dev/),
+  [Automerge](https://automerge.org/))
+- **GitHub Device Flow** позволяет авторизовать CLI/desktop-приложение без `gh`, без
+  client secret и без собственного сервера; токен можно хранить в защищённом хранилище ОС.
+  ([GitHub: authorizing OAuth apps, device flow](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps#device-flow))
+- **npm trusted publishing** публикует через OIDC без долгоживущих токенов; provenance
+  автоматически подписывается Sigstore, но **не генерируется для приватных репозиториев**
+  и требует публичного repo/package. Это важно для нашего private-подхода.
+  ([npm trusted publishing](https://docs.npmjs.com/trusted-publishers),
+  [npm provenance](https://docs.npmjs.com/generating-provenance-statements))
+- **Секреты** надо ловить до публикации: gitleaks (git/dir/stdin, pre-commit, CI),
+  GitHub secret scanning/push protection, а не только redaction в памяти.
+  ([gitleaks](https://github.com/gitleaks/gitleaks),
+  [GitHub secret scanning](https://docs.github.com/en/code-security/secret-scanning))
+- **Локальный поиск** без сервера: SQLite FTS5/BM25; для 10–50k фактов достаточно
+  JS-инвертированного индекса или `node:sqlite`, без внешних сервисов.
+  ([SQLite FTS5](https://sqlite.org/fts5.html))
+
+---
+
+## 4. Целевая архитектура
+
+```
+                 ┌──────────────────────── DSH Memory Hub (UI) ───────────────────────┐
+                 │  статус · проекты · поиск · конфликты · история · перенос · doctor │
+                 └───────────────▲────────────────────────────▲───────────────────────┘
+                                 │ RPC                        │ RPC
+      ┌──────────────────────────┴─────────┐      ┌───────────┴──────────────────────┐
+      │ dsh-project-memory 2.x             │      │ dsh-memory-bridge 3.x           │
+      │ Markdown (канон)                   │      │ Semantic Sync Engine            │
+      │ + derived index (FTS/BM25)         │◄────►│ block merge · event log · retry │
+      │ + provenance/confidence/temporal   │      │ private GitHub transport        │
+      │ + health/doctor/bench              │      │ history · restore · conflict UI │
+      └──────────────┬─────────────────────┘      └───────────┬─────────────────────┘
+                     │                                        │
+      ┌──────────────▼─────────────┐             ┌────────────▼─────────────────────┐
+      │ dsh-profile-transfer 2.x   │             │ GitHub (private)                  │
+      │ encrypted signed archive   │             │ repo as cloud peer / history      │
+      │ preview · delta · rollback │             │ no personal data in package       │
+      └────────────────────────────┘             └───────────────────────────────────┘
+```
+
+### 4.1 Память (project-memory 2.0)
+
+- **Канон:** Markdown + JSON-манифест; journal — событийный JSONL/Markdown append-only.
+- **Derived index:** локальный индекс фактов/секций/журнала с BM25 + фильтрами
+  проект/тип/время; обновление инкрементальное; индекс можно удалить и перестроить.
+- **Fact model:** `id`, `text`, `kind`, `project`, `source`, `validFrom`, `recordedAt`,
+  `lastSeen`, `confidence`, `supersedes`, `tags`; без LLM — эвристики из заголовков/маркеров.
+- **Retrieval:** budget-aware упаковка (≤ N символов), recency/importance/confidence,
+  MMR-разнообразие, abstention при низком score; explain-почему факт попал в дайджест.
+- **Consolidation:** дедупликация near-duplicate, supersede по ключу, месячная архивация
+  журнала, «предложения» на основе git-диффов (review before write).
+- **Health:** stale/дубли/конфликты/отсутствующие секции/размер; `/memory doctor` + UI.
+- **Bench:** фикстуры на 5 способностей LongMemEval-типа (retrieval precision/recall,
+  temporal, update, abstention), прогон в CI; сравнение «digest vs full-context».
+
+### 4.2 Синхронизация (bridge 3.0)
+
+- **Semantic Markdown merge:** блоки Markdown (заголовок, список, таблица, параграф, код);
+  стабильные block-id по контент-хэшу; трёхсторонний merge на уровне блоков; списки —
+  union; таблицы — по ключу строки/столбца; журнал — append-only union. Конфликт только когда
+  один блок изменён по-разному; сохранение синтаксиса Markdown гарантировано.
+- **Operation log / base snapshots:** локальный append-only лог операций (deviceId, opId,
+  timestamp, blockId, hash) для диагностики/повторов; Git commit — снимок.
+- **Sync engine:** per-project sync/exclude, очередь, exponential backoff + jitter,
+  lock на проект, offline-детект, rate-limit-aware, статус сети/репо, идемпотентные retry;
+  «синхронизировать проект» и «исключить» в UI.
+- **Conflict UX:** 3-way diff по блокам, ручной редактор, «мой/их/оба/выбрать блоки»,
+  история и откат (уже есть), preview до записи, бэкап.
+- **Auth:** гибрид — существующий `gh` CLI + встроенный GitHub Device Flow OAuth
+  (без `gh`, без сервера), токен в ОС-хранилище (DPAPI), refresh/истечение, revoke;
+  проверка scope `repo`, private-only; никаких токенов в репозитории/логах.
+- **Transport safety:** проверка приватности перед каждым циклом (есть), gitleaks перед push,
+  redaction, блокировка при публичном репо, never force.
+- **Security:** threat model, secret scanning, SBOM? (опционально), safe mode.
+
+### 4.3 Перенос (profile-transfer 2.0)
+
+- **Encrypted archive:** AES-256-GCM + scrypt (или age-совместимый формат), passphrase,
+  подпись/манифест SHA-256, версия формата; потоково, без загрузки гигабайт в RAM.
+- **Preview/dry-run:** что будет перезаписано, конфликты реестра, размеры, diff.
+- **Selective restore:** по группам, per-profile, merge registry (уже есть), rollback snapshot.
+- **Delta/incremental:** по content-hash, исключение неизменных large workspaces.
+- **Bridge config:** перенос repo/branch/enabled/autoSync без машинных путей и секретов;
+  проверка, установлен ли bridge; после переноса — «подключить и включить» одним действием.
+- **Безопасность:** path traversal, limits, очистка temp, отзыв пароля/ключей.
+
+### 4.4 Kit UX 3.0
+
+- **Memory Hub** — единая секция настроек: health score, sync status, конфликты, история,
+  список проектов, поиск по досье/журналу, рекомендуемые действия.
+- **Notifications:** бейдж/уведомления о конфликтах, ошибках sync, stale памяти, приближении
+  контекстного пика; не спамить.
+- **`/kit doctor`:** окружение, git/gh/device flow, repo privacy, конфликты, плагины, навыки,
+  память, переносы; экспорт redacted ZIP диагностики.
+- **Accessibility/i18n:** AA-контраст, 1440/390, light/dark, reduced motion, keyboard;
+  ru/en/zh, единый глоссарий.
+- **Visual QA:** Playwright screenshots + diff, живые сценарии, preview-harness для CI.
+
+### 4.5 Остальные плагины
+
+- **gkb-ru-ui:** полный locale QA, глоссарий, переключение, скриншот-тесты.
+- **token-lab:** прогноз бюджета, стоимость навыков/ROI, prompt-composition diff, алерты.
+- **peak-guard:** прогноз пиков по модели/контексту, настраиваемые окна, auto-suggest compact.
+- **session-move:** транзакционный перенос, dry-run/rollback, bulk, проверка ссылок.
+- **skill-autopilot:** explainable top-k, локальный семантический роутинг (TF-IDF/BM25),
+  обратная связь по успеху, стоимость подсказки.
+- **profile-transfer:** см. 4.3.
+
+---
+
+## 5. Дорожная карта (10–12 недель, можно параллелить)
+
+### S0. Фундамент релиза и качества — 1 неделя
+
+- CI matrix (Windows/Node 22/24), `npm test`, `npm pack --dry-run`, `check-client`,
+  `validate-skills`, build reproducibility.
+- gitleaks pre-commit + CI; `npm audit`; secret scanning.
+- Release workflow: trusted publishing/OIDC, `publish.yml`, versioning, GitHub Release,
+  checksums, CHANGELOG.
+- Исправить/дописать то, что найдёт live-smoke kit 2.3.0.
+- **Выход:** зелёный CI, воспроизводимый `dsh-desktop-kit-2.3.0.tgz`, план публикации.
+
+### S0.5. Память на флешке — сделано (bridge 2.3.0 / kit 2.4.0)
+
+- экспорт досье в `dsh-memory-portable/` на флешку;
+- манифест + SHA-256 каждого файла;
+- сканирование флешки, статусы new/update/same;
+- импорт с бэкапом существующих досье;
+- UI в настройках «Память проектов» → «Перенос через флешку»;
+- тест: экспорт → подмена файла отклоняется → импорт на третью машину.
+
+### S1. Sync 3.0: надёжность и семантика — 2–3 недели
+
+- per-project sync/exclude; lock; backoff/jitter; offline queue; retry.
+- backoff-логи и метрики; `/sync` diagnostic (уже есть) + redacted bundle.
+- semantic block merge прототип + fuzz-тесты (1000 случайных правок, 0 silent loss).
+- conflict preview/diff на блоках; manual editor.
+- device flow OAuth (opt-in) + DPAPI token store; `gh` fallback.
+
+### S2. Memory 2.0: индекс и качество — 2–3 недели
+
+- derived index + incremental rebuild; search API/tool; budget-aware retrieval; explain.
+- provenance/confidence/temporal; dedup/supersede; health/doctor; monthly journal archive.
+- digest: conflict/error alert только при проблеме; abstention.
+- benchmark suite + CI; memory proposals из git diff (review).
+
+### S3. Transfer 2.0: шифрование и перенос — 2 недели
+
+- encrypted signed archive; preview/dry-run; rollback; delta.
+- bridge config; post-transfer doctor; bootstrap.
+- tests: wrong passphrase, tamper, path traversal, huge workspace, rollback.
+
+### S4. Hub и остальные плагины — 2–3 недели
+
+- Memory Hub, notifications, `/kit doctor`, search UI, history/timeline.
+- token-lab, peak-guard, session-move, autopilot, gkb upgrades.
+- accessibility/i18n and visual regression.
+
+### S5. Релиз 3.0 — 1 неделя
+
+- migration/upgrade docs, screenshots, README, security policy, FAQ.
+- load/perf tests; memory/cpu budgets.
+- npm publish bridge 3.0 + kit 3.0 (staged/trusted), GitHub Release, checksums.
+- post-release smoke on clean profile.
+
+---
+
+## 6. Приоритетный backlog
+
+| Приоритет | Задача | Компонент | Проверка |
+|---|---|---|---|
+| P0 | per-project sync/exclude + backoff/jitter + lock | bridge | тесты на 2 клонах, retry, offline |
+| P0 | semantic block merge + fuzz | bridge | 1000 сценариев, нет молчаливой потери |
+| P0 | gitleaks + CI + release workflow | kit | CI зелёный, gitleaks 0 |
+| P0 | encrypted transfer archive + preview/rollback | transfer | wrong key/tamper/path traversal |
+| P0 | `/kit doctor` + redacted diagnostic bundle | kit | live-сценарии |
+| P1 | derived memory index + search + explain | memory | precision/recall fixtures |
+| P1 | provenance/confidence/temporal + health | memory | doctor/bench |
+| P1 | device flow OAuth + DPAPI | bridge | auth flow без gh |
+| P1 | Memory Hub + notifications | kit | 1440/390, light/dark, AA |
+| P1 | token-lab forecast/ROI, peak-guard forecast | token-lab/peak-guard | расчёты + UI |
+| P2 | memory proposals из git diff (review) | memory/bridge | approve/reject |
+| P2 | optional local embeddings | memory | offline benchmark |
+| P2 | CRDT/real-time collaboration | bridge | research spike, не в 3.0 |
+
+---
+
+## 7. Метрики и критерии приёмки
+
+**Данные**
+- 1000 случайных сценариев merge: ни одной молчаливой потери; 100% восстановимо.
+- restore/history/backup проверены на реальном репозитории.
+- transfer: tamper/wrong passphrase/path traversal отклоняются.
+
+**Синхронизация**
+- Успешность после retry ≥ 99% в тестовом сценарии; p95 ручной sync ≤ 5 c для 100 файлов.
+- Публичный репозиторий → синхронизация остановлена; неизвестная приватность → остановлена.
+- 0 токенов LLM на синхронизацию.
+
+**Память**
+- Дайджест ≤ 2800 символов по умолчанию; retrieval ≤ 1200 символов в контексте.
+- Benchmark: precision@k/recall/abstention выше baseline «full dossier» на синтетике.
+- `/memory doctor` находит stale/дубли/конфликты; исправление не удаляет данные.
+
+**UX**
+- 1440/768/390, light/dark, AA, нет горизонтального скролла; setup ≤ 5 кликов.
+- Visual regression: 0 необъяснённых diff.
+
+**Релиз**
+- CI зелёный на Windows; пакет детерминирован; npm publish dry-run OK.
+- Trusted publishing или явно документированный exception (private repo → no provenance).
+- README/скриншоты/CHANGELOG/security policy обновлены.
+
+---
+
+## 8. Риски и откат
+
+| Риск | Митигация |
+|---|---|
+| Повреждение досье merge-ом | backup перед записью (есть), snapshots, restore, fuzz, never force |
+| Рассинхронизация схем | версионирование JSON, миграции + тесты, `schemaVersion` |
+| Раздувание пакета | allowlist, build-time excludes, size budget 10 MB |
+| Токены/секреты | redaction, gitleaks, secret scanning, DPAPI, private-only, revoke |
+| Сложность CRDT | не вводим в 3.0; semantic merge + operation log |
+| LLM-стоимость | deterministic by default; LLM только явно и с бюджетом |
+| Несовместимость DSH | matrix 0.2.x, `inject`/Fiber, HMR tests, version gate |
+| Публикация из private repo | документируем отсутствие provenance; вариант — public source repo |
+
+**Откат:** feature-флаг на каждую новую подсистему, старые версии плагинов в CHANGELOG,
+локальные бэкапы, `dsh-desktop-kit` rollback, restore из GitHub commit.
+
+---
+
+## 9. Решения, которые нужны от владельца
+
+1. **Merge:** semantic block merge (рекомендую) или CRDT-подход?
+2. **Auth:** оставить только `gh` или добавить встроенный Device Flow (рекомендую гибрид)?
+3. **Retrieval:** детерминированный локальный индекс (рекомендую) или сразу эмбеддинги?
+4. **Шифрование переносов:** включать по умолчанию passphrase (рекомендую да) или опционально?
+5. **Публикация/provenance:** оставить репозитории private (provenance не будет) или сделать
+   исходники kit/bridge публичными ради trusted publishing/provenance?
+6. **Темп:** сначала S0+S1 (sync/quality), затем S2 (memory) — или memory важнее?
+
+---
+
+## 10. Первый спринт (S0) — конкретные шаги
+
+1. `.github/workflows/test.yml`: matrix Windows, Node 22/24; `npm test`, `npm pack --dry-run`,
+   `check-client`, `validate-skills`.
+2. `.github/workflows/security.yml`: gitleaks + `npm audit`; fail on findings.
+3. `.github/workflows/publish.yml`: OIDC trusted publishing (после решения по п.9.5),
+   staged publish, `id-token: write`, `repository.url` в package.json.
+4. `docs/SECURITY.md`, `SECURITY.md`, `docs/RELEASE.md`.
+5. Bridge: backoff/jitter, per-project controls, sync diagnostics; тесты.
+6. Memory: conflict alert в дайджесте + `/memory doctor`; тесты.
+7. Transfer: manifest checksum + preview/dry-run; тесты.
+8. Kit: `/kit doctor` + redacted bundle; screenshot acceptance.
+9. Прогнать live-smoke: настройки, синхронизация, конфликт, история, перенос.
+10. Обновить CHANGELOG/README/roadmap после каждого спринта.
+
+---
+
+## Источники
+
+- [DeepSeek Harness: plugins and lifecycle](https://github.com/deepseek-ai/DeepSeek-Harness/blob/master/docs/user/develop/framework/index.md?plain=1)
+- [DeepSeek Harness: your first plugin](https://github.com/deepseek-ai/DeepSeek-Harness/blob/master/docs/user/develop/basic/index.md?plain=1)
+- [LongMemEval, ICLR 2025 (arXiv:2410.10813)](https://arxiv.org/abs/2410.10813)
+- [What Do Memory Benchmarks Actually Measure? (2026)](https://huggingface.co/blog/mjfk/agentic-memory-benchmark)
+- [Mem0 (arXiv:2504.19413)](https://arxiv.org/abs/2504.19413)
+- [MemGPT (arXiv:2310.08560)](https://arxiv.org/abs/2310.08560)
+- [Local-first software, Ink & Switch](https://www.inkandswitch.com/local-first/)
+- [Yjs CRDT documentation](https://docs.yjs.dev/)
+- [GitHub OAuth device flow](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps#device-flow)
+- [npm trusted publishing](https://docs.npmjs.com/trusted-publishers)
+- [npm provenance](https://docs.npmjs.com/generating-provenance-statements)
+- [gitleaks](https://github.com/gitleaks/gitleaks)
+- [GitHub secret scanning](https://docs.github.com/en/code-security/secret-scanning)
+- [SQLite FTS5](https://sqlite.org/fts5.html)

package/docs/ROADMAP.md

@@ -4,7 +4,7 @@
 
 ## Уже в 2.0
 
-- компактные ядра навыков и references (25 навыков);
+- компактные ядра навыков и references (30 навыков);
 - `dsh-skill-autopilot` — навыки применяются по смыслу запроса, а не по памяти модели;
 - `dsh-token-lab` — живой замер контекста, состав, топ потребителей, экономия библиотеки;
 - Skills Studio — редактирование, создание, дублирование и удаление навыков в GUI;

package/docs/SUBAGENTS.md

@@ -0,0 +1,25 @@
+# Субагенты: роли и запуск
+
+Постоянный набор ролей живёт в навыке `subagent-playbook` (промпты — в
+`skills/subagent-playbook/references/prompts.md`). Роли нужны не «для количества», а как
+независимая проверка.
+
+| Роль | Когда | Результат |
+|---|---|---|
+| **research-scout** | нужны свежие факты/версии/практики | матрица вариантов + ссылки |
+| **ui-critic** | UI готов или «поехал» | 5–7 правок + скриншоты |
+| **responsive-qa** | адаптив, overflow, мобилки | список багов + измерения |
+| **release-auditor** | релиз/публикация | go/no-go, блокеры |
+| **code-reviewer** | большой дифф | баги/регрессии, severity |
+
+## Как попросить Lead
+- «Запусти research-scout по <тема> и принеси матрицу вариантов».
+- «Запусти ui-critic на скриншотах 1440/768/390, нужен список правок».
+- «Перед релизом — release-auditor, файлы не менять».
+- «Сделай code-reviewer по этим диффам и верни только блокеры».
+
+## Правила
+- 1–2 роли на задачу; не дублировать одну работу.
+- Роль-читатель не меняет файлы; пишет только отчёт.
+- Решение и финальный ответ остаются за Lead.
+- Параллельно — только независимые роли; зависимые — последовательно.

package/docs/TEST-0.2.2.md

@@ -1,17 +1,17 @@
 # Тест на DeepSeek Harness 0.2.2-rc.1 (win-x64)
 
-Дата: **2026-11-06** · пакет: **dsh-desktop-kit 2.2.0** (первый прогон — 2.1.3, фикс автопилота — 2.1.4) · ОС: Windows 11.
+Дата: **2026-11-06** · пакет: **dsh-desktop-kit 2.2.1** (первый прогон — 2.1.3, фикс автопилота — 2.1.4) · ОС: Windows 11.
 
 ## Стенд
 
-- Установщик: `deepseek-harness-0.2.2-rc.1-win-x64.exe` (293 425 336 байт), распакован в `C:\Users\bulav\dsh-022-runtime` (7-Zip, без установки поверх рабочего DSH).
+- Установщик: `deepseek-harness-0.2.2-rc.1-win-x64.exe` (293 425 336 байт), распакован в `C:\Users\<user>\dsh-022-runtime` (7-Zip, без установки поверх рабочего DSH).
 - Версия рантайма: `0.2.2-rc.1`, Node `24.21.0`, pnpm `11.28.5`.
-- Изолированный `DSH_HOME`: `C:\Users\bulav\dsh-022-home` — рабочий профиль пользователя не тронут.
+- Изолированный `DSH_HOME`: `C:\Users\<user>\dsh-022-home` — рабочий профиль пользователя не тронут.
 - Профиль `probe` создан из шаблона `web`:
   ```powershell
-  $env:DSH_HOME = 'C:\Users\bulav\dsh-022-home'
+  $env:DSH_HOME = 'C:\Users\<user>\dsh-022-home'
   dsh --profile probe --from-default-profile web --dump-config
-  dsh plugin --profile probe add C:\Users\bulav\OneDrive\Desktop\Projects\dsh
+  dsh plugin --profile probe add C:\Users\<user>\OneDrive\Desktop\Projects\dsh
   ```
   Установка из репозитория прошла как `link:...\Projects\dsh`; `--dump-config` показывает ряд `dsh-desktop-kit`.
 - Для UI-проверок скопирован локальный `.credentials.yaml`, модель переключена на `provider: deepseek-account` (иначе web-профиль 0.2.2 по умолчанию идёт в `deepseek-official` без API-ключа).
@@ -42,7 +42,7 @@
 
 ## Обновление до 2.2.0 (проверено на этом же стенде)
 
-- В `C:\Users\bulav\dsh-022-home` не было state-файла; один навык (`code-review-checklist`) был намеренно изменён в Skills Studio.
+- В `C:\Users\<user>\dsh-022-home` не было state-файла; один навык (`code-review-checklist`) был намеренно изменён в Skills Studio.
 - После запуска 2.2.0: 24 навыка приняты как пакетные, **1 конфликт** (`modified-unknown-base`), правка сохранена в файле; в UI по-прежнему 25 карточек.
 - `/kit status` вернул `DSH Desktop Kit 2.2.0`, `Плагины: 7/7`, `конфликтов: 1`, путь состояния.
 - `window.__DSH_DESKTOP_KIT__`: version `2.2.0`, 5 частей, `errors: []`.

package/docs/TEST-2.3.0.md

@@ -0,0 +1,49 @@
+# Отчёт тестирования 2.3.0
+
+Дата: **2026-11-09** · пакет: **dsh-desktop-kit 2.3.0** + **dsh-memory-bridge 2.2.1** · ОС: Windows 11 · Node.js 24.20 · DSH `0.2.2-rc.1` (win-x64).
+
+## Что изменилось
+
+- Восьмой плагин `dsh-memory-bridge`: GitHub-обмен досье между машинами, страница «Настройки → Память проектов», 3-way merge, конфликты, история/откат, проверка приватности.
+- `dsh-project-memory` подхватывает готовое досье с другой машины и переселяет реестр на локальный путь вместо `<slug>-2`.
+- `dsh-profile-transfer` сливает `projects-memory/registry.json` с локальным и пересчитывает пути с машины-источника.
+- Клиентская половина пакета: 6 частей вместо 5, сборка `client.js` 471 411 байт.
+
+## Прогоны
+
+| Проверка | Команда | Результат |
+|---|---|---|
+| Kit smoke | `node tools/smoke-tests.mjs` | 2/2: объединённый клиент и Token Lab регистрируются, части изолированы |
+| Память проектов | `node tools/memory-tests.mjs` | OK: автоскан, redaction, дайджест, инструмент, **адопция досье** и **переселение реестра** |
+| Синхронизация навыков | `node tools/skills-sync-tests.mjs` | OK: обновление, конфликт, бэкап, baseline |
+| Обновление пакета | `node tools/kit-upgrade-tests.mjs` | OK: 25 навыков, правка пользователя сохранена, `/kit status` — **8/8** |
+| Перенос профиля | `node plugins/dsh-profile-transfer/test/transfer.test.mjs` | **49 passed, 0 failed**, включая слияние реестра проектов |
+| GitHub-мост | `node --test plugins/dsh-memory-bridge/test/*.test.mjs` | **35 passed, 0 failed**: 2 клона, конфликты, redaction, per-user GitHub, приватность, история |
+| Клиент | `node tools/build-client.mjs` + `node tools/check-client.mjs client.js` | 6 частей; id `dsh-desktop-kit`, `apply` — функция, синтаксис OK |
+| Навыки | `node tools/validate-skills.mjs` + `node tools/skill-cost.mjs --check` | 25 навыков, frontmatter и ссылки OK; ядра 38 103 токенов, максимум ядра 2 081 токен |
+| Упаковка | `npm pack` | 302 файла, 8 498 950 байт (11 035 272 распакованных); тесты и `support/` не входят, 6 PNG моста входят |
+| Установка из tarball | `npm install dsh-desktop-kit-2.3.0.tgz` в чистый каталог | OK: `apply` — функция, версия 2.3.0, `client.js`, `docs/images`, `lib/**` на месте |
+| Установка моста | `npm install dsh-memory-bridge-2.2.1.tgz` в чистый каталог | OK: `apply` — функция, `inject: ["connection","commands"]`, `client.js` и 6 PNG на месте |
+
+## Проверки на временных `DSH_HOME`
+
+1. **Досье без реестра.** Папка `projects-memory/clinic-app` с `PROJECT.md` создана до первого запуска плагина. После старта: один проект `clinic-app`, папки `clinic-app-2` нет, текст досье сохранён.
+2. **Реестр с чужого пути.** `registry.json` указывает на `old-machine\clinic-app`; после открытия проекта корень заменён на локальный, дубля нет.
+3. **Импорт архива на машину с локальными проектами.** `dsh-profile-transfer` сохраняет `local-project`, добавляет `example-project` и пересчитывает его корень на новый home; счётчик `projectsRegistry.added = 1`.
+
+## Визуальный гейт
+
+Новых экранов в 2.3.0 нет: страница моста уже проверена в 2.2.0 (скриншоты `plugins/dsh-memory-bridge/docs/images/`: light/dark/390, конфликты, мастер подключения), остальные экраны не менялись. В этой сессии проверена регистрация шести клиентских частей в общем бандле; живой браузерный прогон не повторялся, чтобы не менять установленный профиль.
+
+## Ограничения
+
+- Живой `npm publish` требует авторизации npm; на машине токен в `~/.npmrc` возвращает `401`, поэтому пакеты собраны и проверены локально, а публикация — отдельный шаг.
+- `dsh-memory-bridge` требует `git` и `gh` на каждой машине; без них синхронизация показывает точные шаги в UI.
+- Первый импорт архива на машину с другим home пересчитывает пути только по префиксам `origin.userHome` / `origin.dshHome`; нестандартные сетевые пути нужно проверить вручную.
+
+## Откат
+
+- Пакет: `npm install dsh-desktop-kit@2.2.1` (или предыдущий tarball), перезапуск DSH.
+- Навыки: `/kit force` не нужен; state и бэкапы лежат в `~/.dsh/skills/.dsh-kit-skills.json` и `.dsh-kit-backups/`.
+- Память проектов: перед импортом `dsh-profile-transfer` создаёт `~/.dsh/backup-import-*`; досье не удаляются.
+- Мост: отключить синхронизацию переключателем на странице; состояние — в `~/.dsh/memory-sync`.

package/docs/TEST-2.7.2.md

@@ -0,0 +1,46 @@
+# Отчёт тестирования 2.7.2
+
+Дата: **2026-11-10** · пакет: **dsh-desktop-kit 2.7.2** · ОС: Windows 11 · Node.js 24.20 · DSH `0.2.2-rc.1` (win-x64).
+
+## Что изменилось
+
+- Метаданные и документация приведены к фактической версии 2.7: README 2.7, 14 плагинов, 30 навыков, описание пакета, CHANGELOG 2.4–2.7.
+- Картинки README переведены с npm CDN (`@2.3.0`, ещё не опубликован) на относительные пути.
+- Обновлены `docs/ARCHITECTURE.md`, `docs/COMPATIBILITY.md`, `docs/INSTALL.md`, `docs/TOKENS.md`, `docs/TROUBLESHOOTING.md`, `docs/ROADMAP*`.
+- Код плагинов не менялся относительно 2.7.1; `client.js` пересобран только из-за версии.
+
+## Прогоны
+
+| Проверка | Команда | Результат |
+|---|---|---|
+| Kit smoke | `node tools/smoke-tests.mjs` | 3/3: объединённый клиент, Token Lab, угловой peak-guard toast и праздники Китая |
+| Память проектов | `node tools/memory-tests.mjs` | OK: автоскан, redaction, дайджест, адопция досье и переселение реестра |
+| Синхронизация навыков | `node tools/skills-sync-tests.mjs` | OK: обновление, конфликт, бэкап, baseline |
+| Обновление пакета | `node tools/kit-upgrade-tests.mjs` | OK: 30 навыков, правка пользователя сохранена, `/kit status` — 14/14 |
+| Перенос профиля | `node plugins/dsh-profile-transfer/test/transfer.test.mjs` | **52 passed, 0 failed** |
+| GitHub-мост | `node --test plugins/dsh-memory-bridge/test/*.test.mjs` | **36 passed, 0 failed** |
+| Repo map / checkpoints / plan | `tools/repo-map-tests.mjs`, `tools/checkpoints-tests.mjs`, `tools/plan-mode-tests.mjs` | OK |
+| Browser QA / GitHub review | `tools/browser-qa-tests.mjs`, `tools/github-review-tests.mjs` | OK |
+| Guardrails | `plugins/dsh-guardrails/tools/guardrails-tests.mjs` | OK, **39 тестов** |
+| Клиент | `node tools/build-client.mjs` + `check-client.mjs` | 6 частей, 511 979 байт, id и `apply` корректны |
+| Навыки | `validate-skills.mjs` + `skill-cost.mjs --check` | 30 навыков; ядра 42 638 токенов, все в бюджете |
+| Упаковка | `npm pack` / `npm publish --dry-run` | 358 файлов, 8.8 МБ (11.7 МБ распакованных) |
+| Установка из tarball | `npm install dsh-desktop-kit-2.7.2.tgz` в чистый каталог | OK: `apply` — функция, все 14 плагинов и `client.js` на месте |
+
+SHA-256 tarball: `1C98B26A4906F9E55585AB475A778A04DC630117497B2ACB18C9C22B405D6AD6`.
+
+## Установка в профиль
+
+`plugin_manager install_bundle` с локальной папкой репозитория обновляет профиль `desktop` с npm-версии 2.2.1 на 2.7.2. Host-часть монтирует 14 плагинов; клиентская графика требует `Ctrl+R` в окне DSH. Навыки синхронизируются при старте с бэкапом, правки пользователя не перезаписываются.
+
+## Ограничения
+
+- `browser-qa-tests.mjs` использует локальный Chrome/Edge; на машине без браузера часть проверок может быть пропущена.
+- npm-публикация по-прежнему требует `npm login` под владельцем `dsh-desktop-kit`; в этой сессии токен возвращает `401`.
+- Новые экраны (USB-память, режимы переноса, угловой toast) проверены ранее своими наборами скриншотов; в 2.7.2 визуальный код не менялся.
+
+## Откат
+
+- Профиль: `plugin_manager install_bundle` с предыдущим tarball 2.3.0/2.7.1 или `npm install dsh-desktop-kit@2.2.1`.
+- Навыки: `.dsh-kit-backups/skills/`; состояние — `~/.dsh/skills/.dsh-kit-skills.json`.
+- Память и переносы: бэкапы `~/.dsh/backup-import-*`, `memory-sync/backups/`.

package/docs/TOKENS.md

@@ -1,4 +1,4 @@
-# Экономия токенов в DSH Desktop Kit 2.2
+# Экономия токенов в DSH Desktop Kit 2.7
 
 Документ отвечает на три вопроса: **куда уходили токены раньше**, **что изменилось в 2.x** и **как измерить эффект** на своей сессии.
 
@@ -111,7 +111,7 @@ node tools/skill-cost.mjs --json > skill-cost.json
 | `seo` ядро | ≈11 000 токенов | ≈2 000 |
 | `wow-design` ядро | ≈5 000 токенов | ≈1 900 |
 | `skills-router` ядро | ≈2 900 токенов | ≈1 700 |
-| Библиотека из 25 навыков | ≈60 600 токенов | ≈37 600 |
+| Библиотека из 30 навыков | ≈60 600 токенов | ≈42 600 |
 | Типовая задача (3 ядра) | 15 000–30 000 | ≈4 500 |
 | Подсказка автопилота | — | 80–140 |
 

package/docs/TROUBLESHOOTING.md

@@ -7,6 +7,33 @@
 3. Поставьте `dsh-desktop-kit` заново через «Add plugin».
 4. Перезапустите DSH.
 
+## После обновления клиента: «Нет разрешения на запись» / `ERR_PNPM_EPERM`
+
+Это не ACL и не антивирус: в `node_modules` остался старый **junction** от локальной установки (`link:`), пока пакет уже убран из `package.json`. pnpm не может заменить ссылку и падает.
+
+1. Полностью закройте DSH.
+2. Проверьте, что это ссылка, и удалите **только её** (цель-репозиторий не трогайте):
+
+   ```powershell
+   $link = "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-desktop-kit"
+   (Get-Item $link -Force).LinkType   # Junction
+   cmd /c "rmdir `"$link`""
+   ```
+
+3. Удалите временные копии от неудачных попыток:
+
+   ```powershell
+   Remove-Item "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\.ignored\dsh-desktop-kit_tmp_*" -Recurse -Force -ErrorAction SilentlyContinue
+   ```
+
+4. Поставьте пакет заново:
+
+   ```powershell
+   dsh plugin --profile desktop add dsh-desktop-kit@2.7.2
+   ```
+
+5. Запустите DSH; в профиле должен появиться `dsh-desktop-kit` в `dependencies` и `dsh.profile.bundles`.
+
 ## Плагин установился, но ничего не появилось
 
 - В «Плагинах» переключатель `dsh-desktop-kit` включён?

package/docs/UI-QA.md

@@ -0,0 +1,28 @@
+# UI QA — постоянный визуальный гейт
+
+## Обязательный набор
+| Ширина | Что проверяем |
+|---|---|
+| 1440×900 | десктоп, две колонки, длинные пути |
+| 768×1024 | планшет, переносы, модалки |
+| 390×844 | мобилка, кнопки, safe-area, composer |
+
+Темы: light/dark, если есть; состояния: loading/empty/error/disabled.
+
+## Автоматически
+1. Открыть экран (живой DSH или preview-harness с реальным client.js).
+2. Снять PNG на каждой ширине.
+3. Проверить `document.documentElement.scrollWidth <= clientWidth`.
+4. Найти элементы с `scrollWidth > clientWidth + 1` и видимым overflow.
+5. Открыть PNG глазами: отступы, обрезания, фокус, контраст.
+
+## Команды
+См. `skills/visual-qa/references/commands.md` — Chrome headless, CDP-проверка overflow,
+превью-харнесс bridge и peak-toast.
+
+## Приёмка
+- 0 горизонтального скролла на 390/768/1440.
+- Нет обрезанных заголовков/кнопок/путей; текст переносится.
+- Сетка 4/8: одинаковые внешние/внутренние отступы, выравнивание по левому краю.
+- Фокус видим, тач-цели ≥ 40 px, `prefers-reduced-motion` уважается.
+- После правок — повторный снимок; в отчёте указать, что проверено.