Skip to content

feat(migration): add release readiness checks and rollback evidence - #326

Merged
BigDella merged 2 commits into
Parcel-Protocol:mainfrom
Rodrigoue9:feat/322-migration-release-readiness
Oct 22, 2026
Merged

BigDella merged 2 commits into
Parcel-Protocol:mainfrom
Rodrigoue9:feat/322-migration-release-readiness

Conversation

@Rodrigoue9

Copy link
Copy Markdown
Contributor

Summary

  • Implements release readiness verification gates for database and schema migrations (core/migration/release-readiness.ts).
  • Normal path: Verifies that pending migrations have declarative schema versions, dry-run preview evidence, documented rollback/forward-fix procedures, and registered post-migration invariant checks.
  • Rollback evidence: Generates tamper-evident, cryptographically verifiable rollback evidence bundles (RollbackEvidenceBundle) with SHA-256 digests of pre-migration snapshots and rollback procedures.
  • Authorization path: Enforces role-based access control, requiring maintainer or release_manager roles and rejecting unauthorized callers with detailed audit trails.
  • Retry path: Resilient readiness probe evaluation with configurable exponential backoff to handle transient cluster and storage health checks.
  • Executable verification: Ships scripts/verify-migration-readiness.mjs and npm script npm run verify:migration-readiness.
  • Automated test suite: Covers normal, failure, retry, authorization, and rollback evidence integrity paths in core/migration/__tests__/releaseReadiness.test.ts.

Closes #322

Test plan

  • node scripts/verify-migration-readiness.mjs passes with verified evidence bundles
  • node scripts/release-readiness-gate.mjs passes (4/4 gates satisfied)

@BigDella

BigDella commented Oct 22, 2026 •

Copy link
Copy Markdown
Contributor

Merged after updating/checking against the live base branch and passing the required Malware guard. The earlier status comment was based on an older GitHub merge preview or a branch that did not need updating; it was not a finding that this contribution introduced malware.

@BigDella
BigDella merged commit 9b0ac7e into Parcel-Protocol:main Oct 22, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

utix: Add release readiness checks for migrations and rollback evidence

2 participants