@cat-factory/app 0.91.0 → 0.92.0

package/app/components/documents/DocumentTemplatesModal.vue

@@ -0,0 +1,253 @@
+<script setup lang="ts">
+import { DOC_KINDS } from '~/types/domain'
+import type { DocKind, DocumentLinkRole, SourceDocument } from '~/types/domain'
+import IntegrationBackTitle from '~/components/layout/IntegrationBackTitle.vue'
+
+// Manage the workspace's per-DocKind TEMPLATE (singular) + EXEMPLAR (multi) document links (WS1).
+// A kind can be pointed at one of the workspace's already-imported documents so its parsed
+// sections override the built-in skeleton (template) and the author agents study it (exemplar).
+// Reuses the same imported-document corpus as context linking — no new fetch surface.
+const { t } = useI18n()
+const ui = useUiStore()
+const documents = useDocumentsStore()
+const toast = useToast()
+
+const open = computed({
+  get: () => ui.documentTemplates,
+  set: (v: boolean) => {
+    if (!v) ui.closeDocumentTemplates()
+  },
+})
+const back = useIntegrationBack(open)
+
+const kind = ref<DocKind>('prd')
+const busy = ref(false)
+/** The imported document (`source:externalId`) selected in the "add" picker. */
+const pick = ref<string | undefined>(undefined)
+
+watch(
+  open,
+  (isOpen) => {
+    if (isOpen) {
+      pick.value = undefined
+      // Surface a load failure instead of silently rendering an empty panel (which would invite
+      // re-linking over links that still exist server-side).
+      Promise.all([documents.loadDocuments(), documents.loadRoleLinks()]).catch((e) => {
+        toast.add({
+          title: t('documents.templates.loadFailed'),
+          description: e instanceof Error ? e.message : String(e),
+          icon: 'i-lucide-triangle-alert',
+          color: 'error',
+        })
+      })
+    }
+  },
+  { immediate: true },
+)
+
+const template = computed(() => documents.templateFor(kind.value))
+const exemplars = computed(() => documents.exemplarsFor(kind.value))
+
+/**
+ * Imported documents the picker offers. A document row carries at most ONE (role, docKind) tag, so
+ * a doc already linked as any template/exemplar is excluded — re-linking it here would silently
+ * overwrite (and drop) its existing tag. Remove the existing link first to re-point it.
+ */
+const docItems = computed(() => {
+  const tagged = new Set(documents.roleLinks.map((d) => `${d.source}:${d.externalId}`))
+  return documents.documents
+    .filter((d) => !tagged.has(`${d.source}:${d.externalId}`))
+    .map((d) => ({ label: d.title, value: `${d.source}:${d.externalId}` }))
+})
+
+function findDoc(key: string): SourceDocument | undefined {
+  return documents.documents.find((d) => `${d.source}:${d.externalId}` === key)
+}
+
+async function link(role: DocumentLinkRole) {
+  const doc = pick.value ? findDoc(pick.value) : undefined
+  if (!doc) return
+  busy.value = true
+  try {
+    await documents.linkForKind(doc.source, doc.externalId, role, kind.value)
+    pick.value = undefined
+  } catch (e) {
+    toast.add({
+      title: t('documents.templates.linkFailed'),
+      description: e instanceof Error ? e.message : String(e),
+      icon: 'i-lucide-triangle-alert',
+      color: 'error',
+    })
+  } finally {
+    busy.value = false
+  }
+}
+
+async function unlink(doc: SourceDocument) {
+  busy.value = true
+  try {
+    await documents.unlinkForKind(doc.source, doc.externalId)
+  } catch (e) {
+    toast.add({
+      title: t('documents.templates.linkFailed'),
+      description: e instanceof Error ? e.message : String(e),
+      icon: 'i-lucide-triangle-alert',
+      color: 'error',
+    })
+  } finally {
+    busy.value = false
+  }
+}
+</script>
+
+<template>
+  <UModal v-model:open="open" :title="t('documents.templates.title')">
+    <template #title>
+      <IntegrationBackTitle :title="t('documents.templates.title')" @back="back" />
+    </template>
+    <template #body>
+      <div class="space-y-4">
+        <p class="text-xs text-slate-400">{{ t('documents.templates.intro') }}</p>
+
+        <!-- No imported documents yet: a template/exemplar must be an imported document. -->
+        <div v-if="!documents.documents.length" class="space-y-3 text-center">
+          <UIcon name="i-lucide-file-plus" class="mx-auto h-8 w-8 text-slate-500" />
+          <p class="text-sm text-slate-400">{{ t('documents.templates.importFirst') }}</p>
+          <UButton
+            color="primary"
+            variant="soft"
+            icon="i-lucide-file-down"
+            @click="ui.openDocumentImport(null)"
+          >
+            {{ t('documents.templates.importButton') }}
+          </UButton>
+        </div>
+
+        <template v-else>
+          <UFormField :label="t('documents.templates.kindLabel')">
+            <div class="flex flex-wrap gap-1">
+              <UButton
+                v-for="k in DOC_KINDS"
+                :key="k"
+                :color="kind === k ? 'primary' : 'neutral'"
+                :variant="kind === k ? 'soft' : 'ghost'"
+                size="xs"
+                class="uppercase"
+                @click="kind = k"
+              >
+                {{ k }}
+              </UButton>
+            </div>
+          </UFormField>
+
+          <!-- Template (singular per kind) ------------------------------------ -->
+          <section class="rounded-lg border border-slate-800 bg-slate-900/50 p-3">
+            <h3 class="text-[11px] font-semibold uppercase tracking-wide text-slate-400">
+              {{ t('documents.templates.templateHeading') }}
+            </h3>
+            <p class="mt-0.5 text-xs text-slate-500">
+              {{ t('documents.templates.templateHint', { kind }) }}
+            </p>
+            <div
+              v-if="template"
+              class="mt-2 flex items-center justify-between gap-2 rounded-md bg-slate-900/70 px-3 py-2"
+            >
+              <a
+                :href="template.url"
+                target="_blank"
+                rel="noopener"
+                class="truncate text-sm font-medium text-white hover:underline"
+              >
+                {{ template.title }}
+              </a>
+              <UButton
+                color="neutral"
+                variant="ghost"
+                size="xs"
+                icon="i-lucide-x"
+                :loading="busy"
+                @click="unlink(template)"
+              >
+                {{ t('documents.templates.remove') }}
+              </UButton>
+            </div>
+            <p v-else class="mt-2 text-xs text-slate-500">
+              {{ t('documents.templates.templateEmpty') }}
+            </p>
+          </section>
+
+          <!-- Exemplars (multi per kind) -------------------------------------- -->
+          <section class="rounded-lg border border-slate-800 bg-slate-900/50 p-3">
+            <h3 class="text-[11px] font-semibold uppercase tracking-wide text-slate-400">
+              {{ t('documents.templates.exemplarsHeading') }}
+            </h3>
+            <p class="mt-0.5 text-xs text-slate-500">
+              {{ t('documents.templates.exemplarsHint') }}
+            </p>
+            <div v-if="exemplars.length" class="mt-2 space-y-1.5">
+              <div
+                v-for="doc in exemplars"
+                :key="`${doc.source}:${doc.externalId}`"
+                class="flex items-center justify-between gap-2 rounded-md bg-slate-900/70 px-3 py-2"
+              >
+                <a
+                  :href="doc.url"
+                  target="_blank"
+                  rel="noopener"
+                  class="truncate text-sm font-medium text-white hover:underline"
+                >
+                  {{ doc.title }}
+                </a>
+                <UButton
+                  color="neutral"
+                  variant="ghost"
+                  size="xs"
+                  icon="i-lucide-x"
+                  :loading="busy"
+                  @click="unlink(doc)"
+                >
+                  {{ t('documents.templates.remove') }}
+                </UButton>
+              </div>
+            </div>
+            <p v-else class="mt-2 text-xs text-slate-500">
+              {{ t('documents.templates.exemplarsEmpty') }}
+            </p>
+          </section>
+
+          <!-- Picker: choose an imported document, then set as template or add as example. -->
+          <div class="flex items-end gap-2">
+            <UFormField :label="t('documents.templates.pickLabel')" class="flex-1">
+              <USelect
+                v-model="pick"
+                :items="docItems"
+                :placeholder="t('documents.templates.pickPlaceholder')"
+                class="w-full"
+              />
+            </UFormField>
+            <UButton
+              color="primary"
+              variant="soft"
+              icon="i-lucide-file-badge"
+              :loading="busy"
+              :disabled="!pick"
+              @click="link('template')"
+            >
+              {{ t('documents.templates.setTemplate') }}
+            </UButton>
+            <UButton
+              color="neutral"
+              variant="soft"
+              icon="i-lucide-star"
+              :loading="busy"
+              :disabled="!pick"
+              @click="link('exemplar')"
+            >
+              {{ t('documents.templates.addExemplar') }}
+            </UButton>
+          </div>
+        </template>
+      </div>
+    </template>
+  </UModal>
+</template>

