340966b6f7
结论：补齐 LinuxCNC tooldata 源映射 guard，并接入 native/source-link/workstreams 检查；仅验证源覆盖、WASM-safe shim/probe 边界和 TOOL_TABLE source-only 策略，未扩展 smoke 行为。\n\n测试：./check-linuxcnc-tooldata-source-map.sh；./check-linuxcnc-workstreams-source-map.sh；git diff --check；./test-native.sh；./test-linuxcnc-source-link.sh。
57 lines
2.8 KiB
Markdown
57 lines
2.8 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.
|
|
- `test-native.sh` and `test-linuxcnc-source-link.sh` must run the workstream
|
|
source-map guard before consuming generated config aliases or source-linked
|
|
LinuxCNC objects.
|
|
- 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
|
|
```
|
|
|
|
`check-linuxcnc-workstreams-source-map.sh` keeps the six-workstream architecture
|
|
list, source-map documents, guard scripts, LinuxCNC source anchors, and native /
|
|
source-link guard entry points synchronized.
|