From e1029ede0ffb97cebfab10e733579fa376b038ba Mon Sep 17 00:00:00 2001 From: wangdequan Date: Mon, 15 Jun 2026 10:40:37 +0800 Subject: [PATCH] =?UTF-8?q?=E6=8E=A8=E8=BF=9B=20INI=20=E9=9D=A2=E6=9D=BF?= =?UTF-8?q?=20shell=20handoff=20package=20report?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- text13.txt | 106 ++++++++++++++++++ wasm-port/docs/panel-entry.md | 6 + wasm-port/runtime/ui/ini-panel/launch.html | 1 + wasm-port/runtime/ui/ini-panel/ui-shell.js | 87 ++++++++++++++ .../tests/browser/ini_panel_launch_smoke.html | 19 +++- ...anel_shell_integration_workflow_smoke.html | 5 + .../ui/node/verify_ini_panel_entry_docs.mjs | 11 ++ .../verify_ini_panel_launch_api_manifest.mjs | 2 + ...y_ini_panel_shell_integration_manifest.mjs | 97 +++++++++++++++- .../ui/node/verify_ini_panel_ui_shell.mjs | 59 ++++++++++ 10 files changed, 389 insertions(+), 4 deletions(-) diff --git a/text13.txt b/text13.txt index efb486e..1e4bdd3 100644 --- a/text13.txt +++ b/text13.txt @@ -1007,3 +1007,109 @@ host_wasm_opfs_browser_smokes=ok missing package fields、missing manifest fields、version/apiName mismatch 和 checklist blocking reasons 合并成 display-ready report，便于外部 shell 在拒绝 package 时显示原因；仍保持只读， 不新增控制按钮，不解析 G-code。 + +九、2026-06-15 继续执行记录：INI panel shell handoff package report + +本轮按“第一原则：加快实质性推进”继续推进 browser/UI workflow 与文档化可执行工作流， +新增只读 shell handoff package report，把 package schema support、缺失字段、版本/API mismatch +和 checklist blocking reasons 合并成外部 shell 可直接显示的诊断。 + +完成内容： + +- `ui-shell.js` 新增 `createIniPanelShellSessionHandoffPackageReport()`； +- package report 输出： + - `apiName: "ini-panel-shell-session-handoff-package-report"`； + - `reportVersion: 1`； + - `phase`； + - `ready`； + - `packageSupported`； + - `packageReady`； + - `statusLine`； + - `schema`； + - `package`； + - `missingPackageFields`； + - `missingManifestFields`； + - `mismatchFields`； + - `blockingReasons`； + - `rows`； +- report rows 固定覆盖： + - `package-supported`； + - `package-ready`； + - `missing-package-fields`； + - `missing-manifest-fields`； + - `mismatch-fields`； + - `blocking-reasons`； +- `createIniPanelShellViewModel()` 新增： + - `shellSessionHandoffPackageReport`； + - `createShellSessionHandoffPackageReport`； +- `createIniPanelLaunchApiManifest().methods` 新增 + `getShellSessionHandoffPackageReport`； +- `launch.html` 的 `window.linuxCncIniPanelLaunchApi` 新增真实 browser 入口 + `getShellSessionHandoffPackageReport()`； +- `ini_panel_launch_smoke.html` 校验真实 launch iframe： + - package report `ready === true`； + - report rows 数量为 6； + - 当前 report 无 missing package fields； +- `ini_panel_shell_integration_workflow_smoke.html` 校验外部 shell workflow 能读取 + package report，并确认 package supported 与 report rows； +- `verify_ini_panel_shell_integration_manifest.mjs` 覆盖： + - ready package report 完整 shape； + - version mismatch 输出 `mismatchFields`； + - 缺 manifest field 输出 `missingManifestFields`； + - null package 输出全部 missing package fields； +- `verify_ini_panel_ui_shell.mjs` 覆盖 shell view-model 的 package report 聚合关系； +- `verify_ini_panel_launch_api_manifest.mjs`、`verify_ini_panel_entry_docs.mjs` 与 + `docs/panel-entry.md` 同步记录和校验新 helper/API； +- 未新增控制按钮； +- 未执行 action-plan； +- 未解析 G-code； +- 未解释 canonical events； +- 未新增 JS CNC 语义； +- 未改变 OPFS/session persistence、LinuxCNC interpreter、tool、parameter、planner 或 + LinuxCNC-owned runtime semantics。 + +验证已通过： + +```bash +git diff --check +wasm-port/tests/ui/node/verify_ini_panel_shell_integration_manifest.sh +wasm-port/tests/ui/node/verify_ini_panel_launch_api_manifest.sh +wasm-port/tests/ui/node/verify_ini_panel_ui_shell.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/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/host/verify_host_smokes.sh +``` + +关键输出： + +```text +ini_panel_shell_integration_manifest_node_smoke=ok +ini_panel_launch_api_manifest_node_smoke=ok +ini_panel_ui_shell_node_smoke=ok +ini_panel_entry_docs_node_smoke=ok +ui_node_smokes=ok +browser_ini_opfs_smoke=ok +browser_ini_control_page_smoke=ok +browser_ini_launch_smoke=ok +browser_ini_shell_integration_workflow_smoke=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 +host_wasm_opfs_browser_smokes=ok +``` + +下一步建议： + +继续推进 browser/UI workflow。下一批建议新增一个只读 +`createIniPanelShellSessionHandoffPackageDisplayViewModel()` 或等价 helper，把 package report +压成稳定 label/value rows 与 status text，供 launch 页面或外部 shell 直接渲染 package report； +仍保持只读，不新增控制按钮，不解析 G-code。 diff --git a/wasm-port/docs/panel-entry.md b/wasm-port/docs/panel-entry.md index f234f33..3a82bd8 100644 --- a/wasm-port/docs/panel-entry.md +++ b/wasm-port/docs/panel-entry.md @@ -26,6 +26,7 @@ import { createIniPanelShellSessionHandoffCompatibilityReport, createIniPanelShellSessionHandoffDisplayViewModel, createIniPanelShellSessionHandoffPackage, + createIniPanelShellSessionHandoffPackageReport, createIniPanelShellSessionHandoffPackageSchema, createIniPanelShellSessionHandoffRenderState, createIniPanelShellSessionHandoffSnapshot, @@ -192,6 +193,11 @@ Use `createIniPanelShellSessionHandoffPackageSchema()` or versioned package shape, and `isSupportedIniPanelShellSessionHandoffPackage()` or `linuxCncIniPanelLaunchApi.isSupportedShellSessionHandoffPackage()` before consuming a package from a browser shell. +Use `createIniPanelShellSessionHandoffPackageReport()` or +`linuxCncIniPanelLaunchApi.getShellSessionHandoffPackageReport()` when an outer +shell needs display-ready diagnostics for package schema support, missing +package fields, missing manifest fields, api/version mismatches, and checklist +blocking reasons. The browser workflow smoke `tests/browser/ini_panel_shell_integration_workflow_smoke.html` verifies the same external shell handoff: read integration manifest, pass readiness gate, diff --git a/wasm-port/runtime/ui/ini-panel/launch.html b/wasm-port/runtime/ui/ini-panel/launch.html index 67b496b..3937c63 100644 --- a/wasm-port/runtime/ui/ini-panel/launch.html +++ b/wasm-port/runtime/ui/ini-panel/launch.html @@ -148,6 +148,7 @@ getShellSessionHandoffChecklist: () => shellViewModel.shellSessionHandoffChecklist, getShellSessionHandoffPackageSchema: () => shellViewModel.shellSessionHandoffPackageSchema, getShellSessionHandoffPackage: () => shellViewModel.shellSessionHandoffPackage, + getShellSessionHandoffPackageReport: () => shellViewModel.shellSessionHandoffPackageReport, isSupportedShellSessionHandoffPackage: shellViewModel.isSupportedShellSessionHandoffPackage, getLauncherLinks: () => shellViewModel.launcherLinks, getControlPageApiMethods: () => shellViewModel.controlPage.browserApiMethods, diff --git a/wasm-port/runtime/ui/ini-panel/ui-shell.js b/wasm-port/runtime/ui/ini-panel/ui-shell.js index 0d65bac..d0a5126 100644 --- a/wasm-port/runtime/ui/ini-panel/ui-shell.js +++ b/wasm-port/runtime/ui/ini-panel/ui-shell.js @@ -137,6 +137,7 @@ export function createIniPanelLaunchApiManifest(entries = getVisibleIniPanelEntr "getShellSessionHandoffChecklist", "getShellSessionHandoffPackageSchema", "getShellSessionHandoffPackage", + "getShellSessionHandoffPackageReport", "isSupportedShellSessionHandoffPackage", "getLauncherLinks", "getControlPageApiMethods", @@ -793,6 +794,87 @@ export function isSupportedIniPanelShellSessionHandoffPackage( return schema.manifestFields.every((fieldName) => Object.hasOwn(manifests, fieldName)); } +export function createIniPanelShellSessionHandoffPackageReport( + handoffPackage = createIniPanelShellSessionHandoffPackage(), + schema = createIniPanelShellSessionHandoffPackageSchema(), +) { + const packageObject = handoffPackage && typeof handoffPackage === "object" ? handoffPackage : {}; + const manifests = packageObject.manifests && typeof packageObject.manifests === "object" + ? packageObject.manifests + : {}; + const missingPackageFields = schema.fields.filter((fieldName) => !Object.hasOwn(packageObject, fieldName)); + const missingManifestFields = schema.manifestFields.filter((fieldName) => !Object.hasOwn(manifests, fieldName)); + const mismatchFields = [ + ...(packageObject.apiName === schema.apiName ? [] : ["apiName"]), + ...(packageObject.packageVersion === schema.packageVersion ? [] : ["packageVersion"]), + ]; + const blockingReasons = Array.isArray(packageObject?.checklist?.blockingReasons) + ? [...packageObject.checklist.blockingReasons] + : []; + const packageSupported = missingPackageFields.length === 0 + && missingManifestFields.length === 0 + && mismatchFields.length === 0; + const ready = packageSupported && packageObject.ready === true && blockingReasons.length === 0; + + return { + apiName: "ini-panel-shell-session-handoff-package-report", + reportVersion: 1, + phase: ready ? "ready" : "blocked", + ready, + packageSupported, + packageReady: ready, + statusLine: packageObject.statusLine ?? (ready ? "Ready: No blocking reasons" : "Blocked: Package unsupported"), + schema: { + apiName: schema.apiName, + packageVersion: schema.packageVersion, + fields: [...schema.fields], + manifestFields: [...schema.manifestFields], + }, + package: { + apiName: packageObject.apiName ?? null, + packageVersion: packageObject.packageVersion ?? null, + phase: packageObject.phase ?? null, + ready: packageObject.ready ?? false, + }, + missingPackageFields, + missingManifestFields, + mismatchFields, + blockingReasons, + rows: [ + { + id: "package-supported", + label: "Package schema", + value: packageSupported ? "supported" : "blocked", + }, + { + id: "package-ready", + label: "Package readiness", + value: ready ? "ready" : "blocked", + }, + { + id: "missing-package-fields", + label: "Missing package fields", + value: missingPackageFields.length === 0 ? "none" : missingPackageFields.join(", "), + }, + { + id: "missing-manifest-fields", + label: "Missing manifest fields", + value: missingManifestFields.length === 0 ? "none" : missingManifestFields.join(", "), + }, + { + id: "mismatch-fields", + label: "Mismatched fields", + value: mismatchFields.length === 0 ? "none" : mismatchFields.join(", "), + }, + { + id: "blocking-reasons", + label: "Blocking reasons", + value: blockingReasons.length === 0 ? "none" : blockingReasons.join(", "), + }, + ], + }; +} + export function createIniPanelShellViewModel(entries = getVisibleIniPanelEntries()) { const shellIntegrationManifest = createIniPanelShellIntegrationManifest(entries); const shellIntegrationReadiness = createIniPanelShellIntegrationReadiness(shellIntegrationManifest); @@ -837,6 +919,9 @@ export function createIniPanelShellViewModel(entries = getVisibleIniPanelEntries actionPlan: shellSessionHandoffActionPlan, checklist: shellSessionHandoffChecklist, }); + const shellSessionHandoffPackageReport = createIniPanelShellSessionHandoffPackageReport( + shellSessionHandoffPackage, + ); return { pages: entries.map(({ id, href, title }) => ({ id, @@ -858,6 +943,7 @@ export function createIniPanelShellViewModel(entries = getVisibleIniPanelEntries shellSessionHandoffChecklist, shellSessionHandoffPackage, shellSessionHandoffPackageSchema: createIniPanelShellSessionHandoffPackageSchema(), + shellSessionHandoffPackageReport, launchApiSchema: createIniPanelLaunchApiSchema(), launchApiManifest: createIniPanelLaunchApiManifest(entries), isSupportedShellIntegrationManifest: isSupportedIniPanelShellIntegrationManifest, @@ -874,6 +960,7 @@ export function createIniPanelShellViewModel(entries = getVisibleIniPanelEntries createShellSessionHandoffChecklist: createIniPanelShellSessionHandoffChecklist, createShellSessionHandoffPackage: createIniPanelShellSessionHandoffPackage, createShellSessionHandoffPackageSchema: createIniPanelShellSessionHandoffPackageSchema, + createShellSessionHandoffPackageReport: createIniPanelShellSessionHandoffPackageReport, isSupportedShellSessionHandoffPackage: isSupportedIniPanelShellSessionHandoffPackage, controlPage: { browserApiSchema: createControlPageBrowserApiSchema(), diff --git a/wasm-port/tests/browser/ini_panel_launch_smoke.html b/wasm-port/tests/browser/ini_panel_launch_smoke.html index 3aadec7..44d5aa8 100644 --- a/wasm-port/tests/browser/ini_panel_launch_smoke.html +++ b/wasm-port/tests/browser/ini_panel_launch_smoke.html @@ -84,6 +84,7 @@ !launchApi?.getShellSessionHandoffChecklist || !launchApi?.getShellSessionHandoffPackageSchema || !launchApi?.getShellSessionHandoffPackage || + !launchApi?.getShellSessionHandoffPackageReport || !launchApi?.isSupportedShellSessionHandoffPackage || !launchApi?.getLauncherLinks || !launchApi?.getControlPageApiMethods @@ -124,7 +125,7 @@ ); assertEqual( launchApiManifest.methods.join(","), - "isSupportedLaunchApiManifest,getLaunchApiSchema,getLaunchApiManifest,getShellIntegrationSchema,getShellIntegrationManifest,getShellIntegrationReadiness,getShellSessionHandoffSummarySchema,getShellSessionHandoffSummary,isSupportedShellSessionHandoffSummary,getShellSessionHandoffCompatibilityReport,getShellSessionHandoffDisplayViewModel,getShellSessionHandoffSnapshot,getShellSessionHandoffRenderState,getShellSessionHandoffActionPlan,getShellSessionHandoffChecklist,getShellSessionHandoffPackageSchema,getShellSessionHandoffPackage,isSupportedShellSessionHandoffPackage,getLauncherLinks,getControlPageApiMethods", + "isSupportedLaunchApiManifest,getLaunchApiSchema,getLaunchApiManifest,getShellIntegrationSchema,getShellIntegrationManifest,getShellIntegrationReadiness,getShellSessionHandoffSummarySchema,getShellSessionHandoffSummary,isSupportedShellSessionHandoffSummary,getShellSessionHandoffCompatibilityReport,getShellSessionHandoffDisplayViewModel,getShellSessionHandoffSnapshot,getShellSessionHandoffRenderState,getShellSessionHandoffActionPlan,getShellSessionHandoffChecklist,getShellSessionHandoffPackageSchema,getShellSessionHandoffPackage,getShellSessionHandoffPackageReport,isSupportedShellSessionHandoffPackage,getLauncherLinks,getControlPageApiMethods", "launch API manifest methods", ); const shellIntegrationSchema = launchApi.getShellIntegrationSchema(); @@ -140,6 +141,7 @@ const shellSessionHandoffChecklist = launchApi.getShellSessionHandoffChecklist(); const shellSessionHandoffPackageSchema = launchApi.getShellSessionHandoffPackageSchema(); const shellSessionHandoffPackage = launchApi.getShellSessionHandoffPackage(); + const shellSessionHandoffPackageReport = launchApi.getShellSessionHandoffPackageReport(); assertEqual( shellIntegrationSchema.manifestVersion, 1, @@ -310,6 +312,21 @@ false, "shell session handoff package rejects version", ); + assertEqual( + shellSessionHandoffPackageReport.ready, + true, + "shell session handoff package report readiness", + ); + assertEqual( + shellSessionHandoffPackageReport.rows.length, + 6, + "shell session handoff package report rows", + ); + assertEqual( + shellSessionHandoffPackageReport.missingPackageFields.join(","), + "", + "shell session handoff package report missing fields", + ); assertEqual( shellSessionHandoffPackage.ready, true, diff --git a/wasm-port/tests/browser/ini_panel_shell_integration_workflow_smoke.html b/wasm-port/tests/browser/ini_panel_shell_integration_workflow_smoke.html index b6c624e..843bb75 100644 --- a/wasm-port/tests/browser/ini_panel_shell_integration_workflow_smoke.html +++ b/wasm-port/tests/browser/ini_panel_shell_integration_workflow_smoke.html @@ -75,6 +75,7 @@ TOOL_TABLE = browser-shell-tool.tbl !launchApi?.getShellSessionHandoffChecklist || !launchApi?.getShellSessionHandoffPackageSchema || !launchApi?.getShellSessionHandoffPackage || + !launchApi?.getShellSessionHandoffPackageReport || !launchApi?.isSupportedShellSessionHandoffPackage ) { throw new Error("launch API namespace did not expose shell integration helpers"); @@ -92,6 +93,7 @@ TOOL_TABLE = browser-shell-tool.tbl const handoffChecklist = launchApi.getShellSessionHandoffChecklist(); const handoffPackageSchema = launchApi.getShellSessionHandoffPackageSchema(); const handoffPackage = launchApi.getShellSessionHandoffPackage(); + const handoffPackageReport = launchApi.getShellSessionHandoffPackageReport(); assertEqual(handoffSummarySchema.summaryVersion, 1, "shell handoff summary schema version"); assertEqual( launchApi.isSupportedShellSessionHandoffSummary(handoffSummary), @@ -134,6 +136,9 @@ TOOL_TABLE = browser-shell-tool.tbl true, "shell handoff package supported", ); + assertEqual(handoffPackageReport.ready, true, "shell handoff package report readiness"); + assertEqual(handoffPackageReport.packageSupported, true, "shell handoff package report support"); + assertEqual(handoffPackageReport.rows.length, 6, "shell handoff package report rows"); assertEqual(handoffPackage.checklist.ready, handoffChecklist.ready, "shell handoff package checklist"); assertEqual( handoffPackage.actionPlan.nextSteps.map(({ id }) => id).join(","), diff --git a/wasm-port/tests/ui/node/verify_ini_panel_entry_docs.mjs b/wasm-port/tests/ui/node/verify_ini_panel_entry_docs.mjs index fb40674..73eac84 100644 --- a/wasm-port/tests/ui/node/verify_ini_panel_entry_docs.mjs +++ b/wasm-port/tests/ui/node/verify_ini_panel_entry_docs.mjs @@ -23,6 +23,7 @@ import { createIniPanelShellSessionHandoffCompatibilityReport, createIniPanelShellSessionHandoffDisplayViewModel, createIniPanelShellSessionHandoffPackage, + createIniPanelShellSessionHandoffPackageReport, createIniPanelShellSessionHandoffPackageSchema, createIniPanelShellSessionHandoffRenderState, createIniPanelShellSessionHandoffSnapshot, @@ -82,6 +83,7 @@ const requiredShellExports = [ "createIniPanelShellSessionHandoffCompatibilityReport", "createIniPanelShellSessionHandoffDisplayViewModel", "createIniPanelShellSessionHandoffPackage", + "createIniPanelShellSessionHandoffPackageReport", "createIniPanelShellSessionHandoffPackageSchema", "createIniPanelShellSessionHandoffRenderState", "createIniPanelShellSessionHandoffSnapshot", @@ -230,6 +232,10 @@ assert.deepEqual( createIniPanelShellViewModel().shellSessionHandoffPackageSchema, createIniPanelShellSessionHandoffPackageSchema(), ); +assert.deepEqual( + createIniPanelShellViewModel().shellSessionHandoffPackageReport, + createIniPanelShellSessionHandoffPackageReport(createIniPanelShellViewModel().shellSessionHandoffPackage), +); assert.equal(isSupportedIniPanelShellSessionHandoffPackage(createIniPanelShellViewModel().shellSessionHandoffPackage), true); assert.equal(isSupportedIniPanelShellIntegrationManifest(createIniPanelShellViewModel().shellIntegrationManifest), true); assert.deepEqual(createIniPanelShellViewModel().launchApiSchema, createIniPanelLaunchApiSchema()); @@ -290,6 +296,7 @@ assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffChec assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffCompatibilityReport\b/); assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffDisplayViewModel\b/); assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackage\b/); +assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackageReport\b/); assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackageSchema\b/); assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffRenderState\b/); assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffSnapshot\b/); @@ -322,6 +329,7 @@ assert.match(launchText, /\bgetShellSessionHandoffActionPlan\b/); assert.match(launchText, /\bgetShellSessionHandoffChecklist\b/); assert.match(launchText, /\bgetShellSessionHandoffPackageSchema\b/); assert.match(launchText, /\bgetShellSessionHandoffPackage\b/); +assert.match(launchText, /\bgetShellSessionHandoffPackageReport\b/); assert.match(launchText, /\bisSupportedShellSessionHandoffPackage\b/); assert.match(launchText, /\bdata-handoff-shell\b/); assert.match(launchText, /\bdata-handoff-status\b/); @@ -349,6 +357,7 @@ assert.match(docText, /\bcreateIniPanelShellSessionHandoffChecklist\b/); assert.match(docText, /\bcreateIniPanelShellSessionHandoffCompatibilityReport\b/); assert.match(docText, /\bcreateIniPanelShellSessionHandoffDisplayViewModel\b/); assert.match(docText, /\bcreateIniPanelShellSessionHandoffPackage\b/); +assert.match(docText, /\bcreateIniPanelShellSessionHandoffPackageReport\b/); assert.match(docText, /\bcreateIniPanelShellSessionHandoffPackageSchema\b/); assert.match(docText, /\bcreateIniPanelShellSessionHandoffRenderState\b/); assert.match(docText, /\bcreateIniPanelShellSessionHandoffSnapshot\b/); @@ -376,6 +385,7 @@ assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getShellSessionHandoffAction assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getShellSessionHandoffChecklist\b/); assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getShellSessionHandoffPackageSchema\b/); assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getShellSessionHandoffPackage\b/); +assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getShellSessionHandoffPackageReport\b/); assert.match(docText, /\blinuxCncIniPanelLaunchApi\.isSupportedShellSessionHandoffPackage\b/); assert.match(docText, /\bdata-handoff-shell\b/); assert.match(docText, /\bdata-handoff-status\b/); @@ -394,6 +404,7 @@ assert.match(shellIntegrationWorkflowSmokeText, /\bgetShellSessionHandoffActionP assert.match(shellIntegrationWorkflowSmokeText, /\bgetShellSessionHandoffChecklist\b/); assert.match(shellIntegrationWorkflowSmokeText, /\bgetShellSessionHandoffPackageSchema\b/); assert.match(shellIntegrationWorkflowSmokeText, /\bgetShellSessionHandoffPackage\b/); +assert.match(shellIntegrationWorkflowSmokeText, /\bgetShellSessionHandoffPackageReport\b/); assert.match(shellIntegrationWorkflowSmokeText, /\bisSupportedShellSessionHandoffPackage\b/); assert.match(shellIntegrationWorkflowSmokeText, /\bhandoffSummary\.handoffMethods\.readStatus\b/); assert.match(shellIntegrationWorkflowSmokeText, /\breadControlPageStatus\b/); diff --git a/wasm-port/tests/ui/node/verify_ini_panel_launch_api_manifest.mjs b/wasm-port/tests/ui/node/verify_ini_panel_launch_api_manifest.mjs index e001828..1e501fd 100644 --- a/wasm-port/tests/ui/node/verify_ini_panel_launch_api_manifest.mjs +++ b/wasm-port/tests/ui/node/verify_ini_panel_launch_api_manifest.mjs @@ -57,6 +57,7 @@ assert.deepEqual(manifest, { "getShellSessionHandoffChecklist", "getShellSessionHandoffPackageSchema", "getShellSessionHandoffPackage", + "getShellSessionHandoffPackageReport", "isSupportedShellSessionHandoffPackage", "getLauncherLinks", "getControlPageApiMethods", @@ -169,6 +170,7 @@ assert.match(launchText, /\bgetShellSessionHandoffActionPlan\b/); assert.match(launchText, /\bgetShellSessionHandoffChecklist\b/); assert.match(launchText, /\bgetShellSessionHandoffPackageSchema\b/); assert.match(launchText, /\bgetShellSessionHandoffPackage\b/); +assert.match(launchText, /\bgetShellSessionHandoffPackageReport\b/); assert.match(launchText, /\bisSupportedShellSessionHandoffPackage\b/); assert.match(launchText, /\blinuxCncIniPanelLaunchApi\b/); diff --git a/wasm-port/tests/ui/node/verify_ini_panel_shell_integration_manifest.mjs b/wasm-port/tests/ui/node/verify_ini_panel_shell_integration_manifest.mjs index 88d643c..7dca310 100644 --- a/wasm-port/tests/ui/node/verify_ini_panel_shell_integration_manifest.mjs +++ b/wasm-port/tests/ui/node/verify_ini_panel_shell_integration_manifest.mjs @@ -19,6 +19,7 @@ import { createIniPanelShellSessionHandoffCompatibilityReport, createIniPanelShellSessionHandoffDisplayViewModel, createIniPanelShellSessionHandoffPackage, + createIniPanelShellSessionHandoffPackageReport, createIniPanelShellSessionHandoffPackageSchema, createIniPanelShellSessionHandoffRenderState, createIniPanelShellSessionHandoffSnapshot, @@ -69,6 +70,7 @@ const handoffPackage = createIniPanelShellSessionHandoffPackage({ checklist: handoffChecklist, }); const handoffPackageSchema = createIniPanelShellSessionHandoffPackageSchema(); +const handoffPackageReport = createIniPanelShellSessionHandoffPackageReport(handoffPackage); assert.deepEqual(schema, { apiName: "ini-panel-shell-integration", @@ -124,7 +126,7 @@ assert.deepEqual(readiness, { counts: { pages: 2, launcherLinks: 2, - launchMethods: 20, + launchMethods: 21, controlPageMethods: 11, persistenceCapabilities: 3, }, @@ -186,7 +188,7 @@ assert.deepEqual(handoffSummary, { counts: { pages: 2, launcherLinks: 2, - launchMethods: 20, + launchMethods: 21, controlPageMethods: 11, persistenceCapabilities: 3, }, @@ -468,6 +470,80 @@ assert.deepEqual(handoffPackageSchema, { "controlPageMethods", ], }); +assert.deepEqual(handoffPackageReport, { + apiName: "ini-panel-shell-session-handoff-package-report", + reportVersion: 1, + phase: "ready", + ready: true, + packageSupported: true, + packageReady: true, + statusLine: "Ready: No blocking reasons", + schema: { + apiName: "ini-panel-shell-session-handoff-package", + packageVersion: 1, + fields: [ + "apiName", + "packageVersion", + "phase", + "ready", + "statusLine", + "manifests", + "snapshot", + "renderState", + "actionPlan", + "checklist", + ], + manifestFields: [ + "shellIntegration", + "launchApi", + "controlPageApi", + "launchMethods", + "controlPageMethods", + ], + }, + package: { + apiName: "ini-panel-shell-session-handoff-package", + packageVersion: 1, + phase: "ready", + ready: true, + }, + missingPackageFields: [], + missingManifestFields: [], + mismatchFields: [], + blockingReasons: [], + rows: [ + { + id: "package-supported", + label: "Package schema", + value: "supported", + }, + { + id: "package-ready", + label: "Package readiness", + value: "ready", + }, + { + id: "missing-package-fields", + label: "Missing package fields", + value: "none", + }, + { + id: "missing-manifest-fields", + label: "Missing manifest fields", + value: "none", + }, + { + id: "mismatch-fields", + label: "Mismatched fields", + value: "none", + }, + { + id: "blocking-reasons", + label: "Blocking reasons", + value: "none", + }, + ], +}); assert.equal(isSupportedIniPanelShellSessionHandoffPackage(handoffPackage), true); assert.equal( isSupportedIniPanelShellSessionHandoffPackage({ ...handoffPackage, packageVersion: 2 }), @@ -494,12 +570,25 @@ const missingManifestField = { delete missingManifestField.manifests.controlPageMethods; assert.equal(isSupportedIniPanelShellSessionHandoffPackage(missingManifestField), false); assert.equal(isSupportedIniPanelShellSessionHandoffPackage(null), false); +assert.deepEqual( + createIniPanelShellSessionHandoffPackageReport({ ...handoffPackage, packageVersion: 2 }).mismatchFields, + ["packageVersion"], +); +assert.deepEqual( + createIniPanelShellSessionHandoffPackageReport(missingManifestField).missingManifestFields, + ["controlPageMethods"], +); +assert.deepEqual( + createIniPanelShellSessionHandoffPackageReport(null).missingPackageFields, + handoffPackageSchema.fields, +); assert.equal(createIniPanelShellSessionHandoffSnapshot().displayViewModel.rows.length, 5); assert.equal(createIniPanelShellSessionHandoffRenderState().statusLine, "Ready: No blocking reasons"); assert.equal(createIniPanelShellSessionHandoffActionPlan().nextSteps.length, 2); assert.equal(createIniPanelShellSessionHandoffChecklist().checks.length, 5); assert.equal(createIniPanelShellSessionHandoffPackage().manifests.launchMethods.includes("getShellSessionHandoffPackage"), true); assert.equal(isSupportedIniPanelShellSessionHandoffPackage(createIniPanelShellSessionHandoffPackage()), true); +assert.equal(createIniPanelShellSessionHandoffPackageReport().rows.length, 6); assert.deepEqual( createIniPanelShellSessionHandoffDisplayViewModel( createIniPanelShellSessionHandoffCompatibilityReport({ ...handoffSummary, summaryVersion: 2 }), @@ -716,7 +805,7 @@ assert.deepEqual(createIniPanelShellIntegrationReadiness(blockedManifest), { counts: { pages: 2, launcherLinks: 2, - launchMethods: 20, + launchMethods: 21, controlPageMethods: 11, persistenceCapabilities: 3, }, @@ -881,6 +970,7 @@ assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffChec assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffCompatibilityReport\b/); assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffDisplayViewModel\b/); assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackage\b/); +assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackageReport\b/); assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackageSchema\b/); assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffRenderState\b/); assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffSnapshot\b/); @@ -900,6 +990,7 @@ assert.match(docText, /\bcreateIniPanelShellSessionHandoffChecklist\b/); assert.match(docText, /\bcreateIniPanelShellSessionHandoffCompatibilityReport\b/); assert.match(docText, /\bcreateIniPanelShellSessionHandoffDisplayViewModel\b/); assert.match(docText, /\bcreateIniPanelShellSessionHandoffPackage\b/); +assert.match(docText, /\bcreateIniPanelShellSessionHandoffPackageReport\b/); assert.match(docText, /\bcreateIniPanelShellSessionHandoffPackageSchema\b/); assert.match(docText, /\bcreateIniPanelShellSessionHandoffRenderState\b/); assert.match(docText, /\bcreateIniPanelShellSessionHandoffSnapshot\b/); diff --git a/wasm-port/tests/ui/node/verify_ini_panel_ui_shell.mjs b/wasm-port/tests/ui/node/verify_ini_panel_ui_shell.mjs index 3c191b7..00abacb 100644 --- a/wasm-port/tests/ui/node/verify_ini_panel_ui_shell.mjs +++ b/wasm-port/tests/ui/node/verify_ini_panel_ui_shell.mjs @@ -19,6 +19,7 @@ import { createIniPanelShellSessionHandoffCompatibilityReport, createIniPanelShellSessionHandoffDisplayViewModel, createIniPanelShellSessionHandoffPackage, + createIniPanelShellSessionHandoffPackageReport, createIniPanelShellSessionHandoffPackageSchema, createIniPanelShellSessionHandoffRenderState, createIniPanelShellSessionHandoffSnapshot, @@ -83,6 +84,7 @@ assert.equal(typeof createIniPanelShellSessionHandoffChecklist, "function"); assert.equal(typeof createIniPanelShellSessionHandoffCompatibilityReport, "function"); assert.equal(typeof createIniPanelShellSessionHandoffDisplayViewModel, "function"); assert.equal(typeof createIniPanelShellSessionHandoffPackage, "function"); +assert.equal(typeof createIniPanelShellSessionHandoffPackageReport, "function"); assert.equal(typeof createIniPanelShellSessionHandoffPackageSchema, "function"); assert.equal(typeof createIniPanelShellSessionHandoffRenderState, "function"); assert.equal(typeof createIniPanelShellSessionHandoffSnapshot, "function"); @@ -204,6 +206,10 @@ assert.deepEqual( }), ); assert.deepEqual(shellViewModel.shellSessionHandoffPackageSchema, createIniPanelShellSessionHandoffPackageSchema()); +assert.deepEqual( + shellViewModel.shellSessionHandoffPackageReport, + createIniPanelShellSessionHandoffPackageReport(shellViewModel.shellSessionHandoffPackage), +); assert.equal(isSupportedIniPanelShellSessionHandoffPackage(shellViewModel.shellSessionHandoffPackage), true); assert.deepEqual(shellViewModel.shellSessionHandoffDisplayViewModel, { phase: "ready", @@ -371,6 +377,58 @@ assert.deepEqual(shellViewModel.shellSessionHandoffPackageSchema, { "controlPageMethods", ], }); +assert.deepEqual(shellViewModel.shellSessionHandoffPackageReport, { + apiName: "ini-panel-shell-session-handoff-package-report", + reportVersion: 1, + phase: "ready", + ready: true, + packageSupported: true, + packageReady: true, + statusLine: "Ready: No blocking reasons", + schema: shellViewModel.shellSessionHandoffPackageSchema, + package: { + apiName: "ini-panel-shell-session-handoff-package", + packageVersion: 1, + phase: "ready", + ready: true, + }, + missingPackageFields: [], + missingManifestFields: [], + mismatchFields: [], + blockingReasons: [], + rows: [ + { + id: "package-supported", + label: "Package schema", + value: "supported", + }, + { + id: "package-ready", + label: "Package readiness", + value: "ready", + }, + { + id: "missing-package-fields", + label: "Missing package fields", + value: "none", + }, + { + id: "missing-manifest-fields", + label: "Missing manifest fields", + value: "none", + }, + { + id: "mismatch-fields", + label: "Mismatched fields", + value: "none", + }, + { + id: "blocking-reasons", + label: "Blocking reasons", + value: "none", + }, + ], +}); assert.equal( isSupportedIniPanelShellIntegrationManifest(shellViewModel.shellIntegrationManifest), true, @@ -419,6 +477,7 @@ assert.equal(shellViewModel.createShellSessionHandoffRenderState, createIniPanel assert.equal(shellViewModel.createShellSessionHandoffActionPlan, createIniPanelShellSessionHandoffActionPlan); assert.equal(shellViewModel.createShellSessionHandoffChecklist, createIniPanelShellSessionHandoffChecklist); assert.equal(shellViewModel.createShellSessionHandoffPackage, createIniPanelShellSessionHandoffPackage); +assert.equal(shellViewModel.createShellSessionHandoffPackageReport, createIniPanelShellSessionHandoffPackageReport); assert.equal(shellViewModel.createShellSessionHandoffPackageSchema, createIniPanelShellSessionHandoffPackageSchema); assert.equal(shellViewModel.isSupportedShellSessionHandoffPackage, isSupportedIniPanelShellSessionHandoffPackage); assert.deepEqual(shellViewModel.controlPage.contract, createIniPanelShellControlPageContract());