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

package/docs/pdf/README.md

@@ -0,0 +1,24 @@
+# Russian PDF documentation
+
+The three tracked PDFs in this directory are deterministic release artifacts generated from the
+reviewable Markdown files in [`sources`](sources/).
+
+Generate them with:
+
+```bash
+npm run docs:pdf
+```
+
+Verify that the tracked binaries match the current sources and package version with:
+
+```bash
+npm run docs:pdf:check
+```
+
+The generator reads the exact version from the root `package.json`, uses embedded TrueType font
+subsets, and writes deterministic PDF bytes. A release must update source and PDF together. The
+PDFs are human-facing artifacts; runtime code, schemas, the bundled gateway and ordinary Markdown
+documents remain the technical authority.
+
+The runner uses `CODEX_WORKFLOW_PDF_PYTHON` when supplied, then the bundled Codex App Python, then
+`python3`. Non-Codex environments can install the pinned dependency from `requirements.txt`.

package/docs/pdf/requirements.txt

@@ -0,0 +1 @@
+reportlab==4.4.9

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

@@ -0,0 +1,234 @@
+---
+title: Codex Workflow V2: архитектура beta.11
+subtitle: Источники истины, lifecycle, роли, delegation, зависимости Tasks и границы доверия
+part: Часть 1 из 3 | Архитектура
+document_version: 2.0
+date: 24 августа 2026
+subject: Архитектура и границы Codex Workflow V2 beta.11
+---
+
+# 1. Назначение и граница системы
+
+Codex Workflow V2 - локальный state machine поверх Codex App, Git и файлов проекта. Codex выполняет
+исследование и реализацию. Workflow Core решает, разрешена ли конкретная мутация, связывает её с
+актуальными revisions и hashes, управляет writer credentials и создаёт проверяемые Git evidence.
+
+> **Главная граница:** файлы проекта и Git history являются долговременной продуктовой памятью. Локальный Workflow state хранит производный lifecycle и не может заменять repository knowledge.
+
+Система рассчитана на одного пользователя и одну машину. Она не предоставляет distributed locking,
+криптографическую идентификацию actor string или безопасную синхронизацию state между компьютерами.
+
+## 1.1. Что beta.11 гарантирует
+
+- exact project-local npm package и совместимый handshake до lifecycle действий;
+- Discovery до materialization Task или Milestone;
+- утверждённую Project Knowledge Map и Plan, связанный с её точной revision/hash;
+- mechanical-feasibility проверку поддерживаемых форм Plan до новой Task authorization;
+- явный Milestone dependency DAG и один общий runnable predicate для routing, handoff, claim и start;
+- один C1 writer lease, секретные one-time credentials и Core-owned Step commits;
+- external-sealed Step/Task review в отдельных Codex tasks;
+- state-bound human gates либо ранее выданные bounded delegation contracts;
+- journaled recovery для составных переходов и fail-closed поведение при drift/corruption.
+
+## 1.2. Что beta.11 не гарантирует
+
+- правильность продуктовой идеи или автоматически выбранного provider Task;
+- semantic sufficiency Plan, если точные факты нельзя доказать поддерживаемым analyzer;
+- параллельную работу нескольких writers в одном checkout;
+- автоматический structural replacement после `split-required`;
+- восстановление вручную повреждённого state без штатной recovery transition.
+
+# 2. Шесть уровней и источники истины
+
+| Уровень | Источник истины | Ответственность |
+|---|---|---|
+| Пользователь / principal | Явные ответы и подтверждённые policies | Scope, semantic unknowns, grant issuance, human gates |
+| Codex App | Project folders, tasks, permissions | User-visible execution contexts и bounded tool access |
+| Роли агентов | Fresh ContextPacket и Workflow projection | Discovery, planning, execution, review, coordination |
+| Project-local gateway | Exact installed package и protocol | Handshake, routing discipline, app chat boundary |
+| Workflow Core | Runtime transitions и schemas | Revisions, hashes, locks, Git ownership, evidence |
+| Repository и local state | Git/files и revisioned state | Durable product facts и производный lifecycle |
+
+При расхождении приоритет имеют runtime Core и обычные файлы текущего repository. PDF объясняет
+контракт человеку, но не заменяет `status`, свежий `next`, schemas или package-local help.
+
+## 2.1. Exact package boundary
+
+Продуктовый repository обязан объявить `codex-workflow-v2` точной версией в `devDependencies`.
+Gateway разрешает только `node_modules/codex-workflow-v2/dist/src/cli.js` этого repository,
+сравнивает installed и declared versions, затем выполняет `gateway handshake`.
+
+```text
+AGENTS.md
+-> project-local gateway
+-> gateway handshake
+-> status
+-> next [--task <exact TASK-ID>]
+-> только рекламируемая transition
+```
+
+`doctor` является диагностикой, но не заменяет успешные `status` и `next`. Help разрешён только для
+уточнения syntax после свежего routing response.
+
+# 3. Долговременные и производные артефакты
+
+| Артефакт | Где находится | Кто владеет записью |
+|---|---|---|
+| Product code, tests, Markdown docs | Git repository | Worker в Plan scope; Git commit создаёт Core |
+| AGENTS.md и Project Knowledge | Git repository | Пользователь и обычный reviewable change |
+| Knowledge Map | Local Workflow state | Project-memory transitions |
+| Discovery state | Local Workflow state | Discovery transitions |
+| Brief, Plan, Result, evidence | Local Workflow state с versioned artifacts | Core transitions |
+| Task/Milestone state и sidecars | Local Workflow state | Core, CAS и schema validation |
+| Writer locks и private credentials | Local Workflow state | Lock manager и C1 transitions |
+| Transaction journals | Local Workflow state | Composite transition recovery |
+| codebase graph binding | Local Workflow state | Derived evidence, не product authority |
+
+Ручное редактирование state, locks, sidecars или `.versions` запрещено. Оно ломает hash chain,
+expected revision и восстановимость составных операций.
+
+# 4. Discovery, Task и Milestone
+
+| Сущность | Назначение | Terminal success |
+|---|---|---|
+| Discovery | Уточнить outcome, scope, acceptance, constraints и unknowns | Готова к materialization |
+| Task | Один самостоятельный проверяемый результат | Reviewed, accepted и merged |
+| Step | Атомарный инкремент внутри Task | Checks, один Core commit и evidence |
+| Milestone | Сквозной outcome из связанных Tasks | Required Tasks merged, validation и acceptance |
+
+## 4.1. Task lifecycle
+
+```text
+Discovery -> materialize -> Plan -> Plan Risk Audit
+-> mechanical feasibility -> execution authorization
+-> C1 handoff -> claim -> start -> Steps
+-> submit -> external-sealed review -> Result
+-> final acceptance -> merge
+```
+
+Fresh Task authorization записывает versioned mechanical-feasibility evidence. Analyzer может
+выдать `blocked`, `pass` или `unverified`. `unverified` не означает semantic approval; он означает,
+что поддерживаемая точная грамматика не доказала противоречие.
+
+## 4.2. Milestone initial assembly
+
+После materialization Milestone Core возвращает `milestone initial-assembly`. Coordinator создаёт
+linked Task Discoveries и materializes Tasks только через команды, рекламируемые `next`. После
+появления полного intended membership один `milestone plan-set` атомарно публикует state и plan.json.
+До этого execution недоступно.
+
+Каждая membership содержит:
+
+```text
+taskId
+disposition: required | waived | cancelled
+reason
+dependsOnTaskIds: [exact predecessor Task IDs]
+```
+
+Даже независимая Task обязана объявить `dependsOnTaskIds: []`. Отсутствующее поле в legacy state
+означает unknown dependency authority, а не пустой граф.
+
+## 4.3. Runnable predicate P04-A
+
+Task runnable только когда Milestone active, membership required и все canonical predecessors имеют
+status `merged`. Ordinal, название, время создания и порядок в чате не создают dependency.
+
+Один predicate применяется к repository routing, Task-specific routing, handoff preparation,
+claim до lease acquisition и direct start. Authorization не обходит dependency block.
+
+# 5. Delegated approval и Milestone autonomy
+
+Delegation не превращает agent в human actor. Event отдельно хранит principal, delegate, grant,
+policy hash, transition, scope и expiry.
+
+| Механизм | Когда применять | Что не разрешает |
+|---|---|---|
+| Direct human gate | Default path | Никакой последующей автономии |
+| DGA/DGR delegated approval | Exact allow-listed approval transition | Scope expansion, grant issuance, обычные execution transitions |
+| Milestone Autonomy Contract | После полного initial Milestone Plan | Outcome/check/base/discovery changes и standalone map approval |
+
+Для нового `AUTO` Discovery допустим короткий project-scoped DGR, если нужен exact
+`project_memory.approve` или будущий approval transition. Blocking semantic unknown всегда возвращается
+пользователю. После полного initial Milestone Plan предпочтителен один bounded
+`milestone autonomy-prepare` gate и отдельное подтверждение `MAC-*`, затем `autonomy-grant`.
+
+Milestone Autonomy Contract покрывает разрешённые Task/Milestone approvals, membership-only evolve и
+Project Memory approval только внутри atomic Task context refresh этого Milestone. Grant не применяется
+к handoff, claim, run, step-complete, reviews, sync-base или merge.
+
+# 6. Codex App chat topology
+
+Milestone coordinator и Task chats являются отдельными user-visible Codex tasks, не fork одного
+conversation. Coordinator создаёт Task chat just-in-time, передаёт закрытый TaskContextPacket и
+остаётся активным supervisor до terminal Milestone либо настоящего user gate.
+
+```text
+Coordinator
+  -> Task T01 chat
+       -> Step Review chat при external-sealed gate
+       -> Final Review chat
+       -> Corrective/Plan Audit chat при необходимости
+  -> status -> next -> milestone progress
+  -> следующий runnable Task chat
+```
+
+Project chat registry атомарно выдаёт monotonic `#NNN`. Название всегда содержит membership ordinal и
+полный entity ID. Sidebar count, creation order и ручное `01/02` не являются authority.
+
+Coordinator ждёт routed Task через bounded waits, читает закрытый CoordinatorReport, затем проверяет
+repository `status -> next`. Завершение дочернего чата само по себе не доказывает terminal Task.
+
+# 7. C1 handoff, lease и Git ownership
+
+`task handoff-prepare` возвращает одноразовый `credentialHandoff`. Он используется ровно один раз
+целевым actor в `task claim`. Claim проверяет Task/Milestone dependency binding и только затем выдаёт
+`writerLeaseReceipt`. `task run` обновляет активный lease и возвращает Step context.
+
+Bearer credentials нельзя печатать, сохранять в файлы, передавать Reviewer или включать в evidence.
+Если token утерян, используется только рекламируемая credential recovery transition.
+
+Worker меняет только `allowedWrites` и оставляет изменения uncommitted. Coordinator вызывает точный
+`task step-complete`; Core запускает checks, проверяет scope/history, создаёт один commit и evidence.
+
+# 8. Knowledge Map и context refresh
+
+Project Knowledge Map хранит paths, categories, scope, authority, hashes, gaps и conflicts, но не
+копирует содержимое файлов. Scan является read-only. Reconcile и approve выполняются только через Core.
+
+Если top-level `next` возвращает `task context-refresh`, Coordinator вызывает только эту atomic
+transition с указанными revisions, actor и grant. Standalone reconcile перед ней создаёт human-approval
+gap и блокируется.
+
+Кроме content-only drift, Core может допустить exact supporting-source addition, заранее объявленное
+execution-authorized Plan и покрытое тем же Milestone Autonomy Contract. Unsafe differences возвращают
+обычный видимый reconcile/approve/rebind/reauthorize flow.
+
+# 9. Review и corrective recovery
+
+В Codex App strict review выполняется external-sealed:
+
+1. Core формирует read-only review packet и repository seal.
+2. Task chat создаёт отдельный Reviewer chat.
+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.
+
+beta.11 `task plan-integrity-recover` существует для одного первого checks-failed legacy/late case:
+отсутствует exact root npm script и текущий Step не может изменить package.json. Recovery не меняет
+worktree или Plan и не создаёт synthetic second failure; он записывает bound `replan-required`.
+
+> **Стоп P04-A:** `split-required` возвращает `STRUCTURAL_REPLACEMENT_REQUIRED` и `structuralReplacementAvailable=false`. Нельзя вызывать retained replacement command, потреблять replacement Discovery или вручную менять topology. Продолжение возможно только после P04-B/P05.
+
+# 10. Operational checklist
+
+- exact package version установлен, bundled gateway соответствует release и переустановлен;
+- handshake подтверждает protocol 2, state schema 2 и beta.11 capabilities;
+- каждый mutation следует свежему `status -> next` и exact option contract;
+- semantic unknowns и human gates не маскируются delegation;
+- Task chats создаёт coordinator, credentials остаются только в памяти;
+- dependencies, progress и review posture берутся из Core projections;
+- local state не редактируется вручную; release и package update выполняются только после safe preflight и обязательных checks.

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

