layout-debug

Overview ¶

Command layout-debug is the DEV triage view over the layout engine: fast, targeted, one fact per line, greppable and diffable — for an AI session or a human hunting one wrong edge — the debug half of the debug↔explain split (docs/dev/layout-gen/layout-debug.md). It is a SUPERSET of layout-gen: the same --in/--out/--pretty shipping surface, plus the debug addons (--why/--facts/--table/--edges/--candidates/--verbose/--sel). One invocation generates the layout AND produces the view.

Deviation from layout-gen, stated openly: in the dev tool stdout belongs to the VIEW, so the layout JSON is written only when --out names a real file — layout-gen's write-to-stdout default would interleave with the view.

gl:docs/dev/layout-gen/layout-debug.md