From 1682b791ab3f643934b94ceb56bffd798d17f7e5 Mon Sep 17 00:00:00 2001 From: Adrian Webb Date: Thu, 8 Oct 2026 17:16:57 -0400 Subject: [PATCH] Record approved terminal recovery with explicitly unresolved usage --- docs/agent-architecture.md | 2 ++ docs/agent-assignments.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/docs/agent-architecture.md b/docs/agent-architecture.md index e521b7b0..ae321dc0 100644 --- a/docs/agent-architecture.md +++ b/docs/agent-architecture.md @@ -403,6 +403,8 @@ Provider arbitration compares eligible teams globally so one busy team cannot mo Charge actual attempt seconds, including failures and retries, and settle each attempt exactly once. Provider-native usage remains separate from fairness seconds. +When terminal execution evidence exists but the original active measurement is irrecoverably unavailable, a team-management-authorized operator may recover the held assignment reservation using its exact state version, a reason, and an idempotency key. Verify native workspace closure first. Retain the expired assignment, result, failure and provider evidence unchanged; record usage explicitly as unresolved in the existing audit. Release only terminal concurrency claims and retain period-budget claims until actual consumption is known. This is not a zero charge, successful UsageSettlement, passing result, or permission to declare the workday accepted. Never reconstruct usage from elapsed time or refresh the original lease. + ## Implementation Checklist ### Phase 1 — Profiles and contracts diff --git a/docs/agent-assignments.md b/docs/agent-assignments.md index 360aa59e..8f8a1500 100644 --- a/docs/agent-assignments.md +++ b/docs/agent-assignments.md @@ -266,6 +266,8 @@ An assignment is an immutable attempt to execute one node revision. It freezes: The actor and reviewer assignments reserve and settle their own accepted estimates and actual usage. Work-item usage is the derived sum of those attempts. Failure, return, retry, or review rejection creates another attempt against an advanced node revision. Existing assignments are never rewritten. +An explicitly authorized operator recovery may release a terminal assignment's held reservation when its active usage cannot be reconstructed. The existing audit must retain an unresolved-usage disposition with exact version, actor, reason and idempotency identity; no measurement or successful settlement may be invented. Native workspace closure is required before release, terminal concurrency is released once, and period-budget claims remain held. The original assignment, report and failure history remain unchanged and unaccepted; this recovery does not make a failed workday pass. + ### Assignment result Use one result contract: