hivehq 2.0.0

package/README.md

@@ -0,0 +1,329 @@
+<p align="center">
+  <img src="./assets/logo.png" width="120" alt="Hive logo" />
+</p>
+
+# Hive
+
+<p align="center">
+  <img src="./assets/hive-hero.png" alt="Hive 本机多 agent 协作工作台" />
+</p>
+
+**Hive 是浏览器里的 Agent 协作工作台——一群 Agent 在你本机各自开工，一个当 Orchestrator 派活、归总进展，其余各司其职。** Orchestrator 本身就是一个真实的 `claude` / `codex` / `opencode` / `gemini` / `hermes` 进程——不是你、也不是脚本——它派单的 Worker 同样是真 CLI agent。所有 agent 都是本机真实的 PTY 进程，通过 Hive 注入到 shell 里的小型 `team` 协议互相通信，共享 `<workspace>/.hive/tasks.md` 这份 markdown 任务图。
+
+写代码、做调研、起草文档、做翻译——凡是能拆给一群人协作的脑力活，都可以让一群 Agent 合伙干。
+
+[![npm](https://img.shields.io/npm/v/hivehq.svg)](https://www.npmjs.com/package/hivehq)
+[![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-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)](#平台支持)
+
+🌐 **官网**：[hivehq.dev](https://hivehq.dev/)（[English](https://hivehq.dev/en/)）
+
+[English](./README.en.md) · 简体中文
+
+> Hive 是本机优先的工具，只监听 `127.0.0.1`，面向已经在用 CLI Agent 的人。当前 npm 临时分发包见 [npm](https://www.npmjs.com/package/hivehq)，上面的 badge 会指向它。
+
+<p align="center">
+  <img src="./assets/hive-team-view.png" alt="Hive 工作台：4 个 CLI Agent 团队，Orchestrator 派单、Worker 各自开工" />
+</p>
+
+## 为什么需要 Hive
+
+CLI Agent 各自都很强，但同时管几个就有点别扭：
+
+- 长任务的会话散在好几个终端里，注意力来回切。
+- 想把活儿分给几个 Agent（写代码 / review / 测试，或者调研 / 起草 / 事实核查之类），却缺一层来居中调度。
+- Worker 的进度淹在 scrollback 里，回头看找不到。
+- 想重启接着干，全看每个 CLI 自己的 session 恢复行为，散乱不可控。
+
+Hive 加上这一层调度，**不替换**任何 CLI。Agent 还是真实跑在你电脑上的终端进程，Hive 只是它们外面的"团队 shell"。
+
+## 先看看 demo
+
+还没装任何 agent CLI？运行 `hive`、打开它打印出的本地地址、在 first-run 向导里点 **Try Demo**。你会看到一个完全跑在客户端的预览——假 orchestrator + 两个 worker、预录的终端 scrollback、一份预填的任务清单——既不会连服务器，也不需要任何真实 CLI agent。适合决定要不要继续装真 CLI。
+
+## 快速开始
+
+前置条件：
+
+- Node.js 22 或更新版本
+- 至少一个支持的 Agent CLI 已经安装好、登录过、在 `PATH` 上可调用
+
+安装并启动 Hive：
+
+```bash
+npm install -g hivehq
+hive
+```
+
+安装时如果看到 `npm warn allow-scripts` 或 `prebuild-install@7.1.3 deprecated`，先看最后是否显示 `added ... packages`。这些 warning 多数来自 npm 对安装脚本的安全审查，以及 `node-pty` / `better-sqlite3` / `esbuild` 这类原生依赖的二进制安装链路；不代表 Hive 启动失败。下面的故障排查里有逐项解释。
+
+打开终端打印出来的本机地址，通常是 `http://127.0.0.1:3000/`。如果你想指定端口，可以用 `hive --port 4010`。
+
+升级到最新版本：
+
+```bash
+hive update
+```
+
+`hive update` 会在原位运行 `npm install -g hivehq@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 会主动请求浏览器弹原生确认对话框，避免关闭快捷键（macOS 上是 Cmd+W、Windows / Linux 上是 Ctrl+W）误关丢失会话。但现代浏览器要求你跟页面"交互过"（点击 / 滚动 / 输入）才会真的弹这个对话框——刚打开 PWA 立刻按关闭快捷键仍会直接关闭，这是浏览器策略，不是 Hive 的 bug。
+
+首次使用流程：
+
+1. 选择一个项目目录作为 workspace。
+2. 挑一个 Orchestrator 预设。
+3. Hive 会创建 `<workspace>/.hive/tasks.md`，启动 Orchestrator 的 PTY，把内部的 `team` 命令注入这个 agent 会话。
+4. 在 Team Members 面板里添加 Worker。
+5. 跟 Orchestrator 说一声让它派活，它会用 `team send <worker-name> "<task>"` 发任务，Worker 完事后用 `team report` 回报。
+
+想让 Orchestrator 自己决定团队规模，可以保留 **自动组队** 开关开启（默认开启）：它会按任务需要临时 `team spawn` 合适数量的 coder / tester / reviewer，任务结束后自动收回临时成员。
+
+想试更强的自动化，可以在右上角设置里开启实验性的 **Workflow** 开关。开启后，Orchestrator 可以编写并运行多 agent workflow，把一个目标拆成 fan-out / review / test 等阶段；顶部的 **Workflows** 面板会显示运行记录、阶段结果、定时任务和停止按钮。Workflow 创建的新 agent 默认使用哪种 CLI、允许使用哪些 CLI，也可以在 Workflows 面板里配置。
+
+## 工作方式
+
+```text
+浏览器 UI 跑在 127.0.0.1
+  任务 · 团队 · 终端 · 汇报
+          |
+          | HTTP + WebSocket
+          v
+Hive Runtime
+  SQLite 元数据 · PTY 生命周期 · 任务派单
+          |
+          +-- Orchestrator PTY
+          |     可调用：team send、team list、team report
+          |
+          +-- Worker PTY
+          |     可调用：team report
+          |
+          +-- Worker PTY
+                可调用：team report
+
+Workspace 任务图：
+  <workspace>/.hive/tasks.md
+```
+
+三个细节值得记住：
+
+- Agent 是真正的 CLI 进程，不是模拟的 subagent。
+- `team` 命令**只**在 Hive 管理的 agent 会话里可用——通过把包内 bin 目录 prepend 到 PATH 实现，不会装成全局命令。
+- 任务图就是 workspace 里的一份 markdown 文件，你可以在编辑器里直接看或者改。
+
+## Agent 预设
+
+| 预设 | `PATH` 上的命令 | 默认 bypass 模式 | 会话恢复 |
+| --- | --- | --- | --- |
+| Claude Code | `claude` | `--dangerously-skip-permissions`、`--permission-mode=bypassPermissions` | `--resume <session_id>` |
+| Codex | `codex` | `--dangerously-bypass-approvals-and-sandbox` | `resume <session_id>` |
+| OpenCode | `opencode` | 由 `~/.config/opencode/opencode.json` 配置 | `--session <session_id>` |
+| Gemini | `gemini` | `--yolo` | `--resume <session_id>` |
+| Hermes | `hermes` | `--yolo` | `--resume <session_id>` |
+| 自定义 | 任意可执行文件 | 自己配 | 自己配 |
+
+Hive 不替你安装这些 CLI。请在启动 Hive 的同一个 shell 环境里先装好、登录好。
+
+## Hive 提供什么
+
+- Workspace 侧边栏，方便在多个本机项目之间切换。
+- Orchestrator 和 Worker 终端都是真实 PTY 支撑的。
+- Add Worker 预置 coder / reviewer / tester 等角色模板，也支持完全自定义 prompt 与命令——把任何 CLI agent 编排成你需要的角色。
+- 自动组队（实验性，默认开启）：Orchestrator 可以根据任务动态创建临时 coder / tester / reviewer，完成后自动回收。
+- Workflows（实验性，默认关闭）：Orchestrator 可以运行多阶段、多 agent 的 workflow，Hive 在 Workflows 面板里展示运行、日志、结果、定时任务和停止控制。
+- Workflow CLI 策略：为 workflow 创建的 agent 选择默认 CLI，并限制允许使用的 CLI，避免脚本误启未配置的 agent。
+- `.hive/tasks.md` 编辑器，带外部文件冲突处理。
+- PTY 后台保留 + 尽力使用各 CLI 原生 session 恢复。
+- 升级后的 What's New 弹窗，用简短 release highlights 告诉你新版改了什么。
+- 元数据存在本机 SQLite，Windows 默认在 `%APPDATA%\hive`，macOS / Linux 默认在 `~/.config/hive`，也可以通过 `$HIVE_DATA_DIR` 指定。
+
+Hive **不**提供 sandbox 隔离、多用户认证，也不自带任何 agent 模型。它只负责调度你已经在用的本机 CLI。
+
+## 远程访问（可选，默认关闭）
+
+如果想在外面用手机查看、操作正在本机跑着的 Hive，可以开启可选的 **Remote access**。开启后，手机浏览器在网关上用 GitHub / Google 登录、跟桌面完成一次配对，就能通过端到端加密隧道访问**完整**的 Hive Web UI——已配对的手机是与本地浏览器**等权**的受信任设备。
+
+需要清楚的几点：
+
+- **默认关闭**。不开就没有任何出站连接、没有监听，行为跟现在一模一样。
+- **需要一个网关**。隧道要经过一个网关中转（你本机的 daemon 主动出站连它，不开端口、不动路由器）。网关地址可配置：可以 **自己 self-host** 一个 Cloudflare Workers 网关，也可以接一个已部署的网关。Hive **没有**现成的一键托管服务——这一步要你自己搭。
+- **数据和执行永远在本机**。网关只做身份（OAuth 登录）和路由，看不到明文——它只转发密文。网关挂了，本机 `127.0.0.1` 上的一切照常。
+- **端到端加密**。手机 ↔ daemon 之间所有数据帧端到端加密，网关只见密文和路由头。诚实的边界：手机端的加密代码由网关分发（web 端 E2E 的经典局限，跟 Proton / WhatsApp Web 同类），缓解手段是 SRI + 版本化 bundle + PWA 缓存形成 TOFU。我们不宣传"网关被攻破也绝对安全"。
+- **信任根在桌面**。新设备配对必须人在电脑前确认（桌面弹窗 + 6 位 SAS 短码校验）；已配对手机不能凭自己批准新设备。设备随时可吊销。
+
+完整的开启、登录（`hive remote login`）、配对、吊销和 self-host 网关步骤见 [docs/remote-access.md](docs/remote-access.md)。
+
+## 平台支持
+
+所有平台都需要 Node.js 22+。Hive 依赖 `node-pty` 和 `better-sqlite3` 这类原生包，没有预编译二进制时需要你本机有原生构建工具链。
+
+## 安全模型
+
+Hive 是本机开发工具，**不是**托管服务。
+
+- Runtime 只监听 `127.0.0.1`。不要把 Hive 端口通过公网隧道、反向代理或任何共享网络接口暴露出去。
+- 内置预设会主动传 CLI 的 non-interactive / bypass flag。Worker 在选中的 workspace 里有跟启动 shell **同等**的执行权限——把它当成"会自动跑命令的你自己"。
+- 只打开你信任的 workspace。Worker 拥有跟你登录账户一样的文件系统访问权限。
+- Agent token 是 session 级的，由本机 runtime 生成，注入到 agent 进程环境变量里，**不**用于跨网络通信。
+- Hive 不做多用户认证。任何能从本机访问到端口的进程都视为可信本地访问。
+- 浏览器 UI token 只是本机会话保护，不是用来防同一系统账户下其他进程的安全边界。
+
+在敏感仓库里用 Hive 之前，请先读 [SECURITY.md](SECURITY.md)。
+
+## 数据位置
+
+| 数据 | 位置 |
+| --- | --- |
+| Runtime 元数据 | Windows: `%APPDATA%\hive`；macOS / Linux: `~/.config/hive`；或 `$HIVE_DATA_DIR` |
+| Workspace 任务图 | `<workspace>/.hive/tasks.md` |
+| 内部 `team` 命令 | 包内 `dist/bin/`，通过 PATH 注入 PTY |
+| Web UI 资源 | 由 runtime 从包内 `web/dist` 直接服务 |
+
+## 故障排查
+
+**找不到 Agent CLI**
+
+确认选中的命令已经安装好、登录好、在启动 Hive 那个 shell 里能直接调用，且在 `PATH` 上。
+
+**端口被占用**
+
+换个本机端口启动：
+
+```bash
+hive --port 4020
+```
+
+**原生包构建失败**
+
+Hive 依赖 `node-pty` 和 `better-sqlite3`，它们用原生二进制。确认 Node.js 22+，清干净 package manager 缓存，并准备好你平台的构建工具（macOS Xcode CLI、Linux build-essential + python3、Windows VS Build Tools）。
+
+安装成功但看到 npm warning 时，可以按来源判断：
+
+| warning | 来源 | 处理 |
+| --- | --- | --- |
+| `allow-scripts hivehq` | Hive 的 postinstall 会修正打包后的 native/PTY helper 权限。 | 安装成功后可忽略。 |
+| `allow-scripts better-sqlite3` | SQLite 原生绑定需要下载预编译二进制，失败时会本机构建。 | 安装成功后可忽略；失败再检查构建工具链。 |
+| `allow-scripts node-pty` | 终端 PTY 原生绑定需要准备平台二进制。 | 安装成功后可忽略；失败再检查构建工具链。 |
+| `allow-scripts esbuild` | esbuild 会校验/选择当前平台的二进制包。 | 安装成功后可忽略。 |
+
+这是 npm 11 的安装脚本审查提示。当前 npm 版本仍是提示性质，未来可能要求用户显式批准这些脚本。你想审查时可以运行 `npm approve-scripts --allow-scripts-pending` 查看待审列表。
+
+安装时如果看到 `prebuild-install@7.1.3` 的 deprecated warning，可以忽略。它来自 `better-sqlite3` 的原生二进制下载链路，只是上游安装器维护状态提示，不代表 Hive 安装失败，也不会影响运行。
+
+**Linux 上目录选择器不弹**
+
+装 `zenity`，或者直接在对话框里粘路径。
+
+**Windows 上目录选择器**
+
+Windows 版默认使用浏览器内的服务器文件系统浏览器来添加 Workspace，不再弹 PowerShell 原生目录选择器。浏览器会从“此电脑”开始列出可访问盘符，所以可以进入 `C:\`、`D:\` 等其他盘；如果目标目录不在浏览器列表里，可以展开“高级：粘贴路径”直接输入绝对路径。
+
+**Tasks 文件冲突 banner 出现**
+
+Hive 检测到磁盘上的 `.hive/tasks.md` 比 UI 里的新。`Reload` 接受磁盘版本，`Keep Local` 保留 UI 编辑并覆盖保存。
+
+**Worker 卡在 `working` 状态**
+
+Hive 不通过进程活动猜测任务完成。Worker 只有在调 `team report` 时才会回到 `idle`。如果它确实卡了，从 UI 里 Stop 或 Restart。
+
+## 开发
+
+```bash
+pnpm install
+pnpm dev
+```
+
+开发模式下 runtime 跑在 `127.0.0.1:4010`，Vite 跑在 `127.0.0.1:5180`，把 API 和 WebSocket 代理到 runtime。
+
+常用命令：
+
+```bash
+pnpm check
+pnpm build
+pnpm test
+```
+
+预演 production 构建：
+
+```bash
+pnpm build
+node dist/src/cli/hive.js --port 4010
+```
+
+Production 模式下 runtime 直接服务构建好的 web UI，不需要单独的 Vite。
+
+## 发布
+
+维护者本地预演：
+
+```bash
+pnpm release:dry
+```
+
+完整 tag 发版清单见 [docs/release.md](docs/release.md)，里面包含 Windows 手动 smoke 步骤。
+
+带 `v*` 的 tag push 会触发 GitHub Actions release workflow。workflow 会在 macOS、Ubuntu、Windows 三平台验证，然后用 `NPM_TOKEN` 发布到 npm。
+
+## 状态
+
+Hive 目前处于 alpha 阶段，核心流程已可用。当前重点是继续打磨多 Agent 协作体验、Windows 支持和更清晰的调度可观测性。欢迎试用、提 issue——反馈会直接影响后续节奏。
+
+## 交流群
+
+有问题、想反馈，或者就想聊聊 Agent 协作，欢迎进 QQ 群：**Ai Native 交流群**（群号 `1098836554`）。
+
+<p align="center">
+  <img src="./assets/qq-group.jpg" width="240" alt="Ai Native 交流群 QQ 群二维码，群号 1098836554" />
+</p>
+
+## 在路上：跨 Agent 的长时记忆
+
+<p align="center">
+  <a href="https://github.com/EverMind-AI/EverOS">
+    <img src="https://avatars.githubusercontent.com/EverMind-AI" width="72" alt="EverMind / EverOS" />
+  </a>
+</p>
+
+单 agent 现在已经各有各的"记忆"了——但风格其实差很多：
+
+- **Claude Code 的 [Auto Dream](https://claudefa.st/blog/guide/mechanics/auto-dream)（俗称"做梦"）** 走 **离线批处理** 路线：`/dream` 触发（或 24h 自动），Claude 在云端把 JSONL 会话归并去重抽模式，产出新版本 memory 库给你审查再采纳——像人类的 REM 睡眠，**清醒 / 睡眠二相**。
+- **Hermes Agent** 反过来走 **嵌入式 / 在场** 路线：不睡，每 N 轮对话后台 fork 一个 sub-agent review，结果直接落进本地的 **多层记忆**——`MEMORY.md`（事实/规则）·`USER.md`（用户画像）·SQLite + FTS5（情景检索）·Honcho（第三人称表征）·`skills/`（程序性记忆）——而且 agent 允许边走边改自己的 skill 文件，记忆和能力是一回事。
+
+但 **这些都是单 agent 内部的记忆**。Hive 是多 agent 协作工作台，正在把它们打通：让整支团队 **共享一座长时记忆库**——Worker A 今天踩的坑，明天 Orchestrator 派给 Worker B 时能自动调来当上下文。
+
+第一阶段先走本地优先：Hive 用 SQLite 保存协作历史和显式团队记忆，支持 `team recall` / `team memory`、派单和恢复时的自动注入、`<workspace>/.hive/memory.md` 单向导出，以及离线 Dream 整理。Dream 会按 workspace 空闲和增量阈值批处理协议消息，自动应用去重/改写/归档/新增，并保留 diff 报告和整次 run 的回滚入口。
+
+下一阶段再接 **[EverOS](https://github.com/EverMind-AI/EverOS)**（[EverMind](https://evermind.ai/) 出品的开源长时记忆 OS，目前在 LoCoMo / LongMemEval / HaluMem 三个记忆 benchmark 上 SOTA）这类外部 provider。EverOS 的四层架构（Agentic / Memory / Index / API+MCP）跟 Hive 的多 PTY 协作模型很搭：每个 agent 各跑各的 CLI session，团队级的事实和模式凝在 provider，Orchestrator 派单时一并喂给 worker。
+
+进度跟踪：[#6](https://github.com/tt-a1i/hive/issues/6)——想看进度或提建议，在 issue 留 +1。
+
+## 另一种形态：squad
+
+如果你更喜欢 **纯 CLI、零后台进程、能直接在 SSH 进的远端服务器上跑** 的形态，[squad](https://github.com/mco-org/squad) 是同一个想法的另一条路线——SQLite 当通信层，每个 agent 各自开一个终端。两个项目互不替代，按工作流挑就行：
+
+- **Hive** — 想要可视化工作台、一键重启、侧边栏切 workspace、给团队演示
+- **squad** — 活在 tmux 里、SSH 远端开发、不想跑额外后台进程、Windows server
+
+## 鸣谢
+
+Hive 的"模板市场"内置了两份社区角色 prompt 库的快照，两份都按各自上游的 MIT 许可分发：
+
+- 英文版（界面切到 EN 时使用）：[`msitarzewski/agency-agents`](https://github.com/msitarzewski/agency-agents)
+- 中文版（界面切到中文时使用）：[`jnMetaCode/agency-agents-zh`](https://github.com/jnMetaCode/agency-agents-zh)
+
+上游内容未做修改，许可证文本保留在 `vendor/marketplace/<lang>/LICENSE`；快照通过 `pnpm sync:marketplace` 在 hive 发版前刷新。
+
+## License
+
+Hive 源码在 Business Source License 1.1 下提供。个人使用、内部部署、嵌入、fork 都可以；详细边界见 [LICENSE.BSL](LICENSE.BSL)。
+
+Fork 或再分发版本必须保留 [NOTICE](NOTICE)、[LICENSE.BSL](LICENSE.BSL) 和相关许可证文件。Hive 名称、logo 和视觉识别不随源码许可证授权；品牌使用边界见 [TRADEMARK.md](TRADEMARK.md)。

package/SECURITY.md

@@ -0,0 +1,59 @@
+# Security Policy
+
+Hive is a local development tool for coordinating CLI agents. It is not a
+hosted service and does not provide a multi-user security boundary.
+
+## Supported Versions
+
+| Version | Supported |
+| --- | --- |
+| 0.6.x alpha | Security fixes accepted during public preview. |
+| Earlier versions | Not supported. |
+
+## Reporting a Vulnerability
+
+Use GitHub private vulnerability reporting for `tt-a1i/hive` whenever it is
+available. Do not paste exploit details, tokens, terminal logs, private
+workspace paths, or reproduction scripts into a public issue.
+
+If private reporting is temporarily unavailable, open a minimal public issue
+with the title `Security contact request` and no technical details; a maintainer
+will provide a private contact path before triage continues.
+
+Expected response during public preview:
+
+- Initial maintainer response: best effort within 7 days.
+- Public disclosure or changelog entry: after a fix is available, or earlier
+  when the issue does not expose users to practical exploitation.
+
+Please include:
+
+- Hive version or commit SHA.
+- Operating system and Node.js version.
+- Whether the issue affects the local runtime, packaged install, web UI, PTY
+  process handling, or the injected `team` command.
+- A minimal reproduction when it is safe to share.
+
+## Local Runtime Safety
+
+- Hive binds to `127.0.0.1` by default. Do not expose the runtime port to the
+  internet or to an untrusted network.
+- Built-in presets may pass each CLI's non-interactive or bypass flag so worker
+  agents can continue without manual permission prompts.
+- Treat workers as able to run arbitrary shell commands with the permissions of
+  the user account that launched Hive.
+- Only open trusted workspaces. Hive intentionally gives agents access to the
+  selected workspace so they can edit files and run project commands.
+- Agent tokens are generated by the local runtime, injected into agent process
+  environments, and intended only for local agent-to-runtime calls.
+- The browser UI token is a same-machine session guard. It is not designed to
+  protect Hive from other processes already running as the same OS user.
+- Do not paste Hive agent tokens, terminal output, or workspace logs into public
+  reports if they include private repository or machine details.
+
+## Out of Scope for Public Preview
+
+- Running Hive as a shared server for multiple users.
+- Exposing Hive through a public tunnel or reverse proxy.
+- Operating Hive as a hardened production service.
+- Sandboxing third-party CLI agents beyond the controls provided by those CLIs.

package/TRADEMARK.md

@@ -0,0 +1,41 @@
+# Trademark Guidelines
+
+These guidelines apply to the Hive name, logo, icons, visual identity, and
+other brand assets owned by Shaokun Tu (tt-a1i).
+
+The source license for Hive grants rights to use, modify, and distribute the
+software under the terms of LICENSE.BSL. It does not grant trademark rights.
+
+## Permitted Uses
+
+You may:
+
+- Refer to Hive by name when describing compatibility, attribution, or that a
+  project is based on Hive.
+- Use phrases such as "forked from Hive", "based on Hive", or "compatible with
+  Hive" when the relationship is accurate.
+- Link to the upstream Hive repository and documentation.
+
+## Uses That Need Permission
+
+You need prior written permission to:
+
+- Use the Hive name, logo, or icons as the primary name or identity of a fork,
+  distribution, hosted service, or commercial product.
+- Present a fork or derivative work in a way that suggests it is official,
+  endorsed, sponsored, or maintained by tt-a1i.
+- Register domains, social accounts, packages, apps, or marketplaces names that
+  are likely to confuse users about whether they are official Hive properties.
+- Use Hive brand assets in paid advertising, product packaging, or hosted
+  service branding.
+
+## Forks And Derivative Products
+
+Forks should use a distinct product name and distinct visual identity. They
+must preserve the applicable license files and NOTICE file, and should clearly
+state that they are independent from upstream Hive unless a separate written
+agreement says otherwise.
+
+These guidelines do not change the software license. If there is a conflict
+between this document and LICENSE.BSL, LICENSE.BSL controls software license
+rights and this document controls brand usage.

package/dist/bin/team

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { runTeamCommand } from '../src/cli/team.js'
+
+void runTeamCommand(process.argv.slice(2)).catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error))
+  process.exit(1)
+})

package/dist/bin/team.cmd

@@ -0,0 +1,3 @@
+@echo off
+setlocal DisableDelayedExpansion
+node "%~dp0..\src\cli\team.js" %*

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

@@ -0,0 +1,46 @@
+import { DEFAULT_GATEWAY_URL, REMOTE_DAEMON_ID_KEY, REMOTE_DAEMON_TOKEN_KEY, REMOTE_ENABLED_KEY, REMOTE_GATEWAY_URL_KEY } from '../server/remote-config-keys.js';
+import { type RemoteDeviceRecord } from '../server/remote-device-store.js';
+export { DEFAULT_GATEWAY_URL, REMOTE_DAEMON_ID_KEY, REMOTE_DAEMON_TOKEN_KEY, REMOTE_ENABLED_KEY, REMOTE_GATEWAY_URL_KEY, };
+export declare const HIVE_REMOTE_USAGE: string;
+export interface RemoteConfigStore {
+    get(key: string): {
+        value: string | null;
+    } | undefined;
+    set(key: string, value: string | null): void;
+}
+export interface RemoteDeviceListStore {
+    list(includeRevoked?: boolean): RemoteDeviceRecord[];
+    /** Idempotent; false if the device is unknown or already revoked. */
+    revoke(deviceId: string, now?: number): boolean;
+}
+export interface DaemonCodeResponse {
+    code: string;
+    expiresAt: number;
+    pollIntervalMs: number;
+}
+export interface DaemonTokenResponse {
+    daemonId: string;
+    daemonToken: string;
+}
+export interface GatewayClient {
+    requestCode(gatewayUrl: string): Promise<DaemonCodeResponse>;
+    exchangeToken(gatewayUrl: string, code: string, name?: string): Promise<DaemonTokenResponse | null>;
+}
+export declare const defaultGatewayClient: GatewayClient;
+export interface RunHiveRemoteOptions {
+    /** Inject a fake gateway client (tests). */
+    client?: GatewayClient;
+    /** Inject an in-memory config store (tests); defaults to the runtime DB. */
+    config?: RemoteConfigStore;
+    /** Inject a device store (tests); defaults to the runtime DB's device store. */
+    deviceStore?: RemoteDeviceListStore;
+    /** Inject a clock for poll-timeout tests. */
+    now?: () => number;
+    /** Inject the poll delay so tests don't actually wait. */
+    sleep?: (ms: number) => Promise<void>;
+    /** stdout sink (defaults to console.log). */
+    log?: (line: string) => void;
+    /** stderr sink (defaults to console.error). */
+    error?: (line: string) => void;
+}
+export declare const runHiveRemoteCommand: (argv: string[], options?: RunHiveRemoteOptions) => Promise<number>;