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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -90,7 +90,7 @@ uses the grant and passes `--delegation-grant` to the Core transition.
90
90
 
91
91
  Ordinary semantic Milestone scope changes remain journaled, human-only lifecycle actions. A
92
92
  contract delegate may evolve only the membership graph inside the cryptographically bound
93
- semantic scope. The separate beta.12.10 `milestone remediation-materialize` route is not delegation
93
+ semantic scope. The separate beta.12.11 `milestone remediation-materialize` route is not delegation
94
94
  and does not widen this allow-list: Core derives it only from a current blocking Plan Risk Audit and
95
95
  a previously authorized active Milestone. Its topology effect is fixed to one new required upstream
96
96
  Task plus one dependency edge, with all Milestone semantics preserved. The resulting
@@ -1,10 +1,10 @@
1
1
  ---
2
- title: Codex Workflow V2: архитектура beta.12.10
2
+ title: Codex Workflow V2: архитектура beta.12.11
3
3
  subtitle: Источники истины, lifecycle, роли, delegation, зависимости Tasks и границы доверия
4
4
  part: Часть 1 из 3 | Архитектура
5
5
  document_version: 2.0
6
6
  date: 31 августа 2026
7
- subject: Архитектура и границы Codex Workflow V2 beta.12.10
7
+ subject: Архитектура и границы Codex Workflow V2 beta.12.11
8
8
  ---
9
9
 
10
10
  # 1. Назначение и граница системы
@@ -18,7 +18,7 @@ Codex Workflow V2 - локальный state machine поверх Codex App, Git
18
18
  Система рассчитана на одного пользователя и одну машину. Она не предоставляет distributed locking,
19
19
  криптографическую идентификацию actor string или безопасную синхронизацию state между компьютерами.
20
20
 
21
- ## 1.1. Что beta.12.10 гарантирует
21
+ ## 1.1. Что beta.12.11 гарантирует
22
22
 
23
23
  - exact project-local npm package и совместимый handshake до lifecycle действий;
24
24
  - Discovery до materialization Task или Milestone;
@@ -41,7 +41,7 @@ Codex Workflow V2 - локальный state machine поверх Codex App, Git
41
41
  один additive remediation Task без нового Human gate; Core сохраняет Milestone semantics и выводит
42
42
  authority из текущей Milestone authorization и exact audit evidence.
43
43
 
44
- ## 1.2. Что beta.12.10 не гарантирует
44
+ ## 1.2. Что beta.12.11 не гарантирует
45
45
 
46
46
  - правильность продуктовой идеи или автоматически выбранного provider Task;
47
47
  - semantic sufficiency Plan, если точные факты нельзя доказать поддерживаемым analyzer;
@@ -296,7 +296,7 @@ beta.12.9 закрывает исторический provenance gap corrective
296
296
  регистрирует dependency и historical authority одной revision. Оба пути сохраняют dirty bytes текущего
297
297
  Step, не переписывают Git и завершаются fresh обычным `step-complete` flow.
298
298
 
299
- beta.12.10 закрывает иной класс тупика до начала выполнения. Если current Plan Risk Audit required Task
299
+ beta.12.11 закрывает иной класс тупика до начала выполнения. Если current Plan Risk Audit required Task
300
300
  записал `stop-escalate`, потому что нужной upstream capability нет в scope этой Task, Core рекламирует
301
301
  audited remediation. Coordinator сначала формализует capability обычным Discovery. Затем одна Project
302
302
  transaction append-only создаёт required remediation Task на exact merged predecessor frontier исходной
@@ -307,6 +307,13 @@ memberships. Scope-change event связан с Task revision, Brief/Plan и aud
307
307
  обычный Plan, audit, C1, commits и reviews. После её merge исходная Task обязана заменить отвергнутый Plan,
308
308
  пройти fresh audit и продолжить Step. Final Milestone acceptance не выводится автоматически.
309
309
 
310
+ Dependency-only update не должен создавать промежуточный Human gate. Если stale Knowledge отличается
311
+ только content hash `package.json`, все package surfaces уже равны runtime version, checkout clean, а
312
+ каждый Git commit, менявший `package.json` после approved hash, затрагивает ровно manifest/lock и только
313
+ Workflow pin, Core переносит reconcile и `corrective-derived` approval внутрь той же atomic remediation
314
+ transaction. Изменение любого другого Knowledge source, classification, gap или conflict fail-closed
315
+ остаётся в обычном явном approval flow.
316
+
310
317
  Docker socket `EPERM` в sandbox не является доказательством сломанного daemon. Gateway один раз
