Skip to content

Add design document for migration integrity verification#67

Merged
RobbieMcKinstry merged 1 commit into
trunkfrom
claude/document-migration-tracking-EXRML
Jan 24, 2026
Merged

Add design document for migration integrity verification#67
RobbieMcKinstry merged 1 commit into
trunkfrom
claude/document-migration-tracking-EXRML

Conversation

@RobbieMcKinstry

Copy link
Copy Markdown
Contributor

DOCS: Add design document for schema and migration hash verification

This document describes the expected behavior for integrity checks during
migrate up/down commands, including verification of both the xxhash3 schema
checksum and BLAKE3 migration hash against the database's tracking tables.

Key contents:

  • Rationale for two-hash verification approach
  • Current implementation gaps (schema checksum stored but never verified)
  • Proposed verification flow for both up and down migrations
  • Detailed implementation changes needed in tracker, executor, and CLI
  • Error handling and force flag design

DOCS: Add design document for schema and migration hash verification

This document describes the expected behavior for integrity checks during
migrate up/down commands, including verification of both the xxhash3 schema
checksum and BLAKE3 migration hash against the database's tracking tables.

Key contents:
- Rationale for two-hash verification approach
- Current implementation gaps (schema checksum stored but never verified)
- Proposed verification flow for both up and down migrations
- Detailed implementation changes needed in tracker, executor, and CLI
- Error handling and force flag design
@RobbieMcKinstry RobbieMcKinstry merged commit 85dfd64 into trunk Jan 24, 2026
1 check passed
@RobbieMcKinstry RobbieMcKinstry deleted the claude/document-migration-tracking-EXRML branch January 24, 2026 20:54
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.

2 participants