test(desktop): cover the runtime pairing decision surface

The browser smoke drives the boot surface through the decision: both
choices stay available, nothing installs before one is chosen, the native
boot-failure callback cannot overwrite it, escalation never relabels it as
an error, the layout holds at phone width, and "update" checks then installs
while "use this App's runtime" issues the align action and retires the
chooser once services connect. The unit test keeps the pairing evidence
bounded and free of private detail.

Signed-off-by: huangruiteng <14976749+huangruiteng@users.noreply.github.com>

Author: huangruiteng

examples/desktop-recovery-diagnostics-test.mjs

@@ -41,3 +41,55 @@ test('installer failure is actionable and clipboard denial leaves selectable tex
   await elements.get('#copy-diagnostics').onclick();
   assert.equal(elements.get('#diagnostics').selected, true);
 });
+test('a different installed runtime asks before anything is replaced', () => {
+  const {context, elements} = page();
+  const decision = {
+    phase: 'runtime_pairing_required',
+    details: {
+      code: 'runtime_pairing_required',
+      installed_revision: 'a'.repeat(40),
+      bundled_revision: 'b'.repeat(40),
+      installed_identity_available: true,
+      revision_matches: false,
+    },
+  };
+  runInNewContext('render(packet)', Object.assign(context, {packet: decision}));
+  assert.equal(elements.get('#pairing').hidden, false);
+  assert.equal(elements.get('#pairing-installed').textContent, 'a'.repeat(12));
+  assert.equal(elements.get('#pairing-bundled').textContent, 'b'.repeat(12));
+  assert.match(elements.get('#pairing-status').textContent, /本地服务需要两者一致/);
+  // Neither choice is a background install: both stay available and neither
+  // runs before the operator picks one.
+  assert.equal(elements.get('#pairing-update').disabled, false);
+  assert.equal(elements.get('#pairing-align').disabled, false);
+  // The chooser stays up while the chosen action runs, and retires only when
+  // services connect.
+  runInNewContext('render({phase:"installing_runtime",details:{}})', context);
+  assert.equal(elements.get('#pairing').hidden, false);
+  runInNewContext('render({phase:"connecting",details:{service:"chat"}})', context);
+  assert.equal(elements.get('#pairing').hidden, true);
+});
+test('the pairing decision reaches diagnostics without private detail', () => {
+  const {context, elements} = page();
+  context.packet = {
+    app_version: '1.0.5',
+    state: {phase: 'runtime_pairing_required', details: {code: 'runtime_pairing_required'}},
+    last_failure: {
+      phase: 'runtime_pairing_required',
+      details: {
+        code: 'runtime_pairing_required',
+        installed_revision: 'a'.repeat(40),
+        bundled_revision: 'b'.repeat(40),
+        installed_identity_available: true,
+        revision_matches: false,
+        path: 'PRIVATE',
+      },
+    },
+  };
+  runInNewContext('renderDiagnostics(packet)', context);
+  const value = JSON.parse(elements.get('#diagnostics').value);
+  assert.equal(value.error_code, 'runtime_pairing_required');
+  assert.equal(value.failure_phase, 'runtime_pairing_required');
+  assert.equal(value.revision_matches, false);
+  assert.ok(!JSON.stringify(value).includes('PRIVATE'));
+});

examples/desktop-update-browser-smoke.mjs

