From 42dcc08d5aa8dc144fda0b4c72d1a4a3934239c6 Mon Sep 17 00:00:00 2001 From: buryan-agent Date: Fri, 23 Oct 2026 20:14:02 +0300 Subject: [PATCH] =?UTF-8?q?[SPRINT-3]=20=D0=98=D1=81=D1=82=D0=BE=D1=80?= =?UTF-8?q?=D0=B8=D1=8F=20=D0=B8=20=D0=BA=D1=8D=D1=88=20=D0=BA=D0=B0=D1=82?= =?UTF-8?q?=D0=B0=D0=BB=D0=BE=D0=B3=D0=B0,=20=D1=80=D0=B0=D0=B7=D0=B1?= =?UTF-8?q?=D0=BE=D1=80=20inbox=20(=D1=82=D0=B5=D0=B3=D0=B8/=D1=81=D1=82?= =?UTF-8?q?=D0=B0=D1=82=D1=83=D1=81=D1=8B),=20=D1=80=D0=BE=D0=BB=D0=B8=20?= =?UTF-8?q?=D0=B2=D0=BE=20=D0=B2=D1=81=D0=B5=D1=85=20=D0=B1=D0=BE=D1=82?= =?UTF-8?q?=D0=B0=D1=85?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/ops/SPRINT-3-BOTS.md | 76 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 76 insertions(+) diff --git a/ops/ops/SPRINT-3-BOTS.md b/ops/ops/SPRINT-3-BOTS.md index ceb2cb5..c98f702 100644 --- a/ops/ops/SPRINT-3-BOTS.md +++ b/ops/ops/SPRINT-3-BOTS.md @@ -98,3 +98,79 @@ Matrix) не находятся, если русского алиаса нет * словарь алиасов/транслитерации для русских запросов к англоязычным тайтлам; * перенос разбора намерений в профильные боты (сейчас через секретаря); * статистика использования по ролям (кто чем пользуется). + +--- + +# Дополнение (20:15): закрыты оставшиеся пункты спринта + +## 1. История и кэш слоя сбора — ✅ + +| Механизм | Реализация | +|---|---| +| **Кэш каталога** | `load()` держит JSON в памяти, обновляет по `mtime` файла | +| **История изменений** | `/var/lib/hub-core/catalog_history.jsonl` | +| **Журнал диалогов** | `/var/lib/hub-bots/dialog.jsonl` (был) | + +История пишется при каждой сборке, только при изменениях: + +```json +{"event": "state", "title": "Test", "from": "tracked", "to": "in_library"} +{"event": "added", "title": "New", "kind": "movie", "year": 2024} +{"event": "removed", "title": "..."} +``` + +Проверено: при подмене «до/после» записались 2 события. + +## 4. Разбор входящих (inbox) — ✅ + +`/opt/hub-core/inbox_parse.py` + `hub-inbox.timer` (каждые 30 минут). + +Читает `/var/lib/hub-bots/inbox/*.jsonl`, классифицирует по правилам и +складывает в базу пожеланий с тегом: + +| Тег | Ключевые слова | Сколько | +|---|---|---| +| content | фильм, сериал, книг, скачать | 12 | +| feature | хочу чтобы, дашборд, отчёт | 4 | +| other | остальное | 14 | +| bug | не работает, ошибка, падает | 0 (пока) | + +Первый прогон: **разобрано 15 записей**, всего в базе **31 пожелание**. +Обработанное помечается в `inbox_state.json` — повторно не разбирается. + +Колонки в `wishes`: `tag`, `inbox_ref` (ссылка `2026-10-23#4`). + +## 3. Роли во всех ботах (не только в секретаре) — ✅ + +В `matrix.py` добавлен `_role_gate`, вызывается в `dispatch()` **до** любой +команды и свободной фразы. + +| Роль | Опасные команды (restart/delete/approve/config) | Остальное | +|---|---|---| +| owner | разрешено | разрешено | +| family | **запрещено** | разрешено | +| guest | запрещено | только help/find/search + безопасные намерения | +| unknown | запрещено | только help | + +Проверка `_role_gate`: + +``` +owner restart -> разрешено +family restart -> ЗАПРЕЩЕНО +family help -> разрешено +guest restart -> ЗАПРЕЩЕНО +guest help -> разрешено +unknown restart -> ЗАПРЕЩЕНО +``` + +Гость при свободной фразе сначала прогоняется через `/intent`: если это +поиск/рекомендация/статистика — отвечаем, иначе вежливый отказ. + +## Итог по спринту 3 + +| Пункт | Статус | +|---|---| +| 1. Слой сбора: нормализация, история, кэш | ✅ | +| 2. Понимание запросов (правила + LLM) | ✅ (локальная модель отложена) | +| 3. Роли: владелец/семья/гость | ✅ во всех ботах | +| 4. Пожелания: разбор inbox + статусы | ✅ |