@tt-a1i/hive 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -2,6 +2,83 @@
 
 All notable user-facing changes will be documented in this file.
 
+## 1.3.0 - 2026-05-20
+
+Installable Hive: turns the web shell into a real PWA so Chrome / Edge can
+launch it from a dock icon, in its own window, without a visible browser
+chrome.
+
+- Adds a web app manifest with icons (192, 512, maskable 512, apple-touch 180),
+  a wide screenshot, and shortcuts for "Add Workspace" and "Try Demo" so
+  right-clicking the dock icon jumps straight to those flows.
+- Installation is driven entirely by the browser's omnibox install icon
+  (Chrome / Edge / Brave); Hive deliberately does not add a redundant topbar
+  button.
+- Ships a service worker (`/sw.js`) that caches the SPA shell + hashed asset
+  chunks + static icons / sounds / cli-icons, but never intercepts `/api/*`,
+  `/ws/*`, or non-GET requests — auth cookies and WebSockets keep their
+  native paths. Each release writes to its own cache bucket and older buckets
+  are kept so tabs still controlled by the previous SW can resolve their
+  lazy-imported chunks.
+- Surfaces shell updates as a bottom-right toast (`Web UI updated — Reload to
+  activate`) instead of forcing a refresh. The Reload button stays disabled
+  while any terminal run is still working so updates never interrupt an
+  in-flight agent.
+- Routes service-worker auto-reloads through the same silent reload helper used
+  elsewhere in the app, so browser updates do not trip the close-confirmation
+  guard.
+- Replaces the workspace area with a dedicated `Hive runtime is not running`
+  page when the initial bootstrap fails. The page pings `/api/version` every
+  three seconds and reloads automatically once the daemon comes back; a manual
+  Retry button is offered alongside.
+- Hardens the server: `/sw.js` is served with `Cache-Control: no-store` and the
+  manifest with `Cache-Control: max-age=0, must-revalidate`, so SW updates
+  propagate the next time the browser checks instead of waiting on a stale
+  HTTP cache.
+- Notes for first-time installers: the SW activates after the first reload
+  following install. On separate ports (`hive --port 4011` vs `--port 3000`)
+  Chrome treats Hive as two distinct PWAs because the install scope is keyed
+  by origin. To fully remove a PWA install, use
+  `chrome://apps` → right-click the Hive tile → Remove.
+- Always asks the browser to confirm before closing the tab or PWA window so
+  Cmd-W on an installed app never closes silently. Modern browsers gate the
+  prompt on prior page interaction — opening the window and immediately
+  pressing Cmd-W still closes cleanly by browser policy.
+- Open Workspace dropdown now uses each app's brand color for its icon
+  instead of the previous monochrome white treatment, and visually separates
+  VS Code from VS Code Insiders so users can tell their installed targets
+  apart at a glance.
+- Workspace avatars in the sidebar stay the same size when the user drags
+  the sidebar wider. Previously the wide layout used a 22px avatar while the
+  collapsed layout used 32px, so expanding the sidebar made the avatars
+  smaller; both modes now render at 32px.
+- Drops IntelliJ IDEA, Windsurf, and iTerm2 from the Open Workspace dropdown.
+  IntelliJ users typically launch from JetBrains Toolbox rather than a folder
+  picker; Windsurf overlaps with the existing Cursor / VS Code entries;
+  iTerm2 overlaps with the built-in macOS Terminal entry. macOS now exposes
+  seven targets (VS Code, VS Code Insiders, Cursor, Finder, Terminal,
+  Ghostty, Zed); Windows / Linux expose five (VS Code, VS Code Insiders,
+  Cursor, File Explorer / File Manager, Zed). A stored preference for any
+  removed target silently falls back to the platform default at load time.
+- Swaps the Zed, Ghostty, and Finder dropdown icons for the apps' official
+  brand marks (Finder uses the macOS app icon, Ghostty 96×96 / Zed 64×64
+  raster) so each entry reads as the real application rather than an
+  abstract glyph. Ghostty's mark renders inside a generous safe-zone so its
+  display size is bumped 20% via CSS scale to balance the row visually.
+- Replaces the Worker detail modal and Workspace shell dialog with a docked,
+  resizable, VSCode-style terminal panel inside the right column (under the
+  team members pane). Worker tabs and shell tabs share the strip; clicking a
+  member card opens that worker as a tab; the panel hides when no tabs are
+  open. Closing a worker tab keeps the underlying PTY running — worker
+  lifecycle is owned by the card hover cluster. Tab list, active tab, and
+  panel height all persist (height globally, tabs + active per-workspace).
+  Cmd-W (Ctrl-W on Windows / Linux) closes the active tab; a "+" button in
+  the tab strip starts a new shell. Start failures and shell-start failures
+  now surface as toasts instead of inline modal/dialog banners.
+- Moves "Save as template" into the role-instructions toolbar in the Add Member
+  flow, keeping template actions closer to the prompt editor instead of adding
+  another standalone control in the dialog body.
+
 ## 1.2.0 - 2026-05-18
 
 Opens the active workspace in your editor, terminal, or file manager from

