@cat-factory/app 0.93.0 → 0.94.0

package/app/components/settings/InfrastructureWindow.vue

@@ -14,6 +14,10 @@ import type { ProviderConnectionKind } from '~/types/providerConnections'
 import InfrastructureBackendPicker from '~/components/settings/InfrastructureBackendPicker.vue'
 import InfraHandlersConfigurator from '~/components/settings/InfraHandlersConfigurator.vue'
 import LocalContainerPoolSettings from '~/components/settings/LocalContainerPoolSettings.vue'
+import SharedStacksPanel from '~/components/settings/SharedStacksPanel.vue'
+
+// The shared-stacks tab uses its own slot key beyond the provider-connection kinds.
+type InfraTabValue = ProviderConnectionKind | 'shared-stacks'
 
 const { t } = useI18n()
 const ui = useUiStore()
@@ -37,7 +41,7 @@ const agentsAvailable = computed(() => (auth.infrastructure?.execution.available
 const envsAvailable = computed(() => (auth.infrastructure?.testEnv.available.length ?? 0) > 0)
 
 const tabs = computed(() => {
-  const out: { value: ProviderConnectionKind; label: string; icon: string; slot: string }[] = []
+  const out: { value: InfraTabValue; label: string; icon: string; slot: string }[] = []
   if (agentsAvailable.value)
     out.push({
       value: 'runner-pool',
@@ -52,10 +56,19 @@ const tabs = computed(() => {
       icon: 'i-lucide-cloud',
       slot: 'environment',
     })
+  // Shared stacks are long-lived compose infra a Tester environment attaches to, so they live
+  // alongside the test-environment config (shown wherever an environment backend is available).
+  if (envsAvailable.value)
+    out.push({
+      value: 'shared-stacks',
+      label: t('settings.sharedStacks.tab'),
+      icon: 'i-lucide-layers',
+      slot: 'shared-stacks',
+    })
   return out
 })
 
-const activeTab = ref<ProviderConnectionKind>(ui.infrastructureTab)
+const activeTab = ref<InfraTabValue>(ui.infrastructureTab)
 
 // Honour the deep-linked tab each time the window opens, falling back to the first available
 // tab if the requested one is off.
@@ -124,6 +137,9 @@ watch([tabs, () => store.loaded], () => {
               <InfraHandlersConfigurator />
             </div>
           </template>
+          <template #shared-stacks>
+            <SharedStacksPanel />
+          </template>
         </UTabs>
 
         <p v-else class="px-1 py-6 text-center text-sm text-slate-500">

package/app/components/settings/SharedStacksPanel.vue

@@ -0,0 +1,363 @@
+<script setup lang="ts">
+// Shared stacks — long-lived compose infra (e.g. acme-shared-services: MySQL / Postgres /
+// Valkey / RabbitMQ / Kafka / ES / Mailpit / Envoy) brought up ONCE per workspace and reused
+// across runs + PRs. A per-PR consumer environment attaches to a stack's managed network. CRUD
+// works on every backend; the bring-up (Start) / teardown (Stop) drive a host Docker daemon, so
+// 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'
+
+const { t } = useI18n()
+const store = useSharedStacksStore()
+const toast = useToast()
+const { confirmAction, toastDone } = useConfirmAction()
+
+const stacks = computed(() => store.stacks)
+const busyId = ref<string | null>(null)
+const saving = 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)
+
+const form = reactive({
+  name: '',
+  cloneUrl: '',
+  gitRef: '',
+  composeFiles: '',
+  composeProfiles: '',
+  managedNetworks: '',
+  allowHostCommands: false,
+})
+
+/** Status → badge colour. */
+const STATUS_COLOR: Record<SharedStackStatus, 'neutral' | 'warning' | 'success' | 'error'> = {
+  stopped: 'neutral',
+  starting: 'warning',
+  running: 'success',
+  failed: 'error',
+}
+
+// Status → catalog key as an EXHAUSTIVE Record over the enum (not a runtime-assembled key), so a
+// new SharedStackStatus fails the typecheck on this map instead of leaking a raw key into the badge.
+const STATUS_LABEL_KEYS: Record<SharedStackStatus, string> = {
+  stopped: 'settings.sharedStacks.status.stopped',
+  starting: 'settings.sharedStacks.status.starting',
+  running: 'settings.sharedStacks.status.running',
+  failed: 'settings.sharedStacks.status.failed',
+}
+
+function statusLabel(status: SharedStackStatus): string {
+  return t(STATUS_LABEL_KEYS[status])
+}
+
+/** A running/starting stack cannot be reconfigured (the backend refuses) — edit is stopped/failed only. */
+function canEdit(stack: SharedStack): boolean {
+  return stack.status !== 'running' && stack.status !== 'starting'
+}
+
+/** Split a comma/whitespace-separated field into trimmed non-empty tokens. */
+function tokens(value: string): string[] {
+  return value
+    .split(/[\s,]+/)
+    .map((s) => s.trim())
+    .filter(Boolean)
+}
+
+const canSave = computed(
+  () => form.name.trim() && form.cloneUrl.trim() && tokens(form.composeFiles).length > 0,
+)
+
+function resetForm() {
+  editingId.value = null
+  form.name = ''
+  form.cloneUrl = ''
+  form.gitRef = ''
+  form.composeFiles = ''
+  form.composeProfiles = ''
+  form.managedNetworks = ''
+  form.allowHostCommands = false
+}
+
+/** Load a stack's definition into the form for in-place editing. */
+function startEdit(stack: SharedStack) {
+  editingId.value = stack.id
+  form.name = stack.name
+  form.cloneUrl = stack.cloneUrl
+  form.gitRef = stack.gitRef ?? ''
+  form.composeFiles = stack.composeFiles.join(', ')
+  form.composeProfiles = stack.composeProfiles.join(', ')
+  form.managedNetworks = stack.managedNetworks.join(', ')
+  form.allowHostCommands = stack.allowHostCommands
+}
+
+function notifyError(title: string, e: unknown) {
+  toast.add({
+    title,
+    description: e instanceof Error ? e.message : String(e),
+    icon: 'i-lucide-triangle-alert',
+    color: 'error',
+  })
+}
+
+/** Create a new stack, or save edits to the one being edited (same form, mode toggled by `editingId`). */
+async function saveStack() {
+  saving.value = true
+  const editing = editingId.value
+  const payload = {
+    name: form.name.trim(),
+    cloneUrl: form.cloneUrl.trim(),
+    ...(form.gitRef.trim() ? { gitRef: form.gitRef.trim() } : {}),
+    composeFiles: tokens(form.composeFiles),
+    composeProfiles: tokens(form.composeProfiles),
+    managedNetworks: tokens(form.managedNetworks),
+    allowHostCommands: form.allowHostCommands,
+  }
+  try {
+    if (editing) {
+      await store.update(editing, { ...payload, gitRef: form.gitRef.trim() || null })
+    } else {
+      await store.create(payload)
+    }
+    resetForm()
+    toast.add({
+      title: t(
+        editing ? 'settings.sharedStacks.toast.updated' : 'settings.sharedStacks.toast.created',
+      ),
+      icon: 'i-lucide-check',
+      color: 'success',
+    })
+  } catch (e) {
+    notifyError(
+      t(
+        editing
+          ? 'settings.sharedStacks.toast.updateFailed'
+          : 'settings.sharedStacks.toast.createFailed',
+      ),
+      e,
+    )
+  } finally {
+    saving.value = false
+  }
+}
+
+async function start(stack: SharedStack) {
+  busyId.value = stack.id
+  try {
+    // ensureUp resolves 200 even on a FAILED bring-up (the record carries status/lastError), so
+    // surface that as an error toast too — not only a thrown transport/unavailable error.
+    const updated = await store.ensureUp(stack.id)
+    if (updated.status === 'failed') {
+      notifyError(t('settings.sharedStacks.toast.startFailed'), updated.lastError ?? '')
+    }
+  } catch (e) {
+    notifyError(t('settings.sharedStacks.toast.startFailed'), e)
+  } finally {
+    busyId.value = null
+  }
+}
+
+async function stop(stack: SharedStack) {
+  busyId.value = stack.id
+  try {
+    await store.teardown(stack.id)
+  } catch (e) {
+    notifyError(t('settings.sharedStacks.toast.stopFailed'), e)
+  } finally {
+    busyId.value = null
+  }
+}
+
+async function remove(stack: SharedStack) {
+  const noun = t('settings.sharedStacks.stackNoun')
+  if (!(await confirmAction('remove', noun))) return
+  busyId.value = stack.id
+  try {
+    await store.remove(stack.id)
+    toastDone('remove', noun)
+  } catch (e) {
+    notifyError(t('settings.sharedStacks.toast.removeFailed'), e)
+  } finally {
+    busyId.value = null
+  }
+}
+</script>
+
+<template>
+  <div class="space-y-4" data-testid="shared-stacks-panel">
+    <p class="text-sm text-slate-400">{{ t('settings.sharedStacks.intro') }}</p>
+
+    <section v-if="stacks.length" class="space-y-2 rounded-lg border border-slate-700 p-3">
+      <h3 class="text-sm font-semibold">{{ t('settings.sharedStacks.list.heading') }}</h3>
+      <div
+        v-for="stack in stacks"
+        :key="stack.id"
+        class="space-y-2 rounded-md border border-slate-800 px-3 py-2"
+        :data-testid="`shared-stack-${stack.id}`"
+      >
+        <div class="flex items-center justify-between gap-2">
+          <div class="min-w-0 space-y-1">
+            <div class="flex items-center gap-2">
+              <span class="text-sm font-medium">{{ stack.name }}</span>
+              <UBadge :color="STATUS_COLOR[stack.status]" variant="soft" size="sm">
+                {{ statusLabel(stack.status) }}
+              </UBadge>
+            </div>
+            <p class="truncate text-[11px] text-slate-500">{{ stack.cloneUrl }}</p>
+            <div v-if="stack.managedNetworks.length" class="flex flex-wrap gap-1">
+              <UBadge
+                v-for="net in stack.managedNetworks"
+                :key="net"
+                color="neutral"
+                variant="soft"
+                size="sm"
+              >
+                {{ net }}
+              </UBadge>
+            </div>
+          </div>
+          <div class="flex shrink-0 items-center gap-1">
+            <UButton
+              v-if="stack.status !== 'running'"
+              icon="i-lucide-play"
+              size="sm"
+              variant="soft"
+              :loading="busyId === stack.id"
+              :data-testid="`shared-stack-start-${stack.id}`"
+              @click="start(stack)"
+            >
+              {{ t('settings.sharedStacks.list.start') }}
+            </UButton>
+            <UButton
+              v-else
+              icon="i-lucide-square"
+              size="sm"
+              variant="soft"
+              color="warning"
+              :loading="busyId === stack.id"
+              :data-testid="`shared-stack-stop-${stack.id}`"
+              @click="stop(stack)"
+            >
+              {{ t('settings.sharedStacks.list.stop') }}
+            </UButton>
+            <UButton
+              v-if="canEdit(stack)"
+              color="neutral"
+              variant="ghost"
+              icon="i-lucide-pencil"
+              size="sm"
+              :data-testid="`shared-stack-edit-${stack.id}`"
+              :aria-label="t('settings.sharedStacks.list.edit')"
+              @click="startEdit(stack)"
+            />
+            <UButton
+              color="error"
+              variant="ghost"
+              icon="i-lucide-trash-2"
+              size="sm"
+              :loading="busyId === stack.id"
+              :data-testid="`shared-stack-delete-${stack.id}`"
+              :aria-label="t('settings.sharedStacks.list.remove')"
+              @click="remove(stack)"
+            />
+          </div>
+        </div>
+        <p v-if="stack.lastError" class="text-[11px] text-rose-400">{{ stack.lastError }}</p>
+      </div>
+    </section>
+
+    <section
+      class="space-y-3 rounded-lg border border-slate-700 p-3"
+      data-testid="shared-stack-form"
+    >
+      <h3 class="text-sm font-semibold">
+        {{
+          t(editingId ? 'settings.sharedStacks.edit.heading' : 'settings.sharedStacks.add.heading')
+        }}
+      </h3>
+
+      <UFormField :label="t('settings.sharedStacks.add.name')">
+        <UInput v-model="form.name" class="w-full" data-testid="shared-stack-name" />
+      </UFormField>
+
+      <UFormField
+        :label="t('settings.sharedStacks.add.cloneUrl')"
+        :help="t('settings.sharedStacks.add.cloneUrlHelp')"
+      >
+        <UInput
+          v-model="form.cloneUrl"
+          placeholder="https://github.com/acme/acme-shared-services.git"
+          class="w-full"
+          data-testid="shared-stack-clone-url"
+        />
+      </UFormField>
+
+      <UFormField :label="t('settings.sharedStacks.add.gitRef')">
+        <UInput
+          v-model="form.gitRef"
+          placeholder="main"
+          class="w-full"
+          data-testid="shared-stack-git-ref"
+        />
+      </UFormField>
+
+      <UFormField
+        :label="t('settings.sharedStacks.add.composeFiles')"
+        :help="t('settings.sharedStacks.add.composeFilesHelp')"
+      >
+        <UInput
+          v-model="form.composeFiles"
+          placeholder="docker-compose.yml, docker-compose.override.yml"
+          class="w-full"
+          data-testid="shared-stack-compose-files"
+        />
+      </UFormField>
+
+      <UFormField :label="t('settings.sharedStacks.add.composeProfiles')">
+        <UInput
+          v-model="form.composeProfiles"
+          placeholder="backends, peer"
+          class="w-full"
+          data-testid="shared-stack-profiles"
+        />
+      </UFormField>
+
+      <UFormField
+        :label="t('settings.sharedStacks.add.managedNetworks')"
+        :help="t('settings.sharedStacks.add.managedNetworksHelp')"
+      >
+        <UInput
+          v-model="form.managedNetworks"
+          placeholder="acme-net"
+          class="w-full"
+          data-testid="shared-stack-networks"
+        />
+      </UFormField>
+
+      <UCheckbox
+        v-model="form.allowHostCommands"
+        :label="t('settings.sharedStacks.add.allowHostCommands')"
+        data-testid="shared-stack-allow-host-commands"
+      />
+
+      <div class="flex items-center gap-2">
+        <UButton
+          :loading="saving"
+          :disabled="!canSave"
+          data-testid="shared-stack-save"
+          @click="saveStack"
+        >
+          {{ t(editingId ? 'settings.sharedStacks.edit.save' : 'settings.sharedStacks.add.save') }}
+        </UButton>
+        <UButton
+          v-if="editingId"
+          color="neutral"
+          variant="ghost"
+          data-testid="shared-stack-cancel-edit"
+          @click="resetForm"
+        >
+          {{ t('settings.sharedStacks.edit.cancel') }}
+        </UButton>
+      </div>
+    </section>
+  </div>
+</template>

package/app/composables/api/sharedStacks.ts

@@ -0,0 +1,42 @@
+import {
+  createSharedStackContract,
+  deleteSharedStackContract,
+  ensureSharedStackUpContract,
+  listSharedStacksContract,
+  teardownSharedStackContract,
+  updateSharedStackContract,
+} from '@cat-factory/contracts'
+import type { UpdateSharedStackInput } from '~/types/sharedStacks'
+import type { SendParams } from './client'
+import type { ApiContext } from './context'
+
+// The create body is typed from the contract's INPUT shape so the valibot-defaulted array fields
+// (profiles, envFiles, managedNetworks, setupSteps, allowHostCommands) stay optional for callers.
+type CreateSharedStackBody = NonNullable<SendParams<typeof createSharedStackContract>['body']>
+
+/** A workspace's shared stacks: CRUD plus the ensure-up / teardown lifecycle actions. */
+export function sharedStacksApi({ send, ws }: ApiContext) {
+  return {
+    listSharedStacks: (workspaceId: string) =>
+      send(listSharedStacksContract, { pathPrefix: ws(workspaceId) }),
+
+    createSharedStack: (workspaceId: string, body: CreateSharedStackBody) =>
+      send(createSharedStackContract, { pathPrefix: ws(workspaceId), body }),
+
+    updateSharedStack: (workspaceId: string, stackId: string, body: UpdateSharedStackInput) =>
+      send(updateSharedStackContract, {
+        pathPrefix: ws(workspaceId),
+        pathParams: { stackId },
+        body,
+      }),
+
+    deleteSharedStack: (workspaceId: string, stackId: string) =>
+      send(deleteSharedStackContract, { pathPrefix: ws(workspaceId), pathParams: { stackId } }),
+
+    ensureSharedStackUp: (workspaceId: string, stackId: string) =>
+      send(ensureSharedStackUpContract, { pathPrefix: ws(workspaceId), pathParams: { stackId } }),
+
+    teardownSharedStack: (workspaceId: string, stackId: string) =>
+      send(teardownSharedStackContract, { pathPrefix: ws(workspaceId), pathParams: { stackId } }),
+  }
+}

package/app/composables/useApi.ts

@@ -22,6 +22,7 @@ import { modelsApi } from './api/models'
 import { notificationsApi } from './api/notifications'
 import { packageRegistriesApi } from './api/packageRegistries'
 import { presetsApi } from './api/presets'
+import { sharedStacksApi } from './api/sharedStacks'
 import { providerConnectionsApi } from './api/providerConnections'
 import { provisioningLogsApi } from './api/provisioningLogs'
 import { recurringApi } from './api/recurring'
@@ -112,6 +113,7 @@ export function useApi() {
     ...specApi(ctx),
     ...notificationsApi(ctx),
     ...presetsApi(ctx),
+    ...sharedStacksApi(ctx),
     ...providerConnectionsApi(ctx),
     ...infraHandlersApi(ctx),
     ...initiativeApi(ctx),

package/app/stores/sharedStacks.ts

@@ -0,0 +1,65 @@
+import { defineStore } from 'pinia'
+import { ref } from 'vue'
+import type { SharedStack, UpdateSharedStackInput } from '~/types/sharedStacks'
+import { useWorkspaceStore } from '~/stores/workspace'
+
+/**
+ * The workspace's shared stacks — long-lived compose infra (e.g. acme-shared-services) that
+ * per-PR consumer environments attach to over an external network. Hydrated from the workspace
+ * snapshot; managed via the Infrastructure window's "Shared stacks" panel. CRUD works on every
+ * backend, but the bring-up (`ensureUp`) / teardown drive a host Docker daemon, so they succeed
+ * only on the local facade (elsewhere the backend returns a clear error the panel surfaces).
+ *
+ * Mutations refresh the workspace snapshot (the stack list rides it), while the async lifecycle
+ * actions patch the returned record in place so the panel shows the new status immediately.
+ */
+export const useSharedStacksStore = defineStore('sharedStacks', () => {
+  const api = useApi()
+  const stacks = ref<SharedStack[]>([])
+
+  function hydrate(list: SharedStack[]) {
+    stacks.value = [...list].sort((a, b) => a.createdAt - b.createdAt)
+  }
+
+  function patch(stack: SharedStack) {
+    const idx = stacks.value.findIndex((s) => s.id === stack.id)
+    if (idx >= 0) stacks.value[idx] = stack
+    else stacks.value.push(stack)
+  }
+
+  async function create(input: Parameters<typeof api.createSharedStack>[1]) {
+    const ws = useWorkspaceStore()
+    const created = await api.createSharedStack(ws.requireId(), input)
+    await ws.refresh()
+    return created
+  }
+
+  async function update(stackId: string, patchInput: UpdateSharedStackInput) {
+    const ws = useWorkspaceStore()
+    const updated = await api.updateSharedStack(ws.requireId(), stackId, patchInput)
+    await ws.refresh()
+    return updated
+  }
+
+  async function remove(stackId: string) {
+    const ws = useWorkspaceStore()
+    await api.deleteSharedStack(ws.requireId(), stackId)
+    await ws.refresh()
+  }
+
+  async function ensureUp(stackId: string) {
+    const ws = useWorkspaceStore()
+    const updated = await api.ensureSharedStackUp(ws.requireId(), stackId)
+    patch(updated)
+    return updated
+  }
+
+  async function teardown(stackId: string) {
+    const ws = useWorkspaceStore()
+    const updated = await api.teardownSharedStack(ws.requireId(), stackId)
+    patch(updated)
+    return updated
+  }
+
+  return { stacks, hydrate, create, update, remove, ensureUp, teardown }
+})

package/app/stores/workspace.ts

@@ -8,6 +8,7 @@ import { useExecutionStore } from '~/stores/execution'
 import { useAgentRunsStore } from '~/stores/agentRuns'
 import { useNotificationsStore } from '~/stores/notifications'
 import { useMergePresetsStore } from '~/stores/mergePresets'
+import { useSharedStacksStore } from '~/stores/sharedStacks'
 import { useWorkspaceSettingsStore } from '~/stores/workspaceSettings'
 import { useAgentConfigStore } from '~/stores/agentConfig'
 import { useModelPresetsStore } from '~/stores/modelPresets'
@@ -107,6 +108,7 @@ export const useWorkspaceStore = defineStore(
         snapshot.mergePresets ?? [],
         snapshot.mergePresetCatalogVersions,
       )
+      useSharedStacksStore().hydrate(snapshot.sharedStacks ?? [])
       useWorkspaceSettingsStore().hydrate(snapshot.settings)
       useAgentConfigStore().hydrate(snapshot.agentConfigCatalog ?? [])
       useModelPresetsStore().hydrate(snapshot.modelPresets ?? [])

package/app/types/sharedStacks.ts

@@ -0,0 +1,8 @@
+// Wire types for shared stacks — long-lived compose infra a consumer environment attaches to
+// over an external network. Re-exported from the single source of truth (`@cat-factory/contracts`).
+export type {
+  SharedStack,
+  SharedStackStatus,
+  CreateSharedStackInput,
+  UpdateSharedStackInput,
+} from '@cat-factory/contracts'

package/i18n/locales/en.json

@@ -2155,6 +2155,52 @@
         "removeFailed": "Could not remove the registry entry"
       }
     },
+    "sharedStacks": {
+      "tab": "Shared stacks",
+      "intro": "Long-lived compose infrastructure (databases, brokers, search, mail) brought up once per workspace and reused across runs and pull requests. A test environment attaches to a stack's managed network. Bringing a stack up runs on a local Docker deployment; on other backends you can still manage the definition.",
+      "stackNoun": "shared stack",
+      "status": {
+        "stopped": "Stopped",
+        "starting": "Starting",
+        "running": "Running",
+        "failed": "Failed"
+      },
+      "list": {
+        "heading": "Configured stacks",
+        "start": "Start",
+        "stop": "Stop",
+        "edit": "Edit",
+        "remove": "Delete stack"
+      },
+      "add": {
+        "heading": "Add a shared stack",
+        "name": "Name",
+        "cloneUrl": "Repository clone URL",
+        "cloneUrlHelp": "The git repository the stack's compose files live in.",
+        "gitRef": "Branch or tag (optional)",
+        "composeFiles": "Compose files",
+        "composeFilesHelp": "Comma-separated, repo-relative, in override order.",
+        "composeProfiles": "Compose profiles (optional)",
+        "managedNetworks": "Managed networks (optional)",
+        "managedNetworksHelp": "Networks this stack creates and owns for consumers to attach to.",
+        "allowHostCommands": "Allow host-command setup steps",
+        "save": "Add stack"
+      },
+      "edit": {
+        "heading": "Edit shared stack",
+        "save": "Save changes",
+        "cancel": "Cancel"
+      },
+      "toast": {
+        "created": "Shared stack added",
+        "createFailed": "Could not add the shared stack",
+        "updated": "Shared stack updated",
+        "updateFailed": "Could not update the shared stack",
+        "startFailed": "Could not start the shared stack",
+        "stopFailed": "Could not stop the shared stack",
+        "removeFailed": "Could not delete the shared stack"
+      }
+    },
     "localMode": {
       "title": "Local mode",
       "intro": "Tuning for the local container runner, stored on this machine's deployment (it replaced the {poolVars} / {harnessVars} env vars). Saving resizes the warm pool live, no restart needed; in-flight runs keep the container they already hold.",

package/i18n/locales/es.json

@@ -1984,6 +1984,52 @@
         "removeFailed": "No se pudo eliminar la entrada del registro"
       }
     },
+    "sharedStacks": {
+      "tab": "Stacks compartidos",
+      "intro": "Infraestructura de Compose de larga duración (bases de datos, brokers, búsqueda, correo) que se levanta una vez por espacio de trabajo y se reutiliza en todas las ejecuciones y pull requests. Un entorno de pruebas se conecta a la red gestionada de un stack. Levantar un stack requiere un despliegue local de Docker; en otros backends puedes gestionar igualmente la definición.",
+      "stackNoun": "stack compartido",
+      "status": {
+        "stopped": "Detenido",
+        "starting": "Iniciando",
+        "running": "En ejecución",
+        "failed": "Con errores"
+      },
+      "list": {
+        "heading": "Stacks configurados",
+        "start": "Iniciar",
+        "stop": "Detener",
+        "edit": "Editar",
+        "remove": "Eliminar stack"
+      },
+      "add": {
+        "heading": "Añadir un stack compartido",
+        "name": "Nombre",
+        "cloneUrl": "URL de clonación del repositorio",
+        "cloneUrlHelp": "El repositorio git donde viven los archivos de Compose del stack.",
+        "gitRef": "Rama o etiqueta (opcional)",
+        "composeFiles": "Archivos de Compose",
+        "composeFilesHelp": "Separados por comas, relativos al repositorio, en orden de anulación.",
+        "composeProfiles": "Perfiles de Compose (opcional)",
+        "managedNetworks": "Redes gestionadas (opcional)",
+        "managedNetworksHelp": "Redes que este stack crea y posee para que los consumidores se conecten.",
+        "allowHostCommands": "Permitir pasos de configuración con comandos del host",
+        "save": "Añadir stack"
+      },
+      "edit": {
+        "heading": "Editar stack compartido",
+        "save": "Guardar cambios",
+        "cancel": "Cancelar"
+      },
+      "toast": {
+        "created": "Stack compartido añadido",
+        "createFailed": "No se pudo añadir el stack compartido",
+        "updated": "Stack compartido actualizado",
+        "updateFailed": "No se pudo actualizar el stack compartido",
+        "startFailed": "No se pudo iniciar el stack compartido",
+        "stopFailed": "No se pudo detener el stack compartido",
+        "removeFailed": "No se pudo eliminar el stack compartido"
+      }
+    },
     "localMode": {
       "title": "Modo local",
       "intro": "Ajustes del ejecutor de contenedores local, almacenados en el despliegue de esta máquina (reemplazó las variables de entorno {poolVars} / {harnessVars}). Guardar redimensiona el grupo en caliente en vivo, sin necesidad de reiniciar; las ejecuciones en curso conservan el contenedor que ya tienen.",

package/i18n/locales/fr.json

@@ -1984,6 +1984,52 @@
         "removeFailed": "Impossible de supprimer l'entrée du registre"
       }
     },
+    "sharedStacks": {
+      "tab": "Stacks partagés",
+      "intro": "Infrastructure Compose de longue durée (bases de données, brokers, recherche, e-mail) démarrée une fois par espace de travail et réutilisée pour toutes les exécutions et pull requests. Un environnement de test se connecte au réseau géré d'un stack. Démarrer un stack nécessite un déploiement Docker local ; sur les autres backends, vous pouvez tout de même gérer la définition.",
+      "stackNoun": "stack partagé",
+      "status": {
+        "stopped": "Arrêté",
+        "starting": "Démarrage",
+        "running": "En cours d'exécution",
+        "failed": "Échec"
+      },
+      "list": {
+        "heading": "Stacks configurés",
+        "start": "Démarrer",
+        "stop": "Arrêter",
+        "edit": "Modifier",
+        "remove": "Supprimer le stack"
+      },
+      "add": {
+        "heading": "Ajouter un stack partagé",
+        "name": "Nom",
+        "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)",
+        "composeFiles": "Fichiers Compose",
+        "composeFilesHelp": "Séparés par des virgules, relatifs au dépôt, dans l'ordre de surcharge.",
+        "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.",
+        "allowHostCommands": "Autoriser les étapes de configuration par commande hôte",
+        "save": "Ajouter le stack"
+      },
+      "edit": {
+        "heading": "Modifier le stack partagé",
+        "save": "Enregistrer les modifications",
+        "cancel": "Annuler"
+      },
+      "toast": {
+        "created": "Stack partagé ajouté",
+        "createFailed": "Impossible d'ajouter le stack partagé",
+        "updated": "Stack partagé mis à jour",
+        "updateFailed": "Impossible de mettre à jour le stack partagé",
+        "startFailed": "Impossible de démarrer le stack partagé",
+        "stopFailed": "Impossible d'arrêter le stack partagé",
+        "removeFailed": "Impossible de supprimer le stack partagé"
+      }
+    },
     "localMode": {
       "title": "Mode local",
       "intro": "Réglage de l'exécuteur de conteneurs local, stocké sur le déploiement de cette machine (il a remplacé les variables d'environnement {poolVars} / {harnessVars}). L'enregistrement redimensionne le pool à chaud en direct, sans redémarrage nécessaire; les exécutions en cours conservent le conteneur qu'elles détiennent déjà.",

package/i18n/locales/he.json

@@ -2105,6 +2105,52 @@
         "removeFailed": "הסרת רשומת המאגר נכשלה"
       }
     },
+    "sharedStacks": {
+      "tab": "מקבצים משותפים",
+      "intro": "תשתית Compose ארוכת-טווח (מסדי נתונים, ברוקרים, חיפוש, דואר) שמופעלת פעם אחת לכל סביבת עבודה ומשמשת מחדש בכל ההרצות ובקשות המשיכה. סביבת בדיקה מתחברת לרשת המנוהלת של מקבץ. הפעלת מקבץ מחייבת פריסת Docker מקומית; ב-backends אחרים עדיין ניתן לנהל את ההגדרה.",
+      "stackNoun": "מקבץ משותף",
+      "status": {
+        "stopped": "הופסק",
+        "starting": "מופעל",
+        "running": "פועל",
+        "failed": "נכשל"
+      },
+      "list": {
+        "heading": "מקבצים מוגדרים",
+        "start": "הפעלה",
+        "stop": "עצירה",
+        "edit": "עריכה",
+        "remove": "מחיקת מקבץ"
+      },
+      "add": {
+        "heading": "הוספת מקבץ משותף",
+        "name": "שם",
+        "cloneUrl": "כתובת שכפול של המאגר",
+        "cloneUrlHelp": "מאגר ה-git שבו נמצאים קובצי ה-Compose של המקבץ.",
+        "gitRef": "ענף או תג (אופציונלי)",
+        "composeFiles": "קובצי Compose",
+        "composeFilesHelp": "מופרדים בפסיקים, יחסית למאגר, לפי סדר הדריסה.",
+        "composeProfiles": "פרופילי Compose (אופציונלי)",
+        "managedNetworks": "רשתות מנוהלות (אופציונלי)",
+        "managedNetworksHelp": "רשתות שהמקבץ יוצר ומחזיק כדי שצרכנים יתחברו אליהן.",
+        "allowHostCommands": "אפשר שלבי הגדרה עם פקודות מארח",
+        "save": "הוספת מקבץ"
+      },
+      "edit": {
+        "heading": "עריכת מקבץ משותף",
+        "save": "שמירת שינויים",
+        "cancel": "ביטול"
+      },
+      "toast": {
+        "created": "המקבץ המשותף נוסף",
+        "createFailed": "לא ניתן להוסיף את המקבץ המשותף",
+        "updated": "המקבץ המשותף עודכן",
+        "updateFailed": "לא ניתן לעדכן את המקבץ המשותף",
+        "startFailed": "לא ניתן להפעיל את המקבץ המשותף",
+        "stopFailed": "לא ניתן לעצור את המקבץ המשותף",
+        "removeFailed": "לא ניתן למחוק את המקבץ המשותף"
+      }
+    },
     "localMode": {
       "title": "מצב מקומי",
       "intro": "כוונון עבור מריץ הקונטיינרים המקומי, נשמר בפריסה של מכונה זו (הוא החליף את משתני הסביבה {poolVars} / {harnessVars}). שמירה משנה את גודל המאגר החם בזמן אמת, ללא צורך באתחול מחדש; הרצות פעילות שומרות את הקונטיינר שהן כבר מחזיקות.",

package/i18n/locales/ja.json

@@ -2106,6 +2106,52 @@
         "removeFailed": "レジストリエントリを削除できませんでした"
       }
     },
