Hash-pin every external reference in deploy.yml (closes #7)

deploy.yml was the last file in the repo carrying mutable external
references. Every image is now pinned by digest and every action by a
full 40-hex commit SHA, each with a version/date comment on the line
above. All values were resolved from upstream and verified to resolve.

- build container: klakegg/hugo:ext-alpine (abandoned since 2021,
  mutable tag) replaced by the exact alpine 3.21 digest the Dockerfile
  already pins, with script/bootstrap to install hugo and script/test
  to build. One pinned base and one dependency list now serve both the
  check build and the deploy build.
- deploy container: node:20 -> node@sha256:8f693eaa... (node 20.20.2,
  bookworm).
- actions/checkout: v4 -> 11bd7190... (v4.2.2), the same SHA check.yml
  pins, so the two workflows agree.
- actions/upload-artifact: v3 -> ea165f8d... (v4.6.2); v3 is deprecated.
- actions/download-artifact: v3 -> d3f86a10... (v4.3.0); v3 is
  deprecated.
- npm install -g wrangler -> wrangler@4.120.0, so the deploy no longer
  executes whatever the wrangler tag happens to point at.

Also drops the dead feat/initial-site push trigger (that branch is fully
merged into main) and reindents the file to 4-space YAML to match
check.yml and .editorconfig.

The two jobs are deliberately left separate so a deploy regression can
be attributed unambiguously.

Verified: make check and script/cibuild both green; the workflow parses
as YAML with the expected job/step structure. The Cloudflare Pages
deploy path itself cannot be exercised from a branch (it runs only on
push to main and needs CLOUDFLARE_API_TOKEN), so the deploy run on main
must be watched after merge.

.gitea/workflows/deploy.yml

@@ -1,52 +1,63 @@
 name: Build and Deploy to Cloudflare Pages
 
 on:
-  push:
+    push:
-    branches:
+        branches:
-      - feat/initial-site
+            - main
-      - main
 
 jobs:
-  build:
+    build:
-    runs-on: ubuntu-latest
+        runs-on: ubuntu-latest
-    container:
+        container:
-      image: klakegg/hugo:ext-alpine
+            # Same digest the Dockerfile pins: one pinned base image and one
-    steps:
+            # dependency list (script/bootstrap) for both the check build and
-      - name: Checkout
+            # the deploy build.
-        uses: actions/checkout@v4
+            # alpine 3.21, 2026-02-28
-        with:
+            image: alpine@sha256:c3f8e73fdb79deaebaa2037150150191b9dcbfba68b4a46d70103204c53f4709
-          submodules: recursive
+        steps:
+            # actions/checkout v4.2.2, 2026-08-09
+            - name: Checkout
+              uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
+              with:
+                  submodules: recursive
 
-      - name: Build site
+            - name: Install build dependencies
-        run: hugo --minify
+              run: script/bootstrap
 
-      - name: Archive site
+            - name: Build site
-        run: tar -czf site.tar.gz public
+              run: script/test
 
-      - name: Upload artifact
+            - name: Archive site
-        uses: actions/upload-artifact@v3
+              run: tar -czf site.tar.gz public
-        with:
-          name: site
-          path: site.tar.gz
 
-  deploy:
+            # actions/upload-artifact v4.6.2, 2026-08-09
-    runs-on: ubuntu-latest
+            - name: Upload artifact
-    needs: build
+              uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02
-    container:
+              with:
-      image: node:20
+                  name: site
-    steps:
+                  path: site.tar.gz
-      - name: Download artifact
-        uses: actions/download-artifact@v3
-        with:
-          name: site
 
-      - name: Extract site
+    deploy:
-        run: tar -xzf site.tar.gz
+        runs-on: ubuntu-latest
+        needs: build
+        container:
+            # node 20.20.2-bookworm, 2026-08-09
+            image: node@sha256:8f693eaa7e0a8e71560c9a82b55fd54c2ae920a2ba5d2cde28bac7d1c01c9ba5
+        steps:
+            # actions/download-artifact v4.3.0, 2026-08-09
+            - name: Download artifact
+              uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093
+              with:
+                  name: site
 
-      - name: Install Wrangler
+            - name: Extract site
-        run: npm install -g wrangler
+              run: tar -xzf site.tar.gz
 
-      - name: Deploy to Cloudflare Pages
+            # wrangler 4.120.0, 2026-08-09
-        run: wrangler pages deploy public --project-name=lora-vegas --branch=${{ github.ref_name }}
+            - name: Install Wrangler
-        env:
+              run: npm install -g wrangler@4.120.0
-          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+
+            - name: Deploy to Cloudflare Pages
+              run: wrangler pages deploy public --project-name=lora-vegas --branch=${{ github.ref_name }}
+              env:
+                  CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}

TODO.md

@@ -14,7 +14,8 @@ pre-1.0
 
 No git tags. The site is live and now has the scripts-to-rule-them-all scaffold
 (`Makefile`, `script/`, `Dockerfile`, `check.yml`); still missing `LICENSE` and
-policy files.
+policy files. Every external reference in the repo is now pinned by
+cryptographic hash (or, for the wrangler CLI install, an exact version).
 
 # Next Step
 
@@ -24,6 +25,15 @@ Update `README.md` accordingly.
 
 # Completed Steps
 
+- 2026-08-09: hash-pinned every external reference in
+  `.gitea/workflows/deploy.yml` (closes #7): both job container images are
+  pinned by digest, all three `uses:` are pinned by 40-hex commit SHA
+  (`upload`/`download-artifact` moved v3 to v4), and the wrangler install is
+  pinned to an exact version. The abandoned `klakegg/hugo:ext-alpine` image is
+  gone: the build job now runs on the same pinned `alpine` digest the
+  `Dockerfile` uses, with `script/bootstrap` then `script/test`. Also dropped
+  the dead `feat/initial-site` push trigger and reindented the file to 4-space
+  YAML to match `check.yml`
 - 2026-07-25: added the scripts-to-rule-them-all scaffold (closes #4): `script/`
   entrypoints, `Makefile` shims, a Hugo `Dockerfile` (sha256-pinned alpine) plus
   `.dockerignore` that runs `make check`, `.gitea/workflows/check.yml` running
@@ -40,9 +50,6 @@ Update `README.md` accordingly.
 
 # Future Steps
 
-- Pin the images and actions in `deploy.yml` by sha256
-  (`klakegg/hugo:ext-alpine`, `node:20`, `actions/checkout`,
-  `upload`/`download-artifact` are all unpinned)
 - Rework README.md into the standard sections: Description, Getting Started,
   Rationale, Design, TODO, License, Author (currently About, Contributing,
   Technical Details, License)