v0.7.0

What's New

Ocean Brain 0.7.0 is a reliability-focused minor release. It does not change the main workflow, but it makes several long-term note-keeping paths safer: restoring old versions, moving notes through Markdown, and writing notes through MCP.

Safer snapshot restore

Snapshot restore now includes a Compare flow before Restore. The diff shows what would change between the selected snapshot and the current note, with wrapped prose-friendly lines instead of horizontal scrolling.

Use it from a note's previous-version restore modal: choose a snapshot, click Compare, review the diff, then restore only if the change looks right.

More durable Markdown note references

Structured note references can now round-trip through Markdown as ID-backed links:

[[Project Plan]](note:123)

When the note:id part is present, Ocean Brain treats the ID as the stable target and the title as display text. Existing title-only links such as [[Project Plan]] still work for compatibility.

This makes note links more resilient when titles change.

Better Markdown portability

Single-note Markdown export and MCP back-reference output now use the same portable note link format when an ID is available. Tags also stay explicit with bracketed syntax such as [@project], and covered round-trip cases keep code text literal instead of turning examples into real links or tags.

This is still single-note portability work; full vault export remains a separate product decision.

Leaner MCP write flow

MCP write tools now need less context from agents before a safe write:

• compact write baselines can be fetched automatically,
• write tools default to dry-run when dryRun is omitted,
• large dry-run diffs can be shortened with diffPreviewMaxChars,
• change-limit failures report clearer required limits,
• intentional reference removal can be made explicit with preserveReferences: false.

The two-step dry-run and confirm model remains in place.

CLI package fix

The published CLI package now includes the diff runtime dependency required by snapshot diff review. This was caught by the release npx smoke test before tagging and fixed in the same release range.

Upgrade

No manual migration step is required. Ocean Brain still runs database migrations on startup.

For production, prefer exact versions:

npx ocean-brain@0.7.0

docker pull baealex/ocean-brain:0.7.0

Avoid using floating latest tags for production rollback safety.

Included Changes

• ⚡ Reduce MCP write token waste by @baealex in #187
• ✨ Add snapshot diff review by @baealex in #189
• ✨ Support note-id wiki references by @baealex in #188
• ✨ Improve Markdown portability by @baealex in #192
• 🐛 Include diff in CLI runtime dependencies by @baealex in #194
• 🔖 Bump version to 0.7.0 by @baealex in #193

Full Changelog: v0.6.3...v0.7.0