emdash-cli 0.1.4__py3-none-any.whl

emdash_cli/commands/projectmd.py

@@ -0,0 +1,51 @@
+"""PROJECT.md generation CLI command."""
+
+import click
+from rich.console import Console
+
+from ..client import EmdashClient
+from ..server_manager import get_server_manager
+from ..sse_renderer import SSERenderer
+
+console = Console()
+
+
+@click.command("projectmd")
+@click.option("--output", "-o", default="PROJECT.md", help="Output file path")
+@click.option("--save/--no-save", default=True, help="Save to file")
+@click.option("--model", "-m", default=None, help="Model to use")
+@click.option("--quiet", "-q", is_flag=True, help="Hide exploration progress")
+def projectmd(output: str, save: bool, model: str, quiet: bool):
+    """Generate PROJECT.md by exploring the codebase.
+
+    Uses AI to analyze the code graph and generate a comprehensive
+    project document that describes architecture, patterns, and
+    key components.
+
+    Examples:
+        emdash projectmd
+        emdash projectmd --output docs/PROJECT.md
+        emdash projectmd --model gpt-4
+    """
+    server = get_server_manager()
+    client = EmdashClient(server.get_server_url())
+    renderer = SSERenderer(console=console, verbose=not quiet)
+
+    try:
+        console.print("[cyan]Generating PROJECT.md...[/cyan]")
+        console.print()
+
+        stream = client.projectmd_generate_stream(
+            output=output,
+            save=save,
+            model=model,
+        )
+        result = renderer.render_stream(stream)
+
+        if save:
+            console.print()
+            console.print(f"[green]Saved to {output}[/green]")
+
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        raise click.Abort()

emdash_cli/commands/research.py

@@ -0,0 +1,47 @@
+"""Research CLI command."""
+
+import click
+from rich.console import Console
+
+from ..client import EmdashClient
+from ..server_manager import get_server_manager
+from ..sse_renderer import SSERenderer
+
+console = Console()
+
+
+@click.command("research")
+@click.argument("goal")
+@click.option("--max-iterations", default=10, help="Maximum research iterations")
+@click.option("--budget", default=50, help="Token budget (in thousands)")
+@click.option("--model", "-m", default=None, help="Model to use")
+@click.option("--quiet", "-q", is_flag=True, help="Hide progress output")
+def research(goal: str, max_iterations: int, budget: int, model: str, quiet: bool):
+    """Deep research with multi-LLM loops and critic evaluation.
+
+    Performs iterative research on a goal, using a planner, researcher,
+    and critic to synthesize comprehensive answers.
+
+    Examples:
+        emdash research "How does authentication work?"
+        emdash research "What are the main API endpoints?" --max-iterations 15
+    """
+    server = get_server_manager()
+    client = EmdashClient(server.get_server_url())
+    renderer = SSERenderer(console=console, verbose=not quiet)
+
+    try:
+        console.print(f"[cyan]Researching: {goal}[/cyan]")
+        console.print()
+
+        stream = client.research_stream(
+            goal=goal,
+            max_iterations=max_iterations,
+            budget=budget,
+            model=model,
+        )
+        renderer.render_stream(stream)
+
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        raise click.Abort()

emdash_cli/commands/rules.py

@@ -0,0 +1,93 @@
+"""Rules/templates management CLI commands."""
+
+import click
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+
+from ..client import EmdashClient
+from ..server_manager import get_server_manager
+
+console = Console()
+
+
+@click.group()
+def rules():
+    """Manage .emdash-rules templates."""
+    pass
+
+
+@rules.command("init")
+@click.option("--global", "global_", is_flag=True, help="Save to ~/.emdash-rules instead of ./.emdash-rules")
+@click.option("--force", is_flag=True, help="Overwrite existing templates")
+def rules_init(global_: bool, force: bool):
+    """Initialize custom templates in .emdash-rules directory."""
+    server = get_server_manager()
+    client = EmdashClient(server.get_server_url())
+
+    try:
+        result = client.rules_init(global_templates=global_, force=force)
+
+        if result.get("success"):
+            path = result.get("path")
+            templates = result.get("templates", [])
+            console.print(f"[green]Templates initialized at {path}[/green]")
+            console.print(f"[dim]Copied {len(templates)} templates[/dim]")
+        else:
+            console.print(f"[red]Error: {result.get('error')}[/red]")
+
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        raise click.Abort()
+
+
+@rules.command("show")
+@click.argument("template", type=click.Choice(["spec", "tasks", "project", "focus", "pr-review"]))
+def rules_show(template: str):
+    """Show the active template and its source."""
+    server = get_server_manager()
+    client = EmdashClient(server.get_server_url())
+
+    try:
+        result = client.rules_get(template)
+
+        source = result.get("source", "unknown")
+        content = result.get("content", "")
+
+        console.print(Panel(
+            content,
+            title=f"[cyan]{template}[/cyan] [dim]({source})[/dim]",
+            border_style="dim",
+        ))
+
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        raise click.Abort()
+
+
+@rules.command("list")
+def rules_list():
+    """List all templates and their active sources."""
+    server = get_server_manager()
+    client = EmdashClient(server.get_server_url())
+
+    try:
+        templates = client.rules_list()
+
+        table = Table(title="Templates")
+        table.add_column("Name", style="cyan")
+        table.add_column("Source")
+        table.add_column("Description")
+
+        for t in templates:
+            table.add_row(
+                t.get("name", ""),
+                t.get("source", ""),
+                t.get("description", ""),
+            )
+
+        console.print(table)
+
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        raise click.Abort()

