ADR-029: External Intelligence Providers for SONA Learning

[grparry]

Summary

This proposes and implements a trait-based extension point — IntelligenceProvider — that lets external systems feed quality signals into ruvllm's SONA learning loops, embedding classifier, and model router without modifying ruvllm core.

Resolves #191

What's implemented

File	Description
src/intelligence/mod.rs	IntelligenceProvider trait, FileSignalProvider, IntelligenceProviderLoader registry, signal/weight types
claude_flow/model_router.rs	calibration_bias() on TaskComplexityAnalyzer (requires 10+ feedback records)
lib.rs	Public re-exports at crate root
docs/adr/ADR-029-*	Status updated to "Accepted (Implemented)"

The trait

pub trait IntelligenceProvider: Send + Sync {
    fn name(&self) -> &str;
    fn load_signals(&self) -> Result<Vec<QualitySignal>>;
    fn quality_weights(&self) -> Option<QualityWeights> { None }
}

• Providers are registered with IntelligenceProviderLoader and called during load_all()
• A built-in FileSignalProvider covers the common case (non-Rust systems write JSON)
• Zero overhead when no providers are registered
• Backward compatible — existing loading is unchanged

Design decisions

• Follows LlmBackend pattern — trait object behind Box<dyn IntelligenceProvider>
• Non-fatal provider errors — one provider failing doesn't block others
• Two JSON formats — bare array [...] or wrapped {"signals": [...]}
• calibration_bias() requires 10+ records — avoids noisy corrections from sparse data

Test plan

• cargo check -p ruvllm compiles
• 7 intelligence module tests pass (file parsing, loader, fault tolerance)
• 2 existing integration tests still pass
• Manual: Write a signal JSON file, register FileSignalProvider, verify load_all() returns signals

🤖 Generated with Claude Code