# 🗺️ ДОРОЖНАЯ КАРТА И АРХИТЕКТУРНЫЙ РОАДМАП ПРОЕКТА 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 контуре.