codex-workflow-v2 2.0.0-beta.12.7 → 2.0.0-beta.12.9

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

@@ -1,10 +1,10 @@
 ---
-title: Codex Workflow V2: архитектура beta.12.7
+title: Codex Workflow V2: архитектура beta.12.9
 subtitle: Источники истины, lifecycle, роли, delegation, зависимости Tasks и границы доверия
 part: Часть 1 из 3 | Архитектура
 document_version: 2.0
-date: 29 августа 2026
-subject: Архитектура и границы Codex Workflow V2 beta.12.7
+date: 30 августа 2026
+subject: Архитектура и границы Codex Workflow V2 beta.12.9
 ---
 
 # 1. Назначение и граница системы
@@ -18,7 +18,7 @@ Codex Workflow V2 - локальный state machine поверх Codex App, Git
 Система рассчитана на одного пользователя и одну машину. Она не предоставляет distributed locking,
 криптографическую идентификацию actor string или безопасную синхронизацию state между компьютерами.
 
-## 1.1. Что beta.12.7 гарантирует
+## 1.1. Что beta.12.9 гарантирует
 
 - exact project-local npm package и совместимый handshake до lifecycle действий;
 - Discovery до materialization Task или Milestone;
@@ -26,6 +26,8 @@ Codex Workflow V2 - локальный state machine поверх Codex App, Git
 - mechanical-feasibility проверку поддерживаемых форм Plan до новой Task authorization;
 - явный Milestone dependency DAG и один общий runnable predicate для routing, handoff, claim и start;
 - один C1 writer lease, секретные one-time credentials и Core-owned Step commits;
+- lease-free Human final-acceptance gate: `task result-set` проверяет и освобождает active writer
+  lease, а после acceptance merge получает новый credential только через fresh recovery route;
 - external-sealed Step/Task review в отдельных Codex tasks;
 - state-bound human gates либо ранее выданные bounded delegation contracts;
 - journaled recovery для составных переходов и fail-closed поведение при drift/corruption.
@@ -33,8 +35,10 @@ Codex Workflow V2 - локальный state machine поверх Codex App, Git
   worktree и HEAD сохраняются, stale completion authority снимается, та же Task возвращается в planning.
 - bounded compatibility recovery, если beta.12.6 после этого recovery ошибочно rebind-нула отвергнутый
   Plan: exact dirty bytes сохраняются до нового consolidated Step, а Knowledge refresh не отменяет `plan-set`.
+- corrective Plan сохраняет authority исключённых completed Step commits, а beta.12.9 bounded recovery
+  исправляет уже stranded state только при passed strict review и прежнем hash-bound final acceptance.
 
-## 1.2. Что beta.12.7 не гарантирует
+## 1.2. Что beta.12.9 не гарантирует
 
 - правильность продуктовой идеи или автоматически выбранного provider Task;
 - semantic sufficiency Plan, если точные факты нельзя доказать поддерживаемым analyzer;
