@firstpick/pi-package-webui 0.8.0 → 0.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/README.md +34 -5
  2. package/bin/pi-webui.mjs +606 -102
  3. package/lib/component-update-state.mjs +126 -0
  4. package/lib/npm-command.mjs +81 -0
  5. package/lib/queue-mutation.mjs +6 -0
  6. package/lib/trust-boundaries.mjs +1 -0
  7. package/lib/workspace-files-live-watcher.mjs +138 -0
  8. package/package.json +8 -3
  9. package/public/app.js +4231 -376
  10. package/public/index.html +265 -52
  11. package/public/mobile-shell-state.mjs +166 -0
  12. package/public/service-worker.js +60 -13
  13. package/public/styles.css +1790 -383
  14. package/public/subagent-gate-visibility.mjs +16 -0
  15. package/public/subagent-launch-slot-state.mjs +16 -0
  16. package/public/transcript-renderer.mjs +433 -0
  17. package/tests/boot-failure-diagnostics.test.mjs +63 -5
  18. package/tests/browser/control-deck-component-updates.spec.mjs +180 -0
  19. package/tests/browser/interaction-continuity.spec.mjs +897 -0
  20. package/tests/browser/mobile-foundation.spec.mjs +363 -0
  21. package/tests/browser/optimistic-prompt.spec.mjs +130 -0
  22. package/tests/browser/side-panel-section-reorder.spec.mjs +101 -0
  23. package/tests/browser/stats-overlay.spec.mjs +265 -0
  24. package/tests/chat-scroll-intent-static.test.mjs +6 -1
  25. package/tests/codex-fast-mode-static.test.mjs +8 -5
  26. package/tests/compact-sections-static.test.mjs +20 -2
  27. package/tests/compaction-mutation-contract.test.mjs +18 -4
  28. package/tests/compaction-static.test.mjs +1 -0
  29. package/tests/completion-signal-contract.test.mjs +13 -2
  30. package/tests/component-update-api-static.test.mjs +67 -0
  31. package/tests/component-update-state.test.mjs +80 -0
  32. package/tests/control-deck-component-updates-static.test.mjs +251 -0
  33. package/tests/fast-mode-client-static.test.mjs +7 -4
  34. package/tests/fixtures/fake-pi.mjs +305 -2
  35. package/tests/footer-provider-usage-visual-static.test.mjs +71 -0
  36. package/tests/git-panel-gitignore-static.test.mjs +104 -0
  37. package/tests/http-endpoints-harness.test.mjs +228 -2
  38. package/tests/interaction-state-stability-static.test.mjs +271 -0
  39. package/tests/mobile-continuity-tablet-static.test.mjs +55 -0
  40. package/tests/mobile-foundation-static.test.mjs +71 -0
  41. package/tests/mobile-phone-experience-static.test.mjs +65 -0
  42. package/tests/mobile-shell-state.test.mjs +69 -0
  43. package/tests/mobile-static.test.mjs +246 -39
  44. package/tests/mobile-transcript-cache-characterization.test.mjs +34 -0
  45. package/tests/native-parity-harness.test.mjs +2 -0
  46. package/tests/npm-command.test.mjs +64 -1
  47. package/tests/open-issue-wizard-static.test.mjs +2 -1
  48. package/tests/queue-edit-reorder-static.test.mjs +9 -1
  49. package/tests/queue-mutation-contract.test.mjs +22 -0
  50. package/tests/service-worker-lifecycle.test.mjs +120 -0
  51. package/tests/side-panel-section-reorder-static.test.mjs +68 -0
  52. package/tests/sse-backpressure-harness.test.mjs +137 -0
  53. package/tests/stats-dashboard-static.test.mjs +266 -0
  54. package/tests/streaming-ui-coupling.test.mjs +7 -1
  55. package/tests/subagent-gate-visibility.test.mjs +18 -2
  56. package/tests/subagent-launch-slot-state.test.mjs +32 -0
  57. package/tests/subagent-launch-slots-static.test.mjs +8 -2
  58. package/tests/subagents-helper.test.mjs +90 -0
  59. package/tests/terminal-tab-workspace-static.test.mjs +1 -1
  60. package/tests/update-commands.test.mjs +4 -0
  61. package/tests/workspace-files-live-updates-static.test.mjs +76 -0
  62. package/tests/workspace-files-live-watcher.test.mjs +95 -0
  63. package/webui-rpc-helper.mjs +175 -3
