# Исходный подробный контракт этапа 4 Снимок локального плана `_bmad-output/planning-artifacts/epics.md`. Исходная ревизия: `78dc060b8a5086b1cc7a1bec77385a0f2471fbf3`. Дата переноса: 2026-10-04. Технический текст ниже сохранён дословно, чтобы перенос не изменял обязательные критерии. Основные описания этапов и задач в Gitea написаны на русском языке. ## Epic 4: Безопасные параллельные и фоновые выполнения Пользователь запускает долгие Tools как durable Tasks, наблюдает progress, отменяет, восстанавливает после restart и разрешает `outcome_unknown` без неконтролируемого повторения side effects. ### Story 4.1: Публиковать execution mode и применять admission limits **Depends on:** Story 3.4 **Work type:** implementation **Deliverable:** Публиковать execution mode и применять admission limits. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an администратор, I want задавать synchronous, background или adaptive execution policy и bounded concurrency, So that нагрузка не разрушает систему, а клиент заранее знает доступное поведение. **Requirements:** FR-21, FR-24 **Acceptance Criteria:** **Given** Tool Draft **When** задаётся execution mode **Then** policy фиксирует `synchronous`, `background` или `adaptive`, deadline и fallback для клиента без Tasks **And** background не включается неявно для запрещающего его Tool. **Given** sync или background request **When** выполняется `ExecutionAdmission` **Then** один policy snapshot проверяет global/per-Agent/per-Tool concurrency, authorization, approval, deadline и bounded queue capacity **And** оба execution paths используют одинаковые safety gates. **Given** свободная capacity **When** request принят **Then** admission выдаёт scoped permit либо durable enqueue decision с exact Published Version semantics **And** future policy change не меняет уже принятое execution. **Given** saturation **When** лимит или queue исчерпаны **Then** request отклоняется до unbounded allocation с typed overload outcome и retry guidance **And** rejection, queue wait и oldest age записываются low-cardinality metrics. **Given** несколько Agents/Tools **When** они конкурируют за capacity **Then** documented fairness предотвращает starvation в пределах configured weights **And** один Agent не обходит global limit множеством credentials, concurrent connections или protocol revisions. **Given** mandatory safety store недоступен **When** admission не может подтвердить approval/idempotency/capacity state **Then** зависимый path fail closed и readiness отражает dependency failure **And** unsafe in-memory fallback не активируется. **Given** admission tests **When** выполняются concurrency/race/overload cases **Then** доказаны bounded queues, fairness, deadline propagation, exact policy pinning и sync compatibility **And** `just verify` проходит. ### Story 4.2: Атомарно принимать durable Tasks **Depends on:** Story 4.1 **Work type:** implementation **Deliverable:** Атомарно принимать durable Tasks. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an MCP-пользователь, I want получить устойчивый Task ID только после надёжного принятия работы, So that подтверждённая задача не теряется при crash или restart. **Requirements:** FR-22, FR-23 **Acceptance Criteria:** **Given** background admission **When** Task принимается **Then** PostgreSQL transaction сохраняет UUIDv7 Task, owner scope, pinned execution semantics, initial `queued` state и dispatch intent до acknowledgement **And** отсутствует accepted response без durable record. **Given** Task model **When** state читается **Then** доступны `queued`, `working`, `input_required`, `outcome_unknown`, `completed`, `failed`, `cancelled`, progress, timestamps, attempts и result/error **And** protocol adapter не определяет внутреннюю lifecycle semantics. **Given** Task и dispatch intent принимаются **When** transaction commit завершается **Then** Task record сохраняет отдельные Request ID, Trace ID и validated parent TraceContext независимо от sampling **And** acknowledgement возвращает те же support IDs без смешения Task/Execution identity. **Given** terminal transition **When** result commit выполняется **Then** conditional update допускает ровно один переход из разрешённого non-terminal state **And** terminal result immutable до retention expiry. **Given** crash до commit **When** request повторяется **Then** Task не считается принятым и idempotent retry безопасен **And** partial Task/dispatch state невидим. **Given** crash после commit до response **When** request повторяется с тем же scoped key/fingerprint **Then** возвращается существующий Task ID **And** duplicate Task не создаётся. **Given** тот же scoped idempotency key повторён с другим canonical input fingerprint **When** background request принимается **Then** сервер возвращает typed conflict до enqueue или outbound dispatch **And** существующие Task, dispatch intent и audit evidence не изменяются. **Given** status/result request **When** caller не владеет Agent/admin scope **Then** доступ denied/not-found без metadata leakage **And** Task payload читается только после authorization. **Given** Task envelope содержит input, progress, result/error, input schema или reconciliation metadata **When** данные валидируются перед persistence **Then** size/count/depth bounded, secret-bearing fields classified/redacted либо заменены безопасной artifact reference **And** full workspace/Agent/authorization scope входит в Task, idempotency и cache keys; foreign collision не раскрывает metadata. **Given** Task store unavailable **When** background request поступает **Then** сервер fail closed без ephemeral future **And** synchronous fallback используется только если он опубликован Tool policy. **Given** persistence suite **When** выполняются transaction/crash/replay/retention tests **Then** доказаны no-loss acceptance, immutable terminal state и scope isolation **And** migrations fresh/already-migrated и `just verify` проходят. ### Story 4.3: Исполнять Tasks через leases и fencing **Depends on:** Story 4.2 **Work type:** implementation **Deliverable:** Исполнять Tasks через leases и fencing. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an оператор, I want workers безопасно восстанавливать Tasks после сбоев, So that stale worker не перезаписывает progress или terminal outcome. **Requirements:** FR-22, FR-23 **Acceptance Criteria:** **Given** queued Tasks **When** `task-worker` claims bounded batch **Then** PostgreSQL использует `FOR UPDATE SKIP LOCKED`, lease owner/expiry и monotonic fencing token **And** Valkey может только ускорять wake-up. **Given** active lease **When** worker renews либо записывает progress/checkpoint/result **Then** update содержит current owner/token и CAS predicate **And** stale token после lease loss всегда отклоняется. **Given** claim перед outbound dispatch **When** worker готовит attempt **Then** он повторно проверяет Agent publication, exact capability version, credential, approval, deadline и capacity **And** invalidated work завершается безопасно без dispatch. **Given** worker готов перейти от проверки к outbound dispatch **When** он фиксирует начало попытки **Then** dispatch checkpoint и Attempt ID атомарно записываются под current lease owner и fencing-token CAS до сетевого вызова **And** stale worker до checkpoint не вызывает upstream, а uncertainty после checkpoint безопасно фиксируется как `outcome_unknown` без automatic retry. **Given** valid claimed attempt **When** worker продолжает выполнение **Then** он продолжает сохранённый parent trace, а каждый retry создаёт отдельный child attempt span с Attempt ID **And** TraceContext не берётся из mutable queue/cache projection и не попадает в metric labels. **Given** worker crash **When** lease expires **Then** eligible Task становится доступен recovery ≤60 секунд **And** прежний worker не может сделать terminal commit после возвращения. **Given** graceful shutdown **When** worker получает stop **Then** новые claims прекращаются, active work checkpoint-ится/сохраняется в пределах 30 секунд **And** queued Tasks не теряются. **Given** полная потеря Valkey **When** workers продолжают работу **Then** PostgreSQL-only mode сохраняет correctness с допустимым снижением throughput **And** projections восстанавливаются без duplicate terminal outcome. **Given** Task+dispatch intent committed, но process падает до Valkey wake-up **When** worker стартует либо выполняет bounded authoritative scan **Then** queued intent обнаруживается из PostgreSQL и доставляется at-least-once без ручного repair **And** отсутствие Valkey влияет только на wake-up latency, а не на loss/correctness. **Given** lease/fencing suite **When** моделируются crash, pause, partition, stale renew и concurrent claims **Then** доказаны single terminal CAS, stale-write rejection и recovery timing **And** `just verify` проходит. ### Story 4.4: Управлять retry, cancellation и outcome_unknown **Depends on:** Story 4.3 **Work type:** implementation **Deliverable:** Управлять retry, cancellation и outcome_unknown. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an MCP-пользователь, I want честно видеть результат cancellation и retry, So that Crank не повторяет внешний side effect при утраченной определённости. **Requirements:** FR-25 **Acceptance Criteria:** **Given** новый execution attempt **When** начинается dispatch **Then** attempt ID, canonical input/idempotency fingerprint и policy сохраняются до outbound request **And** retry не создаёт неучтённую попытку. **Given** retryable read либо write с verified upstream idempotency **When** attempt fails до deadline **Then** bounded attempts/backoff соблюдают policy и общий deadline **And** каждый attempt имеет отдельный child span/outcome. **Given** write без verified idempotency **When** certainty потеряна после dispatch **Then** Task переходит в non-terminal `outcome_unknown` **And** automatic retry и cancel-as-success блокируются. **Given** cancel до dispatch **When** conditional cancel побеждает claim **Then** Task становится `cancelled` без side effect **And** race result deterministic. **Given** cancel во время execution **When** cooperative cancellation подтверждена **Then** `cancelled` допустим только если cancellation победила до durable dispatch checkpoint; после dispatch write без verified idempotency Task переходит в `outcome_unknown` **And** для read/idempotent write применяется explicit policy outcome, local work прекращается по возможности и audit сохраняет фазу/certainty. **Given** deadline expiry **When** Task не завершён **Then** outcome зависит от dispatch certainty и idempotency contract **And** timeout не превращает `outcome_unknown` в ordinary failed/retryable state. **Given** lease потеряна после durable dispatch checkpoint **When** Task восстанавливает другой worker **Then** verified idempotent write допускает только bounded new attempt, а unverified write переходит в `outcome_unknown` **And** stale worker не изменяет Task, fencing защищает состояние Crank и не заявляется защитой внешней системы. **Given** retry/cancel suite **When** покрываются before/after-dispatch races **Then** доказаны at-least-once delivery, bounded retries и honest ambiguity **And** `just verify` проходит. ### Story 4.5: Продолжать Tasks через валидированный input **Depends on:** Story 4.3 **Work type:** implementation **Deliverable:** Продолжать Tasks через валидированный input. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an авторизованный пользователь, I want передавать дополнительный Task input, So that продолжаю выполнение только после schema validation и CAS. **Requirements:** FR-25 **Acceptance Criteria:** **Given** worker требует input **When** Task входит в `input_required` **Then** сохраняются versioned JSON schema, prompt metadata, TTL и update fingerprint contract **And** новый side effect не выполняется до valid update. **Given** authorized update **When** input проходит schema validation **Then** identical replay возвращает прежний outcome, conflicting replay — conflict **And** CAS переводит Task обратно в `working` ровно один раз. **Given** input TTL истёк **When** sweeper обрабатывает Task **Then** Task становится `failed` без нового dispatch **And** expiry reason сохраняется в audit. **Given** input-update suite **When** выполняются TTL/replay/conflict/scope/race tests **Then** доказаны schema validation и idempotent update **And** `just verify` проходит. ### Story 4.6: Разрешать outcome_unknown через reconciliation evidence **Depends on:** Story 4.4 **Work type:** implementation **Deliverable:** Разрешать outcome_unknown через reconciliation evidence. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an оператор, I want разрешать неизвестный outcome по evidence, So that не повторяю внешний side effect неявно. **Requirements:** FR-25 **Acceptance Criteria:** **Given** `outcome_unknown` **When** оператор предоставляет reconciliation evidence **Then** разрешены только переходы в `completed`, `failed` либо новый явно подтверждённый attempt **And** evidence immutable, bounded, redacted и связано с attempt/trace без raw secrets или произвольного payload. **Given** обычный retry/cancel request для `outcome_unknown` **When** reconciliation отсутствует **Then** request блокируется с предупреждением о side effect **And** protocol adapter не отображает состояние как retriable failure. **Given** reconciliation suite **When** выполняются replay/conflict/scope/race tests **Then** доказаны evidence-bearing transitions и запрет retry/cancel без reconciliation **And** `just verify` проходит. ### Story 4.7: Предоставить MCP Task operations и fallback **Depends on:** Story 4.4, Story 4.5, Story 4.6 **Work type:** implementation **Deliverable:** Предоставить MCP Task operations и fallback. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an MCP-пользователь, I want создавать, отслеживать, обновлять и отменять Tasks через совместимый protocol, So that background execution не зависит от одного HTTP/SSE connection. **Requirements:** FR-21, FR-22, FR-25 **Acceptance Criteria:** **Given** negotiated Task-capable revision **When** вызывается background/adaptive Tool **Then** adapter возвращает Task ID только после durable commit **And** disconnect клиента не отменяет Task. **Given** Story 4.7 активирует Tasks support **When** extension descriptor регистрируется через typed mechanism Story 3.1 **Then** `io.modelcontextprotocol/tasks` рекламируется только на совместимой enabled revision с exact method/result shapes **And** disabled либо unsupported revision не видит descriptor, Task methods или Task notifications; executable Tasks cells добавляются в общий matrix contract этой же Story. **Given** клиент negotiated extension `io.modelcontextprotocol/tasks` **When** он работает с background Tool **Then** adapter реализует применимые `tools/call`, `tasks/get`, `tasks/update` и `tasks/cancel` contracts точной negotiated revision **And** внутренние queue, lease, fencing и attempt records не становятся публичным protocol contract. **Given** клиент заявил Tasks extension для одной revision **When** он отправляет descriptor, metadata или method shape другой revision **Then** adapter возвращает revision-correct protocol error до чтения либо изменения Task **And** не угадывает wire contract и не переключает adapter молча. **Given** клиент передаёт собственный Task ID при создании background execution **When** adapter принимает `tools/call` **Then** client-chosen identifier игнорируется либо отклоняется согласно точному wire contract, а непредсказуемый ID создаёт сервер после durable acceptance **And** клиент не может занять namespace, вызвать collision или проверить существование чужой Task. **Given** Task ID **When** вызываются `tasks/get`, `tasks/update` или `tasks/cancel` **Then** каждый request заново проверяет полный workspace/Agent/key authorization scope и отображает internal state только в допустимые protocol statuses **And** `outcome_unknown` не маскируется retriable failure. **Given** MCP-клиент пытается перечислить Tasks **When** official extension не определяет `tasks/list` **Then** server не изобретает публичный method и возвращает revision-correct method-not-found **And** bounded listing остаётся отдельной Admin API/UI capability, не требуемой для завершения MCP adapter. **Given** клиент без Task capability **When** вызывается background/adaptive Tool **Then** применяется опубликованный synchronous fallback либо structured `unsupported` **And** сервер не рекламирует Task methods. **Given** Tool запрещает background **When** клиент пытается запросить Task mode **Then** request отклоняется до enqueue **And** synchronous behavior остаётся неизменным. **Given** progress/change notification **When** client negotiated support **Then** updates bounded и не являются authoritative state **And** polling/status method восстанавливает состояние после loss/reconnect. **Given** protocol suite **When** выполняются selected stable/extension adapters **Then** покрыты create/status/result/cancel/update, disconnect, auth scope и fallback **And** representative clients и `just verify` проходят. ### Story 4.8: Находить Tasks и выполнять безопасные Admin actions **Depends on:** Story 4.7 **Work type:** implementation **Deliverable:** Находить Tasks и выполнять безопасные Admin actions. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an администратор, I want находить Tasks и выполнять разрешённые cancel/retry actions, So that контролирую выполнения через безопасный UI. **Requirements:** FR-26 **Acceptance Criteria:** **Given** Tasks dataset **When** открывается UI **Then** доступны bounded filters по status, Agent, Tool, period и IDs с opaque pagination **And** loading/empty/error/stale-response states реализованы RU/EN. **Given** Task details **When** запись открыта **Then** видны Task/Execution/Request/Trace IDs, pinned version, progress, attempts, deadline и safe result/error **And** identifiers чётко различаются и копируются, а secret canary отсутствует в progress, result/error, evidence, DOM, telemetry и exported diagnostics. **Given** cancellable Task либо safely retryable failure **When** администратор подтверждает action **Then** UI вызывает conditional operation и показывает race/conflict outcome **And** destructive bulk action требует отдельного confirmation и audit. **Given** UI polling/live updates **When** workspace/filter/request generation меняется **Then** old response не перезаписывает новый context **And** listeners не дублируются. **Given** оператор открывает Tasks navigation, filters либо detail **When** он использует keyboard, back/forward, refresh или reconnect **Then** URL-addressable state, permission-aware visibility, focus restoration, semantic labels/errors и `aria-live` updates сохраняют authoritative context **And** contrast соответствует WCAG 2.2 AA, смысл не зависит только от цвета, animation уважает reduced-motion, stale response не перезаписывает новый state. **Given** Task UI suite **When** выполняется Playwright/API testing **Then** покрыты filters, lifecycle, races, bulk confirmation и localization **And** `just verify` проходит. ### Story 4.9: Предоставить Task input и reconciliation UI **Depends on:** Story 4.8, Story 4.5, Story 4.6 **Work type:** implementation **Deliverable:** Предоставить Task input и reconciliation UI. **Completion:** outcome этой story и все её AC проверены; будущая qualification не выполняется попутно. As an администратор, I want передавать Task input и выполнять reconciliation через UI, So that разрешаю ожидание и ambiguity с явным подтверждением. **Requirements:** FR-26 **Acceptance Criteria:** **Given** `input_required` **When** вводится дополнительный input **Then** form строится из versioned schema и server validates again **And** duplicate submit idempotent, conflicting stale submit видим. **Given** `outcome_unknown` **When** details открыты **Then** обычные Retry/Cancel disabled, отображается предупреждение и reconciliation flow **And** evidence/explicit new attempt требуют confirmation. **Given** UI polling/live updates **When** workspace/filter/request generation меняется **Then** old response не перезаписывает новый context **And** listeners не дублируются. **Given** оператор открывает Task input либо reconciliation flow **When** он использует keyboard, back/forward, refresh или reconnect **Then** URL-addressable state, permission-aware visibility, focus restoration, semantic labels/errors и `aria-live` updates сохраняют authoritative context **And** contrast соответствует WCAG 2.2 AA, смысл не зависит только от цвета, animation уважает reduced-motion, stale response не перезаписывает новый state. **Given** Task UI suite **When** выполняется Playwright/API testing **Then** покрыты input, reconciliation, races, confirmation и localization **And** `just verify` проходит. ### Story 4.10: Доказать Task capacity и recovery envelope **Depends on:** Story 4.9 **Work type:** qualification **Deliverable:** Доказать Task capacity и recovery envelope. **Completion:** accepted evidence всех AC на указанном build/RC и среде; harness-only и внешний handoff не являются pass. As an оператор, I want воспроизводимо проверить concurrency и recovery Tasks, So that заявленные границы подтверждены до production release. **Requirements:** FR-23, FR-24 **Acceptance Criteria:** **Given** Reference Workload background variant **When** полный versioned mix выполняет не менее 128 concurrent synchronous/background Executions и до 10 000 queued Tasks **Then** отсутствует unbounded resource growth, duplicate terminal outcome или starvation **And** Task start ≤5 s p95 при нагрузке в пределах service rate, build/config/topology и workload checksum входят в evidence. **Given** steady-state service rate **When** измеряется queue **Then** queue wait p95 ≤5 s и oldest age ≤30 s **And** saturation rejection и retry guidance корректно классифицированы. **Given** overload stopped with 10 000 backlog **When** capacity восстановлена **Then** backlog дренируется ≤60 минут без loss/duplicate terminal result **And** live metrics отражают progress. **Given** worker/service restart **When** новые claims остановлены и active workers имеют 30 s на checkpoint **Then** eligible Tasks возобновляются ≤60 s **And** stale worker terminal commit невозможен. **Given** Valkey loss и mandatory PostgreSQL/coordination failures **When** выполняется dependency matrix **Then** PG-only mode корректен, unsafe path fail closed, local readiness/dependency diagnostics и typed metrics точны **And** восстановление projections не меняет outcomes. **Given** crash/partition matrix **When** faults вводятся до/после claim, dispatch, side effect и terminal commit **Then** каждый outcome соответствует delivery/idempotency contract **And** raw results content-addressed и связаны с build/config. **Given** завершение Epic 4 **When** capacity/recovery suites проходят **Then** FR-21…FR-26 и NFR-P2/R2/R3/R5 имеют evidence **And** Capability Inventory обновлена, `just verify` успешен.