@cat-factory/app 0.121.2 → 0.122.0

package/app/components/board/AddTaskModal.vue

@@ -81,6 +81,7 @@ const TASK_TYPES = computed<{ value: TaskTypeChoice; label: string; icon: string
       label: t('board.addTask.types.review'),
       icon: 'i-lucide-clipboard-check',
     },
+    { value: 'ralph', label: t('board.addTask.types.ralph'), icon: 'i-lucide-infinity' },
     { value: 'recurring', label: t('board.addTask.types.recurring'), icon: 'i-lucide-repeat' },
   ]
   // A document repository only accepts document/spike tasks (see BoardService.addTask).
@@ -309,6 +310,15 @@ const selectedPipelineLabel = computed(
   () => pipelines.getPipeline(pipelineId.value)?.name ?? t('board.addTask.chooseAtRunTime'),
 )
 
+// Picking the Ralph loop task type auto-selects its pipeline, so the per-task validation
+// command + iteration budget (contributed by the `ralph` agent) surface immediately — the
+// loop is meaningless without them, so "choose at run time" would be a dead end here.
+watch(taskType, (next) => {
+  if (next !== 'ralph') return
+  const ralph = pipelines.pipelines.find((p) => p.id === 'pl_ralph')
+  if (ralph) pipelineId.value = ralph.id
+})
+
 // Task-level agent config contributed by the selected pipeline's agents (e.g. the
 // Tester's environment). Editable up front; persisted on the task and frozen once
 // the contributing agent runs. Defaults to each descriptor's default until changed.
