thoughtleaders-cli 0.5.0__py3-none-any.whl

tl_cli/commands/describe.py

@@ -0,0 +1,166 @@
+"""tl describe — Schema and filter discovery for resources."""
+
+import json
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from tl_cli.client.errors import ApiError, handle_api_error
+from tl_cli.client.http import get_client
+from tl_cli.output.formatter import detect_format
+
+app = typer.Typer(help="Discover available resources, fields, filters, and credit costs")
+console = Console()
+
+
+@app.callback(invoke_without_command=True)
+def describe(ctx: typer.Context) -> None:
+    """Discover resources, fields, filters, and credit costs (free)."""
+    if ctx.invoked_subcommand is None:
+        ctx.invoke(list_cmd, json_output=False)
+
+
+@app.command("list")
+def list_cmd(
+    json_output: bool = typer.Option(False, "--json", help="JSON output"),
+    toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
+) -> None:
+    """List all available resources with credit costs.
+
+    Examples:
+        tl describe list
+        tl describe list --json
+    """
+    fmt = detect_format(json_output, False, False, toon_output)
+
+    client = get_client()
+    try:
+        data = client.get("/describe")
+
+        if fmt == "json":
+            print(json.dumps(data, indent=2, default=str))
+            return
+
+        _print_resource_list(data)
+
+    except ApiError as e:
+        handle_api_error(e)
+    finally:
+        client.close()
+
+
+@app.command("show")
+def show_cmd(
+    resource: str = typer.Argument(..., help="Resource name (sponsorships, channels, etc.)"),
+    filters_only: bool = typer.Option(False, "--filters", help="Show only available filters"),
+    fields_only: bool = typer.Option(False, "--fields", help="Show only available fields"),
+    json_output: bool = typer.Option(False, "--json", help="JSON output"),
+    toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
+) -> None:
+    """Show fields, filters, and credit costs for a specific resource.
+
+    Examples:
+        tl describe show sponsorships
+        tl describe show sponsorships --filters
+        tl describe show sponsorships --json
+    """
+    fmt = detect_format(json_output, False, False, toon_output)
+
+    client = get_client()
+    try:
+        data = client.get(f"/describe/{resource}")
+
+        if fmt == "json":
+            target = data
+            if filters_only and "filters" in data:
+                target = data["filters"]
+            elif fields_only and "fields" in data:
+                target = data["fields"]
+            print(json.dumps(target, indent=2, default=str))
+            return
+
+        _print_resource_detail(data, filters_only, fields_only)
+
+    except ApiError as e:
+        handle_api_error(e)
+    finally:
+        client.close()
+
+
+def _credit_str(credits: dict, key: str) -> str:
+    value = credits.get(key, "free")
+    is_free = value == 0 or value == "free"
+    if is_free and credits.get("credits_vary"):
+        return "*"
+    assert not credits.get("credits_vary"), \
+        f"credits_vary must not be set alongside a fixed non-zero rate ({key}={value})"
+    return str(value)
+
+
+def _print_resource_list(data: dict) -> None:
+    """Print all available resources."""
+    resources = data.get("resources", [])
+    has_variable = any(r.get("credits", {}).get("credits_vary") for r in resources)
+
+    table = Table(title="Available Resources")
+    table.add_column("Resource", style="bold cyan")
+    table.add_column("Description")
+    table.add_column("Credits (list)", justify="right")
+    table.add_column("Credits (detail)", justify="right")
+
+    for r in resources:
+        credits = r.get("credits", {})
+        table.add_row(
+            r["name"],
+            r.get("description", ""),
+            _credit_str(credits, "list"),
+            _credit_str(credits, "detail"),
+        )
+
+    console.print(table)
+    if has_variable:
+        console.print("[dim]* Variable pricing depending on the complexity of the report.[/dim]")
+
+
+def _print_resource_detail(data: dict, filters_only: bool, fields_only: bool) -> None:
+    """Print fields and/or filters for a resource."""
+    name = data.get("resource", "")
+    desc = data.get("description", "")
+    credits = data.get("credits", {})
+
+    if not filters_only:
+        console.print(f"\n[bold]{name}[/bold] — {desc}")
+        console.print(
+            f"Credits: [cyan]{credits.get('list', 'free')}[/cyan]/result, "
+            f"[cyan]{credits.get('detail', 'free')}[/cyan]/detail\n"
+        )
+
+    if not filters_only:
+        fields = data.get("fields", [])
+        if fields:
+            table = Table(title="Fields")
+            table.add_column("Name", style="bold")
+            table.add_column("Type")
+            table.add_column("Description")
+            for f in fields:
+                table.add_row(f["name"], f.get("type", ""), f.get("description", ""))
+            console.print(table)
+
+    if not fields_only:
+        filters = data.get("filters", [])
+        if filters:
+            table = Table(title="Filters")
+            table.add_column("Name", style="bold cyan")
+            table.add_column("Type")
+            table.add_column("Description")
+            table.add_column("Values")
+            for f in filters:
+                values = ", ".join(f.get("values", [])) if "values" in f else ""
+                table.add_row(
+                    f["name"],
+                    f.get("type", ""),
+                    f.get("description", ""),
+                    values,
+                )
+            console.print(table)

