@cat-factory/app 0.97.0 → 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/i18n/locales/en.json

@@ -504,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

@@ -461,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

@@ -461,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

@@ -461,6 +461,7 @@
     }
   },
   "inspector": {
+    "detectRepoUnresolved": "מאגר הקוד של בלוק זה אינו נמצא בין מאגרי GitHub המחוברים, ולכן לא ניתן לקרוא אותו. חבר או סנכרן את GitHub עבורו ונסה שוב.",
     "container": {
       "title": "תוכן",
       "hint": "המודולים והמשימות בתוך בלוק זה. לחץ על פריט כדי לבחור אותו בלוח.",

package/i18n/locales/ja.json

@@ -461,6 +461,7 @@
     }
   },
   "inspector": {
+    "detectRepoUnresolved": "このブロックのリポジトリは接続済みの GitHub リポジトリに含まれていないため、読み取れません。GitHub を接続または同期してから、もう一度お試しください。",
     "container": {
       "title": "内容",
       "hint": "このブロック内のモジュールとタスク。エントリをクリックするとボード上で選択されます。",

package/i18n/locales/pl.json

@@ -461,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

@@ -461,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

@@ -461,6 +461,7 @@
     }
   },
   "inspector": {
+    "detectRepoUnresolved": "Репозиторій цього блоку відсутній серед підключених репозиторіїв GitHub, тому його не вдається прочитати. Підключіть або синхронізуйте GitHub для нього та повторіть спробу.",
     "container": {
       "title": "Вміст",
       "hint": "Модулі та завдання всередині цього блока. Клацніть запис, щоб вибрати його на дошці.",

package/package.json

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