ragtime-cli 0.2.3__py3-none-any.whl → 0.2.5__py3-none-any.whl

ragtime_cli-0.2.5.dist-info/METADATA

@@ -0,0 +1,402 @@
+Metadata-Version: 2.4
+Name: ragtime-cli
+Version: 0.2.5
+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
+Project-URL: Homepage, https://github.com/bretwardjames/ragtime
+Project-URL: Repository, https://github.com/bretwardjames/ragtime
+Project-URL: Issues, https://github.com/bretwardjames/ragtime/issues
+Keywords: claude,rag,memory,mcp,ai,llm,semantic-search,vector-database
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Text Processing :: Indexing
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: chromadb>=0.4.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: click>=8.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# ragtime-cli
+
+Local-first memory and RAG system for Claude Code. Semantic search over code, docs, and team knowledge.
+
+## Features
+
+- **Memory Storage**: Store structured knowledge with namespaces, types, and metadata
+- **Semantic Search**: Query memories, docs, and code with natural language
+- **Code Indexing**: Index functions, classes, and composables from Python, TypeScript, Vue, and Dart
+- **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`, `/create-pr`, `/generate-docs` commands
+- **ghp-cli Integration**: Auto-context when starting issues
+
+## Installation
+
+```bash
+pip install ragtime-cli
+```
+
+## Quick Start
+
+```bash
+# 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 \
+  --type architecture \
+  --component auth
+
+# Search memories
+ragtime search "authentication" --namespace app
+
+# Install Claude commands
+ragtime install --workspace
+
+# Check for updates
+ragtime update --check
+```
+
+## CLI Commands
+
+### Memory Storage
+
+```bash
+# Store a memory
+ragtime remember "content" --namespace app --type architecture --component auth
+
+# List memories
+ragtime memories --namespace app --type decision
+
+# Graduate branch memory to app
+ragtime graduate <memory-id>
+
+# Delete a memory
+ragtime forget <memory-id>
+```
+
+### Search & Indexing
+
+```bash
+# Index everything (docs + code)
+ragtime index
+
+# Index only docs
+ragtime index --type docs
+
+# Index only code (functions, classes, composables)
+ragtime index --type code
+
+# Re-index with clear (removes old entries)
+ragtime index --clear
+
+# Semantic search across all content
+ragtime search "how does auth work" --limit 10
+
+# Search only code
+ragtime search "useAsyncState" --type code
+
+# Search only docs
+ragtime search "authentication" --type docs --namespace app
+
+# 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 all teammate branch memories
+ragtime sync
+
+# 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
+# Install Claude commands to workspace
+ragtime install --workspace
+
+# Install globally
+ragtime install --global
+
+# List available commands
+ragtime install --list
+
+# Set up ghp-cli hooks
+ragtime setup-ghp
+```
+
+## Storage Structure
+
+```
+.ragtime/
+├── config.yaml              # Configuration
+├── CONVENTIONS.md           # Team rules (checked by /create-pr)
+├── app/{component}/         # Graduated app knowledge (tracked)
+│   └── {id}-{slug}.md
+├── team/                    # Team conventions (tracked)
+│   └── {id}-{slug}.md
+├── 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", "javascript", "vue", "dart"]
+  exclude: ["**/node_modules/**", "**/build/**", "**/dist/**"]
+
+conventions:
+  files: [".ragtime/CONVENTIONS.md"]
+  also_search_memories: true
+```
+
+## Code Indexing
+
+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 |
+| Vue | Components, composable usage (useXxx calls) |
+| Dart | Classes, functions, mixins, extensions |
+
+Each symbol is indexed with:
+- **content**: The code snippet with signature and docstring
+- **file**: Full path to the source file
+- **line**: Line number for quick navigation
+- **symbol_name**: Searchable name (e.g., `useAsyncState`, `JWTManager.validate`)
+- **symbol_type**: `function`, `class`, `method`, `interface`, `composable`, etc.
+
+Example search results:
+```
+ragtime search "useAsyncState" --type code
+
+[1] /apps/web/components/agency/payers.vue
+    Type: code | Symbol: payers:useAsyncState
+    Score: 0.892
+    Uses composable: useAsyncState...
+```
+
+## Memory Format
+
+Memories are markdown files with YAML frontmatter:
+
+```markdown
+---
+id: abc123
+namespace: app
+type: architecture
+component: auth
+confidence: high
+status: active
+added: '2025-01-31'
+author: bretwardjames
+---
+
+Auth uses JWT tokens with 15-minute expiry for security.
+Sessions are stored in Redis, not cookies.
+```
+
+## Namespaces
+
+| Namespace | Purpose |
+|-----------|---------|
+| `app` | How the codebase works (architecture, decisions) |
+| `team` | Team conventions and standards |
+| `user-{name}` | Individual preferences |
+| `branch-{name}` | Work-in-progress context |
+
+## Memory Types
+
+| Type | Description |
+|------|-------------|
+| `architecture` | System design, patterns |
+| `feature` | How features work |
+| `decision` | Why we chose X over Y |
+| `convention` | Team standards |
+| `pattern` | Reusable approaches |
+| `integration` | External service connections |
+| `context` | Session handoff |
+
+## Claude Commands
+
+After `ragtime install --workspace`:
+
+| Command | Purpose |
+|---------|---------|
+| `/remember` | Capture knowledge mid-session |
+| `/recall` | Search memories |
+| `/handoff` | Save session context |
+| `/start` | Resume work on an issue |
+| `/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
+
+MIT

