@cat-factory/app 0.89.0 → 0.90.0

package/app/components/gates/GateResultView.vue

@@ -35,9 +35,16 @@ const gate = computed<GateStepState | null>(() => step.value?.gate ?? null)
 
 const isCi = computed(() => step.value?.agentKind === 'ci')
 const isHumanReview = computed(() => step.value?.agentKind === 'human-review')
+const isDocQuality = computed(() => step.value?.agentKind === 'doc-quality')
 const meta = computed(() => agentKindMeta(step.value?.agentKind ?? 'ci'))
 const helperKind = computed(() =>
-  isHumanReview.value ? 'fixer' : isCi.value ? 'ci-fixer' : 'conflict-resolver',
+  isHumanReview.value
+    ? 'fixer'
+    : isCi.value
+      ? 'ci-fixer'
+      : isDocQuality.value
+        ? 'doc-fixer'
+        : 'conflict-resolver',
 )
 const helperMeta = computed(() => agentKindMeta(helperKind.value))
 
@@ -46,7 +53,9 @@ const subtitle = computed(() =>
     ? t('gates.subtitle.humanReview')
     : isCi.value
       ? t('gates.subtitle.ci')
-      : t('gates.subtitle.conflicts'),
+      : isDocQuality.value
+        ? t('gates.subtitle.docQuality')
+        : t('gates.subtitle.conflicts'),
 )
 
 // Human-review: approval progress + the freeform "request a fix" control.