package/app/components/layout/IntegrationsHub.vue

@@ -194,7 +194,18 @@ const groups = computed<IntegrationGroup[]>(() => {
         onClick: () => go(() => ui.openDocumentImport(null)),
       })
     }
-    out.push({ title: t('layout.integrationsHub.groups.documents'), items: docs })
+    // Per-DocKind template + exemplar links are workspace CONFIG over the imported corpus, not an
+    // integration to connect — so they sit as a quiet footer link under the sources.
+    out.push({
+      title: t('layout.integrationsHub.groups.documents'),
+      items: docs,
+      footerLink: {
+        key: 'doc:templates',
+        icon: 'i-lucide-file-badge',
+        label: t('layout.integrationsHub.items.documentTemplates.label'),
+        onClick: () => go(() => ui.openDocumentTemplates()),
+      },
+    })
   }
 
   // --- Task trackers (dynamic sources: Jira / GitHub) ------------------------

package/app/composables/api/documents.ts

@@ -3,14 +3,17 @@ import {
   disconnectDocumentSourceContract,
   importDocumentContract,
   linkDocumentContract,
+  linkDocumentForKindContract,
   listDocumentConnectionsContract,
+  listDocumentRoleLinksContract,
   listDocumentsContract,
   listDocumentSourcesContract,
   planDocumentContract,
   searchDocumentsContract,
   spawnDocumentContract,
+  unlinkDocumentForKindContract,
 } from '@cat-factory/contracts'