emdash_cli/commands/search.py

@@ -0,0 +1,56 @@
+"""Search CLI command."""
+
+import click
+from rich.console import Console
+from rich.table import Table
+
+from ..client import EmdashClient
+from ..server_manager import get_server_manager
+
+console = Console()
+
+
+@click.command("search")
+@click.argument("query")
+@click.option("--semantic/--text", default=True, help="Use semantic search (default) or text search")
+@click.option("--limit", default=20, help="Maximum results")
+def search(query: str, semantic: bool, limit: int):
+    """Search codebase by semantic similarity or text.
+
+    Examples:
+        emdash search "authentication flow"
+        emdash search "login" --text
+        emdash search "error handling" --limit 10
+    """
+    server = get_server_manager()
+    client = EmdashClient(server.get_server_url())
+
+    try:
+        search_type = "semantic" if semantic else "text"
+        result = client.search(query=query, search_type=search_type, limit=limit)
+
+        results = result.get("results", [])
+
+        if not results:
+            console.print("[yellow]No results found[/yellow]")
+            return
+
+        table = Table(title=f"Search Results ({len(results)})")
+        table.add_column("Score", justify="right", style="dim")
+        table.add_column("Type")
+        table.add_column("Name", style="cyan")
+        table.add_column("File")
+
+        for r in results:
+            table.add_row(
+                f"{r.get('score', 0):.3f}",
+                r.get("type", ""),
+                r.get("name", ""),
+                r.get("file", ""),
+            )
+
+        console.print(table)
+
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        raise click.Abort()

emdash_cli/commands/server.py

