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

94 lines
9.7 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. Нужны решение владельца и переписывание закреплений. Сейчас всё закоммичено как есть, ссылки не сломаны
- [ ] DB-3: проверить, как `controlled-migration-history.ts` ведёт себя на существующей БД, где записанные хеши миграций 0008–0013 посчитаны по LF-байтам (образы из `main` применяли LF-блобы). Код не менять до проверки
- [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 | Копия `tmp/` на C: готова и сверена. Реорганизация `docs/` изучена и остановлена (переносимо 31%). Коммит `3c78c55c`: CRLF-байты 28 закреплённых квитанций |