16 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изtmp/vrf-r2-gre-activation-review/sampler-projection.mjs, добавить тест -
VRF: проверить, что разбор keepalive
10sи допуск битаIесть в исходниках, а не только вtmp -
ROUTING: добавить
/ip/dhcp-clientв сверку (причина отказа V63) -
ROUTING: выдача одноразового допуска автоматическому возврату (RT-3)
-
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 (стендовые) |