emdash-cli 0.1.46__py3-none-any.whl → 0.1.70__py3-none-any.whl

emdash_cli/commands/agent/handlers/todos.py

@@ -2,6 +2,16 @@
 
 from rich.console import Console
 
+from ....design import (
+    Colors,
+    header,
+    footer,
+    SEPARATOR_WIDTH,
+    STATUS_ACTIVE,
+    STATUS_INACTIVE,
+    DOT_BULLET,
+)
+
 console = Console()
 
 
@@ -16,12 +26,19 @@ def handle_todos(args: str, client, session_id: str | None, pending_todos: list[
     """
     if not session_id:
         if pending_todos:
-            console.print("\n[bold cyan]Pending Todos[/bold cyan] [dim](will be added when session starts)[/dim]\n")
-            for i, todo in enumerate(pending_todos, 1):
-                console.print(f"  [dim]⬚[/dim] {todo}")
+            console.print()
+            console.print(f"[{Colors.MUTED}]{header('Pending Todos', SEPARATOR_WIDTH)}[/{Colors.MUTED}]")
+            console.print(f"  [{Colors.DIM}]will be added when session starts[/{Colors.DIM}]")
+            console.print()
+            for todo in pending_todos:
+                console.print(f"  [{Colors.MUTED}]○[/{Colors.MUTED}] {todo}")
+            console.print()
+            console.print(f"[{Colors.MUTED}]{footer(SEPARATOR_WIDTH)}[/{Colors.MUTED}]")
             console.print()
         else:
-            console.print("\n[dim]No todos yet. Start a conversation and the agent will track its tasks here.[/dim]\n")
+            console.print()
+            console.print(f"  [{Colors.DIM}]No todos yet. Start a conversation to track tasks.[/{Colors.DIM}]")
+            console.print()
     else:
         try:
             result = client.get_todos(session_id)
@@ -29,43 +46,41 @@ def handle_todos(args: str, client, session_id: str | None, pending_todos: list[
             summary = result.get("summary", {})
 
             if not todos:
-                console.print("\n[dim]No todos in current session.[/dim]\n")
+                console.print()
+                console.print(f"  [{Colors.DIM}]No todos in current session.[/{Colors.DIM}]")
+                console.print()
             else:
-                console.print("\n[bold cyan]Agent Todo List[/bold cyan]\n")
-
-                # Status icons
-                icons = {
-                    "pending": "[dim]⬚[/dim]",
-                    "in_progress": "[yellow]🔄[/yellow]",
-                    "completed": "[green]✓[/green]",
-                }
+                console.print()
+                console.print(f"[{Colors.MUTED}]{header('Todo List', SEPARATOR_WIDTH)}[/{Colors.MUTED}]")
+                console.print()
 
                 for todo in todos:
-                    icon = icons.get(todo["status"], "?")
                     title = todo["title"]
                     status = todo["status"]
 
                     if status == "completed":
-                        console.print(f"  {icon} [dim strikethrough]{title}[/dim strikethrough]")
+                        console.print(f"  [{Colors.SUCCESS}]●[/{Colors.SUCCESS}] [{Colors.DIM} strike]{title}[/{Colors.DIM} strike]")
                     elif status == "in_progress":
-                        console.print(f"  {icon} [bold]{title}[/bold]")
+                        console.print(f"  [{Colors.WARNING}]◐[/{Colors.WARNING}] [{Colors.TEXT} bold]{title}[/{Colors.TEXT} bold]")
                     else:
-                        console.print(f"  {icon} {title}")
+                        console.print(f"  [{Colors.MUTED}]○[/{Colors.MUTED}] {title}")
 
                     if todo.get("description"):
                         desc = todo["description"]
-                        if len(desc) > 60:
-                            console.print(f"      [dim]{desc[:60]}...[/dim]")
-                        else:
-                            console.print(f"      [dim]{desc}[/dim]")
+                        if len(desc) > 55:
+                            desc = desc[:55] + "..."
+                        console.print(f"      [{Colors.DIM}]{desc}[/{Colors.DIM}]")
 
                 console.print()
-                console.print(
-                    f"[dim]Total: {summary.get('total', 0)} | "
-                    f"Pending: {summary.get('pending', 0)} | "
-                    f"In Progress: {summary.get('in_progress', 0)} | "
-                    f"Completed: {summary.get('completed', 0)}[/dim]"
-                )
+                console.print(f"[{Colors.MUTED}]{footer(SEPARATOR_WIDTH)}[/{Colors.MUTED}]")
+
+                # Summary bar
+                total = summary.get('total', 0)
+                completed = summary.get('completed', 0)
+                in_progress = summary.get('in_progress', 0)
+                pending = summary.get('pending', 0)
+
+                console.print(f"  [{Colors.DIM}]○ {pending}[/{Colors.DIM}]  [{Colors.WARNING}]◐ {in_progress}[/{Colors.WARNING}]  [{Colors.SUCCESS}]● {completed}[/{Colors.SUCCESS}]  [{Colors.MUTED}]total {total}[/{Colors.MUTED}]")
                 console.print()
 
         except Exception as e:
@@ -82,17 +97,23 @@ def handle_todo_add(args: str, client, session_id: str | None, pending_todos: li
         pending_todos: List of pending todos (before session starts)
     """
     if not args:
-        console.print("[yellow]Usage: /todo-add <title>[/yellow]")
-        console.print("[dim]Example: /todo-add Fix the failing tests[/dim]")
+        console.print()
+        console.print(f"  [{Colors.WARNING}]Usage:[/{Colors.WARNING}] /todo-add <title>")
+        console.print(f"  [{Colors.DIM}]Example: /todo-add Fix the failing tests[/{Colors.DIM}]")
+        console.print()
     elif not session_id:
         pending_todos.append(args)
-        console.print(f"[green]Todo noted:[/green] {args}")
-        console.print("[dim]This will be added to the agent's context when you start a conversation.[/dim]")
+        console.print()
+        console.print(f"  [{Colors.SUCCESS}]{STATUS_ACTIVE}[/{Colors.SUCCESS}] [{Colors.MUTED}]noted:[/{Colors.MUTED}] {args}")
+        console.print(f"  [{Colors.DIM}]will be added when session starts[/{Colors.DIM}]")
+        console.print()
     else:
         try:
             result = client.add_todo(session_id, args)
             task = result.get("task", {})
-            console.print(f"[green]Added todo #{task.get('id')}: {task.get('title')}[/green]")
-            console.print(f"[dim]Total tasks: {result.get('total_tasks', 0)}[/dim]")
+            console.print()
+            console.print(f"  [{Colors.SUCCESS}]{STATUS_ACTIVE}[/{Colors.SUCCESS}] [{Colors.MUTED}]added:[/{Colors.MUTED}] {task.get('title')}")
+            console.print(f"  [{Colors.DIM}]total: {result.get('total_tasks', 0)}[/{Colors.DIM}]")
+            console.print()
         except Exception as e:
-            console.print(f"[red]Error adding todo: {e}[/red]")
+            console.print(f"  [{Colors.ERROR}]error:[/{Colors.ERROR}] {e}")

emdash_cli/commands/agent/handlers/verify.py

@@ -480,14 +480,17 @@ def _run_verifiers(manager: VerifierManager) -> None:
         return
 
     console.print(f"[bold]Running {len(manager.verifiers)} verifier(s)...[/bold]")
-    console.print()
 
     context = {
         "git_diff": get_git_diff(),
         "files_changed": get_changed_files(),
     }
 
-    report = manager.run_all(context)
+    # Run with spinner for better UX
+    with console.status("[cyan]Running verifiers...", spinner="dots"):
+        report = manager.run_all(context)
+
+    console.print()
     display_report(report)
     console.print()
 
@@ -548,7 +551,6 @@ def run_verification(goal: str | None = None) -> tuple[VerificationReport, bool]
 
     console.print()
     console.print(f"[bold cyan]Running {len(manager.verifiers)} verifier(s)...[/bold cyan]")
-    console.print()
 
     # Build context
     context = {
@@ -557,8 +559,11 @@ def run_verification(goal: str | None = None) -> tuple[VerificationReport, bool]
         "files_changed": get_changed_files(),
     }
 
-    # Run verifiers
-    report = manager.run_all(context)
+    # Run verifiers with spinner
+    with console.status("[cyan]Running verifiers...", spinner="dots"):
+        report = manager.run_all(context)
+
+    console.print()
 
     # Display results
     display_report(report)

emdash_cli/commands/agent/help.py

@@ -0,0 +1,236 @@
+"""Contextual help system for emdash CLI.
+
+Provides detailed help for commands with zen styling.
+"""
+
+from rich.console import Console
+
+from ...design import (
+    Colors,
+    STATUS_ACTIVE,
+    DOT_BULLET,
+    ARROW_PROMPT,
+    header,
+    footer,
+    SEPARATOR_WIDTH,
+)
+
+console = Console()
+
+# Detailed help for each command
+COMMAND_HELP = {
+    "/help": {
+        "description": "Show available commands and help",
+        "usage": ["/help", "/help <command>"],
+        "examples": ["/help", "/help agents"],
+    },
+    "/plan": {
+        "description": "Switch to plan mode for exploration and architecture",
+        "usage": ["/plan"],
+        "details": """Plan mode is read-only. The agent will explore your codebase,
+analyze architecture, and create implementation plans without
+making any changes.""",
+        "examples": ["/plan"],
+    },
+    "/code": {
+        "description": "Switch to code mode for implementation",
+        "usage": ["/code"],
+        "details": """Code mode allows the agent to make changes to your codebase.
+Use this after approving a plan or for direct implementation tasks.""",
+        "examples": ["/code"],
+    },
+    "/agents": {
+        "description": "Manage custom agents for specialized tasks",
+        "usage": [
+            "/agents",
+            "/agents create <name>",
+            "/agents show <name>",
+            "/agents edit <name>",
+            "/agents delete <name>",
+        ],
+        "details": """Custom agents extend emdash with specialized capabilities.
+Each agent has its own prompt, tools, and behavior configuration.""",
+        "examples": [
+            "/agents",
+            "/agents create code-reviewer",
+            "/agents edit planner",
+        ],
+    },
+    "/rules": {
+        "description": "Configure rules that guide agent behavior",
+        "usage": ["/rules", "/rules create", "/rules list"],
+        "details": """Rules define coding standards, preferences, and project
+conventions. The agent follows these guidelines when working
+on your codebase.""",
+        "examples": ["/rules", "/rules create"],
+    },
+    "/skills": {
+        "description": "Manage reusable skill templates",
+        "usage": ["/skills", "/skills create", "/skills list"],
+        "details": """Skills are reusable prompt templates that can be invoked
+for common tasks like code review, testing, or documentation.""",
+        "examples": ["/skills", "/skills create"],
+    },
+    "/session": {
+        "description": "Manage conversation sessions",
+        "usage": ["/session", "/session save <name>", "/session load <name>"],
+        "details": """Sessions preserve conversation context. Save sessions to
+continue work later or switch between different tasks.""",
+        "examples": [
+            "/session",
+            "/session save my-feature",
+            "/session load my-feature",
+        ],
+    },
+    "/verify": {
+        "description": "Run verification checks on the codebase",
+        "usage": ["/verify", "/verify <check>"],
+        "details": """Runs configured verifiers (tests, linting, type checking)
+to ensure code quality. Use /verify-loop for automatic fixing.""",
+        "examples": ["/verify", "/verify tests"],
+    },
+    "/verify-loop": {
+        "description": "Run verification loop with automatic fixing",
+        "usage": ["/verify-loop <task>"],
+        "details": """Runs verifiers repeatedly, letting the agent fix issues
+until all checks pass or you stop the loop.""",
+        "examples": ["/verify-loop fix the failing tests"],
+    },
+    "/pr": {
+        "description": "Review or create pull requests",
+        "usage": ["/pr <url>", "/pr create"],
+        "details": """Review GitHub pull requests or create new ones.
+Provides detailed analysis of changes and suggestions.""",
+        "examples": [
+            "/pr https://github.com/org/repo/pull/123",
+            "/pr create",
+        ],
+    },
+    "/research": {
+        "description": "Research a topic using web search",
+        "usage": ["/research <query>"],
+        "details": """Searches the web for information and provides a summary.
+Useful for finding documentation, examples, or solutions.""",
+        "examples": ["/research react hooks best practices"],
+    },
+    "/todos": {
+        "description": "View and manage task list",
+        "usage": ["/todos", "/todo-add <task>"],
+        "details": """Track tasks and progress. The agent can also add todos
+during planning and implementation.""",
+        "examples": ["/todos", "/todo-add implement auth"],
+    },
+    "/context": {
+        "description": "View current context information",
+        "usage": ["/context"],
+        "details": """Shows token usage, context breakdown, and reranked items
+in the current session.""",
+        "examples": ["/context"],
+    },
+    "/compact": {
+        "description": "Compact conversation context",
+        "usage": ["/compact"],
+        "details": """Summarizes the conversation to reduce context size while
+preserving important information. Use when hitting limits.""",
+        "examples": ["/compact"],
+    },
+    "/status": {
+        "description": "Show current status and configuration",
+        "usage": ["/status"],
+        "details": """Displays current mode, model, session info, and
+active configuration.""",
+        "examples": ["/status"],
+    },
+    "/doctor": {
+        "description": "Run diagnostic checks",
+        "usage": ["/doctor"],
+        "details": """Checks environment, dependencies, and configuration
+for potential issues.""",
+        "examples": ["/doctor"],
+    },
+    "/auth": {
+        "description": "Manage authentication",
+        "usage": ["/auth login", "/auth logout", "/auth status"],
+        "details": """Connect or disconnect from GitHub. Authentication enables
+PR reviews, issue management, and repository access.""",
+        "examples": ["/auth login", "/auth status"],
+    },
+    "/setup": {
+        "description": "Run interactive setup wizard",
+        "usage": ["/setup", "/setup rules", "/setup agents"],
+        "details": """AI-assisted setup for configuring rules, agents, skills,
+and verifiers with templates and guidance.""",
+        "examples": ["/setup", "/setup rules"],
+    },
+    "/reset": {
+        "description": "Reset current session",
+        "usage": ["/reset"],
+        "details": """Clears the current session context. Use to start fresh
+without closing the CLI.""",
+        "examples": ["/reset"],
+    },
+    "/quit": {
+        "description": "Exit emdash",
+        "usage": ["/quit", "/exit", "/q"],
+        "examples": ["/quit"],
+    },
+}
+
+
+def show_command_help(command: str) -> None:
+    """Show detailed help for a specific command."""
+    # Normalize command
+    if not command.startswith("/"):
+        command = "/" + command
+
+    help_info = COMMAND_HELP.get(command)
+
+    if not help_info:
+        console.print(f"  [{Colors.ERROR}]Unknown command: {command}[/{Colors.ERROR}]")
+        console.print(f"  [{Colors.DIM}]Type /help to see all commands[/{Colors.DIM}]")
+        return
+
+    console.print()
+    console.print(f"[{Colors.MUTED}]{header(command, SEPARATOR_WIDTH)}[/{Colors.MUTED}]")
+    console.print()
+    console.print(f"  {help_info['description']}")
+    console.print()
+
+    # Usage
+    console.print(f"  [{Colors.PRIMARY}]Usage:[/{Colors.PRIMARY}]")
+    for usage in help_info.get("usage", []):
+        console.print(f"    {usage}")
+    console.print()
+
+    # Details
+    if "details" in help_info:
+        console.print(f"  [{Colors.DIM}]{help_info['details']}[/{Colors.DIM}]")
+        console.print()
+
+    # Examples
+    if "examples" in help_info:
+        console.print(f"  [{Colors.PRIMARY}]Examples:[/{Colors.PRIMARY}]")
+        for example in help_info["examples"]:
+            console.print(f"    [{Colors.SUCCESS}]{example}[/{Colors.SUCCESS}]")
+        console.print()
+
+    console.print(f"[{Colors.MUTED}]{footer(SEPARATOR_WIDTH)}[/{Colors.MUTED}]")
+    console.print()
+
+
+def show_quick_tips() -> None:
+    """Show quick tips for new users."""
+    console.print()
+    console.print(f"[{Colors.MUTED}]{header('Quick Tips', 35)}[/{Colors.MUTED}]")
+    console.print()
+    console.print(f"  [{Colors.DIM}]Keyboard shortcuts:[/{Colors.DIM}]")
+    console.print(f"    {DOT_BULLET} Ctrl+C to cancel")
+    console.print(f"    {DOT_BULLET} Esc during execution to interrupt")
+    console.print(f"    {DOT_BULLET} Alt+Enter for multiline input")
+    console.print()
+    console.print(f"  [{Colors.DIM}]File references:[/{Colors.DIM}]")
+    console.print(f"    {DOT_BULLET} Use @filename to include files")
+    console.print(f"    {DOT_BULLET} Tab completion for @file paths")
+    console.print()
+    console.print(f"[{Colors.MUTED}]{footer(35)}[/{Colors.MUTED}]")
+    console.print()