feat/general-refinement - Upgrade to Python 3.13.5 and improve coverage configuration

- Upgrade Python version from 3.12 to 3.13.5 across all configurations:
  * Update .python-version, pyproject.toml, and all GitHub workflows
  * Update Dockerfile to use python:3.13-slim base images
  * Update README badge and CONTRIBUTING.md requirements
  * Regenerate uv.lock with Python 3.13 dependencies
- Add Python 3.13+ to system prerequisites in README
- Improve coverage configuration in pyproject.toml:
  * Add comprehensive source and omit patterns
  * Configure exclude_lines for better coverage reporting
  * Set XML output configuration
- Update CI workflow for better Codecov integration:
  * Set fail_ci_if_error to false for more reliable CI
  * Add verbose output for better debugging
  * Ensure CODECOV_TOKEN environment variable is properly set
- All 37 tests passing on Python 3.13.5
- MyPy type checking clean with Python 3.13

Author: Zvi Fried

.github/workflows/ci.yml

@@ -7,15 +7,15 @@ on:
     branches: [ main, develop ]
 
 env:
-  PYTHON_VERSION: "3.12"
+  PYTHON_VERSION: "3.13"
 
 jobs:
   test:
     name: Test Suite
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.12", "3.13"]
+        python-version: ["3.13"]
 
     steps:
     - name: Checkout code
@@ -50,8 +50,11 @@ jobs:
       uses: codecov/codecov-action@v4
       with:
         file: ./coverage.xml
-        fail_ci_if_error: true
+        fail_ci_if_error: false
+        verbose: true
         token: ${{ secrets.CODECOV_TOKEN }}
+      env:
+        CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
 
   security:
     name: Security Scan

.github/workflows/release.yml

@@ -6,7 +6,7 @@ on:
       - 'v*'
 
 env:
-  PYTHON_VERSION: "3.12"
+  PYTHON_VERSION: "3.13"
   REGISTRY: ghcr.io
   IMAGE_NAME: ${{ github.repository }}
 

.github/workflows/semantic-release.yml

@@ -7,7 +7,7 @@ on:
   workflow_dispatch:
 
 env:
-  PYTHON_VERSION: "3.12"
+  PYTHON_VERSION: "3.13"
 
 jobs:
   semantic-release:

CONTRIBUTING.md

@@ -10,7 +10,7 @@ MCP as a Judge aims to revolutionize software development by preventing bad codi
 
 ### **Prerequisites**
 
-- Python 3.12.10+ (latest secure version)
+- Python 3.13.5+ (latest secure version)
 - uv (recommended) or pip
 - Git
 - A compatible MCP client for testing

Dockerfile

@@ -1,5 +1,5 @@
 # Multi-stage build for production-ready MCP as a Judge server
-FROM python:3.12-slim AS builder
+FROM python:3.13-slim AS builder
 
 
 
@@ -32,7 +32,7 @@ RUN .venv/bin/pip install uv
 RUN .venv/bin/uv pip install -e .
 
 # Production stage
-FROM python:3.12-slim AS production
+FROM python:3.13-slim AS production
 
 # Set environment variables
 ENV PYTHONUNBUFFERED=1 \

README.md

