Topology evolution

Frontier bet: evolution that changes coordination geometry, not prompts.

What this proves

Episode logs from real flock run / swarm-demo runs ground fitness via plugin_grounded_fitness().
flock evolve --episodes 10 runs accept/reject over generations (drift + immune gates).
Gen-0 vs gen-N fitness delta and genome lineage are observable in CLI output.

Quick run

cargo build --release -p flock-cli
bash docs/demo/evolve-proof.sh

Or step by step:

flock swarm-demo
flock run --goal "reach target" --plugin gridworld   # repeat 3×
flock evolve --episodes 10 --workspace .flock/episodes
flock genome list
flock genome lineage <genome_id>

Sample output shape

{
  "generations": 10,
  "accepted": 4,
  "rejected": 6,
  "gen0_fitness": 0.69,
  "final_fitness": 0.74,
  "fitness_delta": 0.05,
  "seed_source": "episodes",
  "pareto_front": []
}

CI gate

Fast smoke (no LLM, fixture episodes only):

cargo run -q -p evolve_proof

Fixture corpus: tests/fixtures/evolve-episodes/ (4 gridworld episodes).

Honest limits

Fitness is plugin-grounded from in-tree gridworld episodes, not Govcraft 48.5% LLM benchmark.
Mutations target wake threshold, topology nodes, and per-zone decay — not prompt strings.
Crossover activates when Pareto front has ≥2 non-quarantined entries.

Keyboard shortcuts