tl_cli/commands/doctor.py

@@ -0,0 +1,70 @@
+"""tl doctor — Health check for auth, connectivity, and version."""
+
+import typer
+from rich.console import Console
+
+from tl_cli import __version__
+from tl_cli.auth.token_store import load_tokens
+from tl_cli.client.errors import ApiError
+from tl_cli.client.http import get_client
+from tl_cli.config import get_config
+
+app = typer.Typer(help="Health check (auth, connectivity, version)")
+console = Console()
+
+
+@app.callback(invoke_without_command=True)
+def doctor(ctx: typer.Context) -> None:
+    """Check CLI health: version, auth status, API connectivity, credits."""
+    console.print(f"\n[bold]tl-cli[/bold] v{__version__}\n")
+    config = get_config()
+    all_ok = True
+
+    # API URL
+    console.print(f"  API:    {config.cli_api_base}")
+
+    # Auth
+    tokens = load_tokens()
+    if not tokens:
+        console.print("  Auth:   [red]not logged in[/red]")
+        all_ok = False
+    elif tokens.is_expired:
+        console.print(f"  Auth:   [yellow]token expired[/yellow] ({tokens.email})")
+        all_ok = False
+    else:
+        console.print(f"  Auth:   [green]ok[/green] ({tokens.email})")
+
+    # Connectivity + balance
+    if tokens and not tokens.is_expired:
+        client = get_client()
+        try:
+            data = client.get("/balance")
+            balance_val = data.get("balance", "?")
+            console.print(f"  API:    [green]connected[/green]")
+            console.print(f"  Credits: {balance_val}")
+        except ApiError as e:
+            console.print(f"  API:    [red]error ({e.status_code})[/red]")
+            all_ok = False
+        except Exception as e:
+            console.print(f"  API:    [red]unreachable[/red]")
+            all_ok = False
+        finally:
+            client.close()
+    else:
+        console.print("  API:    [dim]skipped (not authenticated)[/dim]")
+
+    # Plugin/skill versions
+    from tl_cli.commands.setup import check_plugin_version
+    warnings = check_plugin_version()
+    if warnings:
+        for warn in warnings:
+            console.print(f"  Plugin: [yellow]{warn}[/yellow]")
+        all_ok = False
+    else:
+        console.print("  Plugin: [green]ok[/green]")
+
+    console.print()
+    if all_ok:
+        console.print("[green]Everything looks good.[/green]")
+    else:
+        console.print("[yellow]Issues found.[/yellow]")

tl_cli/commands/matches.py