311
318
  повторяет exact health probe или Plan check с sandbox escalation без расходования remediation attempt.
312
319
  Restart Docker Desktop требует отдельного разрешения и допустим только после escalated daemon failure.
@@ -316,7 +323,7 @@ Restart Docker Desktop требует отдельного разрешения
316
323
  # 10. Operational checklist
317
324
 
318
325
  - exact package version установлен, bundled gateway соответствует release и переустановлен;
319
- - handshake подтверждает protocol 2, state schema 2 и beta.12.10 capabilities;
326
+ - handshake подтверждает protocol 2, state schema 2 и beta.12.11 capabilities;
320
327
  - каждый mutation следует свежему `status -> next` и exact option contract;
321
328
  - Docker permission failure сначала классифицируется как sandbox boundary, а не как infra retry;
322
329
  - semantic unknowns и human gates не маскируются delegation;
@@ -1,13 +1,13 @@
1
1
  ---
2
2
  title: Codex Workflow V2: delegated chat-only guide
3
- subtitle: Актуальный beta.12.10 путь от нового Discovery до принятого Milestone без ручного CLI
3
+ subtitle: Актуальный beta.12.11 путь от нового Discovery до принятого Milestone без ручного CLI
4
4
  part: Часть 2 из 3 | Практика
5
5
  document_version: 2.0
6
6
  date: 31 августа 2026
7
- subject: Практическое руководство по delegated Discovery и Milestone в Workflow V2 beta.12.10
7
+ subject: Практическое руководство по delegated Discovery и Milestone в Workflow V2 beta.12.11
8
8
  ---
9
9
 
10
- # 1. Рабочая модель beta.12.10
10
+ # 1. Рабочая модель beta.12.11
11
11
 
12
12
  Пользователь работает в одном Codex Project и формулирует продуктовый outcome. Coordinator выполняет
13
13
  CLI, создаёт отдельные Task/Reviewer chats и ведёт supervision loop. Workflow Core остаётся authority
@@ -40,7 +40,7 @@ Blocking unknown, scope change, grant issuance или unrecoverable integrity co
40
40
  # 2. Подготовка проекта перед новым Discovery
41
41
 
42
42
  1. Убедитесь, что checkout чистый и выбран правильный repository root.
43
- 2. Установите beta.12.10 как точную devDependency после публикации release.
43
+ 2. Установите beta.12.11 как точную devDependency после публикации release.
44
44
  3. Обновите и переустановите bundled `codex-workflow-gateway` этого release.
45
45
  4. Проверьте, что declared и installed package versions равны.
46
46
  5. Запустите новый Coordinator chat, не fork старого Milestone conversation.
@@ -56,7 +56,7 @@ AGENTS.md
56
56
  -> doctor только как дополнительная диагностика
57
57
  ```
58
58
 
59
- Handshake beta.12.10 должен сообщать `packageVersion=2.0.0-beta.12.10`, `protocolVersion=2`,
59
+ Handshake beta.12.11 должен сообщать `packageVersion=2.0.0-beta.12.11`, `protocolVersion=2`,
60
60
  `stateSchemaVersion=2`, dependency DAG, initial Plan transaction, mechanical feasibility,
61
61
  Milestone autonomy и structural replacement disabled capabilities.
62
62
 
@@ -117,7 +117,7 @@ delegate, scope, transitions и expiry. DGR передаётся только е
117
117
  ```text
118
118
  НОВЫЙ COORDINATOR CHAT
119
119
 
120
- Проведи новый Milestone через Codex Workflow V2 beta.12.10 в delegated режиме.
120
+ Проведи новый Milestone через Codex Workflow V2 beta.12.11 в delegated режиме.
121
121
  Repository: <ABSOLUTE-REPOSITORY-ROOT>.
122
122
  Milestone ID: AUTO.
123
123
  Delegate actor: agent:milestone-coordinator.
@@ -315,7 +315,7 @@ Task chat записывает его только при совпадении p
315
315
  Plan-integrity recovery не редактирует Plan, package.json или worktree и не синтезирует второй failure.
316
316
  P04-A не переносит completed Steps и не rewires dependencies при split.
317
317
 
318
- Audited remediation beta.12.10 не является generic scope-change. Coordinator использует только exact
318
+ Audited remediation beta.12.11 не является generic scope-change. Coordinator использует только exact
319
319
  route из fresh `next`: создаёт Discovery для доказанной отсутствующей upstream capability, доводит его
