Files
MikrotikManager/docs/mcp-completion-plan.md
T
DenozordecandClaude Opus 5.5 c1abfffe26 chore(docs): пользовательская документация MCP вместо 417 КБ инженерных записей
Прежний 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]>
2026-11-21 21:25:01 +07:00

56 KiB
Raw Blame History

MCP: план завершения работ (ветка codex/mcp-foundation)

Составлен 15 ноября 2026. Отмечать выполненное: - [x]. Источники остатка: передача от 15 ноября, именованный реестр, полный план MCP.

Исходное состояние

  • В ветке нет коммитов поверх main (HEAD 5efd0339). Вся работа в рабочем дереве: 257 изменённых и 1985 новых файлов.
  • tsc --noEmit для фронтенда и бэкенда проходит. Тесты при составлении плана не запускались.
  • По записям Codex: 368 MCP-инструментов, 202 из 265 REST-маршрутов покрыты, 63 исключены, необработанных нет. Миграции 0015–0057, веб-раздел /mcp, транспорты HTTP и stdio, OAuth.
  • Открыты 7 направлений приёмки: POLL, DB, ROUTING, NATIVE, PATHS, EXTERNAL-UI, FINAL.
  • Мусор вне .gitignore: 2048 tmp-* в корне, 12 каталогов backend/dist-installation-memory*, .next-poll-rest-route-v2-20261030 (442 МБ), .serena. В docs/ 965 файлов, в основном JSON-квитанции. tsconfig.tsbuildinfo отслеживается Git.

Критерий завершения

Этапы 0–2 и 5 выполнены, MCP и контроллер выключены по умолчанию, ветка слита в main. Этап 3 идёт отдельными задачами по мере доступности стенда, этап 4 оформлен как явные решения.

Этап 0. Зафиксировать работу

  • Сделать копию tmp/: C:\Users\shats\Backups\MikrotikManager-3-tmp-20261115, 1 563 185 файлов, 33,658 ГБ. Сухой прогон robocopy подтвердил, что всё идентично (к копированию 0, ошибок по файлам 0). Пустой каталог mcp-scoped-controller-two-chr-20261105/v29-budget-candidate даёт ошибку атрибутов каталога, файлов в нём нет. Частичная копия D:\Backups\MikrotikManager-3-tmp-20261115 лишняя, удалить можно с согласия владельца
  • Дополнить .gitignore: tmp-*, backend/dist-installation-memory*, .next-poll-*, .serena
  • Снять с отслеживания tsconfig.tsbuildinfo
  • Реорганизовать квитанции в docs/ — решение владельца: оставить как есть. Изучено, не выполнено. Безопасно переносимы 238 из 773 JSON (31%): 52 читает или пишет код и тесты (в том числе по шаблонным именам), 6 нужны раннерам в tmp/, 467 упомянуты по имени внутри других JSON (закреплённые пути), 6 связаны с закреплёнными md. Нужны решение владельца и переписывание закреплений. Сейчас всё закоммичено как есть, ссылки не сломаны
  • DB-3: LF/CRLF в миграциях 0008–0013 проверено, кода менять не нужно. Выводы: (1) таблица schema_migrations в main и в этой ветке хранит только id, хеш содержимого миграции в БД не записывается, поэтому «записанных LF-хешей» в существующей БД нет; (2) controlled-migration-history.ts сверяет не файлы, а квитанции контрольной истории (mmapp_control), которых у БД из main нет; (3) байты файлов сверяет analyzeMigration в exactFiles() на каждом запуске, и LF-версии 0008–0013 отвергаются с «Unclassified or changed migration file», так что коммит 42f59f14 с CRLF-блобами обязателен для Docker-образов из Linux-чекаута; (4) в этих шести файлах нет непрозрачных тел и одиночных CR, SQL по смыслу одинаков в обоих вариантах; (5) существующая БД с маркерами и без контрольной истории контрольным путём не принимается (baseline(prefix=0): «Legacy or unmarked application state cannot be enrolled», есть тест controlled-migrations.sql.test.ts), это уже открытый пункт DB-3 про перенос непустой legacy-БД, к LF/CRLF отношения не имеет. Не запускалось: SQL-тесты на одноразовой PostgreSQL, проверена только логика и байты
  • Прогнать поиск секретов по всем новым файлам
  • Сверить число миграций: 57 sql-файлов 0000–0057, все совпадают с хешами migration-manifest.ts; «58» в документах — линия профилей Source58, не номер миграции
  • Коммит: контракты и миграции
  • Коммит: ядро backend/src/modules/mcp
  • Коммит: адаптеры по разделам
  • Коммит: веб-раздел /mcp
  • Коммит: тесты и скрипты
  • Коммит: CI и deploy
  • Коммит: документация

