How waterloo-rocketry/universe works
This repository is a Waterloo Rocketry monorepo whose implemented product is tooling for managing area-specific GitHub Actions workflows. The workflow is: a user runs the CLI, which discovers nested workflows, checks their root copies and path scoping, then either validates or refreshes copies. The README also documents GitHub’s use of the root workflow directory. The source excerpt omits parts of the implementation, so the graph shows only relationships supported by the excerpt or README.
Main entry points: build_ci.py Run workflow · areas Area workflows · workflows Root workflows · __main__.py Build CI CLI
Components 11
CLI entry
- Build CI CLI
tools/build_ci/__main__.py - Run workflow
tools/build_ci/build_ci.py
Discovery and checks
- Area workflows
areas - Workflow discovery
tools/build_ci/build_ci.py - Path-scope check
tools/build_ci/build_ci.py
Workflow copies
- Copy status check
tools/build_ci/build_ci.py - Orphan copy check
tools/build_ci/build_ci.py - Copy refresh
tools/build_ci/build_ci.py - Root workflows
.github/workflows
Other components
- Repository maintainer
- GitHub Actions
Connections 14
- Repository maintainer → Build CI CLI: runs
README.md - Build CI CLI → Run workflow: calls main
tools/build_ci/__main__.py - Run workflow → Workflow discovery: discovers
tools/build_ci/build_ci.py - Workflow discovery → Area workflows: scans
tools/build_ci/build_ci.py - Run workflow → Copy status check: checks copies
tools/build_ci/build_ci.py - Copy status check → Area workflows: compares source
tools/build_ci/build_ci.py - Copy status check → Root workflows: checks copy
tools/build_ci/build_ci.py - Run workflow → Path-scope check: checks scope
tools/build_ci/build_ci.py - Path-scope check → Area workflows: reads triggers
tools/build_ci/build_ci.py - Run workflow → Orphan copy check: finds orphans
tools/build_ci/build_ci.py - Run workflow → Copy refresh: refreshes copies
tools/build_ci/build_ci.py - Copy refresh → Area workflows: copies from
tools/build_ci/build_ci.py - Copy refresh → Root workflows: writes to
tools/build_ci/build_ci.py - Root workflows → GitHub Actions: discovered by
README.md