参考所有分组,完成尽量多的内容。禁止顺手扩功能 smoke:锁定六分组源码映射总索引结论
This commit is contained in:
56
docs/linuxcnc-workstreams-source-map.md
Normal file
56
docs/linuxcnc-workstreams-source-map.md
Normal 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.
|
||||
Reference in New Issue
Block a user