@cat-factory/app 0.244.0 → 0.245.0

package/app/components/outcome/OutcomeSummaryWindow.vue

@@ -19,14 +19,18 @@ import type {
   OutcomeCheckKind,
   OutcomeCheckState,
   OutcomeDisposition,
+  OutcomeSource,
   OutcomeSpecJoin,
   OutcomeVisual,
   RequirementsGap,
+  SourcesGap,
   TestsGap,
   TestsVerdict,
   VisualsGap,
 } from '~/utils/runOutcome'
 import { composeRunOutcome } from '~/utils/runOutcome'
+import { GAP_KEYS } from '~/components/documents/DocumentSyncState.logic'
+import DocumentOriginLink from '~/components/documents/DocumentOriginLink.vue'
 import { REPRODUCTION_STATUS_KEYS } from '~/utils/reproduction'
 import type { RequirementVerdictStatus, TestConcernSeverity } from '~/types/domain'
 import type { TestEnvironment } from '@cat-factory/contracts'
@@ -37,6 +41,7 @@ import MarkdownProse from '~/components/common/MarkdownProse.vue'
 import EmptyState from '~/components/common/EmptyState.vue'
 
 const board = useBoardStore()
+const documents = useDocumentsStore()
 const execution = useExecutionStore()
 const serviceSpec = useServiceSpecStore()
 const ui = useUiStore()
@@ -128,6 +133,10 @@ const TESTS_GAP_KEYS: Record<TestsGap, string> = {
   no_tester_step: 'outcome.tests.gap.no_tester_step',
   tester_not_reported: 'outcome.tests.gap.tester_not_reported',
 }
+const SOURCES_GAP_KEYS: Record<SourcesGap, string> = {
+  run_unavailable: RUN_UNAVAILABLE_KEY,
+  none_linked: 'outcome.sources.gap.none_linked',
+}
 const VISUALS_GAP_KEYS: Record<VisualsGap, string> = {
   run_unavailable: RUN_UNAVAILABLE_KEY,
   no_visual_step: 'outcome.visuals.gap.no_visual_step',
@@ -288,6 +297,47 @@ const checkRows = computed(() =>
   })),
 )
 
+/**
+ * What one linked page's row says about how current the copy the agents read was.
+ *
+ * Four outcomes, and none of them may collapse into another: a named revision to check the work
+ * against, a copy nobody could confirm (a warning about the WORK, not about the platform), a body
+ * with no source to trail, and a deployment that runs no freshness check at all. The last two are
+ * the pair a dash would merge, and they are opposite facts about whether anything is missing.
+ */
+function revisionLabel(freshness: OutcomeSource['freshness']): string {
+  if (!freshness) return t('outcome.sources.unchecked')
+  switch (freshness.status) {
+    case 'confirmed':
+      return t('documents.freshness.revision', { version: freshness.version })
+    case 'not-applicable':
+      return t('outcome.sources.noSource')
+    case 'unconfirmed':
+      return t(GAP_KEYS[freshness.reason])
+    default:
+      return exhaustiveFreshness(freshness)
+  }
+}
+
+/** Compile-time totality: a new verdict member fails the build rather than rendering a blank. */
+function exhaustiveFreshness(freshness: never): string {
+  return String(freshness)
+}
+
+/**
+ * The linked pages with their labels resolved, so the exhaustive mapping above is applied once
+ * per row rather than on every re-render, and the template stays a list.
+ */
+const sourceRows = computed(() => {
+  const sources = outcome.value?.sources
+  if (!sources || sources.status !== 'reported') return []
+  return sources.sources.map((source) => ({
+    ...source,
+    icon: documents.descriptorForOrigin(source.origin)?.icon ?? 'i-lucide-file-text',
+    revision: revisionLabel(source.freshness),
+  }))
+})
+
 /** Drill into the full test report (this card is the summary, never a replacement for it). */
 function openTestReport() {
   if (instance.value) ui.openTestEvidence(instance.value.id)
@@ -358,6 +408,49 @@ function openTestReport() {
         </p>
       </section>
 
+      <!-- What the run built FROM, and which revision of it. Directly under the ask, because it
+           is the rest of the brief: the description is what a person wrote, this is what the
+           agents actually read, and every section below is a statement about work done against
+           it. A design that moved mid-run is the reading that changes all of them. -->
+      <section class="mb-5" data-testid="outcome-sources">
+        <h3 class="mb-1.5 text-[11px] font-semibold uppercase tracking-wide text-slate-500">
+          {{ t('outcome.sources.title') }}
+        </h3>
+        <div v-if="outcome.sources.status === 'reported'" class="space-y-1">
+          <div
+            v-for="source in sourceRows"
+            :key="`${source.origin}:${source.url || source.title}`"
+            class="rounded-md border border-slate-800 bg-slate-900/60 px-2 py-1.5"
+            data-testid="outcome-source"
+          >
+            <DocumentOriginLink
+              :url="source.url ?? ''"
+              class="flex items-center gap-1.5 text-xs text-slate-300"
+              hover-class="hover:text-white"
+            >
+              <UIcon :name="source.icon" class="h-3.5 w-3.5 shrink-0 text-indigo-400" />
+              <span class="truncate">{{ source.title }}</span>
+            </DocumentOriginLink>
+            <p class="mt-0.5 text-[11px] text-slate-500" data-testid="outcome-source-revision">
+              {{ source.revision }}
+            </p>
+            <!-- Stated separately from the revision above: the last revision alone says the run
+                 ENDED current, and says nothing about the step that finished before the page
+                 changed under it. -->
+            <p
+              v-if="source.movedDuringRun"
+              class="mt-0.5 text-[11px] text-amber-300"
+              data-testid="outcome-source-moved"
+            >
+              {{ t('outcome.sources.moved') }}
+            </p>
+          </div>
+        </div>
+        <p v-else class="text-[13px] italic leading-relaxed text-slate-500">
+          {{ t(SOURCES_GAP_KEYS[outcome.sources.gap]) }}
+        </p>
+      </section>
+
       <!-- Requirement coverage: which required behaviours were checked, and what was seen. -->
       <section class="mb-5" data-testid="outcome-requirements">
         <h3 class="mb-1.5 text-[11px] font-semibold uppercase tracking-wide text-slate-500">

package/app/utils/runOutcome.ts

@@ -27,6 +27,8 @@ export type {
   OutcomePullRequest,
   OutcomeRequirement,
   OutcomeRequirements,
+  OutcomeSource,
+  OutcomeSources,
   OutcomeSpecJoin,
   OutcomeTests,
   OutcomeVisual,
@@ -34,6 +36,7 @@ export type {
   RequirementsGap,
   RunOutcome,
   RunUnavailableGap,
+  SourcesGap,
   TestsGap,
   TestsVerdict,
   VisualsGap,

package/i18n/locales/de.json

@@ -6126,6 +6126,15 @@
       "title": "Was gefordert war",
       "none": "Diese Aufgabe hat keine Beschreibung, es gibt hier also nichts, womit sich das Ergebnis vergleichen ließe."
     },
+    "sources": {
+      "title": "Erstellt aus",
+      "unchecked": "Nicht mit der Quelle abgeglichen.",
+      "noSource": "Keine Quellseite zum Abgleichen vorhanden.",
+      "moved": "Diese Seite wurde während des Laufs geändert, frühere Schritte haben also eine ältere Revision gelesen.",
+      "gap": {
+        "none_linked": "Zu diesem Lauf gelangte keine Seite zu den Agenten, sie arbeiteten allein mit der Aufgabenbeschreibung."
+      }
+    },
     "gap": {
       "run_unavailable": "Der Lauf dieser Aufgabe wurde nicht geladen, deshalb können die von ihm erfassten Belege hier nicht gezeigt werden. Das ist nicht dasselbe wie ein Lauf, der nichts erfasst hat."
     },

package/i18n/locales/en.json

@@ -5839,6 +5839,15 @@
       "title": "What was asked",
       "none": "This task carries no description, so there is nothing here to compare the result against."
     },
+    "sources": {
+      "title": "Built from",
+      "unchecked": "Not checked against the source.",
+      "noSource": "No source page to compare against.",
+      "moved": "This page changed while the run was in flight, so earlier steps read an older revision.",
+      "gap": {
+        "none_linked": "No page reached this run's agents, so they worked from the task description alone."
+      }
+    },
     "gap": {
       "run_unavailable": "This task's run was not loaded, so none of the evidence it recorded can be shown here. That is not the same as a run that recorded nothing."
     },

package/i18n/locales/es.json

@@ -5570,6 +5570,15 @@
       "title": "Qué se pidió",
       "none": "Esta tarea no tiene descripción, así que no hay nada con lo que comparar el resultado."
     },
+    "sources": {
+      "title": "Creado a partir de",
+      "unchecked": "No se ha comprobado con la fuente.",
+      "noSource": "No hay página de origen con la que comparar.",
+      "moved": "Esta página cambió mientras la ejecución estaba en curso, así que los pasos anteriores leyeron una revisión más antigua.",
+      "gap": {
+        "none_linked": "Ninguna página llegó a los agentes de esta ejecución, así que trabajaron solo con la descripción de la tarea."
+      }
+    },
     "gap": {
       "run_unavailable": "La ejecución de esta tarea no se cargó, así que aquí no pueden mostrarse las pruebas que registró. No es lo mismo que una ejecución que no registró nada."
     },

package/i18n/locales/fr.json

@@ -5570,6 +5570,15 @@
       "title": "Ce qui était demandé",
       "none": "Cette tâche n'a pas de description, il n'y a donc rien à quoi comparer le résultat."
     },
