aboutsummaryrefslogtreecommitdiffstats
path: root/AGENTS.md
diff options
context:
space:
mode:
Diffstat (limited to 'AGENTS.md')
-rw-r--r--AGENTS.md26
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: