crackerjack 0.37.9__py3-none-any.whl → 0.45.2__py3-none-any.whl

crackerjack/models/semantic_models.py

@@ -0,0 +1,258 @@
+"""Semantic search data models for crackerjack vector store functionality."""
+
+import typing as t
+from datetime import datetime
+from pathlib import Path
+
+from pydantic import BaseModel, ConfigDict, Field, field_serializer
+
+
+class EmbeddingVector(BaseModel):
+    """Represents a single embedding vector with metadata."""
+
+    file_path: Path = Field(..., description="Path to the source file")
+    chunk_id: str = Field(..., description="Unique identifier for this chunk")
+    content: str = Field(..., description="The text content that was embedded")
+    embedding: list[float] = Field(
+        ..., description="The numerical vector representation"
+    )
+    created_at: datetime = Field(
+        default_factory=datetime.now, description="Creation timestamp"
+    )
+    file_hash: str = Field(
+        ..., description="Hash of the source file for change detection"
+    )
+    start_line: int = Field(..., description="Starting line number in the source file")
+    end_line: int = Field(..., description="Ending line number in the source file")
+    file_type: str = Field(..., description="File extension or type identifier")
+
+    model_config = ConfigDict(ser_json_timedelta="iso8601")
+
+    @field_serializer("file_path")
+    def serialize_path(self, value: Path) -> str:
+        """Serialize Path to string."""
+        return str(value)
+
+    @field_serializer("created_at")
+    def serialize_datetime(self, value: datetime) -> str:
+        """Serialize datetime to ISO format."""
+        return value.isoformat()
+
+
+class SearchResult(BaseModel):
+    """Represents a semantic search result with similarity score."""
+
+    file_path: Path = Field(..., description="Path to the matching file")
+    chunk_id: str = Field(..., description="Identifier of the matching chunk")
+    content: str = Field(..., description="The matching text content")
+    similarity_score: float = Field(
+        ..., ge=0.0, le=1.0, description="Similarity score (0-1)"
+    )
+    start_line: int = Field(..., description="Starting line number")
+    end_line: int = Field(..., description="Ending line number")
+    file_type: str = Field(..., description="File type identifier")
+    context_lines: list[str] = Field(
+        default_factory=list, description="Surrounding context lines"
+    )
+
+    @field_serializer("file_path")
+    def serialize_path(self, value: Path) -> str:
+        """Serialize Path to string."""
+        return str(value)
+
+
+class IndexStats(BaseModel):
+    """Statistics about the semantic index."""
+
+    total_files: int = Field(..., description="Total number of indexed files")
+    total_chunks: int = Field(..., description="Total number of text chunks")
+    index_size_mb: float = Field(..., description="Index size in megabytes")
+    last_updated: datetime = Field(..., description="Last index update timestamp")
+    file_types: dict[str, int] = Field(
+        default_factory=dict, description="Count by file type"
+    )
+    embedding_model: str = Field(..., description="Name of the embedding model used")
+    avg_chunk_size: float = Field(..., description="Average chunk size in characters")
+
+    @field_serializer("last_updated")
+    def serialize_datetime(self, value: datetime) -> str:
+        """Serialize datetime to ISO format."""
+        return value.isoformat()
+
+
+class SearchQuery(BaseModel):
+    """Represents a semantic search query with parameters."""
+
+    query: str = Field(..., min_length=1, description="The search query text")
+    max_results: int = Field(
+        default=10, ge=1, le=100, description="Maximum number of results"
+    )
+    min_similarity: float = Field(
+        default=0.3, ge=0.0, le=1.0, description="Minimum similarity threshold"
+    )
+    file_types: list[str] = Field(
+        default_factory=list, description="Filter by file types"
+    )
+    include_context: bool = Field(
+        default=True, description="Include surrounding context lines"
+    )
+    context_lines: int = Field(
+        default=3, ge=0, le=10, description="Number of context lines"
+    )
+
+    model_config = ConfigDict(validate_assignment=True)
+
+
+class IndexingProgress(BaseModel):
+    """Progress information for indexing operations."""
+
+    current_file: Path = Field(..., description="Currently processing file")
+    files_processed: int = Field(..., ge=0, description="Number of files processed")
+    total_files: int = Field(..., ge=0, description="Total files to process")
+    chunks_created: int = Field(..., ge=0, description="Number of chunks created")
+    elapsed_time: float = Field(..., ge=0.0, description="Elapsed time in seconds")
+    estimated_remaining: float | None = Field(
+        default=None, description="Estimated remaining time in seconds"
+    )
+
+    @property
+    def progress_percentage(self) -> float:
+        """Calculate progress as a percentage."""
+        if self.total_files == 0:
+            return 0.0
+        return min(100.0, (self.files_processed / self.total_files) * 100.0)
+
+    @field_serializer("current_file")
+    def serialize_path(self, value: Path) -> str:
+        """Serialize Path to string."""
+        return str(value)
+
+
+class SemanticConfig(BaseModel):
+    """Configuration for semantic search functionality."""
+
+    embedding_model: str = Field(
+        default="all-MiniLM-L6-v2", description="Sentence transformer model name"
+    )
+    chunk_size: int = Field(
+        default=500, ge=100, le=2000, description="Maximum characters per chunk"
+    )
+    chunk_overlap: int = Field(
+        default=50, ge=0, le=500, description="Overlap between chunks"
+    )
+    max_search_results: int = Field(
+        default=10, ge=1, le=100, description="Maximum number of search results"
+    )
+    similarity_threshold: float = Field(
+        default=0.7, ge=0.0, le=1.0, description="Minimum similarity threshold"
+    )
+    embedding_dimension: int = Field(
+        default=384, ge=128, le=1024, description="Embedding vector dimension"
+    )
+    max_file_size_mb: int = Field(
+        default=10, ge=1, le=100, description="Maximum file size to process"
+    )
+    excluded_patterns: list[str] = Field(
+        default_factory=lambda: [
+            "*.pyc",
+            "*.pyo",
+            "*.pyd",
+            "__pycache__/*",
+            ".git/*",
+            ".venv/*",
+            "*.log",
+            "*.tmp",
+        ],
+        description="File patterns to exclude from indexing",
+    )
+    included_extensions: list[str] = Field(
+        default_factory=lambda: [
+            ".py",
+            ".md",
+            ".txt",
+            ".yml",
+            ".yaml",
+            ".json",
+            ".toml",
+            ".ini",
+            ".cfg",
+            ".sh",
+            ".js",
+            ".ts",
+            ".html",
+            ".css",
+            ".sql",
+        ],
+        description="File extensions to include in indexing",
+    )
+    cache_embeddings: bool = Field(default=True, description="Cache embeddings to disk")
+    cache_ttl_hours: int = Field(
+        default=24, ge=1, le=168, description="Cache time-to-live in hours"
+    )
+
+    model_config = ConfigDict(validate_assignment=True)
+
+
+class FileChangeEvent(BaseModel):
+    """Represents a file system change event for incremental indexing."""
+
+    file_path: Path = Field(..., description="Path to the changed file")
+    event_type: t.Literal["created", "modified", "deleted"] = Field(
+        ..., description="Type of change"
+    )
+    timestamp: datetime = Field(
+        default_factory=datetime.now, description="When the change occurred"
+    )
+    file_hash: str | None = Field(
+        default=None, description="New file hash if available"
+    )
+
+    @field_serializer("file_path")
+    def serialize_path(self, value: Path) -> str:
+        """Serialize Path to string."""
+        return str(value)
+
+    @field_serializer("timestamp")
+    def serialize_datetime(self, value: datetime) -> str:
+        """Serialize datetime to ISO format."""
+        return value.isoformat()
+
+
+class SemanticContext(BaseModel):
+    """Context information for AI agents using semantic search."""
+
+    query: str = Field(..., description="The query that generated this context")
+    related_files: list[SearchResult] = Field(
+        ..., description="Semantically related files"
+    )
+    patterns: list[str] = Field(
+        default_factory=list, description="Identified code patterns"
+    )
+    suggestions: list[str] = Field(
+        default_factory=list, description="AI-generated suggestions"
+    )
+    confidence: float = Field(
+        ..., ge=0.0, le=1.0, description="Confidence in the context relevance"
+    )
+
+
+# Type aliases for better code readability
+EmbeddingMatrix = list[list[float]]
+SimilarityMatrix = list[list[float]]
+FilePathSet = set[Path]
+ChunkMapping = dict[str, EmbeddingVector]
+
+__all__ = [
+    "EmbeddingVector",
+    "SearchResult",
+    "IndexStats",
+    "SearchQuery",
+    "IndexingProgress",
+    "SemanticConfig",
+    "FileChangeEvent",
+    "SemanticContext",
+    "EmbeddingMatrix",
+    "SimilarityMatrix",
+    "FilePathSet",
+    "ChunkMapping",
+]

