@cat-factory/app 0.101.0 → 0.102.0

package/app/components/settings/SharedStacksPanel.vue

@@ -6,7 +6,11 @@
 // they succeed only on the local facade (elsewhere the backend returns a clear error surfaced as
 // a toast). Renders inline inside the Infrastructure window's "Shared stacks" tab.
 import { computed, reactive, ref } from 'vue'
-import type { SharedStack, SharedStackStatus } from '~/types/sharedStacks'
+import type {
+  SharedStack,
+  SharedStackRecommendation,
+  SharedStackStatus,
+} from '~/types/sharedStacks'
 
 const { t } = useI18n()
 const store = useSharedStacksStore()
@@ -16,6 +20,7 @@ const { confirmAction, toastDone } = useConfirmAction()
 const stacks = computed(() => store.stacks)
 const busyId = ref<string | null>(null)
 const saving = ref(false)
+const detecting = ref(false)
 // null ⇒ the form is in "add" mode; a stack id ⇒ editing that stack's definition in place.
 const editingId = ref<string | null>(null)
 
@@ -23,12 +28,20 @@ const form = reactive({
   name: '',
   cloneUrl: '',
   gitRef: '',
+  // Subdirectory the compose stack lives in (monorepo) — a detect-time hint only, NOT persisted:
+  // the resolved `composeFiles` already carry the prefix. Absent ⇒ the repo root is scanned.
+  directory: '',
   composeFiles: '',
   composeProfiles: '',
   managedNetworks: '',
   allowHostCommands: false,
 })
 
