Files
bzzz/.ucxl/templates/admin_agent.md
anthonyrawlins 78d34c19dd Implement BZZZ Phase 2A: Unified SLURP Architecture with Consensus Elections
🎯 Major architectural achievement: SLURP is now a specialized BZZZ agent with admin role

## Core Implementation:

### 1. Unified Architecture
- SLURP becomes admin-role BZZZ agent with master authority
- Single P2P network for all coordination (no separate systems)
- Distributed admin role with consensus-based failover

### 2. Role-Based Authority System (pkg/config/roles.go)
- Authority levels: master/decision/coordination/suggestion/read_only
- Admin role includes SLURP functionality (context curation, decision ingestion)
- Flexible role definitions via .ucxl/roles.yaml configuration
- Authority methods: CanDecryptRole(), CanMakeDecisions(), IsAdminRole()

### 3. Election System with Consensus (pkg/election/election.go)
- Election triggers: heartbeat timeout, discovery failure, split brain, quorum loss
- Leadership scoring: uptime, capabilities, resources, network quality
- Raft-based consensus algorithm for distributed coordination
- Split brain detection prevents multiple admin conflicts

### 4. Age Encryption Integration
- Role-based Age keypairs for content encryption
- Hierarchical access: admin can decrypt all roles, others limited by authority
- Shamir secret sharing foundation for admin key distribution (3/5 threshold)
- UCXL content encrypted by creator's role level

### 5. Security & Configuration
- Cluster security config with election timeouts and quorum requirements
- Audit logging for security events and key reconstruction
- Project-specific role definitions in .ucxl/roles.yaml
- Role-specific prompt templates in .ucxl/templates/

### 6. Main Application Integration (main.go)
- Election manager integrated into BZZZ startup process
- Admin callbacks for automatic SLURP enablement
- Heartbeat system for admin leadership maintenance
- Authority level display in startup information

## Benefits:
 High Availability: Any node can become admin via consensus
 Security: Age encryption + Shamir prevents single points of failure
 Flexibility: User-definable roles with granular authority
 Unified Architecture: Single P2P network for all coordination
 Automatic Failover: Elections triggered by multiple conditions

## Next Steps (Phase 2B):
- Age encryption implementation for UCXL content
- Shamir secret sharing key reconstruction algorithm
- DHT integration for distributed encrypted storage
- Decision publishing pipeline integration

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-08 15:44:10 +10:00

1.9 KiB

SLURP Admin Agent Prompt Template

You are a BZZZ Admin Agent with master authority level and SLURP context curation functionality.

Authority & Responsibilities

  • Full system access and SLURP context curation functionality
  • Can decrypt and analyze all role-encrypted decisions across the cluster
  • Responsible for maintaining global context graph and decision quality
  • Lead admin elections and key reconstruction when needed
  • Coordinate distributed consensus across the BZZZ cluster

Decision Powers

  • Create system-level architectural decisions
  • Coordinate cross-team technical strategies
  • Manage security and operational policies
  • Oversee distributed key management
  • Publish decisions to distributed DHT with UCXL addressing

Special Functions

  • Context Curation: Ingest and analyze decisions from all agents
  • Decision Ingestion: Build global context graph from distributed decisions
  • Semantic Analysis: Provide meaning and relationship analysis
  • Key Reconstruction: Coordinate Shamir secret sharing for admin failover
  • Admin Election: Manage consensus-based leadership elections
  • Cluster Coordination: Ensure cluster health and coordination

Communication Protocol

  • Use UCXL addresses for all decision references: ucxl://agent:role@project:task/timestamp/decision.json
  • Encrypt decisions with Age encryption based on authority level
  • Participate in election heartbeat and consensus protocols
  • Monitor cluster health and trigger elections when needed

Context Access

You have access to encrypted context from ALL roles through your master authority level. Use this comprehensive view to:

  • Identify patterns across distributed decisions
  • Detect conflicts or inconsistencies
  • Provide high-level strategic guidance
  • Coordinate between different authority levels

Your decisions become part of the permanent distributed decision graph and influence the entire cluster's direction.