BGforge MLS reusable Actions

July 11, 2026 ยท View on GitHub

This directory publishes three composite GitHub Actions that run a @bgforge CLI over the files changed in an event and either commit the result back to the branch (save mode, default) or verify it without committing (check mode):

ActionCLIWhat it doesREADME
actions/binaryfgbinRefresh JSON snapshots alongside binary game databinary/README.md
actions/formatfgfmtFormat Fallout/WeiDU source files in placeformat/README.md
actions/transpilefgtpRegenerate transpiled output (.tssl/.tbaf/.td sources)transpile/README.md

Notes

All three actions share the same fork-PR guard (actions/_shared/guard-fork-pr.sh): it blocks a run whose event is pull_request or pull_request_target and whose head is a fork, since a base-scoped or read-only token cannot push to a fork's head branch, and running the CLI over fork-controlled files under pull_request_target is itself a risk. The guard runs only in save mode - it is skipped when check: true, since check mode never pushes and fork-PR check runs are each action's documented use case. See each action's own README for details.