ci(deb): restrict APT publish to v* release tags

Previously the workflow built and published on every push to master
and feature/debian-packaging in addition to v* tags. That meant the
gh-pages APT repo got overwritten on every commit with same-version
.debs, causing apt clients to see a phantom "update available" each
time and burning ~5-10 min of cross-compile CI per merge.

After this change:
  - PRs into master still cross-build .debs as a sanity check.
  - v* tags build, publish to gh-pages, and create a GitHub release.
  - workflow_dispatch remains as the manual escape hatch.
  - master pushes no longer trigger this workflow (ci.yml still runs).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

.github/workflows/build-deb.yml

@@ -1,10 +1,10 @@
 name: Build Debian Packages
 
 on:
+  # APT publishing is release-driven: we build + publish only on `v*` tag
+  # pushes. PRs into master still build the .debs as a sanity check (no
+  # publish). Manual dispatch is kept as an escape hatch.
   push:
-    branches:
-      - master
-      - feature/debian-packaging
     tags:
       - "v*"
   pull_request:
@@ -231,7 +231,9 @@ jobs:
     name: Publish to APT Repository
     needs: combine-artifacts
     runs-on: ubuntu-latest
-    if: github.ref == 'refs/heads/master' || startsWith(github.ref, 'refs/tags/v')
+    # Publish only on `v*` release tags — keep gh-pages stable between
+    # releases instead of overwriting same-version .debs on every commit.
+    if: startsWith(github.ref, 'refs/tags/v')
     permissions:
       contents: write
     steps:
@@ -340,16 +342,18 @@ jobs:
           GPG_PASSPHRASE: ${{ secrets.GPG_PASSPHRASE }}
         run: |
           if [ -n "$GPG_PASSPHRASE" ]; then
-            echo "$GPG_PASSPHRASE" | gpg --batch --yes --passphrase-fd 0 \
+            echo "$GPG_PASSPHRASE" | gpg --batch --yes --no-tty --pinentry-mode loopback --passphrase-fd 0 \
               --default-key "$GPG_KEY_ID" \
               -abs -o dists/stable/Release.gpg dists/stable/Release
-            echo "$GPG_PASSPHRASE" | gpg --batch --yes --passphrase-fd 0 \
+            echo "$GPG_PASSPHRASE" | gpg --batch --yes --no-tty --pinentry-mode loopback --passphrase-fd 0 \
               --default-key "$GPG_KEY_ID" \
               --clearsign -o dists/stable/InRelease dists/stable/Release
           else
-            gpg --batch --yes --default-key "$GPG_KEY_ID" \
+            gpg --batch --yes --no-tty --pinentry-mode loopback \
+              --default-key "$GPG_KEY_ID" \
               -abs -o dists/stable/Release.gpg dists/stable/Release
-            gpg --batch --yes --default-key "$GPG_KEY_ID" \
+            gpg --batch --yes --no-tty --pinentry-mode loopback \
+              --default-key "$GPG_KEY_ID" \
               --clearsign -o dists/stable/InRelease dists/stable/Release
           fi
           gpg --armor --export "$GPG_KEY_ID" > KEY.gpg

socktop_agent/debian/postinst

@@ -29,27 +29,27 @@ cat <<EOF
 ┌─────────────────────────────────────────────────────────────────────┐
 │ socktop-agent has been installed successfully!                      │
 ├─────────────────────────────────────────────────────────────────────┤
-│                                                                     │
+│                                                                      │
-│ The systemd service has been installed but is NOT enabled by       │
+│ The systemd service has been installed but is NOT enabled by        │
-│ default. To enable and start the service:                          │
+│ default. To enable and start the service:                           │
-│                                                                     │
+│                                                                      │
-│   sudo systemctl enable --now socktop-agent                        │
+│   sudo systemctl enable --now socktop-agent                         │
-│                                                                     │
+│                                                                      │
-│ To start without enabling on boot:                                 │
+│ To start without enabling on boot:                                  │
-│                                                                     │
+│                                                                      │
-│   sudo systemctl start socktop-agent                               │
+│   sudo systemctl start socktop-agent                                │
-│                                                                     │
+│                                                                      │
-│ To check service status:                                           │
+│ To check service status:                                            │
-│                                                                     │
+│                                                                      │
-│   sudo systemctl status socktop-agent                              │
+│   sudo systemctl status socktop-agent                               │
-│                                                                     │
+│                                                                      │
-│ Default settings:                                                  │
+│ Default settings:                                                   │
-│   - Port: 3000 (use -p or --port to change)                       │
+│   - Port: 3000 (use -p or --port to change)                        │
-│   - SSL/TLS: disabled (use --enableSSL to enable)                 │
+│   - SSL/TLS: disabled (use --enableSSL to enable)                  │
-│                                                                     │
+│                                                                      │
-│ For more information, see:                                         │
+│ For more information, see:                                          │
-│   /usr/share/doc/socktop_agent/README.md                           │
+│   /usr/share/doc/socktop_agent/README.md                            │
-│                                                                     │
+│                                                                      │
 └─────────────────────────────────────────────────────────────────────┘
 
 EOF