subagent transcript

total 20112
drwx------ 1 magik6k magik6k      758 Jul  5 12:43 .
drwxr-xr-x 1 nobody  nobody       224 Jul  5 17:46 ..
drwx------ 1 magik6k magik6k       20 Jul  4 06:22 boost-wasm
drwx------ 1 magik6k magik6k      844 Jul  4 04:42 emsdk
-rw------- 1 magik6k magik6k     1128 Jul  4 03:04 fix-freetype-sjlj.sh
drwx------ 1 magik6k magik6k       20 Jul  4 06:22 fmt-wasm
drwx------ 1 magik6k magik6k      870 Jul  4 00:57 freecad  …[truncated]

=== qt-jspi tree ===
/opt/toolchains/qt-jspi
/opt/toolchains/qt-jspi/6.11.1
/opt/toolchains/qt-jspi/6.11.1/wasm_singlethread
/opt/toolchains/qt-jspi/6.11.1/wasm_singlethread/lib
/opt/toolchains/qt-jspi/6.11.1/wasm_singlethread/mkspecs
/opt/toolchains/qt-jspi/6.11.1/wasm_singlethread/bin
/opt/toolchains/qt-jspi/6.11.1/wasm_singlethread/libexec
/opt/toolchains/qt-jspi/6.11.1/wasm_singlethread/share
/opt/toolchains/qt-jspi/6.11.1/wasm_singlethread/doc
/opt/toolchains/qt-jspi/6.11.1/wasm_singlethrea  …[truncated]

=== rebuild-qt-jspi.sh ===
#!/usr/bin/env bash
set -e
TC=/opt/toolchains
source $TC/emsdk/emsdk_env.sh 2>/dev/null
QTHOST=$TC/qt/6.11.1/gcc_64
PREFIX=$TC/qt-jspi/6.11.1/wasm_singlethread
rm -rf $TC/qt-jspi $TC/qtsrc
mkdir -p $TC/qtsrc && cd $TC/qtsrc

echo "=== download ==="
for m in qtbase qtsvg qttools; do
  curl -sL "https://download.qt.io/official_releases/qt/6.11/6.11.1/submodules/${m}-everywhere-src-6.11.1.tar.xz" -o $m.tar.xz
  tar xJf $m.tar.xz && rm $m.tar.xz && mv ${m}-everywhere-src-6  …[truncated]

=== rebuild-qt-jspi-wasmeh.sh ===
#!/usr/bin/env bash
# Rebuild Qt with JSPI + wasm-EH (-fexceptions). Uses the already-downloaded,
# gate-patched qtsrc. JS-EH avoids the Binaryen parse bug on OCCT's wasm-EH
# try_table output while JSPI still fixes the CPython-trampoline conflict.
set -e
TC=/opt/toolchains
source $TC/emsdk/emsdk_env.sh 2>/dev/null
QTHOST=$TC/qt/6.11.1/gcc_64
PREFIX=$TC/qt-jspi/6.11.1/wasm_singlethread
rm -rf $TC/qt-jspi $TC/qtsrc/qtbase-build $TC/qtsrc/qtsvg-build $TC/qtsrc/qtt  …[truncated]

=== qconfig / features ===
mkspecs/qmodule.pri
mkspecs/qconfig.pri
mkspecs/modules/qt_lib_core.pri
mkspecs/modules/qt_lib_core_private.pri
mkspecs/common/wasm/wasm.conf
mkspecs/features/wasm/wasm.prf
include/QtCore/qconfig.h
--- qconfig.pri features ---
mkspecs/qmodule.pri:QT.global_private.enabled_features = gc_binaries reduce_exports localtime_r posix_fallocate system-zlib gui network printsupport sql testlib widgets xml dlopen trivial_auto_var_init_pattern libcpp_hardening cross_compile large  …[truncated]

=== qtsrc present? ===
qtbase
qtbase-build
qtsvg
qtsvg-build
qttools
qttools-build

