From aff0216ec3dcc3f5a2c3fbd9ad509d5a7fb32eeb Mon Sep 17 00:00:00 2001
From: John Gee <john@ruru.gen.nz>
Date: Mon, 21 Sep 2026 12:03:53 +1200
Subject: [PATCH 1/5] Fix branch lookup for latest

- remove stale jsonp wrappers and go direct
- use vendor directory to avoid neeind sudo for local testing
- update ffi for testing on Mac
- fix stale git specification for json gem
---
 .bundle/config     |  2 ++
 .gitignore         |  2 +-
 Gemfile            |  5 ++++-
 Gemfile.lock       |  5 +++--
 _layouts/docs.html | 46 +++++++++++++++-------------------------------
 5 files changed, 25 insertions(+), 35 deletions(-)
 create mode 100644 .bundle/config

diff --git a/.bundle/config b/.bundle/config
new file mode 100644
index 0000000..2369228
--- /dev/null
+++ b/.bundle/config
@@ -0,0 +1,2 @@
+---
+BUNDLE_PATH: "vendor/bundle"
diff --git a/.gitignore b/.gitignore
index 9132cf4..0f607d1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -3,4 +3,4 @@ _site
 node_modules/
 tmp
 .jekyll-cache
-
+vendor/bundle/
diff --git a/Gemfile b/Gemfile
index 6047f7d..e180288 100644
--- a/Gemfile
+++ b/Gemfile
@@ -1,6 +1,9 @@
 source "http://rubygems.org"
 
-gem 'json', github: 'flori/json', branch: 'v1.8'
+gem 'json', git: 'https://github.com/ruby/json.git', branch: 'v1.8'
 gem 'jekyll', '4.0.1'
 gem 'jekyll-redirect-from'
 gem 'html-proofer'
+# pin ffi past 1.13.1: that version can't resolve size_t against modern Xcode CLT libffi headers
+# (capped below 1.16 since this project still runs on Ruby 2.6, which newer ffi releases dropped support for)
+gem 'ffi', '~> 1.15.5'
diff --git a/Gemfile.lock b/Gemfile.lock
index e43edec..a09b1ea 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -1,5 +1,5 @@
 GIT
-  remote: git://github.com/flori/json.git
+  remote: https://github.com/ruby/json.git
   revision: 7f4cfd853f2c919d854fb95548a19980feff17e8
   branch: v1.8
   specs:
@@ -18,7 +18,7 @@ GEM
     ethon (0.12.0)
       ffi (>= 1.3.0)
     eventmachine (1.2.7)
-    ffi (1.13.1)
+    ffi (1.15.5)
     forwardable-extended (2.6.0)
     html-proofer (3.15.3)
       addressable (~> 2.3)
@@ -90,6 +90,7 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
+  ffi (~> 1.15.5)
   html-proofer
   jekyll (= 4.0.1)
   jekyll-redirect-from
diff --git a/_layouts/docs.html b/_layouts/docs.html
index 1824d04..f816c46 100644
--- a/_layouts/docs.html
+++ b/_layouts/docs.html
@@ -28,40 +28,24 @@
 
     <!-- Initializer -->
     <script>
-      // use a service to wrap registry json in jsonp
-      var svcs = ['https://json2jsonp.com/', 'https://jsonp.afeld.me/']
-      var i = 0
-      var nextSvc = function () {
-        var svc = svcs[i++]
-        if (!svc) {
-          // no jsonp services worked, just use master
-          console.log('falling back to master branch :(')
-          return Flatdoc.run({
+      // registry.npmjs.org supports CORS, so we can fetch it directly
+      fetch('https://registry.npmjs.org/yargs')
+        .then(function (res) { return res.json() })
+        .then(function (data) {
+          var version = data['dist-tags'] && data['dist-tags'].latest
+          if (!version) throw new Error('no latest version found')
+          console.log('determined latest version as %s', version)
+          Flatdoc.run({
+            fetcher: Flatdoc.file('https://raw.githubusercontent.com/yargs/yargs/v' + version + '/docs/api.md')
+          })
+        })
+        .catch(function (err) {
+          // fall back to master branch if the registry lookup fails
+          console.log('falling back to master branch :(', err)
+          Flatdoc.run({
             fetcher: Flatdoc.github('yargs/yargs', 'docs/api.md')
           })
-        }
-        $.ajax(svc, {
-          data: {
-            url: 'https://registry.npmjs.org/yargs'
-          },
-          dataType: 'jsonp',
-          timeout: 2000,
-          jsonpCallback: svc.replace(/\W/g, ''),
-          success: function (data) {
-            var version = data['dist-tags'] && data['dist-tags'].latest
-            if (!version) return nextSvc()
-            console.log('determined latest version as %s via %s', version, svc)
-            Flatdoc.run({
-              fetcher: Flatdoc.file('https://raw.githubusercontent.com/yargs/yargs/v' + version + '/docs/api.md')
-            })
-          },
-          error: function () {
-            console.log('service failed: %s, trying next', svc)
-            nextSvc()
-          }
         })
-      }
-      nextSvc()
     </script>
   </head>
   <body role='flatdoc' class='no-literate'>

From 6501fbf1d4471395cf6b8fbc081da122401f1526 Mon Sep 17 00:00:00 2001
From: John Gee <john@ruru.gen.nz>
Date: Mon, 21 Sep 2026 12:14:42 +1200
Subject: [PATCH 2/5] Update to supported ubuntu for CI

---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 6af98ca..ea38abe 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -6,7 +6,7 @@ on:
 name: ci
 jobs:
   build:
-    runs-on: ubuntu-16.04
+    runs-on: ubuntu-latest
     strategy:
       matrix:
         ruby: [ '2.6' ]

From 6a13f00802da1b569388a169fbcb60f151837d42 Mon Sep 17 00:00:00 2001
From: John Gee <john@ruru.gen.nz>
Date: Mon, 21 Sep 2026 12:17:28 +1200
Subject: [PATCH 3/5] Update actions

---
 .github/workflows/ci.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index ea38abe..8c803a7 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -12,8 +12,8 @@ jobs:
         ruby: [ '2.6' ]
     name: Ruby ${{ matrix.ruby }} test
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-ruby@v1
+      - uses: actions/checkout@v9
+      - uses: actions/ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}
       - name: Build and test

From 2dd1e9ee6c6a67969cfecb2cb8418ec7b64e5dea Mon Sep 17 00:00:00 2001
From: John Gee <john@ruru.gen.nz>
Date: Mon, 21 Sep 2026 12:19:41 +1200
Subject: [PATCH 4/5] Fix action references

---
 .github/workflows/ci.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 8c803a7..437d84b 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -12,8 +12,8 @@ jobs:
         ruby: [ '2.6' ]
     name: Ruby ${{ matrix.ruby }} test
     steps:
-      - uses: actions/checkout@v9
-      - uses: actions/ruby/setup-ruby@v1
+      - uses: actions/checkout@v6
+      - uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby }}
       - name: Build and test

From 53903c82fffce40e8fd985f49282bbb9fdc51ad3 Mon Sep 17 00:00:00 2001
From: John Gee <john@ruru.gen.nz>
Date: Mon, 21 Sep 2026 12:25:10 +1200
Subject: [PATCH 5/5] Pin back bundler

---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 437d84b..58302df 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -18,7 +18,7 @@ jobs:
           ruby-version: ${{ matrix.ruby }}
       - name: Build and test
         run: |
-          gem install bundler
+          gem install bundler -v 2.4.22
           bundle install
           bundle exec jekyll build
           bundle exec htmlproofer ./_site --only-4xx --check-favicon --check-html