@monoes/monomindcli 2.9.22 → 2.9.23

package/.claude/commands/hive-mind/README.md

@@ -1,42 +0,0 @@
----
-name: hive-mind:README
----
-
-# Hive-Mind Commands
-
-Queen-led consensus-based multi-agent coordination system. All operations use the `mcp__monomind__hive-mind_*` MCP tools.
-
-## Commands (invoke as slash commands)
-
-- [hive-mind](./hive-mind.md) — overview of all subcommands, topologies, and quick start
-- [hive-mind-init](./hive-mind-init.md) — initialize hive with topology and consensus settings
-- [hive-mind-spawn](./hive-mind-spawn.md) — spawn workers; `--claude` launches Claude Code as Queen
-- [hive-mind-status](./hive-mind-status.md) — show hive status, workers, and metrics
-- [hive-mind-stop](./hive-mind-stop.md) — shutdown the hive (the `shutdown` subcommand)
-- [hive-mind-consensus](./hive-mind-consensus.md) — manage proposals and voting
-- [hive-mind-memory](./hive-mind-memory.md) — access hive shared memory
-
-## Real Subcommands (11 total)
-
-```
-init           Initialize hive with topology and consensus
-spawn          Spawn workers; --claude launches Claude Code as Queen
-status         Show status, workers, and metrics
-task           Submit a task for distributed execution
-join           Add an agent to the hive
-leave          Remove an agent from the hive
-consensus      Manage consensus proposals and voting
-broadcast      Broadcast a message to all workers
-memory         Access hive shared memory
-optimize-memory Optimize memory patterns and consolidation
-shutdown       Gracefully shutdown the hive
-```
-
-## Real Tools Used
-
-- `mcp__monomind__hive-mind_init` / `hive-mind_spawn` / `hive-mind_status` — lifecycle
-- `mcp__monomind__hive-mind_task` / `hive-mind_join` / `hive-mind_leave` — task and agent management
-- `mcp__monomind__hive-mind_consensus` / `hive-mind_broadcast` — coordination
-- `mcp__monomind__hive-mind_memory` / `hive-mind_optimize-memory` / `hive-mind_shutdown` — memory and shutdown
-- `mcp__monomind__coordination_orchestrate` — cross-agent task distribution
-- `mcp__monomind__memory_store` / `memory_retrieve` — global persistent memory

package/.claude/commands/hive-mind/hive-mind-consensus.md

@@ -1,72 +0,0 @@
----
-name: hive-mind:hive-mind-consensus
----
-
-# hive-mind consensus
-
-Manage consensus proposals and voting within the hive.
-
-## Usage
-```bash
-npx monomind hive-mind consensus [options]
-```
-
-## Options
-
-| Flag | Short | Type | Default | Description |
-|---|---|---|---|---|
-| `--action` | `-a` | string | `list` | Action: `propose`, `vote`, `status`, `list` |
-| `--proposal-id` | `-p` | string | — | Proposal ID (required for `vote` and `status`) |
-| `--type` | `-t` | string | — | Proposal type (used with `propose`) |
-| `--value` | — | string | — | Proposal value (used with `propose`) |
-| `--vote` | `-v` | string | — | Vote to cast: `yes` or `no` (used with `vote`) |
-| `--voter-id` | — | string | — | Voter agent ID (used with `vote`) |
-| `--format` | — | string | — | Output format: `json` |
-
-## Examples
-
-```bash
-# List all pending proposals
-npx monomind hive-mind consensus
-
-# Create a new proposal
-npx monomind hive-mind consensus -a propose -t config-change --value '{"maxAgents":20}'
-
-# Vote on a proposal
-npx monomind hive-mind consensus -a vote -p proposal-abc123 -v yes --voter-id agent-1
-
-# Check proposal status
-npx monomind hive-mind consensus -a status -p proposal-abc123
-
-# List pending proposals as JSON
-npx monomind hive-mind consensus -a list --format json
-```
-
-## Actions
-
-- **`list`** — Show all pending proposals (default)
-- **`propose`** — Create a new consensus proposal (requires `--type` and `--value`)
-- **`vote`** — Cast a vote on a proposal (requires `--proposal-id`, `--vote`, and `--voter-id`)
-- **`status`** — Check the current vote tally for a proposal (requires `--proposal-id`)
-
-## MCP Tool
-
-```javascript
-// List proposals
-mcp__monomind__hive-mind_consensus({ action: "list" })
-
-// Create proposal
-mcp__monomind__hive-mind_consensus({
-  action: "propose",
-  type: "config-change",
-  value: '{"maxAgents":20}'
-})
-
-// Vote
-mcp__monomind__hive-mind_consensus({
-  action: "vote",
-  proposalId: "proposal-abc123",
-  vote: true,
-  voterId: "agent-1"
-})
-```

