@cat-factory/app 0.153.4 → 0.154.0

package/app/components/settings/WorkspaceSettingsPanel.vue

@@ -149,6 +149,7 @@ const draft = reactive({
   taskLimitShared: 5 as number,
   perType: {} as Record<LimitTaskType, number>,
   storeAgentContext: true,
+  publishPrVerificationReport: true,
   artifactRetentionDays: 14,
   kaizenEnabled: true,
   reviewFrictionMode: 'off' as ReviewFrictionMode,
@@ -167,6 +168,7 @@ function hydrate() {
   const pt = s.taskLimitPerType ?? {}
   for (const t of TASK_TYPES) draft.perType[t] = pt[t] ?? 3
   draft.storeAgentContext = s.storeAgentContext
+  draft.publishPrVerificationReport = s.publishPrVerificationReport
   draft.artifactRetentionDays = s.artifactRetentionDays
   draft.kaizenEnabled = s.kaizenEnabled
   draft.reviewFrictionMode = s.reviewFrictionMode
@@ -222,6 +224,7 @@ async function save() {
             )
           : null,
       storeAgentContext: draft.storeAgentContext,
+      publishPrVerificationReport: draft.publishPrVerificationReport,
       artifactRetentionDays: draft.artifactRetentionDays,
       kaizenEnabled: draft.kaizenEnabled,
       reviewFrictionMode: draft.reviewFrictionMode,
@@ -421,6 +424,22 @@ async function save() {
               </label>
             </section>
 
+            <!-- Engine-maintained PR verification report -->
+            <section class="space-y-2">
+              <h3 class="text-sm font-semibold text-slate-200">
+                {{ t('settings.workspaceSettings.prReport.heading') }}
+              </h3>
+              <p class="text-[11px] text-slate-400">
+                {{ t('settings.workspaceSettings.prReport.body') }}
+              </p>
+              <label class="flex items-center gap-2">
+                <USwitch v-model="draft.publishPrVerificationReport" size="sm" />
+                <span class="text-sm text-slate-200">{{
+                  t('settings.workspaceSettings.prReport.toggle')
+                }}</span>
+              </label>
+            </section>
+
             <!-- Visual-confirmation artifact retention -->
             <section class="space-y-2">
               <h3 class="text-sm font-semibold text-slate-200">

package/app/composables/useRunDeepLink.spec.ts

@@ -0,0 +1,51 @@
+import { createPinia, setActivePinia } from 'pinia'
+import { beforeEach, describe, expect, it } from 'vitest'
+import { captureRunDeepLink } from './useRunDeepLink'
+
+/** Point `window.location` + `history` at a URL the capture can read and rewrite. */
+function setUrl(search: string): void {
+  history.replaceState(null, '', `/${search}`)
+}
+
+describe('captureRunDeepLink', () => {
+  beforeEach(() => {
+    setActivePinia(createPinia())
+    setUrl('')
+  })
+
+  it('returns null when the URL carries no run link', () => {
+    setUrl('?other=1')
+    expect(captureRunDeepLink()).toBeNull()
+    // An unrelated param is left alone.
+    expect(window.location.search).toBe('?other=1')
+  })
+
+  it('parses the report link the engine emits', () => {
+    setUrl('?ws=ws_1&block=blk_1&run=exec_1&view=observability')
+    expect(captureRunDeepLink()).toEqual({
+      workspaceId: 'ws_1',
+      blockId: 'blk_1',
+      runId: 'exec_1',
+      view: 'observability',
+    })
+  })
+
+  it('strips its own params so a reload does not re-open the panel', () => {
+    setUrl('?ws=ws_1&run=exec_1&view=observability&keep=yes')
+    captureRunDeepLink()
+    // Only the link's own params are consumed; anything else survives.
+    expect(window.location.search).toBe('?keep=yes')
+    // …and a second read finds nothing left to replay.
+    expect(captureRunDeepLink()).toBeNull()
+  })
+
+  it('tolerates a partial link (run id alone still resolves)', () => {
+    setUrl('?run=exec_1')
+    expect(captureRunDeepLink()).toEqual({
+      workspaceId: null,
+      blockId: null,
+      runId: 'exec_1',
+      view: null,
+    })
+  })
+})

package/app/composables/useRunDeepLink.ts

@@ -0,0 +1,91 @@
+/**
+ * Boot-time replay of a RUN deep link — `?ws=<id>&block=<id>&run=<id>&view=observability`.
+ *
+ * The engine's PR verification report links each PR back to the run's observability panel
+ * (Model activity / Provided context), built from the deployment's public app URL. The SPA is a
+ * single canvas with no URL identity for anything, so this is the narrow consumer that makes
+ * that link resolve: pin the board before the snapshot loads, then — once the board is ready —
+ * select the task and open the panel for the run.
+ *
+ * Deliberately narrow. The GENERAL parser (every entity, every window, plus state→URL sync) is
+ * slice 4 of `docs/initiatives/global-search-and-deep-links.md`; when it lands, this composable
+ * is deleted rather than kept alongside it.
+ */
+import { watch } from 'vue'
+import { useUiStore } from '../stores/ui'
+import { useWorkspaceStore } from '../stores/workspace'
+
+/** The parsed link, or null when the URL carried none. */
+interface PendingRunLink {
+  workspaceId: string | null
+  blockId: string | null
+  runId: string
+  view: string | null
+}
+
+const RUN_LINK_PARAMS = ['ws', 'block', 'run', 'view'] as const
+
+/**
+ * Read (and strip) a run deep link from the current URL. Called BEFORE `workspace.init()` so
+ * the pinned board id is in place when `resolveActiveBoard` picks which board to open. The
+ * params are removed from the URL — mirroring the `?invite=` / `?infraSetup=` handling — so a
+ * reload doesn't re-open the panel and the link isn't left sitting in history.
+ */
+export function captureRunDeepLink(): PendingRunLink | null {
+  if (typeof window === 'undefined') return null
+  const params = new URLSearchParams(window.location.search)
+  const runId = params.get('run')
+  if (!runId) return null
+
+  const link: PendingRunLink = {
+    workspaceId: params.get('ws'),
+    blockId: params.get('block'),
+    runId,
+    view: params.get('view'),
+  }
+  for (const key of RUN_LINK_PARAMS) params.delete(key)
+  const qs = params.toString()
+  history.replaceState(null, '', window.location.pathname + (qs ? `?${qs}` : ''))
+  return link
+}
+
+/**
+ * Capture a run deep link and, once the board has hydrated, apply it. Returns nothing; the
+ * caller mounts it once, next to `workspace.init()`.
+ *
+ * Applying WAITS for `workspace.ready`: opening the panel against a half-loaded board would
+ * read an execution the snapshot hasn't delivered yet. The watcher is one-shot — a later
+ * refresh must not re-open a panel the user closed.
+ */
+export function useRunDeepLink(): void {
+  const link = captureRunDeepLink()
+  if (!link) return
+
+  const workspace = useWorkspaceStore()
+  const ui = useUiStore()
+
+  // Pin the board the link names BEFORE init resolves the active one, so the run's own board
+  // opens rather than whichever one was last used on this device.
+  if (link.workspaceId) workspace.workspaceId = link.workspaceId
+
+  // Applied at most once — a later refresh must not re-open a panel the user closed. The guard
+  // is a flag rather than `{ once: true }` (which would burn the single run on the immediate
+  // not-ready tick and never navigate) and `stop` is a `let` rather than a `const` (with
+  // `immediate`, the callback runs synchronously BEFORE the binding initialises, so an
+  // already-hydrated board would hit the temporal dead zone instead of navigating).
+  let applied = false
+  let stop: (() => void) | undefined
+  stop = watch(
+    () => workspace.ready,
+    (ready) => {
+      if (!ready || applied) return
+      applied = true
+      if (link.blockId) ui.select(link.blockId)
+      // `observability` is the only view this narrow parser serves — an unknown view still
+      // lands the user on the right board and task rather than failing the navigation.
+      if (link.view === 'observability') ui.openObservability(link.runId)
+      stop?.()
+    },
+    { immediate: true },
+  )
+}

package/app/pages/index.vue

@@ -145,6 +145,10 @@ useKeyboardShortcuts()
 
 // Load the board from the backend before rendering it.
 onMounted(() => {
+  // Consume a run deep link (`?ws=…&block=…&run=…&view=observability`) BEFORE init, so the
+  // board it names is the one that opens. This is what makes the observability link on an
+  // engine-published PR verification report resolve.
+  useRunDeepLink()
   void workspace.init()
   // Honour a `cat-factory k3s` CLI hand-off (`?infraSetup=local-k3s&…`): open the Infrastructure
   // window pre-seeded with the provisioned connection so the user only pastes the token + saves.

package/app/stores/workspaceSettings.ts

@@ -10,6 +10,7 @@ const DEFAULTS: WorkspaceSettings = {
   taskLimitShared: null,
   taskLimitPerType: null,
   storeAgentContext: true,
+  publishPrVerificationReport: true,
   artifactRetentionDays: 14,
   kaizenEnabled: true,
   delegateAgentsToRunnerPool: false,

package/i18n/locales/de.json

@@ -760,6 +760,11 @@
         "body": "Speichere den vollständigen Kontext, der jedem Agenten bereitgestellt wird: die zusammengesetzten Prompts, die eingefügten Best-Practice-Fragmente und den vollständigen Inhalt der in seinen Container injizierten Dateien, sodass er später in der Observability-Ansicht inspiziert werden kann. Die Inhalte werden für denselben Zeitraum wie die LLM-Telemetrie pro Aufruf aufbewahrt. Deaktivieren, um die Speicherung zu stoppen (bestehende Snapshots werden durch die Aufbewahrung bereinigt).",
         "toggle": "Vollständigen Agentenkontext speichern"
       },
+      "prReport": {
+        "heading": "Verifizierungsbericht im Pull Request",
+        "body": "Pflegt einen Verifizierungsbericht im Pull Request jedes Laufs: das CI-Ergebnis, den Bericht des Testers, den Lebenszyklus der kurzlebigen Umgebung und die Merge-Bewertung – als erfasste Fakten statt als Behauptungen des Agenten. Zugangsdaten werden vor dem Schreiben entfernt. Zum Beenden ausschalten; ein bereits vorhandener Bericht bleibt unverändert.",
+        "toggle": "Verifizierungsbericht in Pull Requests veröffentlichen"
+      },
       "retention": {
         "heading": "Screenshot-Aufbewahrung",
         "body": "Wie lange die vom UI-Tester aufgenommenen Screenshots und die Referenz-Designbilder, gegen die sie geprüft werden (das visuelle Bestätigungs-Gate), aufbewahrt werden. Ein täglicher Cleanup-Job löscht sowohl die Bild-Bytes als auch ihre Metadaten, sobald sie älter als dieser Zeitraum sind.",

package/i18n/locales/en.json

@@ -2795,6 +2795,11 @@
         "body": "Store the complete context provided to each agent: the composed prompts, the best-practice fragments folded in, and the full content of the files injected into its container, so it can be inspected later in the observability view. The bodies are kept for the same window as the per-call LLM telemetry. Turn off to stop storing it (existing snapshots are pruned by retention).",
         "toggle": "Store full agent context"
       },
+      "prReport": {
+        "heading": "Pull request verification report",
+        "body": "Maintain a verification report on each run's pull request: the CI verdict, the tester's report, ephemeral-environment lifecycle and the merge assessment, as captured facts rather than the agent's own claims. Credentials are scrubbed before anything is written. Turn off to stop publishing; a report already on a pull request is left as it is.",
+        "toggle": "Publish the verification report on pull requests"
+      },
       "retention": {
         "heading": "Screenshot retention",
         "body": "How long to keep the UI tester's captured screenshots and the reference design images they're reviewed against (the visual-confirmation gate). A daily cleanup job deletes both the image bytes and their metadata once they age past this window.",

package/i18n/locales/es.json

@@ -2607,6 +2607,11 @@
         "body": "Almacena el contexto completo proporcionado a cada agente: los prompts compuestos, los fragmentos de buenas prácticas incorporados y el contenido íntegro de los archivos inyectados en su contenedor, para poder inspeccionarlo después en la vista de observabilidad. Los cuerpos se conservan durante la misma ventana que la telemetría de LLM por llamada. Desactívalo para dejar de almacenarlo (las instantáneas existentes se eliminan por retención).",
         "toggle": "Almacenar el contexto completo del agente"
       },
+      "prReport": {
+        "heading": "Informe de verificación en la pull request",
+        "body": "Mantiene un informe de verificación en la pull request de cada ejecución: el veredicto de CI, el informe del probador, el ciclo de vida del entorno efímero y la evaluación de fusión, como hechos registrados y no como afirmaciones del agente. Las credenciales se depuran antes de escribir nada. Desactívalo para dejar de publicarlo; un informe ya presente se deja tal cual.",
+        "toggle": "Publicar el informe de verificación en las pull requests"
+      },
       "retention": {
         "heading": "Retención de capturas de pantalla",
         "body": "Cuánto tiempo conservar las capturas de pantalla del probador de UI y las imágenes de diseño de referencia con las que se comparan (la verificación visual). Un trabajo de limpieza diario elimina tanto los bytes de las imágenes como sus metadatos cuando superan esta ventana.",

package/i18n/locales/fr.json

@@ -2607,6 +2607,11 @@
         "body": "Stockez le contexte complet fourni à chaque agent : les prompts composés, les fragments de bonnes pratiques intégrés et le contenu intégral des fichiers injectés dans son conteneur, afin de pouvoir l'inspecter plus tard dans la vue d'observabilité. Les corps sont conservés pendant la même fenêtre que la télémétrie LLM par appel. Désactivez pour cesser de le stocker (les instantanés existants sont supprimés par la rétention).",
         "toggle": "Stocker le contexte complet de l'agent"
       },
+      "prReport": {
+        "heading": "Rapport de vérification sur la pull request",
+        "body": "Maintient un rapport de vérification sur la pull request de chaque exécution : le verdict de CI, le rapport du testeur, le cycle de vie de l'environnement éphémère et l'évaluation de fusion, sous forme de faits constatés plutôt que d'affirmations de l'agent. Les identifiants sont expurgés avant toute écriture. Désactivez pour cesser de le publier ; un rapport déjà présent reste inchangé.",
+        "toggle": "Publier le rapport de vérification sur les pull requests"
+      },
       "retention": {
         "heading": "Rétention des captures d'écran",
         "body": "Combien de temps conserver les captures d'écran du testeur d'UI et les images de conception de référence auxquelles elles sont comparées (la vérification visuelle). Un nettoyage quotidien supprime à la fois les octets des images et leurs métadonnées une fois qu'ils dépassent cette fenêtre.",

package/i18n/locales/he.json

@@ -2728,6 +2728,11 @@
         "body": "אחסן את ההקשר המלא שניתן לכל סוכן: ההנחיות המורכבות, מקטעי שיטות העבודה המומלצות שמשולבים, והתוכן המלא של הקבצים שמוזרקים לקונטיינר שלו, כך שניתן יהיה לבדוק אותו מאוחר יותר בתצוגת התצפיתיות. הגופים נשמרים לאותו חלון כמו טלמטריית ה-LLM לכל קריאה. כבה כדי להפסיק לאחסן אותו (תצלומים קיימים נגזמים לפי תקופת השמירה).",
         "toggle": "אחסן הקשר סוכן מלא"
       },
+      "prReport": {
+        "heading": "דוח אימות בבקשת המשיכה",
+        "body": "שמירת דוח אימות בבקשת המשיכה של כל הרצה: תוצאת ה-CI, דוח הבודק, מחזור החיים של הסביבה הזמנית והערכת המיזוג — כעובדות שנאספו ולא כטענות של הסוכן. פרטי גישה מנוקים לפני כל כתיבה. כבו כדי להפסיק לפרסם; דוח שכבר קיים נשאר כפי שהוא.",
+        "toggle": "פרסום דוח האימות בבקשות משיכה"
+      },
       "retention": {
         "heading": "שמירת צילומי מסך",
         "body": "כמה זמן לשמור את צילומי המסך שצולמו על ידי בודק הממשק ואת תמונות העיצוב המקוריות שמולן הם נסקרים (שער האישור החזותי). משימת ניקוי יומית מוחקת גם את בתי התמונה וגם את המטא-נתונים שלהם ברגע שהם מתיישנים מעבר לחלון זה.",

package/i18n/locales/it.json

@@ -760,6 +760,11 @@
         "body": "Memorizza il contesto completo fornito a ogni agente: i prompt composti, i frammenti di best practice inclusi e il contenuto completo dei file iniettati nel suo container, cosicche possa essere ispezionato in seguito nella vista di osservabilita. I corpi vengono conservati per la stessa finestra della telemetria LLM per chiamata. Disattiva per interrompere la memorizzazione (gli snapshot esistenti vengono eliminati dalla retention).",
         "toggle": "Memorizza il contesto completo dell'agente"
       },
+      "prReport": {
+        "heading": "Rapporto di verifica sulla pull request",
+        "body": "Mantiene un rapporto di verifica sulla pull request di ogni esecuzione: il verdetto della CI, il rapporto del tester, il ciclo di vita dell'ambiente effimero e la valutazione di merge, come fatti rilevati e non come affermazioni dell'agente. Le credenziali vengono ripulite prima di ogni scrittura. Disattiva per smettere di pubblicarlo; un rapporto già presente resta invariato.",
+        "toggle": "Pubblica il rapporto di verifica sulle pull request"
+      },
       "retention": {
         "heading": "Retention degli screenshot",
         "body": "Per quanto tempo conservare gli screenshot catturati dal tester UI e le immagini di design di riferimento con cui vengono confrontati (il gate di conferma visiva). Un job di pulizia giornaliero elimina sia i byte delle immagini sia i loro metadati una volta superata questa finestra.",

package/i18n/locales/ja.json

@@ -2729,6 +2729,11 @@
         "body": "各エージェントに提供された完全なコンテキストを保存します。構成されたプロンプト、折り込まれたベストプラクティスのフラグメント、コンテナに注入されたファイルの全内容を保存し、後から可観測性ビューで確認できます。本文は呼び出しごとの LLM テレメトリと同じ期間だけ保持されます。オフにすると保存を停止します (既存のスナップショットは保持期限により削除されます)。",
         "toggle": "エージェントの完全なコンテキストを保存"
       },
+      "prReport": {
+        "heading": "プルリクエストの検証レポート",
+        "body": "各実行のプルリクエストに検証レポートを維持します。CI の判定、テスターのレポート、一時環境のライフサイクル、マージ評価を、エージェント自身の主張ではなく記録された事実として掲載します。書き込み前に認証情報は削除されます。オフにすると公開を停止します。すでに掲載されているレポートはそのまま残ります。",
+        "toggle": "プルリクエストに検証レポートを公開する"
+      },
       "retention": {
         "heading": "スクリーンショットの保持",
         "body": "UI テスターがキャプチャしたスクリーンショットと、それらの照合に使われる参照デザイン画像 (視覚的確認ゲート) を保持する期間です。日次のクリーンアップジョブが、この期間を過ぎた画像データとそのメタデータの両方を削除します。",

package/i18n/locales/pl.json

@@ -2607,6 +2607,11 @@
         "body": "Przechowuj pełny kontekst przekazany każdemu agentowi: złożone prompty, włączone fragmenty dobrych praktyk oraz pełną treść plików wstrzykniętych do jego kontenera, aby można było je później sprawdzić w widoku obserwowalności. Treści są przechowywane przez to samo okno co telemetria LLM dla poszczególnych wywołań. Wyłącz, aby przestać je przechowywać (istniejące migawki są usuwane przez retencję).",
         "toggle": "Przechowuj pełny kontekst agenta"
       },
+      "prReport": {
+        "heading": "Raport weryfikacyjny w pull requeście",
+        "body": "Utrzymuje raport weryfikacyjny w pull requeście każdego przebiegu: werdykt CI, raport testera, cykl życia środowiska tymczasowego i ocenę scalenia — jako zarejestrowane fakty, a nie deklaracje agenta. Poświadczenia są usuwane przed zapisem. Wyłącz, aby przestać publikować; raport już obecny pozostaje bez zmian.",
+        "toggle": "Publikuj raport weryfikacyjny w pull requestach"
+      },
       "retention": {
         "heading": "Retencja zrzutów ekranu",
         "body": "Jak długo przechowywać zrzuty ekranu z testera UI oraz referencyjne obrazy projektowe, z którymi są porównywane (weryfikacja wizualna). Codzienne zadanie czyszczące usuwa zarówno bajty obrazów, jak i ich metadane, gdy przekroczą to okno.",

package/i18n/locales/tr.json

@@ -2729,6 +2729,11 @@
         "body": "Her agent'a sağlanan tüm bağlamı saklayın: oluşturulan istemler, içine katlanan en iyi uygulama parçaları ve konteynerine enjekte edilen dosyaların tam içeriği; böylece daha sonra gözlemlenebilirlik görünümünde incelenebilir. Gövdeler, çağrı başına LLM telemetrisi ile aynı süre boyunca tutulur. Saklamayı durdurmak için kapatın (mevcut anlık görüntüler saklama ilkesiyle temizlenir).",
         "toggle": "Tüm agent bağlamını sakla"
       },
+      "prReport": {
+        "heading": "Pull request doğrulama raporu",
+        "body": "Her çalıştırmanın pull request'inde bir doğrulama raporu tutar: CI sonucu, test edicinin raporu, geçici ortamın yaşam döngüsü ve birleştirme değerlendirmesi — ajanın kendi iddiaları yerine kaydedilmiş gerçekler olarak. Kimlik bilgileri yazılmadan önce temizlenir. Yayımlamayı durdurmak için kapatın; hâlihazırda yayımlanmış bir rapor olduğu gibi bırakılır.",
+        "toggle": "Doğrulama raporunu pull request'lerde yayımla"
+      },
       "retention": {
         "heading": "Ekran görüntüsü saklama",
         "body": "Arayüz test aracının yakaladığı ekran görüntülerinin ve bunların karşılaştırıldığı referans tasarım görsellerinin (görsel doğrulama geçidi) ne kadar süre tutulacağı. Günlük bir temizleme işi, hem görsel baytlarını hem de meta verilerini bu süreyi aştıklarında siler.",

package/i18n/locales/uk.json

@@ -2607,6 +2607,11 @@
         "body": "Зберігайте повний контекст, наданий кожному агенту: складені промпти, вбудовані фрагменти найкращих практик і повний вміст файлів, впроваджених у його контейнер, щоб згодом їх можна було переглянути у вікні спостережуваності. Тіла зберігаються протягом того самого вікна, що й телеметрія LLM для кожного виклику. Вимкніть, щоб припинити зберігання (наявні знімки видаляються за політикою зберігання).",
         "toggle": "Зберігати повний контекст агента"
       },
+      "prReport": {
+        "heading": "Звіт про перевірку в пул-реквесті",
+        "body": "Підтримує звіт про перевірку в пул-реквесті кожного запуску: вердикт CI, звіт тестувальника, життєвий цикл тимчасового середовища та оцінку злиття — як зафіксовані факти, а не твердження агента. Облікові дані вилучаються перед будь-яким записом. Вимкніть, щоб припинити публікацію; вже наявний звіт залишається без змін.",
+        "toggle": "Публікувати звіт про перевірку в пул-реквестах"
+      },
       "retention": {
         "heading": "Зберігання знімків екрана",
         "body": "Як довго зберігати знімки екрана від тестувальника UI та еталонні дизайнерські зображення, з якими їх порівнюють (візуальна перевірка). Щоденне завдання очищення видаляє як байти зображень, так і їхні метадані, щойно вони виходять за межі цього вікна.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.153.4",
+  "version": "0.154.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.161.0"
+    "@cat-factory/contracts": "0.162.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",