lovarch-cli 0.2.1__py3-none-any.whl

lovarch_cli/commands/run.py

@@ -0,0 +1,375 @@
+"""lovarch run — Execute the squad pipeline against a project.
+
+Pragmatic shell-out: invokes the existing `pipeline_runner.py` (1821 lines,
+proven in production) as a subprocess instead of pulling its logic into the
+CLI's modular phases architecture (that's Story 1.3 — deferred to Q3 2026).
+
+Flow:
+    1. Resolve project dir (~/.lovarch/projects/<name>/)
+    2. Verify audit was run and passed (last_audit.verdict in project.yaml)
+    3. Load credentials → detect mode (free/premium)
+    4. Premium: pre-flight credits.check_or_raise(required=3500)
+       Free:    skip credits gate
+    5. Persistence: create_execution() → exec_id
+    6. Locate bundled pipeline_runner.py inside lovarch_cli/squad/
+    7. subprocess.Popen with --input-dir <project_input> + mode flag
+       Free → --dry-run (simulation, no API calls)
+       Premium → --real (production, hits Lovarch Supabase + AI providers)
+    8. Stream stdout/stderr to user in real time (preserve ANSI colors)
+    9. Wait for exit code → persistence.update_execution(status)
+   10. Show summary panel with `lovarch status` hint
+
+Free mode dry-run is intentionally limited: the existing pipeline_runner
+hardcodes LovarchClient() which connects to Supabase. A "true" Free run
+that uses LocalSqliteClient + LocalFilesystemStorage requires the Story 1.3
+refactor (replace LovarchClient calls with persistence ABC). For the curso
+delivery, Free → dry-run is sufficient (shows the orchestration flow,
+useful for teaching), Premium → real run delivers actual artifacts.
+"""
+from __future__ import annotations
+
+import asyncio
+import os
+import subprocess
+import sys
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Annotated
+
+import typer
+import yaml
+from rich.console import Console
+from rich.panel import Panel
+from rich.text import Text
+
+from lovarch_cli.clients.persistence import ExecutionMode
+from lovarch_cli.config import DEFAULT_HOME, load_credentials
+from lovarch_cli.credits import (
+    InsufficientCreditsError,
+    get_credits_client,
+)
+from lovarch_cli.i18n import current_lang, set_current_lang, t
+
+console = Console()
+err_console = Console(stderr=True)
+
+# Typical workflow cost (mirrors what the squad bills for a full run).
+# This is the threshold that gates premium runs at pre-flight.
+DEFAULT_REQUIRED_CREDITS = 3_500
+
+# Default workflow until we expose more squads via `lovarch run --workflow X`.
+DEFAULT_WORKFLOW = "dal-brief-al-cantiere"
+
+
+def _pipeline_runner_path(squad_root: Path) -> Path:
+    """Locate pipeline_runner.py inside the resolved squad root."""
+    return squad_root / "scripts" / "pipeline_runner.py"
+
+
+def _resolve_mode_from_creds() -> ExecutionMode:
+    """Map persisted credentials.mode → ExecutionMode enum."""
+    creds = load_credentials()
+    if creds.mode == "premium":
+        return ExecutionMode.PREMIUM
+    # 'free' or 'none' → Free mode dry-run (no real calls)
+    return ExecutionMode.FREE
+
+
+def _read_audit_verdict(project_dir: Path) -> str | None:
+    """Return the last_audit.verdict from project.yaml, or None if absent."""
+    yaml_path = project_dir / "project.yaml"
+    if not yaml_path.exists():
+        return None
+    try:
+        meta = yaml.safe_load(yaml_path.read_text(encoding="utf-8")) or {}
+    except yaml.YAMLError:
+        return None
+    last = meta.get("last_audit") or {}
+    return last.get("verdict")
+
+
+# Map pipeline_runner.py exit codes to a terminal run status. Kept in sync with
+# the EXIT_* constants in squads/architettura-progetto/scripts/pipeline_runner.py.
+_RUN_EXIT_STATUS = {
+    0: "completed",
+    3: "qa_rejected",  # Tier 2 QA REJECT — NOT a crash, NOT a success
+}
+
+
+def _status_from_returncode(returncode: int) -> str:
+    """Translate the runner's exit code into a terminal run status."""
+    return _RUN_EXIT_STATUS.get(returncode, "failed")
+
+
+def _write_last_run(project_dir: Path, status: str, returncode: int) -> None:
+    """Persist the terminal run status into project.yaml `last_run`.
+
+    Best-effort: a write failure must never change the run's exit code.
+    """
+    yaml_path = project_dir / "project.yaml"
+    try:
+        meta = yaml.safe_load(yaml_path.read_text(encoding="utf-8")) or {}
+    except (OSError, yaml.YAMLError):
+        meta = {}
+    meta["last_run"] = {
+        "status": status,
+        "exit_code": returncode,
+        "at": datetime.now(timezone.utc).isoformat(),
+    }
+    try:
+        yaml_path.write_text(
+            yaml.safe_dump(meta, sort_keys=False, allow_unicode=True),
+            encoding="utf-8",
+        )
+    except OSError:
+        pass
+
+
+def run_command(
+    project: Annotated[
+        str,
+        typer.Argument(help="Project name (created via `lovarch init`)."),
+    ],
+    workflow: Annotated[
+        str,
+        typer.Option(
+            "--workflow",
+            "-w",
+            help="Workflow to execute.",
+        ),
+    ] = DEFAULT_WORKFLOW,
+    skip_audit: Annotated[
+        bool,
+        typer.Option(
+            "--skip-audit",
+            help="Skip the audit-verdict check (dangerous).",
+        ),
+    ] = False,
+    skip_credits: Annotated[
+        bool,
+        typer.Option(
+            "--skip-credits",
+            help="Skip the credits pre-flight (Premium only — for testing).",
+        ),
+    ] = False,
+    force_dry_run: Annotated[
+        bool,
+        typer.Option(
+            "--dry-run",
+            help="Force dry-run mode regardless of free/premium auth.",
+        ),
+    ] = False,
+    lang_flag: Annotated[
+        str | None,
+        typer.Option("--lang", "-l", help="Override language (it/pt/en/es)."),
+    ] = None,
+    home_override: Annotated[
+        Path | None,
+        typer.Option(
+            "--home",
+            help="Override $HOME/.lovarch root (mainly for tests).",
+            hidden=True,
+        ),
+    ] = None,
+    squad_src: Annotated[
+        Path | None,
+        typer.Option(
+            "--squad-src",
+            help=(
+                "Path to a squad-architettura-progetto source dir to use "
+                "instead of the bundled payload. Also reads $LOVARCH_SQUAD_SRC. "
+                "Use for the developer's edit-and-test loop against the "
+                "monorepo Lovarch squad sources."
+            ),
+        ),
+    ] = None,
+) -> None:
+    """Run the squad pipeline against a project."""
+    if lang_flag is not None:
+        set_current_lang(lang_flag)
+    lang = current_lang()
+
+    home = home_override or DEFAULT_HOME
+    proj_dir = home / "projects" / project
+    if not proj_dir.is_dir():
+        err_console.print(
+            f"\n[red]✗ {t('run.no_project', lang=lang, name=project)}[/red]\n"
+        )
+        sys.exit(2)
+
+    input_dir = proj_dir / "input"
+    if not input_dir.is_dir():
+        err_console.print(
+            f"\n[red]✗ {t('run.no_input', lang=lang, path=str(input_dir))}[/red]\n"
+        )
+        sys.exit(2)
+
+    # ─── Pre-flight: audit verdict gate ──────────────────────────────────
+    if not skip_audit:
+        verdict = _read_audit_verdict(proj_dir)
+        if verdict is None:
+            err_console.print(
+                f"\n[yellow]{t('run.no_audit', lang=lang, name=project)}[/yellow]\n"
+            )
+            sys.exit(1)
+        if verdict == "FAIL":
+            err_console.print(
+                f"\n[red]{t('run.audit_failed', lang=lang, name=project)}[/red]\n"
+            )
+            sys.exit(1)
+
+    # ─── Mode resolution ─────────────────────────────────────────────────
+    mode = ExecutionMode.FREE if force_dry_run else _resolve_mode_from_creds()
+    is_dry_run = (mode == ExecutionMode.FREE) or force_dry_run
+
+    # ─── Pre-flight: credits check (Premium only) ────────────────────────
+    if mode == ExecutionMode.PREMIUM and not skip_credits:
+        try:
+            credits_client = get_credits_client(mode)
+            asyncio.run(
+                credits_client.check_or_raise(required=DEFAULT_REQUIRED_CREDITS)
+            )
+        except InsufficientCreditsError as exc:
+            bal = exc.balance
+            err_console.print(
+                "\n[red]"
+                + t(
+                    "errors.credits_insufficient",
+                    lang=lang,
+                    remaining=bal.credits_remaining,
+                    required=bal.required,
+                    deficit=bal.deficit,
+                )
+                + "[/red]\n"
+            )
+            sys.exit(1)
+        except RuntimeError as exc:
+            # Premium client unavailable (no keyring session). Programmer-facing.
+            err_console.print(
+                f"\n[red]{t('errors.credits_check_failed', lang=lang, message=str(exc))}[/red]\n"
+            )
+            sys.exit(1)
+
+    # ─── Resolve squad payload + locate pipeline_runner.py ──────────────
+    from lovarch_cli.squad_loader import (
+        SquadNotFoundError,
+        resolve_squad_root,
+        squad_source_label,
+    )
+
+    try:
+        squad_root = resolve_squad_root(override=squad_src)
+    except SquadNotFoundError as exc:
+        err_console.print(f"\n[red]✗ {exc}[/red]\n")
+        sys.exit(2)
+
+    runner = _pipeline_runner_path(squad_root)
+    if not runner.exists():
+        err_console.print(
+            f"\n[red]✗ {t('run.no_runner', lang=lang, path=str(runner))}[/red]\n"
+        )
+        sys.exit(2)
+
+    # Show which squad source is in use (helpful during dev loop).
+    src_label = squad_source_label(squad_root)
+    if src_label != "bundled":
+        console.print(
+            f"[dim cyan]↳ squad: {squad_root} ({src_label})[/dim cyan]"
+        )
+
+    # ─── Header panel ────────────────────────────────────────────────────
+    mode_label = t(
+        "run.mode_free" if is_dry_run else "run.mode_premium",
+        lang=lang,
+    )
+    body_lines = [
+        t("run.starting", lang=lang, project=project, workflow=workflow),
+        t("run.mode_label", lang=lang, mode=mode_label),
+    ]
+    if is_dry_run:
+        body_lines.append(t("run.dry_run_note", lang=lang))
+    console.print()
+    console.print(
+        Panel(
+            Text.from_markup("\n".join(body_lines)),
+            title=f"[bold gold1]🚀 {t('run.title', lang=lang)}[/bold gold1]",
+            border_style="gold1",
+            padding=(1, 2),
+        )
+    )
+    console.print()
+
+    # ─── Build subprocess command ────────────────────────────────────────
+    cmd = [
+        sys.executable,
+        str(runner),
+        "--input-dir",
+        str(input_dir),
+    ]
+    cmd.append("--dry-run" if is_dry_run else "--real")
+
+    # Env vars passed through. The pipeline_runner reads OPENAI_API_KEY,
+    # MAPBOX_TOKEN, etc. directly from os.environ — so any keys the user
+    # has exported in their shell are inherited.
+    env = dict(os.environ)
+    env.setdefault("LOVARCH_PROJECT_NAME", project)
+    env.setdefault("LOVARCH_WORKFLOW", workflow)
+
+    # PREMIUM: hand the user's Supabase session to the runner so ALL paid AI
+    # goes through cli-ai-generate (debiting the user's credits, 1000cr=$1) and
+    # persistence writes as the user (RLS) — the runner never touches the
+    # student's OPENAI_API_KEY nor a service_role key. Also pass --user-id so the
+    # execution rows are owned by the token's user (RLS requires it).
+    if mode == ExecutionMode.PREMIUM and not is_dry_run:
+        from lovarch_cli.auth.session import LovarchSession
+        from lovarch_cli.config import DEFAULT_API_ANON_KEY, DEFAULT_API_URL
+
+        session = LovarchSession.load()
+        if session is not None:
+            env["LOVARCH_ACCESS_TOKEN"] = session.access_token
+            env["LOVARCH_ANON_KEY"] = DEFAULT_API_ANON_KEY
+            env["LOVARCH_API_URL"] = DEFAULT_API_URL
+            env["LOVARCH_SUPABASE_URL"] = DEFAULT_API_URL
+            cmd += ["--user-id", session.user_id]
+
+    # ─── Run subprocess + stream output ──────────────────────────────────
+    try:
+        result = subprocess.run(cmd, env=env, check=False)
+    except FileNotFoundError as exc:
+        err_console.print(
+            f"\n[red]✗ {t('run.subprocess_failed', lang=lang, message=str(exc))}[/red]\n"
+        )
+        sys.exit(2)
+    except KeyboardInterrupt:
+        err_console.print(
+            f"\n[yellow]⚠ {t('run.interrupted', lang=lang)}[/yellow]\n"
+        )
+        sys.exit(130)
+
+    # ─── Result panel ────────────────────────────────────────────────────
+    # Terminal status is derived from the runner's exit code:
+    #   0 → completed · 3 → qa_rejected (Tier 2 QA REJECT) · other → failed
+    run_status = _status_from_returncode(result.returncode)
+    _write_last_run(proj_dir, run_status, result.returncode)
+
+    if run_status == "completed":
+        summary_key, border = "run.completed", "green"
+    elif run_status == "qa_rejected":
+        summary_key, border = "run.qa_rejected", "yellow"
+    else:
+        summary_key, border = "run.failed", "red"
+
+    console.print()
+    console.print(
+        Panel(
+            Text.from_markup(
+                f"{t(summary_key, lang=lang, project=project)}\n\n"
+                f"{t('run.next_steps', lang=lang, project=project)}"
+            ),
+            title=f"[bold {border}]{t('run.summary_title', lang=lang)}[/bold {border}]",
+            border_style=border,
+            padding=(1, 2),
+        )
+    )
+    console.print()
+    sys.exit(result.returncode)

