docs(changelog): update changelog [skip ci]

Signed-off-by: Alexander Davis <alex@adcm.uk>

.gitea/workflows/changelog.yml

@@ -1,62 +0,0 @@
-name: Changelog
-
-on:
-  push:
-    branches: [ main ]
-    tags:
-      - "v*"
-  workflow_dispatch:
-
-jobs:
-  changelog:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout (full history + tags)
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      # Generates Keep a Changelog style CHANGELOG.md using git-cliff.
-      # IMPORTANT: The action downloads git-cliff from GitHub Releases, so we pass a GitHub PAT
-      # (stored as a Gitea secret) to avoid GitHub API 401/rate-limit issues.
-      - name: Generate CHANGELOG.md (Keep a Changelog)
-        uses: orhun/git-cliff-action@v4
-        with:
-          config: cliff.toml
-          args: --verbose
-          github_token: ${{ secrets.DC_GITHUB_PAT }}
-        env:
-          OUTPUT: CHANGELOG.md
-
-      # Commits and pushes CHANGELOG.md back to main using a Gitea PAT stored as CHANGELOG_PAT
-      - name: Commit and push if changed (Gitea PAT)
-        shell: bash
-        env:
-          CHANGELOG_PAT: ${{ secrets.CHANGELOG_PAT }}
-        run: |
-          set -e
-
-          if git diff --quiet -- CHANGELOG.md; then
-            echo "No changelog changes."
-            exit 0
-          fi
-
-          git config user.name "changelog-bot"
-          git config user.email "changelog-bot@users.noreply.local"
-
-          git add CHANGELOG.md
-          git commit -m "docs(changelog): update changelog [skip ci]"
-
-          origin_url="$(git remote get-url origin)"
-
-          # Convert SSH origin to HTTPS if needed (git@host:owner/repo.git -> https://host/owner/repo.git)
-          if echo "$origin_url" | grep -q "^git@"; then
-            host="$(echo "$origin_url" | sed -E 's#git@([^:]+):.*#\1#')"
-            path="$(echo "$origin_url" | sed -E 's#git@[^:]+:(.*)#\1#')"
-            origin_url="https://$host/$path"
-          fi
-
-          # Inject token into https:// URL (https://host/owner/repo.git -> https://oauth2:TOKEN@host/owner/repo.git)
-          authed_url="$(echo "$origin_url" | sed -E "s#^https://#https://oauth2:${CHANGELOG_PAT}@#")"
-
-          git push "$authed_url" HEAD:main

.gitea/workflows/release.yaml

@@ -1,4 +1,4 @@
-name: Release on main
+name: Changelog + Release on main
 
 on:
   push:
@@ -6,15 +6,26 @@ on:
   workflow_dispatch:
 
 jobs:
-  release:
+  changelog_and_release:
     runs-on: ubuntu-latest
+
     steps:
       - name: Checkout (full history + tags)
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
-      - name: Install git-cliff (no GitHub API)
+      - name: Stop if this is the bot changelog commit
+        shell: bash
+        run: |
+          set -e
+          msg="$(git log -1 --pretty=%B)"
+          echo "$msg" | tr -d '\r' | grep -qi "\[skip ci\]" && {
+            echo "Skipping (bot commit with [skip ci])"
+            exit 0
+          } || true
+
+      - name: Install git-cliff
         shell: bash
         run: |
           set -e
@@ -25,71 +36,140 @@ jobs:
           sudo install /tmp/git-cliff-*/git-cliff /usr/local/bin/git-cliff
           git-cliff --version
 
-      - name: Generate release notes (Keep a Changelog)
+      - name: Generate CHANGELOG.md (Keep a Changelog)
         shell: bash
         run: |
           set -e
-          # This generates a full changelog doc; we’ll use it as the release body.
+          git-cliff --config cliff.toml --output CHANGELOG.md
-          git-cliff --config cliff.toml --output RELEASE_NOTES.md
+          test -s CHANGELOG.md
 
-          # (Optional) Trim header if you only want entries (keep as-is if you prefer full text)
+      - name: Commit and push CHANGELOG.md if changed (CHANGELOG_PAT)
-          # For now we use the full generated content.
-          test -s RELEASE_NOTES.md
-
-      - name: Prepare tag + locate zip
-        shell: bash
-        run: |
-          set -e
-
-          # Your exported zip file in the repository
-          ZIP_PATH="Computing:Box Website.zip"
-          if [ ! -f "$ZIP_PATH" ]; then
-            echo "❌ Expected zip not found: $ZIP_PATH"
-            echo "Files in repo root:"
-            ls -la
-            exit 1
-          fi
-
-          # Create a unique tag for every commit to main
-          SHORT_SHA="$(git rev-parse --short HEAD)"
-          RUN_NO="${GITHUB_RUN_NUMBER:-0}"
-          TAG="v1.9-${RUN_NO}-${SHORT_SHA}"
-
-          echo "TAG=$TAG" >> $GITHUB_ENV
-          echo "ZIP_PATH=$ZIP_PATH" >> $GITHUB_ENV
-
-      - name: Create and push tag (uses RELEASE_PAT)
         shell: bash
         env:
