@cat-factory/app 0.96.5 → 0.97.1

package/app/components/panels/inspector/FrontendConfig.vue

@@ -12,6 +12,7 @@ import type {
 } from '~/types/domain'
 import FrontendBindingsResolved from '~/components/panels/inspector/FrontendBindingsResolved.vue'
 import InspectorSection from '~/components/panels/inspector/InspectorSection.vue'
+import { apiErrorEnvelope } from '~/composables/api/errors'
 
 // Frontend-frame (`type: 'frontend'`) configuration: how to build, serve, and mock this
 // frontend for a self-contained UI test (+ an optional browsable preview on local/node),
@@ -119,7 +120,9 @@ const showPreview = ref(false)
 // frame links to its repo the same way a service does (`github_repos.block_id`).
 const repoLink = computed(() => github.repoForBlock(props.block.id))
 const detecting = ref(false)
-const detectError = ref(false)
+// The detect failure message to show, or null when there's no error. Holds the SERVER's real
+// message (the backend raises an actionable one for an unreadable repo) instead of a fixed line.
+const detectError = ref<string | null>(null)
 const detectResult = ref<FrontendConfigRecommendation | null>(null)
 
 // A detection result is scoped to the inspected block — clear it (and any error) when the
@@ -128,18 +131,20 @@ watch(
   () => props.block.id,
   () => {
     detectResult.value = null
-    detectError.value = false
+    detectError.value = null
   },
 )
 
 async function detectFromRepo() {
   const repo = repoLink.value
   if (!repo) {
-    detectError.value = true
+    // The frame points at a repo that isn't in the connected-repo projection, so we can't resolve
+    // its owner/name to ask the backend. A "sync/connect GitHub" problem, not a read failure.
+    detectError.value = t('inspector.detectRepoUnresolved')
     return
   }
   detecting.value = true
-  detectError.value = false
+  detectError.value = null
   detectResult.value = null
   try {
     const result = await infra.detectFrontendConfig({
@@ -151,8 +156,13 @@ async function detectFromRepo() {
     // When nothing was detected the "none" hint tells the user to set the frontend directory —
     // that field lives in the (collapsed) Build group, so open it so the advice is actionable.
     if (!result.detected) showBuild.value = true
-  } catch {
-    detectError.value = true
+  } catch (e) {
+    // Surface the server's real message (an actionable "couldn't read the repo — check App access"
+    // for a read fault), falling back to the generic line only when none is available.
+    detectError.value =
+      apiErrorEnvelope(e)?.message ??
+      (e instanceof Error ? e.message : null) ??
+      t('inspector.frontendConfig.detect.error')
   } finally {
     detecting.value = false
   }
@@ -243,7 +253,7 @@ onUnmounted(() => preview.stopPolling(props.block.id))
       </p>
 
       <p v-if="detectError" class="text-[11px] text-rose-300/80">
-        {{ t('inspector.frontendConfig.detect.error') }}
+        {{ detectError }}
       </p>
 
       <template v-if="detectResult && !detecting">

package/app/components/panels/inspector/ServiceTestConfig.vue

@@ -18,6 +18,7 @@ import type {
 } from '@cat-factory/contracts'
 import RepoTreeBrowser from '~/components/github/RepoTreeBrowser.vue'
 import InspectorSection from '~/components/panels/inspector/InspectorSection.vue'
+import { apiErrorEnvelope } from '~/composables/api/errors'
 
 // Service-level (frame) configuration: the service-owned PROVISIONING — the provision
 // TYPE this service produces (`infraless` / `docker-compose` / `kubernetes` / `custom`)
@@ -284,7 +285,10 @@ function applyPicked() {
 // every field stays editable, and the engine-level URL/namespace suggestions are surfaced
 // read-only (the workspace handler owns them). Nothing is persisted server-side by detection.
 const detecting = ref(false)
-const detectError = ref(false)
+// The detect failure message to show, or null when there's no error. Holds the SERVER's real
+// message (the backend now raises an actionable one for an unreadable repo) so the user sees why
+// detection failed instead of a fixed, vague line.
+const detectError = ref<string | null>(null)
 const detectResult = ref<ProvisioningRecommendation | null>(null)
 // Advisory, LOCAL-ONLY selection: which compose `services:` key the user picked. It is NOT persisted
 // (the compose backend targets the file, not a single service), so it lives only in component state
@@ -298,7 +302,7 @@ watch(
   () => props.block.id,
   () => {
     detectResult.value = null
-    detectError.value = false
+    detectError.value = null
     pickedComposeService.value = null
   },
 )
@@ -308,11 +312,14 @@ async function detectFromRepo() {
   if (!ctx) return
   const repo = github.repoFor(ctx.githubId)
   if (!repo) {
-    detectError.value = true
+    // The frame points at a repo that isn't in the connected-repo projection, so we can't resolve
+    // its owner/name to ask the backend. That's a "sync/connect GitHub" problem, NOT "couldn't read
+    // the repo" — say so specifically.
+    detectError.value = t('inspector.detectRepoUnresolved')
     return
   }
   detecting.value = true
-  detectError.value = false
+  detectError.value = null
   try {
     const rec = await infra.detectProvisioning({
       owner: repo.owner,
@@ -342,8 +349,13 @@ async function detectFromRepo() {
       board.updateBlock(props.block.id, { provisioning: rec.provisioning })
       if (rec.provisioning.type === 'kubernetes') seedKubeSource(rec.provisioning.manifestSource)
     }
-  } catch {
-    detectError.value = true
+  } catch (e) {
+    // Surface the server's real message (an actionable "couldn't read the repo — check App access"
+    // for a read fault), falling back to the generic line only when none is available.
+    detectError.value =
+      apiErrorEnvelope(e)?.message ??
+      (e instanceof Error ? e.message : null) ??
+      t('inspector.testConfig.detect.error')
   } finally {
     detecting.value = false
   }
@@ -452,7 +464,7 @@ function setSize(value: InstanceSize) {
       </p>
 
       <p v-if="detectError" class="text-[11px] text-rose-300/80">
-        {{ t('inspector.testConfig.detect.error') }}
+        {{ detectError }}
       </p>
 
       <template v-if="detectResult && !detecting">

package/app/composables/usePipelineErrorToast.ts

@@ -48,6 +48,7 @@ const CONFLICT_TITLE_KEYS: Record<
   provision_type_unhandled: 'errors.conflict.title.provision_type_unhandled',
   preset_unsatisfiable: 'errors.conflict.title.preset_unsatisfiable',
   visual_pipeline_no_frontend: 'errors.conflict.title.visual_pipeline_no_frontend',
+  deployer_required_before_tester: 'errors.conflict.title.deployer_required_before_tester',
 }
 
 /**

package/app/utils/catalog.ts

@@ -346,6 +346,18 @@ export const SYSTEM_AGENT_META: Record<string, AgentArchetype> = {
     color: '#22d3ee',
     description: 'Maps the repository into the service → modules blueprint.',
   },
+  // The single environment provisioner: an operational (non-LLM) step that stands up the ephemeral
+  // environment the tester / human-test gate run against for a kubernetes/custom service, and is a
+  // fast no-op for docker-compose / infraless. Seeded before the first tester/human-test step in the
+  // built-in pipelines, so it needs display metadata (else it renders as a generic gray "Agent").
+  deployer: {
+    kind: 'deployer',
+    label: 'Deployer',
+    icon: 'i-lucide-cloud-upload',
+    color: '#34d399',
+    description:
+      'Provisions the ephemeral environment the tester and human-test gate run against (kubernetes / custom services); a no-op for docker-compose / infraless.',
+  },
   // The Initiative Planning pipeline's two steps. Only runnable on an initiative
   // block (pl_initiative — enforced by the engine), so they are display-metadata
   // system kinds, never palette archetypes.

package/i18n/locales/en.json

@@ -428,7 +428,8 @@
         "bootstrap_reference_missing": "Reference architecture is gone",
         "provision_type_unhandled": "No handler for this provision type",
         "preset_unsatisfiable": "Model preset can't run this pipeline",
-        "visual_pipeline_no_frontend": "No frontend to test"
+        "visual_pipeline_no_frontend": "No frontend to test",
+        "deployer_required_before_tester": "Add a Deployer before the Tester"
       },
       "fallbackMessage": "This action conflicts with the current state.",
       "providersUnconfigured": {
@@ -503,6 +504,7 @@
     }
   },
   "inspector": {
+    "detectRepoUnresolved": "This block's repository isn't among the connected GitHub repos, so it can't be read. Connect or sync GitHub for it, then retry.",
     "container": {
       "title": "Contents",
       "hint": "The modules and tasks inside this block. Click an entry to select it on the board.",

package/i18n/locales/es.json

@@ -391,7 +391,8 @@
         "bootstrap_not_retryable": "La inicialización no se puede reintentar",
         "bootstrap_reference_missing": "La arquitectura de referencia ha desaparecido",
         "preset_unsatisfiable": "El preajuste de modelo no puede ejecutar esta canalización",
-        "visual_pipeline_no_frontend": "No hay frontend que probar"
+        "visual_pipeline_no_frontend": "No hay frontend que probar",
+        "deployer_required_before_tester": "Añade un Deployer antes del Tester"
       },
       "fallbackMessage": "Esta acción entra en conflicto con el estado actual.",
       "providersUnconfigured": {
@@ -460,6 +461,7 @@
     }
   },
   "inspector": {
+    "detectRepoUnresolved": "El repositorio de este bloque no está entre los repositorios de GitHub conectados, por lo que no se puede leer. Conecta o sincroniza GitHub para él y vuelve a intentarlo.",
     "container": {
       "title": "Contenido",
       "hint": "Los módulos y tareas dentro de este bloque. Haz clic en una entrada para seleccionarla en el tablero.",

package/i18n/locales/fr.json

@@ -391,7 +391,8 @@
         "bootstrap_not_retryable": "L’initialisation ne peut pas être relancée",
         "bootstrap_reference_missing": "L’architecture de référence a disparu",
         "preset_unsatisfiable": "Le préréglage de modèle ne peut pas exécuter ce pipeline",
-        "visual_pipeline_no_frontend": "Aucun frontend à tester"
+        "visual_pipeline_no_frontend": "Aucun frontend à tester",
+        "deployer_required_before_tester": "Ajoutez un Deployer avant le Testeur"
       },
       "fallbackMessage": "Cette action est en conflit avec l’état actuel.",
       "providersUnconfigured": {
@@ -460,6 +461,7 @@
     }
   },
   "inspector": {
+    "detectRepoUnresolved": "Le dépôt de ce bloc ne figure pas parmi les dépôts GitHub connectés et ne peut donc pas être lu. Connectez ou synchronisez GitHub pour ce dépôt, puis réessayez.",
     "container": {
       "title": "Contenu",
       "hint": "Les modules et les tâches contenus dans ce bloc. Cliquez sur une entrée pour la sélectionner sur le tableau.",

package/i18n/locales/he.json

@@ -391,7 +391,8 @@
         "bootstrap_not_retryable": "לא ניתן להריץ מחדש את האתחול",
         "bootstrap_reference_missing": "ארכיטקטורת ההפניה נעלמה",
         "preset_unsatisfiable": "קדם‑הגדרת המודל אינה יכולה להריץ צנרת זו",
-        "visual_pipeline_no_frontend": "אין frontend לבדיקה"
+        "visual_pipeline_no_frontend": "אין frontend לבדיקה",
+        "deployer_required_before_tester": "הוסף Deployer לפני ה-Tester"
       },
       "fallbackMessage": "פעולה זו מתנגשת עם המצב הנוכחי.",
       "providersUnconfigured": {
@@ -460,6 +461,7 @@
     }
   },
   "inspector": {
+    "detectRepoUnresolved": "מאגר הקוד של בלוק זה אינו נמצא בין מאגרי GitHub המחוברים, ולכן לא ניתן לקרוא אותו. חבר או סנכרן את GitHub עבורו ונסה שוב.",
     "container": {
       "title": "תוכן",
       "hint": "המודולים והמשימות בתוך בלוק זה. לחץ על פריט כדי לבחור אותו בלוח.",

package/i18n/locales/ja.json

@@ -391,7 +391,8 @@
         "bootstrap_not_retryable": "ブートストラップは再試行できません",
         "bootstrap_reference_missing": "リファレンスアーキテクチャが見つかりません",
         "preset_unsatisfiable": "モデルプリセットではこのパイプラインを実行できません",
-        "visual_pipeline_no_frontend": "テスト対象のフロントエンドがありません"
+        "visual_pipeline_no_frontend": "テスト対象のフロントエンドがありません",
+        "deployer_required_before_tester": "テスターの前にDeployerを追加してください"
       },
       "fallbackMessage": "この操作は現在の状態と競合します。",
       "providersUnconfigured": {
@@ -460,6 +461,7 @@
     }
   },
   "inspector": {
+    "detectRepoUnresolved": "このブロックのリポジトリは接続済みの GitHub リポジトリに含まれていないため、読み取れません。GitHub を接続または同期してから、もう一度お試しください。",
     "container": {
       "title": "内容",
       "hint": "このブロック内のモジュールとタスク。エントリをクリックするとボード上で選択されます。",

package/i18n/locales/pl.json

@@ -391,7 +391,8 @@
         "bootstrap_not_retryable": "Inicjalizacji nie można ponowić",
         "bootstrap_reference_missing": "Architektura referencyjna zniknęła",
         "preset_unsatisfiable": "Ten zestaw modeli nie może uruchomić tego potoku",
-        "visual_pipeline_no_frontend": "Brak frontendu do przetestowania"
+        "visual_pipeline_no_frontend": "Brak frontendu do przetestowania",
+        "deployer_required_before_tester": "Dodaj Deployer przed Testerem"
       },
       "fallbackMessage": "Ta akcja jest sprzeczna z bieżącym stanem.",
       "providersUnconfigured": {
@@ -460,6 +461,7 @@
     }
   },
   "inspector": {
+    "detectRepoUnresolved": "Repozytorium tego bloku nie znajduje się wśród połączonych repozytoriów GitHub, więc nie można go odczytać. Połącz lub zsynchronizuj GitHub dla tego repozytorium, a następnie spróbuj ponownie.",
     "container": {
       "title": "Zawartość",
       "hint": "Moduły i zadania wewnątrz tego bloku. Kliknij pozycję, aby zaznaczyć ją na tablicy.",

package/i18n/locales/tr.json

@@ -391,7 +391,8 @@
         "bootstrap_not_retryable": "Bootstrap yeniden denenemiyor",
         "bootstrap_reference_missing": "Referans mimari kayıp",
         "preset_unsatisfiable": "Model ön ayarı bu ardışık düzeni çalıştıramıyor",
-        "visual_pipeline_no_frontend": "Test edilecek bir frontend yok"
+        "visual_pipeline_no_frontend": "Test edilecek bir frontend yok",
+        "deployer_required_before_tester": "Tester’dan önce bir Deployer ekleyin"
       },
       "fallbackMessage": "Bu eylem mevcut durumla çelişiyor.",
       "providersUnconfigured": {
@@ -460,6 +461,7 @@
     }
   },
   "inspector": {
+    "detectRepoUnresolved": "Bu bloğun deposu bağlı GitHub depoları arasında değil, bu yüzden okunamıyor. Bunun için GitHub'ı bağlayın veya eşitleyin, ardından yeniden deneyin.",
     "container": {
       "title": "İçerik",
       "hint": "Bu bloğun içindeki modüller ve görevler. Bir öğeye tıklayarak panoda seçin.",

package/i18n/locales/uk.json

@@ -391,7 +391,8 @@
         "bootstrap_not_retryable": "Ініціалізацію неможливо повторити",
         "bootstrap_reference_missing": "Еталонна архітектура зникла",
         "preset_unsatisfiable": "Пресет моделі не може запустити цей конвеєр",
-        "visual_pipeline_no_frontend": "Немає фронтенду для тестування"
+        "visual_pipeline_no_frontend": "Немає фронтенду для тестування",
+        "deployer_required_before_tester": "Додайте Deployer перед Tester"
       },
       "fallbackMessage": "Ця дія суперечить поточному стану.",
       "providersUnconfigured": {
@@ -460,6 +461,7 @@
     }
   },
   "inspector": {
+    "detectRepoUnresolved": "Репозиторій цього блоку відсутній серед підключених репозиторіїв GitHub, тому його не вдається прочитати. Підключіть або синхронізуйте GitHub для нього та повторіть спробу.",
     "container": {
       "title": "Вміст",
       "hint": "Модулі та завдання всередині цього блока. Клацніть запис, щоб вибрати його на дошці.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.96.5",
+  "version": "0.97.1",
   "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.107.0"
+    "@cat-factory/contracts": "0.108.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",