# Совместное меню KILN

Исходник `kiln-system.sh` запускается обёрткой
`/root/.local/share/admin-menu/menus/kiln-system.sh`. В selector и dispatcher
добавлен ключ `kiln-system`; прежние ключи не меняются. Выбрать новое меню
можно штатным переключателем Alt+C. Скрипт ничего не запускает до выбора.

Существующий пункт «Codex — вернуться в сессию KILN» открывает один список
сохранённых неархивированных сессий ровно трёх каталогов:

- сайт: `/var/www/html/kiln`;
- бот: `/srv/kiln-bot`;
- совместная рабочая область: `/var/www/html/kiln-system`.

HotelERP, `/root` и остальные каталоги в этот список не входят. Используется
точное совпадение корня, не подстрока `kiln` и не общий родитель. Выбор по
дате последней активности (Москва), проекту и заголовку сессии. Явное имя
имеет приоритет над title; при отсутствии обоих показано «Без заголовка».
UUID скрыт в значении выбора. Содержимое разговоров, preview и credentials
не читаются. История не копируется и не переносится.

`codex-kiln-sessions.py` читает id/cwd/updated_at/archived, title/name и сохранённые
sandbox_policy/approval_mode из локального
индекса Codex в read-only режиме. Заголовки выбираются только после фильтра
по разрешённым cwd в SQL; управляющие символы, переносы строк и разделитель
Gum обезвреживаются, длинные названия сокращаются. `has_user_event` не используется: в текущем
индексе этот флаг равен нулю и у сохранённых интерактивных чатов. Формат SQLite
внутренний; при его изменении список закрывается с ошибкой, без глобального
fallback. Выбранный UUID повторно проверяется перед запуском.

Выполняется `codex resume <UUID> --cd /var/www/html/kiln-system` с явными
сохранёнными sandbox/approval flags. `--all` не используется. Сессия продолжается
со своим ID/историей, а новые обсуждения из общего контекста сохраняются за
совместным каталогом. Права восстанавливаются из выбранной сессии:
disabled соответствует danger-full-access, read-only остаётся read-only,
workspace-write сохраняет свои network/tmp/writable_roots options и получает
`--add-dir` только для двух репозиториев. Для full access дополнительные roots
избыточны и не передаются; для read-only их передача недопустима. Неизвестный
формат прав останавливает запуск с понятной ошибкой, без повышения прав.
Глобальный config.toml не меняется. Это исправляет ошибку Codex 0.167 при
проверке --add-dir до восстановления сохранённых прав.

Launcher добавляет localhost/127.0.0.1/::1 в NO_PROXY/no_proxy с сохранением
остальных исключений и proxy settings. Уже работающий daemon не наследует
новое окружение автоматически; его отдельный одноразовый refresh описан ниже.
При выходе восстанавливается терминал. Для применения к уже открытому меню
закройте его и откройте снова; контейнеры перезапускать не требуется.

Шаблоны совместного контекста находятся в `workspace/`. Установленные
`AGENTS.md` и `KILN.code-workspace` лежат в `/var/www/html/kiln-system`.
Они ссылаются на оба исходных репозитория и их актуальные инструкции/handoff.
Установку шаблонов выполняйте только при отсутствии конфликтующих файлов;
пользовательские файлы общей области не перезаписывайте автоматически.

Проверки выбора сессий:

```bash
python3 -m unittest discover -s deploy/admin-menu -p 'test_codex_kiln_sessions.py' -v
KILN_MENU_SMOKE=1 python3 -m unittest discover -s deploy/admin-menu -p 'test_codex_kiln_*.py' -v
```

Первый набор использует fixture SQLite. Второй дополнительно открывает
установленное Gum-меню в PTY с настоящим Gum, но подставным Codex: проверяет
выбор, отмену и подмену UUID. Чаты и агентские задачи при тесте не запускаются.
Другие проекты не изменяются.

Проверка 6 ноября после исправления resume: **29 tests passed**, включая три
PTY smoke с настоящим Gum и подставным Codex. Дополнительно реальный Codex
0.167 проверен в трёх режимах на несуществующем UUID: все команды дошли до
«No saved session found», ошибка additional roots отсутствует. Существующие
чаты не открывались, новые чаты/модельные задачи для проверки не создавались.

`codex-daemon-refresh.py --check` читает только служебные статусы загруженных
сессий через локальный Unix socket, без turns/messages. Одноразовый запуск
с --report ожидает завершения **всех** активных задач, затем перезапускает
daemon с localhost bypass. При необходимости обновляет окружение уже
существующего pid updater через штатный bootstrap, сохраняя remote-control
mode. При неизвестном процессе/статусе действие прекращается. После refresh
проверяются environment обоих процессов и codex_tui tools через штатный
MCP status API. Секреты/тексты сессий в report не попадают.
Ожидание ограничено 10 минутами; при занятых сессиях report получает deferred.
Это одноразовая операция текущей задачи, нового меню/постоянного poller нет.

Обновление Codex и диагностика MCP/proxy на сервере:
`../../docs/CODEX_OPERATIONS.md`. Изменение меню не меняет настройки сети.

Совместный backup обеих БД и сохранение работающих rollback-образов доступны
отдельным пунктом. Результат — закрытый каталог `/var/backups/kiln-system`:
PostgreSQL custom dump, сжатый MariaDB dump, SHA обоих проектов, контрольные
суммы и закреплённые Docker tags. Проверка формата dump не заменяет пробное
восстановление и проверку миграции на изолированной БД. Пункт отката запускает
сохранённый бот, проверяет health, затем запускает сайт; данные не откатываются.
При несовместимой миграции сначала нужна отдельная процедура восстановления.
Расширенная диагностика доступна через прежние подменю. Совместный выпуск требует заранее
выполненных процедур DEPLOY.md сайта и OPERATIONS.md бота. Меню не выполняет
pull, reset и ручные исправления БД. Проверка бота запускает текущие исходники
в отдельном контейнере с Python/зависимостями работающего образа, без сети,
credentials и записи в production. Сайт запускает только безопасные *.test.ts;
полный npm test отдельно требует изолированные PostgreSQL и HTTP-сервер.
