feat(tasks): adopt Office-style /tasks list UX

apps/backend/internal/backendapp/boot_state_routes.go

@@ -28,13 +28,19 @@ func (b bootStateBuilder) tasksPageBootData(ctx context.Context, req *http.Reque
 	settingsWorkspaceID := ""
 	settingsWorkflowID := ""
 	settingsRepositoryID := ""
+	settingsTasksListSort := ""
+	settingsTasksListGroup := ""
 	if hasSettings {
 		settingsWorkspaceID = settings.Settings.WorkspaceID
 		settingsWorkflowID = settings.Settings.WorkflowFilterID
+		settingsTasksListSort = settings.Settings.TasksListSort
+		settingsTasksListGroup = settings.Settings.TasksListGroup
 		if len(settings.Settings.RepositoryIDs) > 0 {
 			settingsRepositoryID = settings.Settings.RepositoryIDs[0]
 		}
 	}
+	tasksListSort := tasksListSortForRoute(queryValue(req, "sort"), settingsTasksListSort)
+	tasksListGroup := tasksListGroupForRoute(queryValue(req, "group"), settingsTasksListGroup)
 	workspaceIDs := workspaceIDSet(workspaces)
 	activeWorkspaceID := firstValidID(
 		workspaceIDs,
@@ -54,7 +60,7 @@ func (b bootStateBuilder) tasksPageBootData(ctx context.Context, req *http.Reque
 		state["userSettings"] = mapUserSettingsState(settings, activeWorkspaceID)
 	}
 	if activeWorkspaceID == "" {
-		return state, map[string]any{"activeWorkspaceId": nil, "workflows": []any{}, "steps": []any{}, "repositories": []any{}, "tasks": []any{}, "total": 0}
+		return state, map[string]any{"activeWorkspaceId": nil, "workflows": []any{}, "steps": []any{}, "repositories": []any{}, "tasks": []any{}, "total": 0, "tasksListSort": tasksListSort, "tasksListGroup": tasksListGroup}
 	}
 	workflows, err := b.p.taskSvc.ListWorkflows(ctx, activeWorkspaceID, false)
 	if err != nil {
@@ -77,6 +83,8 @@ func (b bootStateBuilder) tasksPageBootData(ctx context.Context, req *http.Reque
 		"repositories":      repositories,
 		"tasks":             tasks,
 		"total":             total,
+		"tasksListSort":     tasksListSort,
+		"tasksListGroup":    tasksListGroup,
 	}
 	return state, routeData
 }
@@ -438,6 +446,8 @@ func mapUserSettingsState(response userdto.UserSettingsResponse, workspaceID str
 		"kanbanViewMode":              nullString(settings.KanbanViewMode),
 		"workflowId":                  nullString(settings.WorkflowFilterID),
 		"repositoryIds":               stringSlice(settings.RepositoryIDs),
+		"tasksListSort":               usermodels.NormalizeTasksListSort(settings.TasksListSort),
+		"tasksListGroup":              usermodels.NormalizeTasksListGroup(settings.TasksListGroup),
 		"preferredShell":              nullString(settings.PreferredShell),
 		"shellOptions":                response.ShellOptions,
 		"defaultEditorId":             nullString(settings.DefaultEditorID),
@@ -635,6 +645,20 @@ func queryValue(req *http.Request, name string) string {
 	return strings.TrimSpace(parsed.Query().Get(name))
 }
 
+func tasksListSortForRoute(queryValue, settingsValue string) string {
+	if usermodels.IsValidTasksListSort(queryValue) {
+		return strings.TrimSpace(queryValue)
+	}
+	return usermodels.NormalizeTasksListSort(settingsValue)
+}
+
+func tasksListGroupForRoute(queryValue, settingsValue string) string {
+	if usermodels.IsValidTasksListGroup(queryValue) {
+		return strings.TrimSpace(queryValue)
+	}
+	return usermodels.NormalizeTasksListGroup(settingsValue)
+}
+
 func readActiveWorkspaceCookie(req *http.Request) string {
 	if req == nil {
 		return ""

apps/backend/internal/user/controller/controller.go

@@ -48,6 +48,8 @@ func (c *Controller) UpdateUserSettings(ctx context.Context, req dto.UpdateUserS
 		KanbanViewMode:              req.KanbanViewMode,
 		WorkflowFilterID:            req.WorkflowFilterID,
 		RepositoryIDs:               req.RepositoryIDs,
+		TasksListSort:               req.TasksListSort,
+		TasksListGroup:              req.TasksListGroup,
 		InitialSetupComplete:        req.InitialSetupComplete,
 		PreferredShell:              req.PreferredShell,
 		DefaultEditorID:             req.DefaultEditorID,

apps/backend/internal/user/dto/dto.go

@@ -20,6 +20,8 @@ type UserSettingsDTO struct {
 	KanbanViewMode              string                              `json:"kanban_view_mode"`
 	WorkflowFilterID            string                              `json:"workflow_filter_id"`
 	RepositoryIDs               []string                            `json:"repository_ids"`
+	TasksListSort               string                              `json:"tasks_list_sort"`
+	TasksListGroup              string                              `json:"tasks_list_group"`
 	InitialSetupComplete        bool                                `json:"initial_setup_complete"`
 	PreferredShell              string                              `json:"preferred_shell"`
 	DefaultEditorID             string                              `json:"default_editor_id"`
@@ -74,6 +76,8 @@ type UpdateUserSettingsRequest struct {
 	KanbanViewMode              *string                              `json:"kanban_view_mode,omitempty"`
 	WorkflowFilterID            *string                              `json:"workflow_filter_id,omitempty"`
 	RepositoryIDs               *[]string                            `json:"repository_ids,omitempty"`
+	TasksListSort               *string                              `json:"tasks_list_sort,omitempty"`
+	TasksListGroup              *string                              `json:"tasks_list_group,omitempty"`
 	InitialSetupComplete        *bool                                `json:"initial_setup_complete,omitempty"`
 	PreferredShell              *string                              `json:"preferred_shell,omitempty"`
 	DefaultEditorID             *string                              `json:"default_editor_id,omitempty"`
@@ -184,6 +188,8 @@ func FromUserSettings(settings *models.UserSettings) UserSettingsDTO {
 		KanbanViewMode:              settings.KanbanViewMode,
 		WorkflowFilterID:            settings.WorkflowFilterID,
 		RepositoryIDs:               settings.RepositoryIDs,
+		TasksListSort:               settings.TasksListSort,
+		TasksListGroup:              settings.TasksListGroup,
 		InitialSetupComplete:        settings.InitialSetupComplete,
 		PreferredShell:              settings.PreferredShell,
 		DefaultEditorID:             settings.DefaultEditorID,

apps/backend/internal/user/models/models.go

@@ -18,6 +18,8 @@ type UserSettings struct {
 	KanbanViewMode              string                            `json:"kanban_view_mode"`
 	WorkflowFilterID            string                            `json:"workflow_filter_id"`
 	RepositoryIDs               []string                          `json:"repository_ids"`
+	TasksListSort               string                            `json:"tasks_list_sort"`
+	TasksListGroup              string                            `json:"tasks_list_group"`
 	InitialSetupComplete        bool                              `json:"initial_setup_complete"`
 	PreferredShell              string                            `json:"preferred_shell"`
 	DefaultEditorID             string                            `json:"default_editor_id"`

apps/backend/internal/user/models/tasks_list_preferences.go

@@ -0,0 +1,48 @@
+package models
+
+import (
+	"slices"
+	"strings"
+)
+
+const (
+	TasksListSortDefault  = "updated_desc"
+	TasksListGroupDefault = "state"
+)
+
+var (
+	tasksListSortValues  = []string{TasksListSortDefault, "updated_asc", "created_desc", "created_asc", "title_asc", "title_desc"}
+	tasksListGroupValues = []string{TasksListGroupDefault, "workflow", "repository", "none"}
+)
+
+func TasksListSortValues() []string {
+	return append([]string(nil), tasksListSortValues...)
+}
+
+func TasksListGroupValues() []string {
+	return append([]string(nil), tasksListGroupValues...)
+}
+
+func IsValidTasksListSort(value string) bool {
+	return slices.Contains(tasksListSortValues, strings.TrimSpace(value))
+}
+
+func IsValidTasksListGroup(value string) bool {
+	return slices.Contains(tasksListGroupValues, strings.TrimSpace(value))
+}
+
+func NormalizeTasksListSort(value string) string {
+	value = strings.TrimSpace(value)
+	if IsValidTasksListSort(value) {
+		return value
+	}
+	return TasksListSortDefault
+}
+
+func NormalizeTasksListGroup(value string) string {
+	value = strings.TrimSpace(value)
+	if IsValidTasksListGroup(value) {
+		return value
+	}
+	return TasksListGroupDefault
+}

apps/backend/internal/user/service/service.go

@@ -39,6 +39,8 @@ type UpdateUserSettingsRequest struct {
 	KanbanViewMode              *string
 	WorkflowFilterID            *string
 	RepositoryIDs               *[]string
+	TasksListSort               *string
+	TasksListGroup              *string
 	InitialSetupComplete        *bool
 	PreferredShell              *string
 	DefaultEditorID             *string
@@ -193,6 +195,9 @@ func applyBasicSettings(settings *models.UserSettings, req *UpdateUserSettingsRe
 	if req.RepositoryIDs != nil {
 		settings.RepositoryIDs = *req.RepositoryIDs
 	}
+	if err := applyTasksListPreferences(settings, req.TasksListSort, req.TasksListGroup); err != nil {
+		return err
+	}
 	if req.InitialSetupComplete != nil {
 		settings.InitialSetupComplete = *req.InitialSetupComplete
 	}
@@ -248,6 +253,30 @@ func applyBasicSettings(settings *models.UserSettings, req *UpdateUserSettingsRe
 	return nil
 }
 
+func applyTasksListPreferences(settings *models.UserSettings, sortValue, groupValue *string) error {
+	if sortValue != nil {
+		v := strings.TrimSpace(*sortValue)
+		if v == "" {
+			v = models.TasksListSortDefault
+		}
+		if !models.IsValidTasksListSort(v) {
+			return fmt.Errorf("tasks_list_sort must be one of %s", strings.Join(models.TasksListSortValues(), ", "))
+		}
+		settings.TasksListSort = v
+	}
+	if groupValue != nil {
+		v := strings.TrimSpace(*groupValue)
+		if v == "" {
+			v = models.TasksListGroupDefault
+		}
+		if !models.IsValidTasksListGroup(v) {
+			return fmt.Errorf("tasks_list_group must be one of %s", strings.Join(models.TasksListGroupValues(), ", "))
+		}
+		settings.TasksListGroup = v
+	}
+	return nil
+}
+
 func applyTerminalLinkBehavior(settings *models.UserSettings, value *string) error {
 	if value == nil {
 		return nil
@@ -505,6 +534,8 @@ func (s *Service) publishUserSettingsEvent(ctx context.Context, settings *models
 		"kanban_view_mode":                settings.KanbanViewMode,
 		"workflow_filter_id":              settings.WorkflowFilterID,
 		"repository_ids":                  settings.RepositoryIDs,
+		"tasks_list_sort":                 settings.TasksListSort,
+		"tasks_list_group":                settings.TasksListGroup,
 		"initial_setup_complete":          settings.InitialSetupComplete,
 		"preferred_shell":                 settings.PreferredShell,
 		"default_editor_id":               settings.DefaultEditorID,

apps/backend/internal/user/service/service_test.go

@@ -104,6 +104,41 @@ func TestApplyBasicSettings_ReleaseNotes(t *testing.T) {
 	})
 }
 
+func TestApplyBasicSettings_TasksListPreferences(t *testing.T) {
+	t.Run("sets valid sort and group", func(t *testing.T) {
+		settings := &models.UserSettings{}
+		req := &UpdateUserSettingsRequest{
+			TasksListSort:  ptr("title_asc"),
+			TasksListGroup: ptr("repository"),
+		}
+		if err := applyBasicSettings(settings, req); err != nil {
+			t.Fatalf("unexpected error: %v", err)
+		}
+		if settings.TasksListSort != "title_asc" {
+			t.Fatalf("TasksListSort = %q, want title_asc", settings.TasksListSort)
+		}
+		if settings.TasksListGroup != "repository" {
+			t.Fatalf("TasksListGroup = %q, want repository", settings.TasksListGroup)
+		}
+	})
+
+	t.Run("rejects invalid sort", func(t *testing.T) {
+		settings := &models.UserSettings{}
+		req := &UpdateUserSettingsRequest{TasksListSort: ptr("priority_desc")}
+		if err := applyBasicSettings(settings, req); err == nil {
+			t.Fatal("expected invalid sort error")
+		}
+	})
+
+	t.Run("rejects invalid group", func(t *testing.T) {
+		settings := &models.UserSettings{}
+		req := &UpdateUserSettingsRequest{TasksListGroup: ptr("assignee")}
+		if err := applyBasicSettings(settings, req); err == nil {
+			t.Fatal("expected invalid group error")
+		}
+	})
+}
+
 func TestApplyBasicSettings_TerminalFontFamily(t *testing.T) {
 	t.Run("nil leaves settings unchanged", func(t *testing.T) {
 		settings := &models.UserSettings{TerminalFontFamily: "Fira Code"}

apps/backend/internal/user/store/sqlite.go

@@ -329,6 +329,8 @@ func marshalUserSettingsPayload(settings *models.UserSettings) ([]byte, error) {
 		"kanban_view_mode":                settings.KanbanViewMode,
 		"workflow_filter_id":              settings.WorkflowFilterID,
 		"repository_ids":                  settings.RepositoryIDs,
+		"tasks_list_sort":                 models.NormalizeTasksListSort(settings.TasksListSort),
+		"tasks_list_group":                models.NormalizeTasksListGroup(settings.TasksListGroup),
 		"initial_setup_complete":          settings.InitialSetupComplete,
 		"preferred_shell":                 settings.PreferredShell,
 		"default_editor_id":               settings.DefaultEditorID,
@@ -447,6 +449,8 @@ func scanUserSettings(scanner interface{ Scan(dest ...any) error }, userID strin
 	settings.UserID = userID
 	if settingsRaw == "" || settingsRaw == "{}" {
 		settings.RepositoryIDs = []string{}
+		settings.TasksListSort = models.TasksListSortDefault
+		settings.TasksListGroup = models.TasksListGroupDefault
 		settings.ShowReleaseNotification = true
 		settings.ReviewAutoMarkOnScroll = true
 		settings.ChatSubmitKey = "cmd_enter"
@@ -463,6 +467,8 @@ func scanUserSettings(scanner interface{ Scan(dest ...any) error }, userID strin
 		KanbanViewMode              string                              `json:"kanban_view_mode"`
 		WorkflowFilterID            string                              `json:"workflow_filter_id"`
 		RepositoryIDs               []string                            `json:"repository_ids"`
+		TasksListSort               string                              `json:"tasks_list_sort"`
+		TasksListGroup              string                              `json:"tasks_list_group"`
 		InitialSetupComplete        bool                                `json:"initial_setup_complete"`
 		PreferredShell              string                              `json:"preferred_shell"`
 		DefaultEditorID             string                              `json:"default_editor_id"`
@@ -502,6 +508,8 @@ func scanUserSettings(scanner interface{ Scan(dest ...any) error }, userID strin
 	settings.KanbanViewMode = payload.KanbanViewMode
 	settings.WorkflowFilterID = payload.WorkflowFilterID
 	settings.RepositoryIDs = payload.RepositoryIDs
+	settings.TasksListSort = models.NormalizeTasksListSort(payload.TasksListSort)
+	settings.TasksListGroup = models.NormalizeTasksListGroup(payload.TasksListGroup)
 	settings.InitialSetupComplete = payload.InitialSetupComplete
 	settings.PreferredShell = payload.PreferredShell
 	settings.DefaultEditorID = payload.DefaultEditorID

apps/backend/pkg/api/v1/user.go

@@ -16,6 +16,8 @@ type UserSettings struct {
 	KanbanViewMode   string    `json:"kanban_view_mode"`
 	WorkflowFilterID string    `json:"workflow_filter_id"`
 	RepositoryIDs    []string  `json:"repository_ids"`
+	TasksListSort    string    `json:"tasks_list_sort"`
+	TasksListGroup   string    `json:"tasks_list_group"`
 	PreferredShell   string    `json:"preferred_shell"`
 	DefaultEditorID  string    `json:"default_editor_id"`
 	UpdatedAt        time.Time `json:"updated_at"`