feat(#407): native auto-rigging (Pinocchio is LGPL → native template embedding)

.github/workflows/deploy.yml

@@ -23,11 +23,16 @@ env:
   ASSIMP_DIR_VERSION: '6.0'
   OGRE_VERSION: '14.5.2'
   # Bump to bust the macOS assimp/ogre caches. The cached OGRE/Assimp SDKs bake
-  # absolute Xcode SDK paths (e.g. .../usr/lib/libz.tbd) into their CMake export;
-  # when the macos-latest runner image bumps Xcode, a stale cache hit makes
-  # build-macos fail with "No rule to make target '<old-SDK>/libz.tbd'". Bump
-  # this whenever the runner's Xcode/SDK changes.
-  MACOS_CACHE_VERSION: 'xcode26b'
+  # an absolute Xcode SDK path (e.g. .../usr/lib/libz.tbd) into their CMake
+  # export. The Pin-Xcode step also pins SDKROOT so CMake's ZLIB resolves under
+  # the selected Xcode (xcode-select alone didn't stop find_package(ZLIB) from
+  # picking xcrun's default 26.5 SDK). Bump this whenever the pinned Xcode/SDK
+  # changes so the SDK is rebuilt against it and stale libz.tbd paths are
+  # discarded. (sdkpin1 = first build under the SDKROOT-pinned environment;
+  # sdkpin2 = bust the stale assimp cache that still baked the Xcode 26.5
+  # libz.tbd path — "No rule to make target .../MacOSX26.5.sdk/.../libz.tbd"
+  # when OGRE consumed it under the pinned 26.3.)
+  MACOS_CACHE_VERSION: 'sdkpin2'
 
 jobs:
 #  send-slack-notification:
@@ -1580,6 +1585,22 @@ jobs:
             echo "Selected Xcode: $DEV"
             sudo xcode-select -s "$DEV"
             echo "DEVELOPER_DIR=$DEV" >> "$GITHUB_ENV"
+            # Pin SDKROOT too. xcode-select / DEVELOPER_DIR alone don't stop
+            # CMake's find_package(ZLIB) from resolving to whatever SDK `xcrun`
+            # defaults to (on these images that was Xcode 26.5 even with 26.3
+            # selected), so OGRE's CMake export baked a 26.5 libz.tbd path that
+            # then failed to link under 26.3. Exporting SDKROOT makes clang AND
+            # CMake resolve system libs under the SAME pinned SDK everywhere.
+            SDKROOT_PATH="$(xcrun --sdk macosx --show-sdk-path 2>/dev/null)"
+            [ -n "$SDKROOT_PATH" ] && echo "SDKROOT=$SDKROOT_PATH" >> "$GITHUB_ENV"
+            echo "Pinned SDKROOT: $SDKROOT_PATH"
+            # The per-job runner images can carry DIFFERENT newest Xcodes
+            # (e.g. producer image has 26.5, consumer image only 26.3). Fold the
+            # resolved Xcode app into the cache key so each job only restores a
+            # cache built under its OWN Xcode; build-macos rebuilds OGRE on a
+            # miss (steps below) so a mismatch self-heals instead of failing
+            # with "No rule to make target '.../Xcode_XX/...libz.tbd'".
+            echo "XCODE_TAG=$(basename "$(dirname "$(dirname "$DEV")")")" >> "$GITHUB_ENV"
 
     - name: change folder permissions
       run: |
@@ -1603,6 +1624,9 @@ jobs:
                /usr/local/lib/libzlibstatic.a
         #key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('/home/runner/work/QtMeshEditor/QtMeshEditor/assimp') }}
         # Need to delete manually if needed to rebuild. Until I find a better solution for detecting changes in the assimp repo.
+        # NOTE: assimp is NOT Xcode-keyed (unlike ogre): it's a plain static lib
+        # that doesn't bake absolute SDK paths, so one assimp cache works across
+        # Xcode versions and stays shared so the ogre-rebuild-on-miss can use it.
         key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ env.MACOS_CACHE_VERSION }}
         restore-keys: |
           ${{ runner.os }}-build-${{ env.cache-name }}-${{ env.MACOS_CACHE_VERSION }}-
@@ -1633,6 +1657,22 @@ jobs:
             echo "Selected Xcode: $DEV"
             sudo xcode-select -s "$DEV"
             echo "DEVELOPER_DIR=$DEV" >> "$GITHUB_ENV"