320
320
  до ready и вызывает `milestone remediation-materialize` с текущими revisions и exact
321
321
  `requiredPredecessorTaskIds`. Core не принимает новый Milestone Plan: сохраняет outcome/success signal,
@@ -326,6 +326,13 @@ acceptance/checks и старые memberships, append-only добавляет о
326
326
  Audit и как минимум следующему Step. Dirty checkout, lease/transaction, stale audit, started Task,
327
327
  неполный predecessor frontier или повторное использование audit означают hard stop.
328
328
 
329
+ После обновления package fresh `next` может добавить
330
+ `auditedRemediation.dependencyKnowledgeRefresh`. Продолжайте без Human approval только при
331
+ `eligible=true`: Core доказал clean checkout, exact aligned version surfaces, единственный изменённый
332
+ Knowledge path `package.json` и dependency-only Git chain. Refresh будет применён атомарно во время
333
+ `milestone remediation-materialize`. Если объект отсутствует или содержит blockers, не маскируйте
334
+ документационный/product drift под update — используйте обычный Project Knowledge flow.
335
+
329
336
  `task downstream-proof-recover` также не редактирует product files и не создаёт новую Task. Он сохраняет
330
337
  dirty worktree/HEAD, append-only фиксирует invalidated predecessor evidence, освобождает C1 и возвращает
331
338
  текущую Task к `task plan-set`. Если fresh `next` не рекламирует этот переход, вызывать его нельзя.
@@ -375,7 +382,7 @@ Task/project DGR. `dependencyBinding` для standalone handoff равен null.
375
382
 
376
383
  # 14. Итоговый checklist пользователя
377
384
 
378
- - beta.12.10 exact package и новый bundled gateway установлены;
385
+ - beta.12.11 exact package и новый bundled gateway установлены;
379
386
  - новый Coordinator chat не является fork старого Milestone;
380
387
  - bootstrap DGR, если нужен, выдан отдельным exact human confirmation;
381
388
  - Discovery не materialized при blocking unknowns;
@@ -1,10 +1,10 @@
1
1
  ---
2
- title: Codex Workflow V2: технический справочник beta.12.10
2
+ title: Codex Workflow V2: технический справочник beta.12.11
3
3
  subtitle: Protocol 2, state schema 2, transactions, credentials, dependency authority, review и recovery
4
4
  part: Часть 3 из 3 | Technical reference
5
5
  document_version: 2.0
6
6
  date: 31 августа 2026
7
- subject: Технический контракт Codex Workflow V2 beta.12.10
7
+ subject: Технический контракт Codex Workflow V2 beta.12.11
8
8
  ---
9
9
 
10
10
  # 1. Runtime contract
@@ -13,9 +13,9 @@ Workflow V2 предоставляет локальные revisioned transitions
13
13
  и `value` либо структурированную ошибку с `code`, `message` и `details`. Chat, PDF и gateway не создают
14
14
  authority сами: mutating permission определяется runtime state и свежим `next`.
15
15
 
16
- | Параметр beta.12.10 | Значение |
16
+ | Параметр beta.12.11 | Значение |
17
17
  |---|---|
18
- | npm package | `codex-workflow-v2@2.0.0-beta.12.10` |
18
+ | npm package | `codex-workflow-v2@2.0.0-beta.12.11` |
19
19
  | protocolVersion | 2 |
20
20
  | stateSchemaVersion | 2 |
21
21
  | lifecycle epoch | 2 |
@@ -37,7 +37,7 @@ Gateway выполняет:
37
37
  5. вызов только package-local `dist/src/cli.js --repo <root>`;
38
38
  6. `gateway handshake` до lifecycle действий.
39
39
 
40
- Ключевые beta.12.10 capabilities:
40
+ Ключевые beta.12.11 capabilities:
41
41
 
42
42
  | Группа | Capabilities |
43
43
  |---|---|
@@ -402,7 +402,7 @@ exact `HEAD^`/`HEAD`, package/version surfaces и SHA-256 dirty worktree. Recove
402
402
  update-route, dependency provenance в одной Task revision. Fresh `status -> next` после transition
403
403
  должен вернуть обычный credential/`task step-complete` flow текущего Step.
404
404
 
405
- # 13.4. beta.12.10 audited remediation topology
405
+ # 13.4. beta.12.11 audited remediation topology
406
406
 
