@cat-factory/app 0.178.0 → 0.178.1

package/app/components/documents/DocumentImportModal.vue

@@ -4,12 +4,11 @@ import IntegrationBackTitle from '~/components/layout/IntegrationBackTitle.vue'
 
 // Import pages from a connected document source and pick one to expand into
 // board structure. A source selector lets the user choose which connected source
-// to import from (Confluence, Notion, …). Carries an optional target frame from
-// the inspector so "Preview & spawn" lands the structure inside that frame.
+// to import from (Confluence, Notion, …). "Preview & spawn" always creates new
+// top-level frames — see `SpawnPreviewModal` for why there is no frame target.
 const { t } = useI18n()
 const ui = useUiStore()
 const documents = useDocumentsStore()
-const board = useBoardStore()
 const toast = useToast()
 
 const open = computed({
@@ -20,11 +19,6 @@ const open = computed({
 })
 const back = useIntegrationBack(open)
 
-const targetFrameId = computed(() => ui.documentImport?.targetFrameId ?? null)
-const targetFrameTitle = computed(() =>
-  targetFrameId.value ? board.getBlock(targetFrameId.value)?.title : null,
-)
-
 /** Which connected source we're importing from (defaults to the first). */
 const source = ref<DocumentSourceKind | undefined>(undefined)
 const ref_ = ref('')
@@ -78,7 +72,7 @@ async function doImport() {
 }
 
 function preview(externalId: string) {
-  if (source.value) ui.openSpawnPreview(source.value, externalId, targetFrameId.value)
+  if (source.value) ui.openSpawnPreview(source.value, externalId)
 }
 </script>
 
@@ -106,14 +100,6 @@ function preview(externalId: string) {
       </div>
 
       <div v-else class="space-y-4">
-        <p v-if="targetFrameTitle" class="text-xs text-slate-400">
-          <i18n-t keypath="documents.import.spawningInto" scope="global">
-            <template #frame>
-              <span class="font-medium text-slate-200">{{ targetFrameTitle }}</span>
-            </template>
-          </i18n-t>
-        </p>
-
         <UFormField v-if="sourceItems.length > 1" :label="t('documents.import.sourceLabel')">
           <USelect v-model="source" :items="sourceItems" class="w-full" />
         </UFormField>

package/app/components/documents/DocumentTemplatesModal.vue

@@ -117,7 +117,7 @@ async function unlink(doc: SourceDocument) {
             color="primary"
             variant="soft"
             icon="i-lucide-file-down"
-            @click="ui.openDocumentImport(null)"
+            @click="ui.openDocumentImport()"
           >
             {{ t('documents.templates.importButton') }}
           </UButton>

package/app/components/documents/SpawnPreviewModal.vue

@@ -4,10 +4,16 @@ import type { DocumentBoardPlan } from '~/types/domain'
 // Preview the structure an imported document expands into, then spawn it. The
 // plan is fetched fresh on open; a badge makes clear whether an LLM or the
 // deterministic heading parser produced it.
+//
+// A spawn always creates new top-level frames. The planner's job is to decompose a
+// document into services, so spawning into an existing frame could only flatten the
+// planned frames into it — silently discarding the frame titles and types rendered
+// below, i.e. producing something other than what this preview showed. Scoping a
+// spawn to one service needs a target-aware PLAN (a prompt that yields modules and
+// tasks for an existing service), not a target-aware write.
 const { t } = useI18n()
 const ui = useUiStore()
 const documents = useDocumentsStore()
-const board = useBoardStore()
 const toast = useToast()
 
 const open = computed({
@@ -17,11 +23,6 @@ const open = computed({
   },
 })
 
-const targetFrameId = computed(() => ui.spawnPreview?.targetFrameId ?? null)
-const targetFrameTitle = computed(() =>
-  targetFrameId.value ? board.getBlock(targetFrameId.value)?.title : null,
-)
-
 const plan = ref<DocumentBoardPlan | null>(null)
 const loadingPlan = ref(false)
 const spawning = ref(false)
@@ -54,11 +55,7 @@ async function spawn() {
   if (!preview) return
   spawning.value = true
   try {
-    const result = await documents.spawn(
-      preview.source,
-      preview.externalId,
-      targetFrameId.value ?? undefined,
-    )
+    const result = await documents.spawn(preview.source, preview.externalId)
     toast.add({
       title: t('documents.spawn.spawned'),
       description: t('documents.spawn.summary', {
@@ -100,14 +97,7 @@ async function spawn() {
                 : t('documents.spawn.plannerHeadings')
             }}
           </UBadge>
-          <span v-if="targetFrameTitle" class="text-xs text-slate-400">
-            <i18n-t keypath="documents.spawn.intoFrame" scope="global">
-              <template #frame>
-                <span class="font-medium text-slate-200">{{ targetFrameTitle }}</span>
-              </template>
-            </i18n-t>
-          </span>
-          <span v-else class="text-xs text-slate-400">{{ t('documents.spawn.asTopLevel') }}</span>
+          <span class="text-xs text-slate-400">{{ t('documents.spawn.asTopLevel') }}</span>
         </div>
 
         <div v-if="loadingPlan" class="flex items-center gap-2 text-sm text-slate-400">

package/app/components/layout/CommandBar.vue

@@ -92,7 +92,7 @@ const dynamicIntegrationCommands = computed<Command[]>(() => {
         group: groupIntegrations,
         icon: 'i-lucide-file-down',
         keywords: t('layout.commandBar.keywords.documentImport'),
-        run: () => ui.openDocumentImport(null),
+        run: () => ui.openDocumentImport(),
       })
     }
   }

package/app/components/layout/IntegrationsHub.vue

@@ -176,7 +176,7 @@ const groups = computed<IntegrationGroup[]>(() => {
         icon: 'i-lucide-file-down',
         label: t('layout.integrationsHub.items.documentImport.label'),
         description: t('layout.integrationsHub.items.documentImport.description'),
-        onClick: () => go(() => ui.openDocumentImport(null)),
+        onClick: () => go(() => ui.openDocumentImport()),
       })
     }
     // Per-DocKind template + exemplar links are workspace CONFIG over the imported corpus, not an

package/app/components/panels/InspectorPanel.vue

@@ -12,7 +12,6 @@ const board = useBoardStore()
 const pipelines = usePipelinesStore()
 const execution = useExecutionStore()
 const ui = useUiStore()
-const documents = useDocumentsStore()
 const fragments = useFragmentsStore()
 const agentRuns = useAgentRunsStore()
 const github = useGitHubStore()
@@ -30,13 +29,6 @@ onMounted(() => {
   github.ensureLoaded()
 })
 
-/** Open the document import/spawn flow, targeting this container's frame. */
-function spawnFromDocument() {
-  if (!block.value) return
-  const frameId = isFrame.value ? block.value.id : (board.serviceOf(block.value)?.id ?? null)
-  ui.openDocumentImport(frameId)
-}
-
 const block = computed<Block | undefined>(() =>
   ui.selectedBlockId ? board.getBlock(ui.selectedBlockId) : undefined,
 )
@@ -451,17 +443,8 @@ const showOriginalDescription = ref(false)
         </UButton>
         <!-- Tracker entry points (import an issue, hunt bugs) live on the service frame's
              header, where they are already scoped to a frame — the inspector doesn't
-             duplicate them. -->
-        <UButton
-          v-if="isContainer && documents.available && documents.anyConnected"
-          color="neutral"
-          variant="soft"
-          size="xs"
-          icon="i-lucide-wand-sparkles"
-          @click="spawnFromDocument"
-        >
-          {{ t('panels.inspector.spawnFromDocument') }}
-        </UButton>
+             duplicate them. Document spawn is board-level only (command bar, Integrations
+             hub, templates modal), since planning is target-blind. -->
       </div>
 
       <!-- service (frame): navigate the prescriptive spec tree (+ Gherkin scenarios when

package/app/stores/documents.ts

@@ -106,12 +106,15 @@ export const useDocumentsStore = defineStore('documents', () => {
     return api.planDocument(workspace.requireId(), source, externalId)
   }
 
-  /** Apply a page's structure to the board, then refresh the board snapshot. */
-  async function spawn(source: DocumentSourceKind, externalId: string, frameId?: string) {
-    const { result } = await api.spawnDocument(workspace.requireId(), source, {
-      externalId,
-      frameId,
-    })
+  /**
+   * Apply a page's structure to the board as new top-level frames, then refresh the
+   * board snapshot. The endpoint also accepts a `frameId` that flattens the planned
+   * frames into an existing service; the SPA deliberately never sends one, because the
+   * planner is target-blind and that path discards the frame titles/types the preview
+   * shows. Scoping a spawn to a service needs a target-aware plan first.
+   */
+  async function spawn(source: DocumentSourceKind, externalId: string) {
+    const { result } = await api.spawnDocument(workspace.requireId(), source, { externalId })
     await workspace.refresh()
     return result
   }

package/app/stores/ui/modals.ts

@@ -156,23 +156,20 @@ function createMiscModals() {
  * came-from markers (they can be reached from the Integrations hub).
  */
 function createDocumentTaskModals(resetHubReturn: ResetHubReturn) {
-  // Document-source integration modals, keyed by source. `documentImport` and
-  // `spawnPreview` carry an optional target frame, so structure spawned from a
-  // frame's inspector lands inside that frame rather than creating new top-level
-  // frames. `documentConnect` carries the source whose connect form to show;
-  // `documentImport`'s source may be null to let the modal pick a connected one.
+  // Document-source integration modals, keyed by source. A spawn always creates new
+  // top-level frames: the planner decomposes a document into services, so spawning
+  // into an existing frame could only flatten those away (discarding the frame titles
+  // and types the preview shows). `documentConnect` carries the source whose connect
+  // form to show; `documentImport`'s source may be null to let the modal pick a
+  // connected one.
   const documentConnect = ref<{ source: DocumentSourceKind } | null>(null)
-  const documentImport = ref<{
-    source: DocumentSourceKind | null
-    targetFrameId: string | null
-  } | null>(null)
+  const documentImport = ref<{ source: DocumentSourceKind | null } | null>(null)
   // The workspace+DocKind template / exemplar management modal (WS1). A single boolean —
   // it manages every kind's links in one place.
   const documentTemplates = ref(false)
   const spawnPreview = ref<{
     source: DocumentSourceKind
     externalId: string
-    targetFrameId: string | null
   } | null>(null)
 
   // Task-source integration modals, keyed by source. `taskConnect` carries the
@@ -222,12 +219,9 @@ function createDocumentTaskModals(resetHubReturn: ResetHubReturn) {
   function closeDocumentConnect() {
     documentConnect.value = null
   }
-  function openDocumentImport(
-    targetFrameId: string | null = null,
-    source: DocumentSourceKind | null = null,
-  ) {
+  function openDocumentImport(source: DocumentSourceKind | null = null) {
     resetHubReturn()
-    documentImport.value = { source, targetFrameId }
+    documentImport.value = { source }
   }
   function closeDocumentImport() {
     documentImport.value = null
@@ -239,12 +233,8 @@ function createDocumentTaskModals(resetHubReturn: ResetHubReturn) {
   function closeDocumentTemplates() {
     documentTemplates.value = false
   }
-  function openSpawnPreview(
-    source: DocumentSourceKind,
-    externalId: string,
-    targetFrameId: string | null = null,
-  ) {
-    spawnPreview.value = { source, externalId, targetFrameId }
+  function openSpawnPreview(source: DocumentSourceKind, externalId: string) {
+    spawnPreview.value = { source, externalId }
   }
   function closeSpawnPreview() {
     spawnPreview.value = null

package/i18n/locales/de.json

@@ -1711,7 +1711,6 @@
       "lastIncorporatedRequirements": "Zuletzt eingearbeitete Anforderungen",
       "priorDocHint": "Aus der vorherigen Prüfung. Verwende es als Basis: bearbeite die Beschreibung oben und reiche erneut ein.",
       "bootstrapping": "Wird initialisiert…",
-      "spawnFromDocument": "Aus Dokument erzeugen",
       "viewRequirements": "Anforderungen anzeigen",
       "reRun": "Erneut ausführen",
       "run": "Ausführen",
@@ -3286,7 +3285,6 @@
       "title": "Aus einer Dokumentquelle importieren",
       "connectFirst": "Verbinden Sie zuerst eine Dokumentquelle.",
       "connectSource": "{source} verbinden",
-      "spawningInto": "Wird in {frame} erzeugt",
       "sourceLabel": "Quelle",
       "refLabel": "Seiten-URL oder -ID",
       "importButton": "Importieren",
@@ -3311,7 +3309,6 @@
       "title": "Struktur-Vorschau",
       "plannerLlm": "KI-generiert",
       "plannerHeadings": "Aus Überschriften",
-      "intoFrame": "in {frame}",
       "asTopLevel": "als neue Frames auf oberster Ebene",
       "buildingPlan": "Plan wird erstellt…",
       "spawnOntoBoard": "Auf dem Board erzeugen",

package/i18n/locales/en.json

@@ -1433,7 +1433,6 @@
       "lastIncorporatedRequirements": "Last incorporated requirements",
       "priorDocHint": "From the previous review. Use it as a base: edit the description above and resubmit.",
       "bootstrapping": "Bootstrapping…",
-      "spawnFromDocument": "Spawn from document",
       "viewRequirements": "View Requirements",
       "reRun": "Re-run",
       "run": "Run",
@@ -3706,7 +3705,6 @@
       "title": "Import from a document source",
       "connectFirst": "Connect a document source first.",
       "connectSource": "Connect {source}",
-      "spawningInto": "Spawning into {frame}",
       "sourceLabel": "Source",
       "refLabel": "Page URL or ID",
       "importButton": "Import",
@@ -3731,7 +3729,6 @@
       "title": "Preview structure",
       "plannerLlm": "AI-generated",
       "plannerHeadings": "From headings",
-      "intoFrame": "into {frame}",
       "asTopLevel": "as new top-level frames",
       "buildingPlan": "Building plan…",
       "spawnOntoBoard": "Spawn onto board",

package/i18n/locales/es.json

@@ -1347,7 +1347,6 @@
       "lastIncorporatedRequirements": "Últimos requisitos incorporados",
       "priorDocHint": "De la revisión anterior. Úsalo como base: edita la descripción de arriba y reenvíala.",
       "bootstrapping": "Inicializando…",
-      "spawnFromDocument": "Generar desde documento",
       "viewRequirements": "Ver requisitos",
       "reRun": "Reejecutar",
       "run": "Ejecutar",
@@ -3598,7 +3597,6 @@
       "title": "Importar desde una fuente de documentos",
       "connectFirst": "Conecta primero una fuente de documentos.",
       "connectSource": "Conectar {source}",
-      "spawningInto": "Generando dentro de {frame}",
       "sourceLabel": "Fuente",
       "refLabel": "URL o ID de la página",
       "importButton": "Importar",
@@ -3623,7 +3621,6 @@
       "title": "Previsualizar estructura",
       "plannerLlm": "Generado por IA",
       "plannerHeadings": "A partir de los encabezados",
-      "intoFrame": "en {frame}",
       "asTopLevel": "como nuevos marcos de nivel superior",
       "buildingPlan": "Creando el plan…",
       "spawnOntoBoard": "Generar en el tablero",

package/i18n/locales/fr.json

@@ -1347,7 +1347,6 @@
       "lastIncorporatedRequirements": "Dernières exigences intégrées",
       "priorDocHint": "Issu de la revue précédente. Utilisez-le comme base : modifiez la description ci-dessus et resoumettez.",
       "bootstrapping": "Initialisation…",
-      "spawnFromDocument": "Créer à partir d'un document",
       "viewRequirements": "Voir les exigences",
       "reRun": "Relancer",
       "run": "Exécuter",
@@ -3598,7 +3597,6 @@
       "title": "Importer depuis une source de documents",
       "connectFirst": "Connectez d'abord une source de documents.",
       "connectSource": "Connecter {source}",
-      "spawningInto": "Génération dans {frame}",
       "sourceLabel": "Source",
       "refLabel": "URL ou ID de la page",
       "importButton": "Importer",
@@ -3623,7 +3621,6 @@
       "title": "Aperçu de la structure",
       "plannerLlm": "Généré par l'IA",
       "plannerHeadings": "À partir des titres",
-      "intoFrame": "dans {frame}",
       "asTopLevel": "en nouveaux cadres de premier niveau",
       "buildingPlan": "Création du plan…",
       "spawnOntoBoard": "Générer sur le tableau",

package/i18n/locales/he.json

@@ -1347,7 +1347,6 @@
       "lastIncorporatedRequirements": "הדרישות האחרונות ששולבו",
       "priorDocHint": "מהסקירה הקודמת. השתמש בו כבסיס: ערוך את התיאור למעלה ושלח מחדש.",
       "bootstrapping": "מאתחל…",
-      "spawnFromDocument": "צור ממסמך",
       "viewRequirements": "הצג דרישות",
       "reRun": "הרץ מחדש",
       "run": "הרץ",
@@ -3609,7 +3608,6 @@
       "title": "ייבא ממקור מסמכים",
       "connectFirst": "חבר תחילה מקור מסמכים.",
       "connectSource": "חבר את {source}",
-      "spawningInto": "יוצר בתוך {frame}",
       "sourceLabel": "מקור",
       "refLabel": "כתובת URL או מזהה של דף",
       "importButton": "ייבא",
@@ -3634,7 +3632,6 @@
       "title": "תצוגה מקדימה של מבנה",
       "plannerLlm": "נוצר ע״י AI",
       "plannerHeadings": "מתוך כותרות",
-      "intoFrame": "לתוך {frame}",
       "asTopLevel": "כמסגרות חדשות ברמה העליונה",
       "buildingPlan": "בונה תוכנית…",
       "spawnOntoBoard": "צור על הלוח",

package/i18n/locales/it.json

@@ -1711,7 +1711,6 @@
       "lastIncorporatedRequirements": "Ultimi requisiti incorporati",
       "priorDocHint": "Dalla revisione precedente. Usalo come base: modifica la descrizione sopra e reinvia.",
       "bootstrapping": "Bootstrap in corso…",
-      "spawnFromDocument": "Genera da documento",
       "viewRequirements": "Visualizza requisiti",
       "reRun": "Riesegui",
       "run": "Esegui",
@@ -3286,7 +3285,6 @@
       "title": "Importa da una sorgente di documenti",
       "connectFirst": "Collega prima una sorgente di documenti.",
       "connectSource": "Collega {source}",
-      "spawningInto": "Generazione in {frame}",
       "sourceLabel": "Sorgente",
       "refLabel": "URL o ID della pagina",
       "importButton": "Importa",
@@ -3311,7 +3309,6 @@
       "title": "Anteprima struttura",
       "plannerLlm": "Generato dall'AI",
       "plannerHeadings": "Dai titoli",
-      "intoFrame": "in {frame}",
       "asTopLevel": "come nuovi frame di primo livello",
       "buildingPlan": "Creazione del piano…",
       "spawnOntoBoard": "Genera sulla board",

package/i18n/locales/ja.json

@@ -1347,7 +1347,6 @@
       "lastIncorporatedRequirements": "最後に取り込まれた要件",
       "priorDocHint": "前回のレビューより。これをベースに、上の説明を編集して再送信してください。",
       "bootstrapping": "ブートストラップ中…",
-      "spawnFromDocument": "ドキュメントから生成",
       "viewRequirements": "要件を表示",
       "reRun": "再実行",
       "run": "実行",
@@ -3610,7 +3609,6 @@
       "title": "ドキュメントソースからインポート",
       "connectFirst": "先にドキュメントソースを接続してください。",
       "connectSource": "{source} を接続",
-      "spawningInto": "{frame} に生成中",
       "sourceLabel": "ソース",
       "refLabel": "ページの URL または ID",
       "importButton": "インポート",
@@ -3635,7 +3633,6 @@
       "title": "構造をプレビュー",
       "plannerLlm": "AI 生成",
       "plannerHeadings": "見出しから",
-      "intoFrame": "{frame} に",
       "asTopLevel": "新しいトップレベルフレームとして",
       "buildingPlan": "プランを作成中…",
       "spawnOntoBoard": "ボードに生成",

package/i18n/locales/pl.json

@@ -1347,7 +1347,6 @@
       "lastIncorporatedRequirements": "Ostatnie włączone wymagania",
       "priorDocHint": "Z poprzedniej recenzji. Użyj go jako bazy: edytuj opis powyżej i prześlij ponownie.",
       "bootstrapping": "Inicjowanie…",
-      "spawnFromDocument": "Utwórz z dokumentu",
       "viewRequirements": "Wyświetl wymagania",
       "reRun": "Uruchom ponownie",
       "run": "Uruchom",
@@ -3598,7 +3597,6 @@
       "title": "Importuj ze źródła dokumentów",
       "connectFirst": "Najpierw połącz źródło dokumentów.",
       "connectSource": "Połącz {source}",
-      "spawningInto": "Tworzenie w {frame}",
       "sourceLabel": "Źródło",
       "refLabel": "Adres URL lub identyfikator strony",
       "importButton": "Importuj",
@@ -3623,7 +3621,6 @@
       "title": "Podgląd struktury",
       "plannerLlm": "Wygenerowane przez SI",
       "plannerHeadings": "Na podstawie nagłówków",
-      "intoFrame": "do {frame}",
       "asTopLevel": "jako nowe ramki najwyższego poziomu",
       "buildingPlan": "Tworzenie planu…",
       "spawnOntoBoard": "Utwórz na tablicy",

package/i18n/locales/tr.json

@@ -1347,7 +1347,6 @@
       "lastIncorporatedRequirements": "Son dahil edilen gereksinimler",
       "priorDocHint": "Önceki incelemeden. Bir temel olarak kullanın: yukarıdaki açıklamayı düzenleyip yeniden gönderin.",
       "bootstrapping": "Önyükleniyor…",
-      "spawnFromDocument": "Belgeden oluştur",
       "viewRequirements": "Gereksinimleri Görüntüle",
       "reRun": "Yeniden çalıştır",
       "run": "Çalıştır",
@@ -3610,7 +3609,6 @@
       "title": "Bir belge kaynağından içe aktar",
       "connectFirst": "Önce bir belge kaynağı bağla.",
       "connectSource": "{source} bağla",
-      "spawningInto": "{frame} içine oluşturuluyor",
       "sourceLabel": "Kaynak",
       "refLabel": "Sayfa URL'si veya ID'si",
       "importButton": "İçe aktar",
@@ -3635,7 +3633,6 @@
       "title": "Yapıyı önizle",
       "plannerLlm": "Yapay zeka tarafından oluşturuldu",
       "plannerHeadings": "Başlıklardan",
-      "intoFrame": "{frame} içine",
       "asTopLevel": "yeni üst düzey çerçeveler olarak",
       "buildingPlan": "Plan oluşturuluyor…",
       "spawnOntoBoard": "Panoya oluştur",

package/i18n/locales/uk.json

@@ -1347,7 +1347,6 @@
       "lastIncorporatedRequirements": "Останні внесені вимоги",
       "priorDocHint": "З попереднього огляду. Використайте його як основу: відредагуйте опис вище та надішліть повторно.",
       "bootstrapping": "Ініціалізація…",
-      "spawnFromDocument": "Створити з документа",
       "viewRequirements": "Переглянути вимоги",
       "reRun": "Перезапустити",
       "run": "Запустити",
@@ -3598,7 +3597,6 @@
       "title": "Імпорт із джерела документів",
       "connectFirst": "Спершу підключіть джерело документів.",
       "connectSource": "Підключити {source}",
-      "spawningInto": "Створення в {frame}",
       "sourceLabel": "Джерело",
       "refLabel": "URL або ідентифікатор сторінки",
       "importButton": "Імпортувати",
@@ -3623,7 +3621,6 @@
       "title": "Перегляд структури",
       "plannerLlm": "Згенеровано ШІ",
       "plannerHeadings": "За заголовками",
-      "intoFrame": "до {frame}",
       "asTopLevel": "як нові фрейми верхнього рівня",
       "buildingPlan": "Створення плану…",
       "spawnOntoBoard": "Створити на дошці",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.178.0",
+  "version": "0.178.1",
   "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",
@@ -40,7 +40,7 @@
     "valibot": "^1.4.2",
     "vue": "3.5.40",
     "wretch": "^3.0.9",
-    "@cat-factory/contracts": "0.187.0"
+    "@cat-factory/contracts": "0.188.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",