From 6b6410fe572aaaad33ee7ef2a2f9c66d3e375f23 Mon Sep 17 00:00:00 2001 From: Denozordec Date: Thu, 19 Nov 2026 18:27:31 +0700 Subject: [PATCH] =?UTF-8?q?chore(docs):=20=D1=81=D0=B2=D0=BE=D0=B4=D0=BA?= =?UTF-8?q?=D0=B0=20=D1=80=D0=B5=D1=88=D0=B5=D0=BD=D0=B8=D0=B9=20=D0=BF?= =?UTF-8?q?=D0=BE=20MCP=20=D0=B8=20=D1=81=D1=82=D0=B5=D0=BD=D0=B4=D1=83=20?= =?UTF-8?q?=D0=B4=D0=BB=D1=8F=20=D1=80=D0=B5=D0=B2=D1=8C=D1=8E=20=D0=B2?= =?UTF-8?q?=D0=BB=D0=B0=D0=B4=D0=B5=D0=BB=D1=8C=D1=86=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- docs/mcp-decisions-review-20261119.md | 57 +++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 docs/mcp-decisions-review-20261119.md diff --git a/docs/mcp-decisions-review-20261119.md b/docs/mcp-decisions-review-20261119.md new file mode 100644 index 00000000..7d0a248e --- /dev/null +++ b/docs/mcp-decisions-review-20261119.md @@ -0,0 +1,57 @@ +# Ревью решений по MCP и стенду (2026-11-19) + +Сводка решений, принятых по ходу этапа 3, которые меняют поведение продукта или смысл приёмки. По каждому: что сделано, на чём основано, риск и рекомендация. Колонка «Кто решил»: **владелец** — решение уже принято тобой, нужна только финальная проверка; **оркестратор** — принято мной по цели, нужно твоё утверждение. + +Контекст: A2 пройден на слое v28 (продукт `1e96ddac`), `docs/mcp-stand-run-a-plan.md`, раздел «A2, слои v26–v28». + +## 1. Продукт: допуски VRF к поведению RouterOS + +RouterOS меняет link-local адреса (LL), connected-маршруты fe80 и состояние GRE не атомарно и не мгновенно, а продукт читает адреса и маршруты отдельными запросами. Без этих правок запись VRF отклонялась, хотя на роутере всё было верно. + +| # | Коммит | Что | Кто решил | Риск | Рекомендация | +|---|---|---|---|---|---| +| 1.1 | `bffa3086` | Перечитывать роутер, если GRE мигнул после записи VRF | оркестратор | Низкий: принимается только состояние, прошедшее ту же проверку | Утвердить | +| 1.2 | `2a11ea3b` | Пропажа LL у GRE без MAC временная и для неизменяемых участников | оркестратор | Низкий: только перечитывание, не принятие | Утвердить | +| 1.3 | `680c888a` | Перечитывать при пропаже LL и маршрута у любого участника | оркестратор | Низкий: то же | Утвердить | +| 1.4 | `eec984f3` | Предел перечитываний 8, пауза 2 с | оркестратор | Низкий: операция может ждать до ~30 с перед отказом | Утвердить | +| 1.5 | `782d1d52` | **Принять пропажу автоматического LL пустого моста при выходе из VRF** | владелец («принимаю пропажу») | **Средний**: на CHR2 LL возвращается за ~6 с, не возвращался только на CHR1 после нештатной перезагрузки. Возможно, это аномалия CHR1, а продукт теперь принимает её для любого пустого моста | Утвердить, но проверить на CHR1 после штатной перезагрузки (`exp-bridge-ll.mjs`); если LL вернётся, сузить допуск | +| 1.6 | `ca82dade` | Принять однократный возврат LL моста при сверке с запечатанной точкой | оркестратор (следствие 1.5) | Низкий | Утвердить вместе с 1.5 | +| 1.7 | `0dc1f7c9` | Перечитывать, если маршрут fe80 моста вернулся раньше его LL | оркестратор | Низкий: принятие только без «висящего» маршрута | Утвердить | +| 1.8 | `1efc265e` | Перечитывать, если маршрут fe80 задержался после ухода LL | оркестратор | Низкий | Утвердить | + +## 2. Продукт: скорость при той же итоговой защите + +| # | Коммит | Что | Кто решил | Риск | Рекомендация | +|---|---|---|---|---|---| +| 2.1 | `4e4c8717` | REST к RouterOS переиспользует соединение, закрывает его через 2 с простоя (RouterOS держит 30 с), лимит 2 сессии на роутер сохранён | оркестратор | Низкий: замер на CHR, тесты транспорта | Утвердить | +| 2.2 | `65846441` | **Права раз на этап**: свежая проверка в начале шага, прямо перед отправкой, после ACK и перед каждой записью; чтения внутри этапа используют доказательство не старше 2 с | владелец | Отзыв прав замечается не мгновенно, а в пределах 2 с — но только для чтений; ни одна запись без свежей проверки не уходит | Утвердить | +| 2.3 | `65846441` | Параллельное чтение каталогов (не больше 2 соединений на роутер) | владелец | Низкий: порядок снимка прежний | Утвердить | +| 2.4 | `65846441` | **Отказ VRF только повторный**: отказ классификатора окончательный, если тот же отказ повторился на свежем чтении | владелец | Настоящее изменение на роутере остаётся и отклоняется на втором чтении (+2 с к отказу). Единое правило вместо точечных заплаток 1.1–1.8 | Утвердить; позже упростить 1.1–1.8 до этого правила | +| 2.5 | `65846441` | Конфликт каталога перед отправкой помечает операцию «не отправлено» (`rejected`, а не `unknown`) | оркестратор | Низкий: следует контракту `beforeDispatch` (запись не уходит) | Утвердить | +| 2.6 | `af4203d9` | Сервисы WireGuard: собственная проверка раз на этап для чтений; перед записью свежая. `assertVerifiedConfigurationReadAccess` только для чтений | владелец (как 2.2) | Как 2.2 | Утвердить | +| 2.7 | `af4203d9` | `access-generation` и отметки отзыва портала проверяются через `stat` и перечитываются при изменении файла (замена видна сразу) | оркестратор | Низкий на NTFS/ext4; на ФС с грубой точностью времени изменение в ту же секунду с тем же размером было бы не замечено | Утвердить | +| 2.8 | `171c0e61` | scoped-маршрутизация и IPsec: проверка раз на этап для чтений; сверка IPsec осталась строгой | владелец (как 2.2) | Как 2.2 | Утвердить | + +Не сделано и требует твоего решения: держать ключ шифрования в памяти процесса (ещё ~8–20 с на тяжёлых приёмках) — сейчас ключ читается с диска при каждом использовании. + +## 3. Стенд: смысл приёмки A2 (доказательство раннера) + +| # | Слой | Что | Кто решил | Риск | Рекомендация | +|---|---|---|---|---|---| +| 3.1 | v3 | Стабильная проекция `/routing/route` без полей FIB (`active`, `debug.fwp-ptr`, `nexthop-id`, …) | владелец (16.11) | — | Решено | +| 3.2 | v5 | link-маршрут интерфейса VRF принадлежит VRF | владелец (16.11) | — | Решено | +| 3.3 | v7 | FIB-внутренности динамические на своих доменах `/routing/route` только в шагах VRF | **оркестратор** | Низкий: это состояние таблицы пересылки, не конфигурация | Утвердить | +| 3.4 | v8 | Финальная сверка без полей выполнения: счётчики `/interface`, история линка, статус DHCP, счётчики fast-path, uptime BGP, netwatch, динамические сессии `/ip/service` | **оркестратор** | Низкий: конфигурационные поля сверяются строго | Утвердить | +| 3.5 | v14–v15 | Пинг при изоляции: допустимы статусы `timeout`, `net unreachable`, `host unreachable`, `no route to host` (по документации MikroTik это и есть отсутствие маршрута), у строк `net unreachable` допустимы поля `host`/`time` (роутер, приславший ICMP-ошибку); 0 ответов, 100 % потерь и GRE-контроль 3/3 строгие | **оркестратор** (по документации; в журнале помечено «требуется решение владельца») | Низкий | Утвердить | +| 3.6 | v16/v20 | Пропажа LL пустого моста при `DELETE VRF` и при PATCH членства, одно последующее появление тех же ключей | владелец | Связано с 1.5 | Решено; пересмотреть вместе с 1.5 | +| 3.7 | v17 | Окно ожидания операции 300 с | владелец | — | Решено | +| 3.8 | v26 | Стоимость 68, `mutationsPerHour` 80 | владелец | — | Решено | +| 3.9 | v28 | Проверка после записи перечитывает каждые 2 с (до 8 раз) | владелец | Низкий | Решено | +| 3.10 | v28 | **Стабильность**: принятый снимок не должен меняться ещё 2 чтения | **оркестратор** | Строже 3.9; цена ~10–15 с на запись в проверках стенда | Утвердить | +| 3.11 | v28 | Каждая попытка начинает с одного сохранённого долга допущения 3.6 | **оркестратор** (исправление ошибки) | Нет: без этого повтор ломал утверждённое допущение | Утвердить | + +## 4. Что ещё стоит знать + +- Прогоны A2 до v28 шли на backend, собранном 15.11: слои подменяли только 4 файла VRF. v28 — первый прогон на текущем продукте (21 файл подменён, связывание и сценарии проверены). +- `verifyMcpHostFiles` один раз из четырёх упал (`rejected` до отправки), причина не установлена; в тест добавлен `error_code`. +- Ожидают решения вне ревью: скачивание `autosupout.rif` с CHR1 (нужен твой OK), пункты этапа 4.