crackerjack/models/task.py

@@ -3,8 +3,9 @@ import typing as t
 from dataclasses import dataclass
 from enum import Enum
 
+from acb.console import Console
+from acb.depends import Inject, depends
 from pydantic import BaseModel
-from rich.console import Console
 
 
 class TaskStatus(Enum):
@@ -38,11 +39,23 @@ class HookResult:
     duration: float
     files_processed: int = 0
     issues_found: list[str] | None = None
+    issues_count: int = (
+        0  # Total count of issues (may exceed len(issues_found) if truncated)
+    )
     stage: str = "pre-commit"
+    exit_code: int | None = None  # Non-zero exit codes for failed hooks
+    error_message: str | None = None  # Error details from stderr or exceptions
+    is_timeout: bool = False  # Whether hook failed due to timeout
+    is_config_error: bool = (
+        False  # Whether failure is due to config/tool error (not code issues)
+    )
 
     def __post_init__(self) -> None:
         if self.issues_found is None:
             self.issues_found = []
+        # If issues_count not explicitly set, default to length of issues_found list
+        if self.issues_count == 0 and self.issues_found:
+            self.issues_count = len(self.issues_found)
 
 
 @dataclass
@@ -68,16 +81,18 @@ class TaskStatusData:
 
 
 class SessionTracker(BaseModel, arbitrary_types_allowed=True):
