Vapora/scripts/setup.nu
Jesús Pérez d14150da75 feat: Phase 5.3 - Multi-Agent Learning Infrastructure
Implement intelligent agent learning from Knowledge Graph execution history
with per-task-type expertise tracking, recency bias, and learning curves.

## Phase 5.3 Implementation

### Learning Infrastructure ( Complete)
- LearningProfileService with per-task-type expertise metrics
- TaskTypeExpertise model tracking success_rate, confidence, learning curves
- Recency bias weighting: recent 7 days weighted 3x higher (exponential decay)
- Confidence scoring prevents overfitting: min(1.0, executions / 20)
- Learning curves computed from daily execution windows

### Agent Scoring Service ( Complete)
- Unified AgentScore combining SwarmCoordinator + learning profiles
- Scoring formula: 0.3*base + 0.5*expertise + 0.2*confidence
- Rank agents by combined score for intelligent assignment
- Support for recency-biased scoring (recent_success_rate)
- Methods: rank_agents, select_best, rank_agents_with_recency

### KG Integration ( Complete)
- KGPersistence::get_executions_for_task_type() - query by agent + task type
- KGPersistence::get_agent_executions() - all executions for agent
- Coordinator::load_learning_profile_from_kg() - core KG→Learning integration
- Coordinator::load_all_learning_profiles() - batch load for multiple agents
- Convert PersistedExecution → ExecutionData for learning calculations

### Agent Assignment Integration ( Complete)
- AgentCoordinator uses learning profiles for task assignment
- extract_task_type() infers task type from title/description
- assign_task() scores candidates using AgentScoringService
- Fallback to load-based selection if no learning data available
- Learning profiles stored in coordinator.learning_profiles RwLock

### Profile Adapter Enhancements ( Complete)
- create_learning_profile() - initialize empty profiles
- add_task_type_expertise() - set task-type expertise
- update_profile_with_learning() - update swarm profiles from learning

## Files Modified

### vapora-knowledge-graph/src/persistence.rs (+30 lines)
- get_executions_for_task_type(agent_id, task_type, limit)
- get_agent_executions(agent_id, limit)

### vapora-agents/src/coordinator.rs (+100 lines)
- load_learning_profile_from_kg() - core KG integration method
- load_all_learning_profiles() - batch loading for agents
- assign_task() already uses learning-based scoring via AgentScoringService

### Existing Complete Implementation
- vapora-knowledge-graph/src/learning.rs - calculation functions
- vapora-agents/src/learning_profile.rs - data structures and expertise
- vapora-agents/src/scoring.rs - unified scoring service
- vapora-agents/src/profile_adapter.rs - adapter methods

## Tests Passing
- learning_profile: 7 tests 
- scoring: 5 tests 
- profile_adapter: 6 tests 
- coordinator: learning-specific tests 

## Data Flow
1. Task arrives → AgentCoordinator::assign_task()
2. Extract task_type from description
3. Query KG for task-type executions (load_learning_profile_from_kg)
4. Calculate expertise with recency bias
5. Score candidates (SwarmCoordinator + learning)
6. Assign to top-scored agent
7. Execution result → KG → Update learning profiles

## Key Design Decisions
 Recency bias: 7-day half-life with 3x weight for recent performance
 Confidence scoring: min(1.0, total_executions / 20) prevents overfitting
 Hierarchical scoring: 30% base load, 50% expertise, 20% confidence
 KG query limit: 100 recent executions per task-type for performance
 Async loading: load_learning_profile_from_kg supports concurrent loads

## Next: Phase 5.4 - Cost Optimization
Ready to implement budget enforcement and cost-aware provider selection.
2026-01-11 13:03:53 +00:00

147 lines
3.1 KiB
Plaintext

#!/usr/bin/env nu
# VAPORA Development Environment Setup
# Phase 0: Workspace initialization script
# Follows NUSHELL_GUIDELINES.md - 17 rules
# Check if Rust toolchain is installed
def check-rust []: bool {
(which rustc | length) > 0
}
# Check if cargo is available
def check-cargo []: bool {
(which cargo | length) > 0
}
# Get Rust version information
def get-rust-version []: string {
if (check-rust) {
(rustc --version | str trim)
} else {
""
}
}
# Validate minimum Rust version (1.75+)
def validate-rust-version []: record {
let version = (get-rust-version)
if ($version == "") {
{
valid: false,
error: "Rust not installed"
}
} else {
{
valid: true,
error: null
}
}
}
# Check if .env file exists
def check-env-file []: bool {
(".env" | path exists)
}
# Create .env file from template
def create-env-file []: void {
let template = "# VAPORA Environment Variables
# Phase 0: Configuration template
# Server
VAPORA_HOST=127.0.0.1
VAPORA_PORT=3000
# Database (required)
VAPORA_DB_URL=surreal://localhost:8000/vapora
# NATS JetStream
VAPORA_NATS_URL=nats://localhost:4222
# Authentication (set in production)
VAPORA_JWT_SECRET=change-me-in-production
# LLM Providers (optional)
ANTHROPIC_API_KEY=
OPENAI_API_KEY=
GOOGLE_API_KEY=
OLLAMA_URL=http://localhost:11434
# Logging
VAPORA_LOG_LEVEL=info
VAPORA_LOG_JSON=false
"
$template | save -f ".env"
}
# Main setup function
def main []: void {
print "=== VAPORA Development Setup ==="
print ""
# Step 1: Check Rust
print "Checking Rust installation..."
let rust_check = (validate-rust-version)
if (not $rust_check.valid) {
print $"ERROR: ($rust_check.error)"
print "Please install Rust from https://rustup.rs/"
exit 1
}
print $"✓ Rust installed: (get-rust-version)"
# Step 2: Check cargo
if (not (check-cargo)) {
print "ERROR: cargo not found"
exit 1
}
print "✓ Cargo available"
# Step 3: Create .env if missing
print ""
print "Checking environment configuration..."
if (not (check-env-file)) {
print "Creating .env file from template..."
create-env-file
print "✓ .env file created"
print "⚠ Please edit .env and set required variables"
} else {
print "✓ .env file exists"
}
# Step 4: Verify workspace structure
print ""
print "Verifying workspace structure..."
let required_dirs = [
"crates",
"config",
"scripts"
]
for dir in $required_dirs {
if ($dir | path exists) {
print $"✓ [$dir]/ directory exists"
} else {
print $"✗ [$dir]/ directory missing"
exit 1
}
}
# Step 5: Summary
print ""
print "=== Setup Complete ==="
print ""
print "Next steps:"
print " 1. Edit .env file with your configuration"
print " 2. Run: nu scripts/build.nu"
print " 3. Run: nu scripts/test.nu"
print ""
print "VAPORA v0.2.0 - Phase 0 workspace ready"
}