@cat-factory/app 0.83.1 → 0.84.0

package/app/components/initiative/InitiativeTrackerWindow.vue

@@ -13,6 +13,7 @@ import {
   INITIATIVE_ITEM_STATUS_CHIPS,
   INITIATIVE_ITEM_STATUS_LABEL_KEYS,
   INITIATIVE_STATUS_LABEL_KEYS,
+  initiativeProgress,
 } from '~/utils/initiative'
 
 const board = useBoardStore()
@@ -31,6 +32,13 @@ function itemsOf(phaseId: string): InitiativeItem[] {
   return (initiative.value?.items ?? []).filter((i) => i.phaseId === phaseId)
 }
 
+const progress = computed(() => initiativeProgress(initiative.value?.items))
+const progressPct = computed(() =>
+  progress.value && progress.value.total > 0
+    ? Math.round((progress.value.settled / progress.value.total) * 100)
+    : 0,
+)
+
 const policyRules = computed(() => initiative.value?.policy?.rules ?? [])
 function ruleAxes(rule: { minComplexity?: number; minRisk?: number; minImpact?: number }): string {
   const axes = [
@@ -74,6 +82,17 @@ function ruleAxes(rule: { minComplexity?: number; minRisk?: number; minImpact?:
               {{ t('initiative.tracker.subtitle') }}
             </p>
           </div>
+          <div v-if="progress" class="flex items-center gap-2" data-testid="initiative-progress">
+            <div class="h-1.5 w-24 overflow-hidden rounded-full bg-slate-800">
+              <div
+                class="h-full rounded-full bg-emerald-500 transition-[width] duration-500"
+                :style="{ width: `${progressPct}%` }"
+              />
+            </div>
+            <span class="text-[11px] tabular-nums text-slate-400">
+              {{ t('initiative.card.progress', { done: progress.settled, total: progress.total }) }}
+            </span>
+          </div>
           <UBadge v-if="initiative" color="primary" variant="subtle" size="sm">
             {{ t(INITIATIVE_STATUS_LABEL_KEYS[initiative.status]) }}
           </UBadge>

package/app/components/layout/NotificationsInbox.vue

@@ -60,6 +60,9 @@ const META: Record<Notification['type'], { icon: string; color: Accent }> = {
   // Clicking the title opens the Follow-up companion window for the run (see `reveal`); "act"
   // just marks it read (items are decided in that window — file / send back / answer — not here).
   followup_pending: { icon: 'i-lucide-compass', color: 'warning' },
+  // The initiative loop needs attention (a blocked task, or completion). Clicking the title
+  // opens the initiative tracker window; "act" just marks it read.
+  initiative: { icon: 'i-lucide-milestone', color: 'primary' },
 }
 
 // Per-type primary-action label. An exhaustive Record keyed off the notification
@@ -78,6 +81,7 @@ const ACTION_KEYS: Record<Notification['type'], string> = {
   visual_confirmation_ready: 'layout.notifications.action.visual_confirmation_ready',
   human_review: 'layout.notifications.action.human_review',
   followup_pending: 'layout.notifications.action.followup_pending',
+  initiative: 'layout.notifications.action.initiative',
 }
 
 /** The localized primary-action label for a notification (te()-guarded against a
@@ -147,6 +151,7 @@ function reveal(n: Notification) {
   else if (n.type === 'visual_confirmation_ready') revealVisualConfirm(n)
   else if (n.type === 'human_review') revealHumanReview(n)
   else if (n.type === 'followup_pending') revealFollowUps(n)
+  else if (n.type === 'initiative') ui.openInitiativeTracker(n.blockId)
   else ui.select(n.blockId)
 }
 

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

@@ -1,8 +1,9 @@
 <script setup lang="ts">
 // Inspector body for an `initiative`-level block: the entity's status + goal, the
 // "Run planning" control (pinned to the Initiative Planning pipeline — the engine
-// refuses any other on this block), and the tracker window opener. Read-only in
-// this slice; plan/policy editing lands with the execution loop.
+// refuses any other on this block), the execution-loop controls (pause / resume /
+// cancel once executing), and the tracker window opener. Plan/policy editing lands
+// with slice 4.
 import type { Block, InitiativeStatus } from '~/types/domain'
 import { INITIATIVE_STATUS_LABEL_KEYS, initiativeProgress } from '~/utils/initiative'
 
@@ -40,6 +41,13 @@ function openPlanning() {
 }
 
 const progress = computed(() => initiativeProgress(initiative.value?.items))
+
+// Execution-loop controls appear once planning is done (the loop owns the block).
+const isExecuting = computed(() => status.value === 'executing')
+const isPaused = computed(() => status.value === 'paused')
+function control(action: 'pause' | 'resume' | 'cancel') {
+  void initiatives.control(props.block.id, action)
+}
 </script>
 
 <template>
@@ -92,6 +100,45 @@ const progress = computed(() => initiativeProgress(initiative.value?.items))
       </UButton>
     </div>
 
+    <!-- Execution-loop controls (slice 3): pause / resume / cancel an executing initiative. -->
+    <div v-if="isExecuting || isPaused" class="flex flex-wrap items-center gap-2">
+      <UButton
+        v-if="isExecuting"
+        data-testid="initiative-pause"
+        color="warning"
+        variant="soft"
+        size="sm"
+        icon="i-lucide-pause"
+        :loading="initiatives.controlling"
+        @click="control('pause')"
+      >
+        {{ t('initiative.inspector.pause') }}
+      </UButton>
+      <UButton
+        v-if="isPaused"
+        data-testid="initiative-resume"
+        color="primary"
+        variant="soft"
+        size="sm"
+        icon="i-lucide-play"
+        :loading="initiatives.controlling"
+        @click="control('resume')"
+      >
+        {{ t('initiative.inspector.resume') }}
+      </UButton>
+      <UButton
+        data-testid="initiative-cancel"
+        color="error"
+        variant="soft"
+        size="sm"
+        icon="i-lucide-square"
+        :loading="initiatives.controlling"
+        @click="control('cancel')"
+      >
+        {{ t('initiative.inspector.cancel') }}
+      </UButton>
+    </div>
+
     <p class="text-[11px] text-slate-500">
       {{ t('initiative.inspector.hint') }}
     </p>

package/app/components/slack/SlackPanel.vue

@@ -31,6 +31,7 @@ const ROUTABLE = computed<{ type: NotificationType; label: string }[]>(() => [
   { type: 'release_regression', label: t('slack.routable.release_regression') },
   { type: 'human_test_ready', label: t('slack.routable.human_test_ready') },
   { type: 'visual_confirmation_ready', label: t('slack.routable.visual_confirmation_ready') },
+  { type: 'initiative', label: t('slack.routable.initiative') },
 ])
 
 /** Notification-role options for a mapped member (drives who gets @-mentioned). */
@@ -54,6 +55,7 @@ const routes = reactive<Record<NotificationType, SlackRoute>>({
   visual_confirmation_ready: { enabled: false, channel: '' },
   human_review: { enabled: false, channel: '' },
   followup_pending: { enabled: false, channel: '' },
+  initiative: { enabled: false, channel: '' },
 })
 const mentionsEnabled = ref(false)
 const mapping = ref<SlackMemberMappingEntry[]>([])

package/app/composables/api/initiative.ts

@@ -1,11 +1,14 @@
 import {
   answerInitiativeQuestionContract,
+  cancelInitiativeContract,
   continueInitiativePlanningContract,
   createInitiativeContract,
   getInitiativeByBlockContract,
   getInitiativeContract,
   listInitiativesContract,
+  pauseInitiativeContract,
   proceedInitiativePlanningContract,
+  resumeInitiativeContract,
 } from '@cat-factory/contracts'
 import type { ApiContext } from './context'
 
@@ -53,5 +56,15 @@ export function initiativeApi({ send, ws }: ApiContext) {
         pathPrefix: ws(workspaceId),
         pathParams: { blockId },
       }),
+
+    // Execution-loop controls (slice 3): pause / resume / cancel an executing initiative.
+    pauseInitiative: (workspaceId: string, blockId: string) =>
+      send(pauseInitiativeContract, { pathPrefix: ws(workspaceId), pathParams: { blockId } }),
+
+    resumeInitiative: (workspaceId: string, blockId: string) =>
+      send(resumeInitiativeContract, { pathPrefix: ws(workspaceId), pathParams: { blockId } }),
+
+    cancelInitiative: (workspaceId: string, blockId: string) =>
+      send(cancelInitiativeContract, { pathPrefix: ws(workspaceId), pathParams: { blockId } }),
   }
 }

package/app/stores/initiative.ts

@@ -132,6 +132,28 @@ export const useInitiativesStore = defineStore('initiatives', () => {
     }
   }
 
+  /** True while a loop control (pause/resume/cancel) is in flight. */
+  const controlling = ref(false)
+
+  /** Pause / resume / cancel an executing initiative's loop. Applies the returned entity. */
+  async function control(blockId: string, action: 'pause' | 'resume' | 'cancel') {
+    if (!workspace.workspaceId) throw new Error('No active workspace')
+    controlling.value = true
+    try {
+      const call =
+        action === 'pause'
+          ? api.pauseInitiative
+          : action === 'resume'
+            ? api.resumeInitiative
+            : api.cancelInitiative
+      const updated = await call(workspace.workspaceId, blockId)
+      if (updated) upsert(updated)
+      return updated
+    } finally {
+      controlling.value = false
+    }
+  }
+
   function reset() {
     byBlock.value = {}
   }
@@ -142,6 +164,7 @@ export const useInitiativesStore = defineStore('initiatives', () => {
     all,
     creating,
     resuming,
+    controlling,
     forBlock,
     hydrate,
     upsert,
@@ -150,6 +173,7 @@ export const useInitiativesStore = defineStore('initiatives', () => {
     answerQuestion,
     continuePlanning,
     proceedPlanning,
+    control,
     reset,
   }
 })

package/i18n/locales/en.json

@@ -1346,6 +1346,7 @@
         "visual_confirmation_ready": "Mark read",
         "human_review": "Mark read",
         "followup_pending": "Mark read",
+        "initiative": "Mark read",
         "markRead": "Mark read"
       }
     },
