补充 sim-config coverage release gate 文档
This commit is contained in:
132
text14.txt
132
text14.txt
@@ -1121,3 +1121,135 @@ sim-config coverage handoff 文档/测试,明确 `ASSET_ONLY`、`L4_PYTHON_REM
|
||||
`L4_USER_M_PROCESS`、`NON_MAIN_CLASS`、`UPSTREAM_DEMO` 等 skip reasons 与当前 inventory
|
||||
输出之间的对应关系,并把 release gate 中的 `sim_configs_wasm_node_inventory_*` 输出作为
|
||||
机器可审计基线;仍不 promotion blocked runtime family,不扩大 CNC 语义边界。
|
||||
|
||||
十四、2026-06-15 继续执行记录:sim-config coverage release-gate docs
|
||||
|
||||
本轮按 `text14.txt` 执行,继续推进 sim-config coverage/release-gate 文档收口。新增短版
|
||||
sim-config coverage handoff 文档与 docs smoke,明确 skip reason、inventory 输出、artifact 路径、
|
||||
blocked runtime family policy 与 release gate 的对应关系。
|
||||
|
||||
完成内容:
|
||||
|
||||
- 新增 `wasm-port/docs/sim-configs-coverage-handoff.md`;
|
||||
- 文档记录当前 Node/WASM inventory gate:
|
||||
`SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh`;
|
||||
- 文档固定当前 machine-readable baseline:
|
||||
- `sim_configs_wasm_node_inventory_executed=28`;
|
||||
- `sim_configs_wasm_node_inventory_passed=28`;
|
||||
- `sim_configs_wasm_node_inventory_skipped=131`;
|
||||
- `sim_configs_wasm_node_inventory_unexpected_fail=0`;
|
||||
- `sim_configs_wasm_node_inventory_skip_ASSET_ONLY=65`;
|
||||
- `sim_configs_wasm_node_inventory_skip_L4_PYTHON_REMAP=53`;
|
||||
- `sim_configs_wasm_node_inventory_skip_L4_TOOL_DB=1`;
|
||||
- `sim_configs_wasm_node_inventory_skip_L4_USER_M_PROCESS=1`;
|
||||
- `sim_configs_wasm_node_inventory_skip_NON_MAIN_CLASS=10`;
|
||||
- `sim_configs_wasm_node_inventory_skip_UPSTREAM_DEMO=1`;
|
||||
- 文档记录关键 generated artifacts:
|
||||
- `summary.tsv`;
|
||||
- `skip-summary.tsv`;
|
||||
- `boundary-summary.tsv`;
|
||||
- `blocked-dependency-summary.tsv`;
|
||||
- `full-process-boundary-summary.tsv`;
|
||||
- `python-remap-boundary-summary.tsv`;
|
||||
- `runtime-boundary-promotion-blockers.tsv`;
|
||||
- `runtime-boundary-host-readiness-rollup.tsv`;
|
||||
- `runtime-boundary-opt-in-probe-dispatch-rollup.tsv`;
|
||||
- 文档明确 artifact reason 与 shell metric suffix 的映射:
|
||||
- `ASSET-ONLY` -> `ASSET_ONLY`;
|
||||
- `L4-PYTHON-REMAP` -> `L4_PYTHON_REMAP`;
|
||||
- `L4-TOOL-DB` -> `L4_TOOL_DB`;
|
||||
- `L4-USER-M-PROCESS` -> `L4_USER_M_PROCESS`;
|
||||
- `NON_MAIN_CLASS` -> `NON_MAIN_CLASS`;
|
||||
- `UPSTREAM-DEMO` -> `UPSTREAM_DEMO`;
|
||||
- 文档记录 release promotion policy:
|
||||
- 必须有 LinuxCNC-owned runtime proof;
|
||||
- native proof 先通过;
|
||||
- Node/WASM proof 后通过;
|
||||
- browser/host proof 最后通过;
|
||||
- standalone CNC semantics guard 仍通过;
|
||||
- generated inventory artifacts 与 docs 一致;
|
||||
- 文档重申不得从 JS glue promotion:
|
||||
- `L4-PYTHON-REMAP`;
|
||||
- `L4-TOOL-DB`;
|
||||
- `L4-USER-M-PROCESS`;
|
||||
- 文档记录 sim-config coverage release gate 与 host aggregate 必须输出;
|
||||
- 文档记录 blocked runtime opt-in probes 仍非当前 release gate;
|
||||
- 新增 `wasm-port/tests/docs/node/verify_sim_configs_coverage_docs.mjs`;
|
||||
- 新增 `wasm-port/tests/docs/node/verify_sim_configs_coverage_docs.sh`;
|
||||
- docs smoke 覆盖:
|
||||
- handoff 文档存在;
|
||||
- inventory baseline 输出;
|
||||
- skip reason map;
|
||||
- artifact path;
|
||||
- standalone CNC semantics guard;
|
||||
- blocked runtime family;
|
||||
- matrix/completion-plan/tracker/host gate 交叉引用;
|
||||
- 若 `skip-summary.tsv` 已存在,则校验当前 skip reason counts;
|
||||
- `wasm-port/README.md` 增加 `docs/sim-configs-coverage-handoff.md` 项目级入口;
|
||||
- `wasm-port/tests/host/verify_host_smokes.sh` 纳入
|
||||
`wasm-port/tests/docs/node/verify_sim_configs_coverage_docs.sh`;
|
||||
- `PROJECT_COMPLETION_TRACKER.md` 同步当前完成批次与下一步 host/runtime boundary reports;
|
||||
- 未新增控制按钮;
|
||||
- 未执行 action-plan;
|
||||
- 未解析 G-code;
|
||||
- 未解释 canonical events;
|
||||
- 未新增 JS CNC 语义;
|
||||
- 未 promotion blocked runtime family;
|
||||
- 未改变 LinuxCNC interpreter、tool、parameter、planner、kinematics、remap 或 LinuxCNC-owned
|
||||
runtime semantics。
|
||||
|
||||
验证已通过:
|
||||
|
||||
```bash
|
||||
git diff --check
|
||||
wasm-port/tools/verify_vendor_sync.sh
|
||||
wasm-port/tools/verify_no_standalone_cnc_semantics.sh
|
||||
SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
|
||||
wasm-port/tests/docs/node/verify_sim_configs_coverage_docs.sh
|
||||
wasm-port/tests/docs/node/verify_opfs_session_docs.sh
|
||||
wasm-port/tests/sdk/node/verify_sdk_surface.sh
|
||||
wasm-port/tests/ui/node/verify_ui_node_smokes.sh
|
||||
SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_interp_wasm.sh
|
||||
SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_ini_panel_browser.sh
|
||||
wasm-port/tests/host/verify_host_smokes.sh
|
||||
```
|
||||
|
||||
关键输出:
|
||||
|
||||
```text
|
||||
sim_configs_coverage_docs_node_smoke=ok
|
||||
opfs_session_docs_node_smoke=ok
|
||||
sdk_surface_node_smoke=ok
|
||||
ini_panel_ui_shell_node_smoke=ok
|
||||
ini_panel_launch_api_manifest_node_smoke=ok
|
||||
ini_panel_shell_integration_manifest_node_smoke=ok
|
||||
ini_panel_entry_docs_node_smoke=ok
|
||||
ui_node_smokes=ok
|
||||
browser_ini_opfs_smoke=ok
|
||||
browser_ini_control_page_smoke=ok
|
||||
browser_ini_launch_smoke=ok
|
||||
browser_ini_workflow_overview_smoke=ok
|
||||
browser_ini_shell_integration_workflow_smoke=ok
|
||||
vendor sync up to date
|
||||
standalone CNC semantics guard complete
|
||||
interp_wasm_node_smoke=ok
|
||||
sim_configs_wasm_node_inventory_executed=28
|
||||
sim_configs_wasm_node_inventory_passed=28
|
||||
sim_configs_wasm_node_inventory_skipped=131
|
||||
sim_configs_wasm_node_inventory_unexpected_fail=0
|
||||
sim_configs_wasm_node_inventory_skip_ASSET_ONLY=65
|
||||
sim_configs_wasm_node_inventory_skip_L4_PYTHON_REMAP=53
|
||||
sim_configs_wasm_node_inventory_skip_L4_TOOL_DB=1
|
||||
sim_configs_wasm_node_inventory_skip_L4_USER_M_PROCESS=1
|
||||
sim_configs_wasm_node_inventory_skip_NON_MAIN_CLASS=10
|
||||
sim_configs_wasm_node_inventory_skip_UPSTREAM_DEMO=1
|
||||
host_wasm_opfs_browser_smokes=ok
|
||||
```
|
||||
|
||||
下一步工作计划:
|
||||
|
||||
继续推进 host/runtime boundary reports 与最终 release-gate 文档收口。下一批建议新增或收敛
|
||||
host/runtime boundary handoff 文档/测试,聚合 blocked runtime family 的 host readiness、
|
||||
promotion blockers、opt-in probe dispatch/skip evidence、native evidence acceptance gate,以及
|
||||
当前 host 为什么保持 `blocked_missing_host_runtime`;仍不运行 opt-in runtime probes,不 promotion
|
||||
`L4-USER-M-PROCESS`、`L4-TOOL-DB`、`L4-PYTHON-REMAP`。
|
||||
|
||||
Reference in New Issue
Block a user