Source code for ralph.cli.commands.contribute

""":star: ``ralph contribute`` — open the Codeberg repo to star and fork Ralph Workflow.

This is a lightweight community-support command. It opens the canonical
Codeberg repository in the default browser so you can star the project,
watch for releases, or fork it — all from a single CLI invocation.

Alias: `ralph star` is a shortcut that does the same thing.

No git repository, configuration, or authentication is required.
"""

from __future__ import annotations

import webbrowser
from typing import Annotated

import typer
from rich.panel import Panel
from rich.text import Text

CODEBERG_REPO = "https://codeberg.org/RalphWorkflow/Ralph-Workflow"
GITHUB_REPO = "https://github.com/Ralph-Workflow/Ralph-Workflow"
PROJECT_NAME = "Ralph Workflow"


def _build_banner() -> Text:
    """Build the rich-starred contribute banner."""
    return Text.from_markup(
        "\n"
        "  [bold theme.banner.title]✨ Ralph Workflow[/bold theme.banner.title]\n"
        "  [theme.text.muted]Multi-agent AI orchestration pipeline[/theme.text.muted]\n"
        "\n"
        "  [bold]⭐ Star & fork the project[/bold]\n"
        "  [theme.text.muted]"
        "Every star helps more developers discover the tool."
        "[/theme.text.muted]\n"
    )




def contribute(
    source: Annotated[
        str,
        typer.Option(
            "--source",
            "-s",
            help="Repo source to open: 'codeberg' (default) or 'github'",
        ),
    ] = "codeberg",
) -> None:
    """Open the Ralph Workflow repo in your browser so you can star it.

    Opens the Codeberg project page (default) or GitHub mirror so you can
    star, watch, or fork — then come back and keep working.

    Examples:
        ralph contribute              # Open Codeberg
        ralph contribute --source github  # Open GitHub mirror
    """
    source_lower = source.lower()
    if source_lower == "github":
        url = GITHUB_REPO
        label = "GitHub mirror"
    elif source_lower == "codeberg":
        url = CODEBERG_REPO
        label = "Codeberg"
    else:
        typer.echo(
            f"Unknown source '{source}'. Use 'codeberg' (default) or 'github'.",
            err=True,
        )
        raise typer.Exit(1)

    banner = _build_banner()
    typer.echo(banner)

    typer.echo(
        Panel(
            Text.from_markup(
                f"  Opening [bold link={url}]{label} repo[/bold link] in your browser...\n"
                f"  [link={url}]{url}[/link]"
            ),
            title="📂 Contribute",
            border_style="green",
        )
    )

    try:
        opened = webbrowser.open(url)
    except Exception as exc:
        typer.echo(f"Could not open browser: {exc}", err=True)
        typer.echo(f"Visit: {url}")
        raise typer.Exit(1) from exc

    if not opened:
        typer.echo(f"Could not open browser automatically. Visit: {url}")

    typer.echo(Text.from_markup("\n[green]Thank you for supporting Ralph Workflow![/green] ⭐\n"))