Problem
When sparrowdb.node is replaced (format change), the existing database becomes unreadable with no warning.
The upgrade should not happen until a backup exists AND the export/import tools are verified.
Solution
Document the upgrade procedure:
- Run
kms export → verify output file exists and node count matches
- Swap
sparrowdb.node
- Run
kms import <backup-file> into fresh DB path
- Run
kms_ping to verify counts match
- Point
SPARROWDB_PATH at new DB
Blocked by: export and import issues.