Skip to content

v0.6.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 02 Jun 15:25
· 34 commits to main since this release
v0.6.0
d4764e3
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

What's New

Ocean Brain 0.6.0 adds structured note properties, property-aware Views, and safer MCP workflows for agents. It keeps notes as the primary writing surface, but adds a shared metadata layer for values that need to stay queryable across notes, such as project, status, priority, dates, and URLs.

Note Properties

  • Shared property definitions can now be managed from Settings > Properties.
  • Notes can attach typed property values while keeping the main note body free-form.
  • Supported property types include text, URL, number, date, boolean, and select.
  • Select properties use managed option datasets so values such as todo, doing, waiting, and done stay consistent across notes.
  • Property keys and value types stay immutable after creation to avoid accidental data migration issues.
  • Property display names and select option labels can be edited safely without changing stored values.
  • Property deletion shows impact-aware confirmation when existing notes are affected.
  • Note snapshots, trash restore, and note reads now preserve or expose property metadata where needed.

For more context, see my Korean development note: Why I added Properties to Ocean Brain (Korean).

Views and Filters

  • Views can now be built from saved filters instead of tag-only sections.
  • A view section can filter by tags, properties, both together, or no filters for an all-notes section.
  • Property filters support exact values, existence checks, and date/number range-style operators where applicable.
  • Tag filters remain available, so existing tag-based workflows can continue unchanged.
  • The current rendering stays list-based; this release prepares the saved query model for future view display modes.

MCP Agent Workflows

  • MCP clients now have safer intent-based note write tools for patching, appending, metadata updates, and explicit full-note replacement.
  • Destructive MCP writes use dry-run previews, confirmation tokens, operation fingerprints, and baseline checks before applying changes.
  • MCP note reads now include property metadata so agents can understand property names, raw values, value types, and select option labels.
  • MCP clients can list shared property definitions and query notes by property filters.
  • MCP metadata updates can set or delete existing note property values without adding another single-purpose property write tool.
  • Property query output stays lightweight by default, with optional property details when callers ask for them.

Documentation and Project Metadata

  • The README now positions Ocean Brain around connected notes and self-hosted knowledge management instead of product comparisons.
  • Ocean Brain now includes an explicit MIT license in the repository and package metadata.
  • Release-note guidance was clarified so patch and minor releases keep a consistent format.

Upgrade Notes

  • Normal npx, Docker, and source-based users do not need any manual setup step beyond upgrading.
  • New database migrations for note properties and saved view filters are applied automatically by the existing startup migration flow.
  • Existing notes, tags, reminders, and tag-based view sections remain compatible.
  • Existing MCP clients can keep using the older note update path, but new agent workflows should prefer patch, append, metadata, or explicit replace tools.
  • Direct GraphQL callers that create or update properties should use the shared property definition APIs and keep property keys/value types stable after creation.

Production installs should continue using exact versions:

npx ocean-brain@0.6.0
docker run baealex/ocean-brain:0.6.0

No breaking changes are expected.

Included PRs

Full Changelog: v0.5.0...v0.6.0

Assets 2
Loading