@cat-factory/app 0.189.0 → 0.190.0

package/app/components/settings/SharedStacksPanel.vue

@@ -6,6 +6,7 @@
 // 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 { describeComposeSource, normalizeComposeFileRefs } from '@cat-factory/contracts'
 import type {
   SharedStack,
   SharedStackRecommendation,
@@ -76,8 +77,26 @@ function tokens(value: string): string[] {
     .filter(Boolean)
 }
 
+// A stack's compose layers may be bare in-repo paths (what this form authors and what the
+// autodetect scan returns) or explicit sources — an inline document, or a file in another repo —
+// which arrive through the API / a deployment's programmatic seeds. The form edits only the
+// former; a stack carrying any of the latter shows its layers read-only and its save omits
+// `composeFiles` entirely, so editing the name or the profiles can never silently flatten a
+// declaration this form has no editor for.
+const editingStack = computed(() => stacks.value.find((s) => s.id === editingId.value) ?? null)
+const advancedLayers = computed(() =>
+  (editingStack.value?.composeFiles ?? []).some((ref) => typeof ref !== 'string'),
+)
+const layerLabels = computed(() =>
+  normalizeComposeFileRefs(editingStack.value?.composeFiles ?? []).map(describeComposeSource),
+)
+
+// A repo-LESS stack (every layer inline / from another repo) needs no clone URL, so the form
+// requires one only while the layers it can author — in-repo paths — are what is being saved.
 const canSave = computed(
-  () => form.name.trim() && form.cloneUrl.trim() && tokens(form.composeFiles).length > 0,
+  () =>
+    form.name.trim() &&
+    (advancedLayers.value || (form.cloneUrl.trim() && tokens(form.composeFiles).length > 0)),
 )
 
 function resetForm() {
@@ -97,10 +116,12 @@ function resetForm() {
 function startEdit(stack: SharedStack) {
   editingId.value = stack.id
   form.name = stack.name
-  form.cloneUrl = stack.cloneUrl
+  form.cloneUrl = stack.cloneUrl ?? ''
   form.gitRef = stack.gitRef ?? ''
   form.directory = ''
-  form.composeFiles = stack.composeFiles.join(', ')
+  // Only bare in-repo paths are editable here; a stack with richer layers renders them read-only
+  // below and keeps them untouched through the save.
+  form.composeFiles = stack.composeFiles.filter((ref) => typeof ref === 'string').join(', ')
   form.composeProfiles = stack.composeProfiles.join(', ')
   form.managedNetworks = stack.managedNetworks.join(', ')
   form.allowHostCommands = stack.allowHostCommands
@@ -179,7 +200,17 @@ async function saveStack() {
   }
   try {
     if (editing) {
-      await store.update(editing, { ...payload, gitRef: form.gitRef.trim() || null })
+      // `composeFiles` is omitted when the stack carries layers this form can't author — the
+      // partial update preserves them, exactly as it already does for setup steps and the health
+      // gate. `cloneUrl` goes through as an explicit null when cleared, so a stack can be moved to
+      // the repo-less shape from here too.
+      const { composeFiles, ...rest } = payload
+      await store.update(editing, {
+        ...rest,
+        cloneUrl: form.cloneUrl.trim() || null,
+        gitRef: form.gitRef.trim() || null,
+        ...(advancedLayers.value ? {} : { composeFiles }),
+      })
     } else {
       await store.create(payload)
     }
@@ -402,6 +433,23 @@ async function remove(stack: SharedStack) {
       </p>
 
       <UFormField
+        v-if="advancedLayers"
+        :label="t('settings.sharedStacks.add.composeFiles')"
+        :help="t('settings.sharedStacks.add.composeLayersManagedHelp')"
+      >
+        <ul class="space-y-1" data-testid="shared-stack-compose-layers">
+          <li
+            v-for="(label, index) in layerLabels"
+            :key="index"
+            class="font-mono text-[11px] text-slate-500"
+          >
+            {{ label }}
+          </li>
+        </ul>
+      </UFormField>
+
+      <UFormField
+        v-else
         :label="t('settings.sharedStacks.add.composeFiles')"
         :help="t('settings.sharedStacks.add.composeFilesHelp')"
       >

package/app/stores/environmentWizard/save.ts

@@ -95,7 +95,13 @@ export function createSaveActions(ctx: WizardContext) {
       await board.updateBlock(id, {
         provisioning: {
           type: 'docker-compose',
-          ...(pruned.composeFiles?.[0] ? { composePath: pruned.composeFiles[0] } : {}),
+          // `composePath` is the single-file fallback the provider uses when a recipe declares no
+          // layers, so only a bare in-repo path can fill it. The wizard's layers always are ones
+          // (they come from the deterministic detector); an `inline` / other-repo layer, which the
+          // API can supply, simply leaves it unset — the recipe below already carries the layer.
+          ...(typeof pruned.composeFiles?.[0] === 'string'
+            ? { composePath: pruned.composeFiles[0] }
+            : {}),
           ...(build ? { composeBuild: true } : {}),
           recipe: pruned,
         },

package/i18n/locales/de.json

@@ -630,6 +630,7 @@
         "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.",
+        "composeLayersManagedHelp": "Über die API verwaltet — dieser Stack hat Layer, die inline bereitgestellt oder aus einem anderen Repository gelesen werden; sie werden hier schreibgeschützt angezeigt und beim Speichern nicht verändert.",
         "composeProfiles": "Compose-Profile (optional)",
         "managedNetworks": "Verwaltete Netzwerke (optional)",
         "managedNetworksHelp": "Netzwerke, die dieser Stack für Konsumenten erstellt und besitzt, um sich damit zu verbinden.",

package/i18n/locales/en.json

@@ -2923,6 +2923,7 @@
         "directoryHelp": "Used only by Autodetect: the monorepo subdirectory the compose stack lives in.",
         "composeFiles": "Compose files",
         "composeFilesHelp": "Comma-separated, repo-relative, in override order.",
+        "composeLayersManagedHelp": "Managed through the API — this stack has layers supplied inline or read from another repo, so they are shown read-only here and left untouched when you save.",
         "composeProfiles": "Compose profiles (optional)",
         "managedNetworks": "Managed networks (optional)",
         "managedNetworksHelp": "Networks this stack creates and owns for consumers to attach to.",

package/i18n/locales/es.json

@@ -2703,6 +2703,7 @@
         "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.",
+        "composeLayersManagedHelp": "Gestionado mediante la API: esta pila tiene capas suministradas en línea o leídas desde otro repositorio, por lo que aquí se muestran como solo lectura y no se modifican al guardar.",
         "composeProfiles": "Perfiles de Compose (opcional)",
         "managedNetworks": "Redes gestionadas (opcional)",
         "managedNetworksHelp": "Redes que este stack crea y posee para que los consumidores se conecten.",

package/i18n/locales/fr.json

@@ -2703,6 +2703,7 @@
         "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.",
+        "composeLayersManagedHelp": "Géré via l'API — cette pile comporte des couches fournies en ligne ou lues depuis un autre dépôt ; elles sont affichées en lecture seule ici et restent intactes à l'enregistrement.",
         "composeProfiles": "Profils Compose (facultatif)",
         "managedNetworks": "Réseaux gérés (facultatif)",
         "managedNetworksHelp": "Réseaux que ce stack crée et possède pour que les consommateurs s'y connectent.",

package/i18n/locales/he.json

@@ -2843,6 +2843,7 @@
         "directoryHelp": "בשימוש רק על ידי הזיהוי האוטומטי: תת-הספרייה במונורפו שבה נמצא מקבץ ה-compose.",
         "composeFiles": "קובצי Compose",
         "composeFilesHelp": "מופרדים בפסיקים, יחסית למאגר, לפי סדר הדריסה.",
+        "composeLayersManagedHelp": "מנוהל דרך ה-API — למחסנית הזו יש שכבות שסופקו בתוך ההגדרה או נקראות ממאגר אחר, ולכן הן מוצגות כאן לקריאה בלבד ונשארות ללא שינוי בשמירה.",
         "composeProfiles": "פרופילי Compose (אופציונלי)",
         "managedNetworks": "רשתות מנוהלות (אופציונלי)",
         "managedNetworksHelp": "רשתות שהמקבץ יוצר ומחזיק כדי שצרכנים יתחברו אליהן.",

package/i18n/locales/it.json

@@ -630,6 +630,7 @@
         "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.",
+        "composeLayersManagedHelp": "Gestito tramite API: questo stack ha livelli forniti inline o letti da un altro repository, quindi qui sono mostrati in sola lettura e restano invariati al salvataggio.",
         "composeProfiles": "Profili compose (facoltativo)",
         "managedNetworks": "Reti gestite (facoltativo)",
         "managedNetworksHelp": "Reti che questo stack crea e possiede affinche i consumatori vi si colleghino.",

package/i18n/locales/ja.json

@@ -2844,6 +2844,7 @@
         "directoryHelp": "自動検出でのみ使用されます。compose スタックが存在するモノレポのサブディレクトリです。",
         "composeFiles": "Compose ファイル",
         "composeFilesHelp": "カンマ区切り、リポジトリ相対、オーバーライド順。",
+        "composeLayersManagedHelp": "API で管理されています。このスタックにはインラインで指定された層、または別のリポジトリから読み込まれる層があるため、ここでは読み取り専用で表示され、保存時にも変更されません。",
         "composeProfiles": "Compose プロファイル（任意）",
         "managedNetworks": "マネージドネットワーク（任意）",
         "managedNetworksHelp": "コンシューマーが接続するために、このスタックが作成・所有するネットワーク。",

package/i18n/locales/pl.json

@@ -2703,6 +2703,7 @@
         "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.",
+        "composeLayersManagedHelp": "Zarządzane przez API — ten stos ma warstwy podane bezpośrednio lub odczytywane z innego repozytorium, więc są tu tylko do odczytu i pozostają nietknięte przy zapisie.",
         "composeProfiles": "Profile Compose (opcjonalnie)",
         "managedNetworks": "Zarządzane sieci (opcjonalnie)",
         "managedNetworksHelp": "Sieci, które ten stos tworzy i posiada, aby konsumenci mogli się z nimi łączyć.",

package/i18n/locales/tr.json

@@ -2844,6 +2844,7 @@
         "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.",
+        "composeLayersManagedHelp": "API üzerinden yönetilir — bu yığında satır içi verilen veya başka bir depodan okunan katmanlar var; burada salt okunur gösterilir ve kaydettiğinizde değiştirilmez.",
         "composeProfiles": "Compose profilleri (isteğe bağlı)",
         "managedNetworks": "Yönetilen ağlar (isteğe bağlı)",
         "managedNetworksHelp": "Tüketicilerin bağlanması için bu yığının oluşturup sahip olduğu ağlar.",

package/i18n/locales/uk.json

@@ -2703,6 +2703,7 @@
         "directoryHelp": "Використовується лише автовизначенням: підкаталог монорепозиторію, де розташований стек compose.",
         "composeFiles": "Файли Compose",
         "composeFilesHelp": "Через кому, відносно репозиторію, у порядку перевизначення.",
+        "composeLayersManagedHelp": "Керується через API — цей стек має шари, задані безпосередньо або зчитані з іншого репозиторію, тож тут вони показані лише для читання й не змінюються під час збереження.",
         "composeProfiles": "Профілі Compose (необов'язково)",
         "managedNetworks": "Керовані мережі (необов'язково)",
         "managedNetworksHelp": "Мережі, які цей стек створює й якими володіє, щоб споживачі під'єднувалися до них.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.189.0",
+  "version": "0.190.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",
@@ -40,7 +40,7 @@
     "valibot": "^1.4.2",
     "vue": "3.5.40",
     "wretch": "^3.0.9",
-    "@cat-factory/contracts": "0.196.0"
+    "@cat-factory/contracts": "0.197.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",