@cat-factory/app 0.119.0 → 0.120.0

package/app/components/board/AddTaskModal.vue

@@ -102,6 +102,13 @@ const isRecurring = computed(() => taskType.value === 'recurring')
 const severity = ref<'low' | 'medium' | 'high' | 'critical' | ''>('')
 const stepsToReproduce = ref('')
 const timeboxHours = ref<number | undefined>(undefined)
+// Spike research criteria — folded into the spike agent's prompt (see the backend `spike` kind).
+const spikeResearchQuestion = ref('')
+const spikeSuccessCriteria = ref('')
+const spikeOptionsToCompare = ref('')
+// Optional in-repo path the findings document is committed to (else `docs/research/<slug>.md`);
+// shares the `taskTypeFields.targetPath` field + its safe-`.md`-path validation with `document`.
+const spikeTargetPath = ref('')
 // `DOC_KINDS` (and the `DocKind` type) are owned by the contracts package — re-exported via
 // `~/types/domain` — so the picker and the create payload can't drift from the backend list.
 const docKind = ref<DocKind | ''>('')
@@ -171,13 +178,21 @@ function buildTypeFields(): TaskTypeFields | undefined {
     return Object.keys(f).length ? f : undefined
   }
   if (taskType.value === 'spike') {
+    const f: TaskTypeFields = {}
     // `v-model.number` on a cleared number input yields '' (not undefined), which would
     // serialise as a non-number and 400 the create — so require a finite number here.
-    return typeof timeboxHours.value === 'number' &&
+    if (
+      typeof timeboxHours.value === 'number' &&
       Number.isFinite(timeboxHours.value) &&
       timeboxHours.value >= 0
-      ? { timeboxHours: timeboxHours.value }
-      : undefined
+    ) {
+      f.timeboxHours = timeboxHours.value
+    }
+    if (spikeResearchQuestion.value.trim()) f.researchQuestion = spikeResearchQuestion.value.trim()
+    if (spikeSuccessCriteria.value.trim()) f.successCriteria = spikeSuccessCriteria.value.trim()
+    if (spikeOptionsToCompare.value.trim()) f.optionsToCompare = spikeOptionsToCompare.value.trim()
+    if (spikeTargetPath.value.trim()) f.targetPath = spikeTargetPath.value.trim()
+    return Object.keys(f).length ? f : undefined
   }
   if (taskType.value === 'document') {
     const f: TaskTypeFields = {}
@@ -406,6 +421,10 @@ watch(open, (isOpen) => {
   severity.value = ''
   stepsToReproduce.value = ''
   timeboxHours.value = undefined
+  spikeResearchQuestion.value = ''
+  spikeSuccessCriteria.value = ''
+  spikeOptionsToCompare.value = ''
+  spikeTargetPath.value = ''
   docKind.value = ''
   docAudience.value = ''
   docTargetPath.value = ''
@@ -451,6 +470,10 @@ const { requestClose } = useUnsavedGuard({
     severity: severity.value,
     stepsToReproduce: stepsToReproduce.value.trim(),
     timeboxHours: timeboxHours.value ?? null,
+    spikeResearchQuestion: spikeResearchQuestion.value.trim(),
+    spikeSuccessCriteria: spikeSuccessCriteria.value.trim(),
+    spikeOptionsToCompare: spikeOptionsToCompare.value.trim(),
+    spikeTargetPath: spikeTargetPath.value.trim(),
     docKind: docKind.value,
     docAudience: docAudience.value.trim(),
     docTargetPath: docTargetPath.value.trim(),
@@ -671,15 +694,58 @@ async function add() {
             </UFormField>
           </div>
 
-          <UFormField v-else-if="taskType === 'spike'" :label="t('board.addTask.timebox')">
-            <UInput
-              v-model.number="timeboxHours"
-              type="number"
-              min="0"
-              :placeholder="t('board.addTask.timeboxPlaceholder')"
-              class="w-full"
-            />
-          </UFormField>
+          <div v-else-if="taskType === 'spike'" class="space-y-3">
+            <UFormField :label="t('board.addTask.timebox')">
+              <UInput
+                v-model.number="timeboxHours"
+                type="number"
+                min="0"
+                :placeholder="t('board.addTask.timeboxPlaceholder')"
+                class="w-full"
+              />
+            </UFormField>
+            <UFormField
+              :label="t('board.addTask.spikeFields.researchQuestion.label')"
+              :hint="t('board.addTask.optional')"
+            >
+              <UInput
+                v-model="spikeResearchQuestion"
+                :placeholder="t('board.addTask.spikeFields.researchQuestion.placeholder')"
+                class="w-full"
+              />
+            </UFormField>
+            <UFormField
+              :label="t('board.addTask.spikeFields.successCriteria.label')"
+              :hint="t('board.addTask.optional')"
+            >
+              <UTextarea
+                v-model="spikeSuccessCriteria"
+                :rows="2"
+                autoresize
+                :placeholder="t('board.addTask.spikeFields.successCriteria.placeholder')"
+                class="w-full"
+              />
+            </UFormField>
+            <UFormField
+              :label="t('board.addTask.spikeFields.optionsToCompare.label')"
+              :hint="t('board.addTask.optional')"
+            >
+              <UTextarea
+                v-model="spikeOptionsToCompare"
+                :rows="2"
+                autoresize
+                :placeholder="t('board.addTask.spikeFields.optionsToCompare.placeholder')"
+                class="w-full"
+              />
+            </UFormField>
+            <UFormField :label="t('board.addTask.targetPath')" :hint="t('board.addTask.optional')">
+              <UInput
+                v-model="spikeTargetPath"
+                :placeholder="t('board.addTask.targetPathPlaceholder')"
+                class="w-full"
+              />
+            </UFormField>
+          </div>
 
           <div v-else-if="taskType === 'document'" class="space-y-3">
             <UFormField :label="t('board.addTask.documentKind')">

package/app/utils/catalog.spec.ts

@@ -17,6 +17,7 @@ const AGENT_KINDS: AgentKind[] = [
   'requirements-brainstorm',
   'architecture-brainstorm',
   'bug-investigator',
+  'spike',
   'task-estimator',
   'architect',
   'researcher',

package/app/utils/catalog.ts

@@ -64,6 +64,19 @@ export const AGENT_ARCHETYPES: AgentArchetype[] = [
       'Read-only, multi-repo codebase investigation that traces the bug to its root cause and decides whether the report is fixable as-is or needs the reporter to clarify (no code changes).',
     resultView: 'generic-structured',
   },
+  {
+    // A timeboxed read-only research/investigation agent. Its structured findings open in the
+    // shared generic viewer; the findings document is committed by a backend post-op (delivered
+    // as a pull request by default, or straight to base via the direct pipeline).
+    kind: 'spike',
+    label: 'Spike',
+    icon: 'i-lucide-flask-conical',
+    color: '#22d3ee',
+    category: 'design',
+    description:
+      'Timeboxed read-only investigation that answers a research question against the context and codebase, and delivers a findings document (as a pull request by default; no code).',
+    resultView: 'generic-structured',
+  },
   {
     kind: 'task-estimator',
     label: 'Task Estimator',

package/i18n/locales/de.json

@@ -2064,6 +2064,20 @@
           "placeholder": "Die Endpoints oder die Oberfläche im Geltungsbereich"
         }
       },
+      "spikeFields": {
+        "researchQuestion": {
+          "label": "Forschungsfrage",
+          "placeholder": "Die Frage oder Hypothese, die der Spike beantworten soll"
+        },
+        "successCriteria": {
+          "label": "Erfolgskriterien",
+          "placeholder": "Die Akzeptanzkriterien oder die Entscheidung, die die Ergebnisse stützen sollen"
+        },
+        "optionsToCompare": {
+          "label": "Zu vergleichende Optionen",
+          "placeholder": "Die gegeneinander abzuwägenden Optionen"
+        }
+      },
       "optional": "optional",
       "pipeline": "Pipeline",
       "chooseAtRunTime": "Zur Laufzeit auswählen",

package/i18n/locales/en.json

@@ -258,6 +258,20 @@
           "placeholder": "The endpoints or surface in scope"
         }
       },
+      "spikeFields": {
+        "researchQuestion": {
+          "label": "Research question",
+          "placeholder": "The question or hypothesis the spike must answer"
+        },
+        "successCriteria": {
+          "label": "Success criteria",
+          "placeholder": "The acceptance criteria or the decision the findings must inform"
+        },
+        "optionsToCompare": {
+          "label": "Options to compare",
+          "placeholder": "The options to weigh against each other"
+        }
+      },
       "optional": "optional",
       "pipeline": "Pipeline",
       "chooseAtRunTime": "Choose at run time",

package/i18n/locales/es.json

@@ -240,6 +240,20 @@
           "placeholder": "Los endpoints o la superficie dentro del alcance"
         }
       },
+      "spikeFields": {
+        "researchQuestion": {
+          "label": "Pregunta de investigación",
+          "placeholder": "La pregunta o hipótesis que el spike debe responder"
+        },
+        "successCriteria": {
+          "label": "Criterios de éxito",
+          "placeholder": "Los criterios de aceptación o la decisión que deben fundamentar los hallazgos"
+        },
+        "optionsToCompare": {
+          "label": "Opciones a comparar",
+          "placeholder": "Las opciones a sopesar entre sí"
+        }
+      },
       "optional": "opcional",
       "pipeline": "Pipeline",
       "chooseAtRunTime": "Elegir al ejecutar",

package/i18n/locales/fr.json

@@ -240,6 +240,20 @@
           "placeholder": "Les endpoints ou la surface concernés"
         }
       },
