Skip to content

Claude Obsidian v2.1.1 - Legacy Migration Safety

Latest

Choose a tag to compare

@AgriciDaniel AgriciDaniel released this 25 Aug 23:32
9f8c119

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 9f8c1199047eac2c3828496279fbb7ba9540b90b and 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