@@ -3,7 +3,7 @@
 > **Prevent bad coding practices with AI-powered evaluation and user-driven decision making**
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![Python 3.13+](https://img.shields.io/badge/python-3.13+-blue.svg)](https://www.python.org/downloads/)
 [![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io/)
 
 [![CI](https://github.com/hepivax/mcp-as-a-judge/workflows/CI/badge.svg)](https://github.com/hepivax/mcp-as-a-judge/actions/workflows/ci.yml)
@@ -80,6 +80,10 @@ MCP as a Judge is heavily dependent on **MCP Sampling** and **MCP Elicitation**
 - **[MCP Sampling](https://modelcontextprotocol.io/docs/learn/client-concepts#sampling)** - Required for AI-powered code evaluation and judgment
 - **[MCP Elicitation](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation)** - Required for interactive user decision prompts
 
+#### **System Prerequisites**
+
+- **Python 3.13+** - Required for running the MCP server
+
 #### **Supported AI Assistants**
 
 | AI Assistant | Platform | MCP Support | Status | Notes |
@@ -96,53 +100,41 @@ MCP as a Judge is heavily dependent on **MCP Sampling** and **MCP Elicitation**
 
 > **Note**: MCP servers communicate via stdio (standard input/output), not HTTP ports. No network configuration is needed.
 
-### **Installation**
-
-#### **Method 1: Using uv (Recommended)**
-
-```bash
-# Install uv if you don't have it
-pip install uv
 
-# Install from PyPI
-uv add mcp-as-a-judge
 
-# Run the server
-mcp-as-a-judge
-```
+## 🔧 **Visual Studio Code Configuration**
 
-#### **Method 2: Using pip (Alternative)**
+Configure MCP as a Judge in Visual Studio Code with GitHub Copilot:
 
-```bash
-# Install from PyPI
-pip install mcp-as-a-judge
+### **Method 1: Using uv (Recommended)**
 
-# Run the server
-mcp-as-a-judge
-```
-
-#### **Method 3: From Source (Development)**
+1. **Install the package:**
 
-```bash
-# Clone the repository for development
-git clone https://github.com/hepivax/mcp-as-a-judge.git
-cd mcp-as-a-judge
+   ```bash
+   uv add mcp-as-a-judge
+   ```
 
-# Install with uv
-uv sync --all-extras --dev
+2. **Configure Visual Studio Code MCP settings:**
 
-# Run the server
-uv run mcp-as-a-judge
-```
+   Add this to your Visual Studio Code MCP configuration file:
 
-## 🔧 **Visual Studio Code Configuration**
+   ```json
+   {
+     "servers": {
+       "mcp-as-a-judge": {
+         "command": "uv",
+         "args": ["run", "mcp-as-a-judge"]
+       }
+     }
+   }
+   ```
 
-Configure MCP as a Judge in Visual Studio Code with GitHub Copilot:
+### **Method 2: Using Docker**
 
-1. **Install the package:**
+1. **Pull the Docker image:**
 
    ```bash
-   uv add mcp-as-a-judge
+   docker pull ghcr.io/hepivax/mcp-as-a-judge:latest
    ```
 
 2. **Configure Visual Studio Code MCP settings:**
@@ -153,8 +145,8 @@ Configure MCP as a Judge in Visual Studio Code with GitHub Copilot:
    {
      "servers": {
        "mcp-as-a-judge": {
-         "command": "uv",
-         "args": ["run", "mcp-as-a-judge"]
+         "command": "docker",
+         "args": ["run", "--rm", "-i", "ghcr.io/hepivax/mcp-as-a-judge:latest"]
        }
      }
    }

codecov.yml

@@ -0,0 +1,23 @@
+coverage:
+  status:
+    project:
+      default:
+        target: 80%
+        threshold: 1%
+        if_not_found: success
+    patch:
+      default:
+        target: 80%
+        threshold: 1%
+        if_not_found: success
+
+comment:
+  layout: "reach,diff,flags,tree"
+  behavior: default
+  require_changes: false
+
+ignore:
+  - "tests/"
+  - "scripts/"
+  - "**/__pycache__/"
+  - "**/*.pyc"

pyproject.toml

@@ -16,7 +16,6 @@ classifiers = [
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Topic :: Software Development :: Quality Assurance",
     "Topic :: Software Development :: Code Generators",
@@ -26,7 +25,7 @@ classifiers = [
     "Environment :: Console",
     "Typing :: Typed",
 ]
-requires-python = ">=3.12"
+requires-python = ">=3.13"
 dependencies = [
     "jinja2>=3.1.6",
     "mcp[cli]>=1.13.0",
@@ -113,7 +112,7 @@ skip-magic-trailing-comma = false
 line-ending = "auto"
 
 [tool.mypy]
-python_version = "3.12"
+python_version = "3.13"
 warn_return_any = true
 warn_unused_configs = true
 disallow_untyped_defs = true
@@ -142,3 +141,30 @@ markers = [
     "slow: marks tests as slow (deselect with '-m \"not slow\"')",
     "integration: marks tests as integration tests",
 ]
+
+[tool.coverage.run]
+source = ["src"]
+omit = [
+    "tests/*",
+    "*/tests/*",
+    "*/__pycache__/*",
+    "*/venv/*",
+    "*/.venv/*",
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "if self.debug:",
+    "if settings.DEBUG",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if 0:",
+    "if __name__ == .__main__.:",
+    "class .*\\bProtocol\\):",
+    "@(abc\\.)?abstractmethod",
+]
+
+[tool.coverage.xml]
+output = "coverage.xml"