+      "spikeFields": {
+        "researchQuestion": {
+          "label": "Question de recherche",
+          "placeholder": "La question ou l'hypothèse à laquelle le spike doit répondre"
+        },
+        "successCriteria": {
+          "label": "Critères de réussite",
+          "placeholder": "Les critères d'acceptation ou la décision que les conclusions doivent éclairer"
+        },
+        "optionsToCompare": {
+          "label": "Options à comparer",
+          "placeholder": "Les options à mettre en balance"
+        }
+      },
       "optional": "optionnel",
       "pipeline": "Pipeline",
       "chooseAtRunTime": "Choisir au lancement",

package/i18n/locales/he.json

@@ -240,6 +240,20 @@
           "placeholder": "נקודות הקצה או המשטח שבתחום"
         }
       },
+      "spikeFields": {
+        "researchQuestion": {
+          "label": "שאלת מחקר",
+          "placeholder": "השאלה או ההשערה שעל הספייק לענות עליה"
+        },
+        "successCriteria": {
+          "label": "קריטריוני הצלחה",
+          "placeholder": "קריטריוני הקבלה או ההחלטה שהממצאים צריכים לבסס"
+        },
+        "optionsToCompare": {
+          "label": "אפשרויות להשוואה",
+          "placeholder": "האפשרויות שיש לשקול זו מול זו"
+        }
+      },
       "optional": "אופציונלי",
       "pipeline": "צינור",
       "chooseAtRunTime": "בחר בזמן הריצה",

