From b3221b6ab83ea2b2ad017329577e95f445bf5629 Mon Sep 17 00:00:00 2001
From: jochen <jschoubben@gmail.com>
Date: Mon, 26 Oct 2026 13:27:09 +0100
Subject: [PATCH 1/2] pacman: a plain-words search finds pacman_round and
 pacman_upgrades first (answer on the first line, phrases they replace)

---
 modules/pacman/cmd/pacman-tools/main.go |  6 ++++--
 modules/pacman/module.json              | 15 +++++++++++++++
 2 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/modules/pacman/cmd/pacman-tools/main.go b/modules/pacman/cmd/pacman-tools/main.go
index e10ccd46..2e777b36 100644
--- a/modules/pacman/cmd/pacman-tools/main.go
+++ b/modules/pacman/cmd/pacman-tools/main.go
@@ -246,7 +246,8 @@ func tools(m *Machine) []stdio.Tool {
 		},
 		{
 			Name: "pacman_upgrades",
-			Description: "Every full upgrade and rollback of every node, from the bus (ADR 0508 §1): each run's node, kind, what started it, " +
+			Description: "Upgrade history: when each node's last system upgrade or rollback ran and how it ended; one run whole, with its steps.\n" +
+				"Every full upgrade and rollback of every node, from the bus (ADR 0508 §1): each run's node, kind, what started it, " +
 				"its round, when it began and ended, its outcome (refused, finished, failed or running) and whether its after-upgrade check passed; " +
 				"narrowed to a node and to days, newest first. With a run, that run whole, every step with its time: the node's named, else this one's.",
 			Input: schema(map[string]any{
@@ -315,7 +316,8 @@ func tools(m *Machine) []stdio.Tool {
 		},
 		{
 			Name: "pacman_round",
-			Description: "Where the week's upgrade rounds stand (ADR 0508 §5, §6): each round's order and opening, and every node's state in it: " +
+			Description: "Did this week's system upgrade run on every node, and how did each end (the weekly upgrade round, last upgrade of all nodes).\n" +
+				"Where the week's upgrade rounds stand (ADR 0508 §5, §6): each round's order and opening, and every node's state in it: " +
 				"waiting (for the node named), turn, stalled (its turn came longer than round-start-minutes ago), running, passed, failed " +
 				"(the round stops there) or refused, with since when. With pass, a node and a reason, asks the operator on their channel to let " +
 				"the round go on past that node; it goes on only on the operator's Approve.",
diff --git a/modules/pacman/module.json b/modules/pacman/module.json
index 97eaad3f..e1073af7 100644
--- a/modules/pacman/module.json
+++ b/modules/pacman/module.json
@@ -87,6 +87,21 @@
     "pacman_news",
     "pacman_config"
   ],
+  "replaces": {
+    "pacman_round": [
+      "weekly upgrade",
+      "upgrade round",
+      "did the upgrade run",
+      "upgrade ran on all nodes"
+    ],
+    "pacman_upgrades": [
+      "last upgrade",
+      "upgrade history",
+      "upgrade runs",
+      "upgrade last run",
+      "pacman runs history"
+    ]
+  },
   "resources": [
     {
       "id": "package",

From 0300a6fd99b5d2963d13a735a4f994a3b1cd8594 Mon Sep 17 00:00:00 2001
From: jochen <jschoubben@gmail.com>
Date: Mon, 26 Oct 2026 14:04:09 +0100
Subject: [PATCH 2/2] pacman: drop the plain-word phrases from replaces (it
 holds shell commands only, ADR 0245); the descriptions' first lines carry
 them

---
 modules/pacman/module.json | 15 ---------------
 1 file changed, 15 deletions(-)

diff --git a/modules/pacman/module.json b/modules/pacman/module.json
index e1073af7..97eaad3f 100644
--- a/modules/pacman/module.json
+++ b/modules/pacman/module.json
@@ -87,21 +87,6 @@
     "pacman_news",
     "pacman_config"
   ],
-  "replaces": {
-    "pacman_round": [
-      "weekly upgrade",
-      "upgrade round",
-      "did the upgrade run",
-      "upgrade ran on all nodes"
-    ],
-    "pacman_upgrades": [
-      "last upgrade",
-      "upgrade history",
-      "upgrade runs",
-      "upgrade last run",
-      "pacman runs history"
-    ]
-  },
   "resources": [
     {
       "id": "package",