@cat-factory/app 0.60.3 → 0.61.0

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

@@ -7,7 +7,12 @@ import type {
   ProvisionType,
   ServiceProvisioning,
 } from '~/types/domain'
-import type { KubernetesManifestSource, KubernetesRenderer } from '@cat-factory/contracts'
+import type {
+  KubernetesManifestSource,
+  KubernetesRenderer,
+  ProvisioningOverlayCandidate,
+  ProvisioningRecommendation,
+} from '@cat-factory/contracts'
 import RepoTreeBrowser from '~/components/github/RepoTreeBrowser.vue'
 
 // Service-level (frame) configuration: the service-owned PROVISIONING — the provision
@@ -32,7 +37,11 @@ const infra = useInfraConfigStore()
 const { t } = useI18n()
 
 // The custom-manifest-type catalog feeds the `custom` picker. Cheap + shared (coalesced).
-onMounted(() => void infra.ensureLoaded())
+// The repo list backs the detect-from-repo affordance (owner/name lookup).
+onMounted(() => {
+  void infra.ensureLoaded()
+  void github.ensureLoaded()
+})
 
 // The service's declared provision type (absent ⇒ treated as `infraless`: no environment
 // is stood up for the Tester). Switching type MERGES onto the existing provisioning so each
@@ -52,17 +61,22 @@ const kubeRepo = ref('')
 const kubeRef = ref('')
 const kubePath = ref('')
 const kubeRenderer = ref<KubernetesRenderer>('raw')