@@ -2623,7 +2624,8 @@
       "clarity_review": "Clarity review",
       "release_regression": "Release regression",
       "human_test_ready": "Ready for human testing",
-      "visual_confirmation_ready": "Ready for visual confirmation"
+      "visual_confirmation_ready": "Ready for visual confirmation",
+      "initiative": "Initiative updates"
     },
     "role": {
       "engineering": "Engineering",
@@ -4140,6 +4142,9 @@
     "inspector": {
       "runPlanning": "Run planning",
       "answerPlanning": "Answer planning questions",
+      "pause": "Pause",
+      "resume": "Resume",
+      "cancel": "Cancel initiative",
       "hint": "The planning pipeline explores the codebase, drafts the multi-phase plan for approval, then commits the tracker document to the repository."
     },
     "planning": {

package/i18n/locales/es.json

@@ -1294,6 +1294,7 @@
         "visual_confirmation_ready": "Marcar como leída",
         "human_review": "Marcar como leída",
         "followup_pending": "Marcar como leída",
+        "initiative": "Marcar como leída",
         "markRead": "Marcar como leída"
       },
       "toast": {
@@ -2549,7 +2550,8 @@
       "clarity_review": "Revision de claridad",
       "release_regression": "Regresion de version",
       "human_test_ready": "Listo para pruebas humanas",
-      "visual_confirmation_ready": "Listo para confirmacion visual"
+      "visual_confirmation_ready": "Listo para confirmacion visual",
+      "initiative": "Actualizaciones de la iniciativa"
     },
     "role": {
       "engineering": "Ingenieria",
@@ -4021,6 +4023,9 @@
     "inspector": {
       "runPlanning": "Ejecutar planificacion",
       "answerPlanning": "Responder preguntas de planificacion",
+      "pause": "Pausar",
+      "resume": "Reanudar",
+      "cancel": "Cancelar iniciativa",
       "hint": "El pipeline de planificacion explora el codigo, redacta el plan multifase para su aprobacion y luego confirma el documento de seguimiento en el repositorio."
     },
     "planning": {

package/i18n/locales/fr.json

@@ -1294,6 +1294,7 @@
         "visual_confirmation_ready": "Marquer comme lu",
         "human_review": "Marquer comme lu",
         "followup_pending": "Marquer comme lu",
+        "initiative": "Marquer comme lu",
         "markRead": "Marquer comme lu"
       },
       "toast": {
@@ -2549,7 +2550,8 @@
       "clarity_review": "Revue de clarte",
       "release_regression": "Regression de version",
       "human_test_ready": "Pret pour les tests humains",
-      "visual_confirmation_ready": "Pret pour la confirmation visuelle"
+      "visual_confirmation_ready": "Pret pour la confirmation visuelle",
+      "initiative": "Mises a jour de l'initiative"
     },
     "role": {
       "engineering": "Ingenierie",
@@ -4021,6 +4023,9 @@
     "inspector": {
       "runPlanning": "Lancer la planification",
       "answerPlanning": "Repondre aux questions de planification",
+      "pause": "Mettre en pause",
+      "resume": "Reprendre",
+      "cancel": "Annuler l'initiative",
       "hint": "Le pipeline de planification explore le code, redige le plan multiphase pour approbation, puis valide le document de suivi dans le depot."
     },
     "planning": {

package/i18n/locales/he.json

@@ -1294,6 +1294,7 @@
         "visual_confirmation_ready": "סמן כנקרא",
         "human_review": "סמן כנקרא",
         "followup_pending": "סמן כנקרא",
+        "initiative": "סמן כנקרא",
         "markRead": "סמן כנקרא"
       },
       "toast": {
@@ -2560,7 +2561,8 @@
       "clarity_review": "סקירת בהירות",
       "release_regression": "רגרסיית שחרור",
       "human_test_ready": "מוכן לבדיקה אנושית",
-      "visual_confirmation_ready": "מוכן לאישור חזותי"
+      "visual_confirmation_ready": "מוכן לאישור חזותי",
+      "initiative": "עדכוני יוזמה"
     },
     "role": {
       "engineering": "הנדסה",
@@ -4032,6 +4034,9 @@
     "inspector": {
       "runPlanning": "הרצת תכנון",
       "answerPlanning": "מענה על שאלות התכנון",
+      "pause": "השהה",
+      "resume": "המשך",
+      "cancel": "ביטול היוזמה",
       "hint": "צינור התכנון חוקר את הקוד, מנסח את התוכנית הרב-שלבית לאישור, ואז שומר את מסמך המעקב במאגר."
     },
     "planning": {

package/i18n/locales/ja.json

@@ -1294,6 +1294,7 @@
         "visual_confirmation_ready": "既読にする",
         "human_review": "既読にする",
         "followup_pending": "既読にする",
+        "initiative": "既読にする",
         "markRead": "既読にする"
       },
       "toast": {
@@ -2562,7 +2563,8 @@
       "clarity_review": "明確性レビュー",
       "release_regression": "リリースリグレッション",
       "human_test_ready": "人手テスト準備完了",
-      "visual_confirmation_ready": "ビジュアル確認準備完了"
+      "visual_confirmation_ready": "ビジュアル確認準備完了",
+      "initiative": "イニシアチブの更新"
     },
     "role": {
       "engineering": "エンジニアリング",
@@ -4034,6 +4036,9 @@
     "inspector": {
       "runPlanning": "計画を実行",
       "answerPlanning": "計画の質問に回答",
+      "pause": "一時停止",
+      "resume": "再開",
+      "cancel": "イニシアチブをキャンセル",
       "hint": "計画パイプラインはコードベースを調査し、承認用の複数フェーズ計画を起草し、その後トラッカー文書をリポジトリにコミットします。"
     },
     "planning": {

package/i18n/locales/pl.json

@@ -1294,6 +1294,7 @@
         "visual_confirmation_ready": "Oznacz jako przeczytane",
         "human_review": "Oznacz jako przeczytane",
         "followup_pending": "Oznacz jako przeczytane",
+        "initiative": "Oznacz jako przeczytane",
         "markRead": "Oznacz jako przeczytane"
       },
       "toast": {
@@ -2549,7 +2550,8 @@
       "clarity_review": "Przeglad klarownosci",
       "release_regression": "Regresja wydania",
       "human_test_ready": "Gotowe do testow przez czlowieka",
-      "visual_confirmation_ready": "Gotowe do potwierdzenia wizualnego"
+      "visual_confirmation_ready": "Gotowe do potwierdzenia wizualnego",
+      "initiative": "Aktualizacje inicjatywy"
     },
     "role": {
       "engineering": "Inzynieria",
@@ -4021,6 +4023,9 @@
     "inspector": {
       "runPlanning": "Uruchom planowanie",
       "answerPlanning": "Odpowiedz na pytania planowania",
+      "pause": "Wstrzymaj",
+      "resume": "Wznow",
+      "cancel": "Anuluj inicjatywe",
       "hint": "Pipeline planowania bada kod, przygotowuje wielofazowy plan do zatwierdzenia, a nastepnie zapisuje dokument trackera w repozytorium."
     },
     "planning": {

package/i18n/locales/tr.json

@@ -1294,6 +1294,7 @@
         "visual_confirmation_ready": "Okundu işaretle",
         "human_review": "Okundu işaretle",
         "followup_pending": "Okundu işaretle",
+        "initiative": "Okundu işaretle",
         "markRead": "Okundu işaretle"
       },
       "toast": {
@@ -2562,7 +2563,8 @@
       "clarity_review": "Netlik incelemesi",
       "release_regression": "Sürüm gerilemesi",
       "human_test_ready": "İnsan testine hazır",
-      "visual_confirmation_ready": "Görsel onaya hazır"
+      "visual_confirmation_ready": "Görsel onaya hazır",
+      "initiative": "Girisim guncellemeleri"
     },
     "role": {
       "engineering": "Mühendislik",
@@ -4034,6 +4036,9 @@
     "inspector": {
       "runPlanning": "Planlamayi calistir",
       "answerPlanning": "Planlama sorularini yanitla",
+      "pause": "Duraklat",
+      "resume": "Devam et",
+      "cancel": "Girisimi iptal et",
       "hint": "Planlama hatti kod tabanini inceler, onay icin cok asamali plani hazirlar ve ardindan izleyici belgesini depoya kaydeder."
     },
     "planning": {

package/i18n/locales/uk.json

@@ -1294,6 +1294,7 @@
         "visual_confirmation_ready": "Позначити прочитаним",
         "human_review": "Позначити прочитаним",
         "followup_pending": "Позначити прочитаним",
+        "initiative": "Позначити прочитаним",
         "markRead": "Позначити прочитаним"
       },
       "toast": {
@@ -2549,7 +2550,8 @@
       "clarity_review": "Перевірка ясності",
       "release_regression": "Регресія випуску",
       "human_test_ready": "Готово до тестування людиною",
-      "visual_confirmation_ready": "Готово до візуального підтвердження"
+      "visual_confirmation_ready": "Готово до візуального підтвердження",
+      "initiative": "Оновлення ініціативи"
     },
     "role": {
       "engineering": "Інженерія",
@@ -4021,6 +4023,9 @@
     "inspector": {
       "runPlanning": "Запустити планування",
       "answerPlanning": "Відповісти на питання планування",
+      "pause": "Призупинити",
+      "resume": "Відновити",
+      "cancel": "Скасувати ініціативу",
       "hint": "Пайплайн планування досліджує кодову базу, готує багатофазний план на затвердження, а потім комітить документ трекера до репозиторію."
     },
     "planning": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.83.1",
+  "version": "0.84.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.90.0"
+    "@cat-factory/contracts": "0.91.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",