Skip to content

docs(devlog): correct the 2.57.0 Windows evidence and record the after-the-fact dispatch - #4840

Merged
lidge-jun merged 1 commit into
devfrom
codex/2580-correct-release-windows-record
Sep 16, 2026
Merged

lidge-jun merged 1 commit into
devfrom
codex/2580-correct-release-windows-record

Conversation

@lidge-jun

@lidge-jun lidge-jun commented Sep 16, 2026 •

Copy link
Copy Markdown
Owner

Summary

The 2.57.0 release record claimed the candidate run covered "all six Windows shards". It did not, and that sentence is the one a future release would have trusted.

platform-windows is dispatch-only by design (.github/workflows/ci.yml gates it on github.event_name == 'workflow_dispatch'), so on any push or pull_request event the six shards report skipped — and the aggregate ci check accepts a skipped producer as a pass. Both runs cited in the record are push runs:

Run Head windows N/6
35131181996 1831193294 (candidate) skipped
35133242171 44de45dfdc (release SHA) skipped

The green Windows evidence that did exist was run 35134620067 on 1504caaa83, the #4825 lane head — not the candidate and not the commit the package was published from. That is why the claim read as true: it was attached to the wrong commit.

The gap is now closed after the fact. Dispatch 35139132889 ran ci.yml --ref main -f lane=all at 44de45dfdc, the exact commit @bitkyc08/opencodex@2.57.0 was published from, and all six shards passed individually. 2.57.0 is sound on Windows; what failed was the evidence discipline, not the release.

This PR changes documentation only. The two follow-ups it names — making the aggregate gate event-aware, and requiring a Windows lane=all at the exact promotion SHA before a release can publish — belong to the CI-integrity work and are not in this change.

Verification

Documentation only; no source, test, or workflow file is touched. No local suite, typecheck, build, or install was run.

The corrected facts were each read from the GitHub API rather than from memory:

  • gh run view 35131181996 and gh run view 35133242171 both report windows ${{ matrix.shard }}/6 = skipped.
  • gh run view 35134620067 reports six individual windows N/6 = success at 1504caaa83.
  • gh run view 35139132889 reports six individual windows N/6 = success at 44de45dfdc.
  • .github/workflows/ci.yml platform-windows.if and the aggregate gate's skip rationale confirm the mechanism.

Checklist

  • Documentation-only change
  • Every cited run id and conclusion re-read from the API at the time of writing
  • No behaviour, default, or workflow changed
  • Targets dev

Summary by CodeRabbit

  • Documentation
    • Clarified that Windows validation was not run for the original candidate and release-SHA CI runs.
    • Corrected the associated evidence to reflect dispatch-only Windows CI behavior and its connection to a different commit.
    • Documented a later exact-SHA Windows validation in which all six shards passed.
    • Recorded follow-up work to improve event-aware CI gating and require exact-SHA Windows validation before publication.

…r-the-fact dispatch

The release record claimed the candidate run covered all six Windows shards. It did not:
platform-windows is dispatch-only, so both the candidate push run 35131181996 and the
release-SHA push run 35133242171 skipped it, and the aggregate ci check accepts a skipped
producer as a pass. The green Windows evidence that existed belonged to 1504caa, the
#4825 lane head, not to the commit 2.57.0 was published from.

Dispatch 35139132889 has now run lane=all at 44de45d, the exact published SHA, and all
six shards passed individually. The release is sound; the record was not.

No local suite, typecheck, build, or install was run.
@lidge-jun
lidge-jun requested a review from Ingwannu as a code owner September 16, 2026 21:17
@github-actions

Copy link
Copy Markdown
Contributor

✅ Deterministic PR hygiene checks passed.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 16, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-09-16T21:19:33.406333Z 298c233 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Sep 16, 2026
@coderabbitai

coderabbitai Bot commented Sep 16, 2026 •

Copy link
Copy Markdown
Contributor

Review Change StackReview Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Advanced

Run ID: ff79f256-f0ed-4f29-818c-074634d117d8

📥 Commits

Reviewing files that changed from the base of the PR and between 6ed8986 and 298c233.

