@cat-factory/app 0.100.1 → 0.100.2

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/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": {

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": {

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": {

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": {

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": {

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": {

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": {

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": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.100.1",
+  "version": "0.100.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",
@@ -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",