-import type { DocumentSourceKind } from '~/types/domain'
+import type { DocKind, DocumentLinkRole, DocumentSourceKind } from '~/types/domain'
 import type { ApiContext } from './context'
 
 /** Document sources (Confluence, Notion, …): connect, import, search, board-spawn. */
@@ -72,5 +75,24 @@ export function documentsApi({ send, ws }: ApiContext) {
       workspaceId: string,
       body: { source: DocumentSourceKind; externalId: string; blockId: string },
     ) => send(linkDocumentContract, { pathPrefix: ws(workspaceId), body }),
+
+    // ---- workspace+DocKind template / exemplar links (WS1) ----------------
+    listDocumentRoleLinks: (workspaceId: string) =>
+      send(listDocumentRoleLinksContract, { pathPrefix: ws(workspaceId) }),
+
+    linkDocumentForKind: (
+      workspaceId: string,
+      body: {
+        source: DocumentSourceKind
+        externalId: string
+        role: DocumentLinkRole
+        docKind: DocKind
+      },
+    ) => send(linkDocumentForKindContract, { pathPrefix: ws(workspaceId), body }),
+
+    unlinkDocumentForKind: (
+      workspaceId: string,
+      body: { source: DocumentSourceKind; externalId: string },
+    ) => send(unlinkDocumentForKindContract, { pathPrefix: ws(workspaceId), body }),
   }
 }

package/app/pages/index.vue

