feat(mcp): доступ AI-клиентов к Manager через MCP #1

Merged
denozord merged 163 commits from codex/mcp-foundation into main 2026-11-21 22:35:17 +07:00
Owner

Что это

Manager становится MCP-сервером. Внешний AI-клиент читает состояние серверов и готовит изменения RouterOS и приложения. Каждое изменение проходит один путь: план → проверка политики → подтверждение человеком, когда оно нужно → запись → проверка чтением.

По умолчанию всё выключено: MCP, профили Route AI и автоматическое восстановление маршрутов. Это закреплено тестом на свежей базе.

Что входит

  • Доступ. Подключения с режимами «Наблюдатель», «С подтверждением», «Автономный». У каждого — область (серверы и операции), права, лимиты, срок. Ещё есть:
    • защищённые объекты, временные допуски до 24 часов;
    • срок прав владельца — не больше 24 часов;
    • пауза, отзыв, аварийная остановка.
  • Клиенты. Streamable HTTP с Bearer-токеном, stdio-мост, OAuth (PKCE S256, ротация refresh token).
  • Операции.
    • Типизированные объекты RouterOS: интерфейсы, адреса, маршруты, VRF, туннели, OSPF, BGP, IPsec, контейнеры, сертификаты.
    • Сервисы приложения: логи, мониторинг, NetFlow, резервные копии, оповещения и другие.
    • Через MCP доступны 202 из 265 REST-маршрутов, 63 исключены (транспорт, авторизация, управление самим MCP).
  • Надёжность записи.
    • Намерение сохраняется до записи.
    • Повтор с тем же ключом идемпотентности не повторяет запись.
    • Неподтверждённый исход не повторяется автоматически.
    • Есть сверка, обратные планы, восстановление ревизий.
    • Записи в глобальную конфигурацию из интерфейса и из MCP идут по одной.
  • Route AI. Постоянный контроллер переключения маршрутов, проверка пути, независимые каналы управления. Автоматического восстановления нет.
  • Отзыв порталом. Подписанный webhook /_internal/mcp/portal/revocations.
  • Восстановление базы приложения через MCP — только с подтверждением человеком.
  • Веб-раздел «Система» → «MCP».

Документация

  • docs/mcp.md — настройка, подключение, возможности, ограничения.
  • docs/mcp-enable-guide.md — включение по шагам: наблюдение → подтверждения → ограниченная автономность.
  • docs/mcp-final-manifest.md — что проверено, чем и с каким статусом, включая историю отказов.
  • docs/mcp-completion-plan.md — план завершения и открытые решения.

Проверки

Полный этап 1 на итоговом коде:

Проверка Итог
npm run lint 0 ошибок, 45 предупреждений
Сборки корня и backend, tsc --noEmit без ошибок
test:mcp в корне 4 из 4 node-тестов, Playwright 43 из 43
Playwright авторизации 16 из 16
test:mcp backend пройден
test:mcp:pg:all 38 профилей, упавших нет

Первый прогон упал на трёх устаревших заглушках тестов, исправлено в daec2b47. На стенде из двух CHR RouterOS 7.24.5 приняты:

  • IPsec через MCP — 5 прогонов подряд;
  • маршрутизация A3;
  • выдача токена и подписанный отзыв в настоящих Manager и Portal;
  • POLL, DB и другие направления.

Подробности в манифесте.