Этап 1. Локальная заморозка (FINAL-1)

  • npm run lint: 0 ошибок, 41 предупреждение. В eslint.config.mjs добавлены игнорирования локальных каталогов (tmp, tmp-*, .next-*, backend/dist-*, .serena, .claude/worktrees, .ci/docker); без них lint падал на недоступном каталоге в tmp/. Ошибки Codex в новых скриптах и тестах устранены, старые ошибки в components/reui, nav-user, theme-provider исправлены или подавлены eslint-disable с причиной (вендорный код ReUI не переписывался)
  • npm run build (корень и backend): обе сборки проходят, tsc --noEmit фронтенда и бэкенда чистый
  • test:mcp (корень и backend): корень 4 из 4, backend проходит после синхронизации заглушек scheduler-automatic-root.test.mjs с кодом (карантин восстановления, общий шлюз БД, проверка активации)
  • test:mcp:pg:all: все профили и монолит integration.test.ts проходят (147 проверок, в том числе verifyMcpDatabaseBackup с настоящим pg_dump из PostgreSQL 18, установленного через winget только как клиентские утилиты). Монолит после последней проверки висел: native-create-id-acceptance.ts ждал router.close() при открытых keep-alive соединениях; исправлено closeAllConnections(), точечная проверка --native-create-id завершается с кодом 0. Полный монолит после этой правки не гонялся (по решению владельца не перезапускать всё)
  • Playwright: playwright.mcp.config.ts 43 из 43, playwright.mcp-auth.config.ts 16 из 16 (на итоговом коде)
  • Сверка карты покрытия: coverage.test.ts проходит. 265 маршрутов (202 покрыты MCP, 63 исключены, 0 необработанных), 383 инструмента (цифра 368 в исходном плане была устаревшей)

