simbiot-harness/docs/PORTAL-STRUCTURE.md

Структура портала Simbiot Harness

Быстрый структурированный обзор репозитория харнеса: что где лежит, чем живёт, куда смотреть. Для себя, для новых агентов и для Alex — в текстовом виде, без диаграмм.

Топ-уровень

Путь	Что это
cli.py	CLI харнеса: доска задач, лестница, TG-триаж, эскалации, события
README.md	Назначение, главная цель (AUM), лестница уровней, события, структура
architecture.html	HTML-страница архитектуры портала (обзор модулей и связей)
lab42-conditions.html	HTML с условиями кооператива Lab42 (наполним завтра по тексту задачи)
simbiot-presentation.html	Слайды о продукте Simbiot
docs/KEYS-REGISTRY.md	Реестр ключей и секретов хоста (S-таск 30.09)
docs/PORTAL-STRUCTURE.md	Этот файл — текстовый обзор структуры репо
harness.db, events.db, simbiot.db, tg_inbox.db	Локальные SQLite-сторы, в git НЕ входят (.gitignore)
.env	Ключи/секреты локально (0600), в git не входит

harness/ — исполнительное ядро

| Модуль | Роль | |---|| | es.py | Event store + проекции (checkpoint + replay), append-only спина | | levels.py | Конфиг уровней: sec/min/hour/day, интервалы, контекст, модели | | scheduler.py | Планировщик тиков, батч-задачи, занятость уровней | | _llm_worker.py | Рабочий LLM-тик уровня, бюджеты (токены/время/шаги) | | isolated_runner.py | Изоляция запуска тиков уровня | | runtime.py | Runtime-конфиг, пути, загрузка .env | | commands.py | Разбор команд чата/CLI | | tg_inbox.py | Входящие TG-сообщения (inbox), батч-триаж | | tg_commands.py | Команды бота (setMyCommands) | | dashboard.py | Веб-дашборд задач (статусы, детали по клику) | | voice.py + _fw_asr_worker.py | Транскрипция голосовых | | rag_lookup.py | Семантический поиск по базе кооператива (/root/rag) | | proactive.py | Инициативные реплики в чат | | harness.db | Главный стор харнеса |

tests/ — pytest-покрытие

test_task_batch · test_gate · test_inbox_batch · test_delivery_idempotency · test_proactive · test_rag_lookup · test_tg_commands · test_tool_budget · test_voice (см. tests/).

scripts/

safe-restart.sh — безопасный рестарт харнеса.

git

Репо ведётся на git.cil.by (Forgejo). В git НЕ входят: venv/, *.db, .env; .git ≈ 60МБ (в т.ч. большие бинарные артефакты в истории — можно почистить отдельно).

Заметки из последних тиков

• git log (последние): 05555bb feat(levels): day ctx 1M как у hour — симметрия уровней (Alex) e623a10 docs: фиксация главной цели — максимизация долгосрочной AUM (Alex) 7efe845 feat(levels): часовой контекст ~1M
• Статус git: чисто, один untracked — lab42-conditions.html.