+    "sharedStacks": {
+      "tab": "共有スタック",
+      "intro": "ワークスペースごとに一度だけ起動され、すべての実行とプルリクエストで再利用される長期稼働の Compose インフラ（データベース、ブローカー、検索、メール）です。テスト環境はスタックのマネージドネットワークに接続します。スタックの起動にはローカルの Docker デプロイが必要です。他のバックエンドでも定義の管理は可能です。",
+      "stackNoun": "共有スタック",
+      "status": {
+        "stopped": "停止",
+        "starting": "起動中",
+        "running": "実行中",
+        "failed": "失敗"
+      },
+      "list": {
+        "heading": "構成済みのスタック",
+        "start": "開始",
+        "stop": "停止",
+        "edit": "編集",
+        "remove": "スタックを削除"
+      },
+      "add": {
+        "heading": "共有スタックを追加",
+        "name": "名前",
+        "cloneUrl": "リポジトリのクローン URL",
+        "cloneUrlHelp": "スタックの Compose ファイルが置かれている git リポジトリ。",
+        "gitRef": "ブランチまたはタグ（任意）",
+        "composeFiles": "Compose ファイル",
+        "composeFilesHelp": "カンマ区切り、リポジトリ相対、オーバーライド順。",
+        "composeProfiles": "Compose プロファイル（任意）",
+        "managedNetworks": "マネージドネットワーク（任意）",
+        "managedNetworksHelp": "コンシューマーが接続するために、このスタックが作成・所有するネットワーク。",
+        "allowHostCommands": "ホストコマンドのセットアップ手順を許可する",
+        "save": "スタックを追加"
+      },
+      "edit": {
+        "heading": "共有スタックを編集",
+        "save": "変更を保存",
+        "cancel": "キャンセル"
+      },
+      "toast": {
+        "created": "共有スタックを追加しました",
+        "createFailed": "共有スタックを追加できませんでした",
+        "updated": "共有スタックを更新しました",
+        "updateFailed": "共有スタックを更新できませんでした",
+        "startFailed": "共有スタックを開始できませんでした",
+        "stopFailed": "共有スタックを停止できませんでした",
+        "removeFailed": "共有スタックを削除できませんでした"
+      }
+    },
     "localMode": {
       "title": "ローカルモード",
       "intro": "ローカルコンテナランナーの調整設定で、このマシンのデプロイに保存されます ({poolVars} / {harnessVars} 環境変数を置き換えました)。保存するとウォームプールがライブでサイズ変更され、再起動は不要です。実行中のランは、すでに保持しているコンテナをそのまま使います。",

package/i18n/locales/pl.json

@@ -1984,6 +1984,52 @@
         "removeFailed": "Nie udało się usunąć wpisu rejestru"
       }
     },
