Merge branch 'main' into add-gjf

.github/PULL_REQUEST_TEMPLATE.md

@@ -13,6 +13,7 @@ Don't reference an issue in the PR title because GitHub does not support auto-li
 - [x] done; [ ] not done / not applicable
 -->
 
+- [x] I own the copyright of the code submitted and I licence it under the [MIT license](https://github.com/JabRef/jabref/blob/main/LICENSE)
 - [ ] Change in `CHANGELOG.md` described in a way that is understandable for the average user (if applicable)
 - [ ] Tests created for changes (if applicable)
 - [ ] Manually tested changed features in running JabRef (always required)

.github/workflows/assign-issue.yml

@@ -0,0 +1,34 @@
+name: Assign Issue
+
+on:
+  schedule:
+    - cron: 0 0 * * *
+  issue_comment:
+    types: [created]
+  workflow_dispatch:
+
+jobs:
+  assign:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Assign the user or unassign stale assignments
+        uses: takanome-dev/[email protected]
+        with:
+          github_token: '${{ secrets.GITHUB_TOKEN }}'
+          days_until_unassign: 30
+          assigned_comment: |
+            👋 Hey @{{ comment.user.login }},
+
+            Thanks for your interest in this issue! 🎉
+
+            Newcomers, we're excited to have you on board. Start by exploring our [Contributing](https://github.com/JabRef/jabref/blob/main/CONTRIBUTING.md) guidelines, and don't forget to check out our [workspace setup guidelines](https://devdocs.jabref.org/getting-into-the-code/guidelines-for-setting-up-a-local-workspace) to get started smoothly.
+
+            In case you encounter failing tests during development, please check our [developer FAQs](https://devdocs.jabref.org/code-howtos/faq.html)!
+
+            Having any questions or issues? Feel free to ask here on GitHub. Need help setting up your local workspace? Join the conversation on [JabRef's Gitter chat](https://gitter.im/JabRef/jabref). And don't hesitate to open a (draft) pull request early on to show the direction it is heading towards. This way, you will receive valuable feedback.
+
+            ⚠ Note that this issue will become unassigned if it isn't closed within **{{ totalDays }} days**.
+
+            🔧 A maintainer can also add the **{{ inputs.pin_label }}** label to prevent it from being unassigned automatically.
+
+            Happy coding! 🚀

.github/workflows/check-links.yml

@@ -31,7 +31,7 @@ jobs:
           restore-keys: cache-lychee-
       - name: Link Checker
         id: lychee
-        uses: lycheeverse/lychee-action@v1.10.0
+        uses: lycheeverse/lychee-action@v2.0.2
         with:
           fail: true
           args: --accept '200,201,202,203,204,403,429,500' --max-concurrency 1 --cache --no-progress --exclude-all-private './**/*.md'

.github/workflows/cleanup-pr.yml

@@ -28,7 +28,7 @@ jobs:
           BUILDJABREFPRIVATEKEY: ${{ secrets.buildJabRefPrivateKey }}
       - name: Delete folder on builds.jabref.org
         if: steps.checksecrets.outputs.secretspresent == 'YES'
-        uses: appleboy/ssh-action@v1.0.3
+        uses: appleboy/ssh-action@v1.1.0
         with:
           script: rm -rf /var/www/builds.jabref.org/www/pull/${{ github.event.pull_request.number }} || true
           host: build-upload.jabref.org
@@ -37,7 +37,7 @@ jobs:
           key: ${{ secrets.buildJabRefPrivateKey }}
       - name: Update PR comment
         if: steps.checksecrets.outputs.secretspresent == 'YES'
-        uses: thollander/actions-comment-pull-request@v2
+        uses: thollander/actions-comment-pull-request@v3
         with:
           comment_tag: download-link
           message: The build for this PR is no longer available. Please visit <https://builds.jabref.org/main/> for the latest build.

.github/workflows/deployment.yml

@@ -287,7 +287,7 @@ jobs:
           BUILDJABREFPRIVATEKEY: ${{ secrets.buildJabRefPrivateKey }}
       - name: Comment PR
         if: (steps.checksecrets.outputs.secretspresent == 'YES')
-        uses: thollander/actions-comment-pull-request@v2
+        uses: thollander/actions-comment-pull-request@v3
         with:
           message: |
             The build of this PR is available at <https://builds.jabref.org/pull/${{ github.event.pull_request.number }}/merge>.

.github/workflows/on-labeled-issue.yml

@@ -0,0 +1,115 @@
+name: On labeled issue
+
+on:
+  issues:
+     types:
+       - labeled
+
+jobs:
+  FirstTimeCodeContribution:
+    if: ${{ github.event.label.name == 'FirstTimeCodeContribution' }}
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+    steps:
+    - name: GreetingFirstTimeCodeContribution
+      uses: peter-evans/create-or-update-comment@v4
+      with:
+        issue-number: ${{ github.event.issue.number || github.event.pull_request.number }}
+        body: |
+          Welcome to the vibrant world of open-source development with JabRef!
+
+          Newcomers, we're excited to have you on board. Start by exploring our [Contributing](https://github.com/JabRef/jabref/blob/main/CONTRIBUTING.md) guidelines, and don't forget to check out our [workspace setup guidelines](https://devdocs.jabref.org/getting-into-the-code/guidelines-for-setting-up-a-local-workspace) to get started smoothly.
+
+          In case you encounter failing tests during development, please check our [developer FAQs](https://devdocs.jabref.org/code-howtos/faq.html)!
+
+          Having any questions or issues? Feel free to ask here on GitHub. Need help setting up your local workspace? Join the conversation on [JabRef's Gitter chat](https://gitter.im/JabRef/jabref). And don't hesitate to open a (draft) pull request early on to show the direction it is heading towards. This way, you will receive valuable feedback.
+
+          ⚠ Note that this issue will become unassigned if it isn't closed within **30 days**.
+
+          🔧 A maintainer can also add the **`Pinned`** label to prevent it from being unassigned automatically.
+
+          Happy coding! 🚀
+    - name: Move Issue to "Assigned" Column in "Candidates for University Projects"
+      uses: m7kvqbe1/[email protected]
+      with:
+       github-token: ${{ secrets.GH_TOKEN_ACTION_MOVE_ISSUE }}
+       project-url: "https://github.com/orgs/JabRef/projects/3"
+       target-labels: "FirstTimeCodeContribution"
+       target-column: "Assigned"
+       ignored-columns: ""
+    - name: Move Issue to "Assigned" Column in "Good First Issues"
+      uses: m7kvqbe1/[email protected]
+      with:
+       github-token: ${{ secrets.GH_TOKEN_ACTION_MOVE_ISSUE }}
+       project-url: "https://github.com/orgs/JabRef/projects/5"
+       target-labels: "FirstTimeCodeContribution"
+       target-column: "Assigned"
+       ignored-columns: ""
+  Assigned:
+    name: "📍 Assigned"
+    if: ${{ github.event.label.name == '📍 Assigned' }}
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+    steps:
+    - name: Move Issue to "Assigned" Column in "Candidates for University Projects"
+      uses: m7kvqbe1/[email protected]
+      with:
+       github-token: ${{ secrets.GH_TOKEN_ACTION_MOVE_ISSUE }}
+       project-url: "https://github.com/orgs/JabRef/projects/3"
+       target-labels: "📍 Assigned"
+       target-column: "Assigned"
+       ignored-columns: ""
+    - name: Move Issue to "Assigned" Column in "Good First Issues"
+      uses: m7kvqbe1/[email protected]
+      with:
+       github-token: ${{ secrets.GH_TOKEN_ACTION_MOVE_ISSUE }}
+       project-url: "https://github.com/orgs/JabRef/projects/5"
+       target-labels: "📍 Assigned"
+       target-column: "Assigned"
+       ignored-columns: ""
+  good-first-issue:
+    name: "good first issue"
+    if: "${{ github.event.label.name == 'good first issue' }}"
+    runs-on: ubuntu-latest
+    steps:
+      - name: "good first issue"
+        env:
+          GH_TOKEN: ${{ secrets.GH_TOKEN_PROJECT_ITEM_ADD }}
+        run: |
+          ISSUE_URL=$(jq --raw-output .issue.html_url "$GITHUB_EVENT_PATH")
+          gh project item-add 5 --owner JabRef --url $ISSUE_URL
+  needs-refinement:
+    if: github.event.label.name == 'needs-refinement'
+    runs-on: ubuntu-latest
+    steps:
+      - name: needs-refinement
+        env:
+          GH_TOKEN: ${{ secrets.GH_TOKEN_PROJECT_ITEM_ADD }}
+        run: |
+          ISSUE_URL=$(jq --raw-output .issue.html_url "$GITHUB_EVENT_PATH")
+          gh project item-add 15 --owner JabRef --url $ISSUE_URL
+  status-freeze:
+    name: "status: freeze"
+    if: "${{ github.event.label.name == 'status: freeze' }}"
+    runs-on: ubuntu-latest
+    steps:
+      - name: "status: freeze"
+        env:
+          GH_TOKEN: ${{ secrets.GH_TOKEN_PROJECT_ITEM_ADD }}
+        run: |
+          ISSUE_URL=$(jq --raw-output .issue.html_url "$GITHUB_EVENT_PATH")
+          gh project item-add 9 --owner JabRef --url $ISSUE_URL
+  ui:
+    if: "${{ github.event.label.name == 'ui' }}"
+    runs-on: ubuntu-latest
+    steps:
+      - name: ui
+        env:
+          GH_DEBUG: api
+          GH_TOKEN: ${{ secrets.GH_TOKEN_PROJECT_ITEM_ADD }}
+        run: |
+          ISSUE_URL=$(jq --raw-output .issue.html_url "$GITHUB_EVENT_PATH")
+          echo $ISSUE_URL
+          gh project item-add 8 --owner JabRef --url $ISSUE_URL

.github/workflows/on-labeled-pr.yml

@@ -0,0 +1,23 @@
+name: On labeled PR
+
+on:
+  pull_request:
+     types:
+       - labeled
+
+jobs:
+  automerge:
+    name: Auto Merge
+    if: "${{ github.event.label.name == 'automerge' }}"
+    runs-on: ubuntu-latest
+    steps:
+      - name: Approve PR
+        run: gh pr review --approve "$PR_URL"
+        env:
+          PR_URL: ${{github.event.pull_request.html_url}}
+          GITHUB_TOKEN: ${{secrets.GH_TOKEN_JABREF_MACHINE_PR_APPROVE}}
+      - name: Merge PR
+        run: gh pr merge --auto --squash "$PR_URL"
+        env:
+          PR_URL: ${{github.event.pull_request.html_url}}
+          GITHUB_TOKEN: ${{secrets.GH_TOKEN_UPDATE_GRADLE_WRAPPER}}

.github/workflows/on-unlabeled-issue.yml

@@ -0,0 +1,32 @@
+name: On unlabeled issue
+
+on:
+  issues:
+     types:
+       - unlabeled
+
+jobs:
+  FirstTimeCodeContribution_or_Assigned:
+    if: ${{ (github.event.label.name == 'FirstTimeCodeContribution') || (github.event.label.name == '📍 Assigned') }}
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+    steps:
+    - name: Move Issue to "Free to take" Column in "Candidates for University Projects"
+      uses: m7kvqbe1/[email protected]
+      with:
+       github-token: ${{ secrets.GH_TOKEN_ACTION_MOVE_ISSUE }}
+       project-url: "https://github.com/orgs/JabRef/projects/3"
+       target-labels: "📍 Assigned"
+       target-column: "Assigned"
+       ignored-columns: ""
+       default-column: "Free to take"
+    - name: Move Issue to "Free to take" Column in "Good First Issues"
+      uses: m7kvqbe1/[email protected]
+      with:
+       github-token: ${{ secrets.GH_TOKEN_ACTION_MOVE_ISSUE }}
+       project-url: "https://github.com/orgs/JabRef/projects/5"
+       target-labels: "📍 Assigned"
+       target-column: "Assigned"
+       ignored-columns: ""
+       default-column: "Free to take"

.github/workflows/tests.yml

@@ -340,7 +340,7 @@ jobs:
           CODACY_PROJECT_TOKEN: ${{ secrets.CODACY_PROJECT_TOKEN }}
 
   requirements_coverage:
-    name: "Validate requiremenet coverage"
+    name: "Validate requirement coverage"
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4

.vscode/extensions.json

@@ -1,6 +1,6 @@
 {
     "recommendations": [
         "davidanson.vscode-markdownlint",
-        "valentjn.vscode-ltex"
+        "ltex-plus.vscode-ltex-plus"
     ]
 }