@blackbelt-technology/pi-agent-dashboard 0.4.6 → 0.5.1

package/packages/server/src/spawn-preflight.ts

@@ -0,0 +1,82 @@
+/**
+ * Synchronous spawn preflight check.
+ *
+ * Runs before every `spawnPiSession` invocation to catch fast-fail conditions
+ * (bad cwd, missing binaries) without racing the spawn itself. All checks run
+ * regardless of earlier failures so the caller gets all reasons in one pass.
+ *
+ * The ToolResolver passed in MUST have `useLoginShell: false` — preflight
+ * must never spawn a login shell on the spawn-click hot path. If a resolver
+ * with `useLoginShell: true` is passed, the check still runs but a one-time
+ * warning is emitted.
+ *
+ * See change: spawn-failure-diagnostics.
+ */
+import { existsSync, accessSync, statSync, constants } from "node:fs";
+import { ToolResolver } from "@blackbelt-technology/pi-dashboard-shared/platform/binary-lookup.js";
+
+export interface PreflightReason {
+  code: string;
+  message: string;
+}
+
+export interface PreflightResult {
+  ok: boolean;
+  reasons: PreflightReason[];
+}
+
+/**
+ * Run all preflight checks for `cwd` and return the accumulated reasons.
+ * `ok` is `true` iff `reasons.length === 0`.
+ *
+ * @param deps.resolver - Must be constructed with `useLoginShell: false`.
+ *   If omitted, a login-shell-disabled resolver is created automatically.
+ *   Passing a resolver with `useLoginShell: true` violates the preflight
+ *   contract; the function still runs but may call into the login shell.
+ */
+export function preflightSpawn(
+  cwd: string,
+  deps?: { resolver?: ToolResolver },
+): PreflightResult {
+  const resolver = deps?.resolver ?? new ToolResolver({ processExecPath: process.execPath, useLoginShell: false });
+
+  const reasons: PreflightReason[] = [];
+
+  // 1. cwd exists
+  const cwdExists = existsSync(cwd);
+  if (!cwdExists) {
+    reasons.push({ code: "DIR_MISSING", message: `Directory does not exist: ${cwd}` });
+    // No point checking isDirectory / writable if it doesn't exist.
+  } else {
+    // 2. cwd is a directory
+    try {
+      const stat = statSync(cwd);
+      if (!stat.isDirectory()) {
+        reasons.push({ code: "DIR_NOT_DIRECTORY", message: `Path is not a directory: ${cwd}` });
+      }
+    } catch (err: any) {
+      reasons.push({ code: "DIR_NOT_DIRECTORY", message: `Cannot stat path: ${err.message}` });
+    }
+
+    // 3. cwd is writable
+    try {
+      accessSync(cwd, constants.W_OK);
+    } catch {
+      reasons.push({ code: "DIR_NOT_WRITABLE", message: `Directory is not writable: ${cwd}` });
+    }
+  }
+
+  // 4. pi resolves
+  const piCmd = resolver.resolvePi();
+  if (piCmd === null) {
+    reasons.push({ code: "PI_NOT_FOUND", message: "pi binary not found via managed install or system PATH" });
+  }
+
+  // 5. node resolves
+  const nodeCmd = resolver.resolveNode();
+  if (nodeCmd === null) {
+    reasons.push({ code: "NODE_NOT_FOUND", message: "node binary not found via managed install or system PATH" });
+  }
+
+  return { ok: reasons.length === 0, reasons };
+}

package/packages/server/src/spawn-register-watchdog.ts

@@ -0,0 +1,291 @@
+/**
+ * Spawn-register watchdog.
+ *
+ * Arms a per-spawn timer after every successful `spawnPiSession`. If the
+ * spawned pi session never sends `session_register` within the timeout
+ * window, emits `spawn_register_timeout` to the originating WebSocket.
+ *
+ * Two index maps handle the two spawn families:
+ *  - `byPid` — headless spawns where the dashboard owns the PID.
+ *  - `byCwd` — tmux/wt/wsl-tmux spawns where any `session_register` from
+ *    that directory clears the watch.
+ *
+ * Late registrations (pi finally registers after the watchdog fired) are
+ * detected via `recentlyFired` (60 s TTL) and cause a `spawn_register_recovered`
+ * message to auto-clear the timeout banner.
+ *
+ * See change: spawn-failure-diagnostics.
+ */
+import WebSocket from "ws";
+import { readFileSync } from "node:fs";
+import type { SpawnMechanism } from "@blackbelt-technology/pi-dashboard-shared/platform/spawn-mechanism.js";
+import type {
+  SpawnRegisterTimeoutMessage,
+  SpawnRegisterRecoveredMessage,
+} from "@blackbelt-technology/pi-dashboard-shared/browser-protocol.js";
+import { clampSpawnRegisterTimeoutMs, loadConfig } from "@blackbelt-technology/pi-dashboard-shared/config.js";
+import { appendSpawnFailure } from "./spawn-failure-log.js";
+
+export interface WatchdogArmOptions {
+  pid?: number;
+  cwd: string;
+  mechanism: SpawnMechanism;
+  logPath?: string;
+  ws: WebSocket;
+  /**
+   * Server-minted spawn correlation token. When provided, the entry is
+   * indexed in `byToken` for strong-identity clearing via `clearByToken`.
+   * See change: spawn-correlation-token.
+   */
+  spawnToken?: string;
+}
+
+interface Entry {
+  timer: ReturnType<typeof setTimeout>;
+  cwd: string;
+  pid?: number;
+  mechanism: SpawnMechanism;
+  logPath?: string;
+  ws: WebSocket;
+  timeoutMs: number;
+  spawnToken?: string;
+}
+
+interface RecentlyFiredEntry {
+  firedAt: number;
+  pid?: number;
+  ws: WebSocket;
+  spawnToken?: string;
+}
+
+const RECENTLY_FIRED_TTL_MS = 60_000;
+
+export class SpawnRegisterWatchdog {
+  /** Default timeout used when arm() callers do not supply one. */
+  readonly timeoutMs: number;
+  private readonly byPid = new Map<number, Entry>();
+  private readonly byCwd = new Map<string, Entry>();
+  private readonly byToken = new Map<string, Entry>();
+  private readonly recentlyFired = new Map<string, RecentlyFiredEntry>();
+
+  constructor(timeoutMs: number) {
+    this.timeoutMs = clampSpawnRegisterTimeoutMs(timeoutMs);
+  }
+
+  arm(opts: WatchdogArmOptions & { timeoutMs?: number }): void {
+    // Read-on-arm: caller passes the current config value so a Settings change
+    // takes effect on the next spawn without a server restart.
+    // See change: spawn-failure-diagnostics (fix W1).
+    const effectiveTimeout = clampSpawnRegisterTimeoutMs(opts.timeoutMs ?? this.timeoutMs);
+    const { pid, cwd, mechanism, logPath, ws, spawnToken } = opts;
+    const entry: Entry = {
+      timer: null as unknown as ReturnType<typeof setTimeout>,
+      cwd, pid, mechanism, logPath, ws,
+      timeoutMs: effectiveTimeout,
+      spawnToken,
+    };
+    entry.timer = setTimeout(() => this._fireEntry(entry), effectiveTimeout);
+    // Always index by cwd so a `session_register` clears the watchdog even
+    // when the bridge's reported pid differs from the spawner's pid (e.g.
+    // Unix headless wraps pi in `sh -c "tail -f /dev/null | pi …"`, so
+    // spawnResult.pid is the sh wrapper, not pi). Index by pid additionally
+    // for late-recovery lookup. Index by token (when provided) for
+    // strong-identity clearing. See change: spawn-correlation-token.
+    // Replace any prior entry for the same cwd/pid/token to avoid leaking timers.
+    const priorCwd = this.byCwd.get(cwd);
+    if (priorCwd) clearTimeout(priorCwd.timer);
+    this.byCwd.set(cwd, entry);
+    if (pid !== undefined) {
+      const priorPid = this.byPid.get(pid);
+      if (priorPid && priorPid !== priorCwd) clearTimeout(priorPid.timer);
+      this.byPid.set(pid, entry);
+    }
+    if (spawnToken) {
+      const priorTok = this.byToken.get(spawnToken);
+      if (priorTok && priorTok !== priorCwd && priorTok !== entry) clearTimeout(priorTok.timer);
+      this.byToken.set(spawnToken, entry);
+    }
+  }
+
+  /**
+   * Strong-identity clear: cancel watchdog for this exact spawn invocation.
+   * Tier 1 of the three-tier match in `event-wiring.ts`. Removes the entry
+   * from all three indices. See change: spawn-correlation-token.
+   */
+  clearByToken(spawnToken: string): void {
+    const entry = this.byToken.get(spawnToken);
+    if (entry) {
+      clearTimeout(entry.timer);
+      this.byToken.delete(spawnToken);
+      const cwdEntry = this.byCwd.get(entry.cwd);
+      if (cwdEntry === entry) this.byCwd.delete(entry.cwd);
+      if (entry.pid !== undefined) {
+        const pidEntry = this.byPid.get(entry.pid);
+        if (pidEntry === entry) this.byPid.delete(entry.pid);
+      }
+      return;
+    }
+    // Check for late recovery: scan recentlyFired for matching token.
+    for (const [cwd, fired] of this.recentlyFired) {
+      if (fired.spawnToken === spawnToken) {
+        this._emitRecovery(cwd, fired);
+        return;
+      }
+    }
+  }
+
+  clearByPid(pid: number): void {
+    const entry = this.byPid.get(pid);
+    if (entry) {
+      clearTimeout(entry.timer);
+      this.byPid.delete(pid);
+      // Also clear cwd / token entries if they point at the same arm.
+      const cwdEntry = this.byCwd.get(entry.cwd);
+      if (cwdEntry === entry) this.byCwd.delete(entry.cwd);
+      if (entry.spawnToken) {
+        const tokEntry = this.byToken.get(entry.spawnToken);
+        if (tokEntry === entry) this.byToken.delete(entry.spawnToken);
+      }
+      return;
+    }
+    // Check for late recovery.
+    this._checkRecoveryByPid(pid);
+  }
+
+  clearByCwd(cwd: string): void {
+    const entry = this.byCwd.get(cwd);
+    if (entry) {
+      clearTimeout(entry.timer);
+      this.byCwd.delete(cwd);
+      // Also clear pid / token entries if they point at the same arm.
+      if (entry.pid !== undefined) {
+        const pidEntry = this.byPid.get(entry.pid);
+        if (pidEntry === entry) this.byPid.delete(entry.pid);
+      }
+      if (entry.spawnToken) {
+        const tokEntry = this.byToken.get(entry.spawnToken);
+        if (tokEntry === entry) this.byToken.delete(entry.spawnToken);
+      }
+      return;
+    }
+    // Check for late recovery.
+    this._checkRecoveryByCwd(cwd);
+  }
+
+  private _fireEntry(entry: Entry): void {
+    const { cwd, pid, logPath, ws, timeoutMs: entryTimeoutMs } = entry;
+    // Remove from active maps.
+    if (pid !== undefined) {
+      const pidEntry = this.byPid.get(pid);
+      if (pidEntry === entry) this.byPid.delete(pid);
+    }
+    const cwdEntry = this.byCwd.get(cwd);
+    if (cwdEntry === entry) this.byCwd.delete(cwd);
+
+    // Record in recentlyFired for late-recovery detection (also drop token entry).
+    if (entry.spawnToken) {
+      const tokEntry = this.byToken.get(entry.spawnToken);
+      if (tokEntry === entry) this.byToken.delete(entry.spawnToken);
+    }
+    this.recentlyFired.set(cwd, { firedAt: Date.now(), pid, ws, spawnToken: entry.spawnToken });
+
+    // Read stderr tail if logPath available.
+    let stderrTail: string | undefined;
+    if (logPath) {
+      stderrTail = readLogTail(logPath);
+    }
+
+    // Persist the timeout to the rolling failure log. See change: spawn-failure-diagnostics.
+    appendSpawnFailure({
+      ts: new Date().toISOString(),
+      cwd,
+      strategy: entry.mechanism,
+      code: "REGISTER_TIMEOUT",
+      message: `Pi session spawned but never registered (timeout ${this.timeoutMs}ms)`,
+      ...(pid !== undefined ? { pid } : {}),
+      ...(stderrTail ? { stderrTail } : {}),
+    });
+
+    if (ws.readyState !== WebSocket.OPEN) return;
+
+    const msg: SpawnRegisterTimeoutMessage = {
+      type: "spawn_register_timeout",
+      cwd,
+      timeoutMs: entryTimeoutMs,
+      ...(pid !== undefined ? { pid } : {}),
+      ...(stderrTail ? { stderrTail } : {}),
+    };
+    ws.send(JSON.stringify(msg));
+  }
+
+  private _checkRecoveryByPid(pid: number): void {
+    // recentlyFired is keyed by cwd; scan to find matching pid.
+    for (const [cwd, fired] of this.recentlyFired) {
+      if (fired.pid === pid) {
+        this._emitRecovery(cwd, fired);
+        return;
+      }
+    }
+  }
+
+  private _checkRecoveryByCwd(cwd: string): void {
+    const fired = this.recentlyFired.get(cwd);
+    if (!fired) return;
+    this._emitRecovery(cwd, fired);
+  }
+
+  private _emitRecovery(cwd: string, fired: RecentlyFiredEntry): void {
+    // TTL check.
+    if (Date.now() - fired.firedAt > RECENTLY_FIRED_TTL_MS) {
+      this.recentlyFired.delete(cwd);
+      return;
+    }
+
+    this.recentlyFired.delete(cwd);
+
+    if (fired.ws.readyState !== WebSocket.OPEN) return;
+
+    const msg: SpawnRegisterRecoveredMessage = {
+      type: "spawn_register_recovered",
+      cwd,
+      ...(fired.pid !== undefined ? { pid: fired.pid } : {}),
+    };
+    fired.ws.send(JSON.stringify(msg));
+  }
+}
+
+// ── Singleton ────────────────────────────────────────────────────────────────
+
+let _instance: SpawnRegisterWatchdog | null = null;
+
+/**
+ * Lazy singleton. On first call, reads `spawnRegisterTimeoutMs` from config.
+ * Tests can swap the instance via `_setSpawnRegisterWatchdogForTests`.
+ */
+export function getSpawnRegisterWatchdog(): SpawnRegisterWatchdog {
+  if (!_instance) {
+    const config = loadConfig();
+    _instance = new SpawnRegisterWatchdog(config.spawnRegisterTimeoutMs);
+  }
+  return _instance;
+}
+
+/** Swap the singleton for tests. Pass `null` to reset. */
+export function _setSpawnRegisterWatchdogForTests(w: SpawnRegisterWatchdog | null): void {
+  _instance = w;
+}
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+
+function readLogTail(filePath: string, maxBytes = 4096): string | undefined {
+  try {
+    const buf = readFileSync(filePath);
+    if (!buf.length) return undefined;
+    const slice = buf.length <= maxBytes ? buf : buf.slice(buf.length - maxBytes);
+    let start = 0;
+    while (start < slice.length && (slice[start]! & 0xC0) === 0x80) start++;
+    return slice.slice(start).toString("utf-8");
+  } catch {
+    return undefined;
+  }
+}

