Прежний 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]>
56 KiB
MCP: план завершения работ (ветка codex/mcp-foundation)
Составлен 15 ноября 2026. Отмечать выполненное: - [x]. Источники остатка: передача от 15 ноября, именованный реестр, полный план MCP.
Исходное состояние
- В ветке нет коммитов поверх
main(HEAD5efd0339). Вся работа в рабочем дереве: 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: 2048tmp-*в корне, 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.ts43 из 43,playwright.mcp-auth.config.ts16 из 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.ts9 из 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 даёт 400invalid_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 операциях), nonced3f72b64943a81a7, пакет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: отпечатки ключей хоста ED25519CfLP9rN3…qs/o, ECDSA7rFwtP6i…/yAk, RSAGzI/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.
- Edge через SSH-пробросы: вход в Portal, выдача токена в UI, подтверждение плана,
- EXTERNAL-UI: приёмка подписанного защищённого восстановления — 2026-11-21, nonce
4db568f58566878a, образ backendf923d083…(e69d5f0a, Gitea 2747), frontend921ba5e2, 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 2746fed349a6…); послеcompleteпо MCP добавлен штатныйmaintenance-resolve; его отказ на базе source58 исправлен вe69d5f0a.
- 2026-11-21, диагностика на
- 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): ключиinit0700/0600; 0640, 0604, каталог чужого UID, символьная ссылка иinitв существующий каталог отклонены, 0 подключений к PostgreSQL в каждом случае. - Остальные проверки критерия C4 (прогон
30fb9d4ac7d56117):- архив с
mmapp_control: без пина — 503DATABASE_RESTORE_DATA_REFUSEDдо журнала и допуска; с пином — 400 «Архив содержит служебное пространство управления базой…», таблица не заменена; - сбой посреди восстановления: журнал
intent→unconfirmed, стартUNCONFIRMED_MAINTENANCE, новый backend отказывает без единого подключения к PostgreSQL, то есть потребители не стартуют; - доступ из архива (повтор
bff61f8d715cf6bf): токен MCP, выданный до архива, до восстановления принимается (200). После восстановления иcomplete— 401UNAUTHORIZED, хотя строка подключения вернулась активной и с неистёкшими сроками: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).
- POSIX (приёмочный прогон
- 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(backendmcp-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, поля после подписи,addresspeer, ID файлов**…) — исправлено вe7eb108cпо решению владельца; генеральная репетиция на CHR прошла (туннель, ping 10/10, рост SA, 66/66); - применение не ждало глобальную блокировку конфигурации и при опросе сборщиков получало
rejected/DEVICE_UNAVAILABLE(2 из 24 применений наe7eb108c) — исправлено вa7d85fd0,mmapp-testработает на backendmcp-a7d85fd0.
- счётчики
- Подробности в
mcp-stand-run-a-plan.md, раздел «IPsec через MCP»; там же условия прогона (клиент CHR2 — REST-фикстура) и замечания: fast path после IPsec не возвращается (причина и способ возврата не установлены). Остаток profile и proposal послеserver_removeисправлен вd02a019bпо решению владельца; на этом образе ещё 5 из 5 прогонов подряд без остатка.
- 2026-11-21: сценарий написан и отрепетирован (
- Нестабильные сценарии Edge (39 из 41 без повтора) — 2026-11-21, по решению D11 (5 повторов подряд):
npm run test:mcpиз корня (Node 25.5.0, Playwrightplaywright.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, по просьбе владельца пока не берём в работу)
- Пароли роутеров хранятся открытым текстом (
servers.password) и отдаются в ответах API (servers-mapper.ts:8,39); шифрование MCP (AES-256-GCM) есть, но не применено к роутерам. - Контейнер backend работает от root (в
backend/DockerfileнетUSER). - Секрет-заглушка
dev-secret-change-meизbackend/.env.exampleпроходит проверку длины (config.ts:56). - Неизвестный маршрут
/api/*получаетmm:dashboard:readдля любого метода (permissions.ts, конецpermissionForRequest); теста «у каждого маршрута есть правило» нет. verify_sslпо умолчаниюfalse(schema.ts:64), сертификат роутера не проверяется.AUTH_REQUIREDпо умолчаниюfalse(config.ts:20); прод-композиции ставятtrue.- Базовый образ
node:22-bookworm-slimне закреплён по дайджесту. - Ответы 4xx отдают исходный
error.message(index.ts:103-106). Проверено без замечаний: OAuth и токены MCP, список разрешённых командexec, отсутствие подстановки значений в SQL, обязательные переменные в прод-композициях.