basic-memory 0.23.1.dev24__tar.gz → 0.23.2.dev2__tar.gz

{basic_memory-0.23.1.dev24 → basic_memory-0.23.2.dev2}/.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.dev24 → basic_memory-0.23.2.dev2}/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## Unreleased
 
+### Bug Fixes
+
+- `write_note` and `move_note` no longer create case-duplicate folders
+  (`schemas/` beside an existing `Schemas/`). When a requested directory is
+  not an existing folder but matches exactly one existing folder
+  case-insensitively, the note lands in the existing folder; unknown folders
+  are still created as given, and existing case-variant siblings keep today's
+  exact behavior. Folders are resolved from the indexed database paths, so
+  local and cloud runtimes behave identically. (#1326)
+
 ## v0.23.1 (2026-08-25)
 
 Fast-follow patch to v0.23.0 focused on PostgreSQL search parity and a
@@ -41,6 +51,11 @@ after in-place upgrades.
   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.
 

{basic_memory-0.23.1.dev24 → basic_memory-0.23.2.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: basic-memory
-Version: 0.23.1.dev24
+Version: 0.23.2.dev2
 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.1.dev24 → basic_memory-0.23.2.dev2}/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.1.dev24 → basic_memory-0.23.2.dev2}/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.1.dev24 → basic_memory-0.23.2.dev2}/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.1.dev24 → basic_memory-0.23.2.dev2}/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.1.dev24 → basic_memory-0.23.2.dev2}/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.1.dev24 → basic_memory-0.23.2.dev2}/plugins/claude-code/hooks/pre_compact.py

@@ -2,7 +2,7 @@
 # /// script
 # requires-python = ">=3.12"
 # dependencies = [
-#     "basic-memory>=0.23.0",
+#     "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

{basic_memory-0.23.1.dev24 → basic_memory-0.23.2.dev2}/plugins/claude-code/hooks/session_start.py

@@ -2,7 +2,7 @@
 # /// script
 # requires-python = ">=3.12"
 # dependencies = [
-#     "basic-memory>=0.23.0",
+#     "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

{basic_memory-0.23.1.dev24 → basic_memory-0.23.2.dev2}/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.1.dev24 → basic_memory-0.23.2.dev2}/plugins/codex/hooks/pre_compact.py

@@ -2,7 +2,7 @@
 # /// 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.

{basic_memory-0.23.1.dev24 → basic_memory-0.23.2.dev2}/plugins/codex/hooks/session_start.py

@@ -2,7 +2,7 @@
 # /// 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.

{basic_memory-0.23.1.dev24 → basic_memory-0.23.2.dev2}/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.1.dev24 → basic_memory-0.23.2.dev2}/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.dev24 → basic_memory-0.23.2.dev2}/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.1.dev24 → basic_memory-0.23.2.dev2}/src/basic_memory/cli/commands/doctor.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import tempfile
 import uuid
 from pathlib import Path
+from typing import Protocol
 
 from loguru import logger
 from rich.console import Console
@@ -23,6 +24,14 @@ from basic_memory.schemas import ProjectIndexRunResponse
 console = Console()
 
 
+class DoctorProjectClient(Protocol):
+    """Project-client capability required to clean up doctor state."""
+
+    async def delete_project(
+        self, project_external_id: str, delete_notes: bool = False
+    ) -> object: ...
+
+
 def _is_default_project_delete_error(error: Exception) -> bool:
     """Return True only for the API guard that blocks deleting the default project."""
     error_text = str(error)
@@ -61,14 +70,14 @@ async def _delete_doctor_project_locally(project_name: str, project_id: str) ->
 
 
 async def _delete_doctor_project(
-    project_client: ProjectClient, project_name: str, project_id: str
+    project_client: DoctorProjectClient, project_name: str, project_id: str
 ) -> None:
     """Delete the generated doctor project without weakening the public API guard."""
     # Deferred: ToolError lives in FastMCP's runtime, which must not load at CLI startup (#886).
     from fastmcp.exceptions import ToolError
 
     try:
