codex-workflow-v2 2.0.0-beta.13.7 → 2.0.0-beta.13.9

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.
Files changed (47) hide show
  1. package/README.md +1 -1
  2. package/dist/reviewer-runtime-build.json +21 -13
  3. package/dist/src/alpha6/failed-step-planning-recovery.d.ts +10 -0
  4. package/dist/src/alpha6/failed-step-planning-recovery.js +93 -0
  5. package/dist/src/alpha6/failed-step-planning-recovery.js.map +1 -0
  6. package/dist/src/alpha6/plan-risk.d.ts +2 -0
  7. package/dist/src/alpha6/plan-risk.js +10 -3
  8. package/dist/src/alpha6/plan-risk.js.map +1 -1
  9. package/dist/src/alpha7/autonomy.d.ts +3 -0
  10. package/dist/src/alpha7/autonomy.js +89 -42
  11. package/dist/src/alpha7/autonomy.js.map +1 -1
  12. package/dist/src/change-explanation.d.ts +64 -0
  13. package/dist/src/change-explanation.js +150 -0
  14. package/dist/src/change-explanation.js.map +1 -0
  15. package/dist/src/cli-actions.d.ts +1 -0
  16. package/dist/src/cli-actions.js +1 -0
  17. package/dist/src/cli-actions.js.map +1 -1
  18. package/dist/src/cli.js +4 -1
  19. package/dist/src/cli.js.map +1 -1
  20. package/dist/src/lifecycle/corrective-replan.js +3 -3
  21. package/dist/src/lifecycle/corrective-replan.js.map +1 -1
  22. package/dist/src/state/corrective-replan-public.js +5 -4
  23. package/dist/src/state/corrective-replan-public.js.map +1 -1
  24. package/dist/src/state/corrective-yield-executor.js +2 -2
  25. package/dist/src/state/corrective-yield-executor.js.map +1 -1
  26. package/dist/src/state/store.d.ts +1 -1
  27. package/dist/src/state/store.js +17 -3
  28. package/dist/src/state/store.js.map +1 -1
  29. package/dist/src/version.d.ts +1 -1
  30. package/dist/src/version.js +1 -1
  31. package/dist/src/workflow.d.ts +49 -0
  32. package/dist/src/workflow.js +406 -238
  33. package/dist/src/workflow.js.map +1 -1
  34. package/docs/change-model.md +118 -0
  35. package/docs/delegated-approval.md +26 -0
  36. package/docs/pdf/codex-workflow-v2-architecture-ru.pdf +0 -0
  37. package/docs/pdf/codex-workflow-v2-chat-only-guide-ru.pdf +0 -0
  38. package/docs/pdf/codex-workflow-v2-technical-reference-ru.pdf +0 -0
  39. package/docs/pdf/sources/codex-workflow-v2-architecture-ru.md +1 -1
  40. package/docs/pdf/sources/codex-workflow-v2-chat-only-guide-ru.md +3 -5
  41. package/docs/pdf/sources/codex-workflow-v2-technical-reference-ru.md +2 -2
  42. package/docs/release.md +72 -0
  43. package/package.json +1 -1
  44. package/plugins/codex-workflow-gateway/references/chat-dispatch.md +76 -0
  45. package/plugins/codex-workflow-gateway/scripts/chat-dispatch.mjs +116 -3
  46. package/plugins/codex-workflow-gateway/scripts/chat-registry.mjs +6 -1
  47. package/plugins/codex-workflow-gateway/skills/codex-workflow-gateway/SKILL.md +52 -6
@@ -124,8 +124,8 @@ paths and content hash. Every retained path must already be allowed by the new S
124
124
  and remain outside forbidden scope. A changed binding or blocked assessment is a hard
125
125
  stop; never clean, stash, reset, manually commit, or edit state to make it eligible.
126
126
 
127
- The beta.13.7 consumed-carryover compatibility profile also permits the exact
128
- published external beta.13.7 runner to execute only the read-only
127
+ The beta.13.8 consumed-carryover compatibility profile also permits the exact
128
+ published external beta.13.8 runner to execute only the read-only
129
129
  `update corrective-carryover-preflight --id <TASK-ID>` against a coherent beta.13.6
130
130
  repository. A completed, verified Step's carryover remains historical evidence;
131
131
  it must not override a later Step's repeated-cause recovery route.
@@ -151,13 +151,22 @@ another compatibility action. `sourceRecovery` never authorizes transport or
151
151
  Once the replacement Plan is authorized and that same Worker has claimed it,
152
152
  the preflight may expose the exact expired-lease repair described below. Never
153
153
  force-release a live lease. Require a fresh top-level `eligible=true` before
154
- dependency transport. beta.13.7 accepts one dependency-only commit on each of
154
+ dependency transport. beta.13.8 accepts one dependency-only commit on each of
155
155
  the Task and Milestone base, with the same exact source beta.13.6 and target
156
- beta.13.7. After installing the target, use its ordinary advertised
156
+ beta.13.8. After installing the target, use its ordinary advertised
157
157
  dependency provenance recovery, atomic context refresh and original-Worker
158
158
  credential recovery. This profile permits no external state mutation, installed
159
159
  code patch, wider product commit, changed dirty bytes, or approval substitution.
160
160
 