@@ -489,10 +499,20 @@ const { requestClose } = useUnsavedGuard({
 
 // A recurring task only needs a target frame (its details are filled in the schedule
 // modal); every other type needs a title. A review task additionally needs a target PR.
+// The Ralph loop's completion criterion (its `ralph.validationCommand` agent-config id). The
+// loop is meaningless without it, so the create form requires it up front — the backend also
+// refuses to start a Ralph run without one (a 422), this just fails fast in the UI.
+const RALPH_VALIDATION_COMMAND_ID = 'ralph.validationCommand'
+
 const canAdd = computed(() => {
   if (isRecurring.value) return recurringFrameId.value !== null
   if (title.value.trim().length === 0) return false
   if (taskType.value === 'review' && !parseReviewPrRef(reviewPrRef.value)) return false
+  if (
+    taskType.value === 'ralph' &&
+    configValue(RALPH_VALIDATION_COMMAND_ID, '').trim().length === 0
+  )
+    return false
   return true
 })
 
@@ -898,7 +918,7 @@ async function add() {
             </span>
             <div v-for="d in configDescriptors" :key="d.id" class="space-y-1">
               <div class="text-[11px] text-slate-400">{{ d.label }}</div>
-              <div class="flex flex-wrap gap-1">
+              <div v-if="d.type === 'select'" class="flex flex-wrap gap-1">
                 <UButton
                   v-for="opt in d.options"
                   :key="opt.value"
@@ -910,6 +930,15 @@ async function add() {
                   {{ opt.label }}
                 </UButton>
               </div>
+              <UInput
+                v-else
+                :model-value="configValue(d.id, d.default)"
+                :type="d.type === 'number' ? 'number' : 'text'"
+                :placeholder="d.placeholder"
+                size="xs"
+                :data-testid="`agent-config-${d.id}`"
+                @update:model-value="(v: string | number) => setConfig(d.id, String(v))"
+              />
               <p class="text-[11px] leading-snug text-slate-500">{{ d.description }}</p>
             </div>
           </div>

package/app/components/panels/StepResultViewHost.vue

@@ -28,6 +28,7 @@ import MergerResultView from '~/components/panels/MergerResultView.vue'
 import InitiativeTrackerWindow from '~/components/initiative/InitiativeTrackerWindow.vue'
 import InitiativePlanningWindow from '~/components/initiative/InitiativePlanningWindow.vue'
 import DocInterviewWindow from '~/components/docs/DocInterviewWindow.vue'
+import RalphLoopResultView from '~/components/ralph/RalphLoopResultView.vue'
 
 const ui = useUiStore()
 
@@ -72,6 +73,9 @@ const STEP_RESULT_VIEWS: Record<string, Component> = {
   // The interactive document-interview gate (WS5): the interviewer's clarifying questions +
   // answer / continue / proceed, opened as the `doc-interviewer` step's result view.
   'doc-interview': DocInterviewWindow,
+  // The Ralph loop: the persistent retry-until-done iteration history + the programmatic
+  // validation command + its latest exit code / output. Opened as the `ralph` step's view.
+  'ralph-loop': RalphLoopResultView,
 }
 
 const active = computed<Component | null>(() => {

package/app/components/ralph/RalphLoopResultView.vue

@@ -0,0 +1,272 @@
+<script setup lang="ts">
+// Ralph loop window — the dedicated surface for a `ralph` step, opened via the universal
+// result-view host. It surfaces the persistent retry-until-done loop the backend persists on
+// `step.ralph`: the programmatic completion command, the iteration count vs the budget, the
+// most recent validation exit code + output, and the per-iteration history. Synchronous — it
+// reads straight off the execution step (no fetch on open).
+import { computed } from 'vue'
+import { agentKindMeta } from '~/utils/catalog'
+import type { RalphStepState } from '~/types/execution'
+import StepRestartControl from '~/components/panels/StepRestartControl.vue'
+import StepRunMeta from '~/components/panels/StepRunMeta.vue'
+import CopyButton from '~/components/common/CopyButton.vue'
+
+const board = useBoardStore()
+const execution = useExecutionStore()
+const { t, d } = useI18n()
+
+const { open, blockId, instanceId, stepIndex, close } = useResultView('ralph-loop')
+const block = computed(() => (blockId.value ? board.getBlock(blockId.value) : undefined))
+const prUrl = computed(() => block.value?.pullRequest?.url ?? null)
+
+const instance = computed(() =>
+  instanceId.value === null ? null : (execution.getInstance(instanceId.value) ?? null),
+)
+const step = computed(() => {
+  if (instance.value === null || stepIndex.value === null) return null
+  return instance.value.steps[stepIndex.value] ?? null
+})
+const ralph = computed<RalphStepState | null>(() => step.value?.ralph ?? null)
+const meta = computed(() => agentKindMeta('ralph'))
+
+// Iterations, newest-first for the timeline.
+const attempts = computed(() => [...(ralph.value?.attemptLog ?? [])].reverse())
+
+/**
+ * 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);
+ *  - `running` — an iteration is in flight;
+ *  - `failing` — the last validation failed and another iteration is about to run.
+ */
+type RalphDisplayStatus = 'passed' | '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 (s.container?.status === 'starting' || s.container?.status === 'up') return 'running'
+  return 'failing'
+})
+
+const STATUS_META = computed<
+  Record<
+    RalphDisplayStatus,
+    {
+      label: string
+      badge: 'success' | 'warning' | 'error' | 'neutral'
+      icon: string
+      text: string
+    }
+  >
+>(() => ({
+  passed: {
+    label: t('ralph.status.passed'),
+    badge: 'success',
+    icon: 'i-lucide-circle-check',
+    text: 'text-emerald-300',
+  },
+  'gave-up': {
+    label: t('ralph.status.gaveUp'),
+    badge: 'error',
+    icon: 'i-lucide-circle-x',
+    text: 'text-rose-300',
+  },
+  running: {
+    label: t('ralph.status.running'),
+    badge: 'warning',
+    icon: 'i-lucide-loader',
+    text: 'text-amber-300',
+  },
+  failing: {
+    label: t('ralph.status.failing'),
+    badge: 'error',
+    icon: 'i-lucide-circle-x',
+    text: 'text-rose-300',
+  },
+}))
+</script>
+
+<template>
+  <Teleport to="body">
+    <div
+      v-if="open"
+      class="fixed inset-0 z-50 flex max-h-[100dvh] items-stretch justify-center bg-slate-950/70 backdrop-blur-sm"
+      @click.self="close"
+    >
+      <div
+        class="m-4 flex w-full max-w-3xl flex-col overflow-hidden rounded-2xl border border-slate-800 bg-slate-900 shadow-2xl"
+        role="dialog"
+        aria-modal="true"
+        data-testid="ralph-loop-window"
+      >
+        <header class="flex items-center gap-3 border-b border-slate-800 px-5 py-3">
+          <span
+            class="flex h-8 w-8 items-center justify-center rounded-lg bg-violet-500/15 text-violet-300"
+          >
+            <UIcon :name="meta.icon" class="h-4 w-4" />
+          </span>
+          <div class="min-w-0 flex-1">
+            <h2 class="truncate text-sm font-semibold text-slate-100">
+              {{ meta.label }}{{ block ? ` — ${block.title}` : '' }}
+            </h2>
+            <p class="truncate text-[11px] text-slate-400">{{ t('ralph.subtitle') }}</p>
+          </div>
+          <UBadge
+            :color="STATUS_META[status].badge"
+            variant="subtle"
+            size="sm"
+            data-testid="ralph-status"
+          >
+            {{ STATUS_META[status].label }}
+          </UBadge>
+          <StepRestartControl
+            :instance-id="instanceId"
+            :step-index="stepIndex"
+            @restarted="close"
+          />
+          <button
+            class="rounded-md p-1.5 text-slate-400 hover:bg-slate-800 hover:text-slate-200"
+            @click="close"
+          >
+            <UIcon name="i-lucide-x" class="h-4 w-4" />
+          </button>
+        </header>
+
+        <div class="flex min-h-0 flex-1">
+          <div class="min-w-0 flex-1 overflow-y-auto px-5 py-4">
+            <div
+              v-if="!ralph"
+              class="flex h-full flex-col items-center justify-center gap-2 text-center text-slate-400"
+            >
+              <UIcon :name="meta.icon" class="h-8 w-8 opacity-40" />
+              <p class="text-sm">{{ t('ralph.noActivity') }}</p>
+            </div>
+
+            <template v-else>
+              <!-- The completion criterion. -->
+              <h3 class="mb-1.5 text-[11px] font-semibold uppercase tracking-wide text-slate-500">
+                {{ t('ralph.validationCommand') }}
+              </h3>
+              <div class="relative rounded-md border border-slate-800 bg-slate-950/60 px-3 py-2">
+                <CopyButton :text="ralph.validationCommand" class="absolute end-1 top-1" />
+                <code class="block whitespace-pre-wrap pe-8 font-mono text-[12px] text-slate-200">{{
+                  ralph.validationCommand
+                }}</code>
+              </div>
+
+              <!-- The most recent validation output. -->
+              <template v-if="ralph.lastValidationTail">
+                <h3
+                  class="mb-1.5 mt-4 text-[11px] font-semibold uppercase tracking-wide text-slate-500"
+                >
+                  {{ t('ralph.lastOutput', { exit: ralph.lastExitCode ?? '?' }) }}
+                </h3>
+                <div class="relative rounded-md border border-slate-800 bg-slate-950/60 px-3 py-2">
+                  <CopyButton :text="ralph.lastValidationTail" class="absolute end-1 top-1" />
+                  <pre
+                    class="whitespace-pre-wrap pe-8 font-mono text-[11px] leading-relaxed text-slate-400"
+                    >{{ ralph.lastValidationTail }}</pre
+                  >
+                </div>
+              </template>
+
+              <a
+                v-if="prUrl"
+                :href="prUrl"
+                target="_blank"
+                rel="noopener"
+                class="mt-3 inline-flex items-center gap-1 text-[12px] text-sky-300 hover:text-sky-200 hover:underline"
+              >
+                {{ t('ralph.viewPr') }}
+                <UIcon name="i-lucide-external-link" class="h-3 w-3" />
+              </a>
+
+              <!-- 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>
+                <ol class="space-y-2">
+                  <li
+                    v-for="a in attempts"
+                    :key="a.attempt"
+                    class="rounded-md border border-slate-800 bg-slate-950/40 px-3 py-2"
+                    data-testid="ralph-iteration"
+                  >
+                    <div class="flex items-center gap-2">
+                      <UIcon
+                        :name="a.validationPassed ? 'i-lucide-circle-check' : 'i-lucide-circle-x'"
+                        class="h-3.5 w-3.5"
+                        :class="a.validationPassed ? 'text-emerald-400' : 'text-rose-400'"
+                      />
+                      <span class="text-[12px] font-medium text-slate-200">
+                        {{ t('ralph.iteration', { number: a.attempt }) }}
+                      </span>
+                      <span class="text-[11px] text-slate-500">
+                        {{
+                          a.validationPassed
+                            ? t('ralph.iterationPassed')
+                            : t('ralph.iterationFailed', { exit: a.exitCode ?? '?' })
+                        }}
+                      </span>
+                      <span class="ms-auto text-[10px] text-slate-600">{{
+                        d(new Date(a.at), 'long')
+                      }}</span>
+                    </div>
+                    <p
+                      v-if="a.summary"
+                      class="mt-1 whitespace-pre-wrap text-[12px] leading-relaxed text-slate-400"
+                    >
+                      {{ a.summary }}
+                    </p>
+                  </li>
+                </ol>
+              </section>
+            </template>
+          </div>
+
+          <aside
+            class="hidden w-60 shrink-0 flex-col gap-4 border-s border-slate-800 bg-slate-900/50 px-4 py-4 lg:flex"
+          >
+            <div v-if="ralph">
+              <h4 class="mb-2 text-[11px] font-semibold uppercase tracking-wide text-slate-500">
+                {{ t('ralph.sidebar.state') }}
+              </h4>
+              <div class="flex items-center gap-2 text-[13px]">
+                <UIcon
+                  :name="STATUS_META[status].icon"
+                  class="h-4 w-4"
+                  :class="STATUS_META[status].text"
+                />
+                <span :class="STATUS_META[status].text">{{ STATUS_META[status].label }}</span>
+              </div>
+            </div>
+            <div v-if="ralph">
+              <h4 class="mb-1 text-[11px] font-semibold uppercase tracking-wide text-slate-500">
+                {{ t('ralph.sidebar.iterations') }}
+              </h4>
+              <p class="text-[12px] text-slate-300" data-testid="ralph-iteration-count">
+                {{
+                  t('ralph.sidebar.count', { attempts: ralph.attempts, max: ralph.maxIterations })
+                }}
+              </p>
+            </div>
+            <StepRunMeta
+              v-if="step"
+              :step="step"
+              :instance-id="instanceId ?? undefined"
+              :step-number="stepIndex === null ? undefined : stepIndex + 1"
+              :total-steps="instance?.steps.length"
+              :run-failed="instance?.status === 'failed'"
+              :failure-at="instance?.failure?.occurredAt"
+            />
+            <p class="mt-auto text-[10px] leading-relaxed text-slate-600">
+              {{ t('ralph.sidebar.footer') }}
+            </p>
+          </aside>
+        </div>
+      </div>
+    </div>
+  </Teleport>
+</template>

package/app/components/settings/WorkspaceSettingsPanel.vue

@@ -99,6 +99,7 @@ const TASK_TYPE_KEYS: Record<CreateTaskType, string> = {
   document: 'settings.workspaceSettings.taskTypes.document',
   spike: 'settings.workspaceSettings.taskTypes.spike',
   review: 'settings.workspaceSettings.taskTypes.review',
+  ralph: 'settings.workspaceSettings.taskTypes.ralph',
 }
 
 const MODES = computed<{ value: TaskLimitMode; label: string }[]>(() => [

package/app/types/execution.ts

@@ -47,6 +47,9 @@ export type {
   GateFailingCheck,
   GateAttempt,
   GateStepState,
+  RalphStepState,
+  RalphAttempt,
+  RalphVerdict,
   TesterStepState,
   HumanTestEnvironment,
   RunEnvironment,

package/i18n/locales/de.json

@@ -724,7 +724,8 @@
         "bug": "Bug",
         "document": "Dokument",
         "spike": "Spike",
-        "review": "Review"
+        "review": "Review",
+        "ralph": "Ralph-Schleife"
       },
       "observability": {
         "heading": "Agenten-Observability",
@@ -2026,7 +2027,8 @@
         "document": "Dokument",
         "spike": "Spike",
         "recurring": "Wiederkehrend",
-        "review": "Review"
+        "review": "Review",
+        "ralph": "Ralph-Schleife"
       },
       "recurringWithFrame": "Eine wiederkehrende Aufgabe führt eine Pipeline in einem Takt aus. Fahren Sie fort, um Zeitplan + Prompt festzulegen.",
       "recurringNoFrame": "Eine wiederkehrende Aufgabe muss auf einem Service liegen. Fügen Sie sie aus einem Service-Frame (oder einem darin enthaltenen Modul) hinzu.",
@@ -4797,5 +4799,28 @@
       "test": "Tests",
       "other": "Sonstiges"
     }
+  },
+  "ralph": {
+    "subtitle": "Eine dauerhafte Schleife: Aufgabe bearbeiten, Validierungsbefehl ausführen und wiederholen, bis er erfolgreich ist.",
+    "status": {
+      "passed": "Bestanden",
+      "gaveUp": "Aufgegeben",
+      "running": "Läuft",
+      "failing": "Fehlgeschlagen"
+    },
+    "noActivity": "Noch keine Iterationen.",
+    "validationCommand": "Validierungsbefehl",
+    "lastOutput": "Letzte Validierung (Exit {exit})",
+    "viewPr": "Pull Request ansehen",
+    "iterationsHeading": "Iterationen",
+    "iteration": "Iteration {number}",
+    "iterationPassed": "Validierung bestanden",
+    "iterationFailed": "Exit {exit}",
+    "sidebar": {
+      "state": "Status",
+      "iterations": "Iterationen",
+      "count": "{attempts} von {max}",
+      "footer": "Die Schleife wird wiederholt, bis der Validierungsbefehl erfolgreich ist oder das Iterationsbudget aufgebraucht ist."
+    }
   }
 }

package/i18n/locales/en.json

@@ -186,7 +186,8 @@
         "document": "Document",
         "spike": "Spike",
         "recurring": "Recurring",
-        "review": "Review"
+        "review": "Review",
+        "ralph": "Ralph loop"
       },
       "recurringWithFrame": "A recurring task runs a pipeline on a cadence. Continue to set the schedule + prompt.",
       "recurringNoFrame": "A recurring task must live on a service. Add it from a service frame (or a module inside one).",
@@ -2605,7 +2606,8 @@
         "bug": "bug",
         "document": "document",
         "spike": "spike",
-        "review": "review"
+        "review": "review",
+        "ralph": "Ralph loop"
       },
       "observability": {
         "heading": "Agent observability",
@@ -4923,5 +4925,28 @@
       "test": "Tests",
       "other": "Other"
     }
+  },
+  "ralph": {
+    "subtitle": "A persistent loop: work the task, run the validation command, and repeat until it passes.",
+    "status": {
+      "passed": "Passed",
+      "gaveUp": "Gave up",
+      "running": "Running",
+      "failing": "Failing"
+    },
+    "noActivity": "No iterations yet.",
+    "validationCommand": "Validation command",
+    "lastOutput": "Latest validation (exit {exit})",
+    "viewPr": "View pull request",
+    "iterationsHeading": "Iterations",
+    "iteration": "Iteration {number}",
+    "iterationPassed": "validation passed",
+    "iterationFailed": "exit {exit}",
+    "sidebar": {
+      "state": "State",
+      "iterations": "Iterations",
+      "count": "{attempts} of {max}",
+      "footer": "The loop retries until the validation command passes or the iteration budget is spent."
+    }
   }
 }