@@ -0,0 +1,69 @@
+"""tl matches — Shortcut for matched sponsorships."""
+
+from typing import Optional
+
+import typer
+
+from tl_cli.commands.sponsorships import do_create, do_list, do_show
+from tl_cli.output.formatter import detect_format
+
+app = typer.Typer(help="Matches — possible brand-channel pairings (shortcut for sponsorships status:match)")
+
+
+@app.callback(invoke_without_command=True)
+def matches(ctx: typer.Context) -> None:
+    """Matches — possible brand-channel pairings."""
+    if ctx.invoked_subcommand is None:
+        ctx.invoke(list_cmd, args=[], json_output=False, csv_output=False, md_output=False, limit=50, offset=0)
+
+
+@app.command("list")
+def list_cmd(
+    args: list[str] = typer.Argument(None, help="Filters (key:value pairs). Run 'tl describe show sponsorships' for available filters."),
+    json_output: bool = typer.Option(False, "--json", help="JSON output"),
+    csv_output: bool = typer.Option(False, "--csv", help="CSV output"),
+    md_output: bool = typer.Option(False, "--md", help="Markdown output"),
+    toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
+    limit: int = typer.Option(50, "--limit", "-l", help="Max results"),
+    offset: int = typer.Option(0, "--offset", help="Pagination offset"),
+) -> None:
+    """List matches with optional filters.
+
+    Examples:
+        tl matches list                       # List recent matches
+        tl matches list brand:"Nike"          # Filter matches
+    """
+    fmt = detect_format(json_output, csv_output, md_output, toon_output)
+    do_list(args or [], fmt, limit, offset, default_status="match", title="Matches")
+
+
+@app.command("show")
+def show_cmd(
+    item_id: str = typer.Argument(..., help="Sponsorship ID"),
+    json_output: bool = typer.Option(False, "--json", help="JSON output"),
+    toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
+) -> None:
+    """Show match detail by ID.
+
+    Examples:
+        tl matches show 12345
+    """
+    fmt = detect_format(json_output, False, False, toon_output)
+    do_show(item_id, fmt)
+
+
+@app.command("create")
+def create_cmd(
+    channel: int = typer.Option(..., "--channel", "-c", help="Channel ID"),
+    brand: int = typer.Option(..., "--brand", "-b", help="Brand ID"),
+    price: Optional[float] = typer.Option(None, "--price", "-p", help="Deal price"),
+    json_output: bool = typer.Option(False, "--json", help="JSON output"),
+    toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
+) -> None:
+    """Create a new match (free, no credits charged).
+
+    Examples:
+        tl matches create --channel 1 --brand 2
+    """
+    fmt = detect_format(json_output, False, False, toon_output)
+    do_create(channel, brand, price, fmt, status="matched")

tl_cli/commands/proposals.py

@@ -0,0 +1,69 @@
+"""tl proposals — Shortcut for proposed sponsorships."""
+
+from typing import Optional
+
+import typer
+
+from tl_cli.commands.sponsorships import do_create, do_list, do_show
+from tl_cli.output.formatter import detect_format
+
+app = typer.Typer(help="Proposals — matches proposed to both sides (shortcut for sponsorships status:proposal)")
+
+
+@app.callback(invoke_without_command=True)
+def proposals(ctx: typer.Context) -> None:
+    """Proposals — matches proposed to both sides."""
+    if ctx.invoked_subcommand is None:
+        ctx.invoke(list_cmd, args=[], json_output=False, csv_output=False, md_output=False, limit=50, offset=0)
+
+
+@app.command("list")
+def list_cmd(
+    args: list[str] = typer.Argument(None, help="Filters (key:value pairs). Run 'tl describe show sponsorships' for available filters."),
+    json_output: bool = typer.Option(False, "--json", help="JSON output"),
+    csv_output: bool = typer.Option(False, "--csv", help="CSV output"),
+    md_output: bool = typer.Option(False, "--md", help="Markdown output"),
+    toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
+    limit: int = typer.Option(50, "--limit", "-l", help="Max results"),
+    offset: int = typer.Option(0, "--offset", help="Pagination offset"),
+) -> None:
+    """List proposals with optional filters.
+
+    Examples:
+        tl proposals list                     # List recent proposals
+        tl proposals list brand:"Nike"        # Filter proposals
+    """
+    fmt = detect_format(json_output, csv_output, md_output, toon_output)
+    do_list(args or [], fmt, limit, offset, default_status="proposal", title="Proposals")
+
+
+@app.command("show")
+def show_cmd(
+    item_id: str = typer.Argument(..., help="Sponsorship ID"),
+    json_output: bool = typer.Option(False, "--json", help="JSON output"),
+    toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
+) -> None:
+    """Show proposal detail by ID.
+
+    Examples:
+        tl proposals show 12345
+    """
+    fmt = detect_format(json_output, False, False, toon_output)
+    do_show(item_id, fmt)
+
+
+@app.command("create")
+def create_cmd(
+    channel: int = typer.Option(..., "--channel", "-c", help="Channel ID"),
+    brand: int = typer.Option(..., "--brand", "-b", help="Brand ID"),
+    price: Optional[float] = typer.Option(None, "--price", "-p", help="Deal price"),
+    json_output: bool = typer.Option(False, "--json", help="JSON output"),
+    toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
+) -> None:
+    """Create a new proposal (free, no credits charged).
+
+    Examples:
+        tl proposals create --channel 1 --brand 2
+    """
+    fmt = detect_format(json_output, False, False, toon_output)
+    do_create(channel, brand, price, fmt, status="proposed")