bee.Keeper Agent

The guardian of the Aura Hive. An autonomous agent that monitors repository health, consistency with ATCG patterns, and provides "Honey-Aware" feedback.

Agent DNA

The bee.Keeper follows the ATCG (Aggregator, Transformer, Connector, Generator) pattern:

• A - Aggregator: Gathers "Signals" from the environment.

  • get_git_diff(): Current PR or last commit changes.

  • get_hive_metrics(): Queries Prometheus for negotiation success rates.

  • scan_filesystem(): Maps the current directory structure.

• T - Transformer: The "Inquisitor" brain.

  • Analyzes git diffs for architectural "Heresies".

  • Enforces the use of structlog and settings.

  • Verifies compliance with dna.py Protocols.

• C - Connector: The "Hand" that interacts with the world.

  • Posts "Purity Reports" to GitHub.

  • Emits NATS events to notify the Hive of audit completion.

• G - Generator: The "Scribe".

  • Synchronizes llms.txt if Protobuf definitions change.

  • Updates CHRONICLES.md with narrative audit results.

Frugal Mind

The agent is designed to be cost-effective:

• Defaults to "cheap" models (e.g., gpt-4o-mini).

• Includes fallback logic to local Ollama endpoints if budget is tight or primary LLM fails.

Configuration

Settings are managed via Pydantic and environment variables with the AURA_ prefix.

Variable	Description	Default
AURA_LLM__API_KEY	LLM API Key	required
AURA_LLM__MODEL	LLM Model	gpt-4o-mini
AURA_LLM__FALLBACK_MODEL	Fallback Model	ollama/llama3
AURA_LLM__OLLAMA_BASE_URL	Ollama URL	http://localhost:11434
AURA_PROMETHEUS_URL	Prometheus URL	http://prometheus:9090
AURA_NATS_URL	NATS URL	nats://nats:4222