ragtime-cli 0.2.15__py3-none-any.whl → 0.2.17__py3-none-any.whl

{ragtime_cli-0.2.15.dist-info → ragtime_cli-0.2.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ragtime-cli
-Version: 0.2.15
+Version: 0.2.17
 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
@@ -263,9 +263,38 @@ This is intentional - embeddings work better on focused summaries than large cod
 
 For Claude/MCP usage: The search tool description instructs Claude to read returned file paths for full implementations before making code changes.
 
+### Smart Query Understanding
+
+Search automatically detects qualifiers in natural language:
+
+```bash
+# These are equivalent - qualifiers are auto-detected
+ragtime search "error handling in mobile app"
+ragtime search "error handling" -r mobile
+
+# Use --raw for literal/exact search
+ragtime search "mobile error handling" --raw
+```
+
+Auto-detected qualifiers include: mobile, web, desktop, ios, android, flutter, react, vue, dart, python, typescript, auth, api, database, frontend, backend, and more.
+
+### Tiered Search
+
+Use tiered search to prioritize curated knowledge over raw code:
+
+```bash
+# Via MCP
+search(query="authentication", tiered=True)
+```
+
+Tiered search returns results in priority order:
+1. **Memories** - Curated, high-signal knowledge
+2. **Documentation** - Indexed markdown files
+3. **Code** - Function signatures and symbols
+
 ### Hybrid Search
 
-Semantic search can lose qualifiers - "error handling in mobile app" might return web app results because "error handling" dominates the embedding. Use `require_terms` to ensure specific words appear:
+For explicit keyword filtering, use `require_terms`:
 
 ```bash
 # CLI
@@ -277,6 +306,29 @@ search(query="error handling", require_terms=["mobile", "dart"])
 
 This combines semantic similarity (finds conceptually related content) with keyword filtering (ensures qualifiers aren't ignored).
 
+### Hierarchical Doc Chunking
+
+Long markdown files are automatically chunked by headers for better search accuracy:
+
+- Each section becomes a separate searchable chunk
+- Parent headers are preserved as context in the embedding
+- Short docs (<500 chars) remain as single chunks
+- Section path is stored (e.g., "Installation > Configuration > Environment Variables")
+
+### Feedback Loop
+
+Search quality improves over time based on usage patterns:
+
+```bash
+# Record when a result is useful (via MCP)
+record_feedback(query="auth flow", result_file="src/auth.py", action="used")
+
+# View usage statistics
+feedback_stats()
+```
+
+Frequently-used files receive a boost in future search rankings.
+
 ## Code Indexing
 
 The code indexer extracts meaningful symbols from your codebase:
@@ -379,13 +431,15 @@ Add to your Claude config (`.mcp.json`):
 
 Available tools:
 - `remember` - Store a memory
-- `search` - Semantic search
+- `search` - Semantic search (supports tiered mode and auto-extraction)
 - `list_memories` - List with filters
 - `get_memory` - Get by ID
 - `store_doc` - Store document verbatim
 - `forget` - Delete memory
 - `graduate` - Promote branch → app
 - `update_status` - Change memory status
+- `record_feedback` - Record when search results are used (improves future rankings)
+- `feedback_stats` - View search result usage patterns
 
 ## ghp-cli Integration
 

{ragtime_cli-0.2.15.dist-info → ragtime_cli-0.2.17.dist-info}/RECORD

@@ -1,10 +1,10 @@
-ragtime_cli-0.2.15.dist-info/licenses/LICENSE,sha256=9A0wJs2PRDciGRH4F8JUJ-aMKYQyq_gVu2ixrXs-l5A,1070
+ragtime_cli-0.2.17.dist-info/licenses/LICENSE,sha256=9A0wJs2PRDciGRH4F8JUJ-aMKYQyq_gVu2ixrXs-l5A,1070
 src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-src/cli.py,sha256=RmH3M9NvZcIO4sjYgrEJJrD-mn2mcK4dPyqaBxrhdeU,76984
+src/cli.py,sha256=69zjmItb4i3Aqeum8Ud-QdToPRx3Y5yTXyHdpUfDlCw,77249
 src/config.py,sha256=tQ6gPLr4ksn2bJPIUjtELFr-k01Eg4g-LDo3GNE6P0Q,4600
 src/db.py,sha256=eWqFGrg3O6hve67EzRJGcAsIpYxWJo4JlrAtlZUUA_s,15169
 src/feedback.py,sha256=cPw_lzusZZPvkgUxs_eV67NtV1FoCfTXUulBPnD78lo,6455
-src/mcp_server.py,sha256=QHU8jtPdA-kEzoXj88ZM0XhFvwhIngKD8Ow4plvHBfM,26498
+src/mcp_server.py,sha256=SPEfyNXTxmMKTP75WGCwzIPJhZvcwjjrqpfzzgxLQIg,26498
 src/memory.py,sha256=UiHyudKbseMMY-sdcaDSfVBMGj6sFXXw1GxBsZ7nuBc,18450
 src/commands/audit.md,sha256=Xkucm-gfBIMalK9wf7NBbyejpsqBTUAGGlb7GxMtMPY,5137
 src/commands/create-pr.md,sha256=u6-jVkDP_6bJQp6ImK039eY9F6B9E2KlAVlvLY-WV6Q,9483
@@ -19,8 +19,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=Q8krHYw0bybUyZaq1sJ0r6Fv-I_6BjTufhqI1eg_25s,9992
-ragtime_cli-0.2.15.dist-info/METADATA,sha256=J0tETjffr7XYMo3VmUwtm6SqUUnsuPVkrNpw5VYcgd8,11269
-ragtime_cli-0.2.15.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-ragtime_cli-0.2.15.dist-info/entry_points.txt,sha256=cWLbeyMxZNbew-THS3bHXTpCRXt1EaUy5QUOXGXLjl4,75
-ragtime_cli-0.2.15.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
-ragtime_cli-0.2.15.dist-info/RECORD,,
+ragtime_cli-0.2.17.dist-info/METADATA,sha256=zIbJxNyqUjHtsjLOVblwVk68k5ZsdH8q3dfG0-4O-S4,12832
+ragtime_cli-0.2.17.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+ragtime_cli-0.2.17.dist-info/entry_points.txt,sha256=cWLbeyMxZNbew-THS3bHXTpCRXt1EaUy5QUOXGXLjl4,75
+ragtime_cli-0.2.17.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+ragtime_cli-0.2.17.dist-info/RECORD,,

src/cli.py

@@ -281,7 +281,8 @@ def _upsert_entries(db, entries, entry_type: str = "docs", label: str = "  Embed
             if entry_type == "code":
                 ids = [f"{e.file_path}:{e.line_number}:{e.symbol_name}" for e in batch]
             else:
-                ids = [e.file_path for e in batch]
+                # Include chunk_index for hierarchical doc chunks
+                ids = [f"{e.file_path}:{e.chunk_index}" for e in batch]
 
             documents = [e.content for e in batch]
             metadatas = [e.to_metadata() for e in batch]
@@ -2215,8 +2216,12 @@ def update(check: bool):
     import json
     from urllib.request import urlopen
     from urllib.error import URLError
+    from importlib.metadata import version as get_version
 
-    current = "0.2.9"
+    try:
+        current = get_version("ragtime-cli")
+    except Exception:
+        current = "0.0.0"  # Fallback if not installed as package
 
     click.echo(f"Current version: {current}")
     click.echo("Checking PyPI for updates...")

src/mcp_server.py

@@ -612,7 +612,7 @@ class RagtimeMCPServer:
                         "protocolVersion": "2024-11-05",
                         "serverInfo": {
                             "name": "ragtime",
-                            "version": "0.2.15",
+                            "version": "0.2.17",
                         },
                         "capabilities": {
                             "tools": {},