@blackbelt-technology/pi-agent-dashboard 0.3.0 → 0.4.0

package/packages/shared/src/__tests__/bootstrap/cube.ts

@@ -0,0 +1,66 @@
+/**
+ * Cube sweep — fail-closed check that every cell is either registered
+ * or explicitly skipped with a reason.
+ *
+ * See openspec/changes/bootstrap-resolution-harness/design.md §5.
+ */
+import {
+  REGISTERED_SCENARIOS,
+  SKIPPED_SCENARIOS,
+  cellKey,
+  enumerateCube,
+  type ScenarioCell,
+} from "./scenarios.js";
+
+export interface CubeReport {
+  total: number;
+  registered: number;
+  skipped: number;
+  unclassified: ScenarioCell[];
+}
+
+/**
+ * Sweep the cube. Returns a report with the list of cells that have
+ * no test and no skip marker.
+ */
+export function sweepCube(): CubeReport {
+  const all = enumerateCube();
+  const unclassified: ScenarioCell[] = [];
+  let registered = 0;
+  let skipped = 0;
+  for (const cell of all) {
+    const key = cellKey(cell);
+    if (REGISTERED_SCENARIOS.has(key)) {
+      registered++;
+    } else if (SKIPPED_SCENARIOS.has(key)) {
+      skipped++;
+    } else {
+      unclassified.push(cell);
+    }
+  }
+  return { total: all.length, registered, skipped, unclassified };
+}
+
+/**
+ * Build a human-readable error message for unclassified cells.
+ * Truncates at a sensible length; full list printed to stderr.
+ */
+export function formatUnclassifiedError(report: CubeReport): string {
+  const lines: string[] = [];
+  lines.push(
+    `Cube sweep: ${report.unclassified.length} unclassified cell(s) ` +
+      `(${report.registered} registered, ${report.skipped} skipped, ${report.total} total).`,
+  );
+  lines.push("");
+  lines.push("Add each to either REGISTERED_SCENARIOS (via a family-test file) or");
+  lines.push('SKIPPED_SCENARIOS with a reason (via scenarios-skipped.ts).');
+  lines.push("");
+  const preview = report.unclassified.slice(0, 20);
+  for (const cell of preview) {
+    lines.push(`  ${cellKey(cell)}`);
+  }
+  if (report.unclassified.length > preview.length) {
+    lines.push(`  ... and ${report.unclassified.length - preview.length} more`);
+  }
+  return lines.join("\n");
+}

package/packages/shared/src/__tests__/bootstrap/families/__snapshots__/a-electron.test.ts.snap