package/i18n/locales/es.json

@@ -168,7 +168,8 @@
         "document": "Documento",
         "spike": "Spike",
         "recurring": "Recurrente",
-        "review": "Revisión"
+        "review": "Revisión",
+        "ralph": "Bucle Ralph"
       },
       "recurringWithFrame": "Una tarea recurrente ejecuta una pipeline con cierta cadencia. Continúa para definir el horario y el prompt.",
       "recurringNoFrame": "Una tarea recurrente debe vivir en un servicio. Añádela desde un marco de servicio (o un módulo dentro de él).",
@@ -2420,7 +2421,8 @@
         "bug": "error",
         "document": "documento",
         "spike": "spike",
-        "review": "revisión"
+        "review": "revisión",
+        "ralph": "Bucle Ralph"
       },
       "observability": {
         "heading": "Observabilidad del agente",
@@ -4785,5 +4787,28 @@
       "test": "Pruebas",
       "other": "Otros"
     }
+  },
+  "ralph": {
+    "subtitle": "Un bucle persistente: trabaja la tarea, ejecuta el comando de validación y repite hasta que pase.",
+    "status": {
+      "passed": "Superado",
+      "gaveUp": "Abandonado",
+      "running": "En ejecución",
+      "failing": "Fallando"
+    },
+    "noActivity": "Aún no hay iteraciones.",
+    "validationCommand": "Comando de validación",
+    "lastOutput": "Última validación (salida {exit})",
+    "viewPr": "Ver pull request",
+    "iterationsHeading": "Iteraciones",
+    "iteration": "Iteración {number}",
+    "iterationPassed": "validación superada",
+    "iterationFailed": "salida {exit}",
+    "sidebar": {
+      "state": "Estado",
+      "iterations": "Iteraciones",
+      "count": "{attempts} de {max}",
+      "footer": "El bucle se repite hasta que el comando de validación pasa o se agota el presupuesto de iteraciones."
+    }
   }
 }

