wangdequan/cnc_wams
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

补充 project release handoff 文档

Browse Source
This commit is contained in:
wangdequan
2026-06-16 04:11:55 +08:00
parent 67a4a69698
commit 5918a3c573
10 changed files with 380 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
PROJECT_COMPLETION_TRACKER.md
View File

@@ -1,6 +1,6 @@
# Project Completion Tracker
Last updated: 2026-06-15 CST
Last updated: 2026-06-16 CST
This file tracks the overall completion state of the LinuxCNC WASM/browser port.
Use it for project-level status and acceptance tracking. Use `text14.txt` for
@@ -9,7 +9,7 @@ turn-by-turn continuation notes and next-batch execution records.
## Current Status
- Active continuation file: `text14.txt`
- Latest completed batch: host/runtime boundary release-gate docs
- Latest completed batch: project release handoff docs
- Latest relevant commit: use `git log -1 --oneline` after each committed batch
- Working tree at tracker creation: clean
- Required policy: LinuxCNC remains the only CNC semantic source
@@ -41,12 +41,12 @@ The project is complete for the current scope when all of the following are true
| Sim config inventory | Stable with skips | `executed=28`, `passed=28`, `skipped=131`, `unexpected_fail=0`; `docs/sim-configs-coverage-handoff.md` records the release-gate baseline. |
| Native nc_files baseline | Stable | Last recorded Layer 1: `total 107`, `pass 101`, `expected_fail 6`, `unexpected_fail 0`. |
| Native sim configs baseline | Stable | Last recorded Layer 2: `total 159`, `pass 151`, `expected_fail 8`, `unexpected_fail 0`. |
| OPFS/session persistence | In progress | Browser smoke passes, SDK re-exports OPFS/session helpers, and `docs/opfs-session-persistence.md` defines the project-level release gate. |
| SDK/API surface | In progress | SDK re-exports core, OPFS/session, sim-config staging, and INI panel shell/workflow overview helpers with a Node surface smoke. |
| Browser/UI workflow | In progress | Workflow overview embedding mount DOM closure is complete; current focus is SDK/docs/release gate consolidation. |
| Workflow overview embedding | In progress | Report/display/render, DOM contract/readiness/renderer, mount result/display/render, mount DOM contract/readiness/renderer/wrapper exist. |
| Host/runtime boundary proof | In progress | Host smoke passes; runtime families remain blocked and `docs/host-runtime-boundary-handoff.md` records host readiness, promotion blockers, dispatch, and evidence gates. |
| Documentation/release gate | In progress | OPFS/session, sim-config, and host/runtime release gates are documented and smoke-tested; final README/docs pass still pending. |
| OPFS/session persistence | Stable for current scope | Browser smoke passes, SDK re-exports OPFS/session helpers, and `docs/opfs-session-persistence.md` defines the project-level release gate. |
| SDK/API surface | Stable for current scope | SDK re-exports core, OPFS/session, sim-config staging, and INI panel shell/workflow overview helpers with a Node surface smoke. |
| Browser/UI workflow | Stable for current scope | Workflow overview embedding mount DOM closure is complete and documented for external shells. |
| Workflow overview embedding | Stable for current scope | Report/display/render, DOM contract/readiness/renderer, mount result/display/render, mount DOM contract/readiness/renderer/wrapper exist. |
| Host/runtime boundary proof | Stable blocked state | Host smoke passes; runtime families remain blocked and `docs/host-runtime-boundary-handoff.md` records host readiness, promotion blockers, dispatch, and evidence gates. |
| Documentation/release gate | Stable for current scope | `docs/project-release-handoff.md` links README, panel entry, SDK, OPFS/session, sim-config, host/runtime, source reuse, drift, and tracker acceptance paths. |
## Blocked Runtime Families
@@ -74,7 +74,9 @@ Execute these in order unless a later user request explicitly changes priority.
Current next task:
- Refresh final README/docs acceptance checklist and project completion handoff.
- Run the final required gate set from `docs/project-release-handoff.md`, keep
the working tree clean, and add the final `text14.txt` completion record if
all gates pass.
Then complete the closure:
@@ -176,16 +178,21 @@ Completion criteria:
Work items:
- Update `README.md`.
- Update `docs/panel-entry.md`.
- Update `docs/source-reuse-map.md`.
- Update `docs/drift-report.md`.
- Add or refresh final acceptance checklist.
- Update `README.md`. Done.
- Update `docs/panel-entry.md`. Done.
- Update `docs/source-reuse-map.md`. Done.
- Update `docs/drift-report.md`. Done.
- Add or refresh final acceptance checklist. Done via
`docs/project-release-handoff.md`.
- Add docs smoke for project release handoff. Done via
`tests/docs/node/verify_project_release_handoff_docs.sh`.
Completion criteria:
- A new developer can run validation from README/docs without reading old
`text1` through `text13`.
- `project_release_handoff_docs_node_smoke=ok` is included in the host
aggregate gate.
## Required Gates
@@ -228,4 +235,5 @@ wasm-port/tests/native/verify_sim_configs.sh
- [ ] Browser INI panel smoke passes.
- [ ] Host aggregate smoke passes.
- [ ] Runtime blocked families remain documented.
- [ ] Project release handoff docs smoke passes.
- [ ] README/docs explain supported workflows and blocked items.