-          RELEASE_PAT: ${{ secrets.CHANGELOG_PAT }}
+          CHANGELOG_PAT: ${{ secrets.CHANGELOG_PAT }}
         run: |
           set -e
 
-          # Tag the current commit
+          if git diff --quiet -- CHANGELOG.md; then
-          git tag -f "$TAG"
+            echo "No changelog changes."
+          else
+            git config user.name "changelog-bot"
+            git config user.email "changelog-bot@users.noreply.local"
+
+            git add CHANGELOG.md
+            git commit -m "docs(changelog): update changelog [skip ci]"
 
             origin_url="$(git remote get-url origin)"
 
-          # Convert SSH origin to HTTPS if needed (git@host:owner/repo -> https://host/owner/repo)
+            # Convert SSH origin to HTTPS if needed
             if echo "$origin_url" | grep -q "^git@"; then
               host="$(echo "$origin_url" | sed -E 's#git@([^:]+):.*#\1#')"
               path="$(echo "$origin_url" | sed -E 's#git@[^:]+:(.*)#\1#')"
               origin_url="https://$host/$path"
             fi
 
-          authed_url="$(echo "$origin_url" | sed -E "s#^https://#https://oauth2:${RELEASE_PAT}@#")"
+            authed_url="$(echo "$origin_url" | sed -E "s#^https://#https://oauth2:${CHANGELOG_PAT}@#")"
+            git push "$authed_url" HEAD:main
+          fi
 
-          # Push the tag
+      - name: Extract newest changelog section for release body
-          git push "$authed_url" "refs/tags/$TAG" --force
+        shell: bash
-
+        run: |
-      - name: Create release + upload asset to Gitea
+          set -e
+          # Extract the first "## ..." section (newest section) from CHANGELOG.md
+          # Includes the "## ..." heading and everything until the next "## ..." heading.
+          awk '
+            /^## / { if (seen) exit; seen=1 }
+            seen { print }
+          ' CHANGELOG.md > RELEASE_NOTES.md
+
+          # Clean trailing whitespace/newlines a bit
+          sed -i 's/[[:space:]]*$//' RELEASE_NOTES.md
+
+          test -s RELEASE_NOTES.md
+          echo "---- RELEASE_NOTES.md ----"
+          head -n 60 RELEASE_NOTES.md
+          echo "--------------------------"
+
+      - name: Create export zip (Computing:Box Website.zip)
+        shell: bash
+        run: |
+          set -e
+          if [ ! -d "export" ]; then
+            echo "❌ export/ folder not found in repo root"
+            ls -la
+            exit 1
+          fi
+
+          rm -f "Computing:Box Website.zip"
+          (cd export && zip -r "../Computing:Box Website.zip" .)
+          test -s "Computing:Box Website.zip"
+          ls -lh "Computing:Box Website.zip"
+
+      - name: Prepare YY.MM.DD letter-suffix tag + release name
         shell: bash
-        env:
-          RELEASE_PAT: ${{ secrets.CHANGELOG_PAT }}
         run: |
           set -e
 
