docs: improve README with usage instructions

README.md

@@ -11,19 +11,20 @@ license: mit
 short_description: Escalating healing when stagnation is detected
 ---
 
-# Operon Epiplexity Healing Cascade
+# 💡 Operon Epiplexity Healing Cascade
 
-Detect epistemic stagnation via EpiplexityMonitor and escalate through increasingly aggressive healing interventions.
+Detect epistemic stagnation and escalate through increasingly aggressive healing -- autophagy, regeneration, and abort -- like an immune system ramping up its response when initial measures fail.
 
-## Features
+## What to Try
 
-- **Stagnation detection**: EpiplexityMonitor measures novelty and flags STAGNANT/CRITICAL
-- **Escalating cascade**: autophagy -> regeneration -> abort
-- **Diagnostic reports**: Full stagnation history with epiplexity scores
-- **Presets**: Healthy agent, stagnant agent, critical with regeneration
+1. Select a preset from the **Preset** dropdown (e.g. "Stagnant agent" or "Critical with regeneration") and click **Run Cascade** to see how stagnation triggers escalating healing interventions.
+2. Adjust the **Stagnation threshold** and **Autophagy threshold** sliders to change when each healing level kicks in, then re-run to compare outcomes.
+3. Try the "Healthy agent" preset to confirm that a well-performing agent passes through without triggering any healing.
 
-## Motifs Combined
+## How It Works
 
-EpiplexityMonitor + AutophagyDaemon + RegenerativeSwarm + Cascade
+The EpiplexityMonitor watches for declining novelty in agent output. When stagnation is detected, the cascade escalates: first autophagy prunes noisy context, then regeneration respawns the worker with clean state, and finally abort halts the pipeline if nothing else works.
 
-[GitHub](https://github.com/coredipper/operon) | [PyPI](https://pypi.org/project/operon-ai/)
+## Learn More
+
+[GitHub](https://github.com/coredipper/operon) | [PyPI](https://pypi.org/project/operon-ai/) | [Paper](https://github.com/coredipper/operon/tree/main/article)

requirements.txt

@@ -1,2 +1,2 @@
 gradio>=4.0
-operon-ai>=0.14.0
+operon-ai>=0.15.0