neohive 6.0.2 → 6.1.0

package/README.md

@@ -1,13 +1,15 @@
 <p align="center">
-  <h1 align="center">Neohive</h1>
+  <img src="logo.svg" width="120" alt="Neohive logo" />
 </p>
 
+<h1 align="center">Neohive</h1>
+
 <p align="center">
   <strong>One command. Your AI agents can talk to each other.</strong>
 </p>
 
 <p align="center">
-  The MCP collaboration layer for Claude Code, Gemini CLI, and Codex CLI.
+  The MCP collaboration layer for Claude Code, Gemini CLI, Cursor, VS Code Copilot, and more.
 </p>
 
 <br />
@@ -28,7 +30,7 @@
   <a href="#-quick-start">Quick Start</a> &middot;
   <a href="#-features">Features</a> &middot;
   <a href="#-how-it-works">How It Works</a> &middot;
-  <a href="docs/DOCUMENTATION.md">Documentation</a> &middot;
+  <a href="docs/documentation.md">Documentation</a> &middot;
   <a href="#%EF%B8%8F-cli-reference">CLI Reference</a> &middot;
   <a href="https://www.npmjs.com/package/neohive">npm</a>
 </p>
@@ -52,7 +54,7 @@ You open Claude Code in one terminal and Gemini CLI in another. Both are powerfu
 - [Quick Start](#-quick-start)
 - [Features](#-features)
 - [How It Works](#-how-it-works)
-- [Supported CLIs](#-supported-clis)
+- [Supported IDEs & CLIs](#-supported-ides--clis)
 - [Team Templates](#-team-templates)
 - [Dashboard](#-dashboard)
 - [MCP Tools](#-mcp-tools)
@@ -73,6 +75,8 @@ npx neohive init
 
 That's it. Neohive auto-detects your CLI, writes the MCP config, and creates a `.neohive/` data directory.
 
+**MCP config:** `npx neohive init` writes the **absolute path** to the same Node binary that ran the command (so Volta, nvm, or custom installs work even when your IDE’s MCP subprocess has a minimal `PATH`). For **Claude Code**, the project file is `.mcp.json` in the repo root; you can merge the same `neohive` entry into `~/.claude/mcp.json` if you prefer a user-wide setup. Restart the IDE or reload MCP tools after init.
+
 Now open two terminals in the same project:
 
 ```
@@ -111,28 +115,30 @@ npx neohive dashboard    # opens http://localhost:3000
 | 🌿 | **Branching** | Fork conversations at any point with isolated history |
 | 📡 | **Channels** | Sub-team communication with dedicated message streams |
 | 🗳️ | **Voting & Reviews** | Team decisions and structured code review workflows |
-| 🔌 | **Multi-CLI** | Works across Claude Code, Gemini CLI, Codex CLI, and Ollama |
+| 👁 | **Agent Liveness** | Passive stdin tracking, PID checks, auto-reclaim dead seats, unknown/stale/offline states |
+| 🔌 | **Multi-CLI** | Works across Claude Code, Gemini CLI, Cursor, VS Code Copilot, Antigravity, Codex CLI, and Ollama |
 
 <br />
 
 ## 🏗 How It Works
 
 ```
-  ┌─────────────┐   ┌─────────────┐   ┌─────────────┐
-  │ Claude Code  │   │ Gemini CLI  │   │  Codex CLI  │
-  │  Terminal 1  │   │  Terminal 2  │   │  Terminal 3  │
-  └──────┬───────┘   └──────┬───────┘   └──────┬───────┘
-         │                  │                   │
-    MCP Server         MCP Server          MCP Server
-    (stdio)            (stdio)             (stdio)
-         │                  │                   │
-         └──────────────────┼───────────────────┘
-                            │
-                   ┌────────▼────────┐
-                   │   .neohive/     │
-                   │                 │
-                   │  messages.jsonl │
-                   │  agents.json    │
+  ┌─────────────┐   ┌─────────────┐   ┌─────────────┐   ┌─────────────┐
+  │ Claude Code  │   │ Gemini CLI  │   │   Cursor    │   │ VS Code +   │
+  │  Terminal 1  │   │  Terminal 2  │   │  Terminal 3  │   │  Copilot    │
+  └──────┬───────┘   └──────┬───────┘   └──────┬───────┘   └──────┬───────┘
+         │                  │                   │                  │
+    MCP Server         MCP Server          MCP Server         MCP Server
+    (stdio)            (stdio)             (stdio)            (stdio)
+         │                  │                   │                  │
+         └──────────────────┼───────────────────┼──────────────────┘
+                            │                   │
+                   ┌────────▼────────┐   ┌──────▼──────┐
+                   │   .neohive/     │   │  Extension  │
+                   │                 │   │  (liveness) │
+                   │  messages.jsonl │   └──────┬──────┘
+                   │  agents.json    │          │
+                   │  heartbeat-*.json│─────────┘
                    │  tasks.json     │
                    │  workflows.json │
                    │  ...            │
@@ -149,14 +155,17 @@ Each CLI spawns its own MCP server process. All processes share a `.neohive/` di
 
 <br />
 
-## 🔌 Supported CLIs
+## 🔌 Supported IDEs & CLIs
 
-| CLI | Config Location | Auto-detected | Init Flag |
-|-----|----------------|:---:|-----------|
-| [Claude Code](https://claude.ai/code) | `.mcp.json` | ✅ | `--claude` |
-| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `.gemini/settings.json` | ✅ | `--gemini` |
-| [Codex CLI](https://github.com/openai/codex) | `.codex/config.toml` | ✅ | `--codex` |
-| [Ollama](https://ollama.com) | `.neohive/ollama-agent.js` | ✅ | `--ollama` |
+| Tool | Config File | Rules File | Init Flag |
+|------|------------|------------|-----------|
+| [Claude Code](https://claude.ai/code) | `.mcp.json` | `CLAUDE.md` | `--claude` |
+| [Cursor](https://cursor.com) | `.cursor/mcp.json` | `.cursor/rules/neohive.mdc` | `--cursor` |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `.gemini/settings.json` | `GEMINI.md` | `--gemini` |
+| [VS Code Copilot](https://code.visualstudio.com) | `.vscode/mcp.json` | `.github/copilot-instructions.md` | `--vscode` |
+| [Antigravity](https://antigravity.dev) | `~/.gemini/antigravity/mcp_config.json` | `.agent/skills/neohive/SKILL.md` | `--antigravity` |
+| [Codex CLI](https://github.com/openai/codex) | `.codex/config.toml` | — | `--codex` |
+| [Ollama](https://ollama.com) | `.neohive/ollama-agent.js` | — | `--ollama` |
 
 ```bash
 npx neohive init --all    # configure all detected CLIs at once
@@ -185,7 +194,8 @@ npx neohive init --template <name>
 ## 📊 Dashboard
 
 ```bash
-npx neohive dashboard          # http://localhost:3000
+npx neohive dashboard          # http://localhost:3000 (default)
+NEOHIVE_PORT=8080 npx neohive dashboard   # custom port — URL shown in the terminal on startup
 npx neohive dashboard --lan    # accessible from your phone
 ```
 
@@ -199,50 +209,37 @@ npx neohive dashboard --lan    # accessible from your phone
 | **Stats** | Per-agent scores, response times, hourly activity charts |
 | **Docs** | In-dashboard tool reference and mode guides |
 
-Plus: agent status monitoring, profile popups, message injection, conversation export (HTML/JSON/replay), multi-project support, dark/light theme, mobile responsive.
+Plus: agent liveness monitoring (working/listening/idle/stale/unknown/offline), auto-reclaim on session reconnect, profile popups, message injection, conversation export (HTML/JSON/replay), multi-project support, dark/light theme, mobile responsive.
 
 <br />
 
 ## 🛠 MCP Tools
 
-**24 core tools** always available. **30+ optional tools** loaded with `NEOHIVE_FULL_TOOLS=true`.
+The MCP server exposes **70+ built-in tools** in one registration list (no separate “lite” vs “full” mode). See [docs/reference/tools.md](../docs/reference/tools.md) for full parameters and behavior ([hub](../docs/documentation.md)).
 
 <details>
-<summary><strong>Core Tools (24)</strong> — messaging, tasks, workflows, storage</summary>
+<summary><strong>Tool categories</strong> — messaging, tasks, workflows, autonomy, governance</summary>
 
 <br />
 
 | Category | Tools |
 |----------|-------|
-| **Identity** | `register` · `list_agents` · `update_profile` · `get_briefing` |
-| **Messaging** | `send_message` · `broadcast` · `listen` · `check_messages` · `ack_message` |
-| **History** | `get_history` · `get_summary` · `search_messages` |
+| **Identity & briefing** | `register` · `list_agents` · `update_profile` · `get_briefing` · `get_guide` |
+| **Messaging** | `send_message` · `broadcast` · `listen` · `listen_group` · `listen_codex` · `wait_for_reply` · `check_messages` · `consume_messages` · `get_notifications` · `ack_message` |
+| **History & search** | `get_history` · `get_summary` · `search_messages` · `get_compressed_history` |
 | **Collaboration** | `handoff` · `share_file` · `lock_file` · `unlock_file` |
 | **Tasks** | `create_task` · `update_task` · `list_tasks` |
 | **Workflows** | `create_workflow` · `advance_workflow` · `workflow_status` |
 | **Storage** | `workspace_write` · `workspace_read` · `workspace_list` |
-
-</details>
-
-<details>
-<summary><strong>Optional Tools (30+)</strong> — autonomy, voting, reviews, branching</summary>
-
-<br />
-
-| Category | Tools |
-|----------|-------|
 | **Autonomy** | `get_work` · `verify_and_advance` · `start_plan` · `retry_with_improvement` · `distribute_prompt` |
-| **Managed Mode** | `claim_manager` · `yield_floor` · `set_phase` · `set_conversation_mode` |
-| **Knowledge** | `kb_write` · `kb_read` · `kb_list` |
-| **Decisions** | `log_decision` · `get_decisions` |
-| **Voting** | `call_vote` · `cast_vote` · `vote_status` |
-| **Reviews** | `request_review` · `submit_review` |
-| **Progress** | `update_progress` · `get_progress` |
-| **Dependencies** | `declare_dependency` · `check_dependencies` |
+| **Managed mode** | `claim_manager` · `yield_floor` · `set_phase` · `set_conversation_mode` |
+| **Knowledge & decisions** | `kb_write` · `kb_read` · `kb_list` · `log_decision` · `get_decisions` |
+| **Voting & reviews** | `call_vote` · `cast_vote` · `vote_status` · `request_review` · `submit_review` |
+| **Progress & deps** | `update_progress` · `get_progress` · `declare_dependency` · `check_dependencies` |
 | **Reputation** | `get_reputation` · `suggest_task` |
-| **Branching** | `fork_conversation` · `switch_branch` · `list_branches` |
-| **Channels** | `join_channel` · `leave_channel` · `list_channels` |
-| **Rules** | `add_rule` · `remove_rule` · `list_rules` · `toggle_rule` |
+| **Branching & channels** | `fork_conversation` · `switch_branch` · `list_branches` · `join_channel` · `leave_channel` · `list_channels` |
+| **Rules & enforcement** | `add_rule` · `remove_rule` · `list_rules` · `toggle_rule` · `log_violation` · `request_push_approval` · `ack_push` |
+| **Lifecycle** | `reset` |
 
 </details>
 
@@ -251,7 +248,9 @@ Plus: agent status monitoring, profile popups, message injection, conversation e
 ## ⌨️ CLI Reference
 
 ```bash
-neohive init [--claude|--gemini|--codex|--all|--ollama] [--template <name>]
+neohive init [--claude|--gemini|--codex|--cursor|--vscode|--antigravity|--all|--ollama] [--template <name>]
+neohive mcp                 # start MCP stdio server (used internally by IDE configs)
+neohive serve               # optional HTTP MCP server (default port 4321)
 neohive dashboard [--lan]
 neohive status              # active agents, tasks, workflows
 neohive msg <agent> <text>  # send message from CLI
@@ -271,7 +270,6 @@ neohive uninstall           # remove from all CLI configs
 | `NEOHIVE_PORT` | `3000` | Dashboard port |
 | `NEOHIVE_LAN` | `false` | Enable LAN access |
 | `NEOHIVE_LOG_LEVEL` | `warn` | Logging: `error` · `warn` · `info` · `debug` |
-| `NEOHIVE_FULL_TOOLS` | `false` | Load all 54 tools (core + optional) |
 
 <br />
 
@@ -299,13 +297,18 @@ Full details: [SECURITY.md](SECURITY.md)
 
 | Resource | Link |
 |----------|------|
-| Full API Reference | [docs/DOCUMENTATION.md](docs/DOCUMENTATION.md) |
-| Architecture & Data Flow | [docs/DOCUMENTATION.md#architecture](docs/DOCUMENTATION.md#architecture) |
-| Tool Reference | [docs/DOCUMENTATION.md#tools-reference](docs/DOCUMENTATION.md#tools-reference) |
-| Vision & Roadmap | [VISION.md](VISION.md) |
+| Documentation hub | [docs/documentation.md](../docs/documentation.md) |
+| Docs folder index | [docs/README.md](../docs/README.md) |
+| Reference index | [docs/reference/README.md](../docs/reference/README.md) |
+| Architecture (full) | [docs/reference/architecture.md](../docs/reference/architecture.md) |
+| MCP tools (full) | [docs/reference/tools.md](../docs/reference/tools.md) |
+| AI onboarding (repo map) | [docs/ai-onboarding.md](../docs/ai-onboarding.md) |
+| MCP tools (high-level tour) | [docs/mcp-tools-documentation.md](../docs/mcp-tools-documentation.md) |
+| Documentation audit / doc debt | [docs/documentation-audit.md](../docs/documentation-audit.md) |
+| Vision & Roadmap | [VISION.md](../VISION.md) |
 | Security Policy | [SECURITY.md](SECURITY.md) |
-| Contributing Guide | [CONTRIBUTING.md](CONTRIBUTING.md) |
-| Changelog | [CHANGELOG.md](CHANGELOG.md) |
+| Contributing Guide | [CONTRIBUTING.md](../CONTRIBUTING.md) |
+| Changelog | [CHANGELOG.md](CHANGELOG.md) · [root CHANGELOG](../CHANGELOG.md) |
 
 <br />
 
@@ -337,6 +340,6 @@ node dashboard.js # run the dashboard
 <p align="center">
   <a href="https://github.com/fakiho/neohive">GitHub</a> &middot;
   <a href="https://www.npmjs.com/package/neohive">npm</a> &middot;
-  <a href="docs/DOCUMENTATION.md">Docs</a> &middot;
+  <a href="docs/documentation.md">Docs</a> &middot;
   <a href="mailto:contact@alionix.com">Contact</a>
 </p>

package/SECURITY.md

@@ -2,11 +2,13 @@
 
 ## Supported Versions
 
-| Version | Supported          |
-| ------- | ------------------ |
-| 3.x.x   | Yes               |
-| 2.x.x   | No                |
-| < 2.0   | No                |
+| Version | Supported |
+| ------- | --------- |
+| **6.x.x** | Yes — current major line |
+| **5.x.x** | Best-effort security fixes only |
+| **< 5.0** | No |
+
+Older **3.x / 2.x** lines are **not** supported; upgrade via `npx neohive init` and npm.
 
 ## Reporting a Vulnerability
 
@@ -36,7 +38,7 @@ Neohive is a **local message broker** — it passes text messages between CLI te
 ### What it does NOT do
 
 - Does not give agents filesystem access (they already have it via their CLI)
-- Does not expose anything to the internet (dashboard binds to `127.0.0.1` only)
+- Does not expose anything to the internet by default (dashboard binds to `127.0.0.1`; **`dashboard --lan` / `NEOHIVE_LAN`** binds more broadly — use the generated LAN token)
 - Does not store or transmit API keys
 - Does not run any cloud services
 - Does not execute remote code