bootspring swarm

Multi-agent swarm intelligence -- orchestration, memory, and goal planning.

Overview

The swarm command provides multi-agent orchestration with configurable topologies, consensus voting, vector memory, and GOAP-style goal planning.

Usage

Loading code block...

Topologies

TopologyDescription
hierarchicalLeader delegates to workers
meshAll agents communicate freely
ringSequential message passing
starCentral coordinator
adaptiveSelf-organizing based on task

Features

  • Consensus Voting -- Agents vote on decisions with configurable quorum
  • Vector Memory -- HNSW-indexed similarity search across agent knowledge
  • Goal Planning -- GOAP-style A* planning with preconditions and effects
  • Self-Healing -- Heartbeat monitoring and automatic agent recovery
  • Task Dispatch -- Priority-based task routing to capable agents
  • File-Conflict Detection -- Real-time notification when agents write to files other agents have read

Vector Memory

The swarm shares a vector memory store using HNSW indexing and TF-IDF n-gram embeddings:

  • Cosine similarity search across all agent knowledge
  • Trajectory recording for agent decision history
  • Queryable via CLI or API

Goal Planning

GOAP (Goal-Oriented Action Planning) with A* search:

  • Define goals with preconditions and effects
  • 8 built-in development actions (implement, test, review, deploy, etc.)
  • Parallel group decomposition for independent subtasks

Examples

Loading code block...