@@ -110,6 +114,11 @@ Discovery -> materialize -> Plan -> Plan Risk Audit
 -> final acceptance -> merge
 ```
 
+`task result-set` является последним execution lease-bound переходом. Он требует рекламируемый
+writer token, освобождает lease до `awaiting_final_acceptance` и тем самым допускает неограниченную
+по времени Human pause без stale-lock блокировки repository. После acceptance прежний token не
+переиспользуется: fresh `next` выдаёт bounded `task writer-credential-replace` для merge.
+
 Fresh Task authorization записывает versioned mechanical-feasibility evidence. Analyzer может
 выдать `blocked`, `pass` или `unverified`. `unverified` не означает semantic approval; он означает,
 что поддерживаемая точная грамматика не доказала противоречие.
@@ -276,6 +285,14 @@ Task в `needs_fix`; stale Knowledge можно reconciliate/approve, но fresh
 всем dirty set. `task run` принимает carryover лишь при exact HEAD/path/hash match, после чего Step
 проходит обычные checks, Core-owned commit и strict review.
 
+beta.12.9 закрывает исторический provenance gap corrective replan. Новые replan transitions автоматически
+переносят evidence commits исключённых Steps в `invalidatedStepCommits`. Для уже существующего gap Core
+требует один неожиданный commit, complete passed strict-review chain, verified reviewer attestation и
+совпадающий прежний final acceptance. Если пакет уже зарегистрирован, recovery меняет только Task state.
+Если exact beta.12.9 dependency commit ещё находится в HEAD, отдельный update compatibility route
+регистрирует dependency и historical authority одной revision. Оба пути сохраняют dirty bytes текущего
+Step, не переписывают Git и завершаются fresh обычным `step-complete` flow.
+
 Docker socket `EPERM` в sandbox не является доказательством сломанного daemon. Gateway один раз
 повторяет exact health probe или Plan check с sandbox escalation без расходования remediation attempt.
 Restart Docker Desktop требует отдельного разрешения и допустим только после escalated daemon failure.
@@ -285,7 +302,7 @@ Restart Docker Desktop требует отдельного разрешения
 # 10. Operational checklist
 
 - exact package version установлен, bundled gateway соответствует release и переустановлен;
-- handshake подтверждает protocol 2, state schema 2 и beta.12.7 capabilities;
+- handshake подтверждает protocol 2, state schema 2 и beta.12.9 capabilities;
 - каждый mutation следует свежему `status -> next` и exact option contract;
 - Docker permission failure сначала классифицируется как sandbox boundary, а не как infra retry;
 - semantic unknowns и human gates не маскируются delegation;

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.12.7 путь от нового Discovery до принятого Milestone без ручного CLI
+subtitle: Актуальный beta.12.9 путь от нового Discovery до принятого Milestone без ручного CLI
 part: Часть 2 из 3 | Практика
 document_version: 2.0
-date: 29 августа 2026
-subject: Практическое руководство по delegated Discovery и Milestone в Workflow V2 beta.12.7
+date: 30 августа 2026
+subject: Практическое руководство по delegated Discovery и Milestone в Workflow V2 beta.12.9
 ---
 
-# 1. Рабочая модель beta.12.7
+# 1. Рабочая модель beta.12.9
 
 Пользователь работает в одном 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.12.7 как точную devDependency после публикации release.
+2. Установите beta.12.9 как точную 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.12.7 должен сообщать `packageVersion=2.0.0-beta.12.7`, `protocolVersion=2`,
+Handshake beta.12.9 должен сообщать `packageVersion=2.0.0-beta.12.9`, `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.12.7 в delegated режиме.
+Проведи новый Milestone через Codex Workflow V2 beta.12.9 в delegated режиме.
 Repository: <ABSOLUTE-REPOSITORY-ROOT>.
 Milestone ID: AUTO.
 Delegate actor: agent:milestone-coordinator.
@@ -242,6 +242,10 @@ Credential и approval grant решают разные задачи.
 4. Claim проверяет dependency binding и возвращает `writerLeaseReceipt`.
 5. `task run` принимает active writer credential согласно `next.writerTokenContract` и обновляет lease.
 6. `task step-complete`, review record и другие guarded mutations используют только рекламируемый option.
+7. После passed final review `task result-set` использует active writer token и освобождает lease до
+   `awaiting_final_acceptance`; Human gate не должен удерживать credential.
+8. После acceptance старый token не используется: fresh `next` рекламирует
+   `task writer-credential-replace`, затем разрешает merge или merge confirmation.
 
 Нельзя искать token в later payload fields, писать его в prompt/report/evidence или заменять redacted
 fingerprint. Потеря token не разрешает новый handoff либо lease acquisition вне fresh recovery route.
@@ -300,6 +304,7 @@ Task chat записывает его только при совпадении p
 | `split-required` | Stop: `STRUCTURAL_REPLACEMENT_REQUIRED`, никаких replacement writes |
 | Старая версия + active downstream proof блокируют update | Только beta.12.6 exact dependency commits и advertised `update downstream-proof-dependency-recover` |
 | После downstream recovery beta.12.6 вернула отвергнутый Plan через Knowledge rebind | Только beta.12.7 replan update bridge, затем recovery и новый consolidated Plan той же Task |
