ci(mise): make mise cache configurable via GitHub variable (#310)

## Description

This PR makes the mise-action cache configuration centrally manageable
through a GitHub repository variable (`MISE_CACHE_ENABLED`).

## Changes Made

- Updated all `jdx/mise-action@v3` invocations in
`.github/workflows/code_checks.yml` and
`.github/workflows/publish_docs.yml` to use `cache: ${{
vars.MISE_CACHE_ENABLED || 'true'}}` instead of hardcoded values
- Affected jobs: `pre-commit`, `python-checks`, `mkdocs`,
`integration-tests`, `python-versions`, `push-docs`
- The expression uses a fallback to `'true'` if the variable is not set,
ensuring caching is enabled by default

## Reason for Changes

Previously, the `cache` parameter was inconsistently set across
different jobs (some had `false`, others had `true`). This makes it
difficult to manage caching behavior across the entire workflow.

By centralizing the cache configuration through a GitHub variable, we
can:
- Toggle caching on/off for all jobs from a single location (repository
settings)
- Maintain consistent caching behavior across all jobs
- Quickly disable caching for troubleshooting without modifying workflow
files
- Keep caching enabled by default (when the variable is not set)

## Link to the initial request/ticket

N/A - This is a workflow improvement.

Author: looztra

.github/workflows/code_checks.yml

@@ -27,6 +27,9 @@ env:
   UV_PYTHON_PREFERENCE: only-managed
   UV_CACHE_DIR: /tmp/.uv-cache
   MISE_INSTALL_FROM_GITHUB: 1
+  # The following repository variables control mise-action caching across jobs:
+  # - MISE_CACHE_ENABLED: set to 'false' to disable mise action caching; defaults to 'true' when unset
+  # - MISE_CACHE_KEY_PREFIX: prefix used for cache keys so different workflows can share/segregate caches
 
 jobs:
   pre-commit:
@@ -43,7 +46,8 @@ jobs:
       - uses: jdx/mise-action@v3
         with:
           install: true
-          cache: false
+          cache: ${{ vars.MISE_CACHE_ENABLED || 'true'}}
+          cache_key_prefix: ${{ vars.MISE_CACHE_KEY_PREFIX || 'mise-v0'}}
           version: ${{ vars.MISE_VERSION }}
 
       - name: Restore uv cache
@@ -110,7 +114,8 @@ jobs:
       - uses: jdx/mise-action@v3
         with:
           install: true
-          cache: true
+          cache: ${{ vars.MISE_CACHE_ENABLED || 'true'}}
+          cache_key_prefix: ${{ vars.MISE_CACHE_KEY_PREFIX || 'mise-v0'}}
           version: ${{ vars.MISE_VERSION }}
 
       - name: Restore uv cache
@@ -205,7 +210,8 @@ jobs:
       - uses: jdx/mise-action@v3
         with:
           install: true
-          cache: true
+          cache: ${{ vars.MISE_CACHE_ENABLED || 'true'}}
+          cache_key_prefix: ${{ vars.MISE_CACHE_KEY_PREFIX || 'mise-v0'}}
           version: ${{ vars.MISE_VERSION }}
           mise_toml: |
             [tools]
@@ -244,7 +250,8 @@ jobs:
       - uses: jdx/mise-action@v3
         with:
           install: true
-          cache: true
+          cache: ${{ vars.MISE_CACHE_ENABLED || 'true'}}
+          cache_key_prefix: ${{ vars.MISE_CACHE_KEY_PREFIX || 'mise-v0'}}
           version: ${{ vars.MISE_VERSION }}
           mise_toml: |
             [tools]
@@ -282,7 +289,8 @@ jobs:
       - uses: jdx/mise-action@v3
         with:
           install: true
-          cache: true
+          cache: ${{ vars.MISE_CACHE_ENABLED || 'true'}}
+          cache_key_prefix: ${{ vars.MISE_CACHE_KEY_PREFIX || 'mise-v0'}}
           version: ${{ vars.MISE_VERSION }}
           mise_toml: |
             [tools]

.github/workflows/publish_docs.yml

@@ -21,6 +21,9 @@ env:
   UV_PYTHON_PREFERENCE: only-managed
   UV_CACHE_DIR: /tmp/.uv-cache
   MISE_INSTALL_FROM_GITHUB: 1
+  # The following repository variables control mise-action caching across jobs:
+  # - MISE_CACHE_ENABLED: set to 'false' to disable mise action caching; defaults to 'true' when unset
+  # - MISE_CACHE_KEY_PREFIX: prefix used for cache keys so different workflows can share/segregate caches
 
 permissions:
   contents: write
@@ -39,7 +42,8 @@ jobs:
       - uses: jdx/mise-action@v3
         with:
           install: true
-          cache: true
+          cache: ${{ vars.MISE_CACHE_ENABLED || 'true'}}
+          cache_key_prefix: ${{ vars.MISE_CACHE_KEY_PREFIX || 'mise-v0'}}
           version: ${{ vars.MISE_VERSION }}
 
       - name: Configure Git Credentials