feat: add stale issue cleanup workflow (#50)

* feat: add stale issue cleanup workflow

- Introduced a GitHub Actions workflow to mark and close stale issues and pull requests.
- Configured to run on a schedule and manually via workflow dispatch.

docs: update README with new module descriptions and installation instructions

- Added new modules under Dock & Panel, Appearance, Behavior, and Privacy & Clipboard sections.
- Updated installation instructions to reflect changes in GNOME Shell version requirements.

style: update aurora-shell logo and improve UI elements

- Replaced the existing logo with a new design.
- Adjusted styles for dev tool buttons and panels for better consistency and appearance.

fix: remove disposed state tracking in Bluetooth device item

- Eliminated unnecessary disposed state tracking in BluetoothDeviceItemPatcher.
- Simplified update logic to avoid checks against disposed state.

refactor: enhance preferences UI with logo and website link

- Added a logo and a link to the project website in the preferences window.
- Improved layout and styling of the preferences section.

chore: update Portuguese translations

- Updated translation strings for various modules and preferences.
- Adjusted POT-Creation-Date for consistency.

* refactor: clean up workflows and improve notification handling in MeetingClock and WeatherClock modules

* refactor: update tooltip handling to use layoutManager's uiGroup

* refactor: streamline GNOME backport workflow and clarify contribution guidelines

* refactor: remove unused description timers and related logic in WeatherClock module

Author: leandromqrs

.github/workflows/gnome-backport.yml

@@ -2,18 +2,22 @@ name: GNOME Backport
 
 on:
   pull_request_target:
-    types: [opened, synchronize, reopened, labeled, closed]
+    types: [closed]
 
 permissions:
   contents: write
   issues: write
   pull-requests: write
 
+concurrency:
+  group: gnome-backport-${{ github.event.pull_request.number }}
+  cancel-in-progress: false
+
 jobs:
   backport:
     name: Create GNOME maintenance PR
     runs-on: ubuntu-latest
-    if: github.event.action != 'closed' || github.event.pull_request.merged == true
+    if: github.event.pull_request.merged == true && github.event.pull_request.base.ref == 'main'
     steps:
       - uses: actions/checkout@v4
         with:
@@ -47,6 +51,7 @@ jobs:
           export MAJOR
           BASE_BRANCH="release/v${MAJOR}.x"
           BACKPORT_BRANCH="backport/pr-${PR_NUMBER}-gnome-${MAJOR}"
+          BACKPORT_TITLE="${PR_TITLE//$'\n'/ } (GNOME ${MAJOR} backport)"
           ERROR_BODY="/tmp/backport-error.md"
 
           on_error() {
@@ -64,6 +69,7 @@ jobs:
           trap on_error ERR
 
           git fetch origin "+refs/heads/${BASE_BRANCH}:refs/remotes/origin/${BASE_BRANCH}"
+          git fetch origin "+refs/heads/${BACKPORT_BRANCH}:refs/remotes/origin/${BACKPORT_BRANCH}" || true
           git fetch origin "+refs/pull/${PR_NUMBER}/head:refs/remotes/origin/pr/${PR_NUMBER}/head"
           git checkout -B "$BACKPORT_BRANCH" "origin/${BASE_BRANCH}"
 
@@ -98,7 +104,8 @@ jobs:
             git commit -m "Bump version to ${NEXT_VERSION}"
           fi
 
-          git push --force-with-lease origin "$BACKPORT_BRANCH"
+          git fetch origin "+refs/heads/${BACKPORT_BRANCH}:refs/remotes/origin/${BACKPORT_BRANCH}" || true
+          git push --force-with-lease origin HEAD:"$BACKPORT_BRANCH"
 
           EXISTING_PR=$(gh pr list \
             --head "$BACKPORT_BRANCH" \
@@ -111,18 +118,20 @@ jobs:
           {
             echo "Backport of #${PR_NUMBER} to \`${BASE_BRANCH}\`."
             echo ""
+            echo "Original title: ${PR_TITLE}"
+            echo ""
             echo "This branch also bumps \`metadata.json\` to \`${NEXT_VERSION}\`."
           } > "$BODY"
 
           if [ -n "$EXISTING_PR" ]; then
             gh pr edit "$EXISTING_PR" \
-              --title "Backport #${PR_NUMBER} to GNOME ${MAJOR}" \
+              --title "$BACKPORT_TITLE" \
               --body-file "$BODY"
             echo "Updated backport PR #${EXISTING_PR}."
           else
             gh pr create \
               --base "$BASE_BRANCH" \
               --head "$BACKPORT_BRANCH" \
-              --title "Backport #${PR_NUMBER} to GNOME ${MAJOR}" \
+              --title "$BACKPORT_TITLE" \
               --body-file "$BODY"
           fi

.github/workflows/post-hygiene.yml

@@ -0,0 +1,38 @@
+name: Stale Cleanup
+
+on:
+  schedule:
+    - cron: '00 8 * * *'
+  workflow_dispatch:
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  mark-stale:
+    name: Mark and close stale posts
+    runs-on: ubuntu-latest
+    steps:
+      - name: Mark inactive posts as stale and close stale issues
+        uses: actions/stale@v10
+        with:
+          stale-issue-label: stale
+          stale-pr-label: stale
+          days-before-issue-stale: 45
+          days-before-issue-close: 14
+          days-before-pr-stale: 30
+          days-before-close: -1
+          days-before-pr-close: -1
+          close-issue-label: closed-as-stale
+          close-issue-reason: not_planned
+          remove-stale-when-updated: true
+          operations-per-run: 100
+          stale-issue-message: |
+            This issue has been marked as stale because it has not had recent activity. Add a comment or remove the `stale` label if it is still relevant.
+          close-issue-message: |
+            This issue has been closed because it stayed stale without further activity. Reopen it or file a new issue if it is still relevant.
+          stale-pr-message: |
+            This pull request has been marked as stale because it has not had recent activity. Update it, add a comment, or remove the `stale` label if it should stay active.
+          exempt-issue-labels: pinned,security,release-blocker
+          exempt-pr-labels: pinned,security,release-blocker

.github/workflows/stale-cleanup.yml

@@ -6,12 +6,15 @@
 
 ## Validation After Changes
 
-After **any** code change, always follow these rules to ensure quality while being efficient:
+After a change to code under `src/`, always follow these rules to ensure quality while being efficient.
+For documentation, workflow, metadata, translation, or other non-`src/` changes, do not run `just validate`
+or `just shexli` unless the task specifically requires that validation.
 
-1.  **Always run `just validate`** — type-checks the source, lints, and checks formatting. Fix any reported errors.
-2.  **Run targeted integration tests:**
+1.  **Run `just validate`** — type-checks the source, lints, and checks formatting. Fix any reported errors.
+2.  **Run `just shexli`** — packages the extension and runs the extensions.gnome.org static analyzer on the generated ZIP. Review every finding. Some `warning` or `manual_review` findings can be false positives or accepted GNOME-review tradeoffs, but they must be called out explicitly; fix any real regression before finishing.
+3.  **Run targeted integration tests:**
     *   If you modified only **one module**, run only the integration test for that module (e.g., `just test tests/shell/auroraTrayIcons.js`).
-    *   If you made **formatting-only changes** (Prettier) and have already passed the tests in a previous turn, you only need to run `just validate`.
+    *   If you made **formatting-only changes** (Prettier) and have already passed the tests in a previous turn, you only need to run `just validate` and `just shexli`.
     *   If you made **architectural or cross-cutting changes**, run `just toolbox test-all`.
 
 **IMPORTANT:** Never execute the `test` command (or `test-all`) chained with another command using `&&`. Always run it as a separate standalone turn.

AGENTS.md

@@ -152,7 +152,8 @@ Maintainers decide which fixes are worth backporting. Not every fix needs to lan
 ### Automated backports
 
 To request a maintenance backport, add a label such as `GNOME 50` to the original pull request.
-GitHub Actions creates or updates a separate backport PR targeting `release/v50.x`.
+After the original pull request is merged into `main`, GitHub Actions creates or updates a separate
+backport PR targeting `release/v50.x`.
 
 The backport branch is rebuilt from the target release branch, cherry-picks the original PR commits,
 and adds a final version bump commit. For example, if `metadata.json` on `release/v50.x` says

CONTRIBUTING.md

@@ -14,25 +14,46 @@ A modular GNOME Shell extension that adds quality-of-life features missing in va
 
 Aurora is split into independent modules, so you can enable only what you want.
 
+### Dock & Panel
+
 | Module | Description |
 |--------|-------------|
-| **No Overview** | Skips the overview on startup so you land directly on your desktop |
-| **Pip On Top** | Keeps Picture-in-Picture windows above other windows automatically |
-| **Theme Changer** | Keeps GNOME light/dark color scheme behavior consistent |
 | **Dock** | Replaces the stock dash with a smart per-monitor dock with intellihide and edge reveal |
 | **Volume Mixer** | Adds per-application volume sliders to Quick Settings with fast access to Sound Settings |
-| **XWayland Indicator** | Adds an indicator to the app activities in Ctrl + Tab to indicate where XWayland is running |
+| **Bluetooth Menu** | Shows battery level and animated icons in the Bluetooth Quick Settings panel |
 | **Weather Clock** | Shows GNOME Weather next to the panel clock |
 | **Meeting Clock** | Shows upcoming calendar events next to the panel clock and notifies when meetings are about to start |
 | **Tray Icons** | System tray in the panel that shows SNI app icons and GNOME background apps, with configurable icon limit, icon size, attention notifications, and smart SNI/background-app deduplication |
-| **DND on Screen Share** | Automatically enables Do Not Disturb mode when screen sharing or recording is active |
+
+### Appearance
+
+| Module | Description |
+|--------|-------------|
+| **Theme Changer** | Keeps GNOME light/dark color scheme behavior consistent |
 | **Icon Weave** | Automatically fixes missing app icons by matching untracked windows to their apps in-memory |
+| **App Search Tooltip** | Shows app names on hover in the overview search results |
+| **Auto Theme Switcher** | Automatically switches between light and dark theme based on time |
+
+### Behavior
+
+| Module | Description |
+|--------|-------------|
+| **No Overview** | Skips the overview on startup so you land directly on your desktop |
+| **Pip On Top** | Keeps Picture-in-Picture windows above other windows automatically |
+| **XWayland Indicator** | Adds an X11 badge to XWayland apps in the Alt+Tab switcher |
+
+### Privacy & Clipboard
+
+| Module | Description |
+|--------|-------------|
+| **Privacy** | Adds screen sharing privacy features, including automatic Do Not Disturb and panel content hiding |
+| **Clipboard History** | Adds searchable clipboard history with pinning and keyboard navigation |
 
 All modules can be toggled independently from the extension preferences.
 
 ## Requirements
 
-- GNOME Shell 45+
+- GNOME Shell 50+
 - [Node.js](https://nodejs.org/) 20+
 - [Yarn](https://yarnpkg.com/) 4+
 - [just](https://github.com/casey/just) (command runner)
@@ -49,21 +70,12 @@ The easiest way to install is from the official GNOME Extensions website.
 
 ### From command-line
 
-```bash
-git clone https://github.com/luminusOS/aurora-shell.git
-cd aurora-shell
-just install
-```
-
-## Testing
+Download the latest `aurora-shell@luminusos.github.io.shell-extension.zip` file from the
+[GitHub releases page](https://github.com/luminusOS/aurora-shell/releases), then install it:
 
 ```bash
-# Build, install, and run directly on the host
-just run
-
-# Build, install, and run inside a toolbox
-just toolbox create   # first time only
-just toolbox run
+gnome-extensions install --force aurora-shell@luminusos.github.io.shell-extension.zip
+gnome-extensions enable aurora-shell@luminusos.github.io
 ```
 
 ## Contributing