mcp-vector-search 0.15.5__tar.gz

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

@@ -0,0 +1,267 @@
+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
+        with:
+          submodules: recursive
+
+      - 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
+        with:
+          submodules: recursive
+
+      - 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
+        with:
+          submodules: recursive
+
+      - 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
+        with:
+          submodules: recursive
+
+      - 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
+        with:
+          submodules: recursive
+
+      - 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
+        with:
+          submodules: recursive
+
+      - 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 --extensions .py --embedding-model sentence-transformers/all-MiniLM-L6-v2 --no-mcp --no-auto-indexing
+          uv run 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
+        with:
+          submodules: recursive
+
+      - 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
+        with:
+          submodules: recursive
+
+      - 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 --extensions .py --embedding-model sentence-transformers/all-MiniLM-L6-v2 --no-mcp --no-auto-indexing
+
+          # Index and search
+          mcp-vector-search index
+          mcp-vector-search search "function" --limit 5

mcp_vector_search-0.15.5/.github/workflows/update-homebrew.yml

@@ -0,0 +1,123 @@
+name: Update Homebrew Formula
+
+on:
+  workflow_run:
+    workflows: ["CI/CD Pipeline"]
+    types:
+      - completed
+    branches:
+      - main
+
+env:
+  PYTHON_VERSION: "3.11"
+
+jobs:
+  update-formula:
+    name: Update Homebrew Formula
+    runs-on: ubuntu-latest
+    # Only run if the triggering workflow succeeded and it was a tag push
+    if: |
+      github.event.workflow_run.conclusion == 'success' &&
+      github.event.workflow_run.event == 'push' &&
+      startsWith(github.event.workflow_run.head_branch, 'refs/tags/v')
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install ${{ env.PYTHON_VERSION }}
+
+      - name: Extract version from tag
+        id: version
+        run: |
+          VERSION=${GITHUB_REF#refs/tags/v}
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "Extracted version: $VERSION"
+
+      - name: Update Homebrew Formula
+        env:
+          HOMEBREW_TAP_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+        run: |
+          echo "Updating Homebrew formula to version ${{ steps.version.outputs.version }}"
+          python3 scripts/update_homebrew_formula.py --verbose
+
+      - name: Create success notification
+        if: success()
+        run: |
+          echo "✅ Homebrew Formula updated successfully to v${{ steps.version.outputs.version }}"
+          echo "Users can now install with: brew install bobmatnyc/mcp-vector-search/mcp-vector-search"
+
+      - name: Create issue on failure
+        if: failure()
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const version = '${{ steps.version.outputs.version }}';
+            const runUrl = '${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}';
+
+            await github.rest.issues.create({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              title: `❌ Homebrew Formula Update Failed for v${version}`,
+              body: `## Homebrew Formula Update Failed
+
+            The automated Homebrew formula update failed for version **v${version}**.
+
+            **Workflow Run:** ${runUrl}
+
+            ### Manual Update Required
+
+            Please update the formula manually:
+
+            \`\`\`bash
+            export HOMEBREW_TAP_TOKEN=<your-token>
+            make homebrew-update
+            \`\`\`
+
+            Or update directly in the tap repository:
+            https://github.com/bobmatnyc/homebrew-mcp-vector-search
+
+            ### Checklist
+
+            - [ ] Verify PyPI release is available
+            - [ ] Check HOMEBREW_TAP_TOKEN secret is valid
+            - [ ] Manually update formula if needed
+            - [ ] Close this issue when resolved
+            `,
+              labels: ['automation', 'homebrew', 'urgent']
+            });
+
+  notify-success:
+    name: Notify Success
+    runs-on: ubuntu-latest
+    needs: update-formula
+    if: success()
+
+    steps:
+      - name: Extract version from tag
+        id: version
+        run: |
+          VERSION=${GITHUB_REF#refs/tags/v}
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Post success message
+        run: |
+          echo "════════════════════════════════════════════"
+          echo "✅ Homebrew Formula Updated Successfully"
+          echo "════════════════════════════════════════════"
+          echo ""
+          echo "Version: v${{ steps.version.outputs.version }}"
+          echo "Tap: bobmatnyc/mcp-vector-search"
+          echo ""
+          echo "Users can now install with:"
+          echo "  brew install bobmatnyc/mcp-vector-search/mcp-vector-search"
+          echo ""
+          echo "════════════════════════════════════════════"

mcp_vector_search-0.15.5/.gitignore

@@ -0,0 +1,307 @@
+# All dotfiles and dot-directories (catch-all)
+.*
+!.gitignore
+!.github/
+!.pre-commit-config.yaml
+
+# Explicitly exclude common dotfiles/directories
+.claude/
+.changesets/
+
+# MCP Vector Search specific
+.mcp-vector-search/
+*.db
+*.sqlite
+*.sqlite3
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# poetry
+poetry.lock
+
+# pdm
+.pdm.toml
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+.idea/
+
+# VS Code
+.vscode/
+
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Windows
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+*.tmp
+*.temp
+Desktop.ini
+$RECYCLE.BIN/
+
+# Linux
+*~
+
+# Node.js (for any JS/TS development)
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Temporary files
+*.tmp
+*.temp
+*.swp
+*.swo
+*~
+
+# Test files
+test_*.py
+*_test.py
+debug_*.py
+test_js_project/
+test-screenshots/
+chunk-graph.json
+
+# UV specific
+.uv/
+
+# ChromaDB
+chroma.sqlite3
+chroma/
+
+# Logs
+*.log
+logs/
+
+# Backup files
+*.bak
+*.backup
+
+# OS generated files
+.directory
+.fuse_hidden*
+.nfs*
+
+# JetBrains IDEs
+.idea/
+*.iws
+*.iml
+*.ipr
+
+# Sublime Text
+*.sublime-project
+*.sublime-workspace
+
+# Vim
+*.swp
+*.swo
+*~
+.netrwhist
+
+# Emacs
+*~
+\#*\#
+/.emacs.desktop
+/.emacs.desktop.lock
+*.elc
+auto-save-list
+tramp
+.\#*
+
+# Archive files
+*.zip
+*.tar.gz
+*.rar
+*.7z
+
+# Claude configuration directories (completely ignored)
+.claude/
+.claude-mpm/
+
+# Additional development directories
+.aitrackdown/
+.benchmarks/
+.venv-mcp/
+.kuzu-memory/
+.kuzu-memory-backups/
+.conda/
+.npm/
+.yarn/
+.secrets/
+.settings/
+
+# Additional file patterns
+*.cab
+*.cert
+*.crt
+*.key
+*.pem
+*.lnk
+*.mpm.tmp
+*.msi
+*.msm
+*.msp
+.env.*
+credentials/
+kuzu-memories/
+backup/
+backups/
+conda-env/
+virtualenv/
+
+# Added by Claude MPM /mpm-init
+*.cache
+*.old
+*.pytest_cache
+*.sql
+.claude-mpm/*.log
+.claude-mpm/cache/
+.claude-mpm/logs/
+.claude-mpm/sessions/
+.claude-mpm/tmp/
+.claude/cache/
+.claude/sessions/
+.npm
+.project
+.pydevproject
+_build/
+pip-wheel-metadata/
+site/
+temp/
+tmp/
+
+# MCP Ticketer
+.mcp-ticketer/
+
+# MCP configuration (contains tokens)
+.mcp.json