package/i18n/locales/it.json

@@ -2064,6 +2064,20 @@
           "placeholder": "Gli endpoint o la superficie in ambito"
         }
       },
+      "spikeFields": {
+        "researchQuestion": {
+          "label": "Domanda di ricerca",
+          "placeholder": "La domanda o l'ipotesi a cui lo spike deve rispondere"
+        },
+        "successCriteria": {
+          "label": "Criteri di successo",
+          "placeholder": "I criteri di accettazione o la decisione che i risultati devono supportare"
+        },
+        "optionsToCompare": {
+          "label": "Opzioni da confrontare",
+          "placeholder": "Le opzioni da valutare l'una rispetto all'altra"
+        }
+      },
       "optional": "opzionale",
       "pipeline": "Pipeline",
       "chooseAtRunTime": "Scegli al momento dell'esecuzione",

package/i18n/locales/ja.json

@@ -240,6 +240,20 @@
           "placeholder": "対象となるエンドポイントや範囲"
         }
       },
+      "spikeFields": {
+        "researchQuestion": {
+          "label": "調査課題",
+          "placeholder": "スパイクで答えるべき問いや仮説"
+        },
+        "successCriteria": {
+          "label": "成功基準",
+          "placeholder": "受け入れ基準、または調査結果が判断材料とすべき決定事項"
+        },
+        "optionsToCompare": {
+          "label": "比較する選択肢",
+          "placeholder": "互いに比較検討する選択肢"
+        }
+      },
       "optional": "任意",
       "pipeline": "パイプライン",
       "chooseAtRunTime": "実行時に選択",