package/i18n/locales/fr.json

@@ -168,7 +168,8 @@
         "document": "Document",
         "spike": "Spike",
         "recurring": "Récurrent",
-        "review": "Revue"
+        "review": "Revue",
+        "ralph": "Boucle Ralph"
       },
       "recurringWithFrame": "Une tâche récurrente exécute une pipeline selon une cadence. Continuez pour définir le calendrier et le prompt.",
       "recurringNoFrame": "Une tâche récurrente doit appartenir à un service. Ajoutez-la depuis un cadre de service (ou un module à l’intérieur).",
@@ -2420,7 +2421,8 @@
         "bug": "bug",
         "document": "document",
         "spike": "spike",
-        "review": "revue"
+        "review": "revue",
+        "ralph": "Boucle Ralph"
       },
       "observability": {
         "heading": "Observabilité de l'agent",
@@ -4785,5 +4787,28 @@
       "test": "Tests",
       "other": "Autre"
     }
+  },
+  "ralph": {
+    "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",
+      "gaveUp": "Abandonné",
+      "running": "En cours",
+      "failing": "En échec"
+    },
+    "noActivity": "Aucune itération pour l'instant.",
+    "validationCommand": "Commande de validation",
+    "lastOutput": "Dernière validation (code {exit})",
+    "viewPr": "Voir la pull request",
+    "iterationsHeading": "Itérations",
+    "iteration": "Itération {number}",
+    "iterationPassed": "validation réussie",
+    "iterationFailed": "code {exit}",
+    "sidebar": {
+      "state": "État",
+      "iterations": "Itérations",
+      "count": "{attempts} sur {max}",
+      "footer": "La boucle réessaie jusqu'à ce que la commande de validation réussisse ou que le budget d'itérations soit épuisé."
+    }
   }
 }

