ceduix

Frontend control plane for machine-agent-built surfaces.

Quickstart — bin/ceduix-flow

# validate an authored ceduix-flow graph (NDJSON findings, exit 0/1/2)
bin/ceduix-flow validate engine/flow/examples/01-basic-edge.html

# render to standalone SVG (round-trips back to the same canonical model)
bin/ceduix-flow render engine/flow/examples/08-imd-allocation.html --to svg > /tmp/imd.svg

# export IMD allocation as CSV (quantity, cost, owner, period per node)
bin/ceduix-flow export engine/flow/examples/08-imd-allocation.html --as csv

# probe the file for an agent.execution.v1 frontend_lineage_row
bin/ceduix-flow probe engine/flow/examples/08-imd-allocation.html

The CLI is headless: no browser, no worker, no network. ELK runs in Node via elkjs/lib/elk.bundled.js; the SVG renderer is a pure string builder.

Full subcommand reference + invariants: engine/flow/CEDUIX_FLOW.md §9.

Routes

signal	read
agent contract + repo invariants	AGENTS.md
frontend SSOT + engine registry	docs/FRONTEND-LINEAGE-SSOT.md + engines.json
ceduix-flow grammar + CLI	engine/flow/CEDUIX_FLOW.md
token vocabulary	framework/CEDUIX_UI.md + framework/css/ceduix.css
spatial inspection	canvas/CEDUIX_CANVAS.md

Test

npm test          # lint + node test/run.js + chart tests
npm run test:flow # all vitest suites under test/flow/