package/packages/server/src/spawn-token.ts

@@ -0,0 +1,20 @@
+/**
+ * Spawn correlation token: server-minted UUIDv4 per `spawnPiSession` call.
+ *
+ * Flow: `mintSpawnToken()` → injected into spawned process env as
+ * `PI_DASHBOARD_SPAWN_TOKEN` → bridge reads it → bridge echoes back in
+ * `session_register.spawnToken` → server links via `linkByToken`.
+ *
+ * In-memory only; no persistence. TTL aligned to spawn-register-watchdog.
+ *
+ * See change: spawn-correlation-token.
+ */
+import { randomUUID } from "node:crypto";
+
+/** Mint a fresh UUIDv4 spawn correlation token. */
+export function mintSpawnToken(): string {
+  return randomUUID();
+}
+
+/** Env-var name used for the correlation token in spawned pi processes. */
+export const SPAWN_TOKEN_ENV_VAR = "PI_DASHBOARD_SPAWN_TOKEN";

package/packages/server/src/terminal-manager.ts

@@ -185,7 +185,18 @@ export function createTerminalManager(options?: TerminalManagerOptions): Termina
         try {
           const msg: TerminalControlMessage = JSON.parse(str);
           if (msg.type === "resize") {
-            entry.pty.resize(msg.cols, msg.rows);
+            // Defense in depth: reject degenerate resize messages.
+            // A PTY at <2 cols/rows is non-functional for every supported
+            // shell binding; no legitimate user intent maps there. xterm's
+            // FitAddon is supposed to guard against zero, but a transient
+            // display:none container measured during a route transition
+            // can leak a 1 through. See change:
+            // fix-terminal-half-height-dual-mount.
+            if (msg.cols < 2 || msg.rows < 2) {
+              // ignore — keep previous PTY dimensions
+            } else {
+              entry.pty.resize(msg.cols, msg.rows);
+            }
           } else if (msg.type === "title") {
             // title control message — handled elsewhere
           } else {

package/packages/shared/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blackbelt-technology/pi-dashboard-shared",
-  "version": "0.4.6",
+  "version": "0.5.1",
   "description": "Shared types and utilities for pi-dashboard",
   "type": "module",
   "repository": {

package/packages/shared/src/__tests__/bootstrap/__snapshots__/cube.test.ts.snap

@@ -29,12 +29,12 @@ source: —
 path:   —
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   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/@earendil-works/pi-coding-agent/dist/cli.js
   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>/@earendil-works/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"
 `;
@@ -66,8 +66,9 @@ source: managed
 path:   <HOME>/.pi-dashboard/node_modules/@mariozechner/pi-coding-agent/dist/cli.js
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   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/@earendil-works/pi-coding-agent/dist/cli.js
   managed      ok"
 `;
 
@@ -111,12 +112,12 @@ source: —
 path:   —
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   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/@earendil-works/pi-coding-agent/dist/cli.js
   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>/@earendil-works/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"
 `;
@@ -150,10 +151,11 @@ source: npm-global
 path:   <NPM_ROOT>/@mariozechner/pi-coding-agent/dist/cli.js
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   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/@earendil-works/pi-coding-agent/dist/cli.js
   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>/@earendil-works/pi-coding-agent/dist/cli.js
   npm-global   ok
 argv:
   - C:/Program Files/nodejs/node.exe
@@ -199,6 +201,7 @@ source: bare-import
 path:   dist/cli.js
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   bare-import  ok"
 `;
 
@@ -248,8 +251,9 @@ source: managed
 path:   <HOME>/.pi-dashboard/node_modules/@mariozechner/pi-coding-agent/dist/cli.js
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   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/@earendil-works/pi-coding-agent/dist/cli.js
   managed      ok"
 `;
 
@@ -271,12 +275,12 @@ source: —
 path:   —
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   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/@earendil-works/pi-coding-agent/dist/cli.js
   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>/@earendil-works/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"
 `;
@@ -288,8 +292,9 @@ source: managed
 path:   <HOME>/.pi-dashboard/node_modules/@mariozechner/pi-coding-agent/dist/cli.js
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   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/@earendil-works/pi-coding-agent/dist/cli.js
   managed      ok"
 `;
 
@@ -320,8 +325,9 @@ source: managed
 path:   <HOME>/.pi-dashboard/node_modules/@mariozechner/pi-coding-agent/dist/cli.js
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   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/@earendil-works/pi-coding-agent/dist/cli.js
   managed      ok
 argv:
   - C:/Program Files/nodejs/node.exe
@@ -335,10 +341,11 @@ source: npm-global
 path:   <NPM_ROOT>/@mariozechner/pi-coding-agent/dist/cli.js
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   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/@earendil-works/pi-coding-agent/dist/cli.js
   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>/@earendil-works/pi-coding-agent/dist/cli.js
   npm-global   ok
 argv:
   - C:/Program Files/nodejs/node.exe
@@ -352,6 +359,7 @@ source: system
 path:   C:/Program Files/nodejs/node.exe
 tried:
   override     no override set
+  managed      missing: <HOME>/.pi-dashboard/node/node.exe
   managed      missing: <HOME>/.pi-dashboard/node_modules/.bin/node.cmd
   where        ok
 argv:

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

@@ -29,12 +29,12 @@ source: —
 path:   —
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   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/@earendil-works/pi-coding-agent/dist/cli.js
   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>/@earendil-works/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"
 `;
@@ -66,8 +66,9 @@ source: managed
 path:   <HOME>/.pi-dashboard/node_modules/@mariozechner/pi-coding-agent/dist/cli.js
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   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/@earendil-works/pi-coding-agent/dist/cli.js
   managed      ok"
 `;
 

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

@@ -29,12 +29,12 @@ source: —
 path:   —
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   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/@earendil-works/pi-coding-agent/dist/cli.js
   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>/@earendil-works/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"
 `;
@@ -68,10 +68,11 @@ source: npm-global
 path:   <NPM_ROOT>/@mariozechner/pi-coding-agent/dist/cli.js
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   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/@earendil-works/pi-coding-agent/dist/cli.js
   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>/@earendil-works/pi-coding-agent/dist/cli.js
   npm-global   ok
 argv:
   - C:/Program Files/nodejs/node.exe

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

@@ -29,5 +29,6 @@ source: bare-import
 path:   dist/cli.js
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   bare-import  ok"
 `;

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

@@ -27,8 +27,9 @@ source: managed
 path:   <HOME>/.pi-dashboard/node_modules/@mariozechner/pi-coding-agent/dist/cli.js
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   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/@earendil-works/pi-coding-agent/dist/cli.js
   managed      ok"
 `;
 
@@ -50,12 +51,12 @@ source: —
 path:   —
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   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/@earendil-works/pi-coding-agent/dist/cli.js
   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>/@earendil-works/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

@@ -7,8 +7,9 @@ source: managed
 path:   <HOME>/.pi-dashboard/node_modules/@mariozechner/pi-coding-agent/dist/cli.js
 tried:
   override     no override set
+  bare-import  cannot resolve @earendil-works/pi-coding-agent/package.json
   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/@earendil-works/pi-coding-agent/dist/cli.js
   managed      ok"
 `;