PyPI - breadcrumb-cli - Versions diffs - 0.1.0__py3-none-any.whl - Mend

breadcrumb-cli 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (23) hide show

breadcrumb/__init__.py +7 -0
breadcrumb/ai/__init__.py +1 -0
breadcrumb/ai/prompts.py +60 -0
breadcrumb/ai/router.py +187 -0
breadcrumb/cli.py +144 -0
breadcrumb/commands/__init__.py +1 -0
breadcrumb/commands/ask.py +98 -0
breadcrumb/commands/audit.py +77 -0
breadcrumb/commands/chat.py +123 -0
breadcrumb/commands/commit.py +87 -0
breadcrumb/commands/diff.py +90 -0
breadcrumb/commands/digest.py +80 -0
breadcrumb/commands/explain_error.py +63 -0
breadcrumb/commands/init.py +67 -0
breadcrumb/commands/share.py +209 -0
breadcrumb/config.py +84 -0
breadcrumb/history.py +110 -0
breadcrumb/ingest.py +163 -0
breadcrumb_cli-0.1.0.dist-info/METADATA +342 -0
breadcrumb_cli-0.1.0.dist-info/RECORD +23 -0
breadcrumb_cli-0.1.0.dist-info/WHEEL +4 -0
breadcrumb_cli-0.1.0.dist-info/entry_points.txt +2 -0
breadcrumb_cli-0.1.0.dist-info/licenses/LICENSE +23 -0

breadcrumb/commands/share.py ADDED Viewed

@@ -0,0 +1,209 @@
+"""
+Export chat sessions as shareable HTML.
+"""
+# ruff: noqa: W293
+from pathlib import Path
+from typing import Dict, List, Optional
+from rich.console import Console
+console = Console()
+def generate_html(title: str, messages: List[Dict]) -> str:
+    """Generate beautiful HTML from chat messages."""
+    html = f"""<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{title}</title>
+    <style>
+        * {{
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }}
+        body {{
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', sans-serif;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            padding: 20px;
+            min-height: 100vh;
+        }}
+        .container {{
+            max-width: 800px;
+            margin: 0 auto;
+            background: white;
+            border-radius: 12px;
+            box-shadow: 0 20px 60px rgba(0, 0, 0, 0.3);
+            overflow: hidden;
+        }}
+        .header {{
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            color: white;
+            padding: 40px 20px;
+            text-align: center;
+        }}
+        .header h1 {{
+            font-size: 32px;
+            margin-bottom: 10px;
+        }}
+        .header p {{
+            opacity: 0.9;
+            font-size: 14px;
+        }}
+        .messages {{
+            padding: 30px;
+            max-height: 70vh;
+            overflow-y: auto;
+        }}
+        .message {{
+            margin-bottom: 20px;
+            animation: fadeIn 0.3s ease-in;
+        }}
+        @keyframes fadeIn {{
+            from {{ opacity: 0; transform: translateY(10px); }}
+            to {{ opacity: 1; transform: translateY(0); }}
+        }}
+        .message.user {{
+            text-align: right;
+        }}
+        .message.user .content {{
+            background: #667eea;
+            color: white;
+            margin-left: 20%;
+        }}
+        .message.assistant .content {{
+            background: #f0f0f0;
+            color: #333;
+            margin-right: 20%;
+        }}
+        .role {{
+            font-size: 12px;
+            font-weight: 600;
+            margin-bottom: 5px;
+            opacity: 0.7;
+            text-transform: uppercase;
+        }}
+        .content {{
+            padding: 12px 16px;
+            border-radius: 8px;
+            line-height: 1.5;
+            word-wrap: break-word;
+        }}
+        .content code {{
+            background: rgba(0, 0, 0, 0.1);
+            padding: 2px 6px;
+            border-radius: 3px;
+            font-family: 'Monaco', 'Courier New', monospace;
+            font-size: 13px;
+        }}
+        .content pre {{
+            background: rgba(0, 0, 0, 0.05);
+            padding: 10px;
+            border-radius: 5px;
+            overflow-x: auto;
+            margin: 10px 0;
+        }}
+        .content pre code {{
+            background: none;
+            padding: 0;
+        }}
+        .footer {{
+            padding: 20px;
+            background: #f9f9f9;
+            text-align: center;
+            font-size: 12px;
+            color: #999;
+        }}
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="header">
+            <h1>🍞 Bread Crumb Chat</h1>
+            <p>{title}</p>
+        </div>
+        <div class="messages">
+"""
+    for msg in messages:
+        role = msg.get("role", "unknown")
+        content = msg.get("content", "").replace("<", "&lt;").replace(">", "&gt;")
+        html += f"""            <div class="message {role}">
+                <div class="role">{role}</div>
+                <div class="content">{content}</div>
+            </div>
+"""
+    html += f"""        </div>
+        <div class="footer">
+            <p>Powered by Bread Crumb</p>
+            <p>Generated on {Path.cwd()}</p>
+        </div>
+    </div>
+</body>
+</html>"""
+    return html
+def cmd_share(session_file: Path, output_file: Optional[Path] = None) -> Optional[Path]:
+    """
+    Export a chat session as shareable HTML.
+    Args:
+        session_file: Path to session JSON file
+        output_file: Where to save the HTML (default: session.html)
+    Returns:
+        Path to created HTML file
+    """
+    import json
+    if not session_file.exists():
+        console.print(f"[red]Session file not found: {session_file}[/red]")
+        return None
+    try:
+        data = json.loads(session_file.read_text())
+        messages = data.get("messages", [])
+    except Exception as e:
+        console.print(f"[red]Error reading session: {e}[/red]")
+        return None
+    title = f"Bread Crumb Chat - {data.get('session', 'default')}"
+    html = generate_html(title, messages)
+    if not output_file:
+        output_file = session_file.parent / f"{session_file.stem}.html"
+    try:
+        output_file.write_text(html)
+        console.print(f"[green]✓ Exported to {output_file}[/green]")
+        return output_file
+    except Exception as e:
+        console.print(f"[red]Error writing HTML: {e}[/red]")
+        return None

