aprender-orchestrate 0.29.0

Sovereign AI orchestration: autonomous agents, ML serving, code analysis, and transpilation pipelines
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

#![allow(dead_code, unused_imports)]
//! Experiment Tracking Integration Module
//!
//! Integrates with Entrenar Experiment Tracking Spec v1.8.0 for orchestrating
//! ML experiment workflows with full traceability, cost optimization, and
//! academic research support.
//!
//! # Entrenar CLI (v0.2.4)
//!
//! The entrenar crate provides a comprehensive CLI:
//!
//! ```bash
//! # Training (YAML Mode v1.0)
//! entrenar train config.yaml           # Train from declarative YAML
//! entrenar validate config.yaml        # Validate configuration
//! entrenar init --template lora        # Generate config template
//!
//! # Model Operations
//! entrenar quantize model.safetensors --bits 4
//! entrenar merge model1.st model2.st --method ties
//!
//! # Research Workflows
//! entrenar research init --id my-dataset
//! entrenar research cite artifact.yaml --format bibtex
//!
//! # Inspection & Auditing
//! entrenar inspect model.safetensors   # Model/data inspection
//! entrenar audit data.parquet --type bias
//! entrenar monitor data.parquet        # Drift detection
//!
//! # Benchmarking (entrenar-bench)
//! entrenar-bench temperature --start 1.0 --end 8.0
//! entrenar-bench cost-performance --gpu a100-80gb
//! ```
//!
//! # MCP Tooling (pmcp v1.8.6 + pforge v0.1.4)
//!
//! The stack includes Model Context Protocol (MCP) infrastructure:
//!
//! ```bash
//! # pmcp - Rust SDK for MCP servers/clients
//! # Build MCP servers with full TypeScript SDK compatibility
//!
//! # pforge - Declarative MCP framework
//! pforge new my-server              # Create new MCP server project
//! pforge serve                       # Run MCP server
//!
//! # Define tools in YAML (pforge.yaml):
//! # tools:
//! #   - type: native
//! #     name: train_model
//! #     handler: { path: handlers::train }
//! #     params:
//! #       config: { type: string, required: true }
//! ```
//!
//! **Handler Types:**
//! - `native` - Rust functions with full type safety
//! - `cli` - Execute shell commands
//! - `http` - Proxy HTTP endpoints
//! - `pipeline` - Chain multiple tools together
//!
//! # Features
//! - ComputeDevice abstraction (CPU/GPU/TPU/AppleSilicon)
//! - EnergyMetrics and CostMetrics for efficiency tracking
//! - ModelParadigm classification
//! - CostPerformanceBenchmark with Pareto frontier analysis
//! - SovereignDistribution for air-gapped deployments
//! - ResearchArtifact with ORCID/CRediT academic support
//! - CitationMetadata for BibTeX/CFF generation
//! - Experiment tree visualization for run comparison (MLflow replacement)
//! - YAML Mode Training v1.0 declarative configuration

// Submodules
pub mod benchmark;
pub mod metrics;
pub mod research;
pub mod run;
pub mod sovereign;
pub mod tree;
pub mod types;

#[cfg(test)]
mod tests;

// Re-export all public types from submodules for convenient access

// Types module
pub use types::{
    AppleChip, ComputeDevice, ComputeIntensity, CpuArchitecture, ExperimentError, GpuVendor,
    ModelParadigm, PlatformEfficiency, TpuVersion,
};

// Metrics module
pub use metrics::{CostMetrics, EnergyMetrics};

// Benchmark module
pub use benchmark::{CostPerformanceBenchmark, CostPerformancePoint};

// Research module
pub use research::{
    CitationMetadata, CitationType, CreditRole, Orcid, PreRegistration, ResearchArtifact,
    ResearchContributor,
};

// Run module
pub use run::{ExperimentRun, ExperimentStorage, InMemoryExperimentStorage, RunStatus};

// Sovereign module
pub use sovereign::{
    ArtifactSignature, ArtifactType, OfflineRegistryConfig, SignatureAlgorithm, SovereignArtifact,
    SovereignDistribution,
};