mcp-vector-search 0.0.3__tar.gz → 0.4.12__tar.gz

mcp_vector_search-0.4.12/.claude/agents/.dependency_cache

@@ -0,0 +1,13 @@
+{
+  "bb661a7aa0e44dd4632e80c04c7337b9": {
+    "timestamp": 1755844432.4411361,
+    "results": {
+      "agents": {},
+      "summary": {
+        "total_agents": 0
+      }
+    },
+    "deployment_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+    "context": {}
+  }
+}

mcp_vector_search-0.4.12/.claude/agents/.mpm_deployment_state

@@ -0,0 +1,11 @@
+{
+  "deployment_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+  "last_check_time": 1755844432.441344,
+  "last_check_results": {
+    "agents": {},
+    "summary": {
+      "total_agents": 0
+    }
+  },
+  "agent_count": 0
+}

mcp_vector_search-0.4.12/.claude/settings.local.json

@@ -0,0 +1,16 @@
+{
+  "mcpServers": {
+    "mcp-vector-search": {
+      "type": "stdio",
+      "command": "/Users/masa/Projects/managed/mcp-vector-search/.venv/bin/python3",
+      "args": [
+        "-m",
+        "mcp_vector_search.mcp.server",
+        "/Users/masa/Projects/managed/mcp-vector-search"
+      ],
+      "env": {
+        "MCP_ENABLE_FILE_WATCHING": "true"
+      }
+    }
+  }
+}

mcp_vector_search-0.4.12/.claude-mpm/.gitignore

@@ -0,0 +1,4 @@
+logs/
+*.log
+*.pyc
+__pycache__/

mcp_vector_search-0.4.12/.claude-mpm/config/project.json

@@ -0,0 +1,11 @@
+{
+  "version": "1.0",
+  "project_name": "claude-mpm",
+  "agents": {
+    "enabled": true
+  },
+  "tickets": {
+    "auto_create": true,
+    "prefix": "TSK"
+  }
+}

mcp_vector_search-0.4.12/.claude-mpm/memories/README.md

@@ -0,0 +1,36 @@
+# Agent Memory System
+
+## Purpose
+Each agent maintains project-specific knowledge in these files. Agents read their memory file before tasks and update it when they learn something new.
+
+## Manual Editing
+Feel free to edit these files to:
+- Add project-specific guidelines
+- Remove outdated information
+- Reorganize for better clarity
+- Add domain-specific knowledge
+
+## Memory Limits
+- Max file size: 80KB (~20k tokens)
+- Max sections: 10
+- Max items per section: 15
+- Files auto-truncate when limits exceeded
+
+## File Format
+Standard markdown with structured sections. Agents expect:
+- Project Architecture
+- Implementation Guidelines
+- Common Mistakes to Avoid
+- Current Technical Context
+
+## How It Works
+1. Agents read their memory file before starting tasks
+2. Agents add learnings during or after task completion
+3. Files automatically enforce size limits
+4. Developers can manually edit for accuracy
+
+## Memory File Lifecycle
+- Created automatically when agent first runs
+- Updated through hook system after delegations
+- Manually editable by developers
+- Version controlled with project

mcp_vector_search-0.4.12/.claude-mpm/memories/engineer_memories.md

@@ -0,0 +1,3 @@
+# Agent Memory: engineer
+<!-- Last Updated: 2025-08-22T02:21:17.668668Z -->
+

mcp_vector_search-0.4.12/.claude-mpm/memories/research_memories.md

@@ -0,0 +1,3 @@
+# Agent Memory: research
+<!-- Last Updated: 2025-08-22T02:17:34.121284Z -->
+

mcp_vector_search-0.4.12/.claude-mpm/memories/version-control_memories.md

@@ -0,0 +1,3 @@
+# Agent Memory: version-control
+<!-- Last Updated: 2025-08-22T02:30:59.402737Z -->
+

mcp_vector_search-0.4.12/.github/workflows/ci.yml