@@ -31,6 +31,7 @@ try {
   let startupTiming = null;
   let failUpdate = false;
   let checkFailure = null;
+  let checkUpToDate = false;
   let statusFailure = false;
   let environmentTelemetry = null;
   await page.exposeFunction("nativeInvoke", async (command, args) => {
@@ -40,9 +41,16 @@ try {
     }
     calls.push({ command, args });
     if (checkFailure && args.action === "check") return { phase: "error", details: { code: checkFailure } };
+    if (checkUpToDate && args.action === "check") {
+      nativeState = { phase: "up_to_date", details: { channel: args.channel } };
+      return nativeState;
+    }
     if (failUpdate) throw new Error("private diagnostic must not be displayed");
     await new Promise((done) => setTimeout(done, 150));
-    nativeState = { phase: args.action === "check" ? "available" : "restart_required", details: { version: "0.5.5", channel: args.channel } };
+    nativeState = {
+      phase: args.action === "check" ? "available" : args.action === "align_runtime" ? "connecting" : "restart_required",
+      details: { version: "0.5.5", channel: args.channel },
+    };
     return nativeState;
   });
   await page.addInitScript(() => {
@@ -232,6 +240,81 @@ try {
   nativeState = { phase: "runtime_required", details: { code: "runtime_setup_required" } };
   await page.waitForFunction(() => document.querySelector("main").dataset.state === "error" && document.querySelector("#status").innerText.includes("请修复当前版本，成功后重启"));
   environmentTelemetry = null;
+  // A different installed CLI runtime is the operator's decision, shown on the
+  // first screen with both choices: update the App and runtime together, or
+  // replace the CLI runtime with this App's bundled snapshot. Nothing is
+  // installed until one of them is chosen.
+  const pairingState = { phase: "runtime_pairing_required", details: {
+    code: "runtime_pairing_required", app_version: "1.0.5",
+    installed_revision: "a".repeat(40), bundled_revision: "b".repeat(40),
+    installed_identity_available: true, revision_matches: false,
+  } };
+  nativeState = pairingState;
+  await page.reload();
+  const pairingPanel = page.locator("#pairing");
+  await pairingPanel.waitFor({ state: "visible" });
+  assert.equal(await startupPanel.getAttribute("data-state"), "decision");
+  assert.equal(await startupPanel.getAttribute("aria-busy"), "false");
+  assert.equal(await startupDots.isVisible(), false);
+  assert.equal(await page.locator("#status").innerText(), "需要你选择 App 与 CLI 运行时的对齐方式");
+  assert.equal(await page.locator("#pairing-installed").innerText(), "aaaaaaaaaaaa");
+  assert.equal(await page.locator("#pairing-bundled").innerText(), "bbbbbbbbbbbb");
+  assert.ok((await page.locator("#pairing-status").innerText()).includes("本地服务需要两者一致"));
+  assert.equal(await page.getByRole("button", { name: /升级：更新 App 与运行时/ }).isEnabled(), true);
+  assert.equal(await page.getByRole("button", { name: /回退 CLI：改用本 App 自带运行时/ }).isEnabled(), true);
+  // A decision never escalates into the error projection, and the native boot
+  // failure callback cannot overwrite it.
+  await page.evaluate(() => window.loopxBootFailed("启动失败，请重试。"));
+  await page.waitForTimeout(2600);
+  assert.equal(await startupPanel.getAttribute("data-state"), "decision");
+  assert.equal(await pairingPanel.isVisible(), true);
+  assert.equal(await page.locator("#status").innerText(), "需要你选择 App 与 CLI 运行时的对齐方式");
+  await page.screenshot({ path: resolve(output, "startup-pairing-decision.png") });
+  await page.emulateMedia({ colorScheme: "dark" });
+  await page.screenshot({ path: resolve(output, "startup-pairing-decision-dark.png") });
+  await page.emulateMedia({ colorScheme: "light" });
+  await page.setViewportSize({ width: 390, height: 844 });
+  assert.ok(await page.evaluate(() => document.documentElement.scrollWidth <= innerWidth), "the decision must fit a phone-width window");
+  const upgradeBox = await page.getByRole("button", { name: /升级：更新 App 与运行时/ }).boundingBox();
+  const alignBox = await page.getByRole("button", { name: /回退 CLI：改用本 App 自带运行时/ }).boundingBox();
+  assert.ok(upgradeBox && alignBox && upgradeBox.y + upgradeBox.height <= alignBox.y + 1, "both choices stay visible and ordered");
+  await page.screenshot({ path: resolve(output, "startup-pairing-decision-mobile.png") });
+  await page.setViewportSize({ width: 1280, height: 900 });
+
+  // "Upgrade" is one intent: check this App's channel, then continue into the
+  // verified install instead of asking for a second click.
+  calls.length = 0;
+  await page.getByRole("button", { name: /升级：更新 App 与运行时/ }).click();
+  await page.waitForFunction(() => document.querySelector("#pairing-status").textContent.includes("重启"));
+  assert.deepEqual(calls.map((call) => call.args?.action), ["check", "apply"], "upgrade must check then install");
+  assert.deepEqual(calls.at(-1).args.channel, "stable");
+  assert.equal(await pairingPanel.isVisible(), true, "the install outcome stays on the decision surface");
+
+  // A channel with nothing newer says so and leaves the CLI choice standing.
+  nativeState = pairingState;
+  await page.reload();
+  await pairingPanel.waitFor({ state: "visible" });
+  calls.length = 0;
+  checkUpToDate = true;
+  await page.getByRole("button", { name: /升级：更新 App 与运行时/ }).click();
+  await page.waitForFunction(() => document.querySelector("#pairing-status").textContent.includes("没有更新的 App 构建"));
+  assert.deepEqual(calls.map((call) => call.args?.action), ["check"], "a channel without a newer build must not install anything");
+  assert.equal(await pairingPanel.isVisible(), true);
+  checkUpToDate = false;
+
+  // "Roll back the CLI" installs this App's snapshot and reconnects the same
+  // window; the chooser retires as soon as services connect.
+  nativeState = pairingState;
+  await page.reload();
+  await pairingPanel.waitFor({ state: "visible" });
+  calls.length = 0;
+  await page.getByRole("button", { name: /回退 CLI：改用本 App 自带运行时/ }).click();
+  await page.getByText("正在连接本地服务", { exact: true }).waitFor();
+  assert.deepEqual(calls.map((call) => call.args?.action), ["align_runtime"]);
+  assert.equal(await pairingPanel.isVisible(), false);
+  nativeState = { phase: "connecting", details: { service: "chat" } };
+  await page.getByText("正在连接管家对话服务", { exact: true }).waitFor();
+
   // Production boot surface must expose native installation and service
   // stages even while recovery is collapsed; reload keeps native elapsed time.
   nativeState = { phase: "installing_runtime", details: {} };
@@ -249,7 +332,7 @@ try {
   await page.getByText(/启动用时较长/).waitFor();
   nativeState = { phase: "service_error", details: { code: "service_start_failed" } };
   await page.getByText("本地服务连接失败，正在等待重试", { exact: true }).waitFor();
-  console.log("desktop-update-browser-smoke: passed (confirmation, failure redaction, mobile, missing assets + reload, startup motion states, startup recovery, startup error escalation)");
+  console.log("desktop-update-browser-smoke: passed (confirmation, failure redaction, mobile, missing assets + reload, startup motion states, startup recovery, startup error escalation, runtime pairing decision)");
 } finally {
   await browser.close();
   await new Promise((done) => server.close(done));