codex-workflow-v2 2.0.0-beta.11 → 2.0.0-beta.12.1

package/docs/autonomy-guardrails.md

@@ -55,39 +55,47 @@ into the mutation actor slot.
 Invalid or stale review sidecars fail closed. The workflow blocks downstream acceptance and
 normal continuation when review evidence is malformed, unverified, or commit-mismatched.
 
-## Repeated failed review and remediation breaker
-
-The first failed independent review returns the Task to `needs_fix` and requires a changed or
-new remediation Step. After two distinct failed-review attempts, `next` returns
-`task plan-set with independent corrective audit`. Another Plan requires a JSON audit:
-
-```json
-{
-  "auditor": "corrective-auditor",
-  "summary": "The corrective Step covers the latest findings without changing the Brief.",
-  "decision": "continue-fix",
-  "reviewedFindingIds": ["REV-001", "REV-002"]
-}
-```
-
-Apply it with `task plan-set --corrective-audit-file <file>` only for the `continue-fix`
-path. The Auditor must differ from the failed-review author and cover every latest finding.
-`replan-required`, `split-required`, and `stop-escalate` are stop decisions: Core does not
-start another implementation loop.
-
-For guarded Steps, remediation attempts are also tracked in
-`remediation-events.jsonl`. Two ordinary remediation attempts are allowed. A third ordinary
-retry is blocked until `task corrective-decision` records a current corrective decision in
-`corrective-decisions.jsonl`. The corrective gate is derived from the guarded Step, current
-Plan Risk Audit, remediation history, and corrective-decision history, so it remains visible
-after content-only context refresh, Task Knowledge rebind, and reauthorization. `continue-fix`
-allows bounded continuation; `replan-required` requires an actual new Plan posture before
-execution; the other decisions stop or redirect ordinary execution. If that third, corrective
-remediation review also fails, Core enters a hard stop: `next` must report the stop without
-throwing, a fourth run and another `continue-fix`/`replan-required` decision are rejected,
-and only `split-required` or `stop-escalate` may be recorded. At the corrective boundary,
-`next` derives a distinct `agent:corrective-auditor:<task-id>` actor; selecting that actor is
-not a human approval, while auditor independence remains mandatory.
+## Repeated failed review and continuable remediation
+
+A failed final Task review returns the same Task to `needs_fix` and requires a changed or new
+remediation Step. The failed-review count is diagnostic evidence, not a lifecycle limit: another
+Plan does not require a separate corrective Plan Auditor merely because two or more reviews failed.
+Every replacement Plan must preserve the Task objective, requirements, and acceptance; changing
+those commitments requires an explicit scope decision outside ordinary remediation.
+
+For guarded Steps, every failed review is recorded in `remediation-events.jsonl`. Attempts one and
+two retain mode `ordinary`; later attempts use mode `corrective`, but the mode does not impose a
+maximum attempt ordinal. `next` continues to return `task run` for the same failed Step, and every
+new completion still requires a fresh strict review bound to its exact commit. Therefore repeated
+fixes cannot create an approval, while a fourth, tenth, or later reviewed attempt remains possible.
+
+Each failed review finding may carry `route: fix` or `route: replan`. `fix` is the backward-compatible
+default. `replan` is accepted only with `planConflict.planClause`, `whyFixCannotFit`, and
+`minimalPlanChange`; Core retains that evidence in the hash-chained Step-review event and routes
+the failed Step to `task plan-set`. Replan may change implementation Steps only. Explicit historical
+`continue-fix`, `replan-required`, `split-required`, and `stop-escalate` decisions remain readable;
+an explicit split or stop still outranks ordinary execution except for the narrow beta.11
+attempt-four stop compatibility route below.
+
+### Human-confirmed beta.11 attempt-four stop compatibility
+
+Beta.12.1 can resume one historical shape that beta.11 stopped mechanically: the same failed
+guarded Step has exactly two `ordinary` remediation events, one `corrective` third event, an exact
+attempt-3 `continue-fix` decision, and an attempt-4 `stop-escalate` decision under the unchanged
+Plan. Fresh `next` advertises `task stop-override-prepare` only for that shape and only on a clean
+local Task branch with no Step in progress, writer lease, Task transaction, or Core operation.
+
+Preparation is read-only and binds Task revision, Step, both corrective decisions, all three
+remediation events, Plan hash, Git HEAD, package version, actor, and reason to an `SOO-*`
+confirmation code. In a later explicit user turn, invoke `task stop-override-apply` with the same
+inputs and code. Apply appends `stop-escalate-overrides.jsonl`; it never deletes or rewrites the
+original stop. A stale binding, wrong code, duplicate/conflicting override, or damaged hash chain
+fails before continuation. Delegation is not accepted for this Human gate.
+
+This is not a general stop reversal. It does not apply to `split-required`, Plan drift, a different
+attempt ordinal, missing attempt-3 continue authority, or an agent-authored semantic stop outside
+the beta.11 policy shape. After a valid append, attempt four returns to the normal `task run` then
+strict-review cycle; review quality and all later corrective decisions remain unchanged.
 
 ### First-failure Plan-integrity recovery
 
@@ -108,7 +116,8 @@ The recovery appends one hash-bound `replan-required` decision for attempt ordin
 the worktree and does not edit the Plan. A claimed C1 Task must present its current writer token and
 then follow `task corrective-yield`; the replacement Plan still requires the existing independent
 validation, Risk Audit, Human confirmation, journaled execution, readback, and renewed execution
-authorization. Other check failures retain the ordinary two-attempt breaker.
+authorization. Other check failures use the normal continuable remediation route; they do not
+receive the narrow Plan-integrity shortcut, but attempt count alone never stops them.
 
 ## Atomic context refresh
 

package/docs/decisions.md

@@ -64,10 +64,11 @@ This document closes the requirement gaps identified during the V2 design review
     fails closed without changing persisted Task state. This changes navigation and
     diagnostics only; state schema 2 and protocol 1 remain unchanged.
 12. **Autonomous correction guardrail.** The initial Plan must make migration,
-    concurrency, restart/replay, crash-window, and provider risks visible. After two failed
-    independent reviews, another corrective Plan requires a distinct Auditor covering every
-    latest finding. The audit is append-only artifact evidence; no Task state field or schema
-    change is required.
+    concurrency, restart/replay, crash-window, and provider risks visible. Repeated failed reviews
+    do not impose an attempt-count stop: findings default to a same-Task fix and may request replan
+    only with exact Plan-conflict evidence. Attempts after the second are marked corrective for
+    diagnosis, remain executable, and require another strict review. Explicit split/stop decisions
+    remain append-only authority and are never inferred from the counter.
 13. **Content-only context refresh.** A delegate may compose reconcile, approval, knowledge
     rebind, and execution reauthorization only when the approved source classification is
     identical and only content hashes changed. Core validates both delegated transitions

package/docs/delegated-approval.md

@@ -191,10 +191,11 @@ Plan-declared supporting additions допустимы только когда и
 изменении source set, category/authority, gaps или conflicts используй обычный видимый процесс.
 
 После submit запусти отдельный Independent Reviewer; Reviewer не использует
-grant и не исправляет код. После второго failed review не запускай очередной
-патч: получи отдельный corrective Plan audit, охватывающий все последние findings,
-и передай его через `--corrective-audit-file`. Продолжай только при
-`decision=continue-fix`; остальные решения верни пользователю/координатору.
+grant и не исправляет код. Failed review возвращает ту же Task в remediation: добавь или измени
+remediation Step и снова проведи review. Количество failed reviews не требует отдельного
+corrective Plan audit. Для каждого finding Reviewer использует `route=fix` по умолчанию;
+`route=replan` допустим только с точным Plan clause, доказательством невозможности обычного fix и
+минимальным изменением Plan. Objective, requirements и acceptance через remediation не меняются.
 Final acceptance делай
 только при exact task.final_accept option для DGR-ID, затем штатный merge.
 Если option отсутствует, grant истёк, scope не совпал или требуется смысловое

package/docs/development-flow.md

