codex-workflow-v2 2.0.0-beta.12.10 → 2.0.0-beta.12.12

package/docs/delegated-approval.md

@@ -90,7 +90,7 @@ uses the grant and passes `--delegation-grant` to the Core transition.
 
 Ordinary semantic Milestone scope changes remain journaled, human-only lifecycle actions. A
 contract delegate may evolve only the membership graph inside the cryptographically bound
-semantic scope. The separate beta.12.10 `milestone remediation-materialize` route is not delegation
+semantic scope. The separate beta.12.11 `milestone remediation-materialize` route is not delegation
 and does not widen this allow-list: Core derives it only from a current blocking Plan Risk Audit and
 a previously authorized active Milestone. Its topology effect is fixed to one new required upstream
 Task plus one dependency edge, with all Milestone semantics preserved. The resulting

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

@@ -1,10 +1,10 @@
 ---
-title: Codex Workflow V2: архитектура beta.12.10
+title: Codex Workflow V2: архитектура beta.12.12
 subtitle: Источники истины, lifecycle, роли, delegation, зависимости Tasks и границы доверия
 part: Часть 1 из 3 | Архитектура
 document_version: 2.0
 date: 31 августа 2026
-subject: Архитектура и границы Codex Workflow V2 beta.12.10
+subject: Архитектура и границы Codex Workflow V2 beta.12.12
 ---
 
 # 1. Назначение и граница системы
@@ -18,7 +18,7 @@ Codex Workflow V2 - локальный state machine поверх Codex App, Git
 Система рассчитана на одного пользователя и одну машину. Она не предоставляет distributed locking,
 криптографическую идентификацию actor string или безопасную синхронизацию state между компьютерами.
 
-## 1.1. Что beta.12.10 гарантирует
+## 1.1. Что beta.12.12 гарантирует
 
 - exact project-local npm package и совместимый handshake до lifecycle действий;
 - Discovery до materialization Task или Milestone;
@@ -41,7 +41,7 @@ Codex Workflow V2 - локальный state machine поверх Codex App, Git
   один additive remediation Task без нового Human gate; Core сохраняет Milestone semantics и выводит
   authority из текущей Milestone authorization и exact audit evidence.
 
-## 1.2. Что beta.12.10 не гарантирует
+## 1.2. Что beta.12.12 не гарантирует
 
 - правильность продуктовой идеи или автоматически выбранного provider Task;
 - semantic sufficiency Plan, если точные факты нельзя доказать поддерживаемым analyzer;
@@ -296,7 +296,7 @@ beta.12.9 закрывает исторический provenance gap corrective
 регистрирует dependency и historical authority одной revision. Оба пути сохраняют dirty bytes текущего
 Step, не переписывают Git и завершаются fresh обычным `step-complete` flow.
 
-beta.12.10 закрывает иной класс тупика до начала выполнения. Если current Plan Risk Audit required Task
+beta.12.11 закрывает иной класс тупика до начала выполнения. Если current Plan Risk Audit required Task
 записал `stop-escalate`, потому что нужной upstream capability нет в scope этой Task, Core рекламирует
 audited remediation. Coordinator сначала формализует capability обычным Discovery. Затем одна Project
 transaction append-only создаёт required remediation Task на exact merged predecessor frontier исходной
@@ -307,6 +307,22 @@ memberships. Scope-change event связан с Task revision, Brief/Plan и aud
 обычный Plan, audit, C1, commits и reviews. После её merge исходная Task обязана заменить отвергнутый Plan,
 пройти fresh audit и продолжить Step. Final Milestone acceptance не выводится автоматически.
 