-          # Derive base URL + owner/repo from origin
+          # Version: YY.MM.DD (UTC). Swap to `date +...` if you prefer UK-local runner time.
+          VERSION="$(date -u +'%y.%m.%d')"
+          PREFIX="v${VERSION}."
+
+          last_letter="$(
+            git tag --list "${PREFIX}[a-z]" \
+              | sed -E "s/^${PREFIX}([a-z])$/\1/" \
+              | sort \
+              | tail -n 1
+          )"
+
+          if [ -z "$last_letter" ]; then
+            next_letter="a"
+          else
+            if [ "$last_letter" = "z" ]; then
+              echo "❌ Already have v${VERSION}.z today. Refusing to create more than 26 releases/day."
+              exit 1
+            fi
+            next_letter="$(printf "%b" "$(printf '\\%03o' "$(( $(printf '%d' "'$last_letter") + 1 ))")")"
+          fi
+
+          TAG="${PREFIX}${next_letter}"
+          RELEASE_NAME="Computing:Box v${VERSION}.${next_letter}"
+
+          echo "TAG=$TAG" >> "$GITHUB_ENV"
+          echo "RELEASE_NAME=$RELEASE_NAME" >> "$GITHUB_ENV"
+          echo "ZIP_PATH=Computing:Box Website.zip" >> "$GITHUB_ENV"
+
+          echo "Using tag: $TAG"
+          echo "Release name: $RELEASE_NAME"
+
+      - name: Create and push tag (CHANGELOG_PAT)
+        shell: bash
+        env:
+          CHANGELOG_PAT: ${{ secrets.CHANGELOG_PAT }}
+        run: |
+          set -e
+
+          git tag -f "$TAG"
+
+          origin_url="$(git remote get-url origin)"
+
+          # Convert SSH origin to HTTPS if needed
+          if echo "$origin_url" | grep -q "^git@"; then
+            host="$(echo "$origin_url" | sed -E 's#git@([^:]+):.*#\1#')"
+            path="$(echo "$origin_url" | sed -E 's#git@[^:]+:(.*)#\1#')"
+            origin_url="https://$host/$path"
+          fi
+
+          authed_url="$(echo "$origin_url" | sed -E "s#^https://#https://oauth2:${CHANGELOG_PAT}@#")"
+          git push "$authed_url" "refs/tags/$TAG" --force
+
+      - name: Create Gitea release + upload asset (CHANGELOG_PAT)
+        shell: bash
+        env:
+          CHANGELOG_PAT: ${{ secrets.CHANGELOG_PAT }}
+        run: |
+          set -e
+
           origin_url="$(git remote get-url origin)"
           if echo "$origin_url" | grep -q "^git@"; then
             host="$(echo "$origin_url" | sed -E 's#git@([^:]+):.*#\1#')"
@@ -99,7 +179,6 @@ jobs:
 
           base="$(echo "$origin_url" | sed -E 's#(https?://[^/]+)/.*#\1#')"
           repo_path="$(echo "$origin_url" | sed -E 's#https?://[^/]+/##')"
-          # Remove trailing .git if present
           repo_path="$(echo "$repo_path" | sed -E 's/\.git$//')"
 
           owner="$(echo "$repo_path" | cut -d/ -f1)"
@@ -107,58 +186,50 @@ jobs:
 
           api="$base/api/v1"
 
-          # Build release body (escape as JSON safely)
+          python3 - <<'PY'
-          body_json="$(python3 - << 'PY'
+          import json, os
-import json
+          tag = os.environ["TAG"]
+          name = os.environ["RELEASE_NAME"]
+
           with open("RELEASE_NOTES.md", "r", encoding="utf-8") as f:
-    txt = f.read()
+              body = f.read()
-print(json.dumps(txt))
-PY
-)"
 
-          # Create release
+          payload = {
-          payload="$(python3 - << PY
+              "tag_name": tag,
-import json
-print(json.dumps({
-  "tag_name": "${TAG}",
               "target_commitish": "main",
-  "name": "${TAG}",
+              "name": name,
-  "body": json.loads(${body_json}),
+              "body": body,   # newest section only
               "draft": False,
-  "prerelease": False
+              "prerelease": False,
-}))
+          }
-PY
-)"
 
-          release_resp="$(curl -sS -X POST \
+          with open("release.json", "w", encoding="utf-8") as f:
-            -H "Authorization: token ${CHANGELOG_PAT}" \
+              json.dump(payload, f)
+          PY
+
+          curl -sS -X POST \
+            -H "Authorization: Bearer ${CHANGELOG_PAT}" \
             -H "Content-Type: application/json" \
             "${api}/repos/${owner}/${repo}/releases" \
-            -d "${payload}")"
+            --data-binary @release.json \
+            -o release_response.json
 
           release_id="$(python3 - <<'PY'
-import json,sys
+          import json
-data=json.loads(sys.stdin.read())
+          with open("release_response.json","r",encoding="utf-8") as f:
+              data=json.load(f)
           rid=data.get("id")
           if not rid:
-    print("NO_ID")
+              raise SystemExit("No release id returned. Response:\n" + json.dumps(data, indent=2))
-    print(json.dumps(data, indent=2))
-    sys.exit(1)
           print(rid)
           PY
-<<EOF
-$release_resp
-EOF
           )"
-
           echo "Created release id: $release_id"
 
-          # Upload asset (multipart/form-data)
-          # Use a filename that matches what you want users to see in the release.
           curl -sS -X POST \
-            -H "Authorization: token ${CHANGELOG_PAT}" \
+            -H "Authorization: Bearer ${CHANGELOG_PAT}" \
             "${api}/repos/${owner}/${repo}/releases/${release_id}/assets?name=Computing%3ABox%20Website.zip" \
             -F "attachment=@${ZIP_PATH}" \
             >/dev/null
 
-          echo "✅ Release created and asset uploaded: ${TAG}"
+          echo "✅ Release created: ${RELEASE_NAME} (tag: ${TAG}) with asset uploaded"

CHANGELOG.md

@@ -9,6 +9,40 @@ and this project adheres to [Conventional Commits](https://www.conventionalcommi
 
 
 
+### Documentation
+
+
+- update changelog [skip ci]
+
+
+## [main-29-c9402db] - 2025-12-26
+
+
+
+### Documentation
+
+
+- update changelog [skip ci]
+
+
+## [main-27-82654d9] - 2025-12-26
+
+
+
+### Documentation
+
+
+- update changelog [skip ci]
+
+- update changelog [skip ci]
+
+- update changelog [skip ci]
+
+
+## [v1.9] - 2025-12-26
+
+
+
 ### Added
 
 
@@ -46,6 +80,8 @@ and this project adheres to [Conventional Commits](https://www.conventionalcommi
 
 - v1.9
 
+- update changelog [skip ci]
+
 
 ### Reverted