basic-memory 0.13.2__py3-none-any.whl → 0.13.4__py3-none-any.whl

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.13.2"
+__version__ = "0.13.4"
 
 # API version for FastAPI - independent of package version
 __api_version__ = "v0"

basic_memory/config.py

@@ -4,7 +4,7 @@ import json
 import os
 from dataclasses import dataclass
 from pathlib import Path
-from typing import Any, Dict, Literal, Optional, List
+from typing import Any, Dict, Literal, Optional, List, Tuple
 
 from loguru import logger
 from pydantic import Field, field_validator
@@ -196,7 +196,8 @@ class ConfigManager:
 
     def add_project(self, name: str, path: str) -> ProjectConfig:
         """Add a new project to the configuration."""
-        if name in self.config.projects:  # pragma: no cover
+        project_name, _ = self.get_project(name)
+        if project_name:  # pragma: no cover
             raise ValueError(f"Project '{name}' already exists")
 
         # Ensure the path exists
@@ -209,10 +210,12 @@ class ConfigManager:
 
     def remove_project(self, name: str) -> None:
         """Remove a project from the configuration."""
-        if name not in self.config.projects:  # pragma: no cover
+
+        project_name, path = self.get_project(name)
+        if not project_name:  # pragma: no cover
             raise ValueError(f"Project '{name}' not found")
 
-        if name == self.config.default_project:  # pragma: no cover
+        if project_name == self.config.default_project:  # pragma: no cover
             raise ValueError(f"Cannot remove the default project '{name}'")
 
         del self.config.projects[name]
@@ -220,12 +223,21 @@ class ConfigManager:
 
     def set_default_project(self, name: str) -> None:
         """Set the default project."""
-        if name not in self.config.projects:  # pragma: no cover
+        project_name, path = self.get_project(name)
+        if not project_name:  # pragma: no cover
             raise ValueError(f"Project '{name}' not found")
 
         self.config.default_project = name
         self.save_config(self.config)
 
+    def get_project(self, name: str) -> Tuple[str, str] | Tuple[None, None]:
+        """Look up a project from the configuration by name or permalink"""
+        project_permalink = generate_permalink(name)
+        for name, path in app_config.projects.items():
+            if project_permalink == generate_permalink(name):
+                return name, path
+        return None, None
+
 
 def get_project_config(project_name: Optional[str] = None) -> ProjectConfig:
     """
@@ -256,11 +268,14 @@ def get_project_config(project_name: Optional[str] = None) -> ProjectConfig:
     # the config contains a dict[str,str] of project names and absolute paths
     assert actual_project_name is not None, "actual_project_name cannot be None"
 
-    project_path = app_config.projects.get(actual_project_name)
-    if not project_path:  # pragma: no cover
-        raise ValueError(f"Project '{actual_project_name}' not found")
+    project_permalink = generate_permalink(actual_project_name)
+
+    for name, path in app_config.projects.items():
+        if project_permalink == generate_permalink(name):
+            return ProjectConfig(name=name, home=Path(path))
 
-    return ProjectConfig(name=actual_project_name, home=Path(project_path))
+    # otherwise raise error
+    raise ValueError(f"Project '{actual_project_name}' not found") # pragma: no cover
 
 
 # Create config manager

basic_memory/mcp/tools/__init__.py

@@ -48,4 +48,4 @@ __all__ = [
     "sync_status",
     "view_note",
     "write_note",
-]
+]

basic_memory/mcp/tools/project_management.py

@@ -9,7 +9,6 @@ from textwrap import dedent
 from fastmcp import Context
 from loguru import logger
 
-from basic_memory.config import get_project_config
 from basic_memory.mcp.async_client import client
 from basic_memory.mcp.project_session import session, add_project_metadata
 from basic_memory.mcp.server import mcp
@@ -19,7 +18,7 @@ from basic_memory.schemas.project_info import ProjectList, ProjectStatusResponse
 from basic_memory.utils import generate_permalink
 
 
-@mcp.tool()
+@mcp.tool("list_memory_projects")
 async def list_projects(ctx: Context | None = None) -> str:
     """List all available projects with their status.
 
@@ -85,27 +84,38 @@ async def switch_project(project_name: str, ctx: Context | None = None) -> str:
         response = await call_get(client, "/projects/projects")
         project_list = ProjectList.model_validate(response.json())
 
-        # Check if project exists
-        project_exists = any(p.permalink == project_permalink for p in project_list.projects)
-        if not project_exists:
+        # Find the project by name (case-insensitive) or permalink
+        target_project = None
+        for p in project_list.projects:
+            # Match by permalink (handles case-insensitive input)
+            if p.permalink == project_permalink:
+                target_project = p
+                break
+            # Also match by name comparison (case-insensitive)
+            if p.name.lower() == project_name.lower():
+                target_project = p
+                break
+
+        if not target_project:
             available_projects = [p.name for p in project_list.projects]
             return f"Error: Project '{project_name}' not found. Available projects: {', '.join(available_projects)}"
 