package/i18n/locales/he.json

@@ -168,7 +168,8 @@
         "document": "מסמך",
         "spike": "ספייק",
         "recurring": "מחזורי",
-        "review": "סקירה"
+        "review": "סקירה",
+        "ralph": "לולאת Ralph"
       },
       "recurringWithFrame": "משימה מחזורית מריצה צינור במרווחים קבועים. המשך כדי להגדיר את התזמון והפרומפט.",
       "recurringNoFrame": "משימה מחזורית חייבת להתקיים על שירות. הוסף אותה ממסגרת שירות (או ממודול בתוכה).",
@@ -2541,7 +2542,8 @@
         "bug": "באג",
         "document": "מסמך",
         "spike": "חקירה",
-        "review": "סקירה"
+        "review": "סקירה",
+        "ralph": "לולאת Ralph"
       },
       "observability": {
         "heading": "תצפיתיות סוכנים",
@@ -4796,5 +4798,28 @@
       "test": "בדיקות",
       "other": "אחר"
     }
+  },
+  "ralph": {
+    "subtitle": "לולאה מתמשכת: לעבוד על המשימה, להריץ את פקודת האימות, ולחזור עד שהיא עוברת.",
+    "status": {
+      "passed": "עבר",
+      "gaveUp": "ויתר",
+      "running": "פועל",
+      "failing": "נכשל"
+    },
+    "noActivity": "עדיין אין איטרציות.",
+    "validationCommand": "פקודת אימות",
+    "lastOutput": "אימות אחרון (יציאה {exit})",
+    "viewPr": "הצג בקשת משיכה",
+    "iterationsHeading": "איטרציות",
+    "iteration": "איטרציה {number}",
+    "iterationPassed": "האימות עבר",
+    "iterationFailed": "יציאה {exit}",
+    "sidebar": {
+      "state": "מצב",
+      "iterations": "איטרציות",
+      "count": "{attempts} מתוך {max}",
+      "footer": "הלולאה חוזרת עד שפקודת האימות עוברת או שתקציב האיטרציות מסתיים."
+    }
   }
 }

