结论:build-wasm.sh 现在与 native/source-link 一样先运行六分组 source-map guards,再消费生成配置别名和浏览器 artifacts;同步 build/workstreams source map 与 aggregate 元检查。未新增 CNC 行为,未扩展 smoke fallback。\n\n测试:./check-linuxcnc-workstreams-source-map.sh;./check-linuxcnc-build-source-map.sh;git diff --check;CNC_SIM_ALL_NATIVE_GUARDRAILS_ONLY=1 ./test-all-native.sh;./test-native.sh;./test-linuxcnc-source-link.sh。
3.0 KiB
3.0 KiB
LinuxCNC workstreams source map
This map ties the six active workstream contexts to their source-map guards. It is a coordination guard only; it must not add CNC behavior and must not expand the temporary smoke parser.
Workstream Coverage
| Workstream | Source-map documents | Guard scripts |
|---|---|---|
switchkins/remap generator and tables |
docs/linuxcnc-switchkins-remap-source-map.md |
check-linuxcnc-switchkins-remap-source-map.sh |
linuxcnc-kinematics source manifest |
docs/linuxcnc-kinematics-source-map.md |
check-linuxcnc-kinematics-source-map.sh |
| WASM filesystem and OPFS persistence | docs/linuxcnc-opfs-source-map.md, docs/linuxcnc-wasm-shims-source-map.md, docs/linuxcnc-wasm-blockers-source-map.md, docs/linuxcnc-tooldata-source-map.md |
check-linuxcnc-opfs-source-map.sh, check-linuxcnc-wasm-shims-source-map.sh, check-linuxcnc-wasm-blockers-source-map.sh, check-linuxcnc-tooldata-source-map.sh |
| browser app integration | docs/linuxcnc-browser-app-source-map.md |
check-linuxcnc-browser-app-source-map.sh |
| Node and browser smoke coverage | docs/linuxcnc-wasm-smoke-source-map.md |
check-linuxcnc-wasm-smoke-source-map.sh |
| source-link, build, and documentation constraints | docs/linuxcnc-rs274-source-map.md, docs/linuxcnc-build-source-map.md, docs/linuxcnc-tooldata-source-map.md |
check-linuxcnc-rs274-source-map.sh, check-linuxcnc-build-source-map.sh, check-linuxcnc-tooldata-source-map.sh |
LinuxCNC Source Basis
configs/sim/**.iniandremap_subs/{428,429,430}remap.ngcback the switchkins/remap workstream.src/emc/kinematics/Submakefileandsrc/emc/kinematics/kinematics.hback the kinematics manifest workstream.src/emc/rs274ngc/interp_internal.hhandsrc/emc/rs274ngc/rs274ngc_pre.ccback the OPFS/browser parameter-file workstreams.src/emc/rs274ngc/Submakefile,src/emc/tooldata/Submakefile,src/emc/ini/Submakefile, andsrc/emc/pythonplugin/Submakefileback the source-link and build-policy workstream.
Boundaries
- Every active workstream must have at least one source-map document and guard script.
docs/linuxcnc-source-policy.mdmust keep the same one-context workflow boundary and smoke-verification-only rule used by this index.test-native.sh,test-linuxcnc-source-link.sh, andbuild-wasm.shmust run the workstream source-map guard before consuming generated config aliases, source-linked LinuxCNC objects, or browser artifacts.- WASM blocker and shim maps remain source coverage guards, not browser API expansion points.
- Browser filesystem persistence remains OPFS-only.
- Smoke coverage remains verification only and must not become a functional CNC behavior path.
Checks
Run:
./check-linuxcnc-workstreams-source-map.sh
./test-native.sh
./test-linuxcnc-source-link.sh
./build-wasm.sh
check-linuxcnc-workstreams-source-map.sh keeps the six-workstream architecture
list, source-map documents, guard scripts, LinuxCNC source anchors, and native /
source-link / build-wasm guard entry points synchronized.