@cat-factory/app 0.220.0 → 0.221.1

package/app/components/documents/DocumentOriginLink.vue

@@ -0,0 +1,30 @@
+<script setup lang="ts">
+// A stored document rendered as a link to its origin page, or as a plain element when it has none.
+//
+// Not every document came from a page: an `upload` is a body handed to the platform through the
+// public API, so it stores an empty `url`. An anchor with an empty `href` navigates to the current
+// page, which reads as a link that BROKE rather than as a document that never had one — the same
+// distinction kernel's `originSuffix` / `originHeaderLine` draw for the agent-facing renderers.
+// One component so the three places the SPA lists documents cannot each get it half right.
+//
+// `hoverClass` is the caller's hover affordance, applied ONLY when there is somewhere to go: a
+// hover style on an element that does not navigate is the same lie as the empty `href`, one
+// rendering later. It lives here rather than at each call site so a caller cannot pass the style
+// and forget the condition.
+const props = defineProps<{ url: string; hoverClass?: string }>()
+const { t } = useI18n()
+</script>
+
+<template>
+  <component
+    :is="props.url ? 'a' : 'span'"
+    :class="props.url ? props.hoverClass : undefined"
+    v-bind="
+      props.url
+        ? { href: props.url, title: props.url, target: '_blank', rel: 'noopener' }
+        : { title: t('documents.taskDocs.uploadedHint') }
+    "
+  >
+    <slot />
+  </component>
+</template>

package/app/components/documents/DocumentTemplatesModal.vue

@@ -1,6 +1,7 @@
 <script setup lang="ts">
 import { DOC_KINDS } from '~/types/domain'
 import type { DocKind, DocumentLinkRole, SourceDocument } from '~/types/domain'
+import DocumentOriginLink from '~/components/documents/DocumentOriginLink.vue'
 import IntegrationBackTitle from '~/components/layout/IntegrationBackTitle.vue'
 
 // Manage the workspace's per-DocKind TEMPLATE (singular) + EXEMPLAR (multi) document links (WS1).