@@ -47,6 +47,9 @@ const DocumentSourceConnectModal = defineAsyncComponent(
 const DocumentImportModal = defineAsyncComponent(
   () => import('~/components/documents/DocumentImportModal.vue'),
 )
+const DocumentTemplatesModal = defineAsyncComponent(
+  () => import('~/components/documents/DocumentTemplatesModal.vue'),
+)
 const SpawnPreviewModal = defineAsyncComponent(
   () => import('~/components/documents/SpawnPreviewModal.vue'),
 )
@@ -347,6 +350,7 @@ watch(
       <KaizenPanel v-if="ui.kaizenScreenOpen" />
       <DocumentSourceConnectModal v-if="ui.documentConnect" />
       <DocumentImportModal v-if="ui.documentImport" />
+      <DocumentTemplatesModal v-if="ui.documentTemplates" />
       <SpawnPreviewModal v-if="ui.spawnPreview" />
       <BootstrapModal v-if="ui.bootstrapOpen" />
       <AddServiceFromRepoModal v-if="ui.addServiceOpen" />

package/app/stores/documents.ts

@@ -1,8 +1,10 @@
 import { defineStore } from 'pinia'
 import { ref } from 'vue'
 import type {
+  DocKind,
   DocumentBoardPlan,
   DocumentConnection,
+  DocumentLinkRole,
   DocumentSearchResult,
   DocumentSourceDescriptor,
   DocumentSourceKind,
@@ -50,6 +52,10 @@ export const useDocumentsStore = defineStore('documents', () => {
   })
   const loading = ref(false)
 
+  // Workspace+DocKind template / exemplar role links (WS1). Loaded lazily when the management
+  // panel opens; the full list of role-tagged documents across kinds.
+  const roleLinks = ref<SourceDocument[]>([])
+
   /** Imported documents currently attached to a given block. */
   function docsForBlock(blockId: string): SourceDocument[] {
     return documents.value.filter((d) => d.linkedBlockId === blockId)
@@ -116,6 +122,58 @@ export const useDocumentsStore = defineStore('documents', () => {
     return doc
   }
 
+  // ---- workspace+DocKind template / exemplar links (WS1) ------------------
+
+  /** Load every role-tagged (template/exemplar) document for the workspace. */
+  async function loadRoleLinks() {
+    roleLinks.value = await api.listDocumentRoleLinks(workspace.requireId())
+  }
+
+  /** The current template link for a kind (singular), if any. */
+  function templateFor(docKind: DocKind): SourceDocument | undefined {
+    return roleLinks.value.find((d) => d.role === 'template' && d.docKind === docKind)
+  }
+
+  /** The exemplar links for a kind (multi-valued). */
+  function exemplarsFor(docKind: DocKind): SourceDocument[] {
+    return roleLinks.value.filter((d) => d.role === 'exemplar' && d.docKind === docKind)
+  }
+
+  /**
+   * Tag an imported document as the workspace's template (singular per kind) or exemplar for a
+   * kind, then reconcile the local list (a template replaces the prior one for its kind).
+   */
+  async function linkForKind(
+    source: DocumentSourceKind,
+    externalId: string,
+    role: DocumentLinkRole,
+    docKind: DocKind,
+  ) {
+    const doc = await api.linkDocumentForKind(workspace.requireId(), {
+      source,
+      externalId,
+      role,
+      docKind,
+    })
+    const key = (d: SourceDocument) => `${d.source}:${d.externalId}`
+    // Drop any row for this doc, plus the prior template for this kind (singular replace).
+    roleLinks.value = roleLinks.value.filter(
+      (d) =>
+        key(d) !== key(doc) &&
+        !(role === 'template' && d.role === 'template' && d.docKind === docKind),
+    )
+    roleLinks.value.push(doc)
+    return doc
+  }
+
+  /** Clear a document's role tag (built-in template resumes for the kind / exemplar drops). */
+  async function unlinkForKind(source: DocumentSourceKind, externalId: string) {
+    await api.unlinkDocumentForKind(workspace.requireId(), { source, externalId })
+    roleLinks.value = roleLinks.value.filter(
+      (d) => !(d.source === source && d.externalId === externalId),
+    )
+  }
+
   return {
     available,
     sources,
@@ -137,5 +195,11 @@ export const useDocumentsStore = defineStore('documents', () => {
     plan,
     spawn,
     linkToBlock,
+    roleLinks,
+    loadRoleLinks,
+    templateFor,
+    exemplarsFor,
+    linkForKind,
+    unlinkForKind,
   }
 })

package/app/stores/ui.ts

@@ -56,6 +56,9 @@ export const useUiStore = defineStore('ui', () => {
     source: DocumentSourceKind | null
     targetFrameId: string | null
   } | null>(null)
+  // The workspace+DocKind template / exemplar management modal (WS1). A single boolean —
+  // it manages every kind's links in one place.
+  const documentTemplates = ref(false)
   const spawnPreview = ref<{
     source: DocumentSourceKind
     externalId: string
@@ -390,6 +393,13 @@ export const useUiStore = defineStore('ui', () => {
   function closeDocumentImport() {
     documentImport.value = null
   }
+  function openDocumentTemplates() {
+    resetHubReturn()
+    documentTemplates.value = true
+  }
+  function closeDocumentTemplates() {
+    documentTemplates.value = false
+  }
   function openSpawnPreview(
     source: DocumentSourceKind,
     externalId: string,
@@ -796,6 +806,7 @@ export const useUiStore = defineStore('ui', () => {
     decisionContext,
     documentConnect,
     documentImport,
+    documentTemplates,
     spawnPreview,
     taskConnect,
     taskImport,
@@ -866,6 +877,8 @@ export const useUiStore = defineStore('ui', () => {
     closeDocumentConnect,
     openDocumentImport,
     closeDocumentImport,
+    openDocumentTemplates,
+    closeDocumentTemplates,
     openSpawnPreview,
     closeSpawnPreview,
     openTaskConnect,

package/app/types/documents.ts

@@ -10,6 +10,7 @@
 
 export type {
   DocumentSourceKind,
+  DocumentLinkRole,
   CredentialField,
   DocumentSourceDescriptor,
   DocumentConnection,

package/i18n/locales/en.json

@@ -210,7 +210,10 @@
           "label": "Options to compare",
           "placeholder": "The options to weigh against each other"
         },
-        "apiSurface": { "label": "API surface", "placeholder": "The endpoints or surface in scope" }
+        "apiSurface": {
+          "label": "API surface",
+          "placeholder": "The endpoints or surface in scope"
+        }
       },
       "optional": "optional",
       "pipeline": "Pipeline",
@@ -1634,6 +1637,9 @@
         "localRunners": {
           "label": "My local runners",
           "description": "Your own-machine model runners (Ollama, LM Studio, vLLM…)."
+        },
+        "documentTemplates": {
+          "label": "Templates & examples"
         }
       }
     }
@@ -2772,6 +2778,26 @@
       "empty": "Attach a requirement, RFC or PRD so agents see it while implementing this task.",
       "attached": "Document attached",
       "attachFailed": "Could not attach"
+    },
+    "templates": {
+      "title": "Document templates & examples",
+      "intro": "Point a document kind at your own template and example documents. They must be imported first via the Documents integration. A template's sections replace the built-in skeleton for that kind; the examples guide the author agents.",
+      "kindLabel": "Document kind",
+      "importFirst": "Import a document first — a template or example is one of your imported documents.",
+      "importButton": "Import a document",
+      "templateHeading": "Template",
+      "templateHint": "Overrides the built-in {kind} skeleton. One template per kind.",
+      "templateEmpty": "Using the built-in template.",
+      "exemplarsHeading": "Examples to emulate",
+      "exemplarsHint": "Good examples the author agents study, added to the built-in set.",
+      "exemplarsEmpty": "No examples linked.",
+      "pickLabel": "Imported document",
+      "pickPlaceholder": "Choose an imported document…",
+      "setTemplate": "Set as template",
+      "addExemplar": "Add example",
+      "remove": "Remove",
+      "linkFailed": "Couldn't update the document link",
+      "loadFailed": "Couldn't load document templates"
     }
   },
   "tasks": {

package/i18n/locales/es.json

@@ -1584,6 +1584,9 @@
         "localRunners": {
           "label": "Mis ejecutores locales",
           "description": "Tus ejecutores de modelos en tu propia máquina (Ollama, LM Studio, vLLM…)."
+        },
+        "documentTemplates": {
+          "label": "Plantillas y ejemplos"
         }
       }
     },
@@ -2702,6 +2705,26 @@
       "empty": "Adjunta un requisito, RFC o PRD para que los agentes lo vean mientras implementan esta tarea.",
       "attached": "Documento adjuntado",
       "attachFailed": "No se pudo adjuntar"
+    },
+    "templates": {
+      "title": "Plantillas y ejemplos de documentos",
+      "intro": "Asigna a un tipo de documento tu propia plantilla y documentos de ejemplo. Primero deben importarse mediante la integración de Documentos. Las secciones de una plantilla reemplazan el esqueleto integrado de ese tipo; los ejemplos guían a los agentes autores.",
+      "kindLabel": "Tipo de documento",
+      "importFirst": "Importa primero un documento: una plantilla o ejemplo es uno de tus documentos importados.",
+      "importButton": "Importar un documento",
+      "templateHeading": "Plantilla",
+      "templateHint": "Reemplaza el esqueleto integrado de {kind}. Una plantilla por tipo.",
+      "templateEmpty": "Usando la plantilla integrada.",
+      "exemplarsHeading": "Ejemplos a emular",
+      "exemplarsHint": "Buenos ejemplos que estudian los agentes autores, añadidos al conjunto integrado.",
+      "exemplarsEmpty": "No hay ejemplos vinculados.",
+      "pickLabel": "Documento importado",
+      "pickPlaceholder": "Elige un documento importado…",
+      "setTemplate": "Establecer como plantilla",
+      "addExemplar": "Añadir ejemplo",
+      "remove": "Quitar",
+      "linkFailed": "No se pudo actualizar el vínculo del documento",
+      "loadFailed": "No se pudieron cargar las plantillas de documentos"
     }
   },
   "tasks": {

package/i18n/locales/fr.json

@@ -1584,6 +1584,9 @@
         "localRunners": {
           "label": "Mes exécuteurs locaux",
           "description": "Vos exécuteurs de modèles sur votre propre machine (Ollama, LM Studio, vLLM…)."
+        },
+        "documentTemplates": {
+          "label": "Modèles et exemples"
         }
       }
     },
@@ -2702,6 +2705,26 @@
       "empty": "Joignez une exigence, un RFC ou un PRD pour que les agents le voient pendant l'implémentation de cette tâche.",
       "attached": "Document joint",
       "attachFailed": "Impossible de joindre"
+    },
+    "templates": {
+      "title": "Modèles et exemples de documents",
+      "intro": "Associez à un type de document votre propre modèle et des documents d'exemple. Ils doivent d'abord être importés via l'intégration Documents. Les sections d'un modèle remplacent le squelette intégré de ce type ; les exemples guident les agents rédacteurs.",
+      "kindLabel": "Type de document",
+      "importFirst": "Importez d'abord un document : un modèle ou un exemple est l'un de vos documents importés.",
+      "importButton": "Importer un document",
+      "templateHeading": "Modèle",
+      "templateHint": "Remplace le squelette intégré de {kind}. Un modèle par type.",
+      "templateEmpty": "Utilisation du modèle intégré.",
+      "exemplarsHeading": "Exemples à suivre",
+      "exemplarsHint": "De bons exemples que les agents rédacteurs étudient, ajoutés à l'ensemble intégré.",
+      "exemplarsEmpty": "Aucun exemple lié.",
+      "pickLabel": "Document importé",
+      "pickPlaceholder": "Choisissez un document importé…",
+      "setTemplate": "Définir comme modèle",
+      "addExemplar": "Ajouter un exemple",
+      "remove": "Retirer",
+      "linkFailed": "Impossible de mettre à jour le lien du document",
+      "loadFailed": "Impossible de charger les modèles de documents"
     }
   },
   "tasks": {

package/i18n/locales/he.json

@@ -156,7 +156,10 @@
           "label": "משתמשי היעד",
           "placeholder": "למי מיועד המסמך ואילו משימות הם מבצעים"
         },
-        "successMetrics": { "label": "מדדי הצלחה", "placeholder": "תוצאות מדידות שמראות שזה עובד" },
+        "successMetrics": {
+          "label": "מדדי הצלחה",
+          "placeholder": "תוצאות מדידות שמראות שזה עובד"
+        },
         "alternativesConsidered": {
           "label": "חלופות שנשקלו",
           "placeholder": "גישות אחרות שנשקלו ומדוע נפסלו"
@@ -189,7 +192,10 @@
           "label": "אפשרויות להשוואה",
           "placeholder": "האפשרויות שיש לשקול זו מול זו"
         },
-        "apiSurface": { "label": "משטח ה-API", "placeholder": "נקודות הקצה או המשטח שבתחום" }
+        "apiSurface": {
+          "label": "משטח ה-API",
+          "placeholder": "נקודות הקצה או המשטח שבתחום"
+        }
       },
       "optional": "אופציונלי",
       "pipeline": "צינור",
@@ -1578,6 +1584,9 @@
         "localRunners": {
           "label": "המריצים המקומיים שלי",
           "description": "מריצי מודלים על המכונה שלך (Ollama, LM Studio, vLLM…)."
+        },
+        "documentTemplates": {
+          "label": "תבניות ודוגמאות"
         }
       }
     },