+    "sources": {
+      "title": "Construit à partir de",
+      "unchecked": "Non vérifié auprès de la source.",
+      "noSource": "Aucune page source à laquelle comparer.",
+      "moved": "Cette page a changé pendant l'exécution : les étapes antérieures ont donc lu une révision plus ancienne.",
+      "gap": {
+        "none_linked": "Aucune page n'est parvenue aux agents de cette exécution, ils ont donc travaillé uniquement à partir de la description de la tâche."
+      }
+    },
     "gap": {
       "run_unavailable": "L'exécution de cette tâche n'a pas été chargée : les éléments qu'elle a enregistrés ne peuvent donc pas être affichés ici. Ce n'est pas la même chose qu'une exécution qui n'a rien enregistré."
     },

package/i18n/locales/he.json

@@ -5570,6 +5570,15 @@
       "title": "מה התבקש",
       "none": "למשימה הזאת אין תיאור, ולכן אין מול מה להשוות את התוצאה."
     },
+    "sources": {
+      "title": "נבנה מתוך",
+      "unchecked": "לא נבדק מול המקור.",
+      "noSource": "אין עמוד מקור להשוואה.",
+      "moved": "העמוד הזה השתנה בזמן שההרצה רצה, ולכן שלבים מוקדמים קראו גרסה ישנה יותר.",
+      "gap": {
+        "none_linked": "לא הגיע אף עמוד לסוכנים של הרצה זו, ולכן הם עבדו לפי תיאור המשימה בלבד."
+      }
+    },
     "gap": {
       "run_unavailable": "ההרצה של המשימה הזאת לא נטענה, ולכן הראיות שהיא תיעדה לא מוצגות כאן. זה לא אותו דבר כמו הרצה שלא תיעדה כלום."
     },

package/i18n/locales/it.json

@@ -6126,6 +6126,15 @@
       "title": "Che cosa era stato chiesto",
       "none": "Questa attività non ha una descrizione, quindi non c'è nulla con cui confrontare l'esito."
     },
+    "sources": {
+      "title": "Costruito a partire da",
+      "unchecked": "Non verificato con la sorgente.",
+      "noSource": "Nessuna pagina di origine con cui confrontare.",
+      "moved": "Questa pagina è cambiata mentre l'esecuzione era in corso, quindi i passi precedenti hanno letto una revisione più vecchia.",
+      "gap": {
+        "none_linked": "Nessuna pagina è arrivata agli agenti di questa esecuzione, che hanno lavorato solo sulla descrizione dell'attività."
+      }
+    },
     "gap": {
       "run_unavailable": "L'esecuzione di questa attività non è stata caricata, quindi le prove che ha registrato non possono essere mostrate qui. Non è la stessa cosa di un'esecuzione che non ha registrato nulla."
     },

