Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

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

FlagDefaultNotes
--episodes10Generations to run
--workspace.flock/episodesEpisode JSON corpus directory
--hookrustProposer hook (seed-only for fixture tests)
--summarizeoffWrite .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