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",