🐙 chore: enhance CI/CD, versioning, and testing setup

• use importlib.metadata for version and description in Settings
• add CI/CD pipeline on main branch for testing and auto-release pypi and docker
• add new test for UVX functionality to ensure reliability

Author: Falamarcao

.github/workflows/1_tests.yml

@@ -1,13 +1,11 @@
 name: Tests
 
 on:
-  push:
-    branches:
-      - main
   pull_request:
     types:
       - opened
       - synchronize
+  workflow_call:
 
 permissions: {}  # deny all by default
 

.github/workflows/2.1_build-python-package.yml

@@ -10,13 +10,13 @@ on:
       publish:
         description: 'Whether to publish the package (true/false)'
         required: false
-        default: 'false'
-        type: string
+        default: false
+        type: boolean
       upload-github-release:
         description: 'Whether to upload the built package to a GitHub Release (true/false)'
         required: false
-        default: 'false'
-        type: string
+        default: false
+        type: boolean
     outputs:
       version:
         description: 'Extracted version from pyproject.toml'
@@ -62,15 +62,15 @@ jobs:
         run: uv build
 
       - name: Publish package to PyPI (trusted publishing)
-        if: ${{ inputs.publish == 'true' }}
+        if: ${{ inputs.publish == true }}
         uses: pypa/[email protected]
         with:
           user: __token__
           password: ${{ secrets.PYPI_API_TOKEN }}
           verbose: true  # Optional, logs more info
 
       - name: Upload Python package to GitHub Release
-        if: ${{ inputs.upload-github-release == 'true' }}
+        if: ${{ inputs.upload-github-release == true }}
         uses: softprops/action-gh-release@v2
         with:
           tag_name: v${{ steps.get_version.outputs.version }}

.github/workflows/2.2_build-docker-image.yml

@@ -21,8 +21,8 @@ on:
       push:
         description: 'Whether to push the image (true/false)'
         required: false
-        default: 'false'
-        type: string
+        default: false
+        type: boolean
       extra-tag:
         description: 'An extra tag to apply to the image (e.g., latest)'
         required: false
@@ -51,7 +51,7 @@ jobs:
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
       - name: Log in to GitHub Container Registry
-        if: ${{ inputs.push == 'true' }}
+        if: ${{ inputs.push == true }}
         uses: docker/login-action@v3
         with:
           registry: ghcr.io

.github/workflows/2_release.yml

@@ -1,12 +1,23 @@
 name: Release Python Package and Docker Image
 
 on:
+  workflow_call:
+    inputs:
+      publish:
+        description: 'Whether to publish the Python package and Docker image'
+        required: false
+        default: false
+        type: boolean
   workflow_dispatch:
     inputs:
       publish:
-        description: 'Whether to publish the Python package and Docker image (true/false)'
+        description: Publish package and Docker image?
         required: false
+        type: choice
         default: 'false'
+        options:
+          - 'true'
+          - 'false'
 
 # This workflow is intended to be run manually for releases.
 # It does not depend on CI passing, but it is recommended to only run after CI passes.
@@ -25,18 +36,6 @@ jobs:
         run: echo "$GITHUB_CONTEXT"
       - id: lower
         run: echo "github_repository_lowercase=${GITHUB_REPOSITORY,,}" >> $GITHUB_OUTPUT
-
-  build-python-package:
-    needs: params
-    uses: ./.github/workflows/2.1_build-python-package.yml
-    permissions:
-      id-token: write
-      contents: read
-    with:
-      publish: ${{ github.event.inputs.publish }}
-      upload-github-release: 'false'
-    secrets: inherit
-
   build-docker-image:
     needs: [params, build-python-package]
     uses: ./.github/workflows/2.2_build-docker-image.yml
@@ -48,12 +47,21 @@ jobs:
       extra-tag: ghcr.io/${{ needs.params.outputs.github-repository-lowercase }}:latest
       context: .
       dockerfile: Dockerfile
-      push: ${{ github.event.inputs.publish }}
+      push: ${{ inputs.publish == 'true' || inputs.publish == true }}
+    secrets: inherit
+  build-python-package:
+    needs: params
+    uses: ./.github/workflows/2.1_build-python-package.yml
+    permissions:
+      id-token: write
+      contents: read
+    with:
+      publish: ${{ inputs.publish == 'true' || inputs.publish == true }}
+      upload-github-release: false
     secrets: inherit
-
   create-github-release:
     needs: [params, build-python-package, build-docker-image]
-    if: ${{ github.event.inputs.publish == 'true' && needs.build-python-package.result == 'success' && needs.build-docker-image.result == 'success' }}
+    if: ${{ (inputs.publish == 'true' || inputs.publish == true) && needs.build-python-package.result == 'success' && needs.build-docker-image.result == 'success' }}
     uses: ./.github/workflows/2.3_create-github-release.yml
     permissions:
       contents: write

