@cat-factory/app 0.259.3 → 0.260.1

package/app/utils/settlingLoop.spec.ts

@@ -0,0 +1,236 @@
+import { describe, it, expect } from 'vitest'
+import { createSettlingLoop, type FrameScheduler } from './settlingLoop'
+
+/** A hand-driven frame clock: `flush()` runs exactly one scheduled frame. */
+function fakeScheduler() {
+  let nextHandle = 1
+  const pending = new Map<number, () => void>()
+  const scheduler: FrameScheduler = {
+    schedule(run) {
+      const handle = nextHandle++
+      pending.set(handle, run)
+      return handle
+    },
+    cancel(handle) {
+      pending.delete(handle)
+    },
+  }
+  return {
+    scheduler,
+    pending: () => pending.size,
+    /** Run every currently scheduled frame; frames they schedule wait for the next flush. */
+    flush() {
+      const due = [...pending.entries()]
+      pending.clear()
+      for (const [, run] of due) run()
+    },
+  }
+}
+
+describe('createSettlingLoop', () => {
+  it('does not run until poked', () => {
+    const clock = fakeScheduler()
+    let frames = 0
+    const loop = createSettlingLoop({
+      compute: () => {
+        frames++
+        return false
+      },
+      scheduler: clock.scheduler,
+      settleFrames: 3,
+    })
+
+    expect(loop.awake()).toBe(false)
+    clock.flush()
+    expect(frames).toBe(0)
+  })
+
+  it('keeps running while the output changes, and parks once it holds still', () => {
+    const clock = fakeScheduler()
+    let changed = true
+    let frames = 0
+    const loop = createSettlingLoop({
+      compute: () => {
+        frames++
+        return changed
+      },
+      scheduler: clock.scheduler,
+      settleFrames: 3,
+    })
+
+    loop.poke()
+    for (let i = 0; i < 10; i++) clock.flush()
+    expect(frames).toBe(10)
+    expect(loop.awake()).toBe(true)
+
+    // The animation ends: three unchanged frames later the loop is parked and the frame
+    // count stops moving no matter how many times the clock ticks.
+    changed = false
+    clock.flush()
+    clock.flush()
+    expect(loop.awake()).toBe(true)
+    clock.flush()
+    expect(loop.awake()).toBe(false)
+
+    const settledAt = frames
+    for (let i = 0; i < 10; i++) clock.flush()
+    expect(frames).toBe(settledAt)
+  })
+
+  it('runs the settle tail after a poke that changed nothing, then parks', () => {
+    const clock = fakeScheduler()
+    let frames = 0
+    const loop = createSettlingLoop({
+      compute: () => {
+        frames++
+        return false
+      },
+      scheduler: clock.scheduler,
+      settleFrames: 3,
+    })
+
+    // A signal fires one frame BEFORE the transition it starts produces geometry, so a wake
+    // that measures no change still owes the tail rather than parking immediately.
+    loop.poke()
+    clock.flush()
+    expect(loop.awake()).toBe(true)
+    clock.flush()
+    clock.flush()
+    expect(frames).toBe(3)
+    expect(loop.awake()).toBe(false)
+  })
+
+  it('wakes a parked loop again on the next poke', () => {
+    const clock = fakeScheduler()
+    let frames = 0
+    const loop = createSettlingLoop({
+      compute: () => {
+        frames++
+        return false
+      },
+      scheduler: clock.scheduler,
+      settleFrames: 1,
+    })
+
+    loop.poke()
+    clock.flush()
+    expect(loop.awake()).toBe(false)
+
+    loop.poke()
+    clock.flush()
+    expect(frames).toBe(2)
+  })
+
+  it('restarts the countdown on a poke without scheduling a second frame', () => {
+    const clock = fakeScheduler()
+    let frames = 0
+    const loop = createSettlingLoop({
+      compute: () => {
+        frames++
+        return false
+      },
+      scheduler: clock.scheduler,
+      settleFrames: 2,
+    })
+
+    loop.poke()
+    loop.poke()
+    loop.poke()
+    expect(clock.pending()).toBe(1)
+    clock.flush()
+    expect(frames).toBe(1)
+  })
+
+  it('does not schedule a second frame when the compute itself pokes', () => {
+    const clock = fakeScheduler()
+    let frames = 0
+    // A compute that writes to a store can wake watchers that poke back synchronously. That
+    // must reset the countdown, not double the frame rate.
+    const loop = createSettlingLoop({
+      compute: () => {
+        frames++
+        loop.poke()
+        return false
+      },
+      scheduler: clock.scheduler,
+      settleFrames: 2,
+    })
+
+    loop.poke()
+    for (let i = 0; i < 5; i++) {
+      expect(clock.pending()).toBe(1)
+      clock.flush()
+    }
+    expect(frames).toBe(5)
+  })
+
+  it('parks a throwing compute so a later poke still wakes it', () => {
+    const clock = fakeScheduler()
+    let frames = 0
+    let broken = true
+    const loop = createSettlingLoop({
+      compute: () => {
+        frames++
+        if (broken) throw new Error('measured a card that just unmounted')
+        return false
+      },
+      scheduler: clock.scheduler,
+      settleFrames: 3,
+    })
+
+    // The frame the throw escaped from is already spent. Staying awake would leave the loop
+    // holding a stream it can never schedule on again, and every later poke a no-op.
+    loop.poke()
+    expect(() => clock.flush()).toThrow('measured a card that just unmounted')
+    expect(loop.awake()).toBe(false)
+    expect(clock.pending()).toBe(0)
+
+    broken = false
+    loop.poke()
+    clock.flush()
+    expect(frames).toBe(2)
+    expect(loop.awake()).toBe(true)
+  })
+
+  it('stays parked when the compute stops the loop', () => {
+    const clock = fakeScheduler()
+    let frames = 0
+    // A compute whose store write unmounts the board runs `stop()` from inside the frame it
+    // is halfway through. The frame it was about to schedule must not resurrect it.
+    const loop = createSettlingLoop({
+      compute: () => {
+        frames++
+        loop.stop()
+        return true
+      },
+      scheduler: clock.scheduler,
+      settleFrames: 3,
+    })
+
+    loop.poke()
+    clock.flush()
+    expect(loop.awake()).toBe(false)
+    expect(clock.pending()).toBe(0)
+    clock.flush()
+    expect(frames).toBe(1)
+  })
+
+  it('drops the pending frame on stop', () => {
+    const clock = fakeScheduler()
+    let frames = 0
+    const loop = createSettlingLoop({
+      compute: () => {
+        frames++
+        return true
+      },
+      scheduler: clock.scheduler,
+      settleFrames: 3,
+    })
+
+    loop.poke()
+    loop.stop()
+    expect(loop.awake()).toBe(false)
+    clock.flush()
+    expect(frames).toBe(0)
+  })
+})

