@cat-factory/app 0.44.0 → 0.45.0

package/app/components/board/AddTaskModal.vue

@@ -11,7 +11,8 @@
 // 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, TaskSourceKind, TaskTypeFields } from '~/types/domain'
+import type { CreateTaskType, DocKind, TaskSourceKind, TaskTypeFields } from '~/types/domain'
+import { DOC_KINDS } from '~/types/domain'
 import ContextDocumentPicker from '~/components/documents/ContextDocumentPicker.vue'
 import ContextIssuePicker from '~/components/tasks/ContextIssuePicker.vue'
 import { mergePresetOptionLabel, mergePresetThresholds } from '~/utils/mergePreset'
@@ -64,9 +65,13 @@ const isRecurring = computed(() => taskType.value === 'recurring')
 const severity = ref<'low' | 'medium' | 'high' | 'critical' | ''>('')
 const stepsToReproduce = ref('')
 const timeboxHours = ref<number | undefined>(undefined)
-const docKind = ref<'prd' | 'rfc' | 'runbook' | 'reference' | 'other' | ''>('')
+// `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 | ''>('')
+const docAudience = ref('')
+const docTargetPath = ref('')
+const docOutlineHints = ref('')
 const SEVERITIES = ['low', 'medium', 'high', 'critical'] as const
-const DOC_KINDS = ['prd', 'rfc', 'runbook', 'reference', 'other'] as const
 
 function buildTypeFields(): TaskTypeFields | undefined {
   if (taskType.value === 'bug') {
@@ -85,7 +90,12 @@ function buildTypeFields(): TaskTypeFields | undefined {
       : undefined
   }
   if (taskType.value === 'document') {
-    return docKind.value ? { docKind: docKind.value } : undefined
+    const f: TaskTypeFields = {}
+    if (docKind.value) f.docKind = docKind.value
+    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()
+    return Object.keys(f).length ? f : undefined
   }
   return undefined
 }
@@ -284,6 +294,9 @@ watch(open, (isOpen) => {
   stepsToReproduce.value = ''
   timeboxHours.value = undefined
   docKind.value = ''
+  docAudience.value = ''
+  docTargetPath.value = ''
+  docOutlineHints.value = ''
   mergePresetId.value = ''
   modelPresetId.value = ''
   pipelineId.value = ''
@@ -505,21 +518,47 @@ async function add() {
             />
           </UFormField>
 
-          <UFormField v-else-if="taskType === 'document'" label="Document kind">
-            <div class="flex flex-wrap gap-1">
-              <UButton
-                v-for="k in DOC_KINDS"
-                :key="k"
-                :color="docKind === k ? 'primary' : 'neutral'"
-                :variant="docKind === k ? 'soft' : 'ghost'"
-                size="xs"
-                class="uppercase"
-                @click="docKind = docKind === k ? '' : k"
-              >
-                {{ k }}
-              </UButton>
+          <div v-else-if="taskType === 'document'" class="space-y-3">
+            <UFormField label="Document kind">
+              <div class="flex flex-wrap gap-1">
+                <UButton
+                  v-for="k in DOC_KINDS"
+                  :key="k"
+                  :color="docKind === k ? 'primary' : 'neutral'"
+                  :variant="docKind === k ? 'soft' : 'ghost'"
+                  size="xs"
+                  class="uppercase"
+                  @click="docKind = docKind === k ? '' : k"
+                >
+                  {{ k }}
+                </UButton>
+              </div>
+            </UFormField>
+            <div class="grid grid-cols-2 gap-3">
+              <UFormField label="Audience" hint="optional">
+                <UInput
+                  v-model="docAudience"
+                  placeholder="e.g. platform engineers"
+                  class="w-full"
+                />
+              </UFormField>
+              <UFormField label="Target path" hint="optional">
+                <UInput
+                  v-model="docTargetPath"
+                  placeholder="e.g. docs/rfcs/0001-foo.md"
+                  class="w-full"
+                />
+              </UFormField>
             </div>
-          </UFormField>
+            <UFormField label="Outline hints" hint="optional">
+              <UTextarea
+                v-model="docOutlineHints"
+                :rows="2"
+                placeholder="Sections or points the document should cover"
+                class="w-full"
+              />
+            </UFormField>
+          </div>
 
           <div class="grid grid-cols-2 gap-3">
             <UFormField label="Pipeline">

package/app/types/domain.ts

@@ -22,6 +22,7 @@ export type {
   TaskType,
   CreateTaskType,
   TaskTypeFields,
+  DocKind,
   Block,
   PullRequestRef,
   CloudProvider,
@@ -53,6 +54,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'
+
 /** A draggable agent definition shown in the agent palette. Frontend-only. */
 export interface AgentArchetype {
   kind: AgentKind

package/app/utils/catalog.spec.ts

@@ -28,6 +28,7 @@ const AGENT_KINDS: AgentKind[] = [
   'integrator',
   'architect-companion',
   'spec-companion',
+  'doc-reviewer',
   'playwright',
   'mocker',
   'business-documenter',

package/app/utils/catalog.ts

@@ -251,6 +251,14 @@ export const COMPANION_ARCHETYPES: AgentArchetype[] = [
     description:
       'Reviews the spec — especially acceptance-scenario coverage — rating it and looping the Spec Writer back for automatic rework below the threshold, instead of requiring a human review.',
   },
+  {
+    kind: 'doc-reviewer',
+    label: 'Doc Reviewer',
+    icon: 'i-lucide-file-search',
+    color: '#818cf8',
+    description:
+      'Reviews the drafted document for completeness, clarity, accuracy and structure, looping the Doc Writer back for automatic rework below the threshold.',
+  },
 ]
 
 /**
@@ -262,6 +270,7 @@ export const COMPANION_FOR_PRODUCER: Record<string, AgentKind> = {
   coder: 'reviewer',
   architect: 'architect-companion',
   'spec-writer': 'spec-companion',
+  'doc-writer': 'doc-reviewer',
 }
 
 const COMPANION_KINDS: ReadonlySet<string> = new Set(COMPANION_ARCHETYPES.map((a) => a.kind))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.44.0",
+  "version": "0.45.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 @@
     "pinia-plugin-persistedstate": "^4.7.1",
     "vue": "^3.5.38",
     "wretch": "^3.0.9",
-    "@cat-factory/contracts": "0.41.0"
+    "@cat-factory/contracts": "0.42.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.1",