René's URL Explorer Experiment


Title: Open sync pull requests when a consumer's automation.yml drifts by akolson · Pull Request #97 · learningequality/.github · GitHub

Open Graph Title: Open sync pull requests when a consumer's automation.yml drifts by akolson · Pull Request #97 · learningequality/.github

X Title: Open sync pull requests when a consumer's automation.yml drifts by akolson · Pull Request #97 · learningequality/.github

Description: Summary Consumer repos hold a copied automation-template.yml, and nothing checks that the copies still match. A stale copy fails silently: the repo keeps running its old on: block, so a new automation never fires there, with no error and no log line. This adds a workflow that compares each consumer's copy against the template and opens one pull request per repo that differs, in the same shape dependabot uses. There is no accompanying issue, because the change is a byte copy of one file with nothing to author. The change scripts/sync-automation-template.js finds the consumers, compares each copy against the template, and opens or updates a pull request where they differ. A repo in sync gets nothing. A repo with a sync pull request already open gets it updated, never duplicated. .github/workflows/sync-automation-template.yml runs it weekly, on manual dispatch, and when automation-template.yml changes on main. Manual dispatch takes a dry_run input. A concurrency group stops two runs racing to open the same pull request. scripts/sync-automation-template.test.js covers the state machine with an injected client, and asserts the payloads that decide correctness: the write targets the sync branch, carries the template, and keeps the file sha on an update. docs/automation.md describes what the workflow opens, who merges it, and each state that needs a core maintainer. The consumers are discovered, not listed. The workflow walks the org's repos, skips archived ones and forks, and keeps every repo whose .github/workflows/automation.yml calls this repo's automation.yml. This repo's own reusable workflow sits at the same path and does not call it, so that marker excludes it without a special case. Each pull request targets the repo's default branch, which is the only branch GitHub evaluates workflow triggers from. The body is a short explanation of what changed and why the file is generated. kolibri-design-system is the exception: its check-description job fails unless the body carries a Changelog section whose Description is not the placeholder its own template ships with, and a plain explanation has no such section. For that repo the sync reads its template, keeps the Description and Changelog sections, and answers the Changelog fields. Their template opens by asking for unused sections to be removed, so the rest go rather than arriving unfilled. The template is read rather than stored, so it stays current as they change it. Drift is classified by content rather than by dates. The workflow reads the consumer's copy at whatever the last closed sync pull request left behind, its merge commit when merged and its head when closed unmerged. Matching the current template means nothing new has been published since, so the difference came from the consumer: a merged pull request means they reverted it, reported as toolchain-conflict, and a closed one means a maintainer declined it, reported as declined and left alone until the template moves again. Anything else means the template moved on, which is ordinary drift. Dates cannot answer this. A commit carries the date it was written rather than the date it reached main, and the commit that last touched automation-template.yml reads 2026-09-16 while it landed on 2026-09-21 with #88. A consumer merging a sync pull request inside such a window would be told the template had not changed since, and stop syncing. The workflow only proposes. It opens pull requests on a branch, never commits to a default branch, and never merges, approves, or enables auto-merge. Each consumer's own review rules gate the change. There is no bot pre-review. The copy either matches the template or it does not, and the script writes those bytes by construction, so there is no content question a reviewer could answer differently. What the core maintainer decides is whether to accept the file landing in their repo. References Refs #95. Follows #88, which introduced the template and the generator. Reviewer guidance A dry run against the live org finds the eight consumers and reports them all in sync. All eight pre-commit hooks pass, actionlint included, the generator reports no drift, and 68 tests pass. The write path has run end to end in a sandbox org, against real repositories through the real API, by pointing SYNC_ORG at it. Every state was produced there: would-open, opened, updated, declined, toolchain-conflict, and in-sync after a merge. Nothing has run against learningequality, where all eight are in sync and there is nothing to act on. Run GITHUB_TOKEN=$(gh auth token) node scripts/sync-automation-template.js --dry-run. Expect eight rows, all in-sync, and nothing needing attention. Check that the discovered base branches are each repo's default: develop for kolibri, kolibri-design-system and kolibri-data-portal, unstable for studio, release-v0.9.x for morango, and main for the rest. Check that the script never merges and never writes to a base branch. All writes target the automation-template-sync branch, and a test fails if that is changed to a default branch. Read the body kolibri-design-system would receive. Expect two sections, Description and Changelog, with every Changelog field answered. Its check-description job parses that Description field, and the value must not be the placeholder its template ships with. Check that a failure while reading any repo during discovery reports against that repo rather than ending the run. Discovery happens before the per-repo error handling, so it carries its own. To exercise the write path, point SYNC_ORG at a test org with a token scoped to its repos. Discovery only sees what the token can see, so the blast radius is set by the credential rather than by the code being correct. AI usage I used Claude Code to audit the drift across the consumers, to write the script, workflow and tests, and to draft this description. I directed the design decisions: pull requests rather than issues, the workflow doing the copy itself rather than delegating it to an agent, discovering the consumers rather than recording them here, handling kolibri-design-system as a named exception rather than generalising one repo's form into a rule, no bot pre-review on a change with nothing to judge, and human review as a hard constraint. I verified the dry run against the live org, ran the write path end to end in a sandbox org, confirmed the hooks and tests pass, and checked that the payload assertions fail when the write is pointed at a default branch.

Open Graph Description: Summary Consumer repos hold a copied automation-template.yml, and nothing checks that the copies still match. A stale copy fails silently: the repo keeps running its old on: block, so a new automat...

X Description: Summary Consumer repos hold a copied automation-template.yml, and nothing checks that the copies still match. A stale copy fails silently: the repo keeps running its old on: block, so a new automat...

Opengraph URL: https://github.com/learningequality/.github/pull/97

X: @github

direct link

Domain: github.com

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:ad5ac1d6-3c75-286d-1ed2-57ed8b48b8d7
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-id9C14:15DE5D:CFAD37:10F01AB:6AFFF731
html-safe-nonceb3f4886e71c835018f5e6cc224328e33c7034a1ea5af1194e33d00a0e84e42d9
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI5QzE0OjE1REU1RDpDRkFEMzc6MTBGMDFBQjo2QUZGRjczMSIsInZpc2l0b3JfaWQiOiI3MDUzMDAyMjA2NDQxNjMzNTg1IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=
visitor-hmac3ccb38f4469b06d6e766bb49f854dafe27320c096b35b503f4af5a93836435e0
hovercard-subject-tagpull_request:4594055633
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/learningequality/.github/pull/97/files
twitter:imagehttps://avatars.githubusercontent.com/u/5203639?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/5203639?s=400&v=4
og:image:altSummary Consumer repos hold a copied automation-template.yml, and nothing checks that the copies still match. A stale copy fails silently: the repo keeps running its old on: block, so a new automat...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None0a0d8686a27478df474dd7415776a7a080cde8838b3cd92ea7601187572e5729
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/learningequality/.github git https://github.com/learningequality/.github.git
octolytics-dimension-user_id3926525
octolytics-dimension-user_loginlearningequality
octolytics-dimension-repository_id647407699
octolytics-dimension-repository_nwolearningequality/.github
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id647407699
octolytics-dimension-repository_network_root_nwolearningequality/.github
turbo-body-classeslogged-out env-production page-responsive full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release16a11879678aaf97e2a42c33ee70830aa084fa37
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/learningequality/.github/pull/97/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Flearningequality%2F.github%2Fpull%2F97%2Ffiles
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Flearningequality%2F.github%2Fpull%2F97%2Ffiles
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=learningequality%2F.github
Reloadhttps://github.com/learningequality/.github/pull/97/files
Reloadhttps://github.com/learningequality/.github/pull/97/files
Reloadhttps://github.com/learningequality/.github/pull/97/files
learningequalityhttps://github.com/learningequality
.githubhttps://github.com/learningequality/.github
Codehttps://github.com/learningequality/.github
Issues10 (10)https://github.com/learningequality/.github/issues
Pull requests1 (1)https://github.com/learningequality/.github/pulls
Actionshttps://github.com/learningequality/.github/actions
Projectshttps://github.com/learningequality/.github/projects
Security and qualityhttps://github.com/learningequality/.github/security
Insightshttps://github.com/learningequality/.github/insights
Sign up for GitHub https://github.com/signup?return_to=%2Flearningequality%2F.github%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Flearningequality%2F.github%2Fissues%2Fnew%2Fchoose
akolsonhttps://github.com/akolson
mainhttps://github.com/learningequality/.github/tree/main
sync-automation-templatehttps://github.com/learningequality/.github/tree/sync-automation-template
Conversation 32 https://github.com/learningequality/.github/pull/97
Commits 18 https://github.com/learningequality/.github/pull/97/commits
Checks 42 https://github.com/learningequality/.github/pull/97/checks
Files changed https://github.com/learningequality/.github/pull/97/files
Please reload this pagehttps://github.com/learningequality/.github/pull/97/files
Open sync pull requests when a consumer's automation.yml drifts https://github.com/learningequality/.github/pull/97/files#top
Show all changes 18 commits https://github.com/learningequality/.github/pull/97/files
73db4e2 Open sync pull requests when a consumer's automation.yml drifts akolson Sep 21, 2026 https://github.com/learningequality/.github/pull/97/commits/73db4e2e93ee975d7abdf51774ed38746515879f
a4ebeda Request a pre-review from rtibblesbot on sync pull requests akolson Sep 21, 2026 https://github.com/learningequality/.github/pull/97/commits/a4ebeda97a19398a24585c7fe90128f49843478c
06b3ee1 Fix the sync state machine and cover it with tests akolson Sep 21, 2026 https://github.com/learningequality/.github/pull/97/commits/06b3ee1af0be88ce0d21de8b023342aca982a5a9
3a7e81d Fail toward drift when the template history cannot be read akolson Sep 21, 2026 https://github.com/learningequality/.github/pull/97/commits/3a7e81d3426ebb8c4a1ba7448e9bcb29ce1aa434
4cc6deb Say what the problem-state test guards against akolson Sep 21, 2026 https://github.com/learningequality/.github/pull/97/commits/4cc6deb293fbf21823887a3370a42f54d970ee96
ecf5a25 Let a consumer supply the whole sync pull request body akolson Sep 21, 2026 https://github.com/learningequality/.github/pull/97/commits/ecf5a25188b65398d41e15e496c46a504fe22122
f25c460 Drop the bot pre-review from sync pull requests akolson Sep 21, 2026 https://github.com/learningequality/.github/pull/97/commits/f25c4608578914c2f0f47e14ee39b3de3da22b42
91ad2c1 Correct what the sync states mean and what onboarding needs akolson Sep 23, 2026 https://github.com/learningequality/.github/pull/97/commits/91ad2c102cc616e81b13af0ed142ff2cad03d156
d4714c7 Name the bot app and tidy the sync section akolson Sep 23, 2026 https://github.com/learningequality/.github/pull/97/commits/d4714c7938a8dadaca0082c01e096b5885bba7c9
042cb6d Drop the redundant comment on the kolibri-design-system entry akolson Sep 23, 2026 https://github.com/learningequality/.github/pull/97/commits/042cb6d85aa60551738228cd71eb5d6f52ca754e
1df6628 Discover the consumers instead of listing them akolson Sep 23, 2026 https://github.com/learningequality/.github/pull/97/commits/1df6628d5d8220dc053dde95f8219f808f4eb6c6
82b1c72 Build the pull request body from the consumer's own template akolson Sep 23, 2026 https://github.com/learningequality/.github/pull/97/commits/82b1c72f93b49ce424f2fd301155d7e74512a05c
2a700c6 Treat kolibri-design-system as the one template exception akolson Sep 23, 2026 https://github.com/learningequality/.github/pull/97/commits/2a700c65612fe46f366ef440bbcc2de74b26dfe4
2638860 Move the marker comment to the filter that uses it akolson Sep 23, 2026 https://github.com/learningequality/.github/pull/97/commits/26388607c095aa302515af615e9d4fb734f6182d
c2f51ea Contain a thrown read during discovery, and trim the kolibri-design-s… akolson Sep 23, 2026 https://github.com/learningequality/.github/pull/97/commits/c2f51eafc5008657378cadf6cb0a67e62dda65c3
cfc4adc Keep the explanation when a kept heading is renamed akolson Sep 23, 2026 https://github.com/learningequality/.github/pull/97/commits/cfc4adcb08df33c16a0ed1499fd5135347d8e552
8c5d4e9 Let SYNC_ORG point the sync at another org akolson Sep 24, 2026 https://github.com/learningequality/.github/pull/97/commits/8c5d4e93b9e43f567903244f32e7d581267efd43
92e2dce Classify drift by content rather than by commit dates akolson Sep 24, 2026 https://github.com/learningequality/.github/pull/97/commits/92e2dceab1e52b2264b2ecf5dcf6c3f9888007eb
Clear filters https://github.com/learningequality/.github/pull/97/files
Please reload this pagehttps://github.com/learningequality/.github/pull/97/files
Please reload this pagehttps://github.com/learningequality/.github/pull/97/files
sync-automation-template.yml https://github.com/learningequality/.github/pull/97/files#diff-4b800d6cb30bd9215dca52be205101c535d43e798a0c8bd7d7d662a4fab23f04
automation.md https://github.com/learningequality/.github/pull/97/files#diff-51388c15be0d7fc1e715ab32873956ee166188dd267113833917bc6e4c501237
sync-automation-template.js https://github.com/learningequality/.github/pull/97/files#diff-fdc35d3aa6353ab225be8b24c2e117e7d28904ab7253a52b8025757b66026cf7
sync-automation-template.test.js https://github.com/learningequality/.github/pull/97/files#diff-9e7f9f60a3fc18e15c5b283ae6e1d1770a896f20b1132c6a2c207e454b909749
.github/workflows/sync-automation-template.ymlhttps://github.com/learningequality/.github/pull/97/files#diff-4b800d6cb30bd9215dca52be205101c535d43e798a0c8bd7d7d662a4fab23f04
View file https://github.com/learningequality/.github/blob/92e2dceab1e52b2264b2ecf5dcf6c3f9888007eb/.github/workflows/sync-automation-template.yml
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/learningequality/.github/pull/97/{{ revealButtonHref }}
rtibblesbothttps://github.com/rtibblesbot
Sep 21, 2026https://github.com/learningequality/.github/pull/97/files#r4064481563
Please reload this pagehttps://github.com/learningequality/.github/pull/97/files
Learn morehttps://docs.github.com/articles/managing-disruptive-comments/#hiding-a-comment
Please reload this pagehttps://github.com/learningequality/.github/pull/97/files
docs/automation.mdhttps://github.com/learningequality/.github/pull/97/files#diff-51388c15be0d7fc1e715ab32873956ee166188dd267113833917bc6e4c501237
View file https://github.com/learningequality/.github/blob/92e2dceab1e52b2264b2ecf5dcf6c3f9888007eb/docs/automation.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/learningequality/.github/pull/97/{{ revealButtonHref }}
https://github.com/learningequality/.github/pull/97/files#diff-51388c15be0d7fc1e715ab32873956ee166188dd267113833917bc6e4c501237
https://github.com/learningequality/.github/pull/97/files#diff-51388c15be0d7fc1e715ab32873956ee166188dd267113833917bc6e4c501237
Please reload this pagehttps://github.com/learningequality/.github/pull/97/files
Please reload this pagehttps://github.com/learningequality/.github/pull/97/files
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.