package/README.en.md

@@ -71,6 +71,39 @@ hive
 Open the printed local URL, usually `http://127.0.0.1:3000/`. Use
 `hive --port 4010` when you need a specific local port.
 
+To upgrade in place:
+
+```bash
+hive update
+```
+
+`hive update` runs `npm install -g @tt-a1i/hive@latest` in place. Restart any
+in-flight Hive process to pick up the new version. If you installed Hive with
+pnpm or yarn, upgrade through the same package manager — otherwise the new
+npm copy will shadow your existing install.
+
+Install Hive as an app (optional):
+
+Open `http://127.0.0.1:3000/` in Chrome, Edge, or Brave and click the install
+icon at the right edge of the browser's omnibox. The PWA launches in its own
+dock-anchored window without browser chrome and shows **Add Workspace** /
+**Try Demo** shortcuts from the dock right-click menu. Firefox and Safari
+currently don't implement the install-prompt protocol, so the omnibox icon
+only appears in Chromium-based browsers.
+
+The Hive daemon must still be running for the PWA to do anything; if the
+runtime isn't reachable when you launch the app, you'll see a "Hive runtime
+is not running" page that auto-reloads once `hive` is back on `127.0.0.1`.
+The PWA install scope is keyed by origin, so `hive --port 4011` installs as
+a separate app from `hive --port 3000`. To uninstall, visit `chrome://apps`,
+right-click the Hive tile, and choose **Remove from Chrome…**.
+
+Hive asks the browser to confirm before closing the tab or PWA window so an
+accidental Cmd-W doesn't drop your session. Modern browsers gate that prompt
+on prior page interaction — if you open the PWA and immediately press Cmd-W
+without clicking or typing anywhere first, it still closes cleanly. That's a
+browser policy, not a Hive bug.
+
 First-run flow:
 
 1. Create a workspace from a project folder.

package/README.md

@@ -52,6 +52,22 @@ hive
 
 打开终端打印出来的本机地址，通常是 `http://127.0.0.1:3000/`。如果你想指定端口，可以用 `hive --port 4010`。
 
+升级到最新版本：
+
+```bash
+hive update
+```
+
+`hive update` 会在原位运行 `npm install -g @tt-a1i/hive@latest`，完事后重启 Hive 就能用上新版。如果当初是用 pnpm / yarn 装的 Hive，请用同一个包管理器升级，避免装出第二份。
+
+把 Hive 装为应用（可选）：
+
+在 Chrome / Edge / Brave 里打开 `http://127.0.0.1:3000/`，点浏览器地址栏右侧的安装图标即可。装好后 Hive 会以独立窗口启动、有自己的 dock 图标，且 dock 右键菜单上会显示 **添加 Workspace** / **试用演示** 两个快捷入口。Firefox 和 Safari 暂未实现 PWA install-prompt 协议，浏览器地址栏的安装图标只在 Chromium 系浏览器里出现。
+
+PWA 只是 UI 壳，Hive 后端仍需要在终端里跑着。如果启动 PWA 时后端没起，会看到 “Hive 后端未启动” 页面，等你跑起 `hive` 后会自动刷新。PWA 的 install scope 按 origin（含端口）划分，所以 `hive --port 4011` 跟 `hive --port 3000` 在浏览器看来是两个独立应用。卸载方法：浏览器地址栏访问 `chrome://apps`，右键 Hive 图标，选 **从 Chrome 中移除…**。
+
+关闭 PWA 窗口或 tab 时 Hive 会主动请求浏览器弹原生确认对话框，避免 Cmd+W 误关丢失会话。但现代浏览器要求你跟页面"交互过"（点击 / 滚动 / 输入）才会真的弹这个对话框——刚打开 PWA 立刻按 Cmd+W 仍会直接关闭，这是浏览器策略，不是 Hive 的 bug。
+
 首次使用流程：
 
 1. 选择一个项目目录作为 workspace。