lovarch_cli/commands/signup.py

@@ -0,0 +1,185 @@
+"""arch signup — Free mode interactive registration with lead capture.
+
+Flow:
+  1. Welcome banner (4-language)
+  2. Interactive prompts: full_name, email, phone, country, language
+  3. GDPR consent (mandatory — Italian/EU compliance)
+  4. POST → cli-signup EF (validates server-side, creates shadow user, lead)
+  5. Save returned token to ~/.lovarch/credentials.json (chmod 0600)
+  6. Success message + next-steps (arch init, arch run)
+
+Localization: i18n keys live in lovarch_cli/i18n/translations/{it,pt,en,es}.json.
+"""
+from __future__ import annotations
+
+import asyncio
+import re
+import sys
+from datetime import datetime, timezone
+from typing import Annotated
+
+import typer
+from rich.console import Console
+from rich.panel import Panel
+from rich.prompt import Confirm, Prompt
+from rich.text import Text
+
+from lovarch_cli.api import ApiClient, LovarchApiError
+from lovarch_cli.config import Credentials, save_credentials
+from lovarch_cli.i18n import current_lang, set_current_lang, t
+from lovarch_cli.i18n.loader import VALID_LANGUAGES
+
+console = Console()
+err_console = Console(stderr=True)
+
+EMAIL_RX = re.compile(r"^[^\s@]+@[^\s@]+\.[^\s@]+$")
+PHONE_RX = re.compile(r"^\+?[1-9]\d{6,14}$")
+COUNTRY_RX = re.compile(r"^[A-Z]{2}$")
+
+
+def signup_command(
+    yes: Annotated[
+        bool,
+        typer.Option(
+            "--yes",
+            "-y",
+            help="Auto-accept TOS (skip GDPR consent prompt — for CI only).",
+        ),
+    ] = False,
+    lang_flag: Annotated[
+        str | None,
+        typer.Option(
+            "--lang",
+            help="Force language (it/pt/en/es). Default: detect from $LANG.",
+        ),
+    ] = None,
+) -> None:
+    """Cadastro Free interativo (interactive Free signup).
+
+    Use --yes to auto-accept TOS for non-interactive (CI/Docker) flows.
+    """
+    # ─── Language detection ──────────────────────────────────────────────
+    if lang_flag is not None:
+        set_current_lang(lang_flag)
+    lang = current_lang()
+
+    # ─── Welcome banner ──────────────────────────────────────────────────
+    console.print()
+    console.print(
+        Panel(
+            Text.from_markup(t("signup.welcome_body", lang=lang)),
+            title=f"[bold gold1]🎓 {t('signup.welcome_title', lang=lang)}[/bold gold1]",
+            border_style="gold1",
+            padding=(1, 2),
+        )
+    )
+    console.print()
+
+    # ─── Confirm/select language ─────────────────────────────────────────
+    lang = Prompt.ask(
+        f"[bold]{t('signup.prompt_language', lang=lang)}[/bold]",
+        choices=list(VALID_LANGUAGES),
+        default=lang,
+    )
+    set_current_lang(lang)
+
+    # ─── Collect inputs ──────────────────────────────────────────────────
+    while True:
+        full_name = Prompt.ask(
+            f"[bold]{t('signup.prompt_full_name', lang=lang)}[/bold]"
+        ).strip()
+        if len(full_name) >= 3:
+            break
+        err_console.print(f"[red]{t('signup.name_too_short', lang=lang)}[/red]")
+
+    while True:
+        email = (
+            Prompt.ask(f"[bold]{t('signup.prompt_email', lang=lang)}[/bold]")
+            .strip()
+            .lower()
+        )
+        if EMAIL_RX.match(email):
+            break
+        err_console.print(f"[red]{t('signup.invalid_email', lang=lang)}[/red]")
+
+    while True:
+        phone = Prompt.ask(
+            f"[bold]{t('signup.prompt_phone', lang=lang)}[/bold]"
+        ).strip()
+        if PHONE_RX.match(phone):
+            break
+        err_console.print(f"[red]{t('signup.invalid_phone', lang=lang)}[/red]")
+
+    while True:
+        country = (
+            Prompt.ask(f"[bold]{t('signup.prompt_country', lang=lang)}[/bold]")
+            .strip()
+            .upper()
+        )
+        if COUNTRY_RX.match(country):
+            break
+        err_console.print(f"[red]{t('signup.invalid_country', lang=lang)}[/red]")
+
+    # ─── GDPR consent (mandatory) ────────────────────────────────────────
+    if not yes:
+        console.print(
+            f"\n[dim]{t('signup.tos_url_label', lang=lang)} "
+            f"https://lovarch.com/legal/cli-tos[/dim]"
+        )
+        accept = Confirm.ask(
+            f"[bold yellow]{t('signup.prompt_consent', lang=lang)}[/bold yellow]",
+            default=False,
+        )
+        if not accept:
+            err_console.print(
+                f"\n[red]✗ {t('signup.consent_required', lang=lang)}[/red]"
+            )
+            raise typer.Exit(1)
+
+    # ─── Submit to EF ────────────────────────────────────────────────────
+    console.print(f"\n[dim]{t('signup.submitting', lang=lang)}[/dim]")
+    api = ApiClient()
+    payload = {
+        "full_name": full_name,
+        "email": email,
+        "phone": phone,
+        "country": country,
+        "language": lang,
+        "source": "cli-free",
+        "accept_tos": True,
+        "cli_version": "0.1.0",
+    }
+
+    try:
+        response = asyncio.run(api.invoke_ef("cli-signup", payload))
+    except LovarchApiError as exc:
+        err_console.print(f"\n[red]✗ {exc}[/red]")
+        if exc.error_code:
+            err_console.print(f"[dim](error_code: {exc.error_code})[/dim]")
+        sys.exit(1)
+
+    # ─── Save credentials ────────────────────────────────────────────────
+    creds = Credentials(
+        mode="free",
+        lead_id=response["lead_id"],
+        user_id=response["user_id"],
+        free_token=response["free_token"],
+        email=email,
+        full_name=full_name,
+        country=country,
+        language=lang,
+        signed_up_at=datetime.now(timezone.utc).isoformat(timespec="seconds"),
+        upgrade_url=response.get("upgrade_url"),
+    )
+    creds_path = save_credentials(creds)
+
+    # ─── Success ─────────────────────────────────────────────────────────
+    console.print()
+    console.print(
+        Panel(
+            Text.from_markup(t("signup.next_steps", lang=lang)),
+            border_style="green",
+            padding=(1, 2),
+        )
+    )
+    console.print(f"\n[dim]Credentials: {creds_path}[/dim]")