@@ -0,0 +1,83 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`Family A — electron-packaged > A1 — electron-fresh (bundled dashboard, no pi) > resolves nothing for pi (darwin) 1`] = `
+"name:   pi
+ok:     false
+source: —
+path:   —
+tried:
+  override     no override set
+  managed      missing: <HOME>/.pi-dashboard/node_modules/.bin/pi
+  where        not found on PATH"
+`;
+
+exports[`Family A — electron-packaged > A1 — electron-fresh (bundled dashboard, no pi) > resolves nothing for pi (linux) 1`] = `
+"name:   pi
+ok:     false
+source: —
+path:   —
+tried:
+  override     no override set
+  managed      missing: <HOME>/.pi-dashboard/node_modules/.bin/pi
+  where        not found on PATH"
+`;
+
+exports[`Family A — electron-packaged > A1 — electron-fresh (bundled dashboard, no pi) > resolves nothing for pi (win32) 1`] = `
+"name:   pi
+ok:     false
+source: —
+path:   —
+tried:
+  override     no override set
+  bare-import  cannot resolve @mariozechner/pi-coding-agent/package.json
+  bare-import  cannot resolve @oh-my-pi/pi-coding-agent/package.json
+  managed      missing: <HOME>/.pi-dashboard/node_modules/@mariozechner/pi-coding-agent/dist/cli.js
+  managed      missing: <HOME>/.pi-dashboard/node_modules/@oh-my-pi/pi-coding-agent/dist/cli.js
+  npm-global   missing: <NPM_ROOT>/@mariozechner/pi-coding-agent/dist/cli.js
+  npm-global   missing: <NPM_ROOT>/@oh-my-pi/pi-coding-agent/dist/cli.js
+  managed      missing: <HOME>/.pi-dashboard/node_modules/.bin/pi.cmd
+  where        not found on PATH"
+`;
+
+exports[`Family A — electron-packaged > A2 — electron-prewarmed (bundled + managed pi) > resolves pi via managed (darwin) 1`] = `
+"name:   pi
+ok:     true
+source: managed
+path:   <HOME>/.pi-dashboard/node_modules/.bin/pi
+tried:
+  override     no override set
+  managed      ok"
+`;
+
+exports[`Family A — electron-packaged > A2 — electron-prewarmed (bundled + managed pi) > resolves pi via managed (linux) 1`] = `
+"name:   pi
+ok:     true
+source: managed
+path:   <HOME>/.pi-dashboard/node_modules/.bin/pi
+tried:
+  override     no override set
+  managed      ok"
+`;
+
+exports[`Family A — electron-packaged > A2 — electron-prewarmed (bundled + managed pi) > resolves pi via managed (win32) 1`] = `
+"name:   pi
+ok:     true
+source: managed
+path:   <HOME>/.pi-dashboard/node_modules/@mariozechner/pi-coding-agent/dist/cli.js
+tried:
+  override     no override set
+  bare-import  cannot resolve @mariozechner/pi-coding-agent/package.json
+  bare-import  cannot resolve @oh-my-pi/pi-coding-agent/package.json
+  managed      ok"
+`;
+
+exports[`Family A — electron-packaged > A3 — electron + pre-existing global pi > global npm pi takes precedence over managed-bin fallback (linux) 1`] = `
+"name:   pi
+ok:     true
+source: system
+path:   /usr/local/bin/pi
+tried:
+  override     no override set
+  managed      missing: <HOME>/.pi-dashboard/node_modules/.bin/pi
+  where        ok"
+`;

package/packages/shared/src/__tests__/bootstrap/families/__snapshots__/b-npm-global.test.ts.snap

@@ -0,0 +1,89 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`Family B — npm-global > B1 — npm-g dash-only (⚠ captures current Windows bug) > pi unresolved on darwin 1`] = `
+"name:   pi
+ok:     false
+source: —
+path:   —
+tried:
+  override     no override set
+  managed      missing: <HOME>/.pi-dashboard/node_modules/.bin/pi
+  where        not found on PATH"
+`;
+
+exports[`Family B — npm-global > B1 — npm-g dash-only (⚠ captures current Windows bug) > pi unresolved on linux 1`] = `
+"name:   pi
+ok:     false
+source: —
+path:   —
+tried:
+  override     no override set
+  managed      missing: <HOME>/.pi-dashboard/node_modules/.bin/pi
+  where        not found on PATH"
+`;
+
+exports[`Family B — npm-global > B1 — npm-g dash-only (⚠ captures current Windows bug) > pi unresolved on win32 1`] = `
+"name:   pi
+ok:     false
+source: —
+path:   —
+tried:
+  override     no override set
+  bare-import  cannot resolve @mariozechner/pi-coding-agent/package.json
+  bare-import  cannot resolve @oh-my-pi/pi-coding-agent/package.json
+  managed      missing: <HOME>/.pi-dashboard/node_modules/@mariozechner/pi-coding-agent/dist/cli.js
+  managed      missing: <HOME>/.pi-dashboard/node_modules/@oh-my-pi/pi-coding-agent/dist/cli.js
+  npm-global   missing: <NPM_ROOT>/@mariozechner/pi-coding-agent/dist/cli.js
+  npm-global   missing: <NPM_ROOT>/@oh-my-pi/pi-coding-agent/dist/cli.js
+  managed      missing: <HOME>/.pi-dashboard/node_modules/.bin/pi.cmd
+  where        not found on PATH"
+`;
+
+exports[`Family B — npm-global > B2 — npm-g full (pi + openspec via global npm) > pi resolves via npm-global on darwin 1`] = `
+"name:   pi
+ok:     true
+source: system
+path:   /usr/local/bin/pi
+tried:
+  override     no override set
+  managed      missing: <HOME>/.pi-dashboard/node_modules/.bin/pi
+  where        ok"
+`;
+
+exports[`Family B — npm-global > B2 — npm-g full (pi + openspec via global npm) > pi resolves via npm-global on linux 1`] = `
+"name:   pi
+ok:     true
+source: system
+path:   /usr/local/bin/pi
+tried:
+  override     no override set
+  managed      missing: <HOME>/.pi-dashboard/node_modules/.bin/pi
+  where        ok"
+`;
+
+exports[`Family B — npm-global > B2 — npm-g full (pi + openspec via global npm) > pi resolves via npm-global on win32 (with node.exe toArgv) 1`] = `
+"name:   pi
+ok:     true
+source: npm-global
+path:   <NPM_ROOT>/@mariozechner/pi-coding-agent/dist/cli.js
+tried:
+  override     no override set
+  bare-import  cannot resolve @mariozechner/pi-coding-agent/package.json
+  bare-import  cannot resolve @oh-my-pi/pi-coding-agent/package.json
+  managed      missing: <HOME>/.pi-dashboard/node_modules/@mariozechner/pi-coding-agent/dist/cli.js
+  managed      missing: <HOME>/.pi-dashboard/node_modules/@oh-my-pi/pi-coding-agent/dist/cli.js
+  npm-global   ok
+argv:
+  - C:/Program Files/nodejs/node.exe
+  - <NPM_ROOT>/@mariozechner/pi-coding-agent/dist/cli.js"
+`;
+
+exports[`Family B — npm-global > B3 — npm-g pi-installed-first (bridge needs registration) > settings.json present but lacks bridge entry (linux) 1`] = `
+"settings-delta:
+  added:
+    (none)
+  removed:
+    (none)
+  preserved:
+    (none)"
+`;