+// Env/config templates (`*-dist` → gitignored target) the autodetect scan surfaced. The form has no
+// editor for them, so we carry the detected (or, on edit, the stack's existing) set through to the
+// save payload rather than silently dropping them — they're materialized before `up`.
+const detectedEnvFiles = ref<SharedStack['envFiles']>([])
+
 /** Status → badge colour. */
 const STATUS_COLOR: Record<SharedStackStatus, 'neutral' | 'warning' | 'success' | 'error'> = {
   stopped: 'neutral',
@@ -72,10 +85,12 @@ function resetForm() {
   form.name = ''
   form.cloneUrl = ''
   form.gitRef = ''
+  form.directory = ''
   form.composeFiles = ''
   form.composeProfiles = ''
   form.managedNetworks = ''
   form.allowHostCommands = false
+  detectedEnvFiles.value = []
 }
 
 /** Load a stack's definition into the form for in-place editing. */
@@ -84,10 +99,59 @@ function startEdit(stack: SharedStack) {
   form.name = stack.name
   form.cloneUrl = stack.cloneUrl
   form.gitRef = stack.gitRef ?? ''
+  form.directory = ''
   form.composeFiles = stack.composeFiles.join(', ')
   form.composeProfiles = stack.composeProfiles.join(', ')
   form.managedNetworks = stack.managedNetworks.join(', ')
   form.allowHostCommands = stack.allowHostCommands
+  // Preserve the stack's existing env templates so a save (or a later re-detect) doesn't drop them.
+  detectedEnvFiles.value = stack.envFiles
+}
+
+const canDetect = computed(() => Boolean(form.cloneUrl.trim()) && !detecting.value)
+
+/**
+ * Read the repo at the entered clone URL (checkout-free, via the workspace's VCS connection) and
+ * PREFILL the compose-shaped fields from the recommendation. Non-binding: the user reviews + edits
+ * before saving. A SUCCESSFUL detection is authoritative for the compose-shaped fields — it
+ * overwrites them wholesale, including clearing a field the scan found empty (so re-detecting a
+ * different repo can't leave a stale managed network / profile behind). Manual entries survive only
+ * a `detected:false` result, which returns early and touches nothing. The name is suggested only
+ * when still blank (it's a user label, not a repo-derived fact).
+ */
+async function autodetect() {
+  detecting.value = true
+  try {
+    const rec = await store.detect({
+      cloneUrl: form.cloneUrl.trim(),
+      ...(form.gitRef.trim() ? { gitRef: form.gitRef.trim() } : {}),
+      ...(form.directory.trim() ? { directory: form.directory.trim() } : {}),
+    })
+    if (!rec.detected) {
+      toast.add({
+        title: t('settings.sharedStacks.detect.nothing'),
+        description: rec.notes[0]?.message ?? '',
+        icon: 'i-lucide-info',
+        color: 'warning',
+      })
+      return
+    }
+    if (rec.name && !form.name.trim()) form.name = rec.name
+    form.composeFiles = rec.composeFiles.join(', ')
+    form.composeProfiles = rec.composeProfiles.join(', ')
+    form.managedNetworks = rec.managedNetworks.join(', ')
+    detectedEnvFiles.value = rec.envFiles
+    toast.add({
+      title: t('settings.sharedStacks.detect.detected'),
+      description: t('settings.sharedStacks.detect.detectedBody'),
+      icon: 'i-lucide-wand-sparkles',
+      color: 'success',
+    })
+  } catch (e) {
+    notifyError(t('settings.sharedStacks.detect.failed'), e)
+  } finally {
+    detecting.value = false
+  }
 }
 
 function notifyError(title: string, e: unknown) {
@@ -110,6 +174,7 @@ async function saveStack() {
     composeFiles: tokens(form.composeFiles),
     composeProfiles: tokens(form.composeProfiles),
     managedNetworks: tokens(form.managedNetworks),
+    envFiles: detectedEnvFiles.value,
     allowHostCommands: form.allowHostCommands,
   }
   try {
@@ -300,6 +365,42 @@ async function remove(stack: SharedStack) {
         />
       </UFormField>
 
+      <UFormField
+        :label="t('settings.sharedStacks.add.directory')"
+        :help="t('settings.sharedStacks.add.directoryHelp')"
+      >
+        <UInput
+          v-model="form.directory"
+          placeholder="shared"
+          class="w-full"
+          data-testid="shared-stack-directory"
+        />
+      </UFormField>
+
+      <div class="flex items-center gap-2">
+        <UButton
+          icon="i-lucide-wand-sparkles"
+          size="sm"
+          variant="soft"
+          :loading="detecting"
+          :disabled="!canDetect"
+          data-testid="shared-stack-autodetect"
+          @click="autodetect"
+        >
+          {{ t('settings.sharedStacks.detect.button') }}
+        </UButton>
+        <span class="text-[11px] text-slate-500">{{ t('settings.sharedStacks.detect.hint') }}</span>
+      </div>
+
+      <p
+        v-if="detectedEnvFiles.length"
+        class="text-[11px] text-slate-500"
+        data-testid="shared-stack-env-files"
+      >
+        {{ t('settings.sharedStacks.detect.envFiles') }}
+        {{ detectedEnvFiles.map((f) => `${f.template} → ${f.target}`).join(', ') }}
+      </p>
+
       <UFormField
         :label="t('settings.sharedStacks.add.composeFiles')"
         :help="t('settings.sharedStacks.add.composeFilesHelp')"

package/app/composables/api/sharedStacks.ts

@@ -1,12 +1,13 @@
 import {
   createSharedStackContract,
   deleteSharedStackContract,
+  detectSharedStackContract,
   ensureSharedStackUpContract,
   listSharedStacksContract,
   teardownSharedStackContract,
   updateSharedStackContract,
 } from '@cat-factory/contracts'
-import type { UpdateSharedStackInput } from '~/types/sharedStacks'
+import type { DetectSharedStackInput, UpdateSharedStackInput } from '~/types/sharedStacks'
 import type { SendParams } from './client'
 import type { ApiContext } from './context'
 
@@ -23,6 +24,9 @@ export function sharedStacksApi({ send, ws }: ApiContext) {
     createSharedStack: (workspaceId: string, body: CreateSharedStackBody) =>
       send(createSharedStackContract, { pathPrefix: ws(workspaceId), body }),
 
+    detectSharedStack: (workspaceId: string, body: DetectSharedStackInput) =>
+      send(detectSharedStackContract, { pathPrefix: ws(workspaceId), body }),
+
     updateSharedStack: (workspaceId: string, stackId: string, body: UpdateSharedStackInput) =>
       send(updateSharedStackContract, {
         pathPrefix: ws(workspaceId),

package/app/stores/sharedStacks.ts

@@ -1,6 +1,10 @@
 import { defineStore } from 'pinia'
 import { ref } from 'vue'
-import type { SharedStack, UpdateSharedStackInput } from '~/types/sharedStacks'
+import type {
+  DetectSharedStackInput,
+  SharedStack,
+  UpdateSharedStackInput,
+} from '~/types/sharedStacks'
 import { useWorkspaceStore } from '~/stores/workspace'
 
 /**
@@ -34,6 +38,11 @@ export const useSharedStacksStore = defineStore('sharedStacks', () => {
     return created
   }
 
+  async function detect(input: DetectSharedStackInput) {
+    const ws = useWorkspaceStore()
+    return api.detectSharedStack(ws.requireId(), input)
+  }
+
   async function update(stackId: string, patchInput: UpdateSharedStackInput) {
     const ws = useWorkspaceStore()
     const updated = await api.updateSharedStack(ws.requireId(), stackId, patchInput)
@@ -61,5 +70,5 @@ export const useSharedStacksStore = defineStore('sharedStacks', () => {
     return updated
   }
 
-  return { stacks, hydrate, create, update, remove, ensureUp, teardown }
+  return { stacks, hydrate, create, detect, update, remove, ensureUp, teardown }
 })

package/app/types/sharedStacks.ts

@@ -5,4 +5,6 @@ export type {
   SharedStackStatus,
   CreateSharedStackInput,
   UpdateSharedStackInput,
+  DetectSharedStackInput,
+  SharedStackRecommendation,
 } from '@cat-factory/contracts'

package/i18n/locales/de.json

@@ -530,6 +530,8 @@
         "cloneUrl": "Clone-URL des Repositorys",
         "cloneUrlHelp": "Das Git-Repository, in dem die Compose-Dateien des Stacks liegen.",
         "gitRef": "Branch oder Tag (optional)",
+        "directory": "Unterverzeichnis (optional)",
+        "directoryHelp": "Wird nur von der automatischen Erkennung verwendet: das Monorepo-Unterverzeichnis, in dem der Compose-Stack liegt.",
         "composeFiles": "Compose-Dateien",
         "composeFilesHelp": "Kommagetrennt, repo-relativ, in Override-Reihenfolge.",
         "composeProfiles": "Compose-Profile (optional)",
@@ -538,6 +540,15 @@
         "allowHostCommands": "Host-Command-Setup-Schritte erlauben",
         "save": "Stack hinzufügen"
       },
+      "detect": {
+        "button": "Automatisch erkennen",
+        "hint": "Das Repository lesen und Compose-Dateien, Profile und Netzwerke vorausfüllen.",
+        "detected": "Stack-Konfiguration erkannt",
+        "detectedBody": "Aus dem Repository vorausgefüllt. Überprüfen Sie die Felder vor dem Speichern.",
+        "nothing": "Nichts automatisch zu erkennen",
+        "failed": "Automatische Erkennung fehlgeschlagen",
+        "envFiles": "Env-Vorlagen, die vor dem Start materialisiert werden:"
+      },
       "edit": {
         "heading": "Gemeinsamen Stack bearbeiten",
         "save": "Änderungen speichern",

package/i18n/locales/en.json

@@ -2224,6 +2224,8 @@
         "cloneUrl": "Repository clone URL",
         "cloneUrlHelp": "The git repository the stack's compose files live in.",
         "gitRef": "Branch or tag (optional)",
+        "directory": "Subdirectory (optional)",
+        "directoryHelp": "Used only by Autodetect: the monorepo subdirectory the compose stack lives in.",
         "composeFiles": "Compose files",
         "composeFilesHelp": "Comma-separated, repo-relative, in override order.",
         "composeProfiles": "Compose profiles (optional)",
@@ -2232,6 +2234,15 @@
         "allowHostCommands": "Allow host-command setup steps",
         "save": "Add stack"
       },
+      "detect": {
+        "button": "Autodetect",
+        "hint": "Read the repository and prefill the compose files, profiles, and networks.",
+        "detected": "Detected stack configuration",
+        "detectedBody": "Prefilled from the repository. Review the fields before saving.",
+        "nothing": "Nothing to autodetect",
+        "failed": "Autodetection failed",
+        "envFiles": "Env templates to materialize before start:"
+      },
       "edit": {
         "heading": "Edit shared stack",
         "save": "Save changes",

package/i18n/locales/es.json

@@ -2050,6 +2050,8 @@
         "cloneUrl": "URL de clonación del repositorio",
         "cloneUrlHelp": "El repositorio git donde viven los archivos de Compose del stack.",
         "gitRef": "Rama o etiqueta (opcional)",
+        "directory": "Subdirectorio (opcional)",
+        "directoryHelp": "Solo lo usa la detección automática: el subdirectorio del monorepo donde se encuentra el stack de compose.",
         "composeFiles": "Archivos de Compose",
         "composeFilesHelp": "Separados por comas, relativos al repositorio, en orden de anulación.",
         "composeProfiles": "Perfiles de Compose (opcional)",
@@ -2058,6 +2060,15 @@
         "allowHostCommands": "Permitir pasos de configuración con comandos del host",
         "save": "Añadir stack"
       },
+      "detect": {
+        "button": "Detectar automáticamente",
+        "hint": "Lee el repositorio y rellena los archivos de compose, los perfiles y las redes.",
+        "detected": "Configuración del stack detectada",
+        "detectedBody": "Rellenado desde el repositorio. Revisa los campos antes de guardar.",
+        "nothing": "No hay nada que detectar automáticamente",
+        "failed": "La detección automática falló",
+        "envFiles": "Plantillas de entorno que se materializarán antes de iniciar:"
+      },
       "edit": {
         "heading": "Editar stack compartido",
         "save": "Guardar cambios",

package/i18n/locales/fr.json

@@ -2050,6 +2050,8 @@
         "cloneUrl": "URL de clonage du dépôt",
         "cloneUrlHelp": "Le dépôt git où se trouvent les fichiers Compose du stack.",
         "gitRef": "Branche ou tag (facultatif)",
+        "directory": "Sous-répertoire (facultatif)",
+        "directoryHelp": "Utilisé uniquement par la détection automatique : le sous-répertoire du monorepo où se trouve le stack compose.",
         "composeFiles": "Fichiers Compose",
         "composeFilesHelp": "Séparés par des virgules, relatifs au dépôt, dans l'ordre de surcharge.",
         "composeProfiles": "Profils Compose (facultatif)",
@@ -2058,6 +2060,15 @@
         "allowHostCommands": "Autoriser les étapes de configuration par commande hôte",
         "save": "Ajouter le stack"
       },
+      "detect": {
+        "button": "Détection automatique",
+        "hint": "Lire le dépôt et préremplir les fichiers compose, les profils et les réseaux.",
+        "detected": "Configuration de la pile détectée",
+        "detectedBody": "Prérempli à partir du dépôt. Vérifiez les champs avant d'enregistrer.",
+        "nothing": "Rien à détecter automatiquement",
+        "failed": "Échec de la détection automatique",
+        "envFiles": "Modèles d'environnement à matérialiser avant le démarrage :"
+      },
       "edit": {
         "heading": "Modifier le stack partagé",
         "save": "Enregistrer les modifications",

package/i18n/locales/he.json

@@ -2171,6 +2171,8 @@
         "cloneUrl": "כתובת שכפול של המאגר",
         "cloneUrlHelp": "מאגר ה-git שבו נמצאים קובצי ה-Compose של המקבץ.",
         "gitRef": "ענף או תג (אופציונלי)",
+        "directory": "תת-ספרייה (אופציונלי)",
+        "directoryHelp": "בשימוש רק על ידי הזיהוי האוטומטי: תת-הספרייה במונורפו שבה נמצא מקבץ ה-compose.",
         "composeFiles": "קובצי Compose",
         "composeFilesHelp": "מופרדים בפסיקים, יחסית למאגר, לפי סדר הדריסה.",
         "composeProfiles": "פרופילי Compose (אופציונלי)",
@@ -2179,6 +2181,15 @@
         "allowHostCommands": "אפשר שלבי הגדרה עם פקודות מארח",
         "save": "הוספת מקבץ"
       },
+      "detect": {
+        "button": "זיהוי אוטומטי",
+        "hint": "קריאת המאגר ומילוי מראש של קובצי ה-compose, הפרופילים והרשתות.",
+        "detected": "תצורת הסטאק זוהתה",
+        "detectedBody": "מולא מראש מהמאגר. בדקו את השדות לפני השמירה.",
+        "nothing": "אין מה לזהות אוטומטית",
+        "failed": "הזיהוי האוטומטי נכשל",
+        "envFiles": "תבניות env שיש לממש לפני ההפעלה:"
+      },
       "edit": {
         "heading": "עריכת מקבץ משותף",
         "save": "שמירת שינויים",

package/i18n/locales/it.json

@@ -530,6 +530,8 @@
         "cloneUrl": "URL di clone del repository",
         "cloneUrlHelp": "Il repository git in cui risiedono i file compose dello stack.",
         "gitRef": "Branch o tag (facoltativo)",
+        "directory": "Sottodirectory (facoltativo)",
+        "directoryHelp": "Usato solo dal rilevamento automatico: la sottodirectory del monorepo in cui si trova lo stack compose.",
         "composeFiles": "File compose",
         "composeFilesHelp": "Separati da virgola, relativi al repository, in ordine di override.",
         "composeProfiles": "Profili compose (facoltativo)",
@@ -538,6 +540,15 @@
         "allowHostCommands": "Consenti passaggi di setup con comandi host",
         "save": "Aggiungi stack"
       },
+      "detect": {
+        "button": "Rilevamento automatico",
+        "hint": "Legge il repository e precompila i file compose, i profili e le reti.",
+        "detected": "Configurazione dello stack rilevata",
+        "detectedBody": "Precompilato dal repository. Controlla i campi prima di salvare.",
+        "nothing": "Niente da rilevare automaticamente",
+        "failed": "Rilevamento automatico non riuscito",
+        "envFiles": "Modelli di ambiente da materializzare prima dell'avvio:"
+      },
       "edit": {
         "heading": "Modifica stack condiviso",
         "save": "Salva le modifiche",

package/i18n/locales/ja.json

@@ -2172,6 +2172,8 @@
         "cloneUrl": "リポジトリのクローン URL",
         "cloneUrlHelp": "スタックの Compose ファイルが置かれている git リポジトリ。",
         "gitRef": "ブランチまたはタグ（任意）",
+        "directory": "サブディレクトリ（任意）",
+        "directoryHelp": "自動検出でのみ使用されます。compose スタックが存在するモノレポのサブディレクトリです。",
         "composeFiles": "Compose ファイル",
         "composeFilesHelp": "カンマ区切り、リポジトリ相対、オーバーライド順。",
         "composeProfiles": "Compose プロファイル（任意）",
@@ -2180,6 +2182,15 @@
         "allowHostCommands": "ホストコマンドのセットアップ手順を許可する",
         "save": "スタックを追加"
       },
+      "detect": {
+        "button": "自動検出",
+        "hint": "リポジトリを読み取り、compose ファイル、プロファイル、ネットワークを事前入力します。",
+        "detected": "スタック構成を検出しました",
+        "detectedBody": "リポジトリから事前入力しました。保存する前にフィールドを確認してください。",
+        "nothing": "自動検出するものがありません",
+        "failed": "自動検出に失敗しました",
+        "envFiles": "起動前に生成される env テンプレート:"
+      },
       "edit": {
         "heading": "共有スタックを編集",
         "save": "変更を保存",

package/i18n/locales/pl.json

@@ -2050,6 +2050,8 @@
         "cloneUrl": "URL klonowania repozytorium",
         "cloneUrlHelp": "Repozytorium git, w którym znajdują się pliki Compose stosu.",
         "gitRef": "Gałąź lub tag (opcjonalnie)",
+        "directory": "Podkatalog (opcjonalnie)",
+        "directoryHelp": "Używane tylko przez automatyczne wykrywanie: podkatalog monorepo, w którym znajduje się stos compose.",
         "composeFiles": "Pliki Compose",
         "composeFilesHelp": "Rozdzielone przecinkami, względem repozytorium, w kolejności nadpisywania.",
         "composeProfiles": "Profile Compose (opcjonalnie)",
@@ -2058,6 +2060,15 @@
         "allowHostCommands": "Zezwól na kroki konfiguracji z poleceniami hosta",
         "save": "Dodaj stos"
       },
+      "detect": {
+        "button": "Wykryj automatycznie",
+        "hint": "Odczytaj repozytorium i wypełnij wstępnie pliki compose, profile i sieci.",
+        "detected": "Wykryto konfigurację stosu",
+        "detectedBody": "Wypełniono wstępnie na podstawie repozytorium. Sprawdź pola przed zapisaniem.",
+        "nothing": "Nie ma nic do automatycznego wykrycia",
+        "failed": "Automatyczne wykrywanie nie powiodło się",
+        "envFiles": "Szablony env do zmaterializowania przed uruchomieniem:"
+      },
       "edit": {
         "heading": "Edytuj współdzielony stos",
         "save": "Zapisz zmiany",

package/i18n/locales/tr.json

@@ -2172,6 +2172,8 @@
         "cloneUrl": "Depo klonlama URL'si",
         "cloneUrlHelp": "Yığının Compose dosyalarının bulunduğu git deposu.",
         "gitRef": "Dal veya etiket (isteğe bağlı)",
+        "directory": "Alt dizin (isteğe bağlı)",
+        "directoryHelp": "Yalnızca otomatik algılama tarafından kullanılır: compose yığınının bulunduğu monorepo alt dizini.",
         "composeFiles": "Compose dosyaları",
         "composeFilesHelp": "Virgülle ayrılmış, depoya göreli, geçersiz kılma sırasında.",
         "composeProfiles": "Compose profilleri (isteğe bağlı)",
@@ -2180,6 +2182,15 @@
         "allowHostCommands": "Ana makine komutu kurulum adımlarına izin ver",
         "save": "Yığın ekle"
       },
+      "detect": {
+        "button": "Otomatik algıla",
+        "hint": "Depoyu okuyup compose dosyalarını, profilleri ve ağları önceden doldurur.",
+        "detected": "Yığın yapılandırması algılandı",
+        "detectedBody": "Depodan önceden dolduruldu. Kaydetmeden önce alanları gözden geçirin.",
+        "nothing": "Otomatik algılanacak bir şey yok",
+        "failed": "Otomatik algılama başarısız oldu",
+        "envFiles": "Başlatmadan önce oluşturulacak env şablonları:"
+      },
       "edit": {
         "heading": "Paylaşılan yığını düzenle",
         "save": "Değişiklikleri kaydet",

package/i18n/locales/uk.json

@@ -2050,6 +2050,8 @@
         "cloneUrl": "URL клонування репозиторію",
         "cloneUrlHelp": "Git-репозиторій, у якому містяться файли Compose стека.",
         "gitRef": "Гілка або тег (необов'язково)",
+        "directory": "Підкаталог (необов'язково)",
+        "directoryHelp": "Використовується лише автовизначенням: підкаталог монорепозиторію, де розташований стек compose.",
         "composeFiles": "Файли Compose",
         "composeFilesHelp": "Через кому, відносно репозиторію, у порядку перевизначення.",
         "composeProfiles": "Профілі Compose (необов'язково)",
@@ -2058,6 +2060,15 @@
         "allowHostCommands": "Дозволити кроки налаштування з командами хоста",
         "save": "Додати стек"
       },
+      "detect": {
+        "button": "Автовизначення",
+        "hint": "Прочитати репозиторій і попередньо заповнити файли compose, профілі та мережі.",
+        "detected": "Виявлено конфігурацію стека",
+        "detectedBody": "Попередньо заповнено з репозиторію. Перевірте поля перед збереженням.",
+        "nothing": "Немає чого визначати автоматично",
+        "failed": "Не вдалося виконати автовизначення",
+        "envFiles": "Шаблони env, які буде матеріалізовано перед запуском:"
+      },
       "edit": {
         "heading": "Редагувати спільний стек",
         "save": "Зберегти зміни",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.101.0",
+  "version": "0.102.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.110.1"
+    "@cat-factory/contracts": "0.112.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",