@keepur/hive 0.1.0 → 0.1.2

package/README.md

@@ -1,344 +1,60 @@
 # Hive
 
-A multi-agent AI framework that runs your business operations through Slack. Hive deploys a team of Claude-powered agents — each with its own role, memory, and tools — that collaborate to handle real work: customer emails, CRM updates, task management, scheduling, SMS, and more.
+> A team of Claude agents that runs your business in Slack.
 
-## Why Hive
+Most AI tools give you a chatbot. Hive gives you a team. Each agent has a name, a role, persistent memory, and its own Slack channel. Your team @mentions them like coworkers — they handle customer emails, CRM updates, scheduling, SMS, research, and the long tail of operational work that nobody on your real team has time for.
 
-Most AI agent frameworks give you a chatbot. Hive gives you a team.
+It runs on a Mac you already own. One Anthropic key, one Slack workspace, one install command.
 
-### The problem with single-agent tools
+## Install
 
-Tools like OpenClaw, CrewAI, and AutoGen are great for demos — chain a few LLM calls together, get a result. But they fall apart when you try to run actual business operations:
-
-- **No identity** — every request starts from zero. There's no persistent memory, no role specialization, no sense of "who" is handling what.
-- **No channels** — they live in a notebook or CLI. Your team can't interact with them naturally.
-- **No tools** — connecting to real systems (CRM, email, calendars, project management) requires custom glue code for every integration.
-- **No cost control** — every query hits the most expensive model, even simple ones.
-
-### What Hive does differently
-
-| Capability | Hive | Typical agent framework |
-|-----------|------|------------------------|
-| **Agent identity** | Each agent has a name, personality, role, persistent memory, and dedicated Slack channel | Anonymous function chains |
-| **Channel-native** | Lives in Slack — your team @mentions agents like coworkers. Also supports SMS, WebSocket (mobile), and email. | CLI or API-only |
-| **Tool ecosystem** | 20+ MCP servers out of the box — Gmail, Calendar, CRM, GitHub, task management, vector search, SMS, email, browser automation | BYO everything |
-| **Smart routing** | Triage classifies messages, model router picks Haiku/Sonnet/Opus per-turn based on complexity. Simple questions cost pennies. | One model for everything |
-| **Persistent memory** | MongoDB-backed per-agent memory with hot/warm/cold tiers, version history, and semantic recall | Stateless or basic RAG |
-| **Multi-agent coordination** | Flat org with channel-based routing — agents delegate to specialists, no central bottleneck | Sequential chains or rigid DAGs |
-| **Production-ready** | LaunchAgent service, hot-reload, concurrency limits, deduplication, retry queues, structured logging | "Just run the script" |
-| **Plugin system** | Drop in business-specific integrations (CRM, catalog, manufacturing) without touching core | Monolithic |
-
-### Architecture at a glance
-
-```
-Message (Slack / SMS / WebSocket / Scheduler)
-  → Channel Adapter
-  → Dispatcher (routing, dedup, thread continuity)
-  → Triage (fast Haiku: done or continue?)
-  → Model Router (Haiku/Sonnet/Opus based on complexity)
-  → Agent Runner (Claude session + per-agent MCP servers + memory)
-  → Response → Channel Adapter → delivery
-```
-
-### Who it's for
-
-Hive is built for small-to-medium businesses that want AI teammates, not AI toys. If you have a Slack workspace and real operational workflows (sales, support, marketing, ops), Hive turns Claude into a team that works alongside yours.
-
-**Requirements**: Mac (tested on Mac Mini M-series), MongoDB, Node.js 22+, a Slack workspace, and an Anthropic API key or Claude Max subscription.
-
----
-
-## Quick Start
-
-```bash
-# 1. Install prerequisites
-npm run setup:prereqs
-
-# 2. Install dependencies and run the setup wizard
-npm install
-npm run setup
-
-# 3. Start Hive
-npm start
 ```
