breadcrumb-cli 0.1.0__py3-none-any.whl

breadcrumb/commands/chat.py

@@ -0,0 +1,123 @@
+"""
+Interactive chat with the codebase using a TUI.
+"""
+
+from pathlib import Path
+from typing import Optional
+
+from rich.console import Console
+from rich.panel import Panel
+from rich.prompt import Prompt
+from rich.rule import Rule
+
+from breadcrumb.ai.prompts import get_system_prompt
+from breadcrumb.ai.router import AIRouter
+from breadcrumb.history import SessionManager
+from breadcrumb.ingest import FileIngester
+
+console = Console()
+
+
+def cmd_chat(
+    repo_path: Path,
+    provider: Optional[str] = None,
+    session_name: str = "default",
+) -> None:
+    """
+    Interactive chat session with the codebase.
+
+    Args:
+        repo_path: Repository path
+        provider: AI provider (overrides config)
+        session_name: Name of the chat session
+    """
+    # Initialize
+    ingester = FileIngester(repo_path)
+    router = AIRouter(provider)
+    session = SessionManager(repo_path, session_name)
+
+    try:
+        context = ingester.get_content()
+    except Exception as e:
+        console.print(f"[red]Error reading repository: {e}[/red]")
+        context = ""
+
+    console.print(
+        Panel.fit(
+            "[bold cyan]🍞 Bread Crumb[/bold cyan]\n"
+            f"[dim]Chat with your codebase using {router.provider}[/dim]",
+            border_style="cyan",
+        )
+    )
+    console.print(
+        f"[dim]Session: {session_name} | Provider: {router.provider} | Model: {router.model}[/dim]"
+    )
+    console.print("[dim]Type 'exit' to quit, 'clear' to clear history[/dim]")
+    console.print(Rule())
+
+    # Chat loop
+    while True:
+        try:
+            question = Prompt.ask("[cyan]You")
+        except KeyboardInterrupt:
+            console.print("\n[dim]Goodbye![/dim]")
+            break
+        except EOFError:
+            console.print("\n[dim]Goodbye![/dim]")
+            break
+
+        if not question.strip():
+            continue
+
+        if question.lower() == "exit":
+            console.print("[dim]Goodbye![/dim]")
+            break
+
+        if question.lower() == "clear":
+            session.clear()
+            console.print("[yellow]History cleared[/yellow]")
+            continue
+
+        if question.lower() == "sessions":
+            sessions = SessionManager.list_sessions(repo_path)
+            if sessions:
+                console.print("[cyan]Available sessions:[/cyan]")
+                for s in sessions:
+                    console.print(f"  • {s}")
+            else:
+                console.print("[dim]No other sessions[/dim]")
+            continue
+
+        # Add user message to history
+        session.add_message("user", question)
+
+        # Build messages for API
+        system = get_system_prompt("chat")
+
+        # Include context only in first message of session
+        if len(session.messages) <= 1:
+            api_messages = [
+                {"role": "user", "content": f"Repo context:\n{context}\n\nQuestion: {question}"}
+            ]
+        else:
+            api_messages = session.get_messages_for_api()
+
+        # Stream response
+        try:
+            response_text = ""
+            console.print("[cyan]Assistant[/cyan]", end=" ")
+            for chunk in router.stream(api_messages, system):
+                console.print(chunk, end="", highlight=False)
+                response_text += chunk
+            console.print()  # Newline after response
+        except Exception as e:
+            console.print(f"[red]Error: {e}[/red]")
+            continue
+
+        # Add assistant response to history
+        session.add_message("assistant", response_text)
+
+        # Show stats
+        tokens = session.count_tokens()
+        console.print(f"[dim]~{tokens:,} tokens in session[/dim]")
+        console.print(Rule())

breadcrumb/commands/commit.py