package/packages/shared/src/__tests__/bootstrap/families/__snapshots__/c-dev-monorepo.test.ts.snap

@@ -0,0 +1,33 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`Family C — dev monorepo > C1 — posix (managed/where chain, no bare-import for pi) > pi chain runs on darwin 1`] = `
+"name:   pi
+ok:     false
+source: —
+path:   —
+tried:
+  override     no override set
+  managed      missing: <HOME>/.pi-dashboard/node_modules/.bin/pi
+  where        not found on PATH"
+`;
+
+exports[`Family C — dev monorepo > C1 — posix (managed/where chain, no bare-import for pi) > pi chain runs on linux 1`] = `
+"name:   pi
+ok:     false
+source: —
+path:   —
+tried:
+  override     no override set
+  managed      missing: <HOME>/.pi-dashboard/node_modules/.bin/pi
+  where        not found on PATH"
+`;
+
+exports[`Family C — dev monorepo > C2 — win32 (bare-import from workspace) > resolves pi via workspace bare-import 1`] = `
+"name:   pi
+ok:     true
+source: bare-import
+path:   dist/cli.js
+tried:
+  override     no override set
+  bare-import  ok"
+`;

package/packages/shared/src/__tests__/bootstrap/families/__snapshots__/d-overrides.test.ts.snap

@@ -0,0 +1,20 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`Family D — overrides > D1 — override-valid: pi resolves via override 1`] = `
+"name:   pi
+ok:     true
+source: override
+path:   /opt/custom/bin/pi
+tried:
+  override     ok"
+`;
+
+exports[`Family D — overrides > D2 — override-invalid: path doesn't exist, chain falls through 1`] = `
+"name:   pi
+ok:     true
+source: managed
+path:   <HOME>/.pi-dashboard/node_modules/.bin/pi
+tried:
+  override     invalid: path does not exist: /nonexistent/broken/pi
+  managed      ok"
+`;

package/packages/shared/src/__tests__/bootstrap/families/__snapshots__/e-stale-partial.test.ts.snap

