fix(mobile): translate every catalog against its UI context

apps/mobile/AGENTS.md

@@ -81,6 +81,25 @@ git diff --check
 - Set `freezeOnBlur: true` on tabs. Use haptics for commits and outcomes only, never passive interaction.
 - Set `transition={0}` on small or header `expo-image` images to avoid flicker.
 
+## Translations
+
+Copy lives in `src/i18n/locales/en.json`. The other 86 catalogs are reviewed
+against the screens their keys render on, so a key's name and its context are
+what a translator has to work from.
+
+- Add and edit copy in `en.json` only. Never hand-edit another catalog.
+- Search `en.json` for the string before you add a key. If the copy already
+  exists, reuse that key. `pnpm check:i18n` fails when two keys hold the same copy.
+- Put copy used by more than one section under `common.`.
+- Name a label with `$t(other.key)`; never spell an English label inside another
+  message, or every catalog quotes a button the reader never sees.
+- Keep the `{{placeholder}}` set identical to English. Word order around a
+  placeholder is the translator's to change, so never assume English order.
+- Name a key for what the string is, not for the one screen that shows it first.
+- If one English word truly needs two senses, add it to `TWO_SENSE_COPY` in
+  `tools/i18n/check-catalogs.mjs` and record both senses there.
+- Run `pnpm check:i18n` after you touch copy.
+
 ## Design
 
 The app follows https://github.com/Kilo-Org/kilo-design/ in general, except where this file states otherwise.

apps/mobile/src/app/(app)/(tabs)/(1_kiloclaw)/chat/instance-picker.tsx

