feat: setup wizard shell + welcome preflight + first-run redirect (#49, #50, #57)

[lan17]

Summary

• implement refactor: centralize clip status transitions #49 wizard foundation:
  • add /setup route outside app shell and add a Setup nav link
  • build SetupWizardShell with progress, back/next/skip, and exit actions
  • add useWizardState with URL step sync (?step=), schema-versioned localStorage resume, and reset semantics
  • add responsive wizard styles and baseline setup page scaffold
• implement #57 first-run redirect behavior:
  • add useSetupRedirect backed by typed GET /api/v1/setup/status
  • redirect dashboard -> /setup only for fresh state
  • fail open on setup-status API errors
  • suppress redirect if persisted wizard progress exists
  • add subtle "Re-run setup wizard" link on dashboard
• implement refactor: narrow api route dependency surfaces #50 welcome + preflight step:
  • add WelcomeStep for wizard step welcome
  • wire manual preflight checks (Run checks) with pass/fail badges, latency display, and retry
  • show explicit auth-required guidance for unauthorized preflight responses
  • keep step progression non-blocking even when checks fail (warning only)
• extend API typing surface for setup preflight:
  • update API codegen script + generated client/types for PreflightResponse
  • add HomeSecApiClient.runSetupPreflight() and parser
  • add usePreflightMutation

Ticket Links

• fix: count alerts from alert decision events #45 (Parent): https://www.notion.so/levneiman/309d8336c59f81f891e4e5166bf9898e
• refactor: centralize clip status transitions #49: https://www.notion.so/levneiman/309d8336c59f815d9dabe3b7fcd9d336
• #57: https://www.notion.so/309d8336c59f81c191ebe782edd669bc
• refactor: narrow api route dependency surfaces #50: https://www.notion.so/levneiman/UI-Welcome-preflight-step-309d8336c59f81a69c56f2465400061c?v=c6c72c380988427caeb9c5d5b7cdc6e3&source=copy_link

Validation

• make ui-check
  • pnpm api:check: pass
  • eslint: pass
  • vitest: pass (126 tests)
  • typecheck: pass
  • vite build: pass

Notes

• Clarification: for TanStack useMutation, the mutation function does not receive query-style { signal } by default. Current preflight flow uses mutationFn: () => apiClient.runSetupPreflight(). Request cancellation via explicit AbortController is deferred.
• local warning from Vite about Node 20.17.0 vs recommended 20.19+; build still succeeds in current environment.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 82.85%. Comparing base (81631d6) to head (f051eb8).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main      #34   +/-   ##
=======================================
  Coverage   82.85%   82.85%           
=======================================
  Files         107      107           
  Lines        9658     9658           
=======================================
  Hits         8002     8002           
  Misses       1656     1656           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.