Прежний 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]>
120 lines
18 KiB
Markdown
120 lines
18 KiB
Markdown
# 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`, три продуктовые задачи.
|