basic-memory 0.23.0__tar.gz → 0.23.1__tar.gz

{basic_memory-0.23.0 → basic_memory-0.23.1}/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Official Basic Memory plugins from the canonical basic-memory repository",
-    "version": "0.23.0"
+    "version": "0.23.1"
   },
   "plugins": [
     {
       "name": "basic-memory",
       "source": "./plugins/claude-code",
       "description": "The bridge between Claude's working memory and Basic Memory's durable knowledge graph \u2014 session briefings, pre-compaction checkpoints, and capture reflexes",
-      "version": "0.23.0",
+      "version": "0.23.1",
       "author": {
         "name": "Basic Machines"
       },

basic_memory-0.23.1/.github/workflows/mcp-registry-publish.yml

@@ -0,0 +1,36 @@
+name: MCP Registry Publish
+
+# Publishes server.json to the official MCP Registry. GitHub Actions OIDC
+# authenticates this workflow as the repository owner, which grants the
+# io.github.basicmachines-co/* namespace directly — no personal login or
+# public-org-membership derivation involved (the manual `mcp-publisher login
+# github` path proved flaky there; see the v0.23.0 release notes on #1288).
+#
+# Run manually after a release, once the version is live on PyPI.
+
+on:
+  workflow_dispatch:
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install mcp-publisher
+        run: |
+          curl -fsSL "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/').tar.gz" \
+            | tar xz mcp-publisher
+          sudo mv mcp-publisher /usr/local/bin/
+
+      - name: Publish server.json
+        run: |
+          mcp-publisher login github-oidc
+          mcp-publisher publish

{basic_memory-0.23.0 → basic_memory-0.23.1}/CHANGELOG.md

@@ -2,6 +2,53 @@
 
 ## Unreleased
 
+## v0.23.1 (2026-08-25)
+
+Fast-follow patch to v0.23.0 focused on PostgreSQL search parity and a
+search-destroying reindex bug. Postgres now indexes complete note bodies for
+full-text search (previously only titles and capped content stems, unlike
+SQLite), and the per-project search reindex no longer wipes every other
+project's search rows in the same database. Also adds a `#bm:links_to`
+directive for disambiguating prose wiki-links, and hardens `bm update` output
+after in-place upgrades.
+
+### Features
+
+- Added the `#bm:links_to` directive: ending a list item with `#bm:links_to`
+  forces the reference to the implicit `links_to` relation, so a single-token
+  prose prefix (`- Mother [[Alice]] #bm:links_to`) is not parsed as an
+  explicit relation type. The directive stays in the source file but is
+  stripped from indexed observation and relation content.
+
+### Bug Fixes
+
+- PostgreSQL full-text search now covers complete note bodies. Note content is
+  indexed as bounded, overlapping chunks in a new `search_index_fts_chunks`
+  table (a migration backfills existing notes), so deep content matches on
+  Postgres the way it always has on SQLite FTS5. The work includes correct
+  Boolean AND/NOT semantics across chunk boundaries, apostrophe and
+  punctuated-operand handling (`can't`, `v0.13.0b2`, `auth-service`),
+  metadata-filter composition, 100+ operand queries, and candidate
+  preselection so both GIN indexes stay in play.
+- The per-project search reindex (`POST /search/reindex`) no longer drops the
+  shared `search_index` table. Dropping it destroyed every project's search
+  rows in the same database — and on Postgres nothing outside migrations
+  recreates the table, so cloud tenants lost search entirely until manual
+  repair. The rebuild now deletes only the reindexed project's rows (chunk
+  rows cascade), and the chunks migration recreates a missing `search_index`
+  so databases hit by the old behavior migrate cleanly.
+- **#1316**: `bm update` status output no longer crashes after an in-place
+  upgrade removes the running install's files: rich's deferred Unicode width
+  table is preloaded before upgrading, and status lines fall back to plain
+  output instead of failing a completed update.
+- **#1323**: `bm doctor` no longer fails when `BASIC_MEMORY_PROJECT_ROOT`
+  points at an existing project's directory. Doctor now asks the server for a
+  disposable `doctor-*` project under the configured root — the only
+  sanctioned exception to the nested-project guard — and cleanup deletes the
+  project's directory along with its registration.
+- `bm doctor` waits for deferred note materialization before verifying the
+  API-written file, matching the accepted-write contract instead of racing it.
+
 ## v0.23.0 (2026-08-23)
 
 Semantic search grows up and concurrent writes stop deadlocking. Search gains

{basic_memory-0.23.0 → basic_memory-0.23.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: basic-memory
-Version: 0.23.0
+Version: 0.23.1
 Summary: Local-first knowledge management combining Zettelkasten with knowledge graphs
 Project-URL: Homepage, https://github.com/basicmachines-co/basic-memory
 Project-URL: Repository, https://github.com/basicmachines-co/basic-memory

{basic_memory-0.23.0 → basic_memory-0.23.1}/docs/NOTE-FORMAT.md

@@ -166,6 +166,17 @@ Explicit relations:
 - 'in response to' [[Incident Review]]
 ```
 
+When the text before `[[` is ordinary prose rather than a relation type, add
+`#bm:links_to` to force the reference to use the implicit `links_to` relation:
+
+```markdown
+- Mother [[Alice]] #bm:links_to
+```
+
+The directive is parser metadata and is not included in the observation or
+relation context. It is especially useful when a single-token prose prefix
+would otherwise be interpreted as an explicit relation type.
+
 Bare wiki links and prose list items create implicit `links_to` relations:
 
 ```markdown

{basic_memory-0.23.0 → basic_memory-0.23.1}/integrations/hermes/__init__.py

@@ -39,7 +39,7 @@ from typing import Any, Callable
 from agent.memory_provider import MemoryProvider
 from tools.registry import tool_error
 
-__version__ = "0.23.0"
+__version__ = "0.23.1"
 
 logger = logging.getLogger("hermes.memory.basic-memory")
 

{basic_memory-0.23.0 → basic_memory-0.23.1}/integrations/hermes/plugin.yaml

@@ -1,5 +1,5 @@
 name: basic-memory
-version: 0.23.0
+version: 0.23.1
 description: "Basic Memory — persistent knowledge graph backed by the basic-memory MCP server"
 manifest_version: 2
 api_version: 1

{basic_memory-0.23.0 → basic_memory-0.23.1}/integrations/openclaw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basicmemory/openclaw-basic-memory",
-  "version": "0.23.0",
+  "version": "0.23.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

{basic_memory-0.23.0 → basic_memory-0.23.1}/justfile

@@ -521,7 +521,6 @@ doctor:
     TMP_HOME=$(mktemp -d)
     TMP_CONFIG=$(mktemp -d)
     HOME="$TMP_HOME" \
-    BASIC_MEMORY_ENV=test \
     BASIC_MEMORY_HOME="$TMP_HOME/basic-memory" \
     BASIC_MEMORY_CONFIG_DIR="$TMP_CONFIG" \
     ./.venv/bin/python -m basic_memory.cli.main doctor --local
@@ -706,6 +705,8 @@ release version:
         .claude-plugin/marketplace.json \
         plugins/claude-code/.claude-plugin/plugin.json \
         plugins/claude-code/.claude-plugin/marketplace.json \
+        plugins/claude-code/hooks/session_start.py \
+        plugins/claude-code/hooks/pre_compact.py \
         plugins/codex/.codex-plugin/plugin.json \
         plugins/codex/hooks/session_start.py \
         plugins/codex/hooks/pre_compact.py \
@@ -826,6 +827,8 @@ beta version:
         .claude-plugin/marketplace.json \
         plugins/claude-code/.claude-plugin/plugin.json \
         plugins/claude-code/.claude-plugin/marketplace.json \
+        plugins/claude-code/hooks/session_start.py \
+        plugins/claude-code/hooks/pre_compact.py \
         plugins/codex/.codex-plugin/plugin.json \
         plugins/codex/hooks/session_start.py \
         plugins/codex/hooks/pre_compact.py \

{basic_memory-0.23.0 → basic_memory-0.23.1}/plugins/claude-code/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Official plugins from Basic Machines for knowledge management and AI-assisted development",
-    "version": "0.23.0"
+    "version": "0.23.1"
   },
   "plugins": [
     {
       "name": "basic-memory",
       "source": "./",
       "description": "The bridge between Claude's working memory and Basic Memory's durable knowledge graph \u2014 session briefings, pre-compaction checkpoints, and capture reflexes",
-      "version": "0.23.0",
+      "version": "0.23.1",
       "author": {
         "name": "Basic Machines"
       },

{basic_memory-0.23.0 → basic_memory-0.23.1}/plugins/claude-code/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "basic-memory",
   "description": "The bridge between Claude's working memory and Basic Memory's durable knowledge graph \u2014 session briefings, pre-compaction checkpoints, and capture reflexes",
-  "version": "0.23.0",
+  "version": "0.23.1",
   "author": {
     "name": "Basic Machines"
   },

{basic_memory-0.23.0 → basic_memory-0.23.1}/plugins/claude-code/hooks/pre_compact.py

@@ -1,7 +1,14 @@
 #!/usr/bin/env -S uv run --quiet --script
 # /// script
 # requires-python = ">=3.12"
-# dependencies = ["basic-memory>=0.22.1"]
+# dependencies = [
+#     "basic-memory>=0.23.1",
+#     # Direct pre-release pin so old uv resolves basic-memory (which
+#     # requires this exact beta transitively) without enabling
+#     # pre-releases for basic-memory itself. Keep in lockstep with
+#     # core pyproject's fastmcp pin.
+#     "fastmcp==4.0.0b1",
+# ]
 # ///
 """PreCompact hook — the entire hook. All logic (settings resolution, the
 extractive checkpoint note, lifecycle-envelope capture) lives in the released

{basic_memory-0.23.0 → basic_memory-0.23.1}/plugins/claude-code/hooks/session_start.py

@@ -1,7 +1,14 @@
 #!/usr/bin/env -S uv run --quiet --script
 # /// script
 # requires-python = ">=3.12"
-# dependencies = ["basic-memory>=0.22.1"]
+# dependencies = [
+#     "basic-memory>=0.23.1",
+#     # Direct pre-release pin so old uv resolves basic-memory (which
+#     # requires this exact beta transitively) without enabling
+#     # pre-releases for basic-memory itself. Keep in lockstep with
+#     # core pyproject's fastmcp pin.
+#     "fastmcp==4.0.0b1",
+# ]
 # ///
 """SessionStart hook — the entire hook. All logic (settings resolution, the
 context brief, lifecycle-envelope capture) lives in the released basic-memory

{basic_memory-0.23.0 → basic_memory-0.23.1}/plugins/claude-code/hooks/test_claude_pre_compact.py

@@ -119,7 +119,7 @@ def test_dependency_floor_matches_package_version() -> None:
     # scripts/update_versions.py bumps this line at release; drift between the
     # script floor and the package version fails here, before a release lands.
     text = SCRIPT.read_text(encoding="utf-8")
-    floors = re.findall(r'^# dependencies = \["basic-memory>=([^"]+)"\]$', text, re.MULTILINE)
+    floors = re.findall(r'^#     "basic-memory>=([^"]+)",$', text, re.MULTILINE)
 
     assert floors == [__version__]
 

{basic_memory-0.23.0 → basic_memory-0.23.1}/plugins/claude-code/hooks/test_claude_session_start.py

@@ -119,7 +119,7 @@ def test_dependency_floor_matches_package_version() -> None:
     # scripts/update_versions.py bumps this line at release; drift between the
     # script floor and the package version fails here, before a release lands.
     text = SCRIPT.read_text(encoding="utf-8")
-    floors = re.findall(r'^# dependencies = \["basic-memory>=([^"]+)"\]$', text, re.MULTILINE)
+    floors = re.findall(r'^#     "basic-memory>=([^"]+)",$', text, re.MULTILINE)
 
     assert floors == [__version__]
 

{basic_memory-0.23.0 → basic_memory-0.23.1}/plugins/codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codex",
-  "version": "0.23.0",
+  "version": "0.23.1",
   "description": "A Codex-native bridge to Basic Memory for durable engineering context, decisions, and resumable checkpoints.",
   "author": {
     "name": "Basic Machines",

{basic_memory-0.23.0 → basic_memory-0.23.1}/plugins/codex/hooks/pre_compact.py

@@ -2,7 +2,11 @@
 # /// script
 # requires-python = ">=3.12"
 # dependencies = [
-#     "basic-memory @ git+https://github.com/basicmachines-co/basic-memory@v0.23.0",
+#     "basic-memory @ git+https://github.com/basicmachines-co/basic-memory@v0.23.1",
+#     # Direct pre-release pin so old uv resolves basic-memory (which
+#     # requires this exact beta transitively) without enabling
+#     # pre-releases broadly. Keep in lockstep with core pyproject.
+#     "fastmcp==4.0.0b1",
 # ]
 # ///
 """PreCompact hook launcher backed by a pinned Basic Memory revision.

{basic_memory-0.23.0 → basic_memory-0.23.1}/plugins/codex/hooks/session_start.py

@@ -2,7 +2,11 @@
 # /// script
 # requires-python = ">=3.12"
 # dependencies = [
-#     "basic-memory @ git+https://github.com/basicmachines-co/basic-memory@v0.23.0",
+#     "basic-memory @ git+https://github.com/basicmachines-co/basic-memory@v0.23.1",
+#     # Direct pre-release pin so old uv resolves basic-memory (which
+#     # requires this exact beta transitively) without enabling
+#     # pre-releases broadly. Keep in lockstep with core pyproject.
+#     "fastmcp==4.0.0b1",
 # ]
 # ///
 """SessionStart hook launcher backed by a pinned Basic Memory revision.

{basic_memory-0.23.0 → basic_memory-0.23.1}/scripts/update_versions.py

@@ -153,8 +153,8 @@ def _update_packages(version: str, *, dry_run: bool) -> None:
     for script in HOOK_SCRIPTS:
         update_text(
             script,
-            r'^# dependencies = \["basic-memory>=[^"]+"\]$',
-            f'# dependencies = ["basic-memory>={version}"]',
+            r'^#     "basic-memory>=[^"]+",$',
+            f'#     "basic-memory>={version}",',
             dry_run=dry_run,
         )
     update_text(

{basic_memory-0.23.0 → basic_memory-0.23.1}/scripts/validate_claude_plugin.py

@@ -137,6 +137,20 @@ def validate_claude_plugin(plugin_dir: Path) -> None:
     for event in REQUIRED_HOOK_EVENTS:
         if event not in hooks:
             raise SystemExit(f"hooks/hooks.json: missing {event} hook")
+    # Trigger: the shims pin core's exact fastmcp beta so older uv can resolve
+    #   basic-memory (pre-release transitives are refused there) without
+    #   enabling pre-releases for basic-memory itself.
+    # Why: nothing else keeps the shim pin and core's pyproject in lockstep,
+    #   and drift makes shim resolution conflict — which the fail-open contract
+    #   turns into a silent hook no-op.
+    # Outcome: validation fails loudly when core moves its fastmcp pin without
+    #   the shims following.
+    core_pyproject = (ROOT / "pyproject.toml").read_text(encoding="utf-8")
+    core_match = re.search(r'^\s*"fastmcp==([^"]+)",$', core_pyproject, re.MULTILINE)
+    if not core_match:
+        raise SystemExit("pyproject.toml: no exact fastmcp pin found")
+    core_fastmcp_pin = core_match.group(1)
+
     for rel in REQUIRED_HOOK_SCRIPTS:
         script = plugin_dir / rel
         if not script.exists():
@@ -145,9 +159,17 @@ def validate_claude_plugin(plugin_dir: Path) -> None:
             raise SystemExit(f"Hook script is not executable: {script}")
         text = script.read_text(encoding="utf-8")
         if "# /// script" not in text or not re.search(
-            r'^# dependencies = \["basic-memory>=[^"]+"\]$', text, re.MULTILINE
+            r'^#     "basic-memory>=[^"]+",$', text, re.MULTILINE
         ):
             raise SystemExit(f"Hook script missing PEP 723 basic-memory floor: {script}")
+        shim_pins = re.findall(r'^#     "fastmcp==([^"]+)",$', text, re.MULTILINE)
+        if len(shim_pins) != 1:
+            raise SystemExit(f"Hook script missing exact fastmcp pin: {script}")
+        if shim_pins[0] != core_fastmcp_pin:
+            raise SystemExit(
+                f"{script}: fastmcp pin {shim_pins[0]} does not match "
+                f"core pyproject pin {core_fastmcp_pin}"
+            )
 
     # --- Output style ---
     output_style = plugin_dir / "output-styles/basic-memory.md"

{basic_memory-0.23.0 → basic_memory-0.23.1}/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/basicmachines-co/basic-memory.git",
     "source": "github"
   },
-  "version": "0.23.0",
+  "version": "0.23.1",
   "packages": [
     {
       "registryType": "pypi",
       "identifier": "basic-memory",
-      "version": "0.23.0",
+      "version": "0.23.1",
       "runtimeHint": "uvx",
       "runtimeArguments": [
         {

{basic_memory-0.23.0 → basic_memory-0.23.1}/src/basic_memory/__init__.py

@@ -1,7 +1,7 @@
 """basic-memory - Local-first knowledge management combining Zettelkasten with knowledge graphs"""
 
 # Package version - updated by release automation
-__version__ = "0.23.0"
+__version__ = "0.23.1"
 
 # API version for FastAPI - independent of package version
 __api_version__ = "v2"

basic_memory-0.23.1/src/basic_memory/alembic/versions/7f6a2b8c9d10_index_full_postgres_note_content.py

@@ -0,0 +1,133 @@
+"""Index complete PostgreSQL note content for full-text search.
+
+Revision ID: 7f6a2b8c9d10
+Revises: 2d26b287813b
+Create Date: 2026-08-24 22:00:00.000000
+
+"""
+
+from typing import Sequence, Union
+
+from alembic import op
+
+
+# revision identifiers, used by Alembic.
+revision: str = "7f6a2b8c9d10"
+down_revision: Union[str, None] = "2d26b287813b"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Index complete note bodies as bounded PostgreSQL FTS chunks."""
+    connection = op.get_bind()
+    if connection.dialect.name == "postgresql":
+        # --- Repair: recreate search_index if a destructive reindex removed it ---
+        # Trigger: search_index does not exist. Through v0.23.0, the per-project
+        # search reindex ran DROP TABLE IF EXISTS search_index, and on Postgres
+        # nothing outside migrations recreates that table.
+        # Why: the chunk backfill below reads search_index and the chunks table
+        # declares a foreign key to it, so without repair this migration fails
+        # permanently and blocks the database from ever reaching head.
+        # Outcome: healthy databases no-op on IF NOT EXISTS; a repaired database
+        # gets an empty index that the next full reindex repopulates. The DDL
+        # mirrors the current schema in models/search.py.
+        op.execute("""
+            CREATE TABLE IF NOT EXISTS search_index (
+                id INTEGER NOT NULL,
+                project_id INTEGER NOT NULL,
+                title TEXT,
+                content_stems TEXT,
+                content_snippet TEXT,
+                permalink VARCHAR,
+                file_path VARCHAR,
+                type VARCHAR,
+                from_id INTEGER,
+                to_id INTEGER,
+                relation_type VARCHAR,
+                entity_id INTEGER,
+                category VARCHAR,
+                metadata JSONB,
+                created_at TIMESTAMP WITH TIME ZONE,
+                updated_at TIMESTAMP WITH TIME ZONE,
+                textsearchable_index_col tsvector GENERATED ALWAYS AS (
+                    to_tsvector(
+                        'english',
+                        coalesce(title, '') || ' ' ||
+                        coalesce(content_stems, '')
+                    )
+                ) STORED,
+                PRIMARY KEY (id, type, project_id),
+                FOREIGN KEY (project_id) REFERENCES project(id) ON DELETE CASCADE
+            )
+        """)
+        op.execute("""
+            CREATE INDEX IF NOT EXISTS ix_search_index_project_id
+            ON search_index (project_id)
+        """)
+        op.execute("""
+            CREATE INDEX IF NOT EXISTS idx_search_index_fts
+            ON search_index USING gin(textsearchable_index_col)
+        """)
+        op.execute("""
+            CREATE INDEX IF NOT EXISTS idx_search_index_metadata_gin
+            ON search_index USING gin(metadata jsonb_path_ops)
+        """)
+        op.execute("""
+            CREATE UNIQUE INDEX IF NOT EXISTS uix_search_index_permalink_project
+            ON search_index (permalink, project_id)
+            WHERE permalink IS NOT NULL
+        """)
+        op.execute("""
+            CREATE TABLE search_index_fts_chunks (
+                project_id INTEGER NOT NULL,
+                search_index_id INTEGER NOT NULL,
+                search_index_type VARCHAR NOT NULL,
+                chunk_index INTEGER NOT NULL,
+                chunk_text TEXT NOT NULL,
+                textsearchable_index_col tsvector GENERATED ALWAYS AS (
+                    to_tsvector('english', chunk_text)
+                ) STORED,
+                PRIMARY KEY (project_id, search_index_id, search_index_type, chunk_index),
+                FOREIGN KEY (search_index_id, search_index_type, project_id)
+                    REFERENCES search_index(id, type, project_id)
+                    ON UPDATE CASCADE ON DELETE CASCADE
+            )
+        """)
+        op.execute("""
+            -- PostgreSQL ignores lexemes at 2 KiB and above. Stepping 5,952
+            -- characters leaves a conservative 2,048-character overlap, so
+            -- every indexable lexeme split at one edge is complete in the next.
+            INSERT INTO search_index_fts_chunks (
+                project_id,
+                search_index_id,
+                search_index_type,
+                chunk_index,
+                chunk_text
+            )
+            SELECT
+                search_index.project_id,
+                search_index.id,
+                search_index.type,
+                (chunk_start - 1) / 5952,
+                substring(search_index.content_snippet FROM chunk_start FOR 8000)
+            FROM search_index
+            CROSS JOIN LATERAL generate_series(
+                1,
+                length(search_index.content_snippet),
+                5952
+            ) AS chunk_start
+            WHERE search_index.content_snippet IS NOT NULL
+              AND search_index.content_snippet <> ''
+        """)
+        op.execute("""
+            CREATE INDEX idx_search_index_fts_chunks_fts
+            ON search_index_fts_chunks USING gin(textsearchable_index_col)
+        """)
+
+
+def downgrade() -> None:
+    """Remove the bounded full-content PostgreSQL FTS chunks."""
+    connection = op.get_bind()
+    if connection.dialect.name == "postgresql":
+        op.execute("DROP TABLE IF EXISTS search_index_fts_chunks")

{basic_memory-0.23.0 → basic_memory-0.23.1}/src/basic_memory/api/v2/routers/project_router.py

@@ -221,6 +221,28 @@ async def add_project(
         raise HTTPException(status_code=400, detail=str(e))
 
 
+@router.post("/doctor", response_model=ProjectStatusResponse, status_code=201)
+async def add_doctor_project(project_service: ProjectServiceDep) -> ProjectStatusResponse:
+    """Create a server-generated disposable project for the local doctor check."""
+    try:
+        new_project = await project_service.add_doctor_project()
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail=str(e))
+
+    return ProjectStatusResponse(
+        message=f"Project '{new_project.name}' added successfully",
+        status="success",
+        default=new_project.is_default or False,
+        new_project=ProjectItem(
+            id=new_project.id,
+            external_id=new_project.external_id,
+            name=new_project.name,
+            path=new_project.path,
+            is_default=new_project.is_default or False,
+        ),
+    )
+
+
 @router.post("/config/sync", response_model=ProjectStatusResponse)
 async def synchronize_projects(
     project_service: ProjectServiceDep,

{basic_memory-0.23.0 → basic_memory-0.23.1}/src/basic_memory/cli/auto_update.py

@@ -221,6 +221,38 @@ def _preload_lazy_console_modules() -> None:
     """
     import rich._emoji_codes  # noqa: F401
     import typer.rich_utils  # noqa: F401
+    from rich.cells import cell_len
+
+    # Trigger: rich defers its Unicode cell-width table (`rich._unicode_data.
+    # unicode<version>`) until the first character it cannot measure with the
+    # ASCII fast path in `_cell_len`.
+    # Why: status messages echo captured `brew`/`uv` output, which carries
+    # non-ASCII characters (curly quotes, em dashes, warning glyphs), so the
+    # deferred import lands after the upgrade removed our files. Importing the
+    # module by name would hard-code a table version; calling `cell_len` uses
+    # rich's own resolution and honors UNICODE_VERSION like the print path does.
+    # Outcome: the table rich will reach for is resolved and cached up front.
+    cell_len("\u2500\u2018\u2713")
+
+
+def print_update_status(console: Console, text: str, style: str) -> None:
+    """Print an update status line that cannot fail the command.
+
+    Trigger: the line is printed after an in-place upgrade may already have
+    replaced this installation on disk.
+    Why: `_preload_lazy_console_modules` can only preload the deferred imports
+    we know about today, and rich/typer are free to add more. By the time this
+    prints, the upgrade has already succeeded -- a status line must never be
+    what turns it into a traceback and a non-zero exit.
+    Outcome: fall back to a plain, unstyled write that needs no new imports.
+    """
+    try:
+        console.print(f"[{style}]{text}[/{style}]")
+    except Exception as exc:
+        logger.warning(
+            f"Rich console print failed after update, falling back to plain output: {exc}"
+        )
+        print(text)
 
 
 def _save_last_checked_timestamp(config_manager: ConfigManager, checked_at: datetime) -> None:
@@ -468,11 +500,11 @@ def maybe_run_periodic_auto_update(
     }:
         out = console or Console()
         if result.status == AutoUpdateStatus.UPDATED:
-            out.print(f"[green]{result.message}[/green]")
+            print_update_status(out, f"{result.message}", "green")
         elif result.status == AutoUpdateStatus.FAILED:
             error_detail = f" {result.error}" if result.error else ""
-            out.print(f"[yellow]{result.message}{error_detail}[/yellow]")
+            print_update_status(out, f"{result.message}{error_detail}", "yellow")
         elif result.message:
-            out.print(f"[cyan]{result.message}[/cyan]")
+            print_update_status(out, f"{result.message}", "cyan")
 
     return result