@cat-factory/app 0.88.0 → 0.89.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/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/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",

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",

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",

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": "בחר בזמן הריצה",

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": "実行時に選択",

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",

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ç",

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": "Обрати під час запуску",

package/package.json

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