feat: return host task from remove-host

Updates the remove host workflow to track its status with a host-scoped
task. This task is also now returned from the remove-host API endpoint.

PLAT-347

Author: jason-lynch

api/apiv1/design/host.go

@@ -253,9 +253,12 @@ var ListHostsResponseExample = map[string]any{
 }
 
 var RemoveHostResponse = g.Type("RemoveHostResponse", func() {
+	g.Attribute("task", Task, func() {
+		g.Description("The task that tracks the overall host removal operation.")
+	})
 	g.Attribute("update_database_tasks", g.ArrayOf(Task), func() {
 		g.Description("The tasks that will update databases affected by the host removal.")
 	})
 
-	g.Required("update_database_tasks")
+	g.Required("task", "update_database_tasks")
 })

api/apiv1/gen/control_plane/service.go

@@ -0,0 +1,3 @@
+kind: Changed
+body: The `remove-host` API response now includes a `task` that tracks the progress of the entire remove host operation.
+time: 2026-01-14T16:34:06.805619-05:00

api/apiv1/gen/http/control_plane/client/types.go

@@ -101,8 +101,15 @@ func (c *Cluster) Remove(t testing.TB, hostID string) {
 		HostID: controlplane.Identifier(hostID),
 	})
 	require.NoError(t, err)
-	require.NotNil(t, resp, "RemoveHost response should not be nil")
-	require.NotNil(t, resp.UpdateDatabaseTasks, "UpdateDatabaseTasks should always be present (empty slice if no databases)")
+	require.NotNil(t, resp)
+	require.NotNil(t, resp.Task)
+	require.NotNil(t, resp.UpdateDatabaseTasks)
+
+	_, err = c.client.WaitForHostTask(t.Context(), &controlplane.GetHostTaskPayload{
+		HostID: controlplane.Identifier(hostID),
+		TaskID: resp.Task.TaskID,
+	})
+	require.NoError(t, err)
 
 	delete(c.hosts, hostID)
 	c.client = hostsClient(t, c.hosts)