@@ -2707,6 +2716,26 @@
       "empty": "צרף דרישה, RFC או PRD כדי שהסוכנים יראו אותם בעת מימוש משימה זו.",
       "attached": "המסמך צורף",
       "attachFailed": "לא ניתן לצרף"
+    },
+    "templates": {
+      "title": "תבניות ודוגמאות למסמכים",
+      "intro": "כוונו סוג מסמך לתבנית משלכם ולמסמכי דוגמה. יש לייבא אותם תחילה דרך שילוב המסמכים. הסעיפים של תבנית מחליפים את השלד המובנה של אותו סוג; הדוגמאות מנחות את סוכני הכתיבה.",
+      "kindLabel": "סוג מסמך",
+      "importFirst": "ייבאו קודם מסמך — תבנית או דוגמה היא אחד מהמסמכים המיובאים שלכם.",
+      "importButton": "ייבוא מסמך",
+      "templateHeading": "תבנית",
+      "templateHint": "מחליפה את השלד המובנה של {kind}. תבנית אחת לכל סוג.",
+      "templateEmpty": "נעשה שימוש בתבנית המובנית.",
+      "exemplarsHeading": "דוגמאות לחיקוי",
+      "exemplarsHint": "דוגמאות טובות שסוכני הכתיבה לומדים, נוספות למערך המובנה.",
+      "exemplarsEmpty": "לא מקושרות דוגמאות.",
+      "pickLabel": "מסמך מיובא",
+      "pickPlaceholder": "בחרו מסמך מיובא…",
+      "setTemplate": "הגדר כתבנית",
+      "addExemplar": "הוסף דוגמה",
+      "remove": "הסר",
+      "linkFailed": "לא ניתן לעדכן את קישור המסמך",
+      "loadFailed": "לא ניתן היה לטעון את תבניות המסמכים"
     }
   },
   "tasks": {

package/i18n/locales/ja.json

@@ -184,7 +184,10 @@
           "label": "エスカレーション経路",
           "placeholder": "失敗時の連絡先とエスカレーション方法"
         },
