@cat-factory/app 0.186.0 → 0.187.0

package/app/components/fragments/FragmentLibraryManager.vue

@@ -14,6 +14,7 @@ import type {
   ResolvedFragment,
 } from '~/types/domain'
 import { useFragmentLibrary, useFragmentLibraryStore } from '~/stores/fragmentLibrary'
+import { showOverrideField } from '~/utils/uiMode'
 import GitHubRepoSearchSelect from '~/components/github/GitHubRepoSearchSelect.vue'
 import RepoTreeBrowser from '~/components/github/RepoTreeBrowser.vue'
 import GitHubDocUrlImport from '~/components/fragments/GitHubDocUrlImport.vue'
@@ -131,7 +132,7 @@ const linkingDoc = ref(false)
 const linkingSource = ref(false)
 
 // ---- create a hand-authored fragment --------------------------------------
-const draft = ref({ title: '', summary: '', body: '', tags: '' })
+const draft = ref({ title: '', summary: '', body: '', brief: '', tags: '' })
 const draftValid = computed(
   () => draft.value.title.trim() && draft.value.summary.trim() && draft.value.body.trim(),
 )
@@ -167,6 +168,7 @@ const editDraft = ref<{
   title: string
   summary: string
   body: string
+  brief: string
   tags: string
 } | null>(null)
 function startEdit(f: (typeof library.fragments)[number]) {
@@ -175,8 +177,10 @@ function startEdit(f: (typeof library.fragments)[number]) {
     title: f.title,
     summary: f.summary,
     body: f.body,
+    brief: f.brief ?? '',
     tags: (f.tags ?? []).join(', '),
   }
+  showEditBrief.value = showOverrideField(uiMode.isAdvanced, f.brief ?? null)
 }
 function cancelEdit() {
   editDraft.value = null
@@ -188,6 +192,19 @@ const editValid = computed(
     !!editDraft.value.summary.trim() &&
     !!editDraft.value.body.trim(),
 )
+// The linked SHORT VERSION is an OVERRIDE of what the platform does by default (condense a
+// long standard automatically, fold a short one in full), so it follows the override rule:
+// hidden in basic mode while unset, revealed as soon as the fragment carries one — a
+// basic-mode curator is never left unable to see or clear a brief a teammate linked.
+//
+// Both flags are LATCHED at the moment the form opens rather than tracking the live draft.
+// Recomputing per keystroke makes the control delete itself the instant a basic-mode curator
+// empties it — mid-edit, under the cursor, on the one interaction (clearing, to hand the
+// standard back to auto-generation) the rule exists to keep reachable.
+const uiMode = useUiModeStore()
+const showEditBrief = ref(false)
+const showDraftBrief = computed(() => showOverrideField(uiMode.isAdvanced, null))
+
 async function saveEdit() {
   const d = editDraft.value
   if (!d || !editValid.value) return
@@ -197,6 +214,9 @@ async function saveEdit() {
         title: d.title.trim(),
         summary: d.summary.trim(),
         body: d.body.trim(),
+        // Always sent, so clearing the box UNLINKS the short version and hands the
+        // standard back to auto-generation (an omitted key would leave the old one).
+        brief: d.brief.trim(),
         tags: d.tags
           .split(',')
           .map((t) => t.trim())
@@ -218,12 +238,13 @@ async function createFragment() {
       title: draft.value.title.trim(),
       summary: draft.value.summary.trim(),
       body: draft.value.body.trim(),
+      brief: draft.value.brief.trim() || undefined,
       tags: draft.value.tags
         .split(',')
         .map((t) => t.trim())
         .filter(Boolean),
     })
-    draft.value = { title: '', summary: '', body: '', tags: '' }
+    draft.value = { title: '', summary: '', body: '', brief: '', tags: '' }
     toast.add({ title: t('fragments.toast.added'), icon: 'i-lucide-check' })
   } catch (e) {
     notifyError(t('fragments.toast.addFailed'), e)
@@ -701,6 +722,14 @@ async function unlinkSource(id: string) {
               :placeholder="t('fragments.authored.bodyPlaceholder')"
               :rows="4"
             />
+            <div v-if="showEditBrief" class="flex flex-col gap-1">
+              <UTextarea
+                v-model="editDraft.brief"
+                :placeholder="t('fragments.authored.briefPlaceholder')"
+                :rows="2"
+              />
+              <p class="text-xs text-slate-500">{{ t('fragments.authored.briefHint') }}</p>
+            </div>
             <UInput
               v-model="editDraft.tags"
               :placeholder="t('fragments.authored.tagsPlaceholder')"
@@ -799,6 +828,14 @@ async function unlinkSource(id: string) {
               :placeholder="t('fragments.authored.bodyPlaceholder')"
               :rows="4"
             />
+            <div v-if="showDraftBrief" class="flex flex-col gap-1">
+              <UTextarea
+                v-model="draft.brief"
+                :placeholder="t('fragments.authored.briefPlaceholder')"
+                :rows="2"
+              />
+              <p class="text-xs text-slate-500">{{ t('fragments.authored.briefHint') }}</p>
+            </div>
             <UInput v-model="draft.tags" :placeholder="t('fragments.authored.tagsPlaceholder')" />
             <UButton
               icon="i-lucide-plus"

package/i18n/locales/de.json

@@ -4007,6 +4007,8 @@
       "titlePlaceholder": "Titel",
       "summaryPlaceholder": "Einzeilige Zusammenfassung (vom Selektor verwendet)",
       "bodyPlaceholder": "Richtlinientext (in den Prompt injiziert)",
+      "briefPlaceholder": "Kurzfassung, die Coding-Agents erhalten (optional)",
+      "briefHint": "Lange Standards werden für Coding-Agents automatisch verdichtet, da diese sie in jedem Zug erneut lesen. Verlinke hier deine eigene Kurzfassung, um sie stattdessen zu verwenden; leere das Feld, um zur automatischen zurückzukehren.",
       "tagsPlaceholder": "Tags, kommagetrennt (z. B. backend, db)",
       "add": "Fragment hinzufügen",
       "generateTitle": "Generieren",

package/i18n/locales/en.json

@@ -5158,6 +5158,9 @@
       "titlePlaceholder": "Title",
       "summaryPlaceholder": "One-line summary (used by the selector)",
       "bodyPlaceholder": "Guidance body (injected into the prompt)",
+      "briefPlaceholder": "Short version folded for coding agents (optional)",
+      "@briefPlaceholder": "Placeholder for the optional 'brief' field: a terse restatement of the same standard, folded into a coding agent's prompt instead of the full text.",
+      "briefHint": "Long standards are condensed automatically for coding agents, which re-read them on every turn. Link your own short version here to use it instead; clear it to go back to the automatic one.",
       "tagsPlaceholder": "Tags, comma-separated (e.g. backend, db)",
       "add": "Add fragment",
       "generateTitle": "Generate",

package/i18n/locales/es.json

@@ -4932,6 +4932,8 @@
       "titlePlaceholder": "Título",
       "summaryPlaceholder": "Resumen de una línea (usado por el selector)",
       "bodyPlaceholder": "Cuerpo de la guía (inyectado en el prompt)",
+      "briefPlaceholder": "Versión corta que reciben los agentes de código (opcional)",
+      "briefHint": "Los estándares largos se condensan automáticamente para los agentes de código, que los releen en cada turno. Enlaza aquí tu propia versión corta para usarla en su lugar; vacíalo para volver a la automática.",
       "tagsPlaceholder": "Etiquetas, separadas por comas (p. ej., backend, db)",
       "add": "Añadir fragmento",
       "generateTitle": "Generar",

package/i18n/locales/fr.json

@@ -4932,6 +4932,8 @@
       "titlePlaceholder": "Titre",
       "summaryPlaceholder": "Résumé en une ligne (utilisé par le sélecteur)",
       "bodyPlaceholder": "Corps de la consigne (injecté dans le prompt)",
+      "briefPlaceholder": "Version courte transmise aux agents de code (facultatif)",
+      "briefHint": "Les standards longs sont condensés automatiquement pour les agents de code, qui les relisent à chaque tour. Liez ici votre propre version courte pour l'utiliser à la place ; videz le champ pour revenir à la version automatique.",
       "tagsPlaceholder": "Étiquettes, séparées par des virgules (par ex. backend, db)",
       "add": "Ajouter le fragment",
       "generateTitle": "Générer",

package/i18n/locales/he.json

@@ -4943,6 +4943,8 @@
       "titlePlaceholder": "כותרת",
       "summaryPlaceholder": "תקציר בשורה אחת (בשימוש הבורר)",
       "bodyPlaceholder": "גוף ההנחיה (מוזרק לפרומפט)",
+      "briefPlaceholder": "גרסה מקוצרת שסוכני הקוד מקבלים (רשות)",
+      "briefHint": "תקנים ארוכים מתומצתים אוטומטית עבור סוכני קוד, שקוראים אותם מחדש בכל תור. קשרו כאן גרסה מקוצרת משלכם כדי להשתמש בה במקום; רוקנו את השדה כדי לחזור לגרסה האוטומטית.",
       "tagsPlaceholder": "תגיות, מופרדות בפסיקים (למשל backend, db)",
       "add": "הוסף מקטע",
       "generateTitle": "יצירה",

package/i18n/locales/it.json

@@ -4007,6 +4007,8 @@
       "titlePlaceholder": "Titolo",
       "summaryPlaceholder": "Riepilogo su una riga (usato dal selettore)",
       "bodyPlaceholder": "Corpo delle indicazioni (iniettato nel prompt)",
+      "briefPlaceholder": "Versione breve fornita agli agenti di codice (facoltativo)",
+      "briefHint": "Gli standard lunghi vengono condensati automaticamente per gli agenti di codice, che li rileggono a ogni turno. Collega qui la tua versione breve per usarla al suo posto; svuota il campo per tornare a quella automatica.",
       "tagsPlaceholder": "Tag, separati da virgola (es. backend, db)",
       "add": "Aggiungi frammento",
       "generateTitle": "Genera",

package/i18n/locales/ja.json

@@ -4944,6 +4944,8 @@
       "titlePlaceholder": "タイトル",
       "summaryPlaceholder": "1行の要約 (セレクターで使用)",
       "bodyPlaceholder": "ガイダンス本文 (プロンプトに挿入)",
+      "briefPlaceholder": "コーディングエージェントに渡す短縮版 (任意)",
+      "briefHint": "長い基準は、毎ターン読み直すコーディングエージェント向けに自動で要約されます。独自の短縮版をここにリンクするとそちらが使われ、空にすると自動要約に戻ります。",
       "tagsPlaceholder": "タグ、カンマ区切り (例: backend, db)",
       "add": "フラグメントを追加",
       "generateTitle": "生成",

package/i18n/locales/pl.json

@@ -4932,6 +4932,8 @@
       "titlePlaceholder": "Tytuł",
       "summaryPlaceholder": "Jednowierszowe podsumowanie (używane przez selektor)",
       "bodyPlaceholder": "Treść wytycznej (wstrzykiwana do promptu)",
+      "briefPlaceholder": "Krótka wersja przekazywana agentom kodującym (opcjonalnie)",
+      "briefHint": "Długie standardy są automatycznie skracane dla agentów kodujących, które czytają je w każdej turze. Podlinkuj tu własną krótką wersję, aby użyć jej zamiast tego; wyczyść pole, by wrócić do wersji automatycznej.",
       "tagsPlaceholder": "Tagi, oddzielone przecinkami (np. backend, db)",
       "add": "Dodaj fragment",
       "generateTitle": "Generuj",

package/i18n/locales/tr.json

@@ -4944,6 +4944,8 @@
       "titlePlaceholder": "Başlık",
       "summaryPlaceholder": "Tek satırlık özet (seçici tarafından kullanılır)",
       "bodyPlaceholder": "Yönerge gövdesi (prompt'a enjekte edilir)",
+      "briefPlaceholder": "Kod ajanlarına verilen kısa sürüm (isteğe bağlı)",
+      "briefHint": "Uzun standartlar, onları her turda yeniden okuyan kod ajanları için otomatik olarak özetlenir. Bunun yerine kendi kısa sürümünüzü buraya bağlayın; otomatik sürüme dönmek için alanı boşaltın.",
       "tagsPlaceholder": "Etiketler, virgülle ayrılmış (örn. backend, db)",
       "add": "Parça ekle",
       "generateTitle": "Oluştur",

package/i18n/locales/uk.json

@@ -4932,6 +4932,8 @@
       "titlePlaceholder": "Заголовок",
       "summaryPlaceholder": "Однорядковий підсумок (використовується селектором)",
       "bodyPlaceholder": "Текст настанови (вставляється у промпт)",
+      "briefPlaceholder": "Коротка версія, яку отримують агенти-кодери (необов'язково)",
+      "briefHint": "Довгі стандарти автоматично стискаються для агентів-кодерів, які перечитують їх щохода. Приєднайте тут власну коротку версію, щоб використати її замість автоматичної; очистіть поле, щоб повернутися до автоматичної.",
       "tagsPlaceholder": "Теги, розділені комами (напр. backend, db)",
       "add": "Додати фрагмент",
       "generateTitle": "Згенерувати",

package/package.json

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