@@ -83,12 +83,13 @@ to be repeated before merge.
 The Technical Planner performs a risk review before authorization. Migration work includes a
 populated forward-upgrade check; concurrent state includes deterministic races; restart,
 replay, and crash claims include restart/crash-window evidence; provider work includes
-failure injection and hidden-default verification. After two failed independent reviews,
-another Plan requires a distinct corrective Auditor and `--corrective-audit-file`. Only a
-`continue-fix` audit may continue; replan, split, and stop decisions return to coordination.
-For guarded remediation, a third ordinary retry is blocked until a current
-`task corrective-decision` exists for the same Step and Plan binding. If that corrective
-attempt fails review, the third failure is a hard stop and no fourth run is permitted.
+failure injection and hidden-default verification. Repeated failed reviews remain on the same
+Task. They require a new remediation Step for final Task review, or another implementation and
+fresh strict review for a failed guarded Step; they do not require a separate corrective Auditor
+based only on attempt count. Guarded attempts above two are recorded as `corrective` and remain
+executable. A reviewer routes to `replan` only with an exact Plan obstruction and minimal Plan
+change; ordinary findings default to `fix`. Remediation cannot change the Task objective,
+requirements, or acceptance.
 
 One bounded exception avoids a deliberately repeated failure for an older authorization without
 P01-A evidence or a contradiction that becomes observable only after execution starts. If the first guarded check failure

package/docs/lifecycle/state-machine-stabilization.md

@@ -266,7 +266,7 @@ The explorer must be exhaustive over semantic classes, bounded over cardinality,
 | Actor | human, valid delegate, claimant, other |
 | Lease | none, valid-owned, valid-other, stale |
 | Attempts | 0, 1, 2, 3+ |
-| Corrective posture | none, decision-needed, continue-fix, replan, split, stop, hard-stop, recovery-needed |
+| Corrective posture | none, automatic-continue, explicit continue-fix, replan, split, stop, recovery-needed |
 | Knowledge binding | active, stale, awaiting approval, conflicting |
 | Git | clean-bound, clean-diverged, dirty, malformed |
 | Authorization | absent, current, stale, superseded |

package/docs/pdf/sources/codex-workflow-v2-architecture-ru.md

@@ -1,10 +1,10 @@
 ---
-title: Codex Workflow V2: архитектура beta.11
+title: Codex Workflow V2: архитектура beta.12.1
 subtitle: Источники истины, lifecycle, роли, delegation, зависимости Tasks и границы доверия
 part: Часть 1 из 3 | Архитектура
 document_version: 2.0
-date: 24 августа 2026
-subject: Архитектура и границы Codex Workflow V2 beta.11
+date: 27 августа 2026
+subject: Архитектура и границы Codex Workflow V2 beta.12.1
 ---
 
 # 1. Назначение и граница системы
@@ -18,7 +18,7 @@ Codex Workflow V2 - локальный state machine поверх Codex App, Git
 Система рассчитана на одного пользователя и одну машину. Она не предоставляет distributed locking,
 криптографическую идентификацию actor string или безопасную синхронизацию state между компьютерами.
 
-## 1.1. Что beta.11 гарантирует
+## 1.1. Что beta.12.1 гарантирует
 
 - exact project-local npm package и совместимый handshake до lifecycle действий;
 - Discovery до materialization Task или Milestone;
@@ -30,7 +30,7 @@ Codex Workflow V2 - локальный state machine поверх Codex App, Git
 - state-bound human gates либо ранее выданные bounded delegation contracts;
 - journaled recovery для составных переходов и fail-closed поведение при drift/corruption.
 
-## 1.2. Что beta.11 не гарантирует
+## 1.2. Что beta.12.1 не гарантирует
 
 - правильность продуктовой идеи или автоматически выбранного provider Task;
 - semantic sufficiency Plan, если точные факты нельзя доказать поддерживаемым analyzer;
@@ -213,9 +213,21 @@ execution-authorized Plan и покрытое тем же Milestone Autonomy Con
 3. Reviewer возвращает закрытый schema-valid result без mutations.
 4. Core записывает его только если packet и seals не изменились.
 
