bumblebee-cli 0.1.0 → 0.2.0

package/python/bb_cli/commands/item.py

@@ -1,192 +1,192 @@
-import re
-
-import typer
-from rich import print as rprint
-from rich.table import Table
-
-from ..api_client import api_get, api_post, api_put
-from ..config import get_current_project
-
-app = typer.Typer(help="Work item management")
-
-
-def _require_project() -> str:
-    slug = get_current_project()
-    if not slug:
-        rprint("[red]No project selected. Run [bold]bb project switch <slug>[/bold] first.[/red]")
-        raise typer.Exit(1)
-    return slug
-
-
-def _resolve_item(slug: str, id_or_number: str) -> dict:
-    """Resolve a work item by UUID, number, or KEY-number format."""
-    # UUID format
-    if len(id_or_number) > 8 and "-" in id_or_number:
-        return api_get(f"/api/work-items/{id_or_number}")
-
-    # KEY-number format (e.g. BB-42) or plain integer
-    match = re.match(r"^(?:[A-Za-z]+-)?(\d+)$", id_or_number)
-    if match:
-        number = int(match.group(1))
-        return api_get(f"/api/projects/{slug}/work-items/by-number/{number}")
-
-    rprint(f"[red]Invalid identifier: {id_or_number}. Use UUID, number, or KEY-number (e.g. BB-42).[/red]")
-    raise typer.Exit(1)
-
-
-@app.command(name="list")
-def list_items(
-    type: str = typer.Option(None, "-t", "--type", help="Filter by type (story, task, epic, bug...)"),
-    status: str = typer.Option(None, "-s", "--status", help="Filter by status"),
-    parent: str = typer.Option(None, "--parent", help="Filter by parent ID"),
-    assignee: str = typer.Option(None, "-a", "--assignee", help="Filter by assignee"),
-):
-    """List work items in the current project."""
-    slug = _require_project()
-    params = {}
-    if type:
-        params["type"] = type
-    if status:
-        params["status"] = status
-    if parent:
-        params["parent_id"] = parent
-    if assignee:
-        params["assignee"] = assignee
-    items = api_get(f"/api/projects/{slug}/work-items", params=params)
-    table = Table(title=f"Work Items - {slug}")
-    table.add_column("#", style="cyan", justify="right")
-    table.add_column("Type", style="magenta")
-    table.add_column("Title")
-    table.add_column("Status", style="green")
-    table.add_column("Priority")
-    table.add_column("Assignee")
-    for item in items:
-        key = item.get("key") or str(item["number"])
-        table.add_row(
-            key,
-            item["type"],
-            item["title"],
-            item["status"],
-            item["priority"],
-            item.get("assignee") or "-",
-        )
-    rprint(table)
-
-
-@app.command()
-def create(
-    title: str = typer.Argument(...),
-    type: str = typer.Option("story", "-t", "--type", help="Item type: story, task, epic, bug, feature, chore, spike"),
-    description: str = typer.Option(None, "-d", "--description"),
-    priority: str = typer.Option("medium", "-p", "--priority"),
-    parent: str = typer.Option(None, "--parent", help="Parent item ID or number"),
-):
-    """Create a new work item."""
-    slug = _require_project()
-    data: dict = {"title": title, "type": type, "priority": priority}
-    if description:
-        data["description"] = description
-    if parent:
-        # Resolve parent to UUID
-        parent_item = _resolve_item(slug, parent)
-        data["parent_id"] = parent_item["id"]
-    item = api_post(f"/api/projects/{slug}/work-items", json=data)
-    key = item.get("key") or f"#{item['number']}"
-    rprint(f"[green]Created {item['type']} {key}: {item['title']}[/green]")
-
-
-@app.command()
-def show(id_or_number: str = typer.Argument(..., help="UUID, number, or KEY-number (e.g. BB-42)")):
-    """Show work item details."""
-    slug = _require_project()
-    item = _resolve_item(slug, id_or_number)
-    key = item.get("key") or f"#{item['number']}"
-    rprint(f"[bold]{key}[/bold] [{item['type']}] {item['title']}")
-    rprint(f"Status: {item['status']}  |  Priority: {item['priority']}")
-    if item.get("assignee"):
-        rprint(f"Assignee: {item['assignee']}")
-    if item.get("parent_id"):
-        rprint(f"Parent: {item['parent_id']}")
-    if item.get("sprint_id"):
-        rprint(f"Sprint: {item['sprint_id']}")
-    if item.get("story_points"):
-        rprint(f"Points: {item['story_points']}")
-    if item.get("description"):
-        rprint(f"\n{item['description']}")
-    if item.get("acceptance_criteria"):
-        rprint(f"\n[bold]Acceptance Criteria:[/bold]\n{item['acceptance_criteria']}")
-    if item.get("plan"):
-        rprint(f"\n[bold]Plan:[/bold]\n{item['plan']}")
-    if item.get("ai_summary"):
-        rprint(f"\n[bold]AI Summary:[/bold]\n{item['ai_summary']}")
-
-
-@app.command()
-def update(
-    id_or_number: str = typer.Argument(..., help="UUID, number, or KEY-number"),
-    status: str = typer.Option(None, "-s", "--status"),
-    assignee: str = typer.Option(None, "-a", "--assignee"),
-    priority: str = typer.Option(None, "-p", "--priority"),
-    title: str = typer.Option(None, "--title"),
-    type: str = typer.Option(None, "-t", "--type"),
-):
-    """Update a work item."""
-    slug = _require_project()
-    item = _resolve_item(slug, id_or_number)
-    data = {}
-    if status:
-        data["status"] = status
-    if assignee:
-        data["assignee"] = assignee
-    if priority:
-        data["priority"] = priority
-    if title:
-        data["title"] = title
-    if type:
-        data["type"] = type
-    if not data:
-        rprint("[yellow]Nothing to update.[/yellow]")
-        raise typer.Exit()
-    updated = api_put(f"/api/work-items/{item['id']}", json=data)
-    key = updated.get("key") or f"#{updated['number']}"
-    rprint(f"[green]Updated {key}[/green]")
-
-
-@app.command()
-def assign(
-    id_or_number: str = typer.Argument(..., help="UUID, number, or KEY-number"),
-    assignee: str = typer.Argument(...),
-):
-    """Assign a work item to someone."""
-    slug = _require_project()
-    item = _resolve_item(slug, id_or_number)
-    updated = api_put(f"/api/work-items/{item['id']}", json={"assignee": assignee})
-    key = updated.get("key") or f"#{updated['number']}"
-    rprint(f"[green]{key} assigned to {assignee}[/green]")
-
-
-@app.command()
-def children(id_or_number: str = typer.Argument(..., help="UUID, number, or KEY-number")):
-    """List children of a work item."""
-    slug = _require_project()
-    item = _resolve_item(slug, id_or_number)
-    kids = api_get(f"/api/work-items/{item['id']}/children")
-    if not kids:
-        rprint("[dim]No children.[/dim]")
-        return
-    table = Table(title=f"Children of {item.get('key') or '#' + str(item['number'])}")
-    table.add_column("#", style="cyan", justify="right")
-    table.add_column("Type", style="magenta")
-    table.add_column("Title")
-    table.add_column("Status", style="green")
-    table.add_column("Assignee")
-    for kid in kids:
-        key = kid.get("key") or str(kid["number"])
-        table.add_row(
-            key,
-            kid["type"],
-            kid["title"],
-            kid["status"],
-            kid.get("assignee") or "-",
-        )
-    rprint(table)
+import re
+
+import typer
+from rich import print as rprint
+from rich.table import Table
+
+from ..api_client import api_get, api_post, api_put
+from ..config import get_current_project
+
+app = typer.Typer(help="Work item management")
+
+
+def _require_project() -> str:
+    slug = get_current_project()
+    if not slug:
+        rprint("[red]No project selected. Run [bold]bb project switch <slug>[/bold] first.[/red]")
+        raise typer.Exit(1)
+    return slug
+
+
+def _resolve_item(slug: str, id_or_number: str) -> dict:
+    """Resolve a work item by UUID, number, or KEY-number format."""
+    # UUID format
+    if len(id_or_number) > 8 and "-" in id_or_number:
+        return api_get(f"/api/work-items/{id_or_number}")
+
+    # KEY-number format (e.g. BB-42) or plain integer
+    match = re.match(r"^(?:[A-Za-z]+-)?(\d+)$", id_or_number)
+    if match:
+        number = int(match.group(1))
+        return api_get(f"/api/projects/{slug}/work-items/by-number/{number}")
+
+    rprint(f"[red]Invalid identifier: {id_or_number}. Use UUID, number, or KEY-number (e.g. BB-42).[/red]")
+    raise typer.Exit(1)
+
+
+@app.command(name="list")
+def list_items(
+    type: str = typer.Option(None, "-t", "--type", help="Filter by type (story, task, epic, bug...)"),
+    status: str = typer.Option(None, "-s", "--status", help="Filter by status"),
+    parent: str = typer.Option(None, "--parent", help="Filter by parent ID"),
+    assignee: str = typer.Option(None, "-a", "--assignee", help="Filter by assignee"),
+):
+    """List work items in the current project."""
+    slug = _require_project()
+    params = {}
+    if type:
+        params["type"] = type
+    if status:
+        params["status"] = status
+    if parent:
+        params["parent_id"] = parent
+    if assignee:
+        params["assignee"] = assignee
+    items = api_get(f"/api/projects/{slug}/work-items", params=params)
+    table = Table(title=f"Work Items - {slug}")
+    table.add_column("#", style="cyan", justify="right")
+    table.add_column("Type", style="magenta")
+    table.add_column("Title")
+    table.add_column("Status", style="green")
+    table.add_column("Priority")
+    table.add_column("Assignee")
+    for item in items:
+        key = item.get("key") or str(item["number"])
+        table.add_row(
+            key,
+            item["type"],
+            item["title"],
+            item["status"],
+            item["priority"],
+            item.get("assignee") or "-",
+        )
+    rprint(table)
+
+
+@app.command()
+def create(
+    title: str = typer.Argument(...),
+    type: str = typer.Option("story", "-t", "--type", help="Item type: story, task, epic, bug, feature, chore, spike"),
+    description: str = typer.Option(None, "-d", "--description"),
+    priority: str = typer.Option("medium", "-p", "--priority"),
+    parent: str = typer.Option(None, "--parent", help="Parent item ID or number"),
+):
+    """Create a new work item."""
+    slug = _require_project()
+    data: dict = {"title": title, "type": type, "priority": priority}
+    if description:
+        data["description"] = description
+    if parent:
+        # Resolve parent to UUID
+        parent_item = _resolve_item(slug, parent)
+        data["parent_id"] = parent_item["id"]
+    item = api_post(f"/api/projects/{slug}/work-items", json=data)
+    key = item.get("key") or f"#{item['number']}"
+    rprint(f"[green]Created {item['type']} {key}: {item['title']}[/green]")
+
+
+@app.command()
+def show(id_or_number: str = typer.Argument(..., help="UUID, number, or KEY-number (e.g. BB-42)")):
+    """Show work item details."""
+    slug = _require_project()
+    item = _resolve_item(slug, id_or_number)
+    key = item.get("key") or f"#{item['number']}"
+    rprint(f"[bold]{key}[/bold] [{item['type']}] {item['title']}")
+    rprint(f"Status: {item['status']}  |  Priority: {item['priority']}")
+    if item.get("assignee"):
+        rprint(f"Assignee: {item['assignee']}")
+    if item.get("parent_id"):
+        rprint(f"Parent: {item['parent_id']}")
+    if item.get("sprint_id"):
+        rprint(f"Sprint: {item['sprint_id']}")
+    if item.get("story_points"):
+        rprint(f"Points: {item['story_points']}")
+    if item.get("description"):
+        rprint(f"\n{item['description']}")
+    if item.get("acceptance_criteria"):
+        rprint(f"\n[bold]Acceptance Criteria:[/bold]\n{item['acceptance_criteria']}")
+    if item.get("plan"):
+        rprint(f"\n[bold]Plan:[/bold]\n{item['plan']}")
+    if item.get("ai_summary"):
+        rprint(f"\n[bold]AI Summary:[/bold]\n{item['ai_summary']}")
+
+
+@app.command()
+def update(
+    id_or_number: str = typer.Argument(..., help="UUID, number, or KEY-number"),
+    status: str = typer.Option(None, "-s", "--status"),
+    assignee: str = typer.Option(None, "-a", "--assignee"),
+    priority: str = typer.Option(None, "-p", "--priority"),
+    title: str = typer.Option(None, "--title"),
+    type: str = typer.Option(None, "-t", "--type"),
+):
+    """Update a work item."""
+    slug = _require_project()
+    item = _resolve_item(slug, id_or_number)
+    data = {}
+    if status:
+        data["status"] = status
+    if assignee:
+        data["assignee"] = assignee
+    if priority:
+        data["priority"] = priority
+    if title:
+        data["title"] = title
+    if type:
+        data["type"] = type
+    if not data:
+        rprint("[yellow]Nothing to update.[/yellow]")
+        raise typer.Exit()
+    updated = api_put(f"/api/work-items/{item['id']}", json=data)
+    key = updated.get("key") or f"#{updated['number']}"
+    rprint(f"[green]Updated {key}[/green]")
+
+
+@app.command()
+def assign(
+    id_or_number: str = typer.Argument(..., help="UUID, number, or KEY-number"),
+    assignee: str = typer.Argument(...),
+):
+    """Assign a work item to someone."""
+    slug = _require_project()
+    item = _resolve_item(slug, id_or_number)
+    updated = api_put(f"/api/work-items/{item['id']}", json={"assignee": assignee})
+    key = updated.get("key") or f"#{updated['number']}"
+    rprint(f"[green]{key} assigned to {assignee}[/green]")
+
+
+@app.command()
+def children(id_or_number: str = typer.Argument(..., help="UUID, number, or KEY-number")):
+    """List children of a work item."""
+    slug = _require_project()
+    item = _resolve_item(slug, id_or_number)
+    kids = api_get(f"/api/work-items/{item['id']}/children")
+    if not kids:
+        rprint("[dim]No children.[/dim]")
+        return
+    table = Table(title=f"Children of {item.get('key') or '#' + str(item['number'])}")
+    table.add_column("#", style="cyan", justify="right")
+    table.add_column("Type", style="magenta")
+    table.add_column("Title")
+    table.add_column("Status", style="green")
+    table.add_column("Assignee")
+    for kid in kids:
+        key = kid.get("key") or str(kid["number"])
+        table.add_row(
+            key,
+            kid["type"],
+            kid["title"],
+            kid["status"],
+            kid.get("assignee") or "-",
+        )
+    rprint(table)