@cat-factory/app 0.235.0 → 0.236.0

package/app/composables/useContextLinking.spec.ts

@@ -85,6 +85,101 @@ describe('contextKey', () => {
   })
 })
 
+describe('resolvePending', () => {
+  // Fetching an attachment moved AHEAD of the create: an unreachable page is a correction the
+  // user can still make with the form open, where the same failure afterwards leaves a task
+  // carrying context it never got. These pin the two halves that makes load-bearing: what the
+  // host gets back, and that one bad attachment does not hide a second one.
+  function stub(
+    importDocument: (source: string, ref: string) => Promise<{ externalId: string }>,
+    importTask: (
+      source: string,
+      ref: string,
+    ) => Promise<{
+      externalId: string
+      description: string
+    }> = async () => ({ externalId: 'T-1', description: '' }),
+  ) {
+    vi.stubGlobal('useDocumentsStore', () => ({ importDocument }))
+    vi.stubGlobal('useTasksStore', () => ({ importTask }))
+    vi.stubGlobal('useWorkspaceStore', () => ({ workspaceId: 'ws_1' }))
+    vi.stubGlobal('useToast', () => ({ add: vi.fn() }))
+    vi.stubGlobal('useI18n', () => ({ t: (key: string) => key }))
+    vi.stubGlobal('useCopyToClipboard', () => ({ copyAction: () => ({ label: 'copy' }) }))
+  }
+
+  afterEach(() => vi.unstubAllGlobals())
+
+  it('imports what needs it and hands back items the later link can use directly', async () => {
+    stub(async (_source, ref) => ({ externalId: `resolved:${ref}` }))
+    const already = item({ externalId: 'acme/repo:docs/done.md', needsImport: false })
+
+    const { resolved, failures } = await useContextLinking().resolvePending([item(), already])
+
+    expect(failures).toEqual([])
+    // The import's own canonical id is carried forward, not the pasted ref, and the flag flips so
+    // `linkPending` links rather than re-fetching.
+    expect(resolved.map((c) => [c.externalId, c.needsImport])).toEqual([
+      ['resolved:acme/repo:docs/x.md', false],
+      ['acme/repo:docs/done.md', false],
+    ])
+  })
+
+  it('reports EVERY failure and keeps the failed item staged', async () => {
+    stub(async (_source, ref) => {
+      throw new Error(`no access to ${ref}`)
+    })
+    const a = item({ externalId: 'acme/repo:a.md' })
+    const b = item({ externalId: 'acme/repo:b.md' })
+
+    const { resolved, failures } = await useContextLinking().resolvePending([a, b])
+
+    // Both, not just the first: fixing them one round-trip at a time is the failure mode.
+    expect(failures.map((f) => f.item.externalId)).toEqual(['acme/repo:a.md', 'acme/repo:b.md'])
+    expect(failures[0]!.message).toContain('no access to acme/repo:a.md')
+    // Still staged and still unresolved: the host aborts the create, so dropping them here would
+    // silently discard attachments the user asked for while they are fixing them.
+    expect(resolved.map((c) => c.needsImport)).toEqual([true, true])
+    // And MARKED, so the form the user is still looking at names which chip refused. The toast
+    // names them too, but the toast is gone by the time they go looking for the one to remove.
+    expect(resolved.map((c) => c.unreadable)).toEqual([
+      'no access to acme/repo:a.md',
+      'no access to acme/repo:b.md',
+    ])
+  })
+
+  it('clears a stale unreadable mark once the item does resolve', async () => {
+    // A prior failure is not a standing verdict: leaving the mark on a page that has just been
+    // fetched accuses a good attachment (and the retry is the whole point of keeping it staged).
+    stub(async (_source, ref) => ({ externalId: `resolved:${ref}` }))
+    const previouslyFailed = item({ unreadable: 'GitHub denied access (HTTP 403).' })
+
+    const { resolved } = await useContextLinking().resolvePending([previouslyFailed])
+
+    expect(resolved[0]!.unreadable).toBeUndefined()
+    expect(resolved[0]!.needsImport).toBe(false)
+  })
+
+  it("carries an imported issue's description forward, not just its id", async () => {
+    // The add-task form composes the saved description from these items on the very next statement
+    // (`linkedIssueBodies`), so an import that fetched the body and dropped it produced a task
+    // silently missing the issue text it was created from, with the bytes in hand at that moment.
+    stub(
+      async (_source, ref) => ({ externalId: ref }),
+      async () => ({ externalId: 'ENG-42', description: 'Steps to reproduce: …' }),
+    )
+    const issue = item({ kind: 'task', externalId: 'ENG-42', title: 'ENG-42 · Crash' })
+
+    const { resolved } = await useContextLinking().resolvePending([issue])
+
+    expect(resolved[0]).toMatchObject({
+      externalId: 'ENG-42',
+      needsImport: false,
+      description: 'Steps to reproduce: …',
+    })
+  })
+})
+
 describe('presentLinkFailures', () => {
   // Stub the Nuxt auto-imports `useContextLinking` pulls in, so the toast-orchestration
   // side of the composable can be exercised without a full Nuxt runtime.

package/app/composables/useContextLinking.ts

@@ -29,6 +29,17 @@ export interface PendingContext {
   description?: string
   /** True when the item must be imported before it can be linked. */
   needsImport: boolean
+  /**
+   * Why this item could not be FETCHED, when an attempt has already failed (the server's own
+   * message). Set by {@link useContextLinking.resolvePending} and by the add-task form's body
+   * pre-fetch; cleared the moment a later attempt succeeds.
+   *
+   * It exists because the fetch moved ahead of the create: a failure now costs the user the
+   * create, so the item that caused it has to be identifiable ON the form they are still looking
+   * at, not only in the toast that named it. A tracker issue has no pre-flight of its own, so this
+   * is the whole of its warning.
+   */
+  unreadable?: string
 }
 
 /**
@@ -114,6 +125,70 @@ export function useContextLinking() {
   const { t } = useI18n()
   const { copyAction } = useCopyToClipboard()
 
+  /**
+   * Import every pending item that still needs it, BEFORE the block exists.
+   *
+   * The fetch against the external source is the half of attaching that actually fails (a page
+   * that moved, a token without access, a source that is down), and it needs no block id. Running
+   * it after the block was created therefore bought nothing and cost the user their chance to fix
+   * it: the task existed, carrying context it had not got. Run here, a failure is a correction
+   * the host can ask for with the form still open and the reference still editable.
+   *
+   * Returns the items with what succeeded folded in (`needsImport: false`, so the later
+   * {@link linkPending} links them directly), alongside the failures. The batch is NOT aborted on
+   * the first failure: one unreachable page must not hide a second one, or the user fixes them
+   * one round-trip at a time.
+   *
+   * What "folded in" covers is the whole point of running this before the create, so it is more
+   * than the id: a tracker issue's own DESCRIPTION arrives with the import, and the add-task form
+   * composes the saved description from exactly these items on the next statement. Keeping only
+   * the id dropped a body the platform had in hand at the one moment it was needed.
+   */
+  async function resolvePending(
+    items: PendingContext[],
+  ): Promise<{ resolved: PendingContext[]; failures: LinkFailure[] }> {
+    const failures: LinkFailure[] = []
+    const resolved: PendingContext[] = []
+    for (const item of items) {
+      if (!item.needsImport) {
+        resolved.push(item)
+        continue
+      }
+      try {
+        resolved.push(await importPending(item))
+      } catch (e) {
+        const failure = describeLinkFailure(item, e)
+        failures.push(failure)
+        // Kept in the list, still unresolved: the host aborts on any failure, and dropping the
+        // item here would silently discard an attachment the user asked for while they fix it.
+        // Marked, so the form the user is still looking at names WHICH attachment refused.
+        resolved.push({ ...item, unreadable: failure.message })
+      }
+    }
+    return { resolved, failures }
+  }
+
+  /** Fetch one pending item, folding everything the import answers back onto it. */
+  async function importPending(item: PendingContext): Promise<PendingContext> {
+    // `unreadable` is dropped rather than preserved: a prior failure is not a standing verdict, and
+    // leaving the mark on a page that has just been fetched would accuse a good attachment.
+    const { unreadable: _cleared, ...rest } = item
+    if (item.kind === 'document') {
+      const doc = await documents.importDocument(item.source as DocumentSourceKind, item.externalId)
+      return { ...rest, externalId: doc.externalId, needsImport: false }
+    }
+    const task = await tasks.importTask(item.source as TaskSourceKind, item.externalId)
+    return {
+      ...rest,
+      externalId: task.externalId,
+      needsImport: false,
+      // The body reaches the created task through the host's description composition, which reads
+      // `description` off these items: an import that fetched it and did not carry it forward is a
+      // task silently missing the issue text it was created from.
+      ...(task.description.trim() ? { description: task.description } : {}),
+    }
+  }
+
   /**
    * Import (when needed) then link every pending item to `blockId`. Each failure
    * is captured with its actual cause rather than aborting the batch, so one bad
@@ -137,25 +212,31 @@ export function useContextLinking() {
           await tasks.linkToBlock(blockId, source, externalId)
         }
       } catch (e) {
-        // Never swallow the cause: capture the server's own message + status/code/details
-        // so the toast can name the specific reason and the copy affordance can carry the
-        // full context (incl. the upstream GitHub status the backend puts on `details`).
-        const envelope = apiErrorEnvelope(e)
-        failures.push({
-          item,
-          message: e instanceof Error ? e.message : String(e),
-          status: apiErrorStatus(e),
-          code: envelope?.code,
-          details:
-            envelope?.details && typeof envelope.details === 'object'
-              ? (envelope.details as Record<string, unknown>)
-              : undefined,
-        })
+        failures.push(describeLinkFailure(item, e))
       }
     }
     return failures
   }
 
+  /**
+   * Never swallow the cause: capture the server's own message + status/code/details so the toast
+   * can name the specific reason and the copy affordance can carry the full context (incl. the
+   * upstream GitHub status the backend puts on `details`).
+   */
+  function describeLinkFailure(item: PendingContext, e: unknown): LinkFailure {
+    const envelope = apiErrorEnvelope(e)
+    return {
+      item,
+      message: e instanceof Error ? e.message : String(e),
+      status: apiErrorStatus(e),
+      code: envelope?.code,
+      details:
+        envelope?.details && typeof envelope.details === 'object'
+          ? (envelope.details as Record<string, unknown>)
+          : undefined,
+    }
+  }
+
   /**
    * Surface link failures as a single actionable toast: the specific per-item
    * reasons as the body, and a "Copy details" action that puts the full diagnostic
@@ -209,5 +290,5 @@ export function useContextLinking() {
     })
   }
 
-  return { linkPending, presentLinkFailures }
+  return { resolvePending, linkPending, presentLinkFailures }
 }

package/app/stores/documents.ts

@@ -9,6 +9,7 @@ import type {
   DocumentOrigin,
   DocumentSourceDescriptor,
   DocumentSourceKind,
+  ResolvedDocumentRef,
   SourceDocument,
 } from '~/types/domain'
 import { isConnectableSource } from '@cat-factory/contracts'
@@ -82,6 +83,16 @@ export const useDocumentsStore = defineStore('documents', () => {
     documents.value = await api.listDocuments(workspace.requireId())
   }
 
+  /**
+   * Canonicalise a pasted URL/id into the reference this source would store it under, WITHOUT
+   * importing it. The backend's providers own the rule, so the picker validates against the same
+   * parse the import will run rather than a second copy of it that can drift; a ref the source
+   * cannot read comes back as a 422 whose `details.reason` says which correction it needs.
+   */
+  function resolveRef(source: DocumentSourceKind, ref: string): Promise<ResolvedDocumentRef> {
+    return api.resolveDocumentRef(workspace.requireId(), source, { ref })
+  }
+
   /** Import (fetch + persist) a page by id or URL from a source. */
   async function importDocument(source: DocumentSourceKind, ref: string): Promise<SourceDocument> {
     loading.value = true
@@ -211,6 +222,7 @@ export const useDocumentsStore = defineStore('documents', () => {
     connect,
     disconnect,
     loadDocuments,
+    resolveRef,
     importDocument,
     search,
     plan,

package/app/types/documents.ts

@@ -17,6 +17,8 @@ export type {
   DocumentConnection,
   SourceDocument,
   DocumentSearchResult,
+  DocumentRefReason,
+  ResolvedDocumentRef,
   PlanTask,
   PlanModule,
   PlanFrame,

package/i18n/locales/de.json

@@ -2818,7 +2818,8 @@
         "derivedTitleFallback": "Pull Request prüfen",
         "prNotFound": "Pull Request #{number} wurde im Repository dieses Service nicht gefunden. Prüfe die Nummer, oder verknüpfe den Service mit dem Repository, in dem der Pull Request liegt.",
         "prRepoMismatch": "Dieser Pull Request liegt in einem anderen Repository. Dieser Service prüft {repo}; lege die Prüfaufgabe unter dem Service an, der mit dem Repository des Pull Requests verknüpft ist."
-      }
+      },
+      "contextFailed": "Aufgabe nicht erstellt: {count} Anhang konnte nicht gelesen werden | Aufgabe nicht erstellt: {count} Anhänge konnten nicht gelesen werden"
     },
     "recurring": {
       "title": "Eine wiederkehrende Pipeline hinzufügen",
@@ -3004,7 +3005,8 @@
     "attachDocDisabledEnable": "Aktivieren Sie zuerst die Dokumente-Integration",
     "attachIssueDisabledConnect": "Verbinden Sie zuerst einen Issue-Tracker (Integrationen)",
     "attachIssueDisabledEnable": "Aktivieren Sie zuerst die Issue-Tracker-Integration",
-    "importsOnAdd": "importiert beim Hinzufügen"
+    "importsOnAdd": "importiert beim Hinzufügen",
+    "unreadable": "Konnte nicht abgerufen werden: {error}"
   },
   "providers": {
     "presetMismatch": {
@@ -3783,7 +3785,15 @@
       "attachByReference": "{ref} per Referenz anhängen",
       "noMatches": "Keine passenden Seiten.",
       "emptySearchable": "Nach Titel suchen oder ein importiertes Dokument auswählen.",
-      "emptyRefOnly": "Fügen Sie eine Seiten-URL oder -ID ein, um sie anzuhängen."
+      "emptyRefOnly": "Fügen Sie eine Seiten-URL oder -ID ein, um sie anzuhängen.",
+      "refChecking": "Referenz wird geprüft…",
+      "refUnrecognized": "Keine {source}-Referenz. Erwartet: {expected}",
+      "refOtherSource": "Das ist ein {claimed}-Link, kein {source}-Link.",
+      "refSwitchSource": "Stattdessen {source} verwenden",
+      "refTrimmed": "Auf die unterstützte Form gekürzt",
+      "refWidened": "Nennt einen Frame, den diese Quelle nicht lesen kann ({scope}); daher wird die gesamte Datei angehängt.",
+      "refAlreadyAttached": "Diese Referenz ist bereits angehängt.",
+      "refCheckFailed": "Referenz konnte nicht geprüft werden: {error}"
     },
     "repoPicker": {
       "searchRepoPlaceholder": "Repositorys suchen…",
@@ -5040,7 +5050,8 @@
       "failedTitle": "Die Initiative konnte nicht erstellt werden",
       "contextDocsHint": "Hänge eine Anforderung, ein RFC oder ein PRD an, damit die Planungsagenten es beim Abstecken und Entwerfen des Plans lesen.",
       "contextIssuesHint": "Hänge ein Tracker-Issue an, damit die Planungsagenten beim Entwerfen des Plans seine Beschreibung und Kommentare sehen.",
-      "linkFailed": "Initiative erstellt, aber {count} Anhang konnte nicht verknüpft werden | Initiative erstellt, aber {count} Anhänge konnten nicht verknüpft werden"
+      "linkFailed": "Initiative erstellt, aber {count} Anhang konnte nicht verknüpft werden | Initiative erstellt, aber {count} Anhänge konnten nicht verknüpft werden",
+      "contextFailed": "Initiative nicht erstellt: {count} Anhang konnte nicht gelesen werden | Initiative nicht erstellt: {count} Anhänge konnten nicht gelesen werden"
     },
     "status": {
       "planning": "Planung",

package/i18n/locales/en.json

@@ -347,6 +347,10 @@
         "derivedTitleFallback": "Review pull request",
         "prNotFound": "Pull request #{number} was not found in this service's repository. Check the number, or link the service to the repository that pull request is on.",
         "prRepoMismatch": "That pull request is on a different repository. This service reviews {repo}, so create the review task under the service linked to the pull request's repository."
+      },
+      "contextFailed": "Task not created: {count} attachment could not be read | Task not created: {count} attachments could not be read",
+      "@contextFailed": {
+        "description": "Count-based: how many context attachments (docs/issues) could not be fetched, which is why nothing was created (count is always >= 1). Provide ALL plural forms your language needs (English has 2; Polish/Ukrainian need 3 - one/few/many - via the custom pluralRules in i18n.config.ts)."
       }
     },
     "recurring": {
@@ -548,7 +552,8 @@
     "attachDocDisabledEnable": "Enable the documents integration first",
     "attachIssueDisabledConnect": "Connect an issue tracker first (Integrations)",
     "attachIssueDisabledEnable": "Enable the issue-tracker integration first",
-    "importsOnAdd": "imports on add"
+    "importsOnAdd": "imports on add",
+    "unreadable": "Could not be fetched: {error}"
   },
   "errors": {
     "generic": {
@@ -4300,7 +4305,15 @@
       "attachByReference": "Attach {ref} by reference",
       "noMatches": "No matching pages.",
       "emptySearchable": "Search by title, or pick an imported document.",
-      "emptyRefOnly": "Paste a page URL or ID to attach it."
+      "emptyRefOnly": "Paste a page URL or ID to attach it.",
+      "refChecking": "Checking the reference…",
+      "refUnrecognized": "Not a {source} reference. Expected {expected}",
+      "refOtherSource": "That is a {claimed} link, not a {source} one.",
+      "refSwitchSource": "Use {source} instead",
+      "refTrimmed": "Trimmed to the supported form",
+      "refWidened": "Names a frame this source cannot read ({scope}), so the whole file is attached.",
+      "refAlreadyAttached": "This reference is already attached.",
+      "refCheckFailed": "Could not check the reference: {error}"
     },
     "repoPicker": {
       "searchRepoPlaceholder": "Search repositories…",
@@ -6515,6 +6528,10 @@
       "linkFailed": "Initiative created, but {count} attachment could not be linked | Initiative created, but {count} attachments could not be linked",
       "@linkFailed": {
         "description": "Count-based: how many context attachments (docs/issues) failed to link after the initiative was created (count is always >= 1). Provide ALL plural forms your language needs (English has 2; Polish/Ukrainian need 3 - one/few/many - via the custom pluralRules in i18n.config.ts)."
+      },
+      "contextFailed": "Initiative not created: {count} attachment could not be read | Initiative not created: {count} attachments could not be read",
+      "@contextFailed": {
+        "description": "Count-based: how many context attachments (docs/issues) could not be fetched, which is why nothing was created (count is always >= 1). Provide ALL plural forms your language needs (English has 2; Polish/Ukrainian need 3 - one/few/many - via the custom pluralRules in i18n.config.ts)."
       }
     },
     "status": {

package/i18n/locales/es.json

@@ -311,7 +311,8 @@
         "derivedTitleFallback": "Revisar la pull request",
         "prNotFound": "No se encontró la pull request n.º {number} en el repositorio de este servicio. Comprueba el número, o vincula el servicio al repositorio en el que está esa pull request.",
         "prRepoMismatch": "Esa pull request está en otro repositorio. Este servicio revisa {repo}, así que crea la tarea de revisión en el servicio vinculado al repositorio de la pull request."
-      }
+      },
+      "contextFailed": "Tarea no creada: no se pudo leer {count} adjunto | Tarea no creada: no se pudieron leer {count} adjuntos"
     },
     "recurring": {
       "title": "Añadir una pipeline recurrente",
@@ -497,7 +498,8 @@
     "attachDocDisabledEnable": "Activa primero la integración de documentos",
     "attachIssueDisabledConnect": "Conecta primero un gestor de incidencias (Integraciones)",
     "attachIssueDisabledEnable": "Activa primero la integración del gestor de incidencias",
-    "importsOnAdd": "se importa al añadir"
+    "importsOnAdd": "se importa al añadir",
+    "unreadable": "No se pudo obtener: {error}"
   },
   "errors": {
     "generic": {
@@ -4166,7 +4168,15 @@
       "attachByReference": "Adjuntar {ref} por referencia",
       "noMatches": "No hay páginas que coincidan.",
       "emptySearchable": "Busca por título o elige un documento importado.",
-      "emptyRefOnly": "Pega la URL o el ID de una página para adjuntarla."
+      "emptyRefOnly": "Pega la URL o el ID de una página para adjuntarla.",
+      "refChecking": "Comprobando la referencia…",
+      "refUnrecognized": "No es una referencia de {source}. Se esperaba {expected}",
+      "refOtherSource": "Es un enlace de {claimed}, no de {source}.",
+      "refSwitchSource": "Usar {source} en su lugar",
+      "refTrimmed": "Recortado al formato admitido",
+      "refWidened": "Nombra un marco que esta fuente no puede leer ({scope}), así que se adjunta el archivo completo.",
+      "refAlreadyAttached": "Esta referencia ya está adjunta.",
+      "refCheckFailed": "No se pudo comprobar la referencia: {error}"
     },
     "repoPicker": {
       "searchRepoPlaceholder": "Buscar repositorios…",
@@ -6296,7 +6306,8 @@
       "failedTitle": "No se pudo crear la iniciativa",
       "contextDocsHint": "Adjunta un requisito, RFC o PRD para que los agentes de planificación lo lean al delimitar y redactar el plan.",
       "contextIssuesHint": "Adjunta una incidencia para que los agentes de planificación vean su descripción y comentarios al redactar el plan.",
-      "linkFailed": "Iniciativa creada, pero no se pudo vincular {count} adjunto | Iniciativa creada, pero no se pudieron vincular {count} adjuntos"
+      "linkFailed": "Iniciativa creada, pero no se pudo vincular {count} adjunto | Iniciativa creada, pero no se pudieron vincular {count} adjuntos",
+      "contextFailed": "Iniciativa no creada: no se pudo leer {count} adjunto | Iniciativa no creada: no se pudieron leer {count} adjuntos"
     },
     "status": {
       "planning": "Planificando",

package/i18n/locales/fr.json

@@ -311,7 +311,8 @@
         "derivedTitleFallback": "Examiner la pull request",
         "prNotFound": "La pull request n° {number} est introuvable dans le dépôt de ce service. Vérifiez le numéro, ou reliez le service au dépôt qui héberge cette pull request.",
         "prRepoMismatch": "Cette pull request se trouve dans un autre dépôt. Ce service examine {repo} : créez la tâche de revue sous le service relié au dépôt de la pull request."
-      }
+      },
+      "contextFailed": "Tâche non créée : {count} pièce jointe illisible | Tâche non créée : {count} pièces jointes illisibles"
     },
     "recurring": {
       "title": "Ajouter une pipeline récurrente",
@@ -497,7 +498,8 @@
     "attachDocDisabledEnable": "Activez d’abord l’intégration de documents",
     "attachIssueDisabledConnect": "Connectez d’abord un suivi de tickets (Intégrations)",
     "attachIssueDisabledEnable": "Activez d’abord l’intégration du suivi de tickets",
-    "importsOnAdd": "importé à l’ajout"
+    "importsOnAdd": "importé à l’ajout",
+    "unreadable": "Récupération impossible : {error}"
   },
   "errors": {
     "generic": {
@@ -4166,7 +4168,15 @@
       "attachByReference": "Joindre {ref} par référence",
       "noMatches": "Aucune page correspondante.",
       "emptySearchable": "Recherchez par titre ou choisissez un document importé.",
-      "emptyRefOnly": "Collez l'URL ou l'ID d'une page pour la joindre."
+      "emptyRefOnly": "Collez l'URL ou l'ID d'une page pour la joindre.",
+      "refChecking": "Vérification de la référence…",
+      "refUnrecognized": "Ce n'est pas une référence {source}. Format attendu : {expected}",
+      "refOtherSource": "C'est un lien {claimed}, pas un lien {source}.",
+      "refSwitchSource": "Utiliser {source} à la place",
+      "refTrimmed": "Réduit au format pris en charge",
+      "refWidened": "Désigne un cadre que cette source ne peut pas lire ({scope}) : le fichier entier est donc joint.",
+      "refAlreadyAttached": "Cette référence est déjà jointe.",
+      "refCheckFailed": "Impossible de vérifier la référence : {error}"
     },
     "repoPicker": {
       "searchRepoPlaceholder": "Rechercher des dépôts…",
@@ -6296,7 +6306,8 @@
       "failedTitle": "Impossible de creer l'initiative",
       "contextDocsHint": "Joignez une exigence, une RFC ou un PRD pour que les agents de planification la lisent en cadrant et en rédigeant le plan.",
       "contextIssuesHint": "Joignez un ticket pour que les agents de planification voient sa description et ses commentaires en rédigeant le plan.",
-      "linkFailed": "Initiative créée, mais {count} pièce jointe n’a pas pu être liée | Initiative créée, mais {count} pièces jointes n’ont pas pu être liées"
+      "linkFailed": "Initiative créée, mais {count} pièce jointe n’a pas pu être liée | Initiative créée, mais {count} pièces jointes n’ont pas pu être liées",
+      "contextFailed": "Initiative non créée : {count} pièce jointe illisible | Initiative non créée : {count} pièces jointes illisibles"
     },
     "status": {
       "planning": "Planification",

package/i18n/locales/he.json

@@ -311,7 +311,8 @@
         "derivedTitleFallback": "סקירת בקשת המשיכה",
         "prNotFound": "בקשת משיכה #{number} לא נמצאה במאגר של שירות זה. בדקו את המספר, או קשרו את השירות למאגר שבו נמצאת בקשת המשיכה.",
         "prRepoMismatch": "בקשת המשיכה הזו נמצאת במאגר אחר. שירות זה סוקר את {repo}, לכן צרו את משימת הסקירה תחת השירות המקושר למאגר של בקשת המשיכה."
-      }
+      },
+      "contextFailed": "המשימה לא נוצרה: לא ניתן היה לקרוא {count} קובץ מצורף | המשימה לא נוצרה: לא ניתן היה לקרוא שני קבצים מצורפים | המשימה לא נוצרה: לא ניתן היה לקרוא {count} קבצים מצורפים"
     },
     "recurring": {
       "title": "הוסף צינור מחזורי",
@@ -497,7 +498,8 @@
     "attachDocDisabledEnable": "הפעל תחילה את אינטגרציית המסמכים",
     "attachIssueDisabledConnect": "חבר תחילה מערכת לניהול אישיו (אינטגרציות)",
     "attachIssueDisabledEnable": "הפעל תחילה את אינטגרציית מערכת האישיו",
-    "importsOnAdd": "מיובא בעת ההוספה"
+    "importsOnAdd": "מיובא בעת ההוספה",
+    "unreadable": "לא ניתן לאחזר: {error}"
   },
   "errors": {
     "generic": {
@@ -4166,7 +4168,15 @@
       "attachByReference": "צרף את {ref} לפי הפניה",
       "noMatches": "אין דפים תואמים.",
       "emptySearchable": "חפש לפי כותרת, או בחר מסמך שיובא.",
-      "emptyRefOnly": "הדבק כתובת URL או מזהה של דף כדי לצרף אותו."
+      "emptyRefOnly": "הדבק כתובת URL או מזהה של דף כדי לצרף אותו.",
+      "refChecking": "בודקים את ההפניה…",
+      "refUnrecognized": "זו אינה הפניה של {source}. הפורמט הצפוי: {expected}",
+      "refOtherSource": "זה קישור של {claimed}, לא של {source}.",
+      "refSwitchSource": "להשתמש ב-{source} במקום",
+      "refTrimmed": "קוצר לפורמט הנתמך",
+      "refWidened": "מציין מסגרת שהמקור הזה אינו יכול לקרוא ({scope}), ולכן מצורף כל הקובץ.",
+      "refAlreadyAttached": "ההפניה הזאת כבר מצורפת.",
+      "refCheckFailed": "לא ניתן לבדוק את ההפניה: {error}"
     },
     "repoPicker": {
       "searchRepoPlaceholder": "חיפוש מאגרים…",
@@ -6296,7 +6306,8 @@
       "failedTitle": "לא ניתן היה ליצור את היוזמה",
       "contextDocsHint": "צרף דרישה, RFC או PRD כדי שסוכני התכנון יקראו אותם בעת תיחום וגיבוש התוכנית.",
       "contextIssuesHint": "צרף אישיו כדי שסוכני התכנון יראו את התיאור והתגובות שלו בעת גיבוש התוכנית.",
-      "linkFailed": "היוזמה נוצרה, אך {count} צרופה לא ניתנה לקישור | היוזמה נוצרה, אך שתי צרופות לא ניתנו לקישור | היוזמה נוצרה, אך {count} צרופות לא ניתנו לקישור"
+      "linkFailed": "היוזמה נוצרה, אך {count} צרופה לא ניתנה לקישור | היוזמה נוצרה, אך שתי צרופות לא ניתנו לקישור | היוזמה נוצרה, אך {count} צרופות לא ניתנו לקישור",
+      "contextFailed": "היוזמה לא נוצרה: לא ניתן היה לקרוא {count} קובץ מצורף | היוזמה לא נוצרה: לא ניתן היה לקרוא שני קבצים מצורפים | היוזמה לא נוצרה: לא ניתן היה לקרוא {count} קבצים מצורפים"
     },
     "status": {
       "planning": "בתכנון",

package/i18n/locales/it.json

@@ -2818,7 +2818,8 @@
         "derivedTitleFallback": "Rivedi la pull request",
         "prNotFound": "La pull request n. {number} non è stata trovata nel repository di questo servizio. Controlla il numero, oppure collega il servizio al repository in cui si trova la pull request.",
         "prRepoMismatch": "Quella pull request si trova in un altro repository. Questo servizio revisiona {repo}, quindi crea l'attività di revisione sotto il servizio collegato al repository della pull request."
-      }
+      },
+      "contextFailed": "Attività non creata: {count} allegato non leggibile | Attività non creata: {count} allegati non leggibili"
     },
     "recurring": {
       "title": "Aggiungi una pipeline ricorrente",
@@ -3004,7 +3005,8 @@
     "attachDocDisabledEnable": "Abilita prima l'integrazione dei documenti",
     "attachIssueDisabledConnect": "Connetti prima un issue tracker (Integrazioni)",
     "attachIssueDisabledEnable": "Abilita prima l'integrazione dell'issue tracker",
-    "importsOnAdd": "importa all'aggiunta"
+    "importsOnAdd": "importa all'aggiunta",
+    "unreadable": "Impossibile recuperarlo: {error}"
   },
   "providers": {
     "presetMismatch": {
@@ -3783,7 +3785,15 @@
       "attachByReference": "Allega {ref} per riferimento",
       "noMatches": "Nessuna pagina corrispondente.",
       "emptySearchable": "Cerca per titolo, oppure scegli un documento importato.",
-      "emptyRefOnly": "Incolla l'URL o l'ID di una pagina per allegarla."
+      "emptyRefOnly": "Incolla l'URL o l'ID di una pagina per allegarla.",
+      "refChecking": "Verifica del riferimento…",
+      "refUnrecognized": "Non è un riferimento {source}. Formato atteso: {expected}",
+      "refOtherSource": "È un link {claimed}, non un link {source}.",
+      "refSwitchSource": "Usa {source} invece",
+      "refTrimmed": "Ridotto al formato supportato",
+      "refWidened": "Indica un frame che questa origine non può leggere ({scope}), quindi viene allegato l’intero file.",
+      "refAlreadyAttached": "Questo riferimento è già allegato.",
+      "refCheckFailed": "Impossibile verificare il riferimento: {error}"
     },
     "repoPicker": {
       "searchRepoPlaceholder": "Cerca repository…",
@@ -5040,7 +5050,8 @@
       "failedTitle": "Impossibile creare l'iniziativa",
       "contextDocsHint": "Allega un requisito, una RFC o un PRD così gli agenti di pianificazione lo leggono mentre delimitano e redigono il piano.",
       "contextIssuesHint": "Allega una issue così gli agenti di pianificazione ne vedono descrizione e commenti mentre redigono il piano.",
-      "linkFailed": "Iniziativa creata, ma {count} allegato non è stato collegato | Iniziativa creata, ma {count} allegati non sono stati collegati"
+      "linkFailed": "Iniziativa creata, ma {count} allegato non è stato collegato | Iniziativa creata, ma {count} allegati non sono stati collegati",
+      "contextFailed": "Iniziativa non creata: {count} allegato non leggibile | Iniziativa non creata: {count} allegati non leggibili"
     },
     "status": {
       "planning": "Pianificazione",

package/i18n/locales/ja.json

@@ -311,7 +311,8 @@
         "derivedTitleFallback": "プルリクエストをレビュー",
         "prNotFound": "プルリクエスト #{number} はこのサービスのリポジトリで見つかりませんでした。番号を確認するか、そのプルリクエストがあるリポジトリをサービスに紐付けてください。",
         "prRepoMismatch": "そのプルリクエストは別のリポジトリにあります。このサービスは {repo} をレビューします。プルリクエストのリポジトリに紐付いたサービスの下にレビュータスクを作成してください。"
-      }
+      },
+      "contextFailed": "タスクは作成されていません: {count} 件の添付を読み取れませんでした | タスクは作成されていません: {count} 件の添付を読み取れませんでした"
     },
     "recurring": {
       "title": "繰り返しパイプラインを追加",
@@ -497,7 +498,8 @@
     "attachDocDisabledEnable": "まずドキュメント連携を有効にしてください",
     "attachIssueDisabledConnect": "まず issue トラッカーを接続してください（連携）",
     "attachIssueDisabledEnable": "まず issue トラッカー連携を有効にしてください",
-    "importsOnAdd": "追加時にインポート"
+    "importsOnAdd": "追加時にインポート",
+    "unreadable": "取得できませんでした: {error}"
   },
   "errors": {
     "generic": {
@@ -4166,7 +4168,15 @@
       "attachByReference": "{ref} を参照で添付",
       "noMatches": "一致するページがありません。",
       "emptySearchable": "タイトルで検索するか、インポート済みドキュメントを選択してください。",
-      "emptyRefOnly": "ページの URL または ID を貼り付けて添付します。"
+      "emptyRefOnly": "ページの URL または ID を貼り付けて添付します。",
+      "refChecking": "参照を確認しています…",
+      "refUnrecognized": "{source} の参照ではありません。想定される形式: {expected}",
+      "refOtherSource": "これは {claimed} のリンクであり、{source} のものではありません。",
+      "refSwitchSource": "代わりに {source} を使う",
+      "refTrimmed": "サポートされる形式に整形しました",
+      "refWidened": "このソースが読み取れないフレーム（{scope}）を指しているため、ファイル全体を添付します。",
+      "refAlreadyAttached": "この参照はすでに添付されています。",
+      "refCheckFailed": "参照を確認できませんでした: {error}"
     },
     "repoPicker": {
       "searchRepoPlaceholder": "リポジトリを検索…",
@@ -6296,7 +6306,8 @@
       "failedTitle": "イニシアチブを作成できませんでした",
       "contextDocsHint": "要件・RFC・PRD を添付すると、計画エージェントが範囲の確定と計画の作成の際にそれを読みます。",
       "contextIssuesHint": "issue を添付すると、計画エージェントが計画を作成する際にその説明とコメントを参照します。",
-      "linkFailed": "イニシアチブを作成しましたが、{count} 件の添付をリンクできませんでした | イニシアチブを作成しましたが、{count} 件の添付をリンクできませんでした"
+      "linkFailed": "イニシアチブを作成しましたが、{count} 件の添付をリンクできませんでした | イニシアチブを作成しましたが、{count} 件の添付をリンクできませんでした",
+      "contextFailed": "イニシアチブは作成されていません: {count} 件の添付を読み取れませんでした | イニシアチブは作成されていません: {count} 件の添付を読み取れませんでした"
     },
     "status": {
       "planning": "計画中",