Перед слиянием и выкаткой

  • Миграции. 43 новые миграции 0015–0057, применяются при старте backend.
  • Публичного маршрута MCP в deploy нет. Поставляемые deploy/docker-compose*.yml передают backend только /api и /health, а /mcp на основном домене — страница веб-раздела. Для внешнего клиента нужен отдельный маршрут на backend для /mcp, /oauth/* и /.well-known/*, например отдельный хост. Плюс MCP_PUBLIC_URL и MCP_UI_URL, см. docs/mcp.md. На стенде клиент подключался к backend напрямую. Решение за владельцем.
  • Ограничения (статус «отложено» или «ограничение» в манифесте):
    • физическая независимость путей не доказывается (PATHS);
    • лимит памяти 2 ГиБ не подтверждён (RAM-1);
    • автоматическое восстановление маршрутов недоступно (autoRecovery, RT-3);
    • создание VRF поверх активного GRE может закончиться «Выполнена частично».
  • Объём. 163 коммита, 2770 файлов. Из них 951 в docs, в том числе 773 JSON-доказательства приёмок.

🤖 Generated with Claude Code

## Что это Manager становится MCP-сервером. Внешний AI-клиент читает состояние серверов и готовит изменения RouterOS и приложения. Каждое изменение проходит один путь: план → проверка политики → подтверждение человеком, когда оно нужно → запись → проверка чтением. **По умолчанию всё выключено:** MCP, профили Route AI и автоматическое восстановление маршрутов. Это закреплено тестом на свежей базе. ## Что входит - **Доступ.** Подключения с режимами «Наблюдатель», «С подтверждением», «Автономный». У каждого — область (серверы и операции), права, лимиты, срок. Ещё есть: - защищённые объекты, временные допуски до 24 часов; - срок прав владельца — не больше 24 часов; - пауза, отзыв, аварийная остановка. - **Клиенты.** Streamable HTTP с Bearer-токеном, stdio-мост, OAuth (PKCE S256, ротация refresh token). - **Операции.** - Типизированные объекты RouterOS: интерфейсы, адреса, маршруты, VRF, туннели, OSPF, BGP, IPsec, контейнеры, сертификаты. - Сервисы приложения: логи, мониторинг, NetFlow, резервные копии, оповещения и другие. - Через MCP доступны 202 из 265 REST-маршрутов, 63 исключены (транспорт, авторизация, управление самим MCP). - **Надёжность записи.** - Намерение сохраняется до записи. - Повтор с тем же ключом идемпотентности не повторяет запись. - Неподтверждённый исход не повторяется автоматически. - Есть сверка, обратные планы, восстановление ревизий. - Записи в глобальную конфигурацию из интерфейса и из MCP идут по одной. - **Route AI.** Постоянный контроллер переключения маршрутов, проверка пути, независимые каналы управления. Автоматического восстановления нет. - **Отзыв порталом.** Подписанный webhook `/_internal/mcp/portal/revocations`. - **Восстановление базы приложения** через MCP — только с подтверждением человеком. - **Веб-раздел** «Система» → «MCP». ## Документация - [docs/mcp.md](docs/mcp.md) — настройка, подключение, возможности, ограничения. - [docs/mcp-enable-guide.md](docs/mcp-enable-guide.md) — включение по шагам: наблюдение → подтверждения → ограниченная автономность. - [docs/mcp-final-manifest.md](docs/mcp-final-manifest.md) — что проверено, чем и с каким статусом, включая историю отказов. - [docs/mcp-completion-plan.md](docs/mcp-completion-plan.md) — план завершения и открытые решения. ## Проверки Полный этап 1 на итоговом коде: | Проверка | Итог | | --- | --- | | `npm run lint` | 0 ошибок, 45 предупреждений | | Сборки корня и backend, `tsc --noEmit` | без ошибок | | `test:mcp` в корне | 4 из 4 node-тестов, Playwright 43 из 43 | | Playwright авторизации | 16 из 16 | | `test:mcp` backend | пройден | | `test:mcp:pg:all` | 38 профилей, упавших нет | Первый прогон упал на трёх устаревших заглушках тестов, исправлено в `daec2b47`. На стенде из двух CHR RouterOS 7.24.5 приняты: - IPsec через MCP — 5 прогонов подряд; - маршрутизация A3; - выдача токена и подписанный отзыв в настоящих Manager и Portal; - POLL, DB и другие направления. Подробности в манифесте. ## Перед слиянием и выкаткой - **Миграции.** 43 новые миграции `0015`–`0057`, применяются при старте backend. - **Публичного маршрута MCP в deploy нет.** Поставляемые `deploy/docker-compose*.yml` передают backend только `/api` и `/health`, а `/mcp` на основном домене — страница веб-раздела. Для внешнего клиента нужен отдельный маршрут на backend для `/mcp`, `/oauth/*` и `/.well-known/*`, например отдельный хост. Плюс `MCP_PUBLIC_URL` и `MCP_UI_URL`, см. `docs/mcp.md`. На стенде клиент подключался к backend напрямую. Решение за владельцем. - **Ограничения** (статус «отложено» или «ограничение» в манифесте): - физическая независимость путей не доказывается (PATHS); - лимит памяти 2 ГиБ не подтверждён (RAM-1); - автоматическое восстановление маршрутов недоступно (autoRecovery, RT-3); - создание VRF поверх активного GRE может закончиться «Выполнена частично». - **Объём.** 163 коммита, 2770 файлов. Из них 951 в `docs`, в том числе 773 JSON-доказательства приёмок. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
denozord added 163 commits 2026-11-21 22:30:12 +07:00
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Хеши в migration-manifest.ts закреплены за CRLF-байтами; в индексе были LF-блобы из main, и на чистом чекауте проверка манифеста не прошла бы.

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
28 файлов закреплены хешами по CRLF-байтам рабочего дерева, а в индексе были LF-блобы.

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Тест scheduler-automatic-root отстал от исходников: не хватало заглушек карантина восстановления, общего шлюза БД и проверки активации. ESLint больше не обходит локальные каталоги tmp, сгенерированный .ci/docker и dist-*, ошибки Codex в новых скриптах и тестах устранены.

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Устаревший тест, не дефект продукта. Аудит configuration.intent теперь
пишется через requestAccountingWrite (транзакционный клиент), а не через
pool.query, поэтому перехват pool.query в режиме late-intent не срабатывал:
конкурентное изменение не внедрялось и запись законно завершалась applied.
Сценарий переведён на общий фикстур afterConfigurationIntentCommit (как в
mcp-acme-test.ts): изменение updated_at после фиксации намерения ловит
fence перед SQL, запись не отправляется, итог unknown без повтора.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Устаревший тест, не дефект продукта. Аудиты configuration.intent и
configuration.acknowledged пишутся через requestAccountingWrite на клиенте
из pool.connect(), поэтому перехват pool.query в сценариях поздней отмены
доступа и потерянного подтверждения никогда не срабатывал (revoked=false).
Общий фикстур configuration-audit-commit получил помощник
loseConfigurationAcknowledgement; тест GeoIP использует его и
afterConfigurationIntentCommit. Ожидания продукта (нет повторного запроса,
итог unknown при потере подтверждения) не менялись.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Устаревший тест, не дефект продукта. Аудит configuration.intent для
RouterOS-записи пишется на транзакционном клиенте (requestAccountingWrite),
поэтому перехват pool.query не срабатывал: поздняя пауза, защита или
изменение ревизии не внедрялись, и восстановление законно завершалось
applied. Фикстур afterConfigurationIntentCommit принимает предикат по
payload (method), тест GRE использует его; ожидания (unknown, без записи
в RouterOS) не менялись.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Скрипт берёт изменённые файлы из Git и запускает только тесты, которые на них ссылаются. Тесты на PostgreSQL он не запускает, а выводит нужный npm-профиль.

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Устаревший тест, не дефект продукта. Приёмки ARP и IPv6 ND оставляли свою
строку servers (только enabled=false), тогда как все соседние приёмки
удаляют фикстуру. После 88e82702 они создаются стабильно, и лишние строки
доходили до Legacy OSPF, который по задокументированному правилу требует
допуск ко всему каталогу (не более 10 серверов, все в scope). Соединение
приёмки OSPF ограничено серверами [1,2], поэтому каталог отклонялся.
Продуктовое правило не ослабляется: фикстуры удаляются в finally (FK на
servers каскадные; на них ничего позже не ссылается).

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Устаревшие тесты, не дефект продукта. Аудиты configuration.intent и
configuration.acknowledged пишутся через requestAccountingWrite на клиенте
из pool.connect(), поэтому перехваты pool.query в Legacy OSPF, журнале
событий, IPsec peer update, IPsec native write и native conservation не
срабатывали. Фикстур configuration-audit-commit получил общий примитив
hookConfigurationAudits (после COMMIT намерения / перед подтверждением);
afterConfigurationIntentCommit и loseConfigurationAcknowledgement построены
на нём. Ожидаемые итоги (unknown/partial, без записи и повтора) не менялись;
перехват afterVerified в native conservation остаётся на pool.query, так как
runtime обновляет шаги через пул.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Устаревшая фикстура, не дефект продукта. Сценарий mixed passive добавляет
непассивный шаблон OSPF на fixture-loop без Full-соседа, а мок RouterOS в
этой точке отдаёт пустой /interface. resolveOspfInterfaceSelectors
закрыто отказывает (STATE_CONFLICT), если имя интерфейса шаблона нельзя
подтвердить ни соседом, ни инвентарём, — это корректная защита. На реальном
маршрутизаторе интерфейс шаблона есть в /interface, поэтому для этого цикла
мок отдаёт инвентарь с fixture-gre и fixture-loop. Ожидание теста
(шаблон без Full не блокирует и не входит в план) не менялось.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Устаревшие тесты, не дефект продукта. Как и в предыдущих исправлениях,
configuration.intent пишется через requestAccountingWrite на клиенте из
pool.connect(), поэтому перехваты pool.query в приёмках WireGuard import
(поздняя защита интерфейса/пира после намерения) и scoped route community
(afterIntent) не срабатывали. Они переведены на afterConfigurationIntentCommit
и hookConfigurationAudits; фикстур получил beforeIntent для имитации
недоступного аудита намерения. Перехват wireguard.import.checkpoint остаётся
на pool.query: этот аудит пишется через пул.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Устаревшие тесты, не дефекты продукта:
- Пауза во время списка шаблонов OSPF: план читает список шаблонов один раз
  (затем два print-запроса флагов, перед каждым повторная проверка доступа),
  поэтому второй итерации «пауза во время второго списка» не существует.
  Диагностический прогон подтвердил одну выборку списка; итерация 0 (пауза
  во время единственного списка → отказ UNAUTHORIZED) сохранена.
- Отказ хранилища аудита перед нативной записью: аудит намерения пишется на
  транзакционном клиенте, перехват pool.query заменён hookConfigurationAudits
  с beforeIntent.

Режим MCP_INTEGRATION_CONTINUE=1: помощник soft() оборачивает только
самостоятельные приёмочные вызовы после блока OSPF (каждый восстанавливает
свои фикстуры в finally), записывает ошибку и продолжает; в конце печатается
список и выставляется exitCode=1. Встроенные проверки монолита и служебные
вызовы (scheduler, ingest, refreshScheduler) не обёрнуты: их сбой искажает
общее состояние для последующих шагов. Без переменной поведение прежнее.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Устаревшие тесты, не дефекты продукта.
- Фикстур configuration-audit-commit оборачивал клиента через Proxy; вместе с
  committed-scoped-checkpoint-observer, который подменяет client.query на
  экземпляре, это давало бесконечную рекурсию (RangeError в приёмке scoped
  route community). Теперь фикстур, как и наблюдатель, подменяет query на
  экземпляре и восстанавливает его при release; отключение не затирает более
  поздние обёртки pool.connect.
- Приёмка NetFlow purge внедряла сбой журнала событий через pool.query, а
  событие пишется через withPartitionWrite на клиенте pool.connect(), поэтому
  режим journal-failure не срабатывал. Сбои журнала/обслуживания партиций
  проверяются в обоих перехватчиках; сообщения assert называют режим.
Проверено: node scripts/test-mcp-postgres.mjs --recovery-maintenance → exit 0.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Устаревшие тесты, не дефекты продукта (профили test:ipsec и
test:system-database):
- ipsec-nat и ipsec-group: аудит конфигурации теперь пишется через
  requestAccountingWrite (BEGIN, pg_catalog.pg_try_advisory_xact_lock_shared,
  COMMIT), а SQL-заглушка знала только прежние запросы и падала, превращая
  ожидаемый отказ preflight 409 в 502. Заглушка принимает новые запросы
  блокировки и границы транзакции.
- database-restore-audit: bootstrap.ts теперь импортирует модули карантина и
  контрольной точки восстановления и читает process.env; в карту заглушек
  добавлены значения обычного запуска (без карантина и checkpoint), в
  контекст передан пустой process.env. Проверка порядка (guard → миграции →
  импорт → аудит) не менялась.
Проверено: --all --regression-only для test:ipsec и test:system-database → exit 0.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Классификатор перехода помечает в месте отказа только состояние, которое
RouterOS выводит сам у перемещаемого GRE без MAC: отсутствие LL, connected-маршрута,
running=false. При таком отказе исполнитель до 3 раз (пауза 1 с) повторяет
полное огороженное чтение после записи и классификацию; запись не повторяется.
Остальные отказы прерывают сразу; после предела бросается тот же отказ,
в диагностике поле attempts.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Решение владельца по эксперименту на стенде: адрес может не вернуться; возврат принимается один раз.

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
Клиент RouterOS открывал новое TCP-соединение на каждый запрос, а одна
запись MCP делает 100–470 запросов. Замер на CHR: последовательный GET
105 -> 54 мс (CHR1) и 215 -> 114 мс (CHR2). Свободное соединение
закрывается через 2 с простоя (RouterOS держит его 30 с), предел
2 сессии на роутер сохранён.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Решение владельца 2026-11-19 (ускорение и упрощение проверок при той же итоговой защите):
- права шага RouterOS доказываются свежей проверкой на границах этапа (начало шага,
  прямо перед отправкой, сразу после ACK, перед каждой записью); чтения внутри этапа
  повторно используют доказательство моложе 2 с. Сервисные шаги проверяют права на
  каждый вызов, как раньше: их проверка общая для чтений и записей;
- независимые каталоги при проверках и в снимке VRF читаются параллельно (пул REST
  ограничивает 2 соединениями на роутер), порядок снимка прежний; после ACK изменённый
  каталог читается один раз;
- конфликт каталога в проверке перед отправкой помечает операцию «не отправлено»;
- VRF: помеченный отказ классификатора окончательный, только если тот же отказ
  повторился на свежем чтении (в пределах 8 повторов).

Интеграционный набор PostgreSQL: 164 проверки пройдены; общие 92 проверки 401 -> 354 с.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
После всех проверок и закрытия ресурсов процесс оставался жить 15+ минут из-за
чужого MessagePort (таймеров и сокетов не осталось). Явный выход после сброса вывода.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
`npm --prefix backend run test:mcp:pg:sharded`: основной набор и три шарда
(маршрутизация scoped, создание WireGuard, изменение WireGuard), каждый со своей
одноразовой PostgreSQL. Основной набор пропускает ровно те приёмки, что идут в
шардах (MCP_INTEGRATION_SKIP), неизвестное имя - ошибка с обеих сторон.

Замер: 430 с вместо 958 с проверок (плюс прежние 15 минут зависания на выходе);
все 147 проверок полного прогона на месте, этап восстановления БД пройден.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Опция `part` (forward, inverse, route-ai) запускает один этап приёмки; без опции
выполняются все три, как раньше. Основной набор пропускает приёмку целиком, только
если в шардах перечислены все её части; неполный набор частей - ошибка
(acceptance-shards.test.ts).

Замер: весь набор 334 с (был 430 с, до шардов 958 с проверок), 149 строк
результатов совпадают с прошлым шардированным прогоном, каждый этап выполнен один раз.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Новый шард overlay-ipsec: verifyMcpFlowOverlay, удаление интерфейса WireGuard и
четыре приёмки IPsec (удаление пира, пользователя, сертификата, изменение пира).

Замер: весь набор 272 с (было 334 с), 149 строк результатов совпадают.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Профиль приёмки создания WireGuard (81 с): ~3000 свежих проверок прав MCP, ~20000
проверок источника прав и ~63000 чтений файлов состояния с диска (24 с) - всё перед
каждым чтением роутера.
- сервисы WireGuard (создание интерфейса и пира, изменение, импорт): собственная
  проверка (ключи, защиты, допуск) раз на этап, чтения переиспользуют доказательство
  моложе 2 с; перед каждой нативной записью права MCP и защиты по-прежнему
  проверяются заново (executeGuardedConfigurationWrite), у создания интерфейса и
  собственная проверка перед отправкой свежая;
- assertVerifiedConfigurationReadAccess - проверка этапа только для чтений;
  assertVerifiedConfigurationAccess остаётся свежей (записи и публикации);
- access-generation и отметки отзыва портала проверяются через stat и перечитываются
  только при изменении файла (замена видна сразу); ключ шифрования читается как раньше.

Приёмка создания WireGuard 81 -> 14 с отдельно; шарды WireGuard 224/198 -> 69/66 с;
весь набор зелёный, 149 строк результатов на месте.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
- контекст маршрута: проверка перед каждым GET (права, ключ источника, поколение,
  SQL) переиспользует доказательство этапа (2 с); границы фаз и внешний
  context.fence() по-прежнему проверяют заново;
- IPsec (удаление пира, пользователя, сертификата, изменение пира): собственная
  проверка сервиса раз на этап для чтений, assertVerifiedConfigurationReadAccess для
  чтений; перед каждой нативной записью права и защиты проверяются заново
  (executeGuardedConfigurationWrite), checkpoint-записи аудита - свежая проверка;
  сверка (reconcile) остаётся строгой: отзыв прав останавливает следующее же чтение.

Шарды: scoped forward/inverse/route-ai 205/240/324 -> 61/88/133 с, overlay-ipsec
175 -> 133 с (четыре приёмки IPsec 49 -> 19 с); весь набор 276 с, 149 строк на месте.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
- шард misc: 14 приёмок, которые создают свои серверы и проходят в чистой БД
  (BGP, фильтры, аптайм, путь, артефакты логов, live-трафик, контекст пути,
  management transport, сохранение и CREATE ID); verifyMcpAlertsOutbox зависит от
  состояния основного набора и остался в нём;
- шарды scoped forward+inverse и WireGuard объединены: меньше процессов спорят за CPU;
- acceptance-shard.test.ts при MCP_INTEGRATION_CONTINUE=1 продолжает после отказа
  и перечисляет все упавшие приёмки;
- mcp-host-files: в сообщение отказа добавлен error_code (один нестабильный отказ
  rejected до отправки за 4 прогона, причина не установлена).

Замер: основной набор отдельно 180-277 с (разброс машины до 30%), шарды 93-144 с;
149 строк результатов на месте.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Запуск runs/2026-11-19-32678993: траектория a → b → a, 6 окон 3/3,
два решения владельца, сверка 66/66 на обоих CHR, очистка 28/0.
Записаны два неуспешных запуска до него (ошибка SQL раннера и сбой
RouterOS на CHR2) и отзыв подключений после прогона.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Одобрения выполнены агентом под тестовой учётной записью (D8), печати
V63 нет; учётная запись a3-agent отключена, сессии отозваны. После
перезагрузки CHR2 содержимое динамических строк совпадает, новый
эталон CHR2 — final-chr2.json запуска 32678993.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Файл CHR2 от 08.10: undo упал по OOM своей кучи. Сбой 19.11 файла не
оставил. Чтение /system/history на CHR1 вызвало сбой службы и вытеснило
старый autosupout. API 8728 на обоих CHR под подбором паролей.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Исходник B привязан к 7848e38a (образ mmapp-test), числа cold143
143/22/54/4/151 на текущем коде не сдвинулись, тесты снятия и
устойчивого опроса проходят, lock совпадает с архивом зависимостей,
допуск VPS по ресурсам проходит; найдены остатки прежних прогонов.
Разбор CHR: гипотеза про undo помечена как непроверенная.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Опрос держит исключительную блокировку писателя разделов на всё время
выполнения, тик воркера на ней обрывается до компакции; фикстура идёт
по одной операции, поэтому архив выходит раз за цикл и задержка
растёт до предела 10 минут (отказ 13.11 на источнике 22). Варианты
исправления и план B2 с часовыми контрольными точками.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Опрос держит исключительную блокировку записи разделов на всё время
работы, поэтому воркер успевал архивировать только один источник между
опросами. Теперь воркер разбирает очередь, пока писатель свободен
(каждый архив — прежний цикл из двух транзакций, уступает ждущему
опросу).

Права опроса проверяются свежими в начале этапа, перед каждой
отправкой на RouterOS и перед COMMIT каждой пишущей транзакции данных
или DDL; журнал и чтения используют доказательство не старше 2 с.
Холодный опрос: проверок допуска ~3700 -> 32, операция 19,9 -> 3,2 с.

Тесты: разбор очереди, уступка ждущему опросу, отзыв прав при
удержанных чтениях RouterOS, граница числа проверок; исправлено
устаревшее ожидание двух соединений в варианте с потерей ACK.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Свежей стала только последняя проверка в beforeDispatch, после
перечитывания контекста; число проверок прежнее (одна на отправку).

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Фабрики аренды обслуживания и production-зависимостей опроса создавали
по экземпляру AsyncLocalStorage на каждую сессию. Node держит включённые
экземпляры вечно и копирует каждый в каждый асинхронный ресурс, поэтому
опрос замедлялся и к ~170 операциям исчерпывал кучу (abort на Linux B2).
Теперь один экземпляр на процесс и свой ключ у каждой фабрики.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Операторская цепочка source58 на Linux пройдена до двух реплик backend,
C4 — пять отказов POSIX без подключений к БД. Две находки ждут решения
владельца: JIT PostgreSQL против лимита 5 с захвата каталога и блокировка
первого MCP-восстановления под карантином на свежем журнале.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Отметкой попытки при отсутствующем журнале считаются только .used и
квитанции applied/unknown. Квитанции blocked и running без .used не доходят
до записи журнала, поэтому больше не блокируют первое MCP-восстановление
под карантином и старт backend после отклонённой попытки.

Захваты каталога выключают JIT: на PostgreSQL 18 компиляция запроса
unsupported занимала ~5,4 с при лимите 5 с (выполнение 0,2 с). Runtime —
SET LOCAL jit = off в снимке каталога и контролируемой схеме, оператор —
-c jit=off в STARTUP_OPTIONS.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Решения владельца от 21.11 и порядок для оператора: после complete
MCP-восстановления с внешней контрольной точкой — maintenance-inspect и
maintenance-resolve; захваты каталога выключают JIT; квитанции без .used
не закрывают старт при отсутствующем журнале. Образ backend Gitea 2746.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Наблюдение текущего состояния снимало схему только по public. Источник 58
ставит на таблицы public триггеры с функциями mmapp_control, и захват
отказывал на внешних зависимостях («Duplicate catalog row: unsupported»),
поэтому старт backend после MCP-восстановления нельзя было открыть.
При наличии mmapp_control область теперь та же, что у runtime: public и
mmapp_control со служебными event-триггерами.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Приёмочный прогон 4db568f58566878a на образе e69d5f0a (Gitea 2747),
PostgreSQL 18 с JIT по умолчанию: восстановление из Edge через MCP с
подписанным журналом, rebind эпохи 4, seal, complete, maintenance-resolve,
две реплики с защищённой записью; C4 — пять отказов без подключений к БД.
Отмечены EXTERNAL-UI (защищённое восстановление) и DB-4.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Три проверки DB-4 из критерия C4 (архив с mmapp_control, потребители после
сбоя посреди восстановления, доступ из ключей и журнала архива) не
выполнялись — отметка снята. Уточнено, где наблюдались отказы по
контрольной точке и состоянию, что сгенерировал харнесс, какие тесты падают
одинаково до и после правок и что оставлено на VPS.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Прогон 30fb9d4ac7d56117 на образе e69d5f0a (JIT по умолчанию): архив с
mmapp_control отвергается и без пина, и с пином (граница оглавления, таблица
не заменена); после сбоя посреди восстановления новый backend отказывает без
подключений к PostgreSQL; токен MCP, выданный до архива, после
восстановления получает 401. Отказы старта по контрольной точке и состоянию
подтверждены и на принятом образе.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Повтор bff61f8d715cf6bf: после восстановления токен MCP, выданный до
архива, получает 401 при активной неистёкшей строке подключения,
generationValid=false и сменённом access-generation; 48 операторских и
backend-файлов и каталогов — 0600/0700, UID 65534. Уточнены пауза в прогоне
30fb9d4ac7d56117, неустановленная причина расхождения хеша данных и
локальный сценарий карантина.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Edge: npm run test:mcp пять раз, 4/4 и 43/43, retries 0. Маршрутизация: набор из 205 тестов восстановлен по журналу (17 файлов) и пройден пять раз, 205/205.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Доказательство состояния mm_ipsec_server_init_plan и отката ревизии IPsec включало весь /interface со счётчиками rx/tx-byte. На живом CHR два чтения подряд расходились: подготовка плана отказывала STATE_CONFLICT, а fence и сверка после каждой из 13 записей останавливали бы инициализацию на полпути. Счётчики и время смены линка исключены, конфигурация и running остаются запечатанными.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Исправлен и выкачен дефект счётчиков /interface (28738785). Второй дефект: RouterOS 7.24.5 не принимает comment у /certificate, а продукт создаёт и опознаёт свои сертификаты по комментарию. Стенд чист, доступы отозваны.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Проверено пробами на стенде RouterOS 7.24.5: /certificate не принимает comment, sign и export-certificate адресуются только по .id и не принимают name и days-valid, подпись меняет authority и digest-algorithm, peer с address 0.0.0.0/0 возвращается без address, id файлов имеют вид **<base62>. Сертификаты продукта опознаются по имени и цепочке подписи, версии операций повышены (init 5, user_create 3, экспорт 2). Стабы приёмки отказывают как RouterOS 7.24. Генеральная репетиция на CHR: init 13 и PSK-клиент 2 команды сошлись с проекцией продукта, туннель, ping 10/10, рост SA, сверка 66/66.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Прогон 925de9e8 на mmapp-test (backend e7eb108c): четыре операции mm_ipsec_* с одобрением в UI, отказ без одобрения, туннель, ping 10/10, рост installed-sa, сверка 66/66, доступы отозваны. Замечания: server_remove оставляет profile/proposal, DEVICE_UNAVAILABLE первой попытки, fast path после IPsec.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Операция с сервисным шагом брала глобальную блокировку конфигурации неблокирующим try-lock. Пока сборщик трафика или uptime держал её в разделяемом режиме, рантайм получал обычный Error и записывал rejected/DEVICE_UNAVAILABLE: одобренный человеком план терялся (стенд IPsec 2026-11-21: 2 из 24 применений). Теперь рантайм ждёт блокировку до 30 с; занятость отдаётся кодом CONFIGURATION_BUSY/409 с прежним текстом; неожиданные исключения рантайма пишутся в журнал с классом и замаскированным сообщением. SQL-тест: разделяемое удержание, отказ без ожидания, отказ по сроку, вход после освобождения.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Уточнены формулировки IPsec после повторов по D11: три исправления продукта, связь отказов с расписанием сборщиков, остатки в БД и на VPS, проверка шардированного набора (6/6) и A7 (205/205) на итоговом коде.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
mm_ipsec_server_remove_plan и REST-удаление оставляли profile и proposal ipsec-vpn (стенд IPsec 2026-11-21). Теперь они удаляются после policy и peer, если это строки продукта (метка или ipsec-vpn без комментария), не встроенные, и на них ссылаются только удаляемые строки; общие с чужой конфигурацией остаются без отказа. Версия операции 3. Тесты: модель (освобождение, общий профиль, встроенные, профиль init), приёмка со сценарием освобождения и паритетом MCP/REST.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
На свежей базе после миграций: mcp_settings.enabled=false, ни одного включённого профиля контроллера, значение столбца по умолчанию false, autoRecovery по умолчанию false; выключенный MCP отказывает токену MCP_DISABLED/503, повторное включение возвращает тот же доступ.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Манифест сопоставляет исходные критерии реестра с доказательствами и статусами без перекраски failed и unknown; отдельно история отказов и критерии вне плана завершения.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Права портала, настройки сервера, три шага включения с переходами и
возвратом, срок прав владельца, часовой бюджет в объектах, срок плана,
защиты, временный допуск, Route AI без автоматического восстановления,
пауза, отзыв, аварийная остановка и частые отказы. Надписи сверены с
интерфейсом, числа и коды — с backend и контрактами.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
«Обновить мои права» аннулирует планы и выключает профили Route AI;
контроллер останавливается и при изменении политики, отзыве токена и
ошибке проверки. Бюджет списывается при применении по календарному часу.
Уточнены кнопка «Разрешения», применение из интерфейса, «Новый токен»,
отказ APPROVAL_REQUIRED и формулировка о проверке на стенде.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Прежний docs/mcp.md перенесён без изменений текста в
mcp-implementation-history.md с пометкой «исторический». Новый mcp.md
(19 КБ) написан по коду: настройка сервера, подключение клиента, путь
изменения, возможности, Route AI, webhook отзыва, восстановление базы,
ограничения и проверки. Инструкция по включению дополнена правом
mm:settings:admin и путём «Система» → «MCP»; входящие ссылки обновлены.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Поставляемый deploy не передаёт backend /mcp, /oauth/* и /.well-known/*:
записано как ограничение и открытое решение владельца. OAuth-токены
ограничены сроком прав владельца. Добавлен mm_filter_revision_restore_plan,
требование pg_dump/pg_restore для test:mcp:pg*, путь к старым версиям в
истории Git. Запись плана уточняет, что проверено по коду.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Полный прогон этапа 1 нашёл три теста, которые грузят исходники с явным
списком зависимостей: планировщик не знал node:timers/promises (ожидание
глобальной блокировки), фрагмент runtime.ts с экспортом константы
транслировался как ES-модуль, контекст маршрутизации не получал модуль
authorization-stage. Тестам переданы настоящие модули; проверки те же.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Co-Authored-By: Claude Opus 5.5 <[email protected]>
denozord merged commit bef7f1ff72 into main 2026-11-21 22:35:17 +07:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: denozord/MikrotikManager#1