feat(rclone): Add simplified configure_rclone_remote() function (SPEC-20 Phase 2)

Add new configure_rclone_remote() that uses single remote name:
- Single remote: "basic-memory-cloud" (not tenant-specific)
- Simplifies from per-tenant remotes to one credential set per user
- Maintains backup_rclone_config() for safety
- Add comprehensive functional tests for rclone config
- Test remote configuration, updates, save/load operations

Old add_tenant_to_rclone_config() kept for backward compatibility
but will be removed in Phase 5.

Part of SPEC-20 Simplified Project-Scoped Rclone Sync.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Signed-off-by: phernandez <paul@basicmachines.co>

src/basic_memory/cli/commands/cloud/rclone_config.py

@@ -116,6 +116,53 @@ def save_rclone_config(config: configparser.ConfigParser) -> None:
     console.print(f"[dim]Updated rclone config: {config_path}[/dim]")
 
 
+def configure_rclone_remote(
+    access_key: str,
+    secret_key: str,
+    endpoint: str = "https://fly.storage.tigris.dev",
+    region: str = "auto",
+) -> str:
+    """Configure single rclone remote named 'basic-memory-cloud'.
+
+    This is the simplified approach from SPEC-20 that uses one remote
+    for all Basic Memory cloud operations (not tenant-specific).
+
+    Args:
+        access_key: S3 access key ID
+        secret_key: S3 secret access key
+        endpoint: S3-compatible endpoint URL
+        region: S3 region (default: auto)
+
+    Returns:
+        The remote name: "basic-memory-cloud"
+    """
+    # Backup existing config
+    backup_rclone_config()
+
+    # Load existing config
+    config = load_rclone_config()
+
+    # Single remote name (not tenant-specific)
+    REMOTE_NAME = "basic-memory-cloud"
+
+    # Add/update the remote section
+    if not config.has_section(REMOTE_NAME):
+        config.add_section(REMOTE_NAME)
+
+    config.set(REMOTE_NAME, "type", "s3")
+    config.set(REMOTE_NAME, "provider", "Other")
+    config.set(REMOTE_NAME, "access_key_id", access_key)
+    config.set(REMOTE_NAME, "secret_access_key", secret_key)
+    config.set(REMOTE_NAME, "endpoint", endpoint)
+    config.set(REMOTE_NAME, "region", region)
+
+    # Save updated config
+    save_rclone_config(config)
+
+    console.print(f"[green]✓ Configured rclone remote: {REMOTE_NAME}[/green]")
+    return REMOTE_NAME
+
+
 def add_tenant_to_rclone_config(
     tenant_id: str,
     bucket_name: str,

src/basic_memory/config.py

@@ -47,16 +47,12 @@ class CloudProjectConfig(BaseModel):
     that is synced with Basic Memory Cloud.
     """
 
-    local_path: str = Field(
-        description="Local working directory path for this cloud project"
-    )
+    local_path: str = Field(description="Local working directory path for this cloud project")
     last_sync: Optional[datetime] = Field(
-        default=None,
-        description="Timestamp of last successful sync operation"
+        default=None, description="Timestamp of last successful sync operation"
     )
     bisync_initialized: bool = Field(
-        default=False,
-        description="Whether rclone bisync baseline has been established"
+        default=False, description="Whether rclone bisync baseline has been established"
     )
 
 
@@ -454,7 +450,7 @@ def save_basic_memory_config(file_path: Path, config: BasicMemoryConfig) -> None
     """Save configuration to file."""
     try:
         # Use model_dump with mode='json' to serialize datetime objects properly
-        config_dict = config.model_dump(mode='json')
+        config_dict = config.model_dump(mode="json")
         file_path.write_text(json.dumps(config_dict, indent=2))
     except Exception as e:  # pragma: no cover
         logger.error(f"Failed to save config: {e}")