package/app/utils/settlingLoop.ts

@@ -0,0 +1,101 @@
+/**
+ * A frame loop that stops itself once its output stops changing.
+ *
+ * The board's DOM-measuring drivers (dependency edges, task expansion) have to follow
+ * animations they cannot observe directly: a CSS height transition, a Vue Flow pan, a card
+ * reflowing after its text changed. Running them unconditionally every frame makes an idle
+ * board pay O(edges) forced layout reads 60 times a second; running them only on a change
+ * signal makes them stop mid-transition, because the signal fires when the transition
+ * STARTS and says nothing about the frames that follow.
+ *
+ * This resolves both: an external signal `poke()`s the loop awake, and the loop keeps
+ * running while `compute()` reports it changed something. Once the output has held still
+ * for `settleFrames` frames the animation is over and the loop parks at zero cost until the
+ * next poke.
+ *
+ * The scheduler is injected so the behaviour is testable without a browser frame clock.
+ */
+
+/** `requestAnimationFrame` / `cancelAnimationFrame`, injected so tests can drive frames by hand. */
+export type FrameScheduler = {
+  schedule: (run: () => void) => number
+  cancel: (handle: number) => void
+}
+
+export type SettlingLoop = {
+  /** Wake the loop, and reset the settle countdown if it is already awake. */
+  poke: () => void
+  /** Park the loop and drop the pending frame. Idempotent. */
+  stop: () => void
+  /**
+   * Whether the loop still owns the frame stream: a frame is scheduled, or `compute()` is
+   * running right now. The two are deliberately not the same fact, and only this one decides
+   * whether a `poke()` has to schedule anything.
+   */
+  awake: () => boolean
+}
+
+/**
+ * How many unchanged frames end a run. A signal fires when a style or class changes, one
+ * frame BEFORE the transition it starts produces any geometry, so parking on the first
+ * unchanged frame would miss every animation. Four frames (~66ms at 60Hz) clears that gap
+ * while keeping a false wake-up cheap.
+ */
+export const DEFAULT_SETTLE_FRAMES = 4
+
+export function createSettlingLoop(options: {
+  /** Runs one frame; returns whether it changed anything the user can see. */
+  compute: () => boolean
+  scheduler: FrameScheduler
+  settleFrames?: number
+}): SettlingLoop {
+  const { compute, scheduler } = options
+  const settleFrames = options.settleFrames ?? DEFAULT_SETTLE_FRAMES
+  /** The scheduled frame's handle, and ONLY that: null the whole time `compute()` runs. */
+  let pending: number | null = null
+  /** Whether the loop owns the frame stream, which stays true across `compute()`. */
+  let isAwake = false
+  let unchangedFrames = 0
+
+  function frame() {
+    // This callback's own handle is spent the moment it runs, so nothing may cancel it later;
+    // `isAwake` is what carries "the loop is running" across the compute below.
+    pending = null
+    let changed: boolean
+    try {
+      changed = compute()
+    } catch (error) {
+      // Park before letting the error reach the frame callback, where the browser reports it.
+      // Staying awake with no frame scheduled would make every later `poke()` a no-op, so one
+      // throwing frame would freeze the board for the rest of the session; rescheduling would
+      // be worse still, since a compute that threw on this frame throws on the next one too
+      // and a 60Hz error storm costs more than an arrow that waits for the next pulse.
+      isAwake = false
+      throw error
+    }
+    // A `stop()` that ran during `compute()` (an unmount driven by the compute's own store
+    // write) parks the loop for good: it must not be resurrected by the frame below.
+    if (!isAwake) return
+    unchangedFrames = changed ? 0 : unchangedFrames + 1
+    if (unchangedFrames < settleFrames) pending = scheduler.schedule(frame)
+    else isAwake = false
+  }
+
+  return {
+    poke() {
+      unchangedFrames = 0
+      // A poke triggered by the compute's own store write (a watcher, a re-render) resets the
+      // countdown and nothing more: `isAwake` is still set, so it cannot schedule a second
+      // frame beside the one `frame()` is about to schedule itself.
+      if (isAwake) return
+      isAwake = true
+      pending = scheduler.schedule(frame)
+    },
+    stop() {
+      isAwake = false
+      if (pending !== null) scheduler.cancel(pending)
+      pending = null
+    },
+    awake: () => isAwake,
+  }
+}

