modules.api.engine.dirty_hot_reload

Picks up dirty-overlay changes from disk while a scene is loaded in edit mode, applies them to the live entities, and keeps the in-memory representation in lockstep with scene_dirty/ files. Pairs with scene_saver (writes deltas) + scene_loader (composes canonical + overlay at load time).

Parents

A record's parent names the entity it stands under: the entity whose id is that text, else the entity whose display name is exactly that text. A * or ? in it is a character of the name, never a pattern.

A record whose parent no entity provides waits. An entity that does not stand yet is not built, one that already stands keeps its state, the layer logs the record once, and debugState(guid).waiting maps its id to the parent it names. While a record waits, the scene saver leaves it as it stands rather than writing a standing entity's older state over it, until an author edits that entity, which the saver then records as it stands. When a record builds an entity, the records waiting on that entity's id or display name are built under it, so a child record that arrives before its parent's record lands where a load of both places it. Each waiting record is built as its overlay file states it at that moment, so a record rewritten while it waited, including by this session's own saver, builds from its current bytes. A load gives the same account of a record whose parent stays missing: the loader abandons it with parentMissing.