@tt-a1i/hive 0.6.0-alpha.5 → 0.6.0-alpha.8

package/CHANGELOG.md

@@ -2,6 +2,60 @@
 
 All notable user-facing changes will be documented in this file.
 
+## 0.6.0-alpha.8 - 2026-05-16
+
+License switch — no code changes from alpha.7.
+
+- Starting from this version, Hive is licensed under the **Business Source
+  License 1.1** (BSL), not Apache-2.0. BSL allows personal use, internal
+  organizational deployment, embedding in non-competitive products, and
+  non-commercial forks. It only prohibits offering Hive as a hosted or
+  embedded multi-agent orchestration service to third parties on a paid
+  basis. On **2030-05-16** the license automatically converts to Apache-2.0.
+- All versions at or before `0.6.0-alpha.7` remain permanently licensed
+  under Apache-2.0 — that grant is irrevocable and is not affected by this
+  switch.
+- See [`LICENSE.BSL`](./LICENSE.BSL) for the full BSL text including the
+  Additional Use Grant, and [`LICENSE`](./LICENSE) for the historical
+  Apache-2.0 grant.
+
+## 0.6.0-alpha.7 - 2026-05-16
+
+Worker identity, language, and workflow polish.
+
+- Worker cards and the worker detail modal now display the CLI agent's
+  brand logo (Claude Code, Codex, Gemini, OpenCode) instead of the
+  role-letter placeholder. Unknown presets or workers launched via a
+  custom command fall back to the legacy role-letter avatar so existing
+  rows never render blank. The `team list` payload gained a
+  `command_preset_id` field (snake_case wire, camelCase in-process); the
+  enrichment honours `presetAugmentationDisabled` so the launcher and
+  the UI stay in lockstep.
+- Workers can now boot from a custom `startup_command` (e.g. native
+  `claude --resume <session-id>`) entered from the add-member or
+  add-Workspace dialogs. Routes-workspaces detects shell-driven
+  invocations and stores them without binding to a preset.
+- UI language adapts across the entire surface: task drawer (including
+  the raw Markdown editor that previously mixed Chinese conflict copy
+  with English buttons), notification settings popover, OS-level
+  desktop notifications, the workspace add / confirm / server-browse
+  dialogs, the FS picker, the demo view, the toast container, and the
+  terminal screen-reader status. Adds a `~146`-key expansion of the
+  i18n table covering `tasks.*`, `notifications.*`, `workspace.*`,
+  `layout.*`, `terminal.*`, `terminalPanels.*`, `toast.*`, and a couple
+  of `demo.*` / `common.*` additions; `{plural}` placeholders are gone
+  so the wire shape can't leak literal `{plural}` tokens at runtime.
+- Worker cards lost the bottom raw-PTY line preview (a noisy CLI
+  status row that varied per agent and confused users). The
+  `last_pty_line` field stays on the wire so a future "current task
+  summary" surface can reuse it.
+- Translation copy itself was reviewed: `Queen` is gone from UI chrome
+  (the metaphor only appears in onboarding prose), Workspace /
+  Orchestrator / Agent are normalised as proper nouns in Chinese
+  copy, role names tightened (`Coder → 开发`, `Tester → 测试`),
+  ellipsis switched from ASCII `...` to typographic `…`, `task(s)`
+  notation retired.
+
 ## 0.6.0-alpha.5 - 2026-05-15
 
 Public-preview surface polish + internal hygiene pass.

package/LICENSE

@@ -1,3 +1,10 @@
+This Apache License 2.0 applies only to versions of Hive at or before
+0.6.0-alpha.7. Starting from 0.6.0-alpha.8, Hive is licensed under the
+Business Source License 1.1 (see LICENSE.BSL). The BSL automatically
+converts to Apache-2.0 on 2030-05-16.
+
+---
+
                                  Apache License
                            Version 2.0, January 2004
                         https://www.apache.org/licenses/
@@ -199,4 +206,3 @@
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
-

package/LICENSE.BSL

@@ -0,0 +1,101 @@
+Business Source License 1.1
+
+Licensor: Shaokun Tu (tt-a1i)
+Licensed Work: Hive 0.6.0-alpha.8 and later
+Change Date: 2030-05-16
+Change License: Apache License, Version 2.0
+
+Additional Use Grant:
+
+You may make production use of the Licensed Work, provided Your use does not
+include offering the Licensed Work to third parties on a hosted or embedded
+basis in order to compete with Licensor's multi-CLI-agent orchestration
+product.
+
+For purposes of this license, a "competitive offering" is a Product that:
+  (a) is offered to third parties on a paid basis, including paid support
+      arrangements or any form of revenue-generating arrangement; and
+  (b) provides browser-accessible multi-CLI-agent collaboration
+      (orchestrator + worker agents running as PTY sessions communicating
+      via a team protocol), substantially overlapping with the core
+      capabilities of the Licensed Work.
+
+Internal production use by Your organization, embedding the Licensed Work
+into a non-competitive product, and non-commercial forks are not
+"competitive offerings".
+
+License text copyright (c) 2024 MariaDB plc, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB plc.
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may
+vary for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License's text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License's text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to
+all other recipients of the licensed work to be provided by Licensor:
+
+To specify as the Change License the GPL Version 2.0 or any later version,
+or a license that is compatible with GPL Version 2.0 or a later version,
+where "compatible" means that software provided under the Change License can
+be included in a program with software provided under GPL Version 2.0 or a
+later version. Licensor may specify additional Change Licenses without
+limitation.
+
+To either: (a) specify an additional grant of rights to use that does not
+impose any additional restriction on the right granted in this License, as
+the Additional Use Grant; or (b) insert the text "None".
+
+To specify a Change Date.
+
+Not to modify this License in any other way.
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.