package/i18n/locales/de.json

@@ -3403,6 +3403,9 @@
       "monorepoBrowseHint": "Durchsuchen Sie das Repository und wählen Sie die Verzeichnisse der Services aus, die Sie hinzufügen möchten – aus jedem beliebigen Ordner. Agents, die an einem Service arbeiten, laufen innerhalb seines Unterverzeichnisses.",
       "selectedServices": "Ausgewählte Services",
       "noServicesSelected": "Noch keine Services ausgewählt. Wählen Sie oben Verzeichnisse aus.",
+      "frontendLabel": "Frontend-App (optional)",
+      "frontendHint": "Markieren Sie eines der ausgewählten Verzeichnisse als Frontend für die übrigen. Es wird als Frontend-App angelegt, auf dieses Unterverzeichnis festgelegt und mit jedem daneben hinzugefügten Backend-Service verknüpft. Die Umgebungsvariablen für die Backend-URLs benennen Sie anschließend im Inspector des Frontends.",
+      "frontendNone": "Keines: alle Auswahlen sind Backend-Services",
       "addServices": "{count} Service hinzufügen | {count} Services hinzufügen",
       "removeService": "{directory} entfernen",
       "addedConfigure": "{title} hinzugefügt, konfigurieren Sie es",
@@ -3416,7 +3419,9 @@
         "addedDescription": "{title} ist auf dem Board, konfigurieren Sie es unten.",
         "addFailedTitle": "Service konnte nicht hinzugefügt werden",
         "servicesAddedTitle": "Services hinzugefügt",