-        await project_client.delete_project(project_id)
+        await project_client.delete_project(project_id, delete_notes=True)
     except ToolError as exc:
         if not _is_default_project_delete_error(exc):
             raise
@@ -127,9 +136,16 @@ async def run_doctor() -> None:
             project_id: str | None = None
 
             try:
-                status = await project_client.create_project(project_request.model_dump())
+                from basic_memory.config import ConfigManager
+
+                status = (
+                    await project_client.create_doctor_project()
+                    if ConfigManager().config.project_root
+                    else await project_client.create_project(project_request.model_dump())
+                )
                 if not status.new_project:
                     raise ValueError("Failed to create doctor project")
+                project_name = status.new_project.name
                 project_id = status.new_project.external_id
                 # Use the resolved path from the server — when project_root is configured,
                 # the actual project directory differs from the requested temp_path

{basic_memory-0.23.1.dev24 → basic_memory-0.23.2.dev2}/src/basic_memory/indexing/accepted_note_mutation_runner.py

@@ -60,6 +60,7 @@ from basic_memory.runtime.storage import (
 )
 from basic_memory.schemas.base import Entity as EntitySchema
 from basic_memory.schemas.request import EditEntityRequest
+from basic_memory.utils import resolve_directory_casing
 
 type AcceptedNoteMutationChange = RuntimeAcceptedNoteChange[RuntimeNoteContentResponsePayload]
 type AcceptedNoteMutationUserProfileId = UUID
@@ -233,6 +234,11 @@ class AcceptedNoteMutationEntityRepository(Protocol):
         load_relations: bool = False,
     ) -> Entity | None: ...
 
+    async def get_distinct_directories(
+        self,
+        session: AsyncSession,
+    ) -> list[str]: ...
+
 
 class AcceptedNoteMutationNoteContentRepository(Protocol):
     """note_content lookup capability for accepted-note mutations."""
@@ -379,6 +385,58 @@ async def resolve_accepted_note_source_checksum(
     )
 
 
