crowdtime-cli 0.8.2__tar.gz → 0.9.0__tar.gz

{crowdtime_cli-0.8.2 → crowdtime_cli-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crowdtime-cli
-Version: 0.8.2
+Version: 0.9.0
 Summary: AI-powered time tracking CLI — a modern, developer-friendly alternative to Harvest
 Project-URL: Homepage, https://crowdtime.lat
 Project-URL: Documentation, https://crowdtime.lat/docs

{crowdtime_cli-0.8.2 → crowdtime_cli-0.9.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "crowdtime-cli"
-version = "0.8.2"
+version = "0.9.0"
 description = "AI-powered time tracking CLI — a modern, developer-friendly alternative to Harvest"
 readme = "README.md"
 license = {text = "Proprietary"}

{crowdtime_cli-0.8.2 → crowdtime_cli-0.9.0}/src/crowdtime_cli/__init__.py

@@ -1,3 +1,3 @@
 """CrowdTime CLI - AI-powered time tracking from the command line."""
 
-__version__ = "0.8.2"
+__version__ = "0.9.0"

{crowdtime_cli-0.8.2 → crowdtime_cli-0.9.0}/src/crowdtime_cli/commands/invoice_cmd.py

@@ -267,6 +267,21 @@ def list_invoices(
     invoice_type: Optional[str] = typer.Option(
         None, "--type", "-t", help="Filter by type: standard, recurring, retainer."
     ),
+    date_from: Optional[str] = typer.Option(
+        None, "--from", help="Filter by issue date from (YYYY-MM-DD)."
+    ),
+    date_to: Optional[str] = typer.Option(
+        None, "--to", help="Filter by issue date to (YYYY-MM-DD)."
+    ),
+    search: Optional[str] = typer.Option(
+        None, "--search", "-q", help="Search by invoice number, subject, or client name."
+    ),
+    min_amount: Optional[float] = typer.Option(
+        None, "--min-amount", help="Filter by minimum total amount."
+    ),
+    max_amount: Optional[float] = typer.Option(
+        None, "--max-amount", help="Filter by maximum total amount."
+    ),
     output_json: bool = typer.Option(False, "--json", help="Output as JSON."),
 ) -> None:
     """List invoices in the current organization.
@@ -276,6 +291,9 @@ def list_invoices(
         ct invoice list --status sent
         ct invoice list --client <client-id> --status paid
         ct invoice list --type recurring
+        ct invoice list --from 2026-01-01 --to 2026-03-31
+        ct invoice list --search "INV-001"
+        ct invoice list --min-amount 1000 --max-amount 5000
     """
     client = CrowdTimeClient(require_auth=True, require_org=True)
 
@@ -286,6 +304,16 @@ def list_invoices(
         params["client"] = client_id
     if invoice_type:
         params["invoice_type"] = invoice_type
+    if date_from:
+        params["issue_date_from"] = date_from
+    if date_to:
+        params["issue_date_to"] = date_to
+    if search:
+        params["search"] = search
+    if min_amount is not None:
+        params["total_min"] = str(min_amount)
+    if max_amount is not None:
+        params["total_max"] = str(max_amount)
 
     try:
         data = client.get("/invoices/", params=params or None)
@@ -995,17 +1023,37 @@ def retainer_default(ctx: typer.Context) -> None:
 
 @retainer_app.command("list")
 def list_retainers(
+    status: Optional[str] = typer.Option(
+        None, "--status", "-s", help="Filter by status: pending, active, paused, completed, cancelled."
+    ),
+    client_id: Optional[str] = typer.Option(
+        None, "--client", "-c", help="Filter by client ID."
+    ),
+    search: Optional[str] = typer.Option(
+        None, "--search", "-q", help="Search by retainer name or client name."
+    ),
     output_json: bool = typer.Option(False, "--json", help="Output as JSON."),
 ) -> None:
     """List retainer agreements.
 
     Examples:
         ct invoice retainer list
+        ct invoice retainer list --status active
+        ct invoice retainer list --client <client-id>
+        ct invoice retainer list --search "Acme"
     """
     client = CrowdTimeClient(require_auth=True, require_org=True)
 
+    params: dict = {}
+    if status:
+        params["status"] = status
+    if client_id:
+        params["client"] = client_id
+    if search:
+        params["search"] = search
+
     try:
-        data = client.get("/invoices/retainers/")
+        data = client.get("/invoices/retainers/", params=params or None)
         results = data.get("results", []) if isinstance(data, dict) else data
 
         if output_json:
@@ -1020,21 +1068,22 @@ def list_retainers(
             table.add_column("Name", width=20)
             table.add_column("Client", width=18)
             table.add_column("Monthly", justify="right", width=12)
-            table.add_column("Included Hours", justify="right", width=15)
+            table.add_column("Balance", justify="right", width=12)
             table.add_column("Status", width=10)
 
             for ret in results:
-                status = ret.get("status", "active")
-                style = "green" if status == "active" else "dim"
+                ret_status = ret.get("status", "active")
+                style = "green" if ret_status == "active" else "dim"
                 currency = ret.get("currency", "USD")
+                balance = Decimal(str(ret.get("balance", 0)))
 
                 table.add_row(
                     str(ret.get("id", "")),
                     ret.get("name", ret.get("title", "")),
                     ret.get("client_name", ""),
                     _format_currency(ret.get("monthly_amount", ret.get("monthly", 0)), currency),
-                    format_duration(Decimal(str(ret.get("included_hours", 0)))),
-                    f"[{style}]{status.capitalize()}[/{style}]",
+                    f"[green]{_format_currency(balance, currency)}[/green]",
+                    f"[{style}]{ret_status.capitalize()}[/{style}]",
                 )
 
             console.print(table)

{crowdtime_cli-0.8.2 → crowdtime_cli-0.9.0}/src/crowdtime_cli/skills/crowdtime/references/commands.md

@@ -1183,13 +1183,19 @@ Endpoint: `GET /timesheets/team-overview/`
 ### ct invoice list
 
 ```
-ct invoice list [--status STATUS] [--client CLIENT] [--json]
+ct invoice list [--status STATUS] [--client CLIENT] [--type TYPE] [--from DATE] [--to DATE] [--search QUERY] [--min-amount NUM] [--max-amount NUM] [--json]
 ```
 
 | Option | Type | Description |
 |--------|------|-------------|
-| `--status` | string | Filter: `draft`, `sent`, `viewed`, `partial`, `paid`, `overdue`, `void` |
-| `--client` | string | Filter by client name or ID |
+| `--status` `-s` | string | Filter: `draft`, `sent`, `viewed`, `partial`, `paid`, `overdue`, `void` |
+| `--client` `-c` | string | Filter by client ID |
+| `--type` `-t` | string | Filter by type: `standard`, `recurring`, `retainer` |
+| `--from` | string | Filter by issue date from (YYYY-MM-DD) |
+| `--to` | string | Filter by issue date to (YYYY-MM-DD) |
+| `--search` `-q` | string | Search by invoice number, subject, or client name |
+| `--min-amount` | float | Filter by minimum total amount |
+| `--max-amount` | float | Filter by maximum total amount |
 | `--json` | flag | JSON output |
 
 Endpoint: `GET /invoices/`
@@ -1296,6 +1302,21 @@ Creates a copy of an existing invoice as a new draft. Endpoint: `POST /invoices/
 
 ---
 
+### ct invoice retainer list
+
+```
+ct invoice retainer list [--status STATUS] [--client CLIENT] [--search QUERY] [--json]
+```
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `--status` `-s` | string | Filter: `pending`, `active`, `paused`, `completed`, `cancelled` |
+| `--client` `-c` | string | Filter by client ID |
+| `--search` `-q` | string | Search by retainer name or client name |
+| `--json` | flag | JSON output |
+
+Endpoint: `GET /invoices/retainers/`
+
 ### ct invoice retainer show
 
 ```

{crowdtime_cli-0.8.2 → crowdtime_cli-0.9.0}/src/crowdtime_cli/skills/crowdtime/references/workflows.md

@@ -574,8 +574,11 @@ ct invoice show <new-invoice-id>
 ### Set Up a Retainer and Track Balance
 
 ```bash
-# 1. List retainers
+# 1. List retainers (with optional filters)
 ct invoice retainer list
+ct invoice retainer list --status active
+ct invoice retainer list --client <client-id>
+ct invoice retainer list --search "Acme"
 
 # 2. View retainer details and balance
 ct invoice retainer show <retainer-id>