@cat-factory/app 0.156.0 → 0.157.0

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

@@ -183,6 +183,11 @@ function setCommentOnPrOpen(value: WritebackOverride | null) {
 function setResolveOnMerge(value: WritebackOverride | null) {
   board.updateBlock(props.block.id, { trackerResolveOnMerge: value })
 }
+// Only consulted for runs started through the public API — a task started here keeps its in-app
+// clarification window regardless (docs/initiatives/headless-clarification-loop.md).
+function setQuestionsOnPark(value: WritebackOverride | null) {
+  board.updateBlock(props.block.id, { trackerQuestionsOnPark: value })
+}
 function writebackMenu(set: (value: WritebackOverride | null) => void) {
   return [
     [
@@ -212,6 +217,9 @@ const commentOnPrOpenLabel = computed(() =>
 const resolveOnMergeLabel = computed(() =>
   writebackLabel(props.block.trackerResolveOnMerge, tracker.settings.writebackResolveOnMerge),
 )
+const questionsOnParkLabel = computed(() =>
+  writebackLabel(props.block.trackerQuestionsOnPark, tracker.settings.writebackQuestionsOnPark),
+)
 
 // ---- technical label (tri-state) -------------------------------------------
 // Whether this is a purely technical task (the implementer then treats the task
@@ -520,6 +528,21 @@ const technicalLabel = computed(() => {
             </UButton>
           </UDropdownMenu>
         </div>
+        <div class="flex items-center justify-between">
+          <span class="text-[11px] text-slate-400">{{
+            t('inspector.runSettings.questionsOnPark')
+          }}</span>
+          <UDropdownMenu :items="writebackMenu(setQuestionsOnPark)">
+            <UButton
+              size="xs"
+              variant="ghost"
+              color="neutral"
+              trailing-icon="i-lucide-chevron-down"
+            >
+              {{ questionsOnParkLabel }}
+            </UButton>
+          </UDropdownMenu>
+        </div>
       </div>
       <div class="mt-1 text-[11px] text-slate-500">
         {{ t('inspector.runSettings.writebackHint') }}

package/app/components/settings/IssueTrackerPanel.vue

@@ -29,6 +29,7 @@ const jiraProjectKey = ref('')
 const linearTeamId = ref('')
 const commentOnPrOpen = ref(false)
 const resolveOnMerge = ref(false)
+const questionsOnPark = ref(false)
 const saving = ref(false)
 
 function hydrate() {
@@ -37,6 +38,7 @@ function hydrate() {
   linearTeamId.value = tracker.settings.linearTeamId ?? ''
   commentOnPrOpen.value = tracker.settings.writebackCommentOnPrOpen
   resolveOnMerge.value = tracker.settings.writebackResolveOnMerge
+  questionsOnPark.value = tracker.settings.writebackQuestionsOnPark
 }
 onMounted(() => {
   hydrate()
@@ -111,6 +113,7 @@ async function save() {
       linearTeamId: trackerKind.value === 'linear' ? linearTeamId.value.trim() : null,
       writebackCommentOnPrOpen: commentOnPrOpen.value,
       writebackResolveOnMerge: resolveOnMerge.value,
+      writebackQuestionsOnPark: questionsOnPark.value,
     })
     toast.add({
       title: t('settings.issueTracker.toast.saved'),
@@ -591,6 +594,18 @@ const STATUS_UI: Record<
           </span>
         </span>
       </label>
+
+      <label class="flex items-start gap-3 rounded-lg border border-slate-700 bg-slate-800/40 p-3">
+        <USwitch v-model="questionsOnPark" />
+        <span class="text-sm">
+          <span class="block text-slate-200">
+            {{ t('settings.issueTracker.writeback.questionsOnPark.label') }}
+          </span>
+          <span class="block text-xs text-slate-500">
+            {{ t('settings.issueTracker.writeback.questionsOnPark.help') }}
+          </span>
+        </span>
+      </label>
     </section>
 
     <div class="flex justify-end">

package/app/stores/tracker.ts

@@ -18,6 +18,7 @@ export const useTrackerStore = defineStore('tracker', () => {
     linearTeamId: null,
     writebackCommentOnPrOpen: false,
     writebackResolveOnMerge: false,
+    writebackQuestionsOnPark: false,
     updatedAt: 0,
   })
 
@@ -31,6 +32,7 @@ export const useTrackerStore = defineStore('tracker', () => {
       linearTeamId: null,
       writebackCommentOnPrOpen: false,
       writebackResolveOnMerge: false,
+      writebackQuestionsOnPark: false,
       updatedAt: 0,
     }
   }

package/i18n/locales/de.json

@@ -350,6 +350,10 @@
         "resolveOnMerge": {
           "label": "Beim Mergen eines PR als gelöst schließen",
           "help": "Kommentiere, dass der PR gemergt wurde, und schließe / löse dann das verknüpfte Issue."
+        },
+        "questionsOnPark": {
+          "label": "Offene Fragen bei einem pausierten Headless-Lauf posten",
+          "help": "Wenn ein über die API gestarteter Lauf zur Klärung der Anforderungen pausiert, poste seine offenen Fragen — jeweils mit der ID, die eine Antwort nennt — am verknüpften Issue. In der App gestartete Aufgaben sind nicht betroffen."
         }
       },
       "probeFailure": {
@@ -1317,6 +1321,7 @@
       "issueWriteback": "Issue-Rückschreibung",
       "commentOnPrOpen": "Kommentar beim PR-Öffnen",
       "closeOnMerge": "Beim Mergen schließen",
+      "questionsOnPark": "Fragen beim Pausieren stellen",
       "writebackHint": "Schreibt zurück in das verknüpfte Tracker-Issue dieser Aufgabe. Überschreibt den Workspace-Standard.",
       "responsibleProduct": "Verantwortliches Produkt",
       "responsibleEmpty": "Nicht zugewiesen. Setze einen Product Owner, um ihn zu benachrichtigen, wenn die Anforderungsprüfung diese Aufgabe kennzeichnet.",

package/i18n/locales/en.json

@@ -1088,6 +1088,7 @@
       "issueWriteback": "Issue writeback",
       "commentOnPrOpen": "Comment on PR open",
       "closeOnMerge": "Close on merge",
+      "questionsOnPark": "Ask questions on park",
       "writebackHint": "Writes back to this task's linked tracker issue. Overrides the workspace default.",
       "responsibleProduct": "Responsible product",
       "responsibleEmpty": "Unassigned. Set a product owner to notify them when requirement review flags this task.",
@@ -2416,6 +2417,10 @@
         "resolveOnMerge": {
           "label": "Close as resolved when a PR merges",
           "help": "Comment that the PR merged, then close / resolve the linked issue."
+        },
+        "questionsOnPark": {
+          "label": "Post open questions on a parked headless run",
+          "help": "When a run started through the API pauses to clarify requirements, post its open questions — each with the id an answer names — on the linked issue. Tasks started in the app are unaffected."
         }
       },
       "probeFailure": {

package/i18n/locales/es.json

@@ -1031,6 +1031,7 @@
       "issueWriteback": "Reescritura de incidencias",
       "commentOnPrOpen": "Comentar al abrir el PR",
       "closeOnMerge": "Cerrar al fusionar",
+      "questionsOnPark": "Preguntar al pausarse",
       "writebackHint": "Reescribe en la incidencia del tracker vinculada a esta tarea. Anula el valor predeterminado del espacio de trabajo.",
       "responsibleProduct": "Producto responsable",
       "responsibleEmpty": "Sin asignar. Define un responsable de producto para notificarle cuando la revisión de requisitos marque esta tarea.",
@@ -2228,6 +2229,10 @@
         "resolveOnMerge": {
           "label": "Cerrar como resuelta cuando se fusiona un PR",
           "help": "Comenta que el PR se fusionó y luego cierra / resuelve la incidencia vinculada."
+        },
+        "questionsOnPark": {
+          "label": "Publicar preguntas abiertas cuando un ejecución headless se detiene",
+          "help": "Cuando una ejecución iniciada por la API se detiene para aclarar requisitos, publica sus preguntas abiertas — cada una con el id que debe nombrar la respuesta — en la incidencia vinculada. Las tareas iniciadas en la aplicación no se ven afectadas."
         }
       },
       "probeFailure": {

package/i18n/locales/fr.json

@@ -1031,6 +1031,7 @@
       "issueWriteback": "Réécriture d'issue",
       "commentOnPrOpen": "Commenter à l'ouverture de la PR",
       "closeOnMerge": "Fermer à la fusion",
+      "questionsOnPark": "Poser les questions en pause",
       "writebackHint": "Réécrit dans l'issue de tracker liée à cette tâche. Remplace la valeur par défaut de l'espace de travail.",
       "responsibleProduct": "Produit responsable",
       "responsibleEmpty": "Non assigné. Définissez un responsable produit pour le notifier lorsque la revue d'exigences signale cette tâche.",
@@ -2228,6 +2229,10 @@
         "resolveOnMerge": {
           "label": "Clore comme résolu à la fusion d'une PR",
           "help": "Commente que la PR a été fusionnée, puis ferme / résout le ticket lié."
+        },
+        "questionsOnPark": {
+          "label": "Publier les questions ouvertes d'une exécution headless en pause",
+          "help": "Quand une exécution lancée via l'API se met en pause pour clarifier les exigences, publie ses questions ouvertes — chacune avec l'identifiant qu'une réponse doit nommer — sur le ticket lié. Les tâches lancées dans l'application ne sont pas concernées."
         }
       },
       "probeFailure": {

package/i18n/locales/he.json

@@ -1031,6 +1031,7 @@
       "issueWriteback": "כתיבה חזרה לאישו",
       "commentOnPrOpen": "הגב בפתיחת PR",
       "closeOnMerge": "סגור במיזוג",
+      "questionsOnPark": "לשאול שאלות בעת השהיה",
       "writebackHint": "כותב חזרה לאישו המקושר במעקב של משימה זו. עוקף את ברירת המחדל של מרחב העבודה.",
       "responsibleProduct": "מוצר אחראי",
       "responsibleEmpty": "לא משויך. הגדר בעלים של מוצר כדי ליידע אותו כאשר סקירת הדרישות מסמנת משימה זו.",
@@ -2349,6 +2350,10 @@
         "resolveOnMerge": {
           "label": "סגור כפתור כשממוזג PR",
           "help": "הגב שה-PR מוזג, ואז סגור / פתור את הכרטיס המקושר."
+        },
+        "questionsOnPark": {
+          "label": "פרסם שאלות פתוחות בהרצה חסרת-ממשק שהושהתה",
+          "help": "כאשר הרצה שהופעלה דרך ה-API עוצרת כדי להבהיר דרישות, פרסם את השאלות הפתוחות שלה — כל אחת עם המזהה שתשובה צריכה לציין — על הכרטיס המקושר. משימות שהופעלו באפליקציה אינן מושפעות."
         }
       },
       "probeFailure": {

package/i18n/locales/it.json

@@ -350,6 +350,10 @@
         "resolveOnMerge": {
           "label": "Chiudi come risolto quando una PR viene mergiata",
           "help": "Commenta che la PR e stata mergiata, poi chiudi / risolvi l'issue collegato."
+        },
+        "questionsOnPark": {
+          "label": "Pubblica le domande aperte di un'esecuzione headless in pausa",
+          "help": "Quando un'esecuzione avviata tramite API si mette in pausa per chiarire i requisiti, pubblica le sue domande aperte — ciascuna con l'id che una risposta deve indicare — sull'issue collegato. Le attivita avviate nell'app non sono interessate."
         }
       },
       "probeFailure": {
@@ -1317,6 +1321,7 @@
       "issueWriteback": "Writeback della issue",
       "commentOnPrOpen": "Commenta all'apertura della PR",
       "closeOnMerge": "Chiudi al merge",
+      "questionsOnPark": "Chiedi in pausa",
       "writebackHint": "Scrive di ritorno sulla issue del tracker collegata a questa attivita'. Sovrascrive il predefinito del workspace.",
       "responsibleProduct": "Prodotto responsabile",
       "responsibleEmpty": "Non assegnato. Imposta un product owner per notificarlo quando la revisione dei requisiti segnala questa attivita'.",

package/i18n/locales/ja.json

@@ -1031,6 +1031,7 @@
       "issueWriteback": "Issue への書き戻し",
       "commentOnPrOpen": "PR オープン時にコメント",
       "closeOnMerge": "マージ時にクローズ",
+      "questionsOnPark": "一時停止時に質問",
       "writebackHint": "このタスクにリンクされたトラッカーの Issue に書き戻します。ワークスペースの既定を上書きします。",
       "responsibleProduct": "担当プロダクト",
       "responsibleEmpty": "未割り当て。要件レビューがこのタスクをフラグしたときに通知するため、プロダクトオーナーを設定してください。",
@@ -2350,6 +2351,10 @@
         "resolveOnMerge": {
           "label": "PR がマージされたら解決済みとしてクローズ",
           "help": "PR がマージされた旨をコメントし、リンクされた課題をクローズ / 解決します。"
+        },
+        "questionsOnPark": {
+          "label": "ヘッドレス実行が一時停止したら未解決の質問を投稿",
+          "help": "API 経由で開始した実行が要件確認のため一時停止したとき、その未解決の質問を — 回答が指定する ID を添えて — リンクされた課題に投稿します。アプリで開始したタスクには影響しません。"
         }
       },
       "probeFailure": {

package/i18n/locales/pl.json

@@ -1031,6 +1031,7 @@
       "issueWriteback": "Zapis zwrotny do zgłoszenia",
       "commentOnPrOpen": "Komentarz przy otwarciu PR",
       "closeOnMerge": "Zamknij przy scaleniu",
+      "questionsOnPark": "Pytaj przy wstrzymaniu",
       "writebackHint": "Zapisuje zwrotnie do powiązanego zgłoszenia w trackerze tego zadania. Nadpisuje domyślne obszaru roboczego.",
       "responsibleProduct": "Odpowiedzialny produkt",
       "responsibleEmpty": "Nieprzypisane. Ustaw właściciela produktu, aby powiadamiać go, gdy recenzja wymagań oznaczy to zadanie.",
@@ -2228,6 +2229,10 @@
         "resolveOnMerge": {
           "label": "Zamknij jako rozwiązane, gdy PR zostanie scalony",
           "help": "Skomentuj, że PR został scalony, a następnie zamknij / rozwiąż powiązane zgłoszenie."
+        },
+        "questionsOnPark": {
+          "label": "Publikuj otwarte pytania wstrzymanego uruchomienia headless",
+          "help": "Gdy uruchomienie rozpoczęte przez API wstrzymuje się, aby doprecyzować wymagania, opublikuj jego otwarte pytania — każde z identyfikatorem, który ma wskazać odpowiedź — w powiązanym zgłoszeniu. Zadania rozpoczęte w aplikacji pozostają bez zmian."
         }
       },
       "probeFailure": {

package/i18n/locales/tr.json

@@ -1031,6 +1031,7 @@
       "issueWriteback": "Issue geri yazma",
       "commentOnPrOpen": "PR açılışında yorum yap",
       "closeOnMerge": "Birleştirmede kapat",
+      "questionsOnPark": "Duraklamada soru sor",
       "writebackHint": "Bu görevin bağlı izleyici issue'suna geri yazar. Çalışma alanı varsayılanını geçersiz kılar.",
       "responsibleProduct": "Sorumlu ürün",
       "responsibleEmpty": "Atanmamış. Gereksinim incelemesi bu görevi işaretlediğinde bildirim almak için bir ürün sahibi belirleyin.",
@@ -2350,6 +2351,10 @@
         "resolveOnMerge": {
           "label": "Bir PR birleştiğinde çözüldü olarak kapat",
           "help": "PR'ın birleştiğini belirten bir yorum yap, ardından bağlı sorunu kapat / çöz."
+        },
+        "questionsOnPark": {
+          "label": "Duraklatılan başsız çalıştırmanın açık sorularını gönder",
+          "help": "API üzerinden başlatılan bir çalıştırma gereksinimleri netleştirmek için duraklattığında, açık sorularını — her biri bir yanıtın belirteceği kimlikle — bağlı soruna gönderir. Uygulamada başlatılan görevler etkilenmez."
         }
       },
       "probeFailure": {

package/i18n/locales/uk.json

@@ -1031,6 +1031,7 @@
       "issueWriteback": "Зворотний запис у задачу",
       "commentOnPrOpen": "Коментувати при відкритті PR",
       "closeOnMerge": "Закрити при злитті",
+      "questionsOnPark": "Питати під час паузи",
       "writebackHint": "Записує назад до пов'язаної задачі трекера цього завдання. Перевизначає типове для робочого простору.",
       "responsibleProduct": "Відповідальний продукт",
       "responsibleEmpty": "Не призначено. Призначте власника продукту, щоб сповіщати його, коли огляд вимог позначає це завдання.",
@@ -2228,6 +2229,10 @@
         "resolveOnMerge": {
           "label": "Закрити як вирішене, коли PR зливається",
           "help": "Коментує, що PR злито, а потім закриває / вирішує пов'язаний тикет."
+        },
+        "questionsOnPark": {
+          "label": "Публікувати відкриті запитання призупиненого headless-запуску",
+          "help": "Коли запуск, розпочатий через API, призупиняється для уточнення вимог, опублікуй його відкриті запитання — кожне з ідентифікатором, який має назвати відповідь — у пов'язаному тикеті. Завдання, розпочаті в застосунку, лишаються без змін."
         }
       },
       "probeFailure": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.156.0",
+  "version": "0.157.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.165.0"
+    "@cat-factory/contracts": "0.166.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",