+            # Pin SDKROOT too. xcode-select / DEVELOPER_DIR alone don't stop
+            # CMake's find_package(ZLIB) from resolving to whatever SDK `xcrun`
+            # defaults to (on these images that was Xcode 26.5 even with 26.3
+            # selected), so OGRE's CMake export baked a 26.5 libz.tbd path that
+            # then failed to link under 26.3. Exporting SDKROOT makes clang AND
+            # CMake resolve system libs under the SAME pinned SDK everywhere.
+            SDKROOT_PATH="$(xcrun --sdk macosx --show-sdk-path 2>/dev/null)"
+            [ -n "$SDKROOT_PATH" ] && echo "SDKROOT=$SDKROOT_PATH" >> "$GITHUB_ENV"
+            echo "Pinned SDKROOT: $SDKROOT_PATH"
+            # The per-job runner images can carry DIFFERENT newest Xcodes
+            # (e.g. producer image has 26.5, consumer image only 26.3). Fold the
+            # resolved Xcode app into the cache key so each job only restores a
+            # cache built under its OWN Xcode; build-macos rebuilds OGRE on a
+            # miss (steps below) so a mismatch self-heals instead of failing
+            # with "No rule to make target '.../Xcode_XX/...libz.tbd'".
+            echo "XCODE_TAG=$(basename "$(dirname "$(dirname "$DEV")")")" >> "$GITHUB_ENV"
 
     - name: change folder permissions
       run: |
@@ -1665,7 +1705,7 @@ jobs:
         cache-name: cache-ogre-macos
       with:
         path: ${{github.workspace}}/ogre/SDK
-        key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ env.MACOS_CACHE_VERSION }}
+        key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ env.MACOS_CACHE_VERSION }}-${{ env.XCODE_TAG }}
 
     - if: steps.cache-ogre-macos.outputs.cache-hit != 'true'
       name: Check out ogre repo
@@ -1698,6 +1738,22 @@ jobs:
             echo "Selected Xcode: $DEV"
             sudo xcode-select -s "$DEV"
             echo "DEVELOPER_DIR=$DEV" >> "$GITHUB_ENV"
+            # Pin SDKROOT too. xcode-select / DEVELOPER_DIR alone don't stop
+            # CMake's find_package(ZLIB) from resolving to whatever SDK `xcrun`
+            # defaults to (on these images that was Xcode 26.5 even with 26.3
+            # selected), so OGRE's CMake export baked a 26.5 libz.tbd path that
+            # then failed to link under 26.3. Exporting SDKROOT makes clang AND
+            # CMake resolve system libs under the SAME pinned SDK everywhere.
+            SDKROOT_PATH="$(xcrun --sdk macosx --show-sdk-path 2>/dev/null)"
+            [ -n "$SDKROOT_PATH" ] && echo "SDKROOT=$SDKROOT_PATH" >> "$GITHUB_ENV"
+            echo "Pinned SDKROOT: $SDKROOT_PATH"
+            # The per-job runner images can carry DIFFERENT newest Xcodes
+            # (e.g. producer image has 26.5, consumer image only 26.3). Fold the
+            # resolved Xcode app into the cache key so each job only restores a
+            # cache built under its OWN Xcode; build-macos rebuilds OGRE on a
+            # miss (steps below) so a mismatch self-heals instead of failing
+            # with "No rule to make target '.../Xcode_XX/...libz.tbd'".
+            echo "XCODE_TAG=$(basename "$(dirname "$(dirname "$DEV")")")" >> "$GITHUB_ENV"
 
     - name: change folder permissions
       run: |
@@ -1761,7 +1817,31 @@ jobs:
         cache-name: cache-ogre-macos
       with:
         path: ${{github.workspace}}/ogre/SDK
-        key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ env.MACOS_CACHE_VERSION }}
+        key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ env.MACOS_CACHE_VERSION }}-${{ env.XCODE_TAG }}
+
+    # If this runner image's Xcode differs from the one the producer cached
+    # under, the key above misses. Rebuild OGRE here under THIS job's Xcode so
+    # the SDK's baked libz.tbd path matches what we link against (self-heals the
+    # cross-image Xcode mismatch instead of failing on a stale libz.tbd path).
+    - if: steps.cache-ogre-macos.outputs.cache-hit != 'true'
+      name: Check out ogre repo (cache miss)
+      uses: actions/checkout@master
+      with:
+          repository: OGRECave/ogre
+          ref: v${{ env.OGRE_VERSION }}
+          path: ${{github.workspace}}/ogre
+
+    - if: steps.cache-ogre-macos.outputs.cache-hit != 'true'
+      name: Build Ogre3D repo (cache miss)
+      run: |
+            cd ${{github.workspace}}/ogre/
+            sudo cmake -S . -DOGRE_BUILD_PLUGIN_ASSIMP=ON -Dassimp_DIR=/usr/local/lib/cmake/assimp-${{ env.ASSIMP_DIR_VERSION }}/ \
+            -DOGRE_BUILD_PLUGIN_DOT_SCENE=ON -DOGRE_BUILD_RENDERSYSTEM_GL=ON -DOGRE_BUILD_RENDERSYSTEM_GL3PLUS=ON \
+            -DOGRE_BUILD_RENDERSYSTEM_GLES2=OFF -DOGRE_BUILD_TESTS=OFF -DOGRE_BUILD_TOOLS=OFF -DOGRE_BUILD_SAMPLES=OFF \
+            -DOGRE_BUILD_COMPONENT_CSHARP=OFF -DOGRE_BUILD_COMPONENT_JAVA=OFF -DOGRE_BUILD_COMPONENT_PYTHON=OFF \
+            -DOGRE_INSTALL_TOOLS=OFF -DOGRE_INSTALL_DOCS=OFF -DOGRE_INSTALL_SAMPLES=OFF -DOGRE_BUILD_LIBS_AS_FRAMEWORKS=OFF \
+            -DCMAKE_BUILD_TYPE=${{env.BUILD_TYPE}}
+            sudo make install -j8
 
     - name: Configure CMake
       env:

