@cat-factory/app 0.88.0 → 0.90.0

package/app/components/board/AddTaskModal.vue

@@ -11,8 +11,14 @@
 // button is disabled with a hint. Linking needs the block id,
 // so chosen items are staged locally and import-and-linked once the task is created
 // (see useContextLinking) — the same context the agents see for every step of the run.
-import type { CreateTaskType, DocKind, TaskSourceKind, TaskTypeFields } from '~/types/domain'
-import { DOC_KINDS } from '~/types/domain'
+import type {
+  CreateTaskType,
+  DocKind,
+  DocKindFieldKey,
+  TaskSourceKind,
+  TaskTypeFields,
+} from '~/types/domain'
+import { DOC_KINDS, DOC_KIND_FIELDS } from '~/types/domain'
 import ContextDocumentPicker from '~/components/documents/ContextDocumentPicker.vue'
 import ContextIssuePicker from '~/components/tasks/ContextIssuePicker.vue'
 import { mergePresetOptionLabel, mergePresetThresholds } from '~/utils/mergePreset'
@@ -97,6 +103,40 @@ const docKind = ref<DocKind | ''>('')
 const docAudience = ref('')
 const docTargetPath = ref('')
 const docOutlineHints = ref('')
+// Per-kind specific fields (see DOC_KIND_FIELDS). Held in one keyed record; only the fields
+// for the selected kind are shown and submitted, so a value from a previously-selected kind is
+// never sent. The catalog keys below keep the labels/placeholders i18n and drift-guarded.
+const docKindFieldValues = reactive<Partial<Record<DocKindFieldKey, string>>>({})
+const docKindFields = computed(() => (docKind.value ? (DOC_KIND_FIELDS[docKind.value] ?? []) : []))
+// Exhaustive Record<DocKindFieldKey, key> of catalog keys — the initiative's drift guard for a
+// dynamic enum→key lookup (a missing enum member is a compile error here; a locale that omits a
+// key falls back via `te()` rather than leaking a raw key). Do NOT inline as bare template keys.
+const DOC_FIELD_LABEL_KEYS: Record<DocKindFieldKey, string> = {
+  targetUsers: 'board.addTask.docFields.targetUsers.label',
+  successMetrics: 'board.addTask.docFields.successMetrics.label',
+  alternativesConsidered: 'board.addTask.docFields.alternativesConsidered.label',
+  rolloutConcerns: 'board.addTask.docFields.rolloutConcerns.label',
+  decisionDrivers: 'board.addTask.docFields.decisionDrivers.label',
+  consideredOptions: 'board.addTask.docFields.consideredOptions.label',
+  whenToUse: 'board.addTask.docFields.whenToUse.label',
+  escalationPath: 'board.addTask.docFields.escalationPath.label',
+  researchQuestion: 'board.addTask.docFields.researchQuestion.label',
+  optionsToCompare: 'board.addTask.docFields.optionsToCompare.label',
+  apiSurface: 'board.addTask.docFields.apiSurface.label',
+}
+const DOC_FIELD_PLACEHOLDER_KEYS: Record<DocKindFieldKey, string> = {
+  targetUsers: 'board.addTask.docFields.targetUsers.placeholder',
+  successMetrics: 'board.addTask.docFields.successMetrics.placeholder',
+  alternativesConsidered: 'board.addTask.docFields.alternativesConsidered.placeholder',
+  rolloutConcerns: 'board.addTask.docFields.rolloutConcerns.placeholder',
+  decisionDrivers: 'board.addTask.docFields.decisionDrivers.placeholder',
+  consideredOptions: 'board.addTask.docFields.consideredOptions.placeholder',
+  whenToUse: 'board.addTask.docFields.whenToUse.placeholder',
+  escalationPath: 'board.addTask.docFields.escalationPath.placeholder',
+  researchQuestion: 'board.addTask.docFields.researchQuestion.placeholder',
+  optionsToCompare: 'board.addTask.docFields.optionsToCompare.placeholder',
+  apiSurface: 'board.addTask.docFields.apiSurface.placeholder',
+}
 const SEVERITIES = ['low', 'medium', 'high', 'critical'] as const
 
 function buildTypeFields(): TaskTypeFields | undefined {
@@ -121,6 +161,11 @@ function buildTypeFields(): TaskTypeFields | undefined {
     if (docAudience.value.trim()) f.audience = docAudience.value.trim()
     if (docTargetPath.value.trim()) f.targetPath = docTargetPath.value.trim()
     if (docOutlineHints.value.trim()) f.outlineHints = docOutlineHints.value.trim()
+    // Only the selected kind's fields are read, so a stale value for another kind is dropped.
+    for (const spec of docKindFields.value) {
+      const value = docKindFieldValues[spec.key]?.trim()
+      if (value) f[spec.key] = value
+    }
     return Object.keys(f).length ? f : undefined
   }
   return undefined
@@ -336,6 +381,8 @@ watch(open, (isOpen) => {
   docAudience.value = ''
   docTargetPath.value = ''
   docOutlineHints.value = ''
+  for (const key of Object.keys(docKindFieldValues) as DocKindFieldKey[])
+    delete docKindFieldValues[key]
   mergePresetId.value = ''
   modelPresetId.value = ''
   pipelineId.value = ''
@@ -610,6 +657,27 @@ async function add() {
                 class="w-full"
               />
             </UFormField>
+            <!-- Kind-specific fields — only those relevant to the selected docKind are shown. -->
+            <UFormField
+              v-for="spec in docKindFields"
+              :key="spec.key"
+              :label="t(DOC_FIELD_LABEL_KEYS[spec.key])"
+              :hint="t('board.addTask.optional')"
+            >
+              <UTextarea
+                v-if="spec.multiline"
+                v-model="docKindFieldValues[spec.key]"
+                :rows="2"
+                :placeholder="t(DOC_FIELD_PLACEHOLDER_KEYS[spec.key])"
+                class="w-full"
+              />
+              <UInput
+                v-else
+                v-model="docKindFieldValues[spec.key]"
+                :placeholder="t(DOC_FIELD_PLACEHOLDER_KEYS[spec.key])"
+                class="w-full"
+              />
+            </UFormField>
           </div>
 
           <div class="grid grid-cols-2 gap-3">

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/types/domain.ts

@@ -24,6 +24,8 @@ export type {
   CreateTaskType,
   TaskTypeFields,
   DocKind,
+  DocKindFieldKey,
+  DocKindFieldSpec,
   Block,
   PullRequestRef,
   CloudProvider,
@@ -74,9 +76,10 @@ export type {
 
 import type { AgentCategory, AgentKind } from '@cat-factory/contracts'
 
-// The document-kind list is a runtime value (used to render the picker), so it is re-exported
-// as a value — the single source of truth lives in the contracts package.
-export { DOC_KINDS } from '@cat-factory/contracts'
+// The document-kind list + the per-kind field descriptors are runtime values (used to render
+// the picker and the conditional per-kind inputs), so they are re-exported as values — the
+// single source of truth lives in the contracts package.
+export { DOC_KINDS, DOC_KIND_FIELDS } from '@cat-factory/contracts'
 
 /** A draggable agent definition shown in the agent palette. Frontend-only. */
 export interface AgentArchetype {

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

@@ -169,6 +169,49 @@
       "targetPathPlaceholder": "e.g. docs/rfcs/0001-foo.md",
       "outlineHints": "Outline hints",
       "outlineHintsPlaceholder": "Sections or points the document should cover",
+      "docFields": {
+        "targetUsers": {
+          "label": "Target users",
+          "placeholder": "Who the document is for and the jobs they're doing"
+        },
+        "successMetrics": {
+          "label": "Success metrics",
+          "placeholder": "Measurable outcomes that show it's working"
+        },
+        "alternativesConsidered": {
+          "label": "Alternatives considered",
+          "placeholder": "Other approaches weighed and why they were ruled out"
+        },
+        "rolloutConcerns": {
+          "label": "Rollout concerns",
+          "placeholder": "Migration and rollout risks to address"
+        },
+        "decisionDrivers": {
+          "label": "Decision drivers",
+          "placeholder": "The forces and constraints driving the decision"
+        },
+        "consideredOptions": {
+          "label": "Considered options",
+          "placeholder": "The options evaluated, each with its trade-offs"
+        },
+        "whenToUse": {
+          "label": "When to use",
+          "placeholder": "The trigger or situation this runbook applies to"
+        },
+        "escalationPath": {
+          "label": "Escalation path",
+          "placeholder": "Who to contact and how to escalate on failure"
+        },
+        "researchQuestion": {
+          "label": "Research question",
+          "placeholder": "The question or hypothesis to answer"
+        },
+        "optionsToCompare": {
+          "label": "Options to compare",
+          "placeholder": "The options to weigh against each other"
+        },
+        "apiSurface": { "label": "API surface", "placeholder": "The endpoints or surface in scope" }
+      },
       "optional": "optional",
       "pipeline": "Pipeline",
       "chooseAtRunTime": "Choose at run time",
@@ -2987,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",
@@ -3028,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

@@ -151,6 +151,52 @@
       "targetPathPlaceholder": "p. ej. docs/rfcs/0001-foo.md",
       "outlineHints": "Sugerencias de esquema",
       "outlineHintsPlaceholder": "Secciones o puntos que el documento debería cubrir",
+      "docFields": {
+        "targetUsers": {
+          "label": "Usuarios objetivo",
+          "placeholder": "Para quién es el documento y las tareas que realizan"
+        },
+        "successMetrics": {
+          "label": "Métricas de éxito",
+          "placeholder": "Resultados medibles que indican que funciona"
+        },
+        "alternativesConsidered": {
+          "label": "Alternativas consideradas",
+          "placeholder": "Otros enfoques evaluados y por qué se descartaron"
+        },
+        "rolloutConcerns": {
+          "label": "Consideraciones de despliegue",
+          "placeholder": "Riesgos de migración y despliegue a tener en cuenta"
+        },
+        "decisionDrivers": {
+          "label": "Factores de decisión",
+          "placeholder": "Las fuerzas y restricciones que motivan la decisión"
+        },
+        "consideredOptions": {
+          "label": "Opciones consideradas",
+          "placeholder": "Las opciones evaluadas, cada una con sus ventajas y desventajas"
+        },
+        "whenToUse": {
+          "label": "Cuándo usarlo",
+          "placeholder": "El desencadenante o la situación en que aplica este runbook"
+        },
+        "escalationPath": {
+          "label": "Ruta de escalado",
+          "placeholder": "A quién contactar y cómo escalar si falla"
+        },
+        "researchQuestion": {
+          "label": "Pregunta de investigación",
+          "placeholder": "La pregunta o hipótesis a responder"
+        },
+        "optionsToCompare": {
+          "label": "Opciones a comparar",
+          "placeholder": "Las opciones a sopesar entre sí"
+        },
+        "apiSurface": {
+          "label": "Superficie de API",
+          "placeholder": "Los endpoints o la superficie dentro del alcance"
+        }
+      },
       "optional": "opcional",
       "pipeline": "Pipeline",
       "chooseAtRunTime": "Elegir al ejecutar",
@@ -2892,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",
@@ -2933,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

@@ -151,6 +151,52 @@
       "targetPathPlaceholder": "ex. docs/rfcs/0001-foo.md",
       "outlineHints": "Indications de plan",
       "outlineHintsPlaceholder": "Sections ou points que le document devrait couvrir",
+      "docFields": {
+        "targetUsers": {
+          "label": "Utilisateurs cibles",
+          "placeholder": "À qui s'adresse le document et les tâches qu'ils accomplissent"
+        },
+        "successMetrics": {
+          "label": "Indicateurs de réussite",
+          "placeholder": "Résultats mesurables qui montrent que ça fonctionne"
+        },
+        "alternativesConsidered": {
+          "label": "Alternatives envisagées",
+          "placeholder": "Les autres approches évaluées et pourquoi elles ont été écartées"
+        },
+        "rolloutConcerns": {
+          "label": "Points de déploiement",
+          "placeholder": "Risques de migration et de déploiement à traiter"
+        },
+        "decisionDrivers": {
+          "label": "Facteurs de décision",
+          "placeholder": "Les forces et contraintes qui motivent la décision"
+        },
+        "consideredOptions": {
+          "label": "Options envisagées",
+          "placeholder": "Les options évaluées, chacune avec ses compromis"
+        },
+        "whenToUse": {
+          "label": "Quand l'utiliser",
+          "placeholder": "Le déclencheur ou la situation à laquelle ce runbook s'applique"
+        },
+        "escalationPath": {
+          "label": "Chemin d'escalade",
+          "placeholder": "Qui contacter et comment escalader en cas d'échec"
+        },
+        "researchQuestion": {
+          "label": "Question de recherche",
+          "placeholder": "La question ou l'hypothèse à laquelle répondre"
+        },
+        "optionsToCompare": {
+          "label": "Options à comparer",
+          "placeholder": "Les options à mettre en balance"
+        },
+        "apiSurface": {
+          "label": "Surface d'API",
+          "placeholder": "Les endpoints ou la surface concernés"
+        }
+      },
       "optional": "optionnel",
       "pipeline": "Pipeline",
       "chooseAtRunTime": "Choisir au lancement",
@@ -2892,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",
@@ -2933,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

@@ -151,6 +151,46 @@
       "targetPathPlaceholder": "למשל docs/rfcs/0001-foo.md",
       "outlineHints": "רמזים למתווה",
       "outlineHintsPlaceholder": "סעיפים או נקודות שהמסמך צריך לכסות",
+      "docFields": {
+        "targetUsers": {
+          "label": "משתמשי היעד",
+          "placeholder": "למי מיועד המסמך ואילו משימות הם מבצעים"
+        },
+        "successMetrics": { "label": "מדדי הצלחה", "placeholder": "תוצאות מדידות שמראות שזה עובד" },
+        "alternativesConsidered": {
+          "label": "חלופות שנשקלו",
+          "placeholder": "גישות אחרות שנשקלו ומדוע נפסלו"
+        },
+        "rolloutConcerns": {
+          "label": "שיקולי הטמעה",
+          "placeholder": "סיכוני מיגרציה והשקה שיש לטפל בהם"
+        },
+        "decisionDrivers": {
+          "label": "גורמי ההחלטה",
+          "placeholder": "הכוחות והאילוצים שמניעים את ההחלטה"
+        },
+        "consideredOptions": {
+          "label": "אפשרויות שנשקלו",
+          "placeholder": "האפשרויות שהוערכו, כל אחת עם היתרונות והחסרונות שלה"
+        },
+        "whenToUse": {
+          "label": "מתי להשתמש",
+          "placeholder": "הטריגר או המצב שאליו חל ה-runbook הזה"
+        },
+        "escalationPath": {
+          "label": "נתיב הסלמה",
+          "placeholder": "למי לפנות וכיצד להסלים במקרה של כשל"
+        },
+        "researchQuestion": {
+          "label": "שאלת המחקר",
+          "placeholder": "השאלה או ההשערה שיש לענות עליה"
+        },
+        "optionsToCompare": {
+          "label": "אפשרויות להשוואה",
+          "placeholder": "האפשרויות שיש לשקול זו מול זו"
+        },
+        "apiSurface": { "label": "משטח ה-API", "placeholder": "נקודות הקצה או המשטח שבתחום" }
+      },
       "optional": "אופציונלי",
       "pipeline": "צינור",
       "chooseAtRunTime": "בחר בזמן הריצה",
@@ -2903,7 +2943,8 @@
     "subtitle": {
       "humanReview": "ממתין לסקירת קוד אנושית על ה-PR, ומפעיל בלולאה את המתקן על הערות",
       "ci": "מגדר את ה-PR על CI ירוק, ומפעיל בלולאה את מתקן ה-CI בכישלון",
-      "conflicts": "מגדר את ה-PR על מיזוג נקי, ומפעיל בלולאה את הפותר בהתנגשויות"
+      "conflicts": "מגדר את ה-PR על מיזוג נקי, ומפעיל בלולאה את הפותר בהתנגשויות",
+      "docQuality": "בודק את מבנה המסמך שנוסח, ומפעיל בלולאה את מתקן המסמכים בבעיות"
     },
     "status": {
       "passed": "עבר",
@@ -2944,6 +2985,11 @@
       "mergeability": "יכולת מיזוג",
       "viewPr": "הצג את בקשת המשיכה ב-GitHub"
     },
+    "docQuality": {
+      "findings": "בעיות במסמך",
+      "findingsFallback": "המסמך עבר את בדיקות המבנה.",
+      "viewPr": "הצג את בקשת המשיכה ב-GitHub"
+    },
     "attemptsHeading": "ניסיונות {helper}",
     "attempt": "ניסיון {number}",
     "attemptInstructions": "נמסר ל־{helper}",

package/i18n/locales/ja.json

@@ -151,6 +151,49 @@
       "targetPathPlaceholder": "例: docs/rfcs/0001-foo.md",
       "outlineHints": "アウトラインのヒント",
       "outlineHintsPlaceholder": "ドキュメントがカバーすべきセクションや要点",
+      "docFields": {
+        "targetUsers": {
+          "label": "対象ユーザー",
+          "placeholder": "ドキュメントの対象者と、その人が行うタスク"
+        },
+        "successMetrics": {
+          "label": "成功指標",
+          "placeholder": "機能していることを示す測定可能な成果"
+        },
+        "alternativesConsidered": {
+          "label": "検討した代替案",
+          "placeholder": "検討した他のアプローチと却下した理由"
+        },
+        "rolloutConcerns": {
+          "label": "展開時の懸念",
+          "placeholder": "対処すべき移行・展開のリスク"
+        },
+        "decisionDrivers": {
+          "label": "意思決定の要因",
+          "placeholder": "意思決定を左右する要因と制約"
+        },
+        "consideredOptions": {
+          "label": "検討した選択肢",
+          "placeholder": "評価した各選択肢とそのトレードオフ"
+        },
+        "whenToUse": {
+          "label": "使用するタイミング",
+          "placeholder": "このランブックが適用されるトリガーや状況"
+        },
+        "escalationPath": {
+          "label": "エスカレーション経路",
+          "placeholder": "失敗時の連絡先とエスカレーション方法"
+        },
+        "researchQuestion": { "label": "リサーチの問い", "placeholder": "答えるべき問いや仮説" },
+        "optionsToCompare": {
+          "label": "比較する選択肢",
+          "placeholder": "互いに比較検討する選択肢"
+        },
+        "apiSurface": {
+          "label": "API のサーフェス",
+          "placeholder": "対象となるエンドポイントや範囲"
+        }
+      },
       "optional": "任意",
       "pipeline": "パイプライン",
       "chooseAtRunTime": "実行時に選択",
@@ -2904,7 +2947,8 @@
     "subtitle": {
       "humanReview": "PR の人によるコードレビューを待ち、コメントに応じて fixer をループします",
       "ci": "CI がグリーンになるまで PR をゲートし、失敗時に CI fixer をループします",
-      "conflicts": "クリーンなマージになるまで PR をゲートし、コンフリクト時に resolver をループします"
+      "conflicts": "クリーンなマージになるまで PR をゲートし、コンフリクト時に resolver をループします",
+      "docQuality": "作成された文書の構造をチェックし、問題があれば doc fixer をループします"
     },
     "status": {
       "passed": "合格",
@@ -2945,6 +2989,11 @@
       "mergeability": "マージ可能性",
       "viewPr": "GitHub でプルリクエストを表示"
     },
+    "docQuality": {
+      "findings": "文書の問題",
+      "findingsFallback": "文書は構造チェックに合格しました。",
+      "viewPr": "GitHub でプルリクエストを表示"
+    },
     "attemptsHeading": "{helper} の試行",
     "attempt": "試行 {number}",
     "attemptInstructions": "{helper} への指示",

package/i18n/locales/pl.json

@@ -151,6 +151,52 @@
       "targetPathPlaceholder": "np. docs/rfcs/0001-foo.md",
       "outlineHints": "Wskazówki do konspektu",
       "outlineHintsPlaceholder": "Sekcje lub punkty, które dokument powinien obejmować",
+      "docFields": {
+        "targetUsers": {
+          "label": "Użytkownicy docelowi",
+          "placeholder": "Dla kogo jest dokument i jakie zadania wykonują"
+        },
+        "successMetrics": {
+          "label": "Metryki sukcesu",
+          "placeholder": "Mierzalne wyniki potwierdzające, że to działa"
+        },
+        "alternativesConsidered": {
+          "label": "Rozważane alternatywy",
+          "placeholder": "Inne podejścia i powody ich odrzucenia"
+        },
+        "rolloutConcerns": {
+          "label": "Kwestie wdrożenia",
+          "placeholder": "Ryzyka migracji i wdrożenia do rozważenia"
+        },
+        "decisionDrivers": {
+          "label": "Czynniki decyzji",
+          "placeholder": "Siły i ograniczenia kształtujące decyzję"
+        },
+        "consideredOptions": {
+          "label": "Rozważane opcje",
+          "placeholder": "Ocenione opcje wraz z ich kompromisami"
+        },
+        "whenToUse": {
+          "label": "Kiedy stosować",
+          "placeholder": "Wyzwalacz lub sytuacja, w której obowiązuje ten runbook"
+        },
+        "escalationPath": {
+          "label": "Ścieżka eskalacji",
+          "placeholder": "Z kim się kontaktować i jak eskalować w razie awarii"
+        },
+        "researchQuestion": {
+          "label": "Pytanie badawcze",
+          "placeholder": "Pytanie lub hipoteza do rozstrzygnięcia"
+        },
+        "optionsToCompare": {
+          "label": "Opcje do porównania",
+          "placeholder": "Opcje do porównania między sobą"
+        },
+        "apiSurface": {
+          "label": "Powierzchnia API",
+          "placeholder": "Endpointy lub zakres objęty dokumentem"
+        }
+      },
       "optional": "opcjonalne",
       "pipeline": "Pipeline",
       "chooseAtRunTime": "Wybierz przy uruchomieniu",
@@ -2892,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",
@@ -2933,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

@@ -151,6 +151,49 @@
       "targetPathPlaceholder": "ör. docs/rfcs/0001-foo.md",
       "outlineHints": "Ana hat ipuçları",
       "outlineHintsPlaceholder": "Belgenin kapsaması gereken bölümler veya noktalar",
+      "docFields": {
+        "targetUsers": {
+          "label": "Hedef kullanıcılar",
+          "placeholder": "Belgenin kime yönelik olduğu ve yaptıkları işler"
+        },
+        "successMetrics": {
+          "label": "Başarı ölçütleri",
+          "placeholder": "İşe yaradığını gösteren ölçülebilir sonuçlar"
+        },
+        "alternativesConsidered": {
+          "label": "Değerlendirilen alternatifler",
+          "placeholder": "Tartılan diğer yaklaşımlar ve neden elendikleri"
+        },
+        "rolloutConcerns": {
+          "label": "Dağıtım kaygıları",
+          "placeholder": "Ele alınacak geçiş ve dağıtım riskleri"
+        },
+        "decisionDrivers": {
+          "label": "Karar etkenleri",
+          "placeholder": "Kararı yönlendiren güçler ve kısıtlar"
+        },
+        "consideredOptions": {
+          "label": "Değerlendirilen seçenekler",
+          "placeholder": "Değerlendirilen seçenekler ve ödünleşimleri"
+        },
+        "whenToUse": {
+          "label": "Ne zaman kullanılır",
+          "placeholder": "Bu runbook'un geçerli olduğu tetikleyici veya durum"
+        },
+        "escalationPath": {
+          "label": "Yükseltme yolu",
+          "placeholder": "Kiminle iletişime geçileceği ve arıza durumunda nasıl yükseltileceği"
+        },
+        "researchQuestion": {
+          "label": "Araştırma sorusu",
+          "placeholder": "Yanıtlanacak soru veya hipotez"
+        },
+        "optionsToCompare": {
+          "label": "Karşılaştırılacak seçenekler",
+          "placeholder": "Birbirine karşı tartılacak seçenekler"
+        },
+        "apiSurface": { "label": "API yüzeyi", "placeholder": "Kapsamdaki uç noktalar veya yüzey" }
+      },
       "optional": "isteğe bağlı",
       "pipeline": "İşlem hattı",
       "chooseAtRunTime": "Çalıştırma sırasında seç",
@@ -2904,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",
@@ -2945,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

@@ -151,6 +151,52 @@
       "targetPathPlaceholder": "напр. docs/rfcs/0001-foo.md",
       "outlineHints": "Підказки для плану",
       "outlineHintsPlaceholder": "Розділи або пункти, які має охопити документ",
+      "docFields": {
+        "targetUsers": {
+          "label": "Цільові користувачі",
+          "placeholder": "Для кого документ і які завдання вони виконують"
+        },
+        "successMetrics": {
+          "label": "Метрики успіху",
+          "placeholder": "Вимірювані результати, що підтверджують працездатність"
+        },
+        "alternativesConsidered": {
+          "label": "Розглянуті альтернативи",
+          "placeholder": "Інші підходи та причини їх відхилення"
+        },
+        "rolloutConcerns": {
+          "label": "Питання розгортання",
+          "placeholder": "Ризики міграції та розгортання, які слід врахувати"
+        },
+        "decisionDrivers": {
+          "label": "Чинники рішення",
+          "placeholder": "Сили та обмеження, що визначають рішення"
+        },
+        "consideredOptions": {
+          "label": "Розглянуті варіанти",
+          "placeholder": "Оцінені варіанти з їхніми компромісами"
+        },
+        "whenToUse": {
+          "label": "Коли застосовувати",
+          "placeholder": "Тригер або ситуація, до якої застосовний цей runbook"
+        },
+        "escalationPath": {
+          "label": "Шлях ескалації",
+          "placeholder": "До кого звертатися та як ескалювати в разі збою"
+        },
+        "researchQuestion": {
+          "label": "Дослідницьке питання",
+          "placeholder": "Питання або гіпотеза, на яку слід відповісти"
+        },
+        "optionsToCompare": {
+          "label": "Варіанти для порівняння",
+          "placeholder": "Варіанти для зважування між собою"
+        },
+        "apiSurface": {
+          "label": "Поверхня API",
+          "placeholder": "Кінцеві точки або поверхня в межах обсягу"
+        }
+      },
       "optional": "необов’язково",
       "pipeline": "Конвеєр",
       "chooseAtRunTime": "Обрати під час запуску",
@@ -2892,7 +2938,8 @@
     "subtitle": {
       "humanReview": "Чекає на огляд коду людиною в PR, повторюючи виправлювача після коментарів",
       "ci": "Блокує PR до зеленого CI, повторюючи виправлювача CI у разі помилки",
-      "conflicts": "Блокує PR до чистого злиття, повторюючи розв'язувача у разі конфліктів"
+      "conflicts": "Блокує PR до чистого злиття, повторюючи розв'язувача у разі конфліктів",
+      "docQuality": "Перевіряє структуру підготовленого документа, повторюючи виправлювача документів у разі проблем"
     },
     "status": {
       "passed": "Пройдено",
@@ -2933,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.88.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",
@@ -34,7 +34,7 @@
     "valibot": "^1.4.2",
     "vue": "^3.5.39",
     "wretch": "^3.0.9",
-    "@cat-factory/contracts": "0.96.0"
+    "@cat-factory/contracts": "0.97.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",