@@ -0,0 +1,61 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`Family E — stale / partial > E1 — stale managed pi (old version) > current strategies resolve without version gating (darwin) 1`] = `
+"name:   pi
+ok:     true
+source: managed
+path:   <HOME>/.pi-dashboard/node_modules/.bin/pi
+tried:
+  override     no override set
+  managed      ok"
+`;
+
+exports[`Family E — stale / partial > E1 — stale managed pi (old version) > current strategies resolve without version gating (linux) 1`] = `
+"name:   pi
+ok:     true
+source: managed
+path:   <HOME>/.pi-dashboard/node_modules/.bin/pi
+tried:
+  override     no override set
+  managed      ok"
+`;
+
+exports[`Family E — stale / partial > E1 — stale managed pi (old version) > current strategies resolve without version gating (win32) 1`] = `
+"name:   pi
+ok:     true
+source: managed
+path:   <HOME>/.pi-dashboard/node_modules/@mariozechner/pi-coding-agent/dist/cli.js
+tried:
+  override     no override set
+  bare-import  cannot resolve @mariozechner/pi-coding-agent/package.json
+  bare-import  cannot resolve @oh-my-pi/pi-coding-agent/package.json
+  managed      ok"
+`;
+
+exports[`Family E — stale / partial > E2 — partial managed install (package.json, no dist) > strategy skips when entry file absent (linux) 1`] = `
+"name:   pi
+ok:     false
+source: —
+path:   —
+tried:
+  override     no override set
+  managed      missing: <HOME>/.pi-dashboard/node_modules/.bin/pi
+  where        not found on PATH"
+`;
+
+exports[`Family E — stale / partial > E2 — partial managed install (package.json, no dist) > strategy skips when entry file absent (win32) 1`] = `
+"name:   pi
+ok:     false
+source: —
+path:   —
+tried:
+  override     no override set
+  bare-import  cannot resolve @mariozechner/pi-coding-agent/package.json
+  bare-import  cannot resolve @oh-my-pi/pi-coding-agent/package.json
+  managed      missing: <HOME>/.pi-dashboard/node_modules/@mariozechner/pi-coding-agent/dist/cli.js
+  managed      missing: <HOME>/.pi-dashboard/node_modules/@oh-my-pi/pi-coding-agent/dist/cli.js
+  npm-global   missing: <NPM_ROOT>/@mariozechner/pi-coding-agent/dist/cli.js
+  npm-global   missing: <NPM_ROOT>/@oh-my-pi/pi-coding-agent/dist/cli.js
+  managed      missing: <HOME>/.pi-dashboard/node_modules/.bin/pi.cmd
+  where        not found on PATH"
+`;

package/packages/shared/src/__tests__/bootstrap/families/__snapshots__/f-cwd-variants.test.ts.snap

@@ -0,0 +1,33 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`Family F — cwd variants > F1 — resolves normally with Program Files (x86) cwd (win32) 1`] = `
+"name:   pi
+ok:     true
+source: managed
+path:   <HOME>/.pi-dashboard/node_modules/@mariozechner/pi-coding-agent/dist/cli.js
+tried:
+  override     no override set
+  bare-import  cannot resolve @mariozechner/pi-coding-agent/package.json
+  bare-import  cannot resolve @oh-my-pi/pi-coding-agent/package.json
+  managed      ok"
+`;
+
+exports[`Family F — cwd variants > F1 — resolves normally with spaces in cwd (linux) 1`] = `
+"name:   pi
+ok:     true
+source: managed
+path:   <HOME>/.pi-dashboard/node_modules/.bin/pi
+tried:
+  override     no override set
+  managed      ok"
+`;
+
+exports[`Family F — cwd variants > F2 — resolves with Greek/Cyrillic/emoji in cwd 1`] = `
+"name:   pi
+ok:     true
+source: managed
+path:   <HOME>/.pi-dashboard/node_modules/.bin/pi
+tried:
+  override     no override set
+  managed      ok"
+`;

package/packages/shared/src/__tests__/bootstrap/families/__snapshots__/g-windows-specifics.test.ts.snap