+async def resolve_accepted_note_directory(
+    session: AsyncSession,
+    *,
+    project_id: ProjectId,
+    directory: str,
+    dependencies: AcceptedNoteMutationDependencies,
+) -> str:
+    """Resolve a requested note directory against existing folder casing (#1326).
+
+    Trigger: the requested directory is not an existing folder but matches
+        exactly one existing folder case-insensitively.
+    Why: LLM callers guess plausible casing ("schemas" beside an existing
+        "Schemas/"); on case-sensitive storage (cloud object storage) the guess
+        silently creates a case-duplicate sibling folder. Folders are derived
+        from indexed entity file paths in the DB, never by probing storage, so
+        local and cloud runtimes resolve identically.
+    Outcome: a unique case-insensitive match adopts the existing folder's
+        casing; exact matches, unknown folders, and ambiguous case-variant
+        siblings keep the requested casing unchanged.
+    """
+    if not directory:
+        return directory
+    entity_repository = dependencies.lookup_repositories.entity_repository(project_id)
+    existing_directories = await entity_repository.get_distinct_directories(session)
+    return resolve_directory_casing(directory, existing_directories)
+
+
+async def resolve_accepted_note_schema_directory(
+    session: AsyncSession,
+    *,
+    project_id: ProjectId,
+    data: EntitySchema,
+    dependencies: AcceptedNoteMutationDependencies,
+) -> EntitySchema:
+    """Return the write schema with its directory resolved to existing casing.
+
+    The schema's ``file_path`` is computed from ``directory``, so adjusting the
+    directory redirects the conflict lookup, preparation, and permalink
+    resolution downstream. The caller's schema is never mutated: a resolved
+    directory yields a copy so route-owned request data stays as received.
+    """
+    resolved_directory = await resolve_accepted_note_directory(
+        session,
+        project_id=project_id,
+        directory=data.directory,
+        dependencies=dependencies,
+    )
+    if resolved_directory == data.directory:
+        return data
+    return data.model_copy(update={"directory": resolved_directory})
+
+
 async def run_accepted_note_create(
     session: AsyncSession,
     *,
@@ -501,10 +559,16 @@ async def _run_accepted_note_create(
         dependencies=dependencies,
     )
 
+    data = await resolve_accepted_note_schema_directory(
+        session,
+        project_id=project.id,
+        data=request.data,
+        dependencies=dependencies,
+    )
     entity_repository = dependencies.lookup_repositories.entity_repository(project.id)
     conflicting_entity = await entity_repository.get_by_file_path(
         session,
-        request.data.file_path,
+        data.file_path,
         load_relations=False,
     )
     reject_accepted_note_file_path_conflict(
@@ -515,7 +579,7 @@ async def _run_accepted_note_create(
     preparer = dependencies.preparer_factory.create_note_preparer(project)
     prepared_write = await prepare_create_or_reject(
         preparer,
-        request.data,
+        data,
         check_storage_exists=dependencies.verify_storage_absent_on_create,
         session=session,
     )
@@ -579,10 +643,26 @@ async def _run_accepted_note_update(
     existing_file_path = entity.file_path if entity is not None else None
     vacated_source: tuple[RuntimeFilePath, RuntimeFileChecksum | None] | None = None
 
+    # Trigger: the addressed entity already lives in the exact requested directory.
+    # Why: casing resolution scans every distinct entity file_path in the project,
+    #     and content-only PUTs (e.g. repeated collaboration-relay saves of the
+    #     same note) are the hot path where the directory cannot change; an exact
+    #     match would resolve to itself anyway because exact match always wins.
+    # Outcome: only case-variant or relocating PUTs pay for the directory scan.
+    current_directory = existing_file_path.rpartition("/")[0] if existing_file_path else None
+    if current_directory == request.data.directory:
+        data = request.data
+    else:
+        data = await resolve_accepted_note_schema_directory(
+            session,
+            project_id=project.id,
+            data=request.data,
+            dependencies=dependencies,
+        )
     await reject_conflicting_accepted_note_file_path(
         session,
         project_id=project.id,
-        file_path=request.data.file_path,
+        file_path=data.file_path,
         allowed_entity_external_id=request.entity_external_id,
         dependencies=dependencies,
     )
@@ -600,7 +680,7 @@ async def _run_accepted_note_update(
             reject_stale_base_checksum(current_db_checksum=None)
         prepared_write = await prepare_create_or_reject(
             preparer,
-            request.data,
+            data,
             check_storage_exists=dependencies.verify_storage_absent_on_create,
             session=session,
         )
@@ -630,7 +710,7 @@ async def _run_accepted_note_update(
             try:
                 await preparer.verify_move_destination_absent(
                     source_file_path=entity.file_path,
-                    destination_file_path=request.data.file_path,
+                    destination_file_path=data.file_path,
                 )
             except EntityAlreadyExistsError as error:
                 reject_accepted_note_mutation(AcceptedNoteMutationRejectKind.conflict, str(error))
@@ -644,7 +724,7 @@ async def _run_accepted_note_update(
         # A PUT replacement may also rename the note. Capture the exact source bytes before
         # persistence mutates the entity and note_content to the destination version so delayed
         # cleanup cannot let a later project index recreate the old path as a ghost.
-        if request.data.file_path != entity.file_path:
+        if data.file_path != entity.file_path:
             vacated_source = (
                 entity.file_path,
                 await resolve_accepted_note_source_checksum(
@@ -693,7 +773,7 @@ async def _run_accepted_note_update(
                 preparer,
                 session,
                 entity=entity,
-                data=request.data,
+                data=data,
                 current_note_content=current_note_content,
                 user_profile_value=user_profile_value,
             )
@@ -825,6 +905,18 @@ async def _run_accepted_note_move(
         dependencies=dependencies,
     )
     existing_file_path = entity.file_path
+    # The destination filename keeps its requested casing; only the parent
+    # directory resolves against existing folders (issue #1326). The path is
+    # posix-normalized above, so rpartition splits directory from filename.
+    destination_directory, _, destination_filename = accepted_file_path.rpartition("/")
+    resolved_directory = await resolve_accepted_note_directory(
+        session,
+        project_id=project.id,
+        directory=destination_directory,
+        dependencies=dependencies,
+    )
+    if resolved_directory != destination_directory:
+        accepted_file_path = f"{resolved_directory}/{destination_filename}"
     # Same-path moves fail fast everywhere by decision (2026-07-14): cloud's
     # pre-unification route returned a 200 no-op, local rejected — the unified
     # runner keeps the rejection so a mistaken identity move surfaces instead

{basic_memory-0.23.1.dev24 → basic_memory-0.23.2.dev2}/src/basic_memory/mcp/clients/project.py

@@ -78,6 +78,13 @@ class ProjectClient:
         )
         return ProjectStatusResponse.model_validate(response.json())
 
+    async def create_doctor_project(self) -> ProjectStatusResponse:
+        """Create the server-generated disposable project used by doctor."""
+        from basic_memory.mcp.tools.utils import call_post
+
+        response = await call_post(self.http_client, "/v2/projects/doctor")
+        return ProjectStatusResponse.model_validate(response.json())
+
     async def delete_project(
         self, project_external_id: str, delete_notes: bool = False
     ) -> ProjectStatusResponse:

{basic_memory-0.23.1.dev24 → basic_memory-0.23.2.dev2}/src/basic_memory/mcp/tools/move_note.py

@@ -947,9 +947,20 @@ move_note("{identifier}", destination_folder="notes")
             #      the up-front detection: any divergence the caller did not ask for
             #      surfaces as a failure rather than a fake success.
             # Outcome: report failure with the actual landing path instead of "✅".
+            # A case-only difference in the PARENT directories is the server resolving
+            # the destination folder to an existing folder's casing (#1326), not a
+            # boundary degradation — the success message below reports the actual
+            # landing path either way. The server always preserves the requested
+            # filename verbatim, so a basename divergence (even case-only) still
+            # reports the honest failure.
             normalized_requested = PureWindowsPath(destination_path).as_posix().strip("/")
             normalized_actual = PureWindowsPath(result.file_path).as_posix().strip("/")
-            if normalized_actual != normalized_requested:
+            requested_parent, _, requested_name = normalized_requested.rpartition("/")
+            actual_parent, _, actual_name = normalized_actual.rpartition("/")
+            diverged = normalized_actual != normalized_requested and not (
+                actual_name == requested_name and actual_parent.lower() == requested_parent.lower()
+            )
+            if diverged:
                 logger.warning(
                     f"Move outcome diverged from intent: requested={destination_path} "
                     f"actual={result.file_path}"

{basic_memory-0.23.1.dev24 → basic_memory-0.23.2.dev2}/src/basic_memory/services/project_service.py

@@ -4,6 +4,7 @@ import asyncio
 import json
 import os
 import shutil
+import uuid
 from collections.abc import Callable
 from datetime import datetime
 from pathlib import Path
@@ -190,7 +191,9 @@ class ProjectService:
                 # Not nested in either direction
                 return False
 
-    async def add_project(self, name: str, path: str, set_default: bool = False) -> None:
+    async def add_project(
+        self, name: str, path: str, set_default: bool = False, *, allow_nested: bool = False
+    ) -> None:
         """Add a new project to the configuration and database.
 
         Args:
@@ -240,27 +243,25 @@ class ProjectService:
                             f"In cloud mode, paths are normalized to lowercase to prevent case-sensitivity issues."
                         )  # pragma: no cover
 
-            # Check for nested paths with existing projects
-            for existing in existing_projects:
-                if self._check_nested_paths(resolved_path, existing.path):
-                    # Determine which path is nested within which for appropriate error message
-                    p_new = Path(resolved_path).resolve()
-                    p_existing = Path(existing.path).resolve()
-
-                    # Check if new path is nested under existing project
-                    if p_new.is_relative_to(p_existing):
-                        raise ValueError(
-                            f"Cannot create project at '{resolved_path}': "
-                            f"path is nested within existing project '{existing.name}' at '{existing.path}'. "
-                            f"Projects cannot share directory trees."
-                        )
-                    else:
-                        # Existing project is nested under new path
-                        raise ValueError(
-                            f"Cannot create project at '{resolved_path}': "
-                            f"existing project '{existing.name}' at '{existing.path}' is nested within this path. "
-                            f"Projects cannot share directory trees."
-                        )
+            # Doctor creates a disposable project inside the configured project root.
+            # It must be allowed to coexist with the existing root project.
+            if not allow_nested:
+                for existing in existing_projects:
+                    if self._check_nested_paths(resolved_path, existing.path):
+                        p_new = Path(resolved_path).resolve()
+                        p_existing = Path(existing.path).resolve()
+                        if p_new.is_relative_to(p_existing):
+                            raise ValueError(
+                                f"Cannot create project at '{resolved_path}': "
+                                f"path is nested within existing project '{existing.name}' at '{existing.path}'. "
+                                f"Projects cannot share directory trees."
+                            )
+                        else:
+                            raise ValueError(
+                                f"Cannot create project at '{resolved_path}': "
+                                f"existing project '{existing.name}' at '{existing.path}' is nested within this path. "
+                                f"Projects cannot share directory trees."
+                            )
 
             # Ensure the project directory exists on disk.
             # Trigger: project_root not set means local filesystem mode (not S3/cloud)
@@ -332,6 +333,19 @@ class ProjectService:
 
         logger.info(f"Project '{name}' added at {resolved_path}")
 
+    async def add_doctor_project(self) -> Project:
+        """Create a server-generated disposable project under the configured root."""
+        project_root = self.config_manager.config.project_root
+        if not project_root:
+            raise ValueError("Doctor projects require BASIC_MEMORY_PROJECT_ROOT")
+
+        project_name = f"doctor-{uuid.uuid4().hex[:8]}"
+        await self.add_project(project_name, project_root, allow_nested=True)
+        project = await self.get_project(project_name)
+        if project is None:  # pragma: no cover
+            raise ValueError("Failed to retrieve doctor project")
+        return project
+
     async def remove_project(self, name: str, delete_notes: bool = False) -> None:
         """Remove a project from configuration and database.
 

{basic_memory-0.23.1.dev24 → basic_memory-0.23.2.dev2}/src/basic_memory/utils.py

@@ -776,6 +776,52 @@ def detect_potential_file_conflicts(file_path: str, existing_paths: List[str]) -
     return conflicts
 
 
+def resolve_directory_casing(directory: str, existing_directories: List[str]) -> str:
+    """Resolve a requested directory to the casing of existing folders (#1326).
+
+    LLM callers guess plausible-but-wrong casing ("schemas" beside an existing
+    "Schemas/"), and case-sensitive storage backends then grow case-duplicate
+    sibling folders. Each path segment resolves against the folders that exist
+    under the already-resolved parent:
+
+    - Exact match wins: the requested segment casing is kept unchanged.
+    - Unique case-insensitive match: the existing folder's casing is adopted.
+    - No match: the segment is kept as given (a new folder).
+    - Multiple case-variant folders exist: ambiguous, the segment is kept as
+      given (today's exact behavior).
+
+    Args:
+        directory: Requested directory path relative to the project root
+            ("" means the root itself).
+        existing_directories: Known project folders derived from indexed entity
+            file paths (see EntityRepository.get_distinct_directories).
+
+    Returns:
+        The directory path with each segment resolved to existing casing.
+    """
+    if not directory:
+        return directory
+
+    existing = set(existing_directories)
+    resolved_prefix = ""
+    for segment in directory.split("/"):
+        candidate = f"{resolved_prefix}/{segment}" if resolved_prefix else segment
+        if candidate in existing:
+            resolved_prefix = candidate
+            continue
+        # Candidates are constrained to children of the already-resolved parent:
+        # once a parent segment stays ambiguous (kept as requested), a deeper
+        # existing folder under a *different* parent casing must not be spliced in.
+        matches = [
+            existing_directory
+            for existing_directory in existing
+            if existing_directory.lower() == candidate.lower()
+            and existing_directory.rpartition("/")[0] == resolved_prefix
+        ]
+        resolved_prefix = matches[0] if len(matches) == 1 else candidate
+    return resolved_prefix
+
+
 def valid_project_path_value(path: str):
     """Ensure project path is valid."""
     # Allow empty strings as they resolve to the project root