@cat-factory/app 0.68.1 → 0.69.0

package/app/components/board/AddTaskModal.vue

@@ -41,6 +41,16 @@ const container = computed(() =>
   ui.addTaskContainerId ? board.getBlock(ui.addTaskContainerId) : undefined,
 )
 
+// The enclosing service frame: the container itself when it's a frame, else its parent
+// frame (a module's parent). Drives which task types are offered — a document repository
+// only authors documents/spikes, so the other kinds are hidden (and rejected server-side).
+const frame = computed(() => {
+  const c = container.value
+  if (!c) return undefined
+  return c.level === 'frame' ? c : c.parentId ? board.getBlock(c.parentId) : undefined
+})
+const isDocRepo = computed(() => frame.value?.type === 'document')
+
 const title = ref('')
 const description = ref('')
 const saving = ref(false)
@@ -53,13 +63,27 @@ const technical = ref(false)
 // delegates to <RecurringPipelineModal> instead of creating a one-off task here.
 type TaskTypeChoice = CreateTaskType | 'recurring'
 const taskType = ref<TaskTypeChoice>('feature')
-const TASK_TYPES = computed<{ value: TaskTypeChoice; label: string; icon: string }[]>(() => [
-  { value: 'feature', label: t('board.addTask.types.feature'), icon: 'i-lucide-sparkles' },
-  { value: 'bug', label: t('board.addTask.types.bug'), icon: 'i-lucide-bug' },
-  { value: 'document', label: t('board.addTask.types.document'), icon: 'i-lucide-file-text' },
-  { value: 'spike', label: t('board.addTask.types.spike'), icon: 'i-lucide-flask-conical' },
-  { value: 'recurring', label: t('board.addTask.types.recurring'), icon: 'i-lucide-repeat' },
-])
+const TASK_TYPES = computed<{ value: TaskTypeChoice; label: string; icon: string }[]>(() => {
+  const all: { value: TaskTypeChoice; label: string; icon: string }[] = [
+    { value: 'feature', label: t('board.addTask.types.feature'), icon: 'i-lucide-sparkles' },
+    { value: 'bug', label: t('board.addTask.types.bug'), icon: 'i-lucide-bug' },
+    { value: 'document', label: t('board.addTask.types.document'), icon: 'i-lucide-file-text' },
+    { value: 'spike', label: t('board.addTask.types.spike'), icon: 'i-lucide-flask-conical' },
+    { value: 'recurring', label: t('board.addTask.types.recurring'), icon: 'i-lucide-repeat' },
+  ]
+  // A document repository only accepts document/spike tasks (see BoardService.addTask).
+  return isDocRepo.value ? all.filter((k) => k.value === 'document' || k.value === 'spike') : all
+})
+// Keep the selection valid when the target is a document repo (default to document).
+watch(
+  isDocRepo,
+  (doc) => {
+    if (doc && taskType.value !== 'document' && taskType.value !== 'spike') {
+      taskType.value = 'document'
+    }
+  },
+  { immediate: true },
+)
 const isRecurring = computed(() => taskType.value === 'recurring')
 
 // Per-type fields (only the ones relevant to the chosen type are shown / sent).
