ragtime-cli 0.2.8__py3-none-any.whl → 0.2.10__py3-none-any.whl

{ragtime_cli-0.2.8.dist-info → ragtime_cli-0.2.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ragtime-cli
-Version: 0.2.8
+Version: 0.2.10
 Summary: Local-first memory and RAG system for Claude Code - semantic search over code, docs, and team knowledge
 Author-email: Bret Martineau <bretwardjames@gmail.com>
 License-Expression: MIT
@@ -100,13 +100,16 @@ ragtime forget <memory-id>
 # Index everything (docs + code)
 ragtime index
 
+# Incremental index (only changed files - fast!)
+ragtime index  # ~8 seconds vs ~5 minutes for unchanged codebases
+
 # Index only docs
 ragtime index --type docs
 
 # Index only code (functions, classes, composables)
 ragtime index --type code
 
-# Re-index with clear (removes old entries)
+# Full re-index (removes old entries, recomputes all embeddings)
 ragtime index --clear
 
 # Semantic search across all content
@@ -244,6 +247,18 @@ conventions:
   also_search_memories: true
 ```
 
+## How Search Works
+
+Search returns **summaries with locations**, not full code:
+
+1. **What you get**: Function signatures, docstrings, class definitions
+2. **What you don't get**: Full implementations
+3. **What to do**: Use the file path + line number to read the full code
+
+This is intentional - embeddings work better on focused summaries than large code blocks. The search tells you *what exists and where*, then you read the file for details.
+
+For Claude/MCP usage: The search tool description instructs Claude to read returned file paths for full implementations before making code changes.
+
 ## Code Indexing
 
 The code indexer extracts meaningful symbols from your codebase:
@@ -251,7 +266,7 @@ The code indexer extracts meaningful symbols from your codebase:
 | Language | What Gets Indexed |
 |----------|-------------------|
 | Python | Classes, methods, functions (with docstrings) |
-| TypeScript/JS | Exported functions, classes, interfaces, types, constants |
+| TypeScript/JS | Functions, classes, interfaces, types (exported and non-exported) |
 | Vue | Components, composable usage (useXxx calls) |
 | Dart | Classes, functions, mixins, extensions |
 

{ragtime_cli-0.2.8.dist-info → ragtime_cli-0.2.10.dist-info}/RECORD

@@ -1,10 +1,10 @@
-ragtime_cli-0.2.8.dist-info/licenses/LICENSE,sha256=9A0wJs2PRDciGRH4F8JUJ-aMKYQyq_gVu2ixrXs-l5A,1070
+ragtime_cli-0.2.10.dist-info/licenses/LICENSE,sha256=9A0wJs2PRDciGRH4F8JUJ-aMKYQyq_gVu2ixrXs-l5A,1070
 src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-src/cli.py,sha256=qO7tQjzMF9wm5PmBpglCaskEzndyVMk5OMJ5tB69rCs,73978
+src/cli.py,sha256=3Cn4D1W4Wok0mJB1fiBdynnCaDo4FWJo8Zay3Tp_ycQ,73978
 src/config.py,sha256=qyn5ADjPwvQlhwSJHwzat1v449b7MKEzIHr37Q5qhCc,4497
-src/db.py,sha256=Lm3zrj-6KBw4YlSCW17fu5GlaVqrK6AFw06xaW8E-Yw,6648
-src/mcp_server.py,sha256=Ta_v8SgjTI3qXvJvJ9laOEbRqYCdHKBJXB-NmFpvFuw,20791
-src/memory.py,sha256=byzjAu2YaL9u4vNm6MLmaxeOWrg6RqRn5eJlIwxkEzA,12990
+src/db.py,sha256=dxdGNhM-0Ke8yjcp69LTPS4L5vpGue-_2HwBPNvD2bg,7101
+src/mcp_server.py,sha256=l834kmwumb9egzz5Sscfm8DdpPJLcqK7qX6a3sZ3EVk,21036
+src/memory.py,sha256=qd-29w2rfkDzr1qIzxRgi9cr7skxjw8nSKhj7qjt1v4,14506
 src/commands/audit.md,sha256=Xkucm-gfBIMalK9wf7NBbyejpsqBTUAGGlb7GxMtMPY,5137
 src/commands/create-pr.md,sha256=u6-jVkDP_6bJQp6ImK039eY9F6B9E2KlAVlvLY-WV6Q,9483
 src/commands/generate-docs.md,sha256=9W2Yy-PDyC3p5k39uEb31z5YAHkSKsQLg6gV3tLgSnQ,7015
@@ -18,8 +18,8 @@ src/commands/start.md,sha256=qoqhkMgET74DBx8YPIT1-wqCiVBUDxlmevigsCinHSY,6506
 src/indexers/__init__.py,sha256=MYoCPZUpHakMX1s2vWnc9shjWfx_X1_0JzUhpKhnKUQ,454
 src/indexers/code.py,sha256=G2TbiKbWj0e7DV5KsU8-Ggw6ziDb4zTuZ4Bu3ryV4g8,18059
 src/indexers/docs.py,sha256=nyewQ4Ug4SCuhne4TuLDlUDzz9GH2STInddj81ocz50,3555
-ragtime_cli-0.2.8.dist-info/METADATA,sha256=at8aPrC2FKRCn2MKj73K2aICXbXdqhreZb1w0M5DIwg,9875
-ragtime_cli-0.2.8.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-ragtime_cli-0.2.8.dist-info/entry_points.txt,sha256=cWLbeyMxZNbew-THS3bHXTpCRXt1EaUy5QUOXGXLjl4,75
-ragtime_cli-0.2.8.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
-ragtime_cli-0.2.8.dist-info/RECORD,,
+ragtime_cli-0.2.10.dist-info/METADATA,sha256=UeWRU7V51UjtrulR1sNF1CsH2gMA3fjn9FMtMRjOqrw,10619
+ragtime_cli-0.2.10.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+ragtime_cli-0.2.10.dist-info/entry_points.txt,sha256=cWLbeyMxZNbew-THS3bHXTpCRXt1EaUy5QUOXGXLjl4,75
+ragtime_cli-0.2.10.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+ragtime_cli-0.2.10.dist-info/RECORD,,

src/cli.py

@@ -169,7 +169,7 @@ def get_remote_branches_with_ragtime(path: Path) -> list[str]:
 
 
 @click.group()
-@click.version_option(version="0.2.8")
+@click.version_option(version="0.2.9")
 def main():
     """Ragtime - semantic search over code and documentation."""
     pass
@@ -2137,7 +2137,7 @@ def update(check: bool):
     from urllib.request import urlopen
     from urllib.error import URLError
 
-    current = "0.2.8"
+    current = "0.2.9"
 
     click.echo(f"Current version: {current}")
     click.echo("Checking PyPI for updates...")

src/db.py

@@ -94,26 +94,37 @@ class RagtimeDB:
             limit: Max results to return
             type_filter: "code" or "docs" (None = both)
             namespace: Filter by namespace (for docs)
-            **filters: Additional metadata filters
+            **filters: Additional metadata filters (None values are ignored)
 
         Returns:
             List of dicts with 'content', 'metadata', 'distance'
         """
-        where = {}
+        # Build list of filter conditions, excluding None values
+        conditions = []
 
         if type_filter:
-            where["type"] = type_filter
+            conditions.append({"type": type_filter})
 
         if namespace:
-            where["namespace"] = namespace
+            conditions.append({"namespace": namespace})
 
+        # Add any additional filters, but skip None values
         for key, value in filters.items():
-            where[key] = value
+            if value is not None:
+                conditions.append({key: value})
+
+        # ChromaDB requires $and for multiple conditions
+        if len(conditions) == 0:
+            where = None
+        elif len(conditions) == 1:
+            where = conditions[0]
+        else:
+            where = {"$and": conditions}
 
         results = self.collection.query(
             query_texts=[query],
             n_results=limit,
-            where=where if where else None,
+            where=where,
         )
 
         # Flatten results into list of dicts

src/mcp_server.py

@@ -132,7 +132,7 @@ class RagtimeMCPServer:
             },
             {
                 "name": "search",
-                "description": "Semantic search over indexed content and memories",
+                "description": "Semantic search over indexed code and docs. Returns function signatures, class definitions, and doc summaries with file paths and line numbers. IMPORTANT: Results are summaries only - use the Read tool on returned file paths to see full implementations before making code changes or decisions.",
                 "inputSchema": {
                     "type": "object",
                     "properties": {
@@ -487,7 +487,7 @@ class RagtimeMCPServer:
                         "protocolVersion": "2024-11-05",
                         "serverInfo": {
                             "name": "ragtime",
-                            "version": "0.2.8",
+                            "version": "0.2.10",
                         },
                         "capabilities": {
                             "tools": {},

src/memory.py

@@ -32,6 +32,8 @@ class Memory:
     epic: Optional[str] = None
     branch: Optional[str] = None
     supersedes: Optional[str] = None
+    # Internal: actual file path when loaded from disk (not serialized)
+    _file_path: Optional[str] = field(default=None, repr=False)
 
     def to_frontmatter(self) -> dict:
         """Convert to YAML frontmatter dict."""
@@ -71,7 +73,8 @@ class Memory:
     def to_metadata(self) -> dict:
         """Convert to metadata dict for ChromaDB."""
         meta = self.to_frontmatter()
-        meta["file"] = self.get_relative_path()
+        # Use actual file path if loaded from disk, otherwise generate it
+        meta["file"] = self._file_path if self._file_path else self.get_relative_path()
         return meta
 
     def get_relative_path(self) -> str:
@@ -107,8 +110,14 @@ class Memory:
         return slug[:40]  # Limit length
 
     @classmethod
-    def from_file(cls, path: Path) -> "Memory":
-        """Parse a memory from a markdown file with YAML frontmatter."""
+    def from_file(cls, path: Path, relative_to: Optional[Path] = None) -> "Memory":
+        """
+        Parse a memory from a markdown file with YAML frontmatter.
+
+        Args:
+            path: Full path to the markdown file
+            relative_to: Base directory to compute relative path from (for indexing)
+        """
         text = path.read_text()
 
         if not text.startswith("---"):
@@ -122,6 +131,14 @@ class Memory:
         frontmatter = yaml.safe_load(parts[1])
         content = parts[2].strip()
 
+        # Compute relative file path for indexing
+        file_path = None
+        if relative_to:
+            try:
+                file_path = str(path.relative_to(relative_to))
+            except ValueError:
+                pass  # path not relative to base, will regenerate
+
         return cls(
             id=frontmatter.get("id", str(uuid.uuid4())[:8]),
             content=content,
@@ -138,6 +155,7 @@ class Memory:
             epic=frontmatter.get("epic"),
             branch=frontmatter.get("branch"),
             supersedes=frontmatter.get("supersedes"),
+            _file_path=file_path,
         )
 
 
@@ -204,7 +222,8 @@ class MemoryStore:
         file_path = self.memory_dir / file_rel_path
 
         if file_path.exists():
-            return Memory.from_file(file_path)
+            # Pass relative_to so the memory preserves its actual file path
+            return Memory.from_file(file_path, relative_to=self.memory_dir)
 
         return None
 
@@ -283,29 +302,41 @@ class MemoryStore:
         limit: int = 100,
     ) -> list[Memory]:
         """List memories with optional filters."""
-        where = {}
+        # Build filter conditions
+        conditions = []
+        namespace_prefix = None
 
         if namespace:
             if namespace.endswith("*"):
-                # Prefix match - ChromaDB doesn't support this directly
-                # We'll filter in Python
-                pass
+                # Prefix match - filter in Python after fetching
+                namespace_prefix = namespace[:-1]
             else:
-                where["namespace"] = namespace
+                conditions.append({"namespace": namespace})
 
         if type_filter:
-            where["type"] = type_filter
+            conditions.append({"type": type_filter})
 
         if status:
-            where["status"] = status
+            conditions.append({"status": status})
 
         if component:
-            where["component"] = component
+            conditions.append({"component": component})
+
+        # Build where clause with $and if multiple conditions
+        if len(conditions) == 0:
+            where = None
+        elif len(conditions) == 1:
+            where = conditions[0]
+        else:
+            where = {"$and": conditions}
+
+        # When using prefix match, fetch more results since we'll filter some out
+        fetch_limit = limit * 5 if namespace_prefix else limit
 
         # Get from ChromaDB
         results = self.db.collection.get(
-            where=where if where else None,
-            limit=limit,
+            where=where,
+            limit=fetch_limit,
         )
 
         memories = []
@@ -314,9 +345,8 @@ class MemoryStore:
             content = results["documents"][i] if results["documents"] else ""
 
             # Handle namespace prefix filtering
-            if namespace and namespace.endswith("*"):
-                prefix = namespace[:-1]
-                if not metadata.get("namespace", "").startswith(prefix):
+            if namespace_prefix:
+                if not metadata.get("namespace", "").startswith(namespace_prefix):
                     continue
 
             memories.append(Memory(
@@ -332,6 +362,10 @@ class MemoryStore:
                 author=metadata.get("author"),
             ))
 
+            # Stop once we have enough
+            if len(memories) >= limit:
+                break
+
         return memories
 
     def store_document(self, file_path: Path, namespace: str, doc_type: str = "handoff") -> Memory:
@@ -367,7 +401,8 @@ class MemoryStore:
         count = 0
         for md_file in self.memory_dir.rglob("*.md"):
             try:
-                memory = Memory.from_file(md_file)
+                # Pass memory_dir so the actual file path is stored, not regenerated
+                memory = Memory.from_file(md_file, relative_to=self.memory_dir)
                 self.db.upsert(
                     ids=[memory.id],
                     documents=[memory.content],