janet-cli 0.2.7__py3-none-any.whl → 0.2.33__py3-none-any.whl

janet/cli.py

@@ -1,6 +1,9 @@
 """Main CLI application using Typer."""
 
+import sys
+import json
 import typer
+from typing import Optional, List
 from typing_extensions import Annotated
 
 from janet import __version__
@@ -20,11 +23,13 @@ auth_app = typer.Typer(help="Authentication commands")
 org_app = typer.Typer(help="Organization management")
 project_app = typer.Typer(help="Project management")
 config_app = typer.Typer(help="Configuration management")
+ticket_app = typer.Typer(help="Ticket management")
 
-app.add_typer(auth_app, name="auth")
-app.add_typer(org_app, name="org")
-app.add_typer(project_app, name="project")
-app.add_typer(config_app, name="config")
+app.add_typer(auth_app, name="auth", rich_help_panel="Management")
+app.add_typer(org_app, name="org", rich_help_panel="Management")
+app.add_typer(project_app, name="project", rich_help_panel="Management")
+app.add_typer(config_app, name="config", rich_help_panel="Management")
+app.add_typer(ticket_app, name="ticket", rich_help_panel="Management")
 
 # Initialize config manager
 config_manager = ConfigManager()
@@ -52,7 +57,7 @@ def main(
 # =============================================================================
 
 
-@app.command(name="login")
+@app.command(name="login", rich_help_panel="Authentication")
 def login() -> None:
     """Authenticate with Janet AI and select organization."""
     try:
@@ -106,14 +111,75 @@ def login() -> None:
 
         print_success(f"Selected organization: {selected_org['name']}")
         console.print("\n[green]✓ Authentication complete![/green]")
-        console.print("Run 'janet sync' to start syncing tickets.")
+        console.print("Run [cyan]janet sync[/cyan] to sync tickets and watch for real-time updates.")
 
     except JanetCLIError as e:
         print_error(str(e))
         raise typer.Exit(1)
 
 
-@app.command(name="logout")
+@app.command(name="update", rich_help_panel="Utilities")
+def update(
+    test_pypi: bool = typer.Option(False, "--test", help="Update from Test PyPI (for development)")
+) -> None:
+    """Update Janet CLI to the latest version."""
+    import subprocess
+    import httpx
+    from janet import __version__
+
+    console.print("[cyan]Checking for updates...[/cyan]")
+
+    try:
+        # Determine PyPI URL based on flag
+        if test_pypi:
+            pypi_url = "https://test.pypi.org/pypi/janet-cli/json"
+            index_url = "https://test.pypi.org/simple/"
+        else:
+            pypi_url = "https://pypi.org/pypi/janet-cli/json"
+            index_url = None
+
+        # Fetch latest version from PyPI
+        try:
+            response = httpx.get(pypi_url, timeout=10)
+            response.raise_for_status()
+            latest_version = response.json()["info"]["version"]
+        except Exception as e:
+            print_error(f"Failed to check for updates: {e}")
+            raise typer.Exit(1)
+
+        current_version = __version__
+
+        console.print(f"[dim]Current version: {current_version}[/dim]")
+        console.print(f"[dim]Latest version:  {latest_version}[/dim]")
+
+        # Compare versions
+        if current_version == latest_version:
+            console.print("[green]Janet CLI is already up to date.[/green]")
+            return
+
+        # Build pip command
+        pip_cmd = [sys.executable, "-m", "pip", "install", "--upgrade", "janet-cli"]
+        if index_url:
+            pip_cmd.extend(["--index-url", index_url])
+
+        console.print(f"[cyan]Updating to version {latest_version}...[/cyan]")
+
+        result = subprocess.run(pip_cmd, capture_output=True, text=True)
+
+        if result.returncode == 0:
+            console.print(f"[green]✓ Janet CLI updated to {latest_version}![/green]")
+            console.print("[dim]Restart your terminal to use the new version.[/dim]")
+        else:
+            print_error(f"Update failed: {result.stderr}")
+            raise typer.Exit(1)
+    except typer.Exit:
+        raise
+    except Exception as e:
+        print_error(f"Update failed: {e}")
+        raise typer.Exit(1)
+
+
+@app.command(name="logout", rich_help_panel="Authentication")
 def logout() -> None:
     """Clear stored credentials."""
     try:
@@ -227,9 +293,35 @@ def org_select(org_id: str) -> None:
 
         # Update config
         config = config_manager.get()
+        old_org_id = config.selected_organization.id if config.selected_organization else None
+
         config.selected_organization = OrganizationInfo(
             id=org_data["id"], name=org_data["name"], uuid=org_data.get("uuid", org_id)
         )
+
+        # Clear synced projects when switching orgs (they belong to the old org)
+        if old_org_id and old_org_id != org_data["id"]:
+            config.sync.synced_projects = []
+            config.sync.last_sync_org_id = None
+            config.sync.last_sync_total_tickets = 0
+
+            # Regenerate README with new org but empty projects (no statuses until sync)
+            from janet.utils.paths import expand_path
+            from pathlib import Path
+
+            sync_dir = expand_path(config.sync.root_directory)
+            if sync_dir.exists():
+                from janet.sync.readme_generator import ReadmeGenerator
+                readme_gen = ReadmeGenerator()
+                readme_gen.write_readme(
+                    sync_dir=sync_dir,
+                    org_name=org_data["name"],
+                    projects=[],
+                    total_tickets=0,
+                    project_statuses={},
+                )
+                print_info(f"README updated for new organization. Run 'janet sync' to sync projects.")
+
         config_manager.update(config)
 
         print_success(f"Selected organization: {org_data['name']}")
@@ -313,15 +405,17 @@ def project_list() -> None:
 # =============================================================================
 
 
-@app.command(name="sync")
+@app.command(name="sync", rich_help_panel="Syncing")
 def sync(
     directory: Annotated[str, typer.Option("--dir", "-d", help="Sync directory")] = None,
     all_projects: Annotated[bool, typer.Option("--all", help="Sync all projects")] = False,
+    no_watch: Annotated[bool, typer.Option("--no-watch", help="Exit after sync instead of watching for updates")] = False,
 ) -> None:
     """
-    Sync tickets to local markdown files.
+    Sync tickets to local markdown files and watch for real-time updates.
 
     Interactive mode: prompts for project selection and directory.
+    After syncing, stays connected for real-time updates (Ctrl+C to stop).
     """
     try:
         from janet.sync.sync_engine import SyncEngine
@@ -489,6 +583,20 @@ def sync(
             synced = sync_engine.sync_project(project["id"], project_key, project_name)
             total_tickets += synced
 
+        # Fetch project statuses (kanban columns) for each project
+        project_statuses = {}
+        try:
+            for project in selected_projects:
+                project_id = project.get("id", "")
+                project_key = project.get("project_identifier", "")
+                if project_id:
+                    columns = project_api.get_project_columns(project_id)
+                    # Extract status values in order
+                    statuses = [col.get("status_value", "") for col in sorted(columns, key=lambda x: x.get("column_order", 0))]
+                    project_statuses[project_key] = statuses
+        except Exception as e:
+            print_info(f"Note: Could not fetch project statuses: {e}")
+
         # Generate README for AI agents
         from janet.sync.readme_generator import ReadmeGenerator
         readme_gen = ReadmeGenerator()
@@ -497,8 +605,24 @@ def sync(
             org_name=org_name,
             projects=selected_projects,
             total_tickets=total_tickets,
+            project_statuses=project_statuses,
         )
 
+        # Save synced projects to config for README regeneration on org change
+        from janet.config.models import SyncedProject
+        config.sync.synced_projects = [
+            SyncedProject(
+                id=p.get("id", ""),
+                project_identifier=p.get("project_identifier", ""),
+                project_name=p.get("project_name", ""),
+                ticket_count=p.get("ticket_count", 0),
+            )
+            for p in selected_projects
+        ]
+        config.sync.last_sync_org_id = config.selected_organization.id
+        config.sync.last_sync_total_tickets = total_tickets
+        config_manager.update(config)
+
         # Show summary
         console.print(f"\n[bold green]✓ Sync complete![/bold green]")
         console.print(f"  Projects: {len(selected_projects)}")
@@ -506,6 +630,36 @@ def sync(
         console.print(f"\n[cyan]Tickets saved to: {expanded_dir}[/cyan]")
         console.print(f"[dim]README for AI agents: {readme_path}[/dim]")
 
+        # Start watch mode (default behavior, unless --no-watch)
+        if not no_watch:
+            from janet.sync.sse_watcher import SSEWatcher
+            from janet.api.organizations import OrganizationAPI
+
+            console.print(f"\n")
+
+            # Fetch org members for name resolution in SSE updates
+            org_members = None
+            try:
+                org_api = OrganizationAPI(config_manager)
+                org_id = config.selected_organization.id
+                response = org_api.get(f"/api/v1/organizations/{org_id}/members", include_org=False)
+                org_members = response.get("members", [])
+            except Exception:
+                pass  # Will fall back to emails if members can't be fetched
+
+            # Create SSE watcher
+            watcher = SSEWatcher(
+                config_manager=config_manager,
+                projects=selected_projects,
+                org_name=org_name,
+                sync_dir=str(expanded_dir),
+                org_members=org_members,
+                project_statuses=project_statuses,
+            )
+
+            # This blocks until Ctrl+C
+            watcher.watch()
+
     except JanetCLIError as e:
         print_error(str(e))
         raise typer.Exit(1)
@@ -519,7 +673,7 @@ def sync(
 # =============================================================================
 
 
-@app.command(name="status")
+@app.command(name="status", rich_help_panel="Syncing")
 def status() -> None:
     """Show overall status (auth, org, last sync)."""
     try:
@@ -598,5 +752,353 @@ def config_reset(
         raise typer.Exit(1)
 
 
+# =============================================================================
+# Ticket Commands
+# =============================================================================
+
+
+@ticket_app.command(name="create")
+def ticket_create(
+    title: Annotated[str, typer.Argument(help="Ticket title")],
+    project: Annotated[Optional[str], typer.Option("--project", "-p", help="Project key (e.g., PROJ) or ID")] = None,
+    description: Annotated[Optional[str], typer.Option("--description", "-d", help="Ticket description")] = None,
+    status: Annotated[Optional[str], typer.Option("--status", "-s", help="Status (default: To Do)")] = None,
+    priority: Annotated[Optional[str], typer.Option("--priority", help="Priority: Low, Medium, High, Critical")] = None,
+    issue_type: Annotated[Optional[str], typer.Option("--type", "-t", help="Type: Task, Bug, Story, Epic")] = None,
+    assignee: Annotated[Optional[List[str]], typer.Option("--assignee", "-a", help="Assignee email (can repeat)")] = None,
+    tag: Annotated[Optional[List[str]], typer.Option("--tag", help="Tag (can repeat)")] = None,
+    output_json: Annotated[bool, typer.Option("--json", help="Output as JSON")] = False,
+) -> None:
+    """
+    Create a new ticket.
+
+    Examples:
+        janet ticket create "Fix login bug" -p PROJ
+        janet ticket create "Add feature" -p PROJ -d "Details here" --priority High
+        echo "Description" | janet ticket create "Title" -p PROJ
+    """
+    try:
+        from janet.api.tickets import TicketAPI
+        from janet.api.projects import ProjectAPI
+
+        if not config_manager.is_authenticated():
+            print_error("Not authenticated. Run 'janet login' first.")
+            raise typer.Exit(1)
+
+        if not config_manager.has_organization():
+            print_error("No organization selected. Run 'janet org select' first.")
+            raise typer.Exit(1)
+
+        # Get project list
+        project_api = ProjectAPI(config_manager)
+        projects = project_api.list_projects()
+
+        if not projects:
+            print_error("No projects found in organization")
+            raise typer.Exit(1)
+
+        # Resolve project
+        project_id = None
+        project_key = None
+
+        if project:
+            # Try to match by key or ID
+            for p in projects:
+                if p.get("project_identifier", "").upper() == project.upper():
+                    project_id = p["id"]
+                    project_key = p["project_identifier"]
+                    break
+                if p.get("id") == project:
+                    project_id = p["id"]
+                    project_key = p.get("project_identifier", "")
+                    break
+
+            if not project_id:
+                print_error(f"Project '{project}' not found")
+                raise typer.Exit(1)
+        else:
+            # Interactive project selection
+            if not sys.stdin.isatty():
+                print_error("--project is required for non-interactive use")
+                raise typer.Exit(1)
+
+            from InquirerPy import inquirer
+
+            console.print("\n[bold]Select a project:[/bold]\n")
+
+            choices = []
+            for p in projects:
+                key = p.get("project_identifier", "")
+                name = p.get("project_name", "")
+                count = p.get("ticket_count", 0)
+                label_text = f"{key:8s} - {name} ({count} tickets)"
+                choices.append({"name": label_text, "value": p})
+
+            selected = inquirer.select(
+                message="Project:",
+                choices=choices,
+            ).execute()
+
+            project_id = selected["id"]
+            project_key = selected.get("project_identifier", "")
+
+        # Check for piped stdin for description
+        final_description = description
+        if not sys.stdin.isatty() and not description:
+            # Read from stdin
+            stdin_content = sys.stdin.read().strip()
+            if stdin_content:
+                final_description = stdin_content
+
+        # Create ticket
+        ticket_api = TicketAPI(config_manager)
+        result = ticket_api.create_ticket(
+            project_id=project_id,
+            title=title,
+            description=final_description,
+            status=status or "To Do",
+            priority=priority,
+            issue_type=issue_type,
+            assignees=assignee,
+            labels=tag,
+        )
+
+        ticket_key_result = result.get("ticket_key", f"{project_key}-{result.get('ticket_identifier', '?')}")
+
+        if output_json:
+            output = {
+                "success": True,
+                "ticket_id": result.get("ticket_id"),
+                "ticket_key": ticket_key_result,
+                "title": title,
+                "project_key": project_key,
+            }
+            console.print(json.dumps(output, indent=2))
+        else:
+            print_success(f"Created {ticket_key_result}: {title}")
+
+    except JanetCLIError as e:
+        if output_json:
+            console.print(json.dumps({"success": False, "error": str(e)}))
+        else:
+            print_error(str(e))
+        raise typer.Exit(1)
+    except Exception as e:
+        if output_json:
+            console.print(json.dumps({"success": False, "error": str(e)}))
+        else:
+            print_error(f"Failed to create ticket: {e}")
+        raise typer.Exit(1)
+
+
+@ticket_app.command(name="update")
+def ticket_update(
+    ticket_key: Annotated[str, typer.Argument(help="Ticket key (e.g., PROJ-123) or ticket ID")],
+    title: Annotated[Optional[str], typer.Option("--title", help="New title")] = None,
+    description: Annotated[Optional[str], typer.Option("--description", "-d", help="New description")] = None,
+    status: Annotated[Optional[str], typer.Option("--status", "-s", help="New status")] = None,
+    priority: Annotated[Optional[str], typer.Option("--priority", help="New priority: Low, Medium, High, Critical")] = None,
+    issue_type: Annotated[Optional[str], typer.Option("--type", "-t", help="New type: Task, Bug, Story, Epic")] = None,
+    assignee: Annotated[Optional[List[str]], typer.Option("--assignee", "-a", help="New assignee email (can repeat, replaces all)")] = None,
+    tag: Annotated[Optional[List[str]], typer.Option("--tag", help="New tag (can repeat, replaces all)")] = None,
+    due_date: Annotated[Optional[str], typer.Option("--due-date", help="New due date (YYYY-MM-DD)")] = None,
+    output_json: Annotated[bool, typer.Option("--json", help="Output as JSON")] = False,
+) -> None:
+    """
+    Update an existing ticket.
+
+    Examples:
+        janet ticket update PROJ-123 --status "In Progress"
+        janet ticket update PROJ-123 --title "New title" --priority High
+        janet ticket update PROJ-123 -a user@example.com -a user2@example.com
+    """
+    try:
+        from janet.api.tickets import TicketAPI
+        from janet.api.projects import ProjectAPI
+
+        if not config_manager.is_authenticated():
+            print_error("Not authenticated. Run 'janet login' first.")
+            raise typer.Exit(1)
+
+        if not config_manager.has_organization():
+            print_error("No organization selected. Run 'janet org select' first.")
+            raise typer.Exit(1)
+
+        # Resolve ticket_key to ticket_id
+        ticket_id = None
+        resolved_ticket_key = ticket_key
+
+        # Check if it looks like a UUID (ticket ID)
+        if "-" in ticket_key and len(ticket_key) == 36:
+            ticket_id = ticket_key
+        else:
+            # It's a ticket key like PROJ-123, need to find the ticket ID
+            # Parse project key and ticket number
+            parts = ticket_key.upper().rsplit("-", 1)
+            if len(parts) != 2:
+                print_error(f"Invalid ticket key format: {ticket_key}. Expected format: PROJ-123")
+                raise typer.Exit(1)
+
+            project_key, ticket_num = parts
+
+            # Get project list to find the project
+            project_api = ProjectAPI(config_manager)
+            projects = project_api.list_projects()
+
+            project_id = None
+            for p in projects:
+                if p.get("project_identifier", "").upper() == project_key:
+                    project_id = p["id"]
+                    break
+
+            if not project_id:
+                print_error(f"Project '{project_key}' not found")
+                raise typer.Exit(1)
+
+            # Fetch tickets from project to find the one with matching identifier
+            ticket_api = TicketAPI(config_manager)
+            sync_result = ticket_api.sync_all_tickets(project_id)
+            tickets = sync_result.get("tickets", [])
+
+            for t in tickets:
+                if str(t.get("ticket_identifier")) == ticket_num:
+                    ticket_id = t["id"]
+                    break
+
+            if not ticket_id:
+                print_error(f"Ticket '{ticket_key}' not found")
+                raise typer.Exit(1)
+
+        # Check if any update field was provided
+        if not any([title, description, status, priority, issue_type, assignee, tag, due_date]):
+            print_error("No update fields provided. Use --help to see available options.")
+            raise typer.Exit(1)
+
+        # Update ticket
+        ticket_api = TicketAPI(config_manager)
+        result = ticket_api.update_ticket(
+            ticket_id=ticket_id,
+            title=title,
+            description=description,
+            status=status,
+            priority=priority,
+            issue_type=issue_type,
+            assignees=assignee,
+            labels=tag,
+            due_date=due_date,
+        )
+
+        if output_json:
+            output = {
+                "success": True,
+                "ticket_key": resolved_ticket_key,
+                "ticket_id": ticket_id,
+                "updated_fields": result.get("updated_fields", []),
+            }
+            console.print(json.dumps(output, indent=2))
+        else:
+            updated = result.get("updated_fields", [])
+            if updated:
+                print_success(f"Updated {resolved_ticket_key}: {', '.join(updated)}")
+            else:
+                print_success(f"Updated {resolved_ticket_key}")
+
+    except JanetCLIError as e:
+        if output_json:
+            console.print(json.dumps({"success": False, "error": str(e)}))
+        else:
+            print_error(str(e))
+        raise typer.Exit(1)
+    except Exception as e:
+        if output_json:
+            console.print(json.dumps({"success": False, "error": str(e)}))
+        else:
+            print_error(f"Failed to update ticket: {e}")
+        raise typer.Exit(1)
+
+
+# =============================================================================
+# Context Command (for AI agents)
+# =============================================================================
+
+
+@app.command(name="context", rich_help_panel="Syncing")
+def context(
+    output_json: Annotated[bool, typer.Option("--json", help="Output as JSON")] = False,
+) -> None:
+    """
+    Show current context (org, projects) for AI agents.
+
+    Use --json for machine-readable output.
+    """
+    try:
+        from janet.api.projects import ProjectAPI
+
+        config = config_manager.get()
+
+        context_data = {
+            "authenticated": config_manager.is_authenticated(),
+            "user_email": config.auth.user_email if config.auth else None,
+            "organization": None,
+            "projects": [],
+        }
+
+        if config_manager.is_authenticated() and config.selected_organization:
+            context_data["organization"] = {
+                "id": config.selected_organization.id,
+                "name": config.selected_organization.name,
+                "uuid": config.selected_organization.uuid,
+            }
+
+            # Fetch projects
+            if config_manager.has_organization():
+                try:
+                    project_api = ProjectAPI(config_manager)
+                    projects = project_api.list_projects()
+                    context_data["projects"] = [
+                        {
+                            "id": p.get("id"),
+                            "key": p.get("project_identifier"),
+                            "name": p.get("project_name"),
+                            "ticket_count": p.get("ticket_count", 0),
+                        }
+                        for p in projects
+                    ]
+                except Exception:
+                    pass  # Projects fetch failed, leave empty
+
+        if output_json:
+            console.print(json.dumps(context_data, indent=2))
+        else:
+            console.print("[bold]Janet CLI Context[/bold]\n")
+
+            if not context_data["authenticated"]:
+                console.print("[yellow]Not authenticated[/yellow]")
+                console.print("Run 'janet login' to authenticate")
+                return
+
+            console.print(f"[green]✓ Authenticated[/green] as {context_data['user_email']}")
+
+            if context_data["organization"]:
+                console.print(f"[green]✓ Organization:[/green] {context_data['organization']['name']}")
+            else:
+                console.print("[yellow]No organization selected[/yellow]")
+                return
+
+            if context_data["projects"]:
+                console.print(f"\n[bold]Projects ({len(context_data['projects'])}):[/bold]")
+                for p in context_data["projects"]:
+                    console.print(f"  • {p['key']:8s} - {p['name']} ({p['ticket_count']} tickets)")
+            else:
+                console.print("\n[dim]No projects found[/dim]")
+
+    except JanetCLIError as e:
+        if output_json:
+            console.print(json.dumps({"authenticated": False, "error": str(e)}))
+        else:
+            print_error(str(e))
+        raise typer.Exit(1)
+
+
 if __name__ == "__main__":
     app()

janet/config/models.py

@@ -2,7 +2,7 @@
 
 import os
 from datetime import datetime
-from typing import Dict, Optional
+from typing import Dict, List, Optional
 from pydantic import BaseModel, Field
 
 
@@ -37,6 +37,15 @@ class APIConfig(BaseModel):
     timeout: int = 30
 
 
+class SyncedProject(BaseModel):
+    """Information about a synced project."""
+
+    id: str
+    project_identifier: str
+    project_name: str
+    ticket_count: int = 0
+
+
 class SyncConfig(BaseModel):
     """Sync configuration."""
 
@@ -44,6 +53,9 @@ class SyncConfig(BaseModel):
     last_sync_times: Dict[str, str] = Field(default_factory=dict)
     sync_on_init: bool = False
     batch_size: int = 50
+    synced_projects: List[SyncedProject] = Field(default_factory=list)
+    last_sync_org_id: Optional[str] = None
+    last_sync_total_tickets: int = 0
 
 
 class MarkdownConfig(BaseModel):