Skip to content

Conversation

@RobbieMcKinstry
Copy link
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