codex-workflow-v2 2.0.0-beta.10 → 2.0.0-beta.12

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.12 путь от нового Discovery до принятого Milestone без ручного CLI
+part: Часть 2 из 3 | Практика
+document_version: 2.0
+date: 27 августа 2026
+subject: Практическое руководство по delegated Discovery и Milestone в Workflow V2 beta.12
+---
+
+# 1. Рабочая модель beta.12
+
+Пользователь работает в одном 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.12 как точную 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.12 должен сообщать `packageVersion=2.0.0-beta.12`, `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.12 в 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` |
+| 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 не исправляет код,
+не применяет grant и не принимает Result.
+
+# 11. Recovery без micro-patching
+
+| Состояние | Действие |
+|---|---|
+| First proven impossible npm check после legacy/late authorization | Только рекламируемый `task plan-integrity-recover` |
+| 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 |
+| Explicit `stop-escalate` | Terminal 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.12 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.