brain/commands/connect.py

"""brain connect — (Placeholder) Connect a Brain Instance to Supabase cloud sync."""

import typer

from brain.config import get_active_brain
from brain.utils.display import error, info, console


def connect(
    url: str = typer.Option(
        ...,
        "--url",
        help="Supabase project URL (e.g. https://xyzproject.supabase.co).",
    ),
    key: str = typer.Option(
        ...,
        "--key",
        help="Supabase anon/public API key.",
    ),
) -> None:
    """Connect the active Brain Instance to a Supabase backend for cloud sync.

    NOTE: This command is a placeholder and does not perform any real connection.
    It exists to reserve the command surface for a future Supabase integration.
    """
    brain = get_active_brain()
    if brain is None:
        error("No active Brain. Run: brain create <name>")
        raise typer.Exit(code=1)

    brain_name = brain.name

    # --- Placeholder output — nothing actually happens ---
    console.print()
    info(f"Brain: [bold]{brain_name}[/bold]")
    info(f"Supabase URL: {url}")
    info(f"API Key: {key[:8]}{'*' * (len(key) - 8)}")
    console.print()
    console.print(
        "[yellow]![/yellow]  Supabase sync is not yet implemented. "
        "This command is a placeholder for a future release."
    )
    console.print(
        "[dim]   When ready, this will enable cloud-backed memory, "
        "cross-device sync, and team collaboration.[/dim]"
    )
    console.print()