-    console: Console
     session_id: str
     start_time: float
     progress_file: t.Any = None
     tasks: dict[str, TaskStatusData] = {}
     current_task: str | None = None
     metadata: dict[str, t.Any] = {}
+    console: t.Any = None  # Console instance from DI
 
-    def __init__(self, **data: t.Any) -> None:
+    @depends.inject  # type: ignore[misc]
+    def __init__(self, console: Inject[Console], **data: t.Any) -> None:
         super().__init__(**data)
+        self.console = console
         if not self.tasks:
             self.tasks = {}
         if not self.metadata:
@@ -150,6 +165,7 @@ class SessionTracker(BaseModel, arbitrary_types_allowed=True):
             "session_id": self.session_id,
             "duration": time.time() - self.start_time,
             "total_tasks": len(self.tasks),
+            "tasks_count": len(self.tasks),
             "completed": completed,
             "failed": failed,
             "in_progress": in_progress,

crackerjack/models/test_models.py

@@ -0,0 +1,60 @@
+from dataclasses import dataclass, field
+from typing import Any
+
+
+@dataclass
+class TestFailure:
+    """Structured representation of a test failure."""
+
+    test_name: str
+    """Full test node ID (e.g., tests/test_foo.py::TestClass::test_method)"""
+
+    status: str
+    """Test status: FAILED, ERROR, or XFAIL"""
+
+    location: str
+    """File path and line number (e.g., tests/test_foo.py:42)"""
+
+    traceback: list[str] = field(default_factory=list)
+    """Full traceback lines"""
+
+    assertion: str | None = None
+    """Assertion error message if present"""
+
+    captured_stdout: str | None = None
+    """Captured stdout during test execution"""
+
+    captured_stderr: str | None = None
+    """Captured stderr during test execution"""
+
+    duration: float | None = None
+    """Test execution duration in seconds"""
+
+    short_summary: str | None = None
+    """One-line failure summary"""
+
+    locals_context: dict[str, Any] = field(default_factory=dict)
+    """Local variables at failure point (in -vvv mode)"""
+
+    def get_file_path(self) -> str:
+        """Extract file path from location."""
+        if ":" in self.location:
+            return self.location.split(":")[0]
+        return self.location
+
+    def get_line_number(self) -> int | None:
+        """Extract line number from location."""
+        if ":" in self.location:
+            try:
+                return int(self.location.split(":")[1])
+            except (ValueError, IndexError):
+                return None
+        return None
+
+    def get_relevant_traceback(self, max_lines: int = 15) -> list[str]:
+        """Get most relevant traceback lines (last N lines)."""
+        return (
+            self.traceback[-max_lines:]
+            if len(self.traceback) > max_lines
+            else self.traceback
+        )

crackerjack/monitoring/README.md

@@ -0,0 +1,11 @@
+> Crackerjack Docs: [Main](<../../README.md>) | [Crackerjack Package](<../README.md>) | [Monitoring](<./README.md>)
+
+# Monitoring
+
+Observability, metrics, and health checks.
+
+## Related
+
+- [Crackerjack Package](<../README.md>) - Parent package
+- [Events](<../events/README.md>) - Event types and signals
+- [MCP](<../mcp/README.md>) - MCP server monitoring and progress tracking

crackerjack/monitoring/ai_agent_watchdog.py

@@ -5,7 +5,8 @@ from dataclasses import dataclass, field
 from datetime import datetime, timedelta
 from pathlib import Path
 
-from rich.console import Console
+from acb.console import Console
+from acb.depends import depends
 from rich.live import Live
 from rich.table import Table
 
@@ -21,7 +22,7 @@ class AgentPerformanceMetrics:
     failed_fixes: int = 0
     average_confidence: float = 0.0
     average_execution_time: float = 0.0
-    issue_types_handled: dict[IssueType, int] = field(default_factory=dict[str, t.Any])
+    issue_types_handled: dict[IssueType, int] = field(default_factory=dict)
     recent_failures: list[str] = field(default_factory=list)
     last_successful_fix: datetime | None = None
     regression_patterns: list[str] = field(default_factory=list)
@@ -39,7 +40,7 @@ class WatchdogAlert:
 
 class AIAgentWatchdog:
     def __init__(self, console: Console | None = None):
-        self.console = console or Console()
+        self.console = console or depends.get_sync(Console)
         self.performance_metrics: dict[str, AgentPerformanceMetrics] = {}
         self.alerts: list[WatchdogAlert] = []
         self.known_regressions: set[str] = {
@@ -358,7 +359,7 @@ class AIAgentWatchdog:
 
 
 async def run_agent_monitoring_demo() -> None:
-    console = Console()
+    console = depends.get_sync(Console)
     watchdog = AIAgentWatchdog(console)
 
     from crackerjack.agents.base import AgentContext

crackerjack/monitoring/metrics_collector.py

@@ -9,10 +9,11 @@ from collections.abc import Callable
 from dataclasses import asdict, dataclass, field
 from datetime import datetime, timedelta
 
-from rich.console import Console
+from acb.console import Console
+from acb.depends import depends
 
 from crackerjack.monitoring.ai_agent_watchdog import AgentPerformanceMetrics
-from crackerjack.services.cache import CrackerjackCache
+from crackerjack.services.acb_cache_adapter import CrackerjackCache
 
 logger = logging.getLogger(__name__)
 
@@ -111,7 +112,7 @@ class MetricsCollector:
     """
 
     def __init__(self, cache: CrackerjackCache | None = None):
-        self.console = Console()
+        self.console = depends.get_sync(Console)
         self.cache = cache or CrackerjackCache()
 
         self.is_collecting = False

crackerjack/monitoring/regression_prevention.py

@@ -6,7 +6,8 @@ from datetime import datetime, timedelta
 from pathlib import Path
 from typing import Any
 
-from rich.console import Console
+from acb.console import Console
+from acb.depends import depends
 from rich.panel import Panel
 from rich.table import Table
 
@@ -40,7 +41,7 @@ class RegressionAlert:
 
 class RegressionPreventionSystem:
     def __init__(self, console: Console | None = None):
-        self.console = console or Console()
+        self.console = console or depends.get_sync(Console)
         self.known_patterns: dict[str, RegressionPattern] = {}
         self.regression_alerts: list[RegressionAlert] = []
         self.prevention_active = True
@@ -565,7 +566,7 @@ async def monitor_for_regressions(
 
 
 if __name__ == "__main__":
-    console = Console()
+    console = depends.get_sync(Console)
     system = RegressionPreventionSystem(console)
 
     console.print(system.create_prevention_dashboard())