Files
crank/docs/execution-boundary.md
T
bsodfather 2219a7217d
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
feat(epic4): подтверждать durable Task после атомарного PG-commit (Story 4.2)
Application entry выдаёт Task ID только после атомарного PostgreSQL commit
Task+intent+capacity; replay/conflict, owner scope, bounded envelope,
terminal CAS и fail-closed readiness проверены на реальном PG.

Также включён принятый план перехода на rmcp (только документ, миграция не
запускается).
2026-10-27 00:09:36 +00:00

3.8 KiB

Единая граница выполнения 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.