package/dist/src/cli/hive-update.d.ts

@@ -0,0 +1,15 @@
+export declare const HIVE_UPDATE_USAGE: string;
+export interface RunUpdateResult {
+    exitCode: number;
+    spawnError?: Error;
+}
+export type RunUpdate = (command: string, args: readonly string[]) => Promise<RunUpdateResult>;
+export declare const defaultRunUpdate: RunUpdate;
+interface RunHiveUpdateOptions {
+    /** Inject a fake spawn for tests. */
+    runUpdate?: RunUpdate;
+    /** Override platform detection for tests. */
+    platform?: NodeJS.Platform;
+}
+export declare const runHiveUpdateCommand: (argv: string[], options?: RunHiveUpdateOptions) => Promise<number>;
+export {};

package/dist/src/cli/hive-update.js

@@ -0,0 +1,81 @@
+import { spawn } from 'node:child_process';
+import { getNpmCommand, INSTALL_COMMAND_ARGS, INSTALL_COMMAND_DISPLAY, } from '../server/package-version.js';
+export const HIVE_UPDATE_USAGE = [
+    'Usage:',
+    '  hive update',
+    '',
+    `Runs \`${INSTALL_COMMAND_DISPLAY}\` to upgrade Hive in place.`,
+    'Restart any running Hive process afterwards to pick up the new version.',
+    '',
+    'Note: only npm-installed Hive can be upgraded this way. If you installed',
+    'Hive via pnpm or yarn, upgrade through the same package manager instead;',
+    'otherwise the npm copy will shadow your existing install.',
+    '',
+    'Options:',
+    '  -h, --help      Print this help.',
+].join('\n');
+export const defaultRunUpdate = (command, args) => new Promise((resolve) => {
+    const child = spawn(command, [...args], { stdio: 'inherit' });
+    let resolved = false;
+    // Forward Ctrl+C / SIGTERM to the npm child so it can clean up rather
+    // than getting orphaned mid-install. The handlers are registered with
+    // `once` so they don't accumulate across invocations, and we also
+    // explicitly remove them when the child exits in case the user only
+    // sent one signal (Node would otherwise keep the handler alive).
+    const handleSignal = (signal) => () => {
+        child.kill(signal);
+    };
+    const handleSigint = handleSignal('SIGINT');
+    const handleSigterm = handleSignal('SIGTERM');
+    process.once('SIGINT', handleSigint);
+    process.once('SIGTERM', handleSigterm);
+    const finalize = (result) => {
+        if (resolved)
+            return;
+        resolved = true;
+        process.off('SIGINT', handleSigint);
+        process.off('SIGTERM', handleSigterm);
+        resolve(result);
+    };
+    child.on('error', (error) => {
+        finalize({ exitCode: 1, spawnError: error });
+    });
+    child.on('close', (code) => {
+        finalize({ exitCode: typeof code === 'number' ? code : 1 });
+    });
+});
+const printManualFallback = () => {
+    console.error(`You can run the upgrade manually: ${INSTALL_COMMAND_DISPLAY}`);
+};
+export const runHiveUpdateCommand = async (argv, options = {}) => {
+    if (argv.includes('--help') || argv.includes('-h')) {
+        console.log(HIVE_UPDATE_USAGE);
+        return 0;
+    }
+    // Reject unknown flags rather than silently ignoring them — keeps behavior
+    // consistent with how `parsePort` validates `hive` itself.
+    const extra = argv.find((arg) => arg !== '--help' && arg !== '-h');
+    if (extra !== undefined) {
+        console.error(`Unknown argument: ${extra}`);
+        console.error(HIVE_UPDATE_USAGE);
+        return 1;
+    }
+    const run = options.runUpdate ?? defaultRunUpdate;
+    const command = getNpmCommand(options.platform);
+    console.log(`Running: ${INSTALL_COMMAND_DISPLAY}`);
+    const result = await run(command, INSTALL_COMMAND_ARGS);
+    if (result.spawnError) {
+        console.error(`Failed to spawn npm: ${result.spawnError.message}`);
+        printManualFallback();
+        return 1;
+    }
+    if (result.exitCode === 0) {
+        console.log('Hive updated. Restart any running Hive process to pick up the new version.');
+        return 0;
+    }
+    console.error(`npm install exited with code ${result.exitCode}.`);
+    // Permission failures (EACCES on root-owned /usr/bin/npm) and other
+    // non-spawn errors leave the user with copy-paste recovery either way.
+    printManualFallback();
+    return result.exitCode;
+};