package/.claude/commands/hive-mind/hive-mind-init.md

@@ -1,68 +0,0 @@
----
-name: hive-mind:hive-mind-init
----
-
-# hive-mind init
-
-Initialize a hive mind with topology and consensus settings.
-
-## Usage
-```bash
-npx monomind hive-mind init [options]
-```
-
-## Options
-
-| Flag | Short | Type | Default | Description |
-|---|---|---|---|---|
-| `--topology` | `-t` | string | `hierarchical-mesh` | Hive topology: `hierarchical`, `mesh`, `hierarchical-mesh`, `adaptive` |
-| `--consensus` | `-c` | string | `byzantine` | Consensus strategy: `byzantine`, `raft`, `gossip`, `crdt`, `quorum` |
-| `--max-agents` | `-m` | number | `15` | Maximum number of agents |
-| `--persist` | `-p` | boolean | `true` | Enable persistent state across sessions |
-| `--memory-backend` | — | string | `hybrid` | Memory backend: `lancedb`, `sqlite`, `hybrid` |
-
-## Examples
-
-```bash
-# Initialize with recommended settings (interactive topology/consensus selection)
-npx monomind hive-mind init
-
-# Initialize hierarchical-mesh with Byzantine consensus
-npx monomind hive-mind init -t hierarchical-mesh -c byzantine
-
-# Large hive with 20 agents and CRDT consensus
-npx monomind hive-mind init -t mesh -c crdt -m 20
-
-# Minimal hive with no persistence
-npx monomind hive-mind init -t hierarchical -c raft --persist false
-
-# Output as JSON
-npx monomind hive-mind init -t hierarchical-mesh --format json
-```
-
-## Topology Guide
-
-- **`hierarchical`** — Queen controls workers directly. Best for small teams (< 8 agents). Prevents drift.
-- **`mesh`** — Fully connected peers. Best when all agents are equals.
-- **`hierarchical-mesh`** — Queen + peer communication. Recommended for 10+ agents. Most resilient.
-- **`adaptive`** — Dynamically adjusts topology based on current load and task type.
-
-## Consensus Guide
-
-- **`byzantine`** — Tolerates up to 1/3 faulty or malicious agents. Most robust. Default.
-- **`raft`** — Leader-based. Tolerates up to 1/2 failures. Faster than byzantine.
-- **`gossip`** — Epidemic propagation. Eventually consistent. Best for very large swarms.
-- **`crdt`** — Conflict-free. No coordination overhead. Best for parallel writes.
-- **`quorum`** — Simple majority. Configurable threshold.
-
-## MCP Tool
-
-```javascript
-mcp__monomind__hive-mind_init({
-  topology: "hierarchical-mesh",
-  consensus: "byzantine",
-  maxAgents: 15,
-  persist: true,
-  memoryBackend: "hybrid"
-})
-```

package/.claude/commands/hive-mind/hive-mind-memory.md

