@cat-factory/app 0.75.0 → 0.75.2

package/app/components/board/AgentFailureCard.vue

@@ -5,6 +5,7 @@
 // inspector, task panel) gets identical behaviour from one place. Replaces the
 // three hand-rolled bootstrap banners that used to duplicate this logic.
 import type { AgentRunSummary } from '~/stores/agentRuns'
+import FailureDetail from '~/components/board/FailureDetail.vue'
 
 const props = withDefaults(
   defineProps<{ run: AgentRunSummary; variant?: 'compact' | 'expanded' }>(),
@@ -82,15 +83,13 @@ async function retry() {
       {{ failure.hint }}
     </p>
 
-    <details v-if="!compact && failure?.detail && failure.detail !== failure.message" class="mt-1">
-      <summary class="cursor-pointer text-[10px] text-rose-400/60 hover:text-rose-300">
-        {{ t('board.failure.showDetail') }}
-      </summary>
-      <pre
-        class="mt-1 max-h-32 overflow-auto whitespace-pre-wrap rounded bg-rose-950/60 p-1.5 text-[10px] text-rose-200/80"
-        >{{ failure.detail }}</pre
-      >
-    </details>
+    <FailureDetail
+      v-if="!compact && failure"
+      :detail="failure.detail"
+      :message="failure.message"
+      summary-class="text-[10px] text-rose-400/60 hover:text-rose-300"
+      pre-class="bg-rose-950/60 text-[10px] text-rose-200/80"
+    />
 
     <button
       type="button"

package/app/components/board/AgentFailureHistory.vue

@@ -0,0 +1,60 @@
+<script setup lang="ts">
+// The error trail of a run's PRIOR attempts, preserved across retries/restarts. This is
+// deliberately SEPARATE from the top failure banner (`AgentFailureCard`, keyed on the
+// current `status === 'failed'`): when a failed task is retried it restarts and the top
+// banner disappears, but this collapsed history stays available so every previous error
+// remains viewable. Renders nothing when there is no trail.
+import type { AgentFailure } from '~/types/domain'
+import FailureDetail from '~/components/board/FailureDetail.vue'
+
+const props = defineProps<{ failures: AgentFailure[] }>()
+
+const { t, d } = useI18n()
+
+// Newest attempt first — the most recent failure is the most relevant to look at.
+const ordered = computed(() => [...props.failures].reverse())
+</script>
+
+<template>
+  <details
+    v-if="failures.length"
+    class="nodrag rounded-lg border border-slate-700/60 bg-slate-900/40 px-3 py-2"
+    data-testid="agent-failure-history"
+  >
+    <summary
+      class="flex cursor-pointer items-center gap-1.5 text-[11px] text-slate-400 hover:text-slate-200"
+    >
+      <UIcon name="i-lucide-history" class="h-3.5 w-3.5 shrink-0" />
+      {{ t('board.failure.history.previousErrors', { count: failures.length }, failures.length) }}
+    </summary>
+
+    <ol class="mt-2 space-y-2">
+      <li
+        v-for="failure in ordered"
+        :key="failure.occurredAt"
+        class="rounded-md border border-slate-800/80 bg-slate-950/50 px-2.5 py-2"
+        data-testid="agent-failure-history-entry"
+      >
+        <div class="flex items-center gap-1.5 text-[10px] text-slate-500">
+          <UIcon name="i-lucide-alert-triangle" class="h-3 w-3 shrink-0 text-rose-400/70" />
+          <time>{{ d(new Date(failure.occurredAt), 'long') }}</time>
+        </div>
+
+        <p class="mt-1 text-[11px] leading-snug text-slate-300" :title="failure.message">
+          {{ failure.message }}
+        </p>
+
+        <p v-if="failure.hint" class="mt-1 text-[10px] leading-snug text-slate-500">
+          {{ failure.hint }}
+        </p>
+
+        <FailureDetail
+          :detail="failure.detail"
+          :message="failure.message"
+          summary-class="text-[10px] text-slate-500 hover:text-slate-300"
+          pre-class="bg-slate-950/80 text-[10px] text-slate-400"
+        />
+      </li>
+    </ol>
+  </details>
+</template>

package/app/components/board/FailureDetail.vue

@@ -0,0 +1,27 @@
+<script setup lang="ts">
+// Shared collapsible "Show detail" disclosure for a failure's extended `detail`, used by
+// both the failure banner (`AgentFailureCard`) and the prior-errors history
+// (`AgentFailureHistory`). Renders nothing when there is no detail or it merely repeats the
+// message. Tone (summary/pre classes) is passed by the host so it blends into each surface
+// (rose banner vs slate history) while the guard + the `showDetail` key + the whitespace-
+// preserving `<pre>` structure live in one place.
+defineProps<{
+  detail: string | null
+  message: string
+  summaryClass: string
+  preClass: string
+}>()
+
+const { t } = useI18n()
+</script>
+
+<template>
+  <details v-if="detail && detail !== message" class="mt-1">
+    <summary class="cursor-pointer" :class="summaryClass">
+      {{ t('board.failure.showDetail') }}
+    </summary>
+    <pre class="mt-1 max-h-32 overflow-auto whitespace-pre-wrap rounded p-1.5" :class="preClass">{{
+      detail
+    }}</pre>
+  </details>
+</template>

package/app/components/panels/inspector/ServiceFragments.vue

@@ -4,7 +4,8 @@ import type { Block } from '~/types/domain'
 // Service-level best-practice fragments (frame blocks). These are the programming
 // standards/guidelines for the whole service; at run time their bodies are folded
 // into the prompt of every `code-aware` agent on tasks under this service. Drawn from
-// the universal fragment pool (built-in + deployment-registered), grouped by category.
+// the board's merged fragment catalog (built-in ∪ registered ∪ account ∪ workspace,
+// via the fragments store; static pool when the library is off), grouped by category.
 const props = defineProps<{ block: Block }>()
 
 const board = useBoardStore()
@@ -17,10 +18,12 @@ onMounted(() => fragments.ensureLoaded())
 
 type MenuItem = { label: string; icon?: string; onSelect: () => void }
 
+// An id the catalog no longer resolves (removed/suppressed after selection) still
+// renders — labelled by its raw id — so it stays visible and removable.
 const selectedFragments = computed(() =>
-  (props.block.serviceFragmentIds ?? [])
-    .map((id) => fragments.getFragment(id))
-    .filter((f): f is NonNullable<typeof f> => !!f),
+  (props.block.serviceFragmentIds ?? []).map(
+    (id) => fragments.getFragment(id) ?? { id, title: id, summary: '' },
+  ),
 )
 
 // A trailing group that jumps from "attach a fragment" to authoring/editing the

package/app/components/panels/inspector/TaskExecution.vue

@@ -8,6 +8,7 @@ import {
   containerPhaseLabel,
 } from '~/utils/pipelineRender'
 import AgentFailureCard from '~/components/board/AgentFailureCard.vue'
+import AgentFailureHistory from '~/components/board/AgentFailureHistory.vue'
 import EmptyState from '~/components/common/EmptyState.vue'
 
 const props = defineProps<{ block: Block }>()
@@ -57,6 +58,10 @@ const failedRun = computed(() => {
   return run && run.status === 'failed' ? run : null
 })
 
+// Failures from prior attempts, preserved across retries — shown regardless of the run's
+// CURRENT status, so the error trail stays viewable after a restart clears the top banner.
+const failureHistory = computed(() => agentRuns.byBlock[props.block.id]?.failureHistory ?? [])
+
 const pr = computed(() => props.block.pullRequest)
 /** A PR is merged once the block is `done`; otherwise it is open awaiting merge. */
 const prMerged = computed(() => props.block.status === 'done')
@@ -413,6 +418,9 @@ async function mergePr() {
     <!-- failed run: shared failure banner + retry -->
     <AgentFailureCard v-if="failedRun" :run="failedRun" />
 
+    <!-- error trail of prior attempts (survives a retry/restart that cleared the banner) -->
+    <AgentFailureHistory :failures="failureHistory" />
+
     <!-- Open PR: link straight to it on GitHub -->
     <div v-if="pr" class="space-y-2">
       <span class="text-[11px] font-semibold uppercase tracking-wide text-slate-400">

package/app/components/panels/inspector/TaskStructure.vue

@@ -9,14 +9,20 @@ const ui = useUiStore()
 const accounts = useAccountsStore()
 const { t } = useI18n()
 
+// The catalog is per-board and invalidated on a workspace switch, so (re)load it when the
+// task inspector mounts — mirrors ServiceFragments; ensureLoaded is a no-op while current.
+onMounted(() => fragments.ensureLoaded())
+
 type MenuItem = { label: string; icon?: string; onSelect: () => void }
 
 // ---- best-practice prompt fragments ----------------------------------------
-// Selected fragments (resolved against the catalog; unknown ids are dropped).
+// Selected fragments, resolved against the catalog. An id the catalog no longer
+// resolves (removed/suppressed after selection) still renders — labelled by its
+// raw id — so it stays visible and removable.
 const selectedFragments = computed(() =>
-  (props.block.fragmentIds ?? [])
-    .map((id) => fragments.getFragment(id))
-    .filter((f): f is NonNullable<typeof f> => !!f),
+  (props.block.fragmentIds ?? []).map(
+    (id) => fragments.getFragment(id) ?? { id, title: id, summary: '' },
+  ),
 )
 
 // A trailing group that jumps from "attach a fragment" to authoring/editing the

package/app/components/settings/ServiceFragmentDefaultsPanel.vue

@@ -1,7 +1,8 @@
 <script setup lang="ts">
 // Workspace settings: the default best-practice fragments NEW services inherit. The
-// selection is drawn from the universal fragment pool (built-in + deployment-registered)
-// served by GET /prompt-fragments. Changing it does not retroactively change existing
+// selection is drawn from the board's merged fragment catalog (built-in ∪ registered ∪
+// account ∪ workspace via the fragments store; the static GET /prompt-fragments pool
+// when the library is off). Changing it does not retroactively change existing
 // services — each owns its selection from creation. Persisted via the
 // serviceFragmentDefaults store (the backend replaces the whole list on each change).
 import { onMounted, ref } from 'vue'
@@ -17,10 +18,10 @@ const busy = ref(false)
 // The tab renders when Workspace settings opens; load the fragment pool then.
 onMounted(() => void fragments.ensureLoaded())
 
+// An id the catalog no longer resolves still renders (labelled by its raw id) so it
+// stays visible and removable from the default set.
 const selected = computed(() =>
-  defaults.fragmentIds
-    .map((id) => fragments.getFragment(id))
-    .filter((f): f is NonNullable<typeof f> => !!f),
+  defaults.fragmentIds.map((id) => fragments.getFragment(id) ?? { id, title: id, summary: '' }),
 )
 
 // Pool fragments not already in the default set, grouped by category.

package/app/stores/agentRuns.ts

@@ -26,6 +26,13 @@ export interface AgentRunSummary {
   runId: string
   /** Structured failure when `status` is `failed`; null otherwise. */
   failure: AgentFailure | null
+  /**
+   * Failures from the run's PRIOR attempts, oldest→newest — the error trail preserved
+   * across retries/restarts. Stays populated after a restart (when `status` is no longer
+   * `failed` and the top banner is gone), so the "previous errors" history remains
+   * viewable. Empty for a bootstrap run or a run that never failed-then-retried.
+   */
+  failureHistory: AgentFailure[]
   /** Latest subtask counts for a live progress bar (null until reported). */
   subtasks: StepSubtasks | null
 }
@@ -138,6 +145,7 @@ export const useAgentRunsStore = defineStore('agentRuns', () => {
         status: e.status,
         runId: e.id,
         failure: e.failure ?? null,
+        failureHistory: e.failureHistory ?? [],
         subtasks: e.steps[e.currentStep]?.subtasks ?? null,
       }
     }
@@ -150,6 +158,8 @@ export const useAgentRunsStore = defineStore('agentRuns', () => {
         status: job.status,
         runId: job.id,
         failure: job.failure,
+        // Bootstrap runs keep no prior-attempt trail (retry mints a fresh row).
+        failureHistory: [],
         subtasks: job.subtasks,
       }
     }

package/app/stores/fragmentLibrary.ts

@@ -11,6 +11,7 @@ import type {
   UpdatePromptFragmentInput,
 } from '~/types/domain'
 import { useWorkspaceStore } from '~/stores/workspace'
+import { useFragmentsStore } from '~/stores/fragments'
 
 /**
  * Prompt-fragment library state (ADR 0006), scoped to a single owner — a board
@@ -83,6 +84,9 @@ function fragmentLibrarySetup(kind: FragmentOwnerKind, resolveOwnerId: () => str
   }
 
   async function refreshResolved() {
+    // Every library mutation lands here: drop the picker catalog's cache so the
+    // per-service / per-block pickers see the edit on their next open.
+    useFragmentsStore().invalidate()
     if (!hasResolved) return
     resolved.value = await api.getResolvedFragments(requireOwnerId())
   }

package/app/stores/fragments.ts

@@ -1,24 +1,47 @@
 import { defineStore } from 'pinia'
 import { ref, computed } from 'vue'
 import type { BlockType, PromptFragment } from '~/types/domain'
+import { useWorkspaceStore } from '~/stores/workspace'
 
 /**
- * The best-practice prompt fragment catalog. It is build-static reference data on
- * the backend (`GET /prompt-fragments`), workspace-independent, so this store
- * fetches it once and caches it for the per-block picker in the inspector.
+ * The best-practice prompt fragment catalog backing the per-service and per-block
+ * pickers. When the fragment library is configured it loads the MERGED tenant
+ * catalog for the active board (`GET /workspaces/:id/prompt-fragments/resolved` —
+ * built-in ∪ account ∪ workspace, override-by-id, tombstones applied), so managed,
+ * repo-sourced and document-backed fragments are selectable exactly like the
+ * built-ins and a suppressed built-in disappears from the picker. When the library
+ * is off (the resolved endpoint 503s) it falls back to the workspace-independent
+ * static pool (`GET /prompt-fragments`). Cached per board; re-fetched on a board
+ * switch or after `invalidate()` (a library edit).
  */
 export const useFragmentsStore = defineStore('fragments', () => {
   const api = useApi()
   const fragments = ref<PromptFragment[]>([])
   const loaded = ref(false)
+  /** The board the catalog was loaded for (null = never; '' = static pool, no board). */
+  const loadedFor = ref<string | null>(null)
 
-  /** Fetch the catalog once; subsequent calls are no-ops. */
+  /** Fetch the catalog for the active board; a no-op while it is current. */
   async function ensureLoaded() {
-    if (loaded.value) return
-    fragments.value = await api.getPromptFragments()
+    const wsId = useWorkspaceStore().workspaceId ?? ''
+    if (loaded.value && loadedFor.value === wsId) return
+    // Prefer the merged tenant catalog; only a FAILURE (a 503 when the library is
+    // unconfigured, or any other error) degrades to the static universal pool — mapped to
+    // null by the catch. A successful-but-empty resolved catalog is left empty on purpose:
+    // it means every fragment is suppressed at some tier, and falling back to the static
+    // pool would resurrect the very built-ins the tenant tombstoned.
+    const resolved = wsId ? await api.getResolvedFragments(wsId).catch(() => null) : null
+    fragments.value = resolved ?? (await api.getPromptFragments())
+    loadedFor.value = wsId
     loaded.value = true
   }
 
+  /** Drop the cache so the next `ensureLoaded()` re-fetches (after a library edit). */
+  function invalidate() {
+    loaded.value = false
+    loadedFor.value = null
+  }
+
   const byId = computed(() => {
     const map = new Map<string, PromptFragment>()
     for (const f of fragments.value) map.set(f.id, f)
@@ -36,5 +59,5 @@ export const useFragmentsStore = defineStore('fragments', () => {
     )
   }
 
-  return { fragments, loaded, ensureLoaded, byId, getFragment, forBlockType }
+  return { fragments, loaded, ensureLoaded, invalidate, byId, getFragment, forBlockType }
 })

package/app/stores/workspace.ts

@@ -21,6 +21,7 @@ import { useClarityStore } from '~/stores/clarity'
 import { useBrainstormStore } from '~/stores/brainstorm'
 import { useConsensusStore } from '~/stores/consensus'
 import { useGitHubStore } from '~/stores/github'
+import { useFragmentsStore } from '~/stores/fragments'
 import { useProviderConnectionsStore } from '~/stores/providerConnections'
 
 /**
@@ -81,6 +82,10 @@ export const useWorkspaceStore = defineStore(
         useBrainstormStore().reset()
         useConsensusStore().reset()
         useGitHubStore().reset()
+        // The fragment picker catalog is per-board (the merged tenant catalog), so drop
+        // it too — the next inspector open re-fetches it for the switched-to board rather
+        // than showing the previous board's (or a raw-id placeholder for) fragments.
+        useFragmentsStore().invalidate()
       }
       workspaceId.value = snapshot.workspace.id
       spend.value = snapshot.spend ?? null

package/i18n/locales/en.json

@@ -225,7 +225,13 @@
       "retryBootstrap": "Retry bootstrap",
       "retryRun": "Retry run",
       "showDetail": "Show detail",
-      "retrying": "Retrying…"
+      "retrying": "Retrying…",
+      "history": {
+        "previousErrors": "{count} previous error | {count} previous errors",
+        "@previousErrors": {
+          "description": "Count-based tally of a run's earlier failed attempts, rendered as e.g. '3 previous errors' (count is always >= 1). Provide ALL plural forms your language needs (English has 2; Polish/Ukrainian need 3 - one/few/many - via the custom pluralRules in i18n.config.ts)."
+        }
+      }
     },
     "stop": {
       "label": "Stop",

package/i18n/locales/es.json

@@ -204,7 +204,10 @@
       "retryBootstrap": "Reintentar arranque",
       "retryRun": "Reintentar ejecución",
       "showDetail": "Mostrar detalle",
-      "retrying": "Reintentando…"
+      "retrying": "Reintentando…",
+      "history": {
+        "previousErrors": "{count} error anterior | {count} errores anteriores"
+      }
     },
     "stop": {
       "label": "Detener",

package/i18n/locales/fr.json

@@ -204,7 +204,10 @@
       "retryBootstrap": "Relancer l’initialisation",
       "retryRun": "Relancer l’exécution",
       "showDetail": "Afficher le détail",
-      "retrying": "Nouvelle tentative…"
+      "retrying": "Nouvelle tentative…",
+      "history": {
+        "previousErrors": "{count} erreur précédente | {count} erreurs précédentes"
+      }
     },
     "stop": {
       "label": "Arrêter",

package/i18n/locales/he.json

@@ -204,7 +204,10 @@
       "retryBootstrap": "נסה שוב לאתחל",
       "retryRun": "נסה שוב להריץ",
       "showDetail": "הצג פרטים",
-      "retrying": "מנסה שוב…"
+      "retrying": "מנסה שוב…",
+      "history": {
+        "previousErrors": "שגיאה קודמת {count} | {count} שגיאות קודמות"
+      }
     },
     "stop": {
       "label": "עצור",

package/i18n/locales/ja.json

@@ -204,7 +204,10 @@
       "retryBootstrap": "ブートストラップを再試行",
       "retryRun": "実行を再試行",
       "showDetail": "詳細を表示",
-      "retrying": "再試行中…"
+      "retrying": "再試行中…",
+      "history": {
+        "previousErrors": "以前のエラー {count} 件 | 以前のエラー {count} 件"
+      }
     },
     "stop": {
       "label": "停止",

package/i18n/locales/pl.json

@@ -204,7 +204,10 @@
       "retryBootstrap": "Ponów inicjalizację",
       "retryRun": "Ponów uruchomienie",
       "showDetail": "Pokaż szczegóły",
-      "retrying": "Ponawianie…"
+      "retrying": "Ponawianie…",
+      "history": {
+        "previousErrors": "{count} poprzedni błąd | {count} poprzednie błędy | {count} poprzednich błędów"
+      }
     },
     "stop": {
       "label": "Zatrzymaj",

package/i18n/locales/tr.json

@@ -204,7 +204,10 @@
       "retryBootstrap": "Bootstrap'ı yeniden dene",
       "retryRun": "Çalıştırmayı yeniden dene",
       "showDetail": "Ayrıntıyı göster",
-      "retrying": "Yeniden deneniyor…"
+      "retrying": "Yeniden deneniyor…",
+      "history": {
+        "previousErrors": "{count} önceki hata | {count} önceki hata"
+      }
     },
     "stop": {
       "label": "Durdur",

package/i18n/locales/uk.json

@@ -204,7 +204,10 @@
       "retryBootstrap": "Повторити ініціалізацію",
       "retryRun": "Повторити запуск",
       "showDetail": "Показати деталі",
-      "retrying": "Повторення…"
+      "retrying": "Повторення…",
+      "history": {
+        "previousErrors": "{count} попередня помилка | {count} попередні помилки | {count} попередніх помилок"
+      }
     },
     "stop": {
       "label": "Зупинити",

package/package.json

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