v0.0.2

docs/architecture.md

@@ -1,4 +1,4 @@
-# Architecture — release 0.0.1
+# Architecture — release 0.0.2
 
 ## One process with explicit module boundaries
 
@@ -101,12 +101,7 @@ operation timeouts or the number of devices require a longer shutdown window.
 
 ## Fresh initialization and explicit import
 
-`src/schema.sql` contains the complete current schema. If the database file does not
-exist, startup creates a fresh database. If a database file exists, startup first
-opens it read-only and validates that it already has the supported schema. An older
-or unrelated schema is rejected with instructions to use a fresh installation and
-explicit import. Startup does not run `ALTER TABLE`, create upgrade snapshots, add
-migration journals, or move backup files.
+`src/schema.sql` contains the complete current schema. If the database file does not exist, startup creates a fresh schema v2 database. If a database file exists, startup first validates a private read-only snapshot. Current schema v2 databases are accepted unchanged; the supported Rust 0.0.1 schema v1 is then upgraded transactionally to v2 after storage locking. Unsupported or unrelated schemas are rejected with instructions to use a fresh installation or explicit Python import. Startup schema migration does not move backup files.
 
 The separate `import-python --source DIR [--database PATH] [--backup-root DIR]`
 command imports into a new destination. The `import-python.sh` wrapper builds the