@@ -0,0 +1,117 @@
+"""Server management commands."""
+
+import os
+import signal
+import subprocess
+from pathlib import Path
+
+import click
+from rich.console import Console
+
+console = Console()
+
+
+@click.group()
+def server():
+    """Manage the emdash-core server."""
+    pass
+
+
+@server.command("killall")
+def server_killall():
+    """Kill all running emdash servers.
+
+    Example:
+        emdash server killall
+    """
+    killed = 0
+
+    # Kill by PID file first
+    pid_file = Path.home() / ".emdash" / "server.pid"
+    if pid_file.exists():
+        try:
+            pid = int(pid_file.read_text().strip())
+            os.kill(pid, signal.SIGTERM)
+            console.print(f"[green]Killed server process {pid}[/green]")
+            killed += 1
+        except (ValueError, ProcessLookupError, PermissionError):
+            pass
+        finally:
+            pid_file.unlink(missing_ok=True)
+
+    # Clean up port file
+    port_file = Path.home() / ".emdash" / "server.port"
+    if port_file.exists():
+        port_file.unlink(missing_ok=True)
+
+    # Kill any remaining emdash_core.server processes
+    try:
+        result = subprocess.run(
+            ["pgrep", "-f", "emdash_core.server"],
+            capture_output=True,
+            text=True,
+        )
+        if result.returncode == 0:
+            pids = result.stdout.strip().split("\n")
+            for pid_str in pids:
+                if pid_str:
+                    try:
+                        pid = int(pid_str)
+                        os.kill(pid, signal.SIGTERM)
+                        console.print(f"[green]Killed server process {pid}[/green]")
+                        killed += 1
+                    except (ValueError, ProcessLookupError, PermissionError):
+                        pass
+    except FileNotFoundError:
+        # pgrep not available, try pkill
+        subprocess.run(
+            ["pkill", "-f", "emdash_core.server"],
+            capture_output=True,
+        )
+
+    if killed > 0:
+        console.print(f"\n[bold green]Killed {killed} server(s)[/bold green]")
+    else:
+        console.print("[yellow]No running servers found[/yellow]")
+
+
+@server.command("status")
+def server_status():
+    """Show server status.
+
+    Example:
+        emdash server status
+    """
+    port_file = Path.home() / ".emdash" / "server.port"
+    pid_file = Path.home() / ".emdash" / "server.pid"
+
+    if not port_file.exists():
+        console.print("[yellow]No server running[/yellow]")
+        return
+
+    try:
+        port = int(port_file.read_text().strip())
+    except (ValueError, IOError):
+        console.print("[yellow]No server running (invalid port file)[/yellow]")
+        return
+
+    # Check if server is responsive
+    import httpx
+    try:
+        response = httpx.get(f"http://localhost:{port}/api/health", timeout=2.0)
+        if response.status_code == 200:
+            pid = "unknown"
+            if pid_file.exists():
+                try:
+                    pid = pid_file.read_text().strip()
+                except IOError:
+                    pass
+
+            console.print(f"[bold green]Server running[/bold green]")
+            console.print(f"  Port: {port}")
+            console.print(f"  PID: {pid}")
+            console.print(f"  URL: http://localhost:{port}")
+        else:
+            console.print(f"[yellow]Server on port {port} not healthy[/yellow]")
+    except (httpx.RequestError, httpx.TimeoutException):
+        console.print(f"[yellow]Server on port {port} not responding[/yellow]")

emdash_cli/commands/spec.py

@@ -0,0 +1,49 @@
+"""Spec generation CLI command."""
+
+import click
+from rich.console import Console
+
+from ..client import EmdashClient
+from ..server_manager import get_server_manager
+from ..sse_renderer import SSERenderer
+
+console = Console()
+
+
+@click.command("spec")
+@click.argument("feature")
+@click.option("--save", is_flag=True, help="Save spec to specs/<feature>/")
+@click.option("--model", "-m", default=None, help="Model to use")
+@click.option("--quiet", "-q", is_flag=True, help="Hide exploration progress")
+def spec(feature: str, save: bool, model: str, quiet: bool):
+    """Generate a detailed specification for a feature.
+
+    Explores the codebase to understand existing patterns and generates
+    a comprehensive specification document.
+
+    Examples:
+        emdash spec "user authentication"
+        emdash spec "dark mode toggle" --save
+    """
+    server = get_server_manager()
+    client = EmdashClient(server.get_server_url())
+    renderer = SSERenderer(console=console, verbose=not quiet)
+
+    try:
+        console.print(f"[cyan]Generating spec for: {feature}[/cyan]")
+        console.print()
+
+        stream = client.spec_generate_stream(
+            feature=feature,
+            model=model,
+            save=save,
+        )
+        renderer.render_stream(stream)
+
+        if save:
+            console.print()
+            console.print(f"[green]Spec saved to specs/{feature}/[/green]")
+
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        raise click.Abort()

emdash_cli/commands/swarm.py

