codedd-cli 0.1.0__py3-none-any.whl

codedd_cli/commands/audits_cmd.py

@@ -0,0 +1,273 @@
+"""
+``codedd audits`` sub-commands: list, select.
+"""
+
+from typing import Optional
+
+import typer
+from rich.console import Console
+from rich.prompt import IntPrompt
+
+from codedd_cli.api.client import CodeDDClient
+from codedd_cli.api.endpoints import Endpoints
+from codedd_cli.auth.session import require_auth
+from codedd_cli.config.settings import ConfigManager
+from codedd_cli.models.audit import Audit, GroupAudit
+from codedd_cli.utils.display import (
+    print_error,
+    print_info,
+    print_success,
+    render_audit_detail,
+    render_audits_table,
+)
+from codedd_cli.utils.payload_inspector import review_request
+from codedd_cli.utils.validators import is_valid_uuid
+
+console = Console()
+audits_app = typer.Typer(no_args_is_help=True)
+
+
+def _fetch_audits(
+    client: CodeDDClient,
+    offset: int = 0,
+    limit: int = 20,
+    audit_type: Optional[str] = None,
+) -> tuple[list[Audit], list[GroupAudit], int]:
+    """
+    Call the CLI audits endpoint and parse the response into model objects.
+
+    Returns:
+        Tuple of (single_audits, group_audits, total_count).
+    """
+    params: dict[str, str | int] = {"offset": offset, "limit": limit}
+    if audit_type:
+        params["type"] = audit_type
+
+    resp = client.get(Endpoints.LIST_AUDITS, params=params)
+
+    if resp.status_code == 401:
+        print_error("Authentication failed.  Run [bold cyan]codedd auth login[/bold cyan].")
+        raise typer.Exit(code=1)
+
+    if resp.status_code != 200:
+        msg = "Failed to fetch audits"
+        try:
+            msg = resp.json().get("message", msg)
+        except Exception:
+            pass
+        print_error(msg)
+        raise typer.Exit(code=1)
+
+    data = resp.json()
+    if data.get("status") != "success":
+        print_error(data.get("message", "Unknown error from server"))
+        raise typer.Exit(code=1)
+
+    single_audits = [
+        Audit(
+            audit_uuid=a["audit_uuid"],
+            audit_name=a.get("audit_name", ""),
+            audit_status=a.get("audit_status", ""),
+            audit_type=a.get("audit_type", "single"),
+            ai_synthesis=a.get("ai_synthesis"),
+            repo_url=a.get("repo_url", ""),
+            number_files=a.get("number_files", 0),
+            lines_of_code=a.get("lines_of_code", 0),
+        )
+        for a in data.get("audits_data", [])
+    ]
+
+    group_audits = [
+        GroupAudit(
+            audit_uuid=g["audit_uuid"],
+            audit_name=g.get("audit_name", ""),
+            audit_status=g.get("audit_status", ""),
+            audit_type=g.get("audit_type", "group"),
+            ai_synthesis=g.get("ai_synthesis"),
+            number_of_sub_audits=g.get("number_of_sub_audits", 0),
+            number_files=g.get("number_files", 0),
+            lines_of_code=g.get("lines_of_code", 0),
+        )
+        for g in data.get("group_audits_data", [])
+    ]
+
+    total = data.get("total_audits", len(single_audits) + len(group_audits))
+    return single_audits, group_audits, total
+
+
+@audits_app.command("list")
+@require_auth
+def list_audits(
+    audit_type: Optional[str] = typer.Option(
+        None,
+        "--type",
+        "-t",
+        help="Filter by audit type: 'single' or 'group'.",
+    ),
+    limit: int = typer.Option(10, "--limit", "-l", help="Number of audits per page (default 10, max 100)."),
+    page: int = typer.Option(1, "--page", "-p", help="Page number (1-indexed)."),
+    show: bool = typer.Option(
+        False,
+        "--show",
+        "-s",
+        help="Write the API request to a file and open it for review before sending.",
+    ),
+) -> None:
+    """
+    List your audits on the CodeDD platform.
+
+    Displays a table with audit name, status, file count, lines of code,
+    and date.  Use --type to filter by single or group audits.
+    """
+    if audit_type and audit_type not in ("single", "group"):
+        print_error("--type must be 'single' or 'group'")
+        raise typer.Exit(code=1)
+
+    if limit < 1 or limit > 100:
+        print_error("--limit must be between 1 and 100")
+        raise typer.Exit(code=1)
+
+    offset = (page - 1) * limit
+
+    cfg = ConfigManager()
+
+    params: dict[str, str | int] = {"offset": offset, "limit": limit}
+    if audit_type:
+        params["type"] = audit_type
+
+    if show:
+        confirmed = review_request(
+            "GET",
+            Endpoints.LIST_AUDITS,
+            params=params,
+            command_label="Audits List",
+            context_note="This request fetches your list of audits from CodeDD. Only pagination and optional type filter are sent.",
+            confirm_prompt="Proceed with this request to CodeDD?",
+        )
+        if not confirmed:
+            print_info("Cancelled.")
+            raise typer.Exit(code=0)
+
+    with CodeDDClient(config=cfg) as client:
+        single_audits, group_audits, total = _fetch_audits(
+            client, offset=offset, limit=limit, audit_type=audit_type
+        )
+
+    if not single_audits and not group_audits:
+        print_info("No audits found. Create an audit at [bold cyan]https://codedd.ai[/bold cyan]")
+        return
+
+    active_uuid = (cfg.active_audit_uuid or "").strip() or None
+    render_audits_table(single_audits, group_audits, total, active_audit_uuid=active_uuid)
+
+    # Pagination info
+    total_pages = max(1, (total + limit - 1) // limit)
+    if total_pages > 1:
+        print_info(f"Page {page}/{total_pages}  (use --page to navigate)")
+
+
+@audits_app.command("select")
+@require_auth
+def select_audit(
+    audit_uuid: Optional[str] = typer.Argument(
+        None,
+        help="List index (1, 2, …) or UUID of the audit to select (omit for interactive).",
+    ),
+    show: bool = typer.Option(
+        False,
+        "--show",
+        "-s",
+        help="Write the API request to a file and open it for review before sending.",
+    ),
+) -> None:
+    """
+    Select an audit as the active audit for subsequent CLI commands.
+
+    Pass the row number from [bold]codedd audits list[/bold] (e.g. 1, 2) or a
+    full UUID. If omitted, an interactive list is shown.
+    """
+    cfg = ConfigManager()
+
+    list_params: dict[str, str | int] = {"offset": 0, "limit": 50}
+    if show:
+        confirmed = review_request(
+            "GET",
+            Endpoints.LIST_AUDITS,
+            params=list_params,
+            command_label="Audits Select (Fetch List)",
+            context_note="This request fetches your list of audits from CodeDD so you can select one. Only pagination params are sent.",
+            confirm_prompt="Proceed with this request to CodeDD?",
+        )
+        if not confirmed:
+            print_info("Cancelled.")
+            raise typer.Exit(code=0)
+
+    with CodeDDClient(config=cfg) as client:
+        single_audits, group_audits, total = _fetch_audits(client, limit=50)
+
+    # Build a combined ordered list: group audits first, then single
+    all_audits: list[Audit | GroupAudit] = list(group_audits) + list(single_audits)
+
+    if not all_audits:
+        print_info("No audits available.")
+        raise typer.Exit()
+
+    if audit_uuid:
+        audit_uuid = audit_uuid.strip()
+
+        # Selection by 1-based list index (e.g. "1", "2" from "codedd audits list")
+        try:
+            index = int(audit_uuid)
+            if 1 <= index <= len(all_audits):
+                _set_active(cfg, all_audits[index - 1])
+                return
+            print_error(f"Index must be between 1 and {len(all_audits)}.")
+            raise typer.Exit(code=1)
+        except ValueError:
+            pass  # Not an integer; treat as UUID below
+
+        # Direct selection by UUID
+        if not is_valid_uuid(audit_uuid):
+            print_error("Invalid UUID format. Use a list index (e.g. 1) or a full UUID.")
+            raise typer.Exit(code=1)
+
+        match = next(
+            (a for a in all_audits if a.audit_uuid == audit_uuid),
+            None,
+        )
+        if not match:
+            print_error(f"Audit {audit_uuid} not found in your audits.")
+            raise typer.Exit(code=1)
+
+        _set_active(cfg, match)
+        return
+
+    # Interactive selection
+    active_uuid = (cfg.active_audit_uuid or "").strip() or None
+    render_audits_table(
+        [a for a in all_audits if isinstance(a, Audit)],
+        [a for a in all_audits if isinstance(a, GroupAudit)],
+        total,
+        active_audit_uuid=active_uuid,
+    )
+
+    console.print()
+    choice = IntPrompt.ask(
+        "Select an audit by number",
+        default=1,
+        choices=[str(i) for i in range(1, len(all_audits) + 1)],
+    )
+
+    selected = all_audits[choice - 1]
+    _set_active(cfg, selected)
+
+
+def _set_active(cfg: ConfigManager, audit: Audit | GroupAudit) -> None:
+    """Persist the selected audit in config and render its details."""
+    cfg.set_active_audit(
+        audit_uuid=audit.audit_uuid,
+        audit_type=audit.audit_type,
+        audit_name=audit.audit_name,
+    )
+    print_success(f"Active audit set to [bold]{audit.audit_name}[/bold]")
+    render_audit_detail(audit)

codedd_cli/commands/auth_cmd.py

@@ -0,0 +1,230 @@
+"""
+``codedd auth`` sub-commands: login, logout, status.
+"""
+
+from typing import Optional
+
+import typer
+from rich.console import Console
+from rich.panel import Panel
+
+from codedd_cli.api.client import CodeDDClient
+from codedd_cli.api.endpoints import Endpoints
+from codedd_cli.auth.token_manager import TokenManager
+from codedd_cli.config.settings import ConfigManager
+from codedd_cli.models.account import AccountInfo
+from codedd_cli.utils.display import print_error, print_info, print_success
+from codedd_cli.utils.payload_inspector import review_request
+from codedd_cli.utils.validators import is_valid_cli_token
+
+console = Console()
+auth_app = typer.Typer(no_args_is_help=True)
+
+
+@auth_app.command("login")
+def login(
+    token: Optional[str] = typer.Option(
+        None,
+        "--token",
+        "-t",
+        help="CLI token (omit to be prompted interactively).",
+        prompt=False,
+    ),
+    show: bool = typer.Option(
+        False,
+        "--show",
+        "-s",
+        help="Write the verify request to a file and open it for review before sending.",
+    ),
+) -> None:
+    """
+    Authenticate with the CodeDD platform using a CLI token.
+
+    Generate a token from your account settings at https://codedd.ai
+    (Account → CLI Access → Generate Token), then run:
+
+        codedd auth login --token <your_token>
+
+    Or simply run ``codedd auth login`` to be prompted.
+    """
+    # Interactive prompt if --token not given
+    if not token:
+        token = typer.prompt("Paste your CLI token", hide_input=True)
+
+    # Strip whitespace and newlines (handles copy-paste issues)
+    token = token.strip().replace("\n", "").replace("\r", "")
+
+    # Local format check
+    if not is_valid_cli_token(token):
+        # Provide more helpful error message
+        if not token:
+            print_error("Token cannot be empty.")
+        elif not token.startswith("codedd_cli_"):
+            print_error(
+                f"Invalid token format. Token must start with [bold]codedd_cli_[/bold].\n"
+                f"Received: [dim]{token[:20]}...[/dim]"
+            )
+        else:
+            print_error(
+                f"Invalid token format. Token appears too short or contains invalid characters.\n"
+                f"Expected: [bold]codedd_cli_[/bold] followed by at least 32 base64url characters."
+            )
+        raise typer.Exit(code=1)
+
+    # Verify against server
+    console.print("[dim]Verifying token with CodeDD server…[/dim]")
+    cfg = ConfigManager()
+
+    # Temporarily store token so the client can use it
+    TokenManager.store(token)
+
+    try:
+        if show:
+            confirmed = review_request(
+                "POST",
+                Endpoints.VERIFY_TOKEN,
+                command_label="Auth Verify (Login)",
+                context_note="This request verifies your CLI token with CodeDD. The token is sent in the X-CLI-Token header (value not shown in this file).",
+                confirm_prompt="Proceed with sending this request to CodeDD?",
+            )
+            if not confirmed:
+                TokenManager.delete()
+                print_info("Cancelled.")
+                raise typer.Exit(code=0)
+
+        with CodeDDClient(config=cfg) as client:
+            resp = client.post(Endpoints.VERIFY_TOKEN)
+
+        if resp.status_code == 200:
+            data = resp.json()
+            if data.get("status") == "success":
+                account = AccountInfo(
+                    account_uuid=data["account_uuid"],
+                    account_name=data.get("account_name", ""),
+                    email=data.get("email", ""),
+                    token_name=data.get("token_name", ""),
+                )
+
+                # Persist session metadata
+                cfg.account_uuid = account.account_uuid
+                cfg.account_name = account.account_name
+                cfg.token_hint = TokenManager.token_hint(token)
+                cfg.save()
+
+                print_success(f"Authenticated as [bold]{account.account_name}[/bold] ({account.email})")
+                if account.token_name:
+                    print_info(f"Token: {account.token_name}")
+                return
+
+        # Auth failed — clean up
+        TokenManager.delete()
+        error_msg = "Authentication failed"
+        try:
+            error_msg = resp.json().get("message", error_msg)
+        except Exception:
+            pass
+        print_error(error_msg)
+        raise typer.Exit(code=1)
+
+    except Exception as exc:
+        TokenManager.delete()
+        if isinstance(exc, typer.Exit):
+            raise
+        print_error(f"Connection error: {exc}")
+        raise typer.Exit(code=1)
+
+
+@auth_app.command("logout")
+def logout() -> None:
+    """
+    Remove stored credentials and end the current CLI session.
+    """
+    cfg = ConfigManager()
+
+    if not cfg.is_authenticated:
+        print_info("You are not currently logged in.")
+        return
+
+    account_name = cfg.account_name or "user"
+    TokenManager.delete()
+    cfg.clear_session()
+
+    print_success(f"Logged out ([dim]{account_name}[/dim]).")
+
+
+@auth_app.command("status")
+def status(
+    show: bool = typer.Option(
+        False,
+        "--show",
+        "-s",
+        help="Write the verify request to a file and open it for review before sending.",
+    ),
+) -> None:
+    """
+    Show the current authentication state.
+    """
+    cfg = ConfigManager()
+    token = TokenManager.retrieve()
+
+    if not cfg.is_authenticated or not token:
+        console.print(
+            Panel(
+                "[bold red]Not authenticated[/bold red]\n\n"
+                "Run [bold cyan]codedd auth login[/bold cyan] to connect.",
+                title="Auth Status",
+                expand=False,
+            )
+        )
+        return
+
+    # Optionally verify token is still valid server-side
+    if show:
+        confirmed = review_request(
+            "POST",
+            Endpoints.VERIFY_TOKEN,
+            command_label="Auth Verify (Status)",
+            context_note="This request verifies your CLI token with CodeDD. The token is sent in the X-CLI-Token header (value not shown in this file).",
+            confirm_prompt="Proceed with sending this request to CodeDD?",
+        )
+        if not confirmed:
+            print_info("Cancelled. Skipping server verification.")
+            # Still show local state
+            panel_text = (
+                f"[bold green]Authenticated (local)[/bold green]\n\n"
+                f"[bold]Account:[/bold]  {cfg.account_name}\n"
+                f"[bold]Token:[/bold]    {cfg.token_hint}\n"
+                f"[bold]API URL:[/bold] {cfg.api_url}\n\n"
+                "[dim]Server verification was skipped (--show cancelled).[/dim]"
+            )
+            console.print(Panel(panel_text, title="Auth Status", expand=False))
+            return
+
+    with CodeDDClient(config=cfg) as client:
+        try:
+            resp = client.post(Endpoints.VERIFY_TOKEN)
+            if resp.status_code == 200 and resp.json().get("status") == "success":
+                server_info = resp.json()
+                panel_text = (
+                    f"[bold green]Authenticated[/bold green]\n\n"
+                    f"[bold]Account:[/bold]  {server_info.get('account_name', cfg.account_name)}\n"
+                    f"[bold]Email:[/bold]    {server_info.get('email', '—')}\n"
+                    f"[bold]Token:[/bold]    {cfg.token_hint}\n"
+                    f"[bold]API URL:[/bold] {cfg.api_url}"
+                )
+            else:
+                panel_text = (
+                    f"[bold yellow]Token invalid or expired[/bold yellow]\n\n"
+                    f"[bold]Account:[/bold]  {cfg.account_name}\n"
+                    f"[bold]Token:[/bold]    {cfg.token_hint}\n\n"
+                    "Run [bold cyan]codedd auth login[/bold cyan] with a new token."
+                )
+        except Exception:
+            panel_text = (
+                f"[bold yellow]Could not reach server[/bold yellow]\n\n"
+                f"[bold]Account:[/bold]  {cfg.account_name}\n"
+                f"[bold]Token:[/bold]    {cfg.token_hint}\n"
+                f"[bold]API URL:[/bold] {cfg.api_url}"
+            )
+
+    console.print(Panel(panel_text, title="Auth Status", expand=False))