ci: purge stale Pages artifacts

Author: kevinten10

.github/workflows/deploy.yml

@@ -40,8 +40,11 @@ jobs:
       - name: "Create Hugo module directories for Docsy"
         run: node themes/docsy/tools/mkdirp-hugo-mod.js themes
 
+      - name: "Validate"
+        run: npm test
+
       - name: "Build"
-        run: hugo --gc --minify --destination docs
+        run: hugo --gc --minify --cleanDestinationDir --destination docs
 
       - name: "Deploy"
         uses: peaceiris/actions-gh-pages@v4

Makefile

@@ -20,11 +20,11 @@ dev-all:
 
 # Production build
 build:
-	HUGO_ENV="production" ./scripts/hugo.sh --gc --minify
+	HUGO_ENV="production" ./scripts/hugo.sh --gc --minify --cleanDestinationDir
 
 # Validate all pages without changing generated site files
 check:
-	node --test scripts/homepage-reveal.test.mjs
+	node --test scripts/*.test.mjs
 	HUGO_ENV="production" HUGO_READ_ONLY=1 ./scripts/hugo.sh --gc --minify --renderToMemory --noBuildLock
 
 # Clean build artifacts

scripts/site-build.test.mjs

@@ -0,0 +1,15 @@
+import assert from 'node:assert/strict';
+import { readFile } from 'node:fs/promises';
+import test from 'node:test';
+
+const makefile = await readFile(new URL('../Makefile', import.meta.url), 'utf8');
+const workflow = await readFile(new URL('../.github/workflows/deploy.yml', import.meta.url), 'utf8');
+
+test('production builds remove stale generated pages', () => {
+  assert.match(makefile, /^build:\n\t.*--cleanDestinationDir/m);
+  assert.match(workflow, /name: "Build"[\s\S]*?run: hugo .*--cleanDestinationDir/);
+});
+
+test('Pages deployment runs the project validation suite', () => {
+  assert.match(workflow, /name: "Validate"\n\s+run: npm test/);
+});