breadcrumb/config.py ADDED Viewed

@@ -0,0 +1,84 @@
+"""
+Configuration management for Bread Crumb.
+Handles API keys, provider preferences, and global settings.
+"""
+import json
+from pathlib import Path
+from typing import Any, Dict, Optional
+class Config:
+    """Manages user configuration in ~/.breadcrumb/config.json"""
+    def __init__(self):
+        self.app_dir = Path.home() / ".breadcrumb"
+        self.config_file = self.app_dir / "config.json"
+        self.app_dir.mkdir(exist_ok=True)
+        self._config = self._load()
+    def _load(self) -> Dict[str, Any]:
+        """Load config from file or return defaults."""
+        if self.config_file.exists():
+            try:
+                return json.loads(self.config_file.read_text())
+            except Exception:
+                return self._defaults()
+        return self._defaults()
+    def _defaults(self) -> Dict[str, Any]:
+        """Default configuration."""
+        return {
+            "provider": "anthropic",
+            "anthropic_key": "",
+            "openai_key": "",
+            "gemini_key": "",
+            "ollama_url": "http://localhost:11434",
+            "model_anthropic": "claude-3-5-sonnet-20241022",
+            "model_openai": "gpt-4o",
+            "model_gemini": "gemini-2.0-flash",
+            "model_ollama": "llama2",
+            "max_tokens": 200000,
+            "temperature": 0.7,
+        }
+    def set(self, key: str, value: Any) -> None:
+        """Set a configuration value."""
+        self._config[key] = value
+        self.save()
+    def get(self, key: str, default: Any = None) -> Any:
+        """Get a configuration value."""
+        return self._config.get(key, default)
+    def save(self) -> None:
+        """Save config to file."""
+        self.config_file.write_text(json.dumps(self._config, indent=2))
+    def get_api_key(self, provider: str) -> str:
+        """Get API key for provider."""
+        key_map = {
+            "anthropic": "anthropic_key",
+            "openai": "openai_key",
+            "gemini": "gemini_key",
+        }
+        return self.get(key_map.get(provider, ""), "")
+    def set_api_key(self, provider: str, key: str) -> None:
+        """Set API key for provider."""
+        key_map = {
+            "anthropic": "anthropic_key",
+            "openai": "openai_key",
+            "gemini": "gemini_key",
+        }
+        self.set(key_map.get(provider, ""), key)
+    def get_model(self, provider: Optional[str] = None) -> str:
+        """Get model name for provider."""
+        provider = provider or self.get("provider", "anthropic")
+        model_key = f"model_{provider}"
+        return self.get(model_key, "")
+    def to_dict(self) -> Dict[str, Any]:
+        """Return config as dictionary."""
+        return self._config.copy()

