Update CHANGELOG

Author: basvanwesting

AGENTS.md

@@ -666,4 +666,4 @@ Combine with `max_stale_generations` to trigger phase transitions automatically
 7. **`target_population_size` defaults to 0.** Always set it for Evolve.
 8. **Custom Crossover/Mutate/Extension must call `chromosome.reset_metadata(genotype.genes_hashing)`** after modifying genes directly.
 9. **Custom Crossover must call `state.population.increment_age()`** on existing chromosomes.
-10. **For deterministic tests:** use `.with_rng_seed_from_u64(0)`.
+10. **For deterministic tests:** use `.with_rng_seed_from_u64(0)`. Exact results may change between library versions, but deterministic within a version.

CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+
+## [0.26.1] - 2026-02-16
+
+### Added
+* Documentation additions for AI agent (and human) consumption:
+  * Added AGENTS.md as a comprehensive agent guide (decision matrices, API reference, copy-paste templates, gotchas)
+  * Added docstrings to all previously undocumented public constructors and key methods
+  * Fixed several inaccurate docstrings (extensions, crossover, mutate, select)
+  * Improved error messages with actionable fix suggestions
+  * Add example headers
+  * Add a new Heterogeneous Genotype example (`examples/evolve_heterogeneous`)
+
 ## [0.26.0] - 2025-11-24
 
 > [!CAUTION]

README.md

@@ -136,6 +136,8 @@ Run with `cargo run --example [EXAMPLE_BASENAME] --release`
     * See [examples/visualize_evolve_mutation_types](../main/examples/visualize_evolve_mutation_types.rs) for Evolve strategy
     * See [examples/visualize_permutate_mutation_types](../main/examples/visualize_permutate_mutation_types.rs) for Permutate strategy
     * Generates visualizations showing exploration patterns of different mutation strategies
+* Heterogeneous Genotype example (bool, options, continues and discrete in one genome)
+    * See [examples/evolve_heterogeneous](../main/examples/evolve_heterogeneous.rs)
 * Use superset StrategyBuilder for easier switching in implementation
     * See [examples/explore_strategies](../main/examples/explore_strategies.rs)
 * Use fitness LRU cache
@@ -232,6 +234,7 @@ Default configuration for correctness AND performance
 Run tests with `cargo test`
 
 Use `.with_rng_seed_from_u64(0)` builder step to create deterministic tests results.
+Exact results may change between library versions (even minor), but deterministic within a version.
 
 ## Benchmarks
 Implemented using criterion. Run benchmarks with `cargo bench`

examples/evolve_multi_range.rs examples/evolve_heterogeneous.rsexamples/evolve_multi_range.rs renamed to examples/evolve_heterogeneous.rs

@@ -72,6 +72,7 @@
 //! ## Tests
 //!
 //! Use `.with_rng_seed_from_u64(0)` builder step to create deterministic tests results.
+//! Exact results may change between library versions (even minor), but deterministic within a version.
 //!
 //! ## Examples
 //!
@@ -101,6 +102,8 @@
 //!     * See [examples/visualize_evolve_mutation_types](https://github.com/basvanwesting/genetic-algorithm/blob/main/examples/visualize_evolve_mutation_types.rs)
 //!     * See [examples/visualize_permutate_mutation_types](https://github.com/basvanwesting/genetic-algorithm/blob/main/examples/visualize_permutate_mutation_types.rs)
 //!     * Generates visualizations showing exploration patterns of different mutation strategies
+//! * Heterogeneous Genotype example (bool, options, continues and discrete in one genome)
+//!     * See [examples/evolve_heterogeneous](https://github.com/basvanwesting/genetic-algorithm/blob/main/examples/evolve_heterogeneous.rs)
 //! * Use superset StrategyBuilder for easier switching in implementation
 //!     * See [examples/explore_strategies](https://github.com/basvanwesting/genetic-algorithm/blob/main/examples/explore_strategies.rs)
 //! * Use fitness LRU cache