=== JSPI / asyncify refs in wasm platform plugin ===
src/corelib/platform/wasm/qstdweb.cpp:97:EM_JS(bool, jsHaveAsyncify, (), { return typeof Asyncify !== "undefined"; });
src/corelib/platform/wasm/qstdweb.cpp:98:EM_JS(bool, jsHaveJspi, (),
src/corelib/platform/wasm/qstdweb.cpp:99:      { return typeof Asyncify !== "undefined" && !!Asynci  …[truncated]

=== qwasmsuspendresumecontrol.cpp lines 40-160 ===
    control to the browser's event loop (without suspending), and will call the C++
    event handlers directly in that case.
*/

Q_GLOBAL_STATIC(QWasmSuspendResumeControl, s_suspendResumeControl);

// Setup/constructor function for Module.suspendResumeControl.
// FIXME if assigning to the Module object from C++ is/becomes possible
// then this does not need to be a separate JS function.
void qtSuspendResumeControlClearJs() {
    EM_ASM({
        …[truncated]

=== plugins present in qt-jspi (platform plugin, imageformats) ===
libqwasm.a
libqwasm.prl
objects-Release
qtloader.js
qtlogo.svg
wasm_shell.html
--- total libs count jspi vs asyncify ---
jspi: 19 libs
async: 19 libs
--- diff lib lists ---
SAME LIB SET

=== EH style check: disassemble libQt6Core for try_table (wasm-EH) vs invoke/__cxa (JS-EH) ===
(eval):16: no matches found: *.o
obj: archdetect.cpp.o
try_table count: 0
JS-EH sym refs: 44
zshexit:1: parameter HISTDB_FD does not co  …[truncated]

biggest obj: qmetatype.cpp.o
--- target features ---
  7 linking         00041ce1 00000000 
 11 target_features 000000a4 00000000 
--- readobj features ---

File: qmetatype.cpp.o
Format: WASM
Arch: wasm32
AddressSize: 32bit
Version: 0x1
--- scan objects for try_table opcode ---
try_table across top30 objs: 5305
--- scan for invoke_ imports across top30 ---
invoke_ refs across top30 objs: 0
zshexit:1: parameter HISTDB_FD does not contain a file descriptor

=== target_features content of qmetatype.cpp.o ===

qmetatype.cpp.o:	file format wasm
Contents of section target_features:
 0000 0a2b0b62 756c6b2d 6d656d6f 72792b0f  .+.bulk-memory+.
 0010 62756c6b 2d6d656d 6f72792d 6f70742b  bulk-memory-opt+
 0020 1663616c 6c2d696e 64697265 63742d6f  .call-indirect-o
 0030 7665726c 6f6e672b 12657863 65707469  verlong+.excepti
 0040 6f6e2d68 616e646c 696e672b 0a6d756c  on-handling+.mul
 0050 74697661 6c75652b 0f6d7574 61626c65  tivalue+.mutable
 0060 2d676c6f 62  …[truncated]

    set(FREECAD_WASM_EXTRA_LINK_LIBS "" CACHE STRING
        "Extra static archives appended to the FreeCAD wasm links")
    set(FREECAD_WASM_COMMON_LINK_OPTIONS
        "-sALLOW_MEMORY_GROWTH=1"
        # The indirect function table must grow at runtime: numpy's 12 C-extensions
        # plus the added workbenches register far more function pointers (asyncify
        # instruments every function) than fit the static table, so a fixed table
        # throws "WebAssembly.Table.grow() failed". All  …[truncated]

R10-eh-jspi-asyncify-findings.md
R1-codebase-architecture.md
R2-dependency-matrix.md
R3-graphics-coin-webgl.md
R4-python-runtime.md
R5-dialogs-files-jspi.md
R6-payload-memory-threads.md
R7-wasm-threads-decision.md
R8-jspi-migration-plan.md
R9-coin-webgl-strategy.md
=== grep research for JSPI ===
/home/magik6k/lcad-wasm/freecad-port/research/R10-eh-jspi-asyncify-findings.md
/home/magik6k/lcad-wasm/freecad-port/research/R2-dependency-matrix.md
/home/magik6k/lcad-wasm/freecad-port/research/R5-dialo  …[truncated]

############ R8-jspi-migration-plan.md ############
# R8 — JSPI Migration Plan (replace ASYNCIFY)

Status: **planned** (not yet executed). Prereq artifacts already exist:
`toolchain/rebuild-qt-jspi.sh`, and the code carries the ASYNCIFY↔JSPI notes.

## 1. Why (recap of the empirical finding)

The GUI currently links with `-sASYNCIFY` (Qt built `QT_HAVE_EMSCRIPTEN_ASYNCIFY`).
That boots the full GUI, but **Python→C calls made during the Qt event loop
crash in `_PyEM_TrampolineCall` ("unreachable"  …[truncated]

# R10 — Exceptions / JSPI / Asyncify: the definitive matrix

This documents an exhaustive investigation into the single hardest problem of the
port: making CPython's call trampoline, Qt's synchronous `exec()` event loop, and
OCCT's exception-heavy geometry kernel coexist in one wasm module. Every viable
combination of *exception model* × *stack-switching model* was built and tested.

## The three sub-problems (each forces a choice)

1. **CPython call trampoline.** CPython ≥3.13 calls `PyCFunctio  …[truncated]

=== JSPI settings in settings.js ===
817:// - 2 (deprecated): Use ``-sJSPI`` instead.
931:// Deprecated, use JSPI_EXPORTS instead.
943:var JSPI = 0;
947:// that will call an asynchronous import (listed in ``JSPI_IMPORTS``) must be
952:var JSPI_EXPORTS = [];
962:var JSPI_IMPORTS = [];

=== emscripten version ===
"4.0.12"
zshexit:1: parameter HISTDB_FD does not contain a file descriptor

// Deprecated, use JSPI_EXPORTS instead.
// [deprecated]
var ASYNCIFY_EXPORTS = [];

// Use VM support for the JavaScript Promise Integration proposal. This allows
// async operations to happen without the overhead of modifying the wasm. This
// is experimental atm while spec discussion is ongoing, see
// https://github.com/WebAssembly/js-promise-integration/ TODO: document which
// of the following flags are still relevant in this mode (e.g. IGNORE_INDIRECT
// etc. are not needed)
//
// [link]
  …[truncated]

=== qt-asyncify features ===
QT.global.disabled_features = shared pkg-config debug_and_release separate_debug_info appstore-compliant simulator_and_device rpath force_asserts framework c++20 c++2a c++2b c++2c reduce_relocations wasm-simd128 wasm-exceptions wasm-jspi zstd thread dbus openssl-linked opensslv11 opensslv30
--- qt-asyncify EH style (invoke_ vs try_table) on libQt6Core ---
invoke_ syms: 1408

=== Does emscripten auto-mark EM_ASYNC_JS as JSPI import? check library_async or jspi handlin  …[truncated]

em++: warning: -sASYNCIFY=2 (JSPI) is still experimental [-Wexperimental]
=== EXIT compile: 0 ===
-rw-r--r-- 1 magik6k magik6k 42375 Jul  6 01:08 t.js
-rwxr-xr-x 1 magik6k magik6k 24431 Jul  6 01:08 t.wasm
zshexit:1: parameter HISTDB_FD does not contain a file descriptor

/tmp/jspi-jseh-test/t.js:968
              imports[x] = original = new WebAssembly.Suspending(original);
                                      ^

TypeError: WebAssembly.Suspending is not a constructor
    at Object.instrumentWasmImports (/tmp/jspi-jseh-test/t.js:968:39)
    at getWasmImports (/tmp/jspi-jseh-test/t.js:454:12)
    at createWasm (/tmp/jspi-jseh-test/t.js:499:14)
    at /tmp/jspi-jseh-test/t.js:1253:25
    at file:///tmp/jspi-jseh-test/run.mjs:2:17
    at ModuleJob.run (node:interna  …[truncated]

=== try --experimental-wasm-jspi ===
node: bad option: --experimental-wasm-jspi
=== exit: 0 ===
zshexit:1: parameter HISTDB_FD does not contain a file descriptor

  --trace-wasm-stack-switching (trace wasm stack switching)
        type: bool  default: --no-trace-wasm-stack-switching
  --stress-wasm-stack-switching (Always run wasm on a secondary stack, even when it is called with a regular (non-JSPI) export)
        type: bool  default: --no-stress-wasm-stack-switching
  --wasm-stack-switching-stack-size (default size of stacks for wasm stack-switching (in kB))
        type: int  default: --wasm-stack-switching-stack-size=984
  --experimental-wasm-wasmfx   …[truncated]

=== default ===
Suspending: function promising: function
=== with stack-switching flag ===
node: bad option: --experimental-wasm-stack-switching
=== list jspi-ish flags ===
  --stress-wasm-stack-switching (Always run wasm on a secondary stack, even when it is called with a regular (non-JSPI) export)
  --experimental-wasm-growable-stacks (enable growable stacks for jspi for Wasm (experimental))
zshexit:1: parameter HISTDB_FD does not contain a file descriptor

=== run with NO flags (JSPI default-on) ===
THREW: SuspendError: trying to suspend without WebAssembly.promising
=== exit: 0 ===
zshexit:1: parameter HISTDB_FD does not contain a file descriptor

=== CONTROL (no try/catch): ===
    at ModuleJob.run (node:internal/modules/esm/module_job:274:25)
    at async onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:644:26)
    at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:117:5)

Node.js v22.16.0

=== Now confirm the failing one had _run promising-wrapped. grep t.js for promising ===
968:              imports[x] = original = new WebAssembly.Suspending(original);
985:            // Wrap all exports with a   …[truncated]

=== CONTROL full output ===
suspending (no try/catch)...
THREW: SuspendError: trying to suspend without WebAssembly.promising

=== how t.js wraps exports (985-1015) ===
            // Wrap all exports with a promising WebAssembly function.
            let isAsyncifyExport = exportPattern.test(x);
            if (isAsyncifyExport) {
              Asyncify.asyncExports.add(original);
              original = Asyncify.makeAsyncFunction(original);
            }
            var wrapper = Asyncify.ins  …[truncated]

935:        var exportPattern = /^(_run|main|__main_argc_argv)$/;
941:            let isAsyncifyExport = exportPattern.test(x);
              imports[x] = original = new WebAssembly.Suspending(original);
TypeError: WebAssembly.Suspending is not a constructor
zshexit:1: parameter HISTDB_FD does not contain a file descriptor

=== qt-jspi platform plugin object EH + jspi ===
jspi-suspend syms in plugin: 5
=== newest of the 3 qt-jspi scripts (which built installed one) ===
-rw------- 1 magik6k magik6k 2652 04:58 /opt/toolchains/rebuild-qt-jspi-jseh.sh
-rwx------ 1 magik6k magik6k 2316 02:41 /opt/toolchains/rebuild-qt-jspi.sh
-rw------- 1 magik6k magik6k 2683 05:43 /opt/toolchains/rebuild-qt-jspi-wasmeh.sh
installed qt-jspi libQt6Core.a mtime:
-rw------- 1 magik6k magik6k 10514546 05:44 /opt/toolchains/q  …[truncated]

Structured output provided successfully