推进 SDK API surface exports and smoke

This commit is contained in:
2026-06-15 22:24:17 +08:00
parent b771ee4141
commit f3d8955fd7
7 changed files with 425 additions and 9 deletions

View File

@@ -9,7 +9,7 @@ turn-by-turn continuation notes and next-batch execution records.
## Current Status
- Active continuation file: `text14.txt`
- Latest completed batch: workflow overview embedding mount DOM mount wrapper
- Latest completed batch: SDK/API surface exports and smoke
- 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,9 +41,9 @@ 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; final project needs explicit project-level summary/report. |
| SDK/API surface | In progress | Many UI helpers exist; final project needs SDK export/readme consolidation. |
| Browser/UI workflow | In progress | Current focus: workflow overview embedding mount DOM closure and SDK/API handoff. |
| OPFS/session persistence | In progress | Browser smoke passes and SDK re-exports OPFS/session helpers; final project needs explicit project-level summary/report. |
| 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. |
@@ -74,7 +74,7 @@ Execute these in order unless a later user request explicitly changes priority.
Current next task:
- Audit and consolidate SDK/API exports for stable external callers.
- Add project-level OPFS/session persistence summary and release-gate documentation.
Then complete the closure:
@@ -106,10 +106,10 @@ Completion criteria:
Work items:
- Audit `runtime/sdk/src/index.js`.
- Export stable helpers that external callers should use.
- Add or update SDK smoke for export shape and manifest compatibility.
- Update `runtime/sdk/README.md` with usage examples and unsupported areas.
- Audit `runtime/sdk/src/index.js`. Done.
- Export stable helpers that external callers should use. Done for core, OPFS/session, sim-config staging, and INI panel shell/workflow overview helpers.
- Add or update SDK smoke for export shape and manifest compatibility. Done via `tests/sdk/node/verify_sdk_surface.sh`.
- Update `runtime/sdk/README.md` with usage examples and unsupported areas. Initial SDK surface update done; final docs pass still pending.
Completion criteria: