feagi_evolutionary/
lib.rs

1// Copyright 2025 Neuraville Inc.
2// SPDX-License-Identifier: Apache-2.0
3
4/*!
5# FEAGI Evolution & Genome Management
6
7Handles all **genotype** operations for FEAGI:
8
9- Genome I/O (JSON ↔ Rust structs)
10- Genome validation
11- Evolution operators (mutation, crossover)
12- Fitness evaluation
13- Population management
14
15## Architecture
16
17This crate manages the **genetic blueprint** (genotype) of FEAGI brains.
18The actual instantiated brain structure (phenotype) is handled by `feagi-bdu`.
19
20## Separation of Concerns
21
22```text
23feagi-evo (Genotype)        feagi-bdu (Phenotype)
24─────────────────────       ─────────────────────
25│ Genome JSON I/O    │  →   │ Neuroembryogenesis │
26│ Genome Validation  │      │ Connectome I/O      │
27│ Evolution Ops      │      │ Synaptogenesis      │
28│ Fitness Eval       │      │ NPU Integration     │
29└────────────────────┘      └─────────────────────┘
30```
31
32## Modules
33
34- `genome` - Genome I/O and validation
35- `evolution` - Evolution operators (future)
36- `fitness` - Fitness evaluation (future)
37- `population` - Population management (future)
38
39Copyright 2025 Neuraville Inc.
40Licensed under the Apache License, Version 2.0
41*/
42
43/// Crate version from Cargo.toml
44pub const VERSION: &str = env!("CARGO_PKG_VERSION");
45
46// Core modules
47pub mod converter_flat;
48pub mod converter_flat_full;
49pub mod converter_hierarchical_to_flat;
50pub mod cortical_type_parser;
51pub mod genome;
52pub mod plasticity_detector;
53pub mod random;
54pub mod runtime;
55pub mod storage;
56pub mod templates;
57pub mod types;
58pub mod validator;
59
60// Re-export commonly used types
61pub use converter_flat::convert_flat_to_hierarchical;
62pub use converter_flat_full::convert_flat_to_hierarchical_full;
63pub use converter_hierarchical_to_flat::convert_hierarchical_to_flat;
64pub use cortical_type_parser::{parse_cortical_type, validate_cortical_type};
65pub use genome::parser::string_to_cortical_id;
66pub use genome::{
67    load_genome_from_file, load_genome_from_json, migrate_genome, peek_quantization_precision,
68    save_genome_to_file, save_genome_to_json, GenomeParser, GenomeSaver, MigrationResult,
69    ParsedGenome,
70};
71pub use plasticity_detector::{
72    extract_memory_properties, genome_has_plasticity, MemoryAreaProperties,
73};
74pub use runtime::{
75    GenomeMetadata, GenomeSignatures, GenomeStats, Morphology, MorphologyParameters,
76    MorphologyRegistry, MorphologyType, PatternElement, PhysiologyConfig, RuntimeGenome,
77};
78#[cfg(feature = "async-tokio")]
79pub use storage::fs_storage::FileSystemStorage;
80pub use storage::{GenomeStorage, StorageError};
81pub use templates::{
82    add_core_morphologies, create_death_area, create_fatigue_area, create_genome_with_core_areas,
83    create_genome_with_core_morphologies, create_minimal_genome, create_power_area,
84    ensure_core_components, get_default_neural_properties, load_barebones_genome,
85    load_essential_genome, load_test_genome, load_vision_genome, BAREBONES_GENOME_JSON,
86    ESSENTIAL_GENOME_JSON, TEST_GENOME_JSON, VISION_GENOME_JSON,
87};
88pub use types::{EvoError, EvoResult};
89pub use validator::{validate_genome, ValidationResult};
feagi_evolutionary/lib.rs

feagi_evolutionary/
lib.rs