+Dependency-only update не должен создавать промежуточный Human gate. Если stale Knowledge отличается
+только content hash `package.json`, все package surfaces уже равны runtime version, checkout clean, а
+каждый Git commit, менявший `package.json` после approved hash, затрагивает ровно manifest/lock и только
+Workflow pin, Core переносит reconcile и `corrective-derived` approval внутрь той же atomic remediation
+transaction. Изменение любого другого Knowledge source, classification, gap или conflict fail-closed
+остаётся в обычном явном approval flow.
+
+beta.12.12 закрывает доказанный runtime Plan-integrity gap. Mechanical feasibility теперь статически
+распознаёт repository-local `node <runner> affected`, когда исходник runner явно требует selector,
+и блокирует authorization для `npm run <script>` без `--base`, `--head` или `--files`. Для уже начатой
+Task recovery связывает не только первую, а всю последовательную checks-failed history, точный Plan,
+manifest/runner hashes, HEAD и dirty allowlist. Exact beta.12.11 update bridge сохраняет product bytes,
+регистрирует только dependency commit и атомарно обновляет Knowledge, если изменился только Workflow pin.
+Результат — один `replan-required` decision и обычный corrective replan с исполняемой check command;
+повтор старой команды, ручной commit product files и state editing не допускаются.
+
 Docker socket `EPERM` в sandbox не является доказательством сломанного daemon. Gateway один раз
 повторяет exact health probe или Plan check с sandbox escalation без расходования remediation attempt.
 Restart Docker Desktop требует отдельного разрешения и допустим только после escalated daemon failure.
@@ -316,7 +332,7 @@ Restart Docker Desktop требует отдельного разрешения
 # 10. Operational checklist
 
 - exact package version установлен, bundled gateway соответствует release и переустановлен;
-- handshake подтверждает protocol 2, state schema 2 и beta.12.10 capabilities;
+- handshake подтверждает protocol 2, state schema 2 и beta.12.12 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.10 путь от нового Discovery до принятого Milestone без ручного CLI
+subtitle: Актуальный beta.12.12 путь от нового Discovery до принятого Milestone без ручного CLI
 part: Часть 2 из 3 | Практика
 document_version: 2.0
 date: 31 августа 2026
-subject: Практическое руководство по delegated Discovery и Milestone в Workflow V2 beta.12.10
+subject: Практическое руководство по delegated Discovery и Milestone в Workflow V2 beta.12.12
 ---
 
-# 1. Рабочая модель beta.12.10
+# 1. Рабочая модель beta.12.12
 
 Пользователь работает в одном 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.10 как точную devDependency после публикации release.
+2. Установите beta.12.12 как точную 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.10 должен сообщать `packageVersion=2.0.0-beta.12.10`, `protocolVersion=2`,
+Handshake beta.12.12 должен сообщать `packageVersion=2.0.0-beta.12.12`, `protocolVersion=2`,
 `stateSchemaVersion=2`, dependency DAG, initial Plan transaction, mechanical feasibility,
 Milestone autonomy и structural replacement disabled capabilities.
 