@@ -1,73 +0,0 @@
----
-name: hive-mind:hive-mind-memory
----
-
-# hive-mind memory
-
-Access and manage hive shared memory — key-value store accessible to all agents in the hive.
-
-## Usage
-```bash
-npx monomind hive-mind memory [options]
-```
-
-## Options
-
-| Flag | Short | Type | Default | Description |
-|---|---|---|---|---|
-| `--action` | `-a` | string | `list` | Action: `get`, `set`, `delete`, `list` |
-| `--key` | `-k` | string | — | Memory key (required for `get`, `set`, `delete`) |
-| `--value` | `-v` | string | — | Value to store (required for `set`) |
-| `--format` | — | string | — | Output format: `json` |
-
-## Examples
-
-```bash
-# List all keys in shared memory
-npx monomind hive-mind memory
-
-# Store a value
-npx monomind hive-mind memory -a set -k "project-goal" -v "Build auth module"
-
-# Retrieve a value
-npx monomind hive-mind memory -a get -k "project-goal"
-
-# Delete a key
-npx monomind hive-mind memory -a delete -k "project-goal"
-
-# List all keys as JSON
-npx monomind hive-mind memory -a list --format json
-```
-
-## Actions
-
-- **`list`** — Show all keys currently in shared memory with count (default)
-- **`get`** — Retrieve the value at a key (requires `--key`)
-- **`set`** — Store a value at a key (requires `--key` and `--value`)
-- **`delete`** — Remove a key from shared memory (requires `--key`)
-
-## Relationship to `monomind memory`
-
-`hive-mind memory` operates on the **hive's shared memory namespace** — values here are visible to all agents coordinating in the current hive. This is distinct from `npx monomind memory` which operates on the global LanceDB.
-
-Use hive memory for transient inter-agent coordination data (task results, intermediate state). Use global memory for patterns and knowledge that should persist across sessions.
-
-## MCP Tool
-
-```javascript
-// List keys
-mcp__monomind__hive-mind_memory({ action: "list" })
-
-// Set a value
-mcp__monomind__hive-mind_memory({
-  action: "set",
-  key: "project-goal",
-  value: "Build auth module"
-})
-
-// Get a value
-mcp__monomind__hive-mind_memory({ action: "get", key: "project-goal" })
-
-// Delete a key
-mcp__monomind__hive-mind_memory({ action: "delete", key: "project-goal" })
-```

package/.claude/commands/hive-mind/hive-mind-spawn.md

@@ -1,82 +0,0 @@
----
-name: hive-mind:hive-mind-spawn
----
-
-# hive-mind spawn
-
-Spawn worker agents into the hive, or launch Claude Code as the Queen coordinator.
-
-## Usage
-```bash
-npx monomind hive-mind spawn [options]
-```
-
-## Options
-
-| Flag | Short | Type | Default | Description |
-|---|---|---|---|---|
-| `--count` | `-n` | number | `1` | Number of workers to spawn |
-| `--role` | `-r` | string | `worker` | Worker role: `worker`, `specialist`, `scout` |
-| `--type` | `-t` | string | `worker` | Agent type (matches agent registry types) |
-| `--prefix` | `-p` | string | `hive-worker` | Prefix for generated worker IDs |
-| `--claude` | — | boolean | `false` | Launch Claude Code as the Queen coordinator |
-| `--objective` | `-o` | string | — | Objective for the hive (required with `--claude`) |
-| `--dry-run` | — | boolean | `false` | Preview what would happen without launching |
-| `--non-interactive` | — | boolean | `false` | Run Claude Code in non-interactive (pipe) mode |
-| `--dangerously-skip-permissions` | — | boolean | `true` | Skip Claude Code permission prompts |
-| `--no-auto-permissions` | — | boolean | `false` | Disable automatic permission skipping |
-
-## Examples
-
-```bash
-# Spawn 5 default workers
-npx monomind hive-mind spawn -n 5
-
-# Spawn 3 specialists
-npx monomind hive-mind spawn -n 3 -r specialist
-
-# Spawn a coder agent with custom ID prefix
-npx monomind hive-mind spawn -t coder -p my-coder
-
-# Launch Claude Code as Queen with a specific objective
-npx monomind hive-mind spawn --claude -o "Build a REST API with authentication"
-
-# Spawn 5 workers AND launch Claude Code as Queen
-npx monomind hive-mind spawn -n 5 --claude -o "Research AI coordination patterns"
-
-# Preview what would happen without launching
-npx monomind hive-mind spawn -n 3 --claude -o "Test objective" --dry-run
-
-# Non-interactive mode (for CI/scripts)
-npx monomind hive-mind spawn --claude -o "Run security audit" --non-interactive
-```
-
-## The `--claude` Flag
-
-When `--claude` is used, the CLI:
-
-1. Spawns the requested worker agents in the hive
-2. Generates a comprehensive Hive Mind coordination prompt that includes:
-   - Swarm ID, topology, consensus algorithm
-   - All worker IDs and their roles
-   - Full list of MCP tools available for coordination
-   - The objective and execution protocol
-3. Saves the prompt to `.hive-mind/sessions/hive-mind-prompt-<id>.txt`
-4. Launches `claude --dangerously-skip-permissions <prompt>` so Claude acts as the Queen
-
-The Queen Claude instance uses MCP tools (`mcp__monomind__hive-mind_*`, `mcp__monomind__coordination_orchestrate`, etc.) to coordinate all worker agents.
-
-**Requirements:**
-- `--objective` / `-o` must be set (the Queen needs a goal)
-- Claude Code CLI must be installed: `npm install -g @anthropic-ai/claude-code`
-
-## MCP Tool
-
-```javascript
-mcp__monomind__hive-mind_spawn({
-  count: 5,
-  role: "worker",
-  type: "coder",
-  prefix: "hive-worker"
-})
-```

package/.claude/commands/hive-mind/hive-mind-status.md

@@ -1,56 +0,0 @@
----
-name: hive-mind:hive-mind-status
----
-
-# hive-mind status
-
-Show hive mind status including queen, workers, and optional detailed metrics.
-
-## Usage
-```bash
-npx monomind hive-mind status [options]
-```
-
-## Options
-
-| Flag | Short | Type | Default | Description |
-|---|---|---|---|---|
-| `--detailed` | `-d` | boolean | `false` | Include metrics (task counts, avg time, consensus rounds, memory) and health breakdown |
-| `--watch` | `-w` | boolean | `false` | Watch for changes and refresh |
-| `--format` | — | string | — | Output format: `json` |
-
-## Examples
-
-```bash
-# Basic status
-npx monomind hive-mind status
-
-# Full metrics and health breakdown
-npx monomind hive-mind status --detailed
-
-# Watch mode (refreshes on change)
-npx monomind hive-mind status --watch
-
-# JSON output for scripting
-npx monomind hive-mind status --format json
-```
-
-## Output
-
-Basic status shows:
-- Hive ID, status (active / idle / degraded / offline), topology, consensus
-- Queen agent ID, status, load %, and queued task count
-- Worker table: ID, type, status, current task, tasks completed
-
-`--detailed` adds:
-- Metrics table: total tasks, completed, failed, avg task time, consensus rounds, memory usage
-- Health breakdown: overall, queen, workers, consensus, memory
-
-## MCP Tool
-
-```javascript
-mcp__monomind__hive-mind_status({
-  includeMetrics: true,  // set by --detailed
-  includeWorkers: true
-})
-```

package/.claude/commands/hive-mind/hive-mind-stop.md