package/i18n/locales/ja.json

@@ -5570,6 +5570,15 @@
       "title": "依頼内容",
       "none": "このタスクには説明がないため、結果と照らし合わせるものがありません。"
     },
+    "sources": {
+      "title": "参照した資料",
+      "unchecked": "ソースとの照合は行われていません。",
+      "noSource": "比較できるソースページがありません。",
+      "moved": "このページは実行中に変更されたため、前半のステップは古いリビジョンを読んでいます。",
+      "gap": {
+        "none_linked": "この実行のエージェントにはページが渡されなかったため、タスクの説明だけを頼りに作業しました。"
+      }
+    },
     "gap": {
       "run_unavailable": "このタスクの実行が読み込まれていないため、そこに記録された根拠をここには表示できません。何も記録しなかった実行とは別のことです。"
     },

package/i18n/locales/pl.json

@@ -5570,6 +5570,15 @@
       "title": "O co proszono",
       "none": "To zadanie nie ma opisu, więc nie ma do czego porównać wyniku."
     },
+    "sources": {
+      "title": "Zbudowano na podstawie",
+      "unchecked": "Nie sprawdzono ze źródłem.",
+      "noSource": "Brak strony źródłowej do porównania.",
+      "moved": "Ta strona zmieniła się w trakcie uruchomienia, więc wcześniejsze kroki czytały starszą wersję.",
+      "gap": {
+        "none_linked": "Do agentów tego przebiegu nie trafiła żadna strona, więc pracowali wyłącznie na opisie zadania."
+      }
+    },
     "gap": {
       "run_unavailable": "Przebieg tego zadania nie został wczytany, więc zapisane w nim dowody nie są tutaj pokazane. To co innego niż przebieg, który niczego nie zapisał."
     },

package/i18n/locales/tr.json

@@ -5570,6 +5570,15 @@
       "title": "Ne istenmişti",
       "none": "Bu görevin açıklaması yok, dolayısıyla sonucu karşılaştıracak bir şey de yok."
     },
+    "sources": {
+      "title": "Şuradan üretildi",
+      "unchecked": "Kaynakla karşılaştırılmadı.",
+      "noSource": "Karşılaştırılacak bir kaynak sayfa yok.",
+      "moved": "Bu sayfa çalışma sürerken değişti, bu yüzden önceki adımlar daha eski bir sürümü okudu.",
+      "gap": {
+        "none_linked": "Bu çalıştırmanın ajanlarına hiçbir sayfa ulaşmadı, bu yüzden yalnızca görev açıklamasıyla çalıştılar."
+      }
+    },
     "gap": {
       "run_unavailable": "Bu görevin çalışması yüklenmediği için kaydettiği kanıtlar burada gösterilemiyor. Bu, hiçbir şey kaydetmemiş bir çalışmayla aynı şey değildir."
     },

package/i18n/locales/uk.json

@@ -5570,6 +5570,15 @@
       "title": "Про що просили",
       "none": "У цього завдання немає опису, тож немає з чим порівняти результат."
     },
+    "sources": {
+      "title": "Створено на основі",
+      "unchecked": "Не звірено з джерелом.",
+      "noSource": "Немає сторінки джерела для звіряння.",
+      "moved": "Ця сторінка змінилася під час виконання, тож попередні кроки читали давнішу редакцію.",
+      "gap": {
+        "none_linked": "До агентів цього запуску не потрапила жодна сторінка, тож вони працювали лише з опису завдання."
+      }
+    },
     "gap": {
       "run_unavailable": "Запуск цього завдання не завантажено, тому зібрані ним докази тут не показані. Це не те саме, що запуск, який нічого не зібрав."
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.244.0",
+  "version": "0.245.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.266.0"
+    "@cat-factory/contracts": "0.267.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",