Skip to content

v0.19.0

Choose a tag to compare

@github-actions github-actions released this 30 Oct 05:31
· 30 commits to main since this release
54630e9

What's New

Logical workspaces

Keep a project's notes, properties and views separate from the rest of your knowledge. Existing notes remain in the default Notes workspace with their IDs and references preserved.

Open Settings → Workspaces to create and manage workspaces. Once you have more than one, switch between them from the sidebar. Notes, search, tags, views, graph, calendar, reminders and trash follow the selected workspace. Properties and Trash are available from Workspace settings. With a single workspace, the familiar note workflow remains simple.

Workspace icons, names and archives help organize ongoing and completed work. Archived workspaces stay readable and reject writes until restored. Workspaces organize data; existing integration credentials retain access across workspaces.

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

Explicit note moves

Move notes between workspaces with compatible property mappings, version checks and before/after recovery snapshots. Note IDs and references remain stable, and properties are not silently discarded.

MCP and integrations

MCP adds workspace discovery with ocean_brain_list_workspaces, optional read scopes and ownership metadata. Omitted API/MCP read scopes retain all-workspace reads; omitted capture still targets the default workspace unless a saved view supplies its owner. Selecting a workspace in the browser does not change a scheduled integration job's target.

MCP compatibility remains 0.17.0. After upgrading the server to 0.19.0, upgrade the MCP adapter to 0.19.0 to use the new capabilities, then reconnect your MCP client to reload its tool catalog. Client compatibility metadata describes the API contract, separately from the app package version.

Property forms and interface polish

Mobile property create/edit sheets adjust to the visible area above the keyboard and keep later option inputs in view. Workspace and view placeholders use generic prompts. The mobile regression tests simulate keyboard geometry; physical Android keyboard behavior still needs device verification.

The release also updates the Hono server dependency to 2.1.3 for GHSA-rmxm-3fg6-px4f. Dependency and packed-package audits found no known vulnerabilities during release validation.

Upgrade

  1. Stop the running instance and back up its persisted database and assets before upgrading.
  2. Keep your existing authentication settings, data paths and mounted volumes. The first startup runs one automatic database migration, placing existing records in the default workspace.
  3. Start the pinned version using your existing configuration:
npx -y ocean-brain@0.19.0 serve

For Docker, pull the pinned image and recreate your existing service with the same configuration and volumes:

docker pull baealex/ocean-brain:0.19.0

For an existing Compose deployment, update its image to:

image: baealex/ocean-brain:0.19.0

Returning to an older app version after this migration requires restoring the pre-upgrade database and asset backup. Running an older binary against the migrated database is not supported. Preserve any later changes separately before restoring a backup.

Included changes

Full Changelog: v0.18.0...v0.19.0