Skip to content

Commit cf5e1b9

Browse files
committed
docs: refine v2.1.8 release plan
1 parent c763356 commit cf5e1b9

1 file changed

Lines changed: 22 additions & 5 deletions

File tree

devlog/_plan/260623_v218_release/00_plan.md

Lines changed: 22 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,10 @@ The release must:
1717

1818
- Repository: `/Users/jun/Developer/new/700_projects/opencodex`
1919
- Current branch at planning time: `dev`
20-
- `dev` / `origin/dev`: `3a8852cb77037d2f70e5f0c2e3ebe3721140495f`
20+
- `origin/dev`: `3a8852cb77037d2f70e5f0c2e3ebe3721140495f`
21+
- Local `dev` includes this release-plan evidence commit after `origin/dev` and should be included in
22+
the release branch unless a later audit finds a release-blocking reason to exclude docs-only
23+
evidence.
2124
- `main` / `origin/main`: `241e3277a7c0d7e76729a7ac6794a0851d52f9ea`
2225
- `package.json` version: `2.1.7`
2326
- Next release version: `2.1.8`
@@ -50,12 +53,18 @@ Dispatch a read-only plan auditor to verify:
5053
- `bun run build:gui`
5154
- `cd docs-site && bun install --frozen-lockfile && bun run build`
5255
- `git diff --check`
56+
- Capture `git rev-parse dev origin/dev main origin/main` so the release log records the exact
57+
source and target commits.
5358
2. Merge `dev` to `main`:
5459
- Ensure clean tree.
60+
- Push local `dev` first if it contains release-plan or result evidence commits that are not yet
61+
on `origin/dev`.
5562
- Checkout `main`.
56-
- Fast-forward `main` to `dev` if possible.
63+
- Fast-forward `main` to the actual verified local `dev` HEAD.
5764
- Push `origin/main`.
58-
3. Wait for `main` Cross-platform CI on commit `3a8852c`.
65+
3. Wait for `main` Cross-platform CI on the actual pushed `main` HEAD computed after the
66+
fast-forward/merge. Do not hardcode `3a8852c`; that commit is only the pre-plan
67+
`origin/dev` baseline.
5968
4. Release:
6069
- Run `bun scripts/release.ts 2.1.8 --publish` from clean `main`.
6170
- Let the helper bump `package.json`, commit `release: v2.1.8`, push `main`, wait for CI, dispatch release workflow, and watch the workflow.
@@ -80,14 +89,20 @@ Final checks:
8089

8190
### D: Done
8291

83-
Record the final result in `devlog/_plan/260623_v218_release/10_result.md`, save memory, and pause the goal only after an independent final objective review returns DONE.
92+
Record the final result in `devlog/_plan/260623_v218_release/10_result.md` before release if it can be
93+
completed without speculative evidence; otherwise keep post-release evidence in `cli-jaw goal update`
94+
and memory so `dev` does not drift ahead of the published `main` release commit. Pause the goal only
95+
after an independent final objective review returns DONE.
8496

8597
## Expected File Changes
8698

8799
### NEW
88100

89101
- `/Users/jun/Developer/new/700_projects/opencodex/devlog/_plan/260623_v218_release/00_plan.md`
90102
- `/Users/jun/Developer/new/700_projects/opencodex/devlog/_plan/260623_v218_release/10_result.md`
103+
- Create before the release only if its content can be factual and non-speculative; otherwise use
104+
goal evidence/memory for post-release facts to keep `main` and `dev` synchronized at the release
105+
commit.
91106

92107
### MODIFY
93108

@@ -98,7 +113,9 @@ Record the final result in `devlog/_plan/260623_v218_release/10_result.md`, save
98113
## Risks
99114

100115
- Release workflow could fail after npm publish. Mitigation: `scripts/release.ts` checks npm, tag, and GitHub Release are unused before publishing.
101-
- `origin/main` could move while waiting for CI. Mitigation: release helper aborts if remote main no longer equals the release commit.
116+
- `origin/main` could move while waiting for CI. Mitigation: compute the pushed main HEAD after the
117+
merge, wait for CI on that exact SHA, and let the release helper abort if remote main no longer
118+
equals the release commit.
102119
- Docs build is not part of CI. Mitigation: run `docs-site` build locally before main merge/release.
103120
- GUI build is not in full local test by default. Mitigation: run `bun run build:gui` before release and rely on CI GUI build smoke after push.
104121
- npm trusted publishing may fail due GitHub/npm configuration. Mitigation: do not use token fallback unless the trusted publishing failure proves it is necessary; report exact failure.

0 commit comments

Comments
 (0)