CI: back on the stable crafter-build Flatpak, now that 2.2.0 carries the Shader API

Crafter.Build 2.2.0 (2026-10-16) releases the Shader `defines` and
`variant` fields Crafter.Graphics master has used since 2026-10-06, so
CRAFTER_REF goes back to //stable and the toolchain moves only with a
Crafter.Build release again, the way imsd's package job has it. The
comments and the README now describe beta as the stopgap for the next
time Crafter.Graphics runs ahead of a release.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

.forgejo/workflows/deploy.yaml

@@ -26,12 +26,13 @@ jobs:
       # Which crafter-build. `stable` is the branch Crafter.Build publishes
       # from its release tags, `beta` follows every push to its master (the
       # same thing the rolling `latest` tarball this job used to download
-      # was). This site tracks Crafter.Graphics master, which since 2026-10-06
+      # was). Stable, like imsd: the toolchain then moves only with a
-      # uses the Shader `defines`/`variant` fields that only Crafter.Build
+      # Crafter.Build release. This site tracks Crafter.Graphics master, so a
-      # master has: the 2.1.0 release predates them by three days, and run
+      # Crafter.Graphics change that needs a newer Crafter.Build API fails
-      # 533 failed on exactly that. Flip to //stable once a Crafter.Build
+      # here until that API is released: run 533 (2026-10-12) did, on the
-      # release carries them. imsd pins stable; it has no Crafter.Graphics.
+      # Shader `defines`/`variant` fields that 2.1.0 predated; 2.2.0
-      CRAFTER_REF: net.catcrafts.CrafterBuild//beta
+      # (2026-10-16) carries them. Switching to //beta is the stopgap.
+      CRAFTER_REF: net.catcrafts.CrafterBuild//stable
     steps:
       - name: Check live payment test credentials
         # ShouldSettleEurcOnTestnet is a mandatory deploy gate, so a missing

deploy/README.md

@@ -1040,13 +1040,15 @@ sandbox, which is what CI's `crafter-run` wrapper does:
 
 Which branch of the Flatpak CI builds with is `CRAFTER_REF` at the top of
 `.forgejo/workflows/deploy.yaml`. `stable` is published from Crafter.Build's
-release tags, `beta` from every push to its master. The site tracks
+release tags, `beta` from every push to its master. CI is on `stable`, so the
-Crafter.Graphics master, and since 2026-10-06 that uses Shader fields that
+toolchain moves only with a Crafter.Build release. The site tracks
-only Crafter.Build master has, so CI is on `beta` until a release carries
+Crafter.Graphics master, so a Crafter.Graphics change that needs a newer
-them (`flatpak run --command=sh net.catcrafts.CrafterBuild//beta -c
+Crafter.Build API fails the deploy until that API is released (2026-10-12:
-'crafter-build --version'` prints which master commit a beta is). Note that
+the Shader fields 2.1.0 lacked, released in 2.2.0 four days later); `beta` is
-`flatpak install` of an already-installed ref is a no-op even when the remote
+the stopgap, and `crafter-build --version` inside it prints which master
-has moved on; `flatpak update` is what moves it, and the workflow runs both.
+commit it is. Note that `flatpak install` of an already-installed ref is a
+no-op even when the remote has moved on; `flatpak update` is what moves it,
+and the workflow runs both.
 
 ### If a `bin/` glob matches two directories