-        "researchQuestion": { "label": "リサーチの問い", "placeholder": "答えるべき問いや仮説" },
+        "researchQuestion": {
+          "label": "リサーチの問い",
+          "placeholder": "答えるべき問いや仮説"
+        },
         "optionsToCompare": {
           "label": "比較する選択肢",
           "placeholder": "互いに比較検討する選択肢"
@@ -1581,6 +1584,9 @@
         "localRunners": {
           "label": "マイローカルランナー",
           "description": "自分のマシンで動かすモデルランナー (Ollama、LM Studio、vLLM…)。"
+        },
+        "documentTemplates": {
+          "label": "テンプレートと例"
         }
       }
     },
@@ -2711,6 +2717,26 @@
       "empty": "要件、RFC、PRD を添付すると、このタスクの実装中にエージェントが参照できます。",
       "attached": "ドキュメントを添付しました",
       "attachFailed": "添付できませんでした"
+    },
+    "templates": {
+      "title": "ドキュメントのテンプレートと例",
+      "intro": "ドキュメントの種類に独自のテンプレートと例のドキュメントを割り当てます。まずドキュメント連携でインポートする必要があります。テンプレートのセクションはその種類の組み込みスケルトンを置き換え、例は作成エージェントの指針になります。",
+      "kindLabel": "ドキュメントの種類",
+      "importFirst": "先にドキュメントをインポートしてください。テンプレートや例はインポート済みのドキュメントから選びます。",
+      "importButton": "ドキュメントをインポート",
+      "templateHeading": "テンプレート",
+      "templateHint": "{kind} の組み込みスケルトンを置き換えます。種類ごとに1つ。",
+      "templateEmpty": "組み込みテンプレートを使用しています。",
+      "exemplarsHeading": "手本にする例",
+      "exemplarsHint": "作成エージェントが参考にする良い例で、組み込みの一覧に追加されます。",
+      "exemplarsEmpty": "リンクされた例はありません。",
+      "pickLabel": "インポート済みドキュメント",
+      "pickPlaceholder": "インポート済みドキュメントを選択…",
+      "setTemplate": "テンプレートに設定",
+      "addExemplar": "例を追加",
+      "remove": "削除",
+      "linkFailed": "ドキュメントのリンクを更新できませんでした",
+      "loadFailed": "ドキュメントテンプレートを読み込めませんでした"
     }
   },
   "tasks": {

package/i18n/locales/pl.json

@@ -1584,6 +1584,9 @@
         "localRunners": {
           "label": "Moje lokalne silniki",
           "description": "Twoje silniki modeli na własnej maszynie (Ollama, LM Studio, vLLM…)."
+        },
+        "documentTemplates": {
+          "label": "Szablony i przykłady"
         }
       }
     },
