Repositions and packages the one validated, unique win so people can see it and
reuse it (per the positioning review).
- README: new lede leads with "tell what actually changed, not what just moved" +
the live `reagraph demo` contrast (59 of 56 nodes "changed" vs 1 real change) +
the zero-setup `uv tool install reagraph && reagraph demo` + a GIF placeholder
(record with examples/demo.tape). The feature list stays, below the pitch.
- .github/actions/reagraph-diff/ (composite action): diffs two build graphs with
the byte-agnostic diff, writes a Markdown summary, and posts/updates a PR comment
(stable marker, no dupes); outputs the real changed-count. Inputs base/head/by/
comment/reagraph-version.
- .github/workflows/release-diff.yml: example consumer (copy into your repo) that
diffs two builds on release; the in-repo default runs green against the committed
real-REA fixtures, with the live "pull from REA in CI" pattern shown commented.
- docs/GITHUB_ACTION.md: usage, both modes (pre-exported graphs vs live pull),
inputs/outputs, PR-comment behavior.
- README "## Diff your releases in CI" section links it: "a bot comment on every
release — the real change, not the thousands of phantom ones."
Validated: the exact `reagraph diff` the action runs exits 0 on the fixtures
(+4 nodes added / 2 rewired on the added-module build); all workflow YAML parses.
Co-Authored-By: Claude Opus 4.8 <[email protected]>
