@cat-factory/app 0.261.4 → 0.261.5

package/app/components/settings/KubernetesEngineForm.vue

@@ -65,6 +65,9 @@ const form = reactive({
   imageTemplate: '',
   urlSource: 'ingressTemplate' as UrlSource,
   hostTemplate: '',
+  // The ingress-template port, separate from `servicePort`: each url field belongs to exactly ONE
+  // variant, so a value entered for one source can never populate a config built for another.
+  ingressPort: '',
   ingressName: '',
   serviceName: '',
   servicePort: '',
@@ -121,28 +124,34 @@ watch(
     form.insecureSkipTlsVerify = k.insecureSkipTlsVerify === true
     form.namespaceTemplate = k.namespaceTemplate ?? ''
     form.imageTemplate = k.imageTemplate ?? ''
-    // Each url field is read off the ONE variant that carries it, so a field belonging to a
-    // different `source` cannot silently populate the form.
-    //
-    // Typed as present with an on-union `source`, read as neither: both were true when the
-    // connect form admitted this config, and the value has been through storage since — which is
-    // exactly why the backend re-parses a stored `providerConfig` rather than asserting it, and
-    // this form is where an operator REPAIRS one that drifted. An unrecognised source falls back
-    // to the form's default, because `buildUrl` has no branch to build a config out of one.
-    const url: KubeUrlSource | undefined = k.url
-    const source = url?.source
-    form.urlSource = isKubernetesUrlSource(source) ? source : 'ingressTemplate'
-    form.hostTemplate = url?.source === 'ingressTemplate' ? url.hostTemplate : ''
-    form.ingressName = url?.source === 'ingressStatus' ? (url.ingressName ?? '') : ''
-    form.serviceName = url?.source === 'serviceStatus' ? url.serviceName : ''
-    form.servicePort = url?.source === 'serviceStatus' && url.port != null ? String(url.port) : ''
-    form.gatewayName = url?.source === 'gatewayStatus' ? (url.gatewayName ?? '') : ''
-    form.httpRouteName = url?.source === 'httpRouteStatus' ? (url.httpRouteName ?? '') : ''
-    form.urlScheme = url?.scheme ?? 'default'
+    applyStoredUrlSource(k.url)
   },
   { immediate: true },
 )
 
+/**
+ * Prefill the URL-derivation fields from a stored config. Each field is read off the ONE variant
+ * that carries it, so a field belonging to a different `source` cannot silently populate the form.
+ *
+ * Typed as present with an on-union `source`, read as neither: both were true when the connect form
+ * admitted this config, and the value has been through storage since, which is exactly why the
+ * backend re-parses a stored `providerConfig` rather than asserting it, and this form is where an
+ * operator REPAIRS one that drifted. An unrecognised source falls back to the form's default,
+ * because `buildUrl` has no branch to build a config out of one.
+ */
+function applyStoredUrlSource(url: KubeUrlSource | undefined): void {
+  const source = url?.source
+  form.urlSource = isKubernetesUrlSource(source) ? source : 'ingressTemplate'
+  form.hostTemplate = url?.source === 'ingressTemplate' ? url.hostTemplate : ''
+  form.ingressPort = url?.source === 'ingressTemplate' && url.port != null ? String(url.port) : ''
+  form.ingressName = url?.source === 'ingressStatus' ? (url.ingressName ?? '') : ''
+  form.serviceName = url?.source === 'serviceStatus' ? url.serviceName : ''
+  form.servicePort = url?.source === 'serviceStatus' && url.port != null ? String(url.port) : ''
+  form.gatewayName = url?.source === 'gatewayStatus' ? (url.gatewayName ?? '') : ''
+  form.httpRouteName = url?.source === 'httpRouteStatus' ? (url.httpRouteName ?? '') : ''
+  form.urlScheme = url?.scheme ?? 'default'
+}
+
 // 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'
@@ -185,22 +194,33 @@ watch(
     if (prefill.insecureSkipTlsVerify !== undefined)
       form.insecureSkipTlsVerify = prefill.insecureSkipTlsVerify
     if (prefill.namespaceTemplate.trim()) form.namespaceTemplate = prefill.namespaceTemplate.trim()
+    // An EMPTY host template is meaningful, not a gap the link forgot to fill: the CLI withholds
+    // it when it could not establish that the cluster serves an ingress-derived URL, and leaving
+    // the required field blank is what stops a URL nothing answers being saved.
     if (prefill.hostTemplate.trim()) {
       form.urlSource = 'ingressTemplate'
       form.hostTemplate = prefill.hostTemplate.trim()
+      // Carried alongside the template, never inside it: a local cluster publishing its controller
+      // on 18080 needs the port in the URL and NOT in the Ingress host the manifests declare.
+      form.ingressPort = prefill.ingressPort.trim()
     }
+    if (prefill.urlScheme) form.urlScheme = prefill.urlScheme
   },
   { immediate: true },
 )
 
