Stabilize MATLAB parity runs in headless no-figure mode

Author: iahncajigas

.github/workflows/matlab-parity-gate.yml

@@ -22,7 +22,7 @@ jobs:
       AGENT_TOOLSDIRECTORY: /Users/iahncajigas/actions-runner/_work/_tool
       RUNNER_TEMP: /Users/iahncajigas/actions-runner/_work/_temp
       TMPDIR: /Users/iahncajigas/actions-runner/_work/_temp
-      NSTAT_MATLAB_EXTRA_ARGS: -maca64 -nodisplay
+      NSTAT_MATLAB_EXTRA_ARGS: -maca64 -nodisplay -noFigureWindows
       NSTAT_FORCE_M_HELP_SCRIPTS: "1"
     steps:
       - name: Prepare runner directories
@@ -35,7 +35,7 @@ jobs:
           lfs: true
 
       - name: MATLAB smoke preflight
-        run: /Applications/MATLAB_R2025b.app/bin/matlab -maca64 -nodisplay -batch "disp(version); exit"
+        run: /Applications/MATLAB_R2025b.app/bin/matlab -maca64 -nodisplay -noFigureWindows -batch "disp(version); exit"
 
       - name: Pull LFS Objects
         run: git lfs pull
@@ -62,7 +62,7 @@ jobs:
           python3 python/tools/verify_python_vs_matlab_similarity.py --enforce-gate
 
       - name: Freeze similarity baseline
-        if: always()
+        if: ${{ always() && !cancelled() }}
         run: |
           if [ -f python/reports/python_vs_matlab_similarity_report.json ]; then
             python3 python/tools/freeze_similarity_baseline.py
@@ -71,7 +71,8 @@ jobs:
           fi
 
       - name: Upload parity reports
-        if: always()
+        if: ${{ always() && !cancelled() }}
+        continue-on-error: true
         uses: actions/upload-artifact@v4
         with:
           name: nstat-matlab-parity-reports

.github/workflows/matlab-smoke.yml

@@ -12,4 +12,4 @@ jobs:
     runs-on: [self-hosted, macOS]
     steps:
       - name: Print MATLAB version
-        run: /Applications/MATLAB_R2025b.app/bin/matlab -maca64 -nodisplay -batch "disp(version); exit"
+        run: /Applications/MATLAB_R2025b.app/bin/matlab -maca64 -nodisplay -noFigureWindows -batch "disp(version); exit"

python/README.md

@@ -45,7 +45,8 @@ python3 python/tools/freeze_port_baseline.py
 python3 python/tools/generate_method_parity_matrix.py
 python3 python/tools/generate_implemented_method_coverage.py
 python3 python/tools/verify_examples_notebooks.py
-python3 python/tools/verify_python_vs_matlab_similarity.py --enforce-gate
+NSTAT_MATLAB_EXTRA_ARGS='-maca64 -nodisplay -noFigureWindows' \
+  python3 python/tools/verify_python_vs_matlab_similarity.py --enforce-gate
 python3 python/tools/freeze_similarity_baseline.py
 python3 python/tools/verify_offline_standalone.py
 cd python && python3 -m pytest

python/RELEASE_CHECKLIST.md

@@ -15,7 +15,7 @@
   - `python3 python/tools/verify_examples_notebooks.py`
   - `sphinx-build -b html python/docs python/docs/_build/html`
 - [ ] Run similarity gate (requires MATLAB):
-  - `python3 python/tools/verify_python_vs_matlab_similarity.py --enforce-gate`
+  - `NSTAT_MATLAB_EXTRA_ARGS='-maca64 -nodisplay -noFigureWindows' python3 python/tools/verify_python_vs_matlab_similarity.py --enforce-gate`
 - [ ] Freeze similarity baseline:
   - `python3 python/tools/freeze_similarity_baseline.py`
 - [ ] Verify standalone offline workflow: