ouroboros_evolve_step
Run one generation of an evolutionary code-generation loop. Reconstructs lineage state from events, evaluates, and returns a convergence signal with the next action.
Instructions
Run exactly ONE generation of the evolutionary loop. For Gen 1: provide lineage_id and seed_content (YAML). For Gen 2+: provide lineage_id only (state reconstructed from events). Returns generation result, convergence signal, and next action (continue/converged/ontology_stable/stagnated/exhausted/failed). ontology_stable is a non-success handoff; rerun the same lineage with execute=true to perform Execute→Evaluate.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| execute | No | Whether to run seed execution and evaluation. True (default): full pipeline with Execute→Validate→Evaluate. False: ontology-only evolution (fast, no execution). | |
| skip_qa | No | Skip post-execution QA evaluation. Default: false | |
| parallel | No | Whether to run ACs in parallel. True (default): parallel execution (fast, may cause import conflicts). False: sequential execution (slower, more stable code generation). | |
| lineage_id | Yes | Lineage ID to continue or new ID for Gen 1 | |
| project_dir | No | Project root directory for validation (pytest collection check). If omitted, auto-detected from execution output or CWD. | |
| execution_id | No | Optional execution id for checkpoint commit metadata. | |
| seed_content | No | Seed YAML text for Gen 1. Pass a YAML-formatted string (for example, newline-delimited 'goal: ...' fields), not JSON-shaped text or an object literal; some MCP clients may otherwise coerce the value to an object before Ouroboros receives it. Omit for Gen 2+ (seed reconstructed from events). | |
| commit_policy | No | Optional checkpoint commit policy for passed ACs. | |
| auto_session_id | No | Optional auto session id for checkpoint commit metadata. | |
| benchmark_control | No | Run a deliberate full-graph frugality control. Default: false. Requires execute=true, Gen 2+, an explicit Git project_dir, and a clean baseline; unavailable through plugin delegation. | |
| checkpoint_commits | No | Existing checkpoint commit records for idempotency. | |
| conductor_directive | No | Bounded corrective context for this successor generation. | |
| conductor_decision_id | No | Selected conductor decision authorizing this successor generation. | |
| recover_expired_claim | No | Explicitly recover an expired lineage writer claim after confirming the prior owner process is dead. Default: false | |
| predecessor_execution_id | No | Execution or generation that this successor follows. | |
| checkpoint_attempted_ac_ids | No | Acceptance criteria already considered for checkpoint commits. |