schemeta/docs/release-checklist.md

1.9 KiB

Schemeta Release Checklist

Use this checklist before cutting a release tag. Reference docs:

  • docs/quality-gates.md
  • docs/phase4-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.
  • 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.
  • Dense analog fixture meets gate thresholds (crossings=0, overlaps=0, detour target).

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.