@cat-factory/app 0.219.1 → 0.221.0

package/app/components/board/AddTaskModal.vue

@@ -35,6 +35,7 @@ import type { ReviewTargetReason } from '@cat-factory/contracts'
 import { sanitizeDescriptorFields, validateDescriptorFields } from '@cat-factory/contracts'
 import { defaultDescriptorValues } from '~/utils/descriptorFields'
 import { pipelineAllowedForManualStart } from '~/utils/pipeline'
+import { buildTaskTypePickerRows } from '~/utils/taskTypePicker'
 
 const ui = useUiStore()
 // Interface tier. In BASIC mode this form asks for the task itself (type, title,
@@ -183,15 +184,15 @@ const customFieldProblems = computed(() => {
   if (!custom || customFormPanel.value) return []
   return validateDescriptorFields(custom.fields ?? [], customFieldValues.value)
 })
-// The type picker: the built-in choices (i18n labels) + the custom types (their wire presentation).
-const typeChoices = computed<{ value: TaskTypeChoice; label: string; icon: string }[]>(() => [
-  ...TASK_TYPES.value,
-  ...customTaskTypes.value.map((tt) => ({
-    value: tt.taskType as TaskTypeChoice,
-    label: tt.presentation.label,
-    icon: tt.presentation.icon,
-  })),
-])
+// The type picker, laid out as rows (see `buildTaskTypePickerRows`): the built-in choices (i18n
+// labels) first, then the deployment's registered types under their declared `presentation.category`
+// captions, so a catalog of reusable operations reads as sections instead of one wall of buttons.
+// Only the leftovers row's heading is CHROME, so it is the one caption the layer supplies.
+const typeRows = computed(() =>
+  buildTaskTypePickerRows(TASK_TYPES.value, customTaskTypes.value, {
+    other: t('board.addTask.typeOther'),
+  }),
+)
 
 // Parse the PR-reference input into the contract fields: a bare positive integer (optionally
 // `#`-prefixed) becomes `prNumber` (a PR on the service's linked repo); anything else is taken
@@ -768,24 +769,59 @@ function openReviewFrictionDialog(conflict: NonNullable<ReturnType<typeof parseC
         </p>
 
         <UFormField :label="t('board.addTask.typeLabel')">
-          <div class="flex flex-wrap gap-1">
-            <UButton
-              v-for="ty in typeChoices"
-              :key="ty.value"
-              :color="taskType === ty.value ? 'primary' : 'neutral'"
-              :variant="taskType === ty.value ? 'soft' : 'ghost'"
-              :icon="ty.icon"
-              size="xs"
-              :data-testid="`task-type-${ty.value}`"
-              @click="
-                () => {
-                  taskType = ty.value
-                }
-              "
+          <!-- One row per picker group: the built-ins uncaptioned, then a caption per registered
+               category, then the leftovers. Category captions are deployment-authored English
+               rendered verbatim (as are the custom labels and their hover descriptions); only the
+               leftovers heading is chrome, so only it is i18n. The row gap must stay WIDER than a
+               caption's `mb-1`, or a heading sits equidistant between the group above it and its
+               own buttons and the grouping stops reading. -->
+          <div class="space-y-3">
+            <div
+              v-for="row in typeRows"
+              :key="row.id"
+              data-testid="task-type-row"
+              :data-task-type-row="row.id"
             >
-              {{ ty.label }}
-            </UButton>
+              <p
+                v-if="row.caption"
+                class="mb-1 px-1 text-[11px] font-semibold uppercase tracking-wide text-slate-500"
+                data-testid="task-type-category"
+              >
+                {{ row.caption }}
+              </p>
+              <div class="flex flex-wrap gap-1">
+                <UButton
+                  v-for="ty in row.choices"
+                  :key="ty.value"
+                  :color="taskType === ty.value ? 'primary' : 'neutral'"
+                  :variant="taskType === ty.value ? 'soft' : 'ghost'"
+                  :icon="ty.icon"
+                  size="xs"
+                  :title="ty.description"
+                  :data-testid="`task-type-${ty.value}`"
+                  @click="
+                    () => {
+                      taskType = ty.value
+                    }
+                  "
+                >
+                  {{ ty.label }}
+                </UButton>
+              </div>
+            </div>
           </div>
+
+          <!-- What the selected operation is for, in the deployment's own words, in the field's OWN
+               help slot (the `:help` seam every other field here uses) rather than a paragraph
+               beside it fighting the modal's spacing. The hover title above helps you choose; this
+               states the choice you made, which is the half a touch device can reach. Built-in
+               types carry no description (their labels are localized and their meaning is fixed),
+               so only a custom type is described here. -->
+          <template v-if="selectedCustomType?.presentation.description" #help>
+            <span data-testid="task-type-description">
+              {{ selectedCustomType.presentation.description }}
+            </span>
+          </template>
         </UFormField>
 
         <!-- Recurring tasks are configured as a schedule on the service frame. -->

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/docs/consumer-extensions.md

@@ -56,18 +56,18 @@ export default defineNuxtPlugin(() => {
 
 ## The landed seams
 
-| Seam                                | Slot key                  | Entry shape                                                                                      | Host                                                                      |
-| ----------------------------------- | ------------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- |
-| Run-detail windows                  | `resultViews`             | `{ id: '<ns>:<name>', component }`                                                               | `StepResultViewHost` via `dispatchStepView`                               |
-| Agent kinds (palette data)          | `agentKinds`              | `{ kind, container, presentation: { label, icon, color, description, category?, resultView? } }` | agents store merge → `agentKindMeta`                                      |
-| Custom task types                   | `taskTypes`               | `{ taskType: '<ns>:<name>', presentation, fields?, defaultPipelineId?, formPanel? }`             | `AddTaskModal` picker/fields + `TaskCard` badge (via `taskTypeMeta`)      |
-| Sidebar / command-palette / toolbar | `nav`                     | `{ id, labelKey, icon, surfaces, gate?, advanced?, run, sidebar?, command?, toolbar? }`          | the three shells via `useNavContributions`                                |
-| Inspector body panels               | `inspectorPanels`         | `{ id, component, when(block), order }` (`PanelEntry<Block>`)                                    | `<PanelsOutlet>` in `InspectorPanel`                                      |
-| Top-level overlays                  | `appOverlays`             | `{ id: '<ns>:<name>', component }`                                                               | `<AppOverlayHost>` via `useAppOverlays().open(id)`                        |
-| External tools                      | `externalTools`           | `{ id, title, icon, url, description?, requiredMetadata?, gate?, advanced?, order? }`            | the "External tools" sidebar section + palette, via `useNavContributions` |
-| Custom workspace metadata fields    | `workspaceMetadataFields` | `{ key, label, description?, placeholder?, type?, options?, order? }`                            | the Metadata tab of Workspace settings                                    |
-| Multi-step wizards                  | (journeys)                | `registerJourney` + step modules                                                                 | `<JourneyHost>` / `<JourneyOutlet>`                                       |
-| Locale strings                      | (i18n)                    | `i18n/locales/*.json` in the deployment                                                          | `@nuxtjs/i18n` layer deep-merge                                           |
+| Seam                                | Slot key                  | Entry shape                                                                                               | Host                                                                      |
+| ----------------------------------- | ------------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
+| Run-detail windows                  | `resultViews`             | `{ id: '<ns>:<name>', component }`                                                                        | `StepResultViewHost` via `dispatchStepView`                               |
+| Agent kinds (palette data)          | `agentKinds`              | `{ kind, container, presentation: { label, icon, color, description, category?, resultView? } }`          | agents store merge → `agentKindMeta`                                      |
+| Custom task types                   | `taskTypes`               | `{ taskType: '<ns>:<name>', presentation, fields?, defaultPipelineId?, defaultFragmentIds?, formPanel? }` | `AddTaskModal` picker/fields + `TaskCard` badge (via `taskTypeMeta`)      |
+| Sidebar / command-palette / toolbar | `nav`                     | `{ id, labelKey, icon, surfaces, gate?, advanced?, run, sidebar?, command?, toolbar? }`                   | the three shells via `useNavContributions`                                |
+| Inspector body panels               | `inspectorPanels`         | `{ id, component, when(block), order }` (`PanelEntry<Block>`)                                             | `<PanelsOutlet>` in `InspectorPanel`                                      |
+| Top-level overlays                  | `appOverlays`             | `{ id: '<ns>:<name>', component }`                                                                        | `<AppOverlayHost>` via `useAppOverlays().open(id)`                        |
+| External tools                      | `externalTools`           | `{ id, title, icon, url, description?, requiredMetadata?, gate?, advanced?, order? }`                     | the "External tools" sidebar section + palette, via `useNavContributions` |
+| Custom workspace metadata fields    | `workspaceMetadataFields` | `{ key, label, description?, placeholder?, type?, options?, order? }`                                     | the Metadata tab of Workspace settings                                    |
+| Multi-step wizards                  | (journeys)                | `registerJourney` + step modules                                                                          | `<JourneyHost>` / `<JourneyOutlet>`                                       |
+| Locale strings                      | (i18n)                    | `i18n/locales/*.json` in the deployment                                                                   | `@nuxtjs/i18n` layer deep-merge                                           |
 
 A `nav` entry may also declare `advanced: true`, which hides it in **basic** interface mode
 (the shipped default) exactly as it does for the first-party destinations: see
@@ -173,20 +173,48 @@ Values are readable anywhere in the SPA via `useWorkspaceSettingsStore().setting
 
 Model a proprietary work item (an "incident", "pentest", "compliance-audit") as a first-class
 task type, the create-task twin of an agent kind. Contribute `{ taskType: '<ns>:<name>',
-presentation: { label, icon, color, description }, fields?, defaultPipelineId?, formPanel? }` to
-the `taskTypes` slot (see `acme:incident` in the example module). The SPA merges it into the
-create-task picker and the card-badge catalog:
+presentation: { label, icon, color, description, category? }, fields?, defaultPipelineId?,
+defaultFragmentIds?, formPanel? }` to the `taskTypes` slot (see `acme:incident` in the example
+module). The SPA merges it into the create-task picker and the card-badge catalog:
 
 - **`presentation`** drives the create-task picker entry and the `TaskCard` type badge (resolved
   through the pure `taskTypeMeta` read-model: the `agentKindMeta` twin). An UNREGISTERED
   namespaced type (a stale row after your extension is removed) degrades to the `feature`
-  presentation, so a leftover string never breaks a card.
-- **`fields`** are descriptor-driven create-form inputs (`text` / `textarea` / `number` /
-  `select`); their values land in the task's sparse `taskTypeFields.custom` bag (no migration).
+  presentation, so a leftover string never breaks a card. `description` is rendered verbatim as
+  the picker button's tooltip and, once the type is selected, as the type field's help text;
+  `category` groups the picker (below).
+- **`fields`** are descriptor-driven create-form inputs over the shared descriptor-form vocabulary
+  (`text` / `textarea` / `number` / `select` / `checkbox` / `checkbox-group` / `path`, with
+  defaults and `showWhen` visibility; `password` is excluded by construction because a task field
+  value reaches prompts and telemetry). Their values land in the task's sparse
+  `taskTypeFields.custom` bag (no migration). A BACKEND-registered descriptor is enforced
+  server-side on create as well (required answers, option lists, lengths); a code-shipped one is
+  known only to the SPA, so the create form is its only check (see the Validation note below).
 - **`formPanel`** optionally names a bespoke create-form section component you contribute to the
   `taskTypeFormPanels` slot (paired by that id, like `resultViews`); shown INSTEAD of `fields`. An
   unpaired id degrades to the descriptor fields.
 - **`defaultPipelineId`** pre-selects the type's pipeline in the picker.
+- **`defaultFragmentIds`** seed the type's standing context (best-practice fragment ids) onto every
+  new task of it, beside whatever it inherits from its service.
+
+**The picker is grouped, not flat** (`utils/taskTypePicker.ts`): the built-in types come first in
+one uncaptioned row, then one captioned row per declared `presentation.category` in registration
+order, then any uncategorized types under a translated "Other" heading. Declare a category once you
+ship more than a couple of types, or they pile up behind the everyday `feature` / `bug` choices.
+Categories differing only in case or spacing are ONE row, captioned as you first wrote it, so a
+stray `API delivery` / `API Delivery` pair does not split a category in half.
+
+Your own strings (labels, category captions, descriptions) are rendered verbatim and never enter a
+locale catalog; only the platform's own chrome around them is i18n, which is why the "Other" heading
+is the one caption you do not supply. Each row carries `data-testid="task-type-row"` plus
+`data-task-type-row="<id>"`, and each choice `data-testid="task-type-<taskType>"`, so your own e2e
+suite can address a row and the caption inside it.
+
+Together, `fields` + `defaultFragmentIds` + `defaultPipelineId` are what turns a task type from a
+badge into a **reusable operation**: a canned unit of work an org runs repeatedly with per-case
+input, whose collected values reach every agent's prompt. See
+[`docs/initiatives/reusable-operations.md`](../../../../docs/initiatives/reusable-operations.md)
+and the `org:introduce-api` worked example in `backend/internal/example-custom-agent`.
 
 The **same type can be delivered from the backend** instead of code-shipped: register it on the
 deployment's app-owned `TaskTypeRegistry` and it arrives in the workspace snapshot's

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/app/utils/taskTypePicker.spec.ts

@@ -0,0 +1,161 @@
+import { describe, it, expect } from 'vitest'
+import type { CustomTaskType } from '~/types/domain'
+import { buildTaskTypePickerRows, type TaskTypePickerChoice } from './taskTypePicker'
+
+const BUILT_INS: TaskTypePickerChoice[] = [
+  { value: 'feature', label: 'Feature', icon: 'i-lucide-sparkles' },
+  { value: 'bug', label: 'Bug', icon: 'i-lucide-bug' },
+]
+
+/** The localized chrome the caller passes in; the util never authors a display string itself. */
+const CAPTIONS = { other: 'Other' }
+
+const custom = (
+  taskType: string,
+  category?: string,
+  description = `What ${taskType} does`,
+): CustomTaskType =>
+  ({
+    taskType,
+    presentation: {
+      label: taskType.split(':')[1] ?? taskType,
+      icon: 'i-lucide-plug',
+      color: '#0ea5e9',
+      description,
+      ...(category === undefined ? {} : { category }),
+    },
+  }) as CustomTaskType
+
+describe('buildTaskTypePickerRows', () => {
+  it('puts the built-in types first, in one uncaptioned row', () => {
+    const rows = buildTaskTypePickerRows(
+      BUILT_INS,
+      [custom('org:introduce-api', 'API delivery')],
+      CAPTIONS,
+    )
+
+    expect(rows[0]).toEqual({ id: 'built-in', caption: null, choices: BUILT_INS })
+    expect(rows[1]?.caption).toBe('API delivery')
+  })
+
+  it('groups custom types sharing a category under one caption, in first-appearance order', () => {
+    const rows = buildTaskTypePickerRows(
+      BUILT_INS,
+      [
+        custom('org:introduce-api', 'API delivery'),
+        custom('org:onboard-tenant', 'Tenancy'),
+        custom('org:retire-endpoint', 'API delivery'),
+      ],
+      CAPTIONS,
+    )
+
+    // Registration order is the only order the deployment expressed, so it is the caption order,
+    // NOT alphabetical (which would put 'API delivery' first by accident here).
+    expect(rows.slice(1).map((r) => r.caption)).toEqual(['API delivery', 'Tenancy'])
+    expect(rows[1]?.choices.map((c) => c.value)).toEqual([
+      'org:introduce-api',
+      'org:retire-endpoint',
+    ])
+    expect(rows[2]?.choices.map((c) => c.value)).toEqual(['org:onboard-tenant'])
+  })
+
+  it('carries the verbatim wire presentation onto each custom choice', () => {
+    const rows = buildTaskTypePickerRows(
+      BUILT_INS,
+      [custom('org:introduce-api', 'API delivery', 'Expose functionality over the standard API.')],
+      CAPTIONS,
+    )
+
+    expect(rows[1]?.choices[0]).toEqual({
+      value: 'org:introduce-api',
+      label: 'introduce-api',
+      icon: 'i-lucide-plug',
+      description: 'Expose functionality over the standard API.',
+    })
+  })
+
+  it('folds captions differing only in case or spacing into one row, keeping the first spelling', () => {
+    const rows = buildTaskTypePickerRows(
+      BUILT_INS,
+      [custom('org:introduce-api', 'API delivery'), custom('org:retire-endpoint', 'api  DELIVERY')],
+      CAPTIONS,
+    )
+
+    // One row, captioned as the deployment first wrote it: a second heading differing only in case
+    // would read as a second category its author never declared.
+    expect(rows).toHaveLength(2)
+    expect(rows[1]?.caption).toBe('API delivery')
+    expect(rows[1]?.id).toBe('category:api delivery')
+    expect(rows[1]?.choices.map((c) => c.value)).toEqual([
+      'org:introduce-api',
+      'org:retire-endpoint',
+    ])
+  })
+
+  it('keeps captions that differ beyond case and spacing apart, non-ASCII included', () => {
+    const rows = buildTaskTypePickerRows(
+      [],
+      [custom('org:ambito', 'Ámbito'), custom('org:embito', 'Émbito')],
+      CAPTIONS,
+    )
+
+    expect(rows.map((r) => r.caption)).toEqual(['Ámbito', 'Émbito'])
+  })
+
+  it('captions the trailing uncategorized row with the caller chrome string', () => {
+    const rows = buildTaskTypePickerRows(
+      BUILT_INS,
+      [
+        custom('acme:incident'),
+        custom('org:introduce-api', 'API delivery'),
+        custom('acme:pentest'),
+      ],
+      CAPTIONS,
+    )
+
+    expect(rows.map((r) => r.caption)).toEqual([null, 'API delivery', 'Other'])
+    expect(rows[2]).toEqual({
+      id: 'other',
+      caption: 'Other',
+      choices: [
+        expect.objectContaining({ value: 'acme:incident' }),
+        expect.objectContaining({ value: 'acme:pentest' }),
+      ],
+    })
+  })
+
+  it('leaves the uncategorized row uncaptioned when it is the only row', () => {
+    // Nothing precedes it, so a heading would name a distinction the picker does not show.
+    const rows = buildTaskTypePickerRows([], [custom('acme:incident')], CAPTIONS)
+
+    expect(rows).toEqual([
+      {
+        id: 'other',
+        caption: null,
+        choices: [expect.objectContaining({ value: 'acme:incident' })],
+      },
+    ])
+  })
+
+  it('treats a blank category as no category rather than an empty caption', () => {
+    // A CODE-shipped consumer type skips the wire schema's `v.trim()`, so this is reachable.
+    const rows = buildTaskTypePickerRows(BUILT_INS, [custom('acme:incident', '   ')], CAPTIONS)
+
+    expect(rows.map((r) => r.id)).toEqual(['built-in', 'other'])
+  })
+
+  it('emits no rows for empty inputs, and no custom rows when nothing is registered', () => {
+    expect(buildTaskTypePickerRows([], [], CAPTIONS)).toEqual([])
+    expect(buildTaskTypePickerRows(BUILT_INS, [], CAPTIONS).map((r) => r.id)).toEqual(['built-in'])
+  })
+
+  it('keeps a row per category even when only custom types are offered', () => {
+    const rows = buildTaskTypePickerRows(
+      [],
+      [custom('org:introduce-api', 'API delivery')],
+      CAPTIONS,
+    )
+
+    expect(rows.map((r) => r.caption)).toEqual(['API delivery'])
+  })
+})

package/app/utils/taskTypePicker.ts

@@ -0,0 +1,127 @@
+import type { CustomTaskType } from '~/types/domain'
+
+/**
+ * The create-task type picker's layout rule (reusable-operations initiative, slice 3).
+ *
+ * The picker was one flat button row, which is right for the handful of built-in types and wrong
+ * the moment a deployment registers a catalog of REUSABLE OPERATIONS: an org with twenty of them
+ * ("Introduce API", "Retire endpoint", "Add tenant", …) turns the row into an undifferentiated
+ * wall in which the everyday `feature` / `bug` choices are no longer findable. Each custom type
+ * may declare a `presentation.category`, and this is where that axis becomes rows.
+ *
+ * Extracted rather than inlined in `AddTaskModal.vue` for the same reason as
+ * `buildFragmentCategoryGroups`: the ORDER is the behaviour worth pinning, and a rule inside an
+ * SFC is only reachable by mounting one.
+ */
+
+/** One selectable type in the picker. */
+export interface TaskTypePickerChoice<T extends string = string> {
+  /** The task type id submitted on create. */
+  value: T
+  /** Button label: an i18n string for a built-in, the verbatim wire presentation for a custom type. */
+  label: string
+  /** Icon id (`i-lucide-*`). */
+  icon: string
+  /**
+   * The deployment-authored one-liner from a CUSTOM type's presentation, rendered verbatim (never
+   * i18n). Absent for a built-in type, whose meaning is fixed and whose label is already localized.
+   */
+  description?: string
+}
+
+/** One row of the picker: the choices under an optional caption. */
+export interface TaskTypePickerRow<T extends string = string> {
+  /**
+   * Stable `v-for` key, also published as the row's `data-task-type-row` attribute so a caption
+   * (whose `data-testid` repeats per row, exactly as `pipeline-step`'s does) is addressable through
+   * its row instead of by position. Never rendered as text: `built-in`, `other`, or
+   * `category:<folded caption>`.
+   */
+  id: string
+  /**
+   * The row's heading, or `null` for an UNCAPTIONED row. Deployment-authored and rendered verbatim
+   * for a category row; the caller's localized chrome string for the leftovers row.
+   */
+  caption: string | null
+  choices: TaskTypePickerChoice<T>[]
+}
+
+/** The localized CHROME captions the picker needs; every other caption is deployment-authored. */
+export interface TaskTypePickerCaptions {
+  /** Heading for the trailing row of custom types that declared no category. */
+  other: string
+}
+
+/**
+ * Lay the picker out as rows: the BUILT-IN types first in one uncaptioned row (the everyday
+ * delivery loop stays where it has always been), then one captioned row per declared category in
+ * first-appearance order (the deployment's own registration order, which is the only order it
+ * expressed), then any uncategorized custom types in a trailing row captioned `captions.other`.
+ *
+ * Deliberately no collapsing, no overflow menu and no alphabetical re-sort: an operation catalog
+ * that needs those has outgrown what a create-task dialog should be asking, and each would hide a
+ * choice behind a second interaction.
+ */
+export function buildTaskTypePickerRows<T extends string>(
+  builtIns: readonly TaskTypePickerChoice<T>[],
+  customTypes: readonly CustomTaskType[],
+  captions: TaskTypePickerCaptions,
+): TaskTypePickerRow<T>[] {
+  const rows: TaskTypePickerRow<T>[] = []
+  if (builtIns.length > 0) rows.push({ id: 'built-in', caption: null, choices: [...builtIns] })
+
+  const byCategory = new Map<string, { caption: string; choices: TaskTypePickerChoice<T>[] }>()
+  const uncategorized: TaskTypePickerChoice<T>[] = []
+  for (const type of customTypes) {
+    const choice = toChoice<T>(type)
+    // A category is `v.trim()`-ed on the wire, but a CODE-shipped consumer type is trusted and
+    // unvalidated (see `docs/consumer-extensions.md`), so a whitespace-only caption is possible
+    // and must read as "no category" rather than render an empty heading.
+    const caption = type.presentation.category?.trim()
+    if (!caption) {
+      uncategorized.push(choice)
+      continue
+    }
+    const key = categoryKey(caption)
+    const bucket = byCategory.get(key)
+    if (bucket) bucket.choices.push(choice)
+    else byCategory.set(key, { caption, choices: [choice] })
+  }
+
+  for (const [key, { caption, choices }] of byCategory)
+    rows.push({ id: `category:${key}`, caption, choices })
+  // The leftovers are captioned only when something PRECEDES them: as the picker's only row they
+  // are the whole catalog, and a heading would then name a distinction the user cannot see.
+  if (uncategorized.length > 0)
+    rows.push({
+      id: 'other',
+      caption: rows.length > 0 ? captions.other : null,
+      choices: uncategorized,
+    })
+  return rows
+}
+
+/**
+ * The bucket a caption falls in: its own text folded on CASE and on whitespace runs, so two
+ * spellings of one category ("API delivery" / "api  delivery") are ONE row rather than
+ * near-duplicate headings sitting beside each other. The row still renders the FIRST-SEEN
+ * spelling verbatim, because the caption is the deployment's own words.
+ *
+ * Deliberately NOT slugified: a caption is arbitrary Unicode (a deployment writes it in its own
+ * language), so stripping it to an id-safe `[a-z0-9-]` key would fold genuinely distinct captions
+ * onto each other ("Ámbito" and "Émbito" both reduce to `mbito`). That is also why the row id
+ * carries the folded caption as-is and is addressed as an attribute VALUE rather than a testid.
+ */
+function categoryKey(caption: string): string {
+  return caption.toLowerCase().replace(/\s+/g, ' ')
+}
+
+/**
+ * A registered custom type as a picker choice. The id assertion carries the widened `taskType`
+ * contract (`<built-in> | <ns>:<name>`): a namespaced registered id IS a legal create-task value,
+ * which is what let `AddTaskModal` offer these choices in the first place.
+ */
+function toChoice<T extends string>(type: CustomTaskType): TaskTypePickerChoice<T> {
+  const { label, icon, description } = type.presentation
+  return { value: type.taskType as T, label, icon, ...(description ? { description } : {}) }
+}

package/i18n/locales/de.json

@@ -2600,6 +2600,7 @@
       "title": "Eine Aufgabe hinzufügen",
       "newTaskIn": "Neue Aufgabe in {container}",
       "typeLabel": "Typ",
+      "typeOther": "Sonstige",
       "types": {
         "feature": "Feature",
         "bug": "Bug",
@@ -3680,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",
@@ -5200,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": {
@@ -5236,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

@@ -216,6 +216,10 @@
       "title": "Add a task",
       "newTaskIn": "New task in {container}",
       "typeLabel": "Type",
+      "typeOther": "Other",
+      "@typeOther": {
+        "description": "Heading over the trailing group in the task-type picker: the deployment's own registered task types that declared no category of their own. A NOUN-like group heading ('the other ones'), not the adjective describing a single type."
+      },
       "types": {
         "feature": "Feature",
         "bug": "Bug",
@@ -639,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": {
@@ -678,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": {
@@ -4181,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

@@ -189,6 +189,7 @@
       "title": "Añadir una tarea",
       "newTaskIn": "Nueva tarea en {container}",
       "typeLabel": "Tipo",
+      "typeOther": "Otros",
       "types": {
         "feature": "Funcionalidad",
         "bug": "Error",
@@ -576,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": {
@@ -612,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": {
@@ -4059,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

@@ -189,6 +189,7 @@
       "title": "Ajouter une tâche",
       "newTaskIn": "Nouvelle tâche dans {container}",
       "typeLabel": "Type",
+      "typeOther": "Autres",
       "types": {
         "feature": "Fonctionnalité",
         "bug": "Bug",
@@ -576,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": {
@@ -612,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": {
@@ -4059,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

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

package/i18n/locales/it.json

@@ -2600,6 +2600,7 @@
       "title": "Aggiungi un'attività",
       "newTaskIn": "Nuova attività in {container}",
       "typeLabel": "Tipo",
+      "typeOther": "Altri",
       "types": {
         "feature": "Feature",
         "bug": "Bug",
@@ -3680,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",
@@ -5200,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": {
@@ -5236,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

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

package/i18n/locales/pl.json

@@ -189,6 +189,7 @@
       "title": "Dodaj zadanie",
       "newTaskIn": "Nowe zadanie w {container}",
       "typeLabel": "Typ",
+      "typeOther": "Inne",
       "types": {
         "feature": "Funkcja",
         "bug": "Błąd",
@@ -576,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": {
@@ -612,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": {
@@ -4059,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

@@ -189,6 +189,7 @@
       "title": "Görev ekle",
       "newTaskIn": "{container} içinde yeni görev",
       "typeLabel": "Tür",
+      "typeOther": "Diğer",
       "types": {
         "feature": "Özellik",
         "bug": "Hata",
@@ -576,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": {
@@ -612,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": {
@@ -4059,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

@@ -189,6 +189,7 @@
       "title": "Додати завдання",
       "newTaskIn": "Нове завдання в {container}",
       "typeLabel": "Тип",
+      "typeOther": "Інші",
       "types": {
         "feature": "Функція",
         "bug": "Помилка",
@@ -576,6 +577,7 @@
         "input_gate_not_parked": "Немає на що відповідати",
         "input_gate_parked": "Відповідайте в перевірці вхідних даних завдання",
         "ticket_already_linked": "У цього тікета вже є завдання",
+        "document_already_linked": "Документ уже прикріплено",
         "dry_run_not_mergeable": "Пробний запуск не можна злити"
       },
       "description": {
@@ -612,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": {
@@ -4059,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.219.1",
+  "version": "0.221.0",
   "description": "Reusable Nuxt layer for the Agent Architecture Board SPA (components, stores, composables, pages). Consume it from a thin deployment app via `extends: ['@cat-factory/app']` and point it at your backend with NUXT_PUBLIC_API_BASE. See deploy/frontend for an example.",
   "repository": {
     "type": "git",
@@ -40,7 +40,7 @@
     "valibot": "^1.4.2",
     "vue": "3.5.40",
     "wretch": "^3.0.9",
-    "@cat-factory/contracts": "0.233.0"
+    "@cat-factory/contracts": "0.235.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",