@cat-factory/app 0.92.2 → 0.94.0

package/app/components/settings/SharedStacksPanel.vue

@@ -0,0 +1,363 @@
+<script setup lang="ts">
+// Shared stacks — long-lived compose infra (e.g. acme-shared-services: MySQL / Postgres /
+// Valkey / RabbitMQ / Kafka / ES / Mailpit / Envoy) brought up ONCE per workspace and reused
+// across runs + PRs. A per-PR consumer environment attaches to a stack's managed network. CRUD
+// works on every backend; the bring-up (Start) / teardown (Stop) drive a host Docker daemon, so
+// they succeed only on the local facade (elsewhere the backend returns a clear error surfaced as
+// a toast). Renders inline inside the Infrastructure window's "Shared stacks" tab.
+import { computed, reactive, ref } from 'vue'
+import type { SharedStack, SharedStackStatus } from '~/types/sharedStacks'
+
+const { t } = useI18n()
+const store = useSharedStacksStore()
+const toast = useToast()
+const { confirmAction, toastDone } = useConfirmAction()
+
+const stacks = computed(() => store.stacks)
+const busyId = ref<string | null>(null)
+const saving = ref(false)
+// null ⇒ the form is in "add" mode; a stack id ⇒ editing that stack's definition in place.
+const editingId = ref<string | null>(null)
+
+const form = reactive({
+  name: '',
+  cloneUrl: '',
+  gitRef: '',
+  composeFiles: '',
+  composeProfiles: '',
+  managedNetworks: '',
+  allowHostCommands: false,
+})
+
+/** Status → badge colour. */
+const STATUS_COLOR: Record<SharedStackStatus, 'neutral' | 'warning' | 'success' | 'error'> = {
+  stopped: 'neutral',
+  starting: 'warning',
+  running: 'success',
+  failed: 'error',
+}
+
+// Status → catalog key as an EXHAUSTIVE Record over the enum (not a runtime-assembled key), so a
+// new SharedStackStatus fails the typecheck on this map instead of leaking a raw key into the badge.
+const STATUS_LABEL_KEYS: Record<SharedStackStatus, string> = {
+  stopped: 'settings.sharedStacks.status.stopped',
+  starting: 'settings.sharedStacks.status.starting',
+  running: 'settings.sharedStacks.status.running',
+  failed: 'settings.sharedStacks.status.failed',
+}
+
+function statusLabel(status: SharedStackStatus): string {
+  return t(STATUS_LABEL_KEYS[status])
+}
+
+/** A running/starting stack cannot be reconfigured (the backend refuses) — edit is stopped/failed only. */
+function canEdit(stack: SharedStack): boolean {
+  return stack.status !== 'running' && stack.status !== 'starting'
+}
+
+/** Split a comma/whitespace-separated field into trimmed non-empty tokens. */
+function tokens(value: string): string[] {
+  return value
+    .split(/[\s,]+/)
+    .map((s) => s.trim())
+    .filter(Boolean)
+}
+
+const canSave = computed(
+  () => form.name.trim() && form.cloneUrl.trim() && tokens(form.composeFiles).length > 0,
+)
+
+function resetForm() {
+  editingId.value = null
+  form.name = ''
+  form.cloneUrl = ''
+  form.gitRef = ''
+  form.composeFiles = ''
+  form.composeProfiles = ''
+  form.managedNetworks = ''
+  form.allowHostCommands = false
+}
+
+/** Load a stack's definition into the form for in-place editing. */
+function startEdit(stack: SharedStack) {
+  editingId.value = stack.id
+  form.name = stack.name
+  form.cloneUrl = stack.cloneUrl
+  form.gitRef = stack.gitRef ?? ''
+  form.composeFiles = stack.composeFiles.join(', ')
+  form.composeProfiles = stack.composeProfiles.join(', ')
+  form.managedNetworks = stack.managedNetworks.join(', ')
+  form.allowHostCommands = stack.allowHostCommands
+}
+
+function notifyError(title: string, e: unknown) {
+  toast.add({
+    title,
+    description: e instanceof Error ? e.message : String(e),
+    icon: 'i-lucide-triangle-alert',
+    color: 'error',
+  })
+}
+
+/** Create a new stack, or save edits to the one being edited (same form, mode toggled by `editingId`). */
+async function saveStack() {
+  saving.value = true
+  const editing = editingId.value
+  const payload = {
+    name: form.name.trim(),
+    cloneUrl: form.cloneUrl.trim(),
+    ...(form.gitRef.trim() ? { gitRef: form.gitRef.trim() } : {}),
+    composeFiles: tokens(form.composeFiles),
+    composeProfiles: tokens(form.composeProfiles),
+    managedNetworks: tokens(form.managedNetworks),
+    allowHostCommands: form.allowHostCommands,
+  }
+  try {
+    if (editing) {
+      await store.update(editing, { ...payload, gitRef: form.gitRef.trim() || null })
+    } else {
+      await store.create(payload)
+    }
+    resetForm()
+    toast.add({
+      title: t(
+        editing ? 'settings.sharedStacks.toast.updated' : 'settings.sharedStacks.toast.created',
+      ),
+      icon: 'i-lucide-check',
+      color: 'success',
+    })
+  } catch (e) {
+    notifyError(
+      t(
+        editing
+          ? 'settings.sharedStacks.toast.updateFailed'
+          : 'settings.sharedStacks.toast.createFailed',
+      ),
+      e,
+    )
+  } finally {
+    saving.value = false
+  }
+}
+
+async function start(stack: SharedStack) {
+  busyId.value = stack.id
+  try {
+    // ensureUp resolves 200 even on a FAILED bring-up (the record carries status/lastError), so
+    // surface that as an error toast too — not only a thrown transport/unavailable error.
+    const updated = await store.ensureUp(stack.id)
+    if (updated.status === 'failed') {
+      notifyError(t('settings.sharedStacks.toast.startFailed'), updated.lastError ?? '')
+    }
+  } catch (e) {
+    notifyError(t('settings.sharedStacks.toast.startFailed'), e)
+  } finally {
+    busyId.value = null
+  }
+}
+
+async function stop(stack: SharedStack) {
+  busyId.value = stack.id
+  try {
+    await store.teardown(stack.id)
+  } catch (e) {
+    notifyError(t('settings.sharedStacks.toast.stopFailed'), e)
+  } finally {
+    busyId.value = null
+  }
+}
+
+async function remove(stack: SharedStack) {
+  const noun = t('settings.sharedStacks.stackNoun')
+  if (!(await confirmAction('remove', noun))) return
+  busyId.value = stack.id
+  try {
+    await store.remove(stack.id)
+    toastDone('remove', noun)
+  } catch (e) {
+    notifyError(t('settings.sharedStacks.toast.removeFailed'), e)
+  } finally {
+    busyId.value = null
+  }
+}
+</script>
+
+<template>
+  <div class="space-y-4" data-testid="shared-stacks-panel">
+    <p class="text-sm text-slate-400">{{ t('settings.sharedStacks.intro') }}</p>
+
+    <section v-if="stacks.length" class="space-y-2 rounded-lg border border-slate-700 p-3">
+      <h3 class="text-sm font-semibold">{{ t('settings.sharedStacks.list.heading') }}</h3>
+      <div
+        v-for="stack in stacks"
+        :key="stack.id"
+        class="space-y-2 rounded-md border border-slate-800 px-3 py-2"
+        :data-testid="`shared-stack-${stack.id}`"
+      >
+        <div class="flex items-center justify-between gap-2">
+          <div class="min-w-0 space-y-1">
+            <div class="flex items-center gap-2">
+              <span class="text-sm font-medium">{{ stack.name }}</span>
+              <UBadge :color="STATUS_COLOR[stack.status]" variant="soft" size="sm">
+                {{ statusLabel(stack.status) }}
+              </UBadge>
+            </div>
+            <p class="truncate text-[11px] text-slate-500">{{ stack.cloneUrl }}</p>
+            <div v-if="stack.managedNetworks.length" class="flex flex-wrap gap-1">
+              <UBadge
+                v-for="net in stack.managedNetworks"
+                :key="net"
+                color="neutral"
+                variant="soft"
+                size="sm"
+              >
+                {{ net }}
+              </UBadge>
+            </div>
+          </div>
+          <div class="flex shrink-0 items-center gap-1">
+            <UButton
+              v-if="stack.status !== 'running'"
+              icon="i-lucide-play"
+              size="sm"
+              variant="soft"
+              :loading="busyId === stack.id"
+              :data-testid="`shared-stack-start-${stack.id}`"
+              @click="start(stack)"
+            >
+              {{ t('settings.sharedStacks.list.start') }}
+            </UButton>
+            <UButton
+              v-else
+              icon="i-lucide-square"
+              size="sm"
+              variant="soft"
+              color="warning"
+              :loading="busyId === stack.id"
+              :data-testid="`shared-stack-stop-${stack.id}`"
+              @click="stop(stack)"
+            >
+              {{ t('settings.sharedStacks.list.stop') }}
+            </UButton>
+            <UButton
+              v-if="canEdit(stack)"
+              color="neutral"
+              variant="ghost"
+              icon="i-lucide-pencil"
+              size="sm"
+              :data-testid="`shared-stack-edit-${stack.id}`"
+              :aria-label="t('settings.sharedStacks.list.edit')"
+              @click="startEdit(stack)"
+            />
+            <UButton
+              color="error"
+              variant="ghost"
+              icon="i-lucide-trash-2"
+              size="sm"
+              :loading="busyId === stack.id"
+              :data-testid="`shared-stack-delete-${stack.id}`"
+              :aria-label="t('settings.sharedStacks.list.remove')"
+              @click="remove(stack)"
+            />
+          </div>
+        </div>
+        <p v-if="stack.lastError" class="text-[11px] text-rose-400">{{ stack.lastError }}</p>
+      </div>
+    </section>
+
+    <section
+      class="space-y-3 rounded-lg border border-slate-700 p-3"
+      data-testid="shared-stack-form"
+    >
+      <h3 class="text-sm font-semibold">
+        {{
+          t(editingId ? 'settings.sharedStacks.edit.heading' : 'settings.sharedStacks.add.heading')
+        }}
+      </h3>
+
+      <UFormField :label="t('settings.sharedStacks.add.name')">
+        <UInput v-model="form.name" class="w-full" data-testid="shared-stack-name" />
+      </UFormField>
+
+      <UFormField
+        :label="t('settings.sharedStacks.add.cloneUrl')"
+        :help="t('settings.sharedStacks.add.cloneUrlHelp')"
+      >
+        <UInput
+          v-model="form.cloneUrl"
+          placeholder="https://github.com/acme/acme-shared-services.git"
+          class="w-full"
+          data-testid="shared-stack-clone-url"
+        />
+      </UFormField>
+
+      <UFormField :label="t('settings.sharedStacks.add.gitRef')">
+        <UInput
+          v-model="form.gitRef"
+          placeholder="main"
+          class="w-full"
+          data-testid="shared-stack-git-ref"
+        />
+      </UFormField>
+
+      <UFormField
+        :label="t('settings.sharedStacks.add.composeFiles')"
+        :help="t('settings.sharedStacks.add.composeFilesHelp')"
+      >
+        <UInput
+          v-model="form.composeFiles"
+          placeholder="docker-compose.yml, docker-compose.override.yml"
+          class="w-full"
+          data-testid="shared-stack-compose-files"
+        />
+      </UFormField>
+
+      <UFormField :label="t('settings.sharedStacks.add.composeProfiles')">
+        <UInput
+          v-model="form.composeProfiles"
+          placeholder="backends, peer"
+          class="w-full"
+          data-testid="shared-stack-profiles"
+        />
+      </UFormField>
+
+      <UFormField
+        :label="t('settings.sharedStacks.add.managedNetworks')"
+        :help="t('settings.sharedStacks.add.managedNetworksHelp')"
+      >
+        <UInput
+          v-model="form.managedNetworks"
+          placeholder="acme-net"
+          class="w-full"
+          data-testid="shared-stack-networks"
+        />
+      </UFormField>
+
+      <UCheckbox
+        v-model="form.allowHostCommands"
+        :label="t('settings.sharedStacks.add.allowHostCommands')"
+        data-testid="shared-stack-allow-host-commands"
+      />
+
+      <div class="flex items-center gap-2">
+        <UButton
+          :loading="saving"
+          :disabled="!canSave"
+          data-testid="shared-stack-save"
+          @click="saveStack"
+        >
+          {{ t(editingId ? 'settings.sharedStacks.edit.save' : 'settings.sharedStacks.add.save') }}
+        </UButton>
+        <UButton
+          v-if="editingId"
+          color="neutral"
+          variant="ghost"
+          data-testid="shared-stack-cancel-edit"
+          @click="resetForm"
+        >
+          {{ t('settings.sharedStacks.edit.cancel') }}
+        </UButton>
+      </div>
+    </section>
+  </div>
+</template>