@@ -0,0 +1,46 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`Family G — Windows specifics > G1 — pi.cmd resolved + toArgv prepends node.exe (no-cmd-flash) 1`] = `
+"name:   pi
+ok:     true
+source: managed
+path:   <HOME>/.pi-dashboard/node_modules/@mariozechner/pi-coding-agent/dist/cli.js
+tried:
+  override     no override set
+  bare-import  cannot resolve @mariozechner/pi-coding-agent/package.json
+  bare-import  cannot resolve @oh-my-pi/pi-coding-agent/package.json
+  managed      ok
+argv:
+  - C:/Program Files/nodejs/node.exe
+  - <HOME>/.pi-dashboard/node_modules/@mariozechner/pi-coding-agent/dist/cli.js"
+`;
+
+exports[`Family G — Windows specifics > G2 — npm-g at %APPDATA%\\Roaming\\npm (argv prepends node.exe) 1`] = `
+"name:   pi
+ok:     true
+source: npm-global
+path:   <NPM_ROOT>/@mariozechner/pi-coding-agent/dist/cli.js
+tried:
+  override     no override set
+  bare-import  cannot resolve @mariozechner/pi-coding-agent/package.json
+  bare-import  cannot resolve @oh-my-pi/pi-coding-agent/package.json
+  managed      missing: <HOME>/.pi-dashboard/node_modules/@mariozechner/pi-coding-agent/dist/cli.js
+  managed      missing: <HOME>/.pi-dashboard/node_modules/@oh-my-pi/pi-coding-agent/dist/cli.js
+  npm-global   ok
+argv:
+  - C:/Program Files/nodejs/node.exe
+  - <NPM_ROOT>/@mariozechner/pi-coding-agent/dist/cli.js"
+`;
+
+exports[`Family G — Windows specifics > G4 — node.exe at C:\\Program Files\\nodejs\\node.exe 1`] = `
+"name:   node
+ok:     true
+source: system
+path:   C:/Program Files/nodejs/node.exe
+tried:
+  override     no override set
+  managed      missing: <HOME>/.pi-dashboard/node_modules/.bin/node.cmd
+  where        ok
+argv:
+  - C:/Program Files/nodejs/node.exe"
+`;

package/packages/shared/src/__tests__/bootstrap/families/__snapshots__/j-path-gui-minimal.test.ts.snap

@@ -0,0 +1,12 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`Family J — minimal PATH > J1 — GUI-launched minimal PATH: pi does NOT resolve on posix (limitation) 1`] = `
+"name:   pi
+ok:     false
+source: —
+path:   —
+tried:
+  override     no override set
+  managed      missing: <HOME>/.pi-dashboard/node_modules/.bin/pi
+  where        not found on PATH"
+`;

package/packages/shared/src/__tests__/bootstrap/families/a-electron.test.ts

