# 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.