-После двух failed review отдельный Corrective Auditor выбирает `continue-fix`, `replan-required`,
-`split-required` или `stop-escalate`. Continue разрешает один bounded corrective attempt; последующий
-failure создаёт hard stop.
+Failed review не ограничивает число попыток. Попытки 1-2 имеют mode `ordinary`, последующие —
+`corrective`; все исполнимы и требуют нового strict review. `route=fix` продолжает Task, а
+`route=replan` допустим только с точным Plan conflict и меняет лишь implementation Steps, не objective,
+requirements или acceptance. Explicit `split-required` и `stop-escalate` остаются stop/redirect decisions.
+
+Beta.12.1 добавляет только одну append-only compatibility оговорку: beta.11 attempt-four
+`stop-escalate` после exact `ordinary, ordinary, corrective` и prior attempt-3 `continue-fix` можно
+возобновить через read-only `stop-override-prepare` и отдельный Human-confirmed
+`stop-override-apply`. Исходный stop сохраняется, `split-required` не подходит, а stale revision,
+Plan, HEAD, lease, transaction или повреждённая chain блокируют переход. Попытка 4 снова проходит
+обычный `task run` и новый strict review.
+
+Dependency-provenance recovery beta.12.1 также сохраняет ранее закоммиченные Task-local поля
+manifest/lock, даже если base их не содержит. Candidate остаётся dependency-only: после удаления
+только Workflow dependency parent и HEAD обязаны совпасть по всем product-owned полям.
 
 beta.11 `task plan-integrity-recover` существует для одного первого checks-failed legacy/late case:
 отсутствует exact root npm script и текущий Step не может изменить package.json. Recovery не меняет
@@ -226,7 +238,7 @@ worktree или Plan и не создаёт synthetic second failure; он за
 # 10. Operational checklist
 
 - exact package version установлен, bundled gateway соответствует release и переустановлен;
-- handshake подтверждает protocol 2, state schema 2 и beta.11 capabilities;
+- handshake подтверждает protocol 2, state schema 2 и beta.12.1 capabilities;
 - каждый mutation следует свежему `status -> next` и exact option contract;
 - semantic unknowns и human gates не маскируются delegation;
 - Task chats создаёт coordinator, credentials остаются только в памяти;

package/docs/pdf/sources/codex-workflow-v2-chat-only-guide-ru.md

@@ -1,13 +1,13 @@
 ---
 title: Codex Workflow V2: delegated chat-only guide
-subtitle: Актуальный beta.11 путь от нового Discovery до принятого Milestone без ручного CLI
+subtitle: Актуальный beta.12.1 путь от нового Discovery до принятого Milestone без ручного CLI
 part: Часть 2 из 3 | Практика
 document_version: 2.0
-date: 24 августа 2026
-subject: Практическое руководство по delegated Discovery и Milestone в Workflow V2 beta.11
+date: 27 августа 2026
+subject: Практическое руководство по delegated Discovery и Milestone в Workflow V2 beta.12.1
 ---
 
-# 1. Рабочая модель beta.11
+# 1. Рабочая модель beta.12.1
 
 Пользователь работает в одном Codex Project и формулирует продуктовый outcome. Coordinator выполняет
 CLI, создаёт отдельные Task/Reviewer chats и ведёт supervision loop. Workflow Core остаётся authority
@@ -40,7 +40,7 @@ Blocking unknown, scope change, grant issuance или unrecoverable integrity co
 # 2. Подготовка проекта перед новым Discovery
 
 1. Убедитесь, что checkout чистый и выбран правильный repository root.
-2. Установите beta.11 как точную devDependency после публикации release.
+2. Установите beta.12.1 как точную devDependency после публикации release.
 3. Обновите и переустановите bundled `codex-workflow-gateway` этого release.
 4. Проверьте, что declared и installed package versions равны.
 5. Запустите новый Coordinator chat, не fork старого Milestone conversation.
