Files
MikrotikManager/docs/mcp-final-manifest.md
T
DenozordecandClaude Opus 5.5 c1abfffe26 chore(docs): пользовательская документация MCP вместо 417 КБ инженерных записей
Прежний docs/mcp.md перенесён без изменений текста в
mcp-implementation-history.md с пометкой «исторический». Новый mcp.md
(19 КБ) написан по коду: настройка сервера, подключение клиента, путь
изменения, возможности, Route AI, webhook отзыва, восстановление базы,
ограничения и проверки. Инструкция по включению дополнена правом
mm:settings:admin и путём «Система» → «MCP»; входящие ссылки обновлены.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-21 21:25:01 +07:00

120 lines
18 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: итоговый манифест (критерий → доказательство → статус)
Составлен 21 ноября 2026 для этапа 5 [плана завершения](mcp-completion-plan.md). Ветка `codex/mcp-foundation`, исправления продукта до `d02a019b` включительно. Правило: статусы `failed` и `unknown` не перекрашиваются. Если пункт позже принят повтором, исторический отказ остаётся отдельной строкой в разделе «История отказов».
**Статусы:**
- **принято** — есть квитанция, критерий выполнен;
- **принято частично** — выполнена названная часть, остальное перечислено;
- **ограничение** / **отложено** — решение владельца, пункт не будет выполняться в этой ветке;
- **открыто** — работа не сделана;
- **не проверено** — критерий есть в исходном реестре, но не входил в план завершения, квитанции нет;
- **failed** / **unknown** — исторический результат, сохранён как есть.
Источник исходных критериев — [именованный реестр от 1–3 ноября](mcp-evidence-statistics-20261101.md), разделы POLL, DB, ROUTING, NATIVE, PATHS, EXTERNAL-UI и FINAL. Пункты плана завершения ссылаются на планы прогонов [A](mcp-stand-run-a-plan.md), [B](mcp-stand-run-b-plan.md), [C](mcp-stand-run-c-plan.md) и на `mcp-current-progress.json`. Пути `tmp/…` — локальные пакеты доказательств вне Git; копия `tmp/` от 15 ноября описана в этапе 0 плана.
## Критерий завершения плана
| Условие | Доказательство | Статус |
| --- | --- | --- |
| Этапы 0–2 выполнены | `mcp-completion-plan.md`, этапы 0–2: все пункты `[x]` | принято |
| Этап 3 (стенд) | там же, этап 3: все пункты `[x]`, журнал 2026-11-21 | принято (отдельные пункты см. ниже) |
| Этап 4 оформлен как явные решения | там же, этап 4: 4 пункта `[ ]` | открыто: решения владельца |
| MCP и контроллер выключены по умолчанию | миграция `0015_mcp.sql` (`mcp_settings.enabled DEFAULT false`, `mcp_routing_profiles.enabled DEFAULT false`); `routeAiProfileSchema.autoRecovery` по умолчанию `false`; `authenticateMcpToken` отказывает `MCP_DISABLED`/503 при выключенном MCP (`store.ts`); воркер не вызывает контроллер при выключенном MCP (`workers.ts`); проверки добавлены в `integration.test.ts` на свежей базе | принято |
| Этап 5 и слияние в `main` | этап 5 плана | открыто |
## POLL
| Исходный критерий | Доказательство | Статус |
| --- | --- | --- |
| Target Linux cold deadline | B1 `0e63cdd5`: cold143 за 10,9 с при пределе 180 с; повтор на `29998815`: 12,1 с; `deadlineAccepted=true`; ключ `targetLinuxColdPollDeadline20261120` | принято по сроку и функциональности (D-B3 а); **строгий `accepted=false` сохранён**: swap хоста 8/43 и 7/5609 страниц, `resourceAccepted=false` относится к отложенному RAM-1 |
| Capacity336 and next admission | B2 `29998815`, nonce `d3f72b64943a81a7`: 337 операций, 336 естественно сжатых аутентифицированных архивов, 1348 GET, 0 ошибок воркера, 5 ч 40 мин; ключ `capacity336LinuxAccepted20261120` | принято; два прежних отказа — в истории |
| Remaining crash/unknown transitions | Причина `unknown` CI2713 оформлена как неустановленная (этап 2) | **unknown** сохранён; остальные переходы не проверялись (план B, раздел 7) |
| Retention and admission policy boundaries | `fourteenDaysElapsedAccepted=false` (14 суток календарного удержания не выдерживались) | не проверено |
| Concurrent collectors and latency budget | — | не проверено (план B, раздел 7) |
## DB
| Исходный критерий | Доказательство | Статус |
| --- | --- | --- |
| DB-1: допуск действительного поколения источника на целевой установке | Приёмка C2 `4db568f58566878a`: проверка каталога источника, rebind source58 (эпоха 4), `seal`, `complete` на целевом Linux | принято в составе C2, отдельной квитанции DB-1 нет |
| DB-2: допуск писателей и реплик под итоговой политикой | C2: две реплики backend с восстановленными данными и защищённой записью `PUT /api/logs/settings` | принято в составе C2, отдельной квитанции DB-2 нет |
| DB-3: перенос непустой legacy-базы | Решение владельца 2026-11-17: контрольный путь старые установки не принимает, обновление идёт legacy-путём (`mmapp-test` 12 → 57 миграций, данные целы) | ограничение |
| DB-4: POSIX-права целевой среды | `4db568f58566878a` (ключи `init` 0700/0600, пять отказов до подключения к БД); `30fb9d4ac7d56117` (архив с `mmapp_control` отклонён, сбой посреди восстановления не запускает потребителей); `bff61f8d715cf6bf` (доступ из архива не возвращается, 48 файлов и каталогов 0600/0700) | принято |
| Защищённое восстановление через Edge и MCP | C2 `4db568f58566878a`; продуктовые исправления `11537c99` (JIT, первое MCP-восстановление), `e69d5f0a` (`maintenance-inspect`) | принято |
## ROUTING
| Исходный критерий | Доказательство | Статус |
| --- | --- | --- |
| A → B → A после правки сверки (пункт плана) | `runs/2026-11-19-32678993` раннера `manual-v64-mmapp-test`: один route ID, 6 окон 3/3, 2 одобрения в UI (D8), `applied` и `recovered`, сверка 66/66 со строгим `/ip/dhcp-client` | принято; два прежних запуска — в истории |
| RT-1: подлинная сетевая контрольная точка (источник событий с обнаружением пропусков) | — | открыто: этап 4, autoRecovery выключен |
| RT-2: положительный обратный шаг в том же резервном слоте | Ближайшее доказательство — возврат `operations.recover` → `recovered` на том же route ID в A3; резервирование именно RT-2 отдельной квитанцией не подтверждено | не проверено |
| RT-3: одноразовый допуск автоматическому возврату | Код отказывает намеренно, покрыто `--routing-reservations` (20 сценариев) | открыто: этап 4, решение владельца |
| RT-4: исходные полномочия восстановления и независимый канал | Локально: `integration.test.ts` (независимый канал отклоняет алиасы основного адреса и другое устройство) | не проверено на стенде |
| RT-5: не-main/VRF и совместимость | A3 шёл в таблице VRF (окна трафика в VRF, GRE внутри VRF) | принято частично: вариант A3; прочие сочетания не проверялись |
| Нестабильный набор маршрутизации (A7, 203 из 205) | Набор из 205 тестов восстановлен, 5 запусков подряд по 205/205 (D11); на итоговом коде ещё раз 205/205 | принято; исторический результат 203/205 — в истории |
## NATIVE
Реестр от 3 ноября: восемь пакетов, три приняты до плана завершения (1, 5, 6), пять открыты.
| Пакет | Доказательство | Статус |
| --- | --- | --- |
| 1, 5, 6 | Реестр `mcp-evidence-statistics-20261101.md` | принято до плана завершения |
| 2. VRF production forwarding | A1 `owned-windows-vrf-bd75f63d…` (отпечаток при активации GRE); A2 v28 `owned-windows-vrf-f04308177d6b31c740159548` (56 из 56, трафик baseline 3/3, изоляция 0/3, восстановление 3/3, сверка совпала) | принято; нестабильность VRF поверх активного GRE (2 из 4 попыток `partial`) — продуктовая задача этапа 5 |
| 3. WireGuard: общий жизненный цикл и трафик | A2 v28: интерфейсы и пиры на обоих CHR, ACK и ID, 36/36 пингов через GRE поверх WireGuard, удаление и сверка 66/66; счётчики байтов не записаны | принято (трафик доказан ответами ping); задержка записи 80–136 с — продуктовая задача этапа 5 |
| 4. IPsec/GRE: ссылки, каскады, SA, трафик | GRE: A2 v28. IPsec: 5 из 5 подряд на `a7d85fd0` и 5 из 5 на `d02a019b` (раннер `tmp/mcp-stand-ipsec-20261121/`), `installed-sa` с ростом `current-bytes`, ping 10/10, сверка 66/66; клиент CHR2 — REST-фикстура (решение владельца) | принято; не проверены на стенде клиенты с сертификатами, экспорт сертификатов, REST-путь `ipsec-ca.ts`, откат ревизии IPsec |
| 7. NetFlow/IPFIX | A5: захваты CHR1/CHR2 и окно 10 ping разобраны `traffic-flow-parse.ts`, ровно два ICMP-потока по 10 пакетов и 560 байт | принято; точный локальный адрес при wildcard-привязке — ограничение Node (этап 2) |
| 8. Recursive acquisition identity semantics | — | не проверено (вне плана завершения) |
## PATHS
| Исходный критерий | Доказательство | Статус |
| --- | --- | --- |
| Независимый третий узел; двусторонний трафик и переключение; ECMP/NAT/FastTrack/RPF/route leaking/community; частичные записи, потеря ACK, дрейф | — | открыто: этап 4 (нет третьего узла) |
## EXTERNAL-UI
| Исходный критерий | Доказательство | Статус |
| --- | --- | --- |
| EXT-1: подписанный отзыв в настоящих Manager и Portal | C1 на `29998815` (Gitea 2745) + Portal CI2586: вход, выдача токена в UI, подтверждение плана, `applied/passed`, подписанный отзыв, 401 без деталей | принято |
| EXT-2: внешний MCP SDK (HTTP, stdio, OAuth PKCE) | `mcp-external-clients-completion-20261103.json` | принято до плана завершения |
| UI-1: веб-раздел MCP целиком | C1 покрывает один поток подтверждения и отзыв; выдача ограниченного доступа, отказы, фильтры и пагинация на стенде не проверялись (план C, раздел 7) | принято частично |
| UI-2: браузерные сценарии артефактов и восстановления | C2: загрузка PGDMP, план с точным хешем, одно применение через MCP. Прочие сценарии UI-2 (размер и SHA файла перед сохранением, исчезновение артефакта, пагинация каталога) прошли локально, но в реестре от 3 ноября UI-2 оставался открытым, и на стенде они не повторялись | принято частично |
| RAM-1: вся установка ≤ 2 ГиБ | — | отложено владельцем (этап 4) |
| Нестабильные сценарии Edge (A6, 39 из 41) | 5 запусков подряд, в каждом 43 из 43 (D11) | принято; причина исторических отказов не установлена |
## FINAL
| Исходный критерий | Доказательство | Статус |
| --- | --- | --- |
| Итоговый снимок исходников и регрессия | Этап 1 на прежнем HEAD; на коде `d02a019b`: шардированный `test-mcp-postgres-sharded.mjs` 6 из 6, `--module-completion`, набор A7 205/205 | принято частично: полный этап 1 (`lint`, `build`, `test:mcp:pg:all`, Playwright) на итоговом HEAD повторяется перед PR |
| Контракты, безопасность, покрытие, судьба нерешённой истории | `coverage.test.ts` (этап 1); этот манифест | принято частично: манифест составлен, решение по открытым строкам — за владельцем |
| Инструкции по эксплуатации и безопасное включение | Проверка «выключено по умолчанию» (выше); [mcp-enable-guide.md](mcp-enable-guide.md) — три шага включения, остановка и отзыв, частые отказы | принято частично: в документах стенда есть доказательства только для режима «С подтверждением»; «Наблюдатель» и «Автономный» — тестами политики; инструкция сверена с кодом, по интерфейсу целиком не пройдена. Пользовательская документация — [mcp.md](mcp.md) |
## История отказов (не перекрашивается)
| Что | Результат | Чем закрыто |
| --- | --- | --- |
| POLL capacity336 V5 (исторический) | failed: 106 операций, 99/336 архивов, 1 ошибка воркера | B2 на `29998815` |
| POLL B2 на `0e63cdd5` | failed на 169 операциях и 163 архивах (утечка `AsyncLocalStorage` на каждый опрос) | исправлено в `29998815`, повтор принят |
| POLL `targetLinuxColdPollAccepted` | `false` (ресурс, swap) | не переписан; срок принят отдельным ключом |
| POLL CI2713 | unknown, причина не установлена | не закрыто |
| ROUTING A3, запуск 1 `runs/2026-11-19-5b3e5daa` | failed: ошибка SQL самого раннера | исправлено в раннере, запуск 3 принят |
| ROUTING A3, запуск 2 `runs/2026-11-19-0aa654b5` | `unknown`/`inconclusive`/`MEASUREMENT_UNKNOWN`: CHR2 перезагрузился сам («critical program crashed») | запуск 3 принят; сбой RouterOS не устранён |
| VRF поверх активного GRE | 2 из 4 попыток `partial`/`VERIFICATION_FAILED` | продуктовая задача этапа 5 |
| C2: попытки до приёмки | две попытки сорвал харнесс (сохранены как dry run) | приёмка `4db568f58566878a` |
| DB-4, попытка `d72555218098d2a1` | failed: защищённый backend без пина схемы не стартует | добавлена фаза `schema-pin`, повтор принят |
| IPsec `runs/2026-11-21-3dcfd8ae` | failed: RouterOS 7.24.5 отклонил `comment` у сертификата | `e7eb108c` |
| IPsec `c5e590e4`, `3e77307b` | `rejected`/`DEVICE_UNAVAILABLE`: применение не ждало глобальную блокировку при опросе сборщиков | `a7d85fd0`, затем 5 из 5 |
| IPsec до `d02a019b` | `server_remove` оставлял profile и proposal (остаток удалял раннер) | `d02a019b`, затем 5 из 5 без остатка |
| Edge 39 из 41, маршрутизация 203 из 205 | исторические отказы, причины не установлены | повторы по D11 |
## Состояние стенда и открытые решения владельца
- `mmapp-test`: backend `mcp-d02a019b`, frontend `mcp-29998815`; MCP выключен, подключения отозваны, тестовая учётная запись `a3-agent` отключена.
- Оба CHR: после IPsec `ipv4/ipv6-fast-path-active=false` при неизменной конфигурации; причина и способ возврата не установлены.
- VPS: 16 резервных копий `/root/backups/*pre-*`, 9 тегов `mmapp-test/backend`, каталоги `/root/c2c4-29998815` и `/var/tmp/restore58-*` — чистка по решению владельца.
- Этап 4: PATHS, RAM-1, autoRecovery, RT-3. Этап 5: PR в `main`, три продуктовые задачи.