完善 gmoccapy XYZAB 参考功能

2026-06-26 17:53:45 -04:00
parent 4e4f1462f5
commit a81b40447d
154 changed files with 17194 additions and 51 deletions
--- a/web-rtcp-5axis-sim-plan/gptlog-process/gpdlog.md
+++ b/web-rtcp-5axis-sim-plan/gptlog-process/gpdlog.md
@@ -3792,3 +3792,923 @@ Final log-sync step:
  - `记录云仓库同步日志`
 - The final action is to push that log commit to:
  - `origin/master`
+
+---
+
+## GPT/Codex execution log - 2026-06-26 10:10:14 EDT
+
+User request:
+- 使用 `/home/meswork/cnc_wams/work/working3` 的资料，编写完善
+  `/home/meswork/cnc_wams/web-rtcp-5axis-sim-plan` 功能的文档。
+- 文档要求覆盖：
+  - 01 功能内容。
+  - 02 程序开发详细步骤。
+  - 03 推进台账：每轮做了什么、改了哪些文件、验证了什么、下一步是什么。
+  - 04 任务矩阵：所有任务编号、状态、验收标准，防止重复做。
+  - 05 验收证据：命令、页面、job_id、report_id、PDF、截图等证据。
+  - 06 决策记录：为什么这么做，后续变更时不反复争论同一个问题。
+- 文档创建在 `/home/meswork/cnc_wams/work/working4`。
+
+Workspace and rules:
+- Working directory: `/home/meswork/cnc_wams`.
+- AGENTS.md logging rule requires appending the full execution process log to:
+  `/home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/gptlog-process/gpdlog.md`.
+- Filesystem access: unrestricted.
+- Approval policy: never.
+
+Discovery commands executed:
+- `find /home/meswork/cnc_wams/work/working3 -maxdepth 3 -type f | sort`
+  - Confirmed `working3` contains:
+    - `gmoccapy_XYZAB_execution_analysis.md`
+    - `gmoccapy_button_icons/README.md`
+    - `gmoccapy_button_icons/button_icon_inventory.csv`
+    - `gmoccapy_button_icons/button_icon_inventory.md`
+    - `gmoccapy_button_icons/files/` with copied PNG/SVG icon assets.
+- `find /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan -maxdepth 3 -type f | sort | sed 's#^#/##'`
+  - Confirmed target project contains README, docs, app sources, build readiness artifact, tests, working notes, run evidence, and `gptlog-process/gpdlog.md`.
+- `find /home/meswork/cnc_wams/work -maxdepth 2 -type d | sort`
+  - Confirmed `work/working4` directory exists.
+- `find /home/meswork/cnc_wams/work/working4 -maxdepth 2 -type f -print | sort`
+  - Confirmed `working4` was empty before writing documents.
+
+Source documents read:
+- `sed -n '1,240p' /home/meswork/cnc_wams/work/working3/gmoccapy_XYZAB_execution_analysis.md`
+- `sed -n '240,520p' /home/meswork/cnc_wams/work/working3/gmoccapy_XYZAB_execution_analysis.md`
+- `sed -n '520,900p' /home/meswork/cnc_wams/work/working3/gmoccapy_XYZAB_execution_analysis.md`
+  - Extracted LinuxCNC/gmoccapy_XYZAB startup order, NML command/status/error communication, HAL/postgui behavior, HALUI role, G-code run conditions, task/mode/interpreter/home interlocks, and button/control logic.
+- `sed -n '1,220p' /home/meswork/cnc_wams/work/working3/gmoccapy_button_icons/README.md`
+  - Confirmed icon inventory structure and naming conventions.
+- `sed -n '1,220p' /home/meswork/cnc_wams/work/working3/gmoccapy_button_icons/button_icon_inventory.md`
+  - Reviewed icon inventory summary and representative rows.
+- `head -n 30 /home/meswork/cnc_wams/work/working3/gmoccapy_button_icons/button_icon_inventory.csv`
+  - Reviewed CSV field names and button/icon mapping examples.
+- `wc -l /home/meswork/cnc_wams/work/working3/gmoccapy_XYZAB_execution_analysis.md /home/meswork/cnc_wams/work/working3/gmoccapy_button_icons/button_icon_inventory.csv /home/meswork/cnc_wams/work/working3/gmoccapy_button_icons/button_icon_inventory.md`
+  - Confirmed line counts:
+    - `gmoccapy_XYZAB_execution_analysis.md`: 1287 lines.
+    - `button_icon_inventory.csv`: 212 lines.
+    - `button_icon_inventory.md`: 247 lines.
+
+Target project context read:
+- `sed -n '1,240p' /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/README.md`
+  - Confirmed project goal: Web RTCP five-axis simulation, not a real machine controller or native LinuxCNC replacement.
+- `sed -n '1,260p' /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/docs/technical-roadmap.md`
+  - Confirmed technology route: native HTML/CSS/ES modules, Three.js, LinuxCNC source-derived WASM boundaries, gmoccapy-style shell.
+- `sed -n '1,260p' /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/docs/traceability-matrix.md`
+  - Confirmed existing traceability records for gmoccapy UI, run controls, LinuxCNC kinematics/interpreter/task-HAL runtime, profiles, OPFS/session, full execution boundary, and native task/HAL readiness.
+- `sed -n '1,260p' /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app/src/main.js`
+- `sed -n '260,620p' /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app/src/main.js`
+  - Confirmed app attaches profile INI config, kinematics runtime, interpreter runtime, task/HAL runtime, machine-file staging, and default LinuxCNC program preview.
+- `find /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app/src -maxdepth 3 -type f | sort`
+  - Confirmed current module layout: profiles, runtime, state, UI, styles, visualization, vendor Three.js.
+- `sed -n '1,260p' /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/working_run/12-working-run-final-completion-record.md`
+  - Confirmed RUN chain, preconditions, status loop, unit conversion, browser evidence, and working_run remaining tasks were previously closed.
+- `sed -n '1,260p' /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/docs/native-task-hal-sync-implementation-steps.md`
+  - Reviewed existing native task/HAL synchronization plan and promotion boundaries.
+- `sed -n '1,220p' /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app/package.json`
+  - Confirmed build, dev, browser smoke, and node smoke scripts.
+- `sed -n '1,260p' /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app/src/profiles/index.js`
+- `sed -n '1,260p' /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app/src/profiles/xyzac-trt.js`
+- `sed -n '1,260p' /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app/src/profiles/xyzbc-trt.js`
+  - Confirmed current profile set is `xyzac-trt` and `xyzbc-trt`; no gmoccapy_XYZAB profile exists yet.
+- `rg -n "icon|button|gmoccapy|status-sidebar|bottom|run|pause|stop|home|tool|touch|coolant|spindle" /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app/src/ui/gmoccapy-shell.js`
+- `sed -n '1,260p' /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app/src/ui/gmoccapy-shell.js`
+  - Confirmed UI has text-based controls and existing regions for titlebar, preview, DRO, G-code, status sidebar, info tabs, override, spindle/coolant, bottom controls.
+- `sed -n '1,280p' /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/app/src/state/store.js`
+  - Confirmed store state includes machine state, run state, kinematics/interpreter/task-HAL runtime status, machine-file staging, DRO, feed, spindle, coolant, preview, tool preview.
+- `sed -n '1,240p' /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/tests/node/verify_run_preconditions.mjs`
+  - Confirmed existing run-precondition tests cover profile/INI/kinematics/machine-file readiness and task policy gates.
+
+Existing evidence paths checked:
+- `find /home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output -maxdepth 2 -type f | sort`
+  - Confirmed existing QA JSON/PDF/DOCX/screenshots including button control evidence, cloud run evidence, native task/HAL comparison, toolpath preview cases, run preconditions feedback, and LinuxCNC source run reports.
+- `find /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/build -maxdepth 3 -type f | sort`
+  - Confirmed `build/readiness/native-task-hal-readiness.json`.
+- `find /home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/working_run/run-feedback-evidence -maxdepth 1 -type f | sort`
+  - Confirmed `run-feedback-local.json` and `run-feedback-local.png`.
+
+Files created with `apply_patch`:
+- `/home/meswork/cnc_wams/work/working4/README.md`
+  - Index for the generated working4 document set.
+- `/home/meswork/cnc_wams/work/working4/01-function-content.md`
+  - Functional scope, current project state, working3 value, proposed feature packages, non-goals, success definition.
+- `/home/meswork/cnc_wams/work/working4/02-program-development-steps.md`
+  - Development plan by stages: asset ingestion, gmoccapy_XYZAB profile, communication diagnostics, icon mapping, gates, HAL/postgui diagnostics, browser evidence.
+- `/home/meswork/cnc_wams/work/working4/03-progress-ledger.md`
+  - Progress ledger with initial W4-DOC-001 entry and future entry template.
+- `/home/meswork/cnc_wams/work/working4/04-task-matrix.md`
+  - Task matrix with IDs, statuses, files, and acceptance standards.
+- `/home/meswork/cnc_wams/work/working4/05-acceptance-evidence.md`
+  - Evidence ledger for current document output, reusable existing evidence, future required evidence, job/report table, and gaps.
+- `/home/meswork/cnc_wams/work/working4/06-decision-records.md`
+  - Decision records ADR-001 through ADR-008 covering source input policy, no GTK port, XYZAB/trivkins boundary, NML/HAL diagnostics, icons vs semantics, three-layer gate model, postgui ordering, and evidence-first promotion.
+
+Validation commands executed:
+- `find /home/meswork/cnc_wams/work/working4 -maxdepth 1 -type f -printf '%f\n' | sort`
+  - Confirmed files:
+    - `01-function-content.md`
+    - `02-program-development-steps.md`
+    - `03-progress-ledger.md`
+    - `04-task-matrix.md`
+    - `05-acceptance-evidence.md`
+    - `06-decision-records.md`
+    - `README.md`
+- `rg -n "功能内容|程序开发详细步骤|推进台账|任务矩阵|验收证据|决策记录|gmoccapy-xyzab|working3|working4" /home/meswork/cnc_wams/work/working4`
+  - Confirmed required sections and key terms appear across the document set.
+- `git diff --check -- /home/meswork/cnc_wams/work/working4`
+  - Result: success, no whitespace errors reported.
+- `wc -l /home/meswork/cnc_wams/work/working4/*.md`
+  - Confirmed total document size: 970 lines.
+  - Per file:
+    - `01-function-content.md`: 98 lines.
+    - `02-program-development-steps.md`: 316 lines.
+    - `03-progress-ledger.md`: 101 lines.
+    - `04-task-matrix.md`: 85 lines.
+    - `05-acceptance-evidence.md`: 155 lines.
+    - `06-decision-records.md`: 160 lines.
+    - `README.md`: 55 lines.
+- `date '+%Y-%m-%d %H:%M:%S %Z'`
+  - Result: `2026-06-26 10:10:14 EDT`.
+- `git status --short -- work/working4 web-rtcp-5axis-sim-plan/gptlog-process/gpdlog.md`
+  - Before appending this log, showed `?? work/working4/`.
+- `git diff --stat -- work/working4`
+  - No stat output because the files were untracked at that moment.
+
+Result:
+- Completed the requested working4 documentation set.
+- Did not modify application source code in `web-rtcp-5axis-sim-plan/app/src`.
+- Did not run app build or smoke tests because this turn only generated planning/traceability documents and did not alter runtime code.
+- Appended this execution process log to `web-rtcp-5axis-sim-plan/gptlog-process/gpdlog.md` per workspace rule.
+
+Next recommended implementation step:
+- Start with `W4-A01` and `W4-A02` from `work/working4/04-task-matrix.md`:
+  - Create `web-rtcp-5axis-sim-plan/docs/gmoccapy-xyzab-reference.md`.
+  - Convert the gmoccapy button CSV inventory into a Web-consumable JSON manifest.
+
+---
+
+## GPT/Codex execution log - W4-IMPL-001 gmoccapy XYZAB reference/profile/models
+
+Timestamp: 2026-06-26 10:43:51 EDT
+Workspace: `/home/meswork/cnc_wams`
+User request: `按“/home/meswork/cnc_wams/work/working4“开始工作`
+
+Process summary:
+- Read workspace instruction from user-provided AGENTS content: append full process log after execution to `web-rtcp-5axis-sim-plan/gptlog-process/gpdlog.md`.
+- Started from `/home/meswork/cnc_wams/work/working4` as requested.
+- Read `work/working4/README.md`, `01-function-content.md`, `02-program-development-steps.md`, `03-progress-ledger.md`, `04-task-matrix.md`, `05-acceptance-evidence.md`, and `06-decision-records.md`.
+- Identified first todo group as W4-A01 through W4-A04, then proceeded through reference profile/model/test work that could be verified independently.
+- Checked dirty worktree with `git status --short`; existing `web-rtcp-5axis-sim-plan/gptlog-process/gpdlog.md` was already modified and `work/working4/` was untracked.
+
+Repository context inspected:
+- `rg --files web-rtcp-5axis-sim-plan/app/src`
+- `rg --files web-rtcp-5axis-sim-plan/tests`
+- `sed -n '1,260p' web-rtcp-5axis-sim-plan/app/src/profiles/index.js`
+- `sed -n '1,300p' web-rtcp-5axis-sim-plan/app/src/profiles/xyzac-trt.js`
+- `sed -n '1,300p' web-rtcp-5axis-sim-plan/app/src/profiles/xyzbc-trt.js`
+- `sed -n '1,360p' web-rtcp-5axis-sim-plan/app/src/profiles/source-reference-map.js`
+- `sed -n '1,260p' web-rtcp-5axis-sim-plan/tests/node/verify_profile_boundary.mjs`
+- `sed -n '1,300p' web-rtcp-5axis-sim-plan/tests/node/verify_run_preconditions.mjs`
+- `sed -n '1,340p' web-rtcp-5axis-sim-plan/app/src/state/linuxcnc-task-policy.js`
+- `sed -n '1,380p' web-rtcp-5axis-sim-plan/app/src/state/store.js`
+- `sed -n '280,620p' web-rtcp-5axis-sim-plan/app/src/ui/gmoccapy-shell.js`
+- `sed -n '2200,2365p' web-rtcp-5axis-sim-plan/app/src/state/store.js`
+- `sed -n '1,260p' web-rtcp-5axis-sim-plan/app/src/runtime/linuxcnc-boundary-adapter.js`
+- `cat web-rtcp-5axis-sim-plan/app/package.json`
+- `sed -n '1,260p' web-rtcp-5axis-sim-plan/app/scripts/build-static.mjs`
+- `sed -n '1,240p' web-rtcp-5axis-sim-plan/app/src/runtime/rtcp-frame.js`
+
+working3/LinuxCNC inputs inspected:
+- `sed -n '1,260p' /home/meswork/cnc_wams/work/working3/gmoccapy_XYZAB_execution_analysis.md`
+- `sed -n '260,620p' /home/meswork/cnc_wams/work/working3/gmoccapy_XYZAB_execution_analysis.md`
+- `sed -n '620,980p' /home/meswork/cnc_wams/work/working3/gmoccapy_XYZAB_execution_analysis.md`
+- `sed -n '1,80p' /home/meswork/cnc_wams/work/working3/gmoccapy_button_icons/button_icon_inventory.csv`
+- `wc -l /home/meswork/cnc_wams/work/working3/gmoccapy_button_icons/button_icon_inventory.csv` returned 212 lines including header.
+- `find /home/meswork/cnc_wams/work/working3 -maxdepth 4 -type f | sort` confirmed CSV, Markdown inventory, and copied icon files.
+- `sed -n '1,260p' linuxcnc/configs/sim/gmoccapy/gmoccapy_XYZAB.ini`
+- `sed -n '1,260p' linuxcnc/configs/sim/gmoccapy/core_sim_XYZAB.hal`
+- `sed -n '1,220p' linuxcnc/configs/sim/gmoccapy/gmoccapy_postgui.hal`
+- `sed -n '1,180p' linuxcnc/configs/sim/gmoccapy/spindle_sim.hal`
+- `sed -n '1,160p' linuxcnc/configs/sim/gmoccapy/simulated_home.hal`
+- `sed -n '1,220p' linuxcnc/configs/sim/gmoccapy/tool.tbl`
+- Verified `linuxcnc/src/emc/kinematics/trivkins.c` exists.
+- Verified `wasm-port/vendor/linuxcnc/configs/sim/gmoccapy` does not exist, so `gmoccapy-xyzab` must remain reference-only and not use machine-file staging.
+
+Asset/manifest generation:
+- Ran a Node CSV conversion script that:
+  - Parsed `work/working3/gmoccapy_button_icons/button_icon_inventory.csv`.
+  - Wrote `web-rtcp-5axis-sim-plan/app/src/ui-reference/gmoccapy-button-icons.json`.
+  - Copied icon files from `work/working3/gmoccapy_button_icons/files/` to `web-rtcp-5axis-sim-plan/app/src/assets/gmoccapy-icons/`.
+- Output:
+  - `manifest_entries=211`
+  - `copied_icons=112`
+- Verified:
+  - `find web-rtcp-5axis-sim-plan/app/src/assets/gmoccapy-icons -maxdepth 1 -type f | wc -l` returned `112`.
+  - Manifest JSON parse check printed `211 112 rbt_auto app/src/assets/gmoccapy-icons/img_auto_on__mode_auto_active__48.png`.
+
+Files added:
+- `web-rtcp-5axis-sim-plan/docs/gmoccapy-xyzab-reference.md`
+- `web-rtcp-5axis-sim-plan/app/src/ui-reference/gmoccapy-button-icons.json`
+- `web-rtcp-5axis-sim-plan/app/src/assets/gmoccapy-icons/` with 112 copied PNG/SVG files
+- `web-rtcp-5axis-sim-plan/app/src/profiles/gmoccapy-xyzab.js`
+- `web-rtcp-5axis-sim-plan/app/src/runtime/gmoccapy-communication-model.js`
+- `web-rtcp-5axis-sim-plan/app/src/runtime/gmoccapy-hal-model.js`
+- `web-rtcp-5axis-sim-plan/tests/node/verify_gmoccapy_xyzab_profile.mjs`
+- `web-rtcp-5axis-sim-plan/tests/node/verify_gmoccapy_icon_manifest.mjs`
+- `web-rtcp-5axis-sim-plan/tests/node/verify_gmoccapy_communication_model.mjs`
+- `web-rtcp-5axis-sim-plan/tests/node/verify_gmoccapy_hal_model.mjs`
+
+Files modified:
+- `web-rtcp-5axis-sim-plan/app/package.json`
+  - Added new gmoccapy tests to `smoke:node`.
+- `web-rtcp-5axis-sim-plan/app/src/profiles/index.js`
+  - Registered `gmoccapyXyzabProfile`.
+- `web-rtcp-5axis-sim-plan/app/src/profiles/source-reference-map.js`
+  - Added gmoccapy_XYZAB INI/HAL/postgui/trivkins/gui/glade/icon/doc references.
+- `web-rtcp-5axis-sim-plan/app/src/runtime/rtcp-frame.js`
+  - Generalized fixture joint-pose axis mapping from profile coordinates so XYZAB maps joint 4 to B instead of C.
+- `web-rtcp-5axis-sim-plan/app/src/state/store.js`
+  - Added protection for `tcpCapable=false` profiles in `SET_RTCP` and `SET_KINS_TYPE`.
+  - Updated RUN_READY TCP behavior to only enable RTCP when the selected profile actually has a tcp switchkins type.
+  - Removed default `tcp-xyzac` fallback from MDI TCP resolution for non-TCP profiles.
+- `web-rtcp-5axis-sim-plan/app/src/ui/gmoccapy-shell.js`
+  - Disabled TCP sidebar button for profiles without a TCP kins type and added a reference-only title reason.
+- `web-rtcp-5axis-sim-plan/docs/traceability-matrix.md`
+  - Added gmoccapy_XYZAB profile, communication model, HAL model, and icon manifest traceability rows.
+- `web-rtcp-5axis-sim-plan/tests/node/verify_profile_boundary.mjs`
+  - Updated expected profile list to include `gmoccapy-xyzab` and added reference-only assertions.
+- `web-rtcp-5axis-sim-plan/tests/node/verify_rtcp_store.mjs`
+  - Updated available profile assertion for the third profile.
+- `work/working4/03-progress-ledger.md`
+  - Added W4-IMPL-001 ledger entry.
+- `work/working4/04-task-matrix.md`
+  - Marked W4-A01..A04, W4-P01..P04, W4-T01..T04, W4-T08, W4-V01..V05 done; left UI icon integration, gate expansion, QA report/screenshot tasks todo.
+- `work/working4/05-acceptance-evidence.md`
+  - Added W4-IMPL-001 evidence with commands, outputs, manifest counts, and remaining gaps.
+- `work/working4/06-decision-records.md`
+  - Added ADR-009: gmoccapy_XYZAB profile must block TCP/RTCP switching.
+
+Important implementation decisions:
+- `gmoccapy-xyzab` is selectable but remains `trivkins coordinates=xyzab`, `tcpCapable=false`, `rtcpProof=false`, `promotionAllowed=false`.
+- UI and store both prevent TCP/RTCP activation for `gmoccapy-xyzab`.
+- Existing source-derived runtime proof remains with `xyzac-trt` and `xyzbc-trt`.
+- Button manifest and copied icons are treated as UI asset provenance only, not control semantics proof.
+- Communication and HAL/postgui models are data/test additions only in this turn; they are not yet rendered in the info panel.
+
+Validation commands and results:
+- `node web-rtcp-5axis-sim-plan/tests/node/verify_gmoccapy_xyzab_profile.mjs`
+  - `gmoccapy_xyzab_profile_smoke=ok`
+- `node web-rtcp-5axis-sim-plan/tests/node/verify_gmoccapy_icon_manifest.mjs`
+  - Initially failed because test expected non-existent CSV IDs `btn_view_x` etc.; inspected manifest and corrected test IDs to `rbt_view_x/y/z/p`, `tbtn_view_tool_path`, `tbtn_view_dimension`.
+  - Final result: `gmoccapy_icon_manifest_smoke=ok`
+- `node web-rtcp-5axis-sim-plan/tests/node/verify_gmoccapy_communication_model.mjs`
+  - `gmoccapy_communication_model_smoke=ok`
+- `node web-rtcp-5axis-sim-plan/tests/node/verify_gmoccapy_hal_model.mjs`
+  - `gmoccapy_hal_model_smoke=ok`
+- `node web-rtcp-5axis-sim-plan/tests/node/verify_profile_boundary.mjs`
+  - `profile_boundary_smoke=ok`
+- `node web-rtcp-5axis-sim-plan/tests/node/verify_rtcp_store.mjs`
+  - Initially failed because existing test expected `availableProfiles.length === 2`; updated assertion to expected IDs `xyzac-trt`, `xyzbc-trt`, `gmoccapy-xyzab`.
+  - Final result: `rtcp_store_smoke=ok`
+- `npm --prefix web-rtcp-5axis-sim-plan/app run build`
+  - `gmoccapy_static_build=ok`
+- `npm --prefix web-rtcp-5axis-sim-plan/app run smoke:node`
+  - Passed all chained tests, including:
+    - `profile_boundary_smoke=ok`
+    - `gmoccapy_xyzab_profile_smoke=ok`
+    - `gmoccapy_icon_manifest_smoke=ok`
+    - `gmoccapy_communication_model_smoke=ok`
+    - `gmoccapy_hal_model_smoke=ok`
+    - `linear_unit_conversion_smoke=ok`
+- `bash web-rtcp-5axis-sim-plan/tests/browser/verify_gmoccapy_shell_browser.sh`
+  - `gmoccapy_shell_smoke=ok`
+- `bash web-rtcp-5axis-sim-plan/tests/browser/verify_gmoccapy_dist_browser.sh`
+  - `gmoccapy_dist_smoke=ok`
+- `git diff --check -- web-rtcp-5axis-sim-plan work/working4`
+  - Returned 0 with no whitespace errors.
+- Final asset check:
+  - `find web-rtcp-5axis-sim-plan/app/src/assets/gmoccapy-icons -maxdepth 1 -type f | wc -l` returned `112`.
+  - Manifest check printed `manifest 211 112`.
+
+Final git status summary:
+- Modified tracked files:
+  - `web-rtcp-5axis-sim-plan/app/package.json`
+  - `web-rtcp-5axis-sim-plan/app/src/profiles/index.js`
+  - `web-rtcp-5axis-sim-plan/app/src/profiles/source-reference-map.js`
+  - `web-rtcp-5axis-sim-plan/app/src/runtime/rtcp-frame.js`
+  - `web-rtcp-5axis-sim-plan/app/src/state/store.js`
+  - `web-rtcp-5axis-sim-plan/app/src/ui/gmoccapy-shell.js`
+  - `web-rtcp-5axis-sim-plan/docs/traceability-matrix.md`
+  - `web-rtcp-5axis-sim-plan/gptlog-process/gpdlog.md`
+  - `web-rtcp-5axis-sim-plan/tests/node/verify_profile_boundary.mjs`
+  - `web-rtcp-5axis-sim-plan/tests/node/verify_rtcp_store.mjs`
+- Untracked new files/directories:
+  - `web-rtcp-5axis-sim-plan/app/src/assets/`
+  - `web-rtcp-5axis-sim-plan/app/src/profiles/gmoccapy-xyzab.js`
+  - `web-rtcp-5axis-sim-plan/app/src/runtime/gmoccapy-communication-model.js`
+  - `web-rtcp-5axis-sim-plan/app/src/runtime/gmoccapy-hal-model.js`
+  - `web-rtcp-5axis-sim-plan/app/src/ui-reference/`
+  - `web-rtcp-5axis-sim-plan/docs/gmoccapy-xyzab-reference.md`
+  - `web-rtcp-5axis-sim-plan/tests/node/verify_gmoccapy_communication_model.mjs`
+  - `web-rtcp-5axis-sim-plan/tests/node/verify_gmoccapy_hal_model.mjs`
+  - `web-rtcp-5axis-sim-plan/tests/node/verify_gmoccapy_icon_manifest.mjs`
+  - `web-rtcp-5axis-sim-plan/tests/node/verify_gmoccapy_xyzab_profile.mjs`
+  - `work/working4/`
+
+Remaining work intentionally left todo:
+- W4-U01..U05: icon registry and actual UI icon integration, plus communication/HAL diagnostics rendering in info panel.
+- W4-G01..G05 and W4-T05: dedicated gmoccapy_XYZAB gate expansion/test.
+- W4-T06..T07: browser smoke extensions and QA JSON/PDF/screenshot report.
+
+Result: W4-A/W4-P/W4-T01..T04/W4-V implementation slice completed and verified.
+
+---
+
+## Codex execution log - W4-IMPL-002
+
+Timestamp: 2026-06-26 15:08:32 EDT
+Workspace: `/home/meswork/cnc_wams`
+User request: Continue the previous round and finish the work under `/home/meswork/cnc_wams/work/working4`.
+
+Process followed:
+1. Inspected `work/working4/README.md`, `03-progress-ledger.md`, `04-task-matrix.md`, `05-acceptance-evidence.md`, `01-function-content.md`, `02-program-development-steps.md`, and `06-decision-records.md`.
+2. Confirmed previous round had completed W4-A and W4-P items, with remaining todo items in UI/icon integration, communication/HAL diagnostics rendering, gmoccapy_XYZAB gates, browser smoke, and QA report generation.
+3. Inspected existing implementation files:
+   - `app/src/ui/gmoccapy-shell.js`
+   - `app/src/styles/gmoccapy.css`
+   - `app/src/state/store.js`
+   - `app/src/state/linuxcnc-task-policy.js`
+   - existing tests under `tests/node/` and `tests/browser/`
+   - existing QA capture scripts under `qa/web-rtcp-5axis-site-test/`
+4. Implemented a focused gmoccapy icon registry and wired it into current shell rendering without introducing a frontend framework or runtime dependency on `work/working3`.
+5. Extended the info panel to render gmoccapy communication and HAL/postgui diagnostics from the already-created models.
+6. Extended task policy for gmoccapy_XYZAB gate semantics while preserving existing `xyzac-trt`/`xyzbc-trt` runtime behavior.
+7. Added spindle direction state and gate-guarded spindle/coolant/override store actions.
+8. Added Node tests for icon registry and gmoccapy_XYZAB gate behavior.
+9. Updated browser smoke to assert core icon DOM attributes and gmoccapy NML/HAL diagnostics.
+10. Added a QA capture script that generates JSON/PDF/screenshots for gmoccapy_XYZAB function evidence.
+11. Updated `work/working4/03-progress-ledger.md`, `04-task-matrix.md`, and `05-acceptance-evidence.md` with current status and evidence.
+12. Ran targeted tests, full smoke tests, browser tests, QA capture, and whitespace checks.
+
+Files added:
+- `web-rtcp-5axis-sim-plan/app/src/ui/gmoccapy-icon-registry.js`
+- `web-rtcp-5axis-sim-plan/tests/node/verify_gmoccapy_icon_registry.mjs`
+- `web-rtcp-5axis-sim-plan/tests/node/verify_gmoccapy_xyzab_gates.mjs`
+- `qa/web-rtcp-5axis-site-test/capture-gmoccapy-xyzab-function-cases.mjs`
+- `qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.json`
+- `qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.pdf`
+- `qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab/01-loaded.png`
+- `qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab/02-profile-selected.png`
+- `qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab/03-run-blocked-power.png`
+- `qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab/04-run-blocked-reference-evidence.png`
+- `qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab/05-controls-active.png`
+- `qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab/06-hal-diagnostics.png`
+
+Files updated in this execution:
+- `web-rtcp-5axis-sim-plan/app/package.json`
+- `web-rtcp-5axis-sim-plan/app/src/state/linuxcnc-task-policy.js`
+- `web-rtcp-5axis-sim-plan/app/src/state/store.js`
+- `web-rtcp-5axis-sim-plan/app/src/styles/gmoccapy.css`
+- `web-rtcp-5axis-sim-plan/app/src/ui/gmoccapy-shell.js`
+- `web-rtcp-5axis-sim-plan/tests/browser/gmoccapy_shell_smoke.html`
+- `work/working4/03-progress-ledger.md`
+- `work/working4/04-task-matrix.md`
+- `work/working4/05-acceptance-evidence.md`
+- `web-rtcp-5axis-sim-plan/gptlog-process/gpdlog.md`
+
+Important fixes/adjustments during validation:
+- Initial `verify_gmoccapy_xyzab_gates.mjs` fixture lacked fields required by `applyIniConfigToProfile`; added minimal profile-derived INI structures.
+- Initial strict RUN/JOG/HOME policy was too broad and broke existing `verify_rtcp_store.mjs`; narrowed strict RUN checks to `gmoccapy-xyzab`.
+- Full `smoke:node` initially failed in `verify_linuxcnc_task_hal_runtime.mjs` because JOG/HOME gating treated a manual-mode stale `runState=running` as active AUTO execution. Adjusted running detection to block JOG/HOME only for AUTO reading/waiting/running, preserving the existing task/HAL HOME/JOG continuity behavior.
+- One build attempt failed with `ENOTEMPTY` because `npm run build` and dist browser smoke were run in parallel against `app/dist`; reran build sequentially and it passed. This was a command concurrency issue, not a source failure.
+
+Validation commands and final results:
+- `node --check web-rtcp-5axis-sim-plan/app/src/ui/gmoccapy-shell.js`
+  - Passed.
+- `node --check web-rtcp-5axis-sim-plan/app/src/state/store.js`
+  - Passed.
+- `node --check web-rtcp-5axis-sim-plan/app/src/state/linuxcnc-task-policy.js`
+  - Passed.
+- `node --check qa/web-rtcp-5axis-site-test/capture-gmoccapy-xyzab-function-cases.mjs`
+  - Passed.
+- `node web-rtcp-5axis-sim-plan/tests/node/verify_gmoccapy_icon_registry.mjs`
+  - `gmoccapy_icon_registry_smoke=ok`
+- `node web-rtcp-5axis-sim-plan/tests/node/verify_gmoccapy_xyzab_gates.mjs`
+  - `gmoccapy_xyzab_gates_smoke=ok`
+- `node web-rtcp-5axis-sim-plan/tests/node/verify_rtcp_store.mjs`
+  - `rtcp_store_smoke=ok`
+- `node web-rtcp-5axis-sim-plan/tests/node/verify_run_preconditions.mjs`
+  - `run_preconditions_ini_profile_smoke=ok`
+  - `run_preconditions_kinematics_smoke=ok`
+  - `run_preconditions_machine_file_smoke=ok`
+- `node web-rtcp-5axis-sim-plan/tests/node/verify_linuxcnc_task_hal_runtime.mjs`
+  - `linuxcnc_task_hal_runtime_smoke=ok`
+  - `task_hal_machine_file_smoke=ok`
+  - `switchkins_remap_hal_sync_smoke=ok`
+  - `browser_task_hal_worker_smoke=ok`
+- `npm --prefix web-rtcp-5axis-sim-plan/app run smoke:node`
+  - Passed all chained Node tests, including `gmoccapy_icon_registry_smoke=ok` and `gmoccapy_xyzab_gates_smoke=ok`.
+- `npm --prefix web-rtcp-5axis-sim-plan/app run build`
+  - Final sequential run: `gmoccapy_static_build=ok`
+- `bash web-rtcp-5axis-sim-plan/tests/browser/verify_gmoccapy_shell_browser.sh`
+  - `gmoccapy_shell_smoke=ok`
+- `bash web-rtcp-5axis-sim-plan/tests/browser/verify_gmoccapy_dist_browser.sh`
+  - `gmoccapy_dist_smoke=ok`
+- `node qa/web-rtcp-5axis-site-test/capture-gmoccapy-xyzab-function-cases.mjs`
+  - `gmoccapy_xyzab_function_status=PASS`
+  - `gmoccapy_xyzab_function_job_id=xyzab-20260626190724-7b80b3aa`
+  - `gmoccapy_xyzab_function_report_id=report-xyzab-20260626190724-7b80b3aa`
+  - JSON: `/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.json`
+  - PDF: `/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.pdf`
+  - Screenshots: `/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab/`
+- `git diff --check -- web-rtcp-5axis-sim-plan qa/web-rtcp-5axis-site-test work/working4`
+  - Returned 0 with no whitespace errors.
+
+QA report checks from JSON:
+- PASS XYZAB profile selected
+- PASS Reference profile blocks RTCP promotion
+- PASS RUN blocked before power
+- PASS RUN blocked by reference evidence
+- PASS Core icons rendered
+- PASS Spindle/coolant state updates
+- PASS NML command diagnostic
+- PASS Web runtime diagnostic
+- PASS HAL postgui diagnostic
+- PASS Screenshots are nonblank
+
+Task matrix outcome:
+- Marked W4-U01..W4-U05 done.
+- Marked W4-G01..W4-G05 done.
+- Marked W4-T05..W4-T07 done.
+- Updated W4 evidence with current JSON/PDF/screenshots and latest job/report IDs.
+
+Final note:
+- `gmoccapy-xyzab` remains a `trivkins` reference-only profile. This work validates UI assets, diagnostics, task gate semantics, blocked reasons, and reporting evidence; it does not promote XYZAB as TCP/RTCP proof or native LinuxCNC realtime execution.
+
+---
+
+## 2026-06-26 15:11:55 EDT - working4 remaining-work completion check
+
+User request:
+- Continue and finish remaining work in `/home/meswork/cnc_wams/work/working4`.
+
+Process:
+- Checked `work/working4/04-task-matrix.md` for task rows still in `todo`, `in_progress`, `blocked`, or `deferred`; none were found.
+- Checked `work/working4/04-task-matrix.md` and `work/working4/05-acceptance-evidence.md` for stale TODO/pending markers. Remaining `blocked` matches were status vocabulary, expected QA screenshot names/check labels, and completed gate evidence text.
+- Parsed `qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.json`; result was `status=PASS`, `steps=6`, `checks=10`.
+- Ran `git diff --check -- web-rtcp-5axis-sim-plan qa/web-rtcp-5axis-site-test work/working4`; returned 0.
+- Updated `work/working4/04-task-matrix.md` wording for W4-D06 and W4-T08 to remove stale "pending evidence" wording from completed rows.
+- Re-ran the remaining-task scan, QA JSON status check, and whitespace check after the wording update. The final task-row scan still found no unfinished W4 task rows; the final QA report status remained `PASS`; the final whitespace check returned 0.
+
+Outcome:
+- No remaining `working4` task-matrix work was found.
+- `gmoccapy-xyzab-function-report.json` remains PASS with 6 steps and 10 checks.
+- Only documentation wording was changed in this continuation pass, plus this required process-log append.
+
+Addendum:
+- After the log append, ran `git diff --check -- web-rtcp-5axis-sim-plan qa/web-rtcp-5axis-site-test work/working4`; returned 0.
+- Checked focused status for `work/working4/04-task-matrix.md` and `web-rtcp-5axis-sim-plan/gptlog-process/gpdlog.md`; status showed the required log file modified and `work/working4/04-task-matrix.md` present as an untracked working file.
+- Appended this addendum as the final tool action for this execution.
+
+---
+
+## 2026-06-26 15:17:57 EDT - working4 status-document closure
+
+User request:
+- Continue completing `/home/meswork/cnc_wams/work/working4`.
+
+Process:
+- Inspected git status for `work/working4`, `web-rtcp-5axis-sim-plan`, and `qa/web-rtcp-5axis-site-test`.
+- Checked `work/working4/04-task-matrix.md` for unfinished W4 task rows; none were found.
+- Read `work/working4/README.md`, `01-function-content.md`, `02-program-development-steps.md`, `03-progress-ledger.md`, `04-task-matrix.md`, and `05-acceptance-evidence.md`.
+- Found remaining planning-era wording in `README.md`, `01-function-content.md`, `02-program-development-steps.md`, and `05-acceptance-evidence.md`: the docs still described the stage as planning-only, had feature package rows marked pending/partial, and mentioned no job/report IDs even though implementation and QA evidence now exist.
+- Updated `README.md` to state that working4 is implemented, verified, and archived, with the current boundary that `gmoccapy-xyzab` remains reference-only.
+- Updated `01-function-content.md` to mark F-XYZAB-01 through F-XYZAB-07 as completed or boundary-completed, and adjusted the success definition to the actual evidence scope.
+- Updated `02-program-development-steps.md` to state that phases A through G are complete and that JSON/PDF QA capture is generated.
+- Updated `04-task-matrix.md` with W4-D08 for status-document closure and updated W4-V05 to include the QA path in `git diff --check`.
+- Updated `05-acceptance-evidence.md` to remove the obsolete "documentation only/no job_id" wording, add icon registry/dist smoke/whitespace evidence rows, and change the document task range to W4-D01 through W4-D08.
+- Updated `03-progress-ledger.md` with W4-DOC-002, including files changed, validation commands, results, retained semantic boundaries, and final next step.
+
+Validation:
+- `rg -n "\\| W4-[A-Z0-9-]+ \\| (todo|in_progress|blocked|deferred) \\|" work/working4/04-task-matrix.md || true`
+  - Returned no unfinished task rows.
+- `rg -n "待实施|待验证|待生成|PDF 任务保持 todo|本轮只创建文档|没有生成新的 job_id|后续新增：|TODO" work/working4/README.md work/working4/01-function-content.md work/working4/02-program-development-steps.md work/working4/05-acceptance-evidence.md || true`
+  - Returned no stale current-state wording.
+- `node -e "const r=JSON.parse(require('fs').readFileSync('qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.json','utf8')); if(r.status!=='PASS') process.exit(1); console.log('qa_report_status='+r.status); console.log('qa_report_steps='+r.steps.length); console.log('qa_report_checks='+r.checks.length);"`
+  - `qa_report_status=PASS`
+  - `qa_report_steps=6`
+  - `qa_report_checks=10`
+- `git diff --check -- web-rtcp-5axis-sim-plan qa/web-rtcp-5axis-site-test work/working4`
+  - Returned 0.
+
+Outcome:
+- `working4` no longer has current task rows pending or current status docs saying the work is still planning-only/pending.
+- The remaining caveats are intentional semantic boundaries: `gmoccapy-xyzab` is still a `trivkins` reference-only profile and this stage does not prove native LinuxCNC realtime execution.
+
+---
+
+## 2026-06-26 15:20:53 EDT - working4 wording finalization
+
+User request:
+- Continue completing `/home/meswork/cnc_wams/work/working4`.
+
+Process:
+- Re-scanned `work/working4/04-task-matrix.md` for W4 rows still in `todo`, `in_progress`, `blocked`, or `deferred`; none were found.
+- Re-scanned current state docs for stale planning wording such as pending implementation, pending validation, pending PDF generation, documentation-only state, missing job_id/report_id, and planning-only headings.
+- Inspected `work/working4/06-decision-records.md`, `04-task-matrix.md`, and `03-progress-ledger.md`.
+- Identified remaining wording that was not a functional gap but could make the archive look like a plan rather than a completed record:
+  - `README.md` document descriptions still said "to be improved" and "files to change".
+  - `02-program-development-steps.md` used "suggested new or updated files" throughout completed phases.
+  - `03-progress-ledger.md` preserved early historical "remaining issues" without a top-level note explaining that later W4 entries closed them.
+  - `04-task-matrix.md` still said W4-D01 listed a future execution entry and W4-T07 output PDF only "if needed".
+- Updated `README.md` to describe `01-function-content.md` and `02-program-development-steps.md` as completed/recorded content.
+- Updated `02-program-development-steps.md` wording from planning suggestions to archived "main new or updated files".
+- Added a note near the top of `03-progress-ledger.md` that early remaining issues and next steps are historical and that current state is governed by the task matrix and acceptance evidence.
+- Updated the W4-DOC-002 ledger entry to include the `02-program-development-steps.md` wording closure.
+- Updated `04-task-matrix.md` W4-D01 and W4-T07 acceptance wording to match the completed archive state.
+- Added W4-DOC-003 to `03-progress-ledger.md` for this final wording cleanup.
+
+Validation:
+- `rg -n "\\| W4-[A-Z0-9-]+ \\| (todo|in_progress|blocked|deferred) \\|" work/working4/04-task-matrix.md || true`
+  - Returned no unfinished W4 task rows.
+- `rg -n "待实施|待验证|待生成|PDF 任务保持 todo|本轮只创建文档|没有生成新的 job_id|后续新增：|建议新增|建议新增或更新|必要时输出 PDF|后续执行入口|拟完善功能包|TODO" work/working4/README.md work/working4/01-function-content.md work/working4/02-program-development-steps.md work/working4/04-task-matrix.md work/working4/05-acceptance-evidence.md || true`
+  - Returned no stale planning/current-state wording.
+- `node -e "const r=JSON.parse(require('fs').readFileSync('qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.json','utf8')); if(r.status!=='PASS') process.exit(1); console.log('qa_report_status='+r.status); console.log('qa_report_steps='+r.steps.length); console.log('qa_report_checks='+r.checks.length);"`
+  - `qa_report_status=PASS`
+  - `qa_report_steps=6`
+  - `qa_report_checks=10`
+- `git diff --check -- web-rtcp-5axis-sim-plan qa/web-rtcp-5axis-site-test work/working4`
+  - Returned 0.
+- After adding W4-DOC-003, re-ran the W4 task-row scan, stale current-state wording scan, and `git diff --check`; all remained clean.
+
+Outcome:
+- No additional implementation work was needed.
+- `working4` docs now read consistently as a completed implementation/evidence archive.
+- The only retained caveats are the intended semantic boundaries: `gmoccapy-xyzab` is reference-only and this stage does not prove TCP/RTCP or native LinuxCNC realtime execution.
+
+---
+
+## 2026-06-26 15:22:49 EDT - working4 recheck no-op closure
+
+User request:
+- Continue completing `/home/meswork/cnc_wams/work/working4`.
+
+Process:
+- Rechecked `work/working4/04-task-matrix.md` for W4 task rows in `todo`, `in_progress`, `blocked`, or `deferred`; none were found.
+- Rechecked current state docs for stale planning/pending wording:
+  - `work/working4/README.md`
+  - `work/working4/01-function-content.md`
+  - `work/working4/02-program-development-steps.md`
+  - `work/working4/04-task-matrix.md`
+  - `work/working4/05-acceptance-evidence.md`
+- Read recent `03-progress-ledger.md`, `README.md`, and the acceptance evidence summary to confirm the previous closure entries and retained semantic boundaries.
+- Parsed `qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.json`.
+- Ran whitespace validation for the project, QA, and working4 paths.
+- Checked focused git status for `work/working4`, `gpdlog.md`, and the gmoccapy QA report artifacts.
+
+Validation:
+- W4 unfinished task-row scan returned no rows.
+- Stale planning/current-state wording scan returned no rows.
+- QA report remained `PASS` with 6 steps and 10 checks.
+- `git diff --check -- web-rtcp-5axis-sim-plan qa/web-rtcp-5axis-site-test work/working4` returned 0.
+- Focused git status showed expected uncommitted artifacts only:
+  - modified `web-rtcp-5axis-sim-plan/gptlog-process/gpdlog.md`
+  - untracked `work/working4/`
+  - untracked gmoccapy QA report JSON/PDF
+
+Outcome:
+- No new code or documentation edits were needed for `working4` in this pass.
+- `working4` remains complete as an implementation/evidence archive, with only the intentional reference-only/native-runtime caveats retained.
+
+---
+
+## 2026-06-26 15:24:59 EDT - working4 QA id-field evidence clarification
+
+User request:
+- Continue completing `/home/meswork/cnc_wams/work/working4`.
+
+Process:
+- Rechecked `04-task-matrix.md` for unfinished W4 rows; none were found.
+- Rechecked current state docs for stale planning or pending wording; none was found.
+- Parsed `qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.json` and initially checked snake_case `job_id/report_id`, which were empty because the JSON uses camelCase `jobId/reportId`.
+- Inspected the QA report JSON structure and confirmed top-level fields include `jobId` and `reportId`.
+- Read `qa/web-rtcp-5axis-site-test/capture-gmoccapy-xyzab-function-cases.mjs` and confirmed it writes `jobId/reportId` to JSON while printing `gmoccapy_xyzab_function_job_id` and `gmoccapy_xyzab_function_report_id` to stdout.
+- Cross-checked `work/working4/05-acceptance-evidence.md` references for job/report IDs.
+- Updated `05-acceptance-evidence.md` to clarify that QA JSON uses camelCase `jobId/reportId`, while console output and the archive table use `job_id/report_id` labels for the same identifiers.
+- Added W4-DOC-004 to `03-progress-ledger.md` documenting this evidence-field clarification.
+
+Validation:
+- `rg -n "\\| W4-[A-Z0-9-]+ \\| (todo|in_progress|blocked|deferred) \\|" work/working4/04-task-matrix.md || true`
+  - Returned no unfinished W4 task rows.
+- `rg -n "待实施|待验证|待生成|PDF 任务保持 todo|本轮只创建文档|没有生成新的 job_id|后续新增：|建议新增|建议新增或更新|必要时输出 PDF|后续执行入口|拟完善功能包|TODO" work/working4/README.md work/working4/01-function-content.md work/working4/02-program-development-steps.md work/working4/04-task-matrix.md work/working4/05-acceptance-evidence.md || true`
+  - Returned no stale current-state wording.
+- `node -e "const r=JSON.parse(require('fs').readFileSync('qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.json','utf8')); if(r.status!=='PASS') process.exit(1); console.log('qa_report_jobId='+r.jobId); console.log('qa_report_reportId='+r.reportId); console.log('qa_report_status='+r.status); console.log('qa_report_steps='+r.steps.length); console.log('qa_report_checks='+r.checks.length);"`
+  - `qa_report_jobId=xyzab-20260626190724-7b80b3aa`
+  - `qa_report_reportId=report-xyzab-20260626190724-7b80b3aa`
+  - `qa_report_status=PASS`
+  - `qa_report_steps=6`
+  - `qa_report_checks=10`
+- `git diff --check -- web-rtcp-5axis-sim-plan qa/web-rtcp-5axis-site-test work/working4`
+  - Returned 0.
+
+Outcome:
+- No implementation changes were needed.
+- `working4` evidence now explicitly documents the QA report field-name mapping, preventing future false-negative checks for `job_id/report_id`.
+
+---
+
+## 2026-06-26 15:26:22 EDT - working4 clean recheck
+
+User request:
+- Continue completing `/home/meswork/cnc_wams/work/working4`.
+
+Process:
+- Rechecked `work/working4/04-task-matrix.md` for unfinished W4 task rows.
+- Rechecked current state docs for stale planning/pending wording:
+  - `work/working4/README.md`
+  - `work/working4/01-function-content.md`
+  - `work/working4/02-program-development-steps.md`
+  - `work/working4/04-task-matrix.md`
+  - `work/working4/05-acceptance-evidence.md`
+- Parsed `qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.json` using `jobId/reportId`.
+- Ran whitespace validation on `web-rtcp-5axis-sim-plan`, `qa/web-rtcp-5axis-site-test`, and `work/working4`.
+- Checked focused git status for `work/working4`, `gpdlog.md`, and the gmoccapy QA report JSON/PDF.
+
+Validation:
+- W4 unfinished task-row scan returned no rows.
+- Stale current-state wording scan returned no rows.
+- QA report remained `PASS`:
+  - `jobId=xyzab-20260626190724-7b80b3aa`
+  - `reportId=report-xyzab-20260626190724-7b80b3aa`
+  - `steps=6`
+  - `checks=10`
+- `git diff --check -- web-rtcp-5axis-sim-plan qa/web-rtcp-5axis-site-test work/working4` returned 0.
+
+Outcome:
+- No new `working4` work was found.
+- No code or documentation changes were needed in this pass.
+
+---
+
+## 2026-06-26 15:27:29 EDT - working4 no-op verification
+
+User request:
+- Continue completing `/home/meswork/cnc_wams/work/working4`.
+
+Process:
+- Ran the standard W4 unfinished-task scan against `work/working4/04-task-matrix.md`.
+- Ran the current-state stale wording scan against the active `working4` docs.
+- Parsed `qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.json`.
+- Ran `git diff --check -- web-rtcp-5axis-sim-plan qa/web-rtcp-5axis-site-test work/working4`.
+- Checked focused status for `work/working4`, `gpdlog.md`, and the gmoccapy QA report JSON/PDF.
+
+Validation:
+- No W4 rows were in `todo`, `in_progress`, `blocked`, or `deferred`.
+- No stale current-state planning/pending wording was found.
+- QA report remained `PASS`:
+  - `jobId=xyzab-20260626190724-7b80b3aa`
+  - `reportId=report-xyzab-20260626190724-7b80b3aa`
+  - `steps=6`
+  - `checks=10`
+- `git diff --check` returned 0.
+
+Outcome:
+- No new work was needed for `working4`.
+- No `working4` source, evidence, or implementation files were changed in this pass.
+
+---
+
+## 2026-06-26 15:32:48 EDT - working4 final closure page
+
+User request:
+- Continue completing `/home/meswork/cnc_wams/work/working4`.
+
+Process:
+- Performed a higher-level closure audit instead of only repeating keyword checks.
+- Inspected the file list under `work/working4`; only README and documents 01 through 06 existed.
+- Read `README.md`, `04-task-matrix.md`, and recent `03-progress-ledger.md`.
+- Determined that the work was complete but the archive lacked a single final closure entry point summarizing completion, evidence, retained boundaries, and future-change rules.
+- Added `work/working4/07-final-closure.md`.
+- Updated `README.md` to mark `07-final-closure.md` as the final closure entry and add it to the document list and maintenance steps.
+- Updated `04-task-matrix.md` with W4-D09 for the final closure document and adjusted W4-D01 to list 01-07 documents.
+- Updated `03-progress-ledger.md` with W4-DOC-005.
+- Updated `05-acceptance-evidence.md` to include `07-final-closure.md` in the document output list and extend the document closure row from W4-D01..W4-D08 to W4-D01..W4-D09.
+- Fixed the stale-wording example command in `07-final-closure.md` so the command itself does not trip the stale-wording scan.
+- Updated W4-DOC-005 results after validation.
+
+Validation:
+- `rg -n "\\| W4-[A-Z0-9-]+ \\| (todo|in_progress|blocked|deferred) \\|" work/working4/04-task-matrix.md || true`
+  - Returned no unfinished W4 task rows.
+- `rg -n "待实施|待验证|待生成|PDF 任务保持 todo|本轮只创建文档|没有生成新的 job_id|后续新增：|建议新增|建议新增或更新|必要时输出 PDF|后续执行入口|拟完善功能包|TODO" work/working4/README.md work/working4/01-function-content.md work/working4/02-program-development-steps.md work/working4/04-task-matrix.md work/working4/05-acceptance-evidence.md work/working4/07-final-closure.md || true`
+  - Returned no stale current-state wording.
+- `node -e "const r=JSON.parse(require('fs').readFileSync('qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.json','utf8')); if(r.status!=='PASS') process.exit(1); console.log('qa_report_jobId='+r.jobId); console.log('qa_report_reportId='+r.reportId); console.log('qa_report_status='+r.status); console.log('qa_report_steps='+r.steps.length); console.log('qa_report_checks='+r.checks.length);"`
+  - `qa_report_jobId=xyzab-20260626190724-7b80b3aa`
+  - `qa_report_reportId=report-xyzab-20260626190724-7b80b3aa`
+  - `qa_report_status=PASS`
+  - `qa_report_steps=6`
+  - `qa_report_checks=10`
+- `git diff --check -- web-rtcp-5axis-sim-plan qa/web-rtcp-5axis-site-test work/working4`
+  - Returned 0.
+
+Outcome:
+- `working4` now has a single final closure document: `work/working4/07-final-closure.md`.
+- Task matrix and evidence archive are aligned through W4-D09.
+- No implementation changes were needed.
+
+---
+
+## 2026-06-26 15:34:24 EDT - working4 final closure recheck
+
+User request:
+- Continue completing `/home/meswork/cnc_wams/work/working4`.
+
+Process:
+- Verified `work/working4` file list includes README and documents 01 through 07.
+- Rechecked `04-task-matrix.md` for unfinished W4 task rows; none were found.
+- Rechecked current state docs, including `07-final-closure.md`, for stale planning/pending wording; none was found.
+- Parsed `qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.json`.
+- Ran `git diff --check -- web-rtcp-5axis-sim-plan qa/web-rtcp-5axis-site-test work/working4`.
+- Read `07-final-closure.md` to verify it contains the final conclusion, QA evidence paths, identifiers, retained boundaries, validation commands, and future-change rules.
+- Checked focused git status for `work/working4`, `gpdlog.md`, and gmoccapy QA report JSON/PDF.
+
+Validation:
+- File list includes `07-final-closure.md`.
+- W4 unfinished task-row scan returned no rows.
+- Stale current-state wording scan returned no rows.
+- QA report remained `PASS`:
+  - `jobId=xyzab-20260626190724-7b80b3aa`
+  - `reportId=report-xyzab-20260626190724-7b80b3aa`
+  - `steps=6`
+  - `checks=10`
+- `git diff --check` returned 0.
+
+Outcome:
+- No additional `working4` edits were needed.
+- Final closure documentation remains complete and consistent.
+
+---
+
+## 2026-06-26 15:35:37 EDT - working4 final state verification
+
+User request:
+- Continue completing `/home/meswork/cnc_wams/work/working4`.
+
+Process:
+- Verified `work/working4/07-final-closure.md` exists.
+- Rechecked `work/working4/04-task-matrix.md` for W4 rows in `todo`, `in_progress`, `blocked`, or `deferred`.
+- Rechecked current state docs for stale planning/pending wording:
+  - `README.md`
+  - `01-function-content.md`
+  - `02-program-development-steps.md`
+  - `04-task-matrix.md`
+  - `05-acceptance-evidence.md`
+  - `07-final-closure.md`
+- Parsed `qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.json`.
+- Ran `git diff --check -- web-rtcp-5axis-sim-plan qa/web-rtcp-5axis-site-test work/working4`.
+- Checked focused git status for `work/working4`, `gpdlog.md`, and gmoccapy QA report JSON/PDF.
+
+Validation:
+- `final_closure=present`
+- No unfinished W4 task rows were found.
+- No stale current-state wording was found.
+- QA report remained `PASS`:
+  - `jobId=xyzab-20260626190724-7b80b3aa`
+  - `reportId=report-xyzab-20260626190724-7b80b3aa`
+  - `steps=6`
+  - `checks=10`
+- `git diff --check` returned 0.
+
+Outcome:
+- No new `working4` work was found.
+- No source, evidence, or implementation files required changes in this pass.
+
+---
+
+## 2026-06-26 17:46:14 EDT - working4 resumed validation and QA refresh
+
+User request:
+- Continue the prior turn and finish the work under `/home/meswork/cnc_wams/work/working4`.
+- The prior turn was intentionally interrupted by the user, then the user requested "continue".
+
+Process:
+- Restored workspace context from `/home/meswork/cnc_wams`.
+- Listed `work/working4` files and confirmed the document set:
+  - `README.md`
+  - `01-function-content.md`
+  - `02-program-development-steps.md`
+  - `03-progress-ledger.md`
+  - `04-task-matrix.md`
+  - `05-acceptance-evidence.md`
+  - `06-decision-records.md`
+  - `07-final-closure.md`
+- Checked git status and observed existing working tree changes in `web-rtcp-5axis-sim-plan`, QA outputs, and `work/working4`.
+- Read workspace `AGENTS.md` and confirmed the required process log path:
+  - `/home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/gptlog-process/gpdlog.md`
+- Read `work/working4/README.md`, `03-progress-ledger.md`, `04-task-matrix.md`, and `07-final-closure.md`.
+- Confirmed the current `working4` documents already recorded all W4-D/W4-A/W4-P/W4-U/W4-G/W4-T/W4-V tasks as complete.
+- Ran the unfinished W4 task-row scan:
+  - `rg -n "\\| W4-[A-Z0-9-]+ \\| (todo|in_progress|blocked|deferred) \\|" work/working4/04-task-matrix.md`
+  - Result: no matches, command exited 1 as expected for no unfinished task rows.
+- Ran the stale current-state wording scan against:
+  - `work/working4/README.md`
+  - `work/working4/01-function-content.md`
+  - `work/working4/02-program-development-steps.md`
+  - `work/working4/04-task-matrix.md`
+  - `work/working4/05-acceptance-evidence.md`
+  - `work/working4/07-final-closure.md`
+  - Result: no matches, command exited 1 as expected for no stale wording.
+- Parsed the existing QA JSON before rerunning capture:
+  - `jobId=xyzab-20260626190724-7b80b3aa`
+  - `reportId=report-xyzab-20260626190724-7b80b3aa`
+  - `status=PASS`
+  - `steps=6`
+  - `checks=10`
+- Ran `git diff --check -- web-rtcp-5axis-sim-plan qa/web-rtcp-5axis-site-test work/working4`.
+  - Result: returned 0.
+- Ran full validation:
+  - `npm --prefix web-rtcp-5axis-sim-plan/app run build`
+  - `npm --prefix web-rtcp-5axis-sim-plan/app run smoke:node`
+  - `bash web-rtcp-5axis-sim-plan/tests/browser/verify_gmoccapy_shell_browser.sh`
+  - `bash web-rtcp-5axis-sim-plan/tests/browser/verify_gmoccapy_dist_browser.sh`
+  - `node qa/web-rtcp-5axis-site-test/capture-gmoccapy-xyzab-function-cases.mjs`
+- Validation outputs:
+  - Build: `gmoccapy_static_build=ok`
+  - Node smoke included:
+    - `linuxcnc_kinematics_runtime_smoke=ok`
+    - `linuxcnc_interpreter_runtime_smoke=ok`
+    - `linuxcnc_ini_runtime_smoke=ok`
+    - `run_preconditions_ini_profile_smoke=ok`
+    - `run_preconditions_kinematics_smoke=ok`
+    - `run_preconditions_machine_file_smoke=ok`
+    - `run_feedback_status_loop_smoke=ok`
+    - `run_ready_sequence_smoke=ok`
+    - `linuxcnc_task_hal_runtime_smoke=ok`
+    - `task_hal_machine_file_smoke=ok`
+    - `switchkins_remap_hal_sync_smoke=ok`
+    - `browser_task_hal_worker_smoke=ok`
+    - `native_task_hal_source_artifact_audit=ok`
+    - `full_linuxcnc_5axis_source_node_smoke=ok`
+    - `real_linuxcnc_5axis_program_cases_smoke=ok`
+    - `full_execution_boundary_smoke=ok`
+    - `machine_file_staging_smoke=ok`
+    - `five_axis_session_smoke=ok`
+    - `rtcp_store_smoke=ok`
+    - `profile_boundary_smoke=ok`
+    - `gmoccapy_xyzab_profile_smoke=ok`
+    - `gmoccapy_icon_manifest_smoke=ok`
+    - `gmoccapy_icon_registry_smoke=ok`
+    - `gmoccapy_communication_model_smoke=ok`
+    - `gmoccapy_hal_model_smoke=ok`
+    - `gmoccapy_xyzab_gates_smoke=ok`
+    - `linear_unit_conversion_smoke=ok`
+  - Browser shell smoke: `gmoccapy_shell_smoke=ok`
+  - Dist browser smoke: `gmoccapy_dist_smoke=ok`
+  - QA capture:
+    - `gmoccapy_xyzab_function_status=PASS`
+    - `gmoccapy_xyzab_function_job_id=xyzab-20260626214346-f4b4aa36`
+    - `gmoccapy_xyzab_function_report_id=report-xyzab-20260626214346-f4b4aa36`
+    - JSON path: `/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.json`
+    - PDF path: `/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.pdf`
+    - Screenshot directory: `/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab`
+- Parsed the refreshed QA JSON:
+  - `jobId=xyzab-20260626214346-f4b4aa36`
+  - `reportId=report-xyzab-20260626214346-f4b4aa36`
+  - `status=PASS`
+  - `steps=6`
+  - `checks=10`
+  - `generatedAt=2026-06-26T21:43:46.310Z`
+- Updated `work/working4/05-acceptance-evidence.md`:
+  - Changed the current QA capture command output to the refreshed `job_id` and `report_id`.
+  - Added a new job/report table row for the resumed QA capture.
+- Updated `work/working4/07-final-closure.md`:
+  - Changed final QA identifiers to the refreshed `jobId` and `reportId`.
+  - Added `generatedAt=2026-06-26T21:43:46.310Z`.
+  - Added the full build, node smoke, browser smoke, dist smoke, and QA capture commands to final validation commands.
+  - Updated final validation results to mention the full validation chain.
+- Updated `work/working4/03-progress-ledger.md`:
+  - Appended `W4-VERIFY-006` with process, files changed, validation commands, results, retained boundaries, and next-step rule.
+- Rechecked identifier usage:
+  - Old `20260626190724` identifiers remain only in historical ledger/history rows.
+  - Current final closure and current QA evidence point to `xyzab-20260626214346-f4b4aa36`.
+- Rechecked unfinished task rows:
+  - No matches.
+- Rechecked stale current-state wording:
+  - No matches.
+- Rechecked whitespace with `git diff --check -- web-rtcp-5axis-sim-plan qa/web-rtcp-5axis-site-test work/working4`.
+  - Result: returned 0.
+
+Files changed in this execution:
+- `/home/meswork/cnc_wams/work/working4/03-progress-ledger.md`
+- `/home/meswork/cnc_wams/work/working4/05-acceptance-evidence.md`
+- `/home/meswork/cnc_wams/work/working4/07-final-closure.md`
+- `/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.json`
+- `/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab-function-report.pdf`
+- `/home/meswork/cnc_wams/qa/web-rtcp-5axis-site-test/output/gmoccapy-xyzab/`
+- `/home/meswork/cnc_wams/web-rtcp-5axis-sim-plan/gptlog-process/gpdlog.md`
+
+Outcome:
+- `working4` remains complete.
+- The current final closure evidence now points to the refreshed QA report:
+  - `jobId=xyzab-20260626214346-f4b4aa36`
+  - `reportId=report-xyzab-20260626214346-f4b4aa36`
+- Full build, Node smoke, browser smoke, dist smoke, QA capture, stale wording scan, unfinished task scan, and whitespace checks all pass.
+- Retained boundary remains unchanged: `gmoccapy-xyzab` is a `trivkins` reference-only profile and is not a TCP/RTCP or native LinuxCNC realtime execution proof.