补充 project release handoff 文档
This commit is contained in:
96
text14.txt
96
text14.txt
@@ -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。
|
||||
|
||||
Reference in New Issue
Block a user