@@ -1,55 +0,0 @@
----
-name: hive-mind:hive-mind-stop
----
-
-# hive-mind shutdown
-
-Gracefully shutdown the hive mind, terminating all agents.
-
-## Usage
-```bash
-npx monomind hive-mind shutdown [options]
-```
-
-## Options
-
-| Flag | Short | Type | Default | Description |
-|---|---|---|---|---|
-| `--force` | `-f` | boolean | `false` | Force immediate shutdown without confirmation |
-| `--save-state` | `-s` | boolean | `true` | Save hive state before shutdown (default: on) |
-
-## Examples
-
-```bash
-# Graceful shutdown with confirmation prompt
-npx monomind hive-mind shutdown
-
-# Force shutdown immediately, no prompt
-npx monomind hive-mind shutdown --force
-
-# Shutdown and save state for later recovery
-npx monomind hive-mind shutdown --save-state
-
-# Force shutdown without saving state
-npx monomind hive-mind shutdown --force --save-state false
-```
-
-## Behavior
-
-Without `--force`, the CLI prompts for confirmation before proceeding.
-
-The shutdown report includes:
-- Number of agents terminated
-- Whether state was saved
-- Shutdown timestamp
-
-When `--save-state` is enabled (default), hive state is persisted and can be referenced in future sessions via `monomind session list`.
-
-## MCP Tool
-
-```javascript
-mcp__monomind__hive-mind_shutdown({
-  force: false,
-  saveState: true
-})
-```

package/.claude/commands/hive-mind/hive-mind.md

@@ -1,87 +0,0 @@
----
-name: hive-mind:hive-mind
----
-
-# hive-mind
-
-Queen-led consensus-based multi-agent coordination system.
-
-## Usage
-```bash
-npx monomind hive-mind <subcommand> [options]
-```
-
-## Subcommands
-
-| Subcommand | Description |
-|---|---|
-| `init` | Initialize hive mind with topology and consensus settings |
-| `spawn` | Spawn worker agents; use `--claude` to launch Claude Code as Queen |
-| `status` | Show hive status, workers, and metrics |
-| `task` | Submit a task to the hive for distributed execution |
-| `join` | Add an existing agent to the hive |
-| `leave` | Remove an agent from the hive |
-| `consensus` | Manage consensus proposals and voting |
-| `broadcast` | Broadcast a message to all workers |
-| `memory` | Access and manage hive shared memory |
-| `optimize-memory` | Optimize hive memory patterns and consolidation |
-| `shutdown` | Gracefully shutdown the hive mind |
-
-## Topologies
-
-| Topology | Description |
-|---|---|
-| `hierarchical` | Queen controls workers directly — tight coordination for small teams |
-| `mesh` | Peer-to-peer coordination among all agents |
-| `hierarchical-mesh` | Queen + peer communication — recommended for 10+ agents |
-| `adaptive` | Dynamic topology based on task load |
-
-## Consensus Strategies
-
-| Strategy | Description |
-|---|---|
-| `byzantine` | BFT — tolerates f < n/3 faulty agents (default) |
-| `raft` | Leader-based — tolerates f < n/2 |
-| `gossip` | Eventually consistent, scales well |
-| `crdt` | Conflict-free replicated data types |
-| `quorum` | Simple majority voting |
-
-## Quick Start
-
-```bash
-# 1. Initialize hive with recommended topology
-npx monomind hive-mind init -t hierarchical-mesh -c byzantine
-
-# 2. Spawn workers
-npx monomind hive-mind spawn -n 5 -r specialist
-
-# 3. (Optional) Launch Claude Code as the Queen coordinator
-npx monomind hive-mind spawn --claude -o "Build a REST API with auth"
-
-# 4. Check status
-npx monomind hive-mind status --detailed
-
-# 5. Submit a task
-npx monomind hive-mind task -d "Implement authentication module" -p high
-
-# 6. Shutdown when done
-npx monomind hive-mind shutdown --save-state
-```
-
-## MCP Tools
-
-All subcommands call their corresponding MCP tool:
-
-```
-mcp__monomind__hive-mind_init
-mcp__monomind__hive-mind_spawn
-mcp__monomind__hive-mind_status
-mcp__monomind__hive-mind_task
-mcp__monomind__hive-mind_join
-mcp__monomind__hive-mind_leave
-mcp__monomind__hive-mind_consensus
-mcp__monomind__hive-mind_broadcast
-mcp__monomind__hive-mind_memory
-mcp__monomind__hive-mind_optimize-memory
-mcp__monomind__hive-mind_shutdown
-```

package/.claude/commands/swarm/README.md