@@ -293,7 +317,10 @@ watch(open, (isOpen) => {
   title.value = ''
   description.value = ''
   saving.value = false
-  taskType.value = 'feature'
+  // This reset runs after the `isDocRepo` watcher in the same open tick, so it must pick the
+  // doc-repo-aware default itself — a document frame only offers document/spike, so `feature`
+  // would leave the selector on a hidden, server-rejected value.
+  taskType.value = isDocRepo.value ? 'document' : 'feature'
   technical.value = false
   severity.value = ''
   stepsToReproduce.value = ''

package/app/components/bootstrap/BootstrapModal.vue

@@ -4,7 +4,7 @@
 // adapt it (in a sandbox container) — either by cloning a chosen reference
 // architecture, or from scratch following a freeform prompt. The modal pairs the
 // launch form with the managed base list.
-import type { BootstrapStatus, ReferenceArchitecture } from '~/types/domain'
+import type { BootstrapStatus, FrameRepoType, ReferenceArchitecture } from '~/types/domain'
 // Explicit import (see GitHubPanel): the auto-import name for github/GitHubConnect
 // doesn't match the `<GitHubConnect>` tag, so bind it directly.
 import GitHubConnect from '~/components/github/GitHubConnect.vue'
@@ -74,6 +74,11 @@ const isPrivate = ref(true)
 const instructions = ref('')
 const launching = ref(false)
 
+// The behavioural repo role for the bootstrapped frame; `service` (backend) by default. The
+// options are shared with the import modal via useFrameRepoTypeItems.
+const selectedType = ref<FrameRepoType>('service')
+const typeItems = useFrameRepoTypeItems()
+
 const usingReference = computed(() => mode.value === 'reference')
 
 // Mirror of the backend `slugField` rule (@cat-factory/contracts bootstrap
@@ -210,6 +215,7 @@ async function launch() {
       description: description.value.trim(),
       private: isPrivate.value,
       instructions: instructions.value.trim(),
+      type: selectedType.value,
     })
     if (job.status === 'failed') {
       // The container couldn't even start (pre-flight failure, e.g. the target
@@ -233,6 +239,8 @@ async function launch() {
       repoName.value = ''
       description.value = ''
       instructions.value = ''
+      // Reset the repo role too, so a later bootstrap doesn't silently inherit this one's type.
+      selectedType.value = 'service'
       // The run is now tracked on the board, so get out of the way: close the
       // dialog as soon as bootstrapping has actually started.
       ui.closeBootstrap()
@@ -469,6 +477,13 @@ const statusLabel = computed<Record<BootstrapStatus, string>>(() => ({
             </div>
           </UFormField>
 
+          <UFormField
+            :label="t('bootstrap.repoType.label')"
+            :description="t('bootstrap.repoType.help')"
+          >
+            <USelect v-model="selectedType" :items="typeItems" value-key="value" class="w-full" />
+          </UFormField>
+
           <UFormField
             :label="t('bootstrap.description.label')"
             :description="t('bootstrap.description.help')"

package/app/components/github/AddServiceFromRepoModal.vue

@@ -11,12 +11,19 @@
 // browses its tree and picks the service's directory before adding (and may add
 // more than one, a subset of the repo's services).
 import { refDebounced } from '@vueuse/core'
+import type { FrameRepoType } from '~/types/domain'
 import GitHubConnect from '~/components/github/GitHubConnect.vue'
 import RepoTreeBrowser from '~/components/github/RepoTreeBrowser.vue'
 import ServiceTestConfig from '~/components/panels/inspector/ServiceTestConfig.vue'
 import ServiceFragments from '~/components/panels/inspector/ServiceFragments.vue'
 
 const { t } = useI18n()
+
+// The behavioural repo role for the imported frame. `service` (backend) is the default so
+// existing muscle memory is unchanged; the options are the four onboardable roles (shared
+// with the bootstrap modal via useFrameRepoTypeItems).
+const selectedType = ref<FrameRepoType>('service')
+const typeItems = useFrameRepoTypeItems()
 const ui = useUiStore()
 const github = useGitHubStore()
 const board = useBoardStore()
@@ -157,6 +164,7 @@ function resetSelection() {
   isMonorepo.value = false
   configuredBlockId.value = undefined
   repoSearch.value = ''
+  selectedType.value = 'service'
 }
 
 // Clear the current repo selection (the combobox's trailing ✕) so the user can pick a
@@ -219,6 +227,7 @@ async function add() {
     const block = await board.addServiceFromRepo(selectedRepoId.value, {
       directory: isMonorepo.value ? selectedDirectory.value : undefined,
       isMonorepo: isMonorepo.value,
+      type: selectedType.value,
     })
     // Refresh the projection so the new repo↔block link is reflected locally.
     await github.load()
@@ -324,6 +333,13 @@ function done() {
             </div>
           </UFormField>
 
+          <UFormField
+            :label="t('github.addService.repoType')"
+            :description="t('github.addService.repoTypeHint')"
+          >
+            <USelect v-model="selectedType" :items="typeItems" value-key="value" class="w-full" />
+          </UFormField>
+
           <!-- monorepo handling: flag + directory picker -->
           <div v-if="selectedRepoId !== undefined" class="space-y-3">
             <USwitch

package/app/composables/useFrameRepoTypeItems.ts

@@ -0,0 +1,29 @@
+import { FRAME_REPO_TYPES } from '@cat-factory/contracts'
+import type { FrameRepoType } from '~/types/domain'
+import { BLOCK_TYPE_META } from '~/utils/catalog'
+
+// One static, typed message key per onboardable repo role. The exhaustive Record means adding
+// a FrameRepoType fails typecheck until it has a label here (the tier-2 dynamic-lookup guard),
+// and keeping the keys as literals lets the i18n drift check see them.
+const REPO_TYPE_LABEL_KEYS: Record<FrameRepoType, string> = {
+  service: 'board.repoTypes.service',
+  frontend: 'board.repoTypes.frontend',
+  library: 'board.repoTypes.library',
+  document: 'board.repoTypes.document',
+}
+
+/**
+ * The repository-type options for the import + bootstrap selectors: one entry per
+ * FRAME_REPO_TYPES role (i18n label + the shared block-type icon). Shared so
+ * AddServiceFromRepoModal and BootstrapModal offer exactly the same set and can't drift.
+ */
+export function useFrameRepoTypeItems() {
+  const { t } = useI18n()
+  return computed(() =>
+    FRAME_REPO_TYPES.map((value) => ({
+      value,
+      label: t(REPO_TYPE_LABEL_KEYS[value]),
+      icon: BLOCK_TYPE_META[value].icon,
+    })),
+  )
+}

package/app/stores/board.ts

@@ -1,7 +1,13 @@
 import { defineStore } from 'pinia'
 import { ref } from 'vue'
 import type { UpdateBlockInput } from '@cat-factory/contracts'
-import type { Block, BlockType, CreateTaskType, TaskTypeFields } from '~/types/domain'
+import type {
+  Block,
+  BlockType,
+  CreateTaskType,
+  FrameRepoType,
+  TaskTypeFields,
+} from '~/types/domain'
 import { useServicesStore } from '~/stores/services'
 import { useWorkspaceStore } from '~/stores/workspace'
 import { useBlockQueries } from '~/composables/useBlockQueries'
@@ -79,12 +85,13 @@ export const useBoardStore = defineStore('board', () => {
    */
   async function addServiceFromRepo(
     repoGithubId: number,
-    opts?: { directory?: string; isMonorepo?: boolean },
+    opts?: { directory?: string; isMonorepo?: boolean; type?: FrameRepoType },
   ): Promise<Block> {
     const block = await api.addServiceFromRepo(useWorkspaceStore().requireId(), {
       repoGithubId,
       ...(opts?.directory ? { directory: opts.directory } : {}),
       ...(opts?.isMonorepo !== undefined ? { isMonorepo: opts.isMonorepo } : {}),
+      ...(opts?.type ? { type: opts.type } : {}),
     })
     upsert(block)
     return block

package/app/types/domain.ts

@@ -18,6 +18,7 @@
 export type {
   BlockStatus,
   BlockType,
+  FrameRepoType,
   BlockLevel,
   TaskType,
   CreateTaskType,

package/app/utils/catalog.spec.ts

@@ -39,6 +39,8 @@ const AGENT_KINDS: AgentKind[] = [
 const BLOCK_TYPES: BlockType[] = [
   'frontend',
   'service',
+  'library',
+  'document',
   'api',
   'database',
   'queue',

package/app/utils/catalog.ts

@@ -519,6 +519,8 @@ type BlockTypeMeta = { label: string; icon: string; accent: string }
 export const BLOCK_TYPE_META: Record<BlockType, BlockTypeMeta> = {
   frontend: { label: 'Frontend', icon: 'i-lucide-monitor', accent: '#60a5fa' },
   service: { label: 'Service', icon: 'i-lucide-server', accent: '#a78bfa' },
+  library: { label: 'Library', icon: 'i-lucide-package', accent: '#f472b6' },
+  document: { label: 'Document repository', icon: 'i-lucide-book-text', accent: '#c084fc' },
   api: { label: 'API', icon: 'i-lucide-route', accent: '#22d3ee' },
   database: { label: 'Database', icon: 'i-lucide-database', accent: '#34d399' },
   queue: { label: 'Queue', icon: 'i-lucide-list-ordered', accent: '#fbbf24' },

package/i18n/locales/en.json

@@ -51,6 +51,12 @@
     "accountSettings": "Account settings"
   },
   "board": {
+    "repoTypes": {
+      "service": "Service",
+      "frontend": "Frontend",
+      "library": "Library",
+      "document": "Document repository"
+    },
     "toolbar": {
       "addService": "Add service",
       "decisionWord": "decision | decisions",
@@ -2184,6 +2190,8 @@
       "connectFirst": "Connect this workspace to GitHub first. Link an installation the App is already on, or install it.",
       "repository": "Repository",
       "repositoryHint": "Repositories the GitHub App can access. Don't see yours? Grant the App access below, then refresh.",
+      "repoType": "Repository type",
+      "repoTypeHint": "What this repo is: a backend service, a frontend app, a shared library, or a document repository (docs/spikes only).",
       "noReposAvailable": "No repositories available yet. Grant the App access to one below, then refresh.",
       "searchPlaceholder": "Search repositories by owner or name…",
       "searchMinChars": "Type at least {min} character to search. | Type at least {min} characters to search.",
@@ -3613,6 +3621,10 @@
       "label": "Grant the App access to this repo",
       "title": "Open the App's installation settings to grant it access to the new repo"
     },
+    "repoType": {
+      "label": "Repository type",
+      "help": "What this repo is: a backend service, a frontend app, a shared library, or a document repository (docs/spikes only)."
+    },
     "description": {
       "label": "Description",
       "help": "Optional one-line summary for the repo."

package/i18n/locales/es.json

@@ -39,6 +39,12 @@
     "infrastructure": "Infraestructura"
   },
   "board": {
+    "repoTypes": {
+      "service": "Servicio",
+      "frontend": "Frontend",
+      "library": "Biblioteca",
+      "document": "Repositorio de documentación"
+    },
     "toolbar": {
       "addService": "Añadir servicio",
       "decisionWord": "decisión | decisiones",
@@ -2146,7 +2152,9 @@
         "addedTitle": "Servicio añadido",
         "addedDescription": "{title} está en el tablero, configúralo abajo.",
         "addFailedTitle": "No se pudo añadir el servicio"
-      }
+      },
+      "repoType": "Tipo de repositorio",
+      "repoTypeHint": "Qué es este repositorio: un servicio backend, una aplicación frontend, una biblioteca compartida o un repositorio de documentación (solo documentos/spikes)."
     },
     "repoTree": {
       "root": "raíz",
@@ -3537,6 +3545,10 @@
       "bootstrapFailed": "No se pudo inicializar",
       "saveArchFailed": "No se pudo guardar la arquitectura de referencia",
       "deleteFailed": "No se pudo eliminar"
+    },
+    "repoType": {
+      "label": "Tipo de repositorio",
+      "help": "Qué es este repositorio: un servicio backend, una aplicación frontend, una biblioteca compartida o un repositorio de documentación (solo documentos/spikes)."
     }
   },
   "mergePreset": {

package/i18n/locales/fr.json

@@ -39,6 +39,12 @@
     "infrastructure": "Infrastructure"
   },
   "board": {
+    "repoTypes": {
+      "service": "Service",
+      "frontend": "Frontend",
+      "library": "Bibliothèque",
+      "document": "Dépôt de documentation"
+    },
     "toolbar": {
       "addService": "Ajouter un service",
       "decisionWord": "décision | décisions",
@@ -2146,7 +2152,9 @@
         "addedTitle": "Service ajouté",
         "addedDescription": "{title} est sur le tableau, configurez-le ci-dessous.",
         "addFailedTitle": "Impossible d'ajouter le service"
-      }
+      },
+      "repoType": "Type de dépôt",
+      "repoTypeHint": "Ce qu'est ce dépôt : un service backend, une application frontend, une bibliothèque partagée ou un dépôt de documentation (documents/spikes uniquement)."
     },
     "repoTree": {
       "root": "racine",
@@ -3537,6 +3545,10 @@
       "bootstrapFailed": "Impossible d'initialiser",
       "saveArchFailed": "Impossible d'enregistrer l'architecture de référence",
       "deleteFailed": "Impossible de supprimer"
+    },
+    "repoType": {
+      "label": "Type de dépôt",
+      "help": "Ce qu'est ce dépôt : un service backend, une application frontend, une bibliothèque partagée ou un dépôt de documentation (documents/spikes uniquement)."
     }
   },
   "mergePreset": {

package/i18n/locales/he.json

@@ -39,6 +39,12 @@
     "accountSettings": "הגדרות חשבון"
   },
   "board": {
+    "repoTypes": {
+      "service": "שירות",
+      "frontend": "פרונט-אנד",
+      "library": "ספרייה",
+      "document": "מאגר תיעוד"
+    },
     "toolbar": {
       "addService": "הוסף שירות",
       "decisionWord": "החלטה | החלטות",
@@ -2157,7 +2163,9 @@
         "addedTitle": "השירות נוסף",
         "addedDescription": "{title} על הלוח, הגדר אותו למטה.",
         "addFailedTitle": "לא ניתן היה להוסיף שירות"
-      }
+      },
+      "repoType": "סוג המאגר",
+      "repoTypeHint": "מה המאגר הזה: שירות בק-אנד, אפליקציית פרונט-אנד, ספרייה משותפת או מאגר תיעוד (מסמכים/ספייקים בלבד)."
     },
     "repoTree": {
       "root": "שורש",
@@ -3548,6 +3556,10 @@
       "bootstrapFailed": "לא ניתן היה לאתחל",
       "saveArchFailed": "לא ניתן היה לשמור ארכיטקטורת ייחוס",
       "deleteFailed": "לא ניתן היה למחוק"
+    },
+    "repoType": {
+      "label": "סוג המאגר",
+      "help": "מה המאגר הזה: שירות בק-אנד, אפליקציית פרונט-אנד, ספרייה משותפת או מאגר תיעוד (מסמכים/ספייקים בלבד)."
     }
   },
   "mergePreset": {

package/i18n/locales/ja.json

@@ -39,6 +39,12 @@
     "accountSettings": "アカウント設定"
   },
   "board": {
+    "repoTypes": {
+      "service": "サービス",
+      "frontend": "フロントエンド",
+      "library": "ライブラリ",
+      "document": "ドキュメントリポジトリ"
+    },
     "toolbar": {
       "addService": "サービスを追加",
       "decisionWord": "決定 | 決定",
@@ -2159,7 +2165,9 @@
         "addedTitle": "サービスを追加しました",
         "addedDescription": "{title}がボードに追加されました。以下で設定してください。",
         "addFailedTitle": "サービスを追加できませんでした"
-      }
+      },
+      "repoType": "リポジトリの種類",
+      "repoTypeHint": "このリポジトリの種類: バックエンドサービス、フロントエンドアプリ、共有ライブラリ、またはドキュメントリポジトリ（ドキュメント/スパイクのみ）。"
     },
     "repoTree": {
       "root": "ルート",
@@ -3550,6 +3558,10 @@
       "bootstrapFailed": "ブートストラップできませんでした",
       "saveArchFailed": "リファレンスアーキテクチャを保存できませんでした",
       "deleteFailed": "削除できませんでした"
+    },
+    "repoType": {
+      "label": "リポジトリの種類",
+      "help": "このリポジトリの種類: バックエンドサービス、フロントエンドアプリ、共有ライブラリ、またはドキュメントリポジトリ（ドキュメント/スパイクのみ）。"
     }
   },
   "mergePreset": {

package/i18n/locales/pl.json

@@ -39,6 +39,12 @@
     "infrastructure": "Infrastruktura"
   },
   "board": {
+    "repoTypes": {
+      "service": "Usługa",
+      "frontend": "Frontend",
+      "library": "Biblioteka",
+      "document": "Repozytorium dokumentacji"
+    },
     "toolbar": {
       "addService": "Dodaj usługę",
       "decisionWord": "decyzja | decyzje | decyzji",
@@ -2146,7 +2152,9 @@
         "addedTitle": "Dodano usługę",
         "addedDescription": "{title} jest na tablicy, skonfiguruj ją poniżej.",
         "addFailedTitle": "Nie udało się dodać usługi"
-      }
+      },
+      "repoType": "Typ repozytorium",
+      "repoTypeHint": "Czym jest to repozytorium: usługą backendową, aplikacją frontendową, współdzieloną biblioteką lub repozytorium dokumentacji (tylko dokumenty/spike'i)."
     },
     "repoTree": {
       "root": "katalog główny",
@@ -3537,6 +3545,10 @@
       "bootstrapFailed": "Nie udało się zainicjować",
       "saveArchFailed": "Nie udało się zapisać architektury referencyjnej",
       "deleteFailed": "Nie udało się usunąć"
+    },
+    "repoType": {
+      "label": "Typ repozytorium",
+      "help": "Czym jest to repozytorium: usługą backendową, aplikacją frontendową, współdzieloną biblioteką lub repozytorium dokumentacji (tylko dokumenty/spike'i)."
     }
   },
   "mergePreset": {

package/i18n/locales/tr.json

@@ -39,6 +39,12 @@
     "accountSettings": "Hesap ayarları"
   },
   "board": {
+    "repoTypes": {
+      "service": "Servis",
+      "frontend": "Frontend",
+      "library": "Kütüphane",
+      "document": "Doküman deposu"
+    },
     "toolbar": {
       "addService": "Servis ekle",
       "decisionWord": "karar | karar",
@@ -2159,7 +2165,9 @@
         "addedTitle": "Servis eklendi",
         "addedDescription": "{title} panoda, aşağıdan yapılandırın.",
         "addFailedTitle": "Servis eklenemedi"
-      }
+      },
+      "repoType": "Depo türü",
+      "repoTypeHint": "Bu deponun türü: bir backend servisi, bir frontend uygulaması, paylaşılan bir kütüphane veya bir doküman deposu (yalnızca doküman/spike)."
     },
     "repoTree": {
       "root": "kök",
@@ -3550,6 +3558,10 @@
       "bootstrapFailed": "Başlatılamadı",
       "saveArchFailed": "Referans mimari kaydedilemedi",
       "deleteFailed": "Silinemedi"
+    },
+    "repoType": {
+      "label": "Depo türü",
+      "help": "Bu deponun türü: bir backend servisi, bir frontend uygulaması, paylaşılan bir kütüphane veya bir doküman deposu (yalnızca doküman/spike)."
     }
   },
   "mergePreset": {

package/i18n/locales/uk.json

@@ -39,6 +39,12 @@
     "infrastructure": "Інфраструктура"
   },
   "board": {
+    "repoTypes": {
+      "service": "Сервіс",
+      "frontend": "Фронтенд",
+      "library": "Бібліотека",
+      "document": "Репозиторій документації"
+    },
     "toolbar": {
       "addService": "Додати сервіс",
       "decisionWord": "рішення | рішення | рішень",
@@ -2146,7 +2152,9 @@
         "addedTitle": "Сервіс додано",
         "addedDescription": "{title} на дошці, налаштуйте його нижче.",
         "addFailedTitle": "Не вдалося додати сервіс"
-      }
+      },
+      "repoType": "Тип репозиторію",
+      "repoTypeHint": "Що це за репозиторій: бекенд-сервіс, фронтенд-застосунок, спільна бібліотека або репозиторій документації (лише документи/спайки)."
     },
     "repoTree": {
       "root": "корінь",
@@ -3537,6 +3545,10 @@
       "bootstrapFailed": "Не вдалося ініціалізувати",
       "saveArchFailed": "Не вдалося зберегти еталонну архітектуру",
       "deleteFailed": "Не вдалося видалити"
+    },
+    "repoType": {
+      "label": "Тип репозиторію",
+      "help": "Що це за репозиторій: бекенд-сервіс, фронтенд-застосунок, спільна бібліотека або репозиторій документації (лише документи/спайки)."
     }
   },
   "mergePreset": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.68.1",
+  "version": "0.69.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.73.0"
+    "@cat-factory/contracts": "0.74.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",