The merge gate asks whether Gaia contributed any stars, never how many. The TAP service truncates on its own timeout and still serves a well-formed CSV with a 200, ordered by magnitude — so a half answer is the bright half, which is the half HYG overlaps. Every gate passes: Gaia stars are present, HYG survivors go down rather than up, unmerged twins can only fall. The weekly job would publish a catalogue missing two hundred thousand stars and the runner would cache it for the weeks after. `fetchGaiaStars` now refuses fewer than 95% of the 412 765 rows its query holds, as its sibling query already did, and refuses an answer that fills the row limit. `fetchText` retried the request but not the body: a connection reset part-way through the 57 MB CSV rejected out of the loop, with no wait and no second attempt. The read now happens inside it. Also corrected: the merge gate's account of the HYG survivors (two thirds of them are stars Gaia measures but the main query never downloads, since Gaia puts them past the 250 pc cutoff), and the refresh workflow's comment on what happens when the archive is unreachable. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016jxMkwA2rbicdGxHosecYi
102 lines
4.5 KiB
YAML
102 lines
4.5 KiB
YAML
name: Refresh the catalogues
|
|
|
|
# Re-runs the ETL against the live archives on a schedule and republishes the site when the data
|
|
# actually changed, so the catalogues track NASA without anyone touching the code. The archives
|
|
# this reads — HYG, the Exoplanet Archive, JPL Horizons, OpenNGC, Gaia — are all anonymous
|
|
# public endpoints; no keys are involved.
|
|
on:
|
|
schedule:
|
|
# Mondays 05:23 UTC. An arbitrary minute rather than :00, which is the busiest minute on
|
|
# GitHub's cron fleet and the most likely to be delayed or dropped.
|
|
- cron: '23 5 * * 1'
|
|
workflow_dispatch:
|
|
|
|
# Never two refreshes at once, and never cancel one mid-push.
|
|
concurrency:
|
|
group: data-refresh
|
|
cancel-in-progress: false
|
|
|
|
permissions:
|
|
contents: write # push the regenerated catalogues to main
|
|
actions: write # dispatch the deploy and CI afterwards — see the final step
|
|
|
|
jobs:
|
|
refresh:
|
|
name: Fetch, gate, publish
|
|
runs-on: ubuntu-latest
|
|
timeout-minutes: 30
|
|
steps:
|
|
- uses: actions/checkout@v5
|
|
with:
|
|
# The data lives on main and the push below goes to main, whichever ref the workflow
|
|
# file itself ran from.
|
|
ref: main
|
|
|
|
- uses: actions/setup-node@v5
|
|
with:
|
|
node-version: 22
|
|
cache: npm
|
|
|
|
- run: npm ci
|
|
|
|
# Gaia DR3 is a frozen release: the same query returns the same bytes (a live re-fetch has
|
|
# reproduced stars.bin exactly), so its responses are carried from one run to the next
|
|
# rather than re-downloaded every week from an archive that times out under load. The key
|
|
# follows gaia.ts, where the queries are written, so a changed query is fetched afresh.
|
|
- uses: actions/cache@v4
|
|
with:
|
|
path: tools/etl/.cache/gaia-dr3-*.csv
|
|
key: gaia-dr3-${{ hashFiles('tools/etl/sources/gaia.ts') }}
|
|
|
|
# Every other source is fetched live on this fresh runner. A failed fetch fails the run by
|
|
# design — no refresh is better than a partial one. That includes Gaia on a cold cache, by
|
|
# two different paths: its Hipparcos cross-match is required, so an unreachable archive
|
|
# fails the run from fetchStars itself, while its main query is skipped when unreachable and
|
|
# the merge gate in build.ts then refuses a catalogue it contributed nothing to. An archive
|
|
# that answers short rather than not at all is caught in fetchGaiaStars.
|
|
- name: Rebuild the datasets
|
|
run: npm run etl
|
|
|
|
- name: Detect a real change
|
|
id: diff
|
|
run: |
|
|
if git diff --quiet -- src/assets/data; then
|
|
echo "changed=false" >> "$GITHUB_OUTPUT"
|
|
echo "The archives published nothing new — catalogues are byte-identical." >> "$GITHUB_STEP_SUMMARY"
|
|
else
|
|
echo "changed=true" >> "$GITHUB_OUTPUT"
|
|
{ echo "Catalogue changes:"; echo '```'; git diff --stat -- src/assets/data; echo '```'; } >> "$GITHUB_STEP_SUMMARY"
|
|
fi
|
|
|
|
# The same gates CI runs, run here instead: the push below is made with GITHUB_TOKEN, and
|
|
# GitHub deliberately fires no workflows for such pushes, so the data must be proven
|
|
# before it lands rather than checked after.
|
|
- name: Unit tests against the new data
|
|
if: steps.diff.outputs.changed == 'true'
|
|
run: npm test -- --no-watch
|
|
|
|
- name: Production build against the new data
|
|
if: steps.diff.outputs.changed == 'true'
|
|
run: npm run build
|
|
|
|
- name: Commit to main
|
|
if: steps.diff.outputs.changed == 'true'
|
|
run: |
|
|
git config user.name "github-actions[bot]"
|
|
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
|
|
git add src/assets/data
|
|
git commit -m "Refresh the astronomical catalogues" \
|
|
-m "Scheduled re-run of the ETL against the live archives. Gated on the unit suite and a production build in this same run, because a GITHUB_TOKEN push triggers no CI of its own."
|
|
git push origin HEAD:main
|
|
|
|
# The recursion guard that keeps the bot push from triggering `push` workflows also keeps
|
|
# it from deploying, so the deploy — and a visible CI record on the new commit — are
|
|
# dispatched explicitly. Dispatch does go through, unlike push events.
|
|
- name: Redeploy the site, and put checks on the commit
|
|
if: steps.diff.outputs.changed == 'true'
|
|
env:
|
|
GH_TOKEN: ${{ github.token }}
|
|
run: |
|
|
gh workflow run pages.yml --ref main
|
|
gh workflow run ci.yml --ref main
|