docs: version bump for Basic Memory v0.21.0 (#20)

* docs: version bump for Basic Memory v0.21.0

Followed the CLAUDE.md Version Bump Checklist:

1. Release notes — renamed 0.v0.20.0.md → 0.v0.21.0.md and rewrote
   for v0.21.0: workspace-aware routing, faster search/sync, recent
   activity ordering fix, opt-in multi-project search + result
   totals, CLI quality-of-life (bm orphan, db reset guard), tool
   parameter aliases, parsing footgun fixes. Prominent ::warning for
   the breaking relation-parsing change (#824) with quoting guidance.
2. Homepage badge — content/index.md: v0.20 → v0.21, link points to
   /whats-new/v0.21.0.
3. Changelog — auto-fetches from GitHub releases, no manual change.
4. CLAUDE.md — bumped the "up-to-date for vX" status line and the
   release-notes reference command to v0.21.

v0.21.1 is CI-only (Homebrew bump tooling); noted as a patch aside
rather than its own page. All internal links in the new page
verified against existing content files.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* docs: reframe v0.21 routing section as Basic Memory Teams support

Rename the section heading to "Basic Memory Teams Support" and
rewrite the intro, frontmatter description, and section body around
the user-facing concept instead of internals.

The old body led with "the headline of this release" and an
implementation list (edit_note, delete_project, factory-mode project
listing, the API client) that assumes the reader already knows what
workspace routing is. Replaced with: what a team is (a shared cloud
workspace alongside your personal one), what was wrong before
(assistant saw an inconsistent slice of projects), and what v0.21
delivers (consistent routing everywhere). The concrete "What you'll
notice" bullets are kept — they now have context.

Grounded in BM cloud's existing personal/organization workspace
model; no Teams setup/billing specifics invented.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* update whats-new with v0.21.0 release notes

* fix grammar problem in v0.21.0 notes

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: groksrc

CLAUDE.md

@@ -181,13 +181,13 @@ When updating docs for a new Basic Memory release, update all of the following:
 
 ## Documentation Status & Priorities
 
-Documentation is up-to-date for v0.20.x release. Cloud product documentation is complete.
+Documentation is up-to-date for v0.21.x release. Cloud product documentation is complete.
 
 ### Reference Materials
 
 When documenting features:
 - **Basic Memory CHANGELOG**: `gh api repos/basicmachines-co/basic-memory/contents/CHANGELOG.md`
-- **Release Notes**: `gh release view v0.20.0 --repo basicmachines-co/basic-memory`
+- **Release Notes**: `gh release view v0.21.0 --repo basicmachines-co/basic-memory`
 - **Basic Memory README**: https://github.com/basicmachines-co/basic-memory
 - **Cloud README**: https://github.com/basicmachines-co/basic-memory-cloud
 - **Cloud CLAUDE.md**: https://github.com/basicmachines-co/basic-memory-cloud/blob/main/CLAUDE.md

content/2.whats-new/0.v0.20.0.md

@@ -0,0 +1,100 @@
+---
+title: v0.21.0
+description: Basic Memory Teams support — shared cloud workspaces that work consistently across MCP and CLI, plus faster search and sync and parsing footgun fixes in v0.21.
+---
+
+v0.21.0 brings **Basic Memory Teams** support: shared cloud workspaces now work consistently across every MCP tool and CLI command, so your AI assistant reaches the right projects whether you're working solo or with a team. Search and sync are also noticeably faster, and a handful of long-standing parsing footguns are gone.
+
+::warning
+**Breaking change: relation parsing.** Unquoted multi-word text before a wikilink is no longer treated as a custom relation type. If you rely on multi-word relation types, **quote them before upgrading** so they survive the next re-sync. See [Upgrading](#upgrading) below.
+::
+
+---
+
+## Basic Memory Teams Support
+
+This is our first release to include support for Basic Memory Teams (subscription required). When you work with Teams, your projects live in a shared cloud workspace that everyone on the team can read and write. If you have a local workspace or personal Basic Memory subscription you can continue to use both at the same time.
+
+What you'll notice:
+
+- **Cross-workspace project discovery in MCP** — your assistant's project list now spans every accessible cloud workspace, not just the current one.
+- **`bm project list` spans all workspaces** — no more missing projects depending on which workspace you were in.
+- **Create projects by workspace slug from MCP** — `create_memory_project(workspace=...)` targets a specific cloud workspace directly.
+- **`bm project add --visibility`** — set visibility for cloud projects at creation time.
+
+---
+
+## Faster Search and Sync
+
+- **Search hydration** no longer issues an N+1 query — results come back faster, especially on large knowledge bases.
+- **File indexing is batched** during sync, and single-file sync is significantly quicker.
+- **Vector sync** does less redundant work, with tuned embedding defaults.
+
+No configuration changes required — existing projects just get faster on upgrade.
+
+---
+
+## Recent Activity, Fixed
+
+`recent_activity` now orders and filters by `updated_at`, so notes you just edited bubble to the top instead of staying pinned to their creation time. Responses are also capped with an explicit truncation footer, so you can tell when there's more rather than silently losing rows.
+
+---
+
+## Search Scope and Totals
+
+- **Multi-project search is now opt-in.** `search_notes` stays scoped to the resolved project by default; pass `search_all_projects=True` to search everything. This makes everyday search predictable.
+- **Search responses include result totals**, so paginated clients can stop guessing how many matches exist.
+
+---
+
+## CLI Quality of Life
+
+- **`bm orphan`** surfaces entities whose underlying markdown files are gone, with a flag to clean them out.
+- **`bm db reset` is now guarded** — it refuses to run while a `basic-memory mcp` process is alive, so a reset can no longer corrupt an open session.
+- **`bm project info`** reports cloud index freshness; private projects show their display name instead of a raw UUID.
+
+---
+
+## Training-Data-Friendly Tool Aliases
+
+MCP tools now accept the parameter names models reach for naturally — `q` / `search` / `text` as aliases for `query`, and similar across other tools. Assistants spend fewer turns correcting argument names, so common operations just work on the first try.
+
+---
+
+## Parsing Footgun Fixes
+
+- **Obsidian callouts** are skipped by the observation parser — `> [!note]` blocks no longer get misread as observations.
+- **Long `relation_type` values** are handled correctly (regression guarded).
+- The relation-parsing change below removes the biggest footgun of all: prose accidentally becoming relation types.
+
+---
+
+## Upgrading
+
+::warning
+**Relation parsing changed (#824).** Unquoted multi-word text before a wikilink is no longer treated as a custom relation type:
+
+- Bare list wikilinks like `- [[Target]]` now index as `links_to`.
+- Prose list items like `- some other thing [[Target]]` now index as `links_to`.
+- Single-token relation types are unaffected: `relates_to [[Target]]` still works.
+
+To preserve existing multi-word relation types across the next re-sync, **quote them before upgrading**: `"relates to" [[Target]]` or `'relates to' [[Target]]`.
+::
+
+The rest of the release is backward compatible — search, sync, and routing improvements apply automatically with no configuration changes.
+
+::note
+**Patch release:** v0.21.1 is a CI-only release (Homebrew formula bump tooling) with no user-facing changes.
+::
+
+---
+
+## Documentation
+
+- Updated: [Memory URLs](/concepts/memory-urls) — workspace-qualified routing and resolution order
+- Updated: [Local & Cloud Routing](/cloud/routing) — cross-workspace project behavior
+- Updated: [MCP Tools Reference](/reference/mcp-tools-reference) — parameter aliases, `search_all_projects`, result totals
+- Updated: [CLI Reference](/reference/cli-reference) — `bm orphan`, `bm db reset` guard, `--visibility`
+- Updated: [Knowledge Format](/concepts/knowledge-format) — relation-type quoting rules
+
+For commit-level release history, see [Changelog](/whats-new/changelog).

content/2.whats-new/0.v0.21.0.md

@@ -44,10 +44,10 @@ See why your AI needs Basic Memory.
   :::u-button
   ---
   size: sm
-  to: /whats-new/v0.20.0
+  to: /whats-new/v0.21.0
   variant: outline
   ---
-  v0.20 →
+  v0.21 →
   :::
 
 #default