补充 OPFS session persistence release gate 文档

PROJECT_COMPLETION_TRACKER.md

@@ -9,7 +9,7 @@ turn-by-turn continuation notes and next-batch execution records.
 ## Current Status
 
 - Active continuation file: `text14.txt`
-- Latest completed batch: SDK/API surface exports and smoke
+- Latest completed batch: OPFS/session persistence release-gate 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`. |
 | 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 and SDK re-exports OPFS/session helpers; final project needs explicit project-level summary/report. |
+| 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 below remain blocked. |
-| Documentation/release gate | In progress | `text14.txt` has roadmap; README/docs final pass still pending. |
+| Documentation/release gate | In progress | OPFS/session release gate is documented and smoke-tested; sim-config coverage and final README/docs pass still pending. |
 
 ## Blocked Runtime Families
 
@@ -74,7 +74,7 @@ Execute these in order unless a later user request explicitly changes priority.
 
 Current next task:
 
-- Add project-level OPFS/session persistence summary and release-gate documentation.
+- Consolidate sim-config coverage/release-gate docs and machine-readable skip reason handoff.
 
 Then complete the closure:
 
@@ -121,17 +121,19 @@ Completion criteria:
 
 Work items:
 
-- Add a project-level OPFS/session workflow summary helper or report.
+- Add a project-level OPFS/session workflow summary helper or report. Done as `docs/opfs-session-persistence.md`.
 - Include machine files, session snapshot, readonly control status, and handoff
-  readiness.
+  readiness. Done through linked UI docs plus browser and host gate references.
 - Add browser smoke coverage for save -> restore -> readonly status -> shell
-  handoff.
-- Document OPFS scope and failure modes.
+  handoff. Existing browser smoke remains the gate for this workflow.
+- Document OPFS scope and failure modes. Done.
+- Add docs smoke for the project-level handoff. Done via `tests/docs/node/verify_opfs_session_docs.sh`.
 
 Completion criteria:
 
 - `browser_ini_opfs_smoke=ok` remains stable.
 - External callers can inspect persistence readiness and failures.
+- `opfs_session_docs_node_smoke=ok` is included in the host aggregate gate.
 
 ### 4. Sim Config Coverage Promotion Matrix