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    apply_genome_title_to_unique_top_circuit, decode_genome_artifact, encode_genome_artifact,
70    load_genome_artifact_with_report, load_genome_from_artifact, load_genome_from_file,
71    load_genome_from_json, load_genome_value_with_report, load_genome_with_report,
72    load_genome_with_report_from_file, migrate_genome, migrate_genome_json_to_current,
73    migrate_genome_value_to_current, peek_quantization_precision, save_genome_to_file,
74    save_genome_to_json, subset_runtime_genome_for_region_branch,
75    validate_genome_artifact_file_name, wrap_parentless_regions_under_named_root, ChainResult,
76    GenomeArtifactCodec, GenomeArtifactEncoding, GenomeParser, GenomeSaver,
77    JsonGenomeArtifactCodec, MigrationResult, ParsedGenome, GENOME_ARTIFACT_EXTENSION,
78    GENOME_ARTIFACT_MEDIA_TYPE,
79};
80pub use plasticity_detector::{
81    extract_memory_properties, genome_has_plasticity, MemoryAreaProperties,
82};
83pub use runtime::{
84    GenomeMetadata, GenomeSignatures, GenomeStats, Morphology, MorphologyParameters,
85    MorphologyRegistry, MorphologyType, PatternElement, PhysiologyConfig, RuntimeGenome,
86};
87#[cfg(feature = "async-tokio")]
88pub use storage::fs_storage::FileSystemStorage;
89pub use storage::{GenomeStorage, StorageError};
90pub use templates::{
91    add_core_morphologies, create_death_area, create_fatigue_area, create_fear_area,
92    create_genome_with_core_areas, create_genome_with_core_morphologies, create_hope_area,
93    create_minimal_genome, create_pain_area, create_pleasure_area, create_power_area,
94    ensure_core_components, get_default_neural_properties, load_barebones_genome,
95    load_essential_genome, load_test_genome, load_vision_genome, BAREBONES_GENOME_JSON,
96    ESSENTIAL_GENOME_JSON, TEST_GENOME_JSON, VISION_GENOME_JSON,
97};
98pub use types::{EvoError, EvoResult};
99pub use validator::{validate_genome, ValidationResult};
feagi_evolutionary/lib.rs

feagi_evolutionary/
lib.rs
