docs(mcp): добавить документацию, аудиты вызовов и квитанции приёмки MCP

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
DenozordecandClaude Sonnet 5.5 committed 2026-11-15 20:36:15 +07:00
1 parent 531d822338
commit 1d519b1734
945 files changed
+384627

No files matched your search

+38
View File
@@ -0,0 +1,38 @@
# Общий 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).