161
+ The exact beta.13.9 runner supports the same bounded consumed-carryover profile
162
+ with beta.13.6 as its source and beta.13.9 as its pinned target. Require the
163
+ returned version bindings and all the same source-recovery and transport proofs.
164
+ Historical beta.13.8 evidence is not proof for a beta.13.9 invocation.
165
+
166
+ The historical beta.13.7 runner retains its own exact beta.13.6-to-beta.13.7 profile.
167
+ The current beta.13.8 profile does not admit a beta.13.7 source or an in-progress
168
+ Step and cannot be used to bypass the ordinary safe update boundary.
169
+
161
170
  The historical beta.13.6 corrective-carryover update compatibility profile permits its exact
162
171
  external runner to execute only the read-only
163
172
  `update corrective-carryover-preflight --id <TASK-ID>` against a repository coherently
@@ -653,10 +662,20 @@ delegable only through an explicit project-scoped `project_memory.approve` permi
653
662
  changes, grant issuance, and grant expansion are never delegated by `delegated-approval-v1`.
654
663
 
655
664
  For an entire Milestone, prefer one bounded `milestone autonomy-prepare` gate after the complete
656
- initial membership Plan exists. Show principal, delegate, expiry, semantic-scope hash, policy
665
+ initial membership Plan exists. An explicitly human-requested full contract may also be prepared
666
+ for an `active` Milestone, including after a previous contract expired or was revoked. This is
667
+ new issuance, never automatic renewal. Fresh Task-first or repository `next` may expose
668
+ `activeMilestoneAutonomyOptions`; these are optional preparation routes and do not replace the
669
+ current Task action. Preparation still requires coherent state and active Project Knowledge.
670
+ A generic grant does not become a full contract and is not automatically revoked. A still-valid
671
+ full contract must first be explicitly revoked by its principal before a different one is issued.
672
+ The new confirmation binds the current Milestone status, revision, Plan, semantic scope, policy,
673
+ and previous contract/grant state; any change requires preparation and confirmation again.
674
+ An exact successful retry returns the same grant; an old code cannot revive a revoked grant. Show principal, delegate, expiry, semantic-scope hash, policy
657
675
  hash, and `MAC-*` code, then stop. A later exact approval permits `milestone autonomy-grant`.
658
676
  Use the delegated path only when the same `next` response exposes
659
- `milestoneAuthorizationOptions[].action = "milestone autonomy-prepare"` and the user explicitly
677
+ `milestoneAuthorizationOptions[].action = "milestone autonomy-prepare"` or an
678
+ `activeMilestoneAutonomyOptions` entry for that exact Milestone, and the user explicitly
660
679
  requested delegated Milestone operation; otherwise follow the ordinary `milestone authorize`
661
680
  human gate.
662
681
  The resulting grant covers the existing Task/Milestone approval transitions and the Project
@@ -668,6 +687,18 @@ only for membership changes; any change to outcome, success signal, acceptance,
668
687
  discovery, or base branch requires the ordinary human scope-change gate. Never self-renew or
669
688
  replace the contract.
670
689
 
690
+ When fresh `next` advertises `task corrective-decision` with
691
+ `planningRecovery.authority = "planning-only"`, a started failed Step has a current
692
+ blocking audit after a Knowledge-only Plan rebind. Core proves the historical approved
693
+ safety baseline; the stopped audit does not authorize execution. Obtain the independent
694
+ corrective decision against the returned bindings and preserve the exact original Worker
695
+ credential/yield prerequisites. Follow the existing human-confirmed corrective-replan
696
+ route, then fresh replacement Plan authorization. Never approve the obstructed Plan merely
697
+ to unlock navigation, use ordinary `plan-set` to bypass the corrective gate, or create an
698
+ upstream remediation Task for this already-started posture. `continue-fix` is unavailable
699
+ for this planning-only route. A package update can require another Knowledge rebind and
700
+ fresh blocking audit; do not rewrite or silently reuse a stale audit.
701
+
671
702
  Repeated failed Task reviews remain on the same Task and do not require a separate corrective
672
703
  Plan audit based only on count. Follow fresh `next`: ordinary findings default to `route=fix`;
673
704
  `route=replan` is valid only with the exact Plan clause, obstruction, and minimal Plan change
@@ -736,3 +767,18 @@ returns `safe=true` with a clean checkout, no running Step, and no active writer
736
767
  - A lifecycle `status` or `next` failed; do not continue with a different lifecycle mutation.
737
768
  - A human gate was emitted but the user has not approved its exact confirmation code in a
738
769
  later message and no exact eligible delegated approval option exists.
770
+
771
+ ## Explain an implementation change before escalating
772
+
773
+ Before a product write by a tracked Worker, run the packaged registry `dispatch-context-check`
774
+ using fresh App readback, the actual write root and the branch from the current Task. Resolve
775
+ checkout mismatch without duplicate dispatch or silent canonical-checkout writes. A matching
776
+ context is not a filesystem permission or writer credential.
777
+
778
+ When a fix needs additional files, the route is unclear, or an external operation was denied,
779
+ use read-only `change explain --task <exact Task ID> --file <closed proposal JSON>` as documented
780
+ in `docs/change-model.md`. Present all known blocking layers together. Never relabel an external
781
+ permission refusal as a missing grant. `requiresUser: null` is unknown, not blanket approval.
782
+ For an exact Core-derived check-support amendment, follow the existing advertised recovery and
783
+ fresh next; do not manually widen allowedWrites or issue new authority. Membership, semantic
784
+ scope and Knowledge refresh retain their separate existing routes and evidence requirements.