package/README.en.md

@@ -0,0 +1,275 @@
+# Hive
+
+<p align="center">
+  <img src="./assets/hive-hero.png" alt="Hive local-first multi-agent coding workspace hero image" />
+</p>
+
+**Hive is a browser-native hive-mind for CLI coding agents.** The orchestrator
+is a real `claude` / `codex` / `opencode` / `gemini` process — not you, and
+not a script — and so are the workers it dispatches to. Every agent runs as
+a real PTY on your machine, talks through a small `team` protocol that Hive
+injects into each agent's shell, and shares a markdown task graph at
+`<workspace>/.hive/tasks.md`.
+
+[![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)
+[![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/)
+
+English · [简体中文](./README.md)
+
+> Public preview. Hive is local-first, runs on `127.0.0.1`, and is intended
+> for developers who already use CLI coding agents. The latest published
+> version is on [npm](https://www.npmjs.com/package/@tt-a1i/hive) and the
+> badge above resolves to it.
+
+## Why Hive
+
+CLI coding agents are powerful, but coordinating several of them manually is
+awkward:
+
+- Long-running sessions are spread across terminals.
+- It is hard to split a task into implementation, review, and testing without a
+  routing layer.
+- Worker progress disappears into scrollback.
+- Restart recovery depends on each CLI's native session behavior.
+
+Hive adds that coordination layer without replacing the CLIs. The agents remain
+real terminal processes running on your machine; Hive manages the team shell
+around them.
+
+## Try the demo first
+
+Don't have an agent CLI installed yet? Run `hive`, open the printed URL, and
+click **Try Demo** in the first-run wizard. You get a fully client-side
+preview — fake orchestrator + two workers, prerecorded scrollback, a
+prefilled task list — without touching the server or any real CLI agent.
+Useful for deciding whether to install a real CLI.
+
+## Quick Start
+
+Prerequisites:
+
+- Node.js 22 or newer.
+- At least one supported agent CLI installed, authenticated, and available on
+  `PATH`.
+
+Install and start Hive:
+
+```bash
+npm install -g @tt-a1i/hive
+hive
+```
+
+Open the printed local URL, usually `http://127.0.0.1:3000/`. Use
+`hive --port 4010` when you need a specific local port.
+
+First-run flow:
+
+1. Create a workspace from a project folder.
+2. Choose an Orchestrator preset.
+3. Hive creates `<workspace>/.hive/tasks.md`, starts the Orchestrator PTY, and
+   injects the internal `team` command into the agent session.
+4. Add workers from the Team Members panel.
+5. Ask the Orchestrator to delegate work. It sends tasks with
+   `team send <worker-name> "<task>"`; workers report back with `team report`.
+
+## How It Works
+
+```text
+Browser UI on 127.0.0.1
+  tasks, team, terminals, reports
+          |
+          | HTTP + WebSocket
+          v
+Hive runtime
+  SQLite metadata, PTY lifecycle, task dispatch
+          |
+          +-- Orchestrator PTY
+          |     can call: team send, team list, team report
+          |
+          +-- Worker PTY
+          |     can call: team report
+          |
+          +-- Worker PTY
+                can call: team report
+
+Workspace task graph:
+  <workspace>/.hive/tasks.md
+```
+
+Three details matter:
+
+- Agents are real CLI processes, not simulated subagents.
+- `team` is injected only inside Hive-managed agent sessions by prepending the
+  package's internal bin directory to `PATH`; it is not installed as a global
+  command.
+- The task graph is a markdown file in the workspace, so you can inspect or
+  edit it outside the app.
+
+## Agent Presets
+
+| Preset | Command expected on `PATH` | Default bypass mode | Session resume |
+| --- | --- | --- | --- |
+| 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-driven in `~/.config/opencode/opencode.json` | `--session <session_id>` |
+| Gemini | `gemini` | `--yolo` | `--resume <session_id>` |
+| Custom | Any executable | User configured | User configured |
+
+Hive does not install these CLIs for you. Install and authenticate them in the
+same shell environment you use to start Hive.
+
+## What Hive Provides
+
+- Workspace sidebar for switching between local projects.
+- Orchestrator and worker terminals backed by real PTYs.
+- Add Worker flow with role presets for coder, reviewer, tester, and custom
+  members.
+- `.hive/tasks.md` editor with external-file conflict handling.
+- Background PTY preservation and best-effort native session resume.
+- Local SQLite metadata under `~/.config/hive` by default, or `$HIVE_DATA_DIR`
+  when set.
+
+Hive does not provide sandboxing, multi-user auth, cloud hosting, or its own
+coding model. It coordinates tools you already run locally.
+
+## Platform Support
+
+| Platform | Status | Notes |
+| --- | --- | --- |
+| macOS | Tier 1 | Main development and release verification target. |
+| Linux | Tier 1 | CI verified. Native folder picking expects `zenity`; manual path entry works without it. |
+| Windows | Tier 2 | CI runs a Windows test subset and a packaged-install smoke. Folder picking uses Windows PowerShell and the package includes `team.cmd`. Treat as best-effort — full Windows verification before each release is manual. |
+
+All platforms require Node.js 22+. Hive depends on native packages
+(`node-pty` and `better-sqlite3`), so native install tooling may be required
+when prebuilt binaries are unavailable.
+
+## Safety Model
+
+Hive is a local development tool, not a hosted service.
+
+- The runtime binds to `127.0.0.1`. Do not expose the Hive port through a public
+  tunnel, reverse proxy, or shared network interface.
+- Built-in presets intentionally use each CLI's non-interactive or bypass mode
+  where available. Treat workers as able to run arbitrary shell commands inside
+  the selected workspace.
+- Open only trusted workspaces. A worker has the same filesystem access as the
+  shell account running Hive.
+- Agent tokens are session scoped, generated by the local runtime, injected into
+  agent process environments, and not intended as internet-facing credentials.
+- Hive has no multi-user authentication boundary. Treat same-machine processes
+  that can reach the local port as trusted local access.
+- The browser UI token is a local session guard, not protection against other
+  processes already running as your OS user.
+
+Read [SECURITY.md](SECURITY.md) before using Hive with sensitive repositories.
+
+## Data Locations
+
+| Data | Location |
+| --- | --- |
+| Runtime metadata | `~/.config/hive` or `$HIVE_DATA_DIR` |
+| Workspace tasks | `<workspace>/.hive/tasks.md` |
+| Internal `team` command | Packaged under `dist/bin/`, injected into PTYs |
+| Web UI assets | Served by the runtime from the packaged `web/dist` build |
+
+## Troubleshooting
+
+**Agent CLI not found**
+
+Check that the selected command is installed, authenticated, executable from the
+same shell, and available on `PATH`.
+
+**Port already in use**
+
+Start Hive with another local port:
+
+```bash
+hive --port 4020
+```
+
+**Native package install fails**
+
+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.
+
+**Folder picker does not open on Linux**
+
+Install `zenity`, or paste the workspace path manually.
+
+**Folder picker does not open on Windows**
+
+Verify Windows PowerShell is available as `powershell.exe`, or paste the
+workspace path manually.
+
+**Tasks file conflict banner appears**
+
+Hive detected a newer `.hive/tasks.md` on disk. Use `Reload` to accept the file
+from disk, or `Keep Local` to keep the editor contents and save again.
+
+**Worker appears stuck in `working`**
+
+Hive does not guess task completion from process activity. Workers move back to
+`idle` when they call `team report`. If a worker is blocked, stop or restart it
+from the UI.
+
+## Development
+
+```bash
+pnpm install
+pnpm dev
+```
+
+Development mode runs the runtime on `127.0.0.1:4010`; Vite runs on
+`127.0.0.1:5180` and proxies API and WebSocket traffic to the runtime.
+
+Useful checks:
+
+```bash
+pnpm check
+pnpm build
+pnpm test
+```
+
+Production-style local run:
+
+```bash
+pnpm build
+node dist/src/cli/hive.js --port 4010
+```
+
+The production server serves the built web UI directly. No Vite server is
+needed after `pnpm build`.
+
+## Release
+
+Maintainer dry run:
+
+```bash
+pnpm release:dry
+```
+
+See [docs/release.md](docs/release.md) for the full tagged release checklist,
+including manual Windows smoke steps.
+
+Tag pushes matching `v*` run the GitHub Actions release workflow. The workflow
+verifies macOS, Ubuntu, and Windows, then publishes to npm with `NPM_TOKEN`.
+
+## Status
+
+Hive is in alpha public preview. Expect UI and protocol details to keep moving
+while the core local orchestration model hardens.
+
+## License
+
+- **0.6.0-alpha.8 onward**: Business Source License 1.1 (see [LICENSE.BSL](LICENSE.BSL)). Automatically converts to Apache-2.0 on 2030-05-16.
+- **0.6.0-alpha.7 and earlier**: Apache-2.0 (see [LICENSE](LICENSE)), permanent grant.
+
+BSL permits personal use, internal deployment, embedding in non-competitive products, and non-commercial forks. **Only prohibits** offering Hive as a hosted multi-agent orchestration service to third parties. See the Additional Use Grant in [LICENSE.BSL](LICENSE.BSL) for the exact boundary.