-        "servicesAddedDescription": "{count} Service zum Board hinzugefügt. | {count} Services zum Board hinzugefügt."
+        "servicesAddedDescription": "{count} Service zum Board hinzugefügt. | {count} Services zum Board hinzugefügt.",
+        "frontendLinkedNote": "{directory} wurde als Frontend hinzugefügt und mit den übrigen verknüpft. Benennen Sie die Umgebungsvariablen für die Backend-URLs im Inspector.",
+        "frontendWiringFailedNote": "Die Frontend-Einstellungen wurden nicht gespeichert. Öffnen Sie den Inspector jeder Frontend-App, um ihr Unterverzeichnis und ihre Backend-Services zu setzen."
       }
     },
     "repoTree": {

package/i18n/locales/en.json

@@ -4271,6 +4271,9 @@
       "monorepoBrowseHint": "Browse the repository and select the directories of the services you want to add — from any folder. Agents working on a service run within its subdirectory.",
       "selectedServices": "Selected services",
       "noServicesSelected": "No services selected yet. Pick directories above.",
+      "frontendLabel": "Frontend app (optional)",
+      "frontendHint": "Mark one of the selected directories as the frontend for the rest. It is added as a frontend app pinned to that subdirectory and linked to every backend service added beside it. Name each backend URL environment variable afterwards in the frontend's inspector.",
+      "frontendNone": "None: every selection is a backend service",
       "addServices": "Add {count} service | Add {count} services",
       "@addServices": {
         "description": "Count-driven button label; resolved via t(key, { count }, count) so {count} also drives the plural choice. Provide ALL plural forms your language needs (English has 2; Polish/Ukrainian need 3 - one/few/many - via the custom pluralRules in i18n.config.ts)."
@@ -4290,7 +4293,9 @@
         "servicesAddedDescription": "{count} service added to the board. | {count} services added to the board.",
         "@servicesAddedDescription": {
           "description": "Count-driven toast; resolved via t(key, { count }, count) so {count} also drives the plural choice. Provide ALL plural forms your language needs (Polish/Ukrainian need 3 - one/few/many)."
-        }
+        },
+        "frontendLinkedNote": "{directory} was added as the frontend and linked to the others. Name its backend URL environment variables in its inspector.",
+        "frontendWiringFailedNote": "The frontend settings did not save. Open each frontend app's inspector to set its subdirectory and its backend services."
       }
     },
     "repoTree": {

package/i18n/locales/es.json

@@ -4138,6 +4138,9 @@
       "monorepoBrowseHint": "Explora el repositorio y selecciona los directorios de los servicios que quieres añadir, de cualquier carpeta. Los agentes que trabajen en un servicio se ejecutarán dentro de su subdirectorio.",
       "selectedServices": "Servicios seleccionados",
       "noServicesSelected": "Aún no hay servicios seleccionados. Elige directorios arriba.",
+      "frontendLabel": "Aplicación frontend (opcional)",
+      "frontendHint": "Marca uno de los directorios seleccionados como el frontend de los demás. Se añade como aplicación frontend anclada a ese subdirectorio y se enlaza con cada servicio backend añadido junto a él. Después, asigna en el inspector del frontend el nombre de cada variable de entorno con la URL del backend.",
+      "frontendNone": "Ninguno: todas las selecciones son servicios backend",
       "addServices": "Añadir {count} servicio | Añadir {count} servicios",
       "removeService": "Quitar {directory}",
       "addedConfigure": "{title} añadido, configúralo",
@@ -4151,7 +4154,9 @@
         "addedDescription": "{title} está en el tablero, configúralo abajo.",
         "addFailedTitle": "No se pudo añadir el servicio",
         "servicesAddedTitle": "Servicios añadidos",
-        "servicesAddedDescription": "{count} servicio añadido al tablero. | {count} servicios añadidos al tablero."
+        "servicesAddedDescription": "{count} servicio añadido al tablero. | {count} servicios añadidos al tablero.",
+        "frontendLinkedNote": "{directory} se añadió como frontend y se enlazó con los demás. Asigna el nombre de sus variables de entorno con las URL de backend en su inspector.",
+        "frontendWiringFailedNote": "Los ajustes del frontend no se guardaron. Abre el inspector de cada aplicación frontend para definir su subdirectorio y sus servicios backend."
       },
       "repoType": "Tipo de repositorio",
       "repoTypeHint": "Qué es este repositorio: un servicio backend, una aplicación frontend, una biblioteca compartida o un repositorio de documentación (solo documentos/spikes)."

package/i18n/locales/fr.json

@@ -4138,6 +4138,9 @@
       "monorepoBrowseHint": "Parcourez le dépôt et sélectionnez les répertoires des services que vous voulez ajouter, depuis n'importe quel dossier. Les agents travaillant sur un service s'exécutent dans son sous-répertoire.",
       "selectedServices": "Services sélectionnés",
       "noServicesSelected": "Aucun service sélectionné pour le moment. Choisissez des répertoires ci-dessus.",
+      "frontendLabel": "Application frontend (facultatif)",
+      "frontendHint": "Désignez l'un des répertoires sélectionnés comme le frontend des autres. Il est ajouté en tant qu'application frontend rattachée à ce sous-répertoire et relié à chaque service backend ajouté à ses côtés. Nommez ensuite chaque variable d'environnement d'URL backend dans l'inspecteur du frontend.",
+      "frontendNone": "Aucun : toutes les sélections sont des services backend",
       "addServices": "Ajouter {count} service | Ajouter {count} services",
       "removeService": "Retirer {directory}",
       "addedConfigure": "{title} ajouté, configurez-le",
@@ -4151,7 +4154,9 @@
         "addedDescription": "{title} est sur le tableau, configurez-le ci-dessous.",
         "addFailedTitle": "Impossible d'ajouter le service",
         "servicesAddedTitle": "Services ajoutés",
-        "servicesAddedDescription": "{count} service ajouté au tableau. | {count} services ajoutés au tableau."
+        "servicesAddedDescription": "{count} service ajouté au tableau. | {count} services ajoutés au tableau.",
+        "frontendLinkedNote": "{directory} a été ajouté comme frontend et relié aux autres. Nommez ses variables d'environnement d'URL backend dans son inspecteur.",
+        "frontendWiringFailedNote": "Les réglages du frontend n'ont pas été enregistrés. Ouvrez l'inspecteur de chaque application frontend pour définir son sous-répertoire et ses services backend."
       },
       "repoType": "Type de dépôt",
       "repoTypeHint": "Ce qu'est ce dépôt : un service backend, une application frontend, une bibliothèque partagée ou un dépôt de documentation (documents/spikes uniquement)."

package/i18n/locales/he.json

@@ -4138,6 +4138,9 @@
       "monorepoBrowseHint": "עיין במאגר ובחר את הספריות של השירותים שברצונך להוסיף — מכל תיקייה. סוכנים העובדים על שירות ירוצו בתוך תת-הספרייה שלו.",
       "selectedServices": "שירותים נבחרים",
       "noServicesSelected": "עדיין לא נבחרו שירותים. בחר ספריות למעלה.",
+      "frontendLabel": "אפליקציית פרונט-אנד (אופציונלי)",
+      "frontendHint": "סמן אחת מהספריות שנבחרו כפרונט-אנד עבור השאר. היא תתווסף כאפליקציית פרונט-אנד המוצמדת לתת-הספרייה הזו ותקושר לכל שירות בק-אנד שנוסף לצידה. את שמות משתני הסביבה של כתובות הבק-אנד הגדר לאחר מכן באינספקטור של הפרונט-אנד.",
+      "frontendNone": "ללא: כל הבחירות הן שירותי בק-אנד",
       "addServices": "הוסף שירות אחד | הוסף שני שירותים | הוסף {count} שירותים",
       "removeService": "הסר {directory}",
       "addedConfigure": "{title} נוסף, הגדר אותו",
@@ -4151,7 +4154,9 @@
         "addedDescription": "{title} על הלוח, הגדר אותו למטה.",
         "addFailedTitle": "לא ניתן היה להוסיף שירות",
         "servicesAddedTitle": "השירותים נוספו",