+# Fresh Mac
+curl -fsSL https://raw.githubusercontent.com/keepur/hive/main/install/bootstrap.sh | bash
 
-The setup wizard walks you through everything: Slack app creation, API keys, business context, and service installation. It seeds a **chief-of-staff** agent to start — additional agents are created through it as your needs evolve.
-
-## Prerequisites
-
-Mac (tested on Mac Mini M-series) with:
-
-- **Node.js 22+** — JavaScript runtime
-- **MongoDB** — database for agent memory, definitions, contacts, and state
-- **Git** — version control
-
-The prereqs script installs all of these via Homebrew:
-
-```bash
-npm run setup:prereqs
+# Already have Node 22
+npm i -g @keepur/hive && hive init
 ```
 
-If you already have them, the script skips what's installed.
-
-## What You'll Need
-
-Before running `npm run setup`, have these ready:
-
-### Required
-
-- **Slack workspace** you can install apps into
-- **Anthropic API key** or **Claude Max subscription** — if using Max, the SDK authenticates via OAuth automatically (no API key needed)
+The bootstrap installs Homebrew and Node 22, then drops you into the `hive init` wizard which handles the rest (MongoDB, Ollama, Qdrant). Budget about 20 minutes end-to-end.
 
-### Optional (enable as you grow)
+## Documentation
 
-- **Resend API key** — outbound email per agent
-- **Quo (OpenPhone) API key** — SMS integration
-- **Google account(s)** — Gmail and Calendar access (via `gog` CLI)
-- **HubSpot API key** — CRM read/write
-- **GitHub repo** — issue tracking integration
-- **Brave Search API key** — web search for agents
-- **Gemini API key** — vision/OCR for file attachments
-- **ClickUp / Linear API key** — project management
+- [Getting started](docs/getting-started.md) — install + first conversation
+- [Managing your hive](docs/managing-your-hive.md) — plugins, skills, day-two ops
+- [Troubleshooting](docs/troubleshooting.md) — when things break
 
-## Setup Guide
+## What you get
 
-### 1. Create Your Slack App
+- **A real team, not a chatbot.** Each agent has identity, voice, and a dedicated Slack channel. Mentions, threads, and DMs all work the way your team already uses Slack.
+- **Persistent memory.** Agents remember what you've told them, what they've done, and who they've talked to — backed by MongoDB with semantic recall and version history.
+- **Plugin ecosystem.** Drop in integrations for Gmail, Calendar, HubSpot, GitHub, Linear, ClickUp, SMS, email, and more. Plugins ship MCP servers and starter agents together.
+- **Smart cost control.** A per-turn classifier picks Haiku, Sonnet, or Opus based on what the message actually needs. Simple replies cost pennies.
+- **Mac-native deployment.** Runs as a launchd service on a Mac Mini you already have. No cloud bill, no container orchestration, no egress fees on your business data.
 
-The setup wizard displays a complete app manifest. Here's the short version:
+## Requirements
 
