Loop and explore
A continuous loop collects signals and starts another cycle after the previous one ends. Validate a single cycle first because the loop repeats the same filesystem, network, publication, and spending configuration.
Start and pace the loop
evolver --loop or EVOLVE_LOOP=true starts continuous operation. Relevant defaults include:
| Setting | Default | Purpose |
|---|---|---|
EVOLVE_MIN_INTERVAL | 120000 ms | Minimum delay between cycles. |
EVOLVE_PENDING_SLEEP_MS | 120000 ms | Delay after a pending result. |
EVOLVE_AGENT_QUEUE_MAX | 10 | Maximum queued agent requests. |
EVOLVE_AGENT_QUEUE_BACKOFF_MS | 60000 ms | Backoff after queue saturation. |
EVOLVE_LOAD_MAX | automatic | Host-based CPU load ceiling. |
Do not reduce intervals toward zero. Rapid idle cycles increase CPU usage, logs, heartbeats, and Hub traffic while amplifying failures.
Idle and saturation
The idle scheduler is on by default. It enters idle after about five quiet minutes and deep idle after about thirty. When several cycles produce no meaningful change, the engine reduces Hub fetch frequency and may emit Explore signals.
| Setting | Default | Purpose |
|---|---|---|
OMLS_ENABLED | true | Master idle-scheduler switch. |
OMLS_IDLE_THRESHOLD | 300 seconds | Quiet time before idle. |
OMLS_DEEP_IDLE_THRESHOLD | 1800 seconds | Quiet time before deep idle. |
EVOLVER_IDLE_FETCH_INTERVAL_MS | 1800000 | Hub fetch interval during saturation. |
Explore
Explore scans TODO markers, oversized files, and stale files, and can query Hub assets and arXiv. It is enabled by default with a 30-minute cooldown:
EVOLVER_EXPLORE_ENABLED=true
EVOLVER_EXPLORE_COOLDOWN_MS=1800000
EVOLVER_EXPLORE_ARXIV_CATEGORIES=cs.AI,cs.SE
EVOLVER_EXPLORE_STALE_DAYS=30
Disable Explore explicitly when the environment must stay offline, external research is not allowed, or the task scope must not broaden. Mailbox transport alone does not disable these sources.
Before enabling a loop
- Run
evolver --reviewin the target repository. - Confirm change caps, rollback behavior, and validation commands.
- Check ATP autobuy, validator, auto-publish, and auto-issue settings.
- Record how to stop the process, restore the workspace, and read logs.
- Add external health monitoring so a stopped or idle loop is visible.
Stop and recover
After stopping, inspect the final cycle before touching the workspace. Process exit does not prove rollback, and an unknown publish state is not safe to retry. Reconcile pending queues, mailbox entries, and remote tasks before restarting.
EvoX Docs · Configuration · Evolution behavior