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