entrenar 0.7.13

//! # Entrenar: Training & Optimization Library
//!
//! Entrenar provides a tape-based autograd engine with optimizers, LoRA/QLoRA,
//! quantization (QAT/PTQ), model merging (TIES/DARE/SLERP), and knowledge distillation.
//!
//! ## Architecture
//!
//! - **autograd**: Tape-based automatic differentiation
//! - **optim**: Optimizers (SGD, Adam, AdamW)
//! - **lora**: Low-rank adaptation with QLoRA support
//! - **quant**: Quantization-aware training and post-training quantization
//! - **merge**: Model merging methods
//! - **distill**: Knowledge distillation
//! - **config**: Declarative YAML configuration
//! - **train**: High-level training loop
//! - **io**: Model saving and loading (JSON, YAML formats)
//! - **hf_pipeline**: HuggingFace model fetching and distillation
//! - **citl**: Compiler-in-the-Loop training with RAG-based fix suggestions (feature-gated)
//! - **efficiency**: Cost tracking, device detection, and performance benchmarking
//! - **eval**: Model evaluation framework with metrics, comparison, and drift detection
//! - **sovereign**: Air-gapped deployment and distribution packaging
//! - **research**: Academic research artifacts, citations, and archive deposits
//! - **ecosystem**: PAIML stack integrations (Batuta, Realizar, Ruchy)
//! - **dashboard**: Real-time training monitoring and WASM bindings
//! - **yaml_mode**: Declarative YAML Mode Training (v1.0 spec)
//! - **transformer**: Transformer layers with autograd support
//! - **moe**: Mixture of Experts sparse routing layer
//! - **decision**: Decision pattern storage and CITL trainer (GH-28, GH-29)
//! - **cli**: Command-line interface handlers
//! - **finetune**: Fine-tuning pipeline with Popperian QA (SPEC-FT-001)

// Contract assertions from YAML (pv codegen)
#[macro_use]
#[allow(unused_macros)]
mod generated_contracts;

// Fallback macros for contracts not yet in build.rs codegen
// (embedding-lookup-v1 was added in provable-contracts 0.2 but
// entrenar's build.rs hasn't been updated to generate it yet)
#[cfg(not(feature = "__has_embedding_contract"))]
macro_rules! contract_pre_embedding_lookup {
    () => {{}};
    ($input:expr) => {{
        let _ = &$input;
    }};
}
#[cfg(not(feature = "__has_embedding_contract"))]
#[allow(unused_macros)]
macro_rules! contract_post_embedding_lookup {
    ($result:expr) => {{
        let _ = &$result;
    }};
}

// Fallback stubs for contract macros not in generated_contracts.rs.
// PMAT-517: These MUST cover every contract_pre_*/contract_post_* used in source
// but not generated by provable-contracts codegen. Without these, crates.io builds
// fail because the binding.yaml is not available outside the workspace.
// Run `bash scripts/check_publish_safety.sh` to verify completeness.
macro_rules! contract_pre_data_read { () => {{}}; ($($x:expr),+ $(,)?) => {{ $(let _ = &$x;)+ }}; }
macro_rules! contract_pre_data_mut { () => {{}}; ($($x:expr),+ $(,)?) => {{ $(let _ = &$x;)+ }}; }
macro_rules! contract_pre_transpose_tracked { () => {{}}; ($($x:expr),+ $(,)?) => {{ $(let _ = &$x;)+ }}; }
#[allow(unused_macros)]
macro_rules! contract_pre_with_resident_weights { () => {{}}; ($($x:expr),+ $(,)?) => {{ $(let _ = &$x;)+ }}; }
#[allow(unused_macros)]
macro_rules! contract_pre_alignment_enforcement { () => {{}}; ($($x:expr),+ $(,)?) => {{ $(let _ = &$x;)+ }}; }
#[allow(unused_macros)]
macro_rules! contract_pre_geometric_mean { () => {{}}; ($($x:expr),+ $(,)?) => {{ $(let _ = &$x;)+ }}; }
#[allow(unused_macros)]
macro_rules! contract_pre_layer_composition { () => {{}}; ($($x:expr),+ $(,)?) => {{ $(let _ = &$x;)+ }}; }
#[allow(unused_macros)]
macro_rules! contract_pre_mqs_pass_rate { () => {{}}; ($($x:expr),+ $(,)?) => {{ $(let _ = &$x;)+ }}; }

pub mod aprender_compat;
pub mod autograd;
#[cfg(feature = "citl")]
pub mod citl;
pub mod cli;
pub mod config;
pub mod dashboard;
pub mod decision;
pub mod distill;
pub mod ecosystem;
pub mod efficiency;
pub mod eval;
#[cfg(not(target_arch = "wasm32"))]
pub mod finetune;
pub mod generative;
#[cfg(not(target_arch = "wasm32"))]
pub mod gpu;
#[cfg(all(not(target_arch = "wasm32"), feature = "hub"))]
pub mod hf_pipeline;
pub mod inference;
pub mod integrity;
pub mod io;
pub mod lora;
pub mod merge;
pub mod moe;
pub mod monitor;
pub mod numerical;
pub mod optim;
pub mod pipeline;
pub mod prune;
pub mod quality;
pub mod quant;
pub mod research;
pub mod run;
pub mod safety;
pub mod search;
pub mod server;
pub mod sovereign;
pub mod sovereign_array;
pub mod staging;
pub mod storage;
pub mod tokenizer;
pub mod trace;
pub mod tracking;
pub mod train;
pub mod training;
pub mod transformer;
pub mod yaml_mode;

pub mod error;

// Re-export commonly used types
pub use autograd::{backward, Context, Tensor};
pub use error::{Error, Result};