flow-tools/docs/ARCHITECTURE.md

Architecture

The bounded parser accepts pasted or local JSON, CSV, NDJSON and inert XML and produces JSON values. The interpreter copies rows stage-by-stage and accepts a fixed discriminated grammar, including deduplication, bounded slicing and array explosion. It records output, loss notes and dataset statistics after each run.

Analysis and simulation run in a disposable module worker. Progress messages are revision-checked, cancellation terminates the worker, and React retains the last successful snapshots. Recipe imports are size-bounded and validate every field before execution. Result JSON/CSV, recipe JSON and the escaped pipeline SVG are generated entirely in the browser.