@@ -56,7 +56,7 @@ AGENTS.md
 -> doctor только как дополнительная диагностика
 ```
 
-Handshake beta.11 должен сообщать `packageVersion=2.0.0-beta.11`, `protocolVersion=2`,
+Handshake beta.12.1 должен сообщать `packageVersion=2.0.0-beta.12.1`, `protocolVersion=2`,
 `stateSchemaVersion=2`, dependency DAG, initial Plan transaction, mechanical feasibility,
 Milestone autonomy и structural replacement disabled capabilities.
 
@@ -116,7 +116,7 @@ delegate, scope, transitions и expiry. DGR передаётся только е
 ```text
 НОВЫЙ COORDINATOR CHAT
 
-Проведи новый Milestone через Codex Workflow V2 beta.11 в delegated режиме.
+Проведи новый Milestone через Codex Workflow V2 beta.12.1 в delegated режиме.
 Repository: <ABSOLUTE-REPOSITORY-ROOT>.
 Milestone ID: AUTO.
 Delegate actor: agent:milestone-coordinator.
@@ -282,7 +282,7 @@ Knowledge Map approval path. Milestone grant не разрешает standalone
 |---|---|
 | Guarded Step review | `step-review-packet` -> новый Reviewer chat -> `step-review-record` |
 | Submitted Task review | `review-packet` -> новый Final Reviewer chat -> `review-sealed-record` |
-| Corrective audit | Отдельный read-only Corrective/Plan Audit chat |
+| Explicit corrective disposition (если выбран) | Отдельный read-only Corrective/Plan Auditor chat; не attempt-count gate |
 
 Reviewer получает неизменённый packet, проверяет exact commit/diff/evidence и возвращает closed JSON.
 Task chat записывает его только при совпадении packet и repository seal hashes. Reviewer не исправляет код,
@@ -293,11 +293,12 @@ Task chat записывает его только при совпадении p
 | Состояние | Действие |
 |---|---|
 | First proven impossible npm check после legacy/late authorization | Только рекламируемый `task plan-integrity-recover` |
-| Два failed guarded reviews | Separate Corrective Auditor и exact decision route |
-| `continue-fix` | Один bounded corrective attempt |
-| `replan-required` | Corrective yield, human-confirmed journaled replan |
+| Failed guarded review | Та же Task: исправление и новый strict review без attempt hard stop |
+| Finding `route=fix` | Продолжить тот же Step; count остаётся диагностикой |
+| Finding `route=replan` с exact Plan conflict | `task plan-set`, меняются только implementation Steps |
 | `split-required` | Stop: `STRUCTURAL_REPLACEMENT_REQUIRED`, никаких replacement writes |
-| `stop-escalate` или third corrective failure | Terminal hard stop и user attention |
+| Exact beta.11 attempt-four `stop-escalate` | Только advertised prepare, затем отдельный Human-confirmed apply; исходный stop сохраняется |
+| Любой другой explicit `stop-escalate` | Terminal user attention |
 | Stale dependency binding | Новый handoff/claim только по fresh `next` |
 | Review seal drift | Discard review и создать fresh packet |
 
@@ -321,7 +322,7 @@ Task/project DGR. `dependencyBinding` для standalone handoff равен null.
 
 # 14. Итоговый checklist пользователя
 
-- beta.11 exact package и новый bundled gateway установлены;
+- beta.12.1 exact package и новый bundled gateway установлены;
 - новый Coordinator chat не является fork старого Milestone;
 - bootstrap DGR, если нужен, выдан отдельным exact human confirmation;
 - Discovery не materialized при blocking unknowns;
@@ -330,5 +331,6 @@ Task/project DGR. `dependencyBinding` для standalone handoff равен null.
 - Coordinator сам создаёт и supervises Task/Reviewer chats;
 - credentials не появились в prompts, reports или files;
 - каждый transition пришёл из fresh `next`;
+- beta.11 stop override, если рекламировался, прошёл отдельные prepare и user-confirmed apply без journal rewrite;
 - split-required остановился без replacement mutations;
 - Milestone validation и final acceptance связаны с текущим clean base HEAD.

package/docs/pdf/sources/codex-workflow-v2-technical-reference-ru.md

@@ -1,10 +1,10 @@
 ---
-title: Codex Workflow V2: технический справочник beta.11
+title: Codex Workflow V2: технический справочник beta.12.1
 subtitle: Protocol 2, state schema 2, transactions, credentials, dependency authority, review и recovery
 part: Часть 3 из 3 | Technical reference
 document_version: 2.0