+| Corrective Plan потерял authority ранее принятого Step commit | Только advertised beta.12.9 historical-Step preflight/recovery; без rebase/reset и без новой Task |
 | 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` |
@@ -319,32 +324,26 @@ beta.12.6 и требуйте от fresh `next` `update downstream-proof-depende
 binding dirty set. Recover регистрирует только dependency HEAD; следующий fresh `next` должен вернуть
 обычный `task downstream-proof-recover`. Любой иной diff/history/dirty path/lease означает stop.
 
-Для exact stranded shape после уже выполненного beta.12.6 recovery сначала запустите новой версией
-read-only `update downstream-proof-replan-update-preflight`. Продолжайте только при `eligible=true`,
-source `2.0.0-beta.12.6`, exact revision/HEAD, ожидаемых dirty paths/hash и пустых blockers. Затем
-перенесите beta.12.7 двумя dependency-only commits на base и Task branch, установите пакет и следуйте
-fresh `next` через `update downstream-proof-replan-dependency-recover` и
-`task downstream-proof-replan-recover`. После обязательного Knowledge reconcile/approve fresh `next`
-должен остаться на `task plan-set`, а не resurrect старый Plan. Новый Step обязан один владеть всем
-сохранённым dirty set; `task run` допустим только при `downstreamProofCarryover.state=validated`.
+Для beta.12.9 historical-Step blocker обновите base в отдельном worktree и Task branch двумя commits
+только package/lock. После install продолжайте лишь при advertised `update historical-step-dependency-recover`
+и preflight, связавшем HEAD/parent, passed+accepted historical SHA, Plan/Step, dirty hash и отсутствие lease.
+Recover сохраняет product bytes; затем обязательны `status -> next -> task step-complete`. Если package
+уже зарегистрирован, используйте advertised `task historical-step-provenance-preflight/recover`.
+
+Для exact beta.12.6 stranded-replan shape сначала нужен eligible read-only source preflight с exact
+revision/HEAD/dirty hash. Затем два beta.12.7 dependency-only commits и advertised dependency/replan
+recoveries. После Knowledge refresh `next` обязан остаться на `task plan-set`; новый единый Step должен
+владеть всем dirty set, а `task run` требует `downstreamProofCarryover.state=validated`.
 
 Ошибка Docker socket/CLI `EPERM`, `operation not permitted` или `permission denied` в sandbox не считается
 падением daemon и не расходует retry. Повторите exact read-only probe или Plan check один раз с sandbox
 escalation. Не перезапускайте Docker Desktop и не меняйте image без отдельного разрешения и подтверждённого
 escalated daemon failure.
 
-Если после применённого stop override `next` рекламирует delegated `task context-refresh` или
-`update dependency-provenance-recover`, выполните только этот advertised atomic/recovery переход и
-снова запросите `status -> next`. Таких механических refresh/update циклов может быть несколько.
-Продолжайте attempt 4 только при `stopOverrideContextRebind.state=validated`. При одновременном
-`writerCredentialRecovery.action=task writer-credential-replace` сначала восстановите credential
-точного claimant-актора. `doctor`, semantic Plan change, разрыв rebind/audit chain или HEAD commit без
-точного dependency-provenance record означают stop, а не ручной обход.
-
-Если advertised navigation записала dependency provenance после последнего context-refresh audit,
-продолжайте только когда fresh `next` сам вернул `task run`. Core обязан доказать, что каждый такой
-recovery объясняет ровно один дополнительный Task revision; простое `revision >=` не является
-authority.
+После stop override выполняйте только advertised context/dependency recoveries и каждый раз повторяйте
+`status -> next`; attempt 4 требует `stopOverrideContextRebind.state=validated`. Lost credential
+восстанавливает только advertised exact claimant route. Semantic drift, broken chain, необъяснённый HEAD
+или revision означают stop; продолжение разрешено только когда fresh `next` сам вернул `task run`.
 
 # 12. Milestone final acceptance
 
@@ -363,7 +362,7 @@ Task/project DGR. `dependencyBinding` для standalone handoff равен null.
 
 # 14. Итоговый checklist пользователя
 
-- beta.12.7 exact package и новый bundled gateway установлены;
+- beta.12.9 exact package и новый bundled gateway установлены;
 - новый Coordinator chat не является fork старого Milestone;
 - bootstrap DGR, если нужен, выдан отдельным exact human confirmation;
 - Discovery не materialized при blocking unknowns;