breadcrumb/history.py ADDED Viewed

@@ -0,0 +1,110 @@
+"""
+Session management and conversation history persistence.
+Supports named sessions per repository.
+"""
+import json
+from datetime import datetime
+from pathlib import Path
+from typing import Dict, List
+class SessionManager:
+    """Manages named chat sessions for repositories."""
+    def __init__(self, repo_path: Path, session_name: str = "default"):
+        self.repo_path = Path(repo_path)
+        self.session_name = session_name
+        self.history_dir = Path.home() / ".breadcrumb" / "sessions"
+        self.history_dir.mkdir(parents=True, exist_ok=True)
+        # Use repo hash to differentiate repos with same name
+        import hashlib
+        repo_hash = hashlib.md5(str(self.repo_path.absolute()).encode()).hexdigest()[:8]
+        self.session_file = self.history_dir / f"{repo_hash}_{session_name}.json"
+        self.messages: List[Dict[str, str]] = self._load()
+    def _load(self) -> List[Dict[str, str]]:
+        """Load session from disk."""
+        if self.session_file.exists():
+            try:
+                data = json.loads(self.session_file.read_text())
+                return data.get("messages", [])
+            except Exception:
+                return []
+        return []
+    def save(self) -> None:
+        """Save session to disk."""
+        data = {
+            "repo": str(self.repo_path),
+            "session": self.session_name,
+            "created": self.session_file.stat().st_ctime
+            if self.session_file.exists()
+            else datetime.now().timestamp(),
+            "updated": datetime.now().timestamp(),
+            "messages": self.messages,
+        }
+        self.session_file.write_text(json.dumps(data, indent=2))
+    def add_message(self, role: str, content: str) -> None:
+        """Add a message to the session."""
+        self.messages.append(
+            {
+                "role": role,
+                "content": content,
+                "timestamp": datetime.now().isoformat(),
+            }
+        )
+        self.save()
+    def get_messages(self) -> List[Dict[str, str]]:
+        """Get all messages in the session."""
+        return self.messages
+    def get_messages_for_api(self) -> List[Dict[str, str]]:
+        """Get messages formatted for API calls (without timestamps)."""
+        return [{"role": m["role"], "content": m["content"]} for m in self.messages]
+    def clear(self) -> None:
+        """Clear session history."""
+        self.messages = []
+        self.save()
+    def count_tokens(self) -> int:
+        """Rough token count for current session."""
+        content = "".join(m["content"] for m in self.messages)
+        return len(content) // 4  # Rough estimate
+    @staticmethod
+    def list_sessions(repo_path: Path) -> List[str]:
+        """List all available sessions for a repository."""
+        import hashlib
+        history_dir = Path.home() / ".breadcrumb" / "sessions"
+        if not history_dir.exists():
+            return []
+        repo_hash = hashlib.md5(str(repo_path.absolute()).encode()).hexdigest()[:8]
+        pattern = f"{repo_hash}_*.json"
+        sessions = []
+        for file in history_dir.glob(pattern):
+            session_name = file.stem.replace(f"{repo_hash}_", "")
+            sessions.append(session_name)
+        return sorted(sessions)
+    @staticmethod
+    def delete_session(repo_path: Path, session_name: str) -> None:
+        """Delete a named session."""
+        import hashlib
+        history_dir = Path.home() / ".breadcrumb" / "sessions"
+        repo_hash = hashlib.md5(str(repo_path.absolute()).encode()).hexdigest()[:8]
+        session_file = history_dir / f"{repo_hash}_{session_name}.json"
+        if session_file.exists():
+            session_file.unlink()

breadcrumb/ingest.py ADDED Viewed

