Fix Docker setup and MCP image building

.bumpversion.toml

@@ -0,0 +1,54 @@
+[tool.bumpversion]
+# 当前版本号（自动从 pyproject.toml 读取）
+current_version = "0.7.0"
+
+# 版本解析格式（支持 major.minor.patch）
+parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
+
+# 版本序列化格式
+serialize = ["{major}.{minor}.{patch}"]
+
+# 搜索和替换的格式
+search = "{current_version}"
+replace = "{new_version}"
+
+# Git 集成
+commit = true
+commit_args = ""
+tag = true
+tag_name = "v{new_version}"
+tag_message = "Release version {new_version}"
+sign_tags = false
+
+# 允许 dirty 工作区（如果需要）
+allow_dirty = false
+
+# 提交信息模板
+message = "chore: bump version from {current_version} to {new_version}"
+
+# 需要更新版本号的文件列表
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"
+search = 'version = "{current_version}"'
+replace = 'version = "{new_version}"'
+
+[[tool.bumpversion.files]]
+filename = "src/__version__.py"
+search = '__version__ = "{current_version}"'
+replace = '__version__ = "{new_version}"'
+
+# Note: docs/changelog.md is now automatically generated by scripts/generate-changelog.py
+# It's called by scripts/bump-version.sh before bump-my-version runs
+
+# 版本部分定义
+[tool.bumpversion.parts.major]
+# major 版本从 0 开始，递增到任意数字
+values = ["0", "1", "2", "3", "4", "5", "6", "7", "8", "9"]
+
+[tool.bumpversion.parts.minor]
+# minor 版本从 0 开始，递增到任意数字
+values = ["0", "1", "2", "3", "4", "5", "6", "7", "8", "9"]
+
+[tool.bumpversion.parts.patch]
+# patch 版本从 0 开始，递增到任意数字
+values = ["0", "1", "2", "3", "4", "5", "6", "7", "8", "9"]

.github/workflows/docker-build.yml