+// Seed the local kube edit refs from a persisted manifest source. Reused by the per-block
+// watch AND after a detect-from-repo run (which mutates provisioning without changing block.id,
+// so the watch wouldn't re-fire on its own).
+function seedKubeSource(src?: KubernetesManifestSource) {
+  kubeSourceType.value = src?.type ?? 'colocated'
+  kubePath.value = src?.path ?? ''
+  kubeRenderer.value = src?.renderer ?? 'raw'
+  kubeRepo.value = src?.type === 'separate' ? src.repo : ''
+  kubeRef.value = src?.type === 'separate' ? (src.ref ?? '') : ''
+}
 watch(
   () => props.block.id,
-  () => {
-    const src = props.block.provisioning?.manifestSource
-    kubeSourceType.value = src?.type ?? 'colocated'
-    kubePath.value = src?.path ?? ''
-    kubeRenderer.value = src?.renderer ?? 'raw'
-    kubeRepo.value = src?.type === 'separate' ? src.repo : ''
-    kubeRef.value = src?.type === 'separate' ? (src.ref ?? '') : ''
+  () => seedKubeSource(props.block.provisioning?.manifestSource),
+  {
+    immediate: true,
   },
-  { immediate: true },
 )
 const customManifestId = computed(() => props.block.provisioning?.manifestId ?? '')
 const customManifestPath = computed(() => props.block.provisioning?.manifestPath ?? '')
@@ -183,6 +197,65 @@ function applyPicked() {
   browseOpen.value = false
 }
 
+// Auto-detect (slice 11): read the repo checkout-free and propose a NON-BINDING provisioning
+// config. The user always confirms — the result prefills the form (and the kube edit refs) but
+// 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)
+const detectResult = ref<ProvisioningRecommendation | null>(null)
+
+// A detection result is scoped to the inspected block — clear it (and any error) when the
+// selection changes, so block B never shows block A's stale recommendation / overlay chips.
+watch(
+  () => props.block.id,
+  () => {
+    detectResult.value = null
+    detectError.value = false
+  },
+)
+
+async function detectFromRepo() {
+  const ctx = repoContext.value
+  if (!ctx) return
+  const repo = github.repoFor(ctx.githubId)
+  if (!repo) {
+    detectError.value = true
+    return
+  }
+  detecting.value = true
+  detectError.value = false
+  try {
+    const rec = await infra.detectProvisioning({
+      owner: repo.owner,
+      repo: repo.name,
+      ...(ctx.directory ? { directory: ctx.directory } : {}),
+    })
+    detectResult.value = rec
+    // Only prefill when the detector actually inferred something. A `detected: false`
+    // recommendation is `infraless`; applying it would WIPE the service's existing
+    // provisioning (board.updateBlock persists immediately). Leave the current config
+    // untouched and just surface the "nothing found" note.
+    if (rec.detected) {
+      board.updateBlock(props.block.id, { provisioning: rec.provisioning })
+      if (rec.provisioning.type === 'kubernetes') seedKubeSource(rec.provisioning.manifestSource)
+    }
+  } catch {
+    detectError.value = true
+  } finally {
+    detecting.value = false
+  }
+}
+
+// Switch the recommended manifest path to a different overlay candidate (the user's pick).
+function applyOverlay(candidate: ProvisioningOverlayCandidate) {
+  setKubePath(candidate.path)
+}
+
+function provisionTypeLabel(type: ProvisionType): string {
+  return t(`inspector.testConfig.provisionTypes.${type}`)
+}
+
 // A service with no explicit provider inherits the active account's default (else the
 // built-in `cloudflare`); show that as the selected chip so the inherited value is visible.
 const effectiveProvider = computed<CloudProvider>(
@@ -237,6 +310,90 @@ function setSize(value: InstanceSize) {
       </p>
     </div>
 
+    <!-- Auto-detect a recommended provisioning config from the repo (slice 11). Non-binding:
+         it prefills the form below + the kube edit refs; the user confirms/edits everything. -->
+    <div v-if="repoContext" class="space-y-2 rounded border border-slate-800 bg-slate-900/40 p-2">
+      <div class="flex items-center justify-between gap-2">
+        <span class="text-[11px] text-slate-400">{{ t('inspector.testConfig.detect.title') }}</span>
+        <UButton
+          size="xs"
+          variant="soft"
+          color="primary"
+          icon="i-lucide-wand-sparkles"
+          :loading="detecting"
+          @click="detectFromRepo"
+        >
+          {{ t('inspector.testConfig.detect.button') }}
+        </UButton>
+      </div>
+      <p class="text-[11px] leading-snug text-slate-500">
+        {{ t('inspector.testConfig.detect.hint') }}
+      </p>
+
+      <p v-if="detectError" class="text-[11px] text-rose-300/80">
+        {{ t('inspector.testConfig.detect.error') }}
+      </p>
+
+      <template v-if="detectResult && !detecting">
+        <p v-if="!detectResult.detected" class="text-[11px] text-amber-300/80">
+          {{ t('inspector.testConfig.detect.none') }}
+        </p>
+        <template v-else>
+          <p class="text-[11px] text-emerald-300/80">
+            {{
+              t('inspector.testConfig.detect.applied', {
+                type: provisionTypeLabel(detectResult.provisioning.type),
+              })
+            }}
+          </p>
+
+          <div v-if="detectResult.overlayCandidates?.length" class="space-y-1">
+            <span class="text-[11px] text-slate-400">{{
+              t('inspector.testConfig.detect.overlayTitle')
+            }}</span>
+            <div class="flex flex-wrap gap-1">
+              <UButton
+                v-for="o in detectResult.overlayCandidates"
+                :key="o.path"
+                :color="kubePath === o.path ? 'primary' : 'neutral'"
+                :variant="kubePath === o.path ? 'soft' : 'ghost'"
+                size="xs"
+                @click="applyOverlay(o)"
+              >
+                {{ o.name }}
+              </UButton>
+            </div>
+          </div>
+
+          <p v-if="detectResult.urlSource" class="text-[11px] text-slate-500">
+            {{
+              t('inspector.testConfig.detect.urlSource', { source: detectResult.urlSource.source })
+            }}
+          </p>
+          <p v-if="detectResult.namespace" class="text-[11px] text-slate-500">
+            {{ t('inspector.testConfig.detect.namespace', { namespace: detectResult.namespace }) }}
+          </p>
+
+          <ul v-if="detectResult.notes.length" class="space-y-0.5">
+            <li
+              v-for="(n, i) in detectResult.notes"
+              :key="i"
+              class="flex items-start gap-1.5 text-[11px] leading-snug text-slate-500"
+            >
+              <span :class="n.confidence === 'high' ? 'text-emerald-400/70' : 'text-amber-400/70'">
+                {{
+                  n.confidence === 'high'
+                    ? t('inspector.testConfig.detect.confidenceHigh')
+                    : t('inspector.testConfig.detect.confidenceLow')
+                }}
+              </span>
+              <span>{{ n.message }}</span>
+            </li>
+          </ul>
+        </template>
+      </template>
+    </div>
+
     <div v-if="provisionType === 'docker-compose'" class="space-y-2">
       <div class="space-y-1">
         <label class="text-[11px] text-slate-400">{{

package/app/composables/api/infraHandlers.ts

@@ -1,4 +1,5 @@
 import {
+  detectServiceProvisioningContract,
   listEnvironmentHandlersContract,
   listEnvironmentUserHandlersContract,
   registerEnvironmentHandlerContract,
@@ -9,6 +10,7 @@ import {
   upsertEnvironmentUserHandlerContract,
 } from '@cat-factory/contracts'
 import type {
+  DetectServiceProvisioningInput,
   ProvisionType,
   RegisterEnvironmentHandlerInput,
   UpsertCustomManifestTypeInput,
@@ -33,6 +35,10 @@ export function infraHandlersApi({ send, ws }: ApiContext) {
     registerEnvironmentHandler: (workspaceId: string, body: RegisterEnvironmentHandlerInput) =>
       send(registerEnvironmentHandlerContract, { pathPrefix: ws(workspaceId), body }),
 
+    // Auto-detect a non-binding recommended provisioning config from a service's repo.
+    detectServiceProvisioning: (workspaceId: string, body: DetectServiceProvisioningInput) =>
+      send(detectServiceProvisioningContract, { pathPrefix: ws(workspaceId), body }),
+
     // `manifestId` (for a `custom` handler) rides as a query param; absent ⇒ the bare handler.
     unregisterEnvironmentHandler: (
       workspaceId: string,

package/app/stores/infraConfig.ts

@@ -2,6 +2,7 @@ import { defineStore } from 'pinia'
 import { ref, type Ref } from 'vue'
 import type {
   CustomManifestType,
+  DetectServiceProvisioningInput,
   EnvironmentHandlerView,
   ProvisionType,
   RegisterEnvironmentHandlerInput,
@@ -94,6 +95,16 @@ export const useInfraConfigStore = defineStore('infraConfig', () => {
     return saved
   }
 
+  /**
+   * Auto-detect a NON-BINDING recommended provisioning config from a service's repo. The SPA
+   * prefills the confirm form from the result; nothing is persisted server-side. Detection is
+   * pure repo introspection, so it works regardless of which handlers are registered.
+   */
+  async function detectProvisioning(input: DetectServiceProvisioningInput) {
+    const ws = useWorkspaceStore()
+    return api.detectServiceProvisioning(ws.requireId(), input)
+  }
+
   async function unregisterHandler(type: ProvisionType, manifestId?: string | null) {
     const ws = useWorkspaceStore()
     await api.unregisterEnvironmentHandler(ws.requireId(), type, manifestId ?? undefined)
@@ -161,6 +172,7 @@ export const useInfraConfigStore = defineStore('infraConfig', () => {
     ensureLoaded,
     handlerFor,
     registerHandler,
+    detectProvisioning,
     unregisterHandler,
     upsertCustomType,
     removeCustomType,

package/i18n/locales/en.json

@@ -474,7 +474,20 @@
       "customManifestIdPlaceholder": "Pick a manifest type",
       "customNoTypes": "No custom manifest types are defined yet. Add one in the Infrastructure window.",
       "customManifestIdHint": "The custom type this service produces, matched to a remote-custom handler the workspace configures.",
-      "customManifestPath": "Manifest path (optional)"
+      "customManifestPath": "Manifest path (optional)",
+      "detect": {
+        "title": "Auto-detect",
+        "button": "Detect from repo",
+        "hint": "Inspect the repository and suggest a provisioning config. You confirm and edit everything below; nothing is saved automatically.",
+        "error": "Could not read the repository to detect provisioning.",
+        "none": "No Kubernetes manifests or Compose file were detected.",
+        "applied": "Suggested a {type} config. Review and adjust the fields below.",
+        "overlayTitle": "Ephemeral overlay",
+        "urlSource": "Suggested environment URL source: {source}. The workspace handler owns this; set it there.",
+        "namespace": "Manifests pin namespace \"{namespace}\"; recommend honoring it on the workspace handler.",
+        "confidenceHigh": "Detected",
+        "confidenceLow": "Suggestion"
+      }
     },
     "agentConfig": {
       "title": "Agent configuration",

package/i18n/locales/es.json

@@ -437,7 +437,20 @@
       "customManifestIdPlaceholder": "Elige un tipo de manifiesto",
       "customNoTypes": "Aún no hay tipos de manifiesto personalizados. Añade uno en la ventana de Infraestructura.",
       "customManifestIdHint": "El tipo personalizado que produce este servicio, emparejado con un gestor remote-custom que configura el espacio de trabajo.",
-      "customManifestPath": "Ruta del manifiesto (opcional)"
+      "customManifestPath": "Ruta del manifiesto (opcional)",
+      "detect": {
+        "title": "Detección automática",
+        "button": "Detectar desde el repo",
+        "hint": "Inspecciona el repositorio y sugiere una configuración de aprovisionamiento. Confirmas y editas todo lo de abajo; nada se guarda automáticamente.",
+        "error": "No se pudo leer el repositorio para detectar el aprovisionamiento.",
+        "none": "No se detectaron manifiestos de Kubernetes ni archivo Compose.",
+        "applied": "Se sugirió una configuración {type}. Revisa y ajusta los campos de abajo.",
+        "overlayTitle": "Overlay efímero",
+        "urlSource": "Fuente de URL del entorno sugerida: {source}. El gestor del espacio de trabajo la controla; configúrala allí.",
+        "namespace": "Los manifiestos fijan el espacio de nombres \"{namespace}\"; se recomienda respetarlo en el gestor del espacio de trabajo.",
+        "confidenceHigh": "Detectado",
+        "confidenceLow": "Sugerencia"
+      }
     },
     "agentConfig": {
       "title": "Configuración del agente",

package/i18n/locales/fr.json

@@ -437,7 +437,20 @@
       "customManifestIdPlaceholder": "Choisir un type de manifeste",
       "customNoTypes": "Aucun type de manifeste personnalisé n'est encore défini. Ajoutez-en un dans la fenêtre Infrastructure.",
       "customManifestIdHint": "Le type personnalisé que ce service produit, associé à un gestionnaire remote-custom configuré par l'espace de travail.",
-      "customManifestPath": "Chemin du manifeste (facultatif)"
+      "customManifestPath": "Chemin du manifeste (facultatif)",
+      "detect": {
+        "title": "Détection automatique",
+        "button": "Détecter depuis le dépôt",
+        "hint": "Inspecte le dépôt et propose une configuration de provisionnement. Vous confirmez et modifiez tout ci-dessous ; rien n'est enregistré automatiquement.",
+        "error": "Impossible de lire le dépôt pour détecter le provisionnement.",
+        "none": "Aucun manifeste Kubernetes ni fichier Compose détecté.",
+        "applied": "Configuration {type} suggérée. Vérifiez et ajustez les champs ci-dessous.",
+        "overlayTitle": "Overlay éphémère",
+        "urlSource": "Source d'URL d'environnement suggérée : {source}. Le gestionnaire de l'espace de travail la contrôle ; définissez-la là.",
+        "namespace": "Les manifestes fixent l'espace de noms « {namespace} » ; il est recommandé de le respecter sur le gestionnaire de l'espace de travail.",
+        "confidenceHigh": "Détecté",
+        "confidenceLow": "Suggestion"
+      }
     },
     "agentConfig": {
       "title": "Configuration de l'agent",

package/i18n/locales/he.json

@@ -437,7 +437,20 @@
       "customManifestIdPlaceholder": "בחר סוג מניפסט",
       "customNoTypes": "עדיין לא הוגדרו סוגי מניפסט מותאמים. הוסף אחד בחלון התשתית.",
       "customManifestIdHint": "הסוג המותאם שהשירות הזה מייצר, המותאם למטפל remote-custom שהמרחב מגדיר.",
-      "customManifestPath": "נתיב המניפסט (אופציונלי)"
+      "customManifestPath": "נתיב המניפסט (אופציונלי)",
+      "detect": {
+        "title": "זיהוי אוטומטי",
+        "button": "זהה מהמאגר",
+        "hint": "בדיקת המאגר והצעת תצורת הקצאה. אתה מאשר ועורך הכול למטה; שום דבר לא נשמר אוטומטית.",
+        "error": "לא ניתן לקרוא את המאגר כדי לזהות את ההקצאה.",
+        "none": "לא זוהו מניפסטים של Kubernetes או קובץ Compose.",
+        "applied": "הוצעה תצורת {type}. בדוק והתאם את השדות למטה.",
+        "overlayTitle": "שכבת סביבה זמנית",
+        "urlSource": "מקור כתובת הסביבה המוצע: {source}. המטפל של המרחב שולט בכך; הגדר זאת שם.",
+        "namespace": "המניפסטים מקבעים את מרחב השמות \"{namespace}\"; מומלץ לכבד אותו במטפל של המרחב.",
+        "confidenceHigh": "זוהה",
+        "confidenceLow": "הצעה"
+      }
     },
     "agentConfig": {
       "title": "תצורת סוכן",

package/i18n/locales/ja.json

@@ -437,7 +437,20 @@
       "customManifestIdPlaceholder": "マニフェストタイプを選択",
       "customNoTypes": "カスタムマニフェストタイプはまだ定義されていません。インフラウィンドウで追加してください。",
       "customManifestIdHint": "このサービスが生成するカスタムタイプ。ワークスペースが構成する remote-custom ハンドラーと照合されます。",
-      "customManifestPath": "マニフェストのパス（任意）"
+      "customManifestPath": "マニフェストのパス（任意）",
+      "detect": {
+        "title": "自動検出",
+        "button": "リポジトリから検出",
+        "hint": "リポジトリを調べてプロビジョニング設定を提案します。以下の内容はすべて確認・編集でき、自動保存はされません。",
+        "error": "リポジトリを読み取ってプロビジョニングを検出できませんでした。",
+        "none": "Kubernetes マニフェストや Compose ファイルは検出されませんでした。",
+        "applied": "{type} の設定を提案しました。以下のフィールドを確認して調整してください。",
+        "overlayTitle": "一時環境のオーバーレイ",
+        "urlSource": "推奨される環境 URL ソース: {source}。これはワークスペースのハンドラーが管理します。そちらで設定してください。",
+        "namespace": "マニフェストは名前空間「{namespace}」を固定しています。ワークスペースのハンドラーでそれを尊重することを推奨します。",
+        "confidenceHigh": "検出",
+        "confidenceLow": "提案"
+      }
     },
     "agentConfig": {
       "title": "エージェント設定",

package/i18n/locales/pl.json

@@ -437,7 +437,20 @@
       "customManifestIdPlaceholder": "Wybierz typ manifestu",
       "customNoTypes": "Nie zdefiniowano jeszcze niestandardowych typów manifestów. Dodaj jeden w oknie Infrastruktura.",
       "customManifestIdHint": "Niestandardowy typ, który tworzy ta usługa, dopasowany do handlera remote-custom skonfigurowanego przez przestrzeń roboczą.",
-      "customManifestPath": "Ścieżka manifestu (opcjonalnie)"
+      "customManifestPath": "Ścieżka manifestu (opcjonalnie)",
+      "detect": {
+        "title": "Autowykrywanie",
+        "button": "Wykryj z repozytorium",
+        "hint": "Sprawdza repozytorium i proponuje konfigurację provisioningu. Potwierdzasz i edytujesz wszystko poniżej; nic nie jest zapisywane automatycznie.",
+        "error": "Nie udało się odczytać repozytorium, aby wykryć provisioning.",
+        "none": "Nie wykryto manifestów Kubernetes ani pliku Compose.",
+        "applied": "Zaproponowano konfigurację {type}. Przejrzyj i dostosuj pola poniżej.",
+        "overlayTitle": "Tymczasowy overlay",
+        "urlSource": "Sugerowane źródło adresu URL środowiska: {source}. Zarządza tym handler przestrzeni roboczej; ustaw to tam.",
+        "namespace": "Manifesty ustalają przestrzeń nazw \"{namespace}\"; zaleca się jej przestrzeganie w handlerze przestrzeni roboczej.",
+        "confidenceHigh": "Wykryto",
+        "confidenceLow": "Sugestia"
+      }
     },
     "agentConfig": {
       "title": "Konfiguracja agenta",

package/i18n/locales/tr.json

@@ -437,7 +437,20 @@
       "customManifestIdPlaceholder": "Bir manifest türü seçin",
       "customNoTypes": "Henüz özel manifest türü tanımlanmadı. Altyapı penceresinden bir tane ekleyin.",
       "customManifestIdHint": "Bu servisin ürettiği özel tür; çalışma alanının yapılandırdığı remote-custom işleyiciyle eşleştirilir.",
-      "customManifestPath": "Manifest yolu (isteğe bağlı)"
+      "customManifestPath": "Manifest yolu (isteğe bağlı)",
+      "detect": {
+        "title": "Otomatik algılama",
+        "button": "Depodan algıla",
+        "hint": "Depoyu inceleyip bir provizyon yapılandırması önerir. Aşağıdaki her şeyi onaylayıp düzenlersiniz; hiçbir şey otomatik kaydedilmez.",
+        "error": "Provizyonu algılamak için depo okunamadı.",
+        "none": "Kubernetes manifesti veya Compose dosyası algılanmadı.",
+        "applied": "{type} yapılandırması önerildi. Aşağıdaki alanları gözden geçirip ayarlayın.",
+        "overlayTitle": "Geçici overlay",
+        "urlSource": "Önerilen ortam URL kaynağı: {source}. Bunu çalışma alanı işleyicisi yönetir; oradan ayarlayın.",
+        "namespace": "Manifestler \"{namespace}\" ad alanını sabitliyor; çalışma alanı işleyicisinde buna uymanız önerilir.",
+        "confidenceHigh": "Algılandı",
+        "confidenceLow": "Öneri"
+      }
     },
     "agentConfig": {
       "title": "Ajan yapılandırması",

package/i18n/locales/uk.json

@@ -437,7 +437,20 @@
       "customManifestIdPlaceholder": "Виберіть тип маніфесту",
       "customNoTypes": "Власні типи маніфестів ще не визначені. Додайте один у вікні Інфраструктура.",
       "customManifestIdHint": "Власний тип, який створює ця служба, зіставлений з обробником remote-custom, який налаштовує робочий простір.",
-      "customManifestPath": "Шлях до маніфесту (необов'язково)"
+      "customManifestPath": "Шлях до маніфесту (необов'язково)",
+      "detect": {
+        "title": "Автовизначення",
+        "button": "Визначити з репозиторію",
+        "hint": "Перевірити репозиторій і запропонувати конфігурацію провізіювання. Ви підтверджуєте та редагуєте все нижче; нічого не зберігається автоматично.",
+        "error": "Не вдалося прочитати репозиторій для визначення провізіювання.",
+        "none": "Маніфести Kubernetes або файл Compose не виявлено.",
+        "applied": "Запропоновано конфігурацію {type}. Перегляньте та скоригуйте поля нижче.",
+        "overlayTitle": "Тимчасовий overlay",
+        "urlSource": "Запропоноване джерело URL середовища: {source}. Цим керує обробник робочого простору; налаштуйте його там.",
+        "namespace": "Маніфести фіксують простір імен \"{namespace}\"; рекомендуємо дотримуватися його в обробнику робочого простору.",
+        "confidenceHigh": "Виявлено",
+        "confidenceLow": "Пропозиція"
+      }
     },
     "agentConfig": {
       "title": "Конфігурація агента",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.60.3",
+  "version": "0.61.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.67.0"
+    "@cat-factory/contracts": "0.68.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",