-        "servicesAddedDescription": "שירות אחד נוסף ללוח. | שני שירותים נוספו ללוח. | {count} שירותים נוספו ללוח."
+        "servicesAddedDescription": "שירות אחד נוסף ללוח. | שני שירותים נוספו ללוח. | {count} שירותים נוספו ללוח.",
+        "frontendLinkedNote": "{directory} נוספה כפרונט-אנד וקושרה לשאר. הגדר את שמות משתני הסביבה של כתובות הבק-אנד באינספקטור שלה.",
+        "frontendWiringFailedNote": "הגדרות הפרונט-אנד לא נשמרו. פתח את האינספקטור של כל אפליקציית פרונט-אנד כדי להגדיר את תת-הספרייה ואת שירותי הבק-אנד שלה."
       },
       "repoType": "סוג המאגר",
       "repoTypeHint": "מה המאגר הזה: שירות בק-אנד, אפליקציית פרונט-אנד, ספרייה משותפת או מאגר תיעוד (מסמכים/ספייקים בלבד)."

package/i18n/locales/it.json

@@ -3403,6 +3403,9 @@
       "monorepoBrowseHint": "Sfoglia il repository e seleziona le directory dei servizi che vuoi aggiungere, da qualsiasi cartella. Gli agenti che lavorano su un servizio verranno eseguiti all'interno della sua sottodirectory.",
       "selectedServices": "Servizi selezionati",
       "noServicesSelected": "Nessun servizio ancora selezionato. Scegli le directory sopra.",
+      "frontendLabel": "App frontend (facoltativo)",
+      "frontendHint": "Indica una delle directory selezionate come frontend delle altre. Viene aggiunta come app frontend ancorata a quella sottodirectory e collegata a ogni servizio backend aggiunto accanto. Assegna poi il nome a ciascuna variabile d'ambiente con l'URL del backend nell'inspector del frontend.",
+      "frontendNone": "Nessuna: tutte le selezioni sono servizi backend",
       "addServices": "Aggiungi {count} servizio | Aggiungi {count} servizi",
       "removeService": "Rimuovi {directory}",
       "addedConfigure": "{title} aggiunto, configuralo",
@@ -3416,7 +3419,9 @@
         "addedDescription": "{title} è sulla board, configuralo qui sotto.",
         "addFailedTitle": "Impossibile aggiungere il servizio",
         "servicesAddedTitle": "Servizi aggiunti",
-        "servicesAddedDescription": "{count} servizio aggiunto alla board. | {count} servizi aggiunti alla board."
+        "servicesAddedDescription": "{count} servizio aggiunto alla board. | {count} servizi aggiunti alla board.",
+        "frontendLinkedNote": "{directory} è stata aggiunta come frontend e collegata alle altre. Assegna il nome alle sue variabili d'ambiente con gli URL dei backend nel suo inspector.",
+        "frontendWiringFailedNote": "Le impostazioni del frontend non sono state salvate. Apri l'inspector di ogni app frontend per impostarne la sottodirectory e i servizi backend."
       }
     },
     "repoTree": {

package/i18n/locales/ja.json

@@ -4138,6 +4138,9 @@
       "monorepoBrowseHint": "リポジトリを参照し、追加したいサービスのディレクトリを任意のフォルダから選択してください。サービスで作業するエージェントは、そのサブディレクトリ内で実行されます。",
       "selectedServices": "選択したサービス",
       "noServicesSelected": "サービスがまだ選択されていません。上でディレクトリを選択してください。",
+      "frontendLabel": "フロントエンドアプリ（任意）",
+      "frontendHint": "選択したディレクトリのいずれか1つを、残りのフロントエンドとして指定します。そのサブディレクトリに固定されたフロントエンドアプリとして追加され、一緒に追加される各バックエンドサービスにリンクされます。バックエンドURLの環境変数名は、あとでフロントエンドのインスペクターで設定してください。",
+      "frontendNone": "なし: 選択はすべてバックエンドサービス",
       "addServices": "{count}件のサービスを追加 | {count}件のサービスを追加",
       "removeService": "{directory} を削除",
       "addedConfigure": "{title}を追加しました。設定してください",
@@ -4151,7 +4154,9 @@
         "addedDescription": "{title}がボードに追加されました。以下で設定してください。",
         "addFailedTitle": "サービスを追加できませんでした",
         "servicesAddedTitle": "サービスを追加しました",
-        "servicesAddedDescription": "{count}件のサービスをボードに追加しました。 | {count}件のサービスをボードに追加しました。"
+        "servicesAddedDescription": "{count}件のサービスをボードに追加しました。 | {count}件のサービスをボードに追加しました。",
+        "frontendLinkedNote": "{directory} をフロントエンドとして追加し、ほかのサービスにリンクしました。バックエンドURLの環境変数名はインスペクターで設定してください。",
+        "frontendWiringFailedNote": "フロントエンドの設定を保存できませんでした。各フロントエンドアプリのインスペクターを開き、サブディレクトリとバックエンドサービスを設定してください。"
       },
       "repoType": "リポジトリの種類",
       "repoTypeHint": "このリポジトリの種類: バックエンドサービス、フロントエンドアプリ、共有ライブラリ、またはドキュメントリポジトリ（ドキュメント/スパイクのみ）。"