-date: 24 августа 2026
-subject: Технический контракт Codex Workflow V2 beta.11
+date: 27 августа 2026
+subject: Технический контракт Codex Workflow V2 beta.12.1
 ---
 
 # 1. Runtime contract
@@ -13,9 +13,9 @@ Workflow V2 предоставляет локальные revisioned transitions
 и `value` либо структурированную ошибку с `code`, `message` и `details`. Chat, PDF и gateway не создают
 authority сами: mutating permission определяется runtime state и свежим `next`.
 
-| Параметр beta.11 | Значение |
+| Параметр beta.12.1 | Значение |
 |---|---|
-| npm package | `codex-workflow-v2@2.0.0-beta.11` |
+| npm package | `codex-workflow-v2@2.0.0-beta.12.1` |
 | protocolVersion | 2 |
 | stateSchemaVersion | 2 |
 | lifecycle epoch | 2 |
@@ -37,7 +37,7 @@ Gateway выполняет:
 5. вызов только package-local `dist/src/cli.js --repo <root>`;
 6. `gateway handshake` до lifecycle действий.
 
-Ключевые beta.11 capabilities:
+Ключевые beta.12.1 capabilities:
 
 | Группа | Capabilities |
 |---|---|
@@ -45,8 +45,8 @@ Gateway выполняет:
 | Milestone | lifecycle, initial assembly navigation, autonomy, progress, dependency DAG, initial Plan transaction |
 | Task planning | Plan Risk Audit, proof obligations, mechanical feasibility |
 | C1 | handoff sidecar, handoff bundle, derived Worker actor, credential replacement |
-| Reviews | strict reviewer, Step strict review, corrective audit and hard stop |
-| Recovery | dependency provenance, plan integrity, remediation mode, corrective yield/replan journals |
+| Reviews | strict reviewer, Step strict review, continuable remediation, evidence-bound fix/replan routing |
+| Recovery | Task-local dependency provenance, plan integrity, remediation mode, legacy stop override, corrective yield/replan journals |
 | Replacement | `structural-task-replacement-disabled-v1` |
 
 Handshake incompatibility прекращает работу. Запуск global package, `latest`, mutable range или соседней
@@ -65,7 +65,7 @@ $CODEX_HOME/workflow-state/v2/projects/<project-id>/
   tasks/<TASK-ID>/
     brief.md, plan.md, result.md, evidence.json, state.json
     .versions/
-    authorization/review/remediation/corrective/handoff sidecars
+    authorization/review/remediation/corrective/stop-override/handoff sidecars
   milestones/<MS-ID>/
     plan.json, result.md, evidence.json, state.json
     .versions/ и scope/autonomy sidecars
@@ -281,21 +281,23 @@ local reviewer внутри Codex App sandbox.
 
 # 12. Remediation и corrective decisions
 
-Guarded Step имеет bounded remediation circuit:
+Guarded Step имеет проверяемый, но не ограниченный счётчиком remediation circuit:
 
 | Boundary | Разрешение |
 |---|---|
-| Первый failed review/check cycle | Ordinary scoped retry |
-| Два failed review cycles | Independent Corrective Auditor |
-| `continue-fix` | Один corrective attempt |
-| Corrective attempt failed | Hard stop, fourth run запрещён |
-| `replan-required` | Corrective yield и Human-confirmed journaled replan |
-| `split-required` | Structural replacement stop |
-| `stop-escalate` | Terminal user attention |
-
-Corrective replan разделён на prepare, Human confirmation, execute и recover. Candidate/receipt связывают
-Task revision, Plan/Brief/evidence, corrective decision, writer posture и repository state. Execution
-transaction supersedes old authority и публикует replacement Plan атомарно.
+| Failed cycles 1-2 | `ordinary`; та же Task и новый strict review |
+| Failed cycles 3+ | `corrective`; остаются исполнимыми и требуют нового strict review |
+| Finding `route=fix` или route отсутствует | Продолжить ту же Task/Step |
+| Finding `route=replan` с exact Plan conflict | `task plan-set`; меняются только implementation Steps |
+| `route=replan` без exact conflict | Невалидный review result, state не меняется |
+| Explicit `split-required` | Structural replacement stop |
+| Exact beta.11 attempt-four `stop-escalate` | Append-only Human-confirmed compatibility override |
+| Любой другой explicit `stop-escalate` | Terminal user attention |
+
+Attempt count является диагностикой, а не lifecycle authority. Explicit corrective-decision journal
+сохраняется для намеренного stop/split и совместимого historical recovery, но не требуется после второй
+ошибки. Replan из review обязан назвать `planClause`, `whyFixCannotFit` и `minimalPlanChange`; objective,
+requirements и acceptance Task при remediation неизменяемы. Новый Plan проходит обычные audit и authorization.
 
 # 13. beta.11 Plan-integrity recovery
 
