kodit 0.3.0__tar.gz → 0.3.1__tar.gz

kodit-0.3.1/.claude/commands/debug.md

@@ -0,0 +1,121 @@
+# Debug Error Command
+
+Systematically debug and resolve errors in any codebase using a structured approach.
+
+## Instructions
+
+Follow this comprehensive debugging methodology to resolve: **$ARGUMENTS**
+
+1. **Error Information Gathering**
+   - Collect the complete error message, stack trace, and error code
+   - Note when the error occurs (timing, conditions, frequency)
+   - Identify the environment where the error happens (dev, staging, prod)
+   - Gather relevant logs from before and after the error
+
+2. **Reproduce the Error**
+   - Create a minimal test case that reproduces the error consistently
+   - Document the exact steps needed to trigger the error
+   - Test in different environments if possible
+   - Note any patterns or conditions that affect error occurrence
+
+3. **Stack Trace Analysis**
+   - Read the stack trace from bottom to top to understand the call chain
+   - Identify the exact line where the error originates
+   - Trace the execution path leading to the error
+   - Look for any obvious issues in the failing code
+
+4. **Code Context Investigation**
+   - Examine the code around the error location
+   - Check recent changes that might have introduced the bug
+   - Review variable values and state at the time of error
+   - Analyze function parameters and return values
+
+5. **Hypothesis Formation**
+   - Based on evidence, form hypotheses about the root cause
+   - Consider common causes:
+     - Null pointer/undefined reference
+     - Type mismatches
+     - Race conditions
+     - Resource exhaustion
+     - Logic errors
+     - External dependency failures
+
+6. **Debugging Tools Setup**
+   - Set up appropriate debugging tools for the technology stack
+   - Use debugger, profiler, or logging as needed
+   - Configure breakpoints at strategic locations
+   - Set up monitoring and alerting if not already present
+
+7. **Systematic Investigation**
+   - Test each hypothesis methodically
+   - Use binary search approach to isolate the problem
+   - Add strategic logging or print statements
+   - Check data flow and transformations step by step
+
+8. **Data Validation**
+   - Verify input data format and validity
+   - Check for edge cases and boundary conditions
+   - Validate assumptions about data state
+   - Test with different data sets to isolate patterns
+
+9. **Dependency Analysis**
+   - Check external dependencies and their versions
+   - Verify network connectivity and API availability
+   - Review configuration files and environment variables
+   - Test database connections and query execution
+
+10. **Memory and Resource Analysis**
+    - Check for memory leaks or excessive memory usage
+    - Monitor CPU and I/O resource consumption
+    - Analyze garbage collection patterns if applicable
+    - Check for resource deadlocks or contention
+
+11. **Concurrency Issues Investigation**
+    - Look for race conditions in multi-threaded code
+    - Check synchronization mechanisms and locks
+    - Analyze async operations and promise handling
+    - Test under different load conditions
+
+12. **Root Cause Identification**
+    - Once the cause is identified, understand why it happened
+    - Determine if it's a logic error, design flaw, or external issue
+    - Assess the scope and impact of the problem
+    - Consider if similar issues exist elsewhere
+
+13. **Solution Implementation**
+    - Design a fix that addresses the root cause
+    - Consider multiple solution approaches and trade-offs
+    - Implement the fix with appropriate error handling
+    - Add validation and defensive programming where needed
+
+14. **Testing the Fix**
+    - Test the fix against the original error case
+    - Test edge cases and related scenarios
+    - Run regression tests to ensure no new issues
+    - Test under various load and stress conditions
+
+15. **Prevention Measures**
+    - Add appropriate unit and integration tests
+    - Improve error handling and logging
+    - Add input validation and defensive checks
+    - Update documentation and code comments
+
+16. **Monitoring and Alerting**
+    - Set up monitoring for similar issues
+    - Add metrics and health checks
+    - Configure alerts for error thresholds
+    - Implement better observability
+
+17. **Documentation**
+    - Document the error, investigation process, and solution
+    - Update troubleshooting guides
+    - Share learnings with the team
+    - Update code comments with context
+
+18. **Post-Resolution Review**
+    - Analyze why the error wasn't caught earlier
+    - Review development and testing processes
+    - Consider improvements to prevent similar issues
+    - Update coding standards or guidelines if needed
+
+Remember to maintain detailed notes throughout the debugging process and consider the wider implications of both the error and the fix.

