@cat-factory/app 0.112.0 → 0.114.0

package/app/components/auth/BackendMisconfiguredScreen.vue

@@ -41,6 +41,16 @@ function reload() {
             <span class="font-medium text-slate-300">{{ t('app.misconfigured.howToFix') }}</span>
             {{ problem.remedy }}
           </p>
+          <a
+            v-if="problem.docsUrl"
+            :href="problem.docsUrl"
+            target="_blank"
+            rel="noopener noreferrer"
+            class="mt-2 inline-flex items-center gap-1 text-sm text-amber-300 hover:text-amber-200"
+          >
+            <UIcon name="i-lucide-book-open" class="h-4 w-4" />
+            {{ t('app.misconfigured.viewDocs') }}
+          </a>
         </li>
       </ul>
 

package/app/components/panels/inspector/TaskAprioriBranches.vue

@@ -0,0 +1,247 @@
+<script setup lang="ts">
+// Pre-existing branches of a task's PRIMARY target repo handed to the run as input, in two
+// deliberately-disjoint modes (see `backend/docs/adr/0021-apriori-branches.md`):
+//
+//  - `reference` — read-only context (a spike / prototype / prior-art branch). The consuming
+//    agents may read it (log/diff/open files) but never commit to or push it.
+//  - `working` — the branch the run keeps building inside: it starts from and continues
+//    committing into this branch instead of minting `cat-factory/<blockId>` off the default,
+//    and the PR / CI-gate / merger all ride it.
+//
+// The cross-entry invariants the backend enforces at the write boundary are mirrored here so a
+// forbidden combination is prevented in the UI rather than surfaced as a rejected write: at most
+// ONE working entry, no duplicate names, the working entry frozen once a PR exists (its head is
+// already pinned everywhere), and no working entry on a multi-repo task (v1 — peer legs would
+// mint the user's branch name across every involved repo).
+import { aprioriWorkingBranch } from '@cat-factory/contracts'
+import type { AprioriBranch, Block } from '~/types/domain'
+
+const props = defineProps<{ block: Block }>()
+
+const { t } = useI18n()
+const github = useGitHubStore()
+const board = useBoardStore()
+
+// The primary target repo is the one bound to the task's owning service frame — the sole
+// repo↔frame linkage. Branch options come from the existing per-repo branches projection.
+const frame = computed(() => board.serviceOf(props.block))
+const repo = computed(() => (frame.value ? github.repoForBlock(frame.value.id) : undefined))
+const repoBranches = computed(() => {
+  const id = repo.value?.githubId
+  return id != null ? (github.branches[id] ?? []) : []
+})
+
+// Load (and cache) the target repo's branches once it's resolved. Best-effort — a fetch failure
+// just leaves the picker empty (the same repo the run clones, so a real failure is rare).
+watch(
+  () => repo.value?.githubId,
+  (id) => {
+    if (id != null) void github.loadBranches(id).catch(() => {})
+  },
+  { immediate: true },
+)
+
+// Write-boundary mirrors:
+//  - a PR pins the run's branch, so the working entry is FROZEN (references stay editable);
+//  - a multi-repo task (any involved service) BLOCKS working mode entirely.
+const hasPullRequest = computed(() => !!props.block.pullRequest)
+const isMultiRepo = computed(() => (props.block.involvedServiceIds ?? []).length > 0)
+
+// A working entry set while single-repo becomes invalid the moment the task gains a second
+// involved service (the backend rejects a working entry on a multi-repo task). Rather than let
+// that stale entry ride along and fail the NEXT write wholesale, demote any working entry to
+// `reference` on a multi-repo task — applied both to what we render and to what we persist, so
+// the invariant is mirrored (not surfaced as a rejected write) and self-heals on the next save.
+function normalize(entries: AprioriBranch[]): AprioriBranch[] {
+  if (!isMultiRepo.value) return entries
+  return entries.map((b) => (b.mode === 'working' ? { ...b, mode: 'reference' } : b))
+}
+
+const attached = computed<AprioriBranch[]>(() => normalize(props.block.aprioriBranches ?? []))
+const attachedNames = computed(() => new Set(attached.value.map((b) => b.name)))
+const workingName = computed(() => aprioriWorkingBranch(attached.value))
+
+function isProtected(name: string): boolean {
+  return repoBranches.value.find((b) => b.name === name)?.protected === true
+}
+// Building the run inside the repo's base branch has nothing to diff and no PR to open, so it's
+// rejected at dispatch — surface it here as a non-selectable working target.
+function isBaseBranch(name: string): boolean {
+  return repo.value?.defaultBranch != null && name === repo.value.defaultBranch
+}
+
+function save(next: AprioriBranch[]) {
+  board.updateBlock(props.block.id, { aprioriBranches: normalize(next) })
+}
+
+// ---- add / remove -----------------------------------------------------------
+// The picker adds a branch as `reference` (the safe default — promoting to working is an
+// explicit second action, guarded below).
+const pickedName = ref<string | undefined>(undefined)
+watch(pickedName, (name) => {
+  if (name === undefined) return
+  pickedName.value = undefined
+  if (attachedNames.value.has(name)) return
+  save([...attached.value, { name, mode: 'reference' }])
+})
+
+const branchItems = computed(() =>
+  repoBranches.value.map((b) => ({
+    label: b.name,
+    value: b.name,
+    disabled: attachedNames.value.has(b.name),
+  })),
+)
+
+function remove(name: string) {
+  save(attached.value.filter((b) => b.name !== name))
+}
+
+// ---- mode toggle ------------------------------------------------------------
+// Promoting an entry to `working` demotes any existing working entry to `reference` in the same
+// write, so the single-working invariant holds without an intermediate rejected state.
+function setMode(name: string, mode: AprioriBranch['mode']) {
+  save(
+    attached.value.map((b) => {
+      if (b.name === name) return { ...b, mode }
+      if (mode === 'working' && b.mode === 'working') return { ...b, mode: 'reference' }
+      return b
+    }),
+  )
+}
+
+// Whether a reference entry may be promoted to working: blocked outright on a multi-repo task,
+// on the base branch, and once a PR has frozen the working slot.
+function canPromote(name: string): boolean {
+  return !isMultiRepo.value && !hasPullRequest.value && !isBaseBranch(name)
+}
+// The working entry is frozen once the PR exists (changing/dropping it would silently diverge).
+const workingFrozen = computed(() => hasPullRequest.value && workingName.value !== undefined)
+
+function modeMenu(entry: AprioriBranch) {
+  const items: Array<{ label: string; icon: string; onSelect: () => void }> = []
+  if (entry.mode === 'working') {
+    if (!workingFrozen.value) {
+      items.push({
+        label: t('inspector.aprioriBranches.mode.reference'),
+        icon: 'i-lucide-book-open-text',
+        onSelect: () => setMode(entry.name, 'reference'),
+      })
+    }
+  } else if (canPromote(entry.name)) {
+    items.push({
+      label: t('inspector.aprioriBranches.mode.working'),
+      icon: 'i-lucide-hammer',
+      onSelect: () => setMode(entry.name, 'working'),
+    })
+  }
+  return [items]
+}
+// The mode dropdown is inert when there's no alternative mode to switch to.
+function modeToggleDisabled(entry: AprioriBranch): boolean {
+  return modeMenu(entry)[0]!.length === 0
+}
+// The working entry can't be removed while frozen by a PR; reference entries are always removable.
+function removeDisabled(entry: AprioriBranch): boolean {
+  return entry.mode === 'working' && workingFrozen.value
+}
+</script>
+
+<template>
+  <div v-if="repo" data-testid="apriori-branches">
+    <div class="mb-1 flex items-center justify-between">
+      <span class="text-[11px] font-semibold uppercase tracking-wide text-slate-400">
+        {{ t('inspector.aprioriBranches.title') }}
+      </span>
+    </div>
+
+    <!-- Attached branches: one row each — name, mode badge + toggle, remove. -->
+    <div v-if="attached.length" class="mb-1.5 space-y-1">
+      <div
+        v-for="entry in attached"
+        :key="entry.name"
+        class="flex items-center gap-1.5"
+        data-testid="apriori-branch-row"
+      >
+        <UBadge
+          size="sm"
+          variant="soft"
+          :color="entry.mode === 'working' ? 'primary' : 'neutral'"
+          class="min-w-0"
+          :data-mode="entry.mode"
+          data-testid="apriori-branch-chip"
+        >
+          <UIcon
+            :name="entry.mode === 'working' ? 'i-lucide-hammer' : 'i-lucide-book-open-text'"
+            class="me-1 h-3 w-3 shrink-0"
+          />
+          <span class="truncate">{{ entry.name }}</span>
+        </UBadge>
+
+        <UDropdownMenu :items="modeMenu(entry)">
+          <UButton
+            size="xs"
+            variant="ghost"
+            color="neutral"
+            trailing-icon="i-lucide-chevron-down"
+            :disabled="modeToggleDisabled(entry)"
+            data-testid="apriori-branch-mode"
+          >
+            {{
+              entry.mode === 'working'
+                ? t('inspector.aprioriBranches.mode.working')
+                : t('inspector.aprioriBranches.mode.reference')
+            }}
+          </UButton>
+        </UDropdownMenu>
+
+        <UButton
+          color="neutral"
+          variant="link"
+          size="xs"
+          icon="i-lucide-x"
+          class="ms-auto"
+          :disabled="removeDisabled(entry)"
+          :aria-label="t('inspector.aprioriBranches.remove', { branch: entry.name })"
+          data-testid="apriori-branch-remove"
+          @click="remove(entry.name)"
+        />
+      </div>
+    </div>
+
+    <!-- The picker: only usable once the workspace's GitHub App is connected. -->
+    <UInputMenu
+      v-if="github.connected"
+      v-model="pickedName"
+      :items="branchItems"
+      value-key="value"
+      icon="i-lucide-git-branch"
+      :placeholder="t('inspector.aprioriBranches.searchPlaceholder')"
+      class="w-full"
+      data-testid="apriori-branch-search"
+    />
+    <div v-else class="text-[11px] text-slate-500">
+      {{ t('inspector.aprioriBranches.connectFirst') }}
+    </div>
+
+    <!-- A protected branch pushed to by the run is likely to be rejected — warn, don't block. -->
+    <div
+      v-if="workingName && isProtected(workingName)"
+      class="mt-1.5 flex items-start gap-1.5 rounded-md border border-amber-500/40 bg-amber-950/40 p-2 text-[11px] text-amber-200/90"
+      data-testid="apriori-branch-protected-warning"
+    >
+      <UIcon name="i-lucide-triangle-alert" class="mt-0.5 h-3.5 w-3.5 shrink-0 text-amber-400" />
+      <span>{{ t('inspector.aprioriBranches.protectedWarning', { branch: workingName }) }}</span>
+    </div>
+
+    <div class="mt-1 text-[11px] text-slate-500">
+      {{ t('inspector.aprioriBranches.hint') }}
+      <template v-if="isMultiRepo">
+        {{ t('inspector.aprioriBranches.multiRepoHint') }}
+      </template>
+      <template v-else-if="workingFrozen">
+        {{ t('inspector.aprioriBranches.frozenHint') }}
+      </template>
+    </div>
+  </div>
+</template>

package/app/components/panels/inspector/TaskRunSettings.vue

@@ -6,6 +6,7 @@ import type { WritebackOverride } from '~/types/tracker'
 import { riskPolicyOptionLabel, riskPolicySummary } from '~/utils/riskPolicy'
 import { pipelineAllowedForManualStart } from '~/utils/pipeline'
 import InspectorSection from '~/components/panels/inspector/InspectorSection.vue'
+import TaskAprioriBranches from '~/components/panels/inspector/TaskAprioriBranches.vue'
 
 const props = defineProps<{ block: Block }>()
 
@@ -480,6 +481,10 @@ const technicalLabel = computed(() => {
       </div>
     </div>
 
+    <!-- apriori branches: pre-existing branches of the target repo handed to the run as input
+         (a read-only reference, or the working branch the run builds inside) -->
+    <TaskAprioriBranches :block="block" />
+
     <!-- reference repositories: read-only repos the doc-writer reads while drafting (doc tasks) -->
     <DocReferenceRepos v-if="block.taskType === 'document'" :block="block" />
 

package/app/types/domain.ts

@@ -29,6 +29,7 @@ export type {
   Block,
   PullRequestRef,
   ReferenceRepo,
+  AprioriBranch,
   CloudProvider,
   InstanceSize,
   ProvisionType,

package/i18n/locales/de.json

@@ -1240,6 +1240,20 @@
       "involvedServicesEmpty": "Keine verbundenen Services. Verbinde Services am Service-Frame, um sie hier auszuwählen.",
       "involvedServiceStale": "Nicht mehr mit dem Service dieser Aufgabe verbunden; wird bei der nächsten Änderung entfernt."
     },
+    "aprioriBranches": {
+      "title": "Vorhandene Branches",
+      "mode": {
+        "reference": "Referenz",
+        "working": "Arbeitsbranch"
+      },
+      "remove": "{branch} entfernen",
+      "searchPlaceholder": "Vorhandenen Branch hinzufügen…",
+      "connectFirst": "Verbinde GitHub, um vorhandene Branches hinzuzufügen.",
+      "protectedWarning": "{branch} ist ein geschützter Branch. Pushes aus dem Lauf werden möglicherweise abgelehnt.",
+      "multiRepoHint": "Der Arbeitsmodus ist nicht verfügbar, solange diese Aufgabe mehr als einen Service umfasst.",
+      "frozenHint": "Der Arbeitsbranch ist gesperrt, da für diese Aufgabe bereits ein Pull Request existiert.",
+      "hint": "Übergib dieser Aufgabe vorhandene Branches ihres Repositorys. Ein Referenzbranch ist schreibgeschützter Kontext, den die Agenten einsehen dürfen; im einzelnen Arbeitsbranch baut der Lauf weiter, statt einen neuen Branch anzulegen."
+    },
     "referenceRepos": {
       "title": "Referenz-Repositories",
       "remove": "{repo} entfernen",
@@ -3640,6 +3654,7 @@
       "title": "Backend nicht konfiguriert",
       "intro": "Der Server wurde gestartet, kann aber erst laufen, wenn die folgenden Einstellungen vorhanden sind. Ergänze die fehlenden Werte in deiner Umgebung und lade neu.",
       "howToFix": "So behebst du es:",
+      "viewDocs": "Dokumentation ansehen",
       "reload": "Neu laden",
       "hint": "Hier werden nur Variablennamen und deren Einrichtung angezeigt, niemals geheime Werte."
     }

package/i18n/locales/en.json

@@ -9,6 +9,7 @@
       "title": "Backend not configured",
       "intro": "The server started but can't run until the settings below are provided. Add the missing values to your environment, then reload.",
       "howToFix": "How to fix:",
+      "viewDocs": "View documentation",
       "reload": "Reload",
       "hint": "Only variable names and how to set them are shown here, never any secret values."
     }
@@ -978,6 +979,20 @@
       "involvedServicesEmpty": "No connected services. Connect services on the service frame to select them here.",
       "involvedServiceStale": "No longer connected to this task's service; it is dropped on the next change."
     },
+    "aprioriBranches": {
+      "title": "Existing branches",
+      "mode": {
+        "reference": "Reference",
+        "working": "Working"
+      },
+      "remove": "Remove {branch}",
+      "searchPlaceholder": "Add an existing branch…",
+      "connectFirst": "Connect GitHub to add existing branches.",
+      "protectedWarning": "{branch} is a protected branch. Pushes from the run may be rejected.",
+      "multiRepoHint": "Working mode is unavailable while this task involves more than one service.",
+      "frozenHint": "The working branch is locked because a pull request already exists for this task.",
+      "hint": "Hand this task pre-existing branches of its repository. A reference branch is read-only context the agents may inspect; the single working branch is where the run keeps building instead of a new branch."
+    },
     "referenceRepos": {
       "title": "Reference repositories",
       "remove": "Remove {repo}",

package/i18n/locales/es.json

@@ -9,6 +9,7 @@
       "title": "Backend sin configurar",
       "intro": "El servidor se inició pero no puede funcionar hasta que se proporcionen los ajustes siguientes. Añade los valores que faltan a tu entorno y vuelve a cargar.",
       "howToFix": "Cómo solucionarlo:",
+      "viewDocs": "Ver la documentación",
       "reload": "Recargar",
       "hint": "Aquí solo se muestran los nombres de las variables y cómo definirlas, nunca valores secretos."
     }
@@ -924,6 +925,20 @@
       "involvedServicesEmpty": "No hay servicios conectados. Conecta servicios en el marco del servicio para seleccionarlos aquí.",
       "involvedServiceStale": "Ya no está conectado al servicio de esta tarea; se eliminará con el próximo cambio."
     },
+    "aprioriBranches": {
+      "title": "Ramas existentes",
+      "mode": {
+        "reference": "Referencia",
+        "working": "Trabajo"
+      },
+      "remove": "Eliminar {branch}",
+      "searchPlaceholder": "Añadir una rama existente…",
+      "connectFirst": "Conecta GitHub para añadir ramas existentes.",
+      "protectedWarning": "{branch} es una rama protegida. Los envíos de la ejecución podrían ser rechazados.",
+      "multiRepoHint": "El modo de trabajo no está disponible mientras esta tarea involucre más de un servicio.",
+      "frozenHint": "La rama de trabajo está bloqueada porque ya existe una solicitud de incorporación para esta tarea.",
+      "hint": "Entrega a esta tarea ramas ya existentes de su repositorio. Una rama de referencia es contexto de solo lectura que los agentes pueden inspeccionar; en la única rama de trabajo la ejecución sigue construyendo en lugar de crear una rama nueva."
+    },
     "referenceRepos": {
       "title": "Repositorios de referencia",
       "remove": "Quitar {repo}",

package/i18n/locales/fr.json

@@ -9,6 +9,7 @@
       "title": "Backend non configuré",
       "intro": "Le serveur a démarré mais ne peut pas fonctionner tant que les paramètres ci-dessous ne sont pas fournis. Ajoutez les valeurs manquantes à votre environnement, puis rechargez.",
       "howToFix": "Comment corriger :",
+      "viewDocs": "Voir la documentation",
       "reload": "Recharger",
       "hint": "Seuls les noms des variables et la façon de les définir sont affichés ici, jamais de valeurs secrètes."
     }
