codegraph-cli 2.1.1__py3-none-any.whl → 2.1.2__py3-none-any.whl

codegraph_cli/cli_chat.py

@@ -2,13 +2,17 @@
 
 from __future__ import annotations
 
-import os
 import shutil
 from datetime import datetime
 from pathlib import Path
 from typing import Optional
 
 import typer
+from rich.console import Console
+from rich.panel import Panel
+from rich.rule import Rule
+from rich.table import Table
+from rich.text import Text
 
 from . import config
 from .chat_agent import ChatAgent
@@ -18,19 +22,7 @@ from .orchestrator import MCPOrchestrator
 from .rag import RAGRetriever
 from .storage import GraphStore, ProjectManager
 
-
-# ── Theme colors ──────────────────────────────────────────────
-C_RESET = "\033[0m"
-C_BOLD = "\033[1m"
-C_DIM = "\033[2m"
-C_CYAN = "\033[36m"
-C_GREEN = "\033[32m"
-C_YELLOW = "\033[33m"
-C_MAGENTA = "\033[35m"
-C_RED = "\033[31m"
-C_BLUE = "\033[34m"
-C_WHITE = "\033[97m"
-C_BG_DARK = "\033[48;5;235m"
+console = Console()
 
 
 def _term_width() -> int:
@@ -38,45 +30,40 @@ def _term_width() -> int:
     return shutil.get_terminal_size((80, 24)).columns
 
 
-def _box(text: str, color: str = C_CYAN, width: int = 0) -> str:
-    """Draw a box around text."""
-    w = width or min(_term_width(), 70)
-    inner = w - 4
-    lines = text.split("\n")
-    out = [f"{color}╭{'─' * (w - 2)}╮{C_RESET}"]
-    for line in lines:
-        padded = line.ljust(inner)[:inner]
-        out.append(f"{color}│{C_RESET} {padded} {color}│{C_RESET}")
-    out.append(f"{color}╰{'─' * (w - 2)}╯{C_RESET}")
-    return "\n".join(out)
+def _print_welcome(project_name: str, use_crew: bool, provider: str, model: str, auto_context: dict | None = None):
+    """Print the modern welcome banner."""
+    mode = "CrewAI Multi-Agent" if use_crew else "Chat"
 
+    console.print()
+    console.print(Panel(f"⚡ CodeGraph {mode}", style="bold cyan", width=min(_term_width(), 70)))
+    console.print(f"  [dim]Project[/dim]  [white]{project_name}[/white]")
+    console.print(f"  [dim]LLM[/dim]      [white]{provider}/{model}[/white]")
 
-def _divider(char: str = "─", color: str = C_DIM) -> str:
-    w = min(_term_width(), 70)
-    return f"{color}{char * w}{C_RESET}"
+    # Show auto-context summary
+    if auto_context:
+        summary = auto_context.get("summary", {})
+        indexed_files = summary.get("indexed_files", 0)
+        total_nodes = summary.get("total_nodes", 0)
+        node_types = summary.get("node_types", {})
+        if indexed_files or total_nodes:
+            funcs = node_types.get("function", 0)
+            classes = node_types.get("class", 0)
+            console.print(f"  [dim]Indexed[/dim]  [white]{indexed_files} files • {funcs} functions • {classes} classes[/white]")
+        recent = auto_context.get("recent_files", [])
+        if recent:
+            console.print(f"  [dim]Recent[/dim]   [white]{', '.join(recent[:3])}[/white]")
 
-
-def _print_welcome(project_name: str, use_crew: bool, provider: str, model: str):
-    """Print the modern welcome banner."""
-    mode = "CrewAI Multi-Agent" if use_crew else "Chat"
-    
-    banner = (
-        f"  {C_BOLD}{C_CYAN}⚡ CodeGraph {mode}{C_RESET}\n"
-        f"  {C_DIM}Project: {C_WHITE}{project_name}{C_RESET}\n"
-        f"  {C_DIM}LLM:     {C_WHITE}{provider}/{model}{C_RESET}"
-    )
-    print(f"\n{_box(f'⚡ CodeGraph {mode}', C_CYAN)}")
-    print(f"  {C_DIM}Project  {C_RESET}{C_WHITE}{project_name}{C_RESET}")
-    print(f"  {C_DIM}LLM      {C_RESET}{C_WHITE}{provider}/{model}{C_RESET}")
-    print(f"  {C_DIM}Type {C_YELLOW}/help{C_DIM} for commands, {C_YELLOW}/exit{C_DIM} to quit{C_RESET}")
-    print(_divider())
-    print()
+    console.print("  [dim]Type [yellow]/help[/yellow] for commands, [yellow]/exit[/yellow] to quit[/dim]")
+    console.print(Rule(style="dim"))
+    console.print()
 
 
 def _print_help(use_crew: bool):
     """Print help with styled formatting."""