@@ -156,14 +157,13 @@ async function unlink(doc: SourceDocument) {
               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"
+              <DocumentOriginLink
+                :url="template.url"
+                class="truncate text-sm font-medium text-white"
+                hover-class="hover:underline"
               >
                 {{ template.title }}
-              </a>
+              </DocumentOriginLink>
               <UButton
                 color="neutral"
                 variant="ghost"
@@ -194,14 +194,13 @@ async function unlink(doc: SourceDocument) {
                 :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"
+                <DocumentOriginLink
+                  :url="doc.url"
+                  class="truncate text-sm font-medium text-white"
+                  hover-class="hover:underline"
                 >
                   {{ doc.title }}
-                </a>
+                </DocumentOriginLink>
                 <UButton
                   color="neutral"
                   variant="ghost"

package/app/components/documents/TaskContextDocs.vue

@@ -2,6 +2,7 @@
 import type { DropdownMenuItem } from '@nuxt/ui'
 import type { Block } from '~/types/domain'
 import ContextDocumentPicker from '~/components/documents/ContextDocumentPicker.vue'
+import DocumentOriginLink from '~/components/documents/DocumentOriginLink.vue'
 import InspectorSection from '~/components/panels/inspector/InspectorSection.vue'
 
 // Documents (from any source) attached to a task OR an initiative as agent
@@ -129,21 +130,19 @@ async function attach(item: PendingContext) {
     />
 
     <div v-if="linked.length" class="space-y-1">
-      <a
+      <DocumentOriginLink
         v-for="doc in linked"
         :key="`${doc.source}:${doc.externalId}`"
-        :href="doc.url"
-        :title="doc.url"
-        target="_blank"
-        rel="noopener"
-        class="flex items-center gap-1.5 rounded-md border border-slate-800 bg-slate-900/60 px-2 py-1.5 text-xs text-slate-300 hover:bg-slate-800/60"
+        :url="doc.url"
+        class="flex items-center gap-1.5 rounded-md border border-slate-800 bg-slate-900/60 px-2 py-1.5 text-xs text-slate-300"
+        hover-class="hover:bg-slate-800/60"
       >
         <UIcon
-          :name="documents.descriptorFor(doc.source)?.icon ?? 'i-lucide-file-text'"
+          :name="documents.descriptorForOrigin(doc.source)?.icon ?? 'i-lucide-file-text'"
           class="h-3.5 w-3.5 shrink-0 text-indigo-400"
         />
         <span class="truncate">{{ doc.title }}</span>
-      </a>
+      </DocumentOriginLink>
     </div>
     <p v-else class="text-[11px] text-slate-500">
       {{ emptyHint }}

package/app/composables/api/documents.ts

@@ -13,7 +13,7 @@ import {
   spawnDocumentContract,
   unlinkDocumentForKindContract,
 } from '@cat-factory/contracts'
-import type { DocKind, DocumentLinkRole, DocumentSourceKind } from '~/types/domain'
+import type { DocKind, DocumentLinkRole, DocumentOrigin, DocumentSourceKind } from '~/types/domain'
 import type { ApiContext } from './context'
 
 /** Document sources (Confluence, Notion, …): connect, import, search, board-spawn. */
@@ -73,7 +73,7 @@ export function documentsApi({ send, ws }: ApiContext) {
 
     linkDocument: (
       workspaceId: string,
-      body: { source: DocumentSourceKind; externalId: string; blockId: string },
+      body: { source: DocumentOrigin; externalId: string; blockId: string },
     ) => send(linkDocumentContract, { pathPrefix: ws(workspaceId), body }),
 
     // ---- workspace+DocKind template / exemplar links (WS1) ----------------
@@ -83,7 +83,7 @@ export function documentsApi({ send, ws }: ApiContext) {
     linkDocumentForKind: (
       workspaceId: string,
       body: {
-        source: DocumentSourceKind
+        source: DocumentOrigin
         externalId: string
         role: DocumentLinkRole
         docKind: DocKind
@@ -92,7 +92,7 @@ export function documentsApi({ send, ws }: ApiContext) {
 
     unlinkDocumentForKind: (
       workspaceId: string,
-      body: { source: DocumentSourceKind; externalId: string },
+      body: { source: DocumentOrigin; externalId: string },
     ) => send(unlinkDocumentForKindContract, { pathPrefix: ws(workspaceId), body }),
   }
 }

package/app/composables/useContextLinking.ts

@@ -168,13 +168,30 @@ export function useContextLinking() {
    * would make it a variable, which defeats both the typed-message-key check and the extractor's
    * static scan — and the plural choice has to be made against the same count.
    */
+  /**
+   * A failure's line in the toast: TRANSLATED copy where the backend named a reason we have a
+   * key for, else the server's own prose.
+   *
+   * The backend does not localize (it emits `details.reason`), so a refusal a user routinely
+   * hits — attaching a document another task already holds — would otherwise reach them as
+   * English prose in every locale. The full diagnostic dump keeps the raw message regardless,
+   * so nothing is lost for support.
+   */
+  function describeFailure(failure: LinkFailure): string {
+    const reason = failure.details?.reason
+    if (reason === 'document_already_linked') {
+      return t('errors.conflict.description.document_already_linked')
+    }
+    return failure.message
+  }
+
   function presentLinkFailures(
     failures: LinkFailure[],
     blockId?: string,
     opts: { title?: (count: number) => string } = {},
   ): void {
     if (failures.length === 0) return
-    const description = failures.map((f) => `${f.item.title}: ${f.message}`).join('\n')
+    const description = failures.map((f) => `${f.item.title}: ${describeFailure(f)}`).join('\n')
     const report = buildLinkFailureReport(failures, {
       workspaceId: workspace.workspaceId,
       blockId,

package/app/composables/usePipelineErrorToast.ts

@@ -256,6 +256,10 @@ const CONFLICT_INFO: Record<Exclude<ConflictReason, BespokeConflictReason>, Conf
     titleKey: 'errors.conflict.title.ticket_already_linked',
     descriptionKey: 'errors.conflict.description.ticket_already_linked',
   },
+  document_already_linked: {
+    titleKey: 'errors.conflict.title.document_already_linked',
+    descriptionKey: 'errors.conflict.description.document_already_linked',
+  },
 }
 
 /**

package/app/stores/documents.ts

@@ -6,10 +6,12 @@ import type {
   DocumentConnection,
   DocumentLinkRole,
   DocumentSearchResult,
+  DocumentOrigin,
   DocumentSourceDescriptor,
   DocumentSourceKind,
   SourceDocument,
 } from '~/types/domain'
+import { isConnectableSource } from '@cat-factory/contracts'
 import { useSourceIntegration } from '~/composables/useSourceIntegration'
 import { useUpsertList } from '~/composables/useUpsertList'
 import { useWorkspaceStore } from '~/stores/workspace'
@@ -119,8 +121,21 @@ export const useDocumentsStore = defineStore('documents', () => {
     return result
   }
 
+  /**
+   * The descriptor for a STORED document's origin, or undefined when it has none.
+   *
+   * `descriptorFor` is keyed by a connectable `DocumentSourceKind`, and a stored document's
+   * origin is wider than that: an `upload` was handed to the platform through the API and has no
+   * source behind it to describe. Narrowing through the predicate DERIVED from the source
+   * picklist is what keeps that a typed absence rather than an `undefined` the caller trips over,
+   * and what makes adding a source fail the build here until it is handled.
+   */
+  function descriptorForOrigin(origin: DocumentOrigin): DocumentSourceDescriptor | undefined {
+    return isConnectableSource(origin) ? descriptorFor(origin) : undefined
+  }
+
   /** Attach an imported page to a block as agent context. */
-  async function linkToBlock(blockId: string, source: DocumentSourceKind, externalId: string) {
+  async function linkToBlock(blockId: string, source: DocumentOrigin, externalId: string) {
     const doc = await api.linkDocument(workspace.requireId(), { source, externalId, blockId })
     upsertDoc(doc)
     return doc
@@ -148,7 +163,7 @@ export const useDocumentsStore = defineStore('documents', () => {
    * kind, then reconcile the local list (a template replaces the prior one for its kind).
    */
   async function linkForKind(
-    source: DocumentSourceKind,
+    source: DocumentOrigin,
     externalId: string,
     role: DocumentLinkRole,
     docKind: DocKind,
@@ -171,7 +186,7 @@ export const useDocumentsStore = defineStore('documents', () => {
   }
 
   /** Clear a document's role tag (built-in template resumes for the kind / exemplar drops). */
-  async function unlinkForKind(source: DocumentSourceKind, externalId: string) {
+  async function unlinkForKind(source: DocumentOrigin, externalId: string) {
     await api.unlinkDocumentForKind(workspace.requireId(), { source, externalId })
     roleLinks.value = roleLinks.value.filter(
       (d) => !(d.source === source && d.externalId === externalId),
@@ -187,6 +202,7 @@ export const useDocumentsStore = defineStore('documents', () => {
     connectedSources,
     anyConnected,
     descriptorFor,
+    descriptorForOrigin,
     connectionFor,
     isConnected,
     docsForBlock,

package/app/types/documents.ts

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

package/i18n/locales/de.json

@@ -3681,7 +3681,8 @@
       "connectSourceNamed": "{source} verbinden",
       "empty": "Hängen Sie eine Anforderung, ein RFC oder ein PRD an, damit Agents es beim Umsetzen dieser Aufgabe sehen.",
       "emptyInitiative": "Hängen Sie eine Anforderung, ein RFC oder ein PRD an, damit die Planungsagenten es beim Entwerfen dieser Initiative lesen.",
-      "attached": "Dokument angehängt"
+      "attached": "Dokument angehängt",
+      "uploadedHint": "Über die API hochgeladen, daher gibt es keine Quellseite zum Öffnen."
     },
     "templates": {
       "title": "Dokumentvorlagen & Beispiele",
@@ -5201,6 +5202,7 @@
         "input_gate_not_parked": "Nichts zu beantworten",
         "input_gate_parked": "Über die Eingabeprüfung der Aufgabe beantworten",
         "ticket_already_linked": "Dieses Ticket hat bereits eine Aufgabe",
+        "document_already_linked": "Dokument bereits angehängt",
         "dry_run_not_mergeable": "Probelauf kann nicht zusammengeführt werden"
       },
       "description": {
@@ -5237,6 +5239,7 @@
         "input_gate_not_parked": "Dieser Lauf wartet nicht mehr auf seine Eingabeprüfung. Möglicherweise hat sie jemand schon beantwortet oder der Lauf ist weitergelaufen.",
         "input_gate_parked": "Dieser Lauf wartet auf seine Eingabeprüfung, die über die Freigabe nicht beantwortet werden kann. Nutzen Sie den Hinweis am Lauf: Aufgabe ergänzen und erneut prüfen, oder trotzdem ausführen.",
         "ticket_already_linked": "Ein Ticket kann nur eine Aufgabe stützen. Es erneut zu verknüpfen würde der bestehenden Aufgabe genau den Kontext entziehen, mit dem sie angelegt wurde. Öffne stattdessen diese Aufgabe oder hebe die Verknüpfung des Tickets zuerst auf.",
+        "document_already_linked": "Dieses Dokument ist an eine andere Aufgabe angehängt. Lösen Sie es dort zuerst, oder hängen Sie eine separate Kopie an.",
         "dry_run_not_mergeable": "Dieser Pull Request stammt aus einem Probelauf und kann hier nicht zusammengeführt werden. Starte die Aufgabe erneut als echten Lauf, um einen Pull Request zu erzeugen, den dieser Arbeitsbereich zusammenführt."
       },
       "action": {

package/i18n/locales/en.json

@@ -643,6 +643,7 @@
         "input_gate_not_parked": "Nothing to answer",
         "input_gate_parked": "Answer it in the task's input check",
         "ticket_already_linked": "This issue already has a task",
+        "document_already_linked": "Document already attached",
         "dry_run_not_mergeable": "Dry run cannot be merged"
       },
       "description": {
@@ -682,6 +683,7 @@
         "input_gate_not_parked": "This run is not waiting on its input check any more. Someone may have answered it already, or the run has moved on.",
         "input_gate_parked": "This run is parked on its input check, which the approval rail cannot answer. Use the notice on the run: fix the task and re-check, or run it anyway.",
         "ticket_already_linked": "An issue can back only one task, so linking it again would strip the existing task of the context it was created with. Open that task instead, or unlink the issue first.",
+        "document_already_linked": "That document is attached to another task. Detach it there first, or attach a separate copy.",
         "dry_run_not_mergeable": "This pull request came from a dry run, so it can't be merged from here. Start the task again as a live run to produce a pull request this workspace will merge."
       },
       "action": {
@@ -4185,7 +4187,8 @@
       "connectSourceNamed": "Connect {source}",
       "empty": "Attach a requirement, RFC or PRD so agents see it while implementing this task.",
       "emptyInitiative": "Attach a requirement, RFC or PRD so the planning agents read it while shaping this initiative.",
-      "attached": "Document attached"
+      "attached": "Document attached",
+      "uploadedHint": "Uploaded through the API, so there is no source page to open."
     },
     "templates": {
       "title": "Document templates & examples",

package/i18n/locales/es.json

@@ -577,6 +577,7 @@
         "input_gate_not_parked": "Nada que responder",
         "input_gate_parked": "Respóndelo en la comprobación de entrada de la tarea",
         "ticket_already_linked": "Esta incidencia ya tiene una tarea",
+        "document_already_linked": "El documento ya está adjunto",
         "dry_run_not_mergeable": "Una ejecución de prueba no se puede fusionar"
       },
       "description": {
@@ -613,6 +614,7 @@
         "input_gate_not_parked": "Esta ejecución ya no espera su comprobación de entrada. Puede que alguien la haya respondido o que la ejecución haya avanzado.",
         "input_gate_parked": "Esta ejecución está detenida en su comprobación de entrada, que la vía de aprobación no puede resolver. Usa el aviso de la ejecución: corrige la tarea y vuelve a comprobar, o ejecútala de todos modos.",
         "ticket_already_linked": "Una incidencia solo puede respaldar una tarea, así que volver a vincularla dejaría a la tarea existente sin el contexto con el que se creó. Abre esa tarea o desvincula antes la incidencia.",
+        "document_already_linked": "Ese documento está adjunto a otra tarea. Sepáralo allí primero o adjunta una copia aparte.",
         "dry_run_not_mergeable": "Esta pull request proviene de una ejecución de prueba, así que no se puede fusionar desde aquí. Vuelve a iniciar la tarea como ejecución real para producir una pull request que este espacio de trabajo sí fusionará."
       },
       "action": {
@@ -4060,7 +4062,8 @@
       "connectSourceNamed": "Conectar {source}",
       "empty": "Adjunta un requisito, RFC o PRD para que los agentes lo vean mientras implementan esta tarea.",
       "emptyInitiative": "Adjunta un requisito, RFC o PRD para que los agentes de planificación lo lean al redactar esta iniciativa.",
-      "attached": "Documento adjuntado"
+      "attached": "Documento adjuntado",
+      "uploadedHint": "Subido a través de la API, por lo que no hay página de origen que abrir."
     },
     "templates": {
       "title": "Plantillas y ejemplos de documentos",

package/i18n/locales/fr.json

@@ -577,6 +577,7 @@
         "input_gate_not_parked": "Rien à répondre",
         "input_gate_parked": "Répondez-y dans la vérification d'entrée de la tâche",
         "ticket_already_linked": "Ce ticket a déjà une tâche",
+        "document_already_linked": "Document déjà joint",
         "dry_run_not_mergeable": "Une exécution à blanc ne peut pas être fusionnée"
       },
       "description": {
@@ -613,6 +614,7 @@
         "input_gate_not_parked": "Cette exécution n'attend plus sa vérification d'entrée. Quelqu'un y a peut-être déjà répondu, ou l'exécution a avancé.",
         "input_gate_parked": "Cette exécution est en attente de sa vérification d'entrée, à laquelle la validation ne peut pas répondre. Utilisez l'avis sur l'exécution : corrigez la tâche et relancez la vérification, ou exécutez-la quand même.",
         "ticket_already_linked": "Un ticket ne peut alimenter qu'une seule tâche : le relier à nouveau priverait la tâche existante du contexte avec lequel elle a été créée. Ouvrez plutôt cette tâche, ou dissociez d'abord le ticket.",
+        "document_already_linked": "Ce document est joint à une autre tâche. Détachez-le d'abord, ou joignez-en une copie distincte.",
         "dry_run_not_mergeable": "Cette pull request provient d'une exécution à blanc et ne peut pas être fusionnée ici. Relancez la tâche en exécution réelle pour produire une pull request que cet espace de travail fusionnera."
       },
       "action": {
@@ -4060,7 +4062,8 @@
       "connectSourceNamed": "Connecter {source}",
       "empty": "Joignez une exigence, un RFC ou un PRD pour que les agents le voient pendant l'implémentation de cette tâche.",
       "emptyInitiative": "Joignez une exigence, une RFC ou un PRD pour que les agents de planification le lisent en rédigeant cette initiative.",
-      "attached": "Document joint"
+      "attached": "Document joint",
+      "uploadedHint": "Envoyé via l'API : aucune page source à ouvrir."
     },
     "templates": {
       "title": "Modèles et exemples de documents",

package/i18n/locales/he.json

@@ -577,6 +577,7 @@
         "input_gate_not_parked": "אין על מה להשיב",
         "input_gate_parked": "השיבו בבדיקת הקלט של המשימה",
         "ticket_already_linked": "לכרטיס הזה כבר יש משימה",
+        "document_already_linked": "המסמך כבר מצורף",
         "dry_run_not_mergeable": "לא ניתן למזג הרצת יבש"
       },
       "description": {
@@ -613,6 +614,7 @@
         "input_gate_not_parked": "ההרצה כבר לא ממתינה לבדיקת הקלט. ייתכן שמישהו כבר השיב, או שההרצה התקדמה.",
         "input_gate_parked": "הרצה זו ממתינה לבדיקת הקלט שלה, ומסלול האישור אינו יכול להשיב עליה. השתמשו בהודעה שעל ההרצה: תקנו את המשימה ובדקו שוב, או הריצו בכל זאת.",
         "ticket_already_linked": "כרטיס יכול לגבות משימה אחת בלבד, ולכן קישור נוסף שלו ישלול מהמשימה הקיימת את ההקשר שאיתו נוצרה. פתחו את המשימה הזו במקום זאת, או בטלו קודם את קישור הכרטיס.",
+        "document_already_linked": "המסמך מצורף למשימה אחרת. נתקו אותו שם תחילה, או צרפו עותק נפרד.",
         "dry_run_not_mergeable": "בקשת המשיכה הזו הגיעה מהרצת יבש, ולכן לא ניתן למזג אותה מכאן. הפעילו את המשימה מחדש כהרצה רגילה כדי ליצור בקשת משיכה שסביבת העבודה הזו תמזג."
       },
       "action": {
@@ -4060,7 +4062,8 @@
       "connectSourceNamed": "חבר את {source}",
       "empty": "צרף דרישה, RFC או PRD כדי שהסוכנים יראו אותם בעת מימוש משימה זו.",
       "emptyInitiative": "צרף דרישה, RFC או PRD כדי שסוכני התכנון יקראו אותם בעת גיבוש יוזמה זו.",
-      "attached": "המסמך צורף"
+      "attached": "המסמך צורף",
+      "uploadedHint": "הועלה דרך ה-API, ולכן אין דף מקור לפתיחה."
     },
     "templates": {
       "title": "תבניות ודוגמאות למסמכים",

package/i18n/locales/it.json

@@ -3681,7 +3681,8 @@
       "connectSourceNamed": "Collega {source}",
       "empty": "Allega un requisito, un RFC o un PRD così gli agenti lo vedono durante l'implementazione di questa attività.",
       "emptyInitiative": "Allega un requisito, un RFC o un PRD così gli agenti di pianificazione lo leggono mentre redigono questa iniziativa.",
-      "attached": "Documento allegato"
+      "attached": "Documento allegato",
+      "uploadedHint": "Caricato tramite l'API, quindi non c'è una pagina di origine da aprire."
     },
     "templates": {
       "title": "Modelli ed esempi di documenti",
@@ -5201,6 +5202,7 @@
         "input_gate_not_parked": "Niente a cui rispondere",
         "input_gate_parked": "Rispondi nel controllo di input dell'attività",
         "ticket_already_linked": "Questo ticket ha già un'attività",
+        "document_already_linked": "Documento già allegato",
         "dry_run_not_mergeable": "Una prova non può essere unita"
       },
       "description": {
@@ -5237,6 +5239,7 @@
         "input_gate_not_parked": "Questa esecuzione non attende più il controllo dell'input. Forse qualcuno ha già risposto, o l'esecuzione è andata avanti.",
         "input_gate_parked": "Questa esecuzione è in attesa del suo controllo di input, a cui l'approvazione non può rispondere. Usa l'avviso sull'esecuzione: correggi l'attività e ricontrolla, oppure eseguila comunque.",
         "ticket_already_linked": "Un ticket può sostenere una sola attività, quindi ricollegarlo toglierebbe all'attività esistente il contesto con cui è stata creata. Apri invece quell'attività, oppure scollega prima il ticket.",
+        "document_already_linked": "Quel documento è allegato a un'altra attività. Scollegalo prima da lì oppure allega una copia separata.",
         "dry_run_not_mergeable": "Questa pull request proviene da una prova, quindi non può essere unita da qui. Riavvia l’attività come esecuzione reale per produrre una pull request che questo spazio di lavoro unirà."
       },
       "action": {

package/i18n/locales/ja.json

@@ -577,6 +577,7 @@
         "input_gate_not_parked": "応答すべきものはありません",
         "input_gate_parked": "タスクの入力チェックで回答してください",
         "ticket_already_linked": "この課題にはすでにタスクがあります",
+        "document_already_linked": "ドキュメントは既に添付されています",
         "dry_run_not_mergeable": "ドライランはマージできません"
       },
       "description": {
@@ -613,6 +614,7 @@
         "input_gate_not_parked": "この実行はもう入力チェックを待っていません。すでに誰かが応答したか、実行が先に進んだ可能性があります。",
         "input_gate_parked": "この実行は入力チェックで停止しており、承認からは回答できません。実行の通知から、タスクを修正して再チェックするか、そのまま実行してください。",
         "ticket_already_linked": "1 つの課題が支えられるタスクは 1 つだけです。もう一度リンクすると、既存のタスクは作成時の文脈を失います。代わりにそのタスクを開くか、先に課題のリンクを解除してください。",
+        "document_already_linked": "そのドキュメントは別のタスクに添付されています。先にそちらで添付を解除するか、別のコピーを添付してください。",
         "dry_run_not_mergeable": "このプルリクエストはドライランによるものなので、ここからはマージできません。このワークスペースがマージするプルリクエストを作るには、タスクを通常の実行として開始し直してください。"
       },
       "action": {
@@ -4060,7 +4062,8 @@
       "connectSourceNamed": "{source} を接続",
       "empty": "要件、RFC、PRD を添付すると、このタスクの実装中にエージェントが参照できます。",
       "emptyInitiative": "要件、RFC、PRD を添付すると、このイニシアチブの計画作成中に計画エージェントが参照できます。",
-      "attached": "ドキュメントを添付しました"
+      "attached": "ドキュメントを添付しました",
+      "uploadedHint": "API 経由でアップロードされたため、開けるソースページはありません。"
     },
     "templates": {
       "title": "ドキュメントのテンプレートと例",

package/i18n/locales/pl.json

@@ -577,6 +577,7 @@
         "input_gate_not_parked": "Nie ma na co odpowiadać",
         "input_gate_parked": "Odpowiedz w kontroli danych wejściowych zadania",
         "ticket_already_linked": "To zgłoszenie ma już zadanie",
+        "document_already_linked": "Dokument jest już załączony",
         "dry_run_not_mergeable": "Uruchomienia próbnego nie można scalić"
       },
       "description": {
@@ -613,6 +614,7 @@
         "input_gate_not_parked": "Ten przebieg nie czeka już na kontrolę danych wejściowych. Ktoś mógł już na nią odpowiedzieć albo przebieg poszedł dalej.",
         "input_gate_parked": "To uruchomienie czeka na kontrolę danych wejściowych, której nie da się rozstrzygnąć przez zatwierdzenie. Skorzystaj z powiadomienia przy uruchomieniu: popraw zadanie i sprawdź ponownie albo uruchom mimo to.",
         "ticket_already_linked": "Zgłoszenie może stać za tylko jednym zadaniem, więc ponowne powiązanie pozbawiłoby istniejące zadanie kontekstu, z którym powstało. Otwórz to zadanie albo najpierw odłącz zgłoszenie.",
+        "document_already_linked": "Ten dokument jest załączony do innego zadania. Najpierw odłącz go tam albo załącz osobną kopię.",
         "dry_run_not_mergeable": "Ten pull request pochodzi z uruchomienia próbnego, więc nie można go tutaj scalić. Uruchom zadanie ponownie w trybie rzeczywistym, aby powstał pull request, który ta przestrzeń robocza scali."
       },
       "action": {
@@ -4060,7 +4062,8 @@
       "connectSourceNamed": "Połącz {source}",
       "empty": "Dołącz wymaganie, dokument RFC lub PRD, aby agenci widzieli je podczas realizacji tego zadania.",
       "emptyInitiative": "Dołącz wymaganie, dokument RFC lub PRD, aby agenci planowania przeczytali je podczas tworzenia planu tej inicjatywy.",
-      "attached": "Dokument dołączony"
+      "attached": "Dokument dołączony",
+      "uploadedHint": "Przesłano przez API, więc nie ma strony źródłowej do otwarcia."
     },
     "templates": {
       "title": "Szablony i przykłady dokumentów",

package/i18n/locales/tr.json

@@ -577,6 +577,7 @@
         "input_gate_not_parked": "Yanıtlanacak bir şey yok",
         "input_gate_parked": "Görevin girdi kontrolünden yanıtlayın",
         "ticket_already_linked": "Bu kayda ait bir görev zaten var",
+        "document_already_linked": "Belge zaten ekli",
         "dry_run_not_mergeable": "Prova çalışması birleştirilemez"
       },
       "description": {
@@ -613,6 +614,7 @@
         "input_gate_not_parked": "Bu çalışma artık giriş denetimini beklemiyor. Biri onu yanıtlamış ya da çalışma ilerlemiş olabilir.",
         "input_gate_parked": "Bu çalıştırma girdi kontrolünde bekliyor ve onay akışı bunu yanıtlayamaz. Çalıştırmadaki bildirimi kullanın: görevi düzeltip yeniden kontrol edin ya da yine de çalıştırın.",
         "ticket_already_linked": "Bir kayıt yalnızca tek bir görevi besleyebilir; yeniden bağlamak mevcut görevi oluşturulduğu bağlamdan yoksun bırakır. Bunun yerine o görevi açın ya da önce kaydın bağlantısını kaldırın.",
+        "document_already_linked": "Bu belge başka bir göreve ekli. Önce oradan ayırın ya da ayrı bir kopya ekleyin.",
         "dry_run_not_mergeable": "Bu pull request bir prova çalışmasından geliyor, bu yüzden buradan birleştirilemez. Bu çalışma alanının birleştireceği bir pull request üretmek için görevi gerçek çalışma olarak yeniden başlatın."
       },
       "action": {
@@ -4060,7 +4062,8 @@
       "connectSourceNamed": "{source} bağla",
       "empty": "Agentların bu görevi uygularken görebilmesi için bir gereksinim, RFC veya PRD ekle.",
       "emptyInitiative": "Planlama ajanlarının bu girişimin planını hazırlarken okuyabilmesi için bir gereksinim, RFC veya PRD ekle.",
-      "attached": "Belge eklendi"
+      "attached": "Belge eklendi",
+      "uploadedHint": "API üzerinden yüklendiği için açılacak bir kaynak sayfa yok."
     },
     "templates": {
       "title": "Belge şablonları ve örnekleri",

package/i18n/locales/uk.json

@@ -577,6 +577,7 @@
         "input_gate_not_parked": "Немає на що відповідати",
         "input_gate_parked": "Відповідайте в перевірці вхідних даних завдання",
         "ticket_already_linked": "У цього тікета вже є завдання",
+        "document_already_linked": "Документ уже прикріплено",
         "dry_run_not_mergeable": "Пробний запуск не можна злити"
       },
       "description": {
@@ -613,6 +614,7 @@
         "input_gate_not_parked": "Цей запуск більше не чекає на перевірку вхідних даних. Можливо, хтось уже відповів, або запуск рушив далі.",
         "input_gate_parked": "Цей запуск очікує на перевірку вхідних даних, і схвалення її не розвʼязує. Скористайтеся повідомленням на запуску: виправте завдання й перевірте ще раз або запустіть попри це.",
         "ticket_already_linked": "Тікет може живити лише одне завдання, тож повторне звʼязування позбавить наявне завдання контексту, з яким його створено. Відкрийте це завдання або спершу відʼєднайте тікет.",
+        "document_already_linked": "Цей документ прикріплено до іншого завдання. Спершу відкріпіть його там або прикріпіть окрему копію.",
         "dry_run_not_mergeable": "Цей pull request походить із пробного запуску, тому його не можна злити звідси. Запустіть завдання ще раз у звичайному режимі, щоб отримати pull request, який цей робочий простір зіллє."
       },
       "action": {
@@ -4060,7 +4062,8 @@
       "connectSourceNamed": "Підключити {source}",
       "empty": "Долучіть вимогу, RFC або PRD, щоб агенти бачили їх під час реалізації цього завдання.",
       "emptyInitiative": "Долучіть вимогу, RFC або PRD, щоб агенти планування прочитали їх під час складання плану цієї ініціативи.",
-      "attached": "Документ долучено"
+      "attached": "Документ долучено",
+      "uploadedHint": "Завантажено через API, тож немає вихідної сторінки, яку можна відкрити."
     },
     "templates": {
       "title": "Шаблони та приклади документів",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.220.0",
+  "version": "0.221.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.40",
     "wretch": "^3.0.9",
-    "@cat-factory/contracts": "0.234.0"
+    "@cat-factory/contracts": "0.236.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",