Skip to main content
The Flow editor is the single surface for designing, inspecting, and operating IR-native pipelines. It lives at /data/flow-pipelines/[id]/edit and replaces the legacy single-pane pipeline-flow-editor for any pipeline whose irVersion is "1.0".

​
Layout

PaneWidthContents
Left220px (resizable)Recent runs preview (full list in the Runs tab)
CenterflexTabbed editor: Visual / JSON IR / SQL Preview / Lineage / Runs / Errors / Schedule
Right380px (resizable)AI Panel (Pipeline mode) ↔ Node Config (auto-swaps when you click a node on the canvas)
A top bar shows the pipeline name, status pill, IR version pill, and a Run-now button. A bottom strip shows the last run, next scheduled fire, DLQ count, and quick links.

​
Tab reference

​
Visual

React Flow canvas, kind-coloured nodes (source / transform / validate / target / branch / join / archive / enrich), deterministic vertical waterfall layout. Click a node → right pane swaps to Node Config (read-only JSON for now; an editable form lands in a follow-up plan).

​
JSON IR

Read/write IR editor with format-on-blur. Server-side validation goes through parsePipelineIR — invalid IR is rejected with the structured errors array rendered verbatim. Save creates a new IR version (POST /api/v1/pipelines/:id/ir) and bumps the version pill.

​
SQL Preview

Renders the exact INSERT … SELECT each target node would execute, using the same builders the runtime uses (buildLoadSql + buildSelectExpr). blue_green, incremental_watermark, and cdc_mirror targets render an explicit “preview not available — runtime load-mode helper handles it” note rather than fabricated SQL. GET /api/v1/pipelines/:id/sql-preview powers this tab.

​
Lineage

See Flow Lineage.

​
Runs

Top-20 runs for the current pipeline (status pill, started, rows processed/failed, duration, error). Click a run → drawer with per-node metric tiles (rowsIn/rowsOut/rowsLoaded/warnings) coloured by status. Reads from pipeline_runs.metadata.nodeResults (persisted by the runtime since Phase 6.1).

​
Errors

See Flow Error Inspector.

​
Schedule

See Flow Schedule.

​
What’s NOT in 6.3

Documented honest residuals (deferred to follow-up plans):
  • Drag-to-create-edge / right-click “Delete” on the visual canvas
  • Editable per-node config form in the right pane
  • Pane collapse buttons (react-resizable-panels v4 typing settles)
  • Run-over-run trend chart (Phase 6.6 hardening)
  • Visual DAG highlight when clicking a lineage row (Wave 4 polish)
  • Selective replay-from-DLQ runtime (replayDlqOnly flag)
These aren’t broken — they just aren’t built yet, and the UI calls them out by name where they would otherwise appear.