kodit-0.3.1/.claude/commands/refactor.md

@@ -0,0 +1,33 @@
+# Refactor Code Command
+
+Safely improve code structure while preserving functionality.
+
+## Core Principles
+
+- **Test First**: Ensure tests exist and pass before starting
+- **Small Steps**: Make incremental changes, test after each
+- **Preserve Behavior**: External functionality must remain identical
+
+## Refactoring Process
+
+1. **Analyze** - Understand current code and identify improvement areas
+2. **Test Coverage** - Verify/add tests before changing anything
+3. **Plan** - Choose refactoring technique (extract method, rename, simplify conditionals)
+4. **Execute** - Make one small change at a time, running tests after each
+5. **Verify** - Ensure all tests pass and performance hasn't degraded
+
+## Key Improvements
+
+- **Clarity**: Better names, simpler logic, shorter methods
+- **Structure**: Remove duplication, improve separation of concerns, improve cohesion
+- **Maintainability**: Apply patterns where beneficial, standardize error handling
+- **Documentation**: Update comments and docs to match changes
+
+## Safety Checklist
+
+- [ ] All tests passing before and after
+- [ ] No functionality changes
+- [ ] Code reviewed for quality
+- [ ] Changes documented
+
+Remember: Working code > perfect code. Commit frequently, refactor incrementally.

kodit-0.3.1/.claude/settings.json

@@ -0,0 +1,3 @@
+{
+    "includeCoAuthoredBy": false
+}

kodit-0.3.1/CLAUDE.md

@@ -0,0 +1,99 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Kodit is a code indexing MCP (Model Context Protocol) server that connects AI coding assistants to external codebases. It provides semantic and keyword search capabilities over indexed code snippets to improve AI-assisted development.
+
+## Development Commands
+
+### Testing
+
+- `uv run pytest src/kodit` - Run all unit tests with coverage
+- `uv run pytest tests/path/to/test.py` - Run specific test file
+- `uv run pytest -k "test_name"` - Run specific test by name
+
+### Code Quality
+
+- `uv run ruff check --fix` - Run linting
+- `uv run ruff format` - Format code
+- `uv run mypy src/` - Type checking
+
+### Application
+
+- `uv run kodit --help` - Show CLI help
+- `uv run kodit index <path>` - Index a codebase
+- `uv run kodit serve` - Start MCP server
+
+### Database
+
+- `uv run alembic upgrade head` - Apply database migrations
+- `uv run alembic revision --autogenerate -m "description"` - Generate new migration
+
+## Architecture
+
+### Domain-Driven Design Structure
+
+The codebase follows Domain-Driven Design (DDD) with clean architecture:
+
+- `domain/` - Core business logic and interfaces
+  - `entities.py` - Domain entities (Snippet, File, etc.)
+  - `repositories.py` - Repository interfaces
+  - `services/` - Domain services for business logic
+- `application/` - Application services and factories
+- `infrastructure/` - External concerns and implementations
+  - `sqlalchemy/` - Database repositories
+  - `embedding/` - Vector embedding providers
+  - `bm25/` - BM25 search implementations
+  - `indexing/` - Code indexing services
+
+### Key Components
+
+**Indexing Pipeline:**
+
+1. Clone/read source code
+2. Extract snippets using Tree-sitter
+3. Generate embeddings and BM25 indices
+4. Store in database
+
+**Search System:**
+
+- Hybrid search combining semantic (embeddings) and keyword (BM25)
+- Multiple providers: local models, OpenAI, custom APIs
+- Configurable via environment variables
+
+**MCP Server:**
+
+- FastMCP-based server exposing search tools
+- Integrates with Cursor, Cline, and other AI assistants
+
+## Configuration
+
+Key environment variables:
+
+- `KODIT_EMBEDDING_PROVIDER` - embedding provider (local/openai)
+- `KODIT_DATABASE_URL` - database connection string
+- `KODIT_OPENAI_API_KEY` - for OpenAI embeddings
+- `KODIT_LOG_LEVEL` - logging level
+
+See `config.py` for full configuration options.
+
+## Database
+
+Uses SQLAlchemy with async support. Supports:
+
+- SQLite (default, local development)
+- PostgreSQL with Vectorchord (production)
+
+Migrations managed with Alembic in `migrations/` directory. DO NOT EDIT THESE FILES.
+
+## Testing Strategy
+
+- Unit tests for domain services and repositories
+- Integration tests for database operations
+- E2E tests for full indexing pipeline
+- Smoke tests for deployment validation
+- Performance tests for similarity search
+
+Test files mirror source structure under `tests/` directory.

{kodit-0.3.0 → kodit-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kodit
-Version: 0.3.0
+Version: 0.3.1
 Summary: Code indexing for better AI code generation
 Project-URL: Homepage, https://docs.helixml.tech/kodit/
 Project-URL: Documentation, https://docs.helixml.tech/kodit/
@@ -83,7 +83,7 @@ If you're an engineer working with AI-powered coding assistants, Kodit helps by
 providing relevant and up-to-date examples of your task so that LLMs make less mistakes
 and produce fewer hallucinations.
 
-## ✨ Features
+## Features
 
 ### Codebase Indexing
 
@@ -94,7 +94,11 @@ code. This index is used to build a snippet library, ready for ingestion into an
 - Build comprehensive snippet libraries for LLM ingestion
 - Support for multiple codebase types and languages
 - Efficient indexing and search capabilities
-- Privacy first: respects .gitignore and .noindex files.
+- Privacy first: respects .gitignore and .noindex files
+- **NEW in 0.3**: Auto-indexing configuration for shared server deployments
+- **NEW in 0.3**: Enhanced Git provider support including Azure DevOps
+- **NEW in 0.3**: Index private repositories via a PAT
+- **NEW in 0.3**: Improved progress monitoring and reporting during indexing
 
 ### MCP Server
 
@@ -107,6 +111,7 @@ intent. Kodit has been tested to work well with:
   - [Cursor](https://docs.helix.ml/kodit/getting-started/integration/#integration-with-cursor)
   - [Cline](https://docs.helix.ml/kodit/getting-started/integration/#integration-with-cline)
 - Please contribute more instructions! ... any other assistant is likely to work ...
+- **New in 0.3**: Filter snippets by source, language, author or timestamp.
 
 ### Enterprise Ready
 
@@ -127,7 +132,12 @@ Supported providers:
 - Secure, private LLM enclave with [Helix](https://helix.ml).
 - Any other OpenAI compatible API
 
-## 🚀 Quick Start
+**NEW in 0.3**: Enhanced deployment options:
+
+- Docker Compose configurations with VectorChord
+- Kubernetes manifests for production deployments
+
+## Quick Start
 
 1. [Install Kodit](https://docs.helix.ml/kodit/getting-started/installation/)
 2. [Index codebases](https://docs.helix.ml/kodit/getting-started/quick-start/)

{kodit-0.3.0 → kodit-0.3.1}/README.md

@@ -30,7 +30,7 @@ If you're an engineer working with AI-powered coding assistants, Kodit helps by
 providing relevant and up-to-date examples of your task so that LLMs make less mistakes
 and produce fewer hallucinations.
 
-## ✨ Features
+## Features
 
 ### Codebase Indexing
 
@@ -41,7 +41,11 @@ code. This index is used to build a snippet library, ready for ingestion into an
 - Build comprehensive snippet libraries for LLM ingestion
 - Support for multiple codebase types and languages
 - Efficient indexing and search capabilities
-- Privacy first: respects .gitignore and .noindex files.
+- Privacy first: respects .gitignore and .noindex files
+- **NEW in 0.3**: Auto-indexing configuration for shared server deployments
+- **NEW in 0.3**: Enhanced Git provider support including Azure DevOps
+- **NEW in 0.3**: Index private repositories via a PAT
+- **NEW in 0.3**: Improved progress monitoring and reporting during indexing
 
 ### MCP Server
 
@@ -54,6 +58,7 @@ intent. Kodit has been tested to work well with:
   - [Cursor](https://docs.helix.ml/kodit/getting-started/integration/#integration-with-cursor)
   - [Cline](https://docs.helix.ml/kodit/getting-started/integration/#integration-with-cline)
 - Please contribute more instructions! ... any other assistant is likely to work ...
+- **New in 0.3**: Filter snippets by source, language, author or timestamp.
 
 ### Enterprise Ready
 
@@ -74,7 +79,12 @@ Supported providers:
 - Secure, private LLM enclave with [Helix](https://helix.ml).
 - Any other OpenAI compatible API
 
-## 🚀 Quick Start
+**NEW in 0.3**: Enhanced deployment options:
+
+- Docker Compose configurations with VectorChord
+- Kubernetes manifests for production deployments
+
+## Quick Start
 
 1. [Install Kodit](https://docs.helix.ml/kodit/getting-started/installation/)
 2. [Index codebases](https://docs.helix.ml/kodit/getting-started/quick-start/)

{kodit-0.3.0 → kodit-0.3.1}/docs/_index.md

@@ -40,7 +40,7 @@ If you're an engineer working with AI-powered coding assistants, Kodit helps by
 providing relevant and up-to-date examples of your task so that LLMs make less mistakes
 and produce fewer hallucinations.
 
-## ✨ Features
+## Features
 
 ### Codebase Indexing
 
@@ -51,7 +51,11 @@ code. This index is used to build a snippet library, ready for ingestion into an
 - Build comprehensive snippet libraries for LLM ingestion
 - Support for multiple codebase types and languages
 - Efficient indexing and search capabilities
-- Privacy first: respects .gitignore and .noindex files.
+- Privacy first: respects .gitignore and .noindex files
+- **NEW in 0.3**: Auto-indexing configuration for shared server deployments
+- **NEW in 0.3**: Enhanced Git provider support including Azure DevOps
+- **NEW in 0.3**: Index private repositories via a PAT
+- **NEW in 0.3**: Improved progress monitoring and reporting during indexing
 
 ### MCP Server
 
@@ -64,6 +68,7 @@ intent. Kodit has been tested to work well with:
   - [Cursor](./getting-started/integration/index.md#integration-with-cursor)
   - [Cline](./getting-started/integration/index.md#integration-with-cline)
 - Please contribute more instructions! ... any other assistant is likely to work ...
+- **New in 0.3**: Filter snippets by source, language, author or timestamp.
 
 ### Enterprise Ready
 
@@ -84,6 +89,11 @@ Supported providers:
 - Secure, private LLM enclave with [Helix](https://helix.ml).
 - Any other OpenAI compatible API
 
+**NEW in 0.3**: Enhanced deployment options:
+
+- Docker Compose configurations with VectorChord
+- Kubernetes manifests for production deployments
+
 ## Roadmap
 
 The roadmap is currently maintained as a [Github Project](https://github.com/orgs/helixml/projects/4).

{kodit-0.3.0 → kodit-0.3.1}/src/kodit/_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.3.0'
-__version_tuple__ = version_tuple = (0, 3, 0)
+__version__ = version = '0.3.1'
+__version_tuple__ = version_tuple = (0, 3, 1)

{kodit-0.3.0 → kodit-0.3.1}/src/kodit/application/services/code_indexing_application_service.py

@@ -27,7 +27,6 @@ from kodit.domain.value_objects import (
     MultiSearchResult,
     SearchRequest,
     SearchResult,
-    SnippetListItem,
 )
 from kodit.log import log_event
 from kodit.reporting import Reporter
@@ -225,17 +224,17 @@ class CodeIndexingApplicationService:
 
         return [
             MultiSearchResult(
-                id=snippet["id"],
-                uri=file["uri"],
-                content=snippet["content"],
+                id=result.snippet.id,
+                uri=result.file.uri,
+                content=result.snippet.content,
                 original_scores=fr.original_scores,
             )
-            for (file, snippet), fr in zip(search_results, final_results, strict=True)
+            for result, fr in zip(search_results, final_results, strict=True)
         ]
 
     async def list_snippets(
         self, file_path: str | None = None, source_uri: str | None = None
-    ) -> list[SnippetListItem]:
+    ) -> list[MultiSearchResult]:
         """List snippets with optional filtering."""
         log_event("kodit.index.list_snippets")
         return await self.snippet_domain_service.list_snippets(file_path, source_uri)

{kodit-0.3.0 → kodit-0.3.1}/src/kodit/cli.py

@@ -260,12 +260,7 @@ async def code(  # noqa: PLR0913
         return
 
     for snippet in snippets:
-        click.echo("-" * 80)
-        click.echo(f"{snippet.uri}")
-        click.echo(f"Original scores: {snippet.original_scores}")
-        click.echo(snippet.content)
-        click.echo("-" * 80)
-        click.echo()
+        click.echo(str(snippet))
 
 
 @search.command()
@@ -322,12 +317,7 @@ async def keyword(  # noqa: PLR0913
         return
 
     for snippet in snippets:
-        click.echo("-" * 80)
-        click.echo(f"{snippet.uri}")
-        click.echo(f"Original scores: {snippet.original_scores}")
-        click.echo(snippet.content)
-        click.echo("-" * 80)
-        click.echo()
+        click.echo(str(snippet))
 
 
 @search.command()
@@ -387,12 +377,7 @@ async def text(  # noqa: PLR0913
         return
 
     for snippet in snippets:
-        click.echo("-" * 80)
-        click.echo(f"{snippet.uri}")
-        click.echo(f"Original scores: {snippet.original_scores}")
-        click.echo(snippet.content)
-        click.echo("-" * 80)
-        click.echo()
+        click.echo(str(snippet))
 
 
 @search.command()
@@ -462,12 +447,7 @@ async def hybrid(  # noqa: PLR0913
         return
 
     for snippet in snippets:
-        click.echo("-" * 80)
-        click.echo(f"{snippet.uri}")
-        click.echo(f"Original scores: {snippet.original_scores}")
-        click.echo(snippet.content)
-        click.echo("-" * 80)
-        click.echo()
+        click.echo(str(snippet))
 
 
 @cli.group()
@@ -499,9 +479,7 @@ async def snippets(
     )
     snippets = await service.list_snippets(file_path=by_path, source_uri=by_source)
     for snippet in snippets:
-        click.echo(f"{snippet.id}: [{snippet.source_uri}] {snippet.file_path}")
-        click.echo(f"  {snippet.content}")
-        click.echo()
+        click.echo(str(snippet))
 
 
 @cli.command()

{kodit-0.3.0 → kodit-0.3.1}/src/kodit/config.py

@@ -9,7 +9,12 @@ from typing import TYPE_CHECKING, Any, Literal, TypeVar
 
 import click
 from pydantic import BaseModel, Field, field_validator
-from pydantic_settings import BaseSettings, SettingsConfigDict
+from pydantic_settings import (
+    BaseSettings,
+    EnvSettingsSource,
+    PydanticBaseSettingsSource,
+    SettingsConfigDict,
+)
 
 if TYPE_CHECKING:
     from collections.abc import Callable, Coroutine
@@ -57,7 +62,7 @@ class AutoIndexingConfig(BaseModel):
 
     @field_validator("sources", mode="before")
     @classmethod
-    def parse_sources(cls, v: Any) -> list[AutoIndexingSource]:
+    def parse_sources(cls, v: Any) -> Any:
         """Parse sources from environment variables or other formats."""
         if v is None:
             return []
@@ -76,6 +81,36 @@ class AutoIndexingConfig(BaseModel):
         return v
 
 
+class CustomAutoIndexingEnvSource(EnvSettingsSource):
+    """Custom environment source for parsing AutoIndexingConfig."""
+
+    def __call__(self) -> dict[str, Any]:
+        """Load settings from env vars with custom auto-indexing parsing."""
+        d: dict[str, Any] = {}
+
+        # First get the standard env vars
+        env_vars = super().__call__()
+        d.update(env_vars)
+
+        # Custom parsing for auto-indexing sources
+        auto_indexing_sources = []
+        i = 0
+        while True:
+            # Note: env_vars keys are lowercase due to Pydantic Settings normalization
+            uri_key = f"auto_indexing_sources_{i}_uri"
+            if uri_key in self.env_vars:
+                uri_value = self.env_vars[uri_key]
+                auto_indexing_sources.append({"uri": uri_value})
+                i += 1
+            else:
+                break
+
+        if auto_indexing_sources:
+            d["auto_indexing"] = {"sources": auto_indexing_sources}
+
+        return d
+
+
 class AppContext(BaseSettings):
     """Global context for the kodit project. Provides a shared state for the app."""
 
@@ -83,10 +118,35 @@ class AppContext(BaseSettings):
         env_file=".env",
         env_file_encoding="utf-8",
         env_nested_delimiter="_",
+        env_nested_max_split=1,
         nested_model_default_partial_update=True,
         extra="ignore",
     )
 
+    @classmethod
+    def settings_customise_sources(
+        cls,
+        settings_cls: type[BaseSettings],
+        init_settings: PydanticBaseSettingsSource,
+        env_settings: PydanticBaseSettingsSource,  # noqa: ARG003
+        dotenv_settings: PydanticBaseSettingsSource,
+        file_secret_settings: PydanticBaseSettingsSource,
+    ) -> tuple[PydanticBaseSettingsSource, ...]:
+        """Customize settings sources to use custom auto-indexing parsing."""
+        custom_env_settings = CustomAutoIndexingEnvSource(
+            settings_cls,
+            env_nested_delimiter=settings_cls.model_config.get("env_nested_delimiter"),
+            env_ignore_empty=settings_cls.model_config.get("env_ignore_empty", False),
+            env_parse_none_str=settings_cls.model_config.get("env_parse_none_str", ""),
+            env_parse_enums=settings_cls.model_config.get("env_parse_enums", None),
+        )
+        return (
+            init_settings,
+            custom_env_settings,
+            dotenv_settings,
+            file_secret_settings,
+        )
+
     data_dir: Path = Field(default=DEFAULT_BASE_DIR)
     db_url: str = Field(default=DEFAULT_DB_URL)
     log_level: str = Field(default=DEFAULT_LOG_LEVEL)
@@ -142,8 +202,6 @@ class AppContext(BaseSettings):
 
 with_app_context = click.make_pass_decorator(AppContext)
 
-T = TypeVar("T")
-
 
 def wrap_async(f: Callable[..., Coroutine[Any, Any, T]]) -> Callable[..., T]:
     """Decorate async Click commands.

{kodit-0.3.0 → kodit-0.3.1}/src/kodit/domain/services/indexing_service.py

@@ -8,6 +8,7 @@ from kodit.domain.value_objects import (
     FusionResult,
     IndexCreateRequest,
     IndexView,
+    SnippetWithFile,
 )
 
 
@@ -51,7 +52,7 @@ class IndexRepository(ABC):
         """Update the content of an existing snippet."""
 
     @abstractmethod
-    async def list_snippets_by_ids(self, ids: list[int]) -> list[tuple[dict, dict]]:
+    async def list_snippets_by_ids(self, ids: list[int]) -> list[SnippetWithFile]:
         """List snippets by IDs."""
 
 
@@ -190,14 +191,14 @@ class IndexingDomainService:
         """
         return self.fusion_service.reciprocal_rank_fusion(rankings, k)
 
-    async def get_snippets_by_ids(self, ids: list[int]) -> list[tuple[dict, dict]]:
+    async def get_snippets_by_ids(self, ids: list[int]) -> list[SnippetWithFile]:
         """Get snippets by IDs.
 
         Args:
             ids: List of snippet IDs to retrieve.
 
         Returns:
-            List of (file, snippet) tuples.
+            List of SnippetWithFile objects containing file and snippet information.
 
         """
         return await self.index_repository.list_snippets_by_ids(ids)

{kodit-0.3.0 → kodit-0.3.1}/src/kodit/domain/services/snippet_service.py

@@ -14,6 +14,7 @@ from kodit.domain.services.snippet_extraction_service import (
 )
 from kodit.domain.value_objects import (
     MultiSearchRequest,
+    MultiSearchResult,
     SnippetExtractionRequest,
     SnippetListItem,
 )
@@ -170,7 +171,7 @@ class SnippetDomainService:
 
     async def list_snippets(
         self, file_path: str | None = None, source_uri: str | None = None
-    ) -> list[SnippetListItem]:
+    ) -> list[MultiSearchResult]:
         """List snippets with optional filtering.
 
         Args:
@@ -178,10 +179,22 @@ class SnippetDomainService:
             source_uri: Optional source URI to filter by
 
         Returns:
-            List of snippet items matching the criteria
+            List of search results matching the criteria
 
         """
-        return list(await self.snippet_repository.list_snippets(file_path, source_uri))
+        snippet_items = await self.snippet_repository.list_snippets(
+            file_path, source_uri
+        )
+        # Convert SnippetListItem to MultiSearchResult for unified display format
+        return [
+            MultiSearchResult(
+                id=item.id,
+                uri=item.source_uri,
+                content=item.content,
+                original_scores=[],
+            )
+            for item in snippet_items
+        ]
 
     def _should_process_file(self, file: Any) -> bool:
         """Check if a file should be processed for snippet extraction.