@cat-factory/app 0.79.2 → 0.81.0

package/app/components/requirements/RequirementsReviewWindow.vue

@@ -38,6 +38,9 @@ const reRequestNotes = ref<Record<string, string>>({})
 // Freeform "do it differently" comment when redoing a merge the human was unhappy with.
 const redoComment = ref('')
 const showRedo = ref(false)
+// Human's explicit collapse choice for the whole incorporated-requirements section; null = follow
+// the default (collapse it while there's still work to do so it doesn't dominate the window).
+const docCollapsedOverride = ref<boolean | null>(null)
 
 // The seam contract (open/blockId/close + Escape handling + load-on-open) lives in
 // `useResultView`, so this window can't drift from the others. Declaring `onOpen` makes the
@@ -52,6 +55,7 @@ const { open, blockId, instanceId, stepIndex, close } = useResultView('requireme
     reRequestNotes.value = {}
     redoComment.value = ''
     showRedo.value = false
+    docCollapsedOverride.value = null
     void requirements.load(id)
   },
 })
@@ -256,6 +260,41 @@ const recommendationProgress = computed(() => {
   const ready = readyRecommendations.value.filter((r) => batchTimes.has(r.createdAt)).length
   return { ready, total: ready + generating.length }
 })
+// Whether the human still has something to act on (findings to answer/dismiss or recommendations
+// to decide). Drives the incorporated-document default collapse so the reference doc doesn't push
+// the actionable findings/recommendations off-screen while there's still work.
+const hasActionableWork = computed(() => {
+  if (!review.value) return false
+  const findingWork = review.value.items.some(
+    (i) => i.status === 'open' || i.status === 'answered' || i.status === 'recommend_requested',
+  )
+  return (
+    findingWork ||
+    readyRecommendations.value.length > 0 ||
+    generatingRecommendations.value.length > 0
+  )
+})
+// The whole incorporated-requirements section collapses as a unit (independent of the per-heading
+// collapse below). Default: collapsed only in the pre-incorporation `ready`-style phase while
+// there's still actionable work — so the (potentially long) reference doc stays out of the way of
+// the findings the human is working through. In `merged` (inspect the draft to decide re-review vs
+// redo) and `incorporated` (the settled deliverable) the document IS the thing to read, so it
+// defaults expanded. The human's explicit toggle wins within a phase; a status change (below)
+// clears it so a collapse from one phase doesn't leak into the next.
+const docCollapsed = computed(
+  () =>
+    docCollapsedOverride.value ?? (!incorporated.value && !merged.value && hasActionableWork.value),
+)
+function toggleDoc() {
+  docCollapsedOverride.value = !docCollapsed.value
+}
+// Reset the manual collapse on every status transition so a collapse chosen in one phase doesn't
+// persist into the next (e.g. a `ready` collapse leaking into `merged`, or surviving convergence to
+// `incorporated` and hiding the final requirements) — each phase then falls back to its own default.
+watch(status, () => {
+  docCollapsedOverride.value = null
+})
+
 function isMarkedForRecommend(item: RequirementReviewItem): boolean {
   return markedForRecommend.value.has(item.id)
 }
@@ -751,9 +790,19 @@ async function resolveExceeded(choice: 'extra-round' | 'proceed' | 'stop-reset')
                 </div>
               </section>
 
-              <!-- incorporated document: the standard-format requirements -->
+              <!-- incorporated document: the standard-format requirements. The whole section
+                   collapses as a unit (a long doc otherwise pushes the findings/recommendations
+                   off-screen); the per-heading toggles below still work when it's expanded. -->
               <section v-if="outline" class="mt-6 border-t border-slate-800 pt-5">
-                <div class="mb-3 flex items-center gap-1.5 text-[11px] text-emerald-400">
+                <button
+                  class="mb-3 flex w-full items-center gap-1.5 text-[11px] text-emerald-400"
+                  @click="toggleDoc"
+                >
+                  <UIcon
+                    name="i-lucide-chevron-right"
+                    class="h-3.5 w-3.5 shrink-0 transition-transform"
+                    :class="docCollapsed ? '' : 'rotate-90'"
+                  />
                   <UIcon name="i-lucide-file-check-2" class="h-3.5 w-3.5" />
                   <span class="font-semibold uppercase tracking-wide">
                     {{
@@ -762,29 +811,31 @@ async function resolveExceeded(choice: 'extra-round' | 'proceed' | 'stop-reset')
                         : t('requirements.incorporatedDraft')
                     }}
                   </span>
