参考所有分组，完成尽量多的内容。禁止顺手扩功能 smoke：锁定构建源码映射结论

docs/linuxcnc-build-source-map.md

@@ -0,0 +1,62 @@
+# 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 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`.
+- `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:
+
+```bash
+./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.