@@ -117,7 +117,7 @@ delegate, scope, transitions и expiry. DGR передаётся только е
 ```text
 НОВЫЙ COORDINATOR CHAT
 
-Проведи новый Milestone через Codex Workflow V2 beta.12.10 в delegated режиме.
+Проведи новый Milestone через Codex Workflow V2 beta.12.12 в delegated режиме.
 Repository: <ABSOLUTE-REPOSITORY-ROOT>.
 Milestone ID: AUTO.
 Delegate actor: agent:milestone-coordinator.
@@ -315,7 +315,7 @@ Task chat записывает его только при совпадении p
 Plan-integrity recovery не редактирует Plan, package.json или worktree и не синтезирует второй failure.
 P04-A не переносит completed Steps и не rewires dependencies при split.
 
-Audited remediation beta.12.10 не является generic scope-change. Coordinator использует только exact
+Audited remediation beta.12.11 не является generic scope-change. Coordinator использует только exact
 route из fresh `next`: создаёт Discovery для доказанной отсутствующей upstream capability, доводит его
 до ready и вызывает `milestone remediation-materialize` с текущими revisions и exact
 `requiredPredecessorTaskIds`. Core не принимает новый Milestone Plan: сохраняет outcome/success signal,
@@ -326,6 +326,13 @@ acceptance/checks и старые memberships, append-only добавляет о
 Audit и как минимум следующему Step. Dirty checkout, lease/transaction, stale audit, started Task,
 неполный predecessor frontier или повторное использование audit означают hard stop.
 
+После обновления package fresh `next` может добавить
+`auditedRemediation.dependencyKnowledgeRefresh`. Продолжайте без Human approval только при
+`eligible=true`: Core доказал clean checkout, exact aligned version surfaces, единственный изменённый
+Knowledge path `package.json` и dependency-only Git chain. Refresh будет применён атомарно во время
+`milestone remediation-materialize`. Если объект отсутствует или содержит blockers, не маскируйте
+документационный/product drift под update — используйте обычный Project Knowledge flow.
+
 `task downstream-proof-recover` также не редактирует product files и не создаёт новую Task. Он сохраняет
 dirty worktree/HEAD, append-only фиксирует invalidated predecessor evidence, освобождает C1 и возвращает
 текущую Task к `task plan-set`. Если fresh `next` не рекламирует этот переход, вызывать его нельзя.
@@ -343,6 +350,16 @@ binding dirty set. Recover регистрирует только dependency HEAD
 Recover сохраняет product bytes; затем обязательны `status -> next -> task step-complete`. Если package
 уже зарегистрирован, используйте advertised `task historical-step-provenance-preflight/recover`.
 
+Для beta.12.11 Task, застрявшей на selector-required `npm run validate:affected` без selector, сначала
+остановите Worker и дождитесь отсутствия active/stale lease. Внешний exact beta.12.12 runner допускается
+только для read-only `update plan-integrity-update-preflight`; требуйте `eligible=true`, exact failed Step,
+полную remediation history и неизменённый dirty allowlist. После единственного dependency-only commit
+на base и Task branch fresh repository-local `next` должен рекламировать
+`update plan-integrity-dependency-recover`. Recovery атомарно регистрирует commit и dependency-only
+Knowledge refresh. Затем выполните advertised credential recovery, `task plan-integrity-recover` и
+`task corrective-yield`. Replacement Plan меняет только неисполняемую check на
+`npm run validate:affected -- --files=<Step allowedWrites>` и проходит fresh Plan Risk Audit до нового run.
+
 Для 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 должен
@@ -375,7 +392,7 @@ Task/project DGR. `dependencyBinding` для standalone handoff равен null.
 
 # 14. Итоговый checklist пользователя
 
-- beta.12.10 exact package и новый bundled gateway установлены;
+- beta.12.12 exact package и новый bundled gateway установлены;
 - новый Coordinator chat не является fork старого Milestone;
 - bootstrap DGR, если нужен, выдан отдельным exact human confirmation;
 - Discovery не materialized при blocking unknowns;

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

@@ -1,10 +1,10 @@
 ---
-title: Codex Workflow V2: технический справочник beta.12.10
+title: Codex Workflow V2: технический справочник beta.12.12
 subtitle: Protocol 2, state schema 2, transactions, credentials, dependency authority, review и recovery
 part: Часть 3 из 3 | Technical reference
 document_version: 2.0
 date: 31 августа 2026
-subject: Технический контракт Codex Workflow V2 beta.12.10
+subject: Технический контракт Codex Workflow V2 beta.12.12
 ---
 
 # 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.10 | Значение |
+| Параметр beta.12.12 | Значение |
 |---|---|
-| npm package | `codex-workflow-v2@2.0.0-beta.12.10` |
+| npm package | `codex-workflow-v2@2.0.0-beta.12.12` |
 | 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.12.10 capabilities:
+Ключевые beta.12.12 capabilities:
 
 | Группа | Capabilities |
 |---|---|
@@ -402,7 +402,7 @@ exact `HEAD^`/`HEAD`, package/version surfaces и SHA-256 dirty worktree. Recove
 update-route, dependency provenance в одной Task revision. Fresh `status -> next` после transition
 должен вернуть обычный credential/`task step-complete` flow текущего Step.
 
-# 13.4. beta.12.10 audited remediation topology
+# 13.4. beta.12.11 audited remediation topology
 
 `milestone remediation-materialize` применим только к required Task в
 `awaiting_execution_authorization`, если ни один Step не начат и последний audit текущей
@@ -435,6 +435,39 @@ Current Milestone execution authorization superseded и заменён `correcti
 mechanical feasibility, C1, Step checks/commits/reviews и final Milestone acceptance не меняются.
 После merge remediation Task исходная Task получает `task plan-set` и проходит fresh audit/authority.
 
