Skip to content

Fix monthly-updates PDF failure and the API map/references mirror push - #24

Merged
jstoobysmith merged 3 commits into
Kernel-Science:mainfrom
Alex-Zughaid:fix/monthly-pdf-glyphs-and-mirror
Sep 18, 2026
Merged

jstoobysmith merged 3 commits into
Kernel-Science:mainfrom
Alex-Zughaid:fix/monthly-pdf-glyphs-and-mirror

Conversation

@Alex-Zughaid

Copy link
Copy Markdown
Contributor

Summary

Three fixes to the scheduled data-generation workflows, found while checking why the live site's monthly updates / API map / references pages looked stale:

  • Generate monthly update was failing outright. The 2026-09-01 run for August errored in assertGlyphsCovered: three Unicode math glyphs used in that month's Lean sources aren't in MISSING_GLYPH_MATH (⋆ U+22C6, 𝐚 U+1D41A, 𝐍 U+1D40D), so XeLaTeX would've silently dropped them from the PDF. Added the three mappings, following the existing conventions in that table.
  • Generate API map and Generate monthly update were pushing to main fine but failing on the mirror step, every run since at least 2026-08-24. mirror-to-personal.yml keeps Gabrielebattimelli/Physlib-Website (the repo Vercel actually deploys) in sync by rewriting commit authorship and force-pushing. The plain git push mirror these two workflows also do — needed because GITHUB_TOKEN pushes don't trigger mirror-to-personal.yml — was therefore rejected as non-fast-forward every time, so these updates reached main but never the deployed site. Added --force, matching what mirror-to-personal.yml already does to that same mirror.
  • References.json (added in Add references page #23) had no workflow generating it at all. Unlike the API map and monthly updates, it was only ever generated once, for that PR. Added references.yml, a weekly scheduled workflow mirroring api-map.yml's structure exactly (generate-references.js needs no extra npm deps, so it skips the npm ci step).

Test plan

  • node --check on the edited generator script
  • YAML-parsed all three workflow files
  • After merge: re-dispatch Generate monthly update for 2026-08 to confirm the PDF now builds, and Generate API map to confirm the mirror push succeeds
  • After merge: let Generate references run once (dispatch or wait for Monday) and confirm References.json updates and reaches the mirror

🤖 Generated with Claude Code

Alex-Zughaid and others added 3 commits September 17, 2026 11:47
The 2026-09-01 scheduled run failed because the August Lean sources use
three Unicode math glyphs XeLaTeX/DejaVu Sans Mono can't render and that
aren't in MISSING_GLYPH_MATH: ⋆ (U+22C6), 𝐚 (U+1D41A), 𝐍 (U+1D40D).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
mirror-to-personal.yml keeps Gabrielebattimelli/Physlib-Website in sync by
rewriting commit authorship (filter-branch) and force-pushing, so its
history is never a fast-forward descendant of this repo's real commits.
The plain `git push mirror` these two workflows also do (needed because
GITHUB_TOKEN pushes don't trigger mirror-to-personal.yml) has therefore
been rejected as non-fast-forward on every run since at least 2026-08-24,
so API map / monthly update commits reached main but never the deployed
site. The mirror is a deploy artifact, not shared history, so force is
correct here too.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
References.json (added in PR Kernel-Science#23) had no workflow running it, unlike
APIMap.json and the monthly updates: it was generated once for that PR
and had no path to staying current. Add a weekly scheduled workflow
that mirrors api-map.yml: run the generator, commit if changed, and
push to the Vercel mirror.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
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.

2 participants