flock evolve
Evolve harness topology from episode logs. Optional Python GEPA hook; drift gate rejects incompatible mutations.
Usage
flock evolve [--episodes 10] [--workspace .flock/episodes] [--hook rust|seed-only] [--summarize]
Key flags
| Flag | Default | Notes |
|---|---|---|
--episodes | 10 | Generations to run |
--workspace | .flock/episodes | Episode JSON corpus directory |
--hook | rust | Proposer hook (seed-only for fixture tests) |
--summarize | off | Write .flock/episode_summary.json without evolving |
--summarize compacts the corpus for the proposer (DRY with substrate heatmap). Drift-incompatible candidates are rejected and logged.
Recipes
Standard evolve from local episodes:
flock run --goal "reach target" --plugin gridworld
flock evolve --episodes 10 --workspace .flock/episodes
Summarize only (no mutation):
flock evolve --summarize --workspace .flock/episodes
Seed archive then run:
flock evolve --episodes 10
flock run --goal "reach target" --plugin gridworld --seed-archive