From 80e19d69fb745fbeba59b262cb379b2c2464bce4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Leszczy=C5=84ski?= <2000michal@wp.pl>
Date: Wed, 21 Jan 2026 11:25:06 +0100
Subject: [PATCH] feat(managerclient): describe task statuses

Fixes #4739
---
 v3/pkg/managerclient/tasks.go | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/v3/pkg/managerclient/tasks.go b/v3/pkg/managerclient/tasks.go
index 6e7ed8ea70..866307e4ad 100644
--- a/v3/pkg/managerclient/tasks.go
+++ b/v3/pkg/managerclient/tasks.go
@@ -1,4 +1,4 @@
-// Copyright (C) 2017 ScyllaDB
+// Copyright (C) 2026 ScyllaDB
 
 package managerclient
 
@@ -45,3 +45,22 @@ const (
 	TaskStatusError    string = "ERROR"
 	TaskStatusAborted  string = "ABORTED"
 )
+
+// TaskStatusDescription contains human friendly descriptions of task statuses.
+var TaskStatusDescription = map[string]string{
+	TaskStatusNew:      "Task was created and awaits its first execution according to schedule",
+	TaskStatusRunning:  "Task is currently running",
+	TaskStatusStopping: "Task is being stopped by the user. It will be stopped shortly",
+	TaskStatusStopped: "Task was stopped by the user or cluster suspend. " +
+		"In case it was stopped, next execution is planned according to schedule. " +
+		"In case of cluster suspend, next execution is planned according to cluster resume parameters",
+	TaskStatusWaiting: "Task was stopped because it reached the end of maintenance window. " +
+		"Next execution is planned at the beginning of next window",
+	TaskStatusDone: "Task finished with success. " +
+		"Next execution is planned according to schedule",
+	TaskStatusError: "Task finished with error. " +
+		"In case it hasn't used all retries, next execution is planned according to retry and backoff settings. " +
+		"Otherwise, next execution is planned according to schedule",
+	TaskStatusAborted: "Task was interrupted by ScyllaDB Manager shutdown. " +
+		"Next execution is planned according to schedule",
+}