diff --git a/docs/mcp-completion-plan.md b/docs/mcp-completion-plan.md index 4948bfa4..971e7124 100644 --- a/docs/mcp-completion-plan.md +++ b/docs/mcp-completion-plan.md @@ -99,10 +99,11 @@ - [x] NetFlow: захват IPFIX с реального RouterOS — 2026-11-19: захваты CHR1/CHR2 (16.11) и окно с пингами на CHR1 разобраны парсером продукта `traffic-flow-parse.ts` (`tmp/mcp-stand-run-a-20261116/ipfix-parse.ts`, квитанция `ipfix-capture.json`): IPFIX v10, домен наблюдения 0, шаблон и данные (наборы 258/259), ifIndex 0/2, порты и счётчики; 10 ping CHR1→CHR2 по 56 байт дали ровно два ICMP-потока по 10 пакетов и 560 байт; окно закрыто, CHR1 66/66 с базой - [x] WireGuard / GRE: жизненный цикл с трафиком (прогон A; IPsec вынесен отдельным пунктом по решению D9) — 2026-11-19 по квитанции A2 v28 `owned-windows-vrf-f04308177d6b31c740159548`, как предусмотрено планом прогона A (строка A4: «те же квитанции A1/A2»): WG-интерфейсы и пиры на обоих CHR (PUT+PATCH, ACK, подтверждённые ID), GRE на обоих (PUT, ACK, `greReadback`), трафик 36/36 контрольных пингов через GRE поверх WireGuard в трёх фазах, DELETE всех туннелей с подтверждённым отсутствием, очистка раннера и сверка снимков 66/66. Счётчики байтов отдельно не записывались: трафик доказан ответами на ping - [x] IPsec: новый MCP-сценарий `mm_ipsec_*` с подтверждением, трафиком и SA на стенде CHR — **принят по D11: 5 из 5 подряд на `a7d85fd0`** (`e55dd89b`, `35de523c`, `4ea0c91f`, `87820788`, `2a0dfc6c`) после исправления блокировки по решению владельца; до него на `e7eb108c` было 4 из 6. Первый успешный прогон `runs/2026-11-21-925de9e8` раннера `tmp/mcp-stand-ipsec-20261121/` на `mmapp-test` (backend `mcp-e7eb108c`): `server_init`, `user_create` (PSK), `user_remove`, `server_remove` через MCP, 4 одобрения в UI (D8), все операции `applied`/`passed` и прочитаны в UI; неодобренное применение отклонено `APPROVAL_REQUIRED`; контрольный ping до туннеля 0/3, в туннеле 10/10; рост `current-bytes` на всех четырёх `installed-sa` (по 560 байт, SPI попарно); `mm_ipsec_state_get` видит клиента онлайн; сверка 66/66 на обоих CHR; доступы отозваны - - 2026-11-21: сценарий написан и отрепетирован (`tmp/mcp-stand-ipsec-20261121/`). Решение владельца: CHR1 — сервер только через MCP, CHR2 — клиент как REST-фикстура. Найдены два дефекта продукта: + - 2026-11-21: сценарий написан и отрепетирован (`tmp/mcp-stand-ipsec-20261121/`). Решение владельца: CHR1 — сервер только через MCP, CHR2 — клиент как REST-фикстура. Найдены и исправлены три дефекта продукта: - **счётчики `/interface` в доказательстве инициализации** — исправлено в `28738785`, `mmapp-test` переведён на этот backend; - - **несовместимость с RouterOS 7.24.5** (`comment` у сертификатов, подпись и экспорт только по `.id`, поля после подписи, `address` peer, ID файлов `**…`) — исправлено в `e7eb108c` по решению владельца; генеральная репетиция на CHR прошла (туннель, ping 10/10, рост SA, 66/66), приёмочный прогон через MCP ждёт нового образа. - - Подробности в `mcp-stand-run-a-plan.md`, раздел «IPsec через MCP»; там же условия прогона (клиент CHR2 — REST-фикстура) и замечания: `server_remove` оставляет profile и proposal, `DEVICE_UNAVAILABLE` первой попытки, fast path после IPsec. + - **несовместимость с RouterOS 7.24.5** (`comment` у сертификатов, подпись и экспорт только по `.id`, поля после подписи, `address` peer, ID файлов `**…`) — исправлено в `e7eb108c` по решению владельца; генеральная репетиция на CHR прошла (туннель, ping 10/10, рост SA, 66/66); + - **применение не ждало глобальную блокировку конфигурации** и при опросе сборщиков получало `rejected`/`DEVICE_UNAVAILABLE` (2 из 24 применений на `e7eb108c`) — исправлено в `a7d85fd0`, `mmapp-test` работает на backend `mcp-a7d85fd0`. + - Подробности в `mcp-stand-run-a-plan.md`, раздел «IPsec через MCP»; там же условия прогона (клиент CHR2 — REST-фикстура) и замечания: `server_remove` оставляет profile и proposal (не исправлено), fast path после IPsec не возвращается (причина и способ возврата не установлены). - [x] Нестабильные сценарии Edge (39 из 41 без повтора) — 2026-11-21, по решению D11 (5 повторов подряд): `npm run test:mcp` из корня (Node 25.5.0, Playwright `playwright.mcp.config.ts`, Edge, `retries: 0`) пять раз подряд, в каждом 4 из 4 node-тестов и 43 из 43 сценариев Edge, ни одного повтора и ни одного flaky. Набор вырос с 41 до 43 сценариев; причина исторических отказов не установлена, повторы показывают только текущую стабильность. Подробности в `mcp-stand-run-a-plan.md`, фаза 6 - [x] Нестабильные сценарии маршрутизации (203 из 205 без повтора) — 2026-11-21, по решению D11: набор из 205 тестов восстановлен по `stage-local-tests.log` (17 файлов, точная команда в `mcp-stand-run-a-plan.md`, фаза 6) и пройден пять раз подряд, каждый раз 205 из 205, отказов 0. Оба прежних отказа (`scoped transport fixes one PATCH…`, `ignores DHCP lease countdown…`) проходят @@ -150,6 +151,7 @@ | 2026-11-20 | B2 (capacity336, nonce `5945935965481c83`) — `failed` на 169 операциях и 163 архивах после 2 ч 41 мин. Разбор очереди архивов держался до конца. Node завершился через `abort()`, текст ошибки не сохранился. Гипотеза — рост кучи с каждой операцией (время операции растёт с 5 до 22 с за 70 операций). Пакет снят, VPS свободен, повтора нет; пункт B2 открыт | | 2026-11-20 | Причина установлена: продукт создавал `AsyncLocalStorage` на каждый опрос (Node держит их вечно), исправлено в `29998815`. `mmapp-test` переразвёрнут (Gitea `2745`), B1 повторён (12,1 с), **B2 принят**: 337/336/1348, 0 ошибок воркера, 5 ч 40 мин, очистка подтверждена. Оба пункта прогона B закрыты | | 2026-11-19 | Оптимизация продукта (keep-alive REST, права раз на этап, параллельные чтения, сервисы WireGuard/scoped/IPsec) и шардированные тесты; A2 пройден на слое v28 (продукт `1e96ddac`) | +| 2026-11-21 | Этап 3 закрыт: A6 и A7 приняты (5 повторов подряд), IPsec через MCP принят по D11 (5 из 5 на `a7d85fd0`) после трёх исправлений продукта: счётчики `/interface` (`28738785`), совместимость с RouterOS 7.24 (`e7eb108c`), ожидание глобальной блокировки (`a7d85fd0`). В этапе 3 открытых пунктов нет | ## Решения владельца 2026-11-17 по прогонам B и C diff --git a/docs/mcp-stand-run-a-plan.md b/docs/mcp-stand-run-a-plan.md index fa011d35..c7f6867f 100644 --- a/docs/mcp-stand-run-a-plan.md +++ b/docs/mcp-stand-run-a-plan.md @@ -478,7 +478,7 @@ o route to host; при этом остаются требования 0 отв - **После прогона** (условие владельца «все токены обнули»): подключения `a3-manual` и `a3-measure` отозваны, MCP на `mmapp-test` выключен, переменные с токенами очищены; в БД 0 активных каналов управления, 0 незавершённых операций и 0 открытых планов. Тестовая учётная запись портала `a3-agent` отключена (`disabled`, портал проверяет это при входе, обновлении и OIDC), её 8 refresh-сессий отозваны, пароль удалён из переменных среды; при необходимости включается обратно с новым паролем. - Открыто для владельца: сбой RouterOS на CHR2 (второй случай на стенде) можно разобрать по `autosupout.rif`, скачивание файла с CHR требует твоего разрешения. -## IPsec через MCP (2026-11-21): сценарий готов, прогон упёрся в дефект продукта +## IPsec через MCP (2026-11-21): принят по D11 после трёх исправлений продукта **Решение владельца (2026-11-21).** Инструменты `mm_ipsec_*` строят только серверную сторону road warrior, клиента IPsec через MCP настроить нельзя. Поэтому: @@ -585,7 +585,7 @@ o route to host; при этом остаются требования 0 отв - Попадание применения на такой опрос даёт обычный `Error` «Глобальная конфигурация изменяется другой операцией» (не `McpError`). Рантайм MCP превращает любое такое исключение в `rejected`/`DEVICE_UNAVAILABLE` без строки шага. - Признаки совпадают: 0,1–0,2 с до отказа, нет шага и записей, разные операции, около 2 из 24 применений. - Следствие для пользователя: одобренный человеком план теряется из-за фонового опроса, а код ошибки указывает не туда. -- Остаются в БД `mmapp-test`: два PSK-секрета; операции `server_init` `unknown` (попытка с `comment`), `user_create` и `server_remove` `rejected`; завершённые и отменённые планы. +- Остаются в БД `mmapp-test` (продукт их не удаляет; итог после всех прогонов дня): 11 зашифрованных PSK-секретов; операции IPsec — 40 `applied`, одна `server_init` `unknown` (попытка с `comment`), по одной `user_create` и `server_remove` `rejected`/`DEVICE_UNAVAILABLE`; 6 строк отозванных подключений; завершённые и отменённые планы. На VPS: 14 резервных копий `/root/backups/*pre-*` (БД и `.env`) и 8 тегов `mmapp-test/backend`. - Проверено попутно: правила `/system/logging` на обоих CHR — только 4 стандартных (временное отладочное удалено); «задокументированное исключение» сверки CHR1 — строка сессии REST в `/ip/service`. - Тесты на итоговом коде (`f0d701d8`): `test-mcp-postgres.mjs --module-completion` (VRF 7 случаев, IPsec init, удаление сервера, откат ревизии IPsec, откат WireGuard) и `--only=ipsec-create` проходят. @@ -595,12 +595,15 @@ o route to host; при этом остаются требования 0 отв - перед применением операции с сервисным шагом рантайм MCP ждёт глобальную блокировку конфигурации до 30 с (`MCP_APPLY_LOCK_WAIT_MS`, параметр `waitMs` у `withApplicationMutationLock`; остальные 48 вызовов без изменений); - занятость после ожидания — `ConfigurationBusyError` (`McpError` `CONFIGURATION_BUSY`, прежний текст и 409) вместо обычного `Error`; - неожиданные исключения рантайма пишутся в журнал (`mcp.operation.unexpected-error`: класс и замаскированное сообщение). -- **Тесты:** в `operation-config-lock-lease.sql-helper.ts` добавлен случай на настоящей рекомендательной блокировке PostgreSQL. Сборщик держит блокировку в разделяемом режиме: без ожидания — сразу `CONFIGURATION_BUSY`/409, с ожиданием — отказ по сроку или вход после освобождения (`--operation-locks`, 9 случаев). `--module-completion` и `--only=ipsec-create` на изменённом коде проходят. +- **Тесты:** в `operation-config-lock-lease.sql-helper.ts` добавлен случай на настоящей рекомендательной блокировке PostgreSQL. Сборщик держит блокировку в разделяемом режиме: без ожидания — сразу `CONFIGURATION_BUSY`/409, с ожиданием — отказ по сроку или вход после освобождения (`--operation-locks`, 9 случаев). `--module-completion` и `--only=ipsec-create` на изменённом коде проходят. На итоговом коде (`b30a81f4`) шардированный набор `test-mcp-postgres-sharded.mjs` — 6 из 6 шардов (первичному нужен `MMAPP_PG_CLIENT_BIN` с `pg_dump`: без него он обрывается на тесте резервной копии БД, это окружение), набор A7 — 205 из 205. Явных ожиданий прежнего мгновенного отказа или `DEVICE_UNAVAILABLE` от занятой блокировки в тестах нет: сборщики по-прежнему отказывают с 409, текст запроса блокировки не изменился. - **Выкатка:** Gitea 2751, backend `sha256:9f96dfa1…` → `mmapp-test/backend:mcp-a7d85fd0`; резервная копия БД и `.env` — `/root/backups/…-pre-a7d85fd0-…`. Вход VPS в реестр теперь постоянный (решение владельца), `docker logout` не выполняется. - **Пять прогонов подряд** (09:11–09:21 UTC, около 2 мин каждый): `e55dd89b`, `35de523c`, `4ea0c91f`, `87820788`, `2a0dfc6c` — все `verdict.passed=true`. - В каждом: 4 одобрения в UI (HTTP 200), 4 операции `applied`/`passed` с чтением в UI. Неодобренное применение отклонено `APPROVAL_REQUIRED`, контрольный ping 0/3, в туннеле 10/10, рост 560 байт на каждом из четырёх SA (SPI попарно), клиент онлайн в `state_get`. - В журнале продукта 4 одобрения владельца и 0 открытых планов. Остаток продукта — profile и proposal `ipsec-vpn`, удалён раннером. Сверка 66/66 на обоих CHR. - - В журнале backend за серию 0 событий `mcp.operation.unexpected-error`. Ожидание блокировки отдельно не журналируется, поэтому, попадали ли применения на опрос сборщиков, не видно. + - В журнале backend за серию 0 событий `mcp.operation.unexpected-error`. Повторов подготовки плана (`prepareRetries`) ни в одном прогоне нет. + - **Связь с расписанием сборщиков** (`scheduler_runs` `mmapp-test`, только чтение). Трафик, uptime, GRE/BGP и движок алертов запускаются пачкой каждые 30 с, примерно в :10–:12,7 и :40–:42,7, занятость около 8 %. Оба отказа на `e7eb108c` пришлись на конец такой пачки (08:20:42,9; 08:36:42,6, во втором случае движок алертов работал в 08:36:42,671–42,678). + - В финальной серии два из 20 применений попали в окна сборщиков (`server_init` 09:17:43,206 рядом с GRE/BGP и движком алертов; `server_remove` 09:18:57,762 рядом с uptime) и прошли. + - Ожидание блокировки отдельно не журналируется, а какие задания держат именно эту блокировку, по коду до конца не проверено. Поэтому прямого доказательства, что ожидание срабатывало, нет. При прежней частоте (2 отказа на 6 прогонов) пять чистых прогонов подряд случайно выпали бы примерно в одном случае из восьми. - **Доступы после серии закрыты:** подключение отозвано, MCP выключен, `a3-agent` отключена, токен и пароль удалены; 0 незавершённых операций и 0 открытых планов. - **Ошибка раннера при подготовке:** раннер читал ID подключения из окружения процесса, где остался ID отозванного подключения; проверка плана владельцем это поймала. Теперь значения берутся из переменных пользователя Windows.