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
47mod amalgamation_remap;
48pub mod converter_flat;
49pub mod converter_flat_full;
50pub mod converter_hierarchical_to_flat;
51pub mod cortical_type_parser;
52pub mod genome;
53pub mod plasticity_detector;
54pub mod random;
55pub mod runtime;
56pub mod storage;
57pub mod templates;
58pub mod types;
59pub mod validator;
60
61// Re-export commonly used types
62pub use amalgamation_remap::remap_guest_custom_memory_cortical_ids_for_amalgamation;
63pub use converter_flat::convert_flat_to_hierarchical;
64pub use converter_flat_full::convert_flat_to_hierarchical_full;
65pub use converter_hierarchical_to_flat::convert_hierarchical_to_flat;
66pub use cortical_type_parser::{parse_cortical_type, validate_cortical_type};
67pub use genome::parser::string_to_cortical_id;
68pub use genome::{
69    load_genome_from_file, load_genome_from_json, load_genome_with_report,
70    load_genome_with_report_from_file, migrate_genome, peek_quantization_precision,
71    save_genome_to_file, save_genome_to_json, subset_runtime_genome_for_region_branch, ChainResult,
72    GenomeParser, GenomeSaver, MigrationResult, ParsedGenome,
73};
74pub use plasticity_detector::{
75    extract_memory_properties, genome_has_plasticity, MemoryAreaProperties,
76};
77pub use runtime::{
78    GenomeMetadata, GenomeSignatures, GenomeStats, Morphology, MorphologyParameters,
79    MorphologyRegistry, MorphologyType, PatternElement, PhysiologyConfig, RuntimeGenome,
80};
81#[cfg(feature = "async-tokio")]
82pub use storage::fs_storage::FileSystemStorage;
83pub use storage::{GenomeStorage, StorageError};
84pub use templates::{
85    add_core_morphologies, create_death_area, create_fatigue_area, create_fear_area,
86    create_genome_with_core_areas, create_genome_with_core_morphologies, create_hope_area,
87    create_minimal_genome, create_pain_area, create_pleasure_area, create_power_area,
88    ensure_core_components, get_default_neural_properties, load_barebones_genome,
89    load_essential_genome, load_test_genome, load_vision_genome, BAREBONES_GENOME_JSON,
90    ESSENTIAL_GENOME_JSON, TEST_GENOME_JSON, VISION_GENOME_JSON,
91};
92pub use types::{EvoError, EvoResult};
93pub use validator::{validate_genome, ValidationResult};
feagi_evolutionary/lib.rs

feagi_evolutionary/
lib.rs