Этап 2. Хвосты кода без стенда

  • VRF: поправка сборщика для afi=link — переносить некуда. sampleGreAfterAck и gre-liveness.mjs существуют только в замороженной нагрузке стенда tmp/owned-windows-vrf-*/payload, в git их нет. Поправка tmp/vrf-r2-gre-activation-review/sampler-projection.mjs (потолок 4 вместо 3 для /routing/route) применяется к этой нагрузке при повторе GRE на стенде, пункт перенесён в этап 3

  • VRF: разбор keepalive есть в исходниках: parseKeepalive в backend/src/services/gre-live.ts (10s,10 → 10 с и 10 повторов, 1m,3 → 60 и 3). Допуск бита I: исходное требование в документах не найдено, не проверено, нужно пояснение владельца

  • ROUTING: /ip/dhcp-client в сверке уже есть в backend (chrTopologyCataloguePaths через wireguardInterfaceDependencyPaths, обратный отсчёт expires-after игнорируется). Тесты traffic-flow-chr-topology-inventory.test.ts 9 из 9; без пути падают 2 (проверено временным удалением). Списки без /ip/dhcp-client лежат в незатрекенном tmp/ (REQUIRED_CATALOGUES в verify-manual-terminal.py, native-topology-conservation.mjs), это стендовые скрипты, обновить при повторе A → B → A на этапе 3

  • POLL: причина unknown из CI2713 — оформлена как неустановленная. Факты (mcp-remaining-work-20261026.md): в изолированном Linux-опросе выборка на 177,409 с дала 16 намерений публикации, 15 подтверждений и unknown/inconclusive без итоговой квитанции; на VPS последнее чтение вернуло running до истечения лимита наблюдения 180 с, квитанция не указывает этап. Локально тот же backend с синтетическим RouterOS завершается за ~32 с, 143 действия в 18 атомарных группах прошли на одноразовой PostgreSQL. Число полных чтений контекста на группу снижено с пяти до четырёх. Причина задержки на VPS и замер версии на VPS открыты, unknown не перекрашивается в успех; остаток уходит в этап 3 (POLL: 336 операций, deadline Linux)

  • Inspector 2.13.0 по прямому HTTP (Bearer) и OAuth (PKCE) принят на текущем коде (HEAD 85a5fdb9), оба прогона с кодом 0, хеши исходников до и после совпали. HTTP: каталог из одного инструмента mm_servers_list, вызов разрешённого сервера, отказ на запрещённом (SERVER_DENIED), старый и отозванный Bearer отклонены, новый принят. OAuth: обнаружение метаданных, обмен кода PKCE выполнил сам Inspector, один запрос авторизации использован один раз, обновление токена (оба токена ротированы), повтор старого refresh даёт 400 invalid_grant и отзыв семьи, новое согласие не запрашивалось. Результаты: tmp/mcp-inspector-http-oauth-20261116/{http,oauth}/result.json. Не покрыто: настоящий портал и интерфейс согласия в браузере (согласие синтетическое), обновление по 401 и естественное истечение, современная эра протокола по Bearer, RFC 7009 revoke от Inspector; Inspector взят из уже установленной копии с совпавшими хешами, не через npx; регистрация клиента заранее (dynamic registration не объявлена); отказ внеобластного инструмента проверен только фильтрацией tools/list

  • NetFlow: точный локальный адрес при wildcard-привязке — закрыто как ограничение Node. dgram отдаёт в message только (msg, rinfo) без адреса назначения, sock.address() после bind остаётся 0.0.0.0 (проверено на Node v25.5.0, Windows; Linux и IPv6 не проверялись, слушатель только udp4). Точный адрес даёт IP_PKTINFO, то есть нативный модуль или raw-сокет. Обходной путь (адрес интерфейса по маршруту к экспортёру) не равен адресу получения и ломается при policy routing и нескольких адресах, поэтому не внедрялся. Область шаблонов от адреса не зависит. Вернуть в работу, если потребуется точная идентичность

  • Корневые tmp-*-pending.patch и tmp-db-*-draft/, tmp-speed-principal-draft/ сверены с HEAD (только чтение). Применены: tmp-flow-drain-wiring-pending.patch, tmp-db-control-draft/ (правка COMMIT на database-schema-control.ts:118-119), tmp-speed-principal-draft/ (тест побайтно совпадает). Заменены более новым кодом, применять нельзя (откатит код): tmp-flow-engine-strict-pending.patch (HEAD содержит все его экспорты и больше), tmp-db-runner-draft/ (режим --profiles-only уже есть в расширенном виде), tmp-check-flow-engine-pending.cjs устарел. Единственное неприменённое: tmp-db-enrollment-draft/ (source-attestation.ts, тест, enrollment-host-contract.ts): в HEAD аналога нет, помечено «TMP review component only», productionApplied:false, потребителей нет; решение владельца, нужен ли он. Логи tmp-mcp-*-v1.log не источники. Файлы не удалялись

  • .claude/settings.local.json отслеживается Git ещё с ранних коммитов, .gitignore его скрывает, секретов нет — решение владельца: оставить как есть (с учёта не снимать)

Этап 3. Стендовые приёмки (CHR и VPS)

Цель владельца от 2026-11-17: довести все стендовые приёмки этапа 3 до конца без отдельных команд «продолжай». Работа идёт непрерывно (запуск, диагностика, очистка, исправление в новом слое, повтор); остановка и вопрос владельцу только при настоящем блокере: решение, меняющее критерий приёмки или поведение продукта; отсутствие доступа; разрушительный шаг без проверенной резервной копии; действия вне стенда (слияние и отправка в main).

Пункты ниже закрываются тремя прогонами вместо отдельных ожиданий. Каждый пункт пишет собственную квитанцию; failed и unknown не перекрашиваются, при падении объединённого прогона причина разбирается по квитанциям пунктов.