-                </div>
-                <div v-for="s in outline.sections" :key="s.id" class="mb-2">
-                  <button
-                    v-if="s.title"
-                    class="group flex w-full items-center gap-2 text-start"
-                    @click="toggle(s.id)"
-                  >
-                    <UIcon
-                      name="i-lucide-chevron-right"
-                      class="h-3.5 w-3.5 shrink-0 text-slate-500 transition-transform"
-                      :class="collapsed[s.id] ? '' : 'rotate-90'"
-                    />
-                    <span
-                      class="font-semibold text-white"
-                      :class="s.depth <= 1 ? 'text-base' : s.depth === 2 ? 'text-sm' : 'text-xs'"
-                      v-html="s.titleHtml"
+                </button>
+                <div v-show="!docCollapsed">
+                  <div v-for="s in outline.sections" :key="s.id" class="mb-2">
+                    <button
+                      v-if="s.title"
+                      class="group flex w-full items-center gap-2 text-start"
+                      @click="toggle(s.id)"
+                    >
+                      <UIcon
+                        name="i-lucide-chevron-right"
+                        class="h-3.5 w-3.5 shrink-0 text-slate-500 transition-transform"
+                        :class="collapsed[s.id] ? '' : 'rotate-90'"
+                      />
+                      <span
+                        class="font-semibold text-white"
+                        :class="s.depth <= 1 ? 'text-base' : s.depth === 2 ? 'text-sm' : 'text-xs'"
+                        v-html="s.titleHtml"
+                      />
+                    </button>
+                    <div
+                      v-show="!s.title || !collapsed[s.id]"
+                      class="reader-prose mt-1 ps-5.5 text-[13px] leading-relaxed text-slate-300"
+                      v-html="s.bodyHtml"
                     />
-                  </button>
-                  <div
-                    v-show="!s.title || !collapsed[s.id]"
-                    class="reader-prose mt-1 ps-5.5 text-[13px] leading-relaxed text-slate-300"
-                    v-html="s.bodyHtml"
-                  />
+                  </div>
                 </div>
               </section>
             </template>
@@ -806,12 +857,63 @@ async function resolveExceeded(choice: 'extra-round' | 'proceed' | 'stop-reset')
                   <span>{{ t('requirements.stats.answered') }}</span>
                   <span class="text-slate-300">{{ answeredCount }}</span>
                 </div>
+                <!-- awaited recommendations — kept here (always visible) so the human can see what
+                     the Writer is still producing / what's waiting on them even while reading the
+                     incorporated document or acting elsewhere in the window. -->
+                <template v-if="generatingRecommendations.length || readyRecommendations.length">
+                  <div
+                    class="flex items-center gap-1.5 border-t border-slate-800/60 pt-2 text-indigo-300"
+                  >
+                    <UIcon name="i-lucide-wand-2" class="h-3 w-3" />
+                    <span class="font-medium">{{ t('requirements.stats.recommendations') }}</span>
+                  </div>
+                  <div
+                    v-if="generatingRecommendations.length"
+                    class="flex items-center justify-between"
+                  >
+                    <span>{{ t('requirements.stats.recsGenerating') }}</span>
+                    <span class="text-indigo-300">{{ generatingRecommendations.length }}</span>
+                  </div>
+                  <div v-if="readyRecommendations.length" class="flex items-center justify-between">
+                    <span>{{ t('requirements.stats.recsToReview') }}</span>
+                    <span class="text-indigo-300">{{ readyRecommendations.length }}</span>
+                  </div>
+                </template>
                 <div v-if="review.model" class="flex items-center justify-between">
                   <span>{{ t('requirements.stats.model') }}</span>
                   <span class="truncate ps-2 text-slate-500">{{ review.model }}</span>
                 </div>
               </div>
 