@@ -0,0 +1,180 @@
1
+ import assert from "node:assert/strict";
2
+ import { spawn } from "node:child_process";
3
+ import { createServer } from "node:net";
4
+ import { mkdtemp, rm } from "node:fs/promises";
5
+ import { tmpdir } from "node:os";
6
+ import { dirname, join } from "node:path";
7
+ import { setTimeout as delay } from "node:timers/promises";
8
+ import { fileURLToPath } from "node:url";
9
+ import { expect, test } from "@playwright/test";
10
+
11
+ const root = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
12
+ const serverScript = join(root, "bin", "pi-webui.mjs");
13
+ const fakePi = join(root, "tests", "fixtures", "fake-pi.mjs");
14
+
15
+ async function freePort() {
16
+ const server = createServer();
17
+ await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
18
+ const { port } = server.address();
19
+ await new Promise((resolve) => server.close(resolve));
20
+ return port;
21
+ }
22
+
23
+ let child;
24
+ let baseURL;
25
+ let tempRoot;
26
+ let output = "";
27
+
28
+ test.beforeAll(async () => {
29
+ const port = await freePort();
30
+ tempRoot = await mkdtemp(join(tmpdir(), "pi-webui-component-updates-"));
31
+ baseURL = `http://127.0.0.1:${port}`;
32
+ child = spawn(process.execPath, [serverScript, "--cwd", tempRoot, "--host", "127.0.0.1", "--port", String(port), "--pi", fakePi], {
33
+ stdio: ["ignore", "pipe", "pipe"],
34
+ env: {
35
+ ...process.env,
36
+ PI_WEBUI_RPC_SUPERVISOR: "0",
37
+ PI_CODING_AGENT_DIR: join(tempRoot, "agent"),
38
+ PI_WEBUI_SETTINGS_FILE: join(tempRoot, "settings.json"),
39
+ },
40
+ });
41
+ child.stdout.on("data", (chunk) => { output += String(chunk); });
42
+ child.stderr.on("data", (chunk) => { output += String(chunk); });
43
+ for (let attempt = 0; attempt < 80; attempt += 1) {
44
+ if (child.exitCode !== null) break;
45
+ try {
46
+ const response = await fetch(`${baseURL}/api/health`, { signal: AbortSignal.timeout(500) });
47
+ if (response.ok) return;
48
+ } catch {
49
+ // Wait for the package server and fake Pi fixture to start.
50
+ }
51
+ await delay(100);
52
+ }
53
+ throw new Error(`Pi Web UI did not start:\n${output}`);
54
+ });
55
+
56
+ test.afterAll(async () => {
57
+ child?.kill("SIGTERM");
58
+ if (child) await new Promise((resolve) => child.once("exit", resolve));
59
+ await rm(tempRoot, { recursive: true, force: true });
60
+ });
61
+
62
+ test("component tags and dialogs expose safe background update lifecycle", async ({ page }) => {
63
+ const requests = [];
64
+ let statusPollsAfterStart = 0;
65
+ const status = {
66
+ updateAvailable: true,
67
+ updateInProgress: false,
68
+ canRunUpdate: true,
69
+ pi: { checked: true, currentVersion: "0.83.0", latestVersion: "0.84.0", updateAvailable: true },
70
+ webui: { checked: true, currentVersion: "0.8.1", latestVersion: "0.8.2", updateAvailable: true },
71
+ componentUpdates: {
72
+ pi: { target: "pi", state: "idle", message: "", error: "", canStart: true, unavailableReason: "", restartRequired: false },
73
+ webui: {
74
+ target: "webui",
75
+ state: "idle",
76
+ message: "",
77
+ error: "",
78
+ canStart: false,
79
+ unavailableReason: "Automatic Web UI update is unavailable from a source or development checkout.",
80
+ restartRequired: true,
81
+ },
82
+ },
83
+ };
84
+
85
+ await page.route("**/api/pi-release-notes", async (route) => {
86
+ await route.fulfill({
87
+ status: 200,
88
+ contentType: "application/json",
89
+ body: JSON.stringify({ ok: true, data: { version: "0.83.0", body: "Fixture release notes", url: "https://example.test/pi" } }),
90
+ });
91
+ });
92
+ await page.route("**/api/component-update", async (route) => {
93
+ const body = route.request().postDataJSON();
94
+ requests.push({ method: route.request().method(), body });
95
+ const target = body?.target;
96
+ status.updateInProgress = true;
97
+ status.componentUpdates[target] = {
98
+ ...status.componentUpdates[target],
99
+ state: "running",
100
+ canStart: false,
101
+ message: `Updating ${target === "pi" ? "Pi" : "Web UI"}…`,
102
+ error: "",
103
+ };
104
+ await route.fulfill({
105
+ status: 202,
106
+ contentType: "application/json",
107
+ body: JSON.stringify({ ok: true, data: status.componentUpdates[target] }),
108
+ });
109
+ });
110
+ await page.route("**/api/update-status*", async (route) => {
111
+ if (status.componentUpdates.pi.state === "running") {
112
+ statusPollsAfterStart += 1;
113
+ status.componentUpdates.pi = {
114
+ ...status.componentUpdates.pi,
115
+ state: "succeeded",
116
+ canStart: true,
117
+ message: "Pi update completed.",
118
+ };
119
+ status.updateInProgress = false;
120
+ }
121
+ await route.fulfill({ status: 200, contentType: "application/json", body: JSON.stringify({ ok: true, data: status }) });
122
+ });
123
+
124
+ await page.goto(baseURL);
125
+ const piTag = page.locator("#piVersionButton");
126
+ const webuiTag = page.locator("#webuiVersionButton");
127
+ await expect(piTag).toHaveAttribute("data-update-state", "available", { timeout: 8_000 });
128
+ await expect(piTag).toHaveAccessibleName(/Pi .*update available/);
129
+ await expect(webuiTag).toHaveAttribute("data-update-state", "available");
130
+ await expect(webuiTag).toHaveAccessibleName(/Web UI .*update available/);
131
+ await page.locator("#updateNotificationDismissButton").click();
132
+ await expect(page.locator("#updateNotification")).toBeHidden();
133
+
134
+ await webuiTag.click();
135
+ const webuiDialog = page.locator("#webuiPackageDialog");
136
+ await expect(webuiDialog).toBeVisible();
137
+ await expect(page.locator("#webuiPackageCurrentVersion")).toHaveText("v0.8.1");
138
+ await expect(page.locator("#webuiPackageLatestVersion")).toHaveText("v0.8.2");
139
+ await expect(page.locator("#webuiPackageNpmButton")).toHaveText("View on npm");
140
+ await expect(page.locator("#webuiComponentUpdateStatus")).toContainText("source or development checkout");
141
+ await expect(page.locator("#webuiComponentUpdateButton")).toBeDisabled();
142
+ await page.locator("#webuiPackageCloseButton").click();
143
+
144
+ await piTag.click();
145
+ const piDialog = page.locator("#piReleaseNotesDialog");
146
+ await expect(piDialog).toBeVisible();
147
+ await expect(page.locator("#piComponentUpdateStatus")).toContainText("Pi v0.83.0 → v0.84.0 is available");
148
+ await page.locator("#piComponentUpdateButton").click();
149
+ await expect(page.locator("#confirmationDialog")).toBeVisible();
150
+ await expect(page.locator("#confirmationSummary")).toContainText("Web UI server and running Pi tabs are not restarted");
151
+ await page.locator("#confirmationConfirmButton").click();
152
+
153
+ await expect(piTag).toHaveAttribute("data-update-state", "running");
154
+ await expect(piTag).toHaveAccessibleName(/update running/);
155
+ await expect(page.locator("#piComponentUpdateButton")).toBeDisabled();
156
+ assert.deepEqual(requests, [{ method: "POST", body: { target: "pi" } }], "the dialog must submit exactly one Pi-only POST");
157
+
158
+ await expect(piTag).toHaveAttribute("data-update-state", "succeeded", { timeout: 5_000 });
159
+ await expect(page.locator("#piComponentUpdateStatus")).toContainText("New or reloaded Pi sessions use the update");
160
+ await expect(page.locator("#piComponentUpdateStatus")).toContainText("already-running tabs keep their current runtime");
161
+ assert.ok(statusPollsAfterStart >= 1, "the browser should poll while the accepted job is running");
162
+ const pollsAtSuccess = statusPollsAfterStart;
163
+ await page.waitForTimeout(1_300);
164
+ assert.equal(statusPollsAfterStart, pollsAtSuccess, "short polling should stop after terminal success");
165
+ await page.locator("#piReleaseNotesCloseButton").click();
166
+ await expect(piDialog).toBeHidden();
167
+
168
+ status.componentUpdates.webui = {
169
+ ...status.componentUpdates.webui,
170
+ state: "failed",
171
+ canStart: true,
172
+ message: "Web UI update failed.",
173
+ error: "bounded fixture failure",
174
+ };
175
+ await webuiTag.click();
176
+ await expect(page.locator("#webuiComponentUpdateStatus")).toContainText("bounded fixture failure");
177
+ await expect(page.locator("#webuiComponentUpdateStatus")).toContainText("retry the update");
178
+ await expect(page.locator("#webuiComponentUpdateButton")).toBeEnabled();
179
+ await expect(page.locator("#webuiComponentUpdateButton")).toHaveText("Retry Web UI update");
180
+ });