@cat-factory/app 0.103.0 → 0.104.0

package/app/components/auth/AuthGate.vue

@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import { computed } from 'vue'
+import BackendMisconfiguredScreen from '~/components/auth/BackendMisconfiguredScreen.vue'
 import LoginScreen from '~/components/auth/LoginScreen.vue'
 
 // Resolves auth state once on mount, then either renders the app (auth off, or
@@ -25,6 +26,8 @@ onMounted(() => auth.bootstrap())
     <span class="text-sm">{{ t('auth.gate.loading') }}</span>
   </div>
 
+  <BackendMisconfiguredScreen v-else-if="auth.isMisconfigured" />
+
   <slot v-else-if="isPublicRoute" />
 
   <LoginScreen v-else-if="auth.needsLogin" />

package/app/components/auth/BackendMisconfiguredScreen.vue

@@ -0,0 +1,55 @@
+<script setup lang="ts">
+import type { ConfigProblem } from '@cat-factory/contracts'
+
+// Shown when the backend booted into its misconfiguration fallback: it couldn't start normally
+// because one or more mandatory environment variables / bindings are missing or invalid. We list
+// each one with what it is for and how to fill it, so the developer can fix their env and reload
+// rather than staring at a generic "can't reach the backend" panel. The `problems` never carry a
+// secret value — only the variable name, its meaning, and the remedy.
+const auth = useAuthStore()
+const { t } = useI18n()
+
+const problems = computed<ConfigProblem[]>(() => auth.misconfigured?.problems ?? [])
+
+function reload() {
+  window.location.reload()
+}
+</script>
+
+<template>
+  <div
+    class="flex h-screen w-screen flex-col items-center justify-center bg-slate-950 p-6 text-slate-200"
+  >
+    <div class="w-full max-w-2xl">
+      <div class="mb-6 text-center">
+        <UIcon name="i-lucide-server-cog" class="mx-auto mb-3 h-10 w-10 text-amber-400" />
+        <h1 class="text-lg font-semibold">{{ t('app.misconfigured.title') }}</h1>
+        <p class="mx-auto mt-2 max-w-lg text-sm text-slate-400">
+          {{ t('app.misconfigured.intro') }}
+        </p>
+      </div>
+
+      <ul class="space-y-3">
+        <li
+          v-for="problem in problems"
+          :key="problem.key"
+          class="rounded-lg border border-slate-800 bg-slate-900/60 p-4"
+        >
+          <code class="text-sm font-semibold text-amber-300">{{ problem.key }}</code>
+          <p class="mt-1 text-sm text-slate-300">{{ problem.summary }}</p>
+          <p class="mt-2 text-sm text-slate-400">
+            <span class="font-medium text-slate-300">{{ t('app.misconfigured.howToFix') }}</span>
+            {{ problem.remedy }}
+          </p>
+        </li>
+      </ul>
+
+      <div class="mt-6 flex items-center justify-center gap-3">
+        <UButton color="primary" icon="i-lucide-rotate-ccw" @click="reload">
+          {{ t('app.misconfigured.reload') }}
+        </UButton>
+      </div>
+      <p class="mt-4 text-center text-xs text-slate-500">{{ t('app.misconfigured.hint') }}</p>
+    </div>
+  </div>
+</template>

package/app/stores/auth.ts

@@ -1,4 +1,8 @@
-import type { InfrastructureCapabilities, LocalModeConfig } from '@cat-factory/contracts'
+import type {
+  BackendMisconfigured,
+  InfrastructureCapabilities,
+  LocalModeConfig,
+} from '@cat-factory/contracts'
 import { defineStore } from 'pinia'
 import { computed, ref } from 'vue'
 import type { AuthUser } from '~/types/domain'