@@ -314,6 +316,19 @@ fresh `next` через corrective yield и обычный Human-confirmed repla
 P01-A предотвращает поддерживаемые contradictions до fresh authorization. beta.11 path остаётся для
 pre-P01 authorizations и late/unsupported exact recovery cases.
 
+# 13.1. beta.12.1 compatibility transitions
+
+`update dependency-provenance-recover` больше не требует полного равенства Task manifest/lock с base.
+Base остаётся version authority, а parent/HEAD candidate сравниваются без единственных Workflow
+dependency entries. Поэтому recorded Task-local scripts сохраняются; payload drift того же candidate
+commit по-прежнему блокируется.
+
+`task stop-override-prepare/apply` обслуживает только exact beta.11 attempt-four policy stop. Prepare
+не пишет state и создаёт binding по Task revision, Step, attempt-3 continue, attempt-4 stop, трём
+remediation events, Plan, HEAD, package, human actor и reason. Apply в отдельном user turn добавляет
+`stop-escalate-overrides.jsonl`. Original corrective decision остаётся неизменным. Split, stale binding,
+lease/transaction, дубликат с другим binding и tampering fail closed.
+
 # 14. P04-A structural replacement boundary
 
 Command shape `task replacement-materialize` retained только для compatibility diagnostics. Любая попытка
@@ -371,7 +386,7 @@ Graph является навигационным индексом, не Project
 После каждой successful mutation обязателен sequential `status`, затем fresh `next`. Failed status/next
 не разрешает direct mutation. Syntax help read-only и не заменяет navigation authority.
 
-# 18. Public command surface beta.11
+# 18. Public command surface beta.12.1
 
 | Область | Actions |
 |---|---|
@@ -386,7 +401,7 @@ Graph является навигационным индексом, не Project
 | Task execution | `start`, `run`, `step-complete`, `submit`, `result-set`, `accept`, `sync-base`, `merge`, `merge-confirm` |
 | C1 | `handoff[-prepare/-replace/-show]`, `claim`, `writer-credential-replace`, `handback[-create]` |
 | Review | review/step-review packet, launch, sealed record и record actions |
-| Corrective | decision/recovery, plan-integrity, remediation-mode, yield и corrective-replan actions |
+| Corrective | decision/recovery, plan-integrity, remediation-mode, stop-override prepare/apply, yield и corrective-replan actions |
 | Replacement | `replacement-materialize` retained, но всегда disabled в P04-A |
 
 Exact options берутся из fresh `next`; command help используется только когда
@@ -398,7 +413,7 @@ Exact options берутся из fresh `next`; command help используе
 running Step и active/stale writer lease. External runner допустим только в документированной rescue
 compatibility форме.
 
-Перед beta.11 tag release repository выполняет:
+Перед beta.12.1 tag release repository выполняет:
 
 1. `npm ci`;
 2. `npm run validate`;

package/docs/release.md

@@ -27,7 +27,7 @@ The PDF check deterministically regenerates all three Russian documents from
 `docs/pdf/sources`, binds the visible package version to the root manifest, and fails when any
 tracked PDF is stale. Source and binary PDFs are one release unit.
 