+    "sharedStacks": {
+      "tab": "Współdzielone stosy",
+      "intro": "Długo działająca infrastruktura Compose (bazy danych, brokery, wyszukiwanie, poczta) uruchamiana raz na przestrzeń roboczą i wykorzystywana ponownie we wszystkich uruchomieniach i pull requestach. Środowisko testowe łączy się z zarządzaną siecią stosu. Uruchomienie stosu wymaga lokalnego wdrożenia Dockera; w innych backendach nadal możesz zarządzać definicją.",
+      "stackNoun": "współdzielony stos",
+      "status": {
+        "stopped": "Zatrzymany",
+        "starting": "Uruchamianie",
+        "running": "Działa",
+        "failed": "Niepowodzenie"
+      },
+      "list": {
+        "heading": "Skonfigurowane stosy",
+        "start": "Uruchom",
+        "stop": "Zatrzymaj",
+        "edit": "Edytuj",
+        "remove": "Usuń stos"
+      },
+      "add": {
+        "heading": "Dodaj współdzielony stos",
+        "name": "Nazwa",
+        "cloneUrl": "URL klonowania repozytorium",
+        "cloneUrlHelp": "Repozytorium git, w którym znajdują się pliki Compose stosu.",
+        "gitRef": "Gałąź lub tag (opcjonalnie)",
+        "composeFiles": "Pliki Compose",
+        "composeFilesHelp": "Rozdzielone przecinkami, względem repozytorium, w kolejności nadpisywania.",
+        "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ć.",
+        "allowHostCommands": "Zezwól na kroki konfiguracji z poleceniami hosta",
+        "save": "Dodaj stos"
+      },
+      "edit": {
+        "heading": "Edytuj współdzielony stos",
+        "save": "Zapisz zmiany",
+        "cancel": "Anuluj"
+      },
+      "toast": {
+        "created": "Dodano współdzielony stos",
+        "createFailed": "Nie udało się dodać współdzielonego stosu",
+        "updated": "Zaktualizowano współdzielony stos",
+        "updateFailed": "Nie udało się zaktualizować współdzielonego stosu",
+        "startFailed": "Nie udało się uruchomić współdzielonego stosu",
+        "stopFailed": "Nie udało się zatrzymać współdzielonego stosu",
+        "removeFailed": "Nie udało się usunąć współdzielonego stosu"
+      }
+    },
     "localMode": {
       "title": "Tryb lokalny",
       "intro": "Strojenie lokalnego uruchamiacza kontenerów, przechowywane we wdrożeniu tej maszyny (zastąpiło zmienne środowiskowe {poolVars} / {harnessVars}). Zapisanie zmienia rozmiar ciepłej puli na żywo, bez potrzeby restartu; trwające uruchomienia zachowują kontener, który już mają.",

package/i18n/locales/tr.json

@@ -2106,6 +2106,52 @@
         "removeFailed": "Kayıt defteri girdisi kaldırılamadı"
       }
     },
