dsh-reference-session-collector 0.0.0-stage → 0.2.0-beta.0

package/README.ru.md

@@ -0,0 +1,73 @@
+# dsh-reference-session-collector (DRS) — синхронизатор проекции сессий
+
+**Плагин DeepSeek Harness (DSH)**: сканирует **только на чтение** журналы
+сессий в `~/.dsh/sessions/**`, декодирует их и проецирует в собственную
+SQLite-проекцию (segments / replaces / FTS5). Одна защищённая HTTP-маршрут
+`GET/POST /api/dsh-reference-session-collector` предоставляет пометки поверхности,
+сверку вызовов (recall) и полнотекстовый поиск с поддержкой китайского.
+**Никогда не записывает в файлы сессий.**
+
+## Статус
+
+**Поставлено (v0.1.0)**: хостовая половина полностью — чистое ядро
+проекции, хранилище SQLite (node:sqlite / FTS5), инкрементальный движок
+синхронизации (предпроверка watermark, отслеживание архива, interval-планировщик),
+слой запросов с трёхуровневым кэшем, защищённый HTTP-маршрут. Цепочка
+гейтов `pnpm check` полностью зелёная (9 наборов / 66 тестов + dist-смоук).
+**Осталось**: подключение потребителей (фаза 1 — сверка CCI, фаза 2 —
+переключение корпуса steward, фаза 3 — дозаполнение якорей memory) и
+бенчмарк эффективности T9.1.
+
+## Архитектура
+
+```
+~/.dsh/sessions/** (только чтение) ──→ ProjectionSync (инкрементально, watermark=bytes+mtime)
+                                   │ projectSessionEvents (чистое ядро)
+                                   ▼
+        ~/.dsh-reference-session-collector/projection.db (4 таблицы + fts5 + 3 уровня кэша)
+                                   │
+              ┌────────────────────┼───────────────────┐
+   /api/dsh-reference-session-collector     CCI (фаза 1)   steward (2) / memory (3)
+```
+
+## Таблица HTTP-маршрутов
+
+| op | параметры | возвращает |
+|---|---|---|
+| `status` | — | самодиагностика хранилища + статистика кэша + последний sync |
+| `sessions` | `offset/limit` | сводка сессий (резидентная Map, 0 SQL) |
+| `session` | `session=<id>`, опц. `turn=` / `fields=search` | детали segments (поля поиска) |
+| `surface` | `session=<id>` | реестр поверхности (текущая + указатели замен) |
+| `recall` | `session=<id>` | классификация пар замен (Σb / Σ(a−b)) |
+| `search` | `q=<запрос>`, опц. `session=` | FTS5 BM25 (одинаковая сегментация zh/en) |
+| `sync` (POST) | `{op:'sync'}` | accepted + последний результат |
+
+## Дисциплина «только чтение»
+
+- файлы сессий и `workspace.json` — всегда только чтение;
+- все записи плагина идут исключительно в
+  `~/.dsh-reference-session-collector/projection.db`;
+- полная перезапись-замена на сессию (DELETE+INSERT в транзакции), идемпотентно;
+- **ответственность за обезличивание не на DRS**: хранится исходный текст,
+  площадь утечки = сами файлы сессий.
+
+## Переменные окружения
+
+| переменная | по умолчанию | значение |
+|---|---|---|
+| `DSH_HOME` | `~/.dsh` | корень журналов сессий |
+| `DSH_REFERENCE_SESSION_COLLECTOR_DIR` | `~/.dsh-reference-session-collector` | каталог БД проекции |
+| `DSH_REFERENCE_SESSION_COLLECTOR_SYNC_INTERVAL_MS` | `30000` | интервал sync; `0` = только вручную |
+
+## Установка / разработка
+
+```
+dsh plugin --profile web add dsh-reference-session-collector
+pnpm install && pnpm check   # typecheck→lint→test→build→smoke
+```
+
+Требуется Node ≥ 22 (`zlib.zstdDecompressSync` + `node:sqlite`).
+
+## Лицензия
+
+MIT

package/assets/deepseek-v4/LICENSE.DeepSeek-V4-Pro.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 DeepSeek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/assets/deepseek-v4/manifest.json

@@ -0,0 +1,23 @@
+{
+  "repository": "deepseek-ai/DeepSeek-V4-Pro",
+  "revision": "0e1a0e5e52aea73055f50fef6f2423db370265b6",
+  "license": "MIT",
+  "modelIds": [
+    "deepseek-v4-flash",
+    "deepseek-v4-pro"
+  ],
+  "files": {
+    "tokenizer.json": {
+      "bytes": 6367146,
+      "sha256": "8f9f37ca37fdc4f5fd36d5cf4d3b0e8392edb4e894fd10cc0d70b4957c8633cf"
+    },
+    "tokenizer_config.json": {
+      "bytes": 801,
+      "sha256": "6ac8c8dc065ed118161d02dd532749ae3f52c243deac27872134fae2f50d8547"
+    },
+    "LICENSE.DeepSeek-V4-Pro.txt": {
+      "bytes": 1064,
+      "sha256": "1c8f573e830ca9b3ebfeb7ace1823146e22b66f99ee223840e7637c9e745e1c7"
+    }
+  }
+}