-For beta.11, the release gate also relies on `npm run release:check` to fail if:
+For beta.12.1, the release gate also relies on `npm run release:check` to fail if:
 
 - canonical entity schema 2 shapes drift;
 - protocol 2 is not the active public contract, or intact protocol-1 adoption evidence stops being readable through the bounded compatibility window;
@@ -44,12 +44,19 @@ For beta.11, the release gate also relies on `npm run release:check` to fail if:
   commands are absent from the packaged surface.
 - bounded dependency-provenance recovery, retained passed-review provenance, the exact Signal T04
   revision-26 fixture, or pending/corrupt-review rejection regressions are absent.
+- dependency recovery again requires Task-local manifest/lock fields to equal the Milestone base,
+  or a candidate commit can alter any non-Workflow dependency payload.
 - the read-only Milestone progress projection, replacement regression, project-monotonic chat
   registry, title fallback/readback, or long-Cyrillic multi-attempt E2E evidence is absent.
 - bounded first-failure Plan-integrity recovery, exact failed-remediation/manifest/worktree
   bindings, or the no-synthetic-second-failure regression is absent.
 - the P04-A Milestone dependency/initial-Plan transaction capabilities or the P01-A mechanical
   feasibility capability is absent from the packaged handshake.
+- continuable guarded remediation or evidence-bound `fix`/`replan` review routing is absent, or a
+  third/later failed review is again converted into an attempt-count stop.
+- the append-only, Human-confirmed beta.11 attempt-four stop override, its exact three-event/
+  continue/stop binding, split rejection, stale-confirmation rejection, or tamper detection is
+  absent from the package.
 
 The separate lifecycle transcript validator fails if the real-agent log contains a mutation that
 bypasses failed `status`/`next`, an unadvertised or failed mutation, an unresolved syntax-only

package/docs/updating-existing-project.md

@@ -52,6 +52,31 @@ commit остался в Git между `baseCommit` и новым dependency-on
 него обязательны последовательные `status` и `next`; выполняйте возвращённый Knowledge reconcile
 или `task context-refresh`, если manifest/lock сделали Knowledge Map stale.
 
+В beta.12.1 preflight сравнивает parent и candidate после удаления только записей зависимости
+`codex-workflow-v2`. Поэтому ранее закоммиченные Task-local scripts и другие product-owned поля
+`package.json`/lockfile могут отличаться от Milestone base и сохраняются. Это не ослабляет сам
+candidate: его HEAD обязан менять ровно `package.json` и `package-lock.json`, только точную Workflow
+dependency; любое другое поле, добавленное тем же candidate commit, неизвестный commit, stale base,
+dirty checkout, lease или transaction по-прежнему блокируют recovery.
+
+### Исключение beta.12.1 для beta.11 attempt-four stop
+
+Если beta.11 записал `stop-escalate` перед четвёртой попыткой только после последовательности
+`ordinary`, `ordinary`, `corrective`, и перед третьей попыткой уже существовал exact
+`continue-fix`, fresh `next` может вернуть `task stop-override-prepare`. Не создавайте новый
+Milestone и не редактируйте sidecar вручную. Сначала выполните только read-only prepare с exact
+Task revision, Step, human actor и содержательной причиной. Проверьте, что ответ связывает тот же
+stop decision, Plan hash, Git HEAD, все три remediation events и policy
+`beta11-attempt4-stop-compatibility-v1`, затем остановитесь перед Human gate.
+
+В отдельном пользовательском сообщении разрешите apply с теми же параметрами и возвращённым
+`SOO-*` кодом. `task stop-override-apply` добавляет одну запись в
+`stop-escalate-overrides.jsonl`, сохраняя исходный `stop-escalate`; после него выполните
+последовательные `status` и `next`. Ожидаемый route — `task run` того же Step с последующим новым
+strict review. Этот путь не работает для `split-required`, другого attempt ordinal, изменённого
+Plan/HEAD/revision, отсутствующего attempt-3 continue, active/stale lease, dirty checkout или
+незавершённой Task transaction. Delegated approval для него отсутствует.
+
 ## 1. Подготовьте отдельный чат обновления
 
 Не обновляйте пакет во время выполняющегося Worker Step. Дождитесь завершения текущего ответа