22c1c311ff
结论：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。
60 lines
3.0 KiB
Markdown
60 lines
3.0 KiB
Markdown
# 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/**.ini` and `remap_subs/{428,429,430}remap.ngc` back the
|
|
switchkins/remap workstream.
|
|
- `src/emc/kinematics/Submakefile` and `src/emc/kinematics/kinematics.h` back
|
|
the kinematics manifest workstream.
|
|
- `src/emc/rs274ngc/interp_internal.hh` and
|
|
`src/emc/rs274ngc/rs274ngc_pre.cc` back the OPFS/browser parameter-file
|
|
workstreams.
|
|
- `src/emc/rs274ngc/Submakefile`, `src/emc/tooldata/Submakefile`,
|
|
`src/emc/ini/Submakefile`, and `src/emc/pythonplugin/Submakefile` back 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.md` must keep the same one-context workflow
|
|
boundary and smoke-verification-only rule used by this index.
|
|
- `test-native.sh`, `test-linuxcnc-source-link.sh`, and `build-wasm.sh` must
|
|
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:
|
|
|
|
```bash
|
|
./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.
|