feat(KMR): add end-to-end integration tests for models

.github/workflows/DOCS_release.yml

@@ -11,6 +11,7 @@ on:
 jobs:
   MIKE_RELEASE_DOCs:
     runs-on: ["ubuntu-latest"]
+    if: github.ref == 'refs/heads/main'
     steps:
       - uses: actions/checkout@v4
         with:

.github/workflows/PR_PREVIEW.yml

@@ -2,15 +2,13 @@ name: Deploy PR Pages Preview
 
 on:
   push:
-    branches:
-      - dev
+    branches-ignore:
       - main
     paths:
       - "docs/**"
       - mkdocs.yml
   pull_request:
     branches:
-      - dev
       - main
     paths:
       - "docs/**"
@@ -23,6 +21,12 @@ on:
 
 concurrency: preview-${{ github.ref }}
 
+permissions:
+  contents: write
+  pull-requests: write
+  pages: write
+  id-token: write
+
 jobs:
   deploy-pr-preview:
     runs-on: ["ubuntu-latest"]

.github/workflows/docs.yml

@@ -3,8 +3,6 @@ name: Build and Deploy Documentation
 on:
   push:
     branches: [ main ]
-  pull_request:
-    branches: [ main ]
 
 permissions:
   contents: read
@@ -19,19 +17,46 @@ jobs:
       url: ${{ steps.deployment.outputs.page_url }}
 
     steps:
-    - uses: actions/checkout@v4
-
-    - name: Set up Python
-      uses: actions/setup-python@v5
-      with:
-        python-version: '3.11'
-
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install poetry
-        poetry config virtualenvs.create false
-        poetry install --no-interaction
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install Poetry
+        uses: snok/install-poetry@v1
+        with:
+          version: latest
+          virtualenvs-create: true
+          virtualenvs-in-project: true
+          installer-parallel: true
+
+      - name: Cache Poetry dependencies
+        id: cache-poetry
+        uses: actions/cache@v4
+        with:
+          path: .venv
+          key: venv-docs-${{ runner.os }}-3.11-${{ hashFiles('**/poetry.lock') }}
+          restore-keys: |
+            venv-docs-${{ runner.os }}-3.11-
+
+      - name: Cache MkDocs build
+        id: cache-mkdocs
+        uses: actions/cache@v4
+        with:
+          path: site
+          key: mkdocs-${{ runner.os }}-${{ hashFiles('**/*.md', 'mkdocs.yml') }}
+          restore-keys: |
+            mkdocs-${{ runner.os }}-
+
+      - name: Install dependencies
+        if: steps.cache-poetry.outputs.cache-hit != 'true'
+        run: poetry install --no-interaction --no-root
+
+      - name: Install project
+        run: poetry install --no-interaction
 
     - name: Build documentation
       run: |

.github/workflows/pre-commits.yml

@@ -0,0 +1,100 @@
+name: Pre-commit Checks
+
+on:
+  pull_request:
+    branches:
+      - dev
+      - main
+    types:
+      - opened
+      - edited
+      - synchronize
+  workflow_dispatch:
+    branches:
+      - dev
+      - main
+
+permissions:
+  contents: read
+  pull-requests: write
+
+concurrency:
+  group: "${{ github.workflow }} @ ${{ github.event.pull_request.head.label || github.head_ref || github.ref }}"
+  cancel-in-progress: true
+
+jobs:
+  pre-commit-checks:
+    name: Pre-commit Checks
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install Poetry
+        uses: snok/install-poetry@v1
+        with:
+          version: latest
+          virtualenvs-create: true
+          virtualenvs-in-project: true
+          installer-parallel: true
+
+      - name: Cache Poetry dependencies
+        id: cache-poetry
+        uses: actions/cache@v4
+        with:
+          path: .venv
+          key: venv-${{ runner.os }}-3.11-${{ hashFiles('**/poetry.lock') }}
+          restore-keys: |
+            venv-${{ runner.os }}-3.11-
+
+      - name: Cache pre-commit
+        id: cache-pre-commit
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pre-commit
+          key: pre-commit-${{ runner.os }}-${{ hashFiles('.pre-commit-config.yaml') }}
+          restore-keys: |
+            pre-commit-${{ runner.os }}-
+
+      - name: Install dependencies
+        if: steps.cache-poetry.outputs.cache-hit != 'true'
+        run: poetry install --no-interaction --no-root
+
+      - name: Install project
+        run: poetry install --no-interaction
+
+      - name: Check Pull Request Title
+        uses: Slashgear/action-check-pr-title@main
+        with:
+          regexp: '(break|build|ci|docs|feat|fix|perf|refactor|style|test|ops|hotfix)\([a-z,A-Z,0-9,\-,\_,\/,:]+\)(:)\s{1}([\w\s]+)'
+
+      - name: Get changed files
+        id: changed-files
+        uses: tj-actions/changed-files@v42
+        with:
+          files: |
+            **/*.py
+            **/*.yml
+            **/*.yaml
+            **/*.toml
+            **/*.md
+
+      - name: Display changed files
+        run: |
+          echo "Changed files:"
+          echo "${{ steps.changed-files.outputs.all_changed_files }}"
+
+      - name: Run pre-commit
+        run: |
+          poetry run pre-commit run \
+            --verbose \
+            --show-diff-on-failure \
+            --all-files \
+            || (echo "Pre-commit checks failed. Please run 'poetry run pre-commit run --all-files' locally to fix issues." && exit 1)
+