@tt-a1i/hive 1.2.0 → 1.3.4

package/CHANGELOG.md

@@ -2,6 +2,118 @@
 
 All notable user-facing changes will be documented in this file.
 
+## 1.3.4 - 2026-05-21
+
+Terminal performance and Tasks panel polish.
+
+- Improves terminal responsiveness by keeping mounted terminal hosts stable,
+  lazy-loading heavier xterm addons, and reducing terminal-run polling churn.
+- Fixes OpenCode TUI wheel and mouse handling by preserving binary input for
+  normal terminals while translating OpenCode legacy mouse reports into the
+  SGR format it handles correctly.
+- Sends a current `.hive/tasks.md` snapshot when a Tasks websocket connects,
+  and guards that initial read so a missing or unreadable file does not break
+  the websocket session.
+- Renames the visible Todo entry to **Tasks** and widens the Tasks side panel
+  to match the default Team Members pane width.
+- Enlarges the Team Members header and count badge for better readability.
+
+## 1.3.3 - 2026-05-21
+
+OpenCode terminal scrolling and small UI polish.
+
+- Restores the Task Graph topbar entry so the graph view is available again
+  from the main shell.
+- Updates generated worker names to use localized, role-scoped historical
+  figure name pools, making Chinese and English workspaces feel less generic.
+- Fixes OpenCode TUI mouse-wheel scrolling inside Hive terminal panels. Hive now
+  tags each terminal run with an input profile and maps OpenCode wheel events to
+  the keys OpenCode's message viewport actually handles (`Ctrl+D` / `Ctrl+U`),
+  while leaving other alternate-screen TUIs on the existing arrow-key fallback.
+- Preserves that OpenCode profile when the user selects the OpenCode preset but
+  starts it through a custom startup command such as `opencode --continue`.
+- Keeps workspace shell terminals on the default input profile.
+- Enlarges the Team Members header count for better readability.
+- Documents that npm's `prebuild-install@7.1.3` deprecation warning comes from
+  the upstream native-binary installer chain and is safe to ignore.
+
+## 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
@@ -58,37 +170,30 @@ Brand polish.
 
 ## 1.1.2 - 2026-05-17
 
-Private-release workflow fix.
+Release workflow fix.
 
 - Runs npm publish on Ubuntu instead of macOS. Publishing does not require
-  macOS, and the Ubuntu runner avoids unnecessary private-repo Actions cost.
+  macOS, and the Ubuntu runner is a better fit for the publish step.
 
 ## 1.1.1 - 2026-05-17
 
-Private-release workflow fix.
+Release workflow fix.
 
-- Publishes from the private product repository without npm provenance because
-  npm provenance currently requires a public GitHub Actions source repository.
-  The package contents are otherwise the same 1.1.x private-release line:
-  Workspace terminal tabs, hidden dormant Blueprint entry, and no production
-  source maps in the npm tarball.
+- Publishes without production source maps in the npm tarball while keeping the
+  user-facing package contents unchanged.
 
 ## 1.1.0 - 2026-05-17
 
-Private-release line.
+Workspace terminal release.
 
 - Added a Workspace terminal that opens from the active workspace and runs in
   the workspace directory. It supports multiple shell tabs, full-height terminal
   space, tab switching, and closing individual tabs without closing the whole
   dialog.
 - Kept the external install path unchanged. Users still install with
-  `npm install -g @tt-a1i/hive` or run with `npx @tt-a1i/hive`; this release is
-  built from the private product repository and published to the same npm
-  package.
+  `npm install -g @tt-a1i/hive` or run with `npx @tt-a1i/hive`.
 - Hid the dormant task-graph / Blueprint entry from the main UI while keeping
   the underlying code in place for possible future use.
-- Documented the public/private repository split and release policy in
-  `docs/private-release-strategy.md`.
 
 ## 1.0.0 - 2026-05-17
 

package/README.en.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="./assets/logo.png" width="120" alt="Hive logo" />
+</p>
+
 # Hive
 
 <p align="center">
