@cat-factory/app 0.216.0 → 0.217.2

package/i18n/locales/it.json

@@ -2671,6 +2671,7 @@
       "continue": "Continua",
       "submit": "Aggiungi attività",
       "addFailedTitle": "Impossibile aggiungere l'attività",
+      "customFieldsInvalid": "Il modulo di questo tipo di attività è cambiato da quando lo hai aperto, quindi le risposte non corrispondono più a quanto richiesto. Chiudi e riapri la finestra per compilare i campi attuali.",
       "linkFailed": "Attività aggiunta, ma {count} allegato non è stato collegato | Attività aggiunta, ma {count} allegati non sono stati collegati",
       "review": {
         "prUrl": "Pull request",
@@ -4814,7 +4815,6 @@
       "titlePlaceholder": "es. Migrare l'API al nuovo modello di autenticazione",
       "goalField": "Obiettivo",
       "goalPlaceholder": "Descrivi l'obiettivo, i vincoli e l'ambito approssimativo. Il pianificatore lo affina in un piano multi-fase.",
-      "pathInvalid": "Inserisci un percorso all'interno del repository (senza \"..\", percorsi assoluti o barre rovesciate).",
       "hint": "Non viene eseguito ancora nulla: dopo la creazione, esegui la pipeline di Pianificazione dell'iniziativa sul blocco. Analizza il codebase e redige il piano multi-fase per la tua approvazione.",
       "submit": "Crea iniziativa",
       "failedTitle": "Impossibile creare l'iniziativa",
@@ -5027,7 +5027,8 @@
       "confirm": "Ignora",
       "keep": "Continua a modificare"
     },
-    "edit": "Modifica"
+    "edit": "Modifica",
+    "pathInvalid": "Inserisci un percorso all'interno del repository (senza \"..\", percorsi assoluti o barre rovesciate)."
   },
   "access": {
     "noBoardWrite": "Accesso in sola lettura: puoi visualizzare questa board ma non modificarla.",

package/i18n/locales/ja.json

@@ -83,7 +83,8 @@
       "confirm": "破棄",
       "keep": "編集を続ける"
     },
