@hueyexe/opencode-ensemble 0.14.1 → 0.15.0

package/README.md

@@ -6,7 +6,7 @@
 
 [![npm version](https://img.shields.io/npm/v/@hueyexe/opencode-ensemble.svg)](https://www.npmjs.com/package/@hueyexe/opencode-ensemble)
 [![npm downloads](https://img.shields.io/npm/dm/@hueyexe/opencode-ensemble.svg)](https://www.npmjs.com/package/@hueyexe/opencode-ensemble)
-[![tests](https://img.shields.io/badge/tests-561%20passing-brightgreen.svg)]()
+[![tests](https://img.shields.io/badge/tests-623%20passing-brightgreen.svg)]()
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)]()
 [![OpenCode SDK](https://img.shields.io/badge/deps-OpenCode%20SDK%20only-blue.svg)]()
 [![license](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
@@ -19,7 +19,7 @@ Plugin built on the public OpenCode SDK. No internal dependencies.
 
 ```json
 {
-  "plugin": ["@hueyexe/opencode-ensemble@0.14.1"]
+  "plugin": ["@hueyexe/opencode-ensemble@0.15.0"]
 }
 ```
 
@@ -152,6 +152,7 @@ A real-time mission control dashboard runs at `http://localhost:4747` while Open
 - **Timeline** — horizontal event strip showing spawns, messages, completions, shutdowns
 - **Keyboard shortcuts** — `j/k` navigate agents, `Enter` opens drawer, `Esc` closes, `?` shows help
 - **Live clock** — current time + team session duration
+- **Project outline** — collapsible per-project grouping when teams span multiple working directories
 
 Configure the port in `.opencode/ensemble.json`:
 
@@ -167,6 +168,13 @@ Set to `0` to disable. The dashboard starts automatically when OpenCode loads th
 
 Two steps: add the plugin, then allowlist worktree paths.
 
+### Runtime requirements
+
+The plugin uses SQLite via the host's runtime adapter:
+
+- **Bun**: any version with `bun:sqlite` (Bun ≥ 1.0).
+- **Node / Electron** (e.g. opencode Desktop): **Node ≥ 24** for stable `node:sqlite`. Older Node (20.x) lacks the module entirely; Node 22.5–23 has it behind `--experimental-sqlite`. If you load the plugin under an older Node and see `Cannot find module 'node:sqlite'` at startup, your runtime is too old.
+
 ### 1. Add the plugin
 
 Add to your OpenCode config with a pinned version. Project-level or global.
@@ -175,7 +183,7 @@ Add to your OpenCode config with a pinned version. Project-level or global.
 
 ```json
 {
-  "plugin": ["@hueyexe/opencode-ensemble@0.14.1"]
+  "plugin": ["@hueyexe/opencode-ensemble@0.15.0"]
 }
 ```
 
@@ -183,7 +191,7 @@ Add to your OpenCode config with a pinned version. Project-level or global.
 
 ```json
 {
-  "plugin": ["@hueyexe/opencode-ensemble@0.14.1"]
+  "plugin": ["@hueyexe/opencode-ensemble@0.15.0"]
 }
 ```
 
@@ -237,7 +245,7 @@ Build with `bun run build`, then restart OpenCode to pick up changes.
 
 | Tool | What it does |
 |------|-------------|
-| `team_create` | Create a team. Caller becomes the lead. |
+| `team_create` | Create a team. Caller becomes the lead. Accepts optional `project_name` to label the project. |
 | `team_spawn` | Start a new teammate with a task. Supports `plan_approval` mode. |
 | `team_shutdown` | Ask a teammate to stop. Preserves their branch before aborting. Supports `force` flag. |
 | `team_merge` | Merge a shutdown teammate's branch into working directory (unstaged). Blocks if you have local changes to overlapping files. |
@@ -280,7 +288,7 @@ Teammate messages arrive in the lead's session as `[Team message from alice]: ..
 
 ## Architecture
 
-- **SQLite** (`bun:sqlite`, WAL mode) for teams, members, tasks, and messages
+- **SQLite** (WAL mode) for teams, members, tasks, and messages. Uses `bun:sqlite` in Bun and `node:sqlite` in Node/Electron through the internal database adapter.
 - **promptAsync** for message delivery: injects a message and starts the prompt loop in one call
 - **Git worktree isolation**: each teammate gets their own worktree by default, so multiple agents can edit files without conflicts. Opt out with `worktree: false` for read-only agents.
 - **System prompt injection**: the lead's system prompt includes team state (member statuses, task counts) on every LLM call. Teammates get a short role reminder.
@@ -447,7 +455,7 @@ Same coordination model (shared tasks, peer messaging, lead coordination) with s
 ```bash
 bun install
 bun run typecheck
-bun test             # 561 tests
+bun test             # 623 tests
 bun run build
 ```