@@ -0,0 +1,87 @@
+"""
+Generate conventional commit messages from staged changes.
+"""
+
+import subprocess
+from pathlib import Path
+from typing import Optional
+
+from rich.console import Console
+
+from breadcrumb.ai.prompts import get_system_prompt
+from breadcrumb.ai.router import AIRouter
+
+console = Console()
+
+
+def get_git_diff_staged(repo_path: Path) -> str:
+    """Get staged changes via git diff --staged."""
+    try:
+        result = subprocess.run(
+            ["git", "diff", "--staged"],
+            cwd=repo_path,
+            capture_output=True,
+            text=True,
+        )
+        return result.stdout
+    except Exception as e:
+        console.print(f"[red]Error running git diff: {e}[/red]")
+        return ""
+
+
+def cmd_commit(
+    repo_path: Path,
+    provider: Optional[str] = None,
+    silent: bool = False,
+) -> str:
+    """
+    Generate a conventional commit message from staged changes.
+
+    Args:
+        repo_path: Repository path
+        provider: AI provider (overrides config)
+        silent: If True, only print the message (no other output)
+
+    Returns:
+        The generated commit message
+    """
+    # Get staged diff
+    diff = get_git_diff_staged(repo_path)
+
+    if not diff:
+        if not silent:
+            console.print("[yellow]No staged changes[/yellow]")
+        return ""
+
+    # Setup AI
+    router = AIRouter(provider)
+    system = get_system_prompt("commit")
+
+    prompt = f"""Analyze these staged changes and generate a conventional commit message.
+
+{diff}
+
+Generate ONLY the commit message in conventional format (type(scope): description).
+No explanation, no markdown, just the message."""
+
+    messages = [{"role": "user", "content": prompt}]
+
+    try:
+        if not silent:
+            with console.status("[bold cyan]Generating commit message...", spinner="dots"):
+                message = router.chat(messages, system)
+        else:
+            message = router.chat(messages, system)
+
+        message = message.strip()
+
+        if not silent:
+            console.print(f"\n[green]Suggested commit:[/green]\n{message}")
+        else:
+            print(message)
+
+        return message
+    except Exception as e:
+        if not silent:
+            console.print(f"[red]Error: {e}[/red]")
+        return ""

breadcrumb/commands/diff.py

@@ -0,0 +1,90 @@
+"""
+Review git diffs with AI.
+"""
+
+import subprocess
+from pathlib import Path
+from typing import Optional
+
+from rich.console import Console
+from rich.markdown import Markdown
+
+from breadcrumb.ai.prompts import get_system_prompt
+from breadcrumb.ai.router import AIRouter
+
+console = Console()
+
+
+def get_git_diff(repo_path: Path, revision: str = "") -> str:
+    """Get git diff for a revision."""
+    try:
+        if revision:
+            result = subprocess.run(
+                ["git", "diff", revision],
+                cwd=repo_path,
+                capture_output=True,
+                text=True,
+            )
+        else:
+            result = subprocess.run(
+                ["git", "diff"],
+                cwd=repo_path,
+                capture_output=True,
+                text=True,
+            )
+        return result.stdout
+    except Exception as e:
+        console.print(f"[red]Error running git diff: {e}[/red]")
+        return ""
+
+
+def cmd_diff(
+    repo_path: Path,
+    revision: str = "",
+    provider: Optional[str] = None,
+) -> str:
+    """
+    Review a git diff with AI.
+
+    Args:
+        repo_path: Repository path
+        revision: Git revision (e.g., 'HEAD~1', 'main..feature/auth')
+        provider: AI provider (overrides config)
+
+    Returns:
+        The review
+    """
+    diff = get_git_diff(repo_path, revision)
+
+    if not diff:
+        console.print("[yellow]No changes found for the specified revision[/yellow]")
+        return ""
+
+    # Limit diff size
+    if len(diff) > 50000:
+        diff = diff[:50000] + "\n... [diff truncated]"
+
+    router = AIRouter(provider)
+    system = get_system_prompt("diff")
+
+    prompt = f"""Review this git diff and provide:
+1. Summary of changes
+2. Any potential issues or bugs
+3. Suggestions for improvement
+4. Impact assessment
+
+{diff}"""
+
+    messages = [{"role": "user", "content": prompt}]
+
+    try:
+        response_text = ""
+        with console.status("[bold cyan]Reviewing diff...", spinner="dots"):
+            for chunk in router.stream(messages, system):
+                response_text += chunk
+
+        console.print(Markdown(response_text))
+        return response_text
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        return ""

breadcrumb/commands/digest.py