@@ -924,6 +925,20 @@
       "involvedServicesEmpty": "Aucun service connecté. Connectez des services sur le cadre du service pour les sélectionner ici.",
       "involvedServiceStale": "N'est plus connecté au service de cette tâche ; il sera retiré au prochain changement."
     },
+    "aprioriBranches": {
+      "title": "Branches existantes",
+      "mode": {
+        "reference": "Référence",
+        "working": "Travail"
+      },
+      "remove": "Supprimer {branch}",
+      "searchPlaceholder": "Ajouter une branche existante…",
+      "connectFirst": "Connectez GitHub pour ajouter des branches existantes.",
+      "protectedWarning": "{branch} est une branche protégée. Les poussées de l'exécution peuvent être rejetées.",
+      "multiRepoHint": "Le mode travail est indisponible tant que cette tâche implique plusieurs services.",
+      "frozenHint": "La branche de travail est verrouillée car une pull request existe déjà pour cette tâche.",
+      "hint": "Confiez à cette tâche des branches déjà existantes de son dépôt. Une branche de référence est un contexte en lecture seule que les agents peuvent consulter ; sur l'unique branche de travail, l'exécution continue de construire au lieu de créer une nouvelle branche."
+    },
     "referenceRepos": {
       "title": "Dépôts de référence",
       "remove": "Retirer {repo}",

package/i18n/locales/he.json

@@ -9,6 +9,7 @@
       "title": "השרת אינו מוגדר",
       "intro": "השרת עלה אך אינו יכול לפעול עד שהערכים הבאים יסופקו. הוסיפו את הערכים החסרים לסביבה שלכם וטענו מחדש.",
       "howToFix": "איך לתקן:",
+      "viewDocs": "צפייה בתיעוד",
       "reload": "טעינה מחדש",
       "hint": "כאן מוצגים רק שמות המשתנים וכיצד להגדיר אותם, לעולם לא ערכים סודיים."
     }