@@ -376,5 +375,6 @@ Task/project DGR. `dependencyBinding` для standalone handoff равен null.
 - downstream predecessor recovery, если рекламировался, сохранил worktree и завершился новым Plan authority;
 - active-proof package bridge, если понадобился, зарегистрировал только exact dependency HEAD перед recovery;
 - stranded-replan bridge, если понадобился, завершился новым Plan и полным Step checks/review, а не только сменой navigation;
+- historical-Step recovery, если рекламировался, сохранил exact accepted commit и довёл текущий Step до обычного `step-complete` без history 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.12.7
+title: Codex Workflow V2: технический справочник beta.12.9
 subtitle: Protocol 2, state schema 2, transactions, credentials, dependency authority, review и recovery
 part: Часть 3 из 3 | Technical reference
 document_version: 2.0
-date: 29 августа 2026
-subject: Технический контракт Codex Workflow V2 beta.12.7
+date: 30 августа 2026
+subject: Технический контракт Codex Workflow V2 beta.12.9
 ---
 
 # 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.12.7 | Значение |
+| Параметр beta.12.9 | Значение |
 |---|---|
-| npm package | `codex-workflow-v2@2.0.0-beta.12.7` |
+| npm package | `codex-workflow-v2@2.0.0-beta.12.9` |
 | protocolVersion | 2 |
 | stateSchemaVersion | 2 |
 | lifecycle epoch | 2 |
@@ -37,16 +37,16 @@ Gateway выполняет:
 5. вызов только package-local `dist/src/cli.js --repo <root>`;
 6. `gateway handshake` до lifecycle действий.
 
-Ключевые beta.12.7 capabilities:
+Ключевые beta.12.9 capabilities:
 
 | Группа | Capabilities |
 |---|---|
 | Knowledge и graph | `project-memory-v1`, `graph-binding-v1`, `task-context-refresh-v1` |
 | 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 |
+| C1 | handoff sidecar/bundle, derived Worker actor, credential replacement, Human-gate lease release |
 | Reviews | strict reviewer, Step strict review, continuable remediation, evidence-bound fix/replan routing |
-| Recovery | Task-local dependency provenance, plan integrity, downstream-proof predecessor invalidation, remediation mode, legacy stop override, append-only stop-rebind chain, corrective yield/replan journals |
+| Recovery | Task-local dependency provenance, historical Step provenance, plan integrity, downstream-proof predecessor invalidation, remediation mode, legacy stop override, append-only stop-rebind chain, corrective yield/replan journals |
 | Replacement | `structural-task-replacement-disabled-v1` |
 
 Handshake incompatibility прекращает работу. Запуск global package, `latest`, mutable range или соседней
@@ -235,7 +235,8 @@ Claim сверяет stored binding с current Milestone authority до lock acq
 3. Exact target actor вызывает `task claim` с one-time token.
 4. Claim выдаёт first-field `writerLeaseReceipt`.
 5. `task run` принимает token по `next.writerTokenContract`, heartbeats lease и возвращает refreshed receipt.
-6. Terminal handback/release уничтожает active bearer material.
+6. `task result-set` consumes active token и освобождает lease до Human final-acceptance gate.
+7. После acceptance `writer-credential-replace` создаёт merge lease; terminal transitions освобождают его.
 
 Credential нельзя логировать, сохранять в chat packet или включать в evidence. `handoff-show` возвращает
 только safe persisted binding. Recovery использует отдельные advertised replacement actions.
@@ -249,7 +250,7 @@ Credential нельзя логировать, сохранять в chat packet
 | Worker return | Изменения uncommitted и только в allowedWrites |
 | Step complete | History, scope, checks, review gate, exact writer token |
 | Commit | Один Core-owned commit с Task/Step metadata |
-| Submit | Clean tree, Steps completed/skipped, recorded commits and evidence |
+| Submit/Result | Exact evidence/review; Result освобождает lease до Human gate |
 | Merge | Fresh review/acceptance, base conditions, accepted HEAD |
 
 Local start повторно сравнивает authorized base внутри Git branch creation, закрывая TOCTOU между
