ragtime-cli 0.2.2__py3-none-any.whl → 0.2.4__py3-none-any.whl

{ragtime_cli-0.2.2.dist-info → ragtime_cli-0.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ragtime-cli
-Version: 0.2.2
+Version: 0.2.4
 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
@@ -37,8 +37,12 @@ Local-first memory and RAG system for Claude Code. Semantic search over code, do
 - **Memory Storage**: Store structured knowledge with namespaces, types, and metadata
 - **Semantic Search**: Query memories and docs with natural language
 - **Cross-Branch Sync**: Share context with teammates before PRs merge
+- **Convention Checking**: Verify code follows team standards before PRs
+- **Doc Generation**: Generate documentation from code (stubs or AI-powered)
+- **Debug Tools**: Verify index integrity, inspect similarity scores
 - **MCP Server**: Native Claude Code integration
-- **Claude Commands**: Pre-built `/remember`, `/recall`, `/handoff`, `/start` commands
+- **Claude Commands**: Pre-built `/remember`, `/recall`, `/create-pr`, `/generate-docs` commands
+- **ghp-cli Integration**: Auto-context when starting issues
 
 ## Installation
 
@@ -52,6 +56,9 @@ pip install ragtime-cli
 # Initialize in your project
 ragtime init
 
+# Index your docs
+ragtime index
+
 # Store a memory
 ragtime remember "Auth uses JWT with 15-min expiry" \
   --namespace app \
@@ -63,6 +70,9 @@ ragtime search "authentication" --namespace app
 
 # Install Claude commands
 ragtime install --workspace
+
+# Check for updates
+ragtime update --check
 ```
 
 ## CLI Commands
@@ -94,19 +104,75 @@ ragtime search "how does auth work" --namespace app --limit 10
 
 # Reindex memory files
 ragtime reindex
+
+# Audit docs for missing frontmatter
+ragtime audit docs/
+ragtime audit docs/ --fix    # Interactively add frontmatter
+ragtime audit docs/ --json   # Machine-readable output
+```
+
+### Documentation Generation
+
+```bash
+# Generate doc stubs from code
+ragtime generate src/ --stubs
+
+# Specify output location
+ragtime generate src/ --stubs -o docs/api
+
+# Python only
+ragtime generate src/ --stubs -l python
+
+# Include private methods
+ragtime generate src/ --stubs --include-private
+```
+
+### Debug & Verification
+
+```bash
+# Debug a search query (show similarity scores)
+ragtime debug search "authentication"
+ragtime debug search "auth" --show-vectors
+
+# Find similar documents
+ragtime debug similar docs/auth/jwt.md
+
+# Index statistics by namespace/type
+ragtime debug stats
+ragtime debug stats --by-namespace
+ragtime debug stats --by-type
+
+# Verify index integrity
+ragtime debug verify
 ```
 
 ### Cross-Branch Sync
 
 ```bash
-# Sync teammate's branch memories
-ragtime sync origin/jm/feature-auth
+# Sync all teammate branch memories
+ragtime sync
 
-# Clean up stale synced folders
+# Auto-prune stale synced folders
+ragtime sync --auto-prune
+
+# Manual prune
 ragtime prune --dry-run
 ragtime prune
 ```
 
+### Daemon (Auto-Sync)
+
+```bash
+# Start background sync daemon
+ragtime daemon start --interval 5m
+
+# Check status
+ragtime daemon status
+
+# Stop daemon
+ragtime daemon stop
+```
+
 ### Claude Integration
 
 ```bash
@@ -118,48 +184,47 @@ ragtime install --global
 
 # List available commands
 ragtime install --list
-```
 
-## MCP Server
-
-Add to your Claude config (`.mcp.json`):
-
-```json
-{
-  "mcpServers": {
-    "ragtime": {
-      "command": "ragtime-mcp",
-      "args": ["--path", "."]
-    }
-  }
-}
+# Set up ghp-cli hooks
+ragtime setup-ghp
 ```
 
-Available tools:
-- `remember` - Store a memory
-- `search` - Semantic search
-- `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
-
 ## Storage Structure
 
 ```
-.claude/memory/
-├── app/{component}/            # Graduated app knowledge
+.ragtime/
+├── config.yaml              # Configuration
+├── CONVENTIONS.md           # Team rules (checked by /create-pr)
+├── app/{component}/         # Graduated app knowledge (tracked)
 │   └── {id}-{slug}.md
-├── team/                       # Team conventions
+├── team/                    # Team conventions (tracked)
 │   └── {id}-{slug}.md
-├── users/{username}/           # User preferences
-│   └── {id}-{slug}.md
-└── branches/
-    ├── {branch-slug}/          # Your branch (tracked in git)
-    │   ├── context.md          # Session handoff
-    │   └── {id}-{slug}.md
-    └── {branch}(unmerged)/     # Synced from teammates (gitignored)
+├── branches/
+│   ├── {branch-slug}/       # Your branch (tracked in git)
+│   │   ├── context.md
+│   │   └── {id}-{slug}.md
+│   └── .{branch-slug}/      # Synced from teammates (gitignored, dot-prefix)
+├── archive/branches/        # Archived completed branches (tracked)
+└── index/                   # ChromaDB vector store (gitignored)
+```
+
+## Configuration
+
+`.ragtime/config.yaml`:
+
+```yaml
+docs:
+  paths: ["docs", ".ragtime"]
+  patterns: ["**/*.md"]
+  exclude: ["**/node_modules/**"]
+
+code:
+  paths: ["."]
+  languages: ["python", "typescript", "dart"]
+
+conventions:
+  files: [".ragtime/CONVENTIONS.md"]
+  also_search_memories: true
 ```
 
 ## Memory Format
@@ -174,7 +239,7 @@ type: architecture
 component: auth
 confidence: high
 status: active
-added: '2026-01-31'
+added: '2025-01-31'
 author: bretwardjames
 ---
 
@@ -200,6 +265,7 @@ Sessions are stored in Redis, not cookies.
 | `decision` | Why we chose X over Y |
 | `convention` | Team standards |
 | `pattern` | Reusable approaches |
+| `integration` | External service connections |
 | `context` | Session handoff |
 
 ## Claude Commands
@@ -212,8 +278,79 @@ After `ragtime install --workspace`:
 | `/recall` | Search memories |
 | `/handoff` | Save session context |
 | `/start` | Resume work on an issue |
-| `/pr-graduate` | Curate branch knowledge after merge |
-| `/audit` | Find duplicates/conflicts |
+| `/create-pr` | Check conventions, graduate memories, create PR |
+| `/generate-docs` | AI-powered documentation generation from code |
+| `/import-docs` | Migrate existing docs to memories |
+| `/pr-graduate` | Curate branch knowledge (fallback if forgot before PR) |
+| `/audit` | Find duplicates/conflicts in memories |
+
+## MCP Server
+
+Add to your Claude config (`.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "ragtime": {
+      "command": "ragtime-mcp",
+      "args": ["--path", "."]
+    }
+  }
+}
+```
+
+Available tools:
+- `remember` - Store a memory
+- `search` - Semantic search
+- `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
+
+## ghp-cli Integration
+
+If you use [ghp-cli](https://github.com/bretwardjames/ghp-cli):
+
+```bash
+# Register ragtime hooks
+ragtime setup-ghp
+```
+
+This auto-creates `context.md` from issue details when you run `ghp start`.
+
+## Workflow
+
+### Starting Work
+
+```bash
+ghp start 123              # Creates branch + context.md
+# or
+ragtime new-branch 123     # Just the context
+```
+
+### During Development
+
+```bash
+/remember "API uses rate limiting"   # Capture insights
+/handoff                              # Save progress for later
+```
+
+### Before PR
+
+```bash
+/create-pr
+# 1. Checks code against CONVENTIONS.md
+# 2. Reviews branch memories
+# 3. Graduates selected memories to app/
+# 4. Commits knowledge with code
+# 5. Creates PR
+```
+
+### After Merge
+
+Graduated knowledge is already in the PR. Run `ragtime prune` to clean up synced folders.
 
 ## License
 

{ragtime_cli-0.2.2.dist-info → ragtime_cli-0.2.4.dist-info}/RECORD

@@ -1,22 +1,24 @@
-ragtime_cli-0.2.2.dist-info/licenses/LICENSE,sha256=9A0wJs2PRDciGRH4F8JUJ-aMKYQyq_gVu2ixrXs-l5A,1070
+ragtime_cli-0.2.4.dist-info/licenses/LICENSE,sha256=9A0wJs2PRDciGRH4F8JUJ-aMKYQyq_gVu2ixrXs-l5A,1070
 src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-src/cli.py,sha256=bjLpugyxTB3h6Ir-D5eHilYmKGhx1sa4r8K_ZXiqaO8,44717
-src/config.py,sha256=_zSMnGSO8uFFF8Was_Jtm2m1JDPGhT3Lh8Zz2rcQs98,3232
+src/cli.py,sha256=iNCYKD6w1gi64eNeb8BFj-xPzVnQLqHMzmPzoRGE3tI,67135
+src/config.py,sha256=kaJV-7yI-LMW16e1w6JvM1ZCjgPf8EiBBOM4OXio6I8,4045
 src/db.py,sha256=BKrlhilXYHNaj-ZcffinSXVhdUqowmwpFPBx7aLxamU,4642
 src/mcp_server.py,sha256=Tx0i73GXO0YmcVrdO7UjRMS0auN8fBG2LOpHuf_LUC0,20374
 src/memory.py,sha256=POT2lYeBcEx4_MPbsIdet6ScwcjmuETz8Dxmz-Z_7IY,11939
 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
 src/commands/handoff.md,sha256=8VxTddtW08jGTW36GW_rS77JdeSn8vHeMfklrWwVUD4,5055
 src/commands/import-docs.md,sha256=ByIdcfbdiF77HoFv5U6zZ_YvZf00-hAs9EMconXssvY,6927
-src/commands/pr-graduate.md,sha256=TdqcIwtemrvLbbbUw-mY7hvixjOSh8H_L-63_QsAtpI,6455
+src/commands/pr-graduate.md,sha256=nXJMuXeOp0SZfjQ567NUO02Rg9zPQHQFbZbJ4Q_His0,6692
 src/commands/recall.md,sha256=unQPWsmocKRoQR7jRtjrj8aVcMHverjGR6u5mYL8TLw,6008
 src/commands/remember.md,sha256=nNewsUhIqF4wtD1jhVDZvmLZjdcmPN6NmUM43SdWepc,5368
 src/commands/save.md,sha256=7gTpW46AU9Y4l8XVZ8f4h1sEdBfVqIRA7hlidUxMAC4,251
 src/commands/start.md,sha256=qoqhkMgET74DBx8YPIT1-wqCiVBUDxlmevigsCinHSY,6506
 src/indexers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/indexers/docs.py,sha256=7FENHaKSvC1T557bRzvmrjyaG_vK94GuQG9XMZdr89w,3349
-ragtime_cli-0.2.2.dist-info/METADATA,sha256=TqC9Yyq8QFFSxwXnJaRAMxnW3PttYEyoGkRhowwouLo,5311
-ragtime_cli-0.2.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-ragtime_cli-0.2.2.dist-info/entry_points.txt,sha256=cWLbeyMxZNbew-THS3bHXTpCRXt1EaUy5QUOXGXLjl4,75
-ragtime_cli-0.2.2.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
-ragtime_cli-0.2.2.dist-info/RECORD,,
+ragtime_cli-0.2.4.dist-info/METADATA,sha256=VtuTNejyKDZqNrVuC5tJGNHWDHVrIY-2Pk1-k0NlwWY,8383
+ragtime_cli-0.2.4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+ragtime_cli-0.2.4.dist-info/entry_points.txt,sha256=cWLbeyMxZNbew-THS3bHXTpCRXt1EaUy5QUOXGXLjl4,75
+ragtime_cli-0.2.4.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+ragtime_cli-0.2.4.dist-info/RECORD,,