@@ -924,6 +925,20 @@
       "involvedServicesEmpty": "אין שירותים מחוברים. חברו שירותים במסגרת השירות כדי לבחור אותם כאן.",
       "involvedServiceStale": "כבר לא מחובר לשירות של משימה זו; הוא יוסר בשינוי הבא."
     },
+    "aprioriBranches": {
+      "title": "ענפים קיימים",
+      "mode": {
+        "reference": "הפניה",
+        "working": "עבודה"
+      },
+      "remove": "הסר את {branch}",
+      "searchPlaceholder": "הוסף ענף קיים…",
+      "connectFirst": "התחבר ל‑GitHub כדי להוסיף ענפים קיימים.",
+      "protectedWarning": "{branch} הוא ענף מוגן. דחיפות מההרצה עלולות להידחות.",
+      "multiRepoHint": "מצב עבודה אינו זמין כאשר משימה זו מערבת יותר משירות אחד.",
+      "frozenHint": "ענף העבודה נעול מכיוון שכבר קיימת בקשת משיכה למשימה זו.",
+      "hint": "מסרו למשימה זו ענפים קיימים של המאגר שלה. ענף הפניה הוא הקשר לקריאה בלבד שהסוכנים רשאים לבחון; בענף העבודה היחיד ההרצה ממשיכה לבנות במקום ליצור ענף חדש."
+    },
     "referenceRepos": {
       "title": "Reference repositories",
       "remove": "Remove {repo}",

package/i18n/locales/it.json

@@ -1240,6 +1240,20 @@
       "involvedServicesEmpty": "Nessun servizio connesso. Connetti i servizi sul frame del servizio per selezionarli qui.",
       "involvedServiceStale": "Non piu' connesso al servizio di questa attivita'; verra' rimosso alla prossima modifica."
     },
