@cat-factory/app 0.296.0 → 0.296.2

package/app/components/bootstrap/BootstrapModal.logic.spec.ts

@@ -1,11 +1,13 @@
 import { describe, expect, it } from 'vitest'
 import {
   defaultBootstrapDelivery,
+  referenceRefusalOf,
+  referenceRefusalSurvivesSave,
   serviceDirectoryLeaf,
   serviceDirectoryParent,
 } from '~/components/bootstrap/BootstrapModal.logic'
 
-// The rule these two pin is what makes the field browsable AND typable at once: the tree hands
+// The rule the first two pin is what makes the field browsable AND typable at once: the tree hands
 // back the folder it was standing in plus the leaf, so a name someone typed has to survive a
 // trip through the tree. Reading the leaf off the service name instead would silently discard it.
 
@@ -43,6 +45,79 @@ describe('serviceDirectoryParent', () => {
   })
 })
 
+// The refusal a launch can come back with. Both halves are read off ONE wire envelope and the
+// stakes are the same in either direction: a banner that is dropped while it is still true takes
+// away the only pointer to the broken entry, and one kept after it is fixed reads as a live error.
+describe('referenceRefusalOf', () => {
+  /** The envelope shape the contract client throws, as `apiErrorEnvelope` reads it. */
+  const failure = (details: Record<string, unknown>) => ({ body: { error: { details } } })
+
+  it('reads the reason and the two fields that name the offending entry', () => {
+    expect(
+      referenceRefusalOf(
+        failure({
+          reason: 'reference_repo_not_found',
+          referenceArchitectureId: 'ref_1',
+          repo: 'acme/service-template',
+        }),
+      ),
+    ).toEqual({
+      reason: 'reference_repo_not_found',
+      architectureId: 'ref_1',
+      repo: 'acme/service-template',
+    })
+  })
+
+  it('keeps the two reasons apart, since only one of them means the entry is wrong', () => {
+    expect(referenceRefusalOf(failure({ reason: 'reference_repo_unreadable' }))?.reason).toBe(
+      'reference_repo_unreadable',
+    )
+  })
+
+  it('is null for every other failure, so an unrelated error never shows this banner', () => {
+    expect(referenceRefusalOf(failure({ reason: 'github_not_connected' }))).toBeNull()
+    expect(referenceRefusalOf(failure({}))).toBeNull()
+    expect(referenceRefusalOf(new Error('network down'))).toBeNull()
+    expect(referenceRefusalOf(undefined)).toBeNull()
+  })
+
+  it('answers null for the ids rather than trusting whatever the field held', () => {
+    // The refusal drives a jump to one entry, so a non-string id must not reach the lookup as one.
+    expect(
+      referenceRefusalOf(
+        failure({ reason: 'reference_repo_not_found', referenceArchitectureId: 7, repo: null }),
+      ),
+    ).toEqual({ reason: 'reference_repo_not_found', architectureId: null, repo: null })
+  })
+})
+
+describe('referenceRefusalSurvivesSave', () => {
+  const refusal = {
+    reason: 'reference_repo_not_found',
+    architectureId: 'ref_1',
+    repo: 'acme/service-template',
+  } as const
+
+  it('is cleared by saving the entry it named: that entry no longer reads the way it did', () => {
+    expect(referenceRefusalSurvivesSave('ref_1', refusal)).toBe(false)
+  })
+
+  it('survives an edit to a DIFFERENT entry, which changed nothing about this claim', () => {
+    expect(referenceRefusalSurvivesSave('ref_2', refusal)).toBe(true)
+  })
+
+  it('survives CREATING an entry beside the refused one', () => {
+    // The case that lost the banner: adding an architecture while the refused one is still
+    // selected and still unreachable, so the next launch fails again with nothing pointing at it.
+    expect(referenceRefusalSurvivesSave(null, refusal)).toBe(true)
+    expect(referenceRefusalSurvivesSave(undefined, refusal)).toBe(true)
+  })
+
+  it('has nothing to survive when no refusal stands', () => {
+    expect(referenceRefusalSurvivesSave('ref_1', null)).toBe(false)
+  })
+})
+
 describe('defaultBootstrapDelivery', () => {
   it('reviews a monorepo and pushes a repository being created', () => {
     // The form has to SHOW the default it is about to send, and the two targets want opposite

package/app/components/bootstrap/BootstrapModal.logic.ts

@@ -1,12 +1,14 @@
+import type { BootstrapReferenceReason } from '@cat-factory/contracts'
+import { apiErrorEnvelope, apiErrorReason } from '~/composables/api/errors'
 import type { BootstrapDelivery } from '~/types/domain'
 import { repoPathSegments } from '~/utils/repoPath'
 
-// The pure half of the bootstrap launch form's monorepo service-directory field. That field
-// holds one string but carries two decisions: what the new directory is CALLED and WHERE in the
-// repo it sits. Browsing the repo tree answers only the second, so it rewrites the parent and
-// keeps the leaf, which means both halves have to be readable off the typed value on their own.
-// Extracted for the reason every `*.logic.ts` here is: a decision worth a test should not need a
-// mounted component to reach.
+// The pure half of the bootstrap launch form: the monorepo service-directory field, the delivery
+// default, and the refusal a launch can come back with. The directory field holds one string but
+// carries two decisions: what the new directory is CALLED and WHERE in the repo it sits. Browsing
+// the repo tree answers only the second, so it rewrites the parent and keeps the leaf, which means
+// both halves have to be readable off the typed value on their own. Extracted for the reason every
+// `*.logic.ts` here is: a decision worth a test should not need a mounted component to reach.
 
 /**
  * What the new directory is called: the last segment of the typed path.
@@ -42,3 +44,50 @@ export function serviceDirectoryParent(directory: string): string {
 export function defaultBootstrapDelivery(intoMonorepo: boolean): BootstrapDelivery {
   return intoMonorepo ? 'pull_request' : 'direct_push'
 }
+
+/** A launch the backend refused because of the reference architecture it named. */
+export interface ReferenceRefusal {
+  reason: BootstrapReferenceReason
+  /** The entry that named the repository, so the fix opens the right one of several. */
+  architectureId: string | null
+  /** `owner/name` as the entry spells it. */
+  repo: string | null
+}
+
+/**
+ * The refusal a failed launch carries, or null when it failed for anything else.
+ *
+ * The reason comes from the shared `apiErrorReason`, never a second hand-rolled read of the same
+ * wire field: that helper is what keeps a renamed code a typecheck failure here instead of a
+ * silent fall-through to the generic toast. The envelope is read directly only for the two extra
+ * fields this refusal carries, which no shared accessor knows about.
+ */
+export function referenceRefusalOf(error: unknown): ReferenceRefusal | null {
+  const reason = apiErrorReason(error)
+  if (reason !== 'reference_repo_not_found' && reason !== 'reference_repo_unreadable') return null
+  const details = (apiErrorEnvelope(error)?.details ?? {}) as Record<string, unknown>
+  return {
+    reason,
+    architectureId:
+      typeof details.referenceArchitectureId === 'string' ? details.referenceArchitectureId : null,
+    repo: typeof details.repo === 'string' ? details.repo : null,
+  }
+}
+
+/**
+ * Whether saving a reference architecture makes a standing refusal stale.
+ *
+ * Only the entry the refusal NAMED: that one has been rewritten, so the refusal no longer
+ * describes it, and whether the new value is reachable is the next launch's question. Every other
+ * save leaves it alone. Clearing on any save is the bug this answers: adding a second
+ * architecture, or editing an unrelated one, dropped the banner while the refused entry was still
+ * selected and still unreachable, taking away the one affordance pointing at the problem.
+ */
+export function referenceRefusalSurvivesSave(
+  /** The entry that was saved, or null/undefined when the save CREATED a new one. */
+  savedArchitectureId: string | null | undefined,
+  refusal: ReferenceRefusal | null,
+): boolean {
+  if (!refusal) return false
+  return !savedArchitectureId || savedArchitectureId !== refusal.architectureId
+}

package/app/components/bootstrap/BootstrapModal.vue

@@ -12,6 +12,9 @@ import type {
 } from '~/types/domain'
 import {
   defaultBootstrapDelivery,
+  type ReferenceRefusal,
+  referenceRefusalOf,
+  referenceRefusalSurvivesSave,
   serviceDirectoryLeaf,
   serviceDirectoryParent,
 } from '~/components/bootstrap/BootstrapModal.logic'
@@ -243,6 +246,49 @@ const selectedArch = computed(() =>
   bootstrap.architectures.find((a) => a.id === selectedArchId.value),
 )
 
+// ---- a launch refused for its reference architecture -----------------------
+// The backend pre-flights the template against the workspace's source-control connection BEFORE
+// it records anything, so this refusal costs the user nothing except a correction: the run does
+// not exist, the board has no card, and every other field of this form is still filled in. That
+// is what the alert is for. A toast would say the same words and then disappear, leaving the
+// person to work out which of the two repositories in this dialog was the problem. Reading it off
+// the wire, and deciding when a save makes it stale, are in `BootstrapModal.logic.ts`.
+const referenceRefusal = ref<ReferenceRefusal | null>(null)
+
+const referenceRefusalMessage = computed(() => {
+  const refusal = referenceRefusal.value
+  if (!refusal) return ''
+  const repo = refusal.repo ?? t('bootstrap.reference.refusal.unnamedRepo')
+  return refusal.reason === 'reference_repo_not_found'
+    ? t('bootstrap.reference.refusal.notFound', { repo })
+    : t('bootstrap.reference.refusal.unreadable', { repo })
+})
+
+/**
+ * Whether correcting the ENTRY is the fix. Only for `not_found`: an unreadable probe says nothing
+ * about the entry, so offering to edit it there would send someone to change a value that is
+ * very likely already right.
+ */
+const referenceRefusalIsFixable = computed(
+  () => referenceRefusal.value?.reason === 'reference_repo_not_found',
+)
+
+/** Open the refused entry's edit form, prefilled, leaving the launch form untouched. */
+function editRefusedArchitecture() {
+  const id = referenceRefusal.value?.architectureId
+  const arch = bootstrap.architectures.find((a) => a.id === id)
+  if (arch) startEdit(arch)
+}
+
+// A refusal is about ONE entry as it was, so picking a different reference architecture makes it
+// stale, and a stale error banner reads as a live one. Reopening the dialog clears it for the same
+// reason: the form deliberately keeps its fields across opens, but a refusal is not a field, it is
+// a claim about a check that has not been made again. Saving the refused entry clears it too
+// (`saveArch`), and saving any other one deliberately does not.
+watch([open, selectedArchId], () => {
+  referenceRefusal.value = null
+})
+
 const archOptions = computed(() =>
   bootstrap.architectures.map((a) => ({
     label: `${a.name} · ${a.repoOwner}/${a.repoName}`,
@@ -433,6 +479,10 @@ async function launch() {
       ui.closeBootstrap()
     }
   } catch (e) {
+    // A reference-architecture refusal is kept on the form as well as toasted: the run was never
+    // recorded, so what the user needs is the one field to change and everything else left alone,
+    // which a toast cannot hold still long enough to give them.
+    referenceRefusal.value = referenceRefusalOf(e)
     present(e, 'bootstrap.toast.bootstrapFailed')
   } finally {
     launching.value = false
@@ -513,8 +563,12 @@ async function saveArch() {
       description: archForm.value.description.trim(),
       defaultInstructions: archForm.value.defaultInstructions.trim(),
     }
-    if (archForm.value.id) await bootstrap.updateArchitecture(archForm.value.id, body)
+    const editedId = archForm.value.id
+    if (editedId) await bootstrap.updateArchitecture(editedId, body)
     else await bootstrap.createArchitecture(body)
+    if (!referenceRefusalSurvivesSave(editedId, referenceRefusal.value)) {
+      referenceRefusal.value = null
+    }
     showArchForm.value = false
     archForm.value = blankForm()
     archRepoSlug.value = undefined
@@ -706,6 +760,31 @@ const statusLabel = computed<Record<BootstrapStatus, string>>(() => ({
                 class="w-full"
               />
             </UFormField>
+
+            <!-- The launch was refused for the template, before anything was recorded. The
+                 remedy lives in this same dialog, so the alert carries the jump to it rather
+                 than describing where to go. -->
+            <UAlert
+              v-if="referenceRefusal"
+              color="error"
+              variant="subtle"
+              icon="i-lucide-triangle-alert"
+              :title="t('bootstrap.reference.refusal.title')"
+              :description="referenceRefusalMessage"
+              data-testid="bootstrap-reference-refusal"
+            >
+              <template v-if="referenceRefusalIsFixable" #actions>
+                <UButton
+                  color="error"
+                  variant="soft"
+                  size="xs"
+                  icon="i-lucide-pencil"
+                  @click="editRefusedArchitecture"
+                >
+                  {{ t('bootstrap.reference.refusal.edit') }}
+                </UButton>
+              </template>
+            </UAlert>
           </template>
 
           <UFormField

package/app/components/settings/OpenRouterCatalogPanel.vue

@@ -30,13 +30,17 @@ const back = useIntegrationBack(open)
 // Popular slugs offered by "Enable recommended" — these mirror the curated `openrouter`
 // refs in the backend MODEL_CATALOG. Only the ones present in the live browse list are
 // ticked, so a recommendation never enables a slug OpenRouter doesn't actually serve.
+// The contributor tier of Muse Spark is deliberately absent: it is cheaper because Meta
+// trains on the traffic, and a one-click "enable recommended" is the wrong place to make
+// that trade on somebody's behalf.
 const RECOMMENDED_SLUGS = [
-  'anthropic/claude-fable-5',
+  'anthropic/claude-fable-5.1',
   'anthropic/claude-opus-5',
   'openai/gpt-5.6-sol',
   'openai/gpt-5.6-terra',
   'google/gemini-3.1-pro-preview',
-  'google/gemini-3.6-flash',
+  'google/gemini-3.8-flash',
+  'meta/muse-spark-1.3',
   'deepseek/deepseek-v4-flash',
   'moonshotai/kimi-k2.7-code',
   'z-ai/glm-5.2',

package/app/composables/usePipelineErrorToast.spec.ts

@@ -5,6 +5,7 @@ import {
   describeGenericFailure,
 } from '~/composables/usePipelineErrorToast'
 import { ApiError } from '~/composables/api/errors'
+import { BOOTSTRAP_REFERENCE_REASONS, UNAVAILABLE_REASONS } from '@cat-factory/contracts'
 import en from '../../i18n/locales/en.json'
 
 /**
@@ -304,6 +305,23 @@ describe('describeGenericFailure', () => {
     ).toBe('errors.generic.description.unexpected')
   })
 
+  it('gives every reason with its own copy a key that ships, and lets it beat the status class', () => {
+    // Derived from the vocabularies the code reads rather than pinned to a count: a new reason is
+    // supposed to be an ordinary addition, and an expectation that fails on every one of them
+    // trains the next person to re-pin it unread. What is worth asserting is the property the
+    // exhaustive `Record` alone cannot make, that the key it maps to actually EXISTS in the
+    // catalog, and that a reason wins over the status class it is attached to. Both refusals here
+    // reach a person who can act on them, and the generic 503 wording ("this deployment has not
+    // configured the capability") would send them to configure something that is already wired.
+    for (const reason of [...UNAVAILABLE_REASONS, ...BOOTSTRAP_REFERENCE_REASONS]) {
+      const failure = describeGenericFailure(
+        new ApiError(503, { error: { code: 'unavailable', details: { reason } } }),
+      )
+      expect(failure.descriptionKey).not.toBe('errors.generic.description.unavailable')
+      expect(hasKey(failure.descriptionKey), `${reason} has no copy`).toBe(true)
+    }
+  })
+
   it('never presents a conflict (parseConflict owns those) but still classifies safely', () => {
     // `conflict` is deliberately absent from the map, so it reads as an unrecognised code rather
     // than throwing — the conflict path intercepts it long before this function is reached.

package/app/composables/usePipelineErrorToast.ts

@@ -28,7 +28,12 @@ import { createBespokeConflictToasts } from '~/composables/pipelineErrorToast/be
 // Imported by path rather than left to Nuxt's auto-import: this module is also loaded directly by
 // unit tests (and from store setup), where the auto-import globals are not installed.
 import { useCopyToClipboard } from '~/composables/useCopyToClipboard'
-import type { ApiErrorCode, ConflictReason, UnavailableReason } from '@cat-factory/contracts'
+import type {
+  ApiErrorCode,
+  BootstrapReferenceReason,
+  ConflictReason,
+  UnavailableReason,
+} from '@cat-factory/contracts'
 import { apiErrorEnvelope, apiErrorReason, apiErrorStatus } from './api/errors'
 
 /** The parsed shape of a backend conflict (`{ error: { code: 'conflict', details } }`). */
@@ -386,8 +391,16 @@ const GENERIC_DESCRIPTION_KEYS: Record<Exclude<ApiErrorCode, 'conflict'>, string
  * the reasons in {@link UNAVAILABLE_REASONS} carry their own copy, and the exhaustive `Record`
  * over that union is the drift guard: a new user-reachable 503 reason fails this typecheck until
  * it has wording.
+ *
+ * `BootstrapReferenceReason` joins it because the same argument reaches one 422: a bootstrap
+ * refused for its reference architecture is not "the request was malformed", it names a specific
+ * entry a specific person can go and fix. The launch dialog handles that one itself, since it can
+ * open the entry. This is what every OTHER caller of the funnel is told instead of the status
+ * class's generic wording, above all a retry driven from the run card.
  */
-const UNAVAILABLE_DESCRIPTION_KEYS: Record<UnavailableReason, string> = {
+const REASON_DESCRIPTION_KEYS: Record<UnavailableReason | BootstrapReferenceReason, string> = {
+  reference_repo_not_found: 'errors.reason.description.reference_repo_not_found',
+  reference_repo_unreadable: 'errors.reason.description.reference_repo_unreadable',
   binary_generators_unreachable: 'errors.unavailable.description.binary_generators_unreachable',
   foundational_builtins_unreachable:
     'errors.unavailable.description.foundational_builtins_unreachable',
@@ -445,7 +458,7 @@ export function describeGenericFailure(error: unknown): GenericFailure {
   // A REASON that has its own copy wins over the status class's, through the same widened-alias
   // read and for the same reason: a `reason` this build doesn't know must resolve to `undefined`
   // and fall through, never narrow the wire string to the union by casting.
-  const byReason: Readonly<Record<string, string | undefined>> = UNAVAILABLE_DESCRIPTION_KEYS
+  const byReason: Readonly<Record<string, string | undefined>> = REASON_DESCRIPTION_KEYS
   const reason = apiErrorReason(error)
   const mapped =
     (reason ? byReason[reason] : undefined) ?? (envelope?.code ? byCode[envelope.code] : undefined)

package/i18n/locales/de.json

@@ -5050,7 +5050,14 @@
       "label": "Referenzarchitektur",
       "description": "Das verwaltete Basis-Repo zum Klonen und Anpassen.",
       "empty": "Noch keine Referenzarchitekturen. Fügen Sie unten eine hinzu oder wechseln Sie zu 'Von Grund auf'.",
-      "placeholder": "Referenzarchitektur wählen"
+      "placeholder": "Referenzarchitektur wählen",
+      "refusal": {
+        "title": "Diese Referenzarchitektur konnte nicht verwendet werden",
+        "notFound": "{repo} ist über die Quellcodeverwaltungs-Verbindung dieses Workspace nicht sichtbar. Entweder nennt dieser Eintrag das falsche Repository, oder die Verbindung hat keinen Zugriff darauf. Es wurde nichts angelegt: Korrigieren Sie den Eintrag und starten Sie erneut, alles andere in diesem Formular bleibt erhalten.",
+        "unreadable": "{repo} konnte gerade nicht gelesen werden, deshalb wurde nichts angelegt. Es ist nichts falsch konfiguriert: Starten Sie erneut, sobald die Verbindung wieder steht, alles andere in diesem Formular bleibt erhalten.",
+        "unnamedRepo": "Das Repository der Referenzarchitektur",
+        "edit": "Diese Referenzarchitektur bearbeiten"
+      }
     },
     "targetRepo": {
       "label": "Name des Ziel-Repositorys",
@@ -6105,6 +6112,12 @@
         "service_catalog_response_too_large": "Das Entwicklerportal hat mit mehr Daten geantwortet, als diese Plattform in einer Antwort aufnimmt. Öffne die Servicekatalog-Einstellungen und senke das Service-Limit oder deaktiviere den Import von Schnittstellendefinitionen, und importiere dann erneut."
       }
     },
+    "reason": {
+      "description": {
+        "reference_repo_not_found": "Das Repository hinter der Referenzarchitektur dieses Laufs ist über die Quellcodeverwaltungs-Verbindung dieses Workspace nicht sichtbar. Entweder nennt der Eintrag das falsche Repository, oder die Verbindung hat keinen Zugriff darauf: Korrigieren Sie die Referenzarchitektur oder erteilen Sie den Zugriff, und versuchen Sie es erneut.",
+        "reference_repo_unreadable": "Das Repository hinter der Referenzarchitektur dieses Laufs konnte gerade nicht gelesen werden, deshalb wurde der Lauf nicht gegen eine Vorlage gestartet, die er möglicherweise nicht klonen kann. Es ist nichts falsch konfiguriert und keine Änderung nötig: versuchen Sie es erneut, sobald die Verbindung wieder steht."
+      }
+    },
     "action": {
       "retryFailed": "Wiederholung fehlgeschlagen",
       "startFailed": "Start fehlgeschlagen",

package/i18n/locales/en.json

@@ -709,6 +709,12 @@
         "service_catalog_response_too_large": "The developer portal answered with more data than this platform will hold in one response. Open the service-catalog settings and lower the service cap, or turn off importing interface definitions, then import again."
       }
     },
+    "reason": {
+      "description": {
+        "reference_repo_not_found": "The repository behind this run's reference architecture cannot be seen through this workspace's source-control connection. Either the entry names the wrong repository, or the connection has not been granted access to it: correct the reference architecture, or grant it access, then try again.",
+        "reference_repo_unreadable": "The repository behind this run's reference architecture could not be read just now, so the run was not started against a template it might be unable to clone. Nothing here is misconfigured and no change is needed: try again once the source-control connection recovers."
+      }
+    },
     "action": {
       "retryFailed": "Retry failed",
       "startFailed": "Failed to start",
@@ -7243,7 +7249,14 @@
       "label": "Reference architecture",
       "description": "The managed base repo to clone and adapt.",
       "empty": "No reference architectures yet. Add one below, or switch to 'From scratch'.",
-      "placeholder": "Choose a reference architecture"
+      "placeholder": "Choose a reference architecture",
+      "refusal": {
+        "title": "This reference architecture could not be used",
+        "notFound": "{repo} cannot be seen through this workspace's source-control connection. Either this entry names the wrong repository, or the connection has not been granted access to it. Nothing was created, so correct the entry and launch again: everything else on this form is kept.",
+        "unreadable": "{repo} could not be read just now, so nothing was created. Nothing here is misconfigured: launch again once the source-control connection recovers, and everything else on this form is kept.",
+        "unnamedRepo": "The reference architecture's repository",
+        "edit": "Edit this reference architecture"
+      }
     },
     "targetRepo": {
       "label": "Target repository name",

package/i18n/locales/es.json

@@ -637,6 +637,12 @@
         "service_catalog_response_too_large": "El portal de desarrollo respondió con más datos de los que esta plataforma admite en una sola respuesta. Abre la configuración del catálogo de servicios y reduce el límite de servicios, o desactiva la importación de definiciones de interfaz, y vuelve a importar."
       }
     },
+    "reason": {
+      "description": {
+        "reference_repo_not_found": "El repositorio de la arquitectura de referencia de esta ejecución no es visible a través de la conexión de control de código de este espacio de trabajo. O la entrada indica el repositorio equivocado, o la conexión no tiene acceso a él: corrige la arquitectura de referencia, o concédele acceso, e inténtalo de nuevo.",
+        "reference_repo_unreadable": "No se ha podido leer en este momento el repositorio de la arquitectura de referencia de esta ejecución, así que no se ha iniciado contra una plantilla que quizá no pueda clonar. No hay nada mal configurado ni hace falta ningún cambio: inténtalo de nuevo cuando se restablezca la conexión."
+      }
+    },
     "action": {
       "retryFailed": "El reintento falló",
       "startFailed": "No se pudo iniciar",
@@ -6920,7 +6926,14 @@
       "label": "Arquitectura de referencia",
       "description": "El repositorio base gestionado que se clona y adapta.",
       "empty": "Aún no hay arquitecturas de referencia. Añade una abajo o cambia a 'Desde cero'.",
-      "placeholder": "Elige una arquitectura de referencia"
+      "placeholder": "Elige una arquitectura de referencia",
+      "refusal": {
+        "title": "No se ha podido usar esta arquitectura de referencia",
+        "notFound": "{repo} no es visible a través de la conexión de control de código de este espacio de trabajo. O esta entrada indica el repositorio equivocado, o la conexión no tiene acceso a él. No se ha creado nada: corrige la entrada y vuelve a lanzar, todo lo demás de este formulario se conserva.",
+        "unreadable": "{repo} no se ha podido leer en este momento, así que no se ha creado nada. No hay nada mal configurado: vuelve a lanzar cuando se restablezca la conexión, todo lo demás de este formulario se conserva.",
+        "unnamedRepo": "El repositorio de la arquitectura de referencia",
+        "edit": "Editar esta arquitectura de referencia"
+      }
     },
     "targetRepo": {
       "label": "Nombre del repositorio de destino",

package/i18n/locales/fr.json

@@ -637,6 +637,12 @@
         "service_catalog_response_too_large": "Le portail développeur a renvoyé plus de données que cette plateforme n'en accepte dans une seule réponse. Ouvrez les paramètres du catalogue de services et abaissez la limite de services, ou désactivez l'import des définitions d'interface, puis relancez l'import."
       }
     },
+    "reason": {
+      "description": {
+        "reference_repo_not_found": "Le dépôt de l'architecture de référence de cette exécution n'est pas visible via la connexion de gestion de code de cet espace de travail. Soit l'entrée désigne le mauvais dépôt, soit la connexion n'y a pas accès : corrigez l'architecture de référence, ou accordez-lui l'accès, puis réessayez.",
+        "reference_repo_unreadable": "Le dépôt de l'architecture de référence de cette exécution n'a pas pu être lu pour l'instant, l'exécution n'a donc pas été lancée sur un modèle qu'elle pourrait ne pas savoir cloner. Rien n'est mal configuré et aucune modification n'est nécessaire : réessayez une fois la connexion rétablie."
+      }
+    },
     "action": {
       "retryFailed": "Échec de la nouvelle tentative",
       "startFailed": "Échec du démarrage",
@@ -6920,7 +6926,14 @@
       "label": "Architecture de référence",
       "description": "Le dépôt de base géré à cloner et à adapter.",
       "empty": "Aucune architecture de référence pour l'instant. Ajoutez-en une ci-dessous, ou passez à « À partir de zéro ».",
-      "placeholder": "Choisissez une architecture de référence"
+      "placeholder": "Choisissez une architecture de référence",
+      "refusal": {
+        "title": "Cette architecture de référence n'a pas pu être utilisée",
+        "notFound": "{repo} n'est pas visible via la connexion de gestion de code de cet espace de travail. Soit cette entrée désigne le mauvais dépôt, soit la connexion n'y a pas accès. Rien n'a été créé : corrigez l'entrée et relancez, tout le reste de ce formulaire est conservé.",
+        "unreadable": "{repo} n'a pas pu être lu pour l'instant, rien n'a donc été créé. Rien n'est mal configuré : relancez une fois la connexion rétablie, tout le reste de ce formulaire est conservé.",
+        "unnamedRepo": "Le dépôt de l'architecture de référence",
+        "edit": "Modifier cette architecture de référence"
+      }
     },
     "targetRepo": {
       "label": "Nom du dépôt cible",

package/i18n/locales/he.json

@@ -637,6 +637,12 @@
         "service_catalog_response_too_large": "פורטל המפתחים החזיר יותר נתונים ממה שהפלטפורמה הזו מחזיקה בתשובה אחת. פתחו את הגדרות קטלוג השירותים והנמיכו את מגבלת השירותים, או כבו את ייבוא הגדרות הממשק, ואז ייבאו שוב."
       }
     },
+    "reason": {
+      "description": {
+        "reference_repo_not_found": "המאגר שמאחורי ארכיטקטורת הייחוס של ההרצה הזו אינו נראה דרך חיבור ניהול הקוד של סביבת העבודה. או שהרשומה מציינת מאגר שגוי, או שלחיבור לא ניתנה גישה אליו: תקנו את ארכיטקטורת הייחוס, או העניקו לה גישה, ונסו שוב.",
+        "reference_repo_unreadable": "לא ניתן היה לקרוא כרגע את המאגר שמאחורי ארכיטקטורת הייחוס של ההרצה הזו, ולכן ההרצה לא הופעלה מול תבנית שאולי לא תוכל לשכפל. אין כאן תצורה שגויה ולא נדרש שום שינוי: נסו שוב כשהחיבור יחזור."
+      }
+    },
     "action": {
       "retryFailed": "הניסיון החוזר נכשל",
       "startFailed": "ההפעלה נכשלה",
@@ -6920,7 +6926,14 @@
       "label": "ארכיטקטורת ייחוס",
       "description": "מאגר הבסיס המנוהל לשכפול והתאמה.",
       "empty": "אין עדיין ארכיטקטורות ייחוס. הוסף אחת למטה, או עבור ל'מאפס'.",
-      "placeholder": "בחר ארכיטקטורת ייחוס"
+      "placeholder": "בחר ארכיטקטורת ייחוס",
+      "refusal": {
+        "title": "לא ניתן היה להשתמש בארכיטקטורת הייחוס הזו",
+        "notFound": "המאגר {repo} אינו נראה דרך חיבור ניהול הקוד של סביבת העבודה. או שהרשומה הזו מציינת מאגר שגוי, או שלחיבור לא ניתנה גישה אליו. לא נוצר דבר: תקנו את הרשומה והפעילו שוב, כל שאר השדות בטופס נשמרים.",
+        "unreadable": "לא ניתן היה לקרוא כרגע את {repo}, ולכן לא נוצר דבר. אין כאן תצורה שגויה: הפעילו שוב כשהחיבור יחזור, כל שאר השדות בטופס נשמרים.",
+        "unnamedRepo": "המאגר של ארכיטקטורת הייחוס",
+        "edit": "ערכו את ארכיטקטורת הייחוס הזו"
+      }
     },
     "targetRepo": {
       "label": "שם מאגר היעד",

package/i18n/locales/it.json

@@ -5050,7 +5050,14 @@
       "label": "Architettura di riferimento",
       "description": "Il repository base gestito da clonare e adattare.",
       "empty": "Nessuna architettura di riferimento ancora. Aggiungine una qui sotto, oppure passa a 'Da zero'.",
-      "placeholder": "Scegli un'architettura di riferimento"
+      "placeholder": "Scegli un'architettura di riferimento",
+      "refusal": {
+        "title": "Non è stato possibile usare questa architettura di riferimento",
+        "notFound": "{repo} non è visibile attraverso la connessione di controllo del codice di questo workspace. O questa voce indica il repository sbagliato, o la connessione non vi ha accesso. Non è stato creato nulla: correggi la voce e riavvia, tutto il resto di questo modulo viene mantenuto.",
+        "unreadable": "{repo} non è risultato leggibile in questo momento, quindi non è stato creato nulla. Non c'è nulla di configurato male: riavvia quando la connessione sarà ripristinata, tutto il resto di questo modulo viene mantenuto.",
+        "unnamedRepo": "Il repository dell'architettura di riferimento",
+        "edit": "Modifica questa architettura di riferimento"
+      }
     },
     "targetRepo": {
       "label": "Nome del repository di destinazione",
@@ -6105,6 +6112,12 @@
         "service_catalog_response_too_large": "Il portale per sviluppatori ha risposto con più dati di quanti questa piattaforma ne accolga in una sola risposta. Apri le impostazioni del catalogo dei servizi e abbassa il limite dei servizi, oppure disattiva l'importazione delle definizioni di interfaccia, poi importa di nuovo."
       }
     },
+    "reason": {
+      "description": {
+        "reference_repo_not_found": "Il repository dietro l'architettura di riferimento di questa esecuzione non è visibile attraverso la connessione di controllo del codice di questo workspace. O la voce indica il repository sbagliato, o la connessione non vi ha accesso: correggi l'architettura di riferimento, oppure concedile l'accesso, e riprova.",
+        "reference_repo_unreadable": "Non è stato possibile leggere in questo momento il repository dietro l'architettura di riferimento di questa esecuzione, quindi l'esecuzione non è stata avviata su un modello che potrebbe non riuscire a clonare. Non c'è nulla di configurato male e non serve alcuna modifica: riprova quando la connessione sarà ripristinata."
+      }
+    },
     "action": {
       "retryFailed": "Nuovo tentativo non riuscito",
       "startFailed": "Avvio non riuscito",

package/i18n/locales/ja.json

@@ -637,6 +637,12 @@
         "service_catalog_response_too_large": "開発者ポータルが、このプラットフォームが 1 回の応答で保持できる量を超えるデータを返しました。サービスカタログの設定を開いてサービス上限を下げるか、インターフェース定義の取り込みをオフにしてから、もう一度取り込んでください。"
       }
     },
+    "reason": {
+      "description": {
+        "reference_repo_not_found": "この実行のリファレンスアーキテクチャが指すリポジトリは、このワークスペースのソース管理接続からは参照できません。エントリが誤ったリポジトリを指しているか、接続にアクセス権が付与されていません。リファレンスアーキテクチャを修正するか、アクセス権を付与してから、もう一度お試しください。",
+        "reference_repo_unreadable": "この実行のリファレンスアーキテクチャが指すリポジトリを現在読み取れなかったため、クローンできない可能性のあるテンプレートに対して実行は開始されませんでした。設定に誤りはなく、変更も不要です。接続が回復してからもう一度お試しください。"
+      }
+    },
     "action": {
       "retryFailed": "再試行に失敗しました",
       "startFailed": "開始に失敗しました",
@@ -6920,7 +6926,14 @@
       "label": "リファレンスアーキテクチャ",
       "description": "クローンして適用する管理対象のベースリポジトリ。",
       "empty": "リファレンスアーキテクチャがまだありません。下で追加するか、'ゼロから' に切り替えてください。",
-      "placeholder": "リファレンスアーキテクチャを選択"
+      "placeholder": "リファレンスアーキテクチャを選択",
+      "refusal": {
+        "title": "このリファレンスアーキテクチャは使用できませんでした",
+        "notFound": "{repo} は、このワークスペースのソース管理接続からは参照できません。このエントリが誤ったリポジトリを指しているか、接続にアクセス権が付与されていません。何も作成されていません。エントリを修正して再度開始してください。このフォームの他の入力内容はそのまま保持されます。",
+        "unreadable": "{repo} を現在読み取れなかったため、何も作成されていません。設定に誤りはありません。接続が回復してから再度開始してください。このフォームの他の入力内容はそのまま保持されます。",
+        "unnamedRepo": "リファレンスアーキテクチャのリポジトリ",
+        "edit": "このリファレンスアーキテクチャを編集"
+      }
     },
     "targetRepo": {
       "label": "ターゲットリポジトリ名",

package/i18n/locales/pl.json

@@ -637,6 +637,12 @@
         "service_catalog_response_too_large": "Portal deweloperski zwrócił więcej danych, niż ta platforma przyjmuje w jednej odpowiedzi. Otwórz ustawienia katalogu usług i obniż limit usług albo wyłącz importowanie definicji interfejsów, a następnie zaimportuj ponownie."
       }
     },
+    "reason": {
+      "description": {
+        "reference_repo_not_found": "Repozytorium stojące za architekturą referencyjną tego uruchomienia nie jest widoczne przez połączenie kontroli źródeł tej przestrzeni roboczej. Albo wpis wskazuje niewłaściwe repozytorium, albo połączenie nie ma do niego dostępu: popraw architekturę referencyjną lub nadaj jej dostęp i spróbuj ponownie.",
+        "reference_repo_unreadable": "Nie udało się teraz odczytać repozytorium stojącego za architekturą referencyjną tego uruchomienia, więc nie zostało ono uruchomione na szablonie, którego może nie umieć sklonować. Nic nie jest źle skonfigurowane i nie trzeba nic zmieniać: spróbuj ponownie, gdy połączenie wróci."
+      }
+    },
     "action": {
       "retryFailed": "Ponowienie nie powiodło się",
       "startFailed": "Nie udało się uruchomić",
@@ -6920,7 +6926,14 @@
       "label": "Architektura referencyjna",
       "description": "Zarządzane repozytorium bazowe do sklonowania i dostosowania.",
       "empty": "Brak architektur referencyjnych. Dodaj jedną poniżej lub przełącz na „Od zera”.",
-      "placeholder": "Wybierz architekturę referencyjną"
+      "placeholder": "Wybierz architekturę referencyjną",
+      "refusal": {
+        "title": "Nie udało się użyć tej architektury referencyjnej",
+        "notFound": "Nie widać {repo} przez połączenie kontroli źródeł tej przestrzeni roboczej. Albo ten wpis wskazuje niewłaściwe repozytorium, albo połączenie nie ma do niego dostępu. Nic nie zostało utworzone: popraw wpis i uruchom ponownie, reszta tego formularza zostaje zachowana.",
+        "unreadable": "Nie udało się teraz odczytać {repo}, więc nic nie zostało utworzone. Nic nie jest źle skonfigurowane: uruchom ponownie, gdy połączenie wróci, reszta tego formularza zostaje zachowana.",
+        "unnamedRepo": "repozytorium architektury referencyjnej",
+        "edit": "Edytuj tę architekturę referencyjną"
+      }
     },
     "targetRepo": {
       "label": "Nazwa repozytorium docelowego",

package/i18n/locales/tr.json

@@ -637,6 +637,12 @@
         "service_catalog_response_too_large": "Geliştirici portalı, bu platformun tek bir yanıtta tutacağından daha fazla veri döndürdü. Servis kataloğu ayarlarını açıp servis sınırını düşürün ya da arayüz tanımlarının aktarımını kapatın, sonra yeniden aktarın."
       }
     },
+    "reason": {
+      "description": {
+        "reference_repo_not_found": "Bu çalıştırmanın referans mimarisinin arkasındaki depo, bu çalışma alanının kaynak denetimi bağlantısı üzerinden görülemiyor. Ya kayıt yanlış depoyu gösteriyor ya da bağlantıya erişim verilmemiş: referans mimarisini düzeltin veya erişim verin, sonra yeniden deneyin.",
+        "reference_repo_unreadable": "Bu çalıştırmanın referans mimarisinin arkasındaki depo şu anda okunamadı, bu yüzden klonlayamayabileceği bir şablon üzerinde başlatılmadı. Yanlış yapılandırılmış bir şey yok ve bir değişiklik gerekmiyor: bağlantı düzeldiğinde yeniden deneyin."
+      }
+    },
     "action": {
       "retryFailed": "Yeniden deneme başarısız oldu",
       "startFailed": "Başlatılamadı",
@@ -6920,7 +6926,14 @@
       "label": "Referans mimari",
       "description": "Klonlanacak ve uyarlanacak yönetilen temel depo.",
       "empty": "Henüz referans mimari yok. Aşağıdan bir tane ekleyin veya 'Sıfırdan' seçeneğine geçin.",
-      "placeholder": "Bir referans mimari seçin"
+      "placeholder": "Bir referans mimari seçin",
+      "refusal": {
+        "title": "Bu referans mimari kullanılamadı",
+        "notFound": "{repo}, bu çalışma alanının kaynak denetimi bağlantısı üzerinden görülemiyor. Ya bu kayıt yanlış depoyu gösteriyor ya da bağlantıya erişim verilmemiş. Hiçbir şey oluşturulmadı: kaydı düzeltip yeniden başlatın, bu formdaki diğer her şey korunur.",
+        "unreadable": "{repo} şu anda okunamadı, bu yüzden hiçbir şey oluşturulmadı. Yanlış yapılandırılmış bir şey yok: bağlantı düzeldiğinde yeniden başlatın, bu formdaki diğer her şey korunur.",
+        "unnamedRepo": "Referans mimarinin deposu",
+        "edit": "Bu referans mimariyi düzenle"
+      }
     },
     "targetRepo": {
       "label": "Hedef depo adı",

package/i18n/locales/uk.json

@@ -637,6 +637,12 @@
         "service_catalog_response_too_large": "Портал розробника повернув більше даних, ніж ця платформа приймає в одній відповіді. Відкрийте налаштування каталогу сервісів і знизьте ліміт сервісів або вимкніть імпорт визначень інтерфейсів, а тоді імпортуйте ще раз."
       }
     },
+    "reason": {
+      "description": {
+        "reference_repo_not_found": "Репозиторій, на який вказує еталонна архітектура цього запуску, не видно через з'єднання з системою контролю версій цього робочого простору. Або запис вказує на не той репозиторій, або з'єднанню не надано до нього доступ: виправте еталонну архітектуру або надайте доступ і спробуйте ще раз.",
+        "reference_repo_unreadable": "Наразі не вдалося прочитати репозиторій, на який вказує еталонна архітектура цього запуску, тож запуск не було розпочато на шаблоні, який він, можливо, не зможе клонувати. Нічого не налаштовано неправильно і жодних змін не потрібно: спробуйте ще раз, коли з'єднання відновиться."
+      }
+    },
     "action": {
       "retryFailed": "Не вдалося повторити",
       "startFailed": "Не вдалося запустити",
@@ -6920,7 +6926,14 @@
       "label": "Еталонна архітектура",
       "description": "Кероване базове репо для клонування й адаптації.",
       "empty": "Еталонних архітектур ще немає. Додайте одну нижче або перемкніться на «З нуля».",
-      "placeholder": "Виберіть еталонну архітектуру"
+      "placeholder": "Виберіть еталонну архітектуру",
+      "refusal": {
+        "title": "Не вдалося скористатися цією еталонною архітектурою",
+        "notFound": "Не видно {repo} через з'єднання з системою контролю версій цього робочого простору. Або цей запис вказує на не той репозиторій, або з'єднанню не надано до нього доступ. Нічого не створено: виправте запис і запустіть знову, решта цієї форми зберігається.",
+        "unreadable": "Наразі не вдалося прочитати {repo}, тож нічого не створено. Нічого не налаштовано неправильно: запустіть знову, коли з'єднання відновиться, решта цієї форми зберігається.",
+        "unnamedRepo": "репозиторій еталонної архітектури",
+        "edit": "Редагувати цю еталонну архітектуру"
+      }
     },
     "targetRepo": {
       "label": "Назва цільового репозиторію",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.296.0",
+  "version": "0.296.2",
   "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",
@@ -18,7 +18,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@cat-factory/contracts": "0.346.0",
+    "@cat-factory/contracts": "0.346.1",
     "@modular-frontend/core": "0.6.0",
     "@modular-vue/core": "^1.5.0",
     "@modular-vue/journeys": "^1.4.0",
@@ -44,7 +44,7 @@
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",
-    "happy-dom": "^20.12.0",
+    "happy-dom": "^20.13.2",
     "msw": "^2.15.0",
     "nuxt": "^4.5.2",
     "typescript": "^6.0.3",