package/dist/src/cli/hive.js

@@ -9,14 +9,19 @@ import { createApp } from '../server/app.js';
 import { readPackageVersion } from '../server/package-version.js';
 import { createRuntimeStore } from '../server/runtime-store.js';
 import { createVersionService } from '../server/version-service.js';
+import { runHiveUpdateCommand } from './hive-update.js';
 export const HIVE_USAGE = [
     'Usage:',
     '  hive [--port <port>]',
+    '  hive update',
     '',
     'Options:',
     '  --port <port>   Bind the local runtime to a specific port (default: 3000).',
     '  -h, --help      Print this help.',
     '  -v, --version   Print the installed Hive version.',
+    '',
+    'Commands:',
+    '  update          Upgrade Hive in place via `npm install -g`.',
 ].join('\n');
 export const handleHiveInfoCommand = (argv) => {
     if (argv.includes('--help') || argv.includes('-h')) {
@@ -128,10 +133,21 @@ const isMainModule = process.argv[1]
     : false;
 if (isMainModule) {
     const argv = process.argv.slice(2);
-    if (handleHiveInfoCommand(argv))
+    if (argv[0] === 'update') {
+        runHiveUpdateCommand(argv.slice(1))
+            .then((code) => process.exit(code))
+            .catch((error) => {
+            console.error(error);
+            process.exit(1);
+        });
+    }
+    else if (handleHiveInfoCommand(argv)) {
         process.exit(0);
-    runHiveCommand(argv).catch((error) => {
-        console.error(error);
-        process.exit(1);
-    });
+    }
+    else {
+        runHiveCommand(argv).catch((error) => {
+            console.error(error);
+            process.exit(1);
+        });
+    }
 }

package/dist/src/server/agent-run-store.d.ts

@@ -27,7 +27,7 @@ export declare const createAgentRunStore: (db: Database) => {
         runId: string;
         agentId: string;
         pid: number | null;
-        status: "starting" | "running" | "exited" | "error";
+        status: "error" | "starting" | "running" | "exited";
         exitCode: number | null;
         startedAt: number;
         endedAt: number | null;

package/dist/src/server/app.js

@@ -54,6 +54,14 @@ const CONTENT_TYPES = {
     '.webp': 'image/webp',
     '.woff2': 'font/woff2',
 };
+// PWA boot files must bypass HTTP caching: `sw.js` because the browser does its
+// own byte-diff update check, and the manifest because Chrome consults it on
+// every install/uninstall transition. Without these, SW updates can stall on a
+// stale cached copy and the install prompt won't reflect a renamed app.
+const PWA_BOOT_CACHE_CONTROL = {
+    '/manifest.webmanifest': 'max-age=0, must-revalidate',
+    '/sw.js': 'no-store',
+};
 const sendStatic = async (response, staticDir, pathname, request) => {
     if (request.method !== 'GET' && request.method !== 'HEAD')
         return false;
@@ -63,6 +71,9 @@ const sendStatic = async (response, staticDir, pathname, request) => {
     try {
         const content = await readFile(filePath);
         response.setHeader('content-type', CONTENT_TYPES[extname(filePath)] ?? 'application/octet-stream');
+        const cacheControl = PWA_BOOT_CACHE_CONTROL[pathname];
+        if (cacheControl !== undefined)
+            response.setHeader('cache-control', cacheControl);
         response.statusCode = 200;
         response.end(request.method === 'HEAD' ? undefined : content);
         return true;

package/dist/src/server/open-target-commands.js

@@ -20,23 +20,10 @@ const macAttempts = (targetId, path) => {
             return [{ command: 'open', args: ['-a', 'Visual Studio Code - Insiders', path] }];
         case 'cursor':
             return [{ command: 'open', args: ['-a', 'Cursor', path] }];
-        case 'windsurf':
-            return [{ command: 'open', args: ['-a', 'Windsurf', path] }];
         case 'terminal':
             return [{ command: 'open', args: ['-a', 'Terminal', path] }];
-        case 'iterm2':
-            // Bundle name has always been `iTerm.app` even after the iTerm2 rename;
-            // the `iTerm2` fallback in earlier ports is cargo-cult.
-            return [{ command: 'open', args: ['-a', 'iTerm', path] }];
         case 'ghostty':
             return [{ command: 'open', args: ['-a', 'Ghostty', path] }];
-        case 'intellijidea':
-            // 2025.3 unified the editions, but installs predating that still ship
-            // `IntelliJ IDEA CE.app` — retry once on the CE bundle.
-            return [
-                { command: 'open', args: ['-a', 'IntelliJ IDEA', path] },
-                { command: 'open', args: ['-a', 'IntelliJ IDEA CE', path] },
-            ];
         case 'zed':
             return [{ command: 'open', args: ['-a', 'Zed', path] }];
     }
@@ -51,8 +38,6 @@ const linuxAttempts = (targetId, path) => {
             return [{ command: 'code-insiders', args: [path] }];
         case 'cursor':
             return [{ command: 'cursor', args: [path] }];
-        case 'windsurf':
-            return [{ command: 'windsurf', args: [path] }];
         case 'zed':
             return [{ command: 'zed', args: [path] }];
         default:
@@ -69,8 +54,6 @@ const windowsAttempts = (targetId, path) => {
             return [{ command: 'code-insiders', args: [path] }];
         case 'cursor':
             return [{ command: 'cursor', args: [path] }];
-        case 'windsurf':
-            return [{ command: 'windsurf', args: [path] }];
         case 'zed':
             return [{ command: 'zed', args: [path] }];
         default:

package/dist/src/server/package-version.d.ts

@@ -1,2 +1,17 @@
 export declare const PACKAGE_NAME = "@tt-a1i/hive";
+/**
+ * Canonical argv for the upgrade command. Sharing one source between the
+ * server's install hint (`version-service.ts`) and the CLI upgrade path
+ * (`hive-update.ts`) keeps the two from drifting if the package name ever
+ * moves.
+ */
+export declare const INSTALL_COMMAND_ARGS: readonly ["install", "-g", "@tt-a1i/hive@latest"];
+export declare const INSTALL_COMMAND_DISPLAY: string;
+/**
+ * Windows ships npm as `npm.cmd` (a batch shim); Node's `child_process.spawn`
+ * will not resolve `.cmd` without `shell: true` or an explicit suffix, so the
+ * default `'npm'` produces ENOENT on Windows. Use this helper any time you
+ * spawn npm directly.
+ */
+export declare const getNpmCommand: (platform?: NodeJS.Platform) => string;
 export declare const readPackageVersion: () => string;

package/dist/src/server/package-version.js

@@ -2,6 +2,21 @@ import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 export const PACKAGE_NAME = '@tt-a1i/hive';
+/**
+ * Canonical argv for the upgrade command. Sharing one source between the
+ * server's install hint (`version-service.ts`) and the CLI upgrade path
+ * (`hive-update.ts`) keeps the two from drifting if the package name ever
+ * moves.
+ */
+export const INSTALL_COMMAND_ARGS = ['install', '-g', `${PACKAGE_NAME}@latest`];
+export const INSTALL_COMMAND_DISPLAY = `npm ${INSTALL_COMMAND_ARGS.join(' ')}`;
+/**
+ * Windows ships npm as `npm.cmd` (a batch shim); Node's `child_process.spawn`
+ * will not resolve `.cmd` without `shell: true` or an explicit suffix, so the
+ * default `'npm'` produces ENOENT on Windows. Use this helper any time you
+ * spawn npm directly.
+ */
+export const getNpmCommand = (platform = process.platform) => platform === 'win32' ? 'npm.cmd' : 'npm';
 export const readPackageVersion = () => {
     let dir = dirname(fileURLToPath(import.meta.url));
     for (let depth = 0; depth < 8; depth += 1) {

package/dist/src/server/version-service.js

@@ -27,7 +27,10 @@ export const compareVersions = (left, right) => {
 };
 const buildVersionInfo = (currentVersion, latestVersion) => ({
     current_version: currentVersion,
-    install_hint: `npm install -g ${PACKAGE_NAME}@latest`,
+    // Show `hive update` as the primary upgrade path now that the subcommand
+    // exists; it prints the npm fallback if its own spawn fails, so users
+    // running on Windows / Linux without a working npm in PATH still recover.
+    install_hint: 'hive update',
     latest_version: latestVersion,
     package_name: PACKAGE_NAME,
     release_url: `https://www.npmjs.com/package/${PACKAGE_NAME}/v/${latestVersion}`,

package/dist/src/server/workspace-shell-runtime.js

@@ -1,5 +1,7 @@
 import { basename } from 'node:path';
 const WORKSPACE_SHELL_SUFFIX = ':shell';
+const WORKSPACE_SHELL_LABEL = 'Shell';
+const EXITED_SHELL_RETENTION_MS = 5000;
 export const getWorkspaceShellAgentId = (workspaceId) => `${workspaceId}${WORKSPACE_SHELL_SUFFIX}`;
 export const isWorkspaceShellAgentId = (agentId) => agentId.endsWith(WORKSPACE_SHELL_SUFFIX);
 const shouldUseLoginShell = (command) => {
@@ -20,10 +22,10 @@ export const resolveWorkspaceShellLaunch = (env = process.env, platform = proces
 };
 export const createWorkspaceShellRuntime = (agentManager) => {
     const labelsByRunId = new Map();
-    const nextShellNumberByWorkspaceId = new Map();
     const workspaceIdsByRunId = new Map();
     const runIdsByWorkspaceId = new Map();
     const startedAtByRunId = new Map();
+    const exitCleanupTimersByRunId = new Map();
     const requireManager = () => {
         if (!agentManager)
             throw new Error('Agent manager is required for workspace shell terminals');
@@ -43,6 +45,10 @@ export const createWorkspaceShellRuntime = (agentManager) => {
         }
     };
     const detachRun = (runId) => {
+        const exitCleanupTimer = exitCleanupTimersByRunId.get(runId);
+        if (exitCleanupTimer)
+            clearTimeout(exitCleanupTimer);
+        exitCleanupTimersByRunId.delete(runId);
         const workspaceId = workspaceIdsByRunId.get(runId);
         if (workspaceId) {
             const retained = (runIdsByWorkspaceId.get(workspaceId) ?? []).filter((id) => id !== runId);
@@ -61,11 +67,27 @@ export const createWorkspaceShellRuntime = (agentManager) => {
         startedAtByRunId.set(runId, startedAt);
         runIdsByWorkspaceId.set(workspaceId, [...(runIdsByWorkspaceId.get(workspaceId) ?? []), runId]);
     };
-    const nextLabel = (workspaceId) => {
-        const next = nextShellNumberByWorkspaceId.get(workspaceId) ?? 1;
-        nextShellNumberByWorkspaceId.set(workspaceId, next + 1);
-        return `Shell ${next}`;
+    const forgetShellRun = (runId) => {
+        detachRun(runId);
+        try {
+            requireManager().removeRun(runId);
+        }
+        catch {
+            // The PTY manager may have already dropped the run.
+        }
+    };
+    const handleShellExit = (runId) => {
+        if (!hasRun(runId) || exitCleanupTimersByRunId.has(runId))
+            return;
+        const timer = setTimeout(() => {
+            exitCleanupTimersByRunId.delete(runId);
+            if (hasRun(runId))
+                forgetShellRun(runId);
+        }, EXITED_SHELL_RETENTION_MS);
+        timer.unref?.();
+        exitCleanupTimersByRunId.set(runId, timer);
     };
+    const isListedRun = (run) => run.status === 'starting' || run.status === 'running';
     const stopPtyRun = (runId) => {
         requireManager().stopRun(runId);
     };
@@ -92,7 +114,9 @@ export const createWorkspaceShellRuntime = (agentManager) => {
             workspaceIdsByRunId.clear();
             startedAtByRunId.clear();
             labelsByRunId.clear();
-            nextShellNumberByWorkspaceId.clear();
+            for (const timer of exitCleanupTimersByRunId.values())
+                clearTimeout(timer);
+            exitCleanupTimersByRunId.clear();
         },
         closeRun(workspaceId, runId) {
             if (workspaceIdsByRunId.get(runId) !== workspaceId)
@@ -110,7 +134,6 @@ export const createWorkspaceShellRuntime = (agentManager) => {
                 }
             }
             runIdsByWorkspaceId.delete(workspaceId);
-            nextShellNumberByWorkspaceId.delete(workspaceId);
         },
         getLiveRun(runId) {
             if (!hasRun(runId))
@@ -122,6 +145,8 @@ export const createWorkspaceShellRuntime = (agentManager) => {
             return (runIdsByWorkspaceId.get(workspaceId) ?? []).flatMap((runId) => {
                 try {
                     const run = toLiveRun(runId);
+                    if (!isListedRun(run))
+                        return [];
                     return [
                         {
                             agent_id: getWorkspaceShellAgentId(workspaceId),
@@ -163,8 +188,9 @@ export const createWorkspaceShellRuntime = (agentManager) => {
                     TERM: 'xterm-256color',
                     TERM_PROGRAM: 'hive-shell',
                 },
+                onExit: ({ runId }) => handleShellExit(runId),
             });
-            attachRun(workspace.id, run.runId, nextLabel(workspace.id), startedAt);
+            attachRun(workspace.id, run.runId, WORKSPACE_SHELL_LABEL, startedAt);
             return { ...run, startedAt };
         },
         stopRun(runId) {

package/dist/src/shared/open-targets.d.ts

@@ -4,7 +4,7 @@
  * and the web client (button + preference store in `web/src/workspace/open-targets.ts`)
  * pull the union and platform whitelist from here so they cannot drift.
  */
-export type OpenTargetId = 'vscode' | 'vscode-insiders' | 'cursor' | 'windsurf' | 'finder' | 'terminal' | 'iterm2' | 'ghostty' | 'intellijidea' | 'zed';
+export type OpenTargetId = 'vscode' | 'vscode-insiders' | 'cursor' | 'finder' | 'terminal' | 'ghostty' | 'zed';
 export type OpenTargetPlatform = 'mac' | 'windows' | 'linux' | 'other';
 export declare const OPEN_TARGET_IDS_BY_PLATFORM: Record<OpenTargetPlatform, readonly OpenTargetId[]>;
 export declare const isOpenTargetId: (value: unknown) => value is OpenTargetId;

package/dist/src/shared/open-targets.js

@@ -6,23 +6,16 @@
  */
 // Note: there is no `cursor-insiders` here. Cursor stopped shipping a separate
 // Nightly bundle / `cursor-nightly` binary in March 2024; the pre-release
-// channel is now an in-app toggle on the regular Cursor.app, so an "Insiders"
-// menu entry would 100% fail with `app-not-installed` on every platform.
+// channel is now an in-app toggle on the regular Cursor.app.
+//
+// IntelliJ IDEA, Windsurf, and iTerm2 were intentionally dropped after 1.3.0:
+// IntelliJ users typically launch from JetBrains Toolbox rather than a folder
+// picker; Windsurf overlaps with Cursor/VS Code; iTerm2 overlaps with the
+// built-in macOS Terminal entry.
 export const OPEN_TARGET_IDS_BY_PLATFORM = {
-    mac: [
-        'vscode',
-        'vscode-insiders',
-        'cursor',
-        'windsurf',
-        'finder',
-        'terminal',
-        'iterm2',
-        'ghostty',
-        'intellijidea',
-        'zed',
-    ],
-    windows: ['vscode', 'vscode-insiders', 'cursor', 'windsurf', 'finder', 'zed'],
-    linux: ['vscode', 'vscode-insiders', 'cursor', 'windsurf', 'finder', 'zed'],
+    mac: ['vscode', 'vscode-insiders', 'cursor', 'finder', 'terminal', 'ghostty', 'zed'],
+    windows: ['vscode', 'vscode-insiders', 'cursor', 'finder', 'zed'],
+    linux: ['vscode', 'vscode-insiders', 'cursor', 'finder', 'zed'],
     other: ['vscode', 'vscode-insiders', 'finder'],
 };
 const ALL_TARGET_IDS = new Set(OPEN_TARGET_IDS_BY_PLATFORM.mac);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tt-a1i/hive",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Browser-native hive-mind for CLI coding agents — Claude Code, Codex, Gemini, and OpenCode collaborate as real PTY processes via a team protocol.",
   "type": "module",
   "packageManager": "pnpm@10.30.3",
@@ -17,7 +17,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/tt-a1i/hive.git"
+    "url": "git+https://github.com/tt-a1i/hive-private.git"
   },
   "bugs": {
     "url": "https://github.com/tt-a1i/hive/issues"
@@ -60,7 +60,7 @@
     "postinstall": "node scripts/fix-runtime-artifacts.mjs",
     "release:dry": "pnpm check && pnpm build && pnpm test && pnpm pack:check && pnpm pack:smoke",
     "test": "vitest run",
-    "test:windows": "vitest run tests/unit/agent-command-resolver.test.ts tests/unit/session-capture-multi-cli.test.ts tests/unit/claude-session-support.test.ts tests/unit/worker-name-generator.test.ts tests/unit/open-target-commands.test.ts tests/server/fs-pick-folder.test.ts tests/server/fs-browse.test.ts tests/server/schema-version.test.ts tests/server/runtime-rehydration.test.ts tests/server/open-workspace-route.test.ts tests/web/workspace-picker.test.tsx tests/web/confirm-dialog.test.tsx tests/web/toast.test.tsx tests/web/open-workspace-button.test.tsx --no-file-parallelism --maxWorkers=1 --testTimeout=30000 --hookTimeout=30000",
+    "test:windows": "vitest run tests/unit/agent-command-resolver.test.ts tests/unit/session-capture-multi-cli.test.ts tests/unit/claude-session-support.test.ts tests/unit/worker-name-generator.test.ts tests/unit/open-target-commands.test.ts tests/unit/sw-template-substitution.test.ts tests/unit/build-sw-plugin.test.ts tests/server/fs-pick-folder.test.ts tests/server/fs-browse.test.ts tests/server/schema-version.test.ts tests/server/runtime-rehydration.test.ts tests/server/open-workspace-route.test.ts tests/server/static-pwa.test.ts tests/web/workspace-picker.test.tsx tests/web/confirm-dialog.test.tsx tests/web/toast.test.tsx tests/web/open-workspace-button.test.tsx tests/web/register-service-worker.test.ts tests/web/use-shortcut-action.test.ts tests/web/update-available-toast.test.tsx tests/web/runtime-offline-page.test.tsx tests/web/use-terminal-panel-height.test.ts tests/web/use-terminal-panel-tabs.test.ts tests/web/terminal-tabs.test.tsx tests/web/terminal-bottom-panel.test.tsx --no-file-parallelism --maxWorkers=1 --testTimeout=60000 --hookTimeout=60000",
     "test:watch": "vitest"
   },
   "dependencies": {