参考所有分组,完成尽量多的内容。禁止顺手扩功能 smoke:锁定六分组源码映射总索引结论

This commit is contained in:
cnc
2026-06-04 16:54:49 +08:00
parent 1bfb7426d4
commit 1f314b7e9e
5 changed files with 168 additions and 0 deletions

View File

@@ -0,0 +1,56 @@
# 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` | `check-linuxcnc-opfs-source-map.sh`, `check-linuxcnc-wasm-shims-source-map.sh`, `check-linuxcnc-wasm-blockers-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` | `check-linuxcnc-rs274-source-map.sh`, `check-linuxcnc-build-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.