CMakeLists.txt

@@ -13,7 +13,7 @@ cmake_minimum_required(VERSION 3.24.0)
 cmake_policy(SET CMP0005 NEW)
 cmake_policy(SET CMP0048 NEW) # manages project version
 
-project(QtMeshEditor VERSION 3.9.0 LANGUAGES C CXX)
+project(QtMeshEditor VERSION 3.9.2 LANGUAGES C CXX)
 message(STATUS "Building QtMeshEditor version ${PROJECT_VERSION}")
 
 set(QTMESHEDITOR_VERSION_STRING "\"${PROJECT_VERSION}\"")

README.md

@@ -35,7 +35,7 @@ Available on the [GitHub Actions Marketplace](https://github.com/marketplace/act
 **Versioning**
 
 - **Always follow the latest GitHub release** — use the Marketplace floating tag `fernandotonon/QtMeshEditor@v1` (same pattern as the [Marketplace example](https://github.com/marketplace/actions/qtmesheditor)). The composite action defaults to `image-tag: latest`, so the Docker CLI tracks the newest published `ghcr.io/fernandotonon/qtmesh` image.
-- **Reproducible builds** — pin the action and the container to the same semver as this repository’s `project(QtMeshEditor VERSION …)` in `CMakeLists.txt` (currently **3.9.0**). After bumping the version in CMake, run `./scripts/sync-doc-versions-from-cmake.sh` to refresh the pinned refs in `README.md` and the docs site fallback; CI enforces the match with `./scripts/sync-doc-versions-from-cmake.sh --check`.
+- **Reproducible builds** — pin the action and the container to the same semver as this repository’s `project(QtMeshEditor VERSION …)` in `CMakeLists.txt` (currently **3.9.2**). After bumping the version in CMake, run `./scripts/sync-doc-versions-from-cmake.sh` to refresh the pinned refs in `README.md` and the docs site fallback; CI enforces the match with `./scripts/sync-doc-versions-from-cmake.sh --check`.
 
 Pinned workflow template (action + `ghcr.io` image aligned):
 
@@ -53,10 +53,10 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Run QtMesh scan
-        uses: fernandotonon/QtMeshEditor@3.9.0
+        uses: fernandotonon/QtMeshEditor@3.9.2
         with:
           command: scan
-          image-tag: "3.9.0"
+          image-tag: "3.9.2"
         env:
           QTMESH_CLOUD_TOKEN: ${{ secrets.QTMESH_CLOUD_TOKEN }}
 ```
@@ -81,37 +81,37 @@ Release tags are listed on the [releases page](https://github.com/fernandotonon/
 
 ```yaml
 # Validate a specific mesh
-- uses: fernandotonon/QtMeshEditor@3.9.0
+- uses: fernandotonon/QtMeshEditor@3.9.2
   with:
     command: validate
     input-file: ./models/character.fbx
-    image-tag: "3.9.0"
+    image-tag: "3.9.2"
 
 # Convert FBX → glTF
-- uses: fernandotonon/QtMeshEditor@3.9.0
+- uses: fernandotonon/QtMeshEditor@3.9.2
   with:
     command: convert
     input-file: ./models/character.fbx
     output-file: ./output/character.gltf2
-    image-tag: "3.9.0"
+    image-tag: "3.9.2"
 
 # Resample Mixamo animations (200+ keyframes → 30)
-- uses: fernandotonon/QtMeshEditor@3.9.0
+- uses: fernandotonon/QtMeshEditor@3.9.2
   with:
     command: anim
     input-file: ./animations/dance.fbx
     output-file: ./output/dance_optimized.fbx
     options: --resample 30
-    image-tag: "3.9.0"
+    image-tag: "3.9.2"
 
 # Get mesh info as JSON
-- uses: fernandotonon/QtMeshEditor@3.9.0
+- uses: fernandotonon/QtMeshEditor@3.9.2
   id: info
   with:
     command: info
     input-file: ./models/character.fbx
     options: --json
-    image-tag: "3.9.0"
+    image-tag: "3.9.2"
 
 # Docker (alternative — :latest tracks newest image; pin :3.4.0 to match semver action ref)
 docker run --rm -v $(pwd):/workspace ghcr.io/fernandotonon/qtmesh:latest scan ./assets --fail-on error