📒 Files selected for processing (1)
  • devlog/_plan/260917_2570_release_train/040_release.md

Included review availability: Your plan provides up to 10 included reviews per hour; 9 remain after this review.


📝 Walkthrough

Walkthrough

The release plan corrects Windows CI evidence for candidate and release-SHA push runs. It records a later exact-SHA dispatch with six passing Windows shards and documents deferred event-aware gating and mandatory validation work.

Changes

Release evidence

Layer / File(s) Summary
Correct Windows CI release evidence
devlog/_plan/260917_2570_release_train/040_release.md
The release sequence now states that Windows was skipped in both cross-platform push runs. A correction documents dispatch-only behavior, identifies evidence from another commit, records the later exact-SHA dispatch with six passing shards, and lists follow-up work for the 2.58.0 cycle.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~3 minutes

Change: Other

Merge Risk: ⚪ Minimal · up to 298c2

The release documentation correction is mergeable; the proposed formatting issues do not establish a blocking problem.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly identifies the documentation change: correcting the 2.57.0 Windows release evidence and recording the later dispatch. It matches the main objective of the pull request.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/2580-correct-release-windows-record

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@lidge-jun

Copy link
Copy Markdown
Owner Author

리뷰 · 우선순위 75 / 80

이 PR은 코드를 고치는 게 아니라, 2.57.0 출시 기록(devlog/_plan/260917_2570_release_train/040_release.md)에 남아 있던 틀린 Windows 증거 문장을 바로잡는 문서 수정입니다. 지금 dev HEAD는 6ed8986c64afb2e37b1055e1afeb7e12d32ca8e4이고, 패키지는 이미 2.58.0으로 열린 상태입니다. 2.57.0 자체는 main/preview에 올라가 있고 npm에도 @bitkyc08/opencodex@2.57.0으로 올라가 있습니다. 그래서 이 변경의 가치는 “출시가 깨졌다”를 고치는 게 아니라, 나중에 같은 출시를 다시 읽을 사람이 믿게 될 문장을 사실과 맞추는 것입니다.

문제의 핵심은 워크플로 설계와 기록 문장이 어긋난 점입니다. .github/workflows/ci.yml에서 platform-windows는 github.event_name == 'workflow_dispatch'일 때만 돌아갑니다. push나 pull_request에서는 Windows 여섯 샤드가 전부 skipped로 나옵니다. 그런데 집계 ci 게이트는 skipped도 통과로 칩니다. 그래서 후보 커밋 1831193294의 push 런 35131181996과, 실제 출시 SHA 44de45dfdc의 push 런 35133242171은 둘 다 “초록”처럼 보이지만 Windows는 한 번도 안 돌았습니다. 예전 기록은 그걸 “여섯 Windows 샤드 포함”이라고 써 버렸습니다.

그다음에 붙은 “초록 Windows 증거”도 커밋이 달랐습니다. 출시 시점에 실제로 초록이었던 Windows 런은 35134620067인데, 헤드는 #4825 레인 헤드 1504caaa83입니다. 출시 패키지가 나온 커밋이 아닙니다. 그래서 “Windows는 초록이었다”는 느낌은 맞았어도, 어느 SHA에서 초록이었는지가 틀려 있었습니다. 이 PR은 그 문장을 “Windows는 skipped였다”로 고치고, 사후에 돌린 dispatch 35139132889(ci.yml --ref main -f lane=all, SHA 44de45dfdc)에서 Windows 1/6~6/6이 전부 success였다는 표를 아래에 붙입니다. 제가 API로 다시 보면 그 여섯 샤드는 정말 success입니다. 다만 런 전체 conclusion은 cancelled/failure 쪽입니다. macos control이 cancelled라서 집계 ci가 failure로 끝난 것이고, Windows 증거와는 별개입니다. 본문이 “샤드가 individually 통과했다”고 쓴 건 맞습니다.