@@ -0,0 +1,251 @@
+name: CI/CD Pipeline
+
+on:
+  push:
+    branches: [ main, develop ]
+    tags: [ 'v*' ]
+  pull_request:
+    branches: [ main, develop ]
+
+env:
+  PYTHON_VERSION: "3.11"
+
+jobs:
+  lint:
+    name: Lint & Format Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+      
+      - name: Set up Python
+        run: uv python install ${{ env.PYTHON_VERSION }}
+      
+      - name: Install dependencies
+        run: uv sync --dev
+      
+      - name: Run ruff format check
+        run: uv run ruff format --check src/
+      
+      - name: Run ruff lint
+        run: uv run ruff check src/
+      
+      - name: Run mypy
+        run: uv run mypy src/mcp_vector_search --ignore-missing-imports
+
+  test:
+    name: Test Suite
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.11", "3.12"]
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+      
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+      
+      - name: Install dependencies
+        run: uv sync --dev
+      
+      - name: Run tests
+        run: uv run pytest tests/ -v --cov=src/mcp_vector_search --cov-report=xml --cov-report=term-missing
+      
+      - name: Upload coverage to Codecov
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11'
+        uses: codecov/codecov-action@v3
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: true
+
+  build:
+    name: Build Package
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+      
+      - name: Set up Python
+        run: uv python install ${{ env.PYTHON_VERSION }}
+      
+      - name: Install dependencies
+        run: uv sync --dev
+      
+      - name: Build package
+        run: uv build
+      
+      - name: Check package
+        run: uv run twine check dist/*
+      
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  security:
+    name: Security Scan
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+      
+      - name: Set up Python
+        run: uv python install ${{ env.PYTHON_VERSION }}
+      
+      - name: Install dependencies
+        run: uv sync --dev
+      
+      - name: Run safety check
+        run: uv run safety check --json || true
+      
+      - name: Run bandit security scan
+        run: uv run bandit -r src/ -f json || true
+
+  release:
+    name: Release to PyPI
+    runs-on: ubuntu-latest
+    needs: [lint, test, build, security]
+    if: startsWith(github.ref, 'refs/tags/v')
+    environment: release
+    permissions:
+      id-token: write  # For trusted publishing
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+
+  performance:
+    name: Performance Benchmarks
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+      
+      - name: Set up Python
+        run: uv python install ${{ env.PYTHON_VERSION }}
+      
+      - name: Install dependencies
+        run: uv sync --dev
+      
+      - name: Run performance tests
+        run: |
+          # Create a test project for benchmarking
+          mkdir -p /tmp/test-project
+          cd /tmp/test-project
+          echo "def hello(): pass" > test.py
+          
+          # Initialize and run benchmarks
+          uv run mcp-vector-search init --file-extensions .py --embedding-model sentence-transformers/all-MiniLM-L6-v2
+          python3 ${{ github.workspace }}/scripts/search_performance_monitor.py --save
+      
+      - name: Upload performance results
+        uses: actions/upload-artifact@v4
+        with:
+          name: performance-results
+          path: /tmp/test-project/.mcp-vector-search/performance_metrics.jsonl
+
+  docs:
+    name: Documentation Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Check README links
+        run: |
+          # Check for broken links in README
+          grep -o 'http[s]*://[^)]*' README.md | while read url; do
+            if ! curl -s --head "$url" | head -n 1 | grep -q "200 OK"; then
+              echo "Broken link: $url"
+              exit 1
+            fi
+          done || true
+      
+      - name: Check documentation completeness
+        run: |
+          # Ensure key documentation files exist
+          required_docs=("README.md" "docs/CHANGELOG.md" "docs/VERSIONING_WORKFLOW.md")
+          for doc in "${required_docs[@]}"; do
+            if [ ! -f "$doc" ]; then
+              echo "Missing documentation: $doc"
+              exit 1
+            fi
+          done
+
+  integration:
+    name: Integration Tests
+    runs-on: ubuntu-latest
+    needs: [build]
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+      
+      - name: Set up Python
+        run: uv python install ${{ env.PYTHON_VERSION }}
+      
+      - name: Test package installation
+        run: |
+          # Install from wheel
+          uv pip install dist/*.whl
+          
+          # Test CLI is available
+          mcp-vector-search --version
+          
+          # Test basic functionality
+          mkdir -p /tmp/integration-test
+          cd /tmp/integration-test
+          echo "def test(): pass" > test.py
+          
+          # Initialize project
+          mcp-vector-search init --file-extensions .py --embedding-model sentence-transformers/all-MiniLM-L6-v2
+          
+          # Index and search
+          mcp-vector-search index
+          mcp-vector-search search "function" --limit 5

{mcp_vector_search-0.0.3 → mcp_vector_search-0.4.12}/.gitignore

@@ -231,3 +231,10 @@ tramp
 *.tar.gz
 *.rar
 *.7z
+
+# Claude configuration
+# The .claude/settings.local.json file contains project-specific MCP configuration
+# and should be committed to the repository for team collaboration
+.claude/cache/
+.claude/tmp/
+# Note: .claude/settings.local.json is NOT ignored - it should be committed

{mcp_vector_search-0.0.3 → mcp_vector_search-0.4.12}/.pre-commit-config.yaml

@@ -16,14 +16,23 @@ repos:
         language_version: python3.11
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.1.9
+    rev: v0.6.0
     hooks:
       - id: ruff
         args: [--fix, --exit-non-zero-on-fix]
+      - id: ruff-format
 
   - repo: https://github.com/pre-commit/mirrors-mypy
     rev: v1.8.0
     hooks:
       - id: mypy
         additional_dependencies: [types-all]
-        args: [--strict, --ignore-missing-imports]
+        args: [--ignore-missing-imports]
+
+  # Security scanning
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.7.5
+    hooks:
+      - id: bandit
+        args: ['-r', 'src/', '-f', 'json']
+        exclude: tests/

mcp_vector_search-0.4.12/CLAUDE.md

@@ -0,0 +1,204 @@
+# MCP Vector Search - Project Documentation Index
+
+## 📋 Project Overview
+
+**MCP Vector Search** is a CLI-first semantic code search tool with MCP (Model Context Protocol) integration. It provides intelligent code search capabilities using vector embeddings and AST-aware parsing.
+
+### 🎯 Core Purpose
+- **Semantic Code Search**: Find code by meaning, not just text matching
+- **Multi-language Support**: Python, JavaScript, TypeScript with extensible architecture
+- **Real-time Updates**: File watching with incremental indexing
+- **Local-first Privacy**: Complete on-device processing
+- **Developer Productivity**: Fast, intelligent code discovery
+
+### 🏗️ Architecture Overview
+- **CLI Interface**: Typer-based command-line tool
+- **Vector Database**: ChromaDB for semantic embeddings
+- **AST Parsing**: Tree-sitter with regex fallback
+- **File Watching**: Real-time change detection
+- **Async Processing**: Modern Python with type safety
+
+---
+
+## 📚 Documentation Structure
+
+### 🚀 Quick Start
+- **[README.md](README.md)** - Installation, usage, and basic examples
+- **[DEVELOPMENT.md](DEVELOPMENT.md)** - Three-stage development workflow
+
+### 🏗️ Architecture & Structure
+- **[docs/STRUCTURE.md](docs/STRUCTURE.md)** - File organization and module architecture
+- **[docs/DEPLOY.md](docs/DEPLOY.md)** - Deployment and installation instructions
+- **[docs/architecture/REINDEXING_WORKFLOW.md](docs/architecture/REINDEXING_WORKFLOW.md)** - Reindexing implementation and workflow analysis
+
+### 👨‍💻 Developer Resources
+- **[docs/developer/](docs/developer/)** - Detailed developer documentation
+  - **[CONTRIBUTING.md](docs/developer/CONTRIBUTING.md)** - Contribution guidelines
+  - **[API.md](docs/developer/API.md)** - Internal API documentation
+  - **[TESTING.md](docs/developer/TESTING.md)** - Testing strategies and practices
+  - **[LINTING.md](docs/developer/LINTING.md)** - Code quality and linting setup
+
+### 🚀 Performance & Features
+- **[docs/FEATURES.md](docs/FEATURES.md)** - Comprehensive feature overview and usage guide
+- **[docs/IMPROVEMENTS_SUMMARY.md](docs/IMPROVEMENTS_SUMMARY.md)** - Summary of major improvements and performance gains
+- **[docs/performance/CONNECTION_POOLING.md](docs/performance/CONNECTION_POOLING.md)** - Connection pooling implementation and benchmarks
+- **[examples/connection_pooling_example.py](examples/connection_pooling_example.py)** - Connection pooling usage examples
+- **[examples/semi_automatic_reindexing_demo.py](examples/semi_automatic_reindexing_demo.py)** - Semi-automatic reindexing strategies demo
+
+### 📦 Release Management
+- **[docs/VERSIONING.md](docs/VERSIONING.md)** - Semantic versioning guidelines
+- **[docs/CHANGELOG.md](docs/CHANGELOG.md)** - Version history and changes
+- **[docs/RELEASES.md](docs/RELEASES.md)** - Release process and best practices
+
+---
+
+## 🔧 Major Functions & Components
+
+### Core Modules
+
+#### **CLI Interface** (`src/mcp_vector_search/cli/`)
+- **`main.py`** - Entry point and command routing
+- **`commands/`** - Individual command implementations
+  - `init.py` - Project initialization
+  - `index.py` - Codebase indexing
+  - `search.py` - Semantic search
+  - `watch.py` - File watching
+  - `status.py` - Project statistics
+  - `config.py` - Configuration management
+  - `auto_index.py` - Automatic reindexing management
+
+#### **Core Engine** (`src/mcp_vector_search/core/`)
+- **`indexer.py`** - Code indexing and chunking
+- **`search.py`** - Semantic search implementation
+- **`database.py`** - Vector database abstraction with connection pooling
+- **`connection_pool.py`** - Database connection pooling for performance
+- **`auto_indexer.py`** - Semi-automatic reindexing strategies
+- **`git_hooks.py`** - Git hooks integration for auto-reindexing
+- **`scheduler.py`** - Scheduled task management for auto-reindexing
+- **`embeddings.py`** - Text embedding generation
+- **`project.py`** - Project management
+- **`watcher.py`** - File system monitoring
+
+#### **Language Parsers** (`src/mcp_vector_search/parsers/`)
+- **`base.py`** - Abstract parser interface
+- **`python.py`** - Python AST parsing
+- **`javascript.py`** - JavaScript/TypeScript parsing
+- **`registry.py`** - Parser registration system
+
+#### **Configuration** (`src/mcp_vector_search/config/`)
+- **`settings.py`** - Application settings
+- **`defaults.py`** - Default configurations
+
+### Key Algorithms
+
+#### **Semantic Chunking**
+```python
+# Intelligent code chunking for optimal search
+def chunk_code(content: str, language: str) -> List[CodeChunk]:
+    # AST-aware chunking with function/class boundaries
+    # Fallback to regex-based chunking
+    # Preserve context and relationships
+```
+
+#### **Vector Search**
+```python
+# Similarity-based code search
+def search_similar(query: str, limit: int = 10) -> List[SearchResult]:
+    # Generate query embedding
+    # Perform vector similarity search
+    # Rank and filter results
+```
+
+#### **Incremental Indexing**
+```python
+# Real-time file change processing
+def update_index(file_path: Path, change_type: str):
+    # Detect file changes
+    # Update vector database
+    # Maintain index consistency
+```
+
+---
+
+## 🎯 Quick Navigation
+
+### For Users
+1. **Getting Started**: [README.md](README.md) → Installation & Usage
+2. **Deployment**: [docs/DEPLOY.md](docs/DEPLOY.md) → Production setup
+
+### For Developers
+1. **Development Setup**: [DEVELOPMENT.md](DEVELOPMENT.md) → Three-stage workflow
+2. **Code Structure**: [docs/STRUCTURE.md](docs/STRUCTURE.md) → Architecture overview
+3. **Contributing**: [docs/developer/CONTRIBUTING.md](docs/developer/CONTRIBUTING.md) → Guidelines
+4. **API Reference**: [docs/developer/API.md](docs/developer/API.md) → Internal APIs
+
+### For Maintainers
+1. **Versioning**: [docs/VERSIONING.md](docs/VERSIONING.md) → Version management
+2. **Releases**: [docs/RELEASES.md](docs/RELEASES.md) → Release process
+3. **Changelog**: [docs/CHANGELOG.md](docs/CHANGELOG.md) → Version history
+
+---
+
+## 🚀 Common Tasks
+
+### Development
+```bash
+./scripts/workflow.sh        # Show development workflow
+./scripts/dev-test.sh        # Run development tests
+uv run mcp-vector-search     # Test CLI locally
+```
+
+### Deployment
+```bash
+./scripts/deploy-test.sh     # Test local deployment
+./scripts/publish.sh         # Publish to PyPI
+```
+
+### Versioning & Releasing
+```bash
+make version-show        # Display current version
+make version-patch       # Bump patch version
+make release-minor       # Full release with minor bump
+make publish            # Publish to PyPI
+```
+
+### Usage
+```bash
+mcp-vector-search init       # Initialize project
+mcp-vector-search index      # Index codebase
+mcp-vector-search search "query"  # Search code
+mcp-vector-search watch      # Start file watching
+```
+
+---
+
+## 📈 Project Status
+
+- **Version**: 0.0.3 (Alpha)
+- **Status**: Active development
+- **License**: MIT
+- **Python**: 3.11+
+- **Platform**: Cross-platform (macOS, Linux, Windows)
+
+### Current Capabilities
+- ✅ Multi-language code parsing (Python, JavaScript, TypeScript)
+- ✅ Semantic vector search with similarity scoring
+- ✅ Real-time file watching and incremental updates
+- ✅ CLI interface with rich output and syntax highlighting
+- ✅ Project-aware configuration management
+- ✅ **Connection pooling** for 13.6% performance improvement
+- ✅ **Semi-automatic reindexing** with 5 different strategies
+- ✅ **Production-ready features** (error handling, monitoring, graceful degradation)
+- ✅ **Git hooks integration** for development workflows
+- ✅ **Scheduled tasks** for production environments
+
+### Roadmap
+- 🔄 Enhanced Tree-sitter integration
+- 🔄 Additional language support
+- 🔮 MCP server implementation
+- 🔮 IDE extensions
+- 🔮 Team collaboration features
+
+---
+
+**For detailed information on any topic, follow the links to specific documentation files.**