@cat-factory/app 0.63.0 → 0.64.0

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

@@ -10,8 +10,11 @@ import type {
 import type {
   KubernetesManifestSource,
   KubernetesRenderer,
+  ProvisioningComposeServiceCandidate,
+  ProvisioningManifestRootCandidate,
   ProvisioningOverlayCandidate,
   ProvisioningRecommendation,
+  ProvisioningServiceDirCandidate,
 } from '@cat-factory/contracts'
 import RepoTreeBrowser from '~/components/github/RepoTreeBrowser.vue'
 
@@ -204,6 +207,11 @@ function applyPicked() {
 const detecting = ref(false)
 const detectError = ref(false)
 const detectResult = ref<ProvisioningRecommendation | null>(null)
+// Advisory, LOCAL-ONLY selection: which compose `services:` key the user picked. It is NOT persisted
+// (the compose backend targets the file, not a single service), so it lives only in component state
+// and merely drives the chip highlight. Without it the highlight would compare `composePath` — which
+// every candidate shares — and light up ALL chips at once, making the picker look non-functional.
+const pickedComposeService = ref<string | 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.
@@ -212,6 +220,7 @@ watch(
   () => {
     detectResult.value = null
     detectError.value = false
+    pickedComposeService.value = null
   },
 )
 
@@ -235,6 +244,9 @@ async function detectFromRepo() {
       prefer: provisionType.value,
     })
     detectResult.value = rec
+    // Pre-select the recommended compose service so the picker opens on a real choice.
+    pickedComposeService.value =
+      rec.composeServiceCandidates?.find((c) => c.recommended)?.service ?? null
     // 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
@@ -255,6 +267,25 @@ function applyOverlay(candidate: ProvisioningOverlayCandidate) {
   setKubePath(candidate.path)
 }
 
+// Point the manifest path at a different k8s root (and match its renderer) the user picks.
+function applyManifestRoot(candidate: ProvisioningManifestRootCandidate) {
+  setKubePath(candidate.path)
+  setKubeRenderer(candidate.renderer)
+}
+
+// Point the manifest path at a different root-shared monorepo deploy slice the user picks.
+function applyServiceDir(candidate: ProvisioningServiceDirCandidate) {
+  setKubePath(candidate.path)
+}
+
+// Point the compose file at the picked candidate's file and record the advisory service selection.
+// The service KEY is not persisted (the compose backend targets the file, not a single service); the
+// picked key is tracked locally only to drive the chip highlight and the note.
+function applyComposeService(candidate: ProvisioningComposeServiceCandidate) {
+  setComposePath(candidate.composePath)
+  pickedComposeService.value = candidate.service
+}
+
 function provisionTypeLabel(type: ProvisionType): string {
   return t(`inspector.testConfig.provisionTypes.${type}`)
 }
@@ -350,6 +381,42 @@ function setSize(value: InstanceSize) {
             }}
           </p>
 
