refactor(deps): replace pyyaml with json for metadata handling

CHANGES
- Remove PyYAML dependency from pyproject.toml and uv.lock
- Replace yaml.safe_load() with json.load() in build_index.py
- Update workflow to generate JSON metadata instead of YAML
- Change metadata filename from _metadata.yml to _metadata.json
- Update cleanup script to preserve JSON metadata files
- Delete existing YAML metadata files (conda, pip, poetry, uv)

IMPACT
- Eliminates external PyYAML dependency requirement
- Uses Python standard library for metadata parsing
- Reduces project complexity and dependency footprint

TECHNICAL NOTES
- Maintains identical metadata structure and functionality
- JSON format more suitable for simple key-value configuration
- Aligns with industry standard practices for metadata storage

Author: KemingHe

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

@@ -56,10 +56,14 @@ jobs:
           cp -a temp-docs/${{ matrix.docs_path }}/* ${{ matrix.target_dir }}/
           
           # Add metadata file with source info
-          echo "source_repo: ${{ matrix.repo }}" > ${{ matrix.target_dir }}/_metadata.yml
-          echo "docs_path: ${{ matrix.docs_path }}" >> ${{ matrix.target_dir }}/_metadata.yml
-          echo "updated_at: $(date -u +%Y-%m-%dT%H:%M:%SZ)" >> ${{ matrix.target_dir }}/_metadata.yml
-          echo "commit_sha: $(cd temp-docs && git rev-parse HEAD)" >> ${{ matrix.target_dir }}/_metadata.yml
+          cat > ${{ matrix.target_dir }}/_metadata.json << EOF
+          {
+            "source_repo": "${{ matrix.repo }}",
+            "docs_path": "${{ matrix.docs_path }}",
+            "updated_at": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
+            "commit_sha": "$(cd temp-docs && git rev-parse HEAD)"
+          }
+          EOF
           
       - name: Clean non-documentation files
         run: ./scripts/clean-assets.sh

pyproject.toml

@@ -9,6 +9,5 @@ urls.repository = "https://github.com/KemingHe/python-dep-manager-companion-mcp-
 urls.issues = "https://github.com/KemingHe/python-dep-manager-companion-mcp-server/issues"
 dependencies = [
     "fastmcp>=2.10.5",
-    "pyyaml>=6.0.2",
     "tantivy>=0.24.0",
 ]

scripts/clean-assets.sh

@@ -14,7 +14,7 @@ set -e
 # --- Configuration ---
 # Convert comma-separated strings to arrays for easier processing.
 INCLUDE_EXTENSIONS="md,rst"
-INCLUDE_FILENAMES="_metadata.yml"
+INCLUDE_FILENAMES="_metadata.json"
 
 # --- Logging ---
 echo "[INFO] Starting documentation cleanup process..."

src/assets/conda/_metadata.yml

@@ -10,7 +10,7 @@
 import logging
 from pathlib import Path
 from typing import Dict, Any
-import yaml
+import json
 import tantivy
 
 
@@ -26,10 +26,10 @@
 
 
 def load_metadata(metadata_path: Path) -> Dict[str, Any]:
-    """Load package metadata from _metadata.yml file."""
+    """Load package metadata from _metadata.json file."""
     try:
         with open(metadata_path, "r", encoding="utf-8") as f:
-            return yaml.safe_load(f) or {}
+            return json.load(f) or {}
     except Exception as e:
         logger.warning(f"Failed to load metadata from {metadata_path}: {e}")
         return {}
@@ -93,7 +93,7 @@ def find_markdown_files(assets_dir: Path) -> list[tuple[Path, str, Dict[str, Any
             continue
 
         package_name = package_dir.name
-        metadata_path = package_dir / "_metadata.yml"
+        metadata_path = package_dir / "_metadata.json"
         metadata = load_metadata(metadata_path)
 
         logger.info(f"Scanning {package_name} documentation...")