@@ -0,0 +1,156 @@
+/**
+ * Family A — Electron-packaged dashboard scenarios.
+ *
+ * A1: electron-fresh   — bundled dashboard, no pi, no settings.
+ * A2: electron-prewarmed — bundled dashboard, managed pi+openspec, valid settings.
+ *
+ * Full family (A3, A4) lands as cells are activated in tasks.md §6.
+ */
+import { describe, expect, it } from "vitest";
+import { withFakeEnv, layer } from "../harness.js";
+import { registerDefaultTools } from "../../../tool-registry/definitions.js";
+import * as fixtures from "../fixtures/index.js";
+import { snapshotTrail } from "../assertions.js";
+import { register, SKIPPED_SCENARIOS, cellKey } from "../scenarios.js";
+
+// Register the cells this file covers. Overrides the bulk-skip from
+// scenarios-skipped.ts. Runs at module import.
+const A1: Parameters<typeof register>[0][] = [
+  { platform: "linux", dash: "electron", pi: "absent", settings: "missing", env: "normal" },
+  { platform: "darwin", dash: "electron", pi: "absent", settings: "missing", env: "normal" },
+  { platform: "win32", dash: "electron", pi: "absent", settings: "missing", env: "normal" },
+];
+const A2: Parameters<typeof register>[0][] = [
+  { platform: "linux", dash: "electron", pi: "present-valid", settings: "valid", env: "normal" },
+  { platform: "darwin", dash: "electron", pi: "present-valid", settings: "valid", env: "normal" },
+  { platform: "win32", dash: "electron", pi: "present-valid", settings: "valid", env: "normal" },
+];
+// A3: electron bundled + global pi (user had pi before installing dashboard).
+const A3: Parameters<typeof register>[0][] = [
+  { platform: "linux", dash: "electron", pi: "present-no-ext", settings: "valid", env: "normal" },
+];
+// A4: linux AppImage first run (temp mount; bridge registration skipped).
+const A4: Parameters<typeof register>[0][] = [
+  { platform: "linux", dash: "electron", pi: "appimage-tmp", settings: "missing", env: "normal" },
+];
+for (const cell of [...A1, ...A2, ...A3, ...A4]) {
+  register(cell, "families/a-electron.test.ts");
+  SKIPPED_SCENARIOS.delete(cellKey(cell));
+}
+
+describe("Family A — electron-packaged", () => {
+  describe("A1 — electron-fresh (bundled dashboard, no pi)", () => {
+    it.each(["linux", "darwin", "win32"] as const)(
+      "resolves nothing for pi (%s)",
+      async (platform) => {
+        const homedir = platform === "win32" ? "C:\\Users\\R" : "/home/r";
+        await withFakeEnv(
+          {
+            platform,
+            homedir,
+            env: { PATH: platform === "win32" ? "C:\\Windows\\System32" : "/usr/bin" },
+            fs: layer(fixtures.electronPackaged({ platform })),
+          },
+          (ctx) => {
+            const registry = ctx.createRegistry();
+            registerDefaultTools(registry, ctx.createStrategyDeps());
+            const res = registry.resolve("pi");
+            expect(res.ok).toBe(false);
+            expect(snapshotTrail(res, ctx)).toMatchSnapshot();
+          },
+        );
+      },
+    );
+  });
+
+  describe("A2 — electron-prewarmed (bundled + managed pi)", () => {
+    it.each(["linux", "darwin", "win32"] as const)(
+      "resolves pi via managed (%s)",
+      async (platform) => {
+        const homedir = platform === "win32" ? "C:\\Users\\R" : "/home/r";
+        await withFakeEnv(
+          {
+            platform,
+            homedir,
+            env: { PATH: platform === "win32" ? "C:\\Windows\\System32" : "/usr/bin" },
+            fs: layer(
+              fixtures.electronPackaged({ platform }),
+              fixtures.managedInstall({ homedir, platform }),
+              fixtures.settingsJson({
+                homedir,
+                platform,
+                packages: [
+                  platform === "win32"
+                    ? "C:\\Program Files\\PI Dashboard\\resources\\server\\packages\\extension"
+                    : "/usr/lib/pi-dashboard/resources/server/packages/extension",
+                ],
+              }),
+            ),
+          },
+          (ctx) => {
+            const registry = ctx.createRegistry();
+            registerDefaultTools(registry, ctx.createStrategyDeps());
+            const res = registry.resolve("pi");
+            expect(res.ok).toBe(true);
+            expect(res.source).toBe("managed");
+            expect(snapshotTrail(res, ctx)).toMatchSnapshot();
+          },
+        );
+      },
+    );
+  });
+
+  describe("A3 — electron + pre-existing global pi", () => {
+    it("global npm pi takes precedence over managed-bin fallback (linux)", async () => {
+      const homedir = "/home/r";
+      await withFakeEnv(
+        {
+          platform: "linux",
+          homedir,
+          env: { PATH: "/usr/local/bin" },
+          fs: layer(
+            fixtures.electronPackaged({ platform: "linux" }),
+            fixtures.npmGlobalUnix({}),
+            fixtures.settingsJson({ homedir, platform: "linux", packages: [] }),
+          ),
+        },
+        (ctx) => {
+          const registry = ctx.createRegistry();
+          registerDefaultTools(registry, ctx.createStrategyDeps());
+          const res = registry.resolve("pi");
+          // pi chain on posix: override → managed-bin → where.
+          // No managed install present; `where` finds /usr/local/bin/pi.
+          expect(res.ok).toBe(true);
+          expect(res.source).toBe("system");
+          expect(snapshotTrail(res, ctx)).toMatchSnapshot();
+        },
+      );
+    });
+  });
+
+  describe("A4 — AppImage first run (temp mount)", () => {
+    it("findBundledExtension rejects /tmp/.mount_* paths", async () => {
+      const homedir = "/home/r";
+      await withFakeEnv(
+        {
+          platform: "linux",
+          homedir,
+          fs: fixtures.electronPackaged({ platform: "linux", appimage: true }),
+        },
+        (ctx) => {
+          // The bundled extension resolved by findBundledExtension when
+          // running from an AppImage temp mount would be under
+          // `/tmp/.mount_*/...`. The real implementation rejects those
+          // paths explicitly (bridge-register.ts). Here we just verify
+          // the fixture places files where the temp-mount detection
+          // would fire.
+          const paths = fixtures.electronPaths({ platform: "linux", appimage: true });
+          expect(paths.extensionDir).toContain("/tmp/.mount_");
+          expect(ctx.fs.existsSync(paths.extensionDir + "/package.json")).toBe(true);
+          // Full round-trip rejection lives in bridge-register unit
+          // tests; this family cell confirms only the fixture shape.
+        },
+      );
+    });
+  });
+});