-        # Switch to the project
-        session.set_current_project(project_permalink)
+        # Switch to the project using the canonical name from database
+        canonical_name = target_project.name
+        session.set_current_project(canonical_name)
         current_project = session.get_current_project()
-        project_config = get_project_config(current_project)
 
         # Get project info to show summary
         try:
+            current_project_permalink = generate_permalink(canonical_name)
             response = await call_get(
                 client,
-                f"{project_config.project_url}/project/info",
-                params={"project_name": project_permalink},
+                f"/{current_project_permalink}/project/info",
+                params={"project_name": canonical_name},
             )
             project_info = ProjectInfoResponse.model_validate(response.json())
 
-            result = f"✓ Switched to {project_permalink} project\n\n"
+            result = f"✓ Switched to {canonical_name} project\n\n"
             result += "Project Summary:\n"
             result += f"• {project_info.statistics.total_entities} entities\n"
             result += f"• {project_info.statistics.total_observations} observations\n"
@@ -113,11 +123,11 @@ async def switch_project(project_name: str, ctx: Context | None = None) -> str:
 
         except Exception as e:
             # If we can't get project info, still confirm the switch
-            logger.warning(f"Could not get project info for {project_name}: {e}")
-            result = f"✓ Switched to {project_name} project\n\n"
+            logger.warning(f"Could not get project info for {canonical_name}: {e}")
+            result = f"✓ Switched to {canonical_name} project\n\n"
             result += "Project summary unavailable.\n"
 
-        return add_project_metadata(result, project_name)
+        return add_project_metadata(result, canonical_name)
 
     except Exception as e:
         logger.error(f"Error switching to project {project_name}: {e}")
@@ -165,13 +175,13 @@ async def get_current_project(ctx: Context | None = None) -> str:
         await ctx.info("Getting current project information")
 
     current_project = session.get_current_project()
-    project_config = get_project_config(current_project)
     result = f"Current project: {current_project}\n\n"
 
-    # get project stats
+    # get project stats (use permalink in URL path)
+    current_project_permalink = generate_permalink(current_project)
     response = await call_get(
         client,
-        f"{project_config.project_url}/project/info",
+        f"/{current_project_permalink}/project/info",
         params={"project_name": current_project},
     )
     project_info = ProjectInfoResponse.model_validate(response.json())

basic_memory/schemas/project_info.py

@@ -185,9 +185,9 @@ class ProjectItem(BaseModel):
     name: str
     path: str
     is_default: bool = False
-    
+
     @property
-    def permalink(self) -> str: # pragma: no cover
+    def permalink(self) -> str:  # pragma: no cover
         return generate_permalink(self.name)
 
 

basic_memory/services/project_service.py

@@ -64,8 +64,10 @@ class ProjectService:
         return await self.repository.find_all()
 
     async def get_project(self, name: str) -> Optional[Project]:
