@cat-factory/app 0.170.0 → 0.171.0

package/app/components/ralph/RalphLoopResultView.vue

@@ -36,20 +36,33 @@ const meta = computed(() => agentKindMeta('ralph'))
 
 // Iterations, newest-first for the timeline.
 const attempts = computed(() => [...(ralph.value?.attemptLog ?? [])].reverse())
+// How many earlier iterations the backend's log cap dropped (0 when the history is complete).
+const droppedAttempts = computed(() => ralph.value?.droppedAttempts ?? 0)
 
 /**
  * The display status, rolled up from the persisted loop state + the run status:
  *  - `passed`  — the step finished (the validation command exited 0);
- *  - `gave-up` — the run failed here (the iteration budget was spent);
+ *  - `stalled` — the run failed here BEFORE the budget ran out, because consecutive iterations
+ *                stopped changing the branch;
+ *  - `gave-up` — the run failed here with the iteration budget spent;
  *  - `running` — an iteration is in flight;
  *  - `failing` — the last validation failed and another iteration is about to run.
+ *
+ * The stall is derived from "ended short of the budget" rather than from the streak count, so
+ * the view never has to keep a copy of the engine's no-progress limit in step with it. Telling
+ * the two apart matters: a loop that stopped at 3 of 20 reads as an unexplained give-up
+ * otherwise, and the fix for a stall (change the task or the command) is not the fix for a
+ * spent budget (give it more room).
  */
-type RalphDisplayStatus = 'passed' | 'gave-up' | 'running' | 'failing'
+type RalphDisplayStatus = 'passed' | 'stalled' | 'gave-up' | 'running' | 'failing'
 const status = computed<RalphDisplayStatus>(() => {
   const s = step.value
   if (!s) return 'running'
   if (s.state === 'done') return 'passed'
-  if (instance.value?.status === 'failed') return 'gave-up'
+  if (instance.value?.status === 'failed') {
+    const r = ralph.value
+    return r && r.attempts > 0 && r.attempts < r.maxIterations ? 'stalled' : 'gave-up'
+  }
   if (s.container?.status === 'starting' || s.container?.status === 'up') return 'running'
   return 'failing'
 })
@@ -71,6 +84,12 @@ const STATUS_META = computed<
     icon: 'i-lucide-circle-check',
     text: 'text-emerald-300',
   },