@@ -2702,6 +2705,26 @@
       "empty": "Dołącz wymaganie, dokument RFC lub PRD, aby agenci widzieli je podczas realizacji tego zadania.",
       "attached": "Dokument dołączony",
       "attachFailed": "Nie udało się dołączyć"
+    },
+    "templates": {
+      "title": "Szablony i przykłady dokumentów",
+      "intro": "Przypisz typowi dokumentu własny szablon i przykładowe dokumenty. Najpierw trzeba je zaimportować przez integrację Dokumentów. Sekcje szablonu zastępują wbudowany szkielet danego typu; przykłady są wskazówką dla agentów piszących.",
+      "kindLabel": "Typ dokumentu",
+      "importFirst": "Najpierw zaimportuj dokument — szablon lub przykład to jeden z zaimportowanych dokumentów.",
+      "importButton": "Zaimportuj dokument",
+      "templateHeading": "Szablon",
+      "templateHint": "Zastępuje wbudowany szkielet {kind}. Jeden szablon na typ.",
+      "templateEmpty": "Używany jest wbudowany szablon.",
+      "exemplarsHeading": "Przykłady do naśladowania",
+      "exemplarsHint": "Dobre przykłady, które studiują agenci piszący, dodane do wbudowanego zestawu.",
+      "exemplarsEmpty": "Brak powiązanych przykładów.",
+      "pickLabel": "Zaimportowany dokument",
+      "pickPlaceholder": "Wybierz zaimportowany dokument…",
+      "setTemplate": "Ustaw jako szablon",
+      "addExemplar": "Dodaj przykład",
+      "remove": "Usuń",
+      "linkFailed": "Nie udało się zaktualizować powiązania dokumentu",
+      "loadFailed": "Nie udało się wczytać szablonów dokumentów"
     }
   },
   "tasks": {

package/i18n/locales/tr.json

@@ -192,7 +192,10 @@
           "label": "Karşılaştırılacak seçenekler",
           "placeholder": "Birbirine karşı tartılacak seçenekler"
         },