@@ -0,0 +1,334 @@
+---
+title: Codex Workflow V2: delegated chat-only guide
+subtitle: Актуальный beta.11 путь от нового Discovery до принятого Milestone без ручного CLI
+part: Часть 2 из 3 | Практика
+document_version: 2.0
+date: 24 августа 2026
+subject: Практическое руководство по delegated Discovery и Milestone в Workflow V2 beta.11
+---
+
+# 1. Рабочая модель beta.11
+
+Пользователь работает в одном Codex Project и формулирует продуктовый outcome. Coordinator выполняет
+CLI, создаёт отдельные Task/Reviewer chats и ведёт supervision loop. Workflow Core остаётся authority
+для lifecycle, revisions, credentials, dependencies и Git commits.
+
+> **Золотое правило:** текст промпта задаёт intent и ограничения, но не разрешает transition. Перед каждой мутацией агент использует exact project-local package, успешные `status` и свежий `next`.
+
+Delegated mode уменьшает количество approval pauses, но не делегирует смысловые продуктовые решения.
+Blocking unknown, scope change, grant issuance или unrecoverable integrity conflict возвращаются
+пользователю.
+
+## 1.1. Что делает пользователь
+
+- подключает правильную папку как primary project folder;
+- задаёт outcome, scope, acceptance и ограничения;
+- отдельным сообщением подтверждает DGA/MAC issuance codes;
+- отвечает на semantic unknowns и human-only scope changes;
+- проверяет terminal Result и при необходимости отзывает grant.
+
+## 1.2. Что делает Coordinator
+
+- проверяет AGENTS.md, exact package, handshake, status и next;
+- проводит Discovery без materialization при blocking unknowns;
+- собирает complete Milestone Plan с explicit dependencies;
+- создаёт Task chats just-in-time через project registry;
+- хранит bearer credentials только в памяти;
+- supervises routed Task до terminal Workflow state;
+- выполняет Milestone validation и exact final gate.
+
+# 2. Подготовка проекта перед новым Discovery
+
+1. Убедитесь, что checkout чистый и выбран правильный repository root.
+2. Установите beta.11 как точную devDependency после публикации release.
+3. Обновите и переустановите bundled `codex-workflow-gateway` этого release.
+4. Проверьте, что declared и installed package versions равны.
+5. Запустите новый Coordinator chat, не fork старого Milestone conversation.
+
+```text
+Минимальная session sequence агента:
+
+AGENTS.md
+-> project-local gateway resolution
+-> gateway handshake
+-> status
+-> next
+-> doctor только как дополнительная диагностика
+```
+
+Handshake beta.11 должен сообщать `packageVersion=2.0.0-beta.11`, `protocolVersion=2`,
+`stateSchemaVersion=2`, dependency DAG, initial Plan transaction, mechanical feasibility,
+Milestone autonomy и structural replacement disabled capabilities.
+
+# 3. Два уровня delegation
+
+Для нового `AUTO` Milestone до появления MS-ID может понадобиться короткий project-scoped DGR.
+Он используется только для allow-listed approval transitions, которые fresh `next` признал eligible.
+После полного initial Milestone Plan предпочтителен bounded Milestone Autonomy Contract.
+
+| Фаза | Authority | Назначение |
+|---|---|---|
+| До entity ID / во время Discovery | Human intent, опциональный project DGR | Knowledge Map и exact allow-listed approvals |
+| Complete initial Milestone Plan | Human `MAC-*` confirmation | Выдать bounded Milestone autonomy grant |
+| Task execution | C1 handoff/claim и Core routing | Не использует approval grant как writer credential |
+| Semantic change | Human scope-change gate | Outcome, success signal, checks, acceptance, discovery, base |
+
+## 3.1. Опциональный bootstrap DGR для AUTO
+
+Grant issuance всегда занимает два пользовательских сообщения. Agent не может сам выдать, расширить
+или продлить grant.
+
+```text
+ПОДГОТОВКА POLICY В ОТДЕЛЬНОМ ЧАТЕ
+
+Подготовь краткоживущую delegated approval policy для нового AUTO Milestone.
+Principal: user:owner.
+Delegate: agent:milestone-coordinator.
+Scope: текущий project.
+Разрешённые transitions перечисли явно и минимально из:
+project_memory.approve,
+milestone.execution_authorize,
+milestone.final_accept,
+task.execution_authorize,
+task.final_accept.
+
+Выполни только delegation prepare. Покажи полный scope, transitions,
+expiresAt, policyHash и DGA-code. Остановись. Grant в этом turn не выпускай.
+```
+
+```text
+ОТВЕТ ПОЛЬЗОВАТЕЛЯ СЛЕДУЮЩИМ СООБЩЕНИЕМ
+
+Одобряю exact policyHash <POLICY-HASH> и DGA-code <DGA-CODE>.
+Выпусти grant, затем покажи DGR-ID, delegate, scope, transitions,
+expiresAt и revision.
+```
+
+Перед использованием DGR Coordinator выполняет `delegation show` и сверяет project, active status,
+delegate, scope, transitions и expiry. DGR передаётся только если тот же `next` вернул exact
+`delegatedApprovalOptions` для этого grant и transition.
+
+# 4. Копируемый prompt: новый delegated Discovery
+
+Этот prompt запускает Coordinator. Пользователь не должен заранее открывать Task chats или назначать
+их номера.
+
+```text
+НОВЫЙ COORDINATOR CHAT
+
+Проведи новый Milestone через Codex Workflow V2 beta.11 в delegated режиме.
+Repository: <ABSOLUTE-REPOSITORY-ROOT>.
+Milestone ID: AUTO.
+Delegate actor: agent:milestone-coordinator.
+Bootstrap delegation grant: <DGR-ID или NONE>.
+
+Пользовательский outcome: <OUTCOME>.
+Начальные ограничения: <CONSTRAINTS>.
+
+Начни с AGENTS.md, exact project-local gateway, handshake, status и next.
+Проверь declared/installed package version и protocol/state schema. Если
+указан DGR-ID, выполни delegation show и проверь его точные bindings.
+Не создавай, не расширяй и не продлевай grant.
+
+Проведи Discovery: outcome, success signal, scope, out-of-scope,
+acceptance, constraints и blocking unknowns. Не materialize сущности,
+пока остаётся semantic ambiguity. Не принимай продуктовые решения за
+пользователя.
+
+После готового Discovery следуй только fresh next. Во время milestone
+initial-assembly materialize все intended linked Tasks, затем один раз
+опубликуй complete Milestone Plan. Для каждой membership явно укажи
+required/waived/cancelled, reason и dependsOnTaskIds, включая [] для
+независимой Task. Не выводи dependencies из ordinal или названия.
+
+Когда fresh next предложит milestone autonomy-prepare, подготовь один
+bounded Milestone Autonomy Contract, покажи полный semantic binding,
+expiry, policyHash и MAC-code и остановись. Не выполняй autonomy-grant
+в том же turn.
+
+После отдельного exact human confirmation продолжай как active
+Coordinator. Создавай Task chats just-in-time как новые standalone Codex
+tasks через project chat registry, никогда fork/handoff текущего чата.
+Передавай только закрытый TaskContextPacket без transcript и bearer
+credentials. Supervise routed Task до terminal Workflow result, затем
+проверяй status, next и milestone progress перед следующей Task.
+
+Используй C1 handoff/claim, external-sealed reviewers и exact recovery
+routes. Не печатай claim/writer tokens. При split-required остановись на
+STRUCTURAL_REPLACEMENT_REQUIRED: P04-A replacement не реализует.
+
+После merge всех required Tasks выполни Milestone validation на чистом
+base HEAD. Final acceptance выполняй только по exact eligible grant и
+текущему MSA-code; иначе покажи полный requiredHumanGate и остановись.
+```
+
+<!-- pagebreak -->
+
+## 4.1. Что должно получиться до autonomy gate
+
+- Discovery без blocking unknowns;
+- materialized Milestone и все intended linked Tasks;
+- complete membership Plan без reverse-membership gaps;
+- explicit `dependsOnTaskIds[]` для каждой membership;
+- checks и acceptance, связанные с outcome и success signal;
+- один свежий `next`, рекламирующий `milestone autonomy-prepare`;
+- MAC policy с principal, delegate, expiry, semantic scope hash и code;
+- отсутствие product Step execution в Coordinator chat.
+
+## 4.2. Подтверждение Milestone Autonomy Contract
+
+```text
+ОТВЕТ ПОЛЬЗОВАТЕЛЯ В СЛЕДУЮЩЕМ СООБЩЕНИИ
+
+Одобряю показанный Milestone Autonomy Contract для <MS-ID>,
+policyHash <POLICY-HASH>, semanticScopeHash <SCOPE-HASH>
+и MAC-code <MAC-CODE>. Выполни только рекламируемый autonomy-grant
+с этими exact bindings и продолжи Milestone supervision.
+```
+
+Если fresh `next` изменил revision, Plan hash, policy hash или MAC-code, старое подтверждение нельзя
+использовать. Coordinator показывает новый gate.
+
+# 5. Initial assembly и dependency routing
+
+Во время initial assembly Coordinator выполняет последовательные checkpoint pairs. После каждой
+mutation он ждёт успешный `status`, затем fresh `next`. Параллельный status/next и direct closing
+`milestone plan-set` после failed checkpoint запрещены.
+
+```text
+Discovery materialize Milestone
+-> next: milestone initial-assembly
+-> linked Task Discovery start/update/materialize
+-> status -> next
+-> повторить для intended membership
+-> один complete milestone plan-set
+-> autonomy prepare / direct authorization
+```
+
+P04-A вычисляет полный runnable set. Task может стать actionable только когда каждый declared required
+predecessor merged. Sequential scheduler выбирает из runnable set, но не добавляет искусственные edges.
+
+Coordinator печатает `milestone progress` после старта/resume, каждой terminal/attention Task boundary и
+membership change. Таблица берётся из Core, а не из памяти чата.
+
+# 6. Автоматическое создание Task chats
+
+Coordinator создаёт Task chat только когда repository-level `next` назвал exact actionable Task.
+Нельзя заранее создавать пустые chats для всех memberships.
+
+Registry title имеет одну из форм:
+
+```text
+#NNN · M<NN>/T<NN> · Task · <Task title> · <TASK-ID>
+#NNN · M<NN>/T<NN>/S<NN> · Step Review A<N> · <Step title> · <TASK-ID>
+#NNN · M<NN>/T<NN> · Final Review A<N> · <Task title> · <TASK-ID>
+```
+
+TaskContextPacket содержит только repository root, exact package requirement, Milestone/Task IDs и
+ordinals, Task revision/title/objective, requirement/acceptance IDs, Brief/Plan hashes, нужный actor/grant,
+Task-local scope/checks/stop conditions и обязательную session sequence. В packet никогда не включаются
+Coordinator transcript, sibling Plans, reasoning, confirmation codes или credentials.
+
+Task chat продолжает через planning, execution, reviews, recovery, acceptance и merge, пока fresh
+navigation разрешает действия. На blocker/terminal boundary он возвращает non-secret CoordinatorReport.
+
+# 7. C1 writer credentials
+
+Credential и approval grant решают разные задачи.
+
+1. `task handoff-prepare` возвращает first-field `credentialHandoff`.
+2. Coordinator сохраняет one-time token только в working memory.
+3. Target Task actor выполняет exact `task claim` с этим token.
+4. Claim проверяет dependency binding и возвращает `writerLeaseReceipt`.
+5. `task run` принимает active writer credential согласно `next.writerTokenContract` и обновляет lease.
+6. `task step-complete`, review record и другие guarded mutations используют только рекламируемый option.
+
+Нельзя искать token в later payload fields, писать его в prompt/report/evidence или заменять redacted
+fingerprint. Потеря token не разрешает новый handoff либо lease acquisition вне fresh recovery route.
+
+# 8. Plan, Knowledge Map и mechanical feasibility
+
+Перед `task plan-set` Planner копирует exact requirement/acceptance IDs из `next.taskPlanContract`.
+Каждый Step объявляет dependencies, exact outputs, allowedWrites, forbiddenScope и executable checks.
+Knowledge files, которые будут созданы, указываются как exact `knowledgeTargets`.
+
+Plan Risk Audit определяет guarded Steps до execution. Fresh authorization запускает bounded mechanical
+analyzers. Подтверждённое противоречие, например отсутствующий exact root npm script без ответственного
+manifest writer, возвращает Plan на `task plan-set` без authorization write.
+
+`unverified` analyzer result не доказывает Plan и не блокирует unsupported semantics. Planner и human/delegate
+approval остаются ответственными за смысловую достаточность.
+
+# 9. Atomic context refresh
+
+Когда top-level `next.action` равен `task context-refresh`, нельзя сначала выполнять standalone
+`project-memory reconcile`. Coordinator вызывает только указанный atomic action с exact Task/map revisions,
+actor и Milestone Autonomy Grant.
+
+Core может разрешить:
+
+- content-only drift без semantic map changes;
+- exact Plan-bounded supporting-source addition, если её заранее объявил current Plan;
+- одновременные reconcile, approve, rebind и reauthorize как одну transaction.
+
+Category, scope, authority, conflicts, gaps или unsafe source changes переходят в обычный visible
+Knowledge Map approval path. Milestone grant не разрешает standalone map approval.
+
+# 10. External-sealed review
+
+В Codex App нельзя запускать nested local reviewer как substitute для независимого процесса.
+
+| Gate | Правильный путь |
+|---|---|
+| 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 |
+
+Reviewer получает неизменённый packet, проверяет exact commit/diff/evidence и возвращает closed JSON.
+Task chat записывает его только при совпадении packet и repository seal hashes. Reviewer не исправляет код,
+не применяет grant и не принимает Result.
+
+# 11. Recovery без micro-patching
+
+| Состояние | Действие |
+|---|---|
+| 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 |
+| `split-required` | Stop: `STRUCTURAL_REPLACEMENT_REQUIRED`, никаких replacement writes |
+| `stop-escalate` или third corrective failure | Terminal hard stop и user attention |
+| Stale dependency binding | Новый handoff/claim только по fresh `next` |
+| Review seal drift | Discard review и создать fresh packet |
+
+Plan-integrity recovery не редактирует Plan, package.json или worktree и не синтезирует второй failure.
+P04-A не переносит completed Steps и не rewires dependencies при split.
+
+# 12. Milestone final acceptance
+
+После merge всех required Tasks Coordinator проверяет clean base HEAD и выполняет рекламируемую
+Milestone validation. `next` возвращает revision, Plan/Result/evidence hashes, validated HEAD и MSA-code.
+
+При active eligible `milestone.final_accept` grant delegate может применить current code в том же turn:
+контролирующим human decision является прежний grant issuance. Если exact option отсутствует, Coordinator
+показывает полный `requiredHumanGate` и останавливается до следующего сообщения пользователя.
+
+# 13. Standalone Task
+
+Standalone Task не использует Milestone dependency DAG или Milestone Autonomy Contract. Она начинает с
+Discovery, следует Task Plan/authorization/C1/review lifecycle и использует direct human gates либо exact
+Task/project DGR. `dependencyBinding` для standalone handoff равен null.
+
+# 14. Итоговый checklist пользователя
+
+- beta.11 exact package и новый bundled gateway установлены;
+- новый Coordinator chat не является fork старого Milestone;
+- bootstrap DGR, если нужен, выдан отдельным exact human confirmation;
+- Discovery не materialized при blocking unknowns;
+- complete initial Plan содержит dependencies для каждой membership;
+- Milestone Autonomy Contract подтверждён отдельным MAC turn;
+- Coordinator сам создаёт и supervises Task/Reviewer chats;
+- credentials не появились в prompts, reports или files;
+- каждый transition пришёл из fresh `next`;
+- split-required остановился без replacement mutations;
+- Milestone validation и final acceptance связаны с текущим clean base HEAD.