补充 project release handoff 文档

This commit is contained in:
2026-06-16 04:11:55 +08:00
parent 67a4a69698
commit 5918a3c573
10 changed files with 380 additions and 14 deletions

View File

@@ -1399,3 +1399,99 @@ host_wasm_opfs_browser_smokes=ok
`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 语义。
十六、2026-06-16 继续执行记录project release handoff docs
本轮按 `text14.txt` 执行,推进最终 README/docs acceptance checklist 与项目完成 handoff。
新增项目级 release handoff 文档和 docs smoke把 README、panel entry、SDK、OPFS/session、
sim-config coverage、host/runtime boundary、source reuse、drift report 与 tracker 串成新接手者可直接
执行的验收路径。
完成内容:
- 新增 `wasm-port/docs/project-release-handoff.md`
- 新增 `wasm-port/tests/docs/node/verify_project_release_handoff_docs.mjs`
- 新增 `wasm-port/tests/docs/node/verify_project_release_handoff_docs.sh`
- `wasm-port/README.md` 增加当前 release handoff 入口、最小 release validation commands、
expected handoff smoke outputs、browser/UI 与 SDK 入口;
- `wasm-port/docs/panel-entry.md` 增加项目级 handoff 入口、SDK 稳定导入说明、
workflow overview embedding helpers 概括与 release validation 引用;
- `wasm-port/docs/source-reuse-map.md` 增加 project release handoff 交叉引用;
- `wasm-port/docs/drift-report.md` 增加 project release handoff 交叉引用;
- `wasm-port/tests/host/verify_host_smokes.sh` 纳入
`wasm-port/tests/docs/node/verify_project_release_handoff_docs.sh`
- `PROJECT_COMPLETION_TRACKER.md` 同步:
- latest completed batch 更新为 `project release handoff docs`
- OPFS/session persistence、SDK/API surface、Browser/UI workflow、Workflow overview embedding、
Documentation/release gate 标记为 current scope stable
- Host/runtime boundary proof 标记为 stable blocked state
- Documentation/Release Gate 工作项标记完成;
- Final Acceptance Checklist 增加 project release handoff docs smoke
- 当前下一步收敛为 final required gate set、clean working tree 与最终 completion record
- 未新增控制按钮;
- 未执行 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_interp_wasm.sh
SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
wasm-port/tests/docs/node/verify_project_release_handoff_docs.sh
wasm-port/tests/docs/node/verify_opfs_session_docs.sh
wasm-port/tests/docs/node/verify_sim_configs_coverage_docs.sh
wasm-port/tests/docs/node/verify_host_runtime_boundary_docs.sh
wasm-port/tests/sdk/node/verify_sdk_surface.sh
wasm-port/tests/ui/node/verify_ini_panel_entry_docs.sh
wasm-port/tests/ui/node/verify_ui_node_smokes.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
project_release_handoff_docs_node_smoke=ok
opfs_session_docs_node_smoke=ok
sim_configs_coverage_docs_node_smoke=ok
host_runtime_boundary_docs_node_smoke=ok
sdk_surface_node_smoke=ok
ini_panel_entry_docs_node_smoke=ok
ui_node_smokes=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
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
browser_interp_smoke=ok
host_wasm_opfs_browser_smokes=ok
```
下一步工作计划:
进入最终 clean-tree acceptance closeout。下一批建议在本批提交后从 clean working tree 重新执行
`docs/project-release-handoff.md` 的最小 release validation commands若全部通过则把
`PROJECT_COMPLETION_TRACKER.md` 的 Final Acceptance Checklist 勾选为当前 scope complete并在
`text14.txt` 追加最终完成记录。仍不新增功能、不扩大 CNC 语义、不 promotion blocked runtime family。