@cat-factory/app 0.200.2 → 0.200.4

package/app/components/foundational/FoundationalServiceSources.vue

@@ -1,15 +1,21 @@
 <script setup lang="ts">
 // Repo sources of foundational-service definitions (backend/docs/adr/0031-foundational-services.md).
-// Two link shapes, and the choice is the whole reason this form has a mode switch:
+// Three link shapes, and the choice is the whole reason this form has a mode switch:
 //   - `directory` — every immediate subdirectory of the linked path is a service, identified by
 //     its `service.md`, with its contract files beside it. The "we keep our specs in a repo" case.
+//   - `folder`    — the whole of one folder (optionally its subfolders too) is the contract set of
+//     the ONE service the link names. The "here is our spec directory" case.
 //   - `files`     — an explicit list of contract files, all describing the ONE service the link
-//     names. The "just point at my openapi.yaml" case, where there is no directory convention to
-//     adopt — which is why the link itself must supply the identity, and the form demands it.
+//     names. The "just point at my openapi.yaml" case.
+// `folder` and `files` both name their service on the link (there is no `service.md` convention to
+// read identity from, which is why the form demands it), and differ in WHEN the file set is
+// decided: `files` pins the paths, `folder` rediscovers them on every sync — so a spec directory
+// that grows wants the folder shape.
 // Mirrors the skill library's sources UI: with the GitHub App connected the user searches a repo
 // and browses to a path; otherwise the manual owner/name fields are the fallback.
 import { computed, reactive, ref, watch } from 'vue'
 import type {
+  FolderScanCoverage,
   FoundationalServiceOwnerKind,
   FoundationalServiceSourceMode,
   GitHubAvailableRepo,
@@ -63,6 +69,7 @@ const mode = ref<FoundationalServiceSourceMode>('directory')
 const repoId = ref<number | undefined>(undefined)
 const repo = ref<GitHubAvailableRepo | undefined>(undefined)
 const dirPath = ref<string | undefined>(undefined)
+const recursive = ref(false)
 const filePaths = ref<string[]>([])
 const gitRef = ref('')
 const manual = reactive({ repoOwner: '', repoName: '', dirPath: '', filePaths: '' })
@@ -77,9 +84,34 @@ watch(repoId, () => {
 
 const modeItems = computed(() => [
   { value: 'directory' as const, label: t('foundational.sources.mode.directory') },
+  { value: 'folder' as const, label: t('foundational.sources.mode.folder') },
   { value: 'files' as const, label: t('foundational.sources.mode.files') },
 ])
 
+// An exhaustive Record of STATIC literal keys, not a key assembled from `mode` — the typed-key
+// check cannot see a runtime-built key, and this fails to compile the day a fourth mode lands.
+const modeHints = computed<Record<FoundationalServiceSourceMode, string>>(() => ({
+  directory: t('foundational.sources.mode.directoryHint'),
+  folder: t('foundational.sources.mode.folderHint'),
+  files: t('foundational.sources.mode.filesHint'),
+}))
+
+/**
+ * What a folder scan's coverage adds to the sync toast, or null when there is nothing to say.
+ *
+ * An exhaustive Record over the union rather than an `if` per state: `complete` having no note
+ * is then a written-down decision, and a fourth coverage value fails to compile until someone
+ * decides whether it needs one.
+ */
+const folderScanNotes = computed<Record<FolderScanCoverage, string | null>>(() => ({
+  complete: null,
+  truncated: t('foundational.toast.syncTruncated'),
+  missing: t('foundational.toast.syncFolderMissing'),
+}))
+
+/** Both single-service modes name their service on the link; only `files` enumerates paths. */
+const namesService = computed(() => mode.value === 'folder' || mode.value === 'files')
+
 const ownerName = computed<{ owner: string; name: string } | null>(() => {
   if (githubReady.value) {
     return repo.value ? { owner: repo.value.owner, name: repo.value.name } : null
@@ -99,18 +131,20 @@ const linkedFiles = computed(() =>
         .filter(Boolean),
 )
 
-// A `files` source names the service its files describe — the backend refuses the link
-// otherwise, so the button is disabled rather than letting the user discover it as a 422.
+// A `folder`/`files` source names the service its contracts describe — the backend refuses the
+// link otherwise, so the button is disabled rather than letting the user discover it as a 422.
 const valid = computed(() => {
   if (!ownerName.value) return false
-  if (mode.value !== 'files') return true
-  return Boolean(named.serviceId.trim() && named.serviceName.trim() && linkedFiles.value.length)
+  if (!namesService.value) return true
+  if (!named.serviceId.trim() || !named.serviceName.trim()) return false
+  return mode.value !== 'files' || linkedFiles.value.length > 0
 })
 
 function resetDraft() {
   repoId.value = undefined
   repo.value = undefined
   dirPath.value = undefined
+  recursive.value = false
   filePaths.value = []
   gitRef.value = ''
   Object.assign(manual, { repoOwner: '', repoName: '', dirPath: '', filePaths: '' })
@@ -134,9 +168,10 @@ async function link() {
       gitRef: gitRef.value.trim() || undefined,
       mode: mode.value,
       dirPath: (githubReady.value ? dirPath.value : manual.dirPath.trim()) || undefined,
-      ...(mode.value === 'files'
+      ...(mode.value === 'folder' ? { recursive: recursive.value } : {}),
+      ...(mode.value === 'files' ? { filePaths: linkedFiles.value } : {}),
+      ...(namesService.value
         ? {
-            filePaths: linkedFiles.value,
             serviceId: named.serviceId.trim(),
             serviceName: named.serviceName.trim(),
             serviceSummary: named.serviceSummary.trim() || undefined,
@@ -157,13 +192,25 @@ async function sync(id: string) {
   await withRow(`sync:${id}`, async () => {
     try {
       const result = await catalog.syncSource(id)
+      // A folder link that quietly produced fewer contracts than its author expected has no
+      // other explanation available to them, so the losses ride the same toast as the counts.
+      const notes: string[] = []
+      if (result.skippedFiles > 0)
+        notes.push(
+          t('foundational.toast.syncSkipped', { count: result.skippedFiles }, result.skippedFiles),
+        )
+      const coverage = result.folderScan ? folderScanNotes.value[result.folderScan] : null
+      if (coverage) notes.push(coverage)
       toast.add({
         title: t('foundational.toast.synced', {
           updated: result.upserted,
           removed: result.tombstoned,
         }),
+        ...(notes.length ? { description: notes.join(' ') } : {}),
         icon: 'i-lucide-refresh-cw',
-        color: 'info',
+        // A folder we could not fully see, or could not find at all, is the one sync outcome a
+        // human has to act on — the counts alone would read as an ordinary quiet success.
+        color: coverage ? 'warning' : 'info',
       })
     } catch (e) {
       notifyError(t('foundational.toast.syncFailed'), e)
@@ -223,14 +270,26 @@ async function unlink(id: string) {
           {{ s.repoOwner }}/{{ s.repoName }}<span class="text-slate-500">/{{ s.dirPath }}</span>
         </span>
         <p class="text-xs text-slate-500">
-          {{
-            s.mode === 'files'
-              ? t('foundational.sources.metaFiles', {
-                  service: s.serviceName ?? s.serviceId ?? '',
-                  count: s.filePaths.length,
-                })
-              : t('foundational.sources.metaDirectory')
-          }}
+          <template v-if="s.mode === 'files'">
+            {{
+              t('foundational.sources.metaFiles', {
+                service: s.serviceName ?? s.serviceId ?? '',
+                count: s.filePaths.length,
+              })
+            }}
+          </template>
+          <template v-else-if="s.mode === 'folder'">
+            {{
+              s.recursive
+                ? t('foundational.sources.metaFolderRecursive', {
+                    service: s.serviceName ?? s.serviceId ?? '',
+                  })
+                : t('foundational.sources.metaFolder', {
+                    service: s.serviceName ?? s.serviceId ?? '',
+                  })
+            }}
+          </template>
+          <template v-else>{{ t('foundational.sources.metaDirectory') }}</template>
         </p>
         <p class="text-xs text-slate-500">
           {{
@@ -295,13 +354,7 @@ async function unlink(id: string) {
       <p class="mb-2 text-sm font-medium">{{ t('foundational.sources.linkTitle') }}</p>
       <div class="flex flex-col gap-2">
         <URadioGroup v-model="mode" :items="modeItems" orientation="horizontal" size="sm" />
-        <p class="text-xs text-slate-500">
-          {{
-            mode === 'files'
-              ? t('foundational.sources.mode.filesHint')
-              : t('foundational.sources.mode.directoryHint')
-          }}
-        </p>
+        <p class="text-xs text-slate-500">{{ modeHints[mode] }}</p>
 
         <!-- Connected: search a repo, then browse to the folder / pick the contract files -->
         <template v-if="githubReady">
@@ -359,9 +412,20 @@ async function unlink(id: string) {
           />
         </template>
 
-        <!-- `files` mode carries no directory convention to read identity from, so the link
-             supplies it. -->
-        <template v-if="mode === 'files'">
+        <!-- Subfolders are opt-in: a folder link pointed near a repo root would otherwise walk
+             far more of the tree than its author meant to offer. -->
+        <USwitch
+          v-if="mode === 'folder'"
+          v-model="recursive"
+          size="sm"
+          :label="t('foundational.sources.recursive')"
+          :description="t('foundational.sources.recursiveHint')"
+          data-testid="foundational-source-recursive"
+        />
+
+        <!-- Neither single-service mode has a directory convention to read identity from, so the
+             link supplies it. -->
+        <template v-if="namesService">
           <div class="flex gap-2">
             <UInput
               v-model="named.serviceId"

package/app/types/foundationalServices.ts

@@ -16,6 +16,7 @@ export type {
   ApiContractFormat,
   ApiContractSummary,
   CreateFoundationalServiceInput,
+  FolderScanCoverage,
   FoundationalService,
   FoundationalServiceOwnerKind,
   FoundationalServiceSelection,

package/i18n/locales/de.json

@@ -4289,12 +4289,16 @@
       "metaSynced": "synchronisiert {date} · Ref {ref}",
       "metaNever": "nie synchronisiert · Ref {ref}",
       "metaFiles": "{service} · {count} Vertragsdateien",
+      "metaFolder": "{service} · Verträge aus diesem Ordner",
+      "metaFolderRecursive": "{service} · Verträge aus diesem Ordner und seinen Unterordnern",
       "metaDirectory": "ein Dienst je Unterverzeichnis",
       "changes": "Änderungen",
       "check": "Auf Änderungen prüfen",
       "sync": "Erneut synchronisieren",
       "unlink": "Verknüpfung lösen",
       "selectedDir": "Verzeichnis:",
+      "recursive": "Unterordner einbeziehen",
+      "recursiveHint": "Auch Vertragsdateien unterhalb des verknüpften Ordners lesen.",
       "selectedFiles": "Ausgewählte Dateien: {count}",
       "wholeRepo": "Gesamtes Repository (Wurzel).",
       "ownerPlaceholder": "Owner",
@@ -4308,8 +4312,10 @@
       "serviceSummaryPlaceholder": "einzeilige Zusammenfassung (optional)",
       "mode": {
         "directory": "Ein Ordner mit Diensten",
+        "folder": "Ganzer Ordner mit Verträgen, ein Dienst",
         "files": "Bestimmte Dateien, ein Dienst",
         "directoryHint": "Jedes Unterverzeichnis des verknüpften Pfads ist ein Dienst, beschrieben durch eine service.md mit den Vertragsdateien daneben.",
+        "folderHint": "Jede Vertragsdatei im verknüpften Ordner beschreibt den einen Dienst, den du hier benennst; später hinzugefügte Dateien werden bei der nächsten Synchronisierung übernommen.",
         "filesHint": "Die aufgeführten Dateien beschreiben alle den einen Dienst, den du hier benennst. Nutze das, wenn es keine Ordnerkonvention gibt."
       }
     },
@@ -4338,6 +4344,9 @@
       "sourceLinked": "Repo verknüpft & synchronisiert",
       "linkSourceFailed": "Repo konnte nicht verknüpft werden",
       "synced": "Synchronisiert: {updated} aktualisiert, {removed} entfernt",
+      "syncSkipped": "{count} Datei sah wie ein Vertrag aus, war aber nicht verwendbar. | {count} Dateien sahen wie Verträge aus, waren aber nicht verwendbar.",
+      "syncTruncated": "Der Ordner enthält mehr, als eine Synchronisierung aufnehmen kann; es wurde nur ein Teil gelesen.",
+      "syncFolderMissing": "Der verknüpfte Ordner ist nicht im Repository vorhanden. Prüfe den Pfad oder verknüpfe die Quelle neu, falls er verschoben wurde.",
       "syncFailed": "Repo konnte nicht synchronisiert werden",
       "changesAvailable": "Stromaufwärts liegen Änderungen vor",
       "upToDate": "Bereits aktuell",

package/i18n/locales/en.json

@@ -5497,12 +5497,16 @@
       "metaSynced": "synced {date} · ref {ref}",
       "metaNever": "never synced · ref {ref}",
       "metaFiles": "{service} · {count} contract files",
+      "metaFolder": "{service} · contracts from this folder",
+      "metaFolderRecursive": "{service} · contracts from this folder and its subfolders",
       "metaDirectory": "one service per subdirectory",
       "changes": "Changes",
       "check": "Check for changes",
       "sync": "Resync",
       "unlink": "Unlink",
       "selectedDir": "Directory:",
+      "recursive": "Include subfolders",
+      "recursiveHint": "Also read contract files nested below the linked folder.",
       "selectedFiles": "Files picked: {count}",
       "wholeRepo": "Whole repository (root).",
       "ownerPlaceholder": "owner",
@@ -5516,8 +5520,10 @@
       "serviceSummaryPlaceholder": "one-line summary (optional)",
       "mode": {
         "directory": "A folder of services",
+        "folder": "Whole folder of contracts, one service",
         "files": "Specific files, one service",
         "directoryHint": "Every subdirectory of the linked path is one service, described by a service.md with its contract files beside it.",
+        "folderHint": "Every contract file in the linked folder describes the one service you name here, and files added later are picked up on the next sync.",
         "filesHint": "The listed files all describe the one service you name here. Use this when there is no folder convention to adopt."
       }
     },
@@ -5546,6 +5552,9 @@
       "sourceLinked": "Repo linked & synced",
       "linkSourceFailed": "Could not link the repo",
       "synced": "Synced: {updated} updated, {removed} removed",
+      "syncSkipped": "{count} file looked like a contract but could not be used. | {count} files looked like contracts but could not be used.",
+      "syncTruncated": "The folder holds more than one sync can take, so only part of it was read.",
+      "syncFolderMissing": "The linked folder is not in the repository. Check the path, or relink the source if it moved.",
       "syncFailed": "Could not sync the repo",
       "changesAvailable": "Changes available upstream",
       "upToDate": "Already up to date",

package/i18n/locales/es.json

@@ -5248,12 +5248,16 @@
       "metaSynced": "sincronizado {date} · ref {ref}",
       "metaNever": "nunca sincronizado · ref {ref}",
       "metaFiles": "{service} · {count} archivos de contrato",
+      "metaFolder": "{service} · contratos de esta carpeta",
+      "metaFolderRecursive": "{service} · contratos de esta carpeta y sus subcarpetas",
       "metaDirectory": "un servicio por subdirectorio",
       "changes": "Cambios",
       "check": "Buscar cambios",
       "sync": "Volver a sincronizar",
       "unlink": "Desvincular",
       "selectedDir": "Directorio:",
+      "recursive": "Incluir subcarpetas",
+      "recursiveHint": "Leer también los archivos de contrato anidados bajo la carpeta vinculada.",
       "selectedFiles": "Archivos elegidos: {count}",
       "wholeRepo": "Todo el repositorio (raíz).",
       "ownerPlaceholder": "propietario",
@@ -5267,8 +5271,10 @@
       "serviceSummaryPlaceholder": "resumen de una línea (opcional)",
       "mode": {
         "directory": "Una carpeta de servicios",
+        "folder": "Carpeta entera de contratos, un servicio",
         "files": "Archivos concretos, un servicio",
         "directoryHint": "Cada subdirectorio de la ruta vinculada es un servicio, descrito por un service.md con sus archivos de contrato al lado.",
+        "folderHint": "Cada archivo de contrato de la carpeta vinculada describe el único servicio que nombras aquí, y los archivos que se añadan después se recogen en la siguiente sincronización.",
         "filesHint": "Los archivos listados describen el único servicio que nombras aquí. Úsalo cuando no haya una convención de carpetas que adoptar."
       }
     },
@@ -5297,6 +5303,9 @@
       "sourceLinked": "Repositorio vinculado y sincronizado",
       "linkSourceFailed": "No se pudo vincular el repositorio",
       "synced": "Sincronizado: {updated} actualizados, {removed} eliminados",
+      "syncSkipped": "{count} archivo parecía un contrato pero no se pudo usar. | {count} archivos parecían contratos pero no se pudieron usar.",
+      "syncTruncated": "La carpeta contiene más de lo que cabe en una sincronización, así que solo se leyó una parte.",
+      "syncFolderMissing": "La carpeta enlazada no está en el repositorio. Revisa la ruta o vuelve a enlazar la fuente si se movió.",
       "syncFailed": "No se pudo sincronizar el repositorio",
       "changesAvailable": "Hay cambios en el origen",
       "upToDate": "Ya está actualizado",

package/i18n/locales/fr.json

@@ -5248,12 +5248,16 @@
       "metaSynced": "synchronisé le {date} · réf {ref}",
       "metaNever": "jamais synchronisé · réf {ref}",
       "metaFiles": "{service} · {count} fichiers de contrat",
+      "metaFolder": "{service} · contrats de ce dossier",
+      "metaFolderRecursive": "{service} · contrats de ce dossier et de ses sous-dossiers",
       "metaDirectory": "un service par sous-répertoire",
       "changes": "Changements",
       "check": "Vérifier les changements",
       "sync": "Resynchroniser",
       "unlink": "Délier",
       "selectedDir": "Répertoire :",
+      "recursive": "Inclure les sous-dossiers",
+      "recursiveHint": "Lire aussi les fichiers de contrat imbriqués sous le dossier lié.",
       "selectedFiles": "Fichiers choisis : {count}",
       "wholeRepo": "Dépôt entier (racine).",
       "ownerPlaceholder": "propriétaire",
@@ -5267,8 +5271,10 @@
       "serviceSummaryPlaceholder": "résumé d'une ligne (facultatif)",
       "mode": {
         "directory": "Un dossier de services",
+        "folder": "Dossier entier de contrats, un seul service",
         "files": "Des fichiers précis, un seul service",
         "directoryHint": "Chaque sous-répertoire du chemin lié est un service, décrit par un service.md avec ses fichiers de contrat à côté.",
+        "folderHint": "Chaque fichier de contrat du dossier lié décrit l'unique service que vous nommez ici, et les fichiers ajoutés ensuite sont repris à la synchronisation suivante.",
         "filesHint": "Les fichiers listés décrivent tous l'unique service que vous nommez ici. À utiliser quand il n'y a pas de convention de dossiers à adopter."
       }
     },
@@ -5297,6 +5303,9 @@
       "sourceLinked": "Dépôt lié et synchronisé",
       "linkSourceFailed": "Impossible de lier le dépôt",
       "synced": "Synchronisé : {updated} mis à jour, {removed} retirés",
+      "syncSkipped": "{count} fichier ressemblait à un contrat mais n'a pas pu être utilisé. | {count} fichiers ressemblaient à des contrats mais n'ont pas pu être utilisés.",
+      "syncTruncated": "Le dossier contient plus que ce qu'une synchronisation peut prendre : seule une partie a été lue.",
+      "syncFolderMissing": "Le dossier lié n'existe pas dans le dépôt. Vérifiez le chemin, ou reliez la source si elle a été déplacée.",
       "syncFailed": "Impossible de synchroniser le dépôt",
       "changesAvailable": "Des changements sont disponibles en amont",
       "upToDate": "Déjà à jour",

package/i18n/locales/he.json

@@ -5259,12 +5259,16 @@
       "metaSynced": "סונכרן {date} · ref {ref}",
       "metaNever": "מעולם לא סונכרן · ref {ref}",
       "metaFiles": "{service} · {count} קבצי חוזה",
+      "metaFolder": "{service} · חוזים מתיקייה זו",
+      "metaFolderRecursive": "{service} · חוזים מתיקייה זו ומתיקיות המשנה שלה",
       "metaDirectory": "שירות אחד לכל תיקיית משנה",
       "changes": "שינויים",
       "check": "בדיקת שינויים",
       "sync": "סנכרון מחדש",
       "unlink": "ניתוק",
       "selectedDir": "תיקייה:",
+      "recursive": "לכלול תיקיות משנה",
+      "recursiveHint": "לקרוא גם קבצי חוזה המקוננים מתחת לתיקייה המקושרת.",
       "selectedFiles": "קבצים שנבחרו: {count}",
       "wholeRepo": "כל המאגר (השורש).",
       "ownerPlaceholder": "בעלים",
@@ -5278,8 +5282,10 @@
       "serviceSummaryPlaceholder": "תקציר בשורה אחת (רשות)",
       "mode": {
         "directory": "תיקייה של שירותים",
+        "folder": "תיקייה שלמה של חוזים, שירות אחד",
         "files": "קבצים מסוימים, שירות אחד",
         "directoryHint": "כל תיקיית משנה בנתיב המקושר היא שירות, המתואר בקובץ service.md עם קבצי החוזה לצידו.",
+        "folderHint": "כל קובץ חוזה בתיקייה המקושרת מתאר את השירות היחיד שאתם מציינים כאן, וקבצים שיתווספו בהמשך ייקלטו בסנכרון הבא.",
         "filesHint": "כל הקבצים ברשימה מתארים את השירות היחיד שאתם מציינים כאן. השתמשו בזה כשאין מוסכמת תיקיות לאמץ."
       }
     },
@@ -5308,6 +5314,9 @@
       "sourceLinked": "המאגר קושר וסונכרן",
       "linkSourceFailed": "לא ניתן היה לקשר את המאגר",
       "synced": "סונכרן: {updated} עודכנו, {removed} הוסרו",
+      "syncSkipped": "קובץ אחד נראה כמו חוזה אך לא ניתן היה להשתמש בו. | {count} קבצים נראו כמו חוזים אך לא ניתן היה להשתמש בהם.",
+      "syncTruncated": "התיקייה מכילה יותר ממה שסנכרון אחד יכול לקלוט, ולכן נקרא רק חלק ממנה.",
+      "syncFolderMissing": "התיקייה המקושרת אינה נמצאת במאגר. בדקו את הנתיב, או קשרו מחדש את המקור אם הוא הועבר.",
       "syncFailed": "לא ניתן היה לסנכרן את המאגר",
       "changesAvailable": "יש שינויים במקור",
       "upToDate": "כבר מעודכן",

package/i18n/locales/it.json

@@ -4289,12 +4289,16 @@
       "metaSynced": "sincronizzato {date} · ref {ref}",
       "metaNever": "mai sincronizzato · ref {ref}",
       "metaFiles": "{service} · {count} file di contratto",
+      "metaFolder": "{service} · contratti da questa cartella",
+      "metaFolderRecursive": "{service} · contratti da questa cartella e dalle sue sottocartelle",
       "metaDirectory": "un servizio per sottocartella",
       "changes": "Modifiche",
       "check": "Cerca modifiche",
       "sync": "Risincronizza",
       "unlink": "Scollega",
       "selectedDir": "Cartella:",
+      "recursive": "Includi le sottocartelle",
+      "recursiveHint": "Leggi anche i file di contratto annidati sotto la cartella collegata.",
       "selectedFiles": "File scelti: {count}",
       "wholeRepo": "Intero repository (radice).",
       "ownerPlaceholder": "proprietario",
@@ -4308,8 +4312,10 @@
       "serviceSummaryPlaceholder": "riepilogo di una riga (facoltativo)",
       "mode": {
         "directory": "Una cartella di servizi",
+        "folder": "Intera cartella di contratti, un solo servizio",
         "files": "File specifici, un solo servizio",
         "directoryHint": "Ogni sottocartella del percorso collegato è un servizio, descritto da un service.md con accanto i suoi file di contratto.",
+        "folderHint": "Ogni file di contratto nella cartella collegata descrive l'unico servizio che indichi qui, e i file aggiunti in seguito vengono raccolti alla sincronizzazione successiva.",
         "filesHint": "I file elencati descrivono tutti l'unico servizio che indichi qui. Usalo quando non c'è una convenzione di cartelle da adottare."
       }
     },
@@ -4338,6 +4344,9 @@
       "sourceLinked": "Repository collegato e sincronizzato",
       "linkSourceFailed": "Impossibile collegare il repository",
       "synced": "Sincronizzato: {updated} aggiornati, {removed} rimossi",
+      "syncSkipped": "{count} file sembrava un contratto ma non è stato utilizzabile. | {count} file sembravano contratti ma non sono stati utilizzabili.",
+      "syncTruncated": "La cartella contiene più di quanto una sincronizzazione possa prendere, quindi ne è stata letta solo una parte.",
+      "syncFolderMissing": "La cartella collegata non è presente nel repository. Controlla il percorso oppure ricollega la sorgente se è stata spostata.",
       "syncFailed": "Impossibile sincronizzare il repository",
       "changesAvailable": "Sono disponibili modifiche a monte",
       "upToDate": "Già aggiornato",

package/i18n/locales/ja.json

@@ -5260,12 +5260,16 @@
       "metaSynced": "同期日時 {date} · ref {ref}",
       "metaNever": "未同期 · ref {ref}",
       "metaFiles": "{service} · コントラクトファイル {count} 件",
+      "metaFolder": "{service} · このフォルダのコントラクト",
+      "metaFolderRecursive": "{service} · このフォルダとサブフォルダのコントラクト",
       "metaDirectory": "サブディレクトリごとに 1 サービス",
       "changes": "変更あり",
       "check": "変更を確認",
       "sync": "再同期",
       "unlink": "連携解除",
       "selectedDir": "ディレクトリ:",
+      "recursive": "サブフォルダを含める",
+      "recursiveHint": "連携したフォルダの下にネストされたコントラクトファイルも読み込みます。",
       "selectedFiles": "選択したファイル: {count}",
       "wholeRepo": "リポジトリ全体（ルート）。",
       "ownerPlaceholder": "オーナー",
@@ -5279,8 +5283,10 @@
       "serviceSummaryPlaceholder": "1 行の要約（任意）",
       "mode": {
         "directory": "サービスをまとめたフォルダ",
+        "folder": "フォルダ全体のコントラクト、1 サービス",
         "files": "特定のファイル、1 サービス",
         "directoryHint": "連携したパスの各サブディレクトリが 1 つのサービスで、service.md で説明され、その横にコントラクトファイルが置かれます。",
+        "folderHint": "連携したフォルダ内のすべてのコントラクトファイルが、ここで指定する 1 つのサービスを説明します。後から追加されたファイルは次回の同期で取り込まれます。",
         "filesHint": "列挙したファイルはすべて、ここで指定する 1 つのサービスを説明します。従うべきフォルダ規約がない場合に使います。"
       }
     },
@@ -5309,6 +5315,9 @@
       "sourceLinked": "リポジトリを連携して同期しました",
       "linkSourceFailed": "リポジトリを連携できませんでした",
       "synced": "同期完了: {updated} 件更新、{removed} 件削除",
+      "syncSkipped": "コントラクトらしき {count} 件のファイルを利用できませんでした。 | コントラクトらしき {count} 件のファイルを利用できませんでした。",
+      "syncTruncated": "フォルダの内容が 1 回の同期で扱える量を超えているため、一部のみ読み込みました。",
+      "syncFolderMissing": "連携したフォルダがリポジトリに存在しません。パスを確認するか、移動した場合はソースを連携し直してください。",
       "syncFailed": "リポジトリを同期できませんでした",
       "changesAvailable": "上流に変更があります",
       "upToDate": "すでに最新です",

package/i18n/locales/pl.json

@@ -5248,12 +5248,16 @@
       "metaSynced": "zsynchronizowano {date} · ref {ref}",
       "metaNever": "nigdy nie synchronizowano · ref {ref}",
       "metaFiles": "{service} · {count} plików kontraktów",
+      "metaFolder": "{service} · kontrakty z tego folderu",
+      "metaFolderRecursive": "{service} · kontrakty z tego folderu i jego podfolderów",
       "metaDirectory": "jedna usługa na podkatalog",
       "changes": "Zmiany",
       "check": "Sprawdź zmiany",
       "sync": "Zsynchronizuj ponownie",
       "unlink": "Odłącz",
       "selectedDir": "Katalog:",
+      "recursive": "Uwzględnij podfoldery",
+      "recursiveHint": "Czytaj także pliki kontraktów zagnieżdżone poniżej powiązanego folderu.",
       "selectedFiles": "Wybrane pliki: {count}",
       "wholeRepo": "Całe repozytorium (katalog główny).",
       "ownerPlaceholder": "właściciel",
@@ -5267,8 +5271,10 @@
       "serviceSummaryPlaceholder": "jednozdaniowe streszczenie (opcjonalne)",
       "mode": {
         "directory": "Katalog z usługami",
+        "folder": "Cały folder kontraktów, jedna usługa",
         "files": "Wybrane pliki, jedna usługa",
         "directoryHint": "Każdy podkatalog powiązanej ścieżki to jedna usługa, opisana plikiem service.md, obok którego leżą jej pliki kontraktów.",
+        "folderHint": "Każdy plik kontraktu w powiązanym folderze opisuje tę jedną usługę, którą tu nazywasz, a pliki dodane później zostaną pobrane przy następnej synchronizacji.",
         "filesHint": "Wymienione pliki opisują tę jedną usługę, którą tu nazywasz. Użyj tego, gdy nie ma konwencji katalogów do przyjęcia."
       }
     },
@@ -5297,6 +5303,9 @@
       "sourceLinked": "Repozytorium powiązane i zsynchronizowane",
       "linkSourceFailed": "Nie udało się powiązać repozytorium",
       "synced": "Zsynchronizowano: {updated} zaktualizowanych, {removed} usuniętych",
+      "syncSkipped": "{count} plik wyglądał jak kontrakt, ale nie dało się go użyć. | {count} pliki wyglądały jak kontrakty, ale nie dało się ich użyć. | {count} plików wyglądało jak kontrakty, ale nie dało się ich użyć.",
+      "syncTruncated": "Folder zawiera więcej, niż mieści jedna synchronizacja, więc odczytano tylko jego część.",
+      "syncFolderMissing": "Połączony folder nie istnieje w repozytorium. Sprawdź ścieżkę lub połącz źródło ponownie, jeśli zostało przeniesione.",
       "syncFailed": "Nie udało się zsynchronizować repozytorium",
       "changesAvailable": "W źródle są zmiany",
       "upToDate": "Już aktualne",

package/i18n/locales/tr.json

@@ -5260,12 +5260,16 @@
       "metaSynced": "eşitlendi {date} · ref {ref}",
       "metaNever": "hiç eşitlenmedi · ref {ref}",
       "metaFiles": "{service} · {count} sözleşme dosyası",
+      "metaFolder": "{service} · bu klasördeki sözleşmeler",
+      "metaFolderRecursive": "{service} · bu klasördeki ve alt klasörlerindeki sözleşmeler",
       "metaDirectory": "her alt dizin için bir hizmet",
       "changes": "Değişiklikler",
       "check": "Değişiklikleri denetle",
       "sync": "Yeniden eşitle",
       "unlink": "Bağlantıyı kaldır",
       "selectedDir": "Dizin:",
+      "recursive": "Alt klasörleri dahil et",
+      "recursiveHint": "Bağlanan klasörün altında yer alan sözleşme dosyalarını da oku.",
       "selectedFiles": "Seçilen dosyalar: {count}",
       "wholeRepo": "Tüm depo (kök).",
       "ownerPlaceholder": "sahip",
@@ -5279,8 +5283,10 @@
       "serviceSummaryPlaceholder": "tek satırlık özet (isteğe bağlı)",
       "mode": {
         "directory": "Hizmetlerin bulunduğu bir klasör",
+        "folder": "Sözleşmelerin tamamının bulunduğu klasör, tek hizmet",
         "files": "Belirli dosyalar, tek hizmet",
         "directoryHint": "Bağlanan yolun her alt dizini bir hizmettir; bir service.md ile tanımlanır ve sözleşme dosyaları onun yanında durur.",
+        "folderHint": "Bağlanan klasördeki her sözleşme dosyası burada adlandırdığınız tek hizmeti tanımlar; sonradan eklenen dosyalar bir sonraki eşitlemede alınır.",
         "filesHint": "Listelenen dosyaların tamamı burada adlandırdığınız tek hizmeti tanımlar. Benimsenecek bir klasör düzeni yoksa bunu kullanın."
       }
     },
@@ -5309,6 +5315,9 @@
       "sourceLinked": "Depo bağlandı ve eşitlendi",
       "linkSourceFailed": "Depo bağlanamadı",
       "synced": "Eşitlendi: {updated} güncellendi, {removed} kaldırıldı",
+      "syncSkipped": "{count} dosya sözleşmeye benziyordu ama kullanılamadı. | {count} dosya sözleşmeye benziyordu ama kullanılamadı.",
+      "syncTruncated": "Klasör tek bir eşitlemenin alabileceğinden fazlasını içeriyor, bu yüzden yalnızca bir kısmı okundu.",
+      "syncFolderMissing": "Bağlanan klasör depoda yok. Yolu kontrol edin veya taşındıysa kaynağı yeniden bağlayın.",
       "syncFailed": "Depo eşitlenemedi",
       "changesAvailable": "Kaynakta değişiklikler var",
       "upToDate": "Zaten güncel",

package/i18n/locales/uk.json

@@ -5248,12 +5248,16 @@
       "metaSynced": "синхронізовано {date} · ref {ref}",
       "metaNever": "ніколи не синхронізовано · ref {ref}",
       "metaFiles": "{service} · {count} файлів контрактів",
+      "metaFolder": "{service} · контракти з цієї теки",
+      "metaFolderRecursive": "{service} · контракти з цієї теки та її підтек",
       "metaDirectory": "один сервіс на підкаталог",
       "changes": "Зміни",
       "check": "Перевірити зміни",
       "sync": "Синхронізувати знову",
       "unlink": "Від'єднати",
       "selectedDir": "Каталог:",
+      "recursive": "Включати підтеки",
+      "recursiveHint": "Читати також файли контрактів, вкладені під приєднаною текою.",
       "selectedFiles": "Обрані файли: {count}",
       "wholeRepo": "Увесь репозиторій (корінь).",
       "ownerPlaceholder": "власник",
@@ -5267,8 +5271,10 @@
       "serviceSummaryPlaceholder": "однорядковий опис (необов'язково)",
       "mode": {
         "directory": "Каталог із сервісами",
+        "folder": "Уся тека контрактів, один сервіс",
         "files": "Окремі файли, один сервіс",
         "directoryHint": "Кожен підкаталог приєднаного шляху - це один сервіс, описаний файлом service.md, поруч з яким лежать його файли контрактів.",
+        "folderHint": "Кожен файл контракту в приєднаній теці описує той єдиний сервіс, який ви тут називаєте, а файли, додані згодом, буде підхоплено під час наступної синхронізації.",
         "filesHint": "Усі перелічені файли описують той єдиний сервіс, який ви тут називаєте. Використовуйте це, коли немає угоди про каталоги."
       }
     },
@@ -5297,6 +5303,9 @@
       "sourceLinked": "Репозиторій приєднано та синхронізовано",
       "linkSourceFailed": "Не вдалося приєднати репозиторій",
       "synced": "Синхронізовано: {updated} оновлено, {removed} вилучено",
+      "syncSkipped": "{count} файл був схожий на контракт, але його не вдалося використати. | {count} файли були схожі на контракти, але їх не вдалося використати. | {count} файлів були схожі на контракти, але їх не вдалося використати.",
+      "syncTruncated": "Тека містить більше, ніж вміщає одна синхронізація, тому прочитано лише її частину.",
+      "syncFolderMissing": "Приєднаної теки немає в репозиторії. Перевірте шлях або приєднайте джерело заново, якщо його перенесено.",
       "syncFailed": "Не вдалося синхронізувати репозиторій",
       "changesAvailable": "У джерелі є зміни",
       "upToDate": "Уже актуально",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.200.2",
+  "version": "0.200.4",
   "description": "Reusable Nuxt layer for the Agent Architecture Board SPA (components, stores, composables, pages). Consume it from a thin deployment app via `extends: ['@cat-factory/app']` and point it at your backend with NUXT_PUBLIC_API_BASE. See deploy/frontend for an example.",
   "repository": {
     "type": "git",
@@ -40,7 +40,7 @@
     "valibot": "^1.4.2",
     "vue": "3.5.40",
     "wretch": "^3.0.9",
-    "@cat-factory/contracts": "0.207.0"
+    "@cat-factory/contracts": "0.209.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",