feat: Auto-generate assets.json and enable direct asset URLs

- Add scripts/generate-assets.js to automatically generate assets.json
  from filesystem, extracting metadata, tags, and sizes from SVG files
- Add .github/workflows/update-assets.yml to regenerate assets.json
  when assets change and commit updates automatically
- Update .github/workflows/pages.yml to:
  - Copy assets to root directories (icons/, logos/, images/) during
    deployment for direct URL access (e.g., /icons/file.svg)
  - Add fallback to generate assets.json if missing
- Regenerate assets.json with updated script output

This enables:
- Direct asset access at shorter URLs (https://assets.awsug.nz/icons/file.svg)
- Automatic assets.json updates when new files are added
- No manual maintenance of assets.json required

Author: jajera

.github/workflows/pages.yml

@@ -23,6 +23,16 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+      - name: Setup Node.js (for fallback)
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - name: Generate assets.json if missing (fallback)
+        run: |
+          if [ ! -f "assets.json" ]; then
+            echo "assets.json missing, generating as fallback..."
+            node scripts/generate-assets.js || echo "Generation failed, continuing..."
+          fi
       - name: Create symlinks for direct access
         run: |
           mkdir -p icons logos images

.github/workflows/update-assets.yml

@@ -0,0 +1,43 @@
+name: Update Assets JSON
+
+on:
+  push:
+    branches: [ "main" ]
+    paths:
+      - 'assets/**'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  update-assets:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Generate assets.json
+        run: |
+          node scripts/generate-assets.js
+
+      - name: Commit and push if changed
+        run: |
+          git config --local user.email "action@github.com"
+          git config --local user.name "GitHub Action"
+          git add assets.json
+          if [ -n "$(git status --porcelain)" ]; then
+            git commit -m "Auto-update: Regenerate assets.json from filesystem"
+            git push
+            echo "ASSETS_UPDATED=true" >> $GITHUB_ENV
+          else
+            echo "No changes to assets.json"
+            echo "ASSETS_UPDATED=false" >> $GITHUB_ENV
+          fi