CI / UI Checks (pull_request) Successful in 8s
CI / Rust Checks (pull_request) Successful in 19m34s
CI / Rust Feature Validation (pull_request) Skipped
CI / Frontend E2E (pull_request) Skipped
CI / Community Image Smoke (pull_request) Skipped
CI / Required Checks (pull_request) Successful in 1s
CI / Deploy (pull_request) Skipped
Application entry выдаёт Task ID только после атомарного PostgreSQL commit Task+intent+capacity; replay/conflict, owner scope, bounded envelope, terminal CAS и fail-closed readiness проверены на реальном PG. Также включён принятый план перехода на rmcp (только документ, миграция не запускается).
54 lines
3.8 KiB
Markdown
54 lines
3.8 KiB
Markdown
# Единая граница выполнения REST Operation
|
||
|
||
Admin Draft Test и MCP `tools/call` используют один путь:
|
||
|
||
`RuntimeExecutionRequest → crank-runtime → ProtocolAdapter → crank-adapter-rest`.
|
||
|
||
До mapping и сетевого dispatch envelope фиксирует workspace, origin, точную
|
||
Operation/version, Agent для immutable snapshot, authorization, resolved auth,
|
||
correlation context и монотонный deadline. Runtime не создаёт fallback Request ID
|
||
или Trace ID. `admin_draft` не принимает Agent ID, а `agent_snapshot` требует его.
|
||
|
||
## Результат и ошибки
|
||
|
||
Успешный результат — нормализованный JSON output. Ошибка один раз преобразуется
|
||
в закрытый `ExecutionFailure`: `error_code`, `stage`, `retryability`,
|
||
`outcome_certainty`, безопасные Request/Trace IDs и ограниченный typed context.
|
||
Admin и MCP лишь проецируют этот descriptor в свои wire-ответы.
|
||
|
||
`retryability` принимает `never`, `safe`, `after_delay`, `manual_reconcile` или
|
||
`requires_confirmation`. При timeout/transport cancellation после возможного
|
||
dispatch возвращается `manual_reconcile + outcome_unknown`; автоматически
|
||
повторять такой вызов нельзя. HTTP/MCP status и текст ошибки не меняют это решение.
|
||
|
||
Raw URL, upstream body/headers, parser/Reqwest/SQLx error и секреты не входят в
|
||
ответ или Invocation History. Resolved auth и confirmation token имеют redacted
|
||
`Debug` и не сериализуются как execution envelope.
|
||
|
||
## История и совместимость
|
||
|
||
Migration v5 (`execution-outcome-v5`) добавляет nullable поля exact Operation
|
||
version, stage, stable error code, retryability и certainty. Для legacy v4 строк
|
||
они остаются `NULL`; значения не фабрикуются. Новые Admin/MCP записи сохраняют
|
||
их вместе с Request ID и Trace ID независимо от telemetry sampling.
|
||
|
||
Пути Admin API, MCP methods и успешные response fields не изменены. Поля ошибки
|
||
добавлены обратно совместимо. Outbound DNS/redirect/retry/SSRF policy принадлежит
|
||
Story 1.9 и этой границей не считается завершённой.
|
||
|
||
## Durable background Task (Story 4.2)
|
||
|
||
Принятие фоновой работы идёт через `TaskApplication → crank-runtime::TaskService →
|
||
TaskStore`. PostgreSQL-реализация выполняет одну транзакцию: Task, dispatch intent
|
||
(`execution_admission_entries.task_id`) и queue slot коммитятся вместе, и только
|
||
после commit выдаётся ack с Task ID/поддержкой Request/Trace/parent TraceContext.
|
||
Повтор того же полного scoped key возвращает сохранённую Task, другой canonical
|
||
input fingerprint — типизированный конфликт; явная другая published-версия при том
|
||
же ключе не перезакрепляет уже принятую работу. Owner-скоуп (workspace, Agent/admin,
|
||
authorization scope) входит в каждый read; чужой Task неотличим от отсутствующего.
|
||
|
||
Границы этой story: публичный MCP wire Tasks/capabilities/activation остаётся
|
||
Story 4.7, worker/leases/recovery — Story 4.3. Существующий `tools/call` сохраняет
|
||
synchronous/unsupported поведение; durable acceptance не запускает ephemeral
|
||
execution и не рекламирует клиенту background capability.
|