wasm-simulator/docs/linuxcnc-build-source-map.md

LinuxCNC build source map

This map records the source basis and boundaries for native, source-link, and WASM build entry points. It is a build-policy guard only; it must not add CNC behavior and must not expand the temporary smoke parser.

LinuxCNC Source Basis

• src/emc/rs274ngc/Submakefile defines LIBRS274SRCS, including rs274ngc_pre.cc, and links RS274 against LinuxCNC INI, HAL, Python plugin, and tooldata libraries.
• src/emc/tooldata/Submakefile defines the LinuxCNC tooldata common, mmap, NML, database, reader, and watcher sources tracked by native and WASM manifests.
• src/emc/ini/Submakefile defines liblinuxcncini and exported INI headers used by source-linked and WASM-safe probes.
• src/emc/pythonplugin/Submakefile defines libpyplugin, which remains a source-tracked Python/remap dependency for source-link and WASM blocker coverage.
• src/emc/kinematics/Submakefile and src/emc/kinematics/kinematics.h define the kinematics source/header surface consumed by switchkins and RTCP build coverage.

Build Coverage

Entry	Boundary
test-native.sh	Runs source-map guards, cached manifest checks, native bridge/API/RS274 probes, and Node/browser smoke after LinuxCNC source-backed native coverage.
test-linuxcnc-source-link.sh	Compiles manifest-selected LinuxCNC RS274 objects directly with source-link support objects and project dump bridges.
test-linuxcnc-source-syntax.sh	Keeps native source syntax validation on persistent dependency-tracked stamps.
test-linuxcnc-wasm-cmake-safe-probe.sh	Configures source-backed WASM-safe probe targets with persistent CMake signatures.
build-wasm.sh	Runs source-map guards, blocker, syntax, object, CMake, tooldata, interp, Python, rs274ngc_pre, and runtime probes before copying browser artifacts.

Boundaries

• Default WASM manifest partition must remain 26 wasm-safe core sources and 9 blocked sources.
• Build paths must keep CNC_SIM_BUILD_JOBS as scheduling only. Persistent object/configure signatures must not include it.
• Hot object probes must use explicit BUILD_RULE_VERSION or CONFIGURE_RULE_VERSION fields instead of hashing whole scripts.
• build-wasm.sh must configure with CNC_SIM_ENABLE_SMOKE_BACKEND=OFF and CNC_SIM_ENABLE_LINUXCNC_WASM_SAFE_PROBE=ON.
• test-native.sh, test-linuxcnc-source-link.sh, and build-wasm.sh must run the same source-map guards before consuming generated config aliases, source-linked LinuxCNC objects, or browser artifacts.
• build-wasm.sh must build cnc_sim_wasm_runtime_probe before cnc_sim_wasm, copy cnc_sim.js and cnc_sim.wasm exactly once, compare copied artifacts with cmp -s, and run Node smoke before browser smoke.
• Build directory overrides must be non-empty, whitespace-free, and outside the filesystem root.

Checks

Run:

./check-linuxcnc-build-source-map.sh
./test-native.sh
./test-linuxcnc-source-link.sh

check-linuxcnc-build-source-map.sh keeps this document, LinuxCNC build-source anchors, manifest partition assumptions, build script ordering, and source-backed build-policy boundaries synchronized.