Files
MikrotikManager/docs/mcp-completion-plan.md
T
DenozordecandClaude Opus 5.5 9ebbf036c8 chore(docs): исправления C2 — JIT, отметки попытки и maintenance-resolve после MCP
Решения владельца от 21.11 и порядок для оператора: после complete
MCP-восстановления с внешней контрольной точкой — maintenance-inspect и
maintenance-resolve; захваты каталога выключают JIT; квитанции без .used
не закрывают старт при отсутствующем журнале. Образ backend Gitea 2746.

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

161 lines
46 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` с кодом (карантин восстановления, общий шлюз БД, проверка активации)
- [x] `test:mcp:pg:all`: все профили и монолит `integration.test.ts` проходят (147 проверок, в том числе `verifyMcpDatabaseBackup` с настоящим `pg_dump` из PostgreSQL 18, установленного через winget только как клиентские утилиты). Монолит после последней проверки висел: `native-create-id-acceptance.ts` ждал `router.close()` при открытых keep-alive соединениях; исправлено `closeAllConnections()`, точечная проверка `--native-create-id` завершается с кодом 0. Полный монолит после этой правки не гонялся (по решению владельца не перезапускать всё)
- [x] Playwright: `playwright.mcp.config.ts` 43 из 43, `playwright.mcp-auth.config.ts` 16 из 16 (на итоговом коде)
- [x] Сверка карты покрытия: `coverage.test.ts` проходит. 265 маршрутов (202 покрыты MCP, 63 исключены, 0 необработанных), 383 инструмента (цифра 368 в исходном плане была устаревшей)
## Этап 2. Хвосты кода без стенда
- [x] VRF: поправка сборщика для `afi=link` — **переносить некуда.** `sampleGreAfterAck` и `gre-liveness.mjs` существуют только в замороженной нагрузке стенда `tmp/owned-windows-vrf-*/payload`, в git их нет. Поправка `tmp/vrf-r2-gre-activation-review/sampler-projection.mjs` (потолок 4 вместо 3 для `/routing/route`) применяется к этой нагрузке при повторе GRE на стенде, пункт перенесён в этап 3
- [x] VRF: разбор keepalive есть в исходниках: `parseKeepalive` в `backend/src/services/gre-live.ts` (`10s,10` → 10 с и 10 повторов, `1m,3` → 60 и 3). Допуск бита `I`: исходное требование в документах не найдено, не проверено, нужно пояснение владельца
- [x] ROUTING: `/ip/dhcp-client` в сверке уже есть в `backend` (`chrTopologyCataloguePaths` через `wireguardInterfaceDependencyPaths`, обратный отсчёт `expires-after` игнорируется). Тесты `traffic-flow-chr-topology-inventory.test.ts` 9 из 9; без пути падают 2 (проверено временным удалением). Списки без `/ip/dhcp-client` лежат в незатрекенном `tmp/` (`REQUIRED_CATALOGUES` в `verify-manual-terminal.py`, `native-topology-conservation.mjs`), это стендовые скрипты, обновить при повторе A → B → A на этапе 3
- [x] POLL: причина `unknown` из CI2713 — **оформлена как неустановленная.** Факты (`mcp-remaining-work-20261026.md`): в изолированном Linux-опросе выборка на 177,409 с дала 16 намерений публикации, 15 подтверждений и `unknown/inconclusive` без итоговой квитанции; на VPS последнее чтение вернуло `running` до истечения лимита наблюдения 180 с, квитанция не указывает этап. Локально тот же backend с синтетическим RouterOS завершается за ~32 с, 143 действия в 18 атомарных группах прошли на одноразовой PostgreSQL. Число полных чтений контекста на группу снижено с пяти до четырёх. Причина задержки на VPS и замер версии на VPS открыты, `unknown` не перекрашивается в успех; остаток уходит в этап 3 (POLL: 336 операций, deadline Linux)
- [x] Inspector 2.13.0 по прямому HTTP (Bearer) и OAuth (PKCE) принят на текущем коде (HEAD `85a5fdb9`), оба прогона с кодом 0, хеши исходников до и после совпали. HTTP: каталог из одного инструмента `mm_servers_list`, вызов разрешённого сервера, отказ на запрещённом (`SERVER_DENIED`), старый и отозванный Bearer отклонены, новый принят. OAuth: обнаружение метаданных, обмен кода PKCE выполнил сам Inspector, один запрос авторизации использован один раз, обновление токена (оба токена ротированы), повтор старого refresh даёт 400 `invalid_grant` и отзыв семьи, новое согласие не запрашивалось. Результаты: `tmp/mcp-inspector-http-oauth-20261116/{http,oauth}/result.json`. **Не покрыто:** настоящий портал и интерфейс согласия в браузере (согласие синтетическое), обновление по 401 и естественное истечение, современная эра протокола по Bearer, RFC 7009 revoke от Inspector; Inspector взят из уже установленной копии с совпавшими хешами, не через npx; регистрация клиента заранее (dynamic registration не объявлена); отказ внеобластного инструмента проверен только фильтрацией `tools/list`
- [x] NetFlow: точный локальный адрес при wildcard-привязке — **закрыто как ограничение Node.** `dgram` отдаёт в `message` только `(msg, rinfo)` без адреса назначения, `sock.address()` после bind остаётся `0.0.0.0` (проверено на Node v25.5.0, Windows; Linux и IPv6 не проверялись, слушатель только udp4). Точный адрес даёт `IP_PKTINFO`, то есть нативный модуль или raw-сокет. Обходной путь (адрес интерфейса по маршруту к экспортёру) не равен адресу получения и ломается при policy routing и нескольких адресах, поэтому не внедрялся. Область шаблонов от адреса не зависит. Вернуть в работу, если потребуется точная идентичность
- [x] Корневые `tmp-*-pending.patch` и `tmp-db-*-draft/`, `tmp-speed-principal-draft/` сверены с HEAD (только чтение). Применены: `tmp-flow-drain-wiring-pending.patch`, `tmp-db-control-draft/` (правка COMMIT на `database-schema-control.ts:118-119`), `tmp-speed-principal-draft/` (тест побайтно совпадает). Заменены более новым кодом, применять нельзя (откатит код): `tmp-flow-engine-strict-pending.patch` (HEAD содержит все его экспорты и больше), `tmp-db-runner-draft/` (режим `--profiles-only` уже есть в расширенном виде), `tmp-check-flow-engine-pending.cjs` устарел. **Единственное неприменённое:** `tmp-db-enrollment-draft/` (`source-attestation.ts`, тест, `enrollment-host-contract.ts`): в HEAD аналога нет, помечено «TMP review component only», `productionApplied:false`, потребителей нет; решение владельца, нужен ли он. Логи `tmp-mcp-*-v1.log` не источники. Файлы не удалялись
- [x] `.claude/settings.local.json` отслеживается Git ещё с ранних коммитов, `.gitignore` его скрывает, секретов нет — **решение владельца: оставить как есть** (с учёта не снимать)
## Этап 3. Стендовые приёмки (CHR и VPS)
**Цель владельца от 2026-11-17: довести все стендовые приёмки этапа 3 до конца без отдельных команд «продолжай».** Работа идёт непрерывно (запуск, диагностика, очистка, исправление в новом слое, повтор); остановка и вопрос владельцу только при настоящем блокере: решение, меняющее критерий приёмки или поведение продукта; отсутствие доступа; разрушительный шаг без проверенной резервной копии; действия вне стенда (слияние и отправка в `main`).
Пункты ниже закрываются тремя прогонами вместо отдельных ожиданий. Каждый пункт пишет собственную квитанцию; `failed` и `unknown` не перекрашиваются, при падении объединённого прогона причина разбирается по квитанциям пунктов.
**Прогон A. Два CHR (маршрутизация), один сквозной сценарий.** Пункты: VRF отпечаток при активации GRE; VRF 56 записей и трафик при смене участников; ROUTING A → B → A после правки сверки (с `/ip/dhcp-client` в списках `tmp/`, включая поправку сборщика `afi=link` в нагрузке `gre-liveness.mjs`); WireGuard / IPsec / GRE с трафиком; NetFlow IPFIX с реального RouterOS (включить экспорт на CHR на время тех же окон трафика); нестабильные Edge (39 из 41) и маршрутизация (203 из 205) как повторы того же прогона.
**Прогон B. Linux VPS (опрос), запускать первым, идёт в фоне.** Пункты: POLL 336 операций с естественным истечением (окно от 252 минут) и POLL deadline Linux. Это один и тот же прогон.
**Прогон C. VPS (внешний интерфейс и БД), одна сессия на целевом Linux.** Пункты: EXTERNAL-UI восстановить SSH (блокер, делается первым), сквозной прогон на образах CI2736, приёмка подписанного защищённого восстановления; DB-3 перенос непустой legacy-базы; DB-4 POSIX-права целевой среды (проверяются на той же среде образов).
Ограничения: B и C нельзя запускать одновременно на одном VPS (лимит 2 ГиБ, RAM-1 отложен): развести по машинам или по времени. A независим от B и C. Порядок: восстановить SSH, затем B в фоне, A, затем C.
- [x] VRF: отпечаток стабильных полей при активации GRE (2026-11-16, прогон A1 с диагностикой v3, запуск `owned-windows-vrf-bd75f63d787ba628adad9952`: 5 кадров, стабильные хеши постоянны, чужие строки не менялись, очистка 14 из 14, сверка с базой совпала; детали и оговорки в `mcp-stand-run-a-plan.md`)
- [x] VRF: полный прогон на 56 записей и проверка трафика при смене участников (2026-11-19, слой v28 на продукте `1e96ddac`, запуск `owned-windows-vrf-f04308177d6b31c740159548`: 56 из 56, 54 операции applied/passed, трафик baseline 3/3, изоляция 0/3 при GRE 3/3, восстановление 3/3, очистка и сверка снимков совпали; детали и изменения проверки раннера в `mcp-stand-run-a-plan.md`)
- [x] ROUTING: повтор A → B → A после правки сверки (2026-11-19, `mmapp-test` на `7848e38a`, запуск `runs/2026-11-19-32678993` раннера `manual-v64-mmapp-test`: траектория a → b → a на одном маршруте, 6 окон по 3/3, 2 одобрения в UI (D8: агент под тестовой учётной записью `a3-agent`), `applied` и `recovered`, сверка 66/66 на обоих CHR со строгим `/ip/dhcp-client`, очистка 28/0; условие прогона: рабочая установка, без печати V63; подключения отозваны, MCP выключен, учётная запись отключена; детали и два неуспешных запуска до него в `mcp-stand-run-a-plan.md`)
- [x] POLL: 336 операций с естественным истечением на Linux (окно от 252 минут) — 2026-11-20, B2 на сборке `29998815` (исправление утечки `AsyncLocalStorage`, из-за которой первый прогон на `0e63cdd5` упал на 169 операциях), nonce `d3f72b64943a81a7`, пакет `tmp/mcp-poll-linux-capacity336-head-29998815-20261120/`.
- `capacity336Accepted=true`: 337 операций, 336 естественно сжатых аутентифицированных архивов, 1348 GET, 337 уникальных источников, 0 ошибок воркера.
- 5 ч 40 мин при пределе 72 ч; задержка архива — медиана 18 с, максимум 56 с.
- Очистка подтверждена, пакет снят, базовый снимок не изменился.
- Квитанции `worker-observation.json` нет.
- Новый ключ — `capacity336LinuxAccepted20261120`; прежний `capacity336Profile` не переписан.
- [x] POLL: deadline целевого Linux — 2026-11-20, повторно на `29998815` (12,1 с, `deadlineAccepted=true`, swap 7/5609 страниц записан отдельно), засчитан в тот же прогон B. Первый B1 был на сборке `0e63cdd5` (57 миграций, `mmapp-test` на `mcp-0e63cdd5`), пакет `tmp/mcp-poll-linux-cold143-head-0e63cdd5-20261120/`: холодный cold143 завершился за 10,9 с при пределе 180 с (CI2683: 158 с), 143/22/54/4/151, очистка подтверждена, базовый снимок не изменился. По D-B3 (а) владельца от 17.11 это срок и функциональность (`deadlineAccepted=true`); swap хоста 8/43 страниц записан отдельно (`resourceAccepted=false`, относится к отложенному RAM-1), строгий `accepted=false` не перекрашивается. Прежний ключ `targetLinuxColdPollAccepted=false` не переписан, новый — `targetLinuxColdPollDeadline20261120`. B1 засчитывается в общий прогон B, потому что снимок базы при запуске B2 (`150b5ac3…`) по содержимому совпал со снимком B1; при любом переразвёртывании до B2 B1 повторялся бы
- [x] EXTERNAL-UI: восстановить SSH к тестовому VPS (блокер) — 2026-11-19: `ssh mm-vps` (161.104.46.222) по ключу под `root` работает (BatchMode); шаг 1.1 планов B и C: отпечатки ключей хоста ED25519 `CfLP9rN3…qs/o`, ECDSA `7rFwtP6i…/yAk`, RSA `GzI/Ajrf…OFA` совпали с `~/.ssh/known_hosts`, ED25519 совпал с закреплённым `tmp/test-server-known-hosts`, его sha256 равен `HOSTKEY_SHA` пакетов POLL (`c6ca709c…d2c9`), ключ хоста не менялся
- [x] EXTERNAL-UI: сквозной прогон на образах текущей сборки (решение владельца 17.11 вместо CI2736) — 2026-11-20, `29998815` (Gitea 2745) + Portal CI2586, 57 миграций, пакет `tmp/mcp-c1-owned-portal-browser-29998815-20261120/`.
- Edge через SSH-пробросы: вход в Portal, выдача токена в UI, подтверждение плана, `applied/passed`, ссылка на шаг, подписанный отзыв владельца, отказ 401 без деталей. Все признаки квитанции `true` (`d3a1e862…`).
- Очистка подтверждена, `mmapp-test` поднят на тех же образах.
- Исправлены дефекты пакета: внутренняя сеть без публикации портов и потеря журналов. Подробности в `mcp-stand-run-c-plan.md`, раздел 2.5.
- [ ] EXTERNAL-UI: приёмка подписанного защищённого восстановления
- 2026-11-21, диагностика на `29998815` (пакет `tmp/mcp-c2c4-restore58-29998815-20261120/`): операторская цепочка на Linux от `init` до двух реплик backend пройдена при двух отступлениях — JIT PostgreSQL выключен, восстановление через REST вместо MCP.
- Ждёт решения владельца по двум находкам: JIT против лимита 5 с захвата каталога; MCP-восстановление под карантином на свежем журнале всегда `blocked`. Подробности в `mcp-stand-run-c-plan.md`, раздел 2.7.
- 2026-11-21: обе исправлены в продукте по решению владельца (`11537c99`, образ backend Gitea 2746 `fed349a6…`); после `complete` по MCP добавлен штатный `maintenance-resolve`. Приёмочный прогон ждёт доставки образа на VPS.
- [x] DB-3: перенос непустой legacy-базы — **закрыто как ограничение (решение владельца 2026-11-17): контрольный путь не принимает старые установки, обновление идёт legacy-путём (проверено на `mmapp-test`, 12 → 57 миграций, данные целы).** Продуктовый путь не разрабатывается; см. раздел «Решения владельца 2026-11-17 по прогонам B и C»
- [ ] DB-4: настоящие POSIX-права целевой среды
- 2026-11-21, диагностика C4 на `29998815`: 0640, 0604, каталог чужого UID, символьная ссылка и `init` в существующий каталог отклонены до подключения к БД (0 подключений по журналу PostgreSQL), точные причины записаны. Засчитывается вместе с приёмочным прогоном C2 (`mcp-stand-run-c-plan.md`, раздел 2.7).
- [x] NetFlow: захват IPFIX с реального RouterOS — 2026-11-19: захваты CHR1/CHR2 (16.11) и окно с пингами на CHR1 разобраны парсером продукта `traffic-flow-parse.ts` (`tmp/mcp-stand-run-a-20261116/ipfix-parse.ts`, квитанция `ipfix-capture.json`): IPFIX v10, домен наблюдения 0, шаблон и данные (наборы 258/259), ifIndex 0/2, порты и счётчики; 10 ping CHR1→CHR2 по 56 байт дали ровно два ICMP-потока по 10 пакетов и 560 байт; окно закрыто, CHR1 66/66 с базой
- [x] WireGuard / GRE: жизненный цикл с трафиком (прогон A; IPsec вынесен отдельным пунктом по решению D9) — 2026-11-19 по квитанции A2 v28 `owned-windows-vrf-f04308177d6b31c740159548`, как предусмотрено планом прогона A (строка A4: «те же квитанции A1/A2»): WG-интерфейсы и пиры на обоих CHR (PUT+PATCH, ACK, подтверждённые ID), GRE на обоих (PUT, ACK, `greReadback`), трафик 36/36 контрольных пингов через GRE поверх WireGuard в трёх фазах, DELETE всех туннелей с подтверждённым отсутствием, очистка раннера и сверка снимков 66/66. Счётчики байтов отдельно не записывались: трафик доказан ответами на ping
- [ ] IPsec: новый MCP-сценарий `mm_ipsec_*` с подтверждением, трафиком и SA на стенде CHR (единственный прежний сценарий `tmp/ipsec-network82.mjs` октябрьский и идёт через REST приложения, не MCP)
- [ ] Нестабильные сценарии Edge (39 из 41 без повтора): исторический прогон управления в Edge из `mcp-remaining-work-20261026.md`, оба отказавших прошли при целевом повторе. Локально не воспроизводится, нужен стенд; перенесено в этап 3 по решению владельца
- [ ] Нестабильные сценарии маршрутизации (203 из 205 без повтора): исторический локальный прогон сверки, оба случая прошли при целевом повторе. Профили маршрутизации в `--profiles-only` прошли (36 из 38, ipsec и system-database исправлены). Перенесено в этап 3 по решению владельца
## Этап 4. Заблокировано или отложено
- [ ] PATHS: нет третьего независимого узла — получить узел или записать как ограничение
- [ ] RAM-1 (лимит 2 ГиБ): отложен владельцем — вернуть в работу или записать как ограничение
- [ ] autoRecovery: нет источника событий RouterOS с обнаружением пропусков — оставить выключенным, записать решение
- [ ] ROUTING: RT-3, выдача одноразового допуска автоматическому возврату — **реализовать нельзя без решения владельца.** Единственная формулировка: пункт открыт (`mcp-evidence-statistics-20261101.md`, стр. 57). Код отказывает намеренно: `recordForwardOutcome` в `routing-reservation-store.ts` не возвращает `RoutingReservedInverseAllocation`, при `failed` бросает «Authenticated network evidence for automatic recovery unavailable». Автовозврат зависит от RT-1 (полный источник событий с обнаружением пропусков), REST `/log` его не заменяет; отказ принят и покрыт `--routing-reservations` (20 сценариев). Перенесено в этап 4 к autoRecovery по решению владельца; вернуть в работу после RT-1
## Этап 5. Закрытие (FINAL-2 и FINAL-3)
- [ ] Манифест: критерий плана → доказательство → статус, без перекраски `failed` и `unknown`
- [ ] Инструкция по включению: наблюдение → подтверждения → ограниченная автономность
- [ ] Проверить, что MCP и контроллер выключены по умолчанию
- [ ] Сократить `docs/mcp.md` (417 КБ) до пользовательской документации
- [ ] PR в `main`
Продуктовые задачи из анализа таймингов (2026-11-17), не блокируют слияние в `main`; детали и числа в `mcp-stand-run-a-plan.md`, раздел «Вопросы к продукту»:
- [ ] **Облегчённый путь «план и применение одним вызовом» и составные операции.** Сейчас все 161 инструмента записи называются `*_plan` и выполняются как план, одобрение (только в режиме `approval`, для защищённых объектов и опасных операций), запись, проверка; составного инструмента вида «создать WireGuard-туннель в отдельном VRF между сервером 1 и сервером 2» нет, клиент собирает цепочку примитивов (`mm_wireguard_interface_*`, `mm_wireguard_peer_*`, `mm_gre_*`, `mm_vrf_*`). Решить: нужен ли в режиме `autonomous` вызов «план и применение вместе» с сохранением политики (лимиты, область, защищённые объекты, аудит до записи) и нужны ли составные операции верхнего уровня; если да, описать контракт и совместимость с идемпотентностью и обратными операциями.
- [ ] **Устойчивость создания VRF поверх активного GRE.** Из четырёх попыток на стенде две дали `partial / VERIFICATION_FAILED` с диагностикой `stage=transition-classification`, `guard=ADDRESS_ROUTE_ABSENCE_OUTSIDE_EXACT_ACQUISITION` (`backend/src/services/vrf-production-transition.ts:394`): GRE при создании VRF гаснет и поднимается, перечитывание не атомарно и видит адрес или маршрут отсутствующим, классификатор отказывает, хотя VRF на роутере создан. Решить и реализовать: повтор классификации после ограниченного ожидания стабилизации либо различение кратковременного исчезновения при мигании GRE; добавить тест на реконструированных до/после-состояниях и проверку на стенде.
- [ ] **Задержка записи WireGuard.** По метрикам прогона `owned-windows-vrf-9ccf68cd…` (раннер с вашего Windows по интернету): запись интерфейса и пира WireGuard 80–136 с на пару PUT+PATCH против 29–36 с для простой записи; одобрение → intent 25–77 с, ACK → терминал 10–48 с, 310–472 чтения роутера на запись против 103. Выяснить, чем вызвано (число чтений роутера самой операцией, ожидания, генерация ключей), и измерить на VPS рядом с CHR без стендовых проверок: простая запись и запись WireGuard через приложение с метками времени продукта и числом чтений. Цель: понять, что оптимизировать в продукте (например, число чтений на операцию), а не в стенде. **Предварительная модель (вывод по записям прогона `9ccf68cd…`, не доказательство):** время шага ≈ 17 с фиксированно + ~0,15 с на каждое чтение роутера (простая запись ≈ 33 с при 103 чтениях, шаг WireGuard ≈ 65 с при 310); запись на роутер занимает 0,06–0,14 с. WireGuard и интерфейс создаются отключёнными и затем включаются отдельной командой (`wireguard-peer-create-actions.ts:113`), поэтому у него пара шагов PUT+PATCH, то есть два цикла «запись → проверка». Неизвестно: какая часть 310–472 чтений принадлежит продукту, а какая независимой проверке раннера, и какая доля 0,15 с на чтение приходится на интернет между Windows и CHR.
## Журнал
| Дата | Что сделано |
| --- | --- |
| 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 закреплённых квитанций |
| 2026-11-16 | Этап 1: `test:mcp:pg:all` починен по устаревшим фикстурам (коммиты `07aaa40b`…`77e52f15`, добавлены `test:changed` и режим `MCP_INTEGRATION_CONTINUE=1`). Единственный остаток: нет `pg_dump` для `verifyMcpDatabaseBackup`. Playwright зелёный |
| 2026-11-16 | Этап 1: `pg:all` закрыт (установлены `pg_dump`/`pg_restore`, исправлено зависание завершения в `native-create-id-acceptance.ts`). Открыты два пункта про нестабильные сценарии: стендовые, нужно решение владельца |
| 2026-11-16 | Этап 1 закрыт. Два пункта про нестабильные сценарии Edge и маршрутизации перенесены в этап 3 (стендовые) |
| 2026-11-16 | Этап 2: NetFlow wildcard закрыт как ограничение Node; `/ip/dhcp-client` уже в `backend`; поправка VRF `afi=link` относится к стендовой нагрузке в `tmp/`; RT-3 ждёт решения владельца |
| 2026-11-16 | RT-3 перенесён в этап 4 к autoRecovery |
| 2026-11-16 | Этап 3: пункты сгруппированы в три прогона (A: два CHR, B: опрос Linux, C: внешний интерфейс и БД) |
| 2026-11-16 | Этап 2: Inspector HTTP и OAuth приняты на HEAD `85a5fdb9` (с оговорками о покрытии). В этапе 2 открытых пунктов нет |
| 2026-11-16 | План прогона A: решены D1 (REST с Windows), D2 (CHR2 закрыт по адресам, ftp и telnet выключены), D3 (раннеры под `claude`), D4 (пароли из переменных), D5 (контроллер локально), D7 (снят), D9 (IPsec вынесен), D10 (захват на CHR) |
| 2026-11-16 | VPS подготовлен к прогонам: очищено 8 ГБ Docker (свободно 11 ГБ), снят дамп базы, ветка `codex/mcp-foundation` отправлена в Gitea, Gitea собрала образы (запуск `2738`, успешно), на VPS заменены backend и frontend установки `mmapp-test` на HEAD `5ec95a7c`. Применены миграции со старых 12 до 57 (`0057`), 34 таблицы `mcp_*`, данные сохранены (2 сервера), backend `healthy`. Обновление прошло по прежнему (legacy) пути, схема `mmapp_control` пуста: контрольный путь миграций и пункт DB-3 этим не закрыты. MCP и контроллер по умолчанию выключены, не проверялось |
| 2026-11-17 | В этап 5 добавлены две продуктовые задачи: облегчённый путь «план и применение» с составными операциями; задержка записи WireGuard и замер на VPS |
| 2026-11-17 | Получена точная причина нестабильного отказа создания VRF (`transition-classification`, `ADDRESS_ROUTE_ABSENCE_OUTSIDE_EXACT_ACQUISITION`), задача в этапе 5 |
| 2026-11-17 | Владелец поставил цель: довести все стендовые приёмки этапа 3 до конца без отдельных команд |
| 2026-11-20 | Владелец утвердил правило прав опроса 2.9 и разбор очереди 2.10. `mmapp-test` переразвёрнут на `0e63cdd5` (запуск Gitea `2743`, резервная копия БД перед заменой). B1 (POLL deadline Linux) пройден по D-B3: 10,9 с из 180 с |
| 2026-11-20 | B2 (capacity336, nonce `5945935965481c83`) — `failed` на 169 операциях и 163 архивах после 2 ч 41 мин. Разбор очереди архивов держался до конца. Node завершился через `abort()`, текст ошибки не сохранился. Гипотеза — рост кучи с каждой операцией (время операции растёт с 5 до 22 с за 70 операций). Пакет снят, VPS свободен, повтора нет; пункт B2 открыт |
| 2026-11-20 | Причина установлена: продукт создавал `AsyncLocalStorage` на каждый опрос (Node держит их вечно), исправлено в `29998815`. `mmapp-test` переразвёрнут (Gitea `2745`), B1 повторён (12,1 с), **B2 принят**: 337/336/1348, 0 ошибок воркера, 5 ч 40 мин, очистка подтверждена. Оба пункта прогона B закрыты |
| 2026-11-19 | Оптимизация продукта (keep-alive REST, права раз на этап, параллельные чтения, сервисы WireGuard/scoped/IPsec) и шардированные тесты; A2 пройден на слое v28 (продукт `1e96ddac`) |
## Решения владельца 2026-11-17 по прогонам B и C
- **DB-3 (перенос непустой legacy-базы): записать как ограничение, пункт переходит в этап 4.** Контрольный мигратор не принимает установки без маркеров контрольной истории (отказ на префиксе 0, принято ранее); обновление старых установок идёт прежним legacy-путём (подтверждено на `mmapp-test`: 12 → 57 миграций, данные целы, схема `mmapp_control` пуста). Разработка продуктового пути (шаг N → 36 под drain и attestation и точка входа для хвоста 0038–0057) не выполняется.
- **«Deadline целевого Linux» (холодный опрос 180 с): критерий разделяется** на `deadlineAccepted` (укладывается ли опрос в 180 с и работает ли функционально) и `resourceAccepted` (подкачка памяти и лимит памяти хоста; относится к отложенному RAM-1). Подкачка фиксируется, но пункт не валит.
- **EXTERNAL-UI, образы:** пакет CI2736 пересвязывается с образами текущего HEAD (CI2738, 57 миграций), старые дайджесты не тянутся; формулировка критерия меняется с «на образах CI2736» на «на образах текущей сборки».
- **Решения оркестратора по цели (не меняют критериев, детали в планах B и C):** сборка B из HEAD `5ec95a7c`, вход по ключу; одноразовые подтверждения и nonce выдаёт агент по цели владельца, фиксируется нейтрально; при отказе до 336 операций автоповтора нет (разбор, исправление новым слоем, новый nonce); `mmapp-test` останавливается на окна C вне B и A (ROUTING); дамп восстанавливается только в изолированный внутренний PostgreSQL на VPS без запуска backend и планировщика, с VPS не копируется.
## Отложено: находки аудита вне MCP (2026-11-17, `ponytail-audit`, по просьбе владельца пока не берём в работу)
1. Пароли роутеров хранятся открытым текстом (`servers.password`) и отдаются в ответах API (`servers-mapper.ts:8,39`); шифрование MCP (AES-256-GCM) есть, но не применено к роутерам.
2. Контейнер backend работает от root (в `backend/Dockerfile` нет `USER`).
3. Секрет-заглушка `dev-secret-change-me` из `backend/.env.example` проходит проверку длины (`config.ts:56`).
4. Неизвестный маршрут `/api/*` получает `mm:dashboard:read` для любого метода (`permissions.ts`, конец `permissionForRequest`); теста «у каждого маршрута есть правило» нет.
5. `verify_ssl` по умолчанию `false` (`schema.ts:64`), сертификат роутера не проверяется.
6. `AUTH_REQUIRED` по умолчанию `false` (`config.ts:20`); прод-композиции ставят `true`.
7. Базовый образ `node:22-bookworm-slim` не закреплён по дайджесту.
8. Ответы 4xx отдают исходный `error.message` (`index.ts:103-106`).
Проверено без замечаний: OAuth и токены MCP, список разрешённых команд `exec`, отсутствие подстановки значений в SQL, обязательные переменные в прод-композициях.