Docs

The Workflow Engine · 05.04

What "Self-Healing" Actually Means

Four real mechanisms working together — a recovery ladder, a law against silent restructuring, a pattern-recognizer for repeat failures, and a safe way to change a live run — not a single feature.

Self-healing

Not one feature — four, working together

MechanismWhat it actually does
The Recovery LadderWhen a node fails, climbs from a free deterministic reflex up through certified structural repair — cheapest and least invasive first, never reaching further than the failure actually requires.
Blueprint LawA graph that's already proven itself in production can never be silently restructured while "healing" something unrelated — runtime-class failures are classified out before structural surgery is ever considered.
The Instinct EngineNotices when the same failure keeps recurring across runs and proposes a real fix — the difference between healing one incident and actually learning from a pattern.
Atomic EvolutionThe contract that makes changing a live run's graph safe — a monotonic ratchet that never lets a mid-run edit make things worse, so healing itself can never be the thing that corrupts a graph.

The failure that motivated all four at once

A proven production workflow and a repair experiment are deliberately separate. A failure is first classified as policy, configuration/capability, transient resource, data contract, graph design, or platform. Only a graph-repair-eligible class can propose a structural change. That change is applied to the current run and stored as a candidate revision; it never overwrites the active production graph. The same failure fingerprint gets at most one repair proposal against the same base revision, preventing repeated self-heal loops. The candidate becomes active only after independent proof and promotion.

Continue