@cat-factory/app 0.75.2 → 0.76.0

package/app/composables/api/infraHandlers.ts

@@ -1,4 +1,5 @@
 import {
+  detectFrontendConfigContract,
   detectServiceProvisioningContract,
   listEnvironmentHandlersContract,
   listEnvironmentUserHandlersContract,
@@ -12,6 +13,7 @@ import {
   upsertEnvironmentUserHandlerContract,
 } from '@cat-factory/contracts'
 import type {
+  DetectFrontendConfigInput,
   DetectServiceProvisioningInput,
   ProvisionType,
   RegisterEnvironmentHandlerInput,
@@ -47,6 +49,10 @@ export function infraHandlersApi({ send, ws }: ApiContext) {
     detectServiceProvisioning: (workspaceId: string, body: DetectServiceProvisioningInput) =>
       send(detectServiceProvisioningContract, { pathPrefix: ws(workspaceId), body }),
 
+    // Auto-detect a non-binding recommended frontend config from a frontend repo.
+    detectFrontendConfig: (workspaceId: string, body: DetectFrontendConfigInput) =>
+      send(detectFrontendConfigContract, { pathPrefix: ws(workspaceId), body }),
+
     // Generate/fix a service's custom manifest via the fixer coding agent (async repair run).
     repairCustomManifest: (workspaceId: string, body: RepairCustomManifestInput) =>
       send(repairCustomManifestContract, { pathPrefix: ws(workspaceId), body }),

package/app/stores/infraConfig.ts

@@ -2,6 +2,7 @@ import { defineStore } from 'pinia'
 import { ref, type Ref } from 'vue'
 import type {
   CustomManifestType,
+  DetectFrontendConfigInput,
   DetectServiceProvisioningInput,
   EnvironmentHandlerView,
   ProvisionType,
@@ -113,6 +114,15 @@ export const useInfraConfigStore = defineStore('infraConfig', () => {
     return api.detectServiceProvisioning(ws.requireId(), input)
   }
 
+  /**
+   * Auto-detect a NON-BINDING recommended frontend config from a frontend repo. The SPA prefills a
+   * preview the user applies; nothing is persisted server-side. Pure repo introspection.
+   */
+  async function detectFrontendConfig(input: DetectFrontendConfigInput) {
+    const ws = useWorkspaceStore()
+    return api.detectFrontendConfig(ws.requireId(), input)
+  }
+
   /**
    * Generate (or fix) a service's custom manifest via the fixer coding agent. Dispatches a
    * durable async repair run and returns immediately with `usedAgent`/`repairJobId`; the run is
@@ -192,6 +202,7 @@ export const useInfraConfigStore = defineStore('infraConfig', () => {
     registerHandler,
     testHandler,
     detectProvisioning,
+    detectFrontendConfig,
     repairCustomManifest,
     unregisterHandler,
     upsertCustomType,

package/app/types/domain.ts

@@ -37,6 +37,8 @@ export type {
   FrontendPackageManager,
   FrontendServeMode,
   FrontendEnvInjection,
+  FrontendConfigRecommendation,
+  FrontendDetectionNote,
   AgentConfigOption,
   AgentConfigDescriptor,
   TestConcernSeverity,

package/i18n/locales/en.json

@@ -485,14 +485,37 @@
     "frontendConfig": {
       "title": "Frontend",
       "hint": "How to build, serve, and mock this frontend for a self-contained UI test. Bindings below link it to the backend services it calls.",
+      "detect": {
+        "title": "Detect from repo",
+        "button": "Detect",
+        "hint": "Read the linked repo and propose a config to review before applying. Nothing is saved until you apply.",
+        "error": "Couldn't read the repo. Check the frontend is linked to a connected repository.",
+        "none": "Nothing frontend-shaped was detected. Set the frontend directory (for a monorepo) or fill the fields in manually.",
+        "apply": "Apply",
+        "dismiss": "Dismiss",
+        "confidenceHigh": "sure",
+        "confidenceLow": "guess"
+      },
+      "groups": {
+        "build": "Build",
+        "serve": "Serve",
+        "mocking": "Mocking",
+        "envInjection": "Env injection",
+        "bindings": "Backend bindings",
+        "preview": "Preview"
+      },
       "packageManager": "Package manager",
+      "directory": "Frontend directory",
+      "directoryHint": "The frontend app's subfolder in the repo (a monorepo, e.g. frontend/). Leave empty if the app is at the repo root.",
       "installCommand": "Install command",
       "buildScript": "Build script",
       "outputDir": "Output directory",
       "serveMode": "Serve mode",
       "serveStatic": "Static",
       "serveCommand": "Command",
-      "serveModeHint": "Static serves the build output directory; Command runs a package.json script (e.g. preview).",
+      "serveStaticDesc": "serves the built output directory as static files. Cheapest for a UI test of a fully built app.",
+      "serveCommandDesc": "runs a package.json script (e.g. preview) to serve the app, for builds that need a running server.",
+      "serveEnvAxisNote": "Separate from Env injection (build-time vs runtime) below, which controls how backend URLs reach the app, not how it is served.",
       "serveScript": "Serve script",
       "servePort": "Serve port",
       "mockMappingsPath": "Mock mappings path",

package/i18n/locales/es.json

@@ -442,14 +442,37 @@
     "frontendConfig": {
       "title": "Frontend",
       "hint": "Cómo compilar, servir y simular este frontend para una prueba de interfaz autónoma. Las vinculaciones de abajo lo conectan con los servicios de backend a los que llama.",
+      "detect": {
+        "title": "Detectar del repositorio",
+        "button": "Detectar",
+        "hint": "Lee el repositorio vinculado y propone una configuración para revisar antes de aplicar. No se guarda nada hasta que la apliques.",
+        "error": "No se pudo leer el repositorio. Comprueba que el frontend esté vinculado a un repositorio conectado.",
+        "none": "No se detectó nada con forma de frontend. Indica el directorio del frontend (para un monorepo) o rellena los campos manualmente.",
+        "apply": "Aplicar",
+        "dismiss": "Descartar",
+        "confidenceHigh": "seguro",
+        "confidenceLow": "estimación"
+      },
+      "groups": {
+        "build": "Compilación",
+        "serve": "Servicio",
+        "mocking": "Simulación",
+        "envInjection": "Inyección de entorno",
+        "bindings": "Vinculaciones de backend",
+        "preview": "Vista previa"
+      },
       "packageManager": "Gestor de paquetes",
+      "directory": "Directorio del frontend",
+      "directoryHint": "La subcarpeta de la app frontend en el repositorio (un monorepo, p. ej. frontend/). Déjalo vacío si la app está en la raíz del repositorio.",
       "installCommand": "Comando de instalación",
       "buildScript": "Script de compilación",
       "outputDir": "Directorio de salida",
       "serveMode": "Modo de servicio",
       "serveStatic": "Estático",
       "serveCommand": "Comando",
-      "serveModeHint": "Estático sirve el directorio de salida de la compilación; Comando ejecuta un script de package.json (p. ej. preview).",
+      "serveStaticDesc": "sirve el directorio de salida compilado como archivos estáticos. Lo más económico para una prueba de interfaz de una app ya compilada.",
+      "serveCommandDesc": "ejecuta un script de package.json (p. ej. preview) para servir la app, para compilaciones que necesitan un servidor en ejecución.",
+      "serveEnvAxisNote": "Distinto de la Inyección de entorno (en compilación vs. en tiempo de ejecución) de abajo, que controla cómo llegan las URL del backend a la app, no cómo se sirve.",
       "serveScript": "Script de servicio",
       "servePort": "Puerto de servicio",
       "mockMappingsPath": "Ruta de asignaciones de simulación",

package/i18n/locales/fr.json

@@ -442,14 +442,37 @@
     "frontendConfig": {
       "title": "Frontend",
       "hint": "Comment compiler, servir et simuler ce frontend pour un test d'interface autonome. Les liaisons ci-dessous le relient aux services de backend qu'il appelle.",
+      "detect": {
+        "title": "Détecter depuis le dépôt",
+        "button": "Détecter",
+        "hint": "Lit le dépôt lié et propose une configuration à vérifier avant application. Rien n'est enregistré tant que vous n'appliquez pas.",
+        "error": "Impossible de lire le dépôt. Vérifiez que le frontend est lié à un dépôt connecté.",
+        "none": "Aucun élément de type frontend détecté. Indiquez le répertoire du frontend (pour un monorepo) ou renseignez les champs manuellement.",
+        "apply": "Appliquer",
+        "dismiss": "Ignorer",
+        "confidenceHigh": "sûr",
+        "confidenceLow": "estimation"
+      },
+      "groups": {
+        "build": "Compilation",
+        "serve": "Service",
+        "mocking": "Simulation",
+        "envInjection": "Injection d'environnement",
+        "bindings": "Liaisons backend",
+        "preview": "Aperçu"
+      },
       "packageManager": "Gestionnaire de paquets",
+      "directory": "Répertoire du frontend",
+      "directoryHint": "Le sous-dossier de l'app frontend dans le dépôt (un monorepo, p. ex. frontend/). Laissez vide si l'app est à la racine du dépôt.",
       "installCommand": "Commande d'installation",
       "buildScript": "Script de compilation",
       "outputDir": "Répertoire de sortie",
       "serveMode": "Mode de service",
       "serveStatic": "Statique",
       "serveCommand": "Commande",
-      "serveModeHint": "Statique sert le répertoire de sortie de la compilation ; Commande exécute un script de package.json (p. ex. preview).",
+      "serveStaticDesc": "sert le répertoire de sortie compilé en fichiers statiques. Le plus économique pour un test d'interface d'une app entièrement compilée.",
+      "serveCommandDesc": "exécute un script de package.json (p. ex. preview) pour servir l'app, pour les compilations nécessitant un serveur en fonctionnement.",
+      "serveEnvAxisNote": "Distinct de l'Injection d'environnement (à la compilation vs à l'exécution) ci-dessous, qui contrôle comment les URL du backend atteignent l'app, pas comment elle est servie.",
       "serveScript": "Script de service",
       "servePort": "Port de service",
       "mockMappingsPath": "Chemin des mappages de simulation",

package/i18n/locales/he.json

@@ -442,14 +442,37 @@
     "frontendConfig": {
       "title": "Frontend",
       "hint": "כיצד לבנות, להגיש ולדמות את ה-frontend הזה לבדיקת ממשק עצמאית. הקישורים למטה מחברים אותו לשירותי ה-backend שהוא קורא אליהם.",
+      "detect": {
+        "title": "זהה מהמאגר",
+        "button": "זהה",
+        "hint": "קורא את המאגר המקושר ומציע תצורה לבדיקה לפני החלה. שום דבר לא נשמר עד שתחיל.",
+        "error": "לא ניתן לקרוא את המאגר. ודא שה-frontend מקושר למאגר מחובר.",
+        "none": "לא זוהה דבר בעל מבנה frontend. הגדר את תיקיית ה-frontend (עבור monorepo) או מלא את השדות ידנית.",
+        "apply": "החל",
+        "dismiss": "בטל",
+        "confidenceHigh": "בטוח",
+        "confidenceLow": "ניחוש"
+      },
+      "groups": {
+        "build": "בנייה",
+        "serve": "הגשה",
+        "mocking": "הדמיה",
+        "envInjection": "הזרקת סביבה",
+        "bindings": "קישורי backend",
+        "preview": "תצוגה מקדימה"
+      },
       "packageManager": "מנהל חבילות",
+      "directory": "תיקיית frontend",
+      "directoryHint": "תת-התיקייה של אפליקציית ה-frontend במאגר (monorepo, למשל frontend/). השאר ריק אם האפליקציה נמצאת בשורש המאגר.",
       "installCommand": "פקודת התקנה",
       "buildScript": "סקריפט בנייה",
       "outputDir": "תיקיית פלט",
       "serveMode": "מצב הגשה",
       "serveStatic": "סטטי",
       "serveCommand": "פקודה",
-      "serveModeHint": "סטטי מגיש את תיקיית פלט הבנייה; פקודה מריצה סקריפט מ-package.json (למשל preview).",
+      "serveStaticDesc": "מגיש את תיקיית פלט הבנייה כקבצים סטטיים. הזול ביותר לבדיקת ממשק של אפליקציה בנויה במלואה.",
+      "serveCommandDesc": "מריץ סקריפט מ-package.json (למשל preview) כדי להגיש את האפליקציה, עבור בנייה הזקוקה לשרת פעיל.",
+      "serveEnvAxisNote": "נפרד מהזרקת הסביבה (בזמן בנייה מול זמן ריצה) שלמטה, השולטת כיצד כתובות ה-backend מגיעות לאפליקציה, לא כיצד היא מוגשת.",
       "serveScript": "סקריפט הגשה",
       "servePort": "פורט הגשה",
       "mockMappingsPath": "נתיב מיפויי הדמיה",

package/i18n/locales/ja.json

@@ -442,14 +442,37 @@
     "frontendConfig": {
       "title": "フロントエンド",
       "hint": "自己完結型の UI テストのために、このフロントエンドをビルド、配信、モックする方法。下のバインディングは、呼び出すバックエンドサービスとフロントエンドをつなぎます。",
+      "detect": {
+        "title": "リポジトリから検出",
+        "button": "検出",
+        "hint": "リンクされたリポジトリを読み取り、適用前に確認できる設定を提案します。適用するまで何も保存されません。",
+        "error": "リポジトリを読み取れませんでした。フロントエンドが接続済みリポジトリにリンクされているか確認してください。",
+        "none": "フロントエンドらしきものは検出されませんでした。（モノレポの場合は）フロントエンドのディレクトリを指定するか、手動で入力してください。",
+        "apply": "適用",
+        "dismiss": "却下",
+        "confidenceHigh": "確実",
+        "confidenceLow": "推測"
+      },
+      "groups": {
+        "build": "ビルド",
+        "serve": "配信",
+        "mocking": "モック",
+        "envInjection": "環境変数の注入",
+        "bindings": "バックエンドバインディング",
+        "preview": "プレビュー"
+      },
       "packageManager": "パッケージマネージャー",
+      "directory": "フロントエンドのディレクトリ",
+      "directoryHint": "リポジトリ内のフロントエンドアプリのサブフォルダー（モノレポ、例: frontend/）。アプリがリポジトリのルートにある場合は空のままにします。",
       "installCommand": "インストールコマンド",
       "buildScript": "ビルドスクリプト",
       "outputDir": "出力ディレクトリ",
       "serveMode": "配信モード",
       "serveStatic": "静的",
       "serveCommand": "コマンド",
-      "serveModeHint": "静的はビルド出力ディレクトリを配信します。コマンドは package.json のスクリプト（例: preview）を実行します。",
+      "serveStaticDesc": "ビルド出力ディレクトリを静的ファイルとして配信します。完全にビルド済みのアプリの UI テストに最も低コストです。",
+      "serveCommandDesc": "package.json のスクリプト（例: preview）を実行してアプリを配信します。サーバーの起動が必要なビルド向けです。",
+      "serveEnvAxisNote": "下の環境変数の注入（ビルド時とランタイム）とは別物で、そちらはバックエンド URL がアプリにどう届くかを制御し、配信方法ではありません。",
       "serveScript": "配信スクリプト",
       "servePort": "配信ポート",
       "mockMappingsPath": "モックマッピングのパス",

package/i18n/locales/pl.json

@@ -442,14 +442,37 @@
     "frontendConfig": {
       "title": "Frontend",
       "hint": "Jak zbudować, uruchomić i zamockować ten frontend na potrzeby samodzielnego testu interfejsu. Powiązania poniżej łączą go z usługami backendu, które wywołuje.",
+      "detect": {
+        "title": "Wykryj z repozytorium",
+        "button": "Wykryj",
+        "hint": "Odczytuje połączone repozytorium i proponuje konfigurację do sprawdzenia przed zastosowaniem. Nic nie jest zapisywane, dopóki nie zastosujesz.",
+        "error": "Nie można odczytać repozytorium. Sprawdź, czy frontend jest połączony z podłączonym repozytorium.",
+        "none": "Nie wykryto niczego w kształcie frontendu. Ustaw katalog frontendu (dla monorepo) lub wypełnij pola ręcznie.",
+        "apply": "Zastosuj",
+        "dismiss": "Odrzuć",
+        "confidenceHigh": "pewne",
+        "confidenceLow": "przypuszczenie"
+      },
+      "groups": {
+        "build": "Budowanie",
+        "serve": "Serwowanie",
+        "mocking": "Mockowanie",
+        "envInjection": "Wstrzykiwanie środowiska",
+        "bindings": "Powiązania backendu",
+        "preview": "Podgląd"
+      },
       "packageManager": "Menedżer pakietów",
+      "directory": "Katalog frontendu",
+      "directoryHint": "Podfolder aplikacji frontendowej w repozytorium (monorepo, np. frontend/). Pozostaw puste, jeśli aplikacja jest w katalogu głównym repozytorium.",
       "installCommand": "Polecenie instalacji",
       "buildScript": "Skrypt budowania",
       "outputDir": "Katalog wyjściowy",
       "serveMode": "Tryb serwowania",
       "serveStatic": "Statyczny",
       "serveCommand": "Polecenie",
-      "serveModeHint": "Statyczny serwuje katalog wyjściowy budowania; Polecenie uruchamia skrypt z package.json (np. preview).",
+      "serveStaticDesc": "serwuje zbudowany katalog wyjściowy jako pliki statyczne. Najtańsze dla testu interfejsu w pełni zbudowanej aplikacji.",
+      "serveCommandDesc": "uruchamia skrypt z package.json (np. preview) do serwowania aplikacji, dla kompilacji wymagających działającego serwera.",
+      "serveEnvAxisNote": "Osobne od Wstrzykiwania środowiska (w czasie budowania vs w czasie działania) poniżej, które kontroluje sposób, w jaki adresy URL backendu docierają do aplikacji, a nie sposób jej serwowania.",
       "serveScript": "Skrypt serwowania",
       "servePort": "Port serwowania",
       "mockMappingsPath": "Ścieżka mapowań mocków",

package/i18n/locales/tr.json

@@ -442,14 +442,37 @@
     "frontendConfig": {
       "title": "Frontend",
       "hint": "Bağımsız bir arayüz testi için bu frontend'in nasıl derleneceği, sunulacağı ve taklit edileceği. Aşağıdaki bağlamalar onu çağırdığı backend hizmetlerine bağlar.",
+      "detect": {
+        "title": "Depodan algıla",
+        "button": "Algıla",
+        "hint": "Bağlı depoyu okur ve uygulamadan önce gözden geçirmeniz için bir yapılandırma önerir. Uygulayana kadar hiçbir şey kaydedilmez.",
+        "error": "Depo okunamadı. Frontend'in bağlı bir depoya bağlı olduğunu kontrol edin.",
+        "none": "Frontend biçiminde bir şey algılanmadı. Frontend dizinini ayarlayın (bir monorepo için) veya alanları elle doldurun.",
+        "apply": "Uygula",
+        "dismiss": "Yoksay",
+        "confidenceHigh": "kesin",
+        "confidenceLow": "tahmin"
+      },
+      "groups": {
+        "build": "Derleme",
+        "serve": "Sunma",
+        "mocking": "Taklit",
+        "envInjection": "Ortam enjeksiyonu",
+        "bindings": "Backend bağlantıları",
+        "preview": "Önizleme"
+      },
       "packageManager": "Paket yöneticisi",
+      "directory": "Frontend dizini",
+      "directoryHint": "Depodaki frontend uygulamasının alt klasörü (bir monorepo, örn. frontend/). Uygulama deponun kökündeyse boş bırakın.",
       "installCommand": "Kurulum komutu",
       "buildScript": "Derleme betiği",
       "outputDir": "Çıktı dizini",
       "serveMode": "Sunma modu",
       "serveStatic": "Statik",
       "serveCommand": "Komut",
-      "serveModeHint": "Statik, derleme çıktı dizinini sunar; Komut, bir package.json betiğini (örn. preview) çalıştırır.",
+      "serveStaticDesc": "derlenen çıktı dizinini statik dosyalar olarak sunar. Tamamen derlenmiş bir uygulamanın arayüz testi için en ucuzu.",
+      "serveCommandDesc": "uygulamayı sunmak için bir package.json betiği (örn. preview) çalıştırır; çalışan bir sunucu gerektiren derlemeler için.",
+      "serveEnvAxisNote": "Aşağıdaki Ortam enjeksiyonundan (derleme zamanı vs çalışma zamanı) ayrıdır; o, backend URL'lerinin uygulamaya nasıl ulaştığını kontrol eder, nasıl sunulduğunu değil.",
       "serveScript": "Sunma betiği",
       "servePort": "Sunma bağlantı noktası",
       "mockMappingsPath": "Taklit eşleme yolu",

package/i18n/locales/uk.json

@@ -442,14 +442,37 @@
     "frontendConfig": {
       "title": "Frontend",
       "hint": "Як зібрати, обслуговувати та мокувати цей frontend для автономного тесту інтерфейсу. Прив'язки нижче з'єднують його з сервісами backend, які він викликає.",
+      "detect": {
+        "title": "Виявити з репозиторію",
+        "button": "Виявити",
+        "hint": "Читає підключений репозиторій і пропонує конфігурацію для перегляду перед застосуванням. Нічого не зберігається, доки ви не застосуєте.",
+        "error": "Не вдалося прочитати репозиторій. Перевірте, що фронтенд пов'язаний із підключеним репозиторієм.",
+        "none": "Нічого схожого на фронтенд не виявлено. Вкажіть каталог фронтенду (для монорепозиторію) або заповніть поля вручну.",
+        "apply": "Застосувати",
+        "dismiss": "Відхилити",
+        "confidenceHigh": "впевнено",
+        "confidenceLow": "припущення"
+      },
+      "groups": {
+        "build": "Збірка",
+        "serve": "Обслуговування",
+        "mocking": "Мокування",
+        "envInjection": "Впровадження середовища",
+        "bindings": "Прив'язки бекенду",
+        "preview": "Попередній перегляд"
+      },
       "packageManager": "Менеджер пакетів",
+      "directory": "Каталог фронтенду",
+      "directoryHint": "Підпапка фронтенд-застосунку в репозиторії (монорепозиторій, напр. frontend/). Залиште порожнім, якщо застосунок у корені репозиторію.",
       "installCommand": "Команда встановлення",
       "buildScript": "Скрипт збірки",
       "outputDir": "Каталог виводу",
       "serveMode": "Режим обслуговування",
       "serveStatic": "Статичний",
       "serveCommand": "Команда",
-      "serveModeHint": "Статичний обслуговує каталог виводу збірки; Команда запускає скрипт з package.json (напр. preview).",
+      "serveStaticDesc": "обслуговує зібраний каталог виводу як статичні файли. Найдешевше для тесту інтерфейсу повністю зібраного застосунку.",
+      "serveCommandDesc": "запускає скрипт із package.json (напр. preview) для обслуговування застосунку, для збірок, що потребують запущеного сервера.",
+      "serveEnvAxisNote": "Відрізняється від Впровадження середовища (під час збірки чи виконання) нижче, яке керує тим, як URL бекенду потрапляють до застосунку, а не тим, як він обслуговується.",
       "serveScript": "Скрипт обслуговування",
       "servePort": "Порт обслуговування",
       "mockMappingsPath": "Шлях зіставлень моків",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.75.2",
+  "version": "0.76.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.81.3"
+    "@cat-factory/contracts": "0.82.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",