@@ -380,6 +381,26 @@ fresh `next` рекламирует lease-bound `task downstream-proof-recover`
 remainder и пройти fresh Plan Risk Audit и execution authorization. Unrelated/non-predecessor file,
 strict-review evidence, unregistered commit, branch mismatch или damaged sidecar возвращают `doctor`.
 
+# 13.3. beta.12.9 historical Step provenance
+
+Corrective replan теперь сохраняет evidence commits Steps, исключённых replacement Plan, в
+`invalidatedStepCommits`. Это предотвращает новый unregistered-history blocker без переноса завершённого
+Step в новый Plan.
+
+Для уже существующего stranded state fresh `next` допускает только один из двух bounded routes:
+
+- `task historical-step-provenance-preflight/recover`, если beta.12.9 dependency HEAD уже зарегистрирован;
+- `update historical-step-dependency-preflight/recover`, если dependency-only beta.12.9 commit ещё
+  является единственным unregistered HEAD.
+
+Core требует один active Step, dirty paths только в его `allowedWrites`, отсутствие leases/transactions,
+ровно один omitted product commit, полный hash-valid strict Step Review с `passed`, verified reviewer
+attestation и прежний hash-bound `final_acceptance` того же Plan. Update-route дополнительно связывает
+exact `HEAD^`/`HEAD`, package/version surfaces и SHA-256 dirty worktree. Recovery не переписывает Git,
+не меняет product bytes и не возвращает старый Step в Plan; он записывает historical authority и, для
+update-route, dependency provenance в одной Task revision. Fresh `status -> next` после transition
+должен вернуть обычный credential/`task step-complete` flow текущего Step.
+
 # 14. P04-A structural replacement boundary
 
 Command shape `task replacement-materialize` retained только для compatibility diagnostics. Любая попытка
@@ -442,12 +463,12 @@ Docker socket/CLI `EPERM`, `operation not permitted` или `permission denied`
 После каждой successful mutation обязателен sequential `status`, затем fresh `next`. Failed status/next
 не разрешает direct mutation. Syntax help read-only и не заменяет navigation authority.
 
-# 18. Public command surface beta.12.7
+# 18. Public command surface beta.12.9
 
 | Область | Actions |
 |---|---|
 | System | `doctor`, `status`, `next`, `gateway handshake`, `locks` |
-| Update | `preflight`, `rescue-preflight`, dependency provenance, downstream-proof dependency bridge, downstream-proof replan update/dependency bridge |
+| Update | `preflight`, `rescue-preflight`, dependency provenance, historical-Step dependency bridge, downstream-proof dependency bridge, downstream-proof replan update/dependency bridge |
 | Project memory | `scan`, `show`, `status`, `approve`, `reconcile` |
 | Delegation | `prepare`, `grant`, `list`, `show`, `revoke` |
 | Graph | `prepare`, `status`, `refresh-request`, `bind`, `fallback` |
@@ -457,7 +478,7 @@ Docker socket/CLI `EPERM`, `operation not permitted` или `permission denied`
 | 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, downstream-proof-recover/replan-recover, remediation-mode, stop-override prepare/apply, yield и corrective-replan actions |
+| Corrective | decision/recovery, plan-integrity, historical-step-provenance preflight/recover, downstream-proof-recover/replan-recover, remediation-mode, stop-override prepare/apply, yield и corrective-replan actions |
 | Replacement | `replacement-materialize` retained, но всегда disabled в P04-A |
 
 Exact options берутся из fresh `next`; command help используется только когда
@@ -467,16 +488,10 @@ Exact options берутся из fresh `next`; command help используе
 
 Перед package update project-local `update preflight` должен вернуть `safe=true`: clean checkout, нет
 running Step и active/stale writer lease. Исключения — документированный alpha.7 rescue, beta.12.6