-1. Go to https://api.slack.com/apps
-2. **Create New App** > **From a manifest**
-3. Select your workspace, choose **YAML** format
-4. Paste the manifest the wizard shows you
-5. **Create**, then **Install App** > **Install to workspace**
+- A Mac (Apple Silicon recommended)
+- An Anthropic API key — [console.anthropic.com](https://console.anthropic.com/)
+- Admin access to a Slack workspace
 
-You'll need two tokens:
+## Quick reference
 
-| Token | Where to find it | Looks like |
-|-------|-----------------|------------|
-| App-Level Token | Basic Information > App-Level Tokens > Generate (add `connections:write` scope) | `xapp-...` |
-| Bot Token | OAuth & Permissions > Bot User OAuth Token | `xoxb-...` |
-
-**Optional:** For Slack search, grab a User Token (`xoxp-...`) from the same OAuth page.
-
-### 2. Anthropic API Key (or Claude Max)
-
-**API key**: Get one from https://console.anthropic.com/settings/keys (starts with `sk-ant-`).
-
-**Claude Max**: Leave `ANTHROPIC_API_KEY` blank in `.env`. The Claude Agent SDK authenticates via your logged-in CLI session.
-
-### 3. SMS via Quo (Optional)
-
-1. Get your API key from Quo workspace settings > API tab
-2. Get your Phone Number ID(s) — they look like `PNxxxxx`
-3. The wizard will ask you to configure named phone lines
-
-### 4. Google Gmail/Calendar (Optional)
-
-Install the [`gog`](https://github.com/jcfisher/gog) CLI:
-
-```bash
-brew install gog
-```
-
-Add accounts:
-
-```bash
-gog auth add you@gmail.com
-# Opens a browser for OAuth — authenticate once, tokens stored locally
-
-# Multiple accounts:
-gog auth add work@company.com
-gog auth add sales@company.com
-```
-
-Verify:
-
-```bash
-gog gmail search "is:unread" -a you@gmail.com
-gog cal events --today -a you@gmail.com
 ```
-
-### 5. Email via Resend (Optional)
-
-Get an API key from https://resend.com. Configure your sending domain and per-agent from addresses in `hive.yaml`.
-
-## Configuration
-
-Hive uses two config files (both generated by the setup wizard, both gitignored):
-
-### `.env` — secrets
-
-```bash
-SLACK_APP_TOKEN=xapp-...
-SLACK_BOT_TOKEN=xoxb-...
-# ANTHROPIC_API_KEY=sk-ant-...  # Leave blank if using Claude Max
-# Plus optional: QUO_API_KEY, RESEND_API_KEY, HUBSPOT_API_KEY, etc.
+hive init                  # Interactive setup wizard
+hive start --daemon        # Start as background service
+hive stop                  # Stop the service
+hive status                # Service status
+hive doctor [--verbose]    # Health check (with fix hints)
+hive update                # Update to latest version
+hive plugin add <pkg>      # Install a plugin
+hive plugin list           # List installed plugins
+hive plugin remove <name>  # Remove a plugin
+hive skill add <name>      # Install a skill
+hive skill list            # List installed skills
+hive skill remove <name>   # Remove a skill
 ```
 
-### `hive.yaml` — instance config
-
-```yaml
-business:
-  name: "Your Business Name"
-  description: "what your business does"
-  location: "City, State"
-  owner:
-    name: "Your Name"
-    role: "CEO"
-
-# plugins:
-#   - your-plugin  # Business-specific integrations
-```
-
-See `hive.yaml.example` for all options including SMS lines, email, and Google Workspace.
-
-## Agents
-
-Hive starts with a single **chief-of-staff** agent. More agents are created as your needs evolve — no need to configure them all upfront.
-
-Agent definitions live in **MongoDB** (not the filesystem). Each agent definition contains:
-
-| Field | Purpose |
-|-------|---------|
-| `model` | Model ceiling (haiku, sonnet, opus) |
-| `channels` | Which Slack channels this agent responds in |
-| `servers` | Which MCP tool servers this agent can use |
-| `soul` | Personality, values, voice |
-| `systemPrompt` | Role definition, guidelines, tool instructions |
-| `schedule` | Cron expressions for recurring tasks |
-
-Manage agents via the admin MCP tools or the REST API. Changes take effect on hot-reload (SIGUSR1) — no restart needed.
-
-## Memory
-
-Agent memory is stored in **MongoDB** with version history and semantic recall:
-
-| Collection | Purpose |
-|-----------|---------|
-| `memory` | Current memory records (hot/warm/cold tiers) |
-| `memory_versions` | Full version history of every change |
-| `agent_definitions` | Agent configs, prompts, personality |
-| `agent_sessions` | Active session state |
-
-Agents read and write memory through the memory MCP server. Memory is structured with tiered lifecycle management — frequently accessed records stay hot (injected into prompts), less-used records drop to warm (semantic recall on demand), and stale records are summarized and archived.
-
-## MCP Tool Servers
-
-Each agent gets a tailored set of MCP servers based on its role. Available servers:
-
-| Server | What it does |
-|--------|-------------|
-| **memory** | Read/write/recall agent memory (MongoDB) |
-| **slack** | Slack API (official HTTP MCP server) |
-| **google** | Gmail + Calendar via `gog` CLI |
-| **contacts** | Contact lookups |
-| **github-issues** | GitHub issue tracking via `gh` CLI |
-| **crm-search** | Semantic search over CRM data (Qdrant) |
-| **resend** | Outbound email |
-| **quo** | SMS via OpenPhone |
-| **schedule** | Self-service schedule management |
-| **callback** | Timer-based delayed responses |
-| **background** | Spawn long-running tasks |
-| **admin** | Agent CRUD + version history |
-| **keychain** | macOS Keychain read-only |
-| **brave-search** | Web search |
-| **recall** | Meeting participation via Recall.ai |
-| **code-task** | Delegate coding to Claude Code CLI |
-
-Plugins can add more (e.g., HubSpot CRM, product catalog, permit management).
-
-## Running Hive
-
-```bash
-# Production (compiled)
-npm start
-
-# Development (live reload)
-npm run dev
-
-# View logs
-tail -f logs/hive.log
-```
-
-### Run as a LaunchAgent (starts on login)
-
-The setup wizard offers to install as a LaunchAgent. Manually:
-
-```bash
-bash service/install.sh
-```
-
-Manage the service:
-
-```bash
-# Restart
-launchctl kickstart -k gui/$(id -u)/com.hive.agent
-
-# Stop
-launchctl bootout gui/$(id -u)/com.hive.agent
-
-# Start
-launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.hive.agent.plist
-```
-
-## Plugins
-
-Business-specific integrations live in `plugins/<name>/`. A plugin can include:
-
-- **MCP servers** — domain-specific tools (CRM, catalog, manufacturing)
-- **Agent seeds** — starter agent definitions imported via `npm run setup:seeds`
-
-Enable plugins in `hive.yaml`:
-
-```yaml
-plugins:
-  - your-plugin
-```
-
-## Dev vs Deploy
-
-| | Dev | Deploy |
-|---|-----|--------|
-| **Path** | `~/github/hive` | `~/services/hive` |
-| **Purpose** | Edit, test, commit, push | Compiled JS, launchd runs here |
-| **Deploy** | — | `deploy.sh` pulls, builds, syncs, restarts |
-
-Editing source in dev does **not** affect the running service.
-
-## Updating
-
-```bash
-npm run update
-```
-
-Pulls latest code, installs dependencies, and rebuilds. Your `hive.yaml`, `.env`, and agent definitions (in MongoDB) are preserved.
-
-## npm Scripts
-
-| Script | What it does |
-|--------|-------------|
-| `npm start` | Start Hive (production, compiled) |
-| `npm run dev` | Start Hive (development, live reload) |
-| `npm run build` | Compile TypeScript (core + plugins) |
-| `npm run setup` | Interactive setup wizard |
-| `npm run setup:prereqs` | Install Homebrew, Node.js, MongoDB, Git |
-| `npm run setup:seeds` | Import plugin agent seeds → MongoDB |
-| `npm run setup:constitution` | Render shared constitution → MongoDB |
-| `npm run setup:plist` | Regenerate the launchd plist |
-| `npm run update` | Pull latest, install deps, rebuild |
-| `npm run check` | All checks (typecheck + lint + format + test) |
-
-## Troubleshooting
-
-| Problem | Fix |
-|---------|-----|
-| Agent not responding | Check `logs/hive.log` for errors. Verify Slack tokens in `.env`. |
-| MCP server changes not taking effect | Run `npm run build` AND restart Hive — MCP servers run from compiled `dist/`. |
-| Agent config changes not taking effect | Send SIGUSR1 to hot-reload: `kill -USR1 $(pgrep -f "node dist/index")` |
-| Slack connection drops | Check `SLACK_APP_TOKEN` has `connections:write` scope. Socket Mode must be enabled. |
-| MongoDB connection refused | Ensure MongoDB is running: `brew services start mongodb-community` |
-
 ## License
 
-Private — access by invitation only.
+Closed-source preview release. Access is by invitation during the early cohort. To request access, email May at may@dodihome.com.

package/package.json

@@ -1,14 +1,17 @@
 {
   "name": "@keepur/hive",
-  "version": "0.1.0",
+  "version": "0.1.2",
+  "hiveApi": "1.0.0",
   "type": "module",
   "bin": {
-    "hive": "pkg/cli.min.js"
+    "hive": "pkg/cli.min.js",
+    "honeypot": "scripts/honeypot"
   },
   "files": [
     "pkg/",
     "seeds/",
-    "templates/"
+    "templates/",
+    "scripts/honeypot"
   ],
   "engines": {
     "node": ">=22.0.0"
@@ -18,15 +21,15 @@
     "build:plugins": "tsc -p tsconfig.plugins.json",
     "start": "node dist/index.js",
     "dev": "npx tsx src/index.ts",
-    "setup": "npx tsx src/setup/wizard.ts",
+    "setup": "npx tsx src/cli.ts init",
     "setup:instance": "npx tsx setup/setup-instance.ts",
-    "setup:prereqs": "bash setup/install-prereqs.sh",
     "setup:constitution": "npx tsx setup/setup-constitution.ts",
     "setup:seeds": "npx tsx setup/setup-seeds.ts",
     "setup:plugins": "npx tsx setup/sync-plugins.ts",
     "migrate:agents:legacy": "npx tsx setup/migrate-agents.ts",
     "setup:plist": "npx tsx setup/generate-plist.ts",
     "update": "git pull && npm install && npm run build",
+    "reindex": "npx tsx scripts/code-index.ts",
     "embed:hubspot": "npx tsx scripts/hubspot-embed.ts",
     "embed:dodi": "npx tsx scripts/dodi-embed.ts",
     "lint": "eslint src/ plugins/ setup/",
@@ -38,6 +41,7 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "check": "npm run typecheck && npm run lint && npm run format:check && npm run test",
+    "check:bundle": "npm run bundle && node scripts/check-bundle-strings.mjs && node scripts/check-bundle-pack.mjs && node scripts/check-bundle-runtime.mjs",
     "bundle": "npm run build && npx tsx build/bundle.ts",
     "prepublishOnly": "npm run bundle"
   },
@@ -50,9 +54,6 @@
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.2.63",
     "@anthropic-ai/sdk": "^0.82.0",
-    "@dodi-hq/fsm-persistence": "^0.1.1",
-    "@dodi-hq/task-core": "^0.1.1",
-    "@dodi-hq/workflow-core": "^0.1.1",
     "@linear/sdk": "^76.0.0",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@qdrant/js-client-rest": "^1.17.0",
@@ -62,7 +63,6 @@
     "brave-search-mcp": "^2.0.1",
     "csv-parse": "^6.1.0",
     "dotenv": "^17.3.1",
-    "jsonwebtoken": "^9.0.3",
     "mammoth": "^1.11.0",
     "mongodb": "^7.1.0",
     "pdf-parse": "^2.4.5",
@@ -73,7 +73,6 @@
   "devDependencies": {
     "@eslint/js": "^9.0.0",
     "@types/better-sqlite3": "^7.6.13",
-    "@types/jsonwebtoken": "^9.0.10",
     "@types/node": "^22.0.0",
     "@types/ws": "^8.18.1",
     "esbuild": "^0.28.0",