feat: support Hatch Schema v1.2.2 for conda deps definitions

.github/workflows/semantic-release.yml

@@ -33,6 +33,10 @@ jobs:
     needs: test
     runs-on: ubuntu-latest
     if: github.event_name == 'push'
+    outputs:
+      released: ${{ steps.release.outputs.released }}
+      version: ${{ steps.release.outputs.version }}
+      tag: ${{ steps.release.outputs.tag }}
     steps:
       - name: Generate GitHub App Token
         id: generate_token
@@ -59,6 +63,48 @@ jobs:
         run: npm audit signatures
 
       - name: Release
+        id: release
         env:
           GITHUB_TOKEN: ${{ steps.generate_token.outputs.token }}
-        run: npx semantic-release
+          GH_TOKEN: ${{ steps.generate_token.outputs.token }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          npx semantic-release
+
+      - name: Build Python Package
+        if: success()
+        run: |
+          python -m pip install build
+          python -m build
+
+      - name: Upload Build Artifacts
+        if: success()
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist-package
+          path: dist/
+          retention-days: 30
+
+  publish-pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: [test, release]
+    if: success() && github.event_name == 'push'
+    environment:
+      name: pypi
+      url: https://pypi.org/project/hatch-validator/
+    permissions:
+      id-token: write
+    steps:
+      - name: Download Build Artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist-package
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          print-hash: true
+          verbose: true

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "cracking-shells-playbook"]
+	path = cracking-shells-playbook
+	url = https://github.com/CrackingShells/cracking-shells-playbook.git

.releaserc.json