-const servicePortValid = computed(() => {
-  const raw = form.servicePort.trim()
-  if (!raw) return true
-  const port = Number(raw)
+/** A blank port is valid (the scheme's default); anything typed has to be a real port number. */
+function portValid(raw: string): boolean {
+  const trimmed = raw.trim()
+  if (!trimmed) return true
+  const port = Number(trimmed)
   return Number.isInteger(port) && port >= 1 && port <= 65535
-})
+}
+const servicePortValid = computed(() => portValid(form.servicePort))
+const ingressPortValid = computed(() => portValid(form.ingressPort))
 const urlValid = computed(() => {
-  if (form.urlSource === 'ingressTemplate') return !!form.hostTemplate.trim()
+  if (form.urlSource === 'ingressTemplate')
+    return !!form.hostTemplate.trim() && ingressPortValid.value
   if (form.urlSource === 'serviceStatus') return !!form.serviceName.trim() && servicePortValid.value
   return true // ingressStatus / gatewayStatus / httpRouteStatus have no required field
 })
@@ -257,8 +277,15 @@ const connectBlockedReason = computed(() => {
 function buildUrl(): KubeUrlSource {
   const scheme = form.urlScheme === 'default' ? {} : { scheme: form.urlScheme }
   switch (form.urlSource) {
-    case 'ingressTemplate':
-      return { source: 'ingressTemplate', hostTemplate: form.hostTemplate.trim(), ...scheme }
+    case 'ingressTemplate': {
+      const port = Number(form.ingressPort)
+      return {
+        source: 'ingressTemplate',
+        hostTemplate: form.hostTemplate.trim(),
+        ...(form.ingressPort.trim() && Number.isInteger(port) ? { port } : {}),
+        ...scheme,
+      }
+    }
     case 'ingressStatus': {
       const ingressName = form.ingressName.trim()
       return { source: 'ingressStatus', ...(ingressName ? { ingressName } : {}), ...scheme }
@@ -456,6 +483,24 @@ async function copyAutoSetupCommand() {
       />
     </UFormField>
 
+    <!-- The host port the controller answers on, when it is not the scheme's default. Separate from
+         the template on purpose: the rendered template is also the Ingress `host` the manifests
+         declare, and Kubernetes rejects a `host` with a port in it. -->
+    <UFormField
+      v-if="form.urlSource === 'ingressTemplate'"
+      :label="optional(t('settings.infrastructure.kubernetesEngine.port'))"
+      :help="t('settings.infrastructure.kubernetesEngine.ingressPortHelp')"
+    >
+      <UInput
+        v-model="form.ingressPort"
+        type="number"
+        :min="1"
+        :max="65535"
+        class="font-mono"
+        placeholder="80"
+      />
+    </UFormField>
+
     <UFormField
       v-if="form.urlSource === 'ingressStatus'"
       :label="optional(t('settings.infrastructure.kubernetesEngine.ingressName'))"

package/app/components/settings/KubernetesEnvironmentForm.vue

@@ -46,6 +46,9 @@ const form = reactive({
   // url derivation
   urlSource: 'ingressTemplate' as 'ingressTemplate' | 'ingressStatus' | 'serviceStatus',
   hostTemplate: '',
+  // The ingress-template port, its own field because the rendered template is also the Ingress
+  // `host` a service's manifests declare, and Kubernetes rejects a `host` carrying a port.
+  ingressPort: '',
   ingressName: '',
   serviceName: '',
   servicePort: '',
@@ -111,6 +114,7 @@ function applyUrl(k: Record<string, unknown>): void {
   if (url?.source === 'ingressTemplate') {
     form.urlSource = 'ingressTemplate'
     form.hostTemplate = readString(url.hostTemplate)
+    form.ingressPort = typeof url.port === 'number' ? String(url.port) : ''
   } else if (url?.source === 'ingressStatus') {
     form.urlSource = 'ingressStatus'
     form.ingressName = readString(url.ingressName)
@@ -154,16 +158,20 @@ const manifestSourceValid = computed(() =>
     ? repoShapeValid.value && !!form.manifestPath.trim()
     : !!form.manifestPath.trim(),
 )
-// serviceStatus.port is an optional integer 1..65535 (kubernetesUrlSourceSchema). Validate
-// it here so a decimal isn't silently dropped and an out-of-range value isn't sent then 422'd.
-const servicePortValid = computed(() => {
-  const raw = form.servicePort.trim()
-  if (!raw) return true
-  const port = Number(raw)
+// Both `ingressTemplate.port` and `serviceStatus.port` are optional integers 1..65535
+// (kubernetesUrlSourceSchema). Validate here so a decimal isn't silently dropped and an
+// out-of-range value isn't sent then 422'd.
+function portValid(raw: string): boolean {
+  const trimmed = raw.trim()
+  if (!trimmed) return true
+  const port = Number(trimmed)
   return Number.isInteger(port) && port >= 1 && port <= 65535
-})
+}
+const servicePortValid = computed(() => portValid(form.servicePort))
+const ingressPortValid = computed(() => portValid(form.ingressPort))
 const urlValid = computed(() => {
-  if (form.urlSource === 'ingressTemplate') return !!form.hostTemplate.trim()
+  if (form.urlSource === 'ingressTemplate')
+    return !!form.hostTemplate.trim() && ingressPortValid.value
   if (form.urlSource === 'serviceStatus') return !!form.serviceName.trim() && servicePortValid.value
   return true // ingressStatus has no required field
 })
@@ -219,6 +227,8 @@ function buildUrl(): Record<string, unknown> {
   const url: Record<string, unknown> = { source: form.urlSource }
   if (form.urlSource === 'ingressTemplate') {
     url.hostTemplate = form.hostTemplate.trim()
+    const port = Number(form.ingressPort)
+    if (form.ingressPort.trim() && Number.isInteger(port)) url.port = port
   } else if (form.urlSource === 'ingressStatus') {
     if (form.ingressName.trim()) url.ingressName = form.ingressName.trim()
   } else {
@@ -338,6 +348,23 @@ function optional(label: string): string {
       />
     </UFormField>
 
+    <!-- The host port the controller answers on, when it is not the scheme's default. Kept out of
+         the template because that value is also the Ingress `host` the manifests declare. -->
+    <UFormField
+      v-if="form.urlSource === 'ingressTemplate'"
+      :label="optional(t('settings.providerConnection.kubernetesEnv.port'))"
+      :help="t('settings.providerConnection.kubernetesEnv.ingressPortHelp')"
+    >
+      <UInput
+        v-model="form.ingressPort"
+        type="number"
+        :min="1"
+        :max="65535"
+        class="font-mono"
+        placeholder="80"
+      />
+    </UFormField>
+
     <UFormField
       v-if="form.urlSource === 'ingressStatus'"
       :label="optional(t('settings.providerConnection.kubernetesEnv.ingressName'))"

package/app/stores/ui/k3sDeepLink.spec.ts

@@ -17,7 +17,15 @@ function openWith(search: string): void {
 const K3S_LINK =
   '?infraSetup=local-k3s&label=Local+k3s&apiServerUrl=https%3A%2F%2F127.0.0.1%3A6443' +
   '&namespaceTemplate=cf-env-%7B%7BpullNumber%7D%7D&hostTemplate=%7B%7Bbranch%7D%7D.127.0.0.1.nip.io' +
-  '&insecureSkipTlsVerify=1'
+  '&scheme=http&insecureSkipTlsVerify=1'
+
+/** The link a cluster published on a NON-default host port produces. */
+const CUSTOM_PORT_LINK = `${K3S_LINK}&ingressPort=18080`
+
+/** The link the CLI emits when it could NOT establish that the cluster serves ingress URLs. */
+const NO_INGRESS_LINK =
+  '?infraSetup=local-k3s&label=Local+k3s&apiServerUrl=https%3A%2F%2F127.0.0.1%3A6443' +
+  '&namespaceTemplate=cf-env-%7B%7BpullNumber%7D%7D&insecureSkipTlsVerify=1'
 
 describe('consumeK3sSetupDeepLink', () => {
   beforeEach(() => {
@@ -39,10 +47,44 @@ describe('consumeK3sSetupDeepLink', () => {
       apiServerUrl: 'https://127.0.0.1:6443',
       namespaceTemplate: 'cf-env-{{pullNumber}}',
       hostTemplate: '{{branch}}.127.0.0.1.nip.io',
+      ingressPort: '',
+      urlScheme: 'http',
       insecureSkipTlsVerify: true,
     })
   })
 
+  it('carries a non-default ingress port SEPARATELY from the host template', () => {
+    // The template is also the Ingress `host` a service's manifests declare, and Kubernetes rejects
+    // a `host` with a port, so the port cannot ride inside it.
+    const ui = createUiModals()
+    openWith(CUSTOM_PORT_LINK)
+    ui.consumeK3sSetupDeepLink()
+
+    expect(ui.k3sSetupPrefill.value?.ingressPort).toBe('18080')
+    expect(ui.k3sSetupPrefill.value?.hostTemplate).toBe('{{branch}}.127.0.0.1.nip.io')
+  })
+
+  it('strips the ingress-port param too, so a reload does not re-seed it', () => {
+    const ui = createUiModals()
+    openWith(CUSTOM_PORT_LINK)
+    ui.consumeK3sSetupDeepLink()
+    expect(window.location.search).toBe('')
+  })
+
+  it('carries NO host template when the CLI could not verify the cluster serves one', () => {
+    // The CLI omits the param rather than prefilling a template the cluster cannot serve; the
+    // form treats it as required, so an empty value is what stops an unserved URL being saved.
+    const ui = createUiModals()
+    openWith(NO_INGRESS_LINK)
+    ui.consumeK3sSetupDeepLink()
+
+    expect(ui.k3sSetupPrefill.value?.hostTemplate).toBe('')
+    expect(ui.k3sSetupPrefill.value?.ingressPort).toBe('')
+    expect(ui.k3sSetupPrefill.value?.urlScheme).toBeUndefined()
+    // The rest of the prefill still lands: a withheld field is not a withheld form.
+    expect(ui.k3sSetupPrefill.value?.apiServerUrl).toBe('https://127.0.0.1:6443')
+  })
+
   it('strips the params so a reload neither re-opens the window nor re-anchors it', () => {
     const ui = createUiModals()
     openWith(K3S_LINK)

package/app/stores/ui/modals.ts

@@ -33,7 +33,21 @@ export interface K3sSetupPrefill {
   label: string
   apiServerUrl: string
   namespaceTemplate: string
+  /**
+   * Empty when the CLI could not establish that the cluster serves an ingress-derived URL, in
+   * which case it deliberately omits the param so this form does NOT prefill a host template
+   * nothing would answer. The field is required for an `ingressTemplate` source, so an empty
+   * value stops the unserved promise being saved.
+   */
   hostTemplate: string
+  /**
+   * The verified host port, as typed into the form's port field, or empty for the scheme default.
+   * Kept out of `hostTemplate` because that value is also the Ingress `host` a service's manifests
+   * declare, and Kubernetes rejects a `host` with a port in it.
+   */
+  ingressPort: string
+  /** Scheme the CLI verified. Absent ⇒ the form keeps its own default. */
+  urlScheme?: 'http' | 'https'
   // Absent when the link omitted the param, so the form keeps its engine default rather than
   // forcing verification back on (which would break a self-signed local cluster).
   insecureSkipTlsVerify?: boolean
@@ -795,6 +809,14 @@ function createInfraModals(resetHubReturn: ResetHubReturn) {
       apiServerUrl: params.get('apiServerUrl') ?? '',
       namespaceTemplate: params.get('namespaceTemplate') ?? '',
       hostTemplate: params.get('hostTemplate') ?? '',
+      // The host port the controller answers on, when it is not the scheme's default. It rides its
+      // own param rather than the host template because the rendered template is also the Ingress
+      // `host` the manifests declare, and Kubernetes rejects a `host` carrying a port.
+      ingressPort: params.get('ingressPort') ?? '',
+      // A local ingress controller serves TLS with a self-signed cert, so the CLI verifies (and
+      // links) a plain-HTTP environment URL. Without this the form would keep its `https`
+      // default and save a URL that fails on the certificate rather than on the connection.
+      urlScheme: params.get('scheme') === 'http' ? 'http' : undefined,
       // Only carry the flag the link actually set — a missing param leaves the form's engine
       // default (skip-TLS on for a local self-signed cluster) untouched.
       insecureSkipTlsVerify: params.has('insecureSkipTlsVerify')
@@ -814,6 +836,8 @@ function createInfraModals(resetHubReturn: ResetHubReturn) {
       'apiServerUrl',
       'namespaceTemplate',
       'hostTemplate',
+      'ingressPort',
+      'scheme',
       'insecureSkipTlsVerify',
     ]) {
       params.delete(key)

package/i18n/locales/de.json

@@ -175,6 +175,7 @@
         "urlHttpRouteStatus": "HTTPRoute-Status (Gateway API)",
         "hostTemplate": "Host-Vorlage",
         "hostTemplateHelp": "Die Host-Vorlage, gerendert mit den Provisioning-Variablen (z. B. branch, sha).",
+        "ingressPortHelp": "Host-Port, auf dem der Ingress-Controller antwortet; leer bedeutet den Standardport des Schemas. Er gehört hierher und nicht in die Host-Vorlage, da ein Kubernetes-Ingress-Host keinen Port enthalten darf.",
         "ingressName": "Ingress-Name",
         "serviceName": "Service-Name",
         "port": "Port",
@@ -305,6 +306,7 @@
         "urlServiceStatus": "Service-Status lesen",
         "hostTemplate": "Host-Vorlage",
         "hostTemplateHelp": "Host-Vorlage, gerendert mit den Provisioning-Variablen wie branch und pullNumber; der gerenderte Host wird zur Umgebungs-URL.",
+        "ingressPortHelp": "Host-Port, auf dem der Ingress-Controller antwortet; leer bedeutet den Standardport des Schemas. Er gehört hierher und nicht in die Host-Vorlage, da ein Kubernetes-Ingress-Host keinen Port enthalten darf.",
         "ingressName": "Ingress-Name",
         "ingressNameHelp": "Ingress, aus dem der Load-Balancer-Host gelesen wird. Leer verwendet den einzigen angewendeten Ingress.",
         "serviceName": "Service-Name",

package/i18n/locales/en.json

@@ -2897,6 +2897,7 @@
         "urlHttpRouteStatus": "HTTPRoute status (Gateway API)",
         "hostTemplate": "Host template",
         "hostTemplateHelp": "The host template, rendered with the provision vars (e.g. branch, sha).",
+        "ingressPortHelp": "Host port the ingress controller answers on; empty means the scheme default. It belongs here rather than in the host template, because a Kubernetes Ingress host cannot carry a port.",
         "ingressName": "Ingress name",
         "serviceName": "Service name",
         "port": "Port",
@@ -3027,6 +3028,7 @@
         "urlServiceStatus": "Read Service status",
         "hostTemplate": "Host template",
         "hostTemplateHelp": "Host template rendered with the provision vars such as branch and pullNumber; the rendered host becomes the environment URL.",
+        "ingressPortHelp": "Host port the ingress controller answers on; empty means the scheme default. It belongs here rather than in the host template, because a Kubernetes Ingress host cannot carry a port.",
         "ingressName": "Ingress name",
         "ingressNameHelp": "Ingress to read the load-balancer host from. Empty uses the only Ingress applied.",
         "serviceName": "Service name",

package/i18n/locales/es.json

@@ -2821,6 +2821,7 @@
         "urlServiceStatus": "Leer estado del Service",
         "hostTemplate": "Plantilla de host",
         "hostTemplateHelp": "Plantilla de host renderizada con las variables de aprovisionamiento como branch y pullNumber; el host resultante se convierte en la URL del entorno.",
+        "ingressPortHelp": "Puerto del host en el que responde el controlador de ingress; vacío significa el puerto predeterminado del esquema. Va aquí y no en la plantilla de host, porque un host de Ingress de Kubernetes no puede llevar un puerto.",
         "ingressName": "Nombre del Ingress",
         "ingressNameHelp": "Ingress del que leer el host del balanceador. Vacío usa el único Ingress aplicado.",
         "serviceName": "Nombre del Service",
@@ -3663,6 +3664,7 @@
         "urlHttpRouteStatus": "Estado de HTTPRoute (Gateway API)",
         "hostTemplate": "Plantilla de host",
         "hostTemplateHelp": "La plantilla de host, renderizada con las variables de aprovisionamiento (p. ej. branch, sha).",
+        "ingressPortHelp": "Puerto del host en el que responde el controlador de ingress; vacío significa el puerto predeterminado del esquema. Va aquí y no en la plantilla de host, porque un host de Ingress de Kubernetes no puede llevar un puerto.",
         "ingressName": "Nombre del Ingress",
         "serviceName": "Nombre del Service",
         "port": "Puerto",

package/i18n/locales/fr.json

@@ -2821,6 +2821,7 @@
         "urlServiceStatus": "Lire l'état du Service",
         "hostTemplate": "Modèle d'hôte",
         "hostTemplateHelp": "Modèle d'hôte rendu avec les variables de provisionnement telles que branch et pullNumber ; l'hôte obtenu devient l'URL de l'environnement.",
+        "ingressPortHelp": "Port hôte sur lequel le contrôleur ingress répond ; vide signifie le port par défaut du schéma. Il se place ici et non dans le modèle d'hôte, car un hôte Ingress Kubernetes ne peut pas contenir de port.",
         "ingressName": "Nom de l'Ingress",
         "ingressNameHelp": "Ingress dont lire l'hôte du load-balancer. Vide utilise le seul Ingress appliqué.",
         "serviceName": "Nom du Service",
@@ -3663,6 +3664,7 @@
         "urlHttpRouteStatus": "Statut de l'HTTPRoute (Gateway API)",
         "hostTemplate": "Modèle d'hôte",
         "hostTemplateHelp": "Le modèle d'hôte, rendu avec les variables de provisionnement (p. ex. branch, sha).",
+        "ingressPortHelp": "Port hôte sur lequel le contrôleur ingress répond ; vide signifie le port par défaut du schéma. Il se place ici et non dans le modèle d'hôte, car un hôte Ingress Kubernetes ne peut pas contenir de port.",
         "ingressName": "Nom de l'Ingress",
         "serviceName": "Nom du Service",
         "port": "Port",

package/i18n/locales/he.json

@@ -2772,6 +2772,7 @@
         "urlHttpRouteStatus": "סטטוס HTTPRoute (Gateway API)",
         "hostTemplate": "תבנית מארח",
         "hostTemplateHelp": "תבנית המארח, מרונדרת עם משתני האספקה (לדוגמה branch, sha).",
+        "ingressPortHelp": "פורט המארח שבו בקר ה-Ingress עונה; ריק פירושו פורט ברירת המחדל של הסכימה. הוא שייך לכאן ולא לתבנית המארח, כי מארח Ingress של Kubernetes אינו יכול לכלול פורט.",
         "ingressName": "שם ה-Ingress",
         "serviceName": "שם ה-Service",
         "port": "פורט",
@@ -2902,6 +2903,7 @@
         "urlServiceStatus": "קרא סטטוס Service",
         "hostTemplate": "תבנית מארח",
         "hostTemplateHelp": "תבנית מארח שעוברת עיבוד עם משתני ההקצאה כגון branch ו-pullNumber; המארח המעובד הופך לכתובת הסביבה.",
+        "ingressPortHelp": "פורט המארח שבו בקר ה-Ingress עונה; ריק פירושו פורט ברירת המחדל של הסכימה. הוא שייך לכאן ולא לתבנית המארח, כי מארח Ingress של Kubernetes אינו יכול לכלול פורט.",
         "ingressName": "שם Ingress",
         "ingressNameHelp": "ה-Ingress שממנו לקרוא את מארח מאזן העומסים. ריק משתמש ב-Ingress היחיד שהוחל.",
         "serviceName": "שם Service",

package/i18n/locales/it.json

@@ -175,6 +175,7 @@
         "urlHttpRouteStatus": "Stato dell'HTTPRoute (Gateway API)",
         "hostTemplate": "Template dell'host",
         "hostTemplateHelp": "Il template dell'host, renderizzato con le variabili di provisioning (es. branch, sha).",
+        "ingressPortHelp": "Porta host su cui risponde il controller ingress; vuoto indica la porta predefinita dello schema. Va qui e non nel template dell'host, perché un host Ingress di Kubernetes non può contenere una porta.",
         "ingressName": "Nome dell'Ingress",
         "serviceName": "Nome del Service",
         "port": "Porta",
@@ -305,6 +306,7 @@
         "urlServiceStatus": "Leggi lo stato del Service",
         "hostTemplate": "Template dell'host",
         "hostTemplateHelp": "Template dell'host renderizzato con le variabili di provisioning come branch e pullNumber; l'host renderizzato diventa l'URL dell'ambiente.",
+        "ingressPortHelp": "Porta host su cui risponde il controller ingress; vuoto indica la porta predefinita dello schema. Va qui e non nel template dell'host, perché un host Ingress di Kubernetes non può contenere una porta.",
         "ingressName": "Nome dell'Ingress",
         "ingressNameHelp": "Ingress da cui leggere l'host del load balancer. Se vuoto, usa l'unico Ingress applicato.",
         "serviceName": "Nome del Service",

package/i18n/locales/ja.json

@@ -2772,6 +2772,7 @@
         "urlHttpRouteStatus": "HTTPRoute ステータス (Gateway API)",
         "hostTemplate": "ホストテンプレート",
         "hostTemplateHelp": "ホストテンプレート。プロビジョニング変数（例: branch、sha）で描画されます。",
+        "ingressPortHelp": "Ingress コントローラーが応答するホストポート。空の場合はスキームの既定ポートです。Kubernetes の Ingress host にはポートを含められないため、ホストテンプレートではなくここに指定します。",
         "ingressName": "Ingress 名",
         "serviceName": "Service 名",
         "port": "ポート",
@@ -2902,6 +2903,7 @@
         "urlServiceStatus": "Service ステータスを読み取る",
         "hostTemplate": "ホストテンプレート",
         "hostTemplateHelp": "branch や pullNumber などのプロビジョニング変数でレンダリングされるホストテンプレート。レンダリングされたホストが環境 URL になります。",
+        "ingressPortHelp": "Ingress コントローラーが応答するホストポート。空の場合はスキームの既定ポートです。Kubernetes の Ingress host にはポートを含められないため、ホストテンプレートではなくここに指定します。",
         "ingressName": "Ingress 名",
         "ingressNameHelp": "ロードバランサーのホストを読み取る Ingress。空の場合は適用された唯一の Ingress を使用します。",
         "serviceName": "Service 名",

package/i18n/locales/pl.json

@@ -2821,6 +2821,7 @@
         "urlServiceStatus": "Odczytaj stan Service",
         "hostTemplate": "Szablon hosta",
         "hostTemplateHelp": "Szablon hosta renderowany ze zmiennymi provisioningu, takimi jak branch i pullNumber; wynikowy host staje się URL-em środowiska.",
+        "ingressPortHelp": "Port hosta, na którym odpowiada kontroler ingress; puste oznacza domyślny port schematu. Należy podać go tutaj, a nie w szablonie hosta, ponieważ host Ingress w Kubernetes nie może zawierać portu.",
         "ingressName": "Nazwa Ingress",
         "ingressNameHelp": "Ingress, z którego odczytać host load-balancera. Puste używa jedynego zastosowanego Ingress.",
         "serviceName": "Nazwa Service",
@@ -3663,6 +3664,7 @@
         "urlHttpRouteStatus": "Status HTTPRoute (Gateway API)",
         "hostTemplate": "Szablon hosta",
         "hostTemplateHelp": "Szablon hosta renderowany ze zmiennymi provisioningu (np. branch, sha).",
+        "ingressPortHelp": "Port hosta, na którym odpowiada kontroler ingress; puste oznacza domyślny port schematu. Należy podać go tutaj, a nie w szablonie hosta, ponieważ host Ingress w Kubernetes nie może zawierać portu.",
         "ingressName": "Nazwa Ingress",
         "serviceName": "Nazwa Service",
         "port": "Port",

package/i18n/locales/tr.json

@@ -2772,6 +2772,7 @@
         "urlHttpRouteStatus": "HTTPRoute durumu (Gateway API)",
         "hostTemplate": "Ana bilgisayar şablonu",
         "hostTemplateHelp": "Sağlama değişkenleriyle (ör. branch, sha) işlenen ana bilgisayar şablonu.",
+        "ingressPortHelp": "Ingress denetleyicisinin yanıt verdiği ana bilgisayar portu; boş bırakılırsa şemanın varsayılan portu kullanılır. Kubernetes Ingress host değeri port içeremediği için burada, host şablonunda değil, belirtilir.",
         "ingressName": "Ingress adı",
         "serviceName": "Service adı",
         "port": "Bağlantı noktası",
@@ -2902,6 +2903,7 @@
         "urlServiceStatus": "Service durumunu oku",
         "hostTemplate": "Host şablonu",
         "hostTemplateHelp": "branch ve pullNumber gibi sağlama değişkenleriyle işlenen host şablonu; işlenen host, ortam URL'si olur.",
+        "ingressPortHelp": "Ingress denetleyicisinin yanıt verdiği ana bilgisayar portu; boş bırakılırsa şemanın varsayılan portu kullanılır. Kubernetes Ingress host değeri port içeremediği için burada, host şablonunda değil, belirtilir.",
         "ingressName": "Ingress adı",
         "ingressNameHelp": "Load balancer host'unun okunacağı Ingress. Boş bırakılırsa uygulanan tek Ingress kullanılır.",
         "serviceName": "Service adı",

package/i18n/locales/uk.json

@@ -2821,6 +2821,7 @@
         "urlServiceStatus": "Зчитати стан Service",
         "hostTemplate": "Шаблон хоста",
         "hostTemplateHelp": "Шаблон хоста, відрендерений зі змінними провіженингу, такими як branch і pullNumber; отриманий хост стає URL середовища.",
+        "ingressPortHelp": "Порт хоста, на якому відповідає контролер ingress; порожнє значення означає стандартний порт схеми. Його вказують тут, а не в шаблоні хоста, бо host в Ingress Kubernetes не може містити порт.",
         "ingressName": "Назва Ingress",
         "ingressNameHelp": "Ingress, з якого зчитати хост балансувальника. Порожнє використовує єдиний застосований Ingress.",
         "serviceName": "Назва Service",
@@ -3663,6 +3664,7 @@
         "urlHttpRouteStatus": "Статус HTTPRoute (Gateway API)",
         "hostTemplate": "Шаблон хоста",
         "hostTemplateHelp": "Шаблон хоста, відрендерений зі змінними провіженінгу (напр. branch, sha).",
+        "ingressPortHelp": "Порт хоста, на якому відповідає контролер ingress; порожнє значення означає стандартний порт схеми. Його вказують тут, а не в шаблоні хоста, бо host в Ingress Kubernetes не може містити порт.",
         "ingressName": "Назва Ingress",
         "serviceName": "Назва Service",
         "port": "Порт",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.261.4",
+  "version": "0.261.5",
   "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.41",
     "wretch": "^3.0.9",
-    "@cat-factory/contracts": "0.293.0"
+    "@cat-factory/contracts": "0.294.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",