Files
MikrotikManager/docs/mcp-final-manifest.md
T

20 KiB
Raw Blame History

MCP: итоговый манифест (критерий → доказательство → статус)

Составлен 21 ноября 2026 для этапа 5 плана завершения. Ветка codex/mcp-foundation, исправления продукта до d02a019b включительно. Правило: статусы failed и unknown не перекрашиваются. Если пункт позже принят повтором, исторический отказ остаётся отдельной строкой в разделе «История отказов».

Статусы:

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

Источник исходных критериев — именованный реестр от 1–3 ноября, разделы POLL, DB, ROUTING, NATIVE, PATHS, EXTERNAL-UI и FINAL. Пункты плана завершения ссылаются на планы прогонов A, B, C и на mcp-current-progress.json. Пути tmp/… — локальные пакеты доказательств вне Git; копия tmp/ от 15 ноября описана в этапе 0 плана.

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

Условие Доказательство Статус
Этапы 0–2 выполнены mcp-completion-plan.md, этапы 0–2: все пункты [x] принято
Этап 3 (стенд) там же, этап 3: все пункты [x], журнал 2026-11-21 принято (отдельные пункты см. ниже)
Этап 4 оформлен как явные решения там же, этап 4: 4 пункта [ ] открыто: решения владельца
MCP и контроллер выключены по умолчанию миграция 0015_mcp.sql (mcp_settings.enabled DEFAULT false, mcp_routing_profiles.enabled DEFAULT false); routeAiProfileSchema.autoRecovery по умолчанию false; authenticateMcpToken отказывает MCP_DISABLED/503 при выключенном MCP (store.ts); воркер не вызывает контроллер при выключенном MCP (workers.ts); проверки добавлены в integration.test.ts на свежей базе принято
Этап 5 и слияние в main этап 5 плана открыто

POLL

Исходный критерий Доказательство Статус
Target Linux cold deadline B1 0e63cdd5: cold143 за 10,9 с при пределе 180 с; повтор на 29998815: 12,1 с; deadlineAccepted=true; ключ targetLinuxColdPollDeadline20261120 принято по сроку и функциональности (D-B3 а); строгий accepted=false сохранён: swap хоста 8/43 и 7/5609 страниц, resourceAccepted=false относится к отложенному RAM-1
Capacity336 and next admission B2 29998815, nonce d3f72b64943a81a7: 337 операций, 336 естественно сжатых аутентифицированных архивов, 1348 GET, 0 ошибок воркера, 5 ч 40 мин; ключ capacity336LinuxAccepted20261120 принято; два прежних отказа — в истории
Remaining crash/unknown transitions Причина unknown CI2713 оформлена как неустановленная (этап 2) unknown сохранён; остальные переходы не проверялись (план B, раздел 7)
Retention and admission policy boundaries fourteenDaysElapsedAccepted=false (14 суток календарного удержания не выдерживались) не проверено
Concurrent collectors and latency budget — не проверено (план B, раздел 7)

DB

Исходный критерий Доказательство Статус
DB-1: допуск действительного поколения источника на целевой установке Приёмка C2 4db568f58566878a: проверка каталога источника, rebind source58 (эпоха 4), seal, complete на целевом Linux принято в составе C2, отдельной квитанции DB-1 нет
DB-2: допуск писателей и реплик под итоговой политикой C2: две реплики backend с восстановленными данными и защищённой записью PUT /api/logs/settings принято в составе C2, отдельной квитанции DB-2 нет
DB-3: перенос непустой legacy-базы Решение владельца 2026-11-17: контрольный путь старые установки не принимает, обновление идёт legacy-путём (mmapp-test 12 → 57 миграций, данные целы) ограничение
DB-4: POSIX-права целевой среды 4db568f58566878a (ключи init 0700/0600, пять отказов до подключения к БД); 30fb9d4ac7d56117 (архив с mmapp_control отклонён, сбой посреди восстановления не запускает потребителей); bff61f8d715cf6bf (доступ из архива не возвращается, 48 файлов и каталогов 0600/0700) принято
Защищённое восстановление через Edge и MCP C2 4db568f58566878a; продуктовые исправления 11537c99 (JIT, первое MCP-восстановление), e69d5f0a (maintenance-inspect) принято

ROUTING