-        """Get the file path for a project by name."""
-        return await self.repository.get_by_name(name)
+        """Get the file path for a project by name or permalink."""
+        return await self.repository.get_by_name(name) or await self.repository.get_by_permalink(
+            name
+        )
 
     async def add_project(self, name: str, path: str, set_default: bool = False) -> None:
         """Add a new project to the configuration and database.
@@ -347,12 +349,15 @@ class ProjectService:
         # Use specified project or fall back to config project
         project_name = project_name or config.project
         # Get project path from configuration
-        project_path = config_manager.projects.get(project_name)
-        if not project_path:  # pragma: no cover
+        name, project_path = config_manager.get_project(project_name)
+        if not name:  # pragma: no cover
             raise ValueError(f"Project '{project_name}' not found in configuration")
 
+        assert project_path is not None
+        project_permalink = generate_permalink(project_name)
+
         # Get project from database to get project_id
-        db_project = await self.repository.get_by_name(project_name)
+        db_project = await self.repository.get_by_permalink(project_permalink)
         if not db_project:  # pragma: no cover
             raise ValueError(f"Project '{project_name}' not found in database")
 
@@ -367,7 +372,7 @@ class ProjectService:
 
         # Get enhanced project information from database
         db_projects = await self.repository.get_active_projects()
-        db_projects_by_name = {p.name: p for p in db_projects}
+        db_projects_by_permalink = {p.permalink: p for p in db_projects}
 
         # Get default project info
         default_project = config_manager.default_project
@@ -375,7 +380,8 @@ class ProjectService:
         # Convert config projects to include database info
         enhanced_projects = {}
         for name, path in config_manager.projects.items():
-            db_project = db_projects_by_name.get(name)
+            config_permalink = generate_permalink(name)
+            db_project = db_projects_by_permalink.get(config_permalink)
             enhanced_projects[name] = {
                 "path": path,
                 "active": db_project.is_active if db_project else True,
@@ -668,4 +674,4 @@ class ProjectService:
             database_size=db_size_readable,
             watch_status=watch_status,
             timestamp=datetime.now(),
-        )
+        )

{basic_memory-0.13.2.dist-info → basic_memory-0.13.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: basic-memory
-Version: 0.13.2
+Version: 0.13.4
 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.13.2.dist-info → basic_memory-0.13.4.dist-info}/RECORD

@@ -1,5 +1,5 @@
-basic_memory/__init__.py,sha256=s4xkAkIj-yvZFc_ImULxCYGhhrih4z5rAGrb5c81sqc,256
-basic_memory/config.py,sha256=lNpbn-b1k9nunQ-htciYQHC8XatRIhc_m6SN2Pbvp-E,11101
+basic_memory/__init__.py,sha256=wtW6Z-HbBdts3U7R1VxrCpzX6uCcRhqCse_ax-93jAE,256
+basic_memory/config.py,sha256=u19Pj3AnkPLQQyD4PRamzdinZgrNbO3VnUm_1Inx4Gk,11699
 basic_memory/db.py,sha256=X4-uyEZdJXVLfFDTpcNZxWzawRZXhDdKoEFWAGgE4Lk,6193
 basic_memory/deps.py,sha256=zXOhqXCoSVIa1iIcO8U6uUiofJn5eT4ycwJkH9I2kX4,12102
 basic_memory/file_utils.py,sha256=eaxTKLLEbTIy_Mb_Iv_Dmt4IXAJSrZGVi-Knrpyci3E,6700
@@ -72,14 +72,14 @@ basic_memory/mcp/prompts/sync_status.py,sha256=_5EqnCavY9BTsaxX2tPp-AgQZLt4bUrqQ
 basic_memory/mcp/prompts/utils.py,sha256=VacrbqwYtySpIlYIrKHo5s6jtoTMscYJqrFRH3zpC6Q,5431
 basic_memory/mcp/resources/ai_assistant_guide.md,sha256=qnYWDkYlb-JmKuOoZ5llmRas_t4dWDXB_i8LE277Lgs,14777
 basic_memory/mcp/resources/project_info.py,sha256=LcUkTx4iXBfU6Lp4TVch78OqLopbOy4ljyKnfr4VXso,1906
-basic_memory/mcp/tools/__init__.py,sha256=lCCOC0jElvL2v53WI_dxRs4qABq4Eo-YGm6j2XeZ6AQ,1591
+basic_memory/mcp/tools/__init__.py,sha256=eVy_IS4yRfwf-90W1kpRjQ2vj0j2AVh8K8IurGW0DiU,1590
 basic_memory/mcp/tools/build_context.py,sha256=RbevfGVblSF901kAD2zc1CQ5z3tzfLC9XV_jcq35d_Y,4490
 basic_memory/mcp/tools/canvas.py,sha256=22F9G9gfPb-l8i1B5ra4Ja_h9zYY83rPY9mDA5C5gkY,3738
 basic_memory/mcp/tools/delete_note.py,sha256=tSyRc_VgBmLyVeenClwX1Sk--LKcGahAMzTX2mK2XIs,7346
 basic_memory/mcp/tools/edit_note.py,sha256=q4x-f7-j_l-wzm17-AVFT1_WGCo0Cq4lI3seYSe21aY,13570
 basic_memory/mcp/tools/list_directory.py,sha256=-FxDsCru5YD02M4qkQDAurEJWyRaC7YI4YR6zg0atR8,5236
 basic_memory/mcp/tools/move_note.py,sha256=esnbddG2OcmIgRNuQwx5OhlwZ1CWcOheg3hUobsEcq0,11320
-basic_memory/mcp/tools/project_management.py,sha256=aLkfgEL3RlRztzERQur283cIed4mv14eAP7kh6gzHpw,12293
+basic_memory/mcp/tools/project_management.py,sha256=Y2pSrY8nWZnk_0SweMED5P84EfL4KVCLD_vyDB32_Qg,12755
 basic_memory/mcp/tools/read_content.py,sha256=4FTw13B8UjVVhR78NJB9HKeJb_nA6-BGT1WdGtekN5Q,8596
 basic_memory/mcp/tools/read_note.py,sha256=GdsJLkcDrCBnmNeM9BZRx9Xs2LUqH5ty_E471T9Kf1Y,7493
 basic_memory/mcp/tools/recent_activity.py,sha256=XVjNJAJnmxvzx9_Ls1A-QOd2yTR7pJlSTTuRxSivmN4,4833
@@ -107,7 +107,7 @@ basic_memory/schemas/delete.py,sha256=UAR2JK99WMj3gP-yoGWlHD3eZEkvlTSRf8QoYIE-Wf
 basic_memory/schemas/directory.py,sha256=F9_LrJqRqb_kO08GDKJzXLb2nhbYG2PdVUo5eDD_Kf4,881
 basic_memory/schemas/importer.py,sha256=FAh-RGxuhFW2rz3HFxwLzENJOiGgbTR2hUeXZZpM3OA,663
 basic_memory/schemas/memory.py,sha256=6YjEyJ9GJLC4VrFD0EnoRDTfg-Sf6g0D4bhL9rwNBi4,5816
-basic_memory/schemas/project_info.py,sha256=4yM51eGchS75ao2qyyVsk8_JyWRKJ0cJM3UzQF3G2ls,7050
+basic_memory/schemas/project_info.py,sha256=fcNjUpe25_5uMmKy142ib3p5qEakzs1WJPLkgol5zyw,7047
 basic_memory/schemas/prompt.py,sha256=SpIVfZprQT8E5uP40j3CpBc2nHKflwOo3iZD7BFPIHE,3648
 basic_memory/schemas/request.py,sha256=Mv5EvrLZlFIiPr8dOjo_4QXvkseYhQI7cd_X2zDsxQM,3760
 basic_memory/schemas/response.py,sha256=lVYR31DTtSeFRddGWX_wQWnQgyiwX0LEpNJ4f4lKpTM,6440
@@ -121,7 +121,7 @@ basic_memory/services/file_service.py,sha256=jCrmnEkTQ4t9HF7L_M6BL7tdDqjjzty9hpT
 basic_memory/services/initialization.py,sha256=6ZeuTInPksyre4pjmiK_GXi5o_mJk3mfqGGH6apHxko,9271
 basic_memory/services/link_resolver.py,sha256=1-_VFsvqdT5rVBHe8Jrq63U59XQ0hxGezxY8c24Tiow,4594
 basic_memory/services/migration_service.py,sha256=pFJCSD7UgHLx1CHvtN4Df1CzDEp-CZ9Vqx4XYn1m1M0,6096
-basic_memory/services/project_service.py,sha256=Nz6N-2rk6DLLKBmtTBcPQATh_nzkLuD8LWWDAwgl6Oc,26875
+basic_memory/services/project_service.py,sha256=YDZl_e7R36D6KcObpBeMqIiM05oh9nOIfZFIFgIRxbY,27151
 basic_memory/services/search_service.py,sha256=c5Ky0ufz7YPFgHhVzNRQ4OecF_JUrt7nALzpMjobW4M,12782
 basic_memory/services/service.py,sha256=V-d_8gOV07zGIQDpL-Ksqs3ZN9l3qf3HZOK1f_YNTag,336
 basic_memory/services/sync_status_service.py,sha256=PRAnYrsNJY8EIlxaxCrDsY0TjySDdhktjta8ReQZyiY,6838
@@ -131,8 +131,8 @@ basic_memory/sync/sync_service.py,sha256=AxC5J1YTcPWTmA0HdzvOZBthi4-_LZ44kNF0KQo
 basic_memory/sync/watch_service.py,sha256=JAumrHUjV1lF9NtEK32jgg0myWBfLXotNXxONeIV9SM,15316
 basic_memory/templates/prompts/continue_conversation.hbs,sha256=begMFHOPN3aCm5sHz5PlKMLOfZ8hlpFxFJ-hgy0T9K4,3075
 basic_memory/templates/prompts/search.hbs,sha256=H1cCIsHKp4VC1GrH2KeUB8pGe5vXFPqb2VPotypmeCA,3098
-basic_memory-0.13.2.dist-info/METADATA,sha256=kTZGjOSHLa84vzIf6BuhEpDxzos3c-MWFGi-VcgLe2o,15469
-basic_memory-0.13.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-basic_memory-0.13.2.dist-info/entry_points.txt,sha256=wvE2mRF6-Pg4weIYcfQ-86NOLZD4WJg7F7TIsRVFLb8,90
-basic_memory-0.13.2.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
-basic_memory-0.13.2.dist-info/RECORD,,
+basic_memory-0.13.4.dist-info/METADATA,sha256=V-vcDG3dmeJf3KBCUW47H_SdLHD4vd7fRZlx3tnhztM,15469
+basic_memory-0.13.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+basic_memory-0.13.4.dist-info/entry_points.txt,sha256=wvE2mRF6-Pg4weIYcfQ-86NOLZD4WJg7F7TIsRVFLb8,90
+basic_memory-0.13.4.dist-info/licenses/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
+basic_memory-0.13.4.dist-info/RECORD,,