@@ -15,12 +19,12 @@ Code, research, drafts, translations — if a team can split the work, a hive ca
 
 [![npm](https://img.shields.io/npm/v/@tt-a1i/hive.svg)](https://www.npmjs.com/package/@tt-a1i/hive)
 [![ci](https://img.shields.io/github/actions/workflow/status/tt-a1i/hive/release.yml?branch=main&label=ci)](https://github.com/tt-a1i/hive/actions/workflows/release.yml)
-[![Website](https://img.shields.io/badge/website-hive--site.pages.dev-5a8a8a.svg)](https://hive-site.pages.dev)
+[![Website](https://img.shields.io/badge/website-hivehq.dev-5a8a8a.svg)](https://hivehq.dev)
 [![Node](https://img.shields.io/badge/node-%3E%3D22-3c873a.svg)](https://nodejs.org/)
 [![License](https://img.shields.io/badge/license-BUSL--1.1-orange.svg)](./LICENSE.BSL)
 [![Platforms](https://img.shields.io/badge/platforms-macOS%20%C2%B7%20Linux%20%C2%B7%20Windows%20(best--effort)-lightgrey.svg)](#platform-support)
 
-🌐 **Website**: [hive-site.pages.dev/en/](https://hive-site.pages.dev/en/) · [中文](https://hive-site.pages.dev/)
+🌐 **Website**: [hivehq.dev/en/](https://hivehq.dev/en/) · [中文](https://hivehq.dev/)
 
 English · [简体中文](./README.md)
 
@@ -29,6 +33,10 @@ English · [简体中文](./README.md)
 > [npm](https://www.npmjs.com/package/@tt-a1i/hive) and the badge above resolves
 > to it.
 
+<p align="center">
+  <img src="./assets/hive-team-view.png" alt="Hive workbench with a 4-agent team — orchestrator dispatching while workers run" />
+</p>
+
 ## Why Hive
 
 CLI agents are powerful, but coordinating several of them manually is
@@ -71,6 +79,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.
@@ -203,6 +244,11 @@ Hive depends on `node-pty` and `better-sqlite3`, which use native binaries. Use
 Node.js 22+, keep your package manager cache clean, and verify your platform
 build tools are available.
 
+If npm prints a deprecated warning for `prebuild-install@7.1.3`, it is safe to
+ignore. The warning comes from `better-sqlite3`'s native binary download chain;
+it is an upstream installer maintenance notice, not a Hive install failure, and
+does not affect runtime behavior.
+
 **Folder picker does not open on Linux**
 
 Install `zenity`, or paste the workspace path manually.
@@ -267,12 +313,21 @@ verifies macOS, Ubuntu, and Windows, then publishes to npm with `NPM_TOKEN`.
 
 ## Status
 
-Hive is published as a stable release. Current work focuses on polishing the
-multi-agent collaboration workflow, Windows support, and clearer orchestration
-observability.
+Hive is in alpha. The core flow is usable today; current work focuses on
+polishing the multi-agent collaboration workflow, Windows support, and clearer
+orchestration observability. Try it out and open issues — feedback shapes what
+gets prioritized next.
 
-## License
+## A different form factor: squad
+
+If you'd rather have **pure CLI, zero background process, and the ability to
+run on a remote SSH box**, [squad](https://github.com/mco-org/squad) takes the
+same idea down a different path — SQLite as the protocol layer, one terminal
+per agent. The two projects don't replace each other; pick by workflow:
 
-Hive is licensed under the Business Source License 1.1 (see [LICENSE.BSL](LICENSE.BSL)). BSL permits personal use, internal deployment, embedding in non-competitive products, and non-commercial forks; it **only prohibits** offering Hive as a hosted multi-agent orchestration service to third parties.
+- **Hive** — visual workbench, one-click restart, workspace sidebar, easier to demo to a team
+- **squad** — lives in tmux, SSH remote dev, no extra background process, Windows servers
+
+## License
 
-See the Additional Use Grant in [LICENSE.BSL](LICENSE.BSL) for the exact boundary.
+Hive is open source under the Business Source License 1.1. Personal use, internal deployment, embedding, and forks are permitted — see [LICENSE.BSL](LICENSE.BSL) for the exact boundary.

package/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="./assets/logo.png" width="120" alt="Hive logo" />
+</p>
+
 # Hive
 
 <p align="center">
@@ -10,17 +14,21 @@
 
 [![npm](https://img.shields.io/npm/v/@tt-a1i/hive.svg)](https://www.npmjs.com/package/@tt-a1i/hive)
 [![ci](https://img.shields.io/github/actions/workflow/status/tt-a1i/hive/release.yml?branch=main&label=ci)](https://github.com/tt-a1i/hive/actions/workflows/release.yml)
-[![Website](https://img.shields.io/badge/website-hive--site.pages.dev-5a8a8a.svg)](https://hive-site.pages.dev)
+[![Website](https://img.shields.io/badge/website-hivehq.dev-5a8a8a.svg)](https://hivehq.dev)
 [![Node](https://img.shields.io/badge/node-%3E%3D22-3c873a.svg)](https://nodejs.org/)
 [![License](https://img.shields.io/badge/license-BUSL--1.1-orange.svg)](./LICENSE.BSL)
 [![Platforms](https://img.shields.io/badge/platforms-macOS%20%C2%B7%20Linux%20%C2%B7%20Windows%20(best--effort)-lightgrey.svg)](#平台支持)
 
-🌐 **官网**：[hive-site.pages.dev](https://hive-site.pages.dev/)（[English](https://hive-site.pages.dev/en/)）
+🌐 **官网**：[hivehq.dev](https://hivehq.dev/)（[English](https://hivehq.dev/en/)）
 
 [English](./README.en.md) · 简体中文
 
 > Hive 是本机优先的工具，只监听 `127.0.0.1`，面向已经在用 CLI Agent 的人。最新稳定版本见 [npm](https://www.npmjs.com/package/@tt-a1i/hive)，上面的 badge 会指向它。
 
+<p align="center">
+  <img src="./assets/hive-team-view.png" alt="Hive 工作台：4 个 CLI Agent 团队，Orchestrator 派单、Worker 各自开工" />
+</p>
+
 ## 为什么需要 Hive
 
 CLI Agent 各自都很强，但同时管几个就有点别扭：
@@ -52,6 +60,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。
@@ -157,6 +181,8 @@ hive --port 4020
 
 Hive 依赖 `node-pty` 和 `better-sqlite3`，它们用原生二进制。确认 Node.js 22+，清干净 package manager 缓存，并准备好你平台的构建工具（macOS Xcode CLI、Linux build-essential + python3、Windows VS Build Tools）。
 
+安装时如果看到 `prebuild-install@7.1.3` 的 deprecated warning，可以忽略。它来自 `better-sqlite3` 的原生二进制下载链路，只是上游安装器维护状态提示，不代表 Hive 安装失败，也不会影响运行。
+
 **Linux 上目录选择器不弹**
 
 装 `zenity`，或者直接在对话框里粘路径。
@@ -213,10 +239,15 @@ pnpm release:dry
 
 ## 状态
 
-Hive 已发布稳定版。当前重点是继续打磨多 Agent 协作体验、Windows 支持和更清晰的调度可观测性。
+Hive 目前处于 alpha 阶段，核心流程已可用。当前重点是继续打磨多 Agent 协作体验、Windows 支持和更清晰的调度可观测性。欢迎试用、提 issue——反馈会直接影响后续节奏。
 
-## License
+## 另一种形态：squad
+
+如果你更喜欢 **纯 CLI、零后台进程、能直接在 SSH 进的远端服务器上跑** 的形态，[squad](https://github.com/mco-org/squad) 是同一个想法的另一条路线——SQLite 当通信层，每个 agent 各自开一个终端。两个项目互不替代，按工作流挑就行：
 
-Hive 使用 Business Source License 1.1（[LICENSE.BSL](LICENSE.BSL)）。BSL 允许个人使用、内部部署、嵌入其他产品、非商业 fork；**仅禁止**把 Hive 包装成多 agent 协作 SaaS 卖给第三方。
+- **Hive** — 想要可视化工作台、一键重启、侧边栏切 workspace、给团队演示
+- **squad** — 活在 tmux 里、SSH 远端开发、不想跑额外后台进程、Windows server
+
+## License
 
-详细边界见 [LICENSE.BSL](LICENSE.BSL) 的 Additional Use Grant。
+Hive 在 Business Source License 1.1 下开源。个人使用、内部部署、嵌入、fork 都可以；详细边界见 [LICENSE.BSL](LICENSE.BSL)。

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/cli/team.d.ts

@@ -1,3 +1,7 @@
+interface ParsedCancelArgs {
+    dispatchId: string;
+    reason: string;
+}
 export interface ParsedReportArgs {
     artifacts: string[];
     dispatchId: string | undefined;
@@ -5,5 +9,7 @@ export interface ParsedReportArgs {
     useStdin: boolean;
 }
 export declare const parseReportArgs: (args: string[], command?: string) => ParsedReportArgs;
+export declare const parseCancelArgs: (args: string[]) => ParsedCancelArgs;
 export declare const readStdinToString: (command?: string) => Promise<string>;
 export declare const runTeamCommand: (argv: string[]) => Promise<void>;
+export {};

package/dist/src/cli/team.js

@@ -10,6 +10,7 @@ const TEAM_USAGE = [
     'Usage:',
     '  team list',
     '  team send <worker-name> "<task>"',
+    '  team cancel --dispatch <dispatch-id> "<reason>"',
     '  team report "<result>" [--dispatch <dispatch-id>] [--artifact <path>]',
     '  team report --stdin [--dispatch <dispatch-id>] [--artifact <path>]',
     '  team status "<current status>" [--artifact <path>]',
@@ -80,6 +81,7 @@ const postJson = async (baseUrl, path, body) => {
 };
 const REPORT_USAGE = 'Usage: team report (<result> | --stdin) [--dispatch <dispatch-id>] [--artifact <path>]';
 const STATUS_USAGE = 'Usage: team status (<current status> | --stdin) [--artifact <path>]';
+const CANCEL_USAGE = 'Usage: team cancel --dispatch <dispatch-id> <reason>';
 const usageFor = (command) => (command === 'status' ? STATUS_USAGE : REPORT_USAGE);
 const withUsage = (message, command) => `${message}\n\n${usageFor(command)}`;
 export const parseReportArgs = (args, command = 'report') => {
@@ -139,6 +141,39 @@ export const parseReportArgs = (args, command = 'report') => {
     }
     return { result: useStdin ? null : (positionals[0] ?? null), artifacts, dispatchId, useStdin };
 };
+export const parseCancelArgs = (args) => {
+    const positionals = [];
+    let dispatchId;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === undefined)
+            continue;
+        if (arg === '--dispatch') {
+            const next = args[index + 1];
+            if (next === undefined || next.startsWith('--')) {
+                throw new Error(`--dispatch requires a value\n\n${CANCEL_USAGE}`);
+            }
+            dispatchId = next;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith('--')) {
+            throw new Error(`Unknown argument: ${arg}\n\n${CANCEL_USAGE}`);
+        }
+        positionals.push(arg);
+    }
+    if (!dispatchId) {
+        throw new Error(`Missing --dispatch <dispatch-id>\n\n${CANCEL_USAGE}`);
+    }
+    if (positionals.length === 0) {
+        throw new Error(`Missing <reason>\n\n${CANCEL_USAGE}`);
+    }
+    const reason = positionals.join(' ').trim();
+    if (!reason) {
+        throw new Error(`Missing <reason>\n\n${CANCEL_USAGE}`);
+    }
+    return { dispatchId, reason };
+};
 export const readStdinToString = async (command = 'report') => {
     if (process.stdin.isTTY) {
         throw new Error(withUsage('--stdin requires piped input, but stdin is a TTY. Did you forget to pipe content in?', command));
@@ -194,6 +229,19 @@ export const runTeamCommand = async (argv) => {
         console.log(JSON.stringify(await response.json()));
         return;
     }
+    if (command === 'cancel') {
+        const cancel = parseCancelArgs(args);
+        const env = getHiveEnv();
+        const baseUrl = getBaseUrl(env);
+        await postJson(baseUrl, '/api/team/cancel', {
+            dispatch_id: cancel.dispatchId,
+            project_id: env.HIVE_PROJECT_ID,
+            from_agent_id: env.HIVE_AGENT_ID,
+            token: env.HIVE_AGENT_TOKEN,
+            reason: cancel.reason,
+        });
+        return;
+    }
     if (command === 'status') {
         const report = parseReportArgs(args, 'status');
         const body = report.useStdin ? await readStdinToString('status') : (report.result ?? '');