-    print(f"\n  {C_BOLD}{C_CYAN}📖 Commands{C_RESET}")
-    print(_divider("─", C_DIM))
+    console.print()
+    table = Table(show_header=False, box=None, padding=(0, 2), title="📖 Commands", title_style="bold cyan")
+    table.add_column(style="yellow", min_width=22)
+    table.add_column(style="dim")
     cmds = [
         ("/exit", "Exit chat session"),
         ("/clear", "Clear conversation history & start fresh"),
@@ -95,22 +82,23 @@ def _print_help(use_crew: bool):
             ("/preview", "Preview pending changes"),
         ])
     for cmd, desc in cmds:
-        print(f"  {C_YELLOW}{cmd:<22}{C_RESET}{C_DIM}{desc}{C_RESET}")
-    print()
+        table.add_row(cmd, desc)
+    console.print(table)
+    console.print()
 
 
 def _print_response(text: str):
     """Print assistant response with styling."""
-    print(f"\n  {C_GREEN}●{C_RESET} {C_BOLD}Assistant{C_RESET}")
-    # Indent each line for clean look
+    console.print()
+    console.print("  [green]●[/green] [bold]Assistant[/bold]")
     for line in text.split("\n"):
-        print(f"  {line}")
-    print()
+        console.print(f"  {line}", highlight=False)
+    console.print()
 
 
-def _print_status(emoji: str, msg: str, color: str = C_GREEN):
+def _print_status(emoji: str, msg: str, style: str = "green"):
     """Print a status message."""
