From 1aeb4db9f266f8c2131f5e3a44e2f606c36b0988 Mon Sep 17 00:00:00 2001
From: "Maksym Hryzodub [DREAM]" <maksym.hryzodub@dreamvention.com>
Date: Wed, 19 Aug 2026 17:13:54 +0300
Subject: [PATCH] feat(app): extract the agent slice into i18n, en+ru
 (CLEAN-38)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Moves all copy out of the agent list, card, detail item and chat screen
— 28 strings the scan found plus the ones it could not see: status
labels and relative timestamps built in script.

Keys, not text, wherever script decides the wording: status meta returns
`status.running` (with the raw value kept for a status the runtime
invented and we have no wording for), the restart overlay returns
titleKey/bodyKey per stage, and the relative timestamp returns a bucket
plus its number so "5m ago" can be reordered by the translation.
agentChat drops its hardcoded 'Restart failed' the same way the auth
providers did — a failure flag plus the server's own message.

Two infrastructure bits this slice forced:

- Russian plural rules in the i18n config. The free-slots counter is a
  real plural, and Russian needs three forms where English has two, so
  vue-i18n's default rule would pick the wrong branch for most numbers.
  The translator prompt now states the branch order, and ru came back
  with the correct four ("нет свободных слотов | {count} слот свободен |
  {count} слота свободно | {count} слотов свободно").
- Narrowed yesterday's message guard. It rejected a bare `|` as well as
  `@`, but `|` *is* the plural separator — a legitimate feature, not a
  mistake. It now flags only `@` outside the `@:key` linked form.

Verified: nuxt typecheck and nuxt build clean, ru strings in the client
chunks, i18n:check green over 5 slice/locale pairs, and a re-scan finds
nothing hardcoded left in the slice.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 .cursor/rules/project.mdc                     |  7 +-
 CLAUDE.md                                     |  2 +-
 app/i18n.sync.json                            | 50 +++++++++++++--
 app/slices/agent/components/agent/Item.vue    | 13 +++-
 .../agent/components/agent/Provider.vue       |  4 +-
 .../agent/components/agentChat/Provider.vue   | 62 +++++++++---------
 .../agent/components/agentList/Card.vue       | 41 ++++++++----
 .../agent/components/agentList/Provider.vue   | 43 ++++++++-----
 app/slices/agent/i18n/locales/en.json         | 64 +++++++++++++++++--
 app/slices/agent/i18n/locales/ru.json         | 64 +++++++++++++++++--
 app/slices/agent/pages/agents/create.vue      |  2 +-
 app/slices/setup/i18n/i18n/i18n.config.ts     | 15 +++++
 scripts/i18n-sync.ts                          | 22 ++++---
 13 files changed, 297 insertions(+), 92 deletions(-)

diff --git a/.cursor/rules/project.mdc b/.cursor/rules/project.mdc
index 781ae2b4..6c532044 100644
--- a/.cursor/rules/project.mdc
+++ b/.cursor/rules/project.mdc
@@ -33,9 +33,10 @@ API keys live in **`.env.project`** (gitignored). Typical keys: `JIRA_API_TOKEN`
 If the user describes work and does **not** give a `CLEAN-<n>` id, that description *is* the ticket. Do not start code, SpecKit, Brainstorm, or a git branch first.
 
 1. Create a Jira issue in CLEAN from their description (title + short summary). Use `.env.project`.
-2. Reply with the issue key and URL.
-3. Move it to In Progress.
-4. Then the usual flow: branch → work → comments → PR.
+2. Mark surface: title prefix `[ADMIN]` / `[APP]` / `[ADMIN][APP]`, plus Jira labels `admin` / `app`. Infer from `admin/` vs `app/`; if unclear, ask. API-only → `[API]`.
+3. Reply with the issue key and URL.
+4. Move it to In Progress.
+5. Then the usual flow: branch → work → comments → PR.
 
 ## OpenAPI
 
diff --git a/CLAUDE.md b/CLAUDE.md
index 406524b9..645b49d3 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -14,7 +14,7 @@ At the start of every task, read `.cursor/rules/project.mdc` (project card) and
 - Git identity: folder `E:/code/dream/` → Maksym Hryzodub [DREAM] / `github-dream`
 - Keys: `JIRA_API_TOKEN`, `JIRA_DOMAIN`, `JIRA_EMAIL`, `GITHUB_TOKEN`, and any other tokens in `.env.project` only
 
-**No `CLEAN-<n>` in the request:** the user's description *is* the ticket. Create the Jira issue first (keys in `.env.project`), send back the key/URL, move to In Progress — then branch/code. Do not start SpecKit or implementation without that id.
+**No `CLEAN-<n>` in the request:** the user's description *is* the ticket. Create the Jira issue first (keys in `.env.project`), mark `[ADMIN]` / `[APP]` in the title and labels, send back the key/URL, move to In Progress — then branch/code. Do not start SpecKit or implementation without that id.
 
 **OpenAPI:** if SDK/types or `api/swagger-spec.json` are missing, regenerate first (`cd api && bun run generate:swagger` or `bun run build`, then `cd admin && bun run build:api` / `cd app && bun run build:api`). Ask where the schema is only after that fails.
 
diff --git a/app/i18n.sync.json b/app/i18n.sync.json
index 50e804a0..5a37c5ac 100644
--- a/app/i18n.sync.json
+++ b/app/i18n.sync.json
@@ -2,12 +2,50 @@
   "version": 1,
   "hashes": {
     "agent:ru": {
-      "agent_name": "28145084c725",
-      "agent_resources": "e89b30aa1dc3",
-      "agent_status": "920e413c7d41",
-      "agent_template": "0575f29df888",
-      "agents": "279b44d2ab4b",
-      "create_agent": "5a614e73e098"
+      "card.open_chat": "0600175af842",
+      "card.updated": "f0a6d28abcbc",
+      "chat.back_to_agents": "7da2164b2679",
+      "chat.elapsed": "e7a16571c3e4",
+      "chat.loading": "ba3bbbe10d8b",
+      "chat.not_found": "a50ba166a23a",
+      "chat.restart": "6b983a81e5e8",
+      "chat.restart_failed": "b8864cf013b4",
+      "chat.restarting": "75d0f1469d16",
+      "chat.unavailable_hint": "b14ea709f7e0",
+      "chat.unavailable_title": "d6bf283bee98",
+      "item.load_error": "af04f385814b",
+      "item.loading": "7e1e624a3210",
+      "item.resources": "e89b30aa1dc3",
+      "item.resources_value": "d4c134c14b82",
+      "item.template": "0575f29df888",
+      "list.cluster_full": "129b2952a7dd",
+      "list.cluster_no_nodes": "4b5656d4657f",
+      "list.create": "5a614e73e098",
+      "list.empty_cta": "88dcddea044f",
+      "list.empty_hint": "3b00ddd1d6b2",
+      "list.empty_no_permission": "11c1123faf1d",
+      "list.empty_title": "971b61f8cb4d",
+      "list.lede": "1a2a5c6eb9e9",
+      "list.running_of": "dafe09b6ae07",
+      "list.slots_free": "aa856cbf3070",
+      "list.title": "279b44d2ab4b",
+      "relative_time.days": "a41234397f3c",
+      "relative_time.hours": "520c737ea624",
+      "relative_time.just_now": "7ddb44d8a533",
+      "relative_time.minutes": "0a03167c208c",
+      "restart_stage.almost_body": "cc88c514c77b",
+      "restart_stage.almost_title": "0ceb8f97a4cc",
+      "restart_stage.deploying_body": "4cc2d4111a84",
+      "restart_stage.deploying_title": "dfdc8e60ff35",
+      "restart_stage.starting_body": "f048e1dcc8ca",
+      "restart_stage.starting_title": "a1661573d16c",
+      "restart_stage.stopping_body": "4d3eb76d014c",
+      "restart_stage.stopping_title": "93f2bb08afc2",
+      "status.deploying": "4338bdb0808b",
+      "status.failed": "031a8f0f659d",
+      "status.pending": "331551b0de41",
+      "status.running": "f4ccae29e1bb",
+      "status.stopped": "1a4f630ac1b6"
     },
     "bridle:ru": {
       "chat.agent": "11b39c93777e",
diff --git a/app/slices/agent/components/agent/Item.vue b/app/slices/agent/components/agent/Item.vue
index 34292e40..401ae09c 100644
--- a/app/slices/agent/components/agent/Item.vue
+++ b/app/slices/agent/components/agent/Item.vue
@@ -11,12 +11,19 @@
     </div>
     <div class="grid grid-cols-2 gap-4">
       <div>
-        <p class="text-sm text-muted-foreground">Template</p>
+        <p class="text-sm text-muted-foreground">{{ $t('item.template') }}</p>
         <p>{{ agent.templateId }}</p>
       </div>
       <div>
-        <p class="text-sm text-muted-foreground">Resources</p>
-        <p>CPU: {{ agent.resources.cpu }} / Memory: {{ agent.resources.memory }}</p>
+        <p class="text-sm text-muted-foreground">{{ $t('item.resources') }}</p>
+        <p>
+          {{
+            $t('item.resources_value', {
+              cpu: agent.resources.cpu,
+              memory: agent.resources.memory,
+            })
+          }}
+        </p>
       </div>
     </div>
   </div>
diff --git a/app/slices/agent/components/agent/Provider.vue b/app/slices/agent/components/agent/Provider.vue
index 6abac03d..771bb236 100644
--- a/app/slices/agent/components/agent/Provider.vue
+++ b/app/slices/agent/components/agent/Provider.vue
@@ -1,6 +1,6 @@
 <template>
-  <div v-if="pending">Loading agent...</div>
-  <div v-else-if="error">Error loading agent</div>
+  <div v-if="pending">{{ $t('item.loading') }}</div>
+  <div v-else-if="error">{{ $t('item.load_error') }}</div>
   <div v-else-if="agent">
     <AgentItem :agent="agent" />
   </div>
diff --git a/app/slices/agent/components/agentChat/Provider.vue b/app/slices/agent/components/agentChat/Provider.vue
index 38563f31..cabd019f 100644
--- a/app/slices/agent/components/agentChat/Provider.vue
+++ b/app/slices/agent/components/agentChat/Provider.vue
@@ -15,6 +15,7 @@ const canManage = computed(() =>
 
 const restarting = ref(false);
 const restartError = ref<string | null>(null);
+const restartFailed = ref(false);
 /** Wallclock the user clicked Restart — used to compute progress / time. */
 const restartStartedAt = ref<number | null>(null);
 
@@ -29,6 +30,7 @@ async function onRestart() {
   if (!agent.value || restarting.value) return;
   restarting.value = true;
   restartError.value = null;
+  restartFailed.value = false;
   restartStartedAt.value = Date.now();
   const previous = agent.value.status;
   // Optimistic flip — overlay appears immediately, status pill animates.
@@ -38,7 +40,8 @@ async function onRestart() {
     await refresh();
   } catch (err) {
     if (agent.value) agent.value = { ...agent.value, status: previous };
-    restartError.value = (err as Error).message || 'Restart failed';
+    restartFailed.value = true;
+    restartError.value = (err as Error).message || null;
     restartStartedAt.value = null;
   } finally {
     restarting.value = false;
@@ -76,17 +79,18 @@ const statusMeta = computed(() => {
   const status = agent.value?.status;
   switch (status) {
     case 'running':
-      return { label: 'Running', dot: 'bg-emerald-500', pulse: true };
+      return { labelKey: 'status.running', label: status, dot: 'bg-emerald-500', pulse: true };
     case 'deploying':
-      return { label: 'Deploying', dot: 'bg-amber-500', pulse: true };
+      return { labelKey: 'status.deploying', label: status, dot: 'bg-amber-500', pulse: true };
     case 'pending':
-      return { label: 'Pending', dot: 'bg-amber-500', pulse: true };
+      return { labelKey: 'status.pending', label: status, dot: 'bg-amber-500', pulse: true };
     case 'failed':
-      return { label: 'Failed', dot: 'bg-rose-500', pulse: false };
+      return { labelKey: 'status.failed', label: status, dot: 'bg-rose-500', pulse: false };
     case 'stopped':
-      return { label: 'Stopped', dot: 'bg-muted-foreground', pulse: false };
+      return { labelKey: 'status.stopped', label: status, dot: 'bg-muted-foreground', pulse: false };
     default:
-      return { label: status ?? 'Unknown', dot: 'bg-muted-foreground', pulse: false };
+      // No wording for a status the runtime invented — show it verbatim.
+      return { labelKey: null, label: status ?? '', dot: 'bg-muted-foreground', pulse: false };
   }
 });
 
@@ -116,30 +120,30 @@ onBeforeUnmount(() => {
   if (elapsedTimer) clearInterval(elapsedTimer);
 });
 
-const overlayStage = computed<{ title: string; subtitle: string }>(() => {
+const overlayStage = computed<{ titleKey: string; bodyKey: string }>(() => {
   const sec = elapsedSec.value;
   // Stages chosen by feel — a typical k8s pod restart is 10–25s.
   if (sec < 3) {
     return {
-      title: 'Stopping current pod…',
-      subtitle: 'Cancelling the running workflow.',
+      titleKey: 'restart_stage.stopping_title',
+      bodyKey: 'restart_stage.stopping_body',
     };
   }
   if (sec < 10) {
     return {
-      title: 'Deploying new pod…',
-      subtitle: 'Scheduling on the cluster.',
+      titleKey: 'restart_stage.deploying_title',
+      bodyKey: 'restart_stage.deploying_body',
     };
   }
   if (sec < 20) {
     return {
-      title: 'Starting up…',
-      subtitle: 'The container is pulling and initialising.',
+      titleKey: 'restart_stage.starting_title',
+      bodyKey: 'restart_stage.starting_body',
     };
   }
   return {
-    title: 'Almost ready…',
-    subtitle: 'Waiting for the agent to come online.',
+    titleKey: 'restart_stage.almost_title',
+    bodyKey: 'restart_stage.almost_body',
   };
 });
 
@@ -164,7 +168,7 @@ const initials = computed(() => {
         <NuxtLink
           to="/agents"
           class="inline-flex items-center justify-center rounded-md p-2 text-muted-foreground hover:text-foreground hover:bg-muted transition"
-          aria-label="Back to agents"
+          :aria-label="$t('chat.back_to_agents')"
         >
           <Icon name="arrow-left" :size="16" />
         </NuxtLink>
@@ -180,8 +184,8 @@ const initials = computed(() => {
           <div class="flex items-center gap-2">
             <h1 class="truncate text-sm font-semibold">
               <template v-if="agent">{{ agent.name }}</template>
-              <template v-else-if="pending">Loading…</template>
-              <template v-else>Agent not found</template>
+              <template v-else-if="pending">{{ $t('chat.loading') }}</template>
+              <template v-else>{{ $t('chat.not_found') }}</template>
             </h1>
             <span
               v-if="agent"
@@ -198,7 +202,7 @@ const initials = computed(() => {
                   :class="statusMeta.dot"
                 />
               </span>
-              {{ statusMeta.label }}
+              {{ statusMeta.labelKey ? $t(statusMeta.labelKey) : statusMeta.label }}
             </span>
           </div>
           <p
@@ -222,19 +226,19 @@ const initials = computed(() => {
             :size="13"
             :class="isTransitioning ? 'animate-spin' : undefined"
           />
-          {{ isTransitioning ? 'Restarting…' : 'Restart' }}
+          {{ $t(isTransitioning ? 'chat.restarting' : 'chat.restart') }}
         </button>
       </div>
     </header>
 
     <div
-      v-if="restartError"
+      v-if="restartFailed"
       class="shrink-0 border-b bg-rose-500/10"
     >
       <p
         class="mx-auto w-full max-w-3xl px-4 py-2 text-xs text-rose-700 dark:text-rose-400"
       >
-        {{ restartError }}
+        {{ restartError ?? $t('chat.restart_failed') }}
       </p>
     </div>
 
@@ -251,16 +255,16 @@ const initials = computed(() => {
           <Icon name="bot-off" :size="22" />
         </div>
         <div>
-          <p class="text-sm font-medium">Agent unavailable</p>
+          <p class="text-sm font-medium">{{ $t('chat.unavailable_title') }}</p>
           <p class="mt-1 text-xs text-muted-foreground">
-            This agent may have been removed or the runtime is offline.
+            {{ $t('chat.unavailable_hint') }}
           </p>
         </div>
         <NuxtLink
           to="/agents"
           class="text-xs font-medium text-primary hover:underline"
         >
-          ← Back to agents
+          ← {{ $t('chat.back_to_agents') }}
         </NuxtLink>
       </div>
       <BridleChatProvider
@@ -305,9 +309,9 @@ const initials = computed(() => {
               </span>
             </div>
 
-            <h3 class="text-sm font-semibold">{{ overlayStage.title }}</h3>
+            <h3 class="text-sm font-semibold">{{ $t(overlayStage.titleKey) }}</h3>
             <p class="mt-1.5 text-xs text-muted-foreground">
-              {{ overlayStage.subtitle }}
+              {{ $t(overlayStage.bodyKey) }}
             </p>
 
             <!-- Indeterminate progress bar — visual only, since k8s doesn't
@@ -317,7 +321,7 @@ const initials = computed(() => {
             </div>
 
             <p class="mt-3 text-[11px] text-muted-foreground/70">
-              Elapsed {{ elapsedSec }}s · agent will reload memory from S3
+              {{ $t('chat.elapsed', { seconds: elapsedSec }) }}
             </p>
           </div>
         </div>
diff --git a/app/slices/agent/components/agentList/Card.vue b/app/slices/agent/components/agentList/Card.vue
index 5ea8d0f8..c49b752f 100644
--- a/app/slices/agent/components/agentList/Card.vue
+++ b/app/slices/agent/components/agentList/Card.vue
@@ -20,11 +20,14 @@ const initials = computed(() => {
     .join('') || '?';
 });
 
+// labelKey is an i18n key; `label` carries the raw status for the default
+// branch, where the runtime reported something we have no wording for.
 const statusMeta = computed(() => {
   switch (props.agent.status) {
     case 'running':
       return {
-        label: 'Running',
+        labelKey: 'status.running',
+        label: props.agent.status,
         dot: 'bg-emerald-500',
         pulse: true,
         text: 'text-emerald-700 dark:text-emerald-400',
@@ -32,27 +35,32 @@ const statusMeta = computed(() => {
     case 'deploying':
     case 'pending':
       return {
-        label: props.agent.status === 'pending' ? 'Pending' : 'Deploying',
+        labelKey:
+          props.agent.status === 'pending' ? 'status.pending' : 'status.deploying',
+        label: props.agent.status,
         dot: 'bg-amber-500',
         pulse: true,
         text: 'text-amber-700 dark:text-amber-400',
       };
     case 'failed':
       return {
-        label: 'Failed',
+        labelKey: 'status.failed',
+        label: props.agent.status,
         dot: 'bg-rose-500',
         pulse: false,
         text: 'text-rose-700 dark:text-rose-400',
       };
     case 'stopped':
       return {
-        label: 'Stopped',
+        labelKey: 'status.stopped',
+        label: props.agent.status,
         dot: 'bg-muted-foreground',
         pulse: false,
         text: 'text-muted-foreground',
       };
     default:
       return {
+        labelKey: null,
         label: props.agent.status,
         dot: 'bg-muted-foreground',
         pulse: false,
@@ -61,7 +69,10 @@ const statusMeta = computed(() => {
   }
 });
 
-const updatedRelative = computed(() => {
+// Returns the bucket and its number; the template turns that into words. The
+// unit suffix is part of the message ("{count}m ago"), so a language that
+// writes it differently — or reorders it — only edits the locale file.
+const updatedRelative = computed<{ key: string; count: number } | null>(() => {
   if (!props.agent.updatedAt) return null;
   const ts = Date.parse(props.agent.updatedAt);
   if (Number.isNaN(ts)) return null;
@@ -69,10 +80,12 @@ const updatedRelative = computed(() => {
   const minute = 60_000;
   const hour = 60 * minute;
   const day = 24 * hour;
-  if (diff < minute) return 'just now';
-  if (diff < hour) return `${Math.floor(diff / minute)}m ago`;
-  if (diff < day) return `${Math.floor(diff / hour)}h ago`;
-  return `${Math.floor(diff / day)}d ago`;
+  if (diff < minute) return { key: 'relative_time.just_now', count: 0 };
+  if (diff < hour)
+    return { key: 'relative_time.minutes', count: Math.floor(diff / minute) };
+  if (diff < day)
+    return { key: 'relative_time.hours', count: Math.floor(diff / hour) };
+  return { key: 'relative_time.days', count: Math.floor(diff / day) };
 });
 </script>
 
@@ -115,7 +128,7 @@ const updatedRelative = computed(() => {
             :class="statusMeta.dot"
           />
         </span>
-        {{ statusMeta.label }}
+        {{ statusMeta.labelKey ? $t(statusMeta.labelKey) : statusMeta.label }}
       </div>
     </div>
 
@@ -124,7 +137,7 @@ const updatedRelative = computed(() => {
     >
       <span class="inline-flex items-center gap-1 truncate">
         <Icon name="message-square" :size="12" class="-mt-0.5" />
-        Open chat
+        {{ $t('card.open_chat') }}
         <Icon
           name="arrow-up-right"
           :size="12"
@@ -132,7 +145,11 @@ const updatedRelative = computed(() => {
         />
       </span>
       <span v-if="updatedRelative" class="shrink-0">
-        Updated {{ updatedRelative }}
+        {{
+          $t('card.updated', {
+            when: $t(updatedRelative.key, { count: updatedRelative.count }),
+          })
+        }}
       </span>
     </div>
   </NuxtLink>
diff --git a/app/slices/agent/components/agentList/Provider.vue b/app/slices/agent/components/agentList/Provider.vue
index 0e82e32c..c7140a91 100644
--- a/app/slices/agent/components/agentList/Provider.vue
+++ b/app/slices/agent/components/agentList/Provider.vue
@@ -36,9 +36,9 @@ onUnmounted(() => {
   <div class="flex flex-col gap-6">
     <header class="flex flex-wrap items-end justify-between gap-4">
       <div>
-        <h1 class="text-2xl font-bold tracking-tight">Agents</h1>
+        <h1 class="text-2xl font-bold tracking-tight">{{ $t('list.title') }}</h1>
         <p class="mt-1 text-sm text-muted-foreground">
-          Click a card to chat. Live runtime status updates as agents come online.
+          {{ $t('list.lede') }}
         </p>
       </div>
 
@@ -57,8 +57,15 @@ onUnmounted(() => {
               :class="runningCount > 0 ? 'bg-emerald-500' : 'bg-muted-foreground'"
             />
           </span>
-          <span class="font-medium text-foreground">{{ runningCount }}</span>
-          / {{ agents.length }} running
+          <!-- The running count keeps its own emphasis, so it comes in as a
+               slot rather than a plain parameter — the sentence stays one
+               translatable string either way. -->
+          <i18n-t keypath="list.running_of" tag="span">
+            <template #running>
+              <span class="font-medium text-foreground">{{ runningCount }}</span>
+            </template>
+            <template #total>{{ agents.length }}</template>
+          </i18n-t>
           <template v-if="canCreate && capacity">
             <span class="text-muted-foreground/60">·</span>
             <span
@@ -68,8 +75,13 @@ onUnmounted(() => {
                   : ''
               "
             >
-              {{ capacity.freeAgentSlots }}
-              {{ capacity.freeAgentSlots === 1 ? 'slot' : 'slots' }} free
+              {{
+                $t(
+                  'list.slots_free',
+                  { count: capacity.freeAgentSlots },
+                  capacity.freeAgentSlots,
+                )
+              }}
             </span>
           </template>
         </div>
@@ -80,7 +92,7 @@ onUnmounted(() => {
           class="inline-flex items-center gap-1.5 rounded-md bg-primary text-primary-foreground px-4 py-2 text-sm font-medium shadow-sm hover:opacity-95 transition"
         >
           <Icon name="plus" :size="14" />
-          Create Agent
+          {{ $t('list.create') }}
         </NuxtLink>
       </div>
     </header>
@@ -93,9 +105,11 @@ onUnmounted(() => {
     >
       <Icon name="alert-triangle" :size="14" class="shrink-0" />
       {{
-        capacity.totalAgentSlots === 0
-          ? 'No agent nodes available in this cluster — new agents will stay Pending.'
-          : 'Cluster is full — stop an agent to free a slot before starting a new one.'
+        $t(
+          capacity.totalAgentSlots === 0
+            ? 'list.cluster_no_nodes'
+            : 'list.cluster_full',
+        )
       }}
     </div>
 
@@ -140,10 +154,9 @@ onUnmounted(() => {
       >
         <Icon name="bot" :size="22" />
       </div>
-      <h2 class="mt-4 text-base font-semibold">No agents yet</h2>
+      <h2 class="mt-4 text-base font-semibold">{{ $t('list.empty_title') }}</h2>
       <p class="mt-1 text-sm text-muted-foreground max-w-sm mx-auto">
-        Spin up your first AI worker — it'll appear here and you can chat with
-        it in real time.
+        {{ $t('list.empty_hint') }}
       </p>
       <NuxtLink
         v-if="canCreate"
@@ -151,13 +164,13 @@ onUnmounted(() => {
         class="mt-5 inline-flex items-center gap-1.5 rounded-md bg-primary text-primary-foreground px-4 py-2 text-sm font-medium hover:opacity-95 transition"
       >
         <Icon name="plus" :size="14" />
-        Create your first agent
+        {{ $t('list.empty_cta') }}
       </NuxtLink>
       <p
         v-else
         class="mt-5 text-xs text-muted-foreground/70"
       >
-        Ask an Admin or Owner to deploy one.
+        {{ $t('list.empty_no_permission') }}
       </p>
     </div>
   </div>
diff --git a/app/slices/agent/i18n/locales/en.json b/app/slices/agent/i18n/locales/en.json
index 932dac8b..b8e3bb31 100644
--- a/app/slices/agent/i18n/locales/en.json
+++ b/app/slices/agent/i18n/locales/en.json
@@ -1,8 +1,60 @@
 {
-  "agents": "Agents",
-  "create_agent": "Create Agent",
-  "agent_name": "Agent Name",
-  "agent_status": "Status",
-  "agent_template": "Template",
-  "agent_resources": "Resources"
+  "list": {
+    "title": "Agents",
+    "lede": "Click a card to chat. Live runtime status updates as agents come online.",
+    "running_of": "{running} / {total} running",
+    "slots_free": "no slots free | {count} slot free | {count} slots free",
+    "cluster_no_nodes": "No agent nodes available in this cluster — new agents will stay Pending.",
+    "cluster_full": "Cluster is full — stop an agent to free a slot before starting a new one.",
+    "create": "Create Agent",
+    "empty_title": "No agents yet",
+    "empty_hint": "Spin up your first AI worker — it'll appear here and you can chat with it in real time.",
+    "empty_cta": "Create your first agent",
+    "empty_no_permission": "Ask an Admin or Owner to deploy one."
+  },
+  "card": {
+    "open_chat": "Open chat",
+    "updated": "Updated {when}"
+  },
+  "item": {
+    "template": "Template",
+    "resources": "Resources",
+    "resources_value": "CPU: {cpu} / Memory: {memory}",
+    "loading": "Loading agent...",
+    "load_error": "Error loading agent"
+  },
+  "chat": {
+    "back_to_agents": "Back to agents",
+    "loading": "Loading…",
+    "not_found": "Agent not found",
+    "unavailable_title": "Agent unavailable",
+    "unavailable_hint": "This agent may have been removed or the runtime is offline.",
+    "restart": "Restart",
+    "restarting": "Restarting…",
+    "restart_failed": "Restart failed",
+    "elapsed": "Elapsed {seconds}s · agent will reload memory from S3"
+  },
+  "status": {
+    "running": "Running",
+    "pending": "Pending",
+    "deploying": "Deploying",
+    "failed": "Failed",
+    "stopped": "Stopped"
+  },
+  "restart_stage": {
+    "stopping_title": "Stopping current pod…",
+    "stopping_body": "Cancelling the running workflow.",
+    "deploying_title": "Deploying new pod…",
+    "deploying_body": "Scheduling on the cluster.",
+    "starting_title": "Starting up…",
+    "starting_body": "The container is pulling and initialising.",
+    "almost_title": "Almost ready…",
+    "almost_body": "Waiting for the agent to come online."
+  },
+  "relative_time": {
+    "just_now": "just now",
+    "minutes": "{count}m ago",
+    "hours": "{count}h ago",
+    "days": "{count}d ago"
+  }
 }
diff --git a/app/slices/agent/i18n/locales/ru.json b/app/slices/agent/i18n/locales/ru.json
index cd7fd4ac..079bf59d 100644
--- a/app/slices/agent/i18n/locales/ru.json
+++ b/app/slices/agent/i18n/locales/ru.json
@@ -1,8 +1,60 @@
 {
-  "agents": "Агенты",
-  "create_agent": "Создать агента",
-  "agent_name": "Имя агента",
-  "agent_status": "Статус",
-  "agent_template": "Шаблон",
-  "agent_resources": "Ресурсы"
+  "list": {
+    "title": "Агенты",
+    "lede": "Нажмите на карточку, чтобы открыть чат. Статус обновляется по мере запуска агентов.",
+    "running_of": "{running} / {total} запущено",
+    "slots_free": "нет свободных слотов | {count} слот свободен | {count} слота свободно | {count} слотов свободно",
+    "cluster_no_nodes": "В этом кластере нет доступных узлов для агентов — новые агенты останутся в статусе Pending.",
+    "cluster_full": "Кластер заполнен — остановите агента, чтобы освободить слот перед запуском нового.",
+    "create": "Создать агента",
+    "empty_title": "Агентов пока нет",
+    "empty_hint": "Запустите первого AI-воркера — он появится здесь, и вы сможете общаться с ним в реальном времени.",
+    "empty_cta": "Создать первого агента",
+    "empty_no_permission": "Попросите администратора или владельца развернуть агента."
+  },
+  "card": {
+    "open_chat": "Открыть чат",
+    "updated": "Обновлено {when}"
+  },
+  "item": {
+    "template": "Шаблон",
+    "resources": "Ресурсы",
+    "resources_value": "CPU: {cpu} / Память: {memory}",
+    "loading": "Загрузка агента...",
+    "load_error": "Ошибка загрузки агента"
+  },
+  "chat": {
+    "back_to_agents": "Назад к агентам",
+    "loading": "Загрузка…",
+    "not_found": "Агент не найден",
+    "unavailable_title": "Агент недоступен",
+    "unavailable_hint": "Возможно, агент удалён или среда выполнения offline.",
+    "restart": "Перезапустить",
+    "restarting": "Перезапуск…",
+    "restart_failed": "Перезапуск не удался",
+    "elapsed": "Прошло {seconds} с · агент загрузит память из S3"
+  },
+  "status": {
+    "running": "Запущен",
+    "pending": "Ожидание",
+    "deploying": "Развёртывание",
+    "failed": "Ошибка",
+    "stopped": "Остановлен"
+  },
+  "restart_stage": {
+    "stopping_title": "Остановка текущего пода…",
+    "stopping_body": "Отмена запущенного workflow.",
+    "deploying_title": "Развёртывание нового пода…",
+    "deploying_body": "Планирование в кластере.",
+    "starting_title": "Запуск…",
+    "starting_body": "Контейнер загружается и инициализируется.",
+    "almost_title": "Почти готово…",
+    "almost_body": "Ожидание выхода агента в сеть."
+  },
+  "relative_time": {
+    "just_now": "только что",
+    "minutes": "{count} мин назад",
+    "hours": "{count} ч назад",
+    "days": "{count} дн назад"
+  }
 }
diff --git a/app/slices/agent/pages/agents/create.vue b/app/slices/agent/pages/agents/create.vue
index 41077eda..30f12c2e 100644
--- a/app/slices/agent/pages/agents/create.vue
+++ b/app/slices/agent/pages/agents/create.vue
@@ -10,7 +10,7 @@ if (!authStore.hasRole(UserRoleTypes.Owner, UserRoleTypes.Admin)) {
 
 <template>
   <div>
-    <h1 class="text-2xl font-bold mb-6">Create Agent</h1>
+    <h1 class="text-2xl font-bold mb-6">{{ $t('list.create') }}</h1>
     <!-- AgentForm will be implemented here -->
   </div>
 </template>
diff --git a/app/slices/setup/i18n/i18n/i18n.config.ts b/app/slices/setup/i18n/i18n/i18n.config.ts
index 0a921a9a..b6ee6c28 100644
--- a/app/slices/setup/i18n/i18n/i18n.config.ts
+++ b/app/slices/setup/i18n/i18n/i18n.config.ts
@@ -7,6 +7,21 @@ export default defineI18nConfig(() => ({
   // the raw key path — so a slice mid-extraction degrades to English rather
   // than showing `chat.send` to the user.
   fallbackLocale: SOURCE_LOCALE,
+  pluralRules: {
+    /**
+     * Russian needs three plural forms where English has two — "1 слот",
+     * "2 слота", "5 слотов" — so vue-i18n's default (English) rule would pick
+     * the wrong branch for most numbers. Message order: zero | one | few | many.
+     */
+    ru: (choice: number, choicesLength: number): number => {
+      if (choice === 0) return 0;
+      const teen = choice > 10 && choice < 20;
+      const lastDigit = choice % 10;
+      if (!teen && lastDigit === 1) return 1;
+      if (!teen && lastDigit >= 2 && lastDigit <= 4) return 2;
+      return choicesLength < 4 ? 2 : 3;
+    },
+  },
   // No `messages` here on purpose: every slice ships its own locale files and
   // the module merges them. Listing locales again would mean editing this file
   // too whenever LOCALES changes.
diff --git a/scripts/i18n-sync.ts b/scripts/i18n-sync.ts
index 2d52534a..24039ccd 100644
--- a/scripts/i18n-sync.ts
+++ b/scripts/i18n-sync.ts
@@ -85,15 +85,20 @@ function hash(value: string): string {
 }
 
 /**
- * vue-i18n compiles every message: a bare `@` starts a linked-message reference
- * and a bare `|` starts a plural branch, so `jane@example.com` fails the build
- * with a compiler error. Both must be written as literals — `jane{'@'}mail.com`.
- * Worth checking here because CI runs typecheck/lint/test and this script, not
- * `nuxt build` — without this guard a broken message reaches production.
+ * vue-i18n compiles every message, and a bare `@` starts a linked-message
+ * reference — so `jane@example.com` fails the build with a compiler error and
+ * has to be written as the literal `jane{'@'}mail.com`. Worth checking here
+ * because CI runs typecheck/lint/test and this script, not `nuxt build`, so a
+ * broken message would otherwise surface in production.
+ *
+ * `|` is deliberately NOT checked: it separates plural branches
+ * ("no slots free | {count} slot free | {count} slots free"), which is a
+ * feature we use, not a mistake.
  */
 function unsafeMessage(value: string): boolean {
   const withoutLiterals = value.replace(/\{'[^']*'\}/g, '').replace(/\{\s*\w+\s*\}/g, '');
-  return /[@|]/.test(withoutLiterals);
+  // `@:key` and `@.lower:key` are the intentional linked-message forms.
+  return /@(?![:.])/.test(withoutLiterals);
 }
 
 // ------------------------------------------------------------------ discovery
@@ -201,7 +206,8 @@ const SYSTEM_PROMPT = [
   '- Return ONLY a JSON object mapping each key you were given to its translation.',
   '- Translate the value, never the key.',
   '- Keep placeholders exactly as they appear: {name}, {count}, @:some.key, and any HTML.',
-  "- Never write a bare @ or | — vue-i18n reads them as control characters. An escaped literal such as {'@'} must come back verbatim.",
+  "- Never write a bare @ — vue-i18n reads it as a linked-message reference. An escaped literal such as {'@'} must come back verbatim.",
+  '- A source message split by | is a plural set. Return the branch count the target language needs, in the order zero | one | few | many: English has 3 branches (zero | one | other), Russian needs 4 — "нет свободных слотов | {count} слот свободен | {count} слота свободно | {count} слотов свободно".',
   '- Do not translate product or component names: Ranch, Bridle, Paddock, Kubernetes, Argo Workflows, Docker.',
   '- Match the register of a modern product UI: short, direct, no marketing filler.',
   '- Keep the ending punctuation and letter case style of the source string.',
@@ -269,7 +275,7 @@ function report(work: Work[]): number {
     if (item.orphaned.length) lines.push(`  orphaned (${item.orphaned.length}): ${item.orphaned.join(', ')}`);
     if (item.invalid.length)
       lines.push(
-        `  unescaped @ or | (${item.invalid.length}): ${item.invalid.join(', ')} — write them as {'@'} / {'|'}`,
+        `  unescaped @ (${item.invalid.length}): ${item.invalid.join(', ')} — write it as {'@'}`,
       );
     if (!lines.length) continue;