@@ -60,6 +64,14 @@ export const useAuthStore = defineStore(
     const autoLoginProvider = ref<'github' | 'gitlab' | null>(null)
     /** True once the initial auth handshake has settled. */
     const ready = ref(false)
+    /**
+     * Set when the backend answered its boot handshake but reported that it is MISCONFIGURED — it
+     * failed to start normally because a mandatory env var / binding is missing, and is serving the
+     * fallback backend that lists the problems (each carries only a name + meaning + remedy, never a
+     * secret). Present ⇒ the SPA renders the dedicated misconfiguration screen instead of the
+     * login/board. Null on a normally-booted backend.
+     */
+    const misconfigured = ref<BackendMisconfigured | null>(null)
     /**
      * Mothership mode: the last mothership sign-in failure (node unreachable / rejected session),
      * or null. Set when the post-OAuth connect exchange fails, so the login screen can tell the
@@ -84,6 +96,9 @@ export const useAuthStore = defineStore(
     /** May the app render? True when auth is off, or on with a known user. */
     const isAuthenticated = computed(() => !required.value || user.value !== null)
 
+    /** Whether the backend reported itself misconfigured (drives the dedicated error screen). */
+    const isMisconfigured = computed(() => misconfigured.value !== null)
+
     /**
      * Whether the SPA must show the login screen before the board.
      *
@@ -176,7 +191,14 @@ export const useAuthStore = defineStore(
         testingNoAuth.value = config.testingNoAuth ?? false
         localMode.value = config.localMode ?? null
         infrastructure.value = config.infrastructure ?? null
+        misconfigured.value = config.misconfigured ?? null
         configLoaded.value = true
+        // A misconfigured backend serves only the fallback app; there's no session/board to
+        // resolve, so settle here and let the SPA render the misconfiguration screen.
+        if (misconfigured.value) {
+          ready.value = true
+          return
+        }
       } catch {
         // Backend unreachable — let the board's own error UI handle it (configLoaded stays
         // false, so we never mistake this for an unauthenticated session and gate it).
@@ -335,8 +357,10 @@ export const useAuthStore = defineStore(
       ready,
       mothershipError,
       configLoaded,
+      misconfigured,
       isLocalFacade,
       isAuthenticated,
+      isMisconfigured,
       needsLogin,
       bootstrap,
       login,

package/i18n/locales/de.json

@@ -3552,7 +3552,14 @@
     "loadingBoard": "Board wird geladen…",
     "backendUnreachable": "Backend nicht erreichbar",
     "reconnecting": "Verbindung wird wiederhergestellt…",
-    "offline": "Keine Live-Updates"
+    "offline": "Keine Live-Updates",
+    "misconfigured": {
+      "title": "Backend nicht konfiguriert",
+      "intro": "Der Server wurde gestartet, kann aber erst laufen, wenn die folgenden Einstellungen vorhanden sind. Ergänze die fehlenden Werte in deiner Umgebung und lade neu.",
+      "howToFix": "So behebst du es:",
+      "reload": "Neu laden",
+      "hint": "Hier werden nur Variablennamen und deren Einrichtung angezeigt, niemals geheime Werte."
+    }
   },
   "language": {
     "switcher": "Sprache",

package/i18n/locales/en.json

@@ -4,7 +4,14 @@
     "loadingBoard": "Loading board…",
     "backendUnreachable": "Can't reach the backend",
     "reconnecting": "Reconnecting…",
-    "offline": "Not receiving live updates"
+    "offline": "Not receiving live updates",
+    "misconfigured": {
+      "title": "Backend not configured",
+      "intro": "The server started but can't run until the settings below are provided. Add the missing values to your environment, then reload.",
+      "howToFix": "How to fix:",
+      "reload": "Reload",
+      "hint": "Only variable names and how to set them are shown here, never any secret values."
+    }
   },
   "language": {
     "switcher": "Language",

package/i18n/locales/es.json

@@ -4,7 +4,14 @@
     "loadingBoard": "Cargando tablero…",
     "backendUnreachable": "No se puede conectar con el backend",
     "reconnecting": "Reconectando…",
-    "offline": "No se reciben actualizaciones en vivo"
+    "offline": "No se reciben actualizaciones en vivo",
+    "misconfigured": {
+      "title": "Backend sin configurar",
+      "intro": "El servidor se inició pero no puede funcionar hasta que se proporcionen los ajustes siguientes. Añade los valores que faltan a tu entorno y vuelve a cargar.",
+      "howToFix": "Cómo solucionarlo:",
+      "reload": "Recargar",
+      "hint": "Aquí solo se muestran los nombres de las variables y cómo definirlas, nunca valores secretos."
+    }
   },
   "language": {
     "switcher": "Idioma",

package/i18n/locales/fr.json

@@ -4,7 +4,14 @@
     "loadingBoard": "Chargement du tableau…",
     "backendUnreachable": "Impossible de joindre le backend",
     "reconnecting": "Reconnexion…",
-    "offline": "Mises à jour en direct non reçues"
+    "offline": "Mises à jour en direct non reçues",
+    "misconfigured": {
+      "title": "Backend non configuré",
+      "intro": "Le serveur a démarré mais ne peut pas fonctionner tant que les paramètres ci-dessous ne sont pas fournis. Ajoutez les valeurs manquantes à votre environnement, puis rechargez.",
+      "howToFix": "Comment corriger :",
+      "reload": "Recharger",
+      "hint": "Seuls les noms des variables et la façon de les définir sont affichés ici, jamais de valeurs secrètes."
+    }
   },
   "language": {
     "switcher": "Langue",

package/i18n/locales/he.json

@@ -4,7 +4,14 @@
     "loadingBoard": "טוען לוח…",
     "backendUnreachable": "לא ניתן להתחבר לבקאנד",
     "reconnecting": "מתחבר מחדש…",
-    "offline": "לא מתקבלים עדכונים חיים"
+    "offline": "לא מתקבלים עדכונים חיים",
+    "misconfigured": {
+      "title": "השרת אינו מוגדר",
+      "intro": "השרת עלה אך אינו יכול לפעול עד שהערכים הבאים יסופקו. הוסיפו את הערכים החסרים לסביבה שלכם וטענו מחדש.",
+      "howToFix": "איך לתקן:",
+      "reload": "טעינה מחדש",
+      "hint": "כאן מוצגים רק שמות המשתנים וכיצד להגדיר אותם, לעולם לא ערכים סודיים."
+    }
   },
   "language": {
     "switcher": "שפה",

package/i18n/locales/it.json

@@ -3552,7 +3552,14 @@
     "loadingBoard": "Caricamento della board…",
     "backendUnreachable": "Impossibile raggiungere il backend",
     "reconnecting": "Riconnessione…",
-    "offline": "Aggiornamenti in tempo reale non ricevuti"
+    "offline": "Aggiornamenti in tempo reale non ricevuti",
+    "misconfigured": {
+      "title": "Backend non configurato",
+      "intro": "Il server è avviato ma non può funzionare finché non vengono forniti i parametri seguenti. Aggiungi i valori mancanti al tuo ambiente e ricarica.",
+      "howToFix": "Come risolvere:",
+      "reload": "Ricarica",
+      "hint": "Qui vengono mostrati solo i nomi delle variabili e come impostarle, mai valori segreti."
+    }
   },
   "language": {
     "switcher": "Lingua",

package/i18n/locales/ja.json

@@ -4,7 +4,14 @@
     "loadingBoard": "ボードを読み込み中…",
     "backendUnreachable": "バックエンドに接続できません",
     "reconnecting": "再接続中…",
-    "offline": "ライブ更新を受信していません"
+    "offline": "ライブ更新を受信していません",
+    "misconfigured": {
+      "title": "バックエンドが設定されていません",
+      "intro": "サーバーは起動しましたが、以下の設定が指定されるまで動作できません。不足している値を環境に追加してから再読み込みしてください。",
+      "howToFix": "対処方法:",
+      "reload": "再読み込み",
+      "hint": "ここに表示されるのは変数名と設定方法のみで、秘密の値は表示されません。"
+    }
   },
   "language": {
     "switcher": "言語",

package/i18n/locales/pl.json

@@ -4,7 +4,14 @@
     "loadingBoard": "Ładowanie tablicy…",
     "backendUnreachable": "Nie można połączyć się z backendem",
     "reconnecting": "Ponowne łączenie…",
-    "offline": "Brak aktualizacji na żywo"
+    "offline": "Brak aktualizacji na żywo",
+    "misconfigured": {
+      "title": "Backend nie jest skonfigurowany",
+      "intro": "Serwer wystartował, ale nie zadziała, dopóki nie uzupełnisz poniższych ustawień. Dodaj brakujące wartości do swojego środowiska i odśwież.",
+      "howToFix": "Jak naprawić:",
+      "reload": "Odśwież",
+      "hint": "Tutaj pokazujemy tylko nazwy zmiennych i sposób ich ustawienia, nigdy wartości sekretnych."
+    }
   },
   "language": {
     "switcher": "Język",

package/i18n/locales/tr.json

@@ -4,7 +4,14 @@
     "loadingBoard": "Pano yükleniyor…",
     "backendUnreachable": "Arka uca ulaşılamıyor",
     "reconnecting": "Yeniden bağlanılıyor…",
-    "offline": "Canlı güncellemeler alınmıyor"
+    "offline": "Canlı güncellemeler alınmıyor",
+    "misconfigured": {
+      "title": "Arka uç yapılandırılmadı",
+      "intro": "Sunucu başladı ancak aşağıdaki ayarlar sağlanana kadar çalışamaz. Eksik değerleri ortamınıza ekleyip yeniden yükleyin.",
+      "howToFix": "Nasıl düzeltilir:",
+      "reload": "Yeniden yükle",
+      "hint": "Burada yalnızca değişken adları ve nasıl ayarlanacakları gösterilir, asla gizli değerler değil."
+    }
   },
   "language": {
     "switcher": "Dil",

package/i18n/locales/uk.json

@@ -4,7 +4,14 @@
     "loadingBoard": "Завантаження дошки…",
     "backendUnreachable": "Не вдається зʼєднатися з бекендом",
     "reconnecting": "Повторне зʼєднання…",
-    "offline": "Оновлення в реальному часі не надходять"
+    "offline": "Оновлення в реальному часі не надходять",
+    "misconfigured": {
+      "title": "Бекенд не налаштовано",
+      "intro": "Сервер запустився, але не працюватиме, доки не буде задано наведені нижче параметри. Додайте відсутні значення до свого середовища та перезавантажте.",
+      "howToFix": "Як виправити:",
+      "reload": "Перезавантажити",
+      "hint": "Тут показано лише назви змінних і як їх задати, ніколи не секретні значення."
+    }
   },
   "language": {
     "switcher": "Мова",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.103.0",
+  "version": "0.104.0",
   "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.113.0"
+    "@cat-factory/contracts": "0.114.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",