🎉 feat(ci): aggiungi versionamento semantico per shared-actions

- Aggiunto package.json con versione 1.0.0
- Nuovo workflow release.yml standalone: crea release Gitea su tag v*
- Aggiornamento automatico tag major floating (v1 → latest v1.x.x)
- Esempi aggiornati da @main a @v1 (tag major stabile)

Flusso di release:
  git tag v1.0.0 && git push origin v1.0.0
  → crea release Gitea con changelog
  → aggiorna tag floating v1

.gitea/workflows/release.yml

@@ -0,0 +1,86 @@
+name: Release
+
+# Workflow standalone — gira nel repo shared-actions stesso.
+# Trigger: git tag v* (es. v1.0.0, v1.1.0)
+#
+# Uso:
+#   git tag v1.0.0
+#   git push origin v1.0.0
+#
+# I consumer dei workflow riutilizzabili possono poi usare:
+#   uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/quality-gates.yml@v1.0.0
+# oppure il tag major floating (aggiornato ad ogni release):
+#   uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/quality-gates.yml@v1
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  create-release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: https://gitea.com/actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Generate changelog
+        id: changelog
+        env:
+          CURRENT_TAG: ${{ gitea.ref_name }}
+        run: |
+          PREV_TAG=$(git tag --sort=-version:refname | grep -v "^${CURRENT_TAG}$" | head -1)
+          if [ -z "$PREV_TAG" ]; then
+            git log --pretty=format:"- %s (%h)" > /tmp/changelog.txt
+          else
+            git log "${PREV_TAG}..${CURRENT_TAG}" --pretty=format:"- %s (%h)" > /tmp/changelog.txt
+          fi
+          echo "prev_tag=${PREV_TAG}" >> $GITHUB_OUTPUT
+
+      - name: Create Gitea release
+        env:
+          GITEA_TOKEN: ${{ gitea.token }}
+          SERVER_URL: ${{ gitea.server_url }}
+          REPOSITORY: ${{ gitea.repository }}
+          CURRENT_TAG: ${{ gitea.ref_name }}
+          PREV_TAG: ${{ steps.changelog.outputs.prev_tag }}
+        run: |
+          CHANGELOG=$(cat /tmp/changelog.txt)
+          if [ -n "$PREV_TAG" ]; then
+            COMPARE="**Full diff:** ${SERVER_URL}/${REPOSITORY}/compare/${PREV_TAG}...${CURRENT_TAG}"
+          else
+            COMPARE=""
+          fi
+          printf '## Changelog\n\n%s\n\n%s' "$CHANGELOG" "$COMPARE" > /tmp/body.md
+          curl -s -X POST \
+            -H "Content-Type: application/json" \
+            -H "Authorization: token $GITEA_TOKEN" \
+            "${SERVER_URL}/api/v1/repos/${REPOSITORY}/releases" \
+            -d "{
+              \"tag_name\": \"${CURRENT_TAG}\",
+              \"name\": \"${CURRENT_TAG}\",
+              \"body\": $(jq -Rs . /tmp/body.md),
+              \"draft\": false,
+              \"prerelease\": false
+            }"
+
+      - name: Update major version tag
+        env:
+          CURRENT_TAG: ${{ gitea.ref_name }}
+          GITEA_TOKEN: ${{ gitea.token }}
+          SERVER_URL: ${{ gitea.server_url }}
+          REPOSITORY: ${{ gitea.repository }}
+        run: |
+          MAJOR=$(echo "$CURRENT_TAG" | grep -oP '^v\d+')
+          SHA=$(git rev-parse HEAD)
+          # Elimina il tag major esistente e lo ricrea sul commit corrente
+          curl -s -X DELETE \
+            -H "Authorization: token $GITEA_TOKEN" \
+            "${SERVER_URL}/api/v1/repos/${REPOSITORY}/tags/${MAJOR}" || true
+          curl -s -X POST \
+            -H "Content-Type: application/json" \
+            -H "Authorization: token $GITEA_TOKEN" \
+            "${SERVER_URL}/api/v1/repos/${REPOSITORY}/tags" \
+            -d "{\"tag_name\": \"${MAJOR}\", \"target\": \"${SHA}\"}"

