From 7895e518555be50e269c4e49b76bd23f3ac96406 Mon Sep 17 00:00:00 2001 From: Denozordec Date: Fri, 20 Nov 2026 02:54:37 +0700 Subject: [PATCH] =?UTF-8?q?chore(docs):=20=D1=80=D0=B0=D0=B7=D0=B1=D0=BE?= =?UTF-8?q?=D1=80=20=D0=BE=D1=87=D0=B5=D1=80=D0=B5=D0=B4=D0=B8=20POLL=20?= =?UTF-8?q?=D0=B8=20=D0=BF=D1=80=D0=B0=D0=B2=D0=B8=D0=BB=D0=BE=20=D0=BF?= =?UTF-8?q?=D1=80=D0=B0=D0=B2=20=D0=BE=D0=BF=D1=80=D0=BE=D1=81=D0=B0=20?= =?UTF-8?q?=D0=B2=20=D0=BF=D0=BB=D0=B0=D0=BD=D0=B5=20B?= 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 | 2 ++ docs/mcp-stand-run-b-plan.md | 8 ++++++++ 2 files changed, 10 insertions(+) diff --git a/docs/mcp-decisions-review-20261119.md b/docs/mcp-decisions-review-20261119.md index 1ec3b23a..2a9ccb93 100644 --- a/docs/mcp-decisions-review-20261119.md +++ b/docs/mcp-decisions-review-20261119.md @@ -31,6 +31,8 @@ RouterOS меняет link-local адреса (LL), connected-маршруты f | 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 | Утвердить | +| 2.9 | (2026-11-19) | Опрос `servers.poll`: права свежие в начале этапа, перед каждой отправкой на RouterOS и перед `COMMIT` каждой пишущей транзакции данных приложения или DDL; журнал опроса и чтения — доказательство не старше 2 с. **Отличие от 2.2:** свежая проверка не перед каждым SQL-оператором записи и не после ACK, а перед `COMMIT`, который делает данные действующими (DDL транзакционный); журнал (учёт хода) — в окне 2 с, записи журнала MCP сами проверяют подключение и учётные данные в SQL | владелец (вариант 3 и «проверок ещё меньше»); формулировка правила — оркестратор | Отзыв, пришедший посреди транзакции, остановит её на `COMMIT`; изменения данных, DDL и отправки на RouterOS после отзыва не проходят; запись журнала о уже выполненном чтении может пройти в пределах 2 с. Проверок допуска за прогон в 112 раз меньше, операция в 6 раз быстрее | Утвердить | +| 2.10 | (2026-11-19) | Воркер разбирает очередь архивов POLL, пока писатель свободен (вариант 1); вариант 2 отклонён после чтения кода (см. план B) | владелец (1), оркестратор (отказ от 2) | Низкий: каждый архив — прежний двухтранзакционный цикл; уступает ждущему опросу | Утвердить | Не сделано и требует твоего решения: держать ключ шифрования в памяти процесса (ещё ~8–20 с на тяжёлых приёмках) — сейчас ключ читается с диска при каждом использовании. diff --git a/docs/mcp-stand-run-b-plan.md b/docs/mcp-stand-run-b-plan.md index 621c50de..01310827 100644 --- a/docs/mcp-stand-run-b-plan.md +++ b/docs/mcp-stand-run-b-plan.md @@ -185,6 +185,14 @@ Любое исправление уводит прогон B с `7848e38a`: перед базовым снимком 1.3 нужно переразвернуть `mmapp-test` на новую сборку и повторить числа cold143. +### Решение владельца (2026-11-19): варианты 1, 2 и 3 — что сделано + +- **Вариант 1 сделан.** Воркер вызывает `drainCompletedServerPollStorage` (`server-poll-terminal-compaction.ts`): прежний цикл «заявка → публикация» повторяется, пока писатель свободен, не дольше 20 с и не больше 64 архивов за тик; одиночный `compactCompletedServerPollStorage` и все его проверки не менялись. Каждый цикл заново берёт писателя через `pg_try_advisory_lock_shared`, поэтому опрос, уже ждущий исключительную блокировку, останавливает разбор (проверено на PostgreSQL). Тесты: модульный (повторный захват на цикл, остановка при занятом писателе), на PostgreSQL — очередь из трёх источников уходит за один вызов и за один тик, разбор уступает ждущему исключительному запросу, ёмкость 336 по-прежнему проходит. +- **Вариант 2 не сделан** (после чтения кода): почти все стадии тика (восстановление, хранение, компакция, снятие, сбор) требуют того же писателя и во время опроса всё равно отступили бы — выигрыша нет; а две стадии без него вредны: обнаружение дрейфа берёт `withConfigMutationLock`, которую опрос держит по всем серверам до 180 с (`server-poll-production.ts:156`, тик повис бы), профили маршрутизации пишут на роутеры. +- **Вариант 3 сделан, затем по просьбе владельца («проверок должно быть ещё меньше») сокращён ещё.** Итоговое правило для опроса: свежая проверка прав в начале каждого этапа (`prepare`/`execute`/`readExisting`), перед каждой отправкой на RouterOS и прямо перед `COMMIT` каждой пишущей транзакции, меняющей данные приложения или DDL (обслуживание разделов, публикация результатов); одна проверка на всю такую границу. Журнал опроса (учёт хода уже разрешённой операции) и чтения используют доказательство не старше 2 с; записи журнала MCP при этом сами проверяют подключение, учётные данные и область в SQL своей транзакции (`server-poll-journal.ts:104–111`). Отказ не переиспользуется. Точки: `server-poll-durable-session.ts` (кеш по набору серверов, сброс в начале этапа), `freshPollAuthority` в `server-poll-storage.ts`, `COMMIT` пишущей транзакции в аренде разделов и в запасной транзакции, `beforeDispatch` отправки на RouterOS. Функция допуска только читает (`BEGIN READ ONLY … ROLLBACK`); с задержкой до 2 с вне свежих границ замечаются: статус/режим/область/срок подключения, права, поколение доступа, защиты, каталог серверов, отзыв портала. +- **Замеры (Windows, локально), холодный опрос cold143.** Настоящих проверок допуска: ~3 700 → 32. Время самой операции (план → одобрение → применение → итог): 19,9 → 3,2 с (весь тест вместе с запуском приложения 27,5 → 6,8 с). SQL-запросов 62 783 → 2 272. Числа 143/22/54/4/151 прежние. Профиль CPU: собственная работа опроса теперь мала, остаток — ожидание PostgreSQL (полные перечитывания контекста перед эффектами ~0,8 с — защита от смены конфигурации, не трогалась — и сами DDL ~1 с). Тест устойчивого опроса: проверок за прогон 17 108 → 152 (в тест добавлена граница 300). Новый тест: отзыв прав при удержанных чтениях RouterOS — опрос отклоняется, после отзыва нет ни одного `COMMIT` обслуживания или публикации и нет итога, каждый дошедший до RouterOS запрос был разрешён и записан в журнал до отзыва (журнал самих чтений может записаться в пределах 2 с). +- **Длительность B2 пока не обещается**: ускорение 2,9× получено на Windows. Время операции на VPS измерить на этапе П1 до запуска B2. + ## Прогон B2 по часовым этапам B2 остаётся **одним непрерывным прогоном** (перезапуск посреди B2 по плану даёт `failed`/`unknown`, а отдельно запускаемые куски меняли бы критерий). Часовые этапы — это контрольные точки с решением «продолжать / остановить» по числам из `support.py monitor` (опрос не чаще раза в 10–15 минут, VPS не нагружается). Подготовка и B1 идут до B2.