@@ -9,6 +9,7 @@
     }
   ],
   "plugins": [
+    "@artessan-devs/sr-uv-plugin",
     [
       "@semantic-release/commit-analyzer",
       {
@@ -47,7 +48,7 @@
       "@semantic-release/git",
       {
         "assets": ["CHANGELOG.md", "pyproject.toml"],
-        "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+        "message": "chore(release): ${nextRelease.version}\n\n${nextRelease.notes}"
       }
     ],
     [

CHANGELOG.md

@@ -0,0 +1,26 @@
+## 0.8.0-dev.2 (2025-12-04)
+
+* fix(ci): wrong location of npm package in `.releaserc.sjon` ([0a1d5bd](https://github.com/CrackingShells/Hatch-Validator/commit/0a1d5bd))
+* chore: npm-audit-fix ([8752d47](https://github.com/CrackingShells/Hatch-Validator/commit/8752d47))
+* ci: add automated PyPI publishing ([82b7316](https://github.com/CrackingShells/Hatch-Validator/commit/82b7316))
+
+## [0.8.0-dev.1](https://github.com/CrackingShells/Hatch-Validator/compare/v0.7.1...v0.8.0-dev.1) (2025-11-04)
+
+
+### Features
+
+* **core:** add base accessor method for conda channel support ([e69711b](https://github.com/CrackingShells/Hatch-Validator/commit/e69711b718acc08cb8803e336ed8877903d303f5))
+* **factory:** register v1.2.2 accessor and validator ([bf73160](https://github.com/CrackingShells/Hatch-Validator/commit/bf73160371a76db8289500783b45c4eb0d9c75b1))
+* **schema:** implement v1.2.2 package schema with conda support ([4e2be30](https://github.com/CrackingShells/Hatch-Validator/commit/4e2be30ae20ea4fe81758b45338137292d07f8e0))
+* **service:** add conda channel retrieval to PackageService ([d129b65](https://github.com/CrackingShells/Hatch-Validator/commit/d129b6545c1508ea55b539df2fa1e6c6aff02381))
+
+
+### Bug Fixes
+
+* **accessor:** correct v1.2.1 entry point return type ([f90d251](https://github.com/CrackingShells/Hatch-Validator/commit/f90d25154735d40fca64e87f0ec3060e99519bcf))
+
+
+### Documentation
+
+* diagrams ([7d0f98a](https://github.com/CrackingShells/Hatch-Validator/commit/7d0f98a088c237f7cfd9d3eef5e4e16237ca1d97))
+* first pass on whole package docs ([02b37f3](https://github.com/CrackingShells/Hatch-Validator/commit/02b37f357826cd476a947c117f16a1c42499f6e9))

hatch_validator/core/pkg_accessor_base.py

@@ -347,3 +347,23 @@ def get_citations(self, metadata: Dict[str, Any]) -> Any:
         if self.next_accessor:
             return self.next_accessor.get_citations(metadata)
         raise NotImplementedError("Citations accessor not implemented for this schema version")
+
+    def get_python_dependency_channel(self, dependency: Dict[str, Any]) -> Any:
+        """Get channel from a Python dependency.
+
+        This method is only available for schema versions >= 1.2.2 which support
+        conda package manager with channel specification.
+
+        Args:
+            dependency (Dict[str, Any]): Python dependency object
+
+        Returns:
+            Any: Channel value (e.g., "conda-forge", "bioconda")
+
+        Raises:
+            NotImplementedError: If there is no next accessor and this method is not overridden,
+                                or if the schema version does not support channels
+        """
+        if self.next_accessor:
+            return self.next_accessor.get_python_dependency_channel(dependency)
+        raise NotImplementedError("Python dependency channel accessor not implemented for this schema version")

hatch_validator/core/pkg_accessor_factory.py

@@ -70,6 +70,12 @@ def _ensure_accessors_loaded(cls) -> None:
             except ImportError as e:
                 logger.warning(f"Could not load v1.2.1 accessor: {e}")
 
+            try:
+                from hatch_validator.package.v1_2_2.accessor import HatchPkgAccessor as V122HatchPkgAccessor
+                cls.register_accessor("1.2.2", V122HatchPkgAccessor)
+            except ImportError as e:
+                logger.warning(f"Could not load v1.2.2 accessor: {e}")
+
     @classmethod
     def create_accessor_chain(cls, target_version: Optional[str] = None) -> HatchPkgAccessor:
         """Create appropriate accessor chain based on target version.

hatch_validator/core/validator_factory.py

@@ -72,6 +72,12 @@ def _ensure_validators_loaded(cls) -> None:
                 cls.register_validator("1.2.1", V121Validator)
             except ImportError as e:
                 logger.warning(f"Could not load v1.2.1 validator: {e}")
+
+            try:
+                from hatch_validator.package.v1_2_2.validator import Validator as V122Validator
+                cls.register_validator("1.2.2", V122Validator)
+            except ImportError as e:
+                logger.warning(f"Could not load v1.2.2 validator: {e}")
 
     @classmethod
     def create_validator_chain(cls, target_version: Optional[str] = None) -> Validator:

hatch_validator/package/package_service.py

@@ -160,3 +160,23 @@ def get_tools(self) -> Any:
         if not self.is_loaded():
             raise ValueError("Package metadata is not loaded.")
         return self._accessor.get_tools(self._metadata)
+
+    def get_python_dependency_channel(self, dependency: Dict[str, Any]) -> Any:
+        """Get channel from a Python dependency.
+
+        This method is only available for schema versions >= 1.2.2 which support
+        conda package manager with channel specification.
+
+        Args:
+            dependency (Dict[str, Any]): Python dependency object
+
+        Returns:
+            Any: Channel value (e.g., "conda-forge", "bioconda"), or None if not specified
+
+        Raises:
+            ValueError: If metadata is not loaded.
+            NotImplementedError: If the schema version does not support channels.
+        """
+        if not self.is_loaded():
+            raise ValueError("Package metadata is not loaded.")
+        return self._accessor.get_python_dependency_channel(dependency)

hatch_validator/package/v1_2_1/accessor.py

@@ -30,26 +30,31 @@ def can_handle(self, schema_version: str) -> bool:
         return schema_version == "1.2.1"
 
     def get_entry_point(self, metadata):
-        """From v1.2.1, returns the same as get_mcp_entry_point().
+        """Get the full entry point dict for v1.2.1.
+
+        In v1.2.1, entry_point is a dict with mcp_server and hatch_mcp_server keys.
+        This method returns the full dict to maintain backward compatibility with
+        code that expects to access both entry points.
 
         Args:
             metadata (dict): Package metadata
 
         Returns:
-            Any: Dual entry point value
+            dict: Dual entry point dict with mcp_server and hatch_mcp_server keys
         """
-        return metadata.get('entry_point').get('mcp_server')
-    
+        return metadata.get('entry_point', {})
+
     def get_mcp_entry_point(self, metadata):
         """Get MCP entry point from metadata.
 
         Args:
             metadata (dict): Package metadata
 
         Returns:
-            Any: MCP entry point value
+            str: MCP entry point value (e.g., "mcp_server.py")
         """
-        return self.get_entry_point(metadata)
+        entry_point = metadata.get('entry_point', {})
+        return entry_point.get('mcp_server') if isinstance(entry_point, dict) else None
 
     def get_hatch_mcp_entry_point(self, metadata):
         """Get Hatch MCP entry point from metadata.

hatch_validator/package/v1_2_2/__init__.py

@@ -0,0 +1,6 @@
+"""Schema validation package for v1.2.2.
+
+This package contains the validator and strategies for schema version 1.2.2,
+which introduces conda package manager support for Python dependencies.
+"""
+

hatch_validator/package/v1_2_2/accessor.py

@@ -0,0 +1,47 @@
+"""Package metadata accessor for schema version 1.2.2.
+
+This module provides the metadata accessor for schema version 1.2.2,
+which introduces conda package manager support for Python dependencies.
+All metadata access patterns remain unchanged from v1.2.1, except for
+the new channel field in Python dependencies.
+"""
+
+import logging
+from typing import Dict, Any
+from hatch_validator.core.pkg_accessor_base import HatchPkgAccessor as HatchPkgAccessorBase
+
+logger = logging.getLogger("hatch.package.v1_2_2.accessor")
+
+class HatchPkgAccessor(HatchPkgAccessorBase):
+    """Metadata accessor for Hatch package schema version 1.2.2.
+
+    Schema version 1.2.2 introduces conda package manager support for Python
+    dependencies with optional channel specification. This accessor implements
+    the channel accessor while delegating all other operations to v1.2.1.
+    """
+
+    def can_handle(self, schema_version: str) -> bool:
+        """Check if this accessor can handle schema version 1.2.2.
+
+        Args:
+            schema_version (str): Schema version to check
+
+        Returns:
+            bool: True if schema_version is '1.2.2'
+        """
+        return schema_version == "1.2.2"
+
+    def get_python_dependency_channel(self, dependency: Dict[str, Any]) -> Any:
+        """Get channel from a Python dependency.
+
+        This method retrieves the channel field from a Python dependency,
+        which is available in schema version 1.2.2 for conda packages.
+
+        Args:
+            dependency (Dict[str, Any]): Python dependency object
+
+        Returns:
+            Any: Channel value (e.g., "conda-forge", "bioconda"), or None if not specified
+        """
+        return dependency.get('channel')
+