@@ -0,0 +1,163 @@
+"""
+File ingestion and .breadcrumbignore support.
+Walks repository, respects ignore patterns, and filters code files.
+"""
+from pathlib import Path
+from typing import List, Optional
+import pathspec
+SKIP_DIRS = {
+    ".git",
+    "node_modules",
+    "__pycache__",
+    ".venv",
+    "venv",
+    "env",
+    "dist",
+    "build",
+    ".next",
+    ".nuxt",
+    "coverage",
+    "vendor",
+    "target",
+    ".cargo",
+    ".mypy_cache",
+    ".pytest_cache",
+    ".ruff_cache",
+    ".turbo",
+    "bundle.js",
+    ".DS_Store",
+}
+CODE_EXTS = {
+    ".py",
+    ".ts",
+    ".tsx",
+    ".js",
+    ".jsx",
+    ".go",
+    ".rs",
+    ".rb",
+    ".java",
+    ".cpp",
+    ".c",
+    ".h",
+    ".cs",
+    ".php",
+    ".swift",
+    ".kt",
+    ".sql",
+    ".graphql",
+    ".yaml",
+    ".yml",
+    ".toml",
+    ".json",
+    ".md",
+    ".html",
+    ".css",
+    ".scss",
+    ".vue",
+    ".svelte",
+    ".sh",
+    ".bash",
+    ".tf",
+    ".dockerfile",
+    ".makefile",
+    ".env.example",
+    ".lock",
+    ".xml",
+    ".gradle",
+}
+class FileIngester:
+    """Walks repository respecting .breadcrumbignore rules."""
+    def __init__(self, repo_path: Path):
+        self.repo_path = Path(repo_path)
+        self.spec = self._load_ignore_patterns()
+    def _load_ignore_patterns(self) -> Optional[pathspec.PathSpec]:
+        """Load .breadcrumbignore patterns if it exists."""
+        ignore_file = self.repo_path / ".breadcrumbignore"
+        if ignore_file.exists():
+            patterns = ignore_file.read_text().strip().split("\n")
+            patterns = [p.strip() for p in patterns if p.strip() and not p.startswith("#")]
+            if patterns:
+                return pathspec.PathSpec.from_lines("gitwildmatch", patterns)
+        return None
+    def _should_skip(self, path: Path) -> bool:
+        """Check if path should be skipped."""
+        # Skip by directory name (check all parents)
+        for part in path.parts:
+            if part in SKIP_DIRS:
+                return True
+        # Skip by .breadcrumbignore
+        if self.spec:
+            rel_path = path.relative_to(self.repo_path)
+            if self.spec.match_file(str(rel_path)):
+                return True
+        return False
+    def _is_code_file(self, path: Path) -> bool:
+        """Check if file is a code file we care about."""
+        return path.suffix.lower() in CODE_EXTS or path.name.lower().endswith(
+            ("dockerfile", "makefile")
+        )
+    def get_files(self) -> List[Path]:
+        """Get all code files respecting ignore patterns."""
+        files = []
+        try:
+            for path in self.repo_path.rglob("*"):
+                if path.is_dir():
+                    if self._should_skip(path):
+                        # Skip entire directory
+                        continue
+                elif path.is_file():
+                    if not self._should_skip(path) and self._is_code_file(path):
+                        files.append(path)
+        except PermissionError:
+            pass
+        return sorted(files)
+    def get_content(self, max_file_size: int = 50000, max_total: int = 180000) -> str:
+        """
+        Get concatenated file contents with size limits.
+        Large files get truncated; if total exceeds max_total, files are skipped.
+        """
+        files = self.get_files()
+        content_parts: list[str] = []
+        total_size = 0
+        for file_path in files:
+            try:
+                file_content = file_path.read_text(errors="ignore")
+                # Truncate large files
+                if len(file_content) > max_file_size:
+                    file_content = file_content[:max_file_size] + "\n... [truncated]"
+                # Check if adding this file exceeds total
+                if total_size + len(file_content) > max_total:
+                    # Indicate truncation happened
+                    content_parts.append(
+                        "\n... [context limit reached, "
+                        f"{len(files) - len(content_parts)} files skipped]"
+                    )
+                    break
+                rel_path = file_path.relative_to(self.repo_path)
+                content_parts.append(f"# {rel_path}\n{file_content}\n")
+                total_size += len(file_content)
+            except Exception:
+                pass
+        return "\n".join(content_parts)