Problem
The wiki records repeated submodule drift: builds/runs can silently use the wrong GEOS-Chem, HEMCO, or Cloud-J branch/commit. This made resolved BrC AOD/Cloud-J issues appear unresolved and makes run provenance hard to audit.
Current known BrC branches
- GEOS-Chem: max/brc for chemistry baseline; max/online_AOD for separate AOD bins; max/brc-pbrcpoa-omoc for PBRCPOA split review
- HEMCO: max/brc for BrC GFED species; max/injection_height for injection-height runs; max/brc-pbrcpoa-omoc for PBRCPOA split review
- Cloud-J: max/brc-array-dims for BrC Cloud-J array dimensions
Needed
- Decide which branch/commit combination is the canonical build for each run family.
- Commit superproject gitlinks for those canonical combinations.
- Document a quick pre-build check in the run workflow.
- Avoid relying on dirty/manual submodule checkouts for production runs.
Acceptance criteria
- Fresh clone + git submodule update lands on the intended BrC-compatible submodule commits.
- Build properties/run notes identify the exact superproject and submodule SHAs.
- No production run relies on a locally drifted submodule state.
Problem
The wiki records repeated submodule drift: builds/runs can silently use the wrong GEOS-Chem, HEMCO, or Cloud-J branch/commit. This made resolved BrC AOD/Cloud-J issues appear unresolved and makes run provenance hard to audit.
Current known BrC branches
Needed
Acceptance criteria