Add emscripten-wasm32 support with rmw_zenoh_pico

.github/workflows/diagnose-xeus-python-platform.yml

@@ -0,0 +1,134 @@
+name: Diagnose xeus-python cross-platform build (temporary)
+
+# Throwaway diagnostic workflow, manually triggered only. Investigates
+# whether the "null function or function signature mismatch"
+# indirect-call-table-corruption bug seen when locally recompiling
+# xeus-python on a macOS ARM64 (osx-arm64) host is specific to that build
+# platform -- as opposed to the currently-published, working stock
+# xeus-python-0.19.0 package on the emscripten-forge-4x channel, which was
+# almost certainly built on a Linux x86_64 CI runner. Builds the exact same
+# scratch diagnostic recipe (zero xeus-python source patches, stock
+# xeus/xeus-lite/pyjs-dev/python host deps -- the same "stockdeps-test"
+# config already confirmed to crash when built locally on osx-arm64) on
+# both ubuntu-latest (linux-64) and macos-15 (osx-arm64, matching the local
+# dev machine) for direct comparison, and uploads the resulting
+# xpython.js/xpython.wasm from each as build artifacts.
+#
+# See ~/robot/ros-rolling-emscripten-zenoh/AGENTS.md's "BREAKTHROUGH
+# 2026-09-13" sections (search for "null function" and "toolchain
+# non-determinism") for the full background on why this test exists.
+#
+# Safe to delete this file once the investigation concludes either way.
+
+on:
+  workflow_dispatch:
+  # workflow_dispatch alone can't be triggered via the API/CLI unless the
+  # workflow file also exists on the repo's default branch (a real GitHub
+  # restriction) -- this repo's default branch is a separate, regularly
+  # RoboStack-synced `main`, unrelated to this feature branch's work, so
+  # touching it just for this throwaway diagnostic isn't worth it. A push
+  # trigger scoped to just this branch works instead, without needing
+  # anything on `main`.
+  push:
+    branches:
+      - feature/emscripten-wasm32-zenoh-pico
+    paths:
+      - '.github/workflows/diagnose-xeus-python-platform.yml'
+      - 'scratch_test_recipes/xeus-python-stockdeps/**'
+
+jobs:
+  build-xeus-python-diagnostic:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            platform: linux-64
+          - os: macos-15
+            platform: osx-arm64
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - name: Checkout ros-rolling-emscripten-zenoh
+        uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+          fetch-depth: 1
+
+      - uses: prefix-dev/setup-pixi@v0.9.4
+        with:
+          frozen: true
+
+      - name: Checkout emscripten-forge/recipes (for cross-python/compiler/pytester toolchain packages)
+        uses: actions/checkout@v6
+        with:
+          repository: emscripten-forge/recipes
+          path: emscripten_forge_recipes
+          persist-credentials: false
+          fetch-depth: 1
+
+      - name: Build emscripten toolchain packages (compiler, cross-python, pytester)
+        shell: bash -l {0}
+        working-directory: emscripten_forge_recipes
+        run: |
+          pixi run rattler-build build \
+            --package-format tar-bz2 \
+            -c https://repo.prefix.dev/emscripten-forge-4x \
+            -c microsoft \
+            -c conda-forge \
+            --skip-existing all \
+            -m variant.yaml \
+            --recipe recipes/recipes/emscripten_emscripten-wasm32
+          pixi run rattler-build build \
+            --package-format tar-bz2 \
+            -c https://repo.prefix.dev/emscripten-forge-4x \
+            -c microsoft \
+            -c conda-forge \
+            --skip-existing all \
+            -m variant.yaml \
+            --recipe recipes/recipes/cross-python_emscripten-wasm32
+          pixi run rattler-build build \
+            --package-format tar-bz2 \
+            -c https://repo.prefix.dev/emscripten-forge-4x \
+            -c microsoft \
+            -c conda-forge \
+            --skip-existing all \
+            -m variant.yaml \
+            --recipe recipes/recipes/pytester
+
+      - name: Build diagnostic xeus-python (zero patches, stock host deps)
+        shell: bash -l {0}
+        run: |
+          pixi run rattler-build build \
+            --package-format tar-bz2 \
+            -r ./scratch_test_recipes/xeus-python-stockdeps/recipe.yaml \
+            -m ./conda_build_config.yaml \
+            --output-dir ./ci_output \
+            -c https://repo.prefix.dev/conda-forge \
+            -c https://repo.prefix.dev/emscripten-forge-4x \
+            -c "file://${{ github.workspace }}/emscripten_forge_recipes/output" \
+            -c microsoft \
+            -c robostack-staging \
+            --target-platform emscripten-wasm32 \
+            --test skip \
+            --channel-priority disabled
+
+      - name: Extract xpython.js/xpython.wasm for upload
+        shell: bash -l {0}
+        run: |
+          mkdir -p extracted_artifact
+          tar xjf ./ci_output/emscripten-wasm32/xeus-python-stockdeps-test-*.tar.bz2 -C extracted_artifact
+          # also record a sha256 of the wasm binary directly in the log, for
+          # a quick eyeball diff between the two matrix legs without needing
+          # to download both artifacts
+          shasum -a 256 extracted_artifact/bin/xpython.wasm extracted_artifact/bin/xpython.js
+
+      - name: Upload xpython.js/xpython.wasm
+        uses: actions/upload-artifact@v4
+        with:
+          name: xeus-python-diagnostic-${{ matrix.platform }}
+          path: |
+            extracted_artifact/bin/xpython.js
+            extracted_artifact/bin/xpython.wasm
+          retention-days: 7

.gitignore

@@ -5,8 +5,35 @@ recipes_only_patch/
 *.sh
 *.ps1
 *.json
+# The blanket *.sh above is meant for vinca-generated build scripts, but it
+# also silently swallowed extra_recipes/*/build.sh -- hand-written source
+# for the microcdr/zenoh-pico recipes, not generated output. Caught by a
+# real CI run doing a genuinely fresh checkout: neither build.sh ever
+# actually made it into a commit, so build-emscripten failed with
+# "build.sh: command not found" once it reached either recipe.
+!extra_recipes/**/*.sh
+# Same deal: a genuine, hand-written, committed helper script, not
+# generated output -- caught this one myself before it repeated the
+# extra_recipes mistake above (2026-09-10).
+!/sync_native_bootstrap_mirror.sh
+# Same deal again: browser_demo/'s own hand-written build*.sh scripts are
+# real, committed source (not generated output) too.
+!browser_demo/*.sh
 .DS_Store
 # pixi environments
 .pixi
 *.egg-info
 output/
+# Throwaway local test/build artifacts -- large binaries, extracted
+# packages, build logs, isolated test builds. Never committed; see
+# AGENTS.md for what each holds and how to regenerate it.
+scratch/
+scratch_test_recipes/
+browser_demo/out/
+# A hand-flattened local scratch extraction of a conda environment used
+# for manual browser_demo testing (see its own README) -- a derived,
+# regeneratable build artifact, not source; never committed.
+demo_env/
+# Local zenohd router binary + plugins, downloaded/extracted for manual
+# testing against a real router -- never committed.
+zenoh_router/