# Easy Nodes and MG_SuperSimple

MagicNodes provides simplified “Easy” variants that expose only high‑value controls while relying on preset files for the rest. These are grouped under the UI category `MagicNodes/Easy`.

- Presets live in `pressets/mg_cade25.cfg` and `pressets/mg_controlfusion.cfg` with INI‑like sections `Step 1..4` and simple `key: value` pairs. The token `$(ROOT)` is supported in paths and is substituted at load time.
- Loader: `mod/easy/preset_loader.py` caches by mtime and does light type parsing.
- The Step+Custom scheme keeps UI and presets in sync: choose a Step to load defaults, then optionally toggle Custom to override only the visible controls, leaving hidden parameters from the Step preset intact.

## MG_SuperSimple (Easy)

Single node that reproduces the 2/3/4‑step CADE+ControlFusion pipeline with minimal surface.

Category: `MagicNodes/Easy`

Inputs
- `model` (MODEL)
- `positive` (CONDITIONING), `negative` (CONDITIONING)
- `vae` (VAE)
- `latent` (LATENT)
- `control_net` (CONTROL_NET) — required by ControlFusion
- `reference_image` (IMAGE, optional) — forwarded to CADE
- `clip_vision` (CLIP_VISION, optional) — forwarded to CADE

Controls
- `step_count` int (1..4): how many steps to run
- `custom` toggle: when On, the visible CADE controls below override the Step presets across all steps; when Off, all CADE values come from presets
- `seed` int with `control_after_generate`
- `steps` int (default 25) — applies to steps 2..4
- `cfg` float (default 4.5)
- `denoise` float (default 0.65, clamped 0.45..0.9) — applies to steps 2..4
- `sampler_name` (default `ddim`)
- `scheduler` (default `MGHybrid`)
- `clipseg_text` string (default `hand, feet, face`)

Behavior
- Step 1 runs CADE with `Step 1` preset and forces `denoise=1.0` (single exception to the override rule). All other visible fields follow the Step+Custom logic described above.
- For steps 2..N: ControlFusion (with `Step N` preset) updates `positive/negative` based on the current image, then CADE (with `Step N` preset) refines the latent/image.
- Initial `positive/negative` come from the node inputs; subsequent steps use the latest CF outputs. `latent` is always taken from the previous CADE.
- When `custom` is Off, UI values are ignored entirely; presets define all CADE parameters.
- ControlFusion inside this node always relies on presets (no additional CF UI here) to keep the surface minimal.

Outputs
- `(LATENT, IMAGE)` from the final executed step (e.g., step 2 if `step_count=2`). No preview outputs.

Quickstart
1) Drop `MG_SuperSimple` into your graph under `MagicNodes/Easy`.
2) Connect `model/positive/negative/vae/latent`, and a `control_net` module; optionally connect `reference_image` and `clip_vision`.
3) Choose `step_count` (2/3/4). Leave `custom` Off to use pure presets, or enable it to apply your `seed/steps/cfg/denoise/sampler/scheduler/clipseg_text` across all steps (with Step 1 `denoise=1.0`).
4) Run. The node returns the final `(LATENT, IMAGE)` for the chosen depth.

Notes
- Presets are read from `pressets/mg_cade25.cfg` and `pressets/mg_controlfusion.cfg`. Keep them in UTF‑8 and prefer `$(ROOT)` over absolute paths.
- `seed` is shared across all steps for determinism; if per‑step offsets are desired later, this can be added as an option without breaking current behavior.