@cat-factory/app 0.141.1 → 0.142.0

package/app/components/board/AddTaskModal.vue

@@ -289,8 +289,9 @@ const selectedModelPresetLabel = computed(() => {
 // Hide UI-testing pipelines (`tester-ui` / `visual-confirmation`) when the target frame has no
 // UI to exercise — they'd be refused server-side (see utils/pipeline + the backend gate). Also
 // hide `'recurring'`-only pipelines (a one-off task start of one is refused at run start) and,
-// for a `document` task, every non-document pipeline (it authors a doc — only document pipelines
-// are relevant, per the `purpose` classifier). Re-filters as the chosen task type changes.
+// for a `document` / `review` task, every pipeline whose purpose doesn't match (a doc task authors
+// a doc, a review task reviews a PR — only document / review pipelines are relevant, per the
+// `purpose` classifier). Re-filters as the chosen task type changes.
 const selectablePipelines = computed(() =>
   pipelines.pipelines.filter((p) =>
     pipelineAllowedForManualStart(p, frame.value, board.blocks, taskType.value),
@@ -302,14 +303,16 @@ const selectablePipelines = computed(() =>
 // must appear in the form BEFORE creation:
 //   - `ralph` needs its preset so the per-task validation command + iteration budget the `ralph`
 //     agent contributes surface for editing ("choose at run time" would be a dead end);
-//   - a `document` task defaults to `pl_document` so its document-only picker (the `purpose` gate
-//     hides every non-document pipeline) is never rendered empty.
-// The other typed defaults (spike/review) carry no up-front config and don't narrow their picker,
-// so the modal leaves `pipelineId` unset and `BoardService` applies the backend type-default at
-// creation. Keep these ids in step with the backend helper.
+//   - a `document` task defaults to `pl_document` and a `review` task to `pl_review` so their
+//     purpose-narrowed picker (the `purpose` gate hides every non-document / non-review pipeline)
+//     is never rendered empty.
+// The other typed default (spike) carries no up-front config and doesn't narrow its picker, so the
+// modal leaves `pipelineId` unset and `BoardService` applies the backend type-default at creation.
+// Keep these ids in step with the backend helper.
 const DEFAULT_PIPELINE_FOR_TYPE: Partial<Record<TaskTypeChoice, string>> = {
   ralph: 'pl_ralph',
   document: 'pl_document',
+  review: 'pl_review',
 }
 watch(taskType, (next) => {
   const preset = DEFAULT_PIPELINE_FOR_TYPE[next]

package/app/components/documents/RepoContextDocPicker.vue

@@ -51,8 +51,12 @@ const selectedRepoId = ref<number | undefined>(undefined)
 const selectedRepo = ref<GitHubAvailableRepo | undefined>(undefined)
 
 function toRepoItem(r: GitHubAvailableRepo) {
-  const suffix = r.private ? t('github.addService.repoLabel.private') : ''
-  return { label: `${r.owner}/${r.name}${suffix}`, value: r.githubId }
+  const priv = r.private ? t('github.addService.repoLabel.private') : ''
+  // Badge a repo reachable only via the user's own PAT: a context doc from it resolves through
+  // the workspace App at run time, so on hosted a personal-only repo fails the link with a clear
+  // error. The badge flags that before the pick.
+  const personal = r.personal ? t('github.addService.repoLabel.personal') : ''
+  return { label: `${r.owner}/${r.name}${priv}${personal}`, value: r.githubId }
 }
 const queryMatches = computed(() => (belowMinChars.value ? [] : repoResults.value.map(toRepoItem)))
 const repoMenuItems = computed(() => {

package/app/components/fragments/FragmentLibraryManager.vue

@@ -181,61 +181,131 @@ async function removeFragment(id: string) {
 // Link a Confluence/Notion page or GitHub file as a fragment that is re-resolved
 // from the source at run time (a living source of truth, not a frozen snapshot).
 const docDraft = ref({ source: '' as DocumentSourceKind | '', ref: '', tags: '' })
-const docDraftValid = computed(
-  () => !docLinkDisabled.value && docDraft.value.source && docDraft.value.ref.trim(),
-)
+const docDraftValid = computed(() => {
+  if (docLinkDisabled.value || !docDraft.value.source) return false
+  // The GitHub picker validates on staged files; every other path on the free-text ref.
+  return usingDocPicker.value ? docFilePaths.value.length > 0 : !!docDraft.value.ref.trim()
+})
 
 // ---- GitHub file picker (documents tab) -----------------------------------
-// For a GitHub source, let the user search a repo + browse to the file instead of
-// hand-typing a `owner/repo:path` ref. Picking a file fills `docDraft.ref` (still
-// editable, so pasting a URL/shorthand keeps working). Only offered when the App is
-// connected; other sources (Confluence/Notion) keep the free-text ref field.
+// For a GitHub source, let the user search a repo + browse to one or MORE files
+// instead of hand-typing a `owner/repo:path` ref. Files are staged into a cart that
+// spans folders (browsing away never drops earlier picks), and every staged file is
+// linked as its own living fragment on submit. Only offered when the App/PAT is
+// connected; other sources (Confluence/Notion) keep the single free-text ref field.
 const isGithubDoc = computed(() => docDraft.value.source === 'github')
 const showGithubDocPicker = computed(() => isGithubDoc.value && githubReady.value)
 const docRepoId = ref<number | undefined>(undefined)
 const docRepo = ref<GitHubAvailableRepo | undefined>(undefined)
-const docFilePath = ref<string | undefined>(undefined)
+// The staged files (repo-root-relative paths) for the selected repo. Multi-select so
+// any number of files from any nesting level can be linked in one action.
+const docFilePaths = ref<string[]>([])
 
-// Reset the picker (and the derived ref) whenever the selected source changes.
+// Reset the picker (and the manual ref) whenever the selected source changes.
 watch(
   () => docDraft.value.source,
   () => {
     docRepoId.value = undefined
     docRepo.value = undefined
-    docFilePath.value = undefined
+    docFilePaths.value = []
     docDraft.value.ref = ''
   },
 )
 
-// A new repo selection clears the previously-browsed file.
-watch(docRepoId, () => {
-  docFilePath.value = undefined
-})
-
-// Derive the canonical `owner/repo:path` ref the GitHub docs provider expects.
-watch([docRepo, docFilePath], () => {
-  if (docRepo.value && docFilePath.value) {
-    docDraft.value.ref = `${docRepo.value.owner}/${docRepo.value.name}:${docFilePath.value}`
-  }
+// A new repo selection clears the previously-staged files (they were repo-scoped).
+// When the repo is fully deselected, drop the cached repo too so no stale `docRepo`
+// lingers behind a now-empty picker.
+watch(docRepoId, (id) => {
+  docFilePaths.value = []
+  if (id === undefined) docRepo.value = undefined
 })
 
 /** This tier's existing document-backed fragments. */
 const documentFragments = computed(() => library.fragments.filter((f) => f.documentRef))
 
+/** Add/remove a browsed file to/from the staged cart (the tree emits `toggle`). */
+function toggleDocFile(path: string) {
+  const clean = normalizeRepoPath(path)
+  const i = docFilePaths.value.indexOf(clean)
+  if (i >= 0) docFilePaths.value.splice(i, 1)
+  else docFilePaths.value.push(clean)
+}
+
+/** Files of the selected repo already linked as fragments — shown "added"/not re-pickable. */
+const docAddedPaths = computed<string[]>(() => {
+  const repo = docRepo.value
+  if (!repo) return []
+  const prefix = `${repo.owner}/${repo.name}:`
+  return documentFragments.value
+    .filter(
+      (f) => f.documentRef?.source === 'github' && f.documentRef.externalId.startsWith(prefix),
+    )
+    .map((f) => f.documentRef!.externalId.slice(prefix.length))
+})
+
+/** The canonical `owner/repo:path` refs for the staged files. */
+const stagedDocRefs = computed(() =>
+  docRepo.value
+    ? docFilePaths.value.map((path) => ({
+        path,
+        ref: `${docRepo.value!.owner}/${docRepo.value!.name}:${path}`,
+      }))
+    : [],
+)
+
+/** When the rich picker drives the ref(s); otherwise the free-text field does. */
+const usingDocPicker = computed(() => showGithubDocPicker.value)
+
 async function linkDocumentFragment() {
   if (!docDraftValid.value) return
   linkingDoc.value = true
   try {
-    await library.createDocumentFragment({
-      source: docDraft.value.source as DocumentSourceKind,
-      ref: docDraft.value.ref.trim(),
-      tags: docDraft.value.tags
-        .split(',')
-        .map((t) => t.trim())
-        .filter(Boolean),
-    })
-    docDraft.value = { source: '', ref: '', tags: '' }
-    toast.add({ title: t('fragments.toast.documentLinked'), icon: 'i-lucide-link' })
+    const source = docDraft.value.source as DocumentSourceKind
+    const tags = docDraft.value.tags
+      .split(',')
+      .map((t) => t.trim())
+      .filter(Boolean)
+
+    if (!usingDocPicker.value) {
+      // Free-text field: exactly one ref.
+      await library.createDocumentFragment({ source, ref: docDraft.value.ref.trim(), tags })
+      docDraft.value = { source: '', ref: '', tags: '' }
+      toast.add({ title: t('fragments.toast.documentLinked'), icon: 'i-lucide-link' })
+      return
+    }
+
+    // The picker stages many files (one fragment each). Link them serially — serial, not
+    // parallel, so one bad ref can't be masked by a burst of concurrent failures — and drop
+    // each from the cart the moment it succeeds. Every staged file is attempted even if an
+    // earlier one fails, so a single unlinkable ref never blocks the rest: the successes are
+    // linked and removed from the cart, and only the failures stay staged (with the first
+    // error surfaced) so a retry re-attempts just those, never re-linking what already went in.
+    let linked = 0
+    let firstError: unknown
+    for (const { path, ref } of stagedDocRefs.value) {
+      try {
+        await library.createDocumentFragment({ source, ref, tags })
+        const i = docFilePaths.value.indexOf(path)
+        if (i >= 0) docFilePaths.value.splice(i, 1)
+        linked++
+      } catch (e) {
+        firstError ??= e
+      }
+    }
+    if (linked > 0) {
+      // A vue-i18n plural message (count as the plural choice) so Slavic few/many forms
+      // render correctly, and the count==1 case reads naturally too.
+      toast.add({
+        title: t('fragments.toast.documentsLinked', { count: linked }, linked),
+        icon: 'i-lucide-link',
+      })
+    }
+    if (firstError) {
+      notifyError(t('fragments.toast.linkDocumentFailed'), firstError)
+    } else {
+      // Everything staged linked — clear the whole draft (also resets repo/source selection).
+      docDraft.value = { source: '', ref: '', tags: '' }
+    }
   } catch (e) {
     notifyError(t('fragments.toast.linkDocumentFailed'), e)
   } finally {
@@ -584,7 +654,7 @@ async function unlinkSource(id: string) {
               </UButton>
             </div>
 
-            <!-- GitHub: search a repo + browse to the file instead of typing the ref -->
+            <!-- GitHub: search a repo + browse to one or more files instead of typing the ref -->
             <template v-if="showGithubDocPicker">
               <GitHubRepoSearchSelect v-model="docRepoId" @update:repo="docRepo = $event" />
               <div
@@ -594,11 +664,47 @@ async function unlinkSource(id: string) {
                 <p class="mb-2 text-xs text-slate-400">
                   {{ t('fragments.documents.githubBrowseHint') }}
                 </p>
-                <RepoTreeBrowser v-model="docFilePath" :repo-github-id="docRepoId" mode="file" />
+                <RepoTreeBrowser
+                  :repo-github-id="docRepoId"
+                  mode="file"
+                  multiple
+                  :selected-paths="docFilePaths"
+                  :added-paths="docAddedPaths"
+                  @toggle="toggleDocFile"
+                />
+                <div v-if="stagedDocRefs.length" class="mt-2 space-y-1">
+                  <p class="text-xs font-medium text-slate-400">
+                    {{ t('fragments.documents.selectedFiles', { count: stagedDocRefs.length }) }}
+                  </p>
+                  <div
+                    v-for="staged in stagedDocRefs"
+                    :key="staged.path"
+                    class="flex items-center gap-1.5 rounded bg-slate-800/60 px-2 py-1 text-xs text-slate-300"
+                  >
+                    <UIcon
+                      name="i-lucide-file-code-2"
+                      class="h-3.5 w-3.5 shrink-0 text-indigo-400"
+                    />
+                    <span class="truncate">{{ staged.path }}</span>
+                    <UButton
+                      class="ms-auto"
+                      color="neutral"
+                      variant="ghost"
+                      size="xs"
+                      icon="i-lucide-x"
+                      :aria-label="t('fragments.documents.removeFile')"
+                      @click="toggleDocFile(staged.path)"
+                    />
+                  </div>
+                </div>
               </div>
             </template>
 
-            <UInput v-model="docDraft.ref" :placeholder="t('fragments.documents.refPlaceholder')" />
+            <UInput
+              v-if="!usingDocPicker"
+              v-model="docDraft.ref"
+              :placeholder="t('fragments.documents.refPlaceholder')"
+            />
             <UInput
               v-model="docDraft.tags"
               :placeholder="t('fragments.documents.tagsPlaceholder')"

package/app/components/github/GitHubRepoSearchSelect.vue

@@ -34,8 +34,13 @@ const belowMinChars = computed(() => repoQueryRaw.value.length < MIN_SEARCH_LEN)
 const selectedRepo = ref<GitHubAvailableRepo | undefined>(undefined)
 
 function toRepoItem(r: GitHubAvailableRepo) {
-  const suffix = r.private ? t('github.addService.repoLabel.private') : ''
-  return { label: `${r.owner}/${r.name}${suffix}`, value: r.githubId }
+  const priv = r.private ? t('github.addService.repoLabel.private') : ''
+  // A repo surfaced only through the signed-in user's PAT (the workspace App can't reach it):
+  // badge it so the user knows this pick rides their personal token. On hosted, a doc/fragment
+  // linked from it resolves through the App at run time, so a personal-only repo will fail the
+  // link with a clear error — the badge sets that expectation up front.
+  const personal = r.personal ? t('github.addService.repoLabel.personal') : ''
+  return { label: `${r.owner}/${r.name}${priv}${personal}`, value: r.githubId }
 }
 
 const repoItems = computed(() => github.availableRepos.map(toRepoItem))

package/app/components/pipeline/PipelineHealthModal.vue

@@ -1,13 +1,16 @@
 <script setup lang="ts">
 // Startup advisory for unhealthy pipelines. Opened once per session from the board page when
 // `usePipelineHealth` reports any issue. Lists:
+//   • new built-in pipelines the workspace doesn't have yet (ADD them);
 //   • invalid pipelines (unknown agent kind / bad shape) — DELETE a custom one, RESEED a built-in;
 //   • outdated built-ins (a newer catalog definition is available) — RESEED to adopt it.
-// Detection is client-side (see usePipelineHealth); the actions hit the pipelines store.
+// Adding a new built-in and reseeding an existing one are the same reseed call (it creates or
+// updates by catalog id). Detection is client-side (see usePipelineHealth); the actions hit the
+// pipelines store.
 const { t } = useI18n()
 const ui = useUiStore()
 const pipelines = usePipelinesStore()
-const { invalid, outdated, hasIssues } = usePipelineHealth()
+const { invalid, outdated, newPipelines, hasIssues } = usePipelineHealth()
 const toast = useToast()
 
 const open = computed({
@@ -45,17 +48,20 @@ const reseed = (id: string) =>
 const remove = (id: string) =>
   run(id, () => pipelines.removePipeline(id), t('pipeline.health.toast.deleteFailed'))
 
-/** Reseed every reseedable pipeline (outdated built-ins + invalid built-ins) in one go. */
+/** Reseed every reseedable pipeline (new + outdated built-ins + invalid built-ins) in one go. */
 async function reseedAll() {
-  const ids = [...invalid.value.filter((h) => h.pipeline.builtin), ...outdated.value].map(
-    (h) => h.pipeline.id,
-  )
+  const ids = [
+    ...newPipelines.value.map((p) => p.id),
+    ...invalid.value.filter((h) => h.pipeline.builtin).map((h) => h.pipeline.id),
+    ...outdated.value.map((h) => h.pipeline.id),
+  ]
   for (const id of new Set(ids)) await reseed(id)
 }
 
 const reseedableCount = computed(
   () =>
     new Set([
+      ...newPipelines.value.map((p) => p.id),
       ...invalid.value.filter((h) => h.pipeline.builtin).map((h) => h.pipeline.id),
       ...outdated.value.map((h) => h.pipeline.id),
     ]).size,
@@ -71,6 +77,41 @@ const reseedableCount = computed(
       </div>
 
       <div v-else class="space-y-5">
+        <!-- New built-in pipelines the workspace can add. -->
+        <section v-if="newPipelines.length" class="space-y-2">
+          <div class="flex items-center gap-2">
+            <UIcon name="i-lucide-sparkles" class="h-4 w-4 text-emerald-400" />
+            <h3 class="text-sm font-semibold text-slate-200">
+              {{ t('pipeline.health.newHeading') }}
+            </h3>
+          </div>
+          <p class="text-[11px] text-slate-500">{{ t('pipeline.health.newDescription') }}</p>
+          <ul class="space-y-2">
+            <li
+              v-for="p in newPipelines"
+              :key="p.id"
+              class="flex items-center justify-between gap-3 rounded-lg border border-slate-800 bg-slate-900/40 p-3"
+            >
+              <div class="min-w-0">
+                <span class="truncate text-sm font-medium text-slate-100 capitalize">{{
+                  p.name
+                }}</span>
+              </div>
+              <UButton
+                size="xs"
+                color="primary"
+                variant="subtle"
+                icon="i-lucide-plus"
+                :loading="isBusy(p.id)"
+                :disabled="anyBusy"
+                @click="reseed(p.id)"
+              >
+                {{ t('pipeline.health.add') }}
+              </UButton>
+            </li>
+          </ul>
+        </section>
+
         <!-- Invalid: unknown agent kinds or a broken shape. -->
         <section v-if="invalid.length" class="space-y-2">
           <div class="flex items-center gap-2">

package/app/composables/usePipelineHealth.spec.ts

@@ -142,4 +142,26 @@ describe('usePipelineHealth', () => {
     expect(invalid.value).toHaveLength(1)
     expect(outdated.value).toHaveLength(0)
   })
+
+  it('surfaces a brand-new built-in the workspace does not have yet (offer to add)', () => {
+    // A board seeded before `pl_review` shipped: the catalog versions advertise it, but no stored
+    // pipeline has that id — so it must appear as a "new" pipeline the user can add.
+    const stored = builtin(['coder', 'reviewer'], { id: 'pl_full', version: 1 })
+    const { newPipelines, hasIssues, invalid, outdated } = scan([stored], {
+      pl_full: 1,
+      pl_review: 4,
+    })
+    expect(newPipelines.value).toEqual([{ id: 'pl_review', name: 'review' }])
+    expect(hasIssues.value).toBe(true)
+    // A brand-new built-in is not "invalid" or "outdated" — those only concern STORED pipelines.
+    expect(invalid.value).toHaveLength(0)
+    expect(outdated.value).toHaveLength(0)
+  })
+
+  it('reports no new pipelines when every catalog id is already stored', () => {
+    const stored = builtin(['coder', 'reviewer'], { id: 'pl_full', version: 1 })
+    const { newPipelines, hasIssues } = scan([stored], { pl_full: 1 })
+    expect(newPipelines.value).toHaveLength(0)
+    expect(hasIssues.value).toBe(false)
+  })
 })

package/app/composables/usePipelineHealth.ts

@@ -23,6 +23,23 @@ export interface PipelineHealth {
   outdated: boolean
 }
 
+/** A brand-new built-in pipeline that appeared in the catalog but isn't in the workspace yet. */
+export interface NewPipeline {
+  /** The catalog (built-in) id — what the reseed endpoint is keyed by (it creates the row). */
+  id: string
+  /** The built-in's display name, from the catalog versions' companion name map. */
+  name: string
+}
+
+/**
+ * A built-in's display name for the "new pipeline" advisory, humanised from its catalog id
+ * (`pl_review` -> "review", rendered capitalised) — used only until the row is reseeded into
+ * existence, at which point its real catalog name is stored. Mirrors `useRiskPolicyHealth`.
+ */
+function builtinPipelineName(id: string): string {
+  return id.replace(/^pl_/, '').replace(/_/g, ' ')
+}
+
 /** Producers a companion kind is allowed to review (inverse of {@link COMPANION_FOR_PRODUCER}). */
 function companionTargets(companion: string): string[] {
   return Object.entries(COMPANION_FOR_PRODUCER)
@@ -88,12 +105,14 @@ function shapeProblem(p: Pipeline): string | null {
 
 /**
  * Detect pipelines in an unhealthy state for the startup advisory: those referencing an unknown
- * agent kind or with an invalid shape (offer to delete a custom one / reseed a built-in), and
- * built-ins whose seeded definition has moved ahead of the stored copy (offer to reseed). Reads
- * the pipeline library + the snapshot's catalog versions from the pipelines store. Detection runs
- * entirely client-side because the canonical agent-kind catalog lives here (`AGENT_BY_KIND` +
- * `SYSTEM_AGENT_META` + registered custom kinds); the version comparison uses the catalog
- * versions the snapshot ships.
+ * agent kind or with an invalid shape (offer to delete a custom one / reseed a built-in), built-ins
+ * whose seeded definition has moved ahead of the stored copy (offer to reseed), AND brand-new
+ * built-ins that appeared in the catalog but aren't in the workspace yet (offer to ADD them — a
+ * board seeded before the built-in shipped, e.g. `pl_review`). Reads the pipeline library + the
+ * snapshot's catalog versions from the pipelines store. Detection runs entirely client-side: the
+ * canonical agent-kind catalog lives here (`AGENT_BY_KIND` + `SYSTEM_AGENT_META` + registered custom
+ * kinds), and the catalog versions the snapshot ships ARE the set of built-in ids — a catalog id
+ * with no stored pipeline is a new built-in. Mirrors `useRiskPolicyHealth` / `useModelPresetHealth`.
  */
 export function usePipelineHealth() {
   const store = usePipelinesStore()
@@ -130,11 +149,20 @@ export function usePipelineHealth() {
     return out
   })
 
+  // Brand-new built-ins: a catalog id (a `catalogVersions` key) with no stored pipeline. Adding one
+  // is the same reseed call as adopting an update (it inserts the row when absent).
+  const newPipelines = computed<NewPipeline[]>(() => {
+    const storedIds = new Set(store.pipelines.map((p) => p.id))
+    return Object.keys(store.catalogVersions)
+      .filter((id) => !storedIds.has(id))
+      .map((id) => ({ id, name: builtinPipelineName(id) }))
+  })
+
   // An invalid built-in is reseeded (not deleted) and that also clears any "outdated" flag, so
   // exclude it from the outdated list to avoid offering the same fix twice.
   const invalid = computed(() => health.value.filter((h) => h.invalid))
   const outdated = computed(() => health.value.filter((h) => h.outdated && !h.invalid))
-  const hasIssues = computed(() => health.value.length > 0)
+  const hasIssues = computed(() => health.value.length > 0 || newPipelines.value.length > 0)
 
-  return { health, invalid, outdated, hasIssues }
+  return { health, invalid, outdated, newPipelines, hasIssues }
 }

package/app/utils/pipeline.spec.ts

@@ -17,10 +17,19 @@ describe('pipelineAllowedForTaskType', () => {
     expect(pipelineAllowedForTaskType(pipeline({ purpose: undefined }), 'document')).toBe(false)
   })
 
-  it('every non-document task type is unrestricted (any purpose, and undefined type)', () => {
-    for (const type of ['feature', 'bug', 'spike', 'review', 'ralph', undefined] as const) {
+  it('a review task offers ONLY review-purpose pipelines', () => {
+    expect(pipelineAllowedForTaskType(pipeline({ purpose: 'review' }), 'review')).toBe(true)
+    expect(pipelineAllowedForTaskType(pipeline({ purpose: 'build' }), 'review')).toBe(false)
+    expect(pipelineAllowedForTaskType(pipeline({ purpose: 'document' }), 'review')).toBe(false)
+    // An unclassified pipeline is hidden from a review task (it requires the explicit classifier).
+    expect(pipelineAllowedForTaskType(pipeline({ purpose: undefined }), 'review')).toBe(false)
+  })
+
+  it('every other task type is unrestricted (any purpose, and undefined type)', () => {
+    for (const type of ['feature', 'bug', 'spike', 'ralph', undefined] as const) {
       expect(pipelineAllowedForTaskType(pipeline({ purpose: 'build' }), type)).toBe(true)
       expect(pipelineAllowedForTaskType(pipeline({ purpose: 'document' }), type)).toBe(true)
+      expect(pipelineAllowedForTaskType(pipeline({ purpose: 'review' }), type)).toBe(true)
       expect(pipelineAllowedForTaskType(pipeline({ purpose: undefined }), type)).toBe(true)
     }
   })
@@ -51,10 +60,15 @@ describe('pipelineAllowedForManualStart composes the task-type gate', () => {
   const noFrame = undefined
   const blocks: Block[] = []
 
-  it('drops a non-document pipeline for a document task, keeps it for others', () => {
+  it('drops a mismatched pipeline for a document / review task, keeps it for others', () => {
     const build = pipeline({ purpose: 'build' })
     expect(pipelineAllowedForManualStart(build, noFrame, blocks, 'document')).toBe(false)
+    expect(pipelineAllowedForManualStart(build, noFrame, blocks, 'review')).toBe(false)
     expect(pipelineAllowedForManualStart(build, noFrame, blocks, 'feature')).toBe(true)
+    // A review pipeline is offered to a review task and hidden from a document task.
+    const review = pipeline({ purpose: 'review' })
+    expect(pipelineAllowedForManualStart(review, noFrame, blocks, 'review')).toBe(true)
+    expect(pipelineAllowedForManualStart(review, noFrame, blocks, 'document')).toBe(false)
     // No task type supplied ⇒ no task-type restriction.
     expect(pipelineAllowedForManualStart(build, noFrame, blocks)).toBe(true)
   })

package/i18n/locales/de.json

@@ -3260,6 +3260,9 @@
       "invalidHeading": "Ungültige Pipelines",
       "invalidDescription": "Diese verweisen auf einen fehlenden Agenten oder sind falsch konfiguriert, sodass sie beim Start fehlschlagen (oder falsch laufen) würden. Löschen Sie eine benutzerdefinierte Pipeline oder setzen Sie eine integrierte neu auf, um ihre Katalogdefinition wiederherzustellen.",
       "builtinBadge": "integriert",
+      "newHeading": "Neue Pipelines verfügbar",
+      "newDescription": "Neue integrierte Pipelines sind verfügbar. Füge sie zur Bibliothek dieses Boards hinzu.",
+      "add": "Hinzufügen",
       "reseed": "Neu aufsetzen",
       "delete": "Löschen",
       "updatesHeading": "Updates verfügbar",
@@ -3561,7 +3564,9 @@
       "refPlaceholder": "Seiten-ID oder URL (z. B. eine Confluence-/Notion-Seite oder GitHub-Datei-URL)",
       "tagsPlaceholder": "Tags, kommagetrennt (optional)",
       "link": "Als lebendes Fragment verknüpfen",
-      "githubBrowseHint": "Durchsuchen Sie das Repo und wählen Sie die zu verknüpfende Datei."
+      "githubBrowseHint": "Durchsuchen Sie das Repo und wählen Sie eine oder mehrere zu verknüpfende Dateien.",
+      "selectedFiles": "Ausgewählte Dateien ({count})",
+      "removeFile": "Datei entfernen"
     },
     "sources": {
       "metaSynced": "synchronisiert · ref {ref}",
@@ -3595,7 +3600,8 @@
       "upToDate": "Aktuell",
       "checkSourceFailed": "Quelle konnte nicht geprüft werden",
       "sourceUnlinked": "Quelle-Verknüpfung aufgehoben",
-      "unlinkSourceFailed": "Quelle-Verknüpfung konnte nicht aufgehoben werden"
+      "unlinkSourceFailed": "Quelle-Verknüpfung konnte nicht aufgehoben werden",
+      "documentsLinked": "{count} Dokument als lebendes Fragment verknüpft | {count} Dokumente als lebende Fragmente verknüpft"
     },
     "confirmRemove": {
       "title": "Dieses Fragment löschen?",

package/i18n/locales/en.json

@@ -3626,6 +3626,9 @@
       "invalidHeading": "Invalid pipelines",
       "invalidDescription": "These reference a missing agent or are misconfigured, so they would fail (or misrun) at start. Delete a custom pipeline, or reseed a built-in to restore its catalog definition.",
       "builtinBadge": "built-in",
+      "newHeading": "New pipelines available",
+      "newDescription": "New built-in pipelines have shipped. Add them to this board's library.",
+      "add": "Add",
       "reseed": "Reseed",
       "delete": "Delete",
       "updatesHeading": "Updates available",
@@ -4561,7 +4564,9 @@
       "refPlaceholder": "Page id or URL (e.g. a Confluence/Notion page or GitHub file URL)",
       "tagsPlaceholder": "Tags, comma-separated (optional)",
       "link": "Link as living fragment",
-      "githubBrowseHint": "Browse the repo and pick the file to link."
+      "githubBrowseHint": "Browse the repo and pick one or more files to link.",
+      "selectedFiles": "Selected files ({count})",
+      "removeFile": "Remove file"
     },
     "sources": {
       "metaSynced": "synced · ref {ref}",
@@ -4595,7 +4600,8 @@
       "upToDate": "Up to date",
       "checkSourceFailed": "Could not check source",
       "sourceUnlinked": "Source unlinked",
-      "unlinkSourceFailed": "Could not unlink source"
+      "unlinkSourceFailed": "Could not unlink source",
+      "documentsLinked": "Linked {count} document as a living fragment | Linked {count} documents as living fragments"
     },
     "confirmRemove": {
       "title": "Delete this fragment?",

package/i18n/locales/es.json

@@ -3527,6 +3527,9 @@
       "invalidHeading": "Pipelines no válidos",
       "invalidDescription": "Estos hacen referencia a un agente inexistente o están mal configurados, por lo que fallarían (o se ejecutarían mal) al iniciar. Elimina un pipeline personalizado o vuelve a generar uno integrado para restaurar su definición del catálogo.",
       "builtinBadge": "integrado",
+      "newHeading": "Nuevos pipelines disponibles",
+      "newDescription": "Hay nuevos pipelines integrados. Añádelos a la biblioteca de este tablero.",
+      "add": "Añadir",
       "reseed": "Regenerar",
       "delete": "Eliminar",
       "updatesHeading": "Actualizaciones disponibles",
@@ -4385,7 +4388,9 @@
       "refPlaceholder": "Id o URL de página (p. ej., una página de Confluence/Notion o la URL de un archivo de GitHub)",
       "tagsPlaceholder": "Etiquetas, separadas por comas (opcional)",
       "link": "Vincular como fragmento vivo",
-      "githubBrowseHint": "Explora el repositorio y elige el archivo a enlazar."
+      "githubBrowseHint": "Explora el repositorio y elige uno o más archivos a enlazar.",
+      "selectedFiles": "Archivos seleccionados ({count})",
+      "removeFile": "Quitar archivo"
     },
     "sources": {
       "metaSynced": "sincronizado · ref {ref}",
@@ -4419,7 +4424,8 @@
       "upToDate": "Al día",
       "checkSourceFailed": "No se pudo comprobar el origen",
       "sourceUnlinked": "Origen desvinculado",
-      "unlinkSourceFailed": "No se pudo desvincular el origen"
+      "unlinkSourceFailed": "No se pudo desvincular el origen",
+      "documentsLinked": "{count} documento vinculado como fragmento vivo | {count} documentos vinculados como fragmentos vivos"
     },
     "confirmRemove": {
       "title": "¿Eliminar este fragmento?",

package/i18n/locales/fr.json

@@ -3527,6 +3527,9 @@
       "invalidHeading": "Pipelines non valides",
       "invalidDescription": "Ceux-ci référencent un agent manquant ou sont mal configurés et échoueraient (ou s'exécuteraient mal) au démarrage. Supprimez un pipeline personnalisé, ou régénérez un pipeline intégré pour restaurer sa définition du catalogue.",
       "builtinBadge": "intégré",
+      "newHeading": "Nouveaux pipelines disponibles",
+      "newDescription": "De nouveaux pipelines intégrés sont arrivés. Ajoutez-les à la bibliothèque de ce tableau.",
+      "add": "Ajouter",
       "reseed": "Régénérer",
       "delete": "Supprimer",
       "updatesHeading": "Mises à jour disponibles",
@@ -4385,7 +4388,9 @@
       "refPlaceholder": "Id ou URL de page (par ex. une page Confluence/Notion ou l'URL d'un fichier GitHub)",
       "tagsPlaceholder": "Étiquettes, séparées par des virgules (facultatif)",
       "link": "Lier comme fragment vivant",
-      "githubBrowseHint": "Parcourez le dépôt et choisissez le fichier à lier."
+      "githubBrowseHint": "Parcourez le dépôt et choisissez un ou plusieurs fichiers à lier.",
+      "selectedFiles": "Fichiers sélectionnés ({count})",
+      "removeFile": "Retirer le fichier"
     },
     "sources": {
       "metaSynced": "synchronisé · ref {ref}",
@@ -4419,7 +4424,8 @@
       "upToDate": "À jour",
       "checkSourceFailed": "Impossible de vérifier la source",
       "sourceUnlinked": "Source dissociée",
-      "unlinkSourceFailed": "Impossible de dissocier la source"
+      "unlinkSourceFailed": "Impossible de dissocier la source",
+      "documentsLinked": "{count} document lié comme fragment vivant | {count} documents liés comme fragments vivants"
     },
     "confirmRemove": {
       "title": "Supprimer ce fragment ?",

package/i18n/locales/he.json

@@ -3538,6 +3538,9 @@
       "invalidHeading": "צינורות לא תקפים",
       "invalidDescription": "אלה מפנים לסוכן חסר או מוגדרים בצורה שגויה, ולכן ייכשלו (או ירוצו בצורה שגויה) בהתחלה. מחק צינור מותאם אישית, או זרע מחדש צינור מובנה כדי לשחזר את הגדרת הקטלוג שלו.",
       "builtinBadge": "מובנה",
+      "newHeading": "צינורות חדשים זמינים",
+      "newDescription": "הגיעו צינורות מובנים חדשים. הוסף אותם לספריית הלוח הזה.",
+      "add": "הוסף",
       "reseed": "זרע מחדש",
       "delete": "מחק",
       "updatesHeading": "עדכונים זמינים",
@@ -4396,7 +4399,9 @@
       "refPlaceholder": "מזהה עמוד או כתובת (למשל עמוד Confluence/Notion או כתובת קובץ GitHub)",
       "tagsPlaceholder": "תגיות, מופרדות בפסיקים (אופציונלי)",
       "link": "קשר כמקטע חי",
-      "githubBrowseHint": "עיין במאגר ובחר את הקובץ לקישור."
+      "githubBrowseHint": "עיין במאגר ובחר קובץ אחד או יותר לקישור.",
+      "selectedFiles": "קבצים שנבחרו ({count})",
+      "removeFile": "הסר קובץ"
     },
     "sources": {
       "metaSynced": "סונכרן · ref {ref}",
@@ -4430,7 +4435,8 @@
       "upToDate": "מעודכן",
       "checkSourceFailed": "לא ניתן היה לבדוק את המקור",
       "sourceUnlinked": "קישור המקור בוטל",
-      "unlinkSourceFailed": "לא ניתן היה לבטל את קישור המקור"
+      "unlinkSourceFailed": "לא ניתן היה לבטל את קישור המקור",
+      "documentsLinked": "{count} מסמך קושר כמקטע חי | {count} מסמכים קושרו כמקטעים חיים"
     },
     "confirmRemove": {
       "title": "למחוק את המקטע הזה?",

package/i18n/locales/it.json

@@ -3260,6 +3260,9 @@
       "invalidHeading": "Pipeline non valide",
       "invalidDescription": "Queste fanno riferimento a un agente mancante o sono configurate male, quindi fallirebbero (o funzionerebbero male) all'avvio. Elimina una pipeline personalizzata, oppure ripristina una integrata per recuperare la sua definizione dal catalogo.",
       "builtinBadge": "integrata",
+      "newHeading": "Nuove pipeline disponibili",
+      "newDescription": "Sono state rilasciate nuove pipeline integrate. Aggiungile alla libreria di questa board.",
+      "add": "Aggiungi",
       "reseed": "Ripristina",
       "delete": "Elimina",
       "updatesHeading": "Aggiornamenti disponibili",
@@ -3561,7 +3564,9 @@
       "refPlaceholder": "Id o URL della pagina (es. una pagina Confluence/Notion o l'URL di un file GitHub)",
       "tagsPlaceholder": "Tag, separati da virgola (opzionale)",
       "link": "Collega come frammento vivente",
-      "githubBrowseHint": "Sfoglia il repository e scegli il file da collegare."
+      "githubBrowseHint": "Sfoglia il repository e scegli uno o più file da collegare.",
+      "selectedFiles": "File selezionati ({count})",
+      "removeFile": "Rimuovi file"
     },
     "sources": {
       "metaSynced": "sincronizzato · ref {ref}",
@@ -3595,7 +3600,8 @@
       "upToDate": "Aggiornato",
       "checkSourceFailed": "Impossibile controllare la sorgente",
       "sourceUnlinked": "Sorgente scollegata",
-      "unlinkSourceFailed": "Impossibile scollegare la sorgente"
+      "unlinkSourceFailed": "Impossibile scollegare la sorgente",
+      "documentsLinked": "{count} documento collegato come frammento vivente | {count} documenti collegati come frammenti viventi"
     },
     "confirmRemove": {
       "title": "Eliminare questo frammento?",

package/i18n/locales/ja.json

@@ -3539,6 +3539,9 @@
       "invalidHeading": "無効なパイプライン",
       "invalidDescription": "存在しないエージェントを参照しているか設定が誤っているため、開始時に失敗(または誤動作)します。カスタムパイプラインを削除するか、ビルトインを再シードしてカタログ定義を復元してください。",
       "builtinBadge": "ビルトイン",
+      "newHeading": "新しいパイプラインがあります",
+      "newDescription": "新しい組み込みパイプラインが追加されました。このボードのライブラリに追加してください。",
+      "add": "追加",
       "reseed": "再シード",
       "delete": "削除",
       "updatesHeading": "更新あり",
@@ -4397,7 +4400,9 @@
       "refPlaceholder": "ページ id または URL (例: Confluence/Notion ページや GitHub ファイル URL)",
       "tagsPlaceholder": "タグ、カンマ区切り (任意)",
       "link": "リビングフラグメントとしてリンク",
-      "githubBrowseHint": "リポジトリを参照してリンクするファイルを選択します。"
+      "githubBrowseHint": "リポジトリを参照してリンクするファイルを1つ以上選択します。",
+      "selectedFiles": "選択したファイル ({count})",
+      "removeFile": "ファイルを削除"
     },
     "sources": {
       "metaSynced": "同期済み · ref {ref}",
@@ -4431,7 +4436,8 @@
       "upToDate": "最新です",
       "checkSourceFailed": "ソースを確認できませんでした",
       "sourceUnlinked": "ソースのリンクを解除しました",
-      "unlinkSourceFailed": "ソースのリンクを解除できませんでした"
+      "unlinkSourceFailed": "ソースのリンクを解除できませんでした",
+      "documentsLinked": "{count}件のドキュメントをリビングフラグメントとしてリンクしました | {count}件のドキュメントをリビングフラグメントとしてリンクしました"
     },
     "confirmRemove": {
       "title": "このフラグメントを削除しますか？",

package/i18n/locales/pl.json

@@ -3527,6 +3527,9 @@
       "invalidHeading": "Nieprawidłowe pipeline'y",
       "invalidDescription": "Odwołują się do brakującego agenta lub są źle skonfigurowane, więc zawiodłyby (lub wykonałyby się błędnie) przy starcie. Usuń pipeline niestandardowy albo zregeneruj wbudowany, aby przywrócić jego definicję z katalogu.",
       "builtinBadge": "wbudowany",
+      "newHeading": "Dostępne nowe pipeline'y",
+      "newDescription": "Pojawiły się nowe wbudowane pipeline'y. Dodaj je do biblioteki tej tablicy.",
+      "add": "Dodaj",
       "reseed": "Zregeneruj",
       "delete": "Usuń",
       "updatesHeading": "Dostępne aktualizacje",
@@ -4385,7 +4388,9 @@
       "refPlaceholder": "Id lub URL strony (np. strona Confluence/Notion lub URL pliku GitHub)",
       "tagsPlaceholder": "Tagi, oddzielone przecinkami (opcjonalnie)",
       "link": "Połącz jako żywy fragment",
-      "githubBrowseHint": "Przeglądaj repozytorium i wybierz plik do połączenia."
+      "githubBrowseHint": "Przeglądaj repozytorium i wybierz jeden lub więcej plików do połączenia.",
+      "selectedFiles": "Wybrane pliki ({count})",
+      "removeFile": "Usuń plik"
     },
     "sources": {
       "metaSynced": "zsynchronizowano · ref {ref}",
@@ -4419,7 +4424,8 @@
       "upToDate": "Aktualne",
       "checkSourceFailed": "Nie udało się sprawdzić źródła",
       "sourceUnlinked": "Odłączono źródło",
-      "unlinkSourceFailed": "Nie udało się odłączyć źródła"
+      "unlinkSourceFailed": "Nie udało się odłączyć źródła",
+      "documentsLinked": "Połączono {count} dokument jako żywy fragment | Połączono {count} dokumenty jako żywe fragmenty | Połączono {count} dokumentów jako żywe fragmenty"
     },
     "confirmRemove": {
       "title": "Usunąć ten fragment?",

package/i18n/locales/tr.json

@@ -3539,6 +3539,9 @@
       "invalidHeading": "Geçersiz pipeline'lar",
       "invalidDescription": "Bunlar eksik bir agent'a referans veriyor veya yanlış yapılandırılmış, bu yüzden başlangıçta başarısız olur (veya hatalı çalışır). Özel bir pipeline'ı silin ya da katalog tanımını geri yüklemek için bir yerleşik pipeline'ı yeniden tohumlayın.",
       "builtinBadge": "yerleşik",
+      "newHeading": "Yeni pipeline'lar mevcut",
+      "newDescription": "Yeni yerleşik pipeline'lar geldi. Bu panonun kütüphanesine ekleyin.",
+      "add": "Ekle",
       "reseed": "Yeniden tohumla",
       "delete": "Sil",
       "updatesHeading": "Güncellemeler mevcut",
@@ -4397,7 +4400,9 @@
       "refPlaceholder": "Sayfa kimliği veya URL (örn. bir Confluence/Notion sayfası veya GitHub dosya URL'si)",
       "tagsPlaceholder": "Etiketler, virgülle ayrılmış (isteğe bağlı)",
       "link": "Canlı parça olarak bağla",
-      "githubBrowseHint": "Depoya göz atın ve bağlanacak dosyayı seçin."
+      "githubBrowseHint": "Depoya göz atın ve bağlanacak bir veya daha fazla dosya seçin.",
+      "selectedFiles": "Seçilen dosyalar ({count})",
+      "removeFile": "Dosyayı kaldır"
     },
     "sources": {
       "metaSynced": "eşitlendi · ref {ref}",
@@ -4431,7 +4436,8 @@
       "upToDate": "Güncel",
       "checkSourceFailed": "Kaynak denetlenemedi",
       "sourceUnlinked": "Kaynak bağlantısı kaldırıldı",
-      "unlinkSourceFailed": "Kaynak bağlantısı kaldırılamadı"
+      "unlinkSourceFailed": "Kaynak bağlantısı kaldırılamadı",
+      "documentsLinked": "{count} belge canlı parça olarak bağlandı | {count} belge canlı parça olarak bağlandı"
     },
     "confirmRemove": {
       "title": "Bu parça silinsin mi?",

package/i18n/locales/uk.json

@@ -3527,6 +3527,9 @@
       "invalidHeading": "Недійсні пайплайни",
       "invalidDescription": "Вони посилаються на відсутнього агента або неправильно налаштовані, тож зазнали б помилки (або виконалися б неправильно) під час старту. Видаліть власний пайплайн або перегенеруйте вбудований, щоб відновити його визначення з каталогу.",
       "builtinBadge": "вбудований",
+      "newHeading": "Доступні нові пайплайни",
+      "newDescription": "З'явилися нові вбудовані пайплайни. Додайте їх до бібліотеки цієї дошки.",
+      "add": "Додати",
       "reseed": "Перегенерувати",
       "delete": "Видалити",
       "updatesHeading": "Доступні оновлення",
@@ -4385,7 +4388,9 @@
       "refPlaceholder": "Id або URL сторінки (напр. сторінка Confluence/Notion чи URL файлу GitHub)",
       "tagsPlaceholder": "Теги, розділені комами (необов'язково)",
       "link": "Прив'язати як живий фрагмент",
-      "githubBrowseHint": "Перегляньте репозиторій і виберіть файл для зв’язування."
+      "githubBrowseHint": "Перегляньте репозиторій і виберіть один або кілька файлів для зв’язування.",
+      "selectedFiles": "Вибрані файли ({count})",
+      "removeFile": "Видалити файл"
     },
     "sources": {
       "metaSynced": "синхронізовано · ref {ref}",
@@ -4419,7 +4424,8 @@
       "upToDate": "Актуально",
       "checkSourceFailed": "Не вдалося перевірити джерело",
       "sourceUnlinked": "Джерело відв'язано",
-      "unlinkSourceFailed": "Не вдалося відв'язати джерело"
+      "unlinkSourceFailed": "Не вдалося відв'язати джерело",
+      "documentsLinked": "Прив’язано {count} документ як живий фрагмент | Прив’язано {count} документи як живі фрагменти | Прив’язано {count} документів як живі фрагменти"
     },
     "confirmRemove": {
       "title": "Видалити цей фрагмент?",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.141.1",
+  "version": "0.142.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.150.0"
+    "@cat-factory/contracts": "0.151.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",