-    "edit": "編集"
+    "edit": "編集",
+    "pathInvalid": "リポジトリ内のパスを入力してください（\"..\"、絶対パス、バックスラッシュは使用できません）。"
   },
   "access": {
     "noBoardWrite": "読み取り専用アクセス: このボードは閲覧できますが編集はできません。",
@@ -298,6 +299,7 @@
       "continue": "続行",
       "submit": "タスクを追加",
       "addFailedTitle": "タスクを追加できませんでした",
+      "customFieldsInvalid": "このタスクタイプのフォームは開いたあとに変更されたため、入力内容が求められているものと一致しません。ダイアログを閉じて開き直し、現在の項目に入力してください。",
       "linkFailed": "タスクを追加しましたが、{count} 件の添付をリンクできませんでした | タスクを追加しましたが、{count} 件の添付をリンクできませんでした",
       "review": {
         "prUrl": "プルリクエスト",
@@ -5942,7 +5944,6 @@
       "titlePlaceholder": "例: API を新しい認証モデルへ移行する",
       "goalField": "ゴール",
       "goalPlaceholder": "ゴール、制約、おおまかなスコープを記述してください。プランナーが複数フェーズの計画に練り上げます。",
-      "pathInvalid": "リポジトリ内のパスを入力してください（\"..\"、絶対パス、バックスラッシュは使用できません）。",
       "hint": "この時点では何も実行されません。作成後、このブロックでイニシアチブ計画パイプラインを実行してください。コードベースを分析し、承認用の複数フェーズ計画を起草します。",
       "submit": "イニシアチブを作成",
       "failedTitle": "イニシアチブを作成できませんでした",

package/i18n/locales/pl.json

@@ -83,7 +83,8 @@
       "confirm": "Odrzuć",
       "keep": "Kontynuuj edycję"
     },
-    "edit": "Edytuj"
+    "edit": "Edytuj",
+    "pathInvalid": "Podaj sciezke wewnatrz repozytorium (bez \"..\", sciezek bezwzglednych ani ukosnikow wstecznych)."
   },
   "access": {
     "noBoardWrite": "Dostęp tylko do odczytu: możesz przeglądać tę tablicę, ale nie możesz jej edytować.",
@@ -298,6 +299,7 @@
       "continue": "Dalej",
       "submit": "Dodaj zadanie",
       "addFailedTitle": "Nie udało się dodać zadania",
+      "customFieldsInvalid": "Formularz tego typu zadania zmienił się od chwili otwarcia, więc odpowiedzi nie odpowiadają już temu, o co pyta. Zamknij i otwórz okno ponownie, aby wypełnić aktualne pola.",
       "linkFailed": "Zadanie dodane, ale nie udało się powiązać {count} załącznika | Zadanie dodane, ale nie udało się powiązać {count} załączników | Zadanie dodane, ale nie udało się powiązać {count} załączników",
       "review": {
         "prUrl": "Pull request",
@@ -3224,13 +3226,25 @@
       "executionBackend": {
         "label": "Gdzie działają agenci",
         "local-docker": "Lokalny Docker (host)",
+        "local-dockerDesc": "Uruchamia każdego agenta w kontenerze na demonie Dockera tej maszyny.",
         "cloudflare-containers": "Cloudflare Containers (wbudowane)",
-        "runner-pool": "Samodzielnie hostowana pula runnerów"
+        "cloudflare-containersDesc": "Uruchamia agentów na wbudowanej platformie kontenerów Cloudflare, po jednym na uruchomienie.",
+        "kubernetes": "Klaster Kubernetes",
+        "kubernetesDesc": "Uruchamia każdego agenta jako pod w klastrze Kubernetes, którym sam zarządzasz.",
+        "runner-pool": "Własna pula runnerów (HTTP)",
+        "runner-poolDesc": "Kieruje agentów do własnego harmonogramu za API manifestów HTTP.",
+        "k3s": "Lokalny Kubernetes (k3s)",
+        "k3sDesc": "Wypełnione wstępnie dla lokalnego klastra k3s/k3d na tej maszynie: wystarczy wkleić token."
       },
       "testEnvBackend": {
         "label": "Gdzie działają środowiska testowe",
-        "local-compose": "docker-compose w kontenerze",
-        "environment-provider": "Dostawca środowisk",
+        "local-compose": "docker-compose w kontenerze (zależności Testera)",
+        "local-composeDesc": "Uruchamia zależności Testera przez docker-compose wewnątrz kontenera uruchomienia. Pełne środowisko podglądu aplikacji znajdziesz w opcji środowiska podglądu Docker Compose poniżej.",
+        "kubernetes": "Klaster Kubernetes",
+        "kubernetesDesc": "Tworzy przestrzeń nazw dla każdego PR w klastrze Kubernetes, którym sam zarządzasz. Najlepsze dla aplikacji natywnych dla Kubernetes lub gdy już masz klaster.",
+        "environment-provider": "Własny dostawca HTTP",
+        "environment-providerDesc": "Tworzy efemeryczne środowiska przez własne API zarządzania HTTP. Najlepsze, gdy masz już własne narzędzia do środowisk podglądu.",
+        "compose": "Środowisko podglądu Docker Compose",
         "composeDesc": "Uruchamia własny plik docker-compose.yml repozytorium na lokalnym demonie Dockera jako adres URL Testera. Najlepsze dla lokalnych aplikacji opartych na Compose. Obsługuje gotowe obrazy lub budowanie ze źródeł; wymaga demona Dockera, więc tylko wdrożenia lokalne."
       },
       "dockerComposeInfo": "Usługi Docker Compose uruchamiają się na lokalnym Dockerze środowiska uruchomieniowego: połączenie nie jest potrzebne (kontener uruchomienia musi obsługiwać Docker-in-Docker). Skonfiguruj usługę, port i źródło obrazu (pobranie gotowego lub budowanie ze źródeł) w ustawieniach środowiska usługi.",
@@ -5930,7 +5944,6 @@
       "titlePlaceholder": "np. Migracja API do nowego modelu uwierzytelniania",
       "goalField": "Cel",
       "goalPlaceholder": "Opisz cel, ograniczenia i przyblizony zakres. Planista doprecyzuje to w wielofazowy plan.",
-      "pathInvalid": "Podaj sciezke wewnatrz repozytorium (bez \"..\", sciezek bezwzglednych ani ukosnikow wstecznych).",
       "hint": "Nic jeszcze nie jest uruchamiane: po utworzeniu uruchom na bloku pipeline planowania inicjatywy. Analizuje on kod i przygotowuje wielofazowy plan do zatwierdzenia.",
       "submit": "Utworz inicjatywe",
       "failedTitle": "Nie udalo sie utworzyc inicjatywy",
@@ -6286,7 +6299,7 @@
     "viewPr": "Zobacz pull request",
     "stalledNote": "Pętla zatrzymała się przedwcześnie: kolejne iteracje nie zmieniły gałęzi, a polecenie walidacji nadal kończy się niepowodzeniem, więc nie zużyła reszty budżetu. Zanim ponowna próba cokolwiek da, prawdopodobnie trzeba zmienić zadanie lub polecenie walidacji.",
     "iterationsHeading": "Iteracje",
-    "iterationsTruncated": "Nie pokazano {count} wcześniejszej iteracji (historia jest ograniczona). | Nie pokazano {count} wcześniejszych iteracji (historia jest ograniczona).",
+    "iterationsTruncated": "Nie pokazano {count} wcześniejszej iteracji (historia jest ograniczona). | Nie pokazano {count} wcześniejszych iteracji (historia jest ograniczona). | Nie pokazano {count} wcześniejszych iteracji (historia jest ograniczona).",
     "iteration": "Iteracja {number}",
     "iterationPassed": "walidacja zaliczona",
     "iterationFailed": "kod {exit}",
@@ -6423,9 +6436,9 @@
       "body": "Uruchomienia agentów wypychają zmiany poświadczeniem, które może zapisywać w każdym objętym repozytorium. Nic tutaj nie powstrzyma skompromitowanego uruchomienia przed wypchnięciem zmian wprost na gałąź domyślną ani przed scaleniem własnego pull requesta przez API hosta — oba przypadki pokrywa wyłącznie ochrona gałęzi po stronie hosta, którą konfigurujesz sam. To sprawdzenie pokazuje, czy jest włączona.",
       "check": "Sprawdź ochronę",
       "allProtected": "Gałąź domyślna każdego powiązanego repozytorium jest chroniona.",
-      "exposed": "{count} repozytorium ma niechronioną gałąź domyślną. | {count} repozytoria mają niechronioną gałąź domyślną.",
+      "exposed": "{count} repozytorium ma niechronioną gałąź domyślną. | {count} repozytoria mają niechronioną gałąź domyślną. | {count} repozytoriów ma niechronioną gałąź domyślną.",
       "unavailable": "Podłączony dostawca nie potrafi zgłosić ochrony gałęzi, więc to sprawdzenie nic nie mówi — to nie jest wynik pozytywny.",
-      "omitted": "Nie sprawdzono jeszcze {count} powiązanego repozytorium. | Nie sprawdzono jeszcze {count} powiązanych repozytoriów.",
+      "omitted": "Nie sprawdzono jeszcze {count} powiązanego repozytorium. | Nie sprawdzono jeszcze {count} powiązanych repozytoriów. | Nie sprawdzono jeszcze {count} powiązanych repozytoriów.",
       "state": {
         "protected": "Chroniona",
         "unprotected": "Niechroniona",

package/i18n/locales/tr.json

@@ -83,7 +83,8 @@
       "confirm": "At",
       "keep": "Düzenlemeye devam et"
     },
-    "edit": "Düzenle"
+    "edit": "Düzenle",
+    "pathInvalid": "Depo icinde bir yol girin (\"..\", mutlak yollar veya ters egik cizgi olmadan)."
   },
   "access": {
     "noBoardWrite": "Salt okunur erişim: bu panoyu görüntüleyebilirsiniz ancak düzenleyemezsiniz.",
@@ -298,6 +299,7 @@
       "continue": "Devam",
       "submit": "Görev ekle",
       "addFailedTitle": "Görev eklenemedi",
+      "customFieldsInvalid": "Bu görev türünün formu siz açtıktan sonra değişti, bu nedenle yanıtlar artık istenenle uyuşmuyor. İletişim kutusunu kapatıp yeniden açarak güncel alanları doldurun.",
       "linkFailed": "Görev eklendi, ancak {count} ek bağlanamadı | Görev eklendi, ancak {count} ek bağlanamadı",
       "review": {
         "prUrl": "Pull request",
@@ -5942,7 +5944,6 @@
       "titlePlaceholder": "orn. API'yi yeni kimlik dogrulama modeline tasi",
       "goalField": "Hedef",
       "goalPlaceholder": "Hedefi, kisitlari ve yaklasik kapsami aciklayin. Planlayici bunu cok asamali bir plana donusturur.",
-      "pathInvalid": "Depo icinde bir yol girin (\"..\", mutlak yollar veya ters egik cizgi olmadan).",
       "hint": "Henuz hicbir sey calismiyor: olusturduktan sonra blok uzerinde Girisim Planlama hattini calistirin. Kod tabanini analiz eder ve onayiniz icin cok asamali plani taslak olarak hazirlar.",
       "submit": "Girisim olustur",
       "failedTitle": "Girisim olusturulamadi",

package/i18n/locales/uk.json

@@ -83,7 +83,8 @@
       "confirm": "Відхилити",
       "keep": "Продовжити редагування"
     },
-    "edit": "Редагувати"
+    "edit": "Редагувати",
+    "pathInvalid": "Введіть шлях усередині репозиторію (без \"..\", абсолютних шляхів або зворотних скісних рисок)."
   },
   "access": {
     "noBoardWrite": "Доступ лише для перегляду: ви можете переглядати цю дошку, але не можете її редагувати.",
@@ -298,6 +299,7 @@
       "continue": "Продовжити",
       "submit": "Додати завдання",
       "addFailedTitle": "Не вдалося додати завдання",
+      "customFieldsInvalid": "Форма цього типу завдання змінилася з моменту, коли ви її відкрили, тому відповіді більше не відповідають запитаному. Закрийте та відкрийте вікно знову, щоб заповнити поточні поля.",
       "linkFailed": "Завдання додано, але не вдалося прив’язати {count} вкладення | Завдання додано, але не вдалося прив’язати {count} вкладення | Завдання додано, але не вдалося прив’язати {count} вкладень",
       "review": {
         "prUrl": "Pull request",
@@ -3224,13 +3226,25 @@
       "executionBackend": {
         "label": "Де виконуються агенти",
         "local-docker": "Локальний Docker (хост)",
+        "local-dockerDesc": "Запускає кожного агента в контейнері на демоні Docker цієї машини.",
         "cloudflare-containers": "Cloudflare Containers (вбудовано)",
-        "runner-pool": "Самостійно розміщений пул раннерів"
+        "cloudflare-containersDesc": "Запускає агентів на вбудованій платформі контейнерів Cloudflare, по одному на запуск.",
+        "kubernetes": "Кластер Kubernetes",
+        "kubernetesDesc": "Запускає кожного агента як pod у кластері Kubernetes, яким ви керуєте.",
+        "runner-pool": "Власний пул раннерів (HTTP)",
+        "runner-poolDesc": "Надсилає агентів до вашого власного планувальника за API маніфестів HTTP.",
+        "k3s": "Локальний Kubernetes (k3s)",
+        "k3sDesc": "Попередньо заповнено для локального кластера k3s/k3d на цій машині: достатньо вставити токен."
       },
       "testEnvBackend": {
         "label": "Де виконуються тестові середовища",
-        "local-compose": "docker-compose у контейнері",
-        "environment-provider": "Провайдер середовищ",
+        "local-compose": "docker-compose у контейнері (залежності Тестувальника)",
+        "local-composeDesc": "Піднімає залежності Тестувальника через docker-compose всередині контейнера запуску. Для повного середовища попереднього перегляду застосунку скористайтеся опцією середовища Docker Compose нижче.",
+        "kubernetes": "Кластер Kubernetes",
+        "kubernetesDesc": "Створює простір імен для кожного PR у кластері Kubernetes, яким ви керуєте. Найкраще підходить для застосунків, орієнтованих на Kubernetes, або якщо ви вже маєте кластер.",
+        "environment-provider": "Власний провайдер HTTP",
+        "environment-providerDesc": "Створює ефемерні середовища через ваш власний API керування HTTP. Найкраще підходить, якщо у вас уже є власні інструменти для середовищ попереднього перегляду.",
+        "compose": "Середовище попереднього перегляду Docker Compose",
         "composeDesc": "Піднімає власний docker-compose.yml репозиторію на локальному демоні Docker як URL Тестувальника. Найкраще підходить для локальних застосунків на основі Compose. Підтримує готові образи або збирання з вихідного коду; потребує демона Docker, тому лише для локальних розгортань."
       },
       "dockerComposeInfo": "Служби Docker Compose піднімаються на локальному Docker середовища виконання: підключення не потрібне (контейнер запуску має підтримувати Docker-in-Docker). Налаштуйте службу, порт і джерело образу (завантаження готового чи збирання з вихідного коду) у налаштуваннях середовища служби.",
@@ -5930,7 +5944,6 @@
       "titlePlaceholder": "напр. Перенести API на нову модель автентифікації",
       "goalField": "Мета",
       "goalPlaceholder": "Опишіть мету, обмеження та приблизний обсяг. Планувальник перетворить це на багатофазний план.",
-      "pathInvalid": "Введіть шлях усередині репозиторію (без \"..\", абсолютних шляхів або зворотних скісних рисок).",
       "hint": "Поки що нічого не запускається: після створення запустіть на блоці пайплайн планування ініціативи. Він аналізує кодову базу та готує багатофазний план на ваше затвердження.",
       "submit": "Створити ініціативу",
       "failedTitle": "Не вдалося створити ініціативу",
@@ -6286,7 +6299,7 @@
     "viewPr": "Переглянути pull request",
     "stalledNote": "Цикл зупинився достроково: послідовні ітерації не змінили гілку, а команда перевірки досі не проходить, тож решту бюджету не витрачено. Імовірно, перш ніж повторний запуск допоможе, потрібно змінити завдання або команду перевірки.",
     "iterationsHeading": "Ітерації",
-    "iterationsTruncated": "Не показано {count} попередню ітерацію (історія обмежена). | Не показано {count} попередніх ітерацій (історія обмежена).",
+    "iterationsTruncated": "Не показано {count} попередню ітерацію (історія обмежена). | Не показано {count} попередні ітерації (історія обмежена). | Не показано {count} попередніх ітерацій (історія обмежена).",
     "iteration": "Ітерація {number}",
     "iterationPassed": "перевірку пройдено",
     "iterationFailed": "код {exit}",
@@ -6423,9 +6436,9 @@
       "body": "Запуски агентів надсилають зміни обліковими даними, які можуть писати в кожен охоплений репозиторій. Ніщо тут не завадить скомпрометованому запуску надіслати зміни просто до типової гілки або злити власний запит на злиття через API хоста — обидва випадки покриває лише захист гілок на боці хоста, і його налаштовуєте ви. Ця перевірка показує, чи він увімкнений.",
       "check": "Перевірити захист",
       "allProtected": "Типова гілка кожного приєднаного репозиторію захищена.",
-      "exposed": "{count} репозиторій має незахищену типову гілку. | {count} репозиторії мають незахищену типову гілку.",
+      "exposed": "{count} репозиторій має незахищену типову гілку. | {count} репозиторії мають незахищену типову гілку. | {count} репозиторіїв мають незахищену типову гілку.",
       "unavailable": "Приєднаний постачальник не вміє повідомляти про захист гілок, тож цій перевірці нема чого сказати — це не чистий результат.",
-      "omitted": "Ще {count} приєднаний репозиторій не перевірено. | Ще {count} приєднаних репозиторіїв не перевірено.",
+      "omitted": "Ще {count} приєднаний репозиторій не перевірено. | Ще {count} приєднані репозиторії не перевірено. | Ще {count} приєднаних репозиторіїв не перевірено.",
       "state": {
         "protected": "Захищена",
         "unprotected": "Незахищена",

package/i18n/plural-forms.spec.ts

@@ -0,0 +1,76 @@
+import { readFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { describe, expect, it } from 'vitest'
+import { allowedFormCounts, type OverriddenLocale } from './plural-rules'
+
+// Catalog invariant for the locales whose plural selector is overridden (`plural-rules.ts`).
+//
+// Neither existing i18n gate can see this class of breakage. `i18n:check` only asks whether a
+// key EXISTS, and the locale-parity guard only asks whether a key MOVED with `en`; both pass on
+// a `he` entry that carries the wrong NUMBER of pipe-separated forms. The damage is silent and
+// total: the form count is what tells the selector whether the entry leads with a zero form, so
+// one form too few does not drop a case, it re-points every remaining slot onto a different
+// count. Too few forms outright is worse still, since the clamp then renders one form for
+// several distinct counts.
+//
+// (This lives as a test rather than a `scripts/*.mjs` guard like its two neighbours so it can
+// import the slot contract from `plural-rules.ts` instead of restating the allowed counts,
+// which is precisely the coupling that would rot.)
+
+const LOCALES: OverriddenLocale[] = ['pl', 'uk', 'he']
+const SOURCE_LOCALE = 'en'
+
+// Resolved off the vitest root (the package dir) rather than `import.meta.url`, which the
+// happy-dom environment rewrites to a server-root-relative path.
+function loadCatalog(locale: string): Map<string, string> {
+  const path = join(process.cwd(), 'i18n', 'locales', `${locale}.json`)
+  const out = new Map<string, string>()
+  const walk = (node: unknown, prefix: string) => {
+    for (const [key, value] of Object.entries(node as Record<string, unknown>)) {
+      // `@<key>` siblings are translator notes, live only in `en`, and are never rendered —
+      // their prose may contain a pipe without being a plural.
+      if (key.startsWith('@')) continue
+      const path = prefix ? `${prefix}.${key}` : key
+      if (typeof value === 'string') out.set(path, value)
+      else if (value && typeof value === 'object') walk(value, path)
+    }
+  }
+  walk(JSON.parse(readFileSync(path, 'utf8')), '')
+  return out
+}
+
+const catalogs = new Map(
+  [SOURCE_LOCALE, ...LOCALES].map((locale) => [locale, loadCatalog(locale)] as const),
+)
+
+/** Pipe-separated plural entries only; a message with no pipe never reaches a selector. */
+function pluralEntries(locale: string): [string, string[]][] {
+  return [...catalogs.get(locale)!]
+    .filter(([, value]) => value.includes('|'))
+    .map(([key, value]) => [key, value.split('|')])
+}
+
+describe.each(LOCALES)('%s plural entries', (locale) => {
+  const allowed = allowedFormCounts(locale)
+
+  it(`carry ${allowed.join(' or ')} forms`, () => {
+    const offenders = pluralEntries(locale)
+      .filter(([, forms]) => !allowed.includes(forms.length))
+      .map(([key, forms]) => `${key}: ${forms.length} forms (expected ${allowed.join(' or ')})`)
+    expect(offenders).toEqual([])
+  })
+
+  // The mirror image: a key `en` pluralizes but this locale renders as one flat string never
+  // reaches the selector at all, so it reads as a singular at every count. Nothing else notices,
+  // because the key is present and moved with `en` exactly as both other gates require.
+  it('pluralize every key `en` pluralizes', () => {
+    const catalog = catalogs.get(locale)!
+    const missing = pluralEntries(SOURCE_LOCALE)
+      .map(([key]) => key)
+      .filter((key) => {
+        const translated = catalog.get(key)
+        return translated !== undefined && !translated.includes('|')
+      })
+    expect(missing).toEqual([])
+  })
+})

package/i18n/plural-rules.spec.ts

@@ -0,0 +1,98 @@
+import { describe, expect, it } from 'vitest'
+import { allowedFormCounts, pluralRules, type OverriddenLocale } from './plural-rules'
+
+// The slot order each overridden locale's CLDR categories fill, matching `plural-rules.ts`.
+// Naming them as CLDR category strings is what lets the tests below compare against
+// `Intl.PluralRules`, the platform's own copy of the same CLDR data: a hand-written rule that
+// drifts from ICU (because CLDR revised the locale, or because the rule was wrong to begin
+// with) fails here instead of quietly rendering the wrong form.
+const CATEGORY_ORDER: Record<OverriddenLocale, readonly Intl.LDMLPluralRule[]> = {
+  pl: ['one', 'few', 'many'],
+  uk: ['one', 'few', 'many'],
+  he: ['one', 'two', 'other'],
+}
+
+const LOCALES = Object.keys(CATEGORY_ORDER) as OverriddenLocale[]
+
+/** The CLDR category a selector resolves `n` to, for an entry carrying only the CLDR forms. */
+function categoryFor(locale: OverriddenLocale, n: number): Intl.LDMLPluralRule {
+  const order = CATEGORY_ORDER[locale]
+  return order[pluralRules[locale](n, order.length)]!
+}
+
+describe('plural selectors agree with Intl.PluralRules', () => {
+  // Every whole count a UI badge can plausibly show. The Slavic rules key off n % 100, and
+  // Hebrew's off n itself, so 0..1000 exercises both far past their period.
+  it.each(LOCALES)('%s over whole counts 0..1000', (locale) => {
+    const icu = new Intl.PluralRules(locale)
+    const disagreements = Array.from({ length: 1001 }, (_, n) => n)
+      .map((n) => ({ n, ours: categoryFor(locale, n), icu: icu.select(n) }))
+      .filter(({ ours, icu: theirs }) => ours !== theirs)
+    expect(disagreements).toEqual([])
+  })
+
+  // Hebrew is exact over fractions too. The Slavic locales are deliberately not: CLDR routes
+  // their fractions to an `other` category the 3-form catalogs carry no slot for, so the rule
+  // folds those onto `many` (documented in `plural-rules.ts`) and cannot be compared here.
+  it('he over fractional counts', () => {
+    const icu = new Intl.PluralRules('he')
+    const fractions = [0.1, 0.5, 0.9, 1.1, 1.5, 2.5, 3.5, 10.5, 20.5, 100.5]
+    for (const n of fractions) expect(categoryFor('he', n)).toBe(icu.select(n))
+  })
+
+  it('treats a negative count as its magnitude', () => {
+    for (const locale of LOCALES) {
+      for (const n of [1, 2, 3, 5, 22]) {
+        expect(pluralRules[locale](-n, 3)).toBe(pluralRules[locale](n, 3))
+      }
+    }
+  })
+})
+
+describe('the leading zero form', () => {
+  // One optional slot may precede the CLDR forms: a copy nicety ("no participants"), NOT a
+  // CLDR category. An entry that carries it shifts every other slot by one, which is why the
+  // form count is part of the contract rather than an authoring detail.
+  it('is selected only for 0, and only when the entry carries it', () => {
+    for (const locale of LOCALES) {
+      const [cldrOnly, withZero] = allowedFormCounts(locale) as [number, number]
+      expect(pluralRules[locale](0, withZero)).toBe(0)
+      // Without a zero slot, 0 falls to whatever category the locale puts it in, never to
+      // the `one` form.
+      expect(pluralRules[locale](0, cldrOnly)).not.toBe(0)
+      for (const n of [1, 2, 3, 5, 11, 22]) {
+        expect(pluralRules[locale](n, withZero)).toBe(pluralRules[locale](n, cldrOnly) + 1)
+      }
+    }
+  })
+})
+
+describe('an entry with too few forms', () => {
+  // A short entry is a CI failure (`scripts/i18n-plural-forms.mjs`). At RUNTIME the selector
+  // still has to answer with an in-range index: vue-i18n indexes the form array raw and throws
+  // out of `t()` on an out-of-range answer, which blanks the whole surface rendering it rather
+  // than degrading to an approximate form.
+  it('clamps to the last form instead of running off the end', () => {
+    for (const locale of LOCALES) {
+      for (const forms of [1, 2]) {
+        for (let n = 0; n <= 200; n++) {
+          const index = pluralRules[locale](n, forms)
+          expect(index).toBeGreaterThanOrEqual(0)
+          expect(index).toBeLessThan(forms)
+        }
+      }
+    }
+  })
+})
+
+describe('hebrew', () => {
+  // The behaviour this module exists to add: 2 is its own form, where the default 2-form
+  // selector lumped it in with the plural.
+  it('gives 2 a form of its own', () => {
+    const forms = ['one', 'two', 'other']
+    expect(forms[pluralRules.he(1, 3)]).toBe('one')
+    expect(forms[pluralRules.he(2, 3)]).toBe('two')
+    expect(forms[pluralRules.he(3, 3)]).toBe('other')
+    expect(forms[pluralRules.he(20, 3)]).toBe('other')
+  })
+})

package/i18n/plural-rules.ts

@@ -0,0 +1,123 @@
+// Per-locale plural SELECTORS for vue-i18n: given a count and how many forms a catalog entry
+// carries, return the index of the form to render. Wired onto `pluralRules` in `i18n.config.ts`;
+// this module is deliberately free of Nuxt/vue-i18n imports so it unit-tests as pure logic
+// (`plural-rules.spec.ts`).
+//
+// vue-i18n's BUILT-IN selector implements neither Slavic nor Semitic agreement: for a 2-form
+// entry it picks index 0 when n === 1 and index 1 otherwise, and for a 3-form entry it picks
+// 0/1/2 for n === 0 / n === 1 / n > 1. That is right for `en`/`es`/`fr`/`de`/`it`/`ja`/`tr`
+// (which are therefore NOT listed here) and wrong everywhere below.
+//
+// ## The slot contract a catalog entry declares by its FORM COUNT
+//
+// A locale's CLDR categories fill the trailing slots, in the order named by `CLDR_CATEGORIES`
+// below. One optional slot may precede them: a ZERO form, which is a COPY nicety rather than a
+// CLDR category ("no participants" reads better than "0 participants") and which `en` already
+// uses. So for a locale with 3 CLDR categories:
+//
+//   3 forms  ->  <cat0> | <cat1> | <cat2>
+//   4 forms  ->  zero | <cat0> | <cat1> | <cat2>
+//
+// The count is therefore load-bearing: dropping a form does not degrade the message, it
+// RE-POINTS every remaining slot onto a different count. `scripts/i18n-plural-forms.mjs` fails
+// CI on an entry whose form count is not one of the two shapes, because nothing else can catch
+// it (a short entry renders confidently and wrongly, and vue-i18n throws outright when a
+// selector returns an index past the end).
+
+/** A vue-i18n plural selector: `(count, formsInThisEntry) => index of the form to render`. */
+export type PluralSelector = (choice: number, choicesLength: number) => number
+
+// Polish and Ukrainian share the `few` bucket but NOT the `one` bucket, and one rule serving
+// both is what this pair of functions replaced: Polish reserves `one` for exactly 1, while
+// Ukrainian gives it to every count ending in 1 except the teens, so 21/31/…/101 were rendering
+// the `many` form ("21 репозиторіїв" for "21 репозиторій") on 89 of the first 1000 counts.
+const slavicFew = (mod10: number, mod100: number): boolean =>
+  mod10 >= 2 && mod10 <= 4 && (mod100 < 12 || mod100 > 14)
+
+/**
+ * Polish one/few/many, e.g. "decyzja | decyzje | decyzji".
+ *
+ * CLDR also gives Polish an `other` category, reached only by fractional counts. The catalogs
+ * carry no slot for it and a count here is always a whole number of things, so a fraction
+ * collapses onto `many`, which is the form Polish uses for a decimal anyway ("2,5 decyzji").
+ * The same holds for Ukrainian below.
+ */
+const polishCategory = (n: number): number => {
+  if (n === 1) return 0 // one
+  if (slavicFew(n % 10, n % 100)) return 1 // few
+  return 2 // many (incl. 0, 5-21, ...)
+}
+
+/** Ukrainian one/few/many, e.g. "рішення | рішення | рішень". */
+const ukrainianCategory = (n: number): number => {
+  const mod10 = n % 10
+  const mod100 = n % 100
+  if (mod10 === 1 && mod100 !== 11) return 0 // one (1, 21, 31, ..., 101, ...)
+  if (slavicFew(mod10, mod100)) return 1 // few
+  return 2 // many (incl. 0, 5-20, ...)
+}
+
+/**
+ * Hebrew one/two/other (CLDR `he`): a distinct DUAL, which is why running `he` on the default
+ * 2-form selector made every count message an approximation. n === 2 takes its own form, both
+ * for the lexical duals ("יומיים" for two days, "פעמיים" for twice) and for the spelled-out
+ * numeral ordinary prose wants ("שתי משימות" rather than "2 משימות").
+ *
+ * Fractions follow CLDR too: a count below 1 is `one` (0.5 -> "one"), a fractional count at or
+ * above 1 is `other`. `plural-rules.spec.ts` asserts the whole domain against `Intl.PluralRules`,
+ * so an ICU/CLDR revision to Hebrew fails a test rather than silently disagreeing with the
+ * platform's own formatter.
+ *
+ * Note the CLDR rule has THREE categories, not the four (one/two/many/other) it carried before
+ * the `many` bucket for round tens was retired: modern Hebrew does not inflect for it, so asking
+ * a translator to author that form would only produce a duplicate of `other`.
+ */
+const hebrewCategory = (n: number): number => {
+  const integerPart = Math.floor(n)
+  if (n !== integerPart) return integerPart === 0 ? 0 : 2 // one below 1, otherwise other
+  if (integerPart === 1) return 0 // one
+  if (integerPart === 2) return 1 // two
+  return 2 // other (incl. 0)
+}
+
+/** How many CLDR categories each overridden locale's rule resolves, in slot order. */
+const CLDR_CATEGORIES = {
+  pl: { count: 3, category: polishCategory },
+  uk: { count: 3, category: ukrainianCategory },
+  he: { count: 3, category: hebrewCategory },
+} as const
+
+/** The locales whose plural selector is overridden, i.e. the ones the form-count guard covers. */
+export type OverriddenLocale = keyof typeof CLDR_CATEGORIES
+
+/**
+ * The form counts a catalog entry may carry in `locale`: the CLDR categories alone, or those
+ * preceded by the optional zero form. Exported so the CI guard and this module agree on the
+ * contract by construction instead of by two copies of the same numbers.
+ */
+export function allowedFormCounts(locale: OverriddenLocale): readonly number[] {
+  const { count } = CLDR_CATEGORIES[locale]
+  return [count, count + 1]
+}
+
+function selectorFor(locale: OverriddenLocale): PluralSelector {
+  const { count: cldrForms, category } = CLDR_CATEGORIES[locale]
+  return (choice, choicesLength) => {
+    const n = Math.abs(choice)
+    // More forms than the locale has categories means the entry leads with a zero form.
+    const hasZeroForm = choicesLength > cldrForms
+    if (hasZeroForm && n === 0) return 0
+    const index = (hasZeroForm ? 1 : 0) + category(n)
+    // An entry with too FEW forms is a CI failure, not a runtime one: clamping renders the
+    // nearest form instead of handing vue-i18n an out-of-range index, which it rejects by
+    // throwing out of `t()` and blanking whatever was rendering the message.
+    return Math.min(index, choicesLength - 1)
+  }
+}
+
+/** vue-i18n's `pluralRules` map: only the locales the built-in selector gets wrong. */
+export const pluralRules: Record<OverriddenLocale, PluralSelector> = {
+  pl: selectorFor('pl'),
+  uk: selectorFor('uk'),
+  he: selectorFor('he'),
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.216.0",
+  "version": "0.217.2",
   "description": "Reusable Nuxt layer for the Agent Architecture Board SPA (components, stores, composables, pages). Consume it from a thin deployment app via `extends: ['@cat-factory/app']` and point it at your backend with NUXT_PUBLIC_API_BASE. See deploy/frontend for an example.",
   "repository": {
     "type": "git",
@@ -40,7 +40,7 @@
     "valibot": "^1.4.2",
     "vue": "3.5.40",
     "wretch": "^3.0.9",
-    "@cat-factory/contracts": "0.229.0"
+    "@cat-factory/contracts": "0.230.1"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",