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

95 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)
- [x] `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 не переписывался)
- [x] `npm run build` (корень и backend): обе сборки проходят, `tsc --noEmit` фронтенда и бэкенда чистый
- [x] `test:mcp` (корень и backend): корень 4 из 4, backend проходит после синхронизации заглушек `scheduler-automatic-root.test.mjs` с кодом (карантин восстановления, общий шлюз БД, проверка активации)
- [ ] `test:mcp:pg:all`
- [ ] Playwright: `playwright.mcp.config.ts`, `playwright.mcp-auth.config.ts`
- [x] Сверка карты покрытия: `coverage.test.ts` проходит. 265 маршрутов (202 покрыты MCP, 63 исключены, 0 необработанных), 383 инструмента (цифра 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 закреплённых квитанций |