Skip to content

Regenerate the documentation graphs on pull requests - #318

Merged
m-messer merged 2 commits into
docs/criteria-graph-imagesfrom
ci/regenerate-doc-graphs
Nov 3, 2026
Merged

m-messer merged 2 commits into
docs/criteria-graph-imagesfrom
ci/regenerate-doc-graphs

Conversation

@m-messer

@m-messer m-messer commented Nov 3, 2026 •

Copy link
Copy Markdown
Member

Stacked on the criteria and process graph images PR (base docs/criteria-graph-images).

Summary

Adds .github/workflows/doc-graphs.yml. On pull requests that change app/**, either generator script or the workflow itself, it installs graphviz and Node, runs scripts.generate_criteria_graphs and scripts.generate_process_graphs, and pushes a "Regenerate the documentation graphs" commit to the pull request's branch if any SVG changed.

Notes

  • The first run will likely commit every SVG: the graphviz and mermaid versions on Ubuntu differ from Homebrew's, so the output differs slightly. Later runs only commit when the graphs change.
  • Commits pushed with GITHUB_TOKEN don't trigger other workflows, so Test and Lint doesn't re-run on the bot's commit (and the workflow can't trigger itself). The main ruleset doesn't require status checks, so merging isn't blocked.
  • Pull requests from forks are skipped, since the workflow can't push to them.
  • A newer push to the same branch cancels a run in progress.
  • Regenerating on production deploys instead isn't possible: the main ruleset requires a pull request with no bypass, and the shared deploy workflow builds the commit the run started from.

🤖 Generated with Claude Code

Runs both graph generators on pull requests that change app/ or the
generator scripts, and commits the SVGs to the pull request's branch if
they changed. Pull requests from forks are skipped.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@m-messer
m-messer added this pull request to stack #319 November 3, 2026 13:46
@m-messer
m-messer merged commit 45f54a3 into main Nov 3, 2026
@m-messer
m-messer deleted the ci/regenerate-doc-graphs branch November 3, 2026 13:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant