add sync status tool

Signed-off-by: phernandez <paul@basicmachines.co>

Author: phernandez

src/basic_memory/cli/commands/sync.py

@@ -180,7 +180,7 @@ async def run_sync(verbose: bool = False):
     sync_service = await get_sync_service(project)
 
     logger.info("Running one-time sync")
-    knowledge_changes = await sync_service.sync(config.home)
+    knowledge_changes = await sync_service.sync(config.home, project_name=project.name)
 
     # Log results
     duration_ms = int((time.time() - start_time) * 1000)

src/basic_memory/mcp/prompts/__init__.py

@@ -10,12 +10,12 @@
 from basic_memory.mcp.prompts import recent_activity
 from basic_memory.mcp.prompts import search
 from basic_memory.mcp.prompts import ai_assistant_guide
-from basic_memory.mcp.prompts import migration_status
+from basic_memory.mcp.prompts import sync_status
 
 __all__ = [
     "ai_assistant_guide",
     "continue_conversation",
-    "migration_status",
     "recent_activity",
     "search",
+    "sync_status",
 ]

…c_memory/mcp/prompts/migration_status.py …/basic_memory/mcp/prompts/sync_status.pysrc/basic_memory/mcp/prompts/migration_status.py renamed to src/basic_memory/mcp/prompts/sync_status.py src/basic_memory/mcp/prompts/migration_status.py renamed to src/basic_memory/mcp/prompts/sync_status.py

@@ -1,26 +1,23 @@
-"""Migration status prompt for Basic Memory MCP server."""
-
-from typing import Optional
+"""Sync status prompt for Basic Memory MCP server."""
 
 from basic_memory.mcp.server import mcp
 
 
 @mcp.prompt(
-    description="""Get migration status with recommendations for AI assistants.
+    description="""Get sync status with recommendations for AI assistants.
     
-    This prompt provides both current migration status and guidance on how
-    AI assistants should respond when migration is in progress or completed.
+    This prompt provides both current sync status and guidance on how
+    AI assistants should respond when sync operations are in progress or completed.
     """,
 )
-async def migration_status_prompt(
-) -> str:
-    """Get migration status with AI assistant guidance.
+async def sync_status_prompt() -> str:
+    """Get sync status with AI assistant guidance.
 
-    This prompt provides detailed migration status information along with
-    recommendations for how AI assistants should handle different migration states.
+    This prompt provides detailed sync status information along with
+    recommendations for how AI assistants should handle different sync states.
 
     Returns:
-        Formatted migration status with AI assistant guidance
+        Formatted sync status with AI assistant guidance
     """
     try:
         from basic_memory.services.migration_service import migration_manager
@@ -29,7 +26,7 @@ async def migration_status_prompt(
 
         # Build status report
         lines = [
-            "# Basic Memory Migration Status",
+            "# Basic Memory Sync Status",
             "",
             f"**Current Status**: {state.status.value.replace('_', ' ').title()}",
             f"**System Ready**: {'Yes' if migration_manager.is_ready else 'No'}",
@@ -39,9 +36,10 @@ async def migration_status_prompt(
         if migration_manager.is_ready:
             lines.extend(
                 [
-                    "✅ **All migrations completed** - System is fully operational",
+                    "✅ **All sync operations completed** - System is fully operational",
                     "",
-                    "All Basic Memory MCP tools are available and functioning normally.",
+                    "All Basic Memory tools are available and functioning normally.",
+                    "File indexing is complete and knowledge graphs are up to date.",
                     "You can proceed with any knowledge management tasks.",
                 ]
             )
@@ -56,59 +54,63 @@ async def migration_status_prompt(
                 lines.extend(
                     [
                         "",
-                        "🔄 **Migration in progress** - Legacy data is being migrated to new format",
+                        "🔄 **File synchronization in progress** - Processing files and building knowledge graphs",
                         "",
                         "**Impact**: Some tools may show status messages instead of normal responses",
-                        "until migration completes (usually 1-3 minutes).",
+                        "until sync completes (usually 1-3 minutes).",
                     ]
                 )
 
             elif state.status.value == "failed":
                 lines.extend(
                     [
                         "",
-                        f"❌ **Migration failed**: {state.error or 'Unknown error'}",
+                        f"❌ **Sync failed**: {state.error or 'Unknown error'}",
                         "",
                         "**Impact**: System may have limited functionality until issue is resolved.",
                     ]
                 )
 
-        # Convert string parameter to boolean
-        include_recs = True
-
-        if include_recs and not migration_manager.is_ready:
+        # Add AI assistant recommendations
+        if not migration_manager.is_ready:
             lines.extend(
                 [
                     "",
                     "---",
                     "",
                     "## AI Assistant Recommendations",
                     "",
-                    "**When migration is in progress:**",
-                    "- Inform the user about the background migration",
-                    "- Suggest using `migration_status()` tool to check progress",
-                    "- Explain that most tools will work normally once migration completes",
-                    "- Avoid creating complex workflows until migration is done",
+                    "**When sync is in progress:**",
+                    "- Inform the user about the background file processing",
+                    "- Suggest using `sync_status()` tool to check progress",
+                    "- Explain that tools will work normally once sync completes",
+                    "- Avoid creating complex workflows until sync is done",
                     "",
                     "**What to tell users:**",
-                    "- 'Basic Memory is upgrading your knowledge base in the background'",
-                    "- 'This usually takes 1-3 minutes depending on your data size'",
-                    "- 'You can check progress anytime with the migration_status tool'",
-                    "- 'Most functionality will be available once the upgrade completes'",
+                    "- 'Basic Memory is processing your files and building knowledge graphs'",
+                    "- 'This usually takes 1-3 minutes depending on your content size'",
+                    "- 'You can check progress anytime with the sync_status tool'",
+                    "- 'Full functionality will be available once processing completes'",
+                    "",
+                    "**User-friendly language:**",
+                    "- Say 'processing files' instead of 'migration' or 'sync'",
+                    "- Say 'building knowledge graphs' instead of 'indexing'",
+                    "- Say 'setting up your knowledge base' instead of 'running migrations'",
                 ]
             )
 
         return "\n".join(lines)
 
     except Exception as e:
-        return f"""# Migration Status - Error
+        return f"""# Sync Status - Error
 
-❌ **Unable to check migration status**: {str(e)}
+❌ **Unable to check sync status**: {str(e)}
 
 ## AI Assistant Recommendations
 
 **When status is unavailable:**
 - Assume the system is likely working normally
 - Try proceeding with normal operations
 - If users report issues, suggest checking logs or restarting
+- Use user-friendly language about 'setting up the knowledge base'
 """

src/basic_memory/mcp/tools/__init__.py

@@ -17,7 +17,7 @@
 from basic_memory.mcp.tools.list_directory import list_directory
 from basic_memory.mcp.tools.edit_note import edit_note
 from basic_memory.mcp.tools.move_note import move_note
-from basic_memory.mcp.tools.migration_status import migration_status
+from basic_memory.mcp.tools.sync_status import sync_status
 from basic_memory.mcp.tools.project_management import (
     list_projects,
     switch_project,
@@ -37,13 +37,13 @@
     "get_current_project",
     "list_directory",
     "list_projects",
-    "migration_status",
     "move_note",
     "read_content",
     "read_note",
     "recent_activity",
     "search_notes",
     "set_default_project",
     "switch_project",
+    "sync_status",
     "write_note",
 ]