Add a Slackware updates tool and a restart script

updates.py compares the -current ChangeLog with the installed package
database: the newest batch holding an installed package is the last one
applied, everything newer is pending. The spoken summary gives counts,
security fixes and a kernel bump, never package lists; report=true writes
a full markdown recap and opens it in MD_EDITOR, detached.

restart.sh stops a running assistant and its quickshell overlay and
starts both again in their own session.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

1 files changed, 25 insertions, 1 deletions

diff --git a/AGENTS.md b/AGENTS.md
index 23fa55f..0cd301e 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -16,7 +16,8 @@ built-in settings. Examples in `examples/`. STT, LLM and TTS stay local;
 only the weather and search tools reach the network, and only when a
 question needs them. Spec: `docs/superpowers/specs/2026-09-26-tools-and-config-design.md`.
 
-Run: `python3 assistant.py` (`--test` for the self-check).
+Run: `python3 assistant.py` (`--test` for the self-check), or `./restart.sh`
+to replace a running one (and its overlay) detached from the terminal.
 
 ---
 
@@ -461,6 +462,29 @@ before tool rounds. The button loop is never blocked by a reply any more.
 - Unrelated but seen: whisper garbled "i Mille" into "i 1000.000e" and
   the model invented an answer for it instead of searching.
 
+### Slackware updates tool (2026-09-26)
+
+`updates` compares the -current ChangeLog (NFS mirror) with
+`/var/lib/pkgtools/packages`: the newest batch holding an entry whose exact
+package name is installed is the last one applied, everything newer is
+pending. Parses the 2.1 MB ChangeLog in ~95 ms, so no announcement.
+
+- Removed entries are left out of that check: a removed package is still
+  installed under its exact name and would mark the batch as applied.
+- A package bumped twice keeps the security flag of the older bump.
+- The first version listed every package (6.8k characters, 506 upgrades)
+  and the 2000-character cap cut it. The user does not want lists read
+  aloud: the summary gives counts, security fixes, the kernel bump and the
+  short new/removed lists, and tells the model to offer a written recap.
+  `report=true` writes `$XDG_RUNTIME_DIR/slackware-updates.md` and opens it
+  in `MD_EDITOR` (typora in the user's config), detached.
+- Live: counts, security fixes and "kernel 7.2.7" spoken, then it offered
+  the recap on its own; "si" opened it (2.2 s).
+- The overlay did not show after `restart.sh` started it together with the
+  assistant: quickshell's `Socket` never retries a failed connect. Fixed in
+  the quickshell repo (fresh `Socket` per retry), which also covers login,
+  where the overlay starts first.
+
 ### TTS (2026-09-25)
 
 `piper-tts` on CPU (onnxruntime), ~5 s sentence per voice: