diff --git a/docs/mcp-completion-plan.md b/docs/mcp-completion-plan.md index 55c23514..35c83f48 100644 --- a/docs/mcp-completion-plan.md +++ b/docs/mcp-completion-plan.md @@ -98,6 +98,7 @@ Продуктовые задачи из анализа таймингов (2026-11-17), не блокируют слияние в `main`; детали и числа в `mcp-stand-run-a-plan.md`, раздел «Вопросы к продукту»: - [ ] **Облегчённый путь «план и применение одним вызовом» и составные операции.** Сейчас все 161 инструмента записи называются `*_plan` и выполняются как план, одобрение (только в режиме `approval`, для защищённых объектов и опасных операций), запись, проверка; составного инструмента вида «создать WireGuard-туннель в отдельном VRF между сервером 1 и сервером 2» нет, клиент собирает цепочку примитивов (`mm_wireguard_interface_*`, `mm_wireguard_peer_*`, `mm_gre_*`, `mm_vrf_*`). Решить: нужен ли в режиме `autonomous` вызов «план и применение вместе» с сохранением политики (лимиты, область, защищённые объекты, аудит до записи) и нужны ли составные операции верхнего уровня; если да, описать контракт и совместимость с идемпотентностью и обратными операциями. +- [ ] **Устойчивость создания VRF поверх активного GRE.** Из четырёх попыток на стенде две дали `partial / VERIFICATION_FAILED` с диагностикой `stage=transition-classification`, `guard=ADDRESS_ROUTE_ABSENCE_OUTSIDE_EXACT_ACQUISITION` (`backend/src/services/vrf-production-transition.ts:394`): GRE при создании VRF гаснет и поднимается, перечитывание не атомарно и видит адрес или маршрут отсутствующим, классификатор отказывает, хотя VRF на роутере создан. Решить и реализовать: повтор классификации после ограниченного ожидания стабилизации либо различение кратковременного исчезновения при мигании GRE; добавить тест на реконструированных до/после-состояниях и проверку на стенде. - [ ] **Задержка записи WireGuard.** По метрикам прогона `owned-windows-vrf-9ccf68cd…` (раннер с вашего Windows по интернету): запись интерфейса и пира WireGuard 80–136 с на пару PUT+PATCH против 29–36 с для простой записи; одобрение → intent 25–77 с, ACK → терминал 10–48 с, 310–472 чтения роутера на запись против 103. Выяснить, чем вызвано (число чтений роутера самой операцией, ожидания, генерация ключей), и измерить на VPS рядом с CHR без стендовых проверок: простая запись и запись WireGuard через приложение с метками времени продукта и числом чтений. Цель: понять, что оптимизировать в продукте (например, число чтений на операцию), а не в стенде. **Предварительная модель (вывод по записям прогона `9ccf68cd…`, не доказательство):** время шага ≈ 17 с фиксированно + ~0,15 с на каждое чтение роутера (простая запись ≈ 33 с при 103 чтениях, шаг WireGuard ≈ 65 с при 310); запись на роутер занимает 0,06–0,14 с. WireGuard и интерфейс создаются отключёнными и затем включаются отдельной командой (`wireguard-peer-create-actions.ts:113`), поэтому у него пара шагов PUT+PATCH, то есть два цикла «запись → проверка». Неизвестно: какая часть 310–472 чтений принадлежит продукту, а какая независимой проверке раннера, и какая доля 0,15 с на чтение приходится на интернет между Windows и CHR. ## Журнал @@ -118,3 +119,4 @@ | 2026-11-16 | План прогона A: решены D1 (REST с Windows), D2 (CHR2 закрыт по адресам, ftp и telnet выключены), D3 (раннеры под `claude`), D4 (пароли из переменных), D5 (контроллер локально), D7 (снят), D9 (IPsec вынесен), D10 (захват на CHR) | | 2026-11-16 | VPS подготовлен к прогонам: очищено 8 ГБ Docker (свободно 11 ГБ), снят дамп базы, ветка `codex/mcp-foundation` отправлена в Gitea, Gitea собрала образы (запуск `2738`, успешно), на VPS заменены backend и frontend установки `mmapp-test` на HEAD `5ec95a7c`. Применены миграции со старых 12 до 57 (`0057`), 34 таблицы `mcp_*`, данные сохранены (2 сервера), backend `healthy`. Обновление прошло по прежнему (legacy) пути, схема `mmapp_control` пуста: контрольный путь миграций и пункт DB-3 этим не закрыты. MCP и контроллер по умолчанию выключены, не проверялось | | 2026-11-17 | В этап 5 добавлены две продуктовые задачи: облегчённый путь «план и применение» с составными операциями; задержка записи WireGuard и замер на VPS | +| 2026-11-17 | Получена точная причина нестабильного отказа создания VRF (`transition-classification`, `ADDRESS_ROUTE_ABSENCE_OUTSIDE_EXACT_ACQUISITION`), задача в этапе 5 | diff --git a/docs/mcp-stand-run-a-plan.md b/docs/mcp-stand-run-a-plan.md index 2e69f526..2321c0e2 100644 --- a/docs/mcp-stand-run-a-plan.md +++ b/docs/mcp-stand-run-a-plan.md @@ -319,3 +319,11 @@ - **Режимы и одобрение (проверено по коду):** `mcpModeSchema = observer | approval | autonomous` (`packages/contracts/src/mcp.ts:9`); `policy.ts:89` требует одобрения человеком только в режиме `approval`, а также для защищённых объектов и для опасных операций, не разрешённых явно для автономного режима (`policy.ts:90-92`). Стендовый раннер создаёт подключение сознательно в режиме `approval` (`run-owned-native.mjs:107`), чтобы проверять путь одобрения, поэтому каждая запись стенда проходит одобрение. В режиме `autonomous` обычные операции идут без одобрения; отдельные операции (резервные копии, восстановление, пересборки) по документации требуют одобрения человека и в нём. - **План (проверено по коду):** все 161 инструмента записи называются `*_plan`: план является единицей политики (лимиты вызовов и мутаций, область серверов и объектов, защищённые объекты, доступность аудита до записи), а не только шагом подтверждения. Составной инструмент вида «создать WireGuard-туннель в отдельном VRF между сервером 1 и сервером 2» в списке не найден: есть примитивы (`mm_wireguard_interface_*`, `mm_wireguard_peer_*`, `mm_gre_*`, `mm_vrf_*`), клиент составляет цепочку из нескольких планов. 56 записей в стендовом кейсе получаются из того, что раннер создаёт по одному объекту на план. - **Открытые вопросы владельцу продукта:** (1) нужен ли облегчённый путь «план и применение одним вызовом» в режиме `autonomous` и составные операции верхнего уровня; (2) замер задержки продукта на VPS рядом с CHR без стендовых проверок (простая запись и запись WireGuard) — пункт запланирован после текущего прогона; (3) почему запись WireGuard занимает 25–77 с на одобрение → intent и до 48 с на ACK → терминал при 310–472 чтениях. + +## Итог A2 с раннером v6 (первый запуск) на 2026-11-17 — точная причина нестабильного отказа продукта при создании VRF + +- **Запуск:** `windows-successor-v6.py` (предел прогона 2 часа), запуск `owned-windows-vrf-40aab99c6e2d7743f299297a`, 23 записи, остановка на `PUT /ip/vrf` (CHR2) за 1097 с, `mcp: partial / verification failed / VERIFICATION_FAILED`. Очистка вручную (`manual-cleanup.mjs`), сверка: оба CHR 66 из 66. +- **Диагностика MCP из квитанции (наблюдение, `childDiagnostics`):** `event=mcp.vrf.execution-failed`, `action=create`, `stage=transition-classification`, `errorClass=Error`, `executorAckObserved=true`, `transition.guard=ADDRESS_ROUTE_ABSENCE_OUTSIDE_EXACT_ACQUISITION`. +- **Что это (вывод по коду, `backend/src/services/vrf-production-transition.ts:394`):** классификатор перехода сравнивает адреса участников до и после; для адреса без преемника допускается только link-local адрес при переносе участника из `main`, иначе отказ `address/route absence outside exact acquisition`. После создания VRF поверх активного GRE (GRE гаснет и поднимается снова: `link-downs` 0→1 в ту же секунду) перечитывание, не атомарное, увидело адрес или маршрут отсутствующим, и классификатор безопасно отказал. Роутер при этом создал VRF (`ACK`), MCP отчитался `partial`. +- **Частота (наблюдение, четыре попытки создать VRF поверх активного GRE на этом кодовом снимке):** `f0011b91…` отказ (причина не записывалась), `9ccf68cd…` MCP прошёл (остановка позже в раннере), `ede42626…` MCP прошёл, `40aab99c…` отказ с названной защитой. То есть примерно половина попыток. +- **Вывод для продукта (задача этапа 5):** состояние VRF после создания поверх активного GRE принимается или отвергается случайно; безопасный отказ корректен, но создаёт ложный `partial`. Нужно решение: повторять классификацию после короткого ожидания стабилизации (ограниченное число попыток) либо различать кратковременное исчезновение адреса при мигании GRE. Это не меняет оценку A2: стендовый раннер продолжает попытки.