schemeta/docs/release-checklist.md
Rbanh 0c5c1040cd
Some checks are pending
CI / test (push) Waiting to run
Sprint 7: add Phase 8 cutover gate and rollback runbook
2026-02-19 23:24:46 -05:00

58 lines
2.2 KiB
Markdown

# Schemeta Release Checklist
Use this checklist before cutting a release tag.
Reference docs:
- `docs/quality-gates.md`
- `docs/phase4-execution-plan.md`
- `docs/phase5-execution-plan.md`
## Pre-merge
- [ ] All relevant issue acceptance criteria are reviewed.
- [ ] PRs are linked to tracked Gitea issues.
- [ ] No unresolved critical/major diagnostics regressions.
## Validation Gates
- [ ] `npm test` passes.
- [ ] `npm run test:ui` passes.
- [ ] `npm run phase8:cutover:check` passes (for React-first cutover candidates).
- [ ] Beta quality gates in `docs/quality-gates.md` are met.
- [ ] Core smoke flow tested in UI:
- [ ] Load sample
- [ ] Edit component/pin/net/symbol
- [ ] Undo/redo works
- [ ] Export/import roundtrip works
- [ ] Compile/analyze API smoke checks return expected envelopes.
- [ ] MCP tool calls (`schemeta_compile`, `schemeta_analyze`, `schemeta_ui_bundle`) work.
## Visual Quality
- [ ] Representative circuits reviewed for routing readability.
- [ ] Visual baselines updated intentionally (`tests/baselines/ui`) and screenshot diff checks pass.
- [ ] Labels remain legible at common zoom levels.
- [ ] No major overlap/crossing regressions vs previous release baseline.
- [ ] UI metrics report generated (`output/playwright/ui-metrics-report.json`).
- [ ] Sample/drag/tidy/dense fixture all meet the thresholds in `docs/quality-gates.md`.
## Security / Operations
- [ ] Deployment env vars verified:
- [ ] `PORT`
- [ ] `MAX_BODY_BYTES`
- [ ] `MAX_REQUESTS_PER_MINUTE`
- [ ] `SCHEMETA_AUTH_TOKEN` (if hosted deployment requires auth)
- [ ] `CORS_ORIGIN`
- [ ] Rate limiting behavior manually validated.
- [ ] Health endpoint checked in target environment.
- [ ] Structured error telemetry checked for compile/analyze failures.
## Release Artifacts
- [ ] `README.md` updated for any interface/version changes.
- [ ] `api_version` and `schema_version` changes reviewed/documented.
- [ ] Changelog/release notes generated with notable UX/compat changes.
- [ ] Tag pushed and release announcement links to milestone/issues.
- [ ] GA gates in `docs/quality-gates.md` confirmed complete.
- [ ] Attach `output/phase8/cutover-check-report.json` for release evidence.