workflow-layout

Use the panel canvas tools to read the graph with panel_query_graph, compute dependency layers from node connections, and reposition each node with panel_edit_node. Nodes are stacked by their full rendered height so nothing overlaps, then the result is saved with panel_save_workflow.

Overlaps happen when nodes are stacked using size[1], which excludes the title bar. Stack columns using full_height from panel_query_graph plus a row gap of about 40 pixels, since full_height includes the header and gives an exact visible gap.

A group is a colored box that labels a region while nodes stay in place and editable. A subgraph collapses nodes into one node with boundary rails, which suits large graphs but hides nodes, so small two or three node stages should stay flat.

Subgraph input and output rails do not follow inner nodes when they move. After laying out a subgraph interior, re-pin the rails with panel_move_rail so the input rail sits left of the node band and the output rail sits right of it.

Canvas edits never affect an in-flight render, though a ComfyUI restart clears the queue. Node positions, titles, and groups only persist after saving the workflow, so save before relying on the new layout.