-    print(f"  {color}{emoji}  {msg}{C_RESET}")
+    console.print(f"  [{style}]{emoji}  {msg}[/{style}]")
 
 
 def start_chat_repl(
@@ -121,13 +109,14 @@ def start_chat_repl(
     use_crew: bool = False,
     provider: str = "",
     model: str = "",
+    auto_context: dict | None = None,
 ):
     """Start interactive REPL for chat."""
     # Load or create session
     if session_id:
         session = session_manager.load_session(session_id)
         if not session:
-            _print_status("🆕", "Session not found. Starting new session.", C_YELLOW)
+            _print_status("🆕", "Session not found. Starting new session.", "yellow")
             session = session_manager.create_session(project_name)
         else:
             _print_status("📂", f"Resumed session ({session.message_count} messages)")
@@ -141,17 +130,21 @@ def start_chat_repl(
             session = session_manager.create_session(project_name)
             _print_status("🆕", "Started new chat session")
     
+    # Hydrate agent with session history (enables crew continuity across restarts)
+    if hasattr(agent, 'load_session_history') and session.messages:
+        agent.load_session_history(session)
+
     # Welcome
-    _print_welcome(project_name, use_crew, provider, model)
+    _print_welcome(project_name, use_crew, provider, model, auto_context=auto_context)
     
     # REPL loop
     while True:
         try:
             # Prompt
             try:
-                user_input = input(f"  {C_BLUE}●{C_RESET} {C_BOLD}You ›{C_RESET} ").strip()
+                user_input = console.input("  [blue]●[/blue] [bold]You ›[/bold] ").strip()
             except EOFError:
-                print(f"\n  {C_DIM}👋 Goodbye! Session saved.{C_RESET}\n")
+                console.print("\n  [dim]👋 Goodbye! Session saved.[/dim]\n")
                 break
             
             if not user_input:
@@ -163,22 +156,28 @@ def start_chat_repl(
                 
                 if cmd == "/exit":
                     session_manager.save_session(session)
-                    print(f"\n  {C_DIM}👋 Goodbye! Session saved.{C_RESET}\n")
+                    console.print("\n  [dim]👋 Goodbye! Session saved.[/dim]\n")
                     break
                 
                 elif cmd == "/clear":
                     session.clear_history()
                     session.clear_proposals()
                     session_manager.save_session(session)
-                    _print_status("🧹", "Conversation cleared. Fresh start!", C_GREEN)
-                    print()
+                    # Clear agent-side memory (crew mode)
+                    if hasattr(agent, 'clear_history'):
+                        agent.clear_history()
+                    _print_status("🧹", "Conversation cleared. Fresh start!")
+                    console.print()
                     continue
                 
                 elif cmd == "/new":
                     session_manager.save_session(session)
                     session = session_manager.create_session(project_name)
-                    _print_status("🆕", "New session started.", C_GREEN)
-                    print()
+                    # Clear agent-side memory (crew mode)
+                    if hasattr(agent, 'clear_history'):
+                        agent.clear_history()
+                    _print_status("🆕", "New session started.")
+                    console.print()
                     continue
                 
                 elif cmd == "/help":
@@ -191,57 +190,57 @@ def start_chat_repl(
                             result = agent.apply_pending_proposal(session)
                             _print_status("📋", result)
                         else:
-                            _print_status("📋", "No pending proposals.", C_YELLOW)
+                            _print_status("📋", "No pending proposals.", "yellow")
                         continue
                     elif cmd == "/preview":
                         if session.pending_proposals:
                             for i, prop in enumerate(session.pending_proposals):
-                                print(f"\n  {C_BOLD}Proposal {i+1}:{C_RESET} {prop.description}")
+                                console.print(f"\n  [bold]Proposal {i+1}:[/bold] {prop.description}")
                                 for ch in prop.changes:
                                     icon = {"create": "🆕", "modify": "✏️", "delete": "🗑️"}.get(ch.change_type, "📄")
-                                    print(f"    {icon} {ch.file_path}")
+                                    console.print(f"    {icon} {ch.file_path}")
                         else:
-                            _print_status("📋", "No pending proposals.", C_YELLOW)
-                        print()
+                            _print_status("📋", "No pending proposals.", "yellow")
+                        console.print()
                         continue
                 
                 elif use_crew:
                     if cmd in ("/rollback", "/undo"):
                         parts = user_input.split(maxsplit=1)
                         if len(parts) < 2:
-                            _print_status("❓", "Usage: /rollback <file_path> [timestamp]", C_YELLOW)
+                            _print_status("❓", "Usage: /rollback <file_path> [timestamp]", "yellow")
                             continue
                         args = parts[1].split()
                         file_path = args[0]
                         ts = args[1] if len(args) > 1 else None
                         result = agent.rollback(file_path, ts)
                         _print_status("⏪", result)
-                        print()
+                        console.print()
                         continue
                     
                     elif cmd == "/backups":
                         backups = agent.list_all_backups()
                         if not backups:
-                            _print_status("📦", "No backups found.", C_YELLOW)
+                            _print_status("📦", "No backups found.", "yellow")
                         else:
-                            print(f"\n  {C_BOLD}{C_CYAN}📦 File Backups{C_RESET}")
-                            print(_divider("─", C_DIM))
+                            console.print("\n  [bold cyan]📦 File Backups[/bold cyan]")
+                            console.print(Rule(style="dim"))
                             for b in backups:
                                 ts = b["timestamp"]
                                 fp = b["original_path"]
-                                print(f"  {C_WHITE}{ts}{C_RESET}  {C_DIM}{fp}{C_RESET}")
-                            print(f"\n  {C_DIM}Use /rollback <file_path> to restore{C_RESET}")
-                        print()
+                                console.print(f"  [white]{ts}[/white]  [dim]{fp}[/dim]")
+                            console.print("\n  [dim]Use /rollback <file_path> to restore[/dim]")
+                        console.print()
                         continue
                 
-                _print_status("❓", f"Unknown command: {cmd}. Type /help", C_YELLOW)
+                _print_status("❓", f"Unknown command: {cmd}. Type /help", "yellow")
                 continue
             
             # ── Process message ──────────────────────────────
             session.add_message("user", user_input, datetime.now().isoformat())
             
             # Show thinking indicator
-            print(f"\n  {C_DIM}⏳ Thinking...{C_RESET}", end="", flush=True)
+            console.print("\n  [dim]⏳ Thinking...[/dim]", end="")
             
             if use_crew:
                 response = agent.process_message(user_input)
@@ -249,7 +248,7 @@ def start_chat_repl(
                 response = agent.process_message(user_input, session)
             
             # Clear thinking indicator
-            print(f"\r{' ' * 30}\r", end="")
+            console.print(f"\r{' ' * 30}\r", end="")
             
             # Save & display
             session.add_message("assistant", response, datetime.now().isoformat())
@@ -259,16 +258,46 @@ def start_chat_repl(
             
         except KeyboardInterrupt:
             session_manager.save_session(session)
-            print(f"\n\n  {C_DIM}👋 Goodbye! Session saved.{C_RESET}\n")
+            console.print("\n\n  [dim]👋 Goodbye! Session saved.[/dim]\n")
             break
         except Exception as e:
-            print(f"\n  {C_RED}❌ Error: {str(e)}{C_RESET}\n")
+            console.print(f"\n  [red]❌ Error: {str(e)}[/red]\n")
 
 
 # ── Typer app ────────────────────────────────────────────────
 chat_app = typer.Typer(help="💬 Interactive chat with AI agents")
 
 
+def _gather_auto_context(project_context) -> dict:
+    """Gather automatic context from the project for chat enrichment.
+
+    Collects project summary (file count, symbol count, node types)
+    and recently modified files so the chat session starts with
+    useful awareness of the codebase.
+    """
+    auto_ctx: dict = {}
+
+    try:
+        summary = project_context.get_project_summary()
+        auto_ctx["summary"] = summary
+    except Exception:
+        auto_ctx["summary"] = {}
+
+    # Recently modified source files
+    try:
+        if project_context.has_source_access:
+            items = project_context.list_directory(".")
+            files = [f for f in items if f["type"] == "file"]
+            files.sort(key=lambda f: f.get("modified", ""), reverse=True)
+            auto_ctx["recent_files"] = [f["name"] for f in files[:5]]
+        else:
+            auto_ctx["recent_files"] = []
+    except Exception:
+        auto_ctx["recent_files"] = []
+
+    return auto_ctx
+
+
 @chat_app.command("start")
 def start_chat(
     session_id: Optional[str] = typer.Option(None, "--session", "-s", help="Resume specific session ID"),
@@ -279,7 +308,14 @@ def start_chat(
     use_crew: bool = typer.Option(False, "--crew", help="Use CrewAI multi-agent system"),
     new_session: bool = typer.Option(False, "--new", "-n", help="Force start a new session"),
 ):
-    """Start interactive chat session."""
+    """💬 Start interactive chat session.
+
+    Example:
+      cg chat start
+      cg chat start --crew
+      cg chat start --new
+      cg chat start --session abc123
+    """
     from .embeddings import get_embedder
     from .project_context import ProjectContext
     
@@ -287,8 +323,8 @@ def start_chat(
     project = pm.get_current_project()
     
     if not project:
-        print(f"\n  {C_RED}❌ No project loaded.{C_RESET}")
-        print(f"  {C_DIM}Use: cg load-project <name>  or  cg index <path>{C_RESET}\n")
+        console.print("\n  [red]❌ No project loaded.[/red]")
+        console.print("  [dim]Use: cg load-project <name>  or  cg index <path>[/dim]\n")
         raise typer.Exit(1)
     
     # Initialize components
@@ -301,10 +337,10 @@ def start_chat(
         try:
             from .crew_chat import CrewChatAgent
         except ImportError:
-            print(f"\n  {C_RED}CrewAI is not installed.{C_RESET}")
-            print(f"  {C_DIM}Install with: pip install codegraph-cli[crew]{C_RESET}\n")
+            console.print("\n  [red]CrewAI is not installed.[/red]")
+            console.print("  [dim]Install with: pip install codegraph-cli\\[crew][/dim]\n")
             raise typer.Exit(1)
-        print(f"\n  {C_MAGENTA}Initializing CrewAI multi-agent system...{C_RESET}")
+        console.print("\n  [magenta]Initializing CrewAI multi-agent system...[/magenta]")
         agent = CrewChatAgent(context, llm, rag_retriever)
     else:
         orchestrator = MCPOrchestrator(
@@ -318,6 +354,9 @@ def start_chat(
     
     session_manager = SessionManager()
     
+    # Gather auto-context from the project for enriched chat experience
+    auto_context = _gather_auto_context(context)
+    
     # Force new session if requested
     effective_session_id = None if new_session else session_id
     
@@ -327,6 +366,7 @@ def start_chat(
             use_crew=use_crew,
             provider=llm_provider,
             model=llm_model,
+            auto_context=auto_context,
         )
     finally:
         context.close()
@@ -336,16 +376,21 @@ def start_chat(
 def list_sessions(
     project: Optional[str] = typer.Option(None, "--project", "-p", help="Filter by project")
 ):
-    """List all chat sessions."""
+    """📋 List all chat sessions.
+
+    Example:
+      cg chat list
+      cg chat list --project my-api
+    """
     session_manager = SessionManager()
     sessions = session_manager.list_sessions(project_name=project)
     
     if not sessions:
-        print(f"\n  {C_DIM}No chat sessions found.{C_RESET}\n")
+        console.print("\n  [dim]No chat sessions found.[/dim]\n")
         return
     
-    print(f"\n  {C_BOLD}{C_CYAN}📋 Chat Sessions ({len(sessions)}){C_RESET}")
-    print(_divider())
+    console.print(f"\n  [bold cyan]📋 Chat Sessions ({len(sessions)})[/bold cyan]")
+    console.print(Rule(style="dim"))
     
     for i, sess in enumerate(sessions, 1):
         created = sess['created_at'][:16].replace("T", " ")
@@ -353,20 +398,80 @@ def list_sessions(
         proj = sess['project_name']
         sid = sess['id'][:8]
         
-        print(f"  {C_WHITE}{i}.{C_RESET} {C_BOLD}{proj}{C_RESET}  {C_DIM}({msgs} msgs, {created}){C_RESET}  {C_DIM}id:{sid}…{C_RESET}")
+        console.print(f"  [white]{i}.[/white] [bold]{proj}[/bold]  [dim]({msgs} msgs, {created})[/dim]  [dim]id:{sid}…[/dim]")
     
-    print()
+    console.print()
 
 
 @chat_app.command("delete")
 def delete_session(
     session_id: str = typer.Argument(..., help="Session ID to delete")
 ):
-    """Delete a chat session."""
+    """🗑️  Delete a chat session.
+
+    Example:
+      cg chat delete abc12345
+    """
     session_manager = SessionManager()
     
     if session_manager.delete_session(session_id):
         _print_status("✅", f"Deleted session {session_id[:8]}…")
     else:
-        print(f"  {C_RED}❌ Session not found{C_RESET}")
+        console.print("  [red]❌ Session not found[/red]")
         raise typer.Exit(1)
+
+
+@chat_app.command("export")
+def export_session(
+    session_id: str = typer.Argument(..., help="Session ID to export"),
+    fmt: str = typer.Option("markdown", "--format", "-f", help="Export format: markdown, json"),
+    output: Optional[str] = typer.Option(None, "--output", "-o", help="Output file path"),
+):
+    """📤 Export chat session to a file.
+
+    Example:
+      cg chat export abc12345
+      cg chat export abc12345 --format json
+      cg chat export abc12345 --output conversation.md
+    """
+    import json as _json
+
+    session_manager = SessionManager()
+    session = session_manager.load_session(session_id)
+
+    if not session:
+        console.print(f"  [red]❌ Session '{session_id}' not found[/red]")
+        raise typer.Exit(1)
+
+    if fmt == "markdown":
+        lines = [
+            f"# Chat Session: {session.project_name}",
+            f"\nSession ID: {session.id}",
+            f"Messages: {session.message_count}\n",
+            "---\n",
+        ]
+        for msg in session.messages:
+            role = "**You**" if msg["role"] == "user" else "**CodeGraph**"
+            lines.append(f"### {role}\n")
+            lines.append(f"{msg['content']}\n")
+            lines.append("\n---\n")
+        content = "\n".join(lines)
+        ext = ".md"
+
+    elif fmt == "json":
+        data = {
+            "session_id": session.id,
+            "project_name": session.project_name,
+            "message_count": session.message_count,
+            "messages": session.messages,
+        }
+        content = _json.dumps(data, indent=2)
+        ext = ".json"
+
+    else:
+        console.print(f"  [red]❌ Unknown format: {fmt}[/red]")
+        raise typer.Exit(1)
+
+    filename = output or f"{session_id[:12]}_export{ext}"
+    Path(filename).write_text(content)
+    _print_status("✅", f"Exported to {filename}")

codegraph_cli/cli_diagnose.py

@@ -19,7 +19,12 @@ diagnose_app = typer.Typer(help="Detect and fix code errors")
 def check_errors(
     path: str = typer.Argument(".", help="Path to check (default: current directory)"),
 ):
-    """Scan project for syntax errors."""
+    """🔍 Scan project for syntax errors.
+
+    Example:
+      cg v2 diagnose check
+      cg v2 diagnose check ./src
+    """
     project_path = Path(path).resolve()
     
     if not project_path.exists():
@@ -49,7 +54,13 @@ def fix_errors(
     preview_only: bool = typer.Option(False, "--preview", "-p", help="Preview fixes without applying"),
     auto_apply: bool = typer.Option(False, "--auto-apply", "-y", help="Apply fixes without confirmation"),
 ):
-    """Automatically fix common syntax errors."""
+    """🔧 Automatically fix common syntax errors.
+
+    Example:
+      cg v2 diagnose fix
+      cg v2 diagnose fix ./src --preview
+      cg v2 diagnose fix ./src --auto-apply
+    """
     project_path = Path(path).resolve()
     
     if not project_path.exists():