@@ -44,7 +44,7 @@ function InstanceRow({
         </Text>
         <View className="flex-row flex-wrap items-center gap-x-3 gap-y-1">
           <Text variant="muted" numberOfLines={1}>
-            {instance.organizationName ?? t('chat.instancePicker.personal')}
+            {instance.organizationName ?? t('common.personal')}
           </Text>
           <StatusBadge status={instance.status} />
         </View>
@@ -100,7 +100,7 @@ export default function InstancePickerScreen() {
       {showList && loadedInstances.length === 0 ? (
         <EmptyState
           icon={Server}
-          title={t('chat.instancePicker.noInstances')}
+          title={t('common.noKiloclawInstances')}
           description={t('chat.instancePicker.noInstancesDescription')}
           action={
             <Button

apps/mobile/src/app/(app)/(tabs)/(1_kiloclaw)/index.tsx

@@ -55,7 +55,7 @@ export default function KiloClawTab() {
     return (
       <View className="flex-1 bg-background">
         <ScreenHeader
-          title={t('kiloclaw.title')}
+          title={t('common.kiloclaw')}
           size="large"
           showBackButton={false}
           className="px-[22px]"
@@ -101,7 +101,7 @@ export default function KiloClawTab() {
   return (
     <View className="flex-1 bg-background">
       <ScreenHeader
-        title={t('kiloclaw.title')}
+        title={t('common.kiloclaw')}
         size="large"
         showBackButton={false}
         className="px-[22px]"

apps/mobile/src/app/(app)/(tabs)/(3_profile)/code-reviewer/[scope]/[platform]/(edit)/focus-areas.tsx

@@ -23,7 +23,7 @@ export default function FocusAreasRoute() {
   const { t } = useTranslation();
   const areaLabels = {
     security: 'codeReviewer.focusArea.security',
-    performance: 'codeReviewer.focusArea.performance',
+    performance: 'common.performance',
     bugs: 'codeReviewer.focusArea.bugs',
     style: 'codeReviewer.focusArea.style',
     testing: 'codeReviewer.focusArea.testing',

apps/mobile/src/app/(app)/(tabs)/(3_profile)/code-reviewer/[scope]/[platform]/(edit)/gate.tsx

@@ -11,10 +11,10 @@ export default function GateThresholdRoute() {
   const save = useSaveReviewConfig(scope, platform);
   const { t } = useTranslation();
   const labels = {
-    off: t('codeReviewer.gateThreshold.off'),
-    all: t('codeReviewer.gateThreshold.all'),
+    off: t('common.off'),
+    all: t('common.all'),
     warning: t('codeReviewer.gateThreshold.warning'),
-    critical: t('codeReviewer.gateThreshold.critical'),
+    critical: t('common.critical'),
   } as const;
   const descriptions = {
     off: t('codeReviewer.gate.off'),

apps/mobile/src/app/(app)/(tabs)/(3_profile)/code-reviewer/[scope]/[platform]/(edit)/repos.tsx

@@ -121,7 +121,7 @@ export default function ReposRoute() {
       <QueryError
         variant="server"
         placement={fullBodyState ? 'center' : 'top'}
-        title={t('codeReviewer.repos.couldNotLoad')}
+        title={t('common.couldNotLoadRepositories')}
         onRetry={refetchRepos}
         isRetrying={reposFetching}
       />
@@ -138,7 +138,7 @@ export default function ReposRoute() {
             size="sm"
             onPress={() => {
               void openExternalUrl(getBitbucketIntegrationUrl(WEB_BASE_URL, scope), {
-                label: t('codeReviewer.repos.bitbucketSetup'),
+                label: t('codeReviewer.bitbucket.setup'),
               });
             }}
           >
@@ -171,7 +171,7 @@ export default function ReposRoute() {
                         { label: t('codeReviewer.repos.repositoryAccess') }
                       );
                     } catch {
-                      toast.error(t('codeReviewer.repos.couldNotOpenGithubSettings'));
+                      toast.error(t('prReview.couldNotOpenGitHubAppSettings'));
                     }
                   } else if (platform === 'gitlab') {
                     await openExternalUrl(getGitLabIntegrationUrl(WEB_BASE_URL, orgScope), {
@@ -191,20 +191,20 @@ export default function ReposRoute() {
 
   return (
     <View className="flex-1 bg-background">
-      <ScreenHeader title={t('codeReviewer.repos.title')} />
+      <ScreenHeader title={t('common.repositories')} />
       {fullBodyState ? (
         repoState
       ) : (
         <TabScreenScrollView className="flex-1" contentContainerClassName="px-6 pt-4">
           {capabilities.selectionModePicker && (
-            <RadioGroup label={t('codeReviewer.repos.title')}>
+            <RadioGroup label={t('common.repositories')}>
               {(['all', 'selected'] as const).map(option => (
                 <ChoiceRow
                   key={option}
                   label={
                     option === 'all'
-                      ? t('codeReviewer.repos.allRepositories')
-                      : t('codeReviewer.repos.selectedRepositories')
+                      ? t('common.allRepositories')
+                      : t('common.selectedRepositories')
                   }
                   selected={mode === option}
                   disabled={configDisabled}
@@ -220,7 +220,7 @@ export default function ReposRoute() {
           {(!capabilities.selectionModePicker || mode === 'selected') && (
             <View className={capabilities.selectionModePicker ? 'mt-6' : undefined}>
               <Text variant="small" className="mb-1 uppercase tracking-wide text-muted-foreground">
-                {t('codeReviewer.repos.title')}
+                {t('common.repositories')}
               </Text>
               {reposLoading && (
                 <View className="gap-3 pt-2">

apps/mobile/src/app/(app)/(tabs)/(3_profile)/code-reviewer/[scope]/[platform]/(edit)/style.tsx

@@ -12,7 +12,7 @@ export default function ReviewStyleRoute() {
   const { t } = useTranslation();
   const labels = {
     strict: t('codeReviewer.reviewStyle.strict'),
-    balanced: t('codeReviewer.reviewStyle.balanced'),
+    balanced: t('common.balanced'),
     lenient: t('codeReviewer.reviewStyle.lenient'),
     roast: t('codeReviewer.reviewStyle.roast'),
   } as const;

apps/mobile/src/app/(app)/(tabs)/_layout.tsx

@@ -164,9 +164,9 @@ export default function TabsLayout() {
           name="(1_kiloclaw)"
           options={{
             href: showKiloClawTab ? undefined : null,
-            title: t('tabs.kiloclaw'),
+            title: t('common.kiloclaw'),
             tabBarAccessibilityLabel: tabAccessibilityLabel(
-              t('tabs.kiloclaw'),
+              t('common.kiloclaw'),
               tabBarPosition('kiloclaw', tabFlags) ?? 2,
               tabCount
             ),
@@ -175,7 +175,7 @@ export default function TabsLayout() {
                 label={
                   fontScale > TAB_LABEL_WRAP_FONT_SCALE
                     ? t('tabs.kiloclawWrapped')
-                    : t('tabs.kiloclaw')
+                    : t('common.kiloclaw')
                 }
                 focused={focused}
               />
@@ -195,16 +195,16 @@ export default function TabsLayout() {
         <Tabs.Screen
           name="(2_agents)"
           options={{
-            title: t('tabs.agents'),
+            title: t('common.agents'),
             tabBarBadge: needsInputBadge,
             tabBarAccessibilityLabel: tabAccessibilityLabel(
               needsInputBadge
-                ? `${t('tabs.agents')}, ${needsInputBadge} ${t('agents.sessionRow.needsInput')}`
-                : t('tabs.agents'),
+                ? `${t('common.agents')}, ${needsInputBadge} ${t('agents.sessionRow.needsInput')}`
+                : t('common.agents'),
               tabBarPosition('agents', tabFlags) ?? 2,
               tabCount
             ),
-            tabBarLabel: ({ focused }) => <TabLabel label={t('tabs.agents')} focused={focused} />,
+            tabBarLabel: ({ focused }) => <TabLabel label={t('common.agents')} focused={focused} />,
             tabBarIcon: ({ color, focused }) => (
               <Bot size={tabIconSize} color={color} strokeWidth={focused ? 2 : 1.5} />
             ),
@@ -219,13 +219,13 @@ export default function TabsLayout() {
           name="(4_chat)"
           options={{
             href: showQuickChatTab ? undefined : null,
-            title: t('tabs.chat'),
+            title: t('common.chat'),
             tabBarAccessibilityLabel: tabAccessibilityLabel(
-              t('tabs.chat'),
+              t('common.chat'),
               tabBarPosition('chat', tabFlags) ?? 3,
               tabCount
             ),
-            tabBarLabel: ({ focused }) => <TabLabel label={t('tabs.chat')} focused={focused} />,
+            tabBarLabel: ({ focused }) => <TabLabel label={t('common.chat')} focused={focused} />,
             tabBarIcon: ({ color, focused }) => (
               <MessageCircle size={tabIconSize} color={color} strokeWidth={focused ? 2 : 1.5} />
             ),
@@ -239,9 +239,15 @@ export default function TabsLayout() {
         <Tabs.Screen
           name="(3_profile)"
           options={{
-            title: t('tabs.profile'),
-            tabBarAccessibilityLabel: tabAccessibilityLabel(t('tabs.profile'), tabCount, tabCount),
-            tabBarLabel: ({ focused }) => <TabLabel label={t('tabs.profile')} focused={focused} />,
+            title: t('common.profile'),
+            tabBarAccessibilityLabel: tabAccessibilityLabel(
+              t('common.profile'),
+              tabCount,
+              tabCount
+            ),
+            tabBarLabel: ({ focused }) => (
+              <TabLabel label={t('common.profile')} focused={focused} />
+            ),
             tabBarIcon: ({ color, focused }) => (
               <UserRound size={tabIconSize} color={color} strokeWidth={focused ? 2 : 1.5} />
             ),

apps/mobile/src/app/(app)/agent-chat/[session-id].tsx

@@ -171,19 +171,19 @@ export default function SessionDetailScreen() {
     );
     let message = t(
       identityFailed
-        ? 'bootstrap.couldNotLoadAccountDescription'
+        ? 'organization.boundary.loadErrorMessage'
         : 'agentChat.session.failedToLoadDetails'
     );
     let variant: 'neutral' | 'not-found' | 'permission' | 'server' = identityFailed
       ? 'neutral'
       : 'server';
     if (notFound) {
-      title = t('agentChat.session.notFound');
-      message = t('agentChat.session.notFoundDescription');
+      title = t('common.notFound');
+      message = t('queryError.notFoundDescription');
       variant = 'not-found';
     } else if (unauthorized) {
-      title = t('agentChat.session.accessDenied');
-      message = t('agentChat.session.accessDeniedDescription');
+      title = t('common.accessDenied');
+      message = t('queryError.permissionDescription');
       variant = 'permission';
     }
     const retry = identityFailed ? confirmation.retry : () => void sessionQuery.refetch();

apps/mobile/src/app/(app)/agent-chat/instance-picker.tsx

@@ -189,7 +189,7 @@ export default function InstancePickerScreen() {
           icon={Server}
           placement="center"
           title={t('agentChat.instancePicker.couldNotLoad')}
-          description={t('agentChat.instancePicker.couldNotLoadDescription')}
+          description={t('organization.boundary.loadErrorMessage')}
           action={
             <Button
               variant="outline"

apps/mobile/src/app/(app)/agent-chat/repo-picker.tsx

@@ -131,7 +131,7 @@ export default function RepoPickerScreen() {
           }
           description={
             search.trim()
-              ? t('agentChat.repoPicker.tryDifferentSearch')
+              ? t('agents.sessionList.tryDifferentSearch')
               : t('agentChat.repoPicker.noRepositoriesDescription')
           }
         />

apps/mobile/src/app/(app)/agent-chat/use-new-session-discard-guard.ts

@@ -62,9 +62,9 @@ export function useNewSessionDiscardGuard({
           : 'agentChat.newSession.discardDraftMessage'
       ),
       [
-        { text: i18n.t('agentChat.newSession.keepEditing'), style: 'cancel' },
+        { text: i18n.t('common.keepEditing'), style: 'cancel' },
         {
-          text: i18n.t('agentChat.newSession.discard'),
+          text: i18n.t('common.discard'),
           style: 'destructive',
           onPress: () => {
             void (async () => {

apps/mobile/src/app/(app)/kiloclaw/[instance-id]/billing.tsx

@@ -27,7 +27,7 @@ import { useTRPC } from '@/lib/trpc';
 import { cn } from '@/lib/utils';
 
 const SUBSCRIPTION_PLAN_KEYS = {
-  commit: 'kiloclaw.billing.planName.commit',
+  commit: 'kiloclaw.billing.commit',
   standard: 'kiloclaw.billing.planName.standard',
 } satisfies Record<string, string>;
 
@@ -107,7 +107,7 @@ function FinalCommitTermDetails({
 
   return (
     <View>
-      <DetailRow label={t('kiloclaw.billing.plan')} value={t('kiloclaw.billing.commitPlan')} />
+      <DetailRow label={t('kiloclaw.billing.plan')} value={t('kiloclaw.billing.commit')} />
       <View className="h-px bg-border" />
       <DetailRow label={t('kiloclaw.billing.finalTermEnds')} value={finalDate} />
       <View className="h-px bg-border" />
@@ -164,7 +164,7 @@ function PlanDetails({
       <View>
         <DetailRow label={t('kiloclaw.billing.plan')} value={t('kiloclaw.billing.freeTrial')} />
         <View className="h-px bg-border" />
-        <DetailRow label={t('kiloclaw.billing.remaining')} value={daysText} />
+        <DetailRow label={t('common.remaining')} value={daysText} />
         <View className="h-px bg-border" />
         <DetailRow
           label={t('kiloclaw.billing.ends')}
@@ -179,7 +179,7 @@ function PlanDetails({
       <View>
         <DetailRow label={t('kiloclaw.billing.plan')} value={t('kiloclaw.billing.earlybird')} />
         <View className="h-px bg-border" />
-        <DetailRow label={t('kiloclaw.billing.remaining')} value={daysText} />
+        <DetailRow label={t('common.remaining')} value={daysText} />
         <View className="h-px bg-border" />
         <DetailRow
           label={t('kiloclaw.billing.expires')}

apps/mobile/src/app/(app)/kiloclaw/[instance-id]/settings/device-pairing.tsx

@@ -256,7 +256,7 @@ export default function DevicePairingScreen() {
                       <Monitor size={18} color={colors.foreground} />
                       <View className="flex-1 gap-0.5">
                         <Text className="text-sm font-medium">
-                          {request.role ?? t('kiloclaw.devicePairing.device')}
+                          {request.role ?? t('common.device')}
                         </Text>
                         <Text variant="muted" className="text-xs">
                           {[request.platform, request.requestId.slice(0, 12)]

apps/mobile/src/app/(app)/kiloclaw/[instance-id]/settings/google.tsx

@@ -139,7 +139,7 @@ export default function GoogleScreen() {
                 isConnected ? 'text-good' : 'text-muted-foreground'
               )}
             >
-              {isConnected ? t('kiloclaw.google.connected') : t('kiloclaw.google.notConnected')}
+              {isConnected ? t('common.connected') : t('common.notConnected')}
             </Text>
           </View>
         </View>
@@ -160,7 +160,7 @@ export default function GoogleScreen() {
                 {!mutations.restartMachine.isPending && (
                   <RefreshCw size={14} color={colors.foreground} />
                 )}
-                <Text>{t('kiloclaw.google.redeploy')}</Text>
+                <Text>{t('kiloclaw.redeploy')}</Text>
               </Button>
             </View>
           )}
@@ -219,9 +219,7 @@ export default function GoogleScreen() {
                 onPress={handleToggleGmail}
                 disabled={mutations.setGmailNotifications.isPending}
               >
-                <Text>
-                  {gmailEnabled ? t('kiloclaw.google.enabled') : t('kiloclaw.google.disabled')}
-                </Text>
+                <Text>{gmailEnabled ? t('common.enabled') : t('common.disabled')}</Text>
               </Button>
             </View>
           </View>