package/i18n/locales/pl.json

@@ -4138,6 +4138,9 @@
       "monorepoBrowseHint": "Przeglądaj repozytorium i wybierz katalogi usług, które chcesz dodać — z dowolnego folderu. Agenci pracujący nad usługą działają w obrębie jej podkatalogu.",
       "selectedServices": "Wybrane usługi",
       "noServicesSelected": "Nie wybrano jeszcze żadnych usług. Wybierz katalogi powyżej.",
+      "frontendLabel": "Aplikacja frontendowa (opcjonalnie)",
+      "frontendHint": "Oznacz jeden z wybranych katalogów jako frontend dla pozostałych. Zostanie dodany jako aplikacja frontendowa przypięta do tego podkatalogu i powiązany z każdą usługą backendową dodaną obok. Nazwy zmiennych środowiskowych z adresami URL backendów uzupełnij następnie w inspektorze frontendu.",
+      "frontendNone": "Brak: wszystkie wybrane pozycje to usługi backendowe",
       "addServices": "Dodaj {count} usługę | Dodaj {count} usługi | Dodaj {count} usług",
       "removeService": "Usuń {directory}",
       "addedConfigure": "Dodano {title}, skonfiguruj",
@@ -4151,7 +4154,9 @@
         "addedDescription": "{title} jest na tablicy, skonfiguruj ją poniżej.",
         "addFailedTitle": "Nie udało się dodać usługi",
         "servicesAddedTitle": "Dodano usługi",
-        "servicesAddedDescription": "Dodano {count} usługę do tablicy. | Dodano {count} usługi do tablicy. | Dodano {count} usług do tablicy."
+        "servicesAddedDescription": "Dodano {count} usługę do tablicy. | Dodano {count} usługi do tablicy. | Dodano {count} usług do tablicy.",
+        "frontendLinkedNote": "{directory} dodano jako frontend i powiązano z pozostałymi. Nazwy jego zmiennych środowiskowych z adresami URL backendów uzupełnij w inspektorze.",
+        "frontendWiringFailedNote": "Ustawienia frontendu nie zostały zapisane. Otwórz inspektor każdej aplikacji frontendowej, aby ustawić jej podkatalog i usługi backendowe."
       },
       "repoType": "Typ repozytorium",
       "repoTypeHint": "Czym jest to repozytorium: usługą backendową, aplikacją frontendową, współdzieloną biblioteką lub repozytorium dokumentacji (tylko dokumenty/spike'i)."

package/i18n/locales/tr.json

@@ -4138,6 +4138,9 @@
       "monorepoBrowseHint": "Depoyu inceleyin ve eklemek istediğiniz servislerin dizinlerini herhangi bir klasörden seçin. Bir servis üzerinde çalışan ajanlar onun alt dizininde çalışır.",
       "selectedServices": "Seçili servisler",
       "noServicesSelected": "Henüz servis seçilmedi. Yukarıdan dizin seçin.",