examples/capacitor/ci.yml

@@ -13,11 +13,11 @@ on:
 
 jobs:
   quality-gates:
-    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/quality-gates.yml@main
+    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/quality-gates.yml@v1
     secrets: inherit
 
   android-debug:
-    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/capacitor-android.yml@main
+    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/capacitor-android.yml@v1
     secrets: inherit
     with:
       build-type: debug

examples/capacitor/maintenance.yml

@@ -16,10 +16,10 @@ on:
 jobs:
   branch-cleanup:
     if: gitea.event_name == 'pull_request' && gitea.event.pull_request.merged == true
-    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/branch-cleanup.yml@main
+    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/branch-cleanup.yml@v1
     secrets: inherit
 
   dependency-check:
     if: gitea.event_name == 'schedule' || gitea.event_name == 'workflow_dispatch'
-    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/dependency-check.yml@main
+    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/dependency-check.yml@v1
     secrets: inherit

examples/capacitor/release.yml

@@ -30,19 +30,19 @@ on:
 
 jobs:
   android-apk:
-    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/capacitor-android.yml@main
+    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/capacitor-android.yml@v1
     secrets: inherit
     with:
       build-type: release
       output-format: apk
 
   android-aab:
-    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/capacitor-android.yml@main
+    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/capacitor-android.yml@v1
     secrets: inherit
     with:
       build-type: release
       output-format: aab
 
   gitea-release:
-    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/auto-release.yml@main
+    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/auto-release.yml@v1
     secrets: inherit

examples/libreria-npm/ci.yml

@@ -16,5 +16,5 @@ on:
 
 jobs:
   quality-gates:
-    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/quality-gates.yml@main
+    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/quality-gates.yml@v1
     secrets: inherit

examples/libreria-npm/maintenance.yml

@@ -13,10 +13,10 @@ on:
 jobs:
   branch-cleanup:
     if: gitea.event_name == 'pull_request' && gitea.event.pull_request.merged == true
-    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/branch-cleanup.yml@main
+    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/branch-cleanup.yml@v1
     secrets: inherit
 
   dependency-check:
     if: gitea.event_name == 'schedule' || gitea.event_name == 'workflow_dispatch'
-    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/dependency-check.yml@main
+    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/dependency-check.yml@v1
     secrets: inherit

examples/libreria-npm/release.yml

@@ -13,9 +13,9 @@ on:
 
 jobs:
   npm-publish:
-    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/npm-publish.yml@main
+    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/npm-publish.yml@v1
     secrets: inherit
 
   auto-release:
-    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/auto-release.yml@main
+    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/auto-release.yml@v1
     secrets: inherit

examples/microservizio/ci.yml

@@ -16,7 +16,7 @@ on:
 
 jobs:
   quality-gates:
-    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/quality-gates.yml@main
+    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/quality-gates.yml@v1
     secrets: inherit
     # with:
     #   node-version: '22.17'   # opzionale, default già impostato

examples/microservizio/maintenance.yml

@@ -13,10 +13,10 @@ on:
 jobs:
   branch-cleanup:
     if: gitea.event_name == 'pull_request' && gitea.event.pull_request.merged == true
-    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/branch-cleanup.yml@main
+    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/branch-cleanup.yml@v1
     secrets: inherit
 
   dependency-check:
     if: gitea.event_name == 'schedule' || gitea.event_name == 'workflow_dispatch'
-    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/dependency-check.yml@main
+    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/dependency-check.yml@v1
     secrets: inherit

examples/microservizio/release.yml

@@ -13,11 +13,11 @@ on:
 
 jobs:
   docker-release:
-    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/docker-release.yml@main
+    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/docker-release.yml@v1
     secrets: inherit
     with:
       runner: catthehacker-latest  # runner con Docker pre-installato
 
   auto-release:
-    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/auto-release.yml@main
+    uses: https://gitea.com/Punga78/shared-actions/.gitea/workflows/auto-release.yml@v1
     secrets: inherit

package.json

@@ -0,0 +1,6 @@
+{
+  "name": "shared-actions",
+  "version": "1.0.0",
+  "description": "Gitea Actions reusable workflows per @pzeta",
+  "private": true
+}