+          <div v-if="detectResult.serviceDirCandidates?.length" class="space-y-1">
+            <span class="text-[11px] text-slate-400">{{
+              t('inspector.testConfig.detect.serviceDirTitle')
+            }}</span>
+            <div class="flex flex-wrap gap-1">
+              <UButton
+                v-for="s in detectResult.serviceDirCandidates"
+                :key="s.path"
+                :color="kubePath === s.path ? 'primary' : 'neutral'"
+                :variant="kubePath === s.path ? 'soft' : 'ghost'"
+                size="xs"
+                @click="applyServiceDir(s)"
+              >
+                {{ s.name }}
+              </UButton>
+            </div>
+          </div>
+
+          <div v-if="detectResult.manifestRootCandidates?.length" class="space-y-1">
+            <span class="text-[11px] text-slate-400">{{
+              t('inspector.testConfig.detect.manifestRootTitle')
+            }}</span>
+            <div class="flex flex-wrap gap-1">
+              <UButton
+                v-for="r in detectResult.manifestRootCandidates"
+                :key="r.path"
+                :color="kubePath === r.path ? 'primary' : 'neutral'"
+                :variant="kubePath === r.path ? 'soft' : 'ghost'"
+                size="xs"
+                @click="applyManifestRoot(r)"
+              >
+                {{ r.name }}
+              </UButton>
+            </div>
+          </div>
+
           <div v-if="detectResult.overlayCandidates?.length" class="space-y-1">
             <span class="text-[11px] text-slate-400">{{
               t('inspector.testConfig.detect.overlayTitle')
@@ -368,6 +435,24 @@ function setSize(value: InstanceSize) {
             </div>
           </div>
 
+          <div v-if="detectResult.composeServiceCandidates?.length" class="space-y-1">
+            <span class="text-[11px] text-slate-400">{{
+              t('inspector.testConfig.detect.composeServiceTitle')
+            }}</span>
+            <div class="flex flex-wrap gap-1">
+              <UButton
+                v-for="c in detectResult.composeServiceCandidates"
+                :key="c.service"
+                :color="pickedComposeService === c.service ? 'primary' : 'neutral'"
+                :variant="pickedComposeService === c.service ? 'soft' : 'ghost'"
+                size="xs"
+                @click="applyComposeService(c)"
+              >
+                {{ c.service }}
+              </UButton>
+            </div>
+          </div>
+
           <p v-if="detectResult.urlSource" class="text-[11px] text-slate-500">
             {{
               t('inspector.testConfig.detect.urlSource', { source: detectResult.urlSource.source })

package/app/components/settings/InfraHandlersConfigurator.vue

@@ -79,6 +79,51 @@ watch(
 
 const busy = ref(false)
 
+// Connection-probe state for the kube engine forms (workspace + per-user override kept
+// separate so a probe result lands on the form it came from). The probe reaches the apiserver
+// with the supplied config + token via the per-type handler test endpoint — nothing persisted.
+type TestResult = { ok: boolean; message?: string } | null
+const kubeTesting = ref(false)
+const kubeTestResult = ref<TestResult>(null)
+const kubeOverrideTesting = ref(false)
+const kubeOverrideTestResult = ref<TestResult>(null)
+
+async function testKube(payload: { config: KubeHandlerConfig; secrets: Record<string, string> }) {
+  kubeTesting.value = true
+  kubeTestResult.value = null
+  try {
+    kubeTestResult.value = await infra.testHandler({
+      config: payload.config,
+      secrets: payload.secrets,
+    })
+  } catch (e) {
+    kubeTestResult.value = { ok: false, message: e instanceof Error ? e.message : String(e) }
+  } finally {
+    kubeTesting.value = false
+  }
+}
+
+async function testKubeOverride(payload: {
+  config: KubeHandlerConfig
+  secrets: Record<string, string>
+}) {
+  kubeOverrideTesting.value = true
+  kubeOverrideTestResult.value = null
+  try {
+    kubeOverrideTestResult.value = await infra.testHandler({
+      config: payload.config,
+      secrets: payload.secrets,
+    })
+  } catch (e) {
+    kubeOverrideTestResult.value = {
+      ok: false,
+      message: e instanceof Error ? e.message : String(e),
+    }
+  } finally {
+    kubeOverrideTesting.value = false
+  }
+}
+
 async function saveKube(payload: { config: KubeHandlerConfig; secrets: Record<string, string> }) {
   busy.value = true
   try {
@@ -170,6 +215,58 @@ const customSavedManifest = computed<Record<string, unknown> | undefined>(() =>
     : undefined
 })
 
+// The registry backend that builds the `remote-custom` handler's provider. The generic
+// built-in `manifest` (BYO HTTP API) is the default; a deployment that registered a native
+// custom env backend (e.g. Kargo) can be picked here so the handler is pinned to it instead of
+// silently resolving to the generic manifest provider. Only backends that serve the
+// `remote-custom` engine are offered (the snapshot advertises each backend's engines).
+const providerConnections = useProviderConnectionsStore()
+const customBackendOptions = computed(() =>
+  providerConnections
+    .backendKindsFor('environment')
+    .filter((o) => o.engines?.includes('remote-custom'))
+    .map((o) => ({ label: o.label, value: o.kind })),
+)
+const selectedBackendKind = ref<string>('manifest')
+// When editing a saved handler, reflect the backend it was registered with; when switching to a
+// custom type with no handler yet, fall back to the first offered backend (the generic manifest).
+watch(
+  [customHandler, customBackendOptions],
+  ([handler, options]) => {
+    const valid = (k: string) => options.some((o) => o.value === k)
+    if (handler?.backendKind && valid(handler.backendKind)) {
+      selectedBackendKind.value = handler.backendKind
+    } else if (!valid(selectedBackendKind.value)) {
+      selectedBackendKind.value = options.find((o) => o.value === 'manifest')?.value
+        ? 'manifest'
+        : (options[0]?.value ?? 'manifest')
+    }
+  },
+  { immediate: true },
+)
+
+// For a NEW handler on a NON-generic backend, prefill the editor from that backend's manifest
+// template (its self-described skeleton + secret refs) so the operator isn't faced with the
+// generic starter. A saved handler's own manifest always takes precedence.
+const templateManifest = ref<Record<string, unknown> | undefined>(undefined)
+watch(
+  [selectedBackendKind, customHandler],
+  async ([kind, handler]) => {
+    if (handler || kind === 'manifest') {
+      templateManifest.value = undefined
+      return
+    }
+    const descriptor = await providerConnections.fetchDescriptor('environment', kind)
+    templateManifest.value = descriptor?.manifestTemplate
+  },
+  { immediate: true },
+)
+// The manifest to seed the editor with: a saved handler's stored manifest, else the picked
+// backend's template (custom kinds), else undefined (the editor's generic starter).
+const customEditorManifest = computed<Record<string, unknown> | undefined>(
+  () => customSavedManifest.value ?? templateManifest.value,
+)
+
 async function saveCustom(payload: {
   manifest: Record<string, unknown>
   secrets: Record<string, string>
@@ -186,6 +283,9 @@ async function saveCustom(payload: {
       provisionType: 'custom',
       manifestId: selectedCustomId.value,
       config,
+      // Pin the chosen registry backend so a native custom backend (e.g. Kargo) builds the
+      // provider — absent, the engine would resolve to the generic manifest provider.
+      backendKind: selectedBackendKind.value,
       secrets: payload.secrets,
     })
     toastSaved()
@@ -280,10 +380,11 @@ function notifyError(e: unknown) {
       <KubernetesEngineForm
         :engine="selectedKubeEngine"
         :handler="kubeHandler"
-        :supports-test="false"
-        :testing="false"
+        :supports-test="true"
+        :testing="kubeTesting"
         :busy="busy"
-        :test-result="null"
+        :test-result="kubeTestResult"
+        @test="testKube"
         @save="saveKube"
       />
 
@@ -322,10 +423,11 @@ function notifyError(e: unknown) {
           <KubernetesEngineForm
             :engine="selectedKubeEngine"
             :handler="kubeUserHandler"
-            :supports-test="false"
-            :testing="false"
+            :supports-test="true"
+            :testing="kubeOverrideTesting"
             :busy="busy"
-            :test-result="null"
+            :test-result="kubeOverrideTestResult"
+            @test="testKubeOverride"
             @save="saveKubeOverride"
           />
         </div>
@@ -355,6 +457,15 @@ function notifyError(e: unknown) {
         <UFormField :label="t('settings.infrastructure.handler.customTypeLabel')">
           <USelect v-model="selectedCustomId" :items="customTypeItems" />
         </UFormField>
+        <!-- Which registered backend builds this custom handler's provider. Shown only when a
+             deployment registered a custom backend beyond the generic manifest. -->
+        <UFormField
+          v-if="customBackendOptions.length > 1"
+          :label="t('settings.infrastructure.handler.customBackendLabel')"
+          :help="t('settings.infrastructure.handler.customBackendHelp')"
+        >
+          <USelect v-model="selectedBackendKind" :items="customBackendOptions" />
+        </UFormField>
         <p
           v-if="customHandler"
           class="flex items-center justify-between gap-2 text-[12px] text-slate-300"
@@ -373,9 +484,9 @@ function notifyError(e: unknown) {
         </p>
         <ProviderManifestEditor
           v-if="selectedCustomId"
-          :key="selectedCustomId"
+          :key="`${selectedCustomId}:${selectedBackendKind}`"
           kind="environment"
-          :saved-manifest="customSavedManifest"
+          :saved-manifest="customEditorManifest"
           :connected="!!customHandler"
           :stored-secret-keys="customHandler?.secretKeys ?? []"
           :supports-test="false"

package/app/components/settings/KubernetesEngineForm.vue

@@ -115,6 +115,35 @@ watch(
   { immediate: true },
 )
 
+// The local-cluster apiserver address every loopback distro (k3s / k3d / kind / minikube)
+// exposes by default — see `seedForEngine`.
+const LOCAL_K3S_API_SERVER = 'https://127.0.0.1:6443'
+
+// Seed the form for the SELECTED engine, so picking an engine gives immediate feedback instead
+// of a dead toggle. `local-k3s` is a low-config local cluster (k3s / k3d / kind all expose a
+// loopback apiserver with a self-signed cert), so prefill its loopback defaults + flag insecure
+// TLS — the operator then only pastes a ServiceAccount token and picks the URL source.
+// `remote-kubernetes` starts clean. Only seeds a FRESH form (never clobbers an edit — a saved
+// handler is prefilled from its stored config by the watch above).
+watch(
+  () => props.engine,
+  (engine) => {
+    if (props.handler) return
+    if (engine === 'local-k3s') {
+      if (!form.label.trim()) form.label = 'Local k3s'
+      if (!form.apiServerUrl.trim()) form.apiServerUrl = LOCAL_K3S_API_SERVER
+      form.insecureSkipTlsVerify = true
+    } else {
+      // Clear the local-only loopback defaults so a remote engine isn't misleadingly prefilled,
+      // but leave anything the operator has actually typed.
+      if (form.apiServerUrl === LOCAL_K3S_API_SERVER) form.apiServerUrl = ''
+      if (form.label === 'Local k3s') form.label = ''
+      form.insecureSkipTlsVerify = false
+    }
+  },
+  { immediate: true },
+)
+
 const servicePortValid = computed(() => {
   const raw = form.servicePort.trim()
   if (!raw) return true
@@ -185,6 +214,13 @@ function optional(label: string): string {
       }}
     </p>
 
+    <p
+      v-if="engine === 'local-k3s'"
+      class="rounded-md border border-sky-500/30 bg-sky-500/10 p-2 text-[11px] text-sky-200"
+    >
+      {{ t('settings.infrastructure.kubernetesEngine.localK3sHint') }}
+    </p>
+
     <UFormField :label="t('settings.infrastructure.kubernetesEngine.label')">
       <UInput
         v-model="form.label"

package/app/composables/api/infraHandlers.ts

@@ -5,6 +5,7 @@ import {
   registerEnvironmentHandlerContract,
   removeCustomManifestTypeContract,
   removeEnvironmentUserHandlerContract,
+  testEnvironmentHandlerContract,
   unregisterEnvironmentHandlerContract,
   upsertCustomManifestTypeContract,
   upsertEnvironmentUserHandlerContract,
@@ -13,6 +14,7 @@ import type {
   DetectServiceProvisioningInput,
   ProvisionType,
   RegisterEnvironmentHandlerInput,
+  TestEnvironmentHandlerInput,
   UpsertCustomManifestTypeInput,
   UpsertEnvironmentUserHandlerBody,
 } from '@cat-factory/contracts'
@@ -35,6 +37,10 @@ export function infraHandlersApi({ send, ws }: ApiContext) {
     registerEnvironmentHandler: (workspaceId: string, body: RegisterEnvironmentHandlerInput) =>
       send(registerEnvironmentHandlerContract, { pathPrefix: ws(workspaceId), body }),
 
+    // Probe a candidate handler connection before saving (nothing persisted).
+    testEnvironmentHandler: (workspaceId: string, body: TestEnvironmentHandlerInput) =>
+      send(testEnvironmentHandlerContract, { 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 }),

package/app/spa-loading-template.html

@@ -1,32 +1,133 @@
 <!-- Early SPA loading shell painted before the JS bundle parses + Vue mounts
      (Nuxt removes it on mount). Self-contained: main.css/icon fonts aren't loaded
-     yet, so styles + spinner are inline pure-CSS. Spinner-only keeps it
-     locale-neutral. Wired via app.spaLoadingTemplate in nuxt.config.ts. -->
-<div class="cf-spa-loader" role="status" aria-label="Loading">
-  <div class="cf-spa-loader__spinner"></div>
+     yet, so styles + markup are inline pure-CSS. The only copy is the "Cat Factory"
+     brand name (a proper noun, identical in every locale) so it stays locale-neutral.
+     Wired via app.spaLoadingTemplate in nuxt.config.ts. -->
+<div class="cf-spa-loader" role="status" aria-label="Cat Factory is starting">
+  <div class="cf-spa-loader__badge">
+    <div class="cf-spa-loader__ring"></div>
+    <!-- Cat face, drawn inline so it paints without the icon font. -->
+    <svg class="cf-spa-loader__cat" viewBox="0 0 24 24" fill="none" aria-hidden="true">
+      <path
+        d="M4 4l3 3.2A7.5 7.5 0 0 1 12 6c1.9 0 3.6.5 5 1.2L20 4v8a8 8 0 0 1-16 0V4z"
+        fill="currentColor"
+      />
+      <circle cx="9" cy="11.5" r="1.1" fill="#0b1020" />
+      <circle cx="15" cy="11.5" r="1.1" fill="#0b1020" />
+      <path
+        d="M10.6 14.4c.4.5 2.4.5 2.8 0"
+        stroke="#0b1020"
+        stroke-width="1"
+        stroke-linecap="round"
+      />
+    </svg>
+  </div>
+  <div class="cf-spa-loader__text">
+    <span class="cf-spa-loader__brand">Cat Factory</span>
+    <span class="cf-spa-loader__status">
+      is starting<span class="cf-spa-loader__dots"><i>.</i><i>.</i><i>.</i></span>
+    </span>
+  </div>
 </div>
 <style>
   .cf-spa-loader {
     position: fixed;
     inset: 0;
     display: flex;
+    flex-direction: column;
     align-items: center;
     justify-content: center;
+    gap: 1.5rem;
     /* --board-bg / slate-950, matching the board surface AuthGate renders on. */
     background-color: #0b1020;
+    font-family:
+      ui-sans-serif,
+      system-ui,
+      -apple-system,
+      'Segoe UI',
+      Roboto,
+      sans-serif;
   }
-  .cf-spa-loader__spinner {
-    width: 2rem;
-    height: 2rem;
+  .cf-spa-loader__badge {
+    position: relative;
+    width: 5rem;
+    height: 5rem;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+  }
+  .cf-spa-loader__ring {
+    position: absolute;
+    inset: 0;
     border-radius: 9999px;
     /* Track in slate-700, the active arc in indigo-500 (the app's primary). */
-    border: 3px solid #334155;
+    border: 3px solid #1e293b;
     border-top-color: #6366f1;
     animation: cf-spa-spin 1s linear infinite;
   }
+  .cf-spa-loader__cat {
+    width: 2.5rem;
+    height: 2.5rem;
+    color: #818cf8;
+    animation: cf-spa-bob 1.6s ease-in-out infinite;
+  }
+  .cf-spa-loader__text {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 0.25rem;
+  }
+  .cf-spa-loader__brand {
+    font-size: 1.35rem;
+    font-weight: 700;
+    letter-spacing: 0.01em;
+    background: linear-gradient(90deg, #818cf8, #6366f1);
+    -webkit-background-clip: text;
+    background-clip: text;
+    color: transparent;
+  }
+  .cf-spa-loader__status {
+    font-size: 0.875rem;
+    color: #94a3b8;
+  }
+  .cf-spa-loader__dots i {
+    font-style: normal;
+    animation: cf-spa-blink 1.4s infinite both;
+  }
+  .cf-spa-loader__dots i:nth-child(2) {
+    animation-delay: 0.2s;
+  }
+  .cf-spa-loader__dots i:nth-child(3) {
+    animation-delay: 0.4s;
+  }
   @keyframes cf-spa-spin {
     to {
       transform: rotate(360deg);
     }
   }
+  @keyframes cf-spa-bob {
+    0%,
+    100% {
+      transform: translateY(0);
+    }
+    50% {
+      transform: translateY(-0.2rem);
+    }
+  }
+  @keyframes cf-spa-blink {
+    0%,
+    100% {
+      opacity: 0.2;
+    }
+    50% {
+      opacity: 1;
+    }
+  }
+  @media (prefers-reduced-motion: reduce) {
+    .cf-spa-loader__ring,
+    .cf-spa-loader__cat,
+    .cf-spa-loader__dots i {
+      animation: none;
+    }
+  }
 </style>

package/app/stores/infraConfig.ts

@@ -6,6 +6,7 @@ import type {
   EnvironmentHandlerView,
   ProvisionType,
   RegisterEnvironmentHandlerInput,
+  TestEnvironmentHandlerInput,
   UpsertCustomManifestTypeInput,
   UpsertEnvironmentUserHandlerBody,
 } from '@cat-factory/contracts'
@@ -95,6 +96,12 @@ export const useInfraConfigStore = defineStore('infraConfig', () => {
     return saved
   }
 
+  /** Probe a candidate handler connection before saving (nothing persisted). */
+  async function testHandler(input: TestEnvironmentHandlerInput) {
+    const ws = useWorkspaceStore()
+    return api.testEnvironmentHandler(ws.requireId(), input)
+  }
+
   /**
    * 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
@@ -172,6 +179,7 @@ export const useInfraConfigStore = defineStore('infraConfig', () => {
     ensureLoaded,
     handlerFor,
     registerHandler,
+    testHandler,
     detectProvisioning,
     unregisterHandler,
     upsertCustomType,

package/app/stores/providerConnections.ts

@@ -18,8 +18,8 @@ const KINDS: ProviderConnectionKind[] = ['environment', 'runner-pool']
 // additionally carry a deployment's programmatically-registered CUSTOM kinds.
 const BUILTIN_BACKEND_KINDS: Record<ProviderConnectionKind, BackendKindOption[]> = {
   environment: [
-    { kind: 'manifest', label: 'HTTP manifest' },
-    { kind: 'kubernetes', label: 'Kubernetes' },
+    { kind: 'manifest', label: 'HTTP manifest', engines: ['remote-custom'] },
+    { kind: 'kubernetes', label: 'Kubernetes', engines: ['local-k3s', 'remote-kubernetes'] },
   ],
   'runner-pool': [
     { kind: 'manifest', label: 'HTTP manifest pool' },
@@ -111,6 +111,23 @@ export const useProviderConnectionsStore = defineStore('providerConnections', ()
     }
   }
 
+  /**
+   * Fetch (without mutating shared state) the descriptor for a specific backend kind — used by
+   * the per-type infra configurator to prefill a custom backend's manifest template/secret
+   * fields when the operator picks it. Returns null on a transient describe failure.
+   */
+  async function fetchDescriptor(
+    kind: ProviderConnectionKind,
+    backendKind?: string,
+  ): Promise<ProviderDescriptor | null> {
+    const ws = useWorkspaceStore()
+    try {
+      return await api.describeProvider(ws.requireId(), kind, backendKind)
+    } catch {
+      return null
+    }
+  }
+
   /** Refresh both providers (used by the banner + after a save/remove). */
   async function load() {
     await Promise.all(KINDS.map((k) => loadKind(k)))
@@ -177,6 +194,7 @@ export const useProviderConnectionsStore = defineStore('providerConnections', ()
     load,
     loadKind,
     loadDescriptor,
+    fetchDescriptor,
     ensureLoaded,
     descriptorFor,
     connectionFor,

package/i18n/locales/en.json

@@ -483,6 +483,9 @@
         "none": "No Kubernetes manifests or Compose file were detected.",
         "applied": "Suggested a {type} config. Review and adjust the fields below.",
         "overlayTitle": "Ephemeral overlay",
+        "serviceDirTitle": "Service deploy folder",
+        "manifestRootTitle": "Manifest location",
+        "composeServiceTitle": "Compose service",
         "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",
@@ -1344,6 +1347,7 @@
         "remote-kubernetes": "Remote Kubernetes"
       },
       "kubernetesEngine": {
+        "localK3sHint": "Prefilled for a local k3s/k3d/kind cluster on this machine. Bind a ServiceAccount to a role, mint its token with `kubectl create token NAME -n NAMESPACE` (Kubernetes 1.24+), and paste it below. Then choose how the environment URL is derived, and edit the API server URL if your cluster listens on a different port.",
         "label": "Connection label",
         "labelPlaceholder": "Preview cluster",
         "apiServerUrl": "API server URL",
@@ -1400,6 +1404,8 @@
         "engineLabel": "Engine",
         "customHandlerTitle": "Remote-custom handler",
         "customTypeLabel": "Custom type",
+        "customBackendLabel": "Backend",
+        "customBackendHelp": "Which registered backend provisions this custom environment.",
         "customConnected": "Handler connected.",
         "saved": "Handler saved",
         "removed": "Handler removed",

package/i18n/locales/es.json

@@ -446,6 +446,9 @@
         "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",
+        "serviceDirTitle": "Carpeta de despliegue del servicio",
+        "manifestRootTitle": "Ubicación del manifiesto",
+        "composeServiceTitle": "Servicio de Compose",
         "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",
@@ -1753,6 +1756,7 @@
         "remote-kubernetes": "Kubernetes remoto"
       },
       "kubernetesEngine": {
+        "localK3sHint": "Precargado para un clúster local k3s/k3d/kind en esta máquina. Vincula una ServiceAccount a un rol, genera su token con `kubectl create token NAME -n NAMESPACE` (Kubernetes 1.24+) y pégalo abajo. Luego elige cómo se deriva la URL del entorno y edita la URL del API server si tu clúster escucha en otro puerto.",
         "label": "Etiqueta de la conexión",
         "labelPlaceholder": "Clúster de vista previa",
         "apiServerUrl": "URL del API server",
@@ -1809,6 +1813,8 @@
         "engineLabel": "Motor",
         "customHandlerTitle": "Gestor remote-custom",
         "customTypeLabel": "Tipo personalizado",
+        "customBackendLabel": "Backend",
+        "customBackendHelp": "Qué backend registrado aprovisiona este entorno personalizado.",
         "customConnected": "Gestor conectado.",
         "saved": "Gestor guardado",
         "removed": "Gestor eliminado",

package/i18n/locales/fr.json

@@ -446,6 +446,9 @@
         "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",
+        "serviceDirTitle": "Dossier de déploiement du service",
+        "manifestRootTitle": "Emplacement du manifeste",
+        "composeServiceTitle": "Service Compose",
         "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é",
@@ -1753,6 +1756,7 @@
         "remote-kubernetes": "Kubernetes distant"
       },
       "kubernetesEngine": {
+        "localK3sHint": "Prérempli pour un cluster local k3s/k3d/kind sur cette machine. Liez un ServiceAccount à un rôle, générez son token avec `kubectl create token NAME -n NAMESPACE` (Kubernetes 1.24+) et collez-le ci-dessous. Choisissez ensuite comment l'URL de l'environnement est dérivée, et modifiez l'URL de l'API server si votre cluster écoute sur un autre port.",
         "label": "Libellé de la connexion",
         "labelPlaceholder": "Cluster de prévisualisation",
         "apiServerUrl": "URL de l'API server",
@@ -1809,6 +1813,8 @@
         "engineLabel": "Moteur",
         "customHandlerTitle": "Gestionnaire remote-custom",
         "customTypeLabel": "Type personnalisé",
+        "customBackendLabel": "Backend",
+        "customBackendHelp": "Quel backend enregistré provisionne cet environnement personnalisé.",
         "customConnected": "Gestionnaire connecté.",
         "saved": "Gestionnaire enregistré",
         "removed": "Gestionnaire supprimé",

package/i18n/locales/he.json

@@ -446,6 +446,9 @@
         "none": "לא זוהו מניפסטים של Kubernetes או קובץ Compose.",
         "applied": "הוצעה תצורת {type}. בדוק והתאם את השדות למטה.",
         "overlayTitle": "שכבת סביבה זמנית",
+        "serviceDirTitle": "תיקיית פריסת השירות",
+        "manifestRootTitle": "מיקום המניפסט",
+        "composeServiceTitle": "שירות Compose",
         "urlSource": "מקור כתובת הסביבה המוצע: {source}. המטפל של המרחב שולט בכך; הגדר זאת שם.",
         "namespace": "המניפסטים מקבעים את מרחב השמות \"{namespace}\"; מומלץ לכבד אותו במטפל של המרחב.",
         "confidenceHigh": "זוהה",
@@ -1302,6 +1305,7 @@
         "remote-kubernetes": "Kubernetes מרוחק"
       },
       "kubernetesEngine": {
+        "localK3sHint": "מולא מראש עבור אשכול k3s/k3d/kind מקומי במחשב הזה. קשרו ServiceAccount לתפקיד, הנפיקו עבורו token באמצעות `kubectl create token NAME -n NAMESPACE` (Kubernetes 1.24+) והדביקו אותו למטה. לאחר מכן בחרו כיצד נגזרת כתובת ה-URL של הסביבה, וערכו את כתובת ה-API server אם האשכול שלכם מאזין ביציאה אחרת.",
         "label": "תווית החיבור",
         "labelPlaceholder": "אשכול תצוגה מקדימה",
         "apiServerUrl": "כתובת ה-API server",
@@ -1358,6 +1362,8 @@
         "engineLabel": "מנוע",
         "customHandlerTitle": "מטפל remote-custom",
         "customTypeLabel": "סוג מותאם",
+        "customBackendLabel": "Backend",
+        "customBackendHelp": "איזה backend רשום מקצה את הסביבה המותאמת אישית הזו.",
         "customConnected": "המטפל מחובר.",
         "saved": "המטפל נשמר",
         "removed": "המטפל הוסר",

package/i18n/locales/ja.json

@@ -446,6 +446,9 @@
         "none": "Kubernetes マニフェストや Compose ファイルは検出されませんでした。",
         "applied": "{type} の設定を提案しました。以下のフィールドを確認して調整してください。",
         "overlayTitle": "一時環境のオーバーレイ",
+        "serviceDirTitle": "サービスのデプロイフォルダ",
+        "manifestRootTitle": "マニフェストの場所",
+        "composeServiceTitle": "Compose サービス",
         "urlSource": "推奨される環境 URL ソース: {source}。これはワークスペースのハンドラーが管理します。そちらで設定してください。",
         "namespace": "マニフェストは名前空間「{namespace}」を固定しています。ワークスペースのハンドラーでそれを尊重することを推奨します。",
         "confidenceHigh": "検出",
@@ -1304,6 +1307,7 @@
         "remote-kubernetes": "リモート Kubernetes"
       },
       "kubernetesEngine": {
+        "localK3sHint": "このマシン上のローカル k3s/k3d/kind クラスター向けにあらかじめ入力されています。ServiceAccount をロールにバインドし、`kubectl create token NAME -n NAMESPACE`（Kubernetes 1.24 以降）でトークンを発行して下記に貼り付けてください。その後、環境 URL の導出方法を選択し、クラスターが別のポートで待ち受けている場合は API サーバー URL を編集してください。",
         "label": "接続ラベル",
         "labelPlaceholder": "プレビュークラスター",
         "apiServerUrl": "API サーバー URL",
@@ -1360,6 +1364,8 @@
         "engineLabel": "エンジン",
         "customHandlerTitle": "remote-custom ハンドラー",
         "customTypeLabel": "カスタムタイプ",
+        "customBackendLabel": "バックエンド",
+        "customBackendHelp": "このカスタム環境をプロビジョニングする登録済みバックエンド。",
         "customConnected": "ハンドラーが接続されました。",
         "saved": "ハンドラーを保存しました",
         "removed": "ハンドラーを削除しました",

package/i18n/locales/pl.json

@@ -446,6 +446,9 @@
         "none": "Nie wykryto manifestów Kubernetes ani pliku Compose.",
         "applied": "Zaproponowano konfigurację {type}. Przejrzyj i dostosuj pola poniżej.",
         "overlayTitle": "Tymczasowy overlay",
+        "serviceDirTitle": "Folder wdrożenia usługi",
+        "manifestRootTitle": "Lokalizacja manifestu",
+        "composeServiceTitle": "Usługa Compose",
         "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",
@@ -1753,6 +1756,7 @@
         "remote-kubernetes": "Zdalny Kubernetes"
       },
       "kubernetesEngine": {
+        "localK3sHint": "Wstępnie wypełnione dla lokalnego klastra k3s/k3d/kind na tym komputerze. Powiąż ServiceAccount z rolą, wygeneruj jego token poleceniem `kubectl create token NAME -n NAMESPACE` (Kubernetes 1.24+) i wklej go poniżej. Następnie wybierz sposób ustalania adresu URL środowiska i zmień URL serwera API, jeśli Twój klaster nasłuchuje na innym porcie.",
         "label": "Etykieta połączenia",
         "labelPlaceholder": "Klaster podglądu",
         "apiServerUrl": "URL serwera API",
@@ -1809,6 +1813,8 @@
         "engineLabel": "Silnik",
         "customHandlerTitle": "Handler remote-custom",
         "customTypeLabel": "Typ niestandardowy",
+        "customBackendLabel": "Backend",
+        "customBackendHelp": "Który zarejestrowany backend obsługuje to niestandardowe środowisko.",
         "customConnected": "Handler połączony.",
         "saved": "Handler zapisany",
         "removed": "Handler usunięty",

package/i18n/locales/tr.json

@@ -446,6 +446,9 @@
         "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",
+        "serviceDirTitle": "Servis dağıtım klasörü",
+        "manifestRootTitle": "Manifest konumu",
+        "composeServiceTitle": "Compose servisi",
         "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ı",
@@ -1304,6 +1307,7 @@
         "remote-kubernetes": "Uzak Kubernetes"
       },
       "kubernetesEngine": {
+        "localK3sHint": "Bu makinedeki yerel bir k3s/k3d/kind kümesi için önceden dolduruldu. Bir ServiceAccount'u bir role bağlayın, `kubectl create token NAME -n NAMESPACE` (Kubernetes 1.24+) ile token'ını oluşturun ve aşağıya yapıştırın. Ardından ortam URL'sinin nasıl türetileceğini seçin ve kümeniz farklı bir bağlantı noktasını dinliyorsa API sunucu URL'sini düzenleyin.",
         "label": "Bağlantı etiketi",
         "labelPlaceholder": "Önizleme kümesi",
         "apiServerUrl": "API sunucu URL'si",
@@ -1360,6 +1364,8 @@
         "engineLabel": "Motor",
         "customHandlerTitle": "remote-custom işleyici",
         "customTypeLabel": "Özel tür",
+        "customBackendLabel": "Arka uç",
+        "customBackendHelp": "Bu özel ortamı hangi kayıtlı arka ucun sağlayacağı.",
         "customConnected": "İşleyici bağlandı.",
         "saved": "İşleyici kaydedildi",
         "removed": "İşleyici kaldırıldı",

package/i18n/locales/uk.json

@@ -446,6 +446,9 @@
         "none": "Маніфести Kubernetes або файл Compose не виявлено.",
         "applied": "Запропоновано конфігурацію {type}. Перегляньте та скоригуйте поля нижче.",
         "overlayTitle": "Тимчасовий overlay",
+        "serviceDirTitle": "Тека розгортання сервісу",
+        "manifestRootTitle": "Розташування маніфесту",
+        "composeServiceTitle": "Сервіс Compose",
         "urlSource": "Запропоноване джерело URL середовища: {source}. Цим керує обробник робочого простору; налаштуйте його там.",
         "namespace": "Маніфести фіксують простір імен \"{namespace}\"; рекомендуємо дотримуватися його в обробнику робочого простору.",
         "confidenceHigh": "Виявлено",
@@ -1753,6 +1756,7 @@
         "remote-kubernetes": "Віддалений Kubernetes"
       },
       "kubernetesEngine": {
+        "localK3sHint": "Попередньо заповнено для локального кластера k3s/k3d/kind на цьому комп'ютері. Прив'яжіть ServiceAccount до ролі, згенеруйте його токен командою `kubectl create token NAME -n NAMESPACE` (Kubernetes 1.24+) і вставте його нижче. Потім виберіть, як визначається URL середовища, і змініть URL сервера API, якщо ваш кластер слухає на іншому порту.",
         "label": "Мітка з'єднання",
         "labelPlaceholder": "Кластер попереднього перегляду",
         "apiServerUrl": "URL сервера API",
@@ -1809,6 +1813,8 @@
         "engineLabel": "Рушій",
         "customHandlerTitle": "Обробник remote-custom",
         "customTypeLabel": "Власний тип",
+        "customBackendLabel": "Бекенд",
+        "customBackendHelp": "Який зареєстрований бекенд забезпечує це користувацьке середовище.",
         "customConnected": "Обробник підключено.",
         "saved": "Обробник збережено",
         "removed": "Обробник видалено",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.63.0",
+  "version": "0.64.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.70.0"
+    "@cat-factory/contracts": "0.71.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",