Исходный критерий Доказательство Статус
A → B → A после правки сверки (пункт плана) runs/2026-11-19-32678993 раннера manual-v64-mmapp-test: один route ID, 6 окон 3/3, 2 одобрения в UI (D8), applied и recovered, сверка 66/66 со строгим /ip/dhcp-client принято; два прежних запуска — в истории
RT-1: подлинная сетевая контрольная точка (источник событий с обнаружением пропусков) — открыто: этап 4, autoRecovery выключен
RT-2: положительный обратный шаг в том же резервном слоте Ближайшее доказательство — возврат operations.recover → recovered на том же route ID в A3; резервирование именно RT-2 отдельной квитанцией не подтверждено не проверено
RT-3: одноразовый допуск автоматическому возврату Код отказывает намеренно, покрыто --routing-reservations (20 сценариев) открыто: этап 4, решение владельца
RT-4: исходные полномочия восстановления и независимый канал Локально: integration.test.ts (независимый канал отклоняет алиасы основного адреса и другое устройство) не проверено на стенде
RT-5: не-main/VRF и совместимость A3 шёл в таблице VRF (окна трафика в VRF, GRE внутри VRF) принято частично: вариант A3; прочие сочетания не проверялись
Нестабильный набор маршрутизации (A7, 203 из 205) Набор из 205 тестов восстановлен, 5 запусков подряд по 205/205 (D11); на итоговом коде ещё раз 205/205 принято; исторический результат 203/205 — в истории

NATIVE

Реестр от 3 ноября: восемь пакетов, три приняты до плана завершения (1, 5, 6), пять открыты.

Пакет Доказательство Статус
1, 5, 6 Реестр mcp-evidence-statistics-20261101.md принято до плана завершения
2. VRF production forwarding A1 owned-windows-vrf-bd75f63d… (отпечаток при активации GRE); A2 v28 owned-windows-vrf-f04308177d6b31c740159548 (56 из 56, трафик baseline 3/3, изоляция 0/3, восстановление 3/3, сверка совпала) принято; нестабильность VRF поверх активного GRE (2 из 4 попыток partial) — продуктовая задача этапа 5
3. WireGuard: общий жизненный цикл и трафик A2 v28: интерфейсы и пиры на обоих CHR, ACK и ID, 36/36 пингов через GRE поверх WireGuard, удаление и сверка 66/66; счётчики байтов не записаны принято (трафик доказан ответами ping); задержка записи 80–136 с — продуктовая задача этапа 5
4. IPsec/GRE: ссылки, каскады, SA, трафик GRE: A2 v28. IPsec: 5 из 5 подряд на a7d85fd0 и 5 из 5 на d02a019b (раннер tmp/mcp-stand-ipsec-20261121/), installed-sa с ростом current-bytes, ping 10/10, сверка 66/66; клиент CHR2 — REST-фикстура (решение владельца) принято; не проверены на стенде клиенты с сертификатами, экспорт сертификатов, REST-путь ipsec-ca.ts, откат ревизии IPsec
7. NetFlow/IPFIX A5: захваты CHR1/CHR2 и окно 10 ping разобраны traffic-flow-parse.ts, ровно два ICMP-потока по 10 пакетов и 560 байт принято; точный локальный адрес при wildcard-привязке — ограничение Node (этап 2)
8. Recursive acquisition identity semantics — не проверено (вне плана завершения)

PATHS

Исходный критерий Доказательство Статус
Независимый третий узел; двусторонний трафик и переключение; ECMP/NAT/FastTrack/RPF/route leaking/community; частичные записи, потеря ACK, дрейф — открыто: этап 4 (нет третьего узла)

EXTERNAL-UI

Исходный критерий Доказательство Статус
EXT-1: подписанный отзыв в настоящих Manager и Portal C1 на 29998815 (Gitea 2745) + Portal CI2586: вход, выдача токена в UI, подтверждение плана, applied/passed, подписанный отзыв, 401 без деталей принято
EXT-2: внешний MCP SDK (HTTP, stdio, OAuth PKCE) mcp-external-clients-completion-20261103.json принято до плана завершения
UI-1: веб-раздел MCP целиком C1 покрывает один поток подтверждения и отзыв; выдача ограниченного доступа, отказы, фильтры и пагинация на стенде не проверялись (план C, раздел 7) принято частично
UI-2: браузерные сценарии артефактов и восстановления C2: загрузка PGDMP, план с точным хешем, одно применение через MCP. Прочие сценарии UI-2 (размер и SHA файла перед сохранением, исчезновение артефакта, пагинация каталога) прошли локально, но в реестре от 3 ноября UI-2 оставался открытым, и на стенде они не повторялись принято частично
RAM-1: вся установка ≤ 2 ГиБ — отложено владельцем (этап 4)
Нестабильные сценарии Edge (A6, 39 из 41) 5 запусков подряд, в каждом 43 из 43 (D11) принято; причина исторических отказов не установлена

FINAL