Прогон A. Два CHR (маршрутизация), один сквозной сценарий. Пункты: VRF отпечаток при активации GRE; VRF 56 записей и трафик при смене участников; ROUTING A → B → A после правки сверки (с /ip/dhcp-client в списках tmp/, включая поправку сборщика afi=link в нагрузке gre-liveness.mjs); WireGuard / IPsec / GRE с трафиком; NetFlow IPFIX с реального RouterOS (включить экспорт на CHR на время тех же окон трафика); нестабильные Edge (39 из 41) и маршрутизация (203 из 205) как повторы того же прогона.

Прогон B. Linux VPS (опрос), запускать первым, идёт в фоне. Пункты: POLL 336 операций с естественным истечением (окно от 252 минут) и POLL deadline Linux. Это один и тот же прогон.

Прогон C. VPS (внешний интерфейс и БД), одна сессия на целевом Linux. Пункты: EXTERNAL-UI восстановить SSH (блокер, делается первым), сквозной прогон на образах CI2736, приёмка подписанного защищённого восстановления; DB-3 перенос непустой legacy-базы; DB-4 POSIX-права целевой среды (проверяются на той же среде образов).

Ограничения: B и C нельзя запускать одновременно на одном VPS (лимит 2 ГиБ, RAM-1 отложен): развести по машинам или по времени. A независим от B и C. Порядок: восстановить SSH, затем B в фоне, A, затем C.

  • VRF: отпечаток стабильных полей при активации GRE (2026-11-16, прогон A1 с диагностикой v3, запуск owned-windows-vrf-bd75f63d787ba628adad9952: 5 кадров, стабильные хеши постоянны, чужие строки не менялись, очистка 14 из 14, сверка с базой совпала; детали и оговорки в mcp-stand-run-a-plan.md)
  • VRF: полный прогон на 56 записей и проверка трафика при смене участников (2026-11-19, слой v28 на продукте 1e96ddac, запуск owned-windows-vrf-f04308177d6b31c740159548: 56 из 56, 54 операции applied/passed, трафик baseline 3/3, изоляция 0/3 при GRE 3/3, восстановление 3/3, очистка и сверка снимков совпали; детали и изменения проверки раннера в mcp-stand-run-a-plan.md)
  • ROUTING: повтор A → B → A после правки сверки (2026-11-19, mmapp-test на 7848e38a, запуск runs/2026-11-19-32678993 раннера manual-v64-mmapp-test: траектория a → b → a на одном маршруте, 6 окон по 3/3, 2 одобрения в UI (D8: агент под тестовой учётной записью a3-agent), applied и recovered, сверка 66/66 на обоих CHR со строгим /ip/dhcp-client, очистка 28/0; условие прогона: рабочая установка, без печати V63; подключения отозваны, MCP выключен, учётная запись отключена; детали и два неуспешных запуска до него в mcp-stand-run-a-plan.md)
  • POLL: 336 операций с естественным истечением на Linux (окно от 252 минут) — 2026-11-20, B2 на сборке 29998815 (исправление утечки AsyncLocalStorage, из-за которой первый прогон на 0e63cdd5 упал на 169 операциях), nonce d3f72b64943a81a7, пакет tmp/mcp-poll-linux-capacity336-head-29998815-20261120/.
    • capacity336Accepted=true: 337 операций, 336 естественно сжатых аутентифицированных архивов, 1348 GET, 337 уникальных источников, 0 ошибок воркера.
    • 5 ч 40 мин при пределе 72 ч; задержка архива — медиана 18 с, максимум 56 с.
    • Очистка подтверждена, пакет снят, базовый снимок не изменился.
    • Квитанции worker-observation.json нет.
    • Новый ключ — capacity336LinuxAccepted20261120; прежний capacity336Profile не переписан.
  • POLL: deadline целевого Linux — 2026-11-20, повторно на 29998815 (12,1 с, deadlineAccepted=true, swap 7/5609 страниц записан отдельно), засчитан в тот же прогон B. Первый B1 был на сборке 0e63cdd5 (57 миграций, mmapp-test на mcp-0e63cdd5), пакет tmp/mcp-poll-linux-cold143-head-0e63cdd5-20261120/: холодный cold143 завершился за 10,9 с при пределе 180 с (CI2683: 158 с), 143/22/54/4/151, очистка подтверждена, базовый снимок не изменился. По D-B3 (а) владельца от 17.11 это срок и функциональность (deadlineAccepted=true); swap хоста 8/43 страниц записан отдельно (resourceAccepted=false, относится к отложенному RAM-1), строгий accepted=false не перекрашивается. Прежний ключ targetLinuxColdPollAccepted=false не переписан, новый — targetLinuxColdPollDeadline20261120. B1 засчитывается в общий прогон B, потому что снимок базы при запуске B2 (150b5ac3…) по содержимому совпал со снимком B1; при любом переразвёртывании до B2 B1 повторялся бы
  • EXTERNAL-UI: восстановить SSH к тестовому VPS (блокер) — 2026-11-19: ssh mm-vps (161.104.46.222) по ключу под root работает (BatchMode); шаг 1.1 планов B и C: отпечатки ключей хоста ED25519 CfLP9rN3…qs/o, ECDSA 7rFwtP6i…/yAk, RSA GzI/Ajrf…OFA совпали с ~/.ssh/known_hosts, ED25519 совпал с закреплённым tmp/test-server-known-hosts, его sha256 равен HOSTKEY_SHA пакетов POLL (c6ca709c…d2c9), ключ хоста не менялся
  • EXTERNAL-UI: сквозной прогон на образах текущей сборки (решение владельца 17.11 вместо CI2736) — 2026-11-20, 29998815 (Gitea 2745) + Portal CI2586, 57 миграций, пакет tmp/mcp-c1-owned-portal-browser-29998815-20261120/.
    • Edge через SSH-пробросы: вход в Portal, выдача токена в UI, подтверждение плана, applied/passed, ссылка на шаг, подписанный отзыв владельца, отказ 401 без деталей. Все признаки квитанции true (d3a1e862…).
    • Очистка подтверждена, mmapp-test поднят на тех же образах.
    • Исправлены дефекты пакета: внутренняя сеть без публикации портов и потеря журналов. Подробности в mcp-stand-run-c-plan.md, раздел 2.5.
  • EXTERNAL-UI: приёмка подписанного защищённого восстановления — 2026-11-21, nonce 4db568f58566878a, образ backend f923d083… (e69d5f0a, Gitea 2747), frontend 921ba5e2, PostgreSQL 18 с JIT по умолчанию, UID 65534. Edge: загрузка PGDMP, план, подтверждение, одно применение через MCP → applied, signedProtectedJournal, applied-consumed, rebind (эпоха 4), seal, complete, maintenance-resolve, две реплики с восстановленными данными и защищённой записью. Квитанция tmp/mcp-c2c4-restore58-29998815-20261120/acceptance-4db568f58566878a/acceptance-receipt.json; подробности в mcp-stand-run-c-plan.md, раздел 2.8.
    • 2026-11-21, диагностика на 29998815 (пакет tmp/mcp-c2c4-restore58-29998815-20261120/): операторская цепочка на Linux от init до двух реплик backend пройдена при двух отступлениях — JIT PostgreSQL выключен, восстановление через REST вместо MCP.
    • Ждёт решения владельца по двум находкам: JIT против лимита 5 с захвата каталога; MCP-восстановление под карантином на свежем журнале всегда blocked. Подробности в mcp-stand-run-c-plan.md, раздел 2.7.
    • 2026-11-21: обе исправлены в продукте по решению владельца (11537c99, образ backend Gitea 2746 fed349a6…); после complete по MCP добавлен штатный maintenance-resolve; его отказ на базе source58 исправлен в e69d5f0a.
  • DB-3: перенос непустой legacy-базы — закрыто как ограничение (решение владельца 2026-11-17): контрольный путь не принимает старые установки, обновление идёт legacy-путём (проверено на mmapp-test, 12 → 57 миграций, данные целы). Продуктовый путь не разрабатывается; см. раздел «Решения владельца 2026-11-17 по прогонам B и C»
  • DB-4: настоящие POSIX-права целевой среды — 2026-11-21, образ f923d083… (e69d5f0a), PostgreSQL 18 с JIT по умолчанию, UID 65534.
    • POSIX (приёмочный прогон 4db568f58566878a): ключи init 0700/0600; 0640, 0604, каталог чужого UID, символьная ссылка и init в существующий каталог отклонены, 0 подключений к PostgreSQL в каждом случае.
    • Остальные проверки критерия C4 (прогон 30fb9d4ac7d56117):
      • архив с mmapp_control: без пина — 503 DATABASE_RESTORE_DATA_REFUSED до журнала и допуска; с пином — 400 «Архив содержит служебное пространство управления базой…», таблица не заменена;
      • сбой посреди восстановления: журнал intent → unconfirmed, старт UNCONFIRMED_MAINTENANCE, новый backend отказывает без единого подключения к PostgreSQL, то есть потребители не стартуют;
      • доступ из архива (повтор bff61f8d715cf6bf): токен MCP, выданный до архива, до восстановления принимается (200). После восстановления и complete — 401 UNAUTHORIZED, хотя строка подключения вернулась активной и с неистёкшими сроками: generationValid: false, хеш access-generation сменился.
      • права файлов: 48 операторских и backend-файлов и каталогов — 0600/0700, владелец UID 65534.
    • Квитанции tmp/mcp-c2c4-restore58-29998815-20261120/db4-30fb9d4ac7d56117/db4-receipt.json и …/access-bff61f8d715cf6bf/access-receipt.json; подробности в mcp-stand-run-c-plan.md, раздел 2.9.
    • 2026-11-21, диагностика C4 на 29998815: 0640, 0604, каталог чужого UID, символьная ссылка и init в существующий каталог отклонены до подключения к БД (0 подключений по журналу PostgreSQL), точные причины записаны. Засчитывается вместе с приёмочным прогоном C2 (mcp-stand-run-c-plan.md, раздел 2.7).
  • 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 с базой
  • 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
  • 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-фикстура. Найдены и исправлены три дефекта продукта:
      • счётчики /interface в доказательстве инициализации — исправлено в 28738785, mmapp-test переведён на этот backend;
      • несовместимость с 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-фикстура) и замечания: fast path после IPsec не возвращается (причина и способ возврата не установлены). Остаток profile и proposal после server_remove исправлен в d02a019b по решению владельца; на этом образе ещё 5 из 5 прогонов подряд без остатка.
  • Нестабильные сценарии 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
  • Нестабильные сценарии маршрутизации (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…) проходят

