Doors: progressive tool disclosure + agent hardening + web-pane migration completion

.claude/agent-memory/rust-sidecar-engineer/MEMORY.md

@@ -0,0 +1,3 @@
+# Memory Index
+
+- [Build exe-lock workaround](build_exe_lock_workaround.md) — rename the running sidecar exe (don't kill Electron) so `cargo build --release` can write the binary while `yarn start` holds it

.claude/agent-memory/rust-sidecar-engineer/build_exe_lock_workaround.md

@@ -0,0 +1,13 @@
+---
+name: build-exe-lock-workaround
+description: How to complete `cargo build --release` when a live `yarn start` Electron holds the sidecar exe
+metadata:
+  type: project
+---
+
+`cargo build --release --manifest-path sidecar/Cargo.toml` compiles fine but fails at the final link/copy step with `error: failed to remove file ... hyperia-sidecar.exe / Access is denied (os error 5)` when a Hyperia dev instance is running. The Electron dev process (`yarn start`) auto-respawns the sidecar, so `Stop-Process` on the sidecar alone loses the race — a new PID re-locks the exe within a second.
+
+**Why:** the output binary IS the running process image; Windows won't let cargo delete-in-place a file backing a live process, and the bridge respawns it.
+
+**How to apply:** Windows allows *renaming* a running exe even while locked. Before building, rename it out of the way so cargo writes a fresh one; the live process keeps using the renamed file:
+`Rename-Item sidecar/target/release/hyperia-sidecar.exe hyperia-sidecar.exe.old` then build. Clean up the `.old` afterward (may still be locked until the old process exits — best-effort `rm -f`). Do NOT kill the whole Electron/`yarn start` session to build — it's the human's live workspace. This matches the user's auto-memory note about the sidecar port-9800 clash / closing the installed copy, but the rename trick avoids disrupting the dev session entirely.

app/bridge.ts

@@ -110,6 +110,14 @@
     for (const [uid, tracked] of trackedSessions) {
       sendSessionRegister(uid, tracked);
     }
+    // Replay window bounds now that the socket is live. The per-window
+    // create/focus/resize sends can fire before the sidecar WS connects
+    // (connect happens last at launch), so send() no-ops silently — this
+    // guarantees the sidecar learns every window's pixel size on connect.
+    try {
+      const winList: BrowserWindow[] = Array.from((app as any).getWindows?.() || []);
+      for (const w of winList) updateWindowBounds(w);
+    } catch { /* best-effort */ }
     startHeartbeat();
   });
 
@@ -360,11 +368,11 @@
 
     case 'SaveLayoutState': {
       // eslint-disable-next-line @typescript-eslint/no-unsafe-call
       const windows: any[] = Array.from((app as any).getWindows?.() || []);
       if (windows.length > 0) {
         for (const w of windows) {
           if (w?.rpc) {
             w.rpc.emit('get-layout-state-req', undefined);
           }
         }
         sendResult(seq, 'ok');
@@ -398,12 +406,21 @@
         shell: p.config?.shell as string | undefined,
         isDefault: p.name === (getConfig() as any).defaultProfile
       }));
+      // Per-window OS pixel size so the agent can answer "how big is the window"
+      // and resize relative to it (terminal_set_window_size).
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+      const winList: BrowserWindow[] = Array.from((app as any).getWindows?.() || []);
+      const windowSizes = winList.map((w) => {
+        const b = w.getBounds();
+        return {id: w.id, width: b.width, height: b.height, x: b.x, y: b.y, focused: w.isFocused()};
+      });
       sendResult(
         seq,
         JSON.stringify({
           panes,
           platform: process.platform,
-          profiles
+          profiles,
+          windowSizes
         })
       );
       break;
@@ -504,8 +521,8 @@
         targetPane: msg.targetPane as string,
         purpose: (msg.purpose as string) || ''
       };
       for (const w of (app as any).getWindows?.() || []) {
         if (w?.rpc) w.rpc.emit('permission request', payload);
       }
       break;
     }
@@ -516,8 +533,8 @@
       // the bar — but never move the human's view (focus-never-steal). The
       // renderer's markTabBell keys off the paneId to find the owning tab.
       const uid = msg.uid as string;
       for (const w of (app as any).getWindows?.() || []) {
         if (w?.rpc) w.rpc.emit('tab bell', {uid});
       }
       break;
     }
@@ -1159,6 +1176,15 @@
   send({type: 'WindowFocus', windowId});
 }
 
+/** Report a window's OS pixel bounds to the sidecar so terminal_status can
+ *  answer "how big is the window" and resize relative to it. Sent on window
+ *  create + resize/move. */
+export function updateWindowBounds(win: BrowserWindow) {
+  if (!win || win.isDestroyed()) return;
+  const b = win.getBounds();
+  send({type: 'WindowBounds', windowId: win.id, width: b.width, height: b.height, x: b.x, y: b.y});
+}
+
 /** Update the description for a session. */
 export function updateSessionDescription(uid: string, description: string) {
   let tracked = trackedSessions.get(uid);

app/index.ts

@@ -469,10 +469,16 @@ async function installDevExtensions(isDev_: boolean) {
   );
 }
 
-// Single instance lock — prevent duplicate tray icons and sidecar spawns
+// Single instance lock — prevent duplicate tray icons and sidecar spawns.
+// HARD exit for the loser: app.quit() is async and the losing instance kept
+// EXECUTING its init — including spawnSidecar's taskkill of the WINNER's
+// sidecar — before actually quitting. That mutual sidecar-squash is what
+// made duplicate launches flash/restart/rotate panes. app.exit() is
+// synchronous and runs nothing further.
 const gotLock = app.requestSingleInstanceLock();
 if (!gotLock) {
-  app.quit();
+  app.exit(0);
+  process.exit(0); // belt-and-suspenders: nothing below may run in the loser
 }
 app.on('second-instance', () => {
   // eslint-disable-next-line @typescript-eslint/no-unsafe-call

app/package.json

@@ -2,7 +2,7 @@
   "name": "hyperia",
   "productName": "Hyperia",
   "description": "A modern agentic terminal.",
-  "version": "0.15.11",
+  "version": "0.15.15",
   "license": "BSD-2-Clause",
   "author": {
     "name": "Deep Blue Dynamics",

app/sticky.ts

@@ -717,13 +717,12 @@ function createStickyNote(
     savedNote.source.path = translateContainerPath(savedNote.source.path);
   }
 
-  // Resolve default size (explicit > persisted manual size > default). A brand-new
-  // sticky opens at 25% of the default size (quick small notes); explicit sizes
-  // and restored notes keep their exact dimensions.
-  const NEW_STICKY_SCALE = 0.25;
+  // Resolve default size (explicit > persisted manual size > default). New
+  // stickys open at the user's default size — the old 25% "quick note" scale
+  // made them ridiculously small (~117×104) and unusable.
   const defaultSize = getStickyDefaultSize();
-  let width = options.width || savedNote?.width || Math.round(defaultSize.width * NEW_STICKY_SCALE);
-  let height = options.height || savedNote?.height || Math.round(defaultSize.height * NEW_STICKY_SCALE);
+  let width = options.width || savedNote?.width || defaultSize.width;
+  let height = options.height || savedNote?.height || defaultSize.height;
 
   // Candidate position: explicit > persisted > centered on the cursor.
   const hasPlacedPos = options.x != null || options.y != null || savedNote?.x != null || savedNote?.y != null;
@@ -738,6 +737,10 @@ function createStickyNote(
   const wa = targetDisplay.workArea;
   width = Math.min(width, wa.width);
   height = Math.min(height, wa.height);
+  // Hard floor: never open a sticky too small to read/use, whatever the
+  // source (corrupt persisted geometry, tiny explicit sizes).
+  width = Math.max(width, 220);
+  height = Math.max(height, 170);
   x = Math.max(wa.x, Math.min(x, wa.x + wa.width - width));
   y = Math.max(wa.y, Math.min(y, wa.y + wa.height - height));
 
@@ -862,8 +865,10 @@ function createStickyNote(
     const bounds = win.getBounds();
     const note = getNote(noteId);
     if (note) {
+      // Persist THIS note's geometry only. Resizing a note must NOT rewrite
+      // the global default — one huge note poisoned every future sticky
+      // ("how many times do I have to ask for a normal sized sticky?").
       upsertNote({...note, x: bounds.x, y: bounds.y, width: bounds.width, height: bounds.height});
-      saveStickyDefaultSize(bounds.width, bounds.height);
     }
   };
   win.on('moved', saveGeom);

app/ui/contextmenu.ts

@@ -51,6 +51,7 @@ const contextMenuTemplate = (
   menu.push(separator);
   menu.push({label: 'New Tab', accelerator: commandKeys['tab:new'], click: cmd('tab:new')});
   menu.push({label: 'New Window', click: () => createWindow()});
+  menu.push({label: 'Hyperia Agent', click: cmd('pane:openShellPane')});
 
   menu.push(separator);
   menu.push({label: 'New Stickys', click: () => ipcMain.emit('new-sticky', {})});