feat(llm): переход на реляционные узлы промпта, db_cli context и очистка от регулярок

2026-08-17 11:55:07 +03:00
parent 4e3c99b728
commit 828ce67817
25 changed files with 4447 additions and 1006 deletions
@@ -0,0 +1,61 @@
+# 🗺️ ДОРОЖНАЯ КАРТА И АРХИТЕКТУРНЫЙ РОАДМАП ПРОЕКТА SCUD ORION AI
+
+## 📌 Зафиксированные вехи и концептуальные архитектурные решения
+
+Схема веток Gitea для развития проекта:
+
+main (100% стабильный релиз)
+  │
+  ├──► feature/prompt-relational-nodes ──┐ (Перевод системного промпта на реляционные узлы в SQLite)
+  │                                      ▼
+  ├──────────────────────────────────► merge to main
+  │
+  ├──► feature/native-function-calling ──┐ (Отказ от регулярных выражений tool_injector.py в пользу нативного FC)
+  │                                      ▼
+  ├──────────────────────────────────► merge to main
+  │
+  └──► feature/ephemeral-context ────────┐ (Интеллектуальный жизненный цикл эфемерных сообщений)
+                                         ▼
+                                     merge to main
+
+---
+
+## 🎯 Текущий активный спринт: Нативный Function Calling и реляционный редактор промпта
+
+### 1. Архитектура чистого диалогового агента без регулярных выражений
+* **Концепция:** Полный отказ от жестких эвристик и регулярных выражений в `tool_injector.py`. Все решения о намерениях оператора, вызове инструментов и переключении тем принимает языковая модель через семантический контекст.
+* **Ключевые этапы реализации:**
+  * **Этап 1 (Санитарная очистка):** Превращение `tool_injector.py` в простой фильтр мусорных тегов без инжекции и перехватов команд.
+  * **Этап 2 (Семантическое управление сессией):** Инструктаж модели в `role: system` о поведении в состоянии `PROMPT_PREVIEW` (оценка подтверждения, отмены, правок или смены темы диалога).
+  * **Этап 3 (Жизненный цикл контекста):** Модель видит временные сообщения (`is_ephemeral = 1`) только во время активной ветки; при фиксации решения (`fast_path.py`) контекст очищается через `db_purge_ephemeral_messages`.
+  * **Этап 4 (Гибридный UI):** Поддержка как диалоговых правок, так и прямого инлайн-редактирования через форму `[✏️ Редактировать]` в окне чата.
+
+---
+
+## 🚀 Масштабирование эфемерного контекста и сервисные инструменты
+
+### 2. Модуль инспекции контекста и базы данных (`db_cli.py`)
+* **Статус:** `Реализовано`.
+* Добавлена команда `context [session_id] [--limit N]` для просмотра сырой таблицы сообщений `chat_messages` с пометками об эфемерности.
+
+### 3. Модуль задач и бэклога (`tasks`)
+* **Целевые инструменты:** `db_get_tasks`, `db_add_task`, `db_update_task_status`, `db_delete_task`.
+* Вывод интерактивных карточек задач с фильтрами без засорения постоянной истории диалога.
+
+### 4. Модуль срезов и архива СКУД (`snapshots`)
+* **Целевые инструменты:** `db_get_snapshots`, `db_delete_snapshots`.
+* Интерактивное подтверждение удаления срезов и автоматическая очистка таблиц срезов из контекста.
+
+### 5. Модуль базы знаний, правил и аномалий (`kb & anomalies`)
+* **Целевые инструменты:** `db_get_rules`, `db_get_anomalies`, `db_get_reference`.
+* Изоляция нормативных справочников от постоянной истории диалога для предотвращения залипания LLM.
+
+---
+
+## 🔮 Долгосрочный бэклог (Future Modules)
+
+### 6. Интерактивный модуль планирования (Checklist & Task Planner Engine)
+* Динамические проектные чек-листы с синхронизацией в таблицу `tasks`.
+
+### 7. Изолированная песочница кода (Code Execution Sandbox Engine)
+* Запуск динамических Python/Pandas вычислений в изолированном Docker/gVisor контуре.