25 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)
Пункты ниже закрываются тремя прогонами вместо отдельных ожиданий. Каждый пункт пишет собственную квитанцию; 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
- VRF: полный прогон на 56 записей и проверка трафика при смене участников
- ROUTING: повтор A → B → A после правки сверки
- POLL: 336 операций с естественным истечением на Linux (окно от 252 минут)
- POLL: deadline целевого Linux
- EXTERNAL-UI: восстановить SSH к тестовому VPS (блокер)
- EXTERNAL-UI: сквозной прогон на образах CI2736
- EXTERNAL-UI: приёмка подписанного защищённого восстановления
- DB-3: перенос непустой legacy-базы
- DB-4: настоящие POSIX-права целевой среды
- NetFlow: захват IPFIX с реального RouterOS
- WireGuard / GRE: жизненный цикл с трафиком (прогон A; IPsec вынесен отдельным пунктом по решению D9)
- IPsec: новый MCP-сценарий
mm_ipsec_*с подтверждением, трафиком и SA на стенде CHR (единственный прежний сценарийtmp/ipsec-network82.mjsоктябрьский и идёт через REST приложения, не MCP) - Нестабильные сценарии Edge (39 из 41 без повтора): исторический прогон управления в Edge из
mcp-remaining-work-20261026.md, оба отказавших прошли при целевом повторе. Локально не воспроизводится, нужен стенд; перенесено в этап 3 по решению владельца - Нестабильные сценарии маршрутизации (203 из 205 без повтора): исторический локальный прогон сверки, оба случая прошли при целевом повторе. Профили маршрутизации в
--profiles-onlyпрошли (36 из 38, ipsec и system-database исправлены). Перенесено в этап 3 по решению владельца
Этап 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 - Инструкция по включению: наблюдение → подтверждения → ограниченная автономность
- Проверить, что MCP и контроллер выключены по умолчанию
- Сократить
docs/mcp.md(417 КБ) до пользовательской документации - PR в
main
Журнал
| Дата | Что сделано |
|---|---|
| 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) |