407
407
  `milestone remediation-materialize` применим только к required Task в
408
408
  `awaiting_execution_authorization`, если ни один Step не начат и последний audit текущей
@@ -435,6 +435,16 @@ Current Milestone execution authorization superseded и заменён `correcti
435
435
  mechanical feasibility, C1, Step checks/commits/reviews и final Milestone acceptance не меняются.
436
436
  После merge remediation Task исходная Task получает `task plan-set` и проходит fresh audit/authority.
437
437
 
438
+ Если перед этим exact package update сделал Knowledge Map stale, navigation может вернуть
439
+ `auditedRemediation.dependencyKnowledgeRefresh`. Eligibility требует: ранее active approved map;
440
+ inspected status `stale`; единственный изменённый Knowledge path `package.json`; clean checkout;
441
+ runtime/declared/locked/installed/HEAD/Milestone-base version равны; approved package content найден в
442
+ Git ancestry; каждый последующий commit, трогавший manifest, меняет ровно `package.json` и
443
+ `package-lock.json`, причём после удаления `codex-workflow-v2` обе JSON-структуры совпадают с parent.
444
+ Materialization тогда дополнительно пишет active Knowledge Map с revision +2 и approval mode
445
+ `corrective-derived` в той же Project transaction. Это не разрешает автоматически принимать README,
446
+ docs, commands, classification, authority, gaps или conflicts.
447
+
438
448
  # 14. P04-A structural replacement boundary
439
449
 
440
450
  Command shape `task replacement-materialize` retained только для compatibility diagnostics. Любая попытка
@@ -497,7 +507,7 @@ Docker socket/CLI `EPERM`, `operation not permitted` или `permission denied`
497
507
  После каждой successful mutation обязателен sequential `status`, затем fresh `next`. Failed status/next
498
508
  не разрешает direct mutation. Syntax help read-only и не заменяет navigation authority.
499
509
 
500
- # 18. Public command surface beta.12.10
510
+ # 18. Public command surface beta.12.11
501
511
 
502
512
  | Область | Actions |
503
513
  |---|---|
@@ -525,7 +535,7 @@ running Step и active/stale writer lease. Исключения — докуме
525
535
  active-downstream-proof bridge, beta.12.7 exact stranded-replan bridge и beta.12.9 historical-Step
526
536
  dependency bridge; все они fail-closed и не дают общего разрешения dirty update.
527
537
 
528
- Перед beta.12.10 tag обязательны `npm ci`, `npm run validate`, `npm run test:signal-remediation-e2e`, `npm run pack:check`,
538
+ Перед beta.12.11 tag обязательны `npm ci`, `npm run validate`, `npm run test:signal-remediation-e2e`, `npm run pack:check`,
529
539
  `npm run smoke:downstream`, `npm run plugin:check`, official plugin/skill validators,
530
540
  `npm run docs:pdf:check`, `npm run release:check` с exact tag binding и validation
531
541
  append-only real-agent lifecycle log.
package/docs/release.md CHANGED
@@ -28,7 +28,7 @@ The PDF check deterministically regenerates all three Russian documents from
28
28
  `docs/pdf/sources`, binds the visible package version to the root manifest, and fails when any
29
29
  tracked PDF is stale. Source and binary PDFs are one release unit.
30
30
 
31
- For beta.12.10, the release gate also relies on `npm run release:check` to fail if:
31
+ For beta.12.11, the release gate also relies on `npm run release:check` to fail if:
32
32
 
33
33
  - canonical entity schema 2 shapes drift;
34
34
  - protocol 2 is not the active public contract, or intact protocol-1 adoption evidence stops being readable through the bounded compatibility window;
@@ -22,12 +22,12 @@ state schema. Совпадение `stateSchemaVersion` до и после об
22
22
  нужна. Для alpha.6 при `stateSchemaVersion: 2` применяется не migration, а sidecar-only
23
23
  adoption posture.
24
24
 
25
- ### beta.12.10: audited remediation вместо ручной смены Milestone scope
25
+ ### beta.12.11: audited remediation и dependency-only Knowledge refresh
26
26
 
27
27
  После безопасного обновления существующий active Milestone может продолжить работу без пересоздания,
28
28
  если current `next` показывает pre-execution `stop-escalate` и объект `auditedRemediation`. Это не
29
29
  update compatibility bridge и не разрешение вручную менять state. Сначала выполните обычный
30
- `update preflight`; установите exact beta.12.10 только при `safe=true`, clean checkout, отсутствии
30
+ `update preflight`; установите exact beta.12.11 только при `safe=true`, clean checkout, отсутствии
31
31
  running Step и leases, затем снова выполните repository-local handshake, `status` и `next`.
32
32
 
33
33
  Далее следуйте только свежему route: remediation Discovery -> ready ->
@@ -40,6 +40,14 @@ repository priority и пройти обычную реализацию/review/m
40
40
  вернуться к `task plan-set`, fresh Risk Audit и следующему Step. Если fresh `next` не рекламирует этот
41
41
  контракт, не вызывайте команды напрямую и не редактируйте Milestone state.
42
42
 
43
+ Если exact dependency-only update сделал approved Knowledge Map stale только по `package.json`,
44
+ `auditedRemediation.dependencyKnowledgeRefresh` должен подтвердить clean checkout, aligned
45
+ declared/locked/installed/HEAD/base versions и полную Git-цепочку commits, меняющих только Workflow pin
46
+ в `package.json`/lock. Такой content refresh не требует Human approval: он применяется в той же Project
47
+ transaction, что и `milestone remediation-materialize`, с `corrective-derived` evidence. Любой другой
48
+ Knowledge diff (включая README, документацию, classification, gap или conflict) не допускается в этот
49
+ маршрут и остаётся в обычном reconcile/approval flow.
50
+
43
51
  ### Исключение для lifecycle-дедлока alpha.6
44
52
 
45
53
  Обычный `update preflight` намеренно блокирует обновление при `in_progress` Step. Если alpha.6
@@ -1,105 +1,113 @@
1
- # V2 beta.12.10 Validation Report
1
+ # V2 beta.12.11 Validation Report
2
2
 
3
- Release candidate `2.0.0-beta.12.10` was validated on 2026-08-31 (Europe/Moscow) with
3
+ Release candidate `2.0.0-beta.12.11` was validated on 2026-08-31 (Europe/Moscow) with
4
4
  Node.js 24.17.0.
5
5
 
6
6
  ## Automated release evidence
7
7
 
8
- - `npm ci` completed from the exact lockfile with 0 reported vulnerabilities.
9
- - `npm run validate` passed typecheck and `344/344` sequential tests with no failures, skips,
10
- cancellations, or todos in 2,087,253.659208 ms.
11
- - `npm run test:signal-remediation-e2e` passed the focused Signal-shaped end-to-end scenario.
12
- The test starts from an active Milestone whose required Task has a current `stop-escalate` Plan
13
- Risk Audit, materializes one audited upstream remediation Task, completes its Plan/audit/C1/Step/
14
- review/accept/merge lifecycle, replans the original Task, and completes a later Step there.
15
- - Negative coverage rejects a non-exact predecessor frontier, duplicate remediation, stale revisions,
16
- non-required or non-active Milestone posture, topology drift, reused audit evidence, and ordinary
17
- standalone/post-execution `stop-escalate` cases that must keep the existing `task plan-set` route.
18
- - The complete lifecycle inventory names `milestone remediation-materialize` and
19
- `WorkflowService.materializeAuditedRemediationTask`; read-only purity, transaction rollback/
20
- roll-forward, concurrent writers, credentials, Core receipts and prior Signal compatibility tests
21
- all passed.
22
- - Package dry-run produced `codex-workflow-v2-2.0.0-beta.12.10.tgz` with 278 files, 1,050,219 bytes
23
- packed and 4,196,113 bytes unpacked. The broad `docs` package allowlist was narrowed so the
24
- repository-local `docs/quality` observation journal cannot enter the tarball. The first invocation
25
- encountered a root-owned user npm cache (`EPERM`); the exact retry used an isolated temporary cache.
8
+ - `npm ci` completed from the exact lockfile. No dependency version changed outside the release pin.
9
+ - `npm run validate` passed typecheck and `345/345` sequential tests with no failures, skips,
10
+ cancellations, or todos in 1,974,837.33 ms.
11
+ - `npm run test:signal-remediation-e2e` passed two focused scenarios. The positive E2E starts with an
12
+ approved Knowledge Map bound to beta.12.9, commits an exact dependency-only update to beta.12.11,
13
+ proves the stale map from Git and all version surfaces, materializes an audited upstream remediation
14
+ Task, completes its Plan/audit/C1/Step/review/accept/merge lifecycle, replans the original Task, and
15
+ completes a later Step there. The negative E2E changes README and proves that unrelated Knowledge
16
+ drift is not auto-approved while standalone reconcile remains executable.
17
+ - Existing negative coverage still rejects non-exact predecessor frontiers, duplicate remediation,
18
+ stale revisions, non-required or non-active Milestone posture, topology drift, reused audit evidence,
19
+ unsafe Knowledge paths, classification/gap/conflict drift, dirty checkouts, unaligned package
20
+ surfaces and wider Git commits.
21
+ - Package dry-run produced `codex-workflow-v2-2.0.0-beta.12.11.tgz` with 278 files, 1,057,906 bytes
22
+ packed and 4,224,300 bytes unpacked. The tarball excludes repository-local `docs/quality`. The first
23
+ invocation encountered a root-owned user npm cache (`EPERM`); the exact retry passed with an isolated
24
+ temporary cache.
26
25
  - `npm run smoke:downstream` built and installed the tarball in a disposable consumer project and
27
- returned `ok=true`. The sandboxed attempt could not resolve npm (`ENOTFOUND`); the same command
28
- passed with network access.
29
- - `npm run plugin:check` passed for bundled gateway
30
- `0.1.0+codex.20260830183000`.
31
- - `npm run docs:pdf:check` reported an empty stale set and exact beta.12.10 package binding.
32
- - `RELEASE_TAG=v2.0.0-beta.12.10 npm run release:check` and `git diff --check` passed after this
33
- report and the exact package allowlist were recorded.
34
-
35
- ## Root cause corrected by beta.12.10
36
-
37
- An active Milestone could reach a genuine pre-execution dead end when a required Task's current Plan
38
- Risk Audit truthfully returned `stop-escalate` because an upstream capability did not exist. The old
39
- choices were insufficient: replanning the same Task could not manufacture the missing capability,
40
- while the generic scope-change path required a separate human approval and permitted a much wider
41
- semantic change than the evidence justified.
42
-
43
- The problem was missing bounded topology authority, not an insufficient number of implementation or
44
- review attempts. Repeating the blocked Task could only reproduce the same unmet prerequisite.
26
+ returned `ok=true`. The sandboxed attempt could not resolve npm (`ENOTFOUND`); the same command passed
27
+ with network access.
28
+ - `npm run plugin:check` passed for bundled gateway `0.1.0+codex.20260830183000`.
29
+ - `npm run docs:pdf:check` reported an empty stale set and exact beta.12.11 package binding.
30
+ - `RELEASE_TAG=v2.0.0-beta.12.11 npm run release:check` and `git diff --check` passed.
31
+
32
+ ## Root causes corrected
33
+
34
+ beta.12.10 added the bounded audited-remediation topology for a required pre-execution Task whose
35
+ current Plan Risk Audit truthfully returned `stop-escalate` because an upstream capability was absent.
36
+ Real installation in Signal exposed a second deadlock before that route could run:
37
+
38
+ 1. the dependency-only package commit changed the approved `package.json` content hash;
39
+ 2. repository `next` correctly observed stale Project Knowledge and advertised standalone reconcile;
40
+ 3. standalone reconcile tried to discover a delegated Task context owner;
41
+ 4. the same blocking Plan Risk Audit rejected that inspection, so the advertised transition could not
42
+ execute; and
43
+ 5. even an ordinary reconcile would have required a Human approval and Task rebind that invalidated the
44
+ exact audit binding needed by remediation.
45
+
46
+ The primary defect was incomplete composition between package update, Knowledge authority and audited
47
+ remediation, not an insufficient retry count. A one-command bypass or broad auto-approval would have
48
+ hidden unreviewed product/documentation changes.
45
49
 
46
50
  ## Implemented lifecycle contract
47
51
 
48
- - Fresh `next` advertises audited remediation only for an `awaiting_execution_authorization`
49
- required Task of an active Milestone with a current `stop-escalate` Plan Risk Audit. Standalone,
50
- post-execution, `split-required`, and other stop postures preserve their existing routes.
51
- - Coordinator first records a normal capability Discovery. `milestone remediation-materialize`
52
- then performs one project transaction that appends exactly one required remediation Task and adds
53
- exactly one dependency edge from the blocked Task to it.
54
- - The new Task must inherit the blocked Task's exact direct predecessor frontier, and every predecessor
55
- must already be merged. Milestone outcome, success signal, acceptance, checks, base, old memberships
56
- and all unrelated dependency edges remain byte-semantically unchanged.
57
- - The scope-change event binds Milestone revision, blocked Task revision, Brief/Plan hashes, exact Plan
58
- Risk Audit event/hash, remediation Discovery revision, new Task identity and predecessor frontier.
59
- Reuse or topology drift fails closed.
60
- - A `corrective-derived` authorization, bound to the audited evidence and exact actor
61
- `agent:milestone-remediation:<MS-ID>`, replaces the superseded Milestone execution authorization.
62
- It authorizes only current required Task execution acceptance transitions; it is neither a general
63
- delegation grant nor human impersonation.
64
- - The remediation route requires no human approval. After its Task merges, the original Task returns
65
- to `task plan-set`, must receive a semantically new Plan and fresh Plan Risk Audit, and then proceeds
66
- through the ordinary C1, checks, commits and reviews.
67
- - Public handshake capabilities include `audited-remediation-topology-v1` and
68
- `corrective-derived-task-authority-v1`.
52
+ - Fresh `next` advertises audited remediation only for an unstarted
53
+ `awaiting_execution_authorization` required Task of an active Milestone with a current
54
+ `stop-escalate` Plan Risk Audit.
55
+ - When Project Knowledge is stale, the route continues without a Human gate only if Core proves all of
56
+ the following: the previously stored map is active and approved; the sole changed Knowledge path is
57
+ `package.json`; checkout is clean; runtime, declared, locked, installed, HEAD and Milestone-base
58
+ versions equal; the approved manifest bytes exist in current Git ancestry; and every subsequent
59
+ commit that touched `package.json` changed exactly `package.json` and `package-lock.json` with no
60
+ structural difference after removing the Workflow dependency.
61
+ - `next.auditedRemediation.dependencyKnowledgeRefresh` exposes the evidence and blockers without writes.
62
+ Discovery start/update stays available only when this assessment is eligible.
63
+ - `milestone remediation-materialize` atomically writes the consumed Discovery, one required remediation
64
+ Task, additive Milestone topology, scope-change evidence and—when required—the reconciled active
65
+ Knowledge Map at revision +2 with `corrective-derived` approval. No actor, confirmation code,
66
+ delegation grant or Human approval is accepted.
67
+ - The new Task inherits the blocked Task exact direct predecessor frontier. Milestone outcome, success
68
+ signal, acceptance, checks, base, old memberships and unrelated dependency edges remain unchanged.
69
+ - The corrective-derived actor remains `agent:milestone-remediation:<MS-ID>` and authorizes only the
70
+ advertised required Task execution/final-acceptance transitions. Final Milestone acceptance remains
71
+ an ordinary Human/delegated gate.
72
+ - After remediation merge, the original Task returns to `task plan-set`, receives a fresh Knowledge
73
+ binding, Plan and Risk Audit, then proceeds through ordinary C1, checks, commits and reviews.
74
+ - Unsafe or unrelated Knowledge drift never enters this route. Standalone reconcile now remains
75
+ executable instead of throwing while it checks whether a blocked Task can own delegated refresh;
76
+ subsequent explicit approval semantics are unchanged.
77
+ - Handshake adds `audited-remediation-dependency-knowledge-refresh-v1` while protocol and state schema
78
+ remain `2/2`.
69
79
 
70
80
  ## Signal-shaped evidence
71
81
 
72
- The release E2E mirrors the observed Signal deadlock: four already merged provider Tasks, one blocked
73
- required consumer Task, a current pre-execution `stop-escalate` audit, and a missing upstream
74
- capability. It proves the entire recovery cycle rather than only the new materialization command.
82
+ The focused E2E reproduces the real post-install boundary, including an older approved manifest hash,
83
+ an exact package/lock update commit, a stale Knowledge observation, an active Milestone, one blocked
84
+ required consumer and the later ordinary Step. It proves the complete continuation rather than only
85
+ the Knowledge assessment or materialization command.
75
86
 
76
- Live Signal installation and mutation are intentionally separate post-publication actions. They must
77
- use exact repository-local beta.12.10, a clean/idle update boundary, fresh `status -> next`, and the
78
- advertised compatibility/recovery route if the dependency update advances active Milestone base
79
- state. No manual state edit, Git history rewrite, Task cancellation, or duplicate Milestone is part of
80
- the release mechanism.
87
+ Live Signal installation and mutation remain post-publication actions. They must install exact
88
+ repository-local beta.12.11, commit only package/lock, run sequential handshake/status/next, follow the
89
+ advertised audited-remediation route and confirm Core readback. No manual state edit, Git history
90
+ rewrite, Task cancellation or duplicate Milestone is part of the recovery.
81
91
 
82
92
  ## PDF release documentation evidence
83
93
 
84
- - All three tracked Russian PDFs were regenerated from beta.12.10 Markdown sources.
94
+ - All three tracked Russian PDFs were regenerated from beta.12.11 Markdown sources.
85
95
  - Architecture is 8 pages, the delegated chat-only guide is 10 pages, and the technical reference is
86
- 12 pages. All 30 pages were rendered and visually inspected; the changed recovery sections were
87
- checked at full-page resolution.
88
- - Titles, package bindings, Cyrillic text, tables, code blocks, margins, footers and section transitions
89
- have no visible clipping, overlap or unreadable content.
96
+ 13 pages. All 31 pages were rendered to PNG and visually inspected.
97
+ - Titles, package bindings, Cyrillic text, tables, code blocks, margins, footers and the new
98
+ dependency-Knowledge sections have no visible clipping, overlap or unreadable content.
90
99
 
91
100
  ## Existing boundaries and non-claims
92
101
 
93
- - The new route does not permit arbitrary Task insertion, task removal, semantic Milestone scope
94
- change, arbitrary dependency rewiring, completed-Step adoption or `split-required` replacement.
95
- - Human approval is removed only from this exact evidence-derived corrective topology transition.
96
- Final Milestone acceptance and generic semantic scope changes retain their existing authority model.
97
- - Protocol version remains 2 and state schema remains 2; older projects remain readable without a
98
- state migration.
99
- - No Git commit, tag, remote push, npm publication or live Signal recovery is claimed by this
100
- pre-publication report.
101
-
102
- Confidence is high for the package implementation, topology invariants, no-human corrective authority,
103
- regression compatibility, tarball composition, downstream installation, plugin and documentation.
104
- Live Signal confidence remains conditional on successful publication, exact dependency installation,
105
- fresh Core readback and Coordinator completion of the advertised remediation route.
102
+ - The route does not permit arbitrary Task insertion, Task removal, semantic Milestone scope change,
103
+ arbitrary dependency rewiring, completed-Step adoption or `split-required` replacement.
104
+ - It does not auto-approve README, documentation, commands, classifications, authorities, gaps,
105
+ conflicts, dirty files or package commits containing any non-Workflow change.
106
+ - Protocol version remains 2 and state schema remains 2; no state migration is required.
107
+ - This report does not claim Git tag/push, npm publication or live Signal recovery before those
108
+ post-gate operations are read back separately.
109
+
110
+ Confidence is high for the package implementation, bounded no-Human dependency Knowledge refresh,
111
+ transaction atomicity, regression compatibility, tarball composition, downstream installation,
112
+ gateway and documentation. Live Signal confidence remains conditional on exact publication,
113
+ installation and fresh Core/Coordinator readback.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "codex-workflow-v2",
3
- "version": "2.0.0-beta.12.10",
3
+ "version": "2.0.0-beta.12.11",
4
4
  "description": "Requirements-first Codex development workflow with local state and explicit Git ownership.",
5
5
  "repository": {
6
6
  "type": "git",
@@ -156,6 +156,16 @@ free-form Milestone scope change. Follow only the advertised route:
156
156
  record a fresh Risk Audit, use the same current derived approval only when advertised, and
157
157
  continue through at least the next ordinary Step boundary.
158
158
 
159
+ An exact package update may make the approved Knowledge Map stale while this route is active. Continue
160
+ without a Human approval only when fresh `next` includes
161
+ `auditedRemediation.dependencyKnowledgeRefresh.eligible=true`. Core must prove that `package.json` is
162
+ the sole changed Knowledge source, every version surface equals the repository-local runtime, and every
163
+ Git commit that changed the approved manifest content altered only the exact Workflow dependency in
164
+ `package.json`/`package-lock.json`. Do not run standalone reconcile first. The refresh is committed
165
+ atomically by `milestone remediation-materialize` with corrective-derived evidence. Any other Knowledge
166
+ path, classification, gap, conflict, dirty checkout, unaligned version or wider commit returns to the
167
+ ordinary explicit Knowledge flow.
168
+
159
169
  This is an idempotent, additive topology transition bound to one exact Plan Risk Audit. Dirty Git,
160
170
  any lease/transaction/Core operation, a started blocked Task, stale Task/Milestone/audit bindings,
161
171
  non-merged or non-exact predecessors, duplicate use of the audit, or any changed Milestone semantic