Исходный критерий Доказательство Статус
Итоговый снимок исходников и регрессия Полный этап 1, 2026-11-21. На d586f870: npm run lint 0 ошибок (45 предупреждений), сборки корня и backend, tsc --noEmit, test:mcp корня 4 из 4 и Playwright 43 из 43, Playwright авторизации 16 из 16. test:mcp backend и test:mcp:pg:all упали на заглушках тестов (см. историю отказов); после daec2b47 повтор: test:mcp backend код 0, test:mcp:pg:all 38 профилей, «Regression failed profiles: none». Ранее на d02a019b: шардированный 6 из 6, --module-completion, A7 205/205 принято
Контракты, безопасность, покрытие, судьба нерешённой истории coverage.test.ts (этап 1); этот манифест принято частично: манифест составлен, решение по открытым строкам — за владельцем
Инструкции по эксплуатации и безопасное включение Проверка «выключено по умолчанию» (выше); mcp-enable-guide.md — три шага включения, остановка и отзыв, частые отказы принято частично: в документах стенда есть доказательства только для режима «С подтверждением»; «Наблюдатель» и «Автономный» — тестами политики; инструкция сверена с кодом, по интерфейсу целиком не пройдена. Пользовательская документация — mcp.md

История отказов (не перекрашивается)

Что Результат Чем закрыто
POLL capacity336 V5 (исторический) failed: 106 операций, 99/336 архивов, 1 ошибка воркера B2 на 29998815
POLL B2 на 0e63cdd5 failed на 169 операциях и 163 архивах (утечка AsyncLocalStorage на каждый опрос) исправлено в 29998815, повтор принят
POLL targetLinuxColdPollAccepted false (ресурс, swap) не переписан; срок принят отдельным ключом
POLL CI2713 unknown, причина не установлена не закрыто
ROUTING A3, запуск 1 runs/2026-11-19-5b3e5daa failed: ошибка SQL самого раннера исправлено в раннере, запуск 3 принят
ROUTING A3, запуск 2 runs/2026-11-19-0aa654b5 unknown/inconclusive/MEASUREMENT_UNKNOWN: CHR2 перезагрузился сам («critical program crashed») запуск 3 принят; сбой RouterOS не устранён
VRF поверх активного GRE 2 из 4 попыток partial/VERIFICATION_FAILED продуктовая задача этапа 5
C2: попытки до приёмки две попытки сорвал харнесс (сохранены как dry run) приёмка 4db568f58566878a
DB-4, попытка d72555218098d2a1 failed: защищённый backend без пина схемы не стартует добавлена фаза schema-pin, повтор принят
IPsec runs/2026-11-21-3dcfd8ae failed: RouterOS 7.24.5 отклонил comment у сертификата e7eb108c
IPsec c5e590e4, 3e77307b rejected/DEVICE_UNAVAILABLE: применение не ждало глобальную блокировку при опросе сборщиков a7d85fd0, затем 5 из 5
IPsec до d02a019b server_remove оставлял profile и proposal (остаток удалял раннер) d02a019b, затем 5 из 5 без остатка
Этап 1 на d586f870 failed: test:mcp backend и профили test:auth, test:system-database, test:mcp:shared-context в test:mcp:pg:all — тесты грузят исходники с явным списком зависимостей и не знали node:timers/promises и экспорт в runtime.ts (после a7d85fd0) и модуль authorization-stage (после 65846441 от 19.11) daec2b47: тестам переданы настоящие модули, повтор принят
Edge 39 из 41, маршрутизация 203 из 205 исторические отказы, причины не установлены повторы по D11

Состояние стенда и открытые решения владельца

  • mmapp-test: backend mcp-d02a019b, frontend mcp-29998815; MCP выключен, подключения отозваны, тестовая учётная запись a3-agent отключена.
  • Оба CHR: после IPsec ipv4/ipv6-fast-path-active=false при неизменной конфигурации; причина и способ возврата не установлены.
  • VPS: 16 резервных копий /root/backups/*pre-*, 9 тегов mmapp-test/backend, каталоги /root/c2c4-29998815 и /var/tmp/restore58-* — чистка по решению владельца.
  • Публичный маршрут MCP: поставляемые deploy/docker-compose*.yml не передают backend /mcp, /oauth/* и /.well-known/* (frontend проксирует только /api и /health, /mcp — страница интерфейса). Стенд подключался к backend через туннель, публичный путь не проверялся. Решить: добавить маршрут на отдельный хост в deploy или оставить ручной настройкой (описано в mcp.md)
  • Этап 4: PATHS, RAM-1, autoRecovery, RT-3. Этап 5: PR в main, три продуктовые задачи.