+Если перед этим exact package update сделал Knowledge Map stale, navigation может вернуть
+`auditedRemediation.dependencyKnowledgeRefresh`. Eligibility требует: ранее active approved map;
+inspected status `stale`; единственный изменённый Knowledge path `package.json`; clean checkout;
+runtime/declared/locked/installed/HEAD/Milestone-base version равны; approved package content найден в
+Git ancestry; каждый последующий commit, трогавший manifest, меняет ровно `package.json` и
+`package-lock.json`, причём после удаления `codex-workflow-v2` обе JSON-структуры совпадают с parent.
+Materialization тогда дополнительно пишет active Knowledge Map с revision +2 и approval mode
+`corrective-derived` в той же Project transaction. Это не разрешает автоматически принимать README,
+docs, commands, classification, authority, gaps или conflicts.
+
+# 13.5. beta.12.12 selector-contract Plan-integrity recovery
+
+Analyzer `wf2.root-npm-script-arguments@1` читает root `package.json` и только repository-local runner
+из evaluated Git HEAD. Узкий доказуемый contract — script `node <safe-relative-path> affected`, исходник
+которого использует `process.argv.slice(3)`, содержит selector literals `--base`, `--head`, `--files` и
+явный `Affected mode requires` guard. Для такого script check без forwarded selector получает
+`ROOT_NPM_SCRIPT_REQUIRED_SELECTOR_MISSING` и блокирует execution authorization. Произвольный shell или
+нераспознанный runner остаётся `unverified`, а не объявляется ошибочным по догадке.
+
+Legacy recovery принимает последовательную append-only history из одного или нескольких
+`checks-failed` events при отсутствии corrective decision. Evidence v2 связывает каждый event ID/hash/
+ordinal, Task revision, Plan/Step definition, manifest и runner hashes, Git HEAD, conflicts и SHA-256
+dirty worktree. `task plan-integrity-recover` записывает один `replan-required` decision с
+`triggeringAttemptCount = failures + 1` и полным `coveredEventIds`.
+
+Если exact beta.12.12 package ещё не установлен, `update plan-integrity-update-preflight` проверяет
+source beta.12.11, отсутствие leases/transactions и exact dirty allowlist. После dependency-only
+transport `update plan-integrity-dependency-preflight/recover` регистрирует единственный HEAD как system
+commit. Когда Knowledge drift объясняется только Workflow pin, та же Project transaction выполняет
+corrective-derived reconcile/approval; прочий drift fail-closed. Product bytes не коммитятся и не
+переносятся. Fresh route продолжается через credential replacement, `plan-integrity-recover`, yield и
+corrective replan с selector-bearing check.
+
 # 14. P04-A structural replacement boundary
 
 Command shape `task replacement-materialize` retained только для compatibility diagnostics. Любая попытка
@@ -497,12 +530,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.10
+# 18. Public command surface beta.12.12
 
 | Область | Actions |
 |---|---|
 | System | `doctor`, `status`, `next`, `gateway handshake`, `locks` |
-| Update | `preflight`, `rescue-preflight`, dependency provenance, historical-Step dependency bridge, downstream-proof dependency bridge, downstream-proof replan update/dependency bridge |
+| Update | `preflight`, `rescue-preflight`, dependency provenance, historical-Step dependency bridge, downstream-proof bridges, Plan-integrity update/dependency bridge |
 | Project memory | `scan`, `show`, `status`, `approve`, `reconcile` |
 | Delegation | `prepare`, `grant`, `list`, `show`, `revoke` |
 | Graph | `prepare`, `status`, `refresh-request`, `bind`, `fallback` |
@@ -522,10 +555,11 @@ 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 и beta.12.9 historical-Step
-dependency bridge; все они fail-closed и не дают общего разрешения dirty update.
+active-downstream-proof bridge, beta.12.7 exact stranded-replan bridge, beta.12.9 historical-Step
+dependency bridge и beta.12.12 Plan-integrity bridge; все они fail-closed и не дают общего разрешения
+dirty update.
 
