✨ feat(support): add pixi and pdm package manager support (#10)

* build(python): upgrade python from 3.12 to 3.13

CHANGES
- Update .python-version to 3.13 for development environment
- Update Dockerfile to use python3.13-alpine for both builder and runtime stages
- Update pyproject.toml requires-python to >=3.13
- Refresh uv.lock with Python 3.13 dependencies

IMPACT
- Development and Docker environments now use Python 3.13
- Ensures consistency across local development and containerized deployments

* feat(support): add pixi and pdm package manager support

closes #8
closes #7

CHANGES
- Add pixi and pdm to auto-update workflow matrix
- Update MCP server tool to support 6 package managers total
- Extend search index schema documentation and heap allocation
- Update all README files with pixi and pdm references
- Add comprehensive package manager links in documentation
- Update roadmap to reflect completed pixi and pdm support
- Remove signoff option from GitHub Actions (bot cannot sign without token)

IMPACT
- Users can now search pixi and pdm official documentation
- Auto-updating pipeline includes pixi and pdm docs weekly
- Expands coverage from 4 to 6 major Python package managers

TECHNICAL NOTES
- Modular workflow architecture enabled clean 2-line additions to matrix
- Type system updates maintain compile-time safety for new package filters
- Documentation structure scales seamlessly to additional package managers

Author: KemingHe

.github/workflows/auto-update-docs.yml

@@ -24,6 +24,10 @@ jobs:
             repo: pypa/pip
             docs_path: docs
             target_dir: src/assets/pip
+          - manager: conda
+            repo: conda/conda
+            docs_path: docs
+            target_dir: src/assets/conda
           - manager: poetry
             repo: python-poetry/poetry
             docs_path: docs
@@ -32,10 +36,14 @@ jobs:
             repo: astral-sh/uv
             docs_path: docs
             target_dir: src/assets/uv
-          - manager: conda
-            repo: conda/conda
+          - manager: pixi
+            repo: prefix-dev/pixi
             docs_path: docs
-            target_dir: src/assets/conda
+            target_dir: src/assets/pixi
+          - manager: pdm
+            repo: pdm-project/pdm
+            docs_path: docs
+            target_dir: src/assets/pdm
 
     steps:
       - name: Checkout main repo
@@ -79,5 +87,4 @@ jobs:
         uses: stefanzweifel/git-auto-commit-action@778341af668090896ca464160c2def5d1d1a3eb0
         with:
           commit_message: 'docs(src/assets/): update ${{ matrix.manager }} official documentation'
-          commit_options: '--signoff'
           file_pattern: 'src/assets/${{ matrix.manager }}/*'

.github/workflows/auto-update-index.yml

@@ -40,5 +40,4 @@ jobs:
         uses: stefanzweifel/git-auto-commit-action@778341af668090896ca464160c2def5d1d1a3eb0
         with:
           commit_message: 'chore(src/index/): rebuild search index from updated documentation'
-          commit_options: '--signoff'
           file_pattern: 'src/index/*'

.python-version

@@ -1 +1 @@
-3.12
+3.13

CONTRIBUTING.md

@@ -6,7 +6,8 @@ Thank you for your interest in contributing! This guide covers development workf
 
 ## 🔄 Contribution Workflow
 
-**Issue-first approach**: No issue, no PR. No PR, no merge.
+> [!IMPORTANT]
+> **Issue-first approach**: No issue, no PR. No PR, no merge.
 
 1. **Raise issue** - Bug report or feature request
 2. **Get assigned** - Wait for maintainer assignment  
@@ -75,8 +76,7 @@ Available templates and prompts for consistent contributions:
 ├── ISSUE_TEMPLATE/
 │   ├── bug-report.md             # Bug report template
 │   └── feature-request.md        # Feature request template
-└── PULL_REQUEST_TEMPLATE/
-    └── pull_request_template.md
+└── pull_request_template.md
 
 prompts/
 ├── prompt-commit-msg-gen.md      # Generate uniform commit messages
@@ -87,7 +87,7 @@ prompts/
 
 ## 🤖 Automated Systems
 
-The repository auto-updates weekly (Tuesday 6pm ET):
+The repository auto-updates weekly (Tuesday 06:00pm ET):
 
 1. Syncs official documentation
 2. Rebuilds search indexes

Dockerfile

@@ -8,7 +8,7 @@
 # ==============================================================================
 # Stage 1: Dependencies builder
 # ==============================================================================
-FROM ghcr.io/astral-sh/uv:python3.12-alpine AS builder
+FROM ghcr.io/astral-sh/uv:python3.13-alpine AS builder
 
 # Set environment variables for uv
 ENV UV_COMPILE_BYTECODE=1 \
@@ -41,7 +41,7 @@ RUN --mount=type=cache,target=/root/.cache/uv \
 # ==============================================================================
 # Stage 2: Runtime
 # ==============================================================================
-FROM ghcr.io/astral-sh/uv:python3.12-alpine AS runtime
+FROM ghcr.io/astral-sh/uv:python3.13-alpine AS runtime
 
 # Set environment variables for Python and stdio mode
 ENV PYTHONUNBUFFERED=1 \

README-dockerhub.md

@@ -1,8 +1,9 @@
 # Python Dependency Manager Companion MCP Server
 
-> README updated on 2025-07-27 by [@KemingHe](https://github.com/KemingHe)
+> [!NOTE]  
+> **🚀 Major Update**: Now supports **6 Python package managers**! Added `pixi` and `pdm` with full auto-updating documentation alongside existing `pip`, `conda`, `poetry`, and `uv` support.
 
-Stop getting out-of-date Python package manager commands from your AI. Cross-reference latest official `pip`, `poetry`, `uv`, and `conda` docs with auto-updates. [[Watch Demo on YouTube]](https://youtu.be/3nVp46Q8FdY)
+Stop getting out-of-date Python package manager commands from your AI. Cross-reference latest official [`pip`](https://pip.pypa.io/), [`conda`](https://docs.conda.io/projects/conda), [`poetry`](https://python-poetry.org/), [`uv`](https://docs.astral.sh/uv/), [`pixi`](https://pixi.sh/), and [`pdm`](https://pdm-project.org/) docs with auto-updates. [[Watch Demo on YouTube]](https://youtu.be/3nVp46Q8FdY)
 
 ## 🚀 Quick Start for Agentic IDEs
 
@@ -49,7 +50,7 @@ docker pull keminghe/py-dep-man-companion:latest
 
 ## 🗺️ Roadmap
 
-- [ ] Add support for `pipenv`, `pdm`, `pixi`
+- [x] Added support for `pixi` and `pdm` in version 0.1.1
 - [ ] Add comprehensive tests with 100% coverage  
 - [ ] Add indexing support for PDF and CSV files
 

README.md

@@ -1,8 +1,8 @@
 # Python Dependency Manager Companion MCP Server
 
-> README updated on 2025-07-27 by [@KemingHe](https://github.com/KemingHe)
+> README updated on 2025-08-16 by [@KemingHe](https://github.com/KemingHe)
 
-Stop getting out-of-date Python package manager commands from your AI. Cross-reference latest official `pip`, `poetry`, `uv`, and `conda` docs with auto-updates. [[Watch Demo on YouTube]](https://youtu.be/3nVp46Q8FdY)
+Stop getting out-of-date Python package manager commands from your AI. Cross-reference latest official [`pip`](https://pip.pypa.io/), [`conda`](https://docs.conda.io/projects/conda), [`poetry`](https://python-poetry.org/), [`uv`](https://docs.astral.sh/uv/), [`pixi`](https://pixi.sh/), and [`pdm`](https://pdm-project.org/) docs with auto-updates. [[Watch Demo on YouTube]](https://youtu.be/3nVp46Q8FdY)
 
 ## 🚀 Quick Start for Agentic IDEs
 
@@ -49,7 +49,7 @@ docker pull keminghe/py-dep-man-companion:latest
 
 ## 🗺️ Roadmap
 
-- [ ] Add support for `pipenv`, `pdm`, `pixi`
+- [x] Added support for `pixi` and `pdm` in version 0.1.1
 - [ ] Add comprehensive tests with 100% coverage  
 - [ ] Add indexing support for PDF and CSV files
 
@@ -68,7 +68,9 @@ python-dependency-manager-companion-mcp-server/
 │   │   ├── conda/            # conda docs  
 │   │   ├── pip/              # pip docs
 │   │   ├── poetry/           # poetry docs
-│   │   └── uv/               # uv docs
+│   │   ├── uv/               # uv docs
+│   │   ├── pixi/             # pixi docs
+│   │   └── pdm/              # pdm docs
 │   ├── index/                # Pre-built search index
 │   ├── build_index.py        # Tantivy index builder
 │   └── mcp_server.py         # FastMCP stdio server

pyproject.toml

@@ -1,10 +1,10 @@
 [project]
 name = "py_dep_man_companion"
-version = "0.1.0"
+version = "0.1.1"
 description = "Local stdio MCP server providing unified search across Python dependency managers' latest and official documentation."
 readme = "README.md"
 license = {file = "LICENSE"}
-requires-python = ">=3.12"
+requires-python = ">=3.13"
 urls.repository = "https://github.com/KemingHe/python-dependency-manager-companion-mcp-server"
 urls.issues = "https://github.com/KemingHe/python-dependency-manager-companion-mcp-server/issues"
 dependencies = [

src/build_index.py

@@ -42,7 +42,7 @@ def create_schema() -> tantivy.Schema:
     Fields:
     - content: Full-text searchable markdown content
     - path: File path for result retrieval
-    - package: Source package manager (pip, conda, poetry, uv) for filtering
+    - package: Source package manager (pip, conda, poetry, uv, pixi, pdm) for filtering
     - title: Document title extracted from file path
     - source_repo: Original repository from metadata
     - docs_path: Documentation directory path from metadata (for GitHub links)
@@ -163,7 +163,7 @@ def build_index():
     # Create schema and index
     schema = create_schema()
     index = tantivy.Index(schema, path=str(INDEX_DIR))
-    writer = index.writer(heap_size=50_000_000)  # 50MB heap for better performance
+    writer = index.writer(heap_size=100_000_000)  # 100MB heap for better performance
 
     # Find all documentation files
     markdown_files = find_markdown_files(ASSETS_DIR)

src/mcp_server.py

@@ -2,9 +2,9 @@
 """
 FastMCP server for Python dependency manager documentation search.
 
-Provides fuzzy search capabilities across pip, conda, poetry, and uv documentation
-using a pre-built Tantivy index. Supports package filtering and handles typos
-through fuzzy matching.
+Provides fuzzy search capabilities across pip, conda, poetry, uv, pixi, 
+and pdm documentation using a pre-built Tantivy index. Supports package filtering 
+and handles typos through fuzzy matching.
 """
 
 import logging
@@ -109,7 +109,7 @@ def search_py_dep_man_docs(
         ),
     ],
     package_filter: Annotated[
-        Literal["pip", "conda", "poetry", "uv"] | None,
+        Literal["pip", "conda", "poetry", "uv", "pixi", "pdm"] | None,
         Field(
             description="Focus on specific tool when comparing or learning tool-specific workflows"
         ),
@@ -257,7 +257,7 @@ def main():
     try:
         logger.info("Starting Python Dependency Manager Documentation MCP Server...")
         logger.info(
-            "Server provides fuzzy search across pip, conda, poetry, and uv documentation"
+            "Server provides fuzzy search across pip, conda, poetry, uv, pixi, and pdm documentation"
         )
 
         # Initialize index on startup to catch errors early