package/i18n/locales/it.json

@@ -724,7 +724,8 @@
         "bug": "bug",
         "document": "documento",
         "spike": "spike",
-        "review": "revisione"
+        "review": "revisione",
+        "ralph": "Ciclo Ralph"
       },
       "observability": {
         "heading": "Osservabilita degli agenti",
@@ -2026,7 +2027,8 @@
         "document": "Documento",
         "spike": "Spike",
         "recurring": "Ricorrente",
-        "review": "Revisione"
+        "review": "Revisione",
+        "ralph": "Ciclo Ralph"
       },
       "recurringWithFrame": "Un'attività ricorrente esegue una pipeline a cadenza regolare. Continua per impostare la pianificazione e il prompt.",
       "recurringNoFrame": "Un'attività ricorrente deve risiedere su un servizio. Aggiungila da un frame di servizio (o da un modulo al suo interno).",
@@ -4797,5 +4799,28 @@
       "test": "Test",
       "other": "Altro"
     }
+  },
+  "ralph": {
+    "subtitle": "Un ciclo persistente: lavora sull'attività, esegui il comando di validazione e ripeti finché non passa.",
+    "status": {
+      "passed": "Superato",
+      "gaveUp": "Interrotto",
+      "running": "In esecuzione",
+      "failing": "In errore"
+    },
+    "noActivity": "Ancora nessuna iterazione.",
+    "validationCommand": "Comando di validazione",
+    "lastOutput": "Ultima validazione (uscita {exit})",
+    "viewPr": "Visualizza pull request",
+    "iterationsHeading": "Iterazioni",
+    "iteration": "Iterazione {number}",
+    "iterationPassed": "validazione superata",
+    "iterationFailed": "uscita {exit}",
+    "sidebar": {
+      "state": "Stato",
+      "iterations": "Iterazioni",
+      "count": "{attempts} di {max}",
+      "footer": "Il ciclo riprova finché il comando di validazione non passa o il budget di iterazioni è esaurito."
+    }
   }
 }