-active-downstream-proof bridge и beta.12.7 exact stranded-replan bridge; все они fail-closed и не дают
-общего разрешения dirty update.
-
-Перед beta.12.7 tag release repository выполняет:
-
-1. `npm ci`;
-2. `npm run validate`;
-3. `npm run pack:check`;
-4. `npm run smoke:downstream`;
-5. `npm run plugin:check` и official plugin/skill validators;
-6. `npm run docs:pdf:check`;
-7. `npm run release:check` с exact release tag binding;
-8. validation append-only real-agent lifecycle log.
+active-downstream-proof bridge, beta.12.7 exact stranded-replan bridge и beta.12.9 historical-Step
+dependency bridge; все они fail-closed и не дают общего разрешения dirty update.
+
+Перед beta.12.9 tag обязательны `npm ci`, `npm run validate`, `npm run pack:check`,
+`npm run smoke:downstream`, `npm run plugin:check`, official plugin/skill validators,
+`npm run docs:pdf:check`, `npm run release:check` с exact tag binding и validation
+append-only real-agent lifecycle log.

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.12.7, the release gate also relies on `npm run release:check` to fail if:
+For beta.12.9, 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;
@@ -42,10 +42,18 @@ For beta.12.7, the release gate also relies on `npm run release:check` to fail i
   explicit recovery, or dual-readback capabilities are absent from the packaged surface.
 - scoped Task navigation, credential replacement recovery, or sealed external Task/Step review
   commands are absent from the packaged surface.
+- `task result-set` can enter the unbounded Human final-acceptance gate without consuming a live
+  writer credential and releasing its lease, or claimed Task E2E cannot reacquire a fresh merge credential.
 - 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.
+- corrective replan drops completed Step evidence from accepted Task history, or an already-stranded
+  Task can register arbitrary/unreviewed history instead of one exact passed and previously accepted
+  Step commit.
+- beta.12.9 cannot install through an exact dependency-only base/Task transport while preserving the
+  active Step worktree, or that compatibility route fails to bind the dependency HEAD, historical
+  commit, current Plan/Step, dirty paths/content hash, and absence of leases/transactions.
 - 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

package/docs/updating-existing-project.md

@@ -59,6 +59,36 @@ candidate: его HEAD обязан менять ровно `package.json` и `p
 dependency; любое другое поле, добавленное тем же candidate commit, неизвестный commit, stale base,
 dirty checkout, lease или transaction по-прежнему блокируют recovery.
 
+### Исключение beta.12.9 для Step commit, потерянного corrective Plan
+
+Если активный corrective Step сохраняет допустимый dirty worktree, а `task step-complete` обнаруживает
+ровно один старый product commit, beta.12.9 не требует переписывать Git. Пакет поддерживает два
+строго ограниченных входа в один и тот же recovery:
+
+- если beta.12.9 уже зарегистрирована, свежий `next` рекламирует
+  `task historical-step-provenance-recover`;
+- если для установки beta.12.9 на Milestone base и Task branch уже созданы ровно dependency-only
+  commits, свежий `next` рекламирует `update historical-step-dependency-recover`. Этот переход
+  атомарно регистрирует новый dependency HEAD и сохраняет authority старого Step commit.
+
+В обоих случаях Core сам доказывает для старого SHA полную hash-valid strict Step Review цепочку с
+решением `passed`, verified reviewer isolation и совпадающий прежний `final_acceptance`. Update-route
+дополнительно требует exact target version на declared/locked/installed/current-branch/base surfaces,
+dependency commit только из `package.json` и `package-lock.json`, а также неизменный hash активного
+dirty worktree относительно read-only assessment.
+
+Сначала выполните read-only `task historical-step-provenance-preflight --id <TASK-ID>`. Продолжайте
+только при `eligible=true`, точных Task revision, Plan/Brief/HEAD и commit SHA, отсутствии leases,
+transactions и Core operations, а также dirty paths строго внутри `allowedWrites` единственного
+активного Step. Recover принимает exact SHA, actor и содержательную reason, добавляет SHA в
+`invalidatedStepCommits` и записывает источник прежнего acceptance. Product bytes, HEAD и текущий
+Plan не меняются; старый Step не возвращается в Plan. После recovery обязательны последовательные
+`status` и `next`, затем обычный credential route и `task step-complete` текущего Step.
+
+Несколько unknown commits, pending/failed review, несовпадающий Plan прежнего acceptance,
+повреждённый sidecar, посторонний dirty path или lease являются hard stop. Запрещено заменять этот
+переход rebase/reset/amend, ручным `systemCommits` или переносом старого Step в текущий Plan.
+
 ### Исключение beta.12.6 для активного downstream proof
 
 Обычный `update preflight` по-прежнему правильно запрещает обновление при running Step и dirty