wasm-simulator/check-linuxcnc-workstreams-source-map.sh

#!/usr/bin/env bash
set -euo pipefail

cd "$(dirname "$0")"

# LinuxCNC source basis: this guard ties the six active workstream contexts to
# their source-map guards and to LinuxCNC source/config anchors. It validates
# coordination policy only; it does not add CNC behavior or expand smoke
# parsing.
linuxcnc_root=${LINUXCNC_ROOT:-../linuxcnc}
linuxcnc_root=$(cd "$linuxcnc_root" && pwd)

grep -F '1. `switchkins/remap` generator and tables' docs/architecture.md >/dev/null
grep -F '2. `linuxcnc-kinematics` source manifest' docs/architecture.md >/dev/null
grep -F '3. WASM filesystem and OPFS persistence' docs/architecture.md >/dev/null
grep -F '4. browser app integration' docs/architecture.md >/dev/null
grep -F '5. Node and browser smoke coverage' docs/architecture.md >/dev/null
grep -F '6. source-link, build, and documentation constraints' docs/architecture.md >/dev/null

grep -F 'REMAP = M428' "$linuxcnc_root/configs/sim/axis/vismach/5axis/bridgemill/5axis.ini" >/dev/null
grep -F '#<kinstype>' "$linuxcnc_root/configs/sim/axis/vismach/5axis/bridgemill/remap_subs/428remap.ngc" >/dev/null
grep -F 'GENSERKINSSRCS := emc/kinematics/ugenserkins.c' \
    "$linuxcnc_root/src/emc/kinematics/Submakefile" >/dev/null
grep -F 'extern int kinematicsInverse(const struct EmcPose * world,' \
    "$linuxcnc_root/src/emc/kinematics/kinematics.h" >/dev/null
grep -F '#define RS274NGC_PARAMETER_FILE_NAME_DEFAULT "rs274ngc.var"' \
    "$linuxcnc_root/src/emc/rs274ngc/interp_internal.hh" >/dev/null
grep -F 'int Interp::save_parameters(const char *filename,' \
    "$linuxcnc_root/src/emc/rs274ngc/rs274ngc_pre.cc" >/dev/null
grep -F 'LIBRS274SRCS := $(addprefix emc/rs274ngc/,' \
    "$linuxcnc_root/src/emc/rs274ngc/Submakefile" >/dev/null
grep -F 'LIBTOOLDATA_SRCS += emc/tooldata/tooldata_common.cc' \
    "$linuxcnc_root/src/emc/tooldata/Submakefile" >/dev/null
grep -F 'LIBLCNCINISRCS := emc/ini/inifile.cc' \
    "$linuxcnc_root/src/emc/ini/Submakefile" >/dev/null
grep -F 'LIBPPSRCS := $(addprefix emc/pythonplugin/,' \
    "$linuxcnc_root/src/emc/pythonplugin/Submakefile" >/dev/null

grep -F 'LinuxCNC workstreams source map' docs/linuxcnc-workstreams-source-map.md >/dev/null
grep -F 'must not add CNC' docs/linuxcnc-workstreams-source-map.md >/dev/null
grep -F 'temporary smoke parser' docs/linuxcnc-workstreams-source-map.md >/dev/null
grep -F 'Every active workstream must have at least one source-map document and guard' \
    docs/linuxcnc-workstreams-source-map.md >/dev/null
grep -F 'Browser filesystem persistence remains OPFS-only.' docs/linuxcnc-workstreams-source-map.md >/dev/null
grep -F 'Smoke coverage remains verification only' docs/linuxcnc-workstreams-source-map.md >/dev/null

python3 - <<'PY'
from pathlib import Path

doc = Path("docs/linuxcnc-workstreams-source-map.md").read_text(encoding="utf-8")
expected = {
    "switchkins/remap": [
        "docs/linuxcnc-switchkins-remap-source-map.md",
        "check-linuxcnc-switchkins-remap-source-map.sh",
    ],
    "linuxcnc-kinematics": [
        "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",
    ],
}
for workstream, paths in expected.items():
    if workstream not in doc:
        raise SystemExit(f"missing workstream row in docs/linuxcnc-workstreams-source-map.md: {workstream}")
    for path in paths:
        if path not in doc:
            raise SystemExit(f"missing source-map path in workstream index: {path}")
        if not Path(path).exists():
            raise SystemExit(f"source-map path listed in workstream index does not exist: {path}")
        if path.startswith("check-") and not Path(path).stat().st_mode & 0o111:
            raise SystemExit(f"source-map guard is not executable: {path}")

for test_entry in ["test-native.sh", "test-linuxcnc-source-link.sh"]:
    text = Path(test_entry).read_text(encoding="utf-8")
    for guard in sorted({path for paths in expected.values() for path in paths if path.startswith("check-")}):
        if guard in {"check-linuxcnc-wasm-shims-source-map.sh", "check-linuxcnc-wasm-blockers-source-map.sh"}:
            continue
        if f"./{guard}" not in text:
            raise SystemExit(f"{test_entry} does not run workstream source-map guard: {guard}")
PY