package/i18n/locales/ja.json

@@ -168,7 +168,8 @@
         "document": "ドキュメント",
         "spike": "スパイク",
         "recurring": "繰り返し",
-        "review": "レビュー"
+        "review": "レビュー",
+        "ralph": "Ralph ループ"
       },
       "recurringWithFrame": "繰り返しタスクは一定の周期でパイプラインを実行します。続行してスケジュールとプロンプトを設定してください。",
       "recurringNoFrame": "繰り返しタスクはサービス上に配置する必要があります。サービスフレーム（またはその中のモジュール）から追加してください。",
@@ -2542,7 +2543,8 @@
         "bug": "バグ",
         "document": "ドキュメント",
         "spike": "スパイク",
-        "review": "レビュー"
+        "review": "レビュー",
+        "ralph": "Ralph ループ"
       },
       "observability": {
         "heading": "エージェントの可観測性",
@@ -4797,5 +4799,28 @@
       "test": "テスト",
       "other": "その他"
     }
+  },
+  "ralph": {
+    "subtitle": "永続的なループ：タスクを進め、検証コマンドを実行し、成功するまで繰り返します。",
+    "status": {
+      "passed": "合格",
+      "gaveUp": "中止",
+      "running": "実行中",
+      "failing": "失敗中"
+    },
+    "noActivity": "まだ反復はありません。",
+    "validationCommand": "検証コマンド",
+    "lastOutput": "最新の検証（終了コード {exit}）",
+    "viewPr": "プルリクエストを表示",
+    "iterationsHeading": "反復",
+    "iteration": "反復 {number}",
+    "iterationPassed": "検証に合格",
+    "iterationFailed": "終了コード {exit}",
+    "sidebar": {
+      "state": "状態",
+      "iterations": "反復",
+      "count": "{max} 回中 {attempts} 回",
+      "footer": "検証コマンドが成功するか、反復の上限に達するまでループは再試行します。"
+    }
   }
 }

package/i18n/locales/pl.json

@@ -168,7 +168,8 @@
         "document": "Dokument",
         "spike": "Spike",
         "recurring": "Cykliczne",
-        "review": "Przegląd"
+        "review": "Przegląd",
+        "ralph": "Pętla Ralph"
       },
       "recurringWithFrame": "Zadanie cykliczne uruchamia pipeline w określonym rytmie. Kontynuuj, aby ustawić harmonogram i prompt.",
       "recurringNoFrame": "Zadanie cykliczne musi należeć do usługi. Dodaj je z ramki usługi (lub modułu w jej obrębie).",
@@ -2420,7 +2421,8 @@
         "bug": "błąd",
         "document": "dokument",
         "spike": "spike",
-        "review": "przegląd"
+        "review": "przegląd",
+        "ralph": "Pętla Ralph"
       },
       "observability": {
         "heading": "Obserwowalność agenta",
@@ -4785,5 +4787,28 @@
       "test": "Testy",
       "other": "Inne"
     }
+  },
+  "ralph": {
+    "subtitle": "Trwała pętla: pracuj nad zadaniem, uruchom polecenie walidacji i powtarzaj, aż się powiedzie.",
+    "status": {
+      "passed": "Zaliczono",
+      "gaveUp": "Poddano się",
+      "running": "Działa",
+      "failing": "Niepowodzenie"
+    },
+    "noActivity": "Brak iteracji.",
+    "validationCommand": "Polecenie walidacji",
+    "lastOutput": "Ostatnia walidacja (kod {exit})",
+    "viewPr": "Zobacz pull request",
+    "iterationsHeading": "Iteracje",
+    "iteration": "Iteracja {number}",
+    "iterationPassed": "walidacja zaliczona",
+    "iterationFailed": "kod {exit}",
+    "sidebar": {
+      "state": "Stan",
+      "iterations": "Iteracje",
+      "count": "{attempts} z {max}",
+      "footer": "Pętla ponawia próby, aż polecenie walidacji się powiedzie lub wyczerpie się budżet iteracji."
+    }
   }
 }

