Files
MikrotikManager/docs/mcp-completion-plan.md
T

18 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

  • 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

  • POLL: установить причину unknown из CI2713 или оформить как неустановленную

  • Inspector: прямой HTTP и OAuth (принят только stdio)

  • 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/: сверить с исходниками. tmp-flow-drain-wiring-pending.patch уже применён; tmp-flow-engine-strict-pending.patch не проверен (формат *** Begin Patch, не unified diff)

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

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

  • 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 / IPsec / GRE: жизненный цикл с трафиком
  • Нестабильные сценарии 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 с обнаружением пропусков — оставить выключенным, записать решение

Этап 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 ждёт решения владельца