@cat-factory/app 0.100.1 → 0.100.3

package/app/components/board/AgentFailureCard.vue

@@ -4,6 +4,7 @@
 // the unified retry through the agentRuns store, so every surface (board card,
 // inspector, task panel) gets identical behaviour from one place. Replaces the
 // three hand-rolled bootstrap banners that used to duplicate this logic.
+import type { EnvironmentFailureReason } from '@cat-factory/contracts'
 import type { AgentRunSummary } from '~/stores/agentRuns'
 import FailureDetail from '~/components/board/FailureDetail.vue'
 
@@ -14,9 +15,59 @@ const props = withDefaults(
 
 const { t } = useI18n()
 const agentRuns = useAgentRunsStore()
+const ui = useUiStore()
+const auth = useAuthStore()
+const board = useBoardStore()
 
 const compact = computed(() => props.variant === 'compact')
 const failure = computed(() => props.run.failure)
+// An `environment` failure is a provisioning/config problem, so offer a one-click jump to the
+// place it's configured alongside the retry — the same "Configure…" deep-link pattern the
+// infra-setup banners use.
+const isEnvironmentFailure = computed(() => failure.value?.kind === 'environment')
+const DEPLOY_RUNNER_UNWIRED: EnvironmentFailureReason = 'deploy_runner_unwired'
+
+// The provision type of the failed run's SERVICE frame (walk up to the frame, mirroring the
+// backend's `resolveServiceProvisioning`). Drives the K8s-specific gate below.
+const provisionType = computed(() => {
+  const block = board.getBlock(props.run.blockId)
+  return block ? board.serviceOf(block)?.provisioning?.type : undefined
+})
+
+// Where the deep-link should land. A `deploy_runner_unwired` cause is fixed by wiring the DEPLOY
+// RUNNER, which is the same self-hosted runner pool that runs agent containers (Infrastructure →
+// "Agent containers" / `runner-pool`) — NOT the environment-provider connection (Infrastructure →
+// "Test environments" / `environment`), where the generic banner would otherwise dead-end. So route
+// that cause to the runner-pool tab on a non-local deployment; local mode's fix is an env var (the
+// hint below, not a UI tab), and every OTHER environment failure is a provider-config problem that
+// belongs on the environment tab.
+const routesToRunnerPool = computed(
+  () =>
+    isEnvironmentFailure.value &&
+    failure.value?.reason === DEPLOY_RUNNER_UNWIRED &&
+    auth.localMode?.enabled !== true,
+)
+function openFailureSetup() {
+  ui.openProviderConnection(routesToRunnerPool.value ? 'runner-pool' : 'environment')
+}
+const failureSetupLabel = computed(() =>
+  routesToRunnerPool.value
+    ? t('board.failure.deployRunnerSetup')
+    : t('board.failure.environmentSetup'),
+)
+
+// The env-var hint is Kubernetes+local specific, so gate it precisely rather than showing it for
+// every environment failure: only for the machine-readable `deploy_runner_unwired` cause (NOT a
+// helm/apply error or a transient blip), only in local mode (where the deploy runtime is an env
+// var, not a UI connection the tab could fix), and only for a `kubernetes` provision (so a future
+// Nomad/custom provider triggering the same cause never shows kubectl/kustomize/helm guidance).
+const showEnvironmentLocalHint = computed(
+  () =>
+    isEnvironmentFailure.value &&
+    auth.localMode?.enabled === true &&
+    failure.value?.reason === DEPLOY_RUNNER_UNWIRED &&
+    provisionType.value === 'kubernetes',
+)
 const title = computed(() => {
   // A `dispatch` failure means the container/runner never accepted the job — say so
   // explicitly rather than the generic "Run failed", and show the verbatim provider
@@ -83,6 +134,22 @@ async function retry() {
       {{ failure.hint }}
     </p>
 
+    <!-- Local mode only: the deploy runtime is configured via env vars, not a UI connection, so
+         name the concrete .env fix rather than only pointing at the (unhelpful-here) tab. -->
+    <p
+      v-if="showEnvironmentLocalHint && !compact"
+      class="mt-1 text-[11px] leading-snug text-rose-400/70"
+      data-testid="agent-failure-environment-local-hint"
+    >
+      {{
+        t('board.failure.environmentLocalHint', {
+          runtime: 'LOCAL_DEPLOY_RUNTIME',
+          native: 'LOCAL_DEPLOY_HARNESS_ENTRY',
+          container: 'LOCAL_DEPLOY_IMAGE',
+        })
+      }}
+    </p>
+
     <FailureDetail
       v-if="!compact && failure"
       :detail="failure.detail"
@@ -91,19 +158,38 @@ async function retry() {
       pre-class="bg-rose-950/60 text-[10px] text-rose-200/80"
     />
 
-    <button
-      type="button"
-      class="nodrag mt-2 flex items-center gap-1 rounded-md bg-rose-900/40 text-rose-200 hover:bg-rose-900/70 disabled:opacity-60"
-      :class="compact ? 'px-2 py-0.5 text-[10px]' : 'px-2 py-1 text-[11px]'"
-      :disabled="retrying"
-      data-testid="agent-failure-retry"
-      @click.stop="retry"
-    >
-      <UIcon
-        :name="retrying ? 'i-lucide-loader-circle' : 'i-lucide-rotate-ccw'"
-        :class="[compact ? 'h-3 w-3' : 'h-3.5 w-3.5', { 'animate-spin': retrying }]"
-      />
-      {{ retrying ? t('board.failure.retrying') : compact ? t('common.retry') : retryLabel }}
-    </button>
+    <div class="mt-2 flex flex-wrap items-center gap-2">
+      <button
+        type="button"
+        class="nodrag flex items-center gap-1 rounded-md bg-rose-900/40 text-rose-200 hover:bg-rose-900/70 disabled:opacity-60"
+        :class="compact ? 'px-2 py-0.5 text-[10px]' : 'px-2 py-1 text-[11px]'"
+        :disabled="retrying"
+        data-testid="agent-failure-retry"
+        @click.stop="retry"
+      >
+        <UIcon
+          :name="retrying ? 'i-lucide-loader-circle' : 'i-lucide-rotate-ccw'"
+          :class="[compact ? 'h-3 w-3' : 'h-3.5 w-3.5', { 'animate-spin': retrying }]"
+        />
+        {{ retrying ? t('board.failure.retrying') : compact ? t('common.retry') : retryLabel }}
+      </button>
+
+      <!-- Environment provisioning failures are almost always a deploy-backend / provider-config
+           issue, so link straight to where it's set up rather than leaving the user to hunt. The
+           destination + label follow the cause: a `deploy_runner_unwired` failure needs the runner
+           pool (Agent containers tab), every other cause needs the environment provider (Test
+           environments tab) — see `routesToRunnerPool`. -->
+      <button
+        v-if="isEnvironmentFailure"
+        type="button"
+        class="nodrag flex items-center gap-1 rounded-md bg-rose-900/20 text-rose-300 hover:bg-rose-900/50"
+        :class="compact ? 'px-2 py-0.5 text-[10px]' : 'px-2 py-1 text-[11px]'"
+        data-testid="agent-failure-configure-environment"
+        @click.stop="openFailureSetup"
+      >
+        <UIcon name="i-lucide-settings" :class="compact ? 'h-3 w-3' : 'h-3.5 w-3.5'" />
+        {{ failureSetupLabel }}
+      </button>
+    </div>
   </div>
 </template>

package/app/components/settings/InfraHandlersConfigurator.vue

@@ -137,6 +137,28 @@ async function testSavedKube() {
   }
 }
 
+// Auto-probe a SAVED kube connection as soon as the window shows one, so the operator sees a
+// LIVE verdict instead of a bare "connection established" card that only means a config is
+// stored — the token can have silently expired (a `kubectl create token` token is short-lived)
+// or the cluster been recreated, which the static card would misleadingly present as healthy.
+// Keyed on the stored config so it re-probes after an edit, and resets when disconnected so a
+// reconnect re-probes; the probe reuses the server-side saved token (empty secrets).
+const autoTestedKubeKey = ref<string | null>(null)
+watch(
+  kubeHandler,
+  (h) => {
+    if (!h) {
+      autoTestedKubeKey.value = null
+      return
+    }
+    const key = JSON.stringify(h.config)
+    if (autoTestedKubeKey.value === key) return
+    autoTestedKubeKey.value = key
+    void testSavedKube()
+  },
+  { immediate: true },
+)
+
 async function testKubeOverride(payload: {
   config: KubeHandlerConfig
   secrets: Record<string, string>

package/i18n/locales/en.json

@@ -297,6 +297,12 @@
       "stalled": "Run stalled",
       "retryBootstrap": "Retry bootstrap",
       "retryRun": "Retry run",
+      "environmentSetup": "Set up environments",
+      "deployRunnerSetup": "Set up runner pool",
+      "environmentLocalHint": "Local ephemeral environments need a deploy runtime to run kubectl/kustomize/helm. Set {runtime} in your .env: native mode runs those tools on your host ({native}), container mode runs them in the deploy image ({container}).",
+      "@environmentLocalHint": {
+        "description": "Shown only in local mode. The {runtime}/{native}/{container} placeholders are injected literal environment-variable names (LOCAL_DEPLOY_RUNTIME etc.) — keep them as placeholders, do not translate. '.env' is a filename, keep it verbatim."
+      },
       "showDetail": "Show detail",
       "retrying": "Retrying…",
       "history": {
@@ -1772,7 +1778,7 @@
         "remote-kubernetes": "Remote Kubernetes"
       },
       "kubernetesEngine": {
-        "localK3sHint": "Prefilled for a local k3s/k3d/kind cluster on this machine. Bind a ServiceAccount to a role, mint its token with `kubectl create token NAME -n NAMESPACE` (Kubernetes 1.24+), and paste it below. Then choose how the environment URL is derived, and edit the API server URL if your cluster listens on a different port.",
+        "localK3sHint": "Prefilled for a local k3s/k3d/kind cluster on this machine. Bind a ServiceAccount to a role and paste a long-lived token below. Note a plain `kubectl create token NAME -n NAMESPACE` token expires in 1 hour: add `--duration=720h` for longer, or create a non-expiring kubernetes.io/service-account-token Secret and read it back. Then choose how the environment URL is derived, and edit the API server URL if your cluster listens on a different port.",
         "autoSetup": {
           "title": "Auto-setup with the CLI",
           "description": "Run this in your terminal to probe or provision a local cluster, mint a ServiceAccount token, and open this form pre-filled. Paste the token it prints, then Test and Save."

package/i18n/locales/es.json

@@ -276,6 +276,9 @@
       "stalled": "La ejecución se estancó",
       "retryBootstrap": "Reintentar arranque",
       "retryRun": "Reintentar ejecución",
+      "environmentSetup": "Configurar entornos",
+      "deployRunnerSetup": "Configurar pool de runners",
+      "environmentLocalHint": "Los entornos efímeros locales necesitan un runtime de despliegue para ejecutar kubectl/kustomize/helm. Define {runtime} en tu .env: el modo nativo ejecuta esas herramientas en tu host ({native}), el modo contenedor las ejecuta en la imagen de despliegue ({container}).",
       "showDetail": "Mostrar detalle",
       "retrying": "Reintentando…",
       "history": {
@@ -2274,7 +2277,7 @@
         "remote-kubernetes": "Kubernetes remoto"
       },
       "kubernetesEngine": {
-        "localK3sHint": "Precargado para un clúster local k3s/k3d/kind en esta máquina. Vincula una ServiceAccount a un rol, genera su token con `kubectl create token NAME -n NAMESPACE` (Kubernetes 1.24+) y pégalo abajo. Luego elige cómo se deriva la URL del entorno y edita la URL del API server si tu clúster escucha en otro puerto.",
+        "localK3sHint": "Precargado para un clúster local k3s/k3d/kind en esta máquina. Vincula una ServiceAccount a un rol y pega abajo un token de larga duración. Ten en cuenta que un token de `kubectl create token NAME -n NAMESPACE` simple caduca en 1 hora: añade `--duration=720h` para que dure más, o crea un Secret kubernetes.io/service-account-token que no caduca y léelo. Luego elige cómo se deriva la URL del entorno y edita la URL del API server si tu clúster escucha en otro puerto.",
         "autoSetup": {
           "title": "Configuración automática con la CLI",
           "description": "Ejecútalo en tu terminal para detectar o aprovisionar un clúster local, generar un token de ServiceAccount y abrir este formulario ya rellenado. Pega el token que muestra y luego pulsa Probar y Guardar."

package/i18n/locales/fr.json

@@ -276,6 +276,9 @@
       "stalled": "L’exécution est bloquée",
       "retryBootstrap": "Relancer l’initialisation",
       "retryRun": "Relancer l’exécution",
+      "environmentSetup": "Configurer les environnements",
+      "deployRunnerSetup": "Configurer le pool de runners",
+      "environmentLocalHint": "Les environnements éphémères locaux nécessitent un runtime de déploiement pour exécuter kubectl/kustomize/helm. Définissez {runtime} dans votre .env : le mode natif exécute ces outils sur votre hôte ({native}), le mode conteneur les exécute dans l'image de déploiement ({container}).",
       "showDetail": "Afficher le détail",
       "retrying": "Nouvelle tentative…",
       "history": {
@@ -2274,7 +2277,7 @@
         "remote-kubernetes": "Kubernetes distant"
       },
       "kubernetesEngine": {
-        "localK3sHint": "Prérempli pour un cluster local k3s/k3d/kind sur cette machine. Liez un ServiceAccount à un rôle, générez son token avec `kubectl create token NAME -n NAMESPACE` (Kubernetes 1.24+) et collez-le ci-dessous. Choisissez ensuite comment l'URL de l'environnement est dérivée, et modifiez l'URL de l'API server si votre cluster écoute sur un autre port.",
+        "localK3sHint": "Prérempli pour un cluster local k3s/k3d/kind sur cette machine. Liez un ServiceAccount à un rôle et collez ci-dessous un token de longue durée. Notez qu'un token `kubectl create token NAME -n NAMESPACE` simple expire au bout d'1 heure : ajoutez `--duration=720h` pour prolonger sa durée, ou créez un Secret kubernetes.io/service-account-token qui n'expire pas et relisez-le. Choisissez ensuite comment l'URL de l'environnement est dérivée, et modifiez l'URL de l'API server si votre cluster écoute sur un autre port.",
         "autoSetup": {
           "title": "Configuration automatique avec la CLI",
           "description": "Exécutez-le dans votre terminal pour détecter ou provisionner un cluster local, générer un jeton de ServiceAccount et ouvrir ce formulaire prérempli. Collez le jeton affiché, puis cliquez sur Tester et Enregistrer."

package/i18n/locales/he.json

@@ -276,6 +276,9 @@
       "stalled": "הריצה נתקעה",
       "retryBootstrap": "נסה שוב לאתחל",
       "retryRun": "נסה שוב להריץ",
+      "environmentSetup": "הגדרת סביבות",
+      "deployRunnerSetup": "הגדרת מאגר ראנרים",
+      "environmentLocalHint": "סביבות זמניות מקומיות זקוקות לזמן ריצה לפריסה כדי להריץ את kubectl/kustomize/helm. הגדירו את {runtime} בקובץ ה-.env שלכם: מצב מקורי מריץ את הכלים האלה על המארח שלכם ({native}), מצב מכולה מריץ אותם בתוך תמונת הפריסה ({container}).",
       "showDetail": "הצג פרטים",
       "retrying": "מנסה שוב…",
       "history": {
@@ -1725,7 +1728,7 @@
         "remote-kubernetes": "Kubernetes מרוחק"
       },
       "kubernetesEngine": {
-        "localK3sHint": "מולא מראש עבור אשכול k3s/k3d/kind מקומי במחשב הזה. קשרו ServiceAccount לתפקיד, הנפיקו עבורו token באמצעות `kubectl create token NAME -n NAMESPACE` (Kubernetes 1.24+) והדביקו אותו למטה. לאחר מכן בחרו כיצד נגזרת כתובת ה-URL של הסביבה, וערכו את כתובת ה-API server אם האשכול שלכם מאזין ביציאה אחרת.",
+        "localK3sHint": "מולא מראש עבור אשכול k3s/k3d/kind מקומי במחשב הזה. קשרו ServiceAccount לתפקיד והדביקו למטה token בעל תוקף ארוך. שימו לב ש-token רגיל מ-`kubectl create token NAME -n NAMESPACE` פג תוקף לאחר שעה אחת: הוסיפו `--duration=720h` לתוקף ארוך יותר, או צרו Secret מסוג kubernetes.io/service-account-token שאינו פג וקראו אותו. לאחר מכן בחרו כיצד נגזרת כתובת ה-URL של הסביבה, וערכו את כתובת ה-API server אם האשכול שלכם מאזין ביציאה אחרת.",
         "autoSetup": {
           "title": "הגדרה אוטומטית באמצעות ה-CLI",
           "description": "הרץ זאת בטרמינל כדי לזהות או להקצות אשכול מקומי, ליצור אסימון ServiceAccount ולפתוח טופס זה כשהוא ממולא מראש. הדבק את האסימון המוצג, ולאחר מכן בצע בדיקה ושמירה."

package/i18n/locales/ja.json

@@ -276,6 +276,9 @@
       "stalled": "実行が停止しました",
       "retryBootstrap": "ブートストラップを再試行",
       "retryRun": "実行を再試行",
+      "environmentSetup": "環境をセットアップ",
+      "deployRunnerSetup": "ランナープールをセットアップ",
+      "environmentLocalHint": "ローカルの一時環境では、kubectl/kustomize/helm を実行するためにデプロイランタイムが必要です。.env に {runtime} を設定してください。ネイティブモードはこれらのツールをホスト上で実行し（{native}）、コンテナモードはデプロイイメージ内で実行します（{container}）。",
       "showDetail": "詳細を表示",
       "retrying": "再試行中…",
       "history": {
@@ -1726,7 +1729,7 @@
         "remote-kubernetes": "リモート Kubernetes"
       },
       "kubernetesEngine": {
-        "localK3sHint": "このマシン上のローカル k3s/k3d/kind クラスター向けにあらかじめ入力されています。ServiceAccount をロールにバインドし、`kubectl create token NAME -n NAMESPACE`（Kubernetes 1.24 以降）でトークンを発行して下記に貼り付けてください。その後、環境 URL の導出方法を選択し、クラスターが別のポートで待ち受けている場合は API サーバー URL を編集してください。",
+        "localK3sHint": "このマシン上のローカル k3s/k3d/kind クラスター向けにあらかじめ入力されています。ServiceAccount をロールにバインドし、長期間有効なトークンを下記に貼り付けてください。通常の `kubectl create token NAME -n NAMESPACE` のトークンは1時間で失効する点に注意してください。より長くするには `--duration=720h` を付け、失効しないトークンが必要な場合は kubernetes.io/service-account-token の Secret を作成して読み取ってください。その後、環境 URL の導出方法を選択し、クラスターが別のポートで待ち受けている場合は API サーバー URL を編集してください。",
         "autoSetup": {
           "title": "CLI による自動セットアップ",
           "description": "これをターミナルで実行すると、ローカルクラスターを検出またはプロビジョニングし、ServiceAccount トークンを生成して、このフォームを事前入力した状態で開きます。表示されたトークンを貼り付けてから、テストして保存してください。"

package/i18n/locales/pl.json

@@ -276,6 +276,9 @@
       "stalled": "Uruchomienie utknęło",
       "retryBootstrap": "Ponów inicjalizację",
       "retryRun": "Ponów uruchomienie",
+      "environmentSetup": "Skonfiguruj środowiska",
+      "deployRunnerSetup": "Skonfiguruj pulę runnerów",
+      "environmentLocalHint": "Lokalne środowiska tymczasowe wymagają środowiska uruchomieniowego wdrożenia do uruchomienia kubectl/kustomize/helm. Ustaw {runtime} w pliku .env: tryb natywny uruchamia te narzędzia na twoim hoście ({native}), tryb kontenerowy uruchamia je w obrazie wdrożeniowym ({container}).",
       "showDetail": "Pokaż szczegóły",
       "retrying": "Ponawianie…",
       "history": {
@@ -2274,7 +2277,7 @@
         "remote-kubernetes": "Zdalny Kubernetes"
       },
       "kubernetesEngine": {
-        "localK3sHint": "Wstępnie wypełnione dla lokalnego klastra k3s/k3d/kind na tym komputerze. Powiąż ServiceAccount z rolą, wygeneruj jego token poleceniem `kubectl create token NAME -n NAMESPACE` (Kubernetes 1.24+) i wklej go poniżej. Następnie wybierz sposób ustalania adresu URL środowiska i zmień URL serwera API, jeśli Twój klaster nasłuchuje na innym porcie.",
+        "localK3sHint": "Wstępnie wypełnione dla lokalnego klastra k3s/k3d/kind na tym komputerze. Powiąż ServiceAccount z rolą i wklej poniżej token o długim czasie ważności. Pamiętaj, że zwykły token z `kubectl create token NAME -n NAMESPACE` wygasa po 1 godzinie: dodaj `--duration=720h`, aby wydłużyć jego ważność, albo utwórz niewygasający Secret kubernetes.io/service-account-token i odczytaj go. Następnie wybierz sposób ustalania adresu URL środowiska i zmień URL serwera API, jeśli Twój klaster nasłuchuje na innym porcie.",
         "autoSetup": {
           "title": "Automatyczna konfiguracja przez CLI",
           "description": "Uruchom to w terminalu, aby wykryć lub udostępnić lokalny klaster, wygenerować token ServiceAccount i otworzyć ten formularz wstępnie wypełniony. Wklej wyświetlony token, a następnie kliknij Przetestuj i Zapisz."

package/i18n/locales/tr.json

@@ -276,6 +276,9 @@
       "stalled": "Çalıştırma askıda kaldı",
       "retryBootstrap": "Bootstrap'ı yeniden dene",
       "retryRun": "Çalıştırmayı yeniden dene",
+      "environmentSetup": "Ortamları yapılandır",
+      "deployRunnerSetup": "Runner havuzunu yapılandır",
+      "environmentLocalHint": "Yerel geçici ortamlar, kubectl/kustomize/helm çalıştırmak için bir dağıtım çalışma zamanı gerektirir. .env dosyanızda {runtime} değerini ayarlayın: yerel mod bu araçları ana makinenizde çalıştırır ({native}), konteyner modu bunları dağıtım imajında çalıştırır ({container}).",
       "showDetail": "Ayrıntıyı göster",
       "retrying": "Yeniden deneniyor…",
       "history": {
@@ -1726,7 +1729,7 @@
         "remote-kubernetes": "Uzak Kubernetes"
       },
       "kubernetesEngine": {
-        "localK3sHint": "Bu makinedeki yerel bir k3s/k3d/kind kümesi için önceden dolduruldu. Bir ServiceAccount'u bir role bağlayın, `kubectl create token NAME -n NAMESPACE` (Kubernetes 1.24+) ile token'ını oluşturun ve aşağıya yapıştırın. Ardından ortam URL'sinin nasıl türetileceğini seçin ve kümeniz farklı bir bağlantı noktasını dinliyorsa API sunucu URL'sini düzenleyin.",
+        "localK3sHint": "Bu makinedeki yerel bir k3s/k3d/kind kümesi için önceden dolduruldu. Bir ServiceAccount'u bir role bağlayın ve aşağıya uzun ömürlü bir token yapıştırın. Düz bir `kubectl create token NAME -n NAMESPACE` token'ının 1 saatte sona erdiğini unutmayın: daha uzun ömür için `--duration=720h` ekleyin veya süresi dolmayan bir kubernetes.io/service-account-token Secret oluşturup okuyun. Ardından ortam URL'sinin nasıl türetileceğini seçin ve kümeniz farklı bir bağlantı noktasını dinliyorsa API sunucu URL'sini düzenleyin.",
         "autoSetup": {
           "title": "CLI ile otomatik kurulum",
           "description": "Yerel bir kümeyi algılamak veya sağlamak, bir ServiceAccount belirteci oluşturmak ve bu formu önceden doldurulmuş olarak açmak için bunu terminalinizde çalıştırın. Yazdırdığı belirteci yapıştırın, ardından Test edin ve Kaydedin."

package/i18n/locales/uk.json

@@ -276,6 +276,9 @@
       "stalled": "Запуск завис",
       "retryBootstrap": "Повторити ініціалізацію",
       "retryRun": "Повторити запуск",
+      "environmentSetup": "Налаштувати середовища",
+      "deployRunnerSetup": "Налаштувати пул раннерів",
+      "environmentLocalHint": "Локальні тимчасові середовища потребують середовища виконання розгортання для запуску kubectl/kustomize/helm. Встановіть {runtime} у вашому .env: нативний режим запускає ці інструменти на вашому хості ({native}), режим контейнера запускає їх в образі розгортання ({container}).",
       "showDetail": "Показати деталі",
       "retrying": "Повторення…",
       "history": {
@@ -2274,7 +2277,7 @@
         "remote-kubernetes": "Віддалений Kubernetes"
       },
       "kubernetesEngine": {
-        "localK3sHint": "Попередньо заповнено для локального кластера k3s/k3d/kind на цьому комп'ютері. Прив'яжіть ServiceAccount до ролі, згенеруйте його токен командою `kubectl create token NAME -n NAMESPACE` (Kubernetes 1.24+) і вставте його нижче. Потім виберіть, як визначається URL середовища, і змініть URL сервера API, якщо ваш кластер слухає на іншому порту.",
+        "localK3sHint": "Попередньо заповнено для локального кластера k3s/k3d/kind на цьому комп'ютері. Прив'яжіть ServiceAccount до ролі та вставте нижче токен із тривалим терміном дії. Зверніть увагу, що звичайний токен від `kubectl create token NAME -n NAMESPACE` втрачає чинність через 1 годину: додайте `--duration=720h`, щоб подовжити термін, або створіть Secret типу kubernetes.io/service-account-token, який не має терміну дії, і прочитайте його. Потім виберіть, як визначається URL середовища, і змініть URL сервера API, якщо ваш кластер слухає на іншому порту.",
         "autoSetup": {
           "title": "Автоматичне налаштування через CLI",
           "description": "Запустіть це в терміналі, щоб виявити або підготувати локальний кластер, згенерувати токен ServiceAccount і відкрити цю форму заздалегідь заповненою. Вставте показаний токен, потім натисніть «Перевірити» та «Зберегти»."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.100.1",
+  "version": "0.100.3",
   "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",
@@ -34,7 +34,7 @@
     "valibot": "^1.4.2",
     "vue": "3.5.39",
     "wretch": "^3.0.9",
-    "@cat-factory/contracts": "0.110.0"
+    "@cat-factory/contracts": "0.110.1"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",