@@ -1,40 +0,0 @@
----
-name: swarm-README
-description: Swarm skill index — lists all available swarm coordination skills and strategies for multi-agent task execution
----
-
-# Swarm Skills
-
-Multi-agent swarm coordination for Monomind.
-
-## Core Skills
-
-- [swarm](./swarm.md) — Main swarm skill: how to start and coordinate swarms
-
-## Strategy Skills
-
-- [analysis](./analysis.md) — Distributed analysis via coordinated agents
-- [development](./development.md) — Coordinated development teams
-- [research](./research.md) — Parallel information gathering
-- [testing](./testing.md) — Distributed test execution
-- [maintenance](./maintenance.md) — System maintenance coordination
-- [optimization](./optimization.md) — Performance optimization swarms
-- [examples](./examples.md) — Common swarm patterns and recipes
-
-## Reference Skills
-
-- [swarm-status](./swarm-status.md) — Check swarm health and agent progress
-- [swarm-monitor](./swarm-monitor.md) — Monitor running swarms
-- [swarm-modes](./swarm-modes.md) — Topology modes: hierarchical, mesh, star
-- [swarm-strategies](./swarm-strategies.md) — Strategy selection guide
-- [swarm-background](./swarm-background.md) — Running swarms in the background
-- [swarm-analysis](./swarm-analysis.md) — Swarm performance analysis
-
-## Quick Start
-
-```bash
-# Initialize and start a swarm via CLI
-npx monomind swarm init --topology hierarchical --max-agents 8
-npx monomind swarm start "Build REST API" --strategy development
-npx monomind swarm status
-```

package/.claude/commands/swarm/swarm.md

@@ -1,79 +0,0 @@
----
-name: swarm-swarm
-description: Main swarm skill — initializes and starts multi-agent swarms for research, development, analysis, testing, optimization, and maintenance tasks
----
-
-# Swarm Orchestration
-
-Start and coordinate multi-agent swarms for complex tasks.
-
-## How to Invoke
-
-In Claude Code, load this skill:
-```
-Skill("swarm:swarm")
-```
-
-Then describe what you want to accomplish:
-> "Start a development swarm to build a REST API with auth endpoints."
-> "Run a research swarm on AI agent coordination patterns."
-
----
-
-## CLI Reference
-
-```bash
-# Initialize a swarm
-npx monomind swarm init --topology hierarchical --max-agents 8 --strategy specialized
-
-# Start a swarm with an objective
-npx monomind swarm start "Build REST API" --strategy development --parallel
-
-# Check swarm status
-npx monomind swarm status
-
-# Stop the swarm
-npx monomind swarm stop
-
-# Scale agents
-npx monomind swarm scale <swarm-id> --agents 12
-```
-
-## MCP Tools
-
-```javascript
-// Initialize swarm
-mcp__monomind__swarm_init({
-  topology: "hierarchical",
-  maxAgents: 8,
-  strategy: "specialized"
-})
-
-// Check status
-mcp__monomind__swarm_status({ swarmId: "current" })
-
-// Coordinate tasks
-mcp__monomind__coordination_orchestrate({ task: "build feature", strategy: "parallel" })
-
-// Spawn an agent
-mcp__monomind__agent_spawn({ type: "coder", capabilities: ["typescript", "api"] })
-
-// Shut down swarm
-mcp__monomind__swarm_shutdown({ swarmId: "current" })
-```
-
-## Strategy Selection
-
-| Strategy | Topology | Use when |
-|----------|----------|----------|
-| research | mesh | Gathering information from multiple sources in parallel |
-| development | hierarchical | Building features with architect → coder → tester flow |
-| analysis | mesh | Distributed codebase or performance analysis |
-| testing | star | Parallel test suite execution |
-| optimization | mesh | Performance profiling and bottleneck resolution |
-| maintenance | star | Sequential dependency updates with checkpoints |
-
-## See Also
-- `swarm:examples` — Common swarm patterns with full code
-- `swarm:swarm-modes` — Topology reference
-- `swarm:swarm-strategies` — Strategy selection guide