@@ -0,0 +1,86 @@
+"""Swarm multi-agent CLI commands."""
+
+import click
+from rich.console import Console
+
+from ..client import EmdashClient
+from ..server_manager import get_server_manager
+from ..sse_renderer import SSERenderer
+
+console = Console()
+
+
+@click.group()
+def swarm():
+    """Multi-agent parallel execution with git worktrees."""
+    pass
+
+
+@swarm.command("run")
+@click.argument("tasks", nargs=-1, required=True)
+@click.option("--model", "-m", default=None, help="Model to use")
+@click.option("--auto-merge", is_flag=True, help="Automatically merge completed tasks")
+@click.option("--quiet", "-q", is_flag=True, help="Hide progress output")
+def swarm_run(tasks: tuple, model: str, auto_merge: bool, quiet: bool):
+    """Run multiple tasks in parallel using git worktrees.
+
+    Each task runs in its own worktree with a dedicated agent.
+    Tasks can be merged after completion.
+
+    Examples:
+        emdash swarm run "Fix login bug" "Add logout button"
+        emdash swarm run "Task 1" "Task 2" "Task 3" --auto-merge
+    """
+    server = get_server_manager()
+    client = EmdashClient(server.get_server_url())
+    renderer = SSERenderer(console=console, verbose=not quiet)
+
+    try:
+        console.print(f"[cyan]Starting swarm with {len(tasks)} tasks...[/cyan]")
+        console.print()
+
+        stream = client.swarm_run_stream(
+            tasks=list(tasks),
+            model=model,
+            auto_merge=auto_merge,
+        )
+        renderer.render_stream(stream)
+
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        raise click.Abort()
+
+
+@swarm.command("status")
+def swarm_status():
+    """Show status of current swarm execution."""
+    server = get_server_manager()
+    client = EmdashClient(server.get_server_url())
+
+    try:
+        status = client.swarm_status()
+
+        if not status.get("active"):
+            console.print("[dim]No active swarm execution[/dim]")
+            return
+
+        console.print("[bold]Swarm Status[/bold]")
+        console.print()
+
+        tasks = status.get("tasks", [])
+        for task in tasks:
+            task_status = task.get("status", "unknown")
+            name = task.get("name", "Unknown task")
+
+            if task_status == "completed":
+                console.print(f"  [green]✓[/green] {name}")
+            elif task_status == "running":
+                console.print(f"  [cyan]⟳[/cyan] {name}")
+            elif task_status == "failed":
+                console.print(f"  [red]✗[/red] {name}")
+            else:
+                console.print(f"  [dim]○[/dim] {name}")
+
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        raise click.Abort()

emdash_cli/commands/tasks.py

@@ -0,0 +1,52 @@
+"""Tasks generation CLI command."""
+
+import click
+from rich.console import Console
+
+from ..client import EmdashClient
+from ..server_manager import get_server_manager
+from ..sse_renderer import SSERenderer
+
+console = Console()
+
+
+@click.command("tasks")
+@click.argument("spec_name", required=False)
+@click.option("--save", is_flag=True, help="Save tasks to spec directory")
+@click.option("--model", "-m", default=None, help="Model to use")
+@click.option("--quiet", "-q", is_flag=True, help="Hide progress output")
+def tasks(spec_name: str, save: bool, model: str, quiet: bool):
+    """Generate implementation tasks from a specification.
+
+    If spec_name is provided, loads the spec from specs/<spec_name>/spec.json.
+    Otherwise, uses the most recent spec from the current session.
+
+    Examples:
+        emdash tasks
+        emdash tasks "user-authentication" --save
+    """
+    server = get_server_manager()
+    client = EmdashClient(server.get_server_url())
+    renderer = SSERenderer(console=console, verbose=not quiet)
+
+    try:
+        if spec_name:
+            console.print(f"[cyan]Generating tasks for: {spec_name}[/cyan]")
+        else:
+            console.print("[cyan]Generating tasks from current spec...[/cyan]")
+        console.print()
+
+        stream = client.tasks_generate_stream(
+            spec_name=spec_name,
+            model=model,
+            save=save,
+        )
+        renderer.render_stream(stream)
+
+        if save:
+            console.print()
+            console.print("[green]Tasks saved[/green]")
+
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        raise click.Abort()

emdash_cli/commands/team.py

@@ -0,0 +1,51 @@
+"""Team analysis CLI commands."""
+
+import click
+from rich.console import Console
+from rich.markdown import Markdown
+
+from ..client import EmdashClient
+from ..server_manager import get_server_manager
+
+console = Console()
+
+
+@click.group()
+def team():
+    """Team activity and collaboration analysis commands."""
+    pass
+
+
+@team.command("focus")
+@click.option("--days", default=14, help="Days to look back")
+@click.option("--model", "-m", default=None, help="Model to use")
+@click.option("--json", "output_json", is_flag=True, help="Output as JSON")
+def team_focus(days: int, model: str, output_json: bool):
+    """Get team's recent focus and work-in-progress.
+
+    Analyzes recent commits, PRs, and code changes to identify
+    what the team is working on.
+
+    Examples:
+        emdash team focus
+        emdash team focus --days 7
+    """
+    server = get_server_manager()
+    client = EmdashClient(server.get_server_url())
+
+    try:
+        result = client.team_focus(days=days, model=model)
+
+        if output_json:
+            import json
+            console.print(json.dumps(result, indent=2))
+        else:
+            content = result.get("content", "")
+            if content:
+                console.print(Markdown(content))
+            else:
+                console.print("[yellow]No focus data available[/yellow]")
+
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        raise click.Abort()