package/i18n/locales/pl.json

@@ -240,6 +240,20 @@
           "placeholder": "Endpointy lub zakres objęty dokumentem"
         }
       },
+      "spikeFields": {
+        "researchQuestion": {
+          "label": "Pytanie badawcze",
+          "placeholder": "Pytanie lub hipoteza, na które ma odpowiedzieć spike"
+        },
+        "successCriteria": {
+          "label": "Kryteria sukcesu",
+          "placeholder": "Kryteria akceptacji lub decyzja, którą mają uzasadnić wyniki"
+        },
+        "optionsToCompare": {
+          "label": "Opcje do porównania",
+          "placeholder": "Opcje do rozważenia względem siebie"
+        }
+      },
       "optional": "opcjonalne",
       "pipeline": "Pipeline",
       "chooseAtRunTime": "Wybierz przy uruchomieniu",

package/i18n/locales/tr.json

@@ -240,6 +240,20 @@
           "placeholder": "Kapsamdaki uç noktalar veya yüzey"
         }
       },
+      "spikeFields": {
+        "researchQuestion": {
+          "label": "Araştırma sorusu",
+          "placeholder": "Spike'ın yanıtlaması gereken soru veya hipotez"
+        },
+        "successCriteria": {
+          "label": "Başarı ölçütleri",
+          "placeholder": "Kabul ölçütleri veya bulguların dayanak oluşturması gereken karar"
+        },
+        "optionsToCompare": {
+          "label": "Karşılaştırılacak seçenekler",
+          "placeholder": "Birbirine karşı tartılacak seçenekler"
+        }
+      },
       "optional": "isteğe bağlı",
       "pipeline": "İşlem hattı",
       "chooseAtRunTime": "Çalıştırma sırasında seç",

package/i18n/locales/uk.json

@@ -240,6 +240,20 @@
           "placeholder": "Кінцеві точки або поверхня в межах обсягу"
         }
       },
+      "spikeFields": {
+        "researchQuestion": {
+          "label": "Дослідницьке питання",
+          "placeholder": "Питання або гіпотеза, на які має відповісти спайк"
+        },
+        "successCriteria": {
+          "label": "Критерії успіху",
+          "placeholder": "Критерії приймання або рішення, яке мають обґрунтувати висновки"
+        },
+        "optionsToCompare": {
+          "label": "Опції для порівняння",
+          "placeholder": "Опції, які слід зважити одна проти одної"
+        }
+      },
       "optional": "необов’язково",
       "pipeline": "Конвеєр",
       "chooseAtRunTime": "Обрати під час запуску",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.119.0",
+  "version": "0.120.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.132.0"
+    "@cat-factory/contracts": "0.134.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",