codex-workflow-v2 2.0.0-alpha.6 → 2.0.0-alpha.6.1
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.
- package/README.md +29 -1
- package/dist/src/cli.js +8 -1
- package/dist/src/cli.js.map +1 -1
- package/dist/src/version.d.ts +1 -1
- package/dist/src/version.js +1 -1
- package/dist/src/version.js.map +1 -1
- package/dist/src/workflow.d.ts +45 -1
- package/dist/src/workflow.js +187 -4
- package/dist/src/workflow.js.map +1 -1
- package/docs/decisions.md +4 -0
- package/docs/updating-existing-project.md +22 -0
- package/docs/validation-report.md +13 -4
- package/package.json +2 -2
- package/plugins/codex-workflow-gateway/references/protocol.md +5 -0
- package/plugins/codex-workflow-gateway/skills/codex-workflow-gateway/SKILL.md +7 -0
package/docs/decisions.md
CHANGED
|
@@ -80,3 +80,7 @@ This document closes the requirement gaps identified during the V2 design review
|
|
|
80
80
|
15. **Safe update preflight.** Dependency updates begin with a read-only preflight requiring
|
|
81
81
|
a clean checkout, no running Step, and no active writer lease. It does not install,
|
|
82
82
|
migrate, or mutate project state.
|
|
83
|
+
16. **Claimed-C1 rescue is one guarded transition.** The alpha.6.1 backport may bypass only
|
|
84
|
+
the stale Knowledge binding that blocks one exact pending strict review. It requires the
|
|
85
|
+
original claimant actor and writer token, preserves the lease, rechecks clean completion
|
|
86
|
+
HEAD and C1 bindings, and never composes stale-lock repair with review.
|
|
@@ -22,6 +22,28 @@ state schema. Совпадение `stateSchemaVersion` до и после об
|
|
|
22
22
|
нужна. Для alpha.6 при `stateSchemaVersion: 2` применяется не migration, а sidecar-only
|
|
23
23
|
adoption posture.
|
|
24
24
|
|
|
25
|
+
## Исключение: claimed C1 strict-review deadlock в alpha.6
|
|
26
|
+
|
|
27
|
+
Не обновляйте dependency, если alpha.6 Task уже имеет `in_progress` Step с completion evidence,
|
|
28
|
+
pending strict review и stale Knowledge binding. Для такого состояния используйте внешний
|
|
29
|
+
точный runner `2.0.0-alpha.6.1`; сам проект до завершения recovery остаётся закреплён на
|
|
30
|
+
`2.0.0-alpha.6`.
|
|
31
|
+
|
|
32
|
+
Сначала выполните только `update rescue-preflight`. Продолжать разрешено исключительно при
|
|
33
|
+
`eligible=true` и одной exact action `update rescue-review`. Передайте returned Task ID, Step
|
|
34
|
+
ID, revision, claimant actor и исходный bound writer token. Не выводите token в чат и не
|
|
35
|
+
передавайте другому actor.
|
|
36
|
+
|
|
37
|
+
Recovery не требует и не допускает предварительный `locks repair`: alpha.6.1 проверяет token
|
|
38
|
+
сразу против существующего lease и C1 hash, затем сохраняет и heartbeat'ит тот же lease в
|
|
39
|
+
единственной guarded review-команде. Active и stale lease допустимы только при exact binding.
|
|
40
|
+
Неверный actor/token, dirty checkout, advanced HEAD, второй pending review
|
|
41
|
+
или посторонний lease блокируют переход без изменения Task state.
|
|
42
|
+
|
|
43
|
+
После successful review следуйте обычному `next`: reconcile/approve Knowledge Map, выполните
|
|
44
|
+
knowledge rebind, свежую authorization и завершите Task. Только на безопасной lifecycle-границе
|
|
45
|
+
запускайте обычное обновление dependency и gateway.
|
|
46
|
+
|
|
25
47
|
## 1. Подготовьте отдельный чат обновления
|
|
26
48
|
|
|
27
49
|
Не обновляйте пакет во время выполняющегося Worker Step. Дождитесь завершения текущего ответа
|
|
@@ -1,11 +1,15 @@
|
|
|
1
1
|
# V2 Alpha Validation Report
|
|
2
2
|
|
|
3
|
-
Release candidate `2.0.0-alpha.6` was validated
|
|
3
|
+
Release candidate `2.0.0-alpha.6.1` was validated on 2026-08-14 with Node.js 24.17.0 as a
|
|
4
|
+
narrow backport from the published `2.0.0-alpha.6` baseline.
|
|
4
5
|
|
|
5
6
|
- `npm run typecheck`, `npm run build`, `npm test`, `npm run validate`, `npm run plugin:check`,
|
|
6
7
|
`npm run smoke:downstream`, `npm run release:check`, and `npm run pack:check` passed in the
|
|
7
|
-
|
|
8
|
-
- The final sequential full suite passed `
|
|
8
|
+
sequential backport validation.
|
|
9
|
+
- The final sequential full suite passed `83/83` on 2026-08-14.
|
|
10
|
+
- The package test script runs test files sequentially and uses Node's `--test-force-exit`
|
|
11
|
+
after all test cases finish because concurrent isolated runners retain IPC/stdio handles in
|
|
12
|
+
this environment; the same 83 cases also passed when executed per file.
|
|
9
13
|
- Plan Risk Audit coverage includes the combined `plan-set --risk-audit-file` path, atomic
|
|
10
14
|
rejection before Task/Plan acceptance, distinct planner/auditor identities, exact current
|
|
11
15
|
Step-set equality, concrete failure modes, executable evidence binding, coupled
|
|
@@ -14,6 +18,11 @@ Release candidate `2.0.0-alpha.6` was validated through 2026-08-14 with Node.js
|
|
|
14
18
|
- Strict high-risk Step Review coverage includes workflow-owned completion commits,
|
|
15
19
|
`task step-review` routing, commit-bound reviewer attestation, and fail-closed rejection of
|
|
16
20
|
stale, malformed, unverified, and wrong-commit review evidence.
|
|
21
|
+
- Alpha.6.1 rescue coverage reproduces the production deadlock with an exact alpha.6
|
|
22
|
+
dependency, stale Knowledge binding, pending strict review, claimed C1 posture, and both
|
|
23
|
+
active and stale bound leases. The single rescue action preserves the original lease,
|
|
24
|
+
exposes no plaintext token, completes review with the exact claimant/token, and fails closed
|
|
25
|
+
for a wrong actor or token. Ordinary `task step-review` remains blocked by stale Knowledge.
|
|
17
26
|
- Guarded remediation coverage includes the per-Step circuit breaker: two ordinary retries
|
|
18
27
|
allowed, third gated by bounded `continue-fix`, a hard stop after a third failed corrective
|
|
19
28
|
review, and stop/redirection handling for `split-required` and `stop-escalate`.
|
|
@@ -38,7 +47,7 @@ Release candidate `2.0.0-alpha.6` was validated through 2026-08-14 with Node.js
|
|
|
38
47
|
`alpha6-adoption-posture-v1`, plus strengthened contracts advertised as
|
|
39
48
|
`semantic-plan-risk-audit-v2`, `guarded-remediation-hard-stop-v1`,
|
|
40
49
|
`milestone-reverse-membership-integrity-v1`, and `task-c1-handoff-bundle-v2`.
|
|
41
|
-
- npm dry-run packaging produced `codex-workflow-v2-2.0.0-alpha.6.tgz` with runtime, schemas,
|
|
50
|
+
- npm dry-run packaging produced `codex-workflow-v2-2.0.0-alpha.6.1.tgz` with runtime, schemas,
|
|
42
51
|
references, docs, and plugin source. Downstream installation and the packaged CLI handshake
|
|
43
52
|
passed, and the install created none of `.codex`, `.tasks`, `.increments`, or
|
|
44
53
|
`.memory-bank` in the temporary project.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "codex-workflow-v2",
|
|
3
|
-
"version": "2.0.0-alpha.6",
|
|
3
|
+
"version": "2.0.0-alpha.6.1",
|
|
4
4
|
"description": "Requirements-first Codex development workflow with local state and explicit Git ownership.",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -40,7 +40,7 @@
|
|
|
40
40
|
"clean": "node --eval \"import('node:fs').then(({rmSync}) => { rmSync('dist', {recursive:true, force:true}); rmSync('.test-dist', {recursive:true, force:true}); })\"",
|
|
41
41
|
"build": "npm run clean && tsc -p tsconfig.build.json && node scripts/mark-cli-executable.mjs",
|
|
42
42
|
"typecheck": "tsc -p tsconfig.json --noEmit",
|
|
43
|
-
"test": "npm run build && tsc -p tsconfig.test.json && node --test .test-dist/tests/*.test.js",
|
|
43
|
+
"test": "npm run build && tsc -p tsconfig.test.json && node --test --test-concurrency=1 --test-force-exit .test-dist/tests/*.test.js",
|
|
44
44
|
"validate": "npm run typecheck && npm test",
|
|
45
45
|
"pack:check": "npm run build && npm pack --dry-run",
|
|
46
46
|
"smoke:downstream": "npm run build && node scripts/downstream-smoke.mjs",
|
|
@@ -120,6 +120,11 @@ Task authorization evidence. Any semantic map change remains on the normal visib
|
|
|
120
120
|
|
|
121
121
|
Before updating the installed package, run `update preflight`. Continue only for `safe=true`.
|
|
122
122
|
|
|
123
|
+
Alpha.6.1 adds one compatibility exception before package update: an exact alpha.6 claimed-C1
|
|
124
|
+
pending strict review with stale Knowledge may use external `update rescue-preflight` followed
|
|
125
|
+
by its single `update rescue-review` action. The action must preserve the original lease and
|
|
126
|
+
prove its bound actor/token; `locks repair` is forbidden before this review.
|
|
127
|
+
|
|
123
128
|
## C1 handoff
|
|
124
129
|
|
|
125
130
|
`C1` coordination is machine-bound and local. Use:
|
|
@@ -110,6 +110,13 @@ replan, split, or stop decisions.
|
|
|
110
110
|
Before an npm package update, run the project-local `update preflight` and stop unless it
|
|
111
111
|
returns `safe=true` with a clean checkout, no running Step, and no active writer lease.
|
|
112
112
|
|
|
113
|
+
For a project still pinned exactly to `2.0.0-alpha.6` with one claimed-C1 pending strict review
|
|
114
|
+
blocked by stale Project Knowledge, do not update the dependency and do not repair the lease.
|
|
115
|
+
Resolve the exact external `2.0.0-alpha.6.1` runner, run its read-only `update rescue-preflight`,
|
|
116
|
+
and continue only for `eligible=true` with the single returned `update rescue-review` action.
|
|
117
|
+
Use the exact claimant and original bound writer token without printing the token. Stop on any
|
|
118
|
+
binding mismatch or additional blocker.
|
|
119
|
+
|
|
113
120
|
## Stop Conditions
|
|
114
121
|
|
|
115
122
|
- Dependency version is missing, ranged, or differs from the installed package.
|