Open source · Automation & Workflows

Approval Path Visualizer

Render approvals as a path showing owners, conditions and exception exits.

v0.1.0 · Node.js 22+ · MIT

Browse the public repository · View releases

Read an approval path — steps, approvers, branch conditions, timeouts and exception exits — check the paths through it, and draw a standalone SVG or HTML diagram of what it found.

This walkthrough uses the tool's public README and checked-in example files. Run the command from a repository checkout with Node.js 22+.

Run the checked-in example

node bin/approval-path-visualizer.mjs --root examples/clean --graph approval.json --out build/approval-path.svg

Read the result

A graph file that was named but is not there is missing evidence, not a configuration error: it is reported as graph-unreadable in an incomplete report. stdout is empty only when the run never had a subject at all — an unusable flag, an unreadable root, a path that resolves outside it.

Scope

The layout is a plain layered one: shortest-path layers top to bottom, steps ordered by id within a layer, straight arrows forward and a curve for anything that goes back. It is meant to be read and diffed, not to be pretty; on a dense graph, arrows cross.