-        "apiSurface": { "label": "API yüzeyi", "placeholder": "Kapsamdaki uç noktalar veya yüzey" }
+        "apiSurface": {
+          "label": "API yüzeyi",
+          "placeholder": "Kapsamdaki uç noktalar veya yüzey"
+        }
       },
       "optional": "isteğe bağlı",
       "pipeline": "İşlem hattı",
@@ -1581,6 +1584,9 @@
         "localRunners": {
           "label": "Yerel runner'larım",
           "description": "Kendi makinenizdeki model runner'ları (Ollama, LM Studio, vLLM…)."
+        },
+        "documentTemplates": {
+          "label": "Şablonlar ve örnekler"
         }
       }
     },
@@ -2711,6 +2717,26 @@
       "empty": "Agentların bu görevi uygularken görebilmesi için bir gereksinim, RFC veya PRD ekle.",
       "attached": "Belge eklendi",
       "attachFailed": "Eklenemedi"
+    },
+    "templates": {
+      "title": "Belge şablonları ve örnekleri",
+      "intro": "Bir belge türüne kendi şablonunuzu ve örnek belgelerinizi atayın. Önce Belgeler entegrasyonu ile içe aktarılmaları gerekir. Bir şablonun bölümleri, o türün yerleşik iskeletinin yerini alır; örnekler yazar aracılara rehberlik eder.",
+      "kindLabel": "Belge türü",
+      "importFirst": "Önce bir belge içe aktarın — şablon veya örnek, içe aktardığınız belgelerden biridir.",
+      "importButton": "Belge içe aktar",
+      "templateHeading": "Şablon",
+      "templateHint": "{kind} için yerleşik iskeletin yerini alır. Tür başına bir şablon.",
+      "templateEmpty": "Yerleşik şablon kullanılıyor.",
+      "exemplarsHeading": "Örnek alınacak belgeler",
+      "exemplarsHint": "Yazar aracıların incelediği iyi örnekler, yerleşik kümeye eklenir.",
+      "exemplarsEmpty": "Bağlı örnek yok.",
+      "pickLabel": "İçe aktarılan belge",
+      "pickPlaceholder": "İçe aktarılan bir belge seçin…",
+      "setTemplate": "Şablon olarak ayarla",
+      "addExemplar": "Örnek ekle",
+      "remove": "Kaldır",
+      "linkFailed": "Belge bağlantısı güncellenemedi",
+      "loadFailed": "Belge şablonları yüklenemedi"
     }
   },
   "tasks": {

package/i18n/locales/uk.json

@@ -1584,6 +1584,9 @@
         "localRunners": {
           "label": "Мої локальні виконавці",
           "description": "Ваші виконавці моделей на власній машині (Ollama, LM Studio, vLLM…)."
+        },
+        "documentTemplates": {
+          "label": "Шаблони та приклади"
         }
       }
     },
@@ -2702,6 +2705,26 @@
       "empty": "Долучіть вимогу, RFC або PRD, щоб агенти бачили їх під час реалізації цього завдання.",
       "attached": "Документ долучено",
       "attachFailed": "Не вдалося долучити"
+    },
+    "templates": {
+      "title": "Шаблони та приклади документів",
+      "intro": "Призначте типу документа власний шаблон і приклади документів. Спершу їх потрібно імпортувати через інтеграцію Документів. Розділи шаблону замінюють вбудований каркас цього типу; приклади скеровують агентів-авторів.",
+      "kindLabel": "Тип документа",
+      "importFirst": "Спершу імпортуйте документ — шаблон або приклад це один із ваших імпортованих документів.",
+      "importButton": "Імпортувати документ",
+      "templateHeading": "Шаблон",
+      "templateHint": "Замінює вбудований каркас {kind}. Один шаблон на тип.",
+      "templateEmpty": "Використовується вбудований шаблон.",
+      "exemplarsHeading": "Приклади для наслідування",
+      "exemplarsHint": "Гарні приклади, які вивчають агенти-автори, додані до вбудованого набору.",
+      "exemplarsEmpty": "Немає пов'язаних прикладів.",
+      "pickLabel": "Імпортований документ",
+      "pickPlaceholder": "Виберіть імпортований документ…",
+      "setTemplate": "Встановити як шаблон",
+      "addExemplar": "Додати приклад",
+      "remove": "Видалити",
+      "linkFailed": "Не вдалося оновити зв'язок документа",
+      "loadFailed": "Не вдалося завантажити шаблони документів"
     }
   },
   "tasks": {

package/package.json

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