Skip to content

docs(release): v1 출시 게이트를 보강한다#113

Merged
JeremyDev87 merged 1 commit into
masterfrom
feature/v1-release-hardening
May 9, 2026
Merged

docs(release): v1 출시 게이트를 보강한다#113
JeremyDev87 merged 1 commit into
masterfrom
feature/v1-release-hardening

Conversation

@JeremyDev87

Copy link
Copy Markdown
Owner

배경

v1.0.0 정식 출시 전 bump 자체를 제외하고, release/publish 운영 안정성, v1 consumer 계약, 지원 플랫폼 문서, local preflight 재현성을 잠그기 위한 보강입니다.

변경 사항

  • execute-only native runtime probe timeout을 1초에서 5초로 늘려 병렬 부하에서 발생한 probe flake 여지를 줄였습니다.
  • release operator runbook을 v1.0.0 기준으로 정리하고, 모든 local npm preflight 및 npm pack 예시에 임시 npm_config_cache 사용을 고정했습니다.
  • v1.0.0 immutable tag publish 이후에만 moving major tag v1을 이동하고, 이동 전후 root action과 marketplace wrapper smoke를 확인하도록 운영 정책을 문서화했습니다.
  • Windows/Linux musl은 v1.0.0 native runtime 미지원이며, JS fallback은 제한적 compatibility surface라는 계약을 문서화했습니다.
  • README release action 예시와 release wiring validator/test를 v1 release path에 맞춰 갱신했습니다.

검증

  • node ./scripts/validate-rust-release-wiring.mjs
  • node ./scripts/update-release-docs.mjs --check
  • git diff --check
  • node --test test/release-docs.test.js test/github-action-wiring.test.js test/installed-native-runtime.test.js test/wrapper-runtime.test.js test/packed-wrapper-fallback.test.js test/release-workflow-context.test.js test/release-plan.test.js test/release-candidate-metadata.test.js test/release-helpers.test.js test/npm-error-classifiers.test.js test/bump-release-version.test.js test/platform-package-manifests.test.js
  • npm testcargo test --workspace 병렬 실행
  • npm test 단독 실행
  • npm_config_cache=/private/tmp/maximus-release-pack-v1-hardening/.npm-cache npm pack --json --pack-destination /private/tmp/maximus-release-pack-v1-hardening
  • node ./scripts/run-packed-wrapper-smoke.mjs /private/tmp/maximus-release-pack-v1-hardening/pack.json ./test/fixtures/clean-project
  • npm registry에서 root 및 4개 platform package의 1.0.0 미점유 확인
  • GitHub 최신 run 확인: release-candidate.yml, dev.yml, release.yml 최신 run 성공. release.yml 내 action smoke에서 root action과 marketplace wrapper step 성공 확인.

브랜치 / 워크트리

  • base: master
  • head: feature/v1-release-hardening
  • worktree: /Users/pjw/workspace/maximus

남은 운영 게이트

  • 이 PR은 tag 생성, v1 tag 이동, release workflow dispatch, npm publish를 수행하지 않습니다.
  • 최종 release 시점에는 runbook에 따라 최신 origin/master 또는 정확한 tag ref에서 gate를 다시 실행해야 합니다.

@JeremyDev87

Copy link
Copy Markdown
Owner Author

독립 fresh-session 리뷰 결과

  • Verdict: CHANGE_REQUEST
  • Severity Summary: Critical 0 / High 1 / Medium 0 / Low 0
  • Findings:
    • [High] docs/release-operator-runbook.mdv1 major tag promotion 절차가 현재 release workflow 계약과 충돌합니다. 현재 .github/workflows/release.yml은 모든 v* 태그 push에서 release workflow를 실행하고, release context/plan 검증은 v1.0.0 형태의 package-version tag만 허용합니다. 문서대로 git push origin refs/tags/v1 --force-with-lease를 수행하면 v1 promotion 직후 release tag v1 does not match package.json version ... 형태의 red release workflow run이 생길 수 있습니다.
  • Rationale: PR check는 모두 pass지만, runbook이 운영자에게 실패하는 release-triggering tag push를 지시하는 High 결함이 남아 있어 승인할 수 없습니다.

Note: GitHub 정책상 self-authored PR에는 공식 request-changes review를 제출할 수 없어 동일한 verdict를 PR comment로 남깁니다.

@JeremyDev87 JeremyDev87 self-assigned this May 9, 2026
@JeremyDev87 JeremyDev87 added the documentation Improvements or additions to documentation label May 9, 2026
@JeremyDev87 JeremyDev87 marked this pull request as ready for review May 9, 2026 01:25
@JeremyDev87 JeremyDev87 force-pushed the feature/v1-release-hardening branch from 2cba25c to 225f8a2 Compare May 9, 2026 01:27
@JeremyDev87

Copy link
Copy Markdown
Owner Author

독립 fresh-session 리뷰 결과

  • Verdict: APPROVE
  • Severity Summary: Critical 0 / High 0 / Medium 0 / Low 0
  • Findings: 없음
  • Rationale: 이전 High blocker는 release.yml이 package release tag(v1.0.0, v1.0.0-alpha.1)만 수신하도록 제한하면서 해소됐습니다. runbook과 Marketplace 문서도 v1 이동이 npm publication trigger가 아니며 별도 action-smoke.yml 대상임을 맞춰 설명합니다. 로컬 집중 검증과 PR GitHub checks가 모두 통과했습니다. 이 코멘트는 이전 CHANGE_REQUEST 코멘트를 대체합니다.

Note: GitHub 정책상 self-authored PR에는 공식 approve review를 제출할 수 없어 동일한 verdict를 PR comment로 남깁니다.

@JeremyDev87 JeremyDev87 merged commit ec42f02 into master May 9, 2026
43 checks passed
@JeremyDev87 JeremyDev87 deleted the feature/v1-release-hardening branch May 9, 2026 01:32
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