@@ -316,6 +325,35 @@ const conflictVerdict = computed(() => {
                 </p>
               </template>
 
+              <!-- Doc quality: the deterministic structural findings the gate raised -->
+              <template v-else-if="isDocQuality">
+                <h3 class="mb-2 text-[11px] font-semibold uppercase tracking-wide text-slate-500">
+                  {{ t('gates.docQuality.findings') }}
+                </h3>
+                <div
+                  v-if="gate.lastFailureSummary"
+                  class="relative rounded-md border border-slate-800 bg-slate-950/40 px-3 py-2"
+                >
+                  <CopyButton :text="gate.lastFailureSummary" class="absolute end-1 top-1" />
+                  <p class="whitespace-pre-wrap pe-8 text-[12px] leading-relaxed text-slate-300">
+                    {{ gate.lastFailureSummary }}
+                  </p>
+                </div>
+                <p v-else class="text-[13px] leading-relaxed text-slate-300">
+                  {{ t('gates.docQuality.findingsFallback') }}
+                </p>
+                <a
+                  v-if="prUrl"
+                  :href="prUrl"
+                  target="_blank"
+                  rel="noopener"
+                  class="mt-2 inline-flex items-center gap-1 text-[12px] text-sky-300 hover:text-sky-200 hover:underline"
+                >
+                  {{ t('gates.docQuality.viewPr') }}
+                  <UIcon name="i-lucide-external-link" class="h-3 w-3" />
+                </a>
+              </template>
+
               <!-- Conflicts: verdict + the resolver's account of what it left -->
               <template v-else>
                 <h3 class="mb-2 text-[11px] font-semibold uppercase tracking-wide text-slate-500">

package/app/utils/catalog.ts

@@ -437,6 +437,20 @@ export const SYSTEM_AGENT_META: Record<string, AgentArchetype> = {
     // of the generic prose step-detail panel. Shared with the conflicts gate.
     resultView: 'gate',
   },
+  // The forward document pipelines' structural gate. Seed-only (no `category`, like ci /
+  // conflicts) — it's part of `pl_document(_quick)`, not a standing palette block — but it
+  // needs display metadata so timelines/saved pipelines render it. Its helper `doc-fixer`
+  // is a registered kind, so it arrives via the workspace snapshot's `customAgentKinds`.
+  'doc-quality': {
+    kind: 'doc-quality',
+    label: 'Doc Quality Gate',
+    icon: 'i-lucide-file-check-2',
+    color: '#818cf8',
+    description:
+      'Checks the drafted document for required sections, placeholders, links and heading structure, looping the doc fixer on problems.',
+    // Opens the dedicated gate window (verdict, attempts, the document findings).
+    resultView: 'gate',
+  },
   'ci-fixer': {
     kind: 'ci-fixer',
     label: 'CI Fixer',

package/i18n/locales/en.json

@@ -3030,7 +3030,8 @@
     "subtitle": {
       "humanReview": "Waits for a human code review on the PR, looping the fixer on comments",
       "ci": "Gates the PR on green CI, looping the CI fixer on failure",
-      "conflicts": "Gates the PR on a clean merge, looping the resolver on conflicts"
+      "conflicts": "Gates the PR on a clean merge, looping the resolver on conflicts",
+      "docQuality": "Checks the drafted document's structure, looping the doc fixer on problems"
     },
     "status": {
       "passed": "Passed",
@@ -3071,6 +3072,11 @@
       "mergeability": "Mergeability",
       "viewPr": "View pull request on GitHub"
     },
+    "docQuality": {
+      "findings": "Document issues",
+      "findingsFallback": "The document passed the structural checks.",
+      "viewPr": "View pull request on GitHub"
+    },
     "attemptsHeading": "{helper} attempts",
     "attempt": "Attempt {number}",
     "attemptInstructions": "Handed to {helper}",

package/i18n/locales/es.json

@@ -2938,7 +2938,8 @@
     "subtitle": {
       "humanReview": "Espera una revisión de código humana en el PR, repitiendo el corrector ante los comentarios",
       "ci": "Bloquea el PR hasta que la CI esté verde, repitiendo el corrector de CI ante los fallos",
-      "conflicts": "Bloquea el PR hasta una fusión limpia, repitiendo el resolutor ante los conflictos"
+      "conflicts": "Bloquea el PR hasta una fusión limpia, repitiendo el resolutor ante los conflictos",
+      "docQuality": "Comprueba la estructura del documento redactado, repitiendo el corrector de documentos ante los problemas"
     },
     "status": {
       "passed": "Aprobado",
@@ -2979,6 +2980,11 @@
       "mergeability": "Fusionabilidad",
       "viewPr": "Ver la pull request en GitHub"
     },
+    "docQuality": {
+      "findings": "Problemas del documento",
+      "findingsFallback": "El documento superó las comprobaciones estructurales.",
+      "viewPr": "Ver la pull request en GitHub"
+    },
     "attemptsHeading": "Intentos de {helper}",
     "attempt": "Intento {number}",
     "attemptInstructions": "Entregado a {helper}",

package/i18n/locales/fr.json

@@ -2938,7 +2938,8 @@
     "subtitle": {
       "humanReview": "Attend une revue de code humaine sur la PR, en relançant le correcteur à chaque commentaire",
       "ci": "Bloque la PR jusqu'à une CI verte, en relançant le correcteur de CI en cas d'échec",
-      "conflicts": "Bloque la PR jusqu'à une fusion propre, en relançant le résolveur en cas de conflits"
+      "conflicts": "Bloque la PR jusqu'à une fusion propre, en relançant le résolveur en cas de conflits",
+      "docQuality": "Vérifie la structure du document rédigé, en relançant le correcteur de documents en cas de problème"
     },
     "status": {
       "passed": "Réussi",
@@ -2979,6 +2980,11 @@
       "mergeability": "Fusionnabilité",
       "viewPr": "Voir la pull request sur GitHub"
     },
+    "docQuality": {
+      "findings": "Problèmes du document",
+      "findingsFallback": "Le document a réussi les vérifications structurelles.",
+      "viewPr": "Voir la pull request sur GitHub"
+    },
     "attemptsHeading": "Tentatives du {helper}",
     "attempt": "Tentative {number}",
     "attemptInstructions": "Transmis à {helper}",

package/i18n/locales/he.json

@@ -2943,7 +2943,8 @@
     "subtitle": {
       "humanReview": "ממתין לסקירת קוד אנושית על ה-PR, ומפעיל בלולאה את המתקן על הערות",
       "ci": "מגדר את ה-PR על CI ירוק, ומפעיל בלולאה את מתקן ה-CI בכישלון",
-      "conflicts": "מגדר את ה-PR על מיזוג נקי, ומפעיל בלולאה את הפותר בהתנגשויות"
+      "conflicts": "מגדר את ה-PR על מיזוג נקי, ומפעיל בלולאה את הפותר בהתנגשויות",
+      "docQuality": "בודק את מבנה המסמך שנוסח, ומפעיל בלולאה את מתקן המסמכים בבעיות"
     },
     "status": {
       "passed": "עבר",
@@ -2984,6 +2985,11 @@
       "mergeability": "יכולת מיזוג",
       "viewPr": "הצג את בקשת המשיכה ב-GitHub"
     },
+    "docQuality": {
+      "findings": "בעיות במסמך",
+      "findingsFallback": "המסמך עבר את בדיקות המבנה.",
+      "viewPr": "הצג את בקשת המשיכה ב-GitHub"
+    },
     "attemptsHeading": "ניסיונות {helper}",
     "attempt": "ניסיון {number}",
     "attemptInstructions": "נמסר ל־{helper}",

package/i18n/locales/ja.json

@@ -2947,7 +2947,8 @@
     "subtitle": {
       "humanReview": "PR の人によるコードレビューを待ち、コメントに応じて fixer をループします",
       "ci": "CI がグリーンになるまで PR をゲートし、失敗時に CI fixer をループします",
-      "conflicts": "クリーンなマージになるまで PR をゲートし、コンフリクト時に resolver をループします"
+      "conflicts": "クリーンなマージになるまで PR をゲートし、コンフリクト時に resolver をループします",
+      "docQuality": "作成された文書の構造をチェックし、問題があれば doc fixer をループします"
     },
     "status": {
       "passed": "合格",
@@ -2988,6 +2989,11 @@
       "mergeability": "マージ可能性",
       "viewPr": "GitHub でプルリクエストを表示"
     },
+    "docQuality": {
+      "findings": "文書の問題",
+      "findingsFallback": "文書は構造チェックに合格しました。",
+      "viewPr": "GitHub でプルリクエストを表示"
+    },
     "attemptsHeading": "{helper} の試行",
     "attempt": "試行 {number}",
     "attemptInstructions": "{helper} への指示",

package/i18n/locales/pl.json

@@ -2938,7 +2938,8 @@
     "subtitle": {
       "humanReview": "Czeka na recenzję kodu przez człowieka na PR, ponawiając korektora po komentarzach",
       "ci": "Blokuje PR do zielonego CI, ponawiając korektora CI przy niepowodzeniu",
-      "conflicts": "Blokuje PR do czystego scalenia, ponawiając rozwiązywacza przy konfliktach"
+      "conflicts": "Blokuje PR do czystego scalenia, ponawiając rozwiązywacza przy konfliktach",
+      "docQuality": "Sprawdza strukturę przygotowanego dokumentu, ponawiając korektora dokumentów przy problemach"
     },
     "status": {
       "passed": "Zaliczono",
@@ -2979,6 +2980,11 @@
       "mergeability": "Możliwość scalenia",
       "viewPr": "Zobacz pull request na GitHub"
     },
+    "docQuality": {
+      "findings": "Problemy dokumentu",
+      "findingsFallback": "Dokument przeszedł kontrole strukturalne.",
+      "viewPr": "Zobacz pull request na GitHub"
+    },
     "attemptsHeading": "Próby: {helper}",
     "attempt": "Próba {number}",
     "attemptInstructions": "Przekazano do: {helper}",

package/i18n/locales/tr.json

@@ -2947,7 +2947,8 @@
     "subtitle": {
       "humanReview": "PR üzerinde bir insan kod incelemesini bekler, yorumlar üzerine düzelticiyi döngüye alır",
       "ci": "PR'ı yeşil CI üzerinde kapı altına alır, başarısızlıkta CI düzelticiyi döngüye alır",
-      "conflicts": "PR'ı temiz bir birleştirme üzerinde kapı altına alır, çakışmalarda çözücüyü döngüye alır"
+      "conflicts": "PR'ı temiz bir birleştirme üzerinde kapı altına alır, çakışmalarda çözücüyü döngüye alır",
+      "docQuality": "Hazırlanan belgenin yapısını denetler, sorunlarda belge düzelticiyi döngüye alır"
     },
     "status": {
       "passed": "Geçti",
@@ -2988,6 +2989,11 @@
       "mergeability": "Birleştirilebilirlik",
       "viewPr": "Çekme isteğini GitHub'da görüntüle"
     },
+    "docQuality": {
+      "findings": "Belge sorunları",
+      "findingsFallback": "Belge yapısal denetimleri geçti.",
+      "viewPr": "Çekme isteğini GitHub'da görüntüle"
+    },
     "attemptsHeading": "{helper} denemeleri",
     "attempt": "Deneme {number}",
     "attemptInstructions": "{helper}'a iletildi",

package/i18n/locales/uk.json

@@ -2938,7 +2938,8 @@
     "subtitle": {
       "humanReview": "Чекає на огляд коду людиною в PR, повторюючи виправлювача після коментарів",
       "ci": "Блокує PR до зеленого CI, повторюючи виправлювача CI у разі помилки",
-      "conflicts": "Блокує PR до чистого злиття, повторюючи розв'язувача у разі конфліктів"
+      "conflicts": "Блокує PR до чистого злиття, повторюючи розв'язувача у разі конфліктів",
+      "docQuality": "Перевіряє структуру підготовленого документа, повторюючи виправлювача документів у разі проблем"
     },
     "status": {
       "passed": "Пройдено",
@@ -2979,6 +2980,11 @@
       "mergeability": "Можливість злиття",
       "viewPr": "Переглянути pull request на GitHub"
     },
+    "docQuality": {
+      "findings": "Проблеми документа",
+      "findingsFallback": "Документ пройшов структурні перевірки.",
+      "viewPr": "Переглянути pull request на GitHub"
+    },
     "attemptsHeading": "Спроби: {helper}",
     "attempt": "Спроба {number}",
     "attemptInstructions": "Передано: {helper}",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.89.0",
+  "version": "0.90.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",