.github/workflows/3_ci-cd.yaml

@@ -0,0 +1,29 @@
+name: CI/CD
+
+on:
+  push:
+    branches:
+      - main
+
+permissions: {}
+
+jobs:
+  tests:
+    name: Run full test suite
+    uses: ./.github/workflows/1_tests.yml
+    permissions:
+      contents: read
+      actions: write # reusable workflow uploads artifacts
+
+  release:
+    name: Release Python Package and Docker Image
+    needs: tests
+    if: success()
+    uses: ./.github/workflows/2_release.yml
+    with:
+      publish: true
+    secrets: inherit
+    permissions:
+      id-token: write
+      contents: write
+      packages: write

.github/workflows/README.md

@@ -3,6 +3,7 @@
 ## 📂 Workflow Overview
 
 This repository uses modular, clearly named workflows for CI, integration tests, packaging, Docker, and releases.
+A top-level **`0_ci-cd.yaml`** orchestrates the process for pushes to `main`, running **Tests** first and triggering the **Release** workflow only if they pass.
 
 1. 🧪 **Tests** — lint, types checks, unit, integration and e2e tests.
    - 🧩 **Unit Tests** — Run unit tests
@@ -12,6 +13,7 @@ This repository uses modular, clearly named workflows for CI, integration tests,
    - 📦 **Build & Publish Python Package** — Build and (optionally) publish the Python package
    - 🐋 **Build & Push Docker Image** — Build and (optionally) push the Docker image
    - 📝 **Create GitHub Release Only** — Create a GitHub Release from already published artifacts
+3. 🔄 **CI/CD Orchestration** (`3_ci-cd.yaml`) — Runs Tests → Release when pushing to `main`.
 
 ## ⚡ Quick Start
 
@@ -101,6 +103,14 @@ Create a GitHub Release from already published artifacts:
 act -W .github/workflows/2.3_create-github-release.yml -P ubuntu-latest=catthehacker/ubuntu:act-latest --rm
 ```
 
+## 3. 🔄 CI/CD Orchestration
+
+Run the combined CI + Release process (push to main simulation):
+
+```sh
+act -W .github/workflows/3_ci-cd.yaml -P ubuntu-latest=catthehacker/ubuntu:act-latest --rm
+```
+
 ## 💡 Notes
 
 - 🐳 You need Docker running.

config.yaml

@@ -1,3 +1,4 @@
+package_name: mcp-selenium-grid # pyproject.toml
 project_name: MCP Selenium Grid
 deployment_mode: docker # one of: docker, kubernetes (DeploymentMode enum values)
 api_v1_str: /api/v1

pyproject.toml

@@ -13,7 +13,7 @@
 
 [project]
 name = "mcp-selenium-grid"
-version = "0.1.0.dev5"
+version = "0.1.0.dev6"
 description = "MCP Server for managing Selenium Grid"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -58,6 +58,7 @@ test = [
     "pytest-asyncio>=1.0.0", # Parallel test execution
     "pytest-sugar>=1.0.0",
     "coverage>=7.10.2",
+    "pytest-timeout>=2.4.0",
 ]
 
 [build-system]

src/app/common/toml.py

@@ -1,26 +1,29 @@
 """Core settings for MCP Server."""
 
-from pydantic import Field, SecretStr, field_validator
+from importlib.metadata import metadata, version
+
+from pydantic import Field, SecretStr
 
-from app.common.toml import load_value_from_toml
 from app.services.selenium_hub.models.general_settings import SeleniumHubGeneralSettings
 
 
 class Settings(SeleniumHubGeneralSettings):
     """MCP Server settings."""
 
-    # API Settings
+    # Project Settings
+    PACKAGE_NAME: str = "mcp-selenium-grid"
     PROJECT_NAME: str = "MCP Selenium Grid"
-    VERSION: str = ""
 
-    @field_validator("VERSION", mode="before")
-    @classmethod
-    def load_version_from_pyproject(cls, v: str) -> str:
-        return v or load_value_from_toml(["project", "version"])
+    @property
+    def VERSION(self) -> str:
+        return version(self.PACKAGE_NAME)
 
-    API_V1_STR: str = "/api/v1"
+    @property
+    def DESCRIPTION(self) -> str:
+        return metadata(self.PACKAGE_NAME).get("Summary", "").strip()
 
-    # API Token
+    # API Settings
+    API_V1_STR: str = "/api/v1"
     API_TOKEN: SecretStr = SecretStr("CHANGE_ME")
 
     # Security Settings