@@ -0,0 +1,246 @@
+name: Build and Push Docker Images
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - 'v*'
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+env:
+  DOCKER_USER: royisme
+  DOCKER_REGISTRY: docker.io
+
+jobs:
+  validate-version:
+    name: Validate Version Consistency
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Validate version consistency
+        run: |
+          echo "=== Version Validation ==="
+
+          # Get version from pyproject.toml
+          PROJECT_VERSION=$(grep '^version = ' pyproject.toml | cut -d'"' -f2)
+          echo "pyproject.toml version: $PROJECT_VERSION"
+
+          # Get version from __version__.py
+          VERSION_PY=$(grep '__version__ = ' src/__version__.py | cut -d'"' -f2)
+          echo "__version__.py version: $VERSION_PY"
+
+          # Validate Python version file
+          if [[ "$PROJECT_VERSION" != "$VERSION_PY" ]]; then
+            echo "❌ Error: Version mismatch!"
+            echo "  pyproject.toml: $PROJECT_VERSION"
+            echo "  __version__.py: $VERSION_PY"
+            exit 1
+          fi
+
+          # If this is a tag push, validate tag version
+          if [[ $GITHUB_REF == refs/tags/* ]]; then
+            TAG_VERSION=${GITHUB_REF#refs/tags/v}
+            echo "Git tag version: v$TAG_VERSION"
+
+            if [[ "$PROJECT_VERSION" != "$TAG_VERSION" ]]; then
+              echo "❌ Error: Version mismatch with tag!"
+              echo "  pyproject.toml: $PROJECT_VERSION"
+              echo "  Git tag: $TAG_VERSION"
+              exit 1
+            fi
+          fi
+
+          echo "✅ All versions consistent: $PROJECT_VERSION"
+
+  build-minimal:
+    needs: validate-version
+    name: Build Minimal Image
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to Docker Hub
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          username: ${{ env.DOCKER_USER }}
+          password: ${{ secrets.DOCKER_HUB_TOKEN }}
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.DOCKER_USER }}/codebase-rag
+          tags: |
+            type=ref,event=branch,suffix=-minimal
+            type=ref,event=pr,suffix=-minimal
+            type=semver,pattern={{version}},suffix=-minimal
+            type=semver,pattern={{major}}.{{minor}},suffix=-minimal
+            type=raw,value=minimal,enable={{is_default_branch}}
+            type=raw,value=minimal-latest,enable={{is_default_branch}}
+
+      - name: Build and push
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: docker/Dockerfile.minimal
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          platforms: linux/amd64,linux/arm64
+
+  build-standard:
+    needs: validate-version
+    name: Build Standard Image
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to Docker Hub
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          username: ${{ env.DOCKER_USER }}
+          password: ${{ secrets.DOCKER_HUB_TOKEN }}
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.DOCKER_USER }}/codebase-rag
+          tags: |
+            type=ref,event=branch,suffix=-standard
+            type=ref,event=pr,suffix=-standard
+            type=semver,pattern={{version}},suffix=-standard
+            type=semver,pattern={{major}}.{{minor}},suffix=-standard
+            type=raw,value=standard,enable={{is_default_branch}}
+            type=raw,value=standard-latest,enable={{is_default_branch}}
+
+      - name: Build and push
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: docker/Dockerfile.standard
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          platforms: linux/amd64,linux/arm64
+
+  build-full:
+    needs: validate-version
+    name: Build Full Image
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to Docker Hub
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          username: ${{ env.DOCKER_USER }}
+          password: ${{ secrets.DOCKER_HUB_TOKEN }}
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.DOCKER_USER }}/codebase-rag
+          tags: |
+            type=ref,event=branch,suffix=-full
+            type=ref,event=pr,suffix=-full
+            type=semver,pattern={{version}},suffix=-full
+            type=semver,pattern={{major}}.{{minor}},suffix=-full
+            type=raw,value=full,enable={{is_default_branch}}
+            type=raw,value=full-latest,enable={{is_default_branch}}
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Build and push
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: docker/Dockerfile.full
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          platforms: linux/amd64,linux/arm64
+
+  create-release:
+    name: Create GitHub Release
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: [build-minimal, build-standard, build-full]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          generate_release_notes: true
+          body: |
+            ## Docker Images
+
+            ### Minimal (Code Graph only)
+            ```bash
+            docker pull royisme/codebase-rag:minimal
+            docker pull royisme/codebase-rag:${{ github.ref_name }}-minimal
+            ```
+
+            ### Standard (Code Graph + Memory)
+            ```bash
+            docker pull royisme/codebase-rag:standard
+            docker pull royisme/codebase-rag:${{ github.ref_name }}-standard
+            ```
+
+            ### Full (All Features)
+            ```bash
+            docker pull royisme/codebase-rag:full
+            docker pull royisme/codebase-rag:${{ github.ref_name }}-full
+            docker pull royisme/codebase-rag:latest
+            ```
+
+            ## Quick Start
+
+            See [documentation](https://code-graph.vantagecraft.dev) for detailed setup instructions.
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  notify:
+    name: Notify Build Status
+    needs: [build-minimal, build-standard, build-full]
+    if: always()
+    runs-on: ubuntu-latest
+    steps:
+      - name: Build Summary
+        run: |
+          echo "## 🐳 Docker Build Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "- **Minimal**: ✅ Built" >> $GITHUB_STEP_SUMMARY
+          echo "- **Standard**: ✅ Built" >> $GITHUB_STEP_SUMMARY
+          echo "- **Full**: ✅ Built" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "Images available at: https://hub.docker.com/r/royisme/codebase-rag" >> $GITHUB_STEP_SUMMARY

.github/workflows/docs-deploy.yml

@@ -0,0 +1,73 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+      - '.github/workflows/docs-deploy.yml'
+  pull_request:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Fetch all history for git info plugin
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          pip install --upgrade pip
+          pip install mkdocs-material
+          pip install mkdocs-minify-plugin
+          pip install mkdocs-git-revision-date-localized-plugin
+
+      - name: Build documentation
+        run: mkdocs build --strict
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    if: github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+
+      - name: Notify deployment
+        run: |
+          echo "📚 Documentation deployed successfully!"
+          echo "🔗 URL: https://code-graph.vantagecraft.dev"