package/app/components/spec/ServiceSpecWindow.vue

@@ -147,7 +147,11 @@ function kindLabel(item: RequirementItem): string {
                 :variant="mode === 'structured' ? 'soft' : 'ghost'"
                 size="xs"
                 icon="i-lucide-list-tree"
-                @click="mode = 'structured'"
+                @click="
+                  () => {
+                    mode = 'structured'
+                  }
+                "
               >
                 {{ t('spec.mode.structured') }}
               </UButton>
@@ -158,7 +162,11 @@ function kindLabel(item: RequirementItem): string {
                 icon="i-lucide-square-check-big"
                 :disabled="!hasGherkin"
                 :title="hasGherkin ? t('spec.mode.gherkinTooltip') : t('spec.mode.gherkinNone')"
-                @click="mode = 'gherkin'"
+                @click="
+                  () => {
+                    mode = 'gherkin'
+                  }
+                "
               >
                 {{ t('spec.mode.gherkin') }}
               </UButton>
@@ -210,7 +218,11 @@ function kindLabel(item: RequirementItem): string {
               :variant="selected === null ? 'soft' : 'ghost'"
               size="xs"
               icon="i-lucide-info"
-              @click="selected = null"
+              @click="
+                () => {
+                  selected = null
+                }
+              "
             >
               {{ t('spec.overview') }}
             </UButton>

package/app/components/testing/TestReportWindow.vue

@@ -444,7 +444,11 @@ const GROUP_STATUS_META: Record<ScenarioGroup['status'], { icon: string; text: s
                     size="xs"
                     class="mt-1.5"
                     data-testid="tester-infra-setup-logs-toggle"
-                    @click="showInfraSetupLogs = !showInfraSetupLogs"
+                    @click="
+                      () => {
+                        showInfraSetupLogs = !showInfraSetupLogs
+                      }
+                    "
                   >
                     {{
                       showInfraSetupLogs
@@ -480,7 +484,11 @@ const GROUP_STATUS_META: Record<ScenarioGroup['status'], { icon: string; text: s
                   variant="ghost"
                   size="xs"
                   data-testid="tester-infra-attempts-toggle"
-                  @click="showProvisioning = !showProvisioning"
+                  @click="
+                    () => {
+                      showProvisioning = !showProvisioning
+                    }
+                  "
                 >
                   {{
                     showProvisioning

package/app/composables/api/docInterview.ts

@@ -0,0 +1,36 @@
+import {
+  answerDocInterviewContract,
+  continueDocInterviewContract,
+  getDocInterviewContract,
+  proceedDocInterviewContract,
+} from '@cat-factory/contracts'
+import type { ApiContext } from './context'
+
+/** Interactive document-interview session (WS5): load + answer / continue / proceed. */
+export function docInterviewApi({ send, ws }: ApiContext) {
+  return {
+    // The interview window's load path: the session anchored to a board block (or null).
+    getDocInterview: (workspaceId: string, blockId: string) =>
+      send(getDocInterviewContract, { pathPrefix: ws(workspaceId), pathParams: { blockId } }),
+
+    // Answer one interview question (no run resume), then continue (interviewer re-runs, may
+    // ask more) or proceed (skip remaining, synthesize the brief and advance to the writer).
+    answerDocInterview: (
+      workspaceId: string,
+      blockId: string,
+      questionId: string,
+      answer: string,
+    ) =>
+      send(answerDocInterviewContract, {
+        pathPrefix: ws(workspaceId),
+        pathParams: { blockId },
+        body: { questionId, answer },
+      }),
+
+    continueDocInterview: (workspaceId: string, blockId: string) =>
+      send(continueDocInterviewContract, { pathPrefix: ws(workspaceId), pathParams: { blockId } }),
+
+    proceedDocInterview: (workspaceId: string, blockId: string) =>
+      send(proceedDocInterviewContract, { pathPrefix: ws(workspaceId), pathParams: { blockId } }),
+  }
+}

package/app/composables/api/sharedStacks.ts

@@ -0,0 +1,42 @@
+import {
+  createSharedStackContract,
+  deleteSharedStackContract,
+  ensureSharedStackUpContract,
+  listSharedStacksContract,
+  teardownSharedStackContract,
+  updateSharedStackContract,
+} from '@cat-factory/contracts'
+import type { UpdateSharedStackInput } from '~/types/sharedStacks'
+import type { SendParams } from './client'
+import type { ApiContext } from './context'
+
+// The create body is typed from the contract's INPUT shape so the valibot-defaulted array fields
+// (profiles, envFiles, managedNetworks, setupSteps, allowHostCommands) stay optional for callers.
+type CreateSharedStackBody = NonNullable<SendParams<typeof createSharedStackContract>['body']>
+
+/** A workspace's shared stacks: CRUD plus the ensure-up / teardown lifecycle actions. */
+export function sharedStacksApi({ send, ws }: ApiContext) {
+  return {
+    listSharedStacks: (workspaceId: string) =>
+      send(listSharedStacksContract, { pathPrefix: ws(workspaceId) }),
+
+    createSharedStack: (workspaceId: string, body: CreateSharedStackBody) =>
+      send(createSharedStackContract, { pathPrefix: ws(workspaceId), body }),
+
+    updateSharedStack: (workspaceId: string, stackId: string, body: UpdateSharedStackInput) =>
+      send(updateSharedStackContract, {
+        pathPrefix: ws(workspaceId),
+        pathParams: { stackId },
+        body,
+      }),
+
+    deleteSharedStack: (workspaceId: string, stackId: string) =>
+      send(deleteSharedStackContract, { pathPrefix: ws(workspaceId), pathParams: { stackId } }),
+
+    ensureSharedStackUp: (workspaceId: string, stackId: string) =>
+      send(ensureSharedStackUpContract, { pathPrefix: ws(workspaceId), pathParams: { stackId } }),
+
+    teardownSharedStack: (workspaceId: string, stackId: string) =>
+      send(teardownSharedStackContract, { pathPrefix: ws(workspaceId), pathParams: { stackId } }),
+  }
+}

package/app/composables/useApi.ts

@@ -14,6 +14,7 @@ import { humanReviewApi } from './api/humanReview'
 import { humanTestApi } from './api/humanTest'
 import { infraHandlersApi } from './api/infraHandlers'
 import { initiativeApi } from './api/initiative'
+import { docInterviewApi } from './api/docInterview'
 import { visualConfirmApi } from './api/visualConfirm'
 import { kaizenApi } from './api/kaizen'
 import { localSettingsApi } from './api/localSettings'
@@ -21,6 +22,7 @@ import { modelsApi } from './api/models'
 import { notificationsApi } from './api/notifications'
 import { packageRegistriesApi } from './api/packageRegistries'
 import { presetsApi } from './api/presets'
+import { sharedStacksApi } from './api/sharedStacks'
 import { providerConnectionsApi } from './api/providerConnections'
 import { provisioningLogsApi } from './api/provisioningLogs'
 import { recurringApi } from './api/recurring'
@@ -111,9 +113,11 @@ export function useApi() {
     ...specApi(ctx),
     ...notificationsApi(ctx),
     ...presetsApi(ctx),
+    ...sharedStacksApi(ctx),
     ...providerConnectionsApi(ctx),
     ...infraHandlersApi(ctx),
     ...initiativeApi(ctx),
+    ...docInterviewApi(ctx),
     ...provisioningLogsApi(ctx),
     ...releaseHealthApi(ctx),
     ...packageRegistriesApi(ctx),

package/app/composables/useWorkspaceStream.ts

@@ -26,6 +26,7 @@ export function useWorkspaceStream() {
   const brainstorm = useBrainstormStore()
   const kaizen = useKaizenStore()
   const initiatives = useInitiativesStore()
+  const docInterview = useDocInterviewStore()
   const api = useApi()
   const apiBase = useRuntimeConfig().public.apiBase
 
@@ -108,6 +109,10 @@ export function useWorkspaceStream() {
       // An initiative changed (created, plan ingested, an item settled) — patch the cache
       // so an open tracker window / the board card reflects the transition live.
       initiatives.upsert(event.initiative)
+    } else if (event.type === 'docInterview') {
+      // The interactive document interview advanced (a fresh batch of questions, an answer, or
+      // convergence) — patch the cache so an open interview window reflects it live.
+      docInterview.upsert(event.session)
     }
   }
 

package/app/stores/docInterview.ts

@@ -0,0 +1,89 @@
+import { defineStore } from 'pinia'
+import { ref } from 'vue'
+import type { DocInterviewSession } from '~/types/domain'
+import { useWorkspaceStore } from '~/stores/workspace'
+
+/**
+ * Interactive document-interview sessions (WS5), keyed by their anchor BLOCK id. Loaded on
+ * demand when the interview window opens (`load`) and patched live from `docInterview` stream
+ * events (`upsert`), so an open window follows the interview as the interviewer asks / converges.
+ * Not carried in the workspace snapshot (a transient per-run gate, unlike initiatives).
+ * Per-workspace; nothing is persisted client-side.
+ */
+export const useDocInterviewStore = defineStore('docInterview', () => {
+  const api = useApi()
+  const workspace = useWorkspaceStore()
+
+  /** The sessions keyed by their anchor block id. */
+  const byBlock = ref<Record<string, DocInterviewSession>>({})
+  /** True while a window action (continue/proceed) is resuming the run. */
+  const resuming = ref(false)
+
+  function forBlock(blockId: string): DocInterviewSession | null {
+    return byBlock.value[blockId] ?? null
+  }
+
+  /** Patch from a live `docInterview` stream event or a call response (newest write wins). */
+  function upsert(session: DocInterviewSession) {
+    const existing = byBlock.value[session.blockId]
+    if (existing && existing.updatedAt > session.updatedAt) return
+    byBlock.value = { ...byBlock.value, [session.blockId]: session }
+  }
+
+  /** Re-fetch one block's session (the interview window's load path). */
+  async function load(blockId: string) {
+    if (!workspace.workspaceId) return
+    const session = await api.getDocInterview(workspace.workspaceId, blockId)
+    if (session) upsert(session)
+  }
+
+  /** Record the human's answer to one pending interview question (no run resume). */
+  async function answerQuestion(blockId: string, questionId: string, answer: string) {
+    if (!workspace.workspaceId) throw new Error('No active workspace')
+    const updated = await api.answerDocInterview(workspace.workspaceId, blockId, questionId, answer)
+    upsert(updated)
+    return updated
+  }
+
+  /** Submit the answers and resume the interview (the interviewer re-runs, may ask more). */
+  async function continueInterview(blockId: string) {
+    if (!workspace.workspaceId) throw new Error('No active workspace')
+    resuming.value = true
+    try {
+      const updated = await api.continueDocInterview(workspace.workspaceId, blockId)
+      upsert(updated)
+      return updated
+    } finally {
+      resuming.value = false
+    }
+  }
+
+  /** Skip remaining questions: the interviewer converges and the run advances to the writer. */
+  async function proceedInterview(blockId: string) {
+    if (!workspace.workspaceId) throw new Error('No active workspace')
+    resuming.value = true
+    try {
+      const updated = await api.proceedDocInterview(workspace.workspaceId, blockId)
+      upsert(updated)
+      return updated
+    } finally {
+      resuming.value = false
+    }
+  }
+
+  function reset() {
+    byBlock.value = {}
+  }
+
+  return {
+    byBlock,
+    resuming,
+    forBlock,
+    upsert,
+    load,
+    answerQuestion,
+    continueInterview,
+    proceedInterview,
+    reset,
+  }
+})