+    "aprioriBranches": {
+      "title": "Branch esistenti",
+      "mode": {
+        "reference": "Riferimento",
+        "working": "Lavoro"
+      },
+      "remove": "Rimuovi {branch}",
+      "searchPlaceholder": "Aggiungi un branch esistente…",
+      "connectFirst": "Connetti GitHub per aggiungere branch esistenti.",
+      "protectedWarning": "{branch} e' un branch protetto. I push dell'esecuzione potrebbero essere rifiutati.",
+      "multiRepoHint": "La modalita' di lavoro non e' disponibile finche' questa attivita' coinvolge piu' di un servizio.",
+      "frozenHint": "Il branch di lavoro e' bloccato perche' esiste gia' una pull request per questa attivita'.",
+      "hint": "Affida a questa attivita' branch gia' esistenti del suo repository. Un branch di riferimento e' contesto in sola lettura che gli agenti possono ispezionare; nell'unico branch di lavoro l'esecuzione continua a costruire invece di creare un nuovo branch."
+    },
     "referenceRepos": {
       "title": "Repository di riferimento",
       "remove": "Rimuovi {repo}",
@@ -3640,6 +3654,7 @@
       "title": "Backend non configurato",
       "intro": "Il server è avviato ma non può funzionare finché non vengono forniti i parametri seguenti. Aggiungi i valori mancanti al tuo ambiente e ricarica.",
       "howToFix": "Come risolvere:",
+      "viewDocs": "Vedi la documentazione",
       "reload": "Ricarica",
       "hint": "Qui vengono mostrati solo i nomi delle variabili e come impostarle, mai valori segreti."
     }

package/i18n/locales/ja.json

@@ -9,6 +9,7 @@
       "title": "バックエンドが設定されていません",
       "intro": "サーバーは起動しましたが、以下の設定が指定されるまで動作できません。不足している値を環境に追加してから再読み込みしてください。",
       "howToFix": "対処方法:",
+      "viewDocs": "ドキュメントを表示",
       "reload": "再読み込み",
       "hint": "ここに表示されるのは変数名と設定方法のみで、秘密の値は表示されません。"
     }
@@ -924,6 +925,20 @@
       "involvedServicesEmpty": "接続済みのサービスはありません。ここで選択するには、サービスフレームでサービスを接続してください。",
       "involvedServiceStale": "このタスクのサービスとの接続が解除されています。次回の変更時に削除されます。"
     },
+    "aprioriBranches": {
+      "title": "既存のブランチ",
+      "mode": {
+        "reference": "参照",
+        "working": "作業"
+      },
+      "remove": "{branch} を削除",
+      "searchPlaceholder": "既存のブランチを追加…",
+      "connectFirst": "既存のブランチを追加するには GitHub を接続してください。",
+      "protectedWarning": "{branch} は保護されたブランチです。実行からのプッシュは拒否される場合があります。",
+      "multiRepoHint": "このタスクが複数のサービスにまたがる間は、作業モードを利用できません。",
+      "frozenHint": "このタスクには既にプルリクエストが存在するため、作業ブランチはロックされています。",
+      "hint": "このタスクにリポジトリの既存ブランチを渡します。参照ブランチはエージェントが閲覧できる読み取り専用のコンテキストです。唯一の作業ブランチでは、新しいブランチを作成せずに実行がそこで作業を続けます。"
+    },
     "referenceRepos": {
       "title": "Reference repositories",
       "remove": "Remove {repo}",

package/i18n/locales/pl.json

@@ -9,6 +9,7 @@
       "title": "Backend nie jest skonfigurowany",
       "intro": "Serwer wystartował, ale nie zadziała, dopóki nie uzupełnisz poniższych ustawień. Dodaj brakujące wartości do swojego środowiska i odśwież.",
       "howToFix": "Jak naprawić:",
+      "viewDocs": "Zobacz dokumentację",
       "reload": "Odśwież",
       "hint": "Tutaj pokazujemy tylko nazwy zmiennych i sposób ich ustawienia, nigdy wartości sekretnych."
     }
@@ -924,6 +925,20 @@
       "involvedServicesEmpty": "Brak połączonych usług. Połącz usługi na ramce usługi, aby móc je tutaj wybrać.",
       "involvedServiceStale": "Nie jest już połączona z usługą tego zadania; zostanie usunięta przy następnej zmianie."
     },
+    "aprioriBranches": {
+      "title": "Istniejące gałęzie",
+      "mode": {
+        "reference": "Referencyjna",
+        "working": "Robocza"
+      },
+      "remove": "Usuń {branch}",
+      "searchPlaceholder": "Dodaj istniejącą gałąź…",
+      "connectFirst": "Połącz GitHub, aby dodać istniejące gałęzie.",
+      "protectedWarning": "{branch} to chroniona gałąź. Wypchnięcia z uruchomienia mogą zostać odrzucone.",
+      "multiRepoHint": "Tryb roboczy jest niedostępny, gdy to zadanie obejmuje więcej niż jedną usługę.",
+      "frozenHint": "Gałąź robocza jest zablokowana, ponieważ dla tego zadania istnieje już pull request.",
+      "hint": "Przekaż temu zadaniu istniejące gałęzie jego repozytorium. Gałąź referencyjna to kontekst tylko do odczytu, który agenci mogą przeglądać; w jedynej gałęzi roboczej uruchomienie kontynuuje pracę zamiast tworzyć nową gałąź."
+    },
     "referenceRepos": {
       "title": "Reference repositories",
       "remove": "Remove {repo}",

package/i18n/locales/tr.json

@@ -9,6 +9,7 @@
       "title": "Arka uç yapılandırılmadı",
       "intro": "Sunucu başladı ancak aşağıdaki ayarlar sağlanana kadar çalışamaz. Eksik değerleri ortamınıza ekleyip yeniden yükleyin.",
       "howToFix": "Nasıl düzeltilir:",
+      "viewDocs": "Belgeleri görüntüle",
       "reload": "Yeniden yükle",
       "hint": "Burada yalnızca değişken adları ve nasıl ayarlanacakları gösterilir, asla gizli değerler değil."
     }