-Перед beta.12.10 tag обязательны `npm ci`, `npm run validate`, `npm run test:signal-remediation-e2e`, `npm run pack:check`,
+Перед beta.12.12 tag обязательны `npm ci`, `npm run validate`, `npm run test:signal-remediation-e2e`, `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

@@ -28,7 +28,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.10, the release gate also relies on `npm run release:check` to fail if:
+For beta.12.12, 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;
@@ -57,7 +57,8 @@ For beta.12.10, the release gate also relies on `npm run release:check` to fail
   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
+- bounded first- or repeated-failure Plan-integrity recovery, selector-required npm-check
+  feasibility, exact failed-remediation/manifest/worktree
   bindings, or the no-synthetic-second-failure regression is absent.
 - downstream proof cannot invalidate only completed transitive-predecessor authority while
   preserving worktree/HEAD, yielding C1, and returning the same Task to fresh planning; or unrelated

package/docs/updating-existing-project.md

@@ -22,12 +22,37 @@ state schema. Совпадение `stateSchemaVersion` до и после об
 нужна. Для alpha.6 при `stateSchemaVersion: 2` применяется не migration, а sidecar-only
 adoption posture.
 
-### beta.12.10: audited remediation вместо ручной смены Milestone scope
+### beta.12.12: неисполняемая Step check и сохранение текущей реализации
+
+Новые Plans больше не могут получить execution authorization, если root npm script запускает
+repository-local `affected` validator, сам validator явно требует `--base`, `--head` или `--files`,
+а Step check не передаёт ни одного selector. Исправьте check в Plan, например
+`npm run validate:affected -- --files=<allowedWrites>`; Worker и remediation attempt до этого не
+запускаются.
+
+Для Task, уже застрявшей на beta.12.11 после одного или нескольких одинаковых `checks-failed`,
+используется только bounded bridge. Внешний exact beta.12.12 runner выполняет read-only
+`update plan-integrity-update-preflight`; продолжение допустимо лишь при `eligible=true`, отсутствии
+lease/transaction и точном dirty set внутри failed Step `allowedWrites`. Затем один dependency-only
+commit (`package.json` и `package-lock.json`) должен оказаться и на Milestone base, и в Task history
+без изменения product bytes. Fresh repository-local `next` рекламирует
+`update plan-integrity-dependency-recover`; этот переход регистрирует dependency commit и, если
+Knowledge drift вызван только Workflow pin в `package.json`, атомарно выполняет corrective-derived
+Knowledge refresh без Human approval.
+
+После регистрации Core связывает всю append-only цепочку failed attempts, текущий Plan, HEAD,
+manifest, validator и SHA-256 dirty worktree. `task plan-integrity-recover` записывает один
+`replan-required` decision для следующего ordinal. Затем следуйте fresh
+`task corrective-yield -> task corrective-replan-*`; replacement Plan обязан сохранить Step и dirty
+allowlist, но заменить check на исполняемую selector-bearing команду. Не коммитьте product files,
+не редактируйте state и не повторяйте старую неисполняемую проверку.
+
+### beta.12.11: audited remediation и dependency-only Knowledge refresh
 
 После безопасного обновления существующий active Milestone может продолжить работу без пересоздания,
 если current `next` показывает pre-execution `stop-escalate` и объект `auditedRemediation`. Это не
 update compatibility bridge и не разрешение вручную менять state. Сначала выполните обычный
-`update preflight`; установите exact beta.12.10 только при `safe=true`, clean checkout, отсутствии
+`update preflight`; установите exact beta.12.11 только при `safe=true`, clean checkout, отсутствии
 running Step и leases, затем снова выполните repository-local handshake, `status` и `next`.
 
 Далее следуйте только свежему route: remediation Discovery -> ready ->
@@ -40,6 +65,14 @@ repository priority и пройти обычную реализацию/review/m
 вернуться к `task plan-set`, fresh Risk Audit и следующему Step. Если fresh `next` не рекламирует этот
 контракт, не вызывайте команды напрямую и не редактируйте Milestone state.
 
+Если exact dependency-only update сделал approved Knowledge Map stale только по `package.json`,
+`auditedRemediation.dependencyKnowledgeRefresh` должен подтвердить clean checkout, aligned
+declared/locked/installed/HEAD/base versions и полную Git-цепочку commits, меняющих только Workflow pin
+в `package.json`/lock. Такой content refresh не требует Human approval: он применяется в той же Project
+transaction, что и `milestone remediation-materialize`, с `corrective-derived` evidence. Любой другой
+Knowledge diff (включая README, документацию, classification, gap или conflict) не допускается в этот
+маршрут и остаётся в обычном reconcile/approval flow.
+
 ### Исключение для lifecycle-дедлока alpha.6
 
 Обычный `update preflight` намеренно блокирует обновление при `in_progress` Step. Если alpha.6