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":               defaultString(settings.TasksListSort, "updated_desc"),
+		"tasksListGroup":              defaultString(settings.TasksListGroup, "state"),
 		"preferredShell":              nullString(settings.PreferredShell),
 		"shellOptions":                response.ShellOptions,
 		"defaultEditorId":             nullString(settings.DefaultEditorID),
@@ -635,6 +645,44 @@ func queryValue(req *http.Request, name string) string {
 	return strings.TrimSpace(parsed.Query().Get(name))
 }
 
+func tasksListSortForRoute(queryValue, settingsValue string) string {
+	if validTasksListSort(queryValue) {
+		return queryValue
+	}
+	if validTasksListSort(settingsValue) {
+		return settingsValue
+	}
+	return "updated_desc"
+}
+
+func tasksListGroupForRoute(queryValue, settingsValue string) string {
+	if validTasksListGroup(queryValue) {
+		return queryValue
+	}
+	if validTasksListGroup(settingsValue) {
+		return settingsValue
+	}
+	return "state"
+}
+
+func validTasksListSort(value string) bool {
+	switch strings.TrimSpace(value) {
+	case "updated_desc", "updated_asc", "created_desc", "created_asc", "title_asc", "title_desc":
+		return true
+	default:
+		return false
+	}
+}
+
+func validTasksListGroup(value string) bool {
+	switch strings.TrimSpace(value) {
+	case "state", "workflow", "repository", "none":
+		return true
+	default:
+		return false
+	}
+}
+
 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/service/service.go

@@ -25,6 +25,8 @@ var (
 const (
 	changesPanelLayoutFlat = "flat"
 	changesPanelLayoutTree = "tree"
+	tasksListSortDefault   = "updated_desc"
+	tasksListGroupDefault  = "state"
 )
 
 type Service struct {
@@ -39,6 +41,8 @@ type UpdateUserSettingsRequest struct {
 	KanbanViewMode              *string
 	WorkflowFilterID            *string
 	RepositoryIDs               *[]string
+	TasksListSort               *string
+	TasksListGroup              *string
 	InitialSetupComplete        *bool
 	PreferredShell              *string
 	DefaultEditorID             *string
@@ -193,6 +197,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 +255,48 @@ 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 = tasksListSortDefault
+		}
+		if !validTasksListSort(v) {
+			return errors.New("tasks_list_sort must be one of updated_desc, updated_asc, created_desc, created_asc, title_asc, title_desc")
+		}
+		settings.TasksListSort = v
+	}
+	if groupValue != nil {
+		v := strings.TrimSpace(*groupValue)
+		if v == "" {
+			v = tasksListGroupDefault
+		}
+		if !validTasksListGroup(v) {
+			return errors.New("tasks_list_group must be one of state, workflow, repository, none")
+		}
+		settings.TasksListGroup = v
+	}
+	return nil
+}
+
+func validTasksListSort(value string) bool {
+	switch value {
+	case "updated_desc", "updated_asc", "created_desc", "created_asc", "title_asc", "title_desc":
+		return true
+	default:
+		return false
+	}
+}
+
+func validTasksListGroup(value string) bool {
+	switch value {
+	case "state", "workflow", "repository", "none":
+		return true
+	default:
+		return false
+	}
+}
+
 func applyTerminalLinkBehavior(settings *models.UserSettings, value *string) error {
 	if value == nil {
 		return nil
@@ -505,6 +554,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":                 normalizeTasksListSort(settings.TasksListSort),
+		"tasks_list_group":                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 = defaultTasksListSort()
+		settings.TasksListGroup = defaultTasksListGroup()
 		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 = normalizeTasksListSort(payload.TasksListSort)
+	settings.TasksListGroup = normalizeTasksListGroup(payload.TasksListGroup)
 	settings.InitialSetupComplete = payload.InitialSetupComplete
 	settings.PreferredShell = payload.PreferredShell
 	settings.DefaultEditorID = payload.DefaultEditorID
@@ -572,6 +580,32 @@ func scanUserSettings(scanner interface{ Scan(dest ...any) error }, userID strin
 	return settings, nil
 }
 
+func defaultTasksListSort() string {
+	return "updated_desc"
+}
+
+func defaultTasksListGroup() string {
+	return "state"
+}
+
+func normalizeTasksListSort(value string) string {
+	switch value {
+	case "updated_desc", "updated_asc", "created_desc", "created_asc", "title_asc", "title_desc":
+		return value
+	default:
+		return defaultTasksListSort()
+	}
+}
+
+func normalizeTasksListGroup(value string) string {
+	switch value {
+	case "state", "workflow", "repository", "none":
+		return value
+	default:
+		return defaultTasksListGroup()
+	}
+}
+
 func normalizeSidebarTaskPrefs(prefs models.SidebarTaskPrefs) models.SidebarTaskPrefs {
 	if prefs.PinnedTaskIDs == nil {
 		prefs.PinnedTaskIDs = []string{}

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