{ragtime_cli-0.2.3.dist-info → ragtime_cli-0.2.5.dist-info}/RECORD

@@ -1,12 +1,13 @@
-ragtime_cli-0.2.3.dist-info/licenses/LICENSE,sha256=9A0wJs2PRDciGRH4F8JUJ-aMKYQyq_gVu2ixrXs-l5A,1070
+ragtime_cli-0.2.5.dist-info/licenses/LICENSE,sha256=9A0wJs2PRDciGRH4F8JUJ-aMKYQyq_gVu2ixrXs-l5A,1070
 src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-src/cli.py,sha256=PZ6NHl7rOyUVZ2HAcGPoytNRtsHczybTBy7A6xQpgoA,47320
-src/config.py,sha256=kaJV-7yI-LMW16e1w6JvM1ZCjgPf8EiBBOM4OXio6I8,4045
+src/cli.py,sha256=8L_Ao9NUAVHRJpTCBvrj5dLd2FHrd-R-bvmZtKvgvg8,68996
+src/config.py,sha256=mlqRkq1gi_bINqqz6TqT4GAR0M0G_hyeo7oY2zr-xsE,4066
 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/mcp_server.py,sha256=co6BbqNyDwrzN5iXQRsp4m5Ewq3-K5Eqq-sjphlczN4,20374
+src/memory.py,sha256=8kuHBLDTsZdSBumgA9FRJhHp_VNeoV78QFmiDcJs7YI,12033
 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=nXJMuXeOp0SZfjQ567NUO02Rg9zPQHQFbZbJ4Q_His0,6692
@@ -14,10 +15,11 @@ 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/__init__.py,sha256=ixS6qYjcW9jWO8TY-pRPEONkOBaVIEa99cQNVkXHqEg,261
+src/indexers/code.py,sha256=f-D6NLgayPbD-8goVKI-vlsiHgyrzS8Mkmo1oRFrBII,16473
 src/indexers/docs.py,sha256=7FENHaKSvC1T557bRzvmrjyaG_vK94GuQG9XMZdr89w,3349
-ragtime_cli-0.2.3.dist-info/METADATA,sha256=QaKUlKE4A2BwGX3NNTXm02JLwko_msFmJg3K6RyOmmo,5311
-ragtime_cli-0.2.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-ragtime_cli-0.2.3.dist-info/entry_points.txt,sha256=cWLbeyMxZNbew-THS3bHXTpCRXt1EaUy5QUOXGXLjl4,75
-ragtime_cli-0.2.3.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
-ragtime_cli-0.2.3.dist-info/RECORD,,
+ragtime_cli-0.2.5.dist-info/METADATA,sha256=HZOUb5o2lJVNytAUjUknt1YnxbV3PJGXUEfUz-YPdFM,9875
+ragtime_cli-0.2.5.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+ragtime_cli-0.2.5.dist-info/entry_points.txt,sha256=cWLbeyMxZNbew-THS3bHXTpCRXt1EaUy5QUOXGXLjl4,75
+ragtime_cli-0.2.5.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+ragtime_cli-0.2.5.dist-info/RECORD,,