补充 host runtime boundary release gate 文档
This commit is contained in:
146
text14.txt
146
text14.txt
@@ -1253,3 +1253,149 @@ host/runtime boundary handoff 文档/测试,聚合 blocked runtime family 的
|
||||
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`。
|
||||
|
||||
十五、2026-06-15 继续执行记录:host/runtime boundary release-gate docs
|
||||
|
||||
本轮按 `text14.txt` 执行,继续推进 host/runtime boundary reports 与最终 release-gate 文档收口。
|
||||
新增短版 host/runtime boundary handoff 文档与 docs smoke,聚合 blocked runtime family 的 host
|
||||
readiness、promotion blockers、opt-in probe dispatch/skip evidence、native evidence acceptance gate,
|
||||
并明确当前 host 为什么保持 blocked。
|
||||
|
||||
完成内容:
|
||||
|
||||
- 新增 `wasm-port/docs/host-runtime-boundary-handoff.md`;
|
||||
- 文档记录当前 blocked runtime families:
|
||||
- `L4-USER-M-PROCESS`;
|
||||
- `L4-TOOL-DB`;
|
||||
- `L4-PYTHON-REMAP`;
|
||||
- 文档记录关键 generated artifacts:
|
||||
- `runtime-boundary-host-readiness-rollup.tsv`;
|
||||
- `runtime-boundary-promotion-blockers.tsv`;
|
||||
- `runtime-boundary-opt-in-probe-dispatch-rollup.tsv`;
|
||||
- `runtime-boundary-native-evidence-acceptance-gate.tsv`;
|
||||
- `runtime-boundary-opt-in-probe-skip-evidence-rollup.tsv`;
|
||||
- `blocked-runtime-promotion-lock.tsv`;
|
||||
- 文档固定当前 host readiness rollup:
|
||||
- `host_readiness_status=host_blocked_for_all_opt_in_native_probes`;
|
||||
- `family_count=3`;
|
||||
- `host_ready_family_count=0`;
|
||||
- `host_blocked_family_count=3`;
|
||||
- `blocked_families=L4-PYTHON-REMAP,L4-TOOL-DB,L4-USER-M-PROCESS`;
|
||||
- `missing_host_requirements=halcmd,halrun,linuxcnc,milltask`;
|
||||
- `ready_opt_in_command_count=0`;
|
||||
- `execution_enabled=0`;
|
||||
- `promotion_allowed=0`;
|
||||
- 文档记录 current promotion blockers:
|
||||
- `host_runtime_requirements_missing`;
|
||||
- `native_runtime_probe_not_passed`;
|
||||
- `native_pass_evidence_not_ready`;
|
||||
- `node_inventory_gate_not_complete`;
|
||||
- `browser_smoke_gate_not_complete`;
|
||||
- `promotion_lock_active`;
|
||||
- `manual_lock_update_required`;
|
||||
- 文档固定 opt-in probe dispatch state:
|
||||
- `dispatch_status=dispatch_blocked_for_all_opt_in_native_probes`;
|
||||
- `probe_count=3`;
|
||||
- `dispatch_allowed_count=0`;
|
||||
- `dispatch_blocked_count=3`;
|
||||
- `dispatch_actions=skip_missing_host_requirements`;
|
||||
- `execution_enabled=0`;
|
||||
- `promotion_allowed=0`;
|
||||
- 文档记录仍 blocked 的 opt-in probe commands:
|
||||
- `ENABLE_MILLTURN_USER_M_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_millturn_user_m_runtime.sh`;
|
||||
- `ENABLE_TOOL_DB_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_tool_db_runtime.sh`;
|
||||
- `ENABLE_PYTHON_REMAP_RUNTIME_PROBE=1 bash wasm-port/tests/native/probe_python_remap_runtime.sh`;
|
||||
- 文档记录 native evidence acceptance gate 当前状态:
|
||||
- `current_probe_status=skipped_missing_host_runtime`;
|
||||
- `native_evidence_status=pending_until_native_pass`;
|
||||
- `skip_evidence_status=skip_valid_until_host_requirements_available`;
|
||||
- `node_gate_status=blocked_until_native_pass_evidence`;
|
||||
- `browser_gate_status=blocked_until_node_gate_complete`;
|
||||
- `native_evidence_gate=blocked_until_host_requirements_available`;
|
||||
- `evidence_acceptance_allowed=0`;
|
||||
- 文档明确 skipped opt-in probe 不是 native pass,只证明当前 host 正确 blocked;
|
||||
- 文档记录 release gate 与 promotion rule;
|
||||
- 新增 `wasm-port/tests/docs/node/verify_host_runtime_boundary_docs.mjs`;
|
||||
- 新增 `wasm-port/tests/docs/node/verify_host_runtime_boundary_docs.sh`;
|
||||
- docs smoke 覆盖:
|
||||
- handoff 文档存在;
|
||||
- host readiness artifact;
|
||||
- promotion blocker artifact;
|
||||
- opt-in dispatch artifact;
|
||||
- native evidence acceptance artifact;
|
||||
- blocked runtime family;
|
||||
- blocked opt-in commands;
|
||||
- full-process docs、sim-config handoff、inventory test、README、tracker、host gate 交叉引用;
|
||||
- 若 generated host readiness / dispatch rollup artifacts 已存在,则校验当前 blocked 状态;
|
||||
- `wasm-port/README.md` 增加 `docs/host-runtime-boundary-handoff.md` 项目级入口;
|
||||
- `wasm-port/tests/host/verify_host_smokes.sh` 纳入
|
||||
`wasm-port/tests/docs/node/verify_host_runtime_boundary_docs.sh`;
|
||||
- `PROJECT_COMPLETION_TRACKER.md` 同步当前完成批次与下一步最终 README/docs acceptance checklist;
|
||||
- 修正 `verify_sim_configs_coverage_docs.mjs` 对 tracker 文案的断言,使其接受当前
|
||||
`Sim config coverage` 表述;
|
||||
- 未新增控制按钮;
|
||||
- 未执行 action-plan;
|
||||
- 未解析 G-code;
|
||||
- 未解释 canonical events;
|
||||
- 未新增 JS CNC 语义;
|
||||
- 未运行 opt-in runtime probes;
|
||||
- 未 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_host_runtime_boundary_docs.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
|
||||
host_runtime_boundary_docs_node_smoke=ok
|
||||
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
|
||||
```
|
||||
|
||||
下一步工作计划:
|
||||
|
||||
继续推进最终 README/docs acceptance checklist 与项目完成 handoff。下一批建议刷新
|
||||
`wasm-port/README.md`、`PROJECT_COMPLETION_TRACKER.md` 和必要 docs 索引,形成新接手者不阅读
|
||||
`text1` 到 `text13` 也能完成验证的最终路径;重点是收敛 required gates、supported workflows、
|
||||
blocked runtime families、SDK/API surface 与 browser/UI workflow 入口,不新增功能或 CNC 语义。
|
||||
|
||||
Reference in New Issue
Block a user