지금 dev가 밀고 있는 방향과도 잘 맞습니다. #4835/#4834로 테스트·스폰 예산을 다시 열고, #4837은 타임아웃/Bun 크래시를 초록으로 덮지 않게 하며 집계 게이트를 이벤트에 맞게 다듬는 CI 무결성 레인입니다. 이 PR 본문이 가리키는 후속 두 가지(집계 게이트가 “일부러 안 돌린 skipped”와 “돌리다가 빠진 skipped”를 구분하지 못함, 출시 전에 정확히 그 SHA에서 Windows lane=all을 강제)는 바로 그 레인의 일입니다. 문서만 고치고 워크플로는 건드리지 않은 선택도 맞습니다. 출시 기록을 거짓말 없이 남기는 일과, 다음부터 같은 구멍을 막는 일을 한 PR에 섞지 않은 겁니다.

라인 - 문서만 바꾸므로 런타임·기본값·워크플로 동작 회귀는 없습니다

040_release.md Freeze/Prove 행 - 예전 “all six Windows shards included” 문장을 지우고 skipped였다고 밝힌 수정은 사실과 일치합니다

Correction 절의 런 표 - 35131181996/35133242171 skipped, 35139132889에서 Windows 6/6 success 서술은 API와 맞습니다

35139132889 - 런 전체 conclusion은 cancelled(macos control) + 집계 ci failure입니다. Windows 샤드 증거와 런 초록을 혼동하지 않도록, 필요하면 “런은 cancelled였지만 Windows 여섯 샤드는 success” 한 줄을 더 적어도 됩니다

후속 문단의 “CI-integrity lane” - 지금 열린 #4837(이벤트 인지 집계·fail-fast)과 직접 이어집니다. 번호만 적어도 다음 독자가 덜 헤맵니다

메인테이너의 판단이 필요한 지점

  • 사후 Windows 증거를 출시 기록에 남길 때, 런 전체 conclusion이 cancelled인 점을 한 줄로 명시할지 말지
  • 문서에 #4837(또는 후속 CI 무결성 PR) 번호를 지금 박을지, 그 PR이 머지된 뒤에 링크를 달지
  • 이 교정만 dev에 먼저 넣을지, Windows 강제 체크리스트/게이트 코드 변경과 한 묶음으로 미룰지 (이 PR 범위는 문서만이 맞아 보임)

너의 추천
문서 사실 관계는 맞고, 출시 자체를 다시 깎을 이유는 없습니다. CI만 초록이면 그대로 머지하세요. 여유 있으면 35139132889가 런 단위로는 cancelled였다는 한 줄과 #4837 교차 참조만 보태면 다음 출시 독자가 더 안전합니다. types/config 분할이나 중복 클로즈 대상은 아닙니다.

이 댓글은 grok-bot이 작성했습니다

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 298c233b07

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

it tells the reader exactly what to do instead of republishing. A pending verification here means
wait and re-read, not cut another version.

## Correction: Windows was never run on the candidate or the release SHA

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Qualify the correction heading by publication time

The heading says Windows was never run on the release SHA, but lines 67–74 immediately document a successful after-the-fact dispatch at that exact SHA. This makes the release record internally contradictory, especially for readers scanning headings; rename it to state that Windows was not run on the candidate or release SHA before publication.

Useful? React with 👍 / 👎.

@lidge-jun
lidge-jun merged commit 5d98281 into dev Sep 16, 2026
23 checks passed
@lidge-jun
lidge-jun deleted the codex/2580-correct-release-windows-record branch September 16, 2026 21:43
agentHits pushed a commit to agentHits/opencodex that referenced this pull request Sep 17, 2026
…r-the-fact dispatch (lidge-jun#4840)

The release record claimed the candidate run covered all six Windows shards. It did not:
platform-windows is dispatch-only, so both the candidate push run 35131181996 and the
release-SHA push run 35133242171 skipped it, and the aggregate ci check accepts a skipped
producer as a pass. The green Windows evidence that existed belonged to 1504caa, the
lidge-jun#4825 lane head, not to the commit 2.57.0 was published from.

Dispatch 35139132889 has now run lane=all at 44de45d, the exact published SHA, and all
six shards passed individually. The release is sound; the record was not.

No local suite, typecheck, build, or install was run.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant