# MCP: план завершения работ (ветка `codex/mcp-foundation`) Составлен 15 ноября 2026. Отмечать выполненное: `- [x]`. Источники остатка: [передача от 15 ноября](mcp-handoff-20261115.md), [именованный реестр](mcp-evidence-statistics-20261101.md), [полный план MCP](mcp-implementation-plan.md). ## Исходное состояние - В ветке нет коммитов поверх `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. Зафиксировать работу - [x] Сделать копию `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` лишняя, удалить можно с согласия владельца - [x] Дополнить `.gitignore`: `tmp-*`, `backend/dist-installation-memory*`, `.next-poll-*`, `.serena` - [x] Снять с отслеживания `tsconfig.tsbuildinfo` - [x] Реорганизовать квитанции в `docs/` — **решение владельца: оставить как есть.** Изучено, не выполнено. Безопасно переносимы 238 из 773 JSON (31%): 52 читает или пишет код и тесты (в том числе по шаблонным именам), 6 нужны раннерам в `tmp/`, 467 упомянуты по имени внутри других JSON (закреплённые пути), 6 связаны с закреплёнными md. Нужны решение владельца и переписывание закреплений. Сейчас всё закоммичено как есть, ссылки не сломаны - [x] 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, проверена только логика и байты - [x] Прогнать поиск секретов по всем новым файлам - [x] Сверить число миграций: 57 sql-файлов `0000`–`0057`, все совпадают с хешами `migration-manifest.ts`; «58» в документах — линия профилей Source58, не номер миграции - [x] Коммит: контракты и миграции - [x] Коммит: ядро `backend/src/modules/mcp` - [x] Коммит: адаптеры по разделам - [x] Коммит: веб-раздел `/mcp` - [x] Коммит: тесты и скрипты - [x] Коммит: CI и deploy - [x] Коммит: документация ## Этап 1. Локальная заморозка (FINAL-1) - [ ] `npm run lint` - [ ] `npm run build` (корень и backend) - [ ] `test:mcp` (корень и backend) - [ ] `test:mcp:pg:all` - [ ] Playwright: `playwright.mcp.config.ts`, `playwright.mcp-auth.config.ts` - [ ] Сверка карты покрытия: 265 маршрутов, 368 инструментов - [ ] Починить нестабильные сценарии Edge (39 из 41 без повтора) - [ ] Починить нестабильные сценарии маршрутизации (203 из 205 без повтора) ## Этап 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-привязке - [ ] Корневые `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: жизненный цикл с трафиком ## Этап 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 закреплённых квитанций |