@@ -0,0 +1,80 @@
+"""
+Generate a daily digest of changes from git commits.
+"""
+
+import subprocess
+from datetime import datetime, timedelta
+from pathlib import Path
+from typing import Optional
+
+from rich.console import Console
+from rich.markdown import Markdown
+
+from breadcrumb.ai.prompts import get_system_prompt
+from breadcrumb.ai.router import AIRouter
+
+console = Console()
+
+
+def get_commits_since(repo_path: Path, hours: int = 24) -> str:
+    """Get git log for the past N hours."""
+    try:
+        since = datetime.now() - timedelta(hours=hours)
+        since_str = since.strftime("%Y-%m-%d %H:%M:%S")
+
+        result = subprocess.run(
+            ["git", "log", f"--since={since_str}", "--oneline"],
+            cwd=repo_path,
+            capture_output=True,
+            text=True,
+        )
+        return result.stdout
+    except Exception as e:
+        console.print(f"[red]Error getting commits: {e}[/red]")
+        return ""
+
+
+def cmd_digest(
+    repo_path: Path,
+    hours: int = 24,
+    provider: Optional[str] = None,
+) -> str:
+    """
+    Generate a digest of recent commits.
+
+    Args:
+        repo_path: Repository path
+        hours: How many hours back to look
+        provider: AI provider (overrides config)
+
+    Returns:
+        The digest
+    """
+    commits = get_commits_since(repo_path, hours)
+
+    if not commits:
+        console.print("[yellow]No commits in the past 24 hours[/yellow]")
+        return ""
+
+    router = AIRouter(provider)
+    system = get_system_prompt("digest")
+
+    prompt = f"""Summarize these commits into a concise digest.
+What changed? What was fixed? Notable improvements?
+
+Commits:
+{commits}"""
+
+    messages = [{"role": "user", "content": prompt}]
+
+    try:
+        response_text = ""
+        with console.status("[bold cyan]Generating digest...", spinner="dots"):
+            for chunk in router.stream(messages, system):
+                response_text += chunk
+
+        console.print(Markdown(response_text))
+        return response_text
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        return ""

breadcrumb/commands/explain_error.py

@@ -0,0 +1,63 @@
+"""
+Explain errors and stack traces.
+"""
+
+import sys
+from typing import Optional
+
+from rich.console import Console
+from rich.markdown import Markdown
+
+from breadcrumb.ai.prompts import get_system_prompt
+from breadcrumb.ai.router import AIRouter
+
+console = Console()
+
+
+def cmd_explain_error(
+    error_text: Optional[str] = None,
+    provider: Optional[str] = None,
+) -> str:
+    """
+    Explain an error or stack trace.
+
+    Args:
+        error_text: Error text (reads from stdin if not provided)
+        provider: AI provider (overrides config)
+
+    Returns:
+        The explanation
+    """
+    if not error_text:
+        error_text = sys.stdin.read()
+
+    if not error_text:
+        console.print("[red]Error: No error text provided[/red]")
+        return ""
+
+    error_text = error_text.strip()
+
+    router = AIRouter(provider)
+    system = get_system_prompt("explain-error")
+
+    prompt = f"""Analyze this error and provide:
+1. Plain English explanation
+2. Root cause
+3. How to fix it
+
+Error:
+{error_text}"""
+
+    messages = [{"role": "user", "content": prompt}]
+
+    try:
+        response_text = ""
+        with console.status("[bold cyan]Analyzing error...", spinner="dots"):
+            for chunk in router.stream(messages, system):
+                response_text += chunk
+
+        console.print(Markdown(response_text))
+        return response_text
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        return ""

breadcrumb/commands/init.py

@@ -0,0 +1,67 @@
+"""
+Initialize a .breadcrumb.yaml config file for a repository.
+"""
+
+from pathlib import Path
+
+from rich.console import Console
+
+console = Console()
+
+BREADCRUMB_YAML_TEMPLATE = """# Bread Crumb Configuration
+# Place this file in your repository root to customize Bread Crumb behavior
+
+# AI Provider: anthropic, openai, gemini, or ollama
+provider: anthropic
+
+# Model name for the chosen provider
+model: claude-3-5-sonnet-20241022
+
+# Patterns to ignore (like .gitignore)
+# These files won't be included in context
+ignore_patterns:
+  - "*.min.js"
+  - "*.min.css"
+  - "dist/"
+  - "build/"
+  - "node_modules/"
+
+# Custom system prompt for this repository
+# Gets prepended to all conversations
+system_prompt: |
+  You are analyzing a [PROJECT_TYPE] project.
+  Key technologies: [TECH_STACK]
+  Important context: [ANY_SPECIAL_RULES]
+
+# Temperature for AI responses (0.0 - 1.0)
+temperature: 0.7
+
+# Maximum tokens per request
+max_tokens: 4096
+"""
+
+
+def cmd_init(repo_path: Path) -> bool:
+    """
+    Initialize a .breadcrumb.yaml config file in the repository.
+
+    Args:
+        repo_path: Repository path
+
+    Returns:
+        True if successful
+    """
+    config_file = repo_path / ".breadcrumb.yaml"
+
+    if config_file.exists():
+        console.print("[yellow].breadcrumb.yaml already exists[/yellow]")
+        return False
+
+    try:
+        config_file.write_text(BREADCRUMB_YAML_TEMPLATE)
+        console.print(f"[green]✓ Created {config_file}[/green]")
+        console.print("[dim]Edit it to customize Bread Crumb for your project[/dim]")
+        return True
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        return False