3.5 KiB
3.5 KiB
id, title, status, wave, depends_on, plan, spec
| id | title | status | wave | depends_on | plan | spec |
|---|---|---|---|---|---|---|
| 19-browse-preferences | Portable Azure browse preferences | completed | 11 | plan.md | ../../specs/integrations/requirements/azure-devops-integration.md |
Task 19: Portable Azure Browse Preferences
Acceptance
- Backend user settings expose and patch
azure_devops_browse_preferences, keyed by workspace, without browser-storage hydration or persistence. - Azure browse restores mode, scope, project/team/board/column, and work-item/PR filters only after settings load; rapid changes use queued writes and stale responses cannot overwrite the latest state.
- Missing/inaccessible remembered provider IDs fall back through the existing valid-child defaults while preserving other valid preferences.
- The SPA boot-state mapper includes
azureDevOpsBrowsePreferencesbefore marking user settings loaded, so a hard refresh restores the same project, team, board, focused column, mode, and filters as client-side navigation. - Regression coverage serializes the boot payload shape and performs a browser reload after changing board selectors.
Verification
go test ./internal/user/... -run AzureDevOpsBrowsePreferencesfromapps/backend.go test ./internal/backendapp -run TestMapUserSettingsStateIncludesAzureDevOpsBrowsePreferencesfromapps/backend.pnpm --filter @kandev/web test -- --run lib/ssr/user-settings.test.ts hooks/domains/azure-devops/use-azure-devops-preferences.test.tsx hooks/domains/azure-devops/use-azure-devops-board.test.tsxfromapps.pnpm e2e:run --host --no-build tests/integrations/azure-devops.spec.tsfromapps/web.
Files Likely Touched
apps/backend/internal/user/models/models.goapps/backend/internal/user/dto/dto.goapps/backend/internal/user/service/service.goapps/backend/internal/user/store/sqlite.goapps/backend/internal/user/service/service_test.goapps/backend/internal/user/store/sqlite_test.goapps/web/lib/types/http-user-settings.tsapps/web/lib/state/slices/settings/types.tsapps/web/lib/ssr/user-settings.tsapps/web/hooks/domains/azure-devops/use-azure-devops-preferences.tsapps/web/hooks/domains/azure-devops/use-azure-devops-preferences.test.tsxapps/web/hooks/domains/azure-devops/use-azure-devops-board.tsapps/web/app/azure-devops/azure-devops-page-client.tsx
Dependencies
None.
Parallelism
Sequential. It spans the shared user-settings contract and Azure page state.
Inputs
- Spec: Azure browse preferences data model and restore scenario.
- ADR 0041 backend-owned portable user settings.
apps/web/lib/user-settings-sync.tsqueued update pattern.
Risks
- Preference hydration must not trigger default searches against a transient pre-hydration selection or persist a fallback before discovery settles.
Output Contract
Report setting shape, fallback rules, RED/GREEN commands, files changed, browser-storage audit, risks, and update task/plan status.
Results (2026-07-31)
- RED: the boot-state mapper test showed a loaded payload with no
azureDevOpsBrowsePreferences; desktop Playwright timed out looking for the remembered board selector. - GREEN: the mapper test passes, the complete Azure Vitest slice passes (79 tests), and desktop Playwright changes from Stories to Tasks, reloads, and restores Tasks and its board content.
- Preferences remain backend-owned user settings. No local-storage fallback was added; stale provider IDs continue through the existing discovery fallback.