+    "sharedStacks": {
+      "tab": "Paylaşılan yığınlar",
+      "intro": "Çalışma alanı başına bir kez başlatılan ve tüm çalıştırmalar ile pull request'lerde yeniden kullanılan uzun ömürlü Compose altyapısı (veritabanları, aracılar, arama, posta). Bir test ortamı, yığının yönetilen ağına bağlanır. Bir yığını başlatmak yerel bir Docker dağıtımı gerektirir; diğer arka uçlarda tanımı yine de yönetebilirsiniz.",
+      "stackNoun": "paylaşılan yığın",
+      "status": {
+        "stopped": "Durduruldu",
+        "starting": "Başlatılıyor",
+        "running": "Çalışıyor",
+        "failed": "Başarısız"
+      },
+      "list": {
+        "heading": "Yapılandırılmış yığınlar",
+        "start": "Başlat",
+        "stop": "Durdur",
+        "edit": "Düzenle",
+        "remove": "Yığını sil"
+      },
+      "add": {
+        "heading": "Paylaşılan yığın ekle",
+        "name": "Ad",
+        "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ı)",
+        "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ı)",
+        "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.",
+        "allowHostCommands": "Ana makine komutu kurulum adımlarına izin ver",
+        "save": "Yığın ekle"
+      },
+      "edit": {
+        "heading": "Paylaşılan yığını düzenle",
+        "save": "Değişiklikleri kaydet",
+        "cancel": "İptal"
+      },
+      "toast": {
+        "created": "Paylaşılan yığın eklendi",
+        "createFailed": "Paylaşılan yığın eklenemedi",
+        "updated": "Paylaşılan yığın güncellendi",
+        "updateFailed": "Paylaşılan yığın güncellenemedi",
+        "startFailed": "Paylaşılan yığın başlatılamadı",
+        "stopFailed": "Paylaşılan yığın durdurulamadı",
+        "removeFailed": "Paylaşılan yığın silinemedi"
+      }
+    },
     "localMode": {
       "title": "Yerel mod",
       "intro": "Yerel konteyner çalıştırıcısı için ayarlar, bu makinenin dağıtımında saklanır ({poolVars} / {harnessVars} ortam değişkenlerinin yerini aldı). Kaydetmek sıcak havuzu anında yeniden boyutlandırır, yeniden başlatma gerekmez; devam eden çalıştırmalar zaten tuttukları konteyneri korur.",

package/i18n/locales/uk.json

@@ -1984,6 +1984,52 @@
         "removeFailed": "Не вдалося видалити запис реєстру"
       }
     },
