Claude Obsidian v2.1.1 hardens legacy vault migration and adoption, especially for manifests that use batch labels instead of file paths or contain more than 1,024 source observations.
Highlights
- Preserves unresolved legacy batch labels as unreviewed manual sources without inventing payload mappings or SHA-256 values.
- Binds legacy source observations to the reviewed migration approval, then rejects drift, unsafe nodes, and path changes before writing.
- Separates read-only source observations from the 1,024-write recovery limit, so larger valid manifests can migrate safely.
- Adds clearer Windows and WSL support guidance, including evidence-bounded troubleshooting for unconfirmed WSL hangs.
- Makes Git-backed release and checkpoint fixtures independent of machine-wide hooks, signing, and identity settings.
The migration behavior originated in PR #174. Release metadata, final hardening, and the audited artifact were promoted through PR #175.
Upgrade and migration
Upgrade the product independently from your vault. Before migrating an older vault, create a normal backup or snapshot, run the migration dry-run, review its approval hash and changed paths, then apply that exact reviewed plan. The legacy .raw/.manifest.json remains byte-for-byte unchanged.
See the install guide and Windows and WSL guide.
Verification
- 10 of 10 GitHub Actions jobs passed across Ubuntu, macOS, Windows portable, and the reproducible release artifact gate.
- Full hermetic suite and executable contracts passed.
- Fresh Save, Ingest, and Query forward evaluations passed every declared invariant.
- Representative migration rollback, clean retry, idempotent rerun, and portable integration uninstall passed.
- Fresh GPT-5.6 Sol xhigh adversarial verifier verdict:
SHIP, with 0 BLOCKER, 0 HIGH, 0 MEDIUM, and 0 LOW findings. - Final archive built twice from merge commit
9f8c1199047eac2c3828496279fbb7ba9540b90band matched byte for byte.
Artifact integrity
- File:
claude-obsidian-v2.1.1.zip - SHA-256:
756258849bd36197389dc6c47deca95b2b046e10457713b4bbcb5c940cbf2b5e - Size: 3,047,323 bytes
- Payload: 199 files, 2,962,609 bytes
- Artifact audit: 0 errors
Known limitations
- The reporter's private legacy vault bytes were unavailable, so migration was verified with a representative fixture containing both a real file locator and an unresolved batch label.
- Native Windows interactive testing was not available. The Windows portable automated surface passed.
Full changes: v2.1.0...v2.1.1