+              <!-- Request the Requirement Writer for the marked findings. Kept OUT of the
+                   status-scoped blocks below so it's available whenever the review is still
+                   editable — the `ready` first pass AND a `merged` review being reworked — not
+                   only when status is exactly `ready`. Scoped to exactly those two states (NOT a
+                   bare `!frozen`, which would also expose it in `exceeded`, where the run is parked
+                   on the cap decision and a fresh recommendation batch has no path to settle). -->
+              <div
+                v-if="review && markedForRecommend.size > 0 && (status === 'ready' || merged)"
+                class="border-t border-slate-800 pt-4"
+              >
+                <UButton
+                  color="primary"
+                  variant="soft"
+                  size="sm"
+                  block
+                  icon="i-lucide-wand-2"
+                  :loading="recommending"
+                  @click="requestRecommendations"
+                >
+                  {{
+                    t(
+                      'requirements.actions.requestRecommendations',
+                      { count: markedForRecommend.size },
+                      markedForRecommend.size,
+                    )
+                  }}
+                </UButton>
+              </div>
+
               <!-- action: ready (answer → incorporate / proceed) -->
               <div
                 v-if="review && status === 'ready'"
@@ -841,24 +943,6 @@ async function resolveExceeded(choice: 'extra-round' | 'proceed' | 'stop-reset')
                 >
                   {{ t('requirements.actions.incorporateAnswers') }}
                 </UButton>
-                <UButton
-                  v-if="markedForRecommend.size > 0"
-                  color="primary"
-                  variant="soft"
-                  size="sm"
-                  block
-                  icon="i-lucide-wand-2"
-                  :loading="recommending"
-                  @click="requestRecommendations"
-                >
-                  {{
-                    t(
-                      'requirements.actions.requestRecommendations',
-                      { count: markedForRecommend.size },
-                      markedForRecommend.size,
-                    )
-                  }}
-                </UButton>
                 <p class="text-[11px] leading-relaxed text-slate-500">
                   <template v-if="canProceed">
                     {{ t('requirements.help.canProceed') }}

package/app/components/tasks/TaskContextIssues.vue

@@ -6,6 +6,7 @@
 // the structured nature of an issue is visible at a glance.
 import type { DropdownMenuItem } from '@nuxt/ui'
 import type { Block, TaskSourceKind } from '~/types/domain'
+import InspectorSection from '~/components/panels/inspector/InspectorSection.vue'
 
 const props = defineProps<{ block: Block }>()
 
