Files
MikrotikManager/docs/mcp-bandwidth-execution-host.md
T

39 lines
8.9 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.
# Общий bandwidth execution host: сборка и оставшаяся приёмка
`createBandwidthExecutionHost(deps).execute(originalContext, scope)` связывает genuine observations, resolve-only canonical registry, отдельный signed control source, SQL journal и strict native transport. [Исторический срез до полной приёмки](mcp-bandwidth-execution-host-progress-20261026.json) сохраняет первоначальные ограничения. Пользователь отдельно разрешил добавить и выполнить owned PG/HTTP helper; миграции и синтетические записи выполняются только внутри одноразового стенда. Production activation из этого разрешения не следует.
## Исходные права и реальный получатель
Trusted `readOriginal` самостоятельно подтверждает исходный human/scheduler/MCP context и текущие права на **все три** возможных ID: source, actual remote и credential provider. Эти роли различаются; credential provider не доказывает идентичность получателя. Весь исходный intent, включая expiry, command, native credentials и socket timeout, фиксируется и сравнивается при повторных проверках. Scope и actor expiry получают исходный monotonic deadline без продления при откате часов.
Trusted `verifyRemote` отдельно подтверждает точный wire address/VRF/zone и canonical receipt реального remote. Его proof идентифицирует исходную wire policy и stable subject; ephemeral observation timestamps не являются новой policy. Proof и первоначальный expiry закрепляются; замена или истечение не создают новое разрешение. Ни один публичный request не может выбирать authority/provider/transport callbacks, UUID узла или ready-флаг.
## Сроки и соединения
Короткий `preScope` — минимум caller/grant и двух текущих genuine observation TTL. Каждый короткий этап получает новые реальные observations **того же исходного subject**: claims с kind/order, sourceProof, endpoint epoch, authority generation, server ID и flags должны точно совпасть. Старые tokens не продлеваются и не используются как свежие. Original intent, actor/peer expiry и monotonic budgets, source record, canonical UUID/incarnation, client и body остаются закреплены. Endpoint HMAC связывает stable subject; свежесть подтверждается отдельными genuine capabilities. Максимум семь пар / 14 license GET на один execute, без циклов и без refresh внутри активного journal/registry lease.
Этот scope ограничивает resolve и последние проверки перед отправкой. Сам native response использует исходный caller/actor budget; после отправки пятисекундный observation TTL не превращается в новый предел длительности bandwidth. Cleanup получает отдельный ограниченный budget и исходный binding/source, без продления execute authority.
Registry session закрывается после resolve. Journal открывает отдельный короткий lease на каждую transition; подпись события использует **то же** соединение. Native response не удерживает registry/journal lease. Последняя проверка после configuration-policy SQL выполняется в `beforeDispatch`, а consume permit — перед фактическим созданием HTTP request.
`nodeSource.assertResolvedOnFence` проверяет signed bootstrap, issuer key, роли/catalog, node authority и claim/node/alias/event MAC двух участников на **существующем ephemeral physical fence**. Пятый checkout не нужен. Shared advisory transaction lock `8723116` совместим с exclusive key штатных registry mutators и удерживается до SQL COMMIT. Это блокировка SQL-транзакции, а не доказательство атомарной остановки filesystem/actor writers или socket-send barrier.
Private terminal proof связан с исходным binding и captured native response. Private no-send допустим только до вызова fixed send. После возможной отправки любой неизвестный исход сохраняет оба владельца; автоматического retry или освобождения unknown нет.
## Что действительно проверено
[Сквозная приёмка исполнителя](mcp-bandwidth-execution-host-acceptance-20261026.json): 25 actual PG-групп, включая шесть broker-сценариев, два физических localhost bandwidth POST и 58 genuine license GET. Три разных server ID, original ALL3 rights, отсутствие чтения третьих credentials при запрете, independent remote policy, отказ изменённого original subject, native response >5,3 s без удержания core leases, configuration audit, unknown/no-retry и tombstone после resolve. После этого проверен public restore восьми control-таблиц. Это компонентная приёмка на явно synthetic operator/peer authority; production providers/activation ещё отсутствуют.
- 24 actual PG-группы control source: новые bounded admission HMAC domains, original source hash, полный 8 MiB payload и immutable capture; journal durability при session `synchronous_commit=off` с восемью реальными COMMIT, каждый с `on`.
- 19 actual PG-групп node source: четыре занятых соединения с same-physical MAC verification, shared lock до COMMIT, отказ подмены claims/incarnation/source hash, сохранение восьми control-таблиц при public restore.
- 13 genuine observation-групп: same-reader strict client без выдачи endpoint через request, отказ fake/copy/expired/source drift; отсутствие SQL/HTTP для unadmitted bandwidth.
- Полный speed-workflow, strict types, lint и backend build. Эти проверки не заменяют terminal acceptance нового execution host.
## Что ещё требуется
Owned PG/HTTP-приёмка включает три отдельных ID, real configuration audit, response дольше пяти секунд с четырьмя свободными core leases, remote/third-ID denial, отказ изменённого subject в новом настоящем наблюдении, dropped response → unknown и отсутствие повтора занятой пары. Первоначальный отказ automatic review на создание helper снят отдельным прямым разрешением пользователя; helper добавлен и выполняется только на одноразовом стенде. Неудачные начальные прогоны сохранены: collision serial ID двух тестовых DB исправлена отдельным диапазоном fixture ID, короткие scopes разделены по genuine фазам без снятия provenance checks.
Предложение удалить повторный `session.binding()` в authorizer было отклонено automatic review и **не применялось**. Все эти проверки сохранены. Независимый review нового механизма genuine фаз не нашёл конкретного ослабления original subject/expiry/source/peer binding.
После приёмки нужны реальные providers исходного контекста/peer policy, genuine operator enrollment и общий writer/quiescence barrier; затем перевод всех REST/scheduler/MCP callers на broker, полный after-ping/history/error workflow и public MCP-приёмка. Production getter/активация и новый публичный speed-tool пока отсутствуют. [Полный остаток плана](mcp-remaining-work-20261026.md).