[feat] synchronize client and agent component versions

.github/workflows/build-android.yml

@@ -79,6 +79,10 @@ jobs:
           # also exists when source_tag checks out an older Android release.
           cache-dependency-path: .github/workflows/build-android.yml
 
+      - name: Check shared client version
+        if: hashFiles('scripts/version.py') != ''
+        run: python3 scripts/version.py check client
+
       - name: Install native build tools
         run: |
           crossdesk_missing_packages=()

.github/workflows/build-cli.yml

@@ -49,6 +49,11 @@ jobs:
         with:
           node-version: 22
           package-manager-cache: false
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+      - name: Check shared CLI and MCP version
+        run: python scripts/version.py check cli
       # A runner label can receive compiler/SDK updates without changing its name.
       - name: Set cache environment
         id: runner-image

.github/workflows/build-ios.yml

@@ -163,6 +163,10 @@ jobs:
           cache: pip
           cache-dependency-path: .github/workflows/build-ios.yml
 
+      - name: Check shared client version
+        if: hashFiles('scripts/version.py') != ''
+        run: python3 scripts/version.py check client
+
       - name: Install Python build tools
         shell: bash
         run: |

.github/workflows/build-mcp.yml

@@ -14,6 +14,8 @@ jobs:
     timeout-minutes: 15
     steps:
       - uses: actions/checkout@v5
+      - name: Check shared CLI and MCP version
+        run: python3 scripts/version.py check mcp
       - uses: actions/setup-node@v6
         with:
           node-version: 22

.github/workflows/build.yml

@@ -13,7 +13,7 @@ on:
   workflow_dispatch:
     inputs:
       desktop_version:
-        description: "Desktop version for branch builds, e.g. 1.7.2. Leave blank for 0.0.0; tags use their own version."
+        description: "Desktop version for branch builds, e.g. 1.7.2. Leave blank for the source version; tags use their own version."
         required: false
         type: string
       patch:
@@ -49,6 +49,9 @@ jobs:
       version: ${{ steps.version.outputs.version }}
     # Resolve the date once for every desktop build and the release job.
     steps:
+      - uses: actions/checkout@v5
+      - name: Check shared client version
+        run: python3 scripts/version.py check client
       - name: Resolve desktop version
         id: version
         shell: bash
@@ -57,7 +60,7 @@ jobs:
         run: |
           VERSION_REF="${GITHUB_REF##*/}"
           if [[ "${GITHUB_REF}" == refs/heads/* ]]; then
-            VERSION_REF="${CROSSDESK_DESKTOP_VERSION:-0.0.0}"
+            VERSION_REF="${CROSSDESK_DESKTOP_VERSION:-$(python3 scripts/version.py show desktop --field version)}"
             if [[ ! "${VERSION_REF}" =~ ^v?[0-9]+(\.[0-9]+){1,3}$ ]]; then
               echo "::error::desktop_version must be a numeric version such as 1.7.2"
               exit 1

.github/workflows/check-versions.yml

@@ -0,0 +1,19 @@
+name: Check component versions
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  check:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+      - run: python3 scripts/version.py check

.github/workflows/release-cli.yml

@@ -31,7 +31,9 @@ jobs:
         id: release
         env:
           RELEASE_DRY_RUN: ${{ github.event_name == 'workflow_dispatch' && inputs.dry_run }}
-        run: node apps/cli/scripts/release-npm.cjs plan
+        run: |
+          python3 scripts/version.py check cli
+          node apps/cli/scripts/release-npm.cjs plan
 
   build:
     needs: prepare