@@ -53,17 +54,19 @@ const attachMenu = computed<DropdownMenuItem[][]>(() => {
 </script>
 
 <template>
-  <div v-if="tasks.available" class="space-y-2">
-    <div class="flex items-center justify-between">
-      <span class="text-[11px] font-semibold uppercase tracking-wide text-slate-400">
-        {{ t('tasks.contextIssues.title') }}
-      </span>
+  <InspectorSection
+    v-if="tasks.available"
+    :title="t('tasks.contextIssues.title')"
+    :hint="t('tasks.contextIssues.hint')"
+    :count="linked.length"
+  >
+    <template #actions>
       <UDropdownMenu :items="attachMenu" :content="{ side: 'bottom', align: 'end' }">
         <UButton color="neutral" variant="soft" size="xs" icon="i-lucide-plus">{{
           t('tasks.contextIssues.attach')
         }}</UButton>
       </UDropdownMenu>
-    </div>
+    </template>
 
     <div v-if="linked.length" class="space-y-1">
       <a
@@ -87,5 +90,5 @@ const attachMenu = computed<DropdownMenuItem[][]>(() => {
     <p v-else class="text-[11px] text-slate-500">
       {{ t('tasks.contextIssues.emptyHint') }}
     </p>
-  </div>
+  </InspectorSection>
 </template>

package/app/stores/fragmentLibrary.ts

@@ -42,8 +42,8 @@ function fragmentLibrarySetup(kind: FragmentOwnerKind, resolveOwnerId: () => str
   const resolved = ref<ResolvedFragment[]>([])
   /** Linked guideline repos for this owner. */
   const sources = ref<FragmentSource[]>([])
-  /** Per-source "changes available" counts from the last status check. */
-  const sourceChanges = ref<Record<string, number>>({})
+  /** Per-source "changes available" flag from the last status check. */
+  const sourceChanges = ref<Record<string, boolean>>({})
   const loading = ref(false)
   /**
    * Account-tier document fragments only: the workspace whose stored
@@ -166,12 +166,12 @@ function fragmentLibrarySetup(kind: FragmentOwnerKind, resolveOwnerId: () => str
     }
   }
 
-  /** Cheap "check for changes" for a source; caches the changed count. */
+  /** Lightweight commit-version "check for changes" for a source; caches the flag. */
   async function checkSource(sourceId: string) {
     const status = await api.fragmentSourceStatus(kind, requireOwnerId(), sourceId)
     sourceChanges.value = {
       ...sourceChanges.value,
-      [sourceId]: status.changed ? status.changedCount : 0,
+      [sourceId]: status.changed,
     }
     return status
   }

package/i18n/locales/en.json

@@ -430,6 +430,8 @@
   },
   "inspector": {
     "container": {
+      "title": "Contents",
+      "hint": "The modules and tasks inside this block. Click an entry to select it on the board.",
       "modules": "Modules ({count})",
       "taskCount": "{count} task | {count} tasks",
       "allTasks": "All tasks ({count})",
@@ -440,6 +442,7 @@
     },
     "epicChildren": {
       "title": "Epic tasks",
+      "hint": "All tasks assigned to this epic, grouped by the service and module they live in. An epic only groups tasks; it does not run anything itself.",
       "doneCount": "{done}/{total} done",
       "empty": "No tasks belong to this epic yet. Import an epic's children, or set a task's epic.",
       "unassigned": "Unassigned"
@@ -478,6 +481,7 @@
     },
     "fragments": {
       "serviceTitle": "Service best practices",
+      "serviceHint": "Programming standards for the whole service. The content of each selected fragment is added to the prompt of every code-aware agent working on tasks under this service.",
       "serviceEmpty": "None. Code-aware agents on this service follow their default guidance.",
       "manageBoard": "Manage this board's fragment library…",
       "manageAccount": "Manage account fragments…"
@@ -562,6 +566,7 @@
     },
     "releaseHealth": {
       "title": "Post-release health",
+      "sectionHint": "After this service's changes merge and ship, a gate watches the mapped monitors and SLOs for a while. On a regression it starts an on-call agent to investigate; nothing is reverted automatically.",
       "clear": "Clear",
       "connectPrompt": "Connect an observability integration to watch this service after releases.",
       "connectFirst": "Connect an observability integration first",
@@ -578,6 +583,7 @@
     },
     "testConfig": {
       "title": "Test infrastructure",
+      "hint": "How a test environment is stood up for this service when a pipeline needs to run it: no infrastructure, a Docker Compose file, Kubernetes manifests, or a custom manifest type.",
       "provisionType": "Provision type",
       "provisionTypeHint": "How this service stands up its environment for the Tester. The workspace configures how each type is handled (the engine + connection).",
       "provisionTypes": {
@@ -661,11 +667,13 @@
     },
     "agentConfig": {
       "title": "Agent configuration",
+      "hint": "Options contributed by the agents in this task's pipeline. Each option stays editable until its agent starts, then it is locked for that run.",
       "inherited": "inherited from service",
       "frozen": "Frozen: the agent has started"
     },
     "dependencies": {
       "title": "Depends on",
+      "hint": "Tasks that must merge before this one can run. The Run control stays locked until every dependency is done.",
       "merged": "Merged",
       "notMerged": "Not merged yet",
       "empty": "No dependencies. Can run any time.",
@@ -677,11 +685,14 @@
     },
     "estimate": {
       "title": "Estimate",
+      "hint": "Produced by the task estimator agent: how complex, risky, and impactful this task looks. Used to decide whether consensus (multi-run) steps are worth running.",
       "complexity": "Complexity",
       "risk": "Risk",
       "impact": "Impact"
     },
     "execution": {
+      "title": "Execution",
+      "hint": "The live run of this task's pipeline: each agent step, its progress, and the resulting pull request.",
       "stage": {
         "incorporating": "Incorporating…",
         "reviewing": "Re-reviewing…",
@@ -735,12 +746,18 @@
       "mergePr": "Merge PR"
     },
     "structure": {
+      "title": "Structure",
+      "hint": "Where this task lives in its service and which coding standards its agents follow.",
       "module": "Module",
       "modulePlaceholder": "e.g. Sessions (created on implement if new)",
+      "moduleHint": "The service module this task belongs to. Type a name; a module that does not exist yet is created when the task is implemented.",
       "bestPractices": "Best practices",
-      "bestPracticesEmpty": "None. Agents follow their default guidance."
+      "bestPracticesEmpty": "None. Agents follow their default guidance.",
+      "bestPracticesHint": "Best-practice fragments folded into the prompts of this task's agents, on top of the service-level standards."
     },
     "runSettings": {
+      "title": "Run settings",
+      "hint": "How this task's pipeline runs: which pipeline starts, which merge and model policies apply, and what happens around the run.",
       "unassigned": "Unassigned",
       "workspaceDefault": "Workspace default",
       "workspaceDefaultParen": "(workspace default)",
@@ -759,10 +776,13 @@
       },
       "pipeline": "Pipeline",
       "pipelineEmpty": "No default. Pick a pipeline when you run this task.",
+      "pipelineHint": "The pipeline the Run button starts by default: the sequence of agent steps (for example spec, code, test, merge) executed for this task.",
       "mergePolicy": "Merge policy",
       "mergePresetDetail": "{name}: auto-merge when complexity ≤ {complexity}, risk ≤ {risk}, impact ≤ {impact}; up to {attempts} CI-fix attempts.",
       "mergePresetEmpty": "No preset configured. The merger raises a review notification for every PR.",
+      "mergePolicyHint": "Decides when a finished pull request merges automatically instead of waiting for a human review, and how many CI-fix attempts a run gets.",
       "modelPreset": "Model preset",
+      "modelPresetHint": "Decides which AI model each agent step runs on.",
       "modelPresetBase": "base {model}",
       "modelPresetOverrides": ", {count} override | , {count} overrides",
       "modelPresetEmpty": "No preset configured. Agents run on the deployment's default routing.",
@@ -2676,6 +2696,7 @@
     },
     "taskDocs": {
       "heading": "Context documents",
+      "hint": "Documents attached to this task as context. Their content is given to the agents that work on the task.",
       "attach": "Attach",
       "importPage": "Import a page…",
       "empty": "Attach a requirement, RFC or PRD so agents see it while implementing this task.",
@@ -2696,6 +2717,7 @@
     },
     "contextIssues": {
       "title": "Context issues",
+      "hint": "Tracker issues attached to this task as context. Their content is given to the agents that work on the task.",
       "attach": "Attach",
       "attached": "Issue attached",
       "attachFailed": "Could not attach",
@@ -3056,6 +3078,9 @@
       "findings": "Findings",
       "open": "Open",
       "answered": "Answered",
+      "recommendations": "Recommendations",
+      "recsGenerating": "Generating",
+      "recsToReview": "To review",
       "model": "Model"
     },
     "actions": {
@@ -3802,7 +3827,7 @@
     "sources": {
       "metaSynced": "synced · ref {ref}",
       "metaNever": "never synced · ref {ref}",
-      "changes": "{count} change | {count} changes",
+      "changes": "Changes",
       "empty": "No linked guideline repos. Link one below to import its Markdown files as fragments.",
       "linkTitle": "Link a guideline repo",
       "ownerPlaceholder": "owner",
@@ -3827,7 +3852,7 @@
       "linkSourceFailed": "Could not link source",
       "synced": "Synced: {updated} updated, {removed} removed",
       "syncFailed": "Could not sync source",
-      "changesAvailable": "{count} change available | {count} changes available",
+      "changesAvailable": "Changes available",
       "upToDate": "Up to date",
       "checkSourceFailed": "Could not check source",
       "sourceUnlinked": "Source unlinked",

package/i18n/locales/es.json

@@ -387,6 +387,8 @@
   },
   "inspector": {
     "container": {
+      "title": "Contenido",
+      "hint": "Los módulos y tareas dentro de este bloque. Haz clic en una entrada para seleccionarla en el tablero.",
       "modules": "Módulos ({count})",
       "taskCount": "{count} tarea | {count} tareas",
       "allTasks": "Todas las tareas ({count})",
@@ -397,6 +399,7 @@
     },
     "epicChildren": {
       "title": "Tareas de la épica",
+      "hint": "Todas las tareas asignadas a esta épica, agrupadas por el servicio y el módulo donde viven. Una épica solo agrupa tareas; no ejecuta nada por sí misma.",
       "doneCount": "{done}/{total} completadas",
       "empty": "Aún no hay tareas en esta épica. Importa las hijas de una épica o asigna la épica de una tarea.",
       "unassigned": "Sin asignar"
@@ -435,6 +438,7 @@
     },
     "fragments": {
       "serviceTitle": "Buenas prácticas del servicio",
+      "serviceHint": "Estándares de programación para todo el servicio. El contenido de cada fragmento seleccionado se añade al prompt de cada agente que conoce el código y trabaja en tareas de este servicio.",
       "serviceEmpty": "Ninguna. Los agentes que conocen el código en este servicio siguen su guía predeterminada.",
       "manageBoard": "Gestionar la biblioteca de fragmentos de este tablero…",
       "manageAccount": "Gestionar los fragmentos de la cuenta…"
@@ -519,6 +523,7 @@
     },
     "releaseHealth": {
       "title": "Salud posterior al lanzamiento",
+      "sectionHint": "Cuando los cambios de este servicio se fusionan y publican, una verificación vigila durante un tiempo los monitores y SLO configurados. Ante una regresión inicia un agente de guardia para investigar; nada se revierte automáticamente.",
       "clear": "Limpiar",
       "connectPrompt": "Conecta una integración de observabilidad para vigilar este servicio tras los lanzamientos.",
       "connectFirst": "Conecta primero una integración de observabilidad",
@@ -535,6 +540,7 @@
     },
     "testConfig": {
       "title": "Infraestructura de pruebas",
+      "hint": "Cómo se levanta un entorno de prueba para este servicio cuando un pipeline necesita ejecutarlo: sin infraestructura, un archivo de Docker Compose, manifiestos de Kubernetes o un tipo de manifiesto personalizado.",
       "provisionType": "Tipo de aprovisionamiento",
       "provisionTypeHint": "Cómo este servicio levanta su entorno para el Tester. El espacio de trabajo configura cómo se gestiona cada tipo (el motor + la conexión).",
       "provisionTypes": {
@@ -618,11 +624,13 @@
     },
     "agentConfig": {
       "title": "Configuración del agente",
+      "hint": "Opciones aportadas por los agentes del pipeline de esta tarea. Cada opción se puede editar hasta que su agente arranca; después queda bloqueada para esa ejecución.",
       "inherited": "heredado del servicio",
       "frozen": "Congelado: el agente ya ha comenzado"
     },
     "dependencies": {
       "title": "Depende de",
+      "hint": "Tareas que deben fusionarse antes de que esta pueda ejecutarse. El control Ejecutar permanece bloqueado hasta que todas las dependencias estén completas.",
       "merged": "Fusionado",
       "notMerged": "Aún sin fusionar",
       "empty": "Sin dependencias. Puede ejecutarse en cualquier momento.",
@@ -634,11 +642,14 @@
     },
     "estimate": {
       "title": "Estimación",
+      "hint": "Producida por el agente estimador de tareas: cuán compleja, arriesgada e impactante parece esta tarea. Se usa para decidir si merecen la pena los pasos de consenso (multiejecución).",
       "complexity": "Complejidad",
       "risk": "Riesgo",
       "impact": "Impacto"
     },
     "execution": {
+      "title": "Ejecución",
+      "hint": "La ejecución en vivo del pipeline de esta tarea: cada paso de agente, su progreso y el pull request resultante.",
       "stage": {
         "incorporating": "Incorporando…",
         "reviewing": "Revisando de nuevo…",
@@ -692,12 +703,18 @@
       }
     },
     "structure": {
+      "title": "Estructura",
+      "hint": "Dónde vive esta tarea dentro de su servicio y qué estándares de código siguen sus agentes.",
       "module": "Módulo",
       "modulePlaceholder": "p. ej. Sesiones (creado al implementar si es nuevo)",
+      "moduleHint": "El módulo del servicio al que pertenece esta tarea. Escribe un nombre; un módulo que aún no existe se crea cuando la tarea se implementa.",
       "bestPractices": "Buenas prácticas",
-      "bestPracticesEmpty": "Ninguna. Los agentes siguen su guía predeterminada."
+      "bestPracticesEmpty": "Ninguna. Los agentes siguen su guía predeterminada.",
+      "bestPracticesHint": "Fragmentos de buenas prácticas incorporados a los prompts de los agentes de esta tarea, además de los estándares a nivel de servicio."
     },
     "runSettings": {
+      "title": "Ajustes de ejecución",
+      "hint": "Cómo se ejecuta el pipeline de esta tarea: qué pipeline arranca, qué políticas de fusión y de modelo se aplican y qué ocurre alrededor de la ejecución.",
       "unassigned": "Sin asignar",
       "workspaceDefault": "Predeterminado del espacio de trabajo",
       "workspaceDefaultParen": "(predeterminado del espacio de trabajo)",
@@ -716,10 +733,13 @@
       },
       "pipeline": "Pipeline",
       "pipelineEmpty": "Sin predeterminado. Elige un pipeline cuando ejecutes esta tarea.",
+      "pipelineHint": "El pipeline que el botón Ejecutar inicia por defecto: la secuencia de pasos de agente (por ejemplo especificación, código, pruebas, fusión) que se ejecuta para esta tarea.",
       "mergePolicy": "Política de fusión",
       "mergePresetDetail": "{name}: fusión automática cuando complejidad ≤ {complexity}, riesgo ≤ {risk}, impacto ≤ {impact}; hasta {attempts} intentos de corrección de CI.",
       "mergePresetEmpty": "No hay preajuste configurado. El fusionador genera una notificación de revisión para cada PR.",
+      "mergePolicyHint": "Decide cuándo un pull request terminado se fusiona automáticamente en lugar de esperar una revisión humana, y cuántos intentos de arreglo de CI tiene una ejecución.",
       "modelPreset": "Preajuste de modelo",
+      "modelPresetHint": "Decide con qué modelo de IA se ejecuta cada paso de agente.",
       "modelPresetBase": "base {model}",
       "modelPresetOverrides": ", {count} anulación | , {count} anulaciones",
       "modelPresetEmpty": "No hay preajuste configurado. Los agentes se ejecutan con el enrutamiento predeterminado del despliegue.",
@@ -2602,6 +2622,7 @@
     },
     "taskDocs": {
       "heading": "Documentos de contexto",
+      "hint": "Documentos adjuntos a esta tarea como contexto. Su contenido se entrega a los agentes que trabajan en la tarea.",
       "attach": "Adjuntar",
       "importPage": "Importar una página…",
       "empty": "Adjunta un requisito, RFC o PRD para que los agentes lo vean mientras implementan esta tarea.",
@@ -2622,6 +2643,7 @@
     },
     "contextIssues": {
       "title": "Incidencias de contexto",
+      "hint": "Incidencias del tracker adjuntas a esta tarea como contexto. Su contenido se entrega a los agentes que trabajan en la tarea.",
       "attach": "Adjuntar",
       "attached": "Incidencia adjuntada",
       "attachFailed": "No se pudo adjuntar",
@@ -2960,6 +2982,9 @@
       "findings": "Hallazgos",
       "open": "Abiertos",
       "answered": "Respondidos",
+      "recommendations": "Recomendaciones",
+      "recsGenerating": "Generando",
+      "recsToReview": "Por revisar",
       "model": "Modelo"
     },
     "actions": {
@@ -3667,7 +3692,7 @@
     "sources": {
       "metaSynced": "sincronizado · ref {ref}",
       "metaNever": "nunca sincronizado · ref {ref}",
-      "changes": "{count} cambio | {count} cambios",
+      "changes": "Cambios",
       "empty": "No hay repositorios de pautas vinculados. Vincula uno abajo para importar sus archivos Markdown como fragmentos.",
       "linkTitle": "Vincular un repositorio de pautas",
       "ownerPlaceholder": "propietario",
@@ -3692,7 +3717,7 @@
       "linkSourceFailed": "No se pudo vincular el origen",
       "synced": "Sincronizado: {updated} actualizados, {removed} eliminados",
       "syncFailed": "No se pudo sincronizar el origen",
-      "changesAvailable": "{count} cambio disponible | {count} cambios disponibles",
+      "changesAvailable": "Cambios disponibles",
       "upToDate": "Al día",
       "checkSourceFailed": "No se pudo comprobar el origen",
       "sourceUnlinked": "Origen desvinculado",