+      "frontendLabel": "Frontend uygulaması (isteğe bağlı)",
+      "frontendHint": "Seçtiğiniz dizinlerden birini diğerlerinin frontend uygulaması olarak işaretleyin. O alt dizine sabitlenmiş bir frontend uygulaması olarak eklenir ve yanında eklenen her backend servisine bağlanır. Backend URL ortam değişkenlerinin adlarını sonrasında frontend’in inspector’ında girin.",
+      "frontendNone": "Yok: tüm seçimler backend servisidir",
       "addServices": "{count} servis ekle | {count} servis ekle",
       "removeService": "{directory} öğesini kaldır",
       "addedConfigure": "{title} eklendi, yapılandırın",
@@ -4151,7 +4154,9 @@
         "addedDescription": "{title} panoda, aşağıdan yapılandırın.",
         "addFailedTitle": "Servis eklenemedi",
         "servicesAddedTitle": "Servisler eklendi",
-        "servicesAddedDescription": "{count} servis panoya eklendi. | {count} servis panoya eklendi."
+        "servicesAddedDescription": "{count} servis panoya eklendi. | {count} servis panoya eklendi.",
+        "frontendLinkedNote": "{directory} frontend olarak eklendi ve diğerlerine bağlandı. Backend URL ortam değişkenlerinin adlarını inspector’ında girin.",
+        "frontendWiringFailedNote": "Frontend ayarları kaydedilmedi. Alt dizinini ve backend servislerini ayarlamak için her frontend uygulamasının inspector’ını açın."
       },
       "repoType": "Depo türü",
       "repoTypeHint": "Bu deponun türü: bir backend servisi, bir frontend uygulaması, paylaşılan bir kütüphane veya bir doküman deposu (yalnızca doküman/spike)."

package/i18n/locales/uk.json

@@ -4138,6 +4138,9 @@
       "monorepoBrowseHint": "Перегляньте репозиторій і виберіть каталоги сервісів, які хочете додати — з будь-якої папки. Агенти, що працюють над сервісом, виконуються в межах його підкаталогу.",
       "selectedServices": "Вибрані сервіси",
       "noServicesSelected": "Сервіси ще не вибрано. Виберіть каталоги вище.",
+      "frontendLabel": "Фронтенд-застосунок (необовʼязково)",
+      "frontendHint": "Позначте один із вибраних каталогів як фронтенд для решти. Його буде додано як фронтенд-застосунок, закріплений за цим підкаталогом, і повʼязано з кожним бекенд-сервісом, доданим поруч. Назви змінних середовища з URL бекендів потім вкажіть в інспекторі фронтенду.",
+      "frontendNone": "Немає: усі вибрані позиції є бекенд-сервісами",
       "addServices": "Додати {count} сервіс | Додати {count} сервіси | Додати {count} сервісів",
       "removeService": "Видалити {directory}",
       "addedConfigure": "{title} додано, налаштуйте",
@@ -4151,7 +4154,9 @@
         "addedDescription": "{title} на дошці, налаштуйте його нижче.",
         "addFailedTitle": "Не вдалося додати сервіс",
         "servicesAddedTitle": "Сервіси додано",
-        "servicesAddedDescription": "Додано {count} сервіс до дошки. | Додано {count} сервіси до дошки. | Додано {count} сервісів до дошки."
+        "servicesAddedDescription": "Додано {count} сервіс до дошки. | Додано {count} сервіси до дошки. | Додано {count} сервісів до дошки.",
+        "frontendLinkedNote": "{directory} додано як фронтенд і повʼязано з рештою. Вкажіть назви його змінних середовища з URL бекендів в інспекторі.",
+        "frontendWiringFailedNote": "Налаштування фронтенду не збережено. Відкрийте інспектор кожного фронтенд-застосунку, щоб указати його підкаталог і бекенд-сервіси."
       },
       "repoType": "Тип репозиторію",
       "repoTypeHint": "Що це за репозиторій: бекенд-сервіс, фронтенд-застосунок, спільна бібліотека або репозиторій документації (лише документи/спайки)."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.259.3",
+  "version": "0.260.1",
   "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.290.0"
+    "@cat-factory/contracts": "0.291.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",