+    "sharedStacks": {
+      "tab": "Спільні стеки",
+      "intro": "Довготривала інфраструктура Compose (бази даних, брокери, пошук, пошта), яку запускають один раз на робочий простір і повторно використовують у всіх запусках та pull request'ах. Тестове середовище під'єднується до керованої мережі стека. Запуск стека потребує локального розгортання Docker; на інших бекендах ви все одно можете керувати визначенням.",
+      "stackNoun": "спільний стек",
+      "status": {
+        "stopped": "Зупинено",
+        "starting": "Запуск",
+        "running": "Працює",
+        "failed": "Помилка"
+      },
+      "list": {
+        "heading": "Налаштовані стеки",
+        "start": "Запустити",
+        "stop": "Зупинити",
+        "edit": "Редагувати",
+        "remove": "Видалити стек"
+      },
+      "add": {
+        "heading": "Додати спільний стек",
+        "name": "Назва",
+        "cloneUrl": "URL клонування репозиторію",
+        "cloneUrlHelp": "Git-репозиторій, у якому містяться файли Compose стека.",
+        "gitRef": "Гілка або тег (необов'язково)",
+        "composeFiles": "Файли Compose",
+        "composeFilesHelp": "Через кому, відносно репозиторію, у порядку перевизначення.",
+        "composeProfiles": "Профілі Compose (необов'язково)",
+        "managedNetworks": "Керовані мережі (необов'язково)",
+        "managedNetworksHelp": "Мережі, які цей стек створює й якими володіє, щоб споживачі під'єднувалися до них.",
+        "allowHostCommands": "Дозволити кроки налаштування з командами хоста",
+        "save": "Додати стек"
+      },
+      "edit": {
+        "heading": "Редагувати спільний стек",
+        "save": "Зберегти зміни",
+        "cancel": "Скасувати"
+      },
+      "toast": {
+        "created": "Спільний стек додано",
+        "createFailed": "Не вдалося додати спільний стек",
+        "updated": "Спільний стек оновлено",
+        "updateFailed": "Не вдалося оновити спільний стек",
+        "startFailed": "Не вдалося запустити спільний стек",
+        "stopFailed": "Не вдалося зупинити спільний стек",
+        "removeFailed": "Не вдалося видалити спільний стек"
+      }
+    },
     "localMode": {
       "title": "Локальний режим",
       "intro": "Налаштування локального запускача контейнерів, збережене на розгортанні цієї машини (воно замінило змінні середовища {poolVars} / {harnessVars}). Збереження змінює розмір теплого пулу наживо, без потреби в перезапуску; поточні запуски зберігають контейнер, який вони вже утримують.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.93.0",
+  "version": "0.94.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.102.0"
+    "@cat-factory/contracts": "0.103.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",