// lib/accounting/core/README.migration.md

# Migration Safety (WP-01)

## Migration Constraints

- No migration or extraction logic may bypass the contracts in this directory.
- All migrated data must be validated using the core validation rules and dimension validator.
- All migrated journals must be hash-chained and immutable.
- All event types in migration must be registered and versioned.
- All open balances must be recalculated using the open balance engine.
- All currency and precision data must be snapshotted.
- All migration scripts must be idempotent and auditable.

## Migration Checklist

- [ ] Core contracts fully implemented
- [ ] All event types registered
- [ ] All validation rules enforced
- [ ] Hash chain and immutability enforced
- [ ] Open balance engine used
- [ ] Currency snapshot for all journals
- [ ] Golden matrix tests pass for all migrated scenarios

---

> **Note:** Migration is not permitted until all items above are complete and validated.
