test(update): prove the footer poll runs and pin the installer's real bytes

Two seams were verified only by inference. Nothing in the suite drove
startUpdateStatusPolling through pollUpdateStatus to dispatchFooter, so the
status-row chip could have been dead code with every test still passing — a
startup test now drives the real poller against real state files and asserts the
rendered row. And the line reader had only ever parsed hand-written fixtures, so
it now pins the exact bytes a real install.sh run emitted, which also records the
throttle's real behaviour: three lines in one chunk write the first update and
the terminal one, not the middle.

Author: elkaix

apps/pythinker-code/test/cli/update/preflight.test.ts

@@ -2058,6 +2058,47 @@ describe('runUpdatePreflight', () => {
       }));
     });
 
+    /**
+     * The exact bytes a real `install.sh` run emitted while downloading the
+     * 0.9.2 release, captured from its stderr. Pinning them here means the
+     * emitter and this parser cannot drift apart silently.
+     */
+    it('parses the bytes a real installer run actually emitted', async () => {
+      mocks.readUpdateCache.mockResolvedValue(cacheWith('0.5.0'));
+      mocks.readUpdateInstallState.mockResolvedValue(installState());
+      mocks.refreshUpdateCache.mockResolvedValue(cacheWith('0.5.0'));
+      mocks.detectInstallSource.mockResolvedValue('npm-global');
+      mockSpawnExitWithStderr(
+        0,
+        'progress: state=downloading percent=0 transferred=0 total=55795679\n'
+        + 'progress: state=downloading percent=49 transferred=27103232 total=55795679\n'
+        + 'progress: state=done transferred=55795679\n',
+      );
+      const { options } = captureOutput();
+
+      await expect(runUpdatePreflight('0.4.0', options)).resolves.toBe('continue');
+      await flushBackgroundInstall();
+
+      // All three lines arrive in one chunk, so the 2-second write throttle
+      // keeps the first downloading update and drops the second; the terminal
+      // state always bypasses the throttle.
+      expect(writeUpdateInstallState).toHaveBeenCalledWith(expect.objectContaining({
+        active: expect.objectContaining({
+          progress: expect.objectContaining({
+            state: 'downloading',
+            percent: 0,
+            transferred: 0,
+            total: 55_795_679,
+          }),
+        }),
+      }));
+      expect(writeUpdateInstallState).toHaveBeenCalledWith(expect.objectContaining({
+        active: expect.objectContaining({
+          progress: expect.objectContaining({ state: 'done', transferred: 55_795_679 }),
+        }),
+      }));
+    });
+
     it('keeps progress lines out of the failure tail and ordinary stderr lines in it', async () => {
       mocks.readUpdateCache.mockResolvedValue(cacheWith('0.5.0'));
       mocks.readUpdateInstallState.mockResolvedValue(installState());

apps/pythinker-code/test/tui/pythinker-tui-startup.test.ts

@@ -1,4 +1,4 @@
-import { mkdtempSync, rmSync } from 'node:fs';
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 
@@ -78,6 +78,11 @@ interface RuntimeStateDriver extends StartupDriver {
   closeSession(reason: string): Promise<void>;
 }
 
+interface UpdatePollDriver extends StartupDriver {
+  startUpdateStatusPolling(): void;
+  stopUpdateStatusPolling(): void;
+}
+
 interface ThemeTrackingDriver extends StartupDriver {
   refreshTerminalThemeTracking(): void;
 }
@@ -2008,3 +2013,85 @@ describe('startup feature parity baseline', () => {
     ).toBe(true);
   });
 });
+
+describe('footer update status poll', () => {
+  /**
+   * The poll is the only thing that puts an update into the footer, and it is
+   * wired from `finishStartup` — so nothing else in this suite would notice if
+   * it stopped dispatching. Drive it against real state files.
+   */
+  it('dispatches availability and then live progress into the status row', async () => {
+    const home = mkdtempSync(join(tmpdir(), 'pk-footer-update-'));
+    const previousHome = process.env['PYTHINKER_CODE_HOME'];
+    process.env['PYTHINKER_CODE_HOME'] = home;
+    const updates = join(home, 'updates');
+    mkdirSync(updates, { recursive: true });
+    const manifest = {
+      version: '9.9.9',
+      publishedAt: '2026-08-07T00:00:00.000Z',
+      rollout: [],
+    };
+    writeFileSync(
+      join(updates, 'latest.json'),
+      JSON.stringify({
+        source: 'cdn',
+        checkedAt: '2026-08-07T00:00:00.000Z',
+        latest: '9.9.9',
+        manifest,
+      }),
+    );
+
+    const presentation = new RecordingPresentation();
+    const driver = new PythinkerTUI(
+      makeHarness() as never,
+      makeStartupInput(),
+      presentation,
+    ) as unknown as UpdatePollDriver;
+
+    try {
+      driver.startUpdateStatusPolling();
+      await vi.waitFor(
+        () => {
+          expect(footerStatusItems(presentation.footerModels.at(-1))).toContain('↑ v9.9.9');
+        },
+        { timeout: 10_000, interval: 50 },
+      );
+
+      writeFileSync(
+        join(updates, 'install.json'),
+        JSON.stringify({
+          active: {
+            version: '9.9.9',
+            source: 'native',
+            startedAt: new Date().toISOString(),
+            pid: process.pid,
+            progress: {
+              state: 'downloading',
+              percent: 42,
+              transferred: 5_320_000,
+              total: 12_600_000,
+              updatedAt: new Date().toISOString(),
+            },
+          },
+          pending: null,
+          lastFailure: null,
+          lastSuccess: null,
+        }),
+      );
+      await vi.waitFor(
+        () => {
+          expect(footerStatusItems(presentation.footerModels.at(-1))).toContain(
+            '↓ v9.9.9 ▰▰▰▱▱▱▱▱ 42%',
+          );
+        },
+        { timeout: 10_000, interval: 50 },
+      );
+    } finally {
+      driver.stopUpdateStatusPolling();
+      driver.state.footer.dispose();
+      if (previousHome === undefined) delete process.env['PYTHINKER_CODE_HOME'];
+      else process.env['PYTHINKER_CODE_HOME'] = previousHome;
+      rmSync(home, { recursive: true, force: true });
+    }
+  }, 30_000);
+});