@@ -924,6 +925,20 @@
       "involvedServicesEmpty": "Bağlı servis yok. Burada seçebilmek için servis çerçevesinde servisleri bağlayın.",
       "involvedServiceStale": "Artık bu görevin servisine bağlı değil; bir sonraki değişiklikte kaldırılacak."
     },
+    "aprioriBranches": {
+      "title": "Mevcut dallar",
+      "mode": {
+        "reference": "Referans",
+        "working": "Çalışma"
+      },
+      "remove": "{branch} öğesini kaldır",
+      "searchPlaceholder": "Mevcut bir dal ekle…",
+      "connectFirst": "Mevcut dalları eklemek için GitHub'ı bağlayın.",
+      "protectedWarning": "{branch} korumalı bir dal. Çalıştırmadan yapılan göndermeler reddedilebilir.",
+      "multiRepoHint": "Bu görev birden fazla servisi kapsadığı sürece çalışma modu kullanılamaz.",
+      "frozenHint": "Bu görev için zaten bir çekme isteği bulunduğundan çalışma dalı kilitli.",
+      "hint": "Bu göreve deposunun mevcut dallarını verin. Referans dalı, ajanların inceleyebileceği salt okunur bir bağlamdır; tek çalışma dalında çalıştırma, yeni bir dal oluşturmak yerine orada geliştirmeye devam eder."
+    },
     "referenceRepos": {
       "title": "Reference repositories",
       "remove": "Remove {repo}",

package/i18n/locales/uk.json

@@ -9,6 +9,7 @@
       "title": "Бекенд не налаштовано",
       "intro": "Сервер запустився, але не працюватиме, доки не буде задано наведені нижче параметри. Додайте відсутні значення до свого середовища та перезавантажте.",
       "howToFix": "Як виправити:",
+      "viewDocs": "Переглянути документацію",
       "reload": "Перезавантажити",
       "hint": "Тут показано лише назви змінних і як їх задати, ніколи не секретні значення."
     }
@@ -924,6 +925,20 @@
       "involvedServicesEmpty": "Немає з'єднаних сервісів. З'єднайте сервіси на рамці сервісу, щоб вибрати їх тут.",
       "involvedServiceStale": "Більше не з'єднаний із сервісом цього завдання; буде видалений під час наступної зміни."
     },
+    "aprioriBranches": {
+      "title": "Наявні гілки",
+      "mode": {
+        "reference": "Довідкова",
+        "working": "Робоча"
+      },
+      "remove": "Вилучити {branch}",
+      "searchPlaceholder": "Додати наявну гілку…",
+      "connectFirst": "Під'єднайте GitHub, щоб додавати наявні гілки.",
+      "protectedWarning": "{branch} — захищена гілка. Надсилання з виконання можуть бути відхилені.",
+      "multiRepoHint": "Робочий режим недоступний, доки це завдання охоплює більше ніж один сервіс.",
+      "frozenHint": "Робочу гілку заблоковано, оскільки для цього завдання вже існує pull request.",
+      "hint": "Передайте цьому завданню наявні гілки його репозиторію. Довідкова гілка — це контекст лише для читання, який агенти можуть переглядати; в єдиній робочій гілці виконання продовжує розробку замість створення нової гілки."
+    },
     "referenceRepos": {
       "title": "Reference repositories",
       "remove": "Remove {repo}",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.112.0",
+  "version": "0.114.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.125.0"
+    "@cat-factory/contracts": "0.126.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",