add stale-issues.yml workflow

Author: davorpa

.github/labels.yml

@@ -48,3 +48,12 @@
 - name: "📌 pinned"
   description: "Issues that are pinned currently"
   color: "0e8a16"
+
+#
+# stale-*.yml
+#
+
+- name: "keep"
+  description: "Requests exempt to be staled"
+  color: "0e8a16"
+

.github/workflows/stale-issues.yml

@@ -0,0 +1,113 @@
+name: Stale issues handler
+
+on:
+  push:                                      # when push this files to branches....
+    branches:
+      - 'main'
+    paths:
+      - '.github/workflows/stale-issues.yml' #  - this workflow
+  workflow_dispatch:                         # manually
+  schedule:                                  # or
+    - cron: "0 0,6,12,18 * * *"              # every 6 hour at o'clock
+
+permissions:
+  # no checkouts needed
+  contents: none
+  # needs issue labels and comments CRUD management
+  issues: write
+
+# This allows a subsequently queued workflow run to interrupt/wait for previous runs
+concurrency:
+  group: '${{ github.workflow }}'
+  cancel-in-progress: false  # true: interrupt, false = wait for
+
+jobs:
+  stale:
+    name: Stale issues
+    runs-on: ubuntu-latest
+    outputs:
+      staled: ${{ steps.set-staled.outputs.numbers }}
+      closed: ${{ steps.set-closed.outputs.numbers }}
+    steps:
+      - uses: actions/stale@v5
+        id: stale
+        with:
+          operations-per-run: 30
+          days-before-stale: 1
+          days-before-close: 1
+          days-before-pr-stale: -1
+          days-before-pr-close: -1
+          stale-issue-label: "stale"
+          close-issue-label: "stale: closed"
+          stale-issue-message: |
+            This issue has been automatically marked as stale because it has not had recent activity during last 60 days :sleeping:
+
+            It will be closed in 15 days if no further activity occurs. To unstale this issue, add a comment with a detailed explanation.
+
+            There can be many reasons why some specific issue has no activity. The most probable cause is lack of time, not lack of interest. This repository is a DavorpaTech's open source project not owned by a single for-profit company. It's a community-driven initiative ruled under open governance model.
+
+            Let us figure out together how to push this issue forward. Connect with us through one of many communication channels we established here.
+
+            Thank you for your patience :heart:
+          close-issue-message: |
+            This issue has been automatically closed because it has been inactive during the last 15 days since being marked as stale.
+
+            Anyway, thank you for your interest of contributing :heart:
+          close-issue-reason: not_planned
+          exempt-issue-labels: "blocked,must,should,keep,📌 pinned"
+          remove-issue-stale-when-updated: true
+      - name: Set staled numbers
+        id: set-staled
+        run: |
+          echo $INPUT_JSON  \
+            | jq --compact-output '[.[] | .number]'  \
+            | sed -e 's/^/::set-output name=numbers::/'
+        env:
+          INPUT_JSON: ${{ steps.stale.outputs.staled-issues-prs }}
+      - name: Set closed numbers
+        id: set-closed
+        run: |
+          echo $INPUT_JSON  \
+            | jq --compact-output '[.[] | .number]'  \
+            | sed -e 's/^/::set-output name=numbers::/'
+        env:
+          INPUT_JSON: ${{ steps.stale.outputs.closed-issues-prs }}
+
+      - name: Write GitHub job summary
+        run: |
+          echo "### Staled"  \
+            >> $GITHUB_STEP_SUMMARY
+          echo "$STALED"  \
+            | jq --raw-output 'map("* [#\(.)](\(env.GITHUB_PUBLIC_URL)/\(.))") | join("\n")'  \
+            >> $GITHUB_STEP_SUMMARY
+
+          echo "### Closed"  \
+            >> $GITHUB_STEP_SUMMARY
+          echo "$CLOSED"  \
+            | jq --raw-output 'map("* [#\(.)](\(env.GITHUB_PUBLIC_URL)/\(.))") | join("\n")'  \
+            >> $GITHUB_STEP_SUMMARY
+        env:
+          GITHUB_PUBLIC_URL: ${{ format('{0}/{1}/issues', github.server_url, github.repository) }}
+          STALED: ${{ steps.set-staled.outputs.numbers }}
+          CLOSED: ${{ steps.set-closed.outputs.numbers }}
+
+  on-close-label-cleanup:
+    name: "Clean labels on close #${{ matrix.value }}"
+    if: ${{ fromJSON(needs.stale.outputs.closed).length > 0 }}
+    needs: [stale]
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        value: ${{ fromJSON(needs.stale.outputs.closed) }}
+      max-parallel: 10    # max number of spawned jobs that can be in progress
+      fail-fast:    false # don't cancel other spawned matrix jobs
+    steps:
+      - name: Remove stale labels
+        uses: actions-ecosystem/action-remove-labels@v1
+        with:
+          repo:   ${{ github.repository }}
+          number: ${{ matrix.value }}
+          labels: |
+            stale
+
+