feat: add usage onboarding survey overlay (#388)

* feat: add usage-survey feedback types and gating function

Claude-Session: https://claude.ai/code/session_01KAC9Lbx8AmebAnj9WQZXHp

* feat: add onboarding usage-survey i18n strings to all locales

Relabels three ambiguous feedback.usageTypes values (personal/team_internal/
business_workflow) and adds a new onboarding namespace (4 keys) across the
reference locale and all 20 translations, so the tree compiles at every
commit instead of only after both locale groups land.

Claude-Session: https://claude.ai/code/session_01KAC9Lbx8AmebAnj9WQZXHp

* feat: add UsageSurveyOverlay component

* feat: mount UsageSurveyOverlay inside AuthGuard

Claude-Session: https://claude.ai/code/session_01KAC9Lbx8AmebAnj9WQZXHp

* fix: use text-start instead of text-left for RTL support in UsageSurveyOverlay

* refactor: drop redundant usage-type field from the admin feedback dialog

Claude-Session: https://claude.ai/code/session_01KAC9Lbx8AmebAnj9WQZXHp

* feat: accept onboarding source and survey id in the feedback route

Claude-Session: https://claude.ai/code/session_01KAC9Lbx8AmebAnj9WQZXHp

* test: cover the onboarding source in the feedback route integration test

Claude-Session: https://claude.ai/code/session_01KAC9Lbx8AmebAnj9WQZXHp

* chore: remove orphaned usageTypeLabel i18n key

* refactor: derive feedback source/survey_id enums from a single source of truth

* perf: skip the settings fetch in UsageSurveyOverlay for non-admin users

apps/web/src/lib/feedback.ts

@@ -5,20 +5,23 @@ export type FeedbackSource =
   | "tool_result"
   | "failed_job"
   | "admin_installer"
-  | "search_miss";
+  | "search_miss"
+  | "onboarding";
 export type FeedbackSurveyId =
   | "global-feedback-v1"
   | "tool-result-v1"
   | "failed-job-v1"
   | "admin-install-v1"
-  | "search-miss-v1";
+  | "search-miss-v1"
+  | "onboarding-usage-v1";
 export type FeedbackPromptVariant =
   | "nav-v1"
   | "inline-v1"
   | "failed-button-v1"
   | "settings-card-v1"
   | "search-empty-v1"
-  | "search-results-v1";
+  | "search-results-v1"
+  | "onboarding-overlay-v1";
 export type FeedbackSentiment = "great" | "okay" | "issue" | "missing" | "bug" | "idea" | "other";
 export type FeedbackType = "bug" | "feature_request" | "confusing_ux" | "performance" | "other";
 export type FeedbackInstallMethod = "docker" | "docker_compose" | "source" | "cloud" | "other";
@@ -100,6 +103,8 @@ export function surveyIdForSource(source: FeedbackSource): FeedbackSurveyId {
       return "search-miss-v1";
     case "global":
       return "global-feedback-v1";
+    case "onboarding":
+      return "onboarding-usage-v1";
   }
 }
 
@@ -115,6 +120,8 @@ export function promptVariantForSource(source: FeedbackSource): FeedbackPromptVa
       return "search-empty-v1";
     case "global":
       return "nav-v1";
+    case "onboarding":
+      return "onboarding-overlay-v1";
   }
 }
 
@@ -150,6 +157,26 @@ export function shouldShowInstallFeedbackCard({
   return !Number.isFinite(parsedSnooze) || parsedSnooze <= now;
 }
 
+interface UsageSurveyVisibilityOptions {
+  settings: Record<string, string>;
+  role: string | null;
+  analyticsConfigLoaded: boolean;
+  analyticsEnabled: boolean;
+}
+
+export function shouldShowUsageSurvey({
+  settings,
+  role,
+  analyticsConfigLoaded,
+  analyticsEnabled,
+}: UsageSurveyVisibilityOptions): boolean {
+  if (!analyticsConfigLoaded || !analyticsEnabled || role !== "admin") return false;
+  return (
+    !settings["onboarding.usageSurvey.answeredAt"] &&
+    !settings["onboarding.usageSurvey.dismissedAt"]
+  );
+}
+
 export async function submitFeedback(payload: FeedbackPayload): Promise<FeedbackResponse> {
   return apiPost<FeedbackResponse>("/v1/feedback", payload);
 }