package/i18n/locales/tr.json

@@ -168,7 +168,8 @@
         "document": "Belge",
         "spike": "Spike",
         "recurring": "Yinelenen",
-        "review": "İnceleme"
+        "review": "İnceleme",
+        "ralph": "Ralph döngüsü"
       },
       "recurringWithFrame": "Yinelenen bir görev, bir işlem hattını belirli bir aralıkta çalıştırır. Programı ve istemi ayarlamak için devam edin.",
       "recurringNoFrame": "Yinelenen bir görev bir serviste bulunmalıdır. Bir servis çerçevesinden (veya içindeki bir modülden) ekleyin.",
@@ -2542,7 +2543,8 @@
         "bug": "hata",
         "document": "belge",
         "spike": "inceleme",
-        "review": "inceleme"
+        "review": "inceleme",
+        "ralph": "Ralph döngüsü"
       },
       "observability": {
         "heading": "Agent gözlemlenebilirliği",
@@ -4797,5 +4799,28 @@
       "test": "Testler",
       "other": "Diğer"
     }
+  },
+  "ralph": {
+    "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",
+      "gaveUp": "Vazgeçildi",
+      "running": "Çalışıyor",
+      "failing": "Başarısız"
+    },
+    "noActivity": "Henüz yineleme yok.",
+    "validationCommand": "Doğrulama komutu",
+    "lastOutput": "Son doğrulama (çıkış {exit})",
+    "viewPr": "Pull request'i görüntüle",
+    "iterationsHeading": "Yinelemeler",
+    "iteration": "Yineleme {number}",
+    "iterationPassed": "doğrulama geçti",
+    "iterationFailed": "çıkış {exit}",
+    "sidebar": {
+      "state": "Durum",
+      "iterations": "Yinelemeler",
+      "count": "{max} içinden {attempts}",
+      "footer": "Döngü, doğrulama komutu geçene kadar veya yineleme bütçesi tükenene kadar yeniden dener."
+    }
   }
 }

package/i18n/locales/uk.json

@@ -168,7 +168,8 @@
         "document": "Документ",
         "spike": "Spike",
         "recurring": "Періодичне",
-        "review": "Огляд"
+        "review": "Огляд",
+        "ralph": "Цикл Ralph"
       },
       "recurringWithFrame": "Періодичне завдання запускає конвеєр із заданою періодичністю. Продовжте, щоб задати розклад і промпт.",
       "recurringNoFrame": "Періодичне завдання має належати сервісу. Додайте його з рамки сервісу (або модуля всередині неї).",
@@ -2420,7 +2421,8 @@
         "bug": "помилка",
         "document": "документ",
         "spike": "spike",
-        "review": "огляд"
+        "review": "огляд",
+        "ralph": "Цикл Ralph"
       },
       "observability": {
         "heading": "Спостережуваність агента",
@@ -4785,5 +4787,28 @@
       "test": "Тести",
       "other": "Інше"
     }
+  },
+  "ralph": {
+    "subtitle": "Постійний цикл: працюйте над завданням, запускайте команду перевірки та повторюйте, доки вона не пройде.",
+    "status": {
+      "passed": "Пройдено",
+      "gaveUp": "Припинено",
+      "running": "Виконується",
+      "failing": "Помилка"
+    },
+    "noActivity": "Ще немає ітерацій.",
+    "validationCommand": "Команда перевірки",
+    "lastOutput": "Остання перевірка (код {exit})",
+    "viewPr": "Переглянути pull request",
+    "iterationsHeading": "Ітерації",
+    "iteration": "Ітерація {number}",
+    "iterationPassed": "перевірку пройдено",
+    "iterationFailed": "код {exit}",
+    "sidebar": {
+      "state": "Стан",
+      "iterations": "Ітерації",
+      "count": "{attempts} з {max}",
+      "footer": "Цикл повторюється, доки команда перевірки не пройде або не буде вичерпано бюджет ітерацій."
+    }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.121.2",
+  "version": "0.122.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.134.0"
+    "@cat-factory/contracts": "0.136.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",