dsh-desktop-kit 0.0.0-stage → 2.0.0

package/plugins/dsh-project-memory/README.md

@@ -0,0 +1,71 @@
+# dsh-project-memory — локальная долговременная память по проектам
+
+Плагин для DeepSeek Harness: превращает «разберись и запомни проект» в постоянную
+локальную базу знаний, которая сама подгружается в новые чаты.
+
+## Что делает
+
+1. **Определяет проект по рабочей директории сессии.** Если каталог не зарегистрирован,
+   но в нём (или выше) есть маркеры проекта (`.git`, `AGENTS.md`, `composer.json`,
+   `package.json`, `artisan`, `wp-config.php`, …), проект регистрируется самозаранее
+   и для него создаётся скелет досье.
+2. **Подмешивает компактный дайджест** (≤ ~2.8 К символов) в контекст каждого запроса
+   модели: название, корень, стек, статус свежести (git), главные инварианты, известные
+   грабли, последняя запись журнала и напоминание, если в прошлом ходе проект менялся,
+   а память не обновлялась. Для подагентов дайджест не подмешивается.
+3. **Даёт модели инструмент `project_memory`**: `status`, `list`, `read`, `search`,
+   `append_journal`, `update_section`, `register`.
+4. **Автоматически пишет журнал.** После каждого хода, в котором проект правился или
+   выполнялись команды, в `JOURNAL/YYYY-MM.md` добавляется детерминированная запись:
+   время, ход, сессия, изменённые файлы, команды, ошибки, признак «память обновлена
+   моделью». Это работает даже если модель не успела ничего записать.
+5. **Команда `/remember`** — просит агента загрузить скилл `project-deep-dive`,
+   проанализировать проект и заполнить досье.
+
+## Где хранится
+
+`<DSH_HOME>/projects-memory/` (по умолчанию `C:\Users\<user>\.dsh\projects-memory\`):
+
+```
+registry.json               проекты и настройки
+_state.json                 служебное состояние сессий
+_access.log                 диагностика (ограничен 300 строками)
+<slug>/PROJECT.md           паспорт проекта
+<slug>/ARCHITECTURE.md      архитектура
+<slug>/CODE-MAP.md          карта кода
+<slug>/INVARIANTS.md        инварианты и запреты
+<slug>/GOTCHAS.md           грабли и решения
+<slug>/RUNBOOK.md           запуск/тесты/деплой/откат
+<slug>/JOURNAL/YYYY-MM.md   журнал по месяцам
+<slug>/INDEX.json           машинный индекс/свежесть
+```
+
+Ничего не отправляется в сеть: наружу уходит только обычный промпт модели, в который
+попадает дайджест. Секреты/PII при записи вычищаются регулярками (и это последняя
+линия защиты — в досье их быть не должно).
+
+## Установка
+
+```
+plugin_manager install_bundle  target = <этот каталог>
+```
+После установки хост-кода достаточно перезагрузки конфига (`set_bundle`), клиентская
+часть и скиллы подхватываются без перезапуска приложения (страницу достаточно
+обновить, чтобы увидеть изменения клиентских плагинов).
+
+## Настройки (registry.json → settings)
+
+- `digestBudgetChars` — бюджет дайджеста в символах (по умолчанию 2800);
+- `injectSubagents` — подмешивать ли дайджест подагентам (по умолчанию `false`);
+- `autoRegister` — авто-регистрация проектов по маркерам (по умолчанию `true`);
+- `curator.enabled`, `curator.idleMs` — фоновый куратор-субагент (если подключён мост).
+
+## Ограничения
+
+- Признак «проект» выводится из путей; для нестандартных раскладок регистрируйте проект
+  вручную (`project_memory action=register name=... root=...`).
+- Дайджест — сжатая выжимка; полную информацию агент читает инструментом.
+- Плагин использует внутренние сервисы Harness (`systemPrompt.context`, `tools`,
+  `session/event`); после крупного обновления DSH возможна адаптация.
+- Автожурнал пишет факты, но не литературные выводы: смысловое резюме — задача модели
+  или куратора.

package/plugins/dsh-project-memory/cordis.patch.yml

@@ -0,0 +1,4 @@
+# Host half of the local project-memory plugin.
+- insert:
+    - id: project-memory
+      name: dsh-project-memory

package/plugins/dsh-project-memory/icon.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="Project memory">
+  <defs>
+    <linearGradient id="pm-a" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#2f7df6"/>
+      <stop offset="1" stop-color="#1b3f9e"/>
+    </linearGradient>
+  </defs>
+  <rect x="2" y="2" width="60" height="60" rx="14" fill="url(#pm-a)"/>
+  <path d="M16 14h22l10 10v26a4 4 0 0 1-4 4H16a4 4 0 0 1-4-4V18a4 4 0 0 1 4-4Z" fill="#ffffff" opacity=".94"/>
+  <path d="M38 14v10h10" fill="none" stroke="#cfe0ff" stroke-width="3" stroke-linejoin="round"/>
+  <path d="M21 33h20M21 40h20M21 47h12" stroke="#2f7df6" stroke-width="3" stroke-linecap="round" opacity=".85"/>
+</svg>