+  stalled: {
+    label: t('ralph.status.stalled'),
+    badge: 'error',
+    icon: 'i-lucide-circle-slash',
+    text: 'text-rose-300',
+  },
   'gave-up': {
     label: t('ralph.status.gaveUp'),
     badge: 'error',
@@ -162,11 +181,30 @@ const STATUS_META = computed<
             <UIcon name="i-lucide-external-link" class="h-3 w-3" />
           </a>
 
+          <!-- Why a loop that stopped short of its budget stopped: without this the count in
+               the sidebar (e.g. "3 of 20") reads as an unexplained abandonment. -->
+          <p
+            v-if="status === 'stalled'"
+            class="mt-3 rounded-md border border-rose-900/60 bg-rose-950/30 px-3 py-2 text-[12px] leading-relaxed text-rose-200"
+            data-testid="ralph-stalled-note"
+          >
+            {{ t('ralph.stalledNote') }}
+          </p>
+
           <!-- Iteration history: what each pass produced and whether its validation passed. -->
           <section v-if="attempts.length" class="mt-5">
             <h3 class="mb-2 text-[11px] font-semibold uppercase tracking-wide text-slate-500">
               {{ t('ralph.iterationsHeading') }}
             </h3>
+            <!-- The log is capped (it rides the run's detail blob); say so rather than letting a
+                 long loop's partial history read as if those iterations never ran. -->
+            <p
+              v-if="droppedAttempts"
+              class="mb-2 text-[11px] text-slate-500"
+              data-testid="ralph-iterations-truncated"
+            >
+              {{ t('ralph.iterationsTruncated', { count: droppedAttempts }, droppedAttempts) }}
+            </p>
             <ol class="space-y-2">
               <li
                 v-for="a in attempts"

package/i18n/locales/de.json

@@ -5423,6 +5423,7 @@
     "subtitle": "Eine dauerhafte Schleife: Aufgabe bearbeiten, Validierungsbefehl ausführen und wiederholen, bis er erfolgreich ist.",
     "status": {
       "passed": "Bestanden",
+      "stalled": "Blockiert",
       "gaveUp": "Aufgegeben",
       "running": "Läuft",
       "failing": "Fehlgeschlagen"
@@ -5431,7 +5432,9 @@
     "validationCommand": "Validierungsbefehl",
     "lastOutput": "Letzte Validierung (Exit {exit})",
     "viewPr": "Pull Request ansehen",
+    "stalledNote": "Die Schleife wurde vorzeitig beendet: Aufeinanderfolgende Iterationen haben den Branch nicht verändert und der Validierungsbefehl schlägt weiterhin fehl, daher wurde das restliche Budget nicht verbraucht. Wahrscheinlich muss die Aufgabe oder der Validierungsbefehl geändert werden, bevor ein erneuter Versuch hilft.",
     "iterationsHeading": "Iterationen",
+    "iterationsTruncated": "{count} frühere Iteration wird nicht angezeigt (der Verlauf ist begrenzt). | {count} frühere Iterationen werden nicht angezeigt (der Verlauf ist begrenzt).",
     "iteration": "Iteration {number}",
     "iterationPassed": "Validierung bestanden",
     "iterationFailed": "Exit {exit}",

package/i18n/locales/en.json

@@ -5573,6 +5573,7 @@
     "subtitle": "A persistent loop: work the task, run the validation command, and repeat until it passes.",
     "status": {
       "passed": "Passed",
+      "stalled": "Stalled",
       "gaveUp": "Gave up",
       "running": "Running",
       "failing": "Failing"
@@ -5581,7 +5582,9 @@
     "validationCommand": "Validation command",
     "lastOutput": "Latest validation (exit {exit})",
     "viewPr": "View pull request",
+    "stalledNote": "The loop stopped early: consecutive iterations left the branch unchanged and the validation command still fails, so it did not spend the rest of its budget. The task or the validation command likely needs a change before a retry can help.",
     "iterationsHeading": "Iterations",
+    "iterationsTruncated": "{count} earlier iteration is not shown (the history is capped). | {count} earlier iterations are not shown (the history is capped).",
     "iteration": "Iteration {number}",
     "iterationPassed": "validation passed",
     "iterationFailed": "exit {exit}",

package/i18n/locales/es.json

@@ -5411,6 +5411,7 @@
     "subtitle": "Un bucle persistente: trabaja la tarea, ejecuta el comando de validación y repite hasta que pase.",
     "status": {
       "passed": "Superado",
+      "stalled": "Estancado",
       "gaveUp": "Abandonado",
       "running": "En ejecución",
       "failing": "Fallando"
@@ -5419,7 +5420,9 @@
     "validationCommand": "Comando de validación",
     "lastOutput": "Última validación (salida {exit})",
     "viewPr": "Ver pull request",
+    "stalledNote": "El bucle se detuvo antes de tiempo: iteraciones consecutivas dejaron la rama sin cambios y el comando de validación sigue fallando, por lo que no gastó el resto de su presupuesto. Probablemente haya que cambiar la tarea o el comando de validación para que un reintento sirva de algo.",
     "iterationsHeading": "Iteraciones",
+    "iterationsTruncated": "No se muestra {count} iteración anterior (el historial está limitado). | No se muestran {count} iteraciones anteriores (el historial está limitado).",
     "iteration": "Iteración {number}",
     "iterationPassed": "validación superada",
     "iterationFailed": "salida {exit}",

package/i18n/locales/fr.json

@@ -5411,6 +5411,7 @@
     "subtitle": "Une boucle persistante : traiter la tâche, exécuter la commande de validation, et recommencer jusqu'à ce qu'elle réussisse.",
     "status": {
       "passed": "Réussi",
+      "stalled": "Bloquée",
       "gaveUp": "Abandonné",
       "running": "En cours",
       "failing": "En échec"
@@ -5419,7 +5420,9 @@
     "validationCommand": "Commande de validation",
     "lastOutput": "Dernière validation (code {exit})",
     "viewPr": "Voir la pull request",
+    "stalledNote": "La boucle s'est arrêtée prématurément : des itérations consécutives ont laissé la branche inchangée et la commande de validation échoue toujours, elle n'a donc pas consommé le reste de son budget. La tâche ou la commande de validation doit probablement être modifiée pour qu'une relance serve à quelque chose.",
     "iterationsHeading": "Itérations",
+    "iterationsTruncated": "{count} itération antérieure n'est pas affichée (l'historique est plafonné). | {count} itérations antérieures ne sont pas affichées (l'historique est plafonné).",
     "iteration": "Itération {number}",
     "iterationPassed": "validation réussie",
     "iterationFailed": "code {exit}",

package/i18n/locales/he.json

@@ -5422,6 +5422,7 @@
     "subtitle": "לולאה מתמשכת: לעבוד על המשימה, להריץ את פקודת האימות, ולחזור עד שהיא עוברת.",
     "status": {
       "passed": "עבר",
+      "stalled": "נתקע",
       "gaveUp": "ויתר",
       "running": "פועל",
       "failing": "נכשל"
@@ -5430,7 +5431,9 @@
     "validationCommand": "פקודת אימות",
     "lastOutput": "אימות אחרון (יציאה {exit})",
     "viewPr": "הצג בקשת משיכה",
+    "stalledNote": "הלולאה נעצרה מוקדם: איטרציות רצופות לא שינו את הענף ופקודת האימות עדיין נכשלת, ולכן היא לא ניצלה את שארית התקציב. כנראה שצריך לשנות את המשימה או את פקודת האימות לפני שניסיון חוזר יועיל.",
     "iterationsHeading": "איטרציות",
+    "iterationsTruncated": "איטרציה קודמת אחת אינה מוצגת (ההיסטוריה מוגבלת). | {count} איטרציות קודמות אינן מוצגות (ההיסטוריה מוגבלת).",
     "iteration": "איטרציה {number}",
     "iterationPassed": "האימות עבר",
     "iterationFailed": "יציאה {exit}",

package/i18n/locales/it.json

@@ -5423,6 +5423,7 @@
     "subtitle": "Un ciclo persistente: lavora sull'attività, esegui il comando di validazione e ripeti finché non passa.",
     "status": {
       "passed": "Superato",
+      "stalled": "In stallo",
       "gaveUp": "Interrotto",
       "running": "In esecuzione",
       "failing": "In errore"
@@ -5431,7 +5432,9 @@
     "validationCommand": "Comando di validazione",
     "lastOutput": "Ultima validazione (uscita {exit})",
     "viewPr": "Visualizza pull request",
+    "stalledNote": "Il ciclo si è fermato in anticipo: iterazioni consecutive hanno lasciato il branch invariato e il comando di validazione continua a fallire, quindi non ha consumato il resto del budget. Probabilmente occorre modificare il task o il comando di validazione prima che un nuovo tentativo possa servire.",
     "iterationsHeading": "Iterazioni",
+    "iterationsTruncated": "{count} iterazione precedente non è mostrata (la cronologia è limitata). | {count} iterazioni precedenti non sono mostrate (la cronologia è limitata).",
     "iteration": "Iterazione {number}",
     "iterationPassed": "validazione superata",
     "iterationFailed": "uscita {exit}",

package/i18n/locales/ja.json

@@ -5423,6 +5423,7 @@
     "subtitle": "永続的なループ：タスクを進め、検証コマンドを実行し、成功するまで繰り返します。",
     "status": {
       "passed": "合格",
+      "stalled": "停滞",
       "gaveUp": "中止",
       "running": "実行中",
       "failing": "失敗中"
@@ -5431,7 +5432,9 @@
     "validationCommand": "検証コマンド",
     "lastOutput": "最新の検証（終了コード {exit}）",
     "viewPr": "プルリクエストを表示",
+    "stalledNote": "ループは早期に停止しました。連続する反復でブランチが変化せず、検証コマンドも失敗し続けたため、残りの上限を使い切らずに終了しています。再実行が有効になるには、タスクか検証コマンドの変更が必要と思われます。",
     "iterationsHeading": "反復",
+    "iterationsTruncated": "以前の反復 {count} 件は表示されていません (履歴は上限付きです)。",
     "iteration": "反復 {number}",
     "iterationPassed": "検証に合格",
     "iterationFailed": "終了コード {exit}",

package/i18n/locales/pl.json

@@ -5411,6 +5411,7 @@
     "subtitle": "Trwała pętla: pracuj nad zadaniem, uruchom polecenie walidacji i powtarzaj, aż się powiedzie.",
     "status": {
       "passed": "Zaliczono",
+      "stalled": "Utknęła",
       "gaveUp": "Poddano się",
       "running": "Działa",
       "failing": "Niepowodzenie"
@@ -5419,7 +5420,9 @@
     "validationCommand": "Polecenie walidacji",
     "lastOutput": "Ostatnia walidacja (kod {exit})",
     "viewPr": "Zobacz pull request",
+    "stalledNote": "Pętla zatrzymała się przedwcześnie: kolejne iteracje nie zmieniły gałęzi, a polecenie walidacji nadal kończy się niepowodzeniem, więc nie zużyła reszty budżetu. Zanim ponowna próba cokolwiek da, prawdopodobnie trzeba zmienić zadanie lub polecenie walidacji.",
     "iterationsHeading": "Iteracje",
+    "iterationsTruncated": "Nie pokazano {count} wcześniejszej iteracji (historia jest ograniczona). | Nie pokazano {count} wcześniejszych iteracji (historia jest ograniczona).",
     "iteration": "Iteracja {number}",
     "iterationPassed": "walidacja zaliczona",
     "iterationFailed": "kod {exit}",

package/i18n/locales/tr.json

@@ -5423,6 +5423,7 @@
     "subtitle": "Kalıcı bir döngü: görev üzerinde çalış, doğrulama komutunu çalıştır ve geçene kadar tekrarla.",
     "status": {
       "passed": "Geçti",
+      "stalled": "Takıldı",
       "gaveUp": "Vazgeçildi",
       "running": "Çalışıyor",
       "failing": "Başarısız"
@@ -5431,7 +5432,9 @@
     "validationCommand": "Doğrulama komutu",
     "lastOutput": "Son doğrulama (çıkış {exit})",
     "viewPr": "Pull request'i görüntüle",
+    "stalledNote": "Döngü erken durdu: ardışık yinelemeler dalı değiştirmedi ve doğrulama komutu hâlâ başarısız oluyor, bu yüzden bütçesinin kalanını harcamadı. Yeniden denemenin işe yaraması için muhtemelen görevin ya da doğrulama komutunun değişmesi gerekiyor.",
     "iterationsHeading": "Yinelemeler",
+    "iterationsTruncated": "Önceki {count} yineleme gösterilmiyor (geçmiş sınırlıdır).",
     "iteration": "Yineleme {number}",
     "iterationPassed": "doğrulama geçti",
     "iterationFailed": "çıkış {exit}",

package/i18n/locales/uk.json

@@ -5411,6 +5411,7 @@
     "subtitle": "Постійний цикл: працюйте над завданням, запускайте команду перевірки та повторюйте, доки вона не пройде.",
     "status": {
       "passed": "Пройдено",
+      "stalled": "Застрягло",
       "gaveUp": "Припинено",
       "running": "Виконується",
       "failing": "Помилка"
@@ -5419,7 +5420,9 @@
     "validationCommand": "Команда перевірки",
     "lastOutput": "Остання перевірка (код {exit})",
     "viewPr": "Переглянути pull request",
+    "stalledNote": "Цикл зупинився достроково: послідовні ітерації не змінили гілку, а команда перевірки досі не проходить, тож решту бюджету не витрачено. Імовірно, перш ніж повторний запуск допоможе, потрібно змінити завдання або команду перевірки.",
     "iterationsHeading": "Ітерації",
+    "iterationsTruncated": "Не показано {count} попередню ітерацію (історія обмежена). | Не показано {count} попередніх ітерацій (історія обмежена).",
     "iteration": "Ітерація {number}",
     "iterationPassed": "перевірку пройдено",
     "iterationFailed": "код {exit}",

package/package.json

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