Этап 4. Заблокировано или отложено

  • PATHS: нет третьего независимого узла — получить узел или записать как ограничение
  • RAM-1 (лимит 2 ГиБ): отложен владельцем — вернуть в работу или записать как ограничение
  • autoRecovery: нет источника событий RouterOS с обнаружением пропусков — оставить выключенным, записать решение
  • ROUTING: RT-3, выдача одноразового допуска автоматическому возврату — реализовать нельзя без решения владельца. Единственная формулировка: пункт открыт (mcp-evidence-statistics-20261101.md, стр. 57). Код отказывает намеренно: recordForwardOutcome в routing-reservation-store.ts не возвращает RoutingReservedInverseAllocation, при failed бросает «Authenticated network evidence for automatic recovery unavailable». Автовозврат зависит от RT-1 (полный источник событий с обнаружением пропусков), REST /log его не заменяет; отказ принят и покрыт --routing-reservations (20 сценариев). Перенесено в этап 4 к autoRecovery по решению владельца; вернуть в работу после RT-1

Этап 5. Закрытие (FINAL-2 и FINAL-3)

  • Манифест: критерий плана → доказательство → статус, без перекраски failed и unknown — 2026-11-21, mcp-final-manifest.md: исходные критерии реестра по направлениям POLL, DB, ROUTING, NATIVE, PATHS, EXTERNAL-UI, FINAL с доказательствами и статусами; отдельно история отказов (13 строк) и критерии вне плана завершения со статусом «не проверено». Решения по открытым строкам — за владельцем

  • Инструкция по включению: наблюдение → подтверждения → ограниченная автономность — 2026-11-21, mcp-enable-guide.md: права портала, MCP_PUBLIC_URL и MCP_STATE_DIR, три шага с переходами и возвратом, срок прав владельца (до 24 часов), часовой бюджет в объектах, срок плана 5 и 15 минут, защиты, временный допуск, Route AI без автоматического восстановления, пауза, отзыв и аварийная остановка, частые отказы. Надписи сверены с components/mcp/*.tsx, числа и коды — с backend и контрактами. В документах стенда есть доказательства только для режима «С подтверждением»; «Наблюдатель» и «Автономный» покрыты policy.test.ts. По интерфейсу инструкцию целиком не проходили

  • Проверить, что MCP и контроллер выключены по умолчанию — 2026-11-21: mcp_settings.enabled и mcp_routing_profiles.enabled по умолчанию false (0015_mcp.sql), autoRecovery по умолчанию false (контракт), выключенный MCP отказывает токену MCP_DISABLED/503 (store.ts), воркер не вызывает контроллер при выключенном MCP (workers.ts). Проверки на свежей базе добавлены в integration.test.ts (первичный шард test-mcp-postgres-sharded.mjs)

  • Сократить docs/mcp.md (417 КБ) до пользовательской документации — 2026-11-21: прежний файл перенесён без изменений текста в mcp-implementation-history.md с пометкой «исторический»; новый mcp.md (19 КБ): настройка сервера, подключение клиента (HTTP, stdio, OAuth), путь изменения, возможности по областям, Route AI, webhook отзыва порталом, восстановление базы, ограничения, проверки. Каждое утверждение написано по коду или манифесту, старый текст служил только списком тем: в нём были устаревшие места (автовосстановление «включается человеком», восстановление ревизий WireGuard и IPsec «pending», отправка отзыва из портала «не принята»). Режимы, лимиты и коды отказов не повторяются — ссылка на mcp-enable-guide.md. Входящие ссылки обновлены (README, план реализации, аудит трафика), хеши documentHashes в JSON-доказательствах оставлены как исторические

  • PR в main Продуктовые задачи из анализа таймингов (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.

Журнал

Дата Что сделано
2026-11-15 План составлен, код не менялся
2026-11-15 Этап 0: 7 коммитов на ветке (bd4ce590…42f59f14), дерево чисто, typecheck фронтенда и бэкенда проходит, ничего не отправлено в remote. Исправлены CRLF-байты миграций 0008–0013 (в блобах были LF, манифест закреплён за CRLF). Секреты в 2478 новых и изменённых файлах не найдены. Промежуточные коммиты по отдельности не собираются. Не сделано: копия tmp/, реорганизация docs/
2026-11-15 Проверка DB-3 по LF/CRLF миграций 0008–0013 завершена, код не менялся (вывод в этапе 2)
2026-11-15 Копия tmp/ на C: готова и сверена. Реорганизация docs/ изучена и остановлена (переносимо 31%). Коммит 3c78c55c: CRLF-байты 28 закреплённых квитанций
2026-11-16 Этап 1: test:mcp:pg:all починен по устаревшим фикстурам (коммиты 07aaa40b…77e52f15, добавлены test:changed и режим MCP_INTEGRATION_CONTINUE=1). Единственный остаток: нет pg_dump для verifyMcpDatabaseBackup. Playwright зелёный
2026-11-16 Этап 1: pg:all закрыт (установлены pg_dump/pg_restore, исправлено зависание завершения в native-create-id-acceptance.ts). Открыты два пункта про нестабильные сценарии: стендовые, нужно решение владельца
2026-11-16 Этап 1 закрыт. Два пункта про нестабильные сценарии Edge и маршрутизации перенесены в этап 3 (стендовые)
2026-11-16 Этап 2: NetFlow wildcard закрыт как ограничение Node; /ip/dhcp-client уже в backend; поправка VRF afi=link относится к стендовой нагрузке в tmp/; RT-3 ждёт решения владельца
2026-11-16 RT-3 перенесён в этап 4 к autoRecovery
2026-11-16 Этап 3: пункты сгруппированы в три прогона (A: два CHR, B: опрос Linux, C: внешний интерфейс и БД)
2026-11-16 Этап 2: Inspector HTTP и OAuth приняты на HEAD 85a5fdb9 (с оговорками о покрытии). В этапе 2 открытых пунктов нет
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
2026-11-17 Владелец поставил цель: довести все стендовые приёмки этапа 3 до конца без отдельных команд
2026-11-20 Владелец утвердил правило прав опроса 2.9 и разбор очереди 2.10. mmapp-test переразвёрнут на 0e63cdd5 (запуск Gitea 2743, резервная копия БД перед заменой). B1 (POLL deadline Linux) пройден по D-B3: 10,9 с из 180 с
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 docs/mcp.md переписан как пользовательская документация (19 КБ); прежний текст — mcp-implementation-history.md
2026-11-21 Инструкция по включению MCP: mcp-enable-guide.md
2026-11-21 server_remove убирает свои profile и proposal (d02a019b, версия операции 3); mmapp-test на mcp-d02a019b, 5 из 5 прогонов IPsec подряд без остатка
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

  • DB-3 (перенос непустой legacy-базы): записать как ограничение, пункт переходит в этап 4. Контрольный мигратор не принимает установки без маркеров контрольной истории (отказ на префиксе 0, принято ранее); обновление старых установок идёт прежним legacy-путём (подтверждено на mmapp-test: 12 → 57 миграций, данные целы, схема mmapp_control пуста). Разработка продуктового пути (шаг N → 36 под drain и attestation и точка входа для хвоста 0038–0057) не выполняется.
  • «Deadline целевого Linux» (холодный опрос 180 с): критерий разделяется на deadlineAccepted (укладывается ли опрос в 180 с и работает ли функционально) и resourceAccepted (подкачка памяти и лимит памяти хоста; относится к отложенному RAM-1). Подкачка фиксируется, но пункт не валит.
  • EXTERNAL-UI, образы: пакет CI2736 пересвязывается с образами текущего HEAD (CI2738, 57 миграций), старые дайджесты не тянутся; формулировка критерия меняется с «на образах CI2736» на «на образах текущей сборки».
  • Решения оркестратора по цели (не меняют критериев, детали в планах B и C): сборка B из HEAD 5ec95a7c, вход по ключу; одноразовые подтверждения и nonce выдаёт агент по цели владельца, фиксируется нейтрально; при отказе до 336 операций автоповтора нет (разбор, исправление новым слоем, новый nonce); mmapp-test останавливается на окна C вне B и A (ROUTING); дамп восстанавливается только в изолированный внутренний PostgreSQL на VPS без запуска backend и планировщика, с VPS не копируется.

Отложено: находки аудита вне MCP (2026-11-17, ponytail-audit, по просьбе владельца пока не берём в работу)

  1. Пароли роутеров хранятся открытым текстом (servers.password) и отдаются в ответах API (servers-mapper.ts:8,39); шифрование MCP (AES-256-GCM) есть, но не применено к роутерам.
  2. Контейнер backend работает от root (в backend/Dockerfile нет USER).
  3. Секрет-заглушка dev-secret-change-me из backend/.env.example проходит проверку длины (config.ts:56).
  4. Неизвестный маршрут /api/* получает mm:dashboard:read для любого метода (permissions.ts, конец permissionForRequest); теста «у каждого маршрута есть правило» нет.
  5. verify_ssl по умолчанию false (schema.ts:64), сертификат роутера не проверяется.
  6. AUTH_REQUIRED по умолчанию false (config.ts:20); прод-композиции ставят true.
  7. Базовый образ node:22-bookworm-slim не закреплён по дайджесту.
  8. Ответы 4xx отдают исходный error.message (index.ts:103-106). Проверено без замечаний: OAuth и токены MCP, список разрешённых команд exec, отсутствие подстановки значений в SQL, обязательные переменные в прод-композициях.