Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector'

vendor/ruvector/crates/sona/src/training/mod.rs

@@ -0,0 +1,70 @@
+//! SONA Training System
+//!
+//! Templated training pipelines for specialized model adaptation.
+//!
+//! ## Overview
+//!
+//! The training module provides:
+//! - **Training Templates**: Pre-configured training setups for common use cases
+//! - **Agent Factory**: Create and manage multiple specialized agents
+//! - **Training Pipelines**: Structured workflows for different verticals
+//! - **Federated Learning**: Distributed training across ephemeral agents
+//! - **Metrics & Results**: Comprehensive training analytics
+//!
+//! ## Quick Start
+//!
+//! ```rust,ignore
+//! use ruvector_sona::training::{TrainingTemplate, AgentFactory, TrainingPipeline};
+//!
+//! // Use a preset template
+//! let template = TrainingTemplate::code_agent();
+//! let pipeline = TrainingPipeline::from_template(template);
+//!
+//! // Train on examples
+//! for example in examples {
+//!     pipeline.add_example(example);
+//! }
+//! let results = pipeline.train()?;
+//! ```
+//!
+//! ## Federated Learning
+//!
+//! ```rust,ignore
+//! use ruvector_sona::training::{EphemeralAgent, FederatedCoordinator};
+//!
+//! // Create coordinator
+//! let mut coordinator = FederatedCoordinator::default_coordinator("main", 3072);
+//!
+//! // Ephemeral agents process tasks
+//! let mut agent = EphemeralAgent::default_federated("agent-1", 3072);
+//! agent.process_trajectory(embedding, activations, quality, route, context);
+//!
+//! // Export state before termination
+//! let export = agent.export_state();
+//! coordinator.aggregate(export);
+//! ```
+
+mod factory;
+mod federated;
+mod metrics;
+mod pipeline;
+mod templates;
+
+pub use factory::{
+    AgentFactory, AgentHandle, AgentStats, ManagedAgent, SharedAgentFactory, SimpleExample,
+    TrainingExample as FactoryTrainingExample,
+};
+pub use federated::{
+    AgentContribution, AgentExport, AgentExportStats, AggregationResult, CoordinatorStats,
+    EphemeralAgent, FederatedCoordinator, FederatedTopology, TrajectoryExport,
+};
+pub use metrics::{
+    EpochStats, PerformanceMetrics, QualityMetrics, TrainingMetrics, TrainingResult,
+};
+pub use pipeline::{
+    BatchConfig, PipelineStage, TrainingCallback, TrainingExample, TrainingPipeline,
+};
+pub use templates::{
+    AgentType, DataSizeHint, TaskDomain, TemplatePreset, TrainingMethod, TrainingTemplate,
+    VerticalConfig,
+};