@cat-factory/app 0.303.3 → 0.304.0

package/app/composables/api/guidedReview.ts

@@ -0,0 +1,80 @@
+import {
+  askGuidedReviewContract,
+  deleteGuidedReviewContract,
+  getGuidedReviewContract,
+  getGuidedReviewThreadContract,
+  listGuidedReviewsContract,
+  openGuidedReviewContract,
+  openGuidedReviewThreadContract,
+  refreshGuidedReviewContract,
+  requestGuidedReviewDraftsContract,
+} from '@cat-factory/contracts'
+import type {
+  AskGuidedReviewInput,
+  OpenGuidedReviewInput,
+  OpenGuidedReviewThreadInput,
+} from '~/types/domain'
+import type { ApiContext } from './context'
+
+/** Guided PR review: sessions, their threads, questions and comment-draft requests. */
+export function guidedReviewApi({ send, ws }: ApiContext) {
+  return {
+    openGuidedReview: (workspaceId: string, body: OpenGuidedReviewInput) =>
+      send(openGuidedReviewContract, { pathPrefix: ws(workspaceId), body }),
+
+    listGuidedReviews: (
+      workspaceId: string,
+      query: { repoId?: string; prNumber?: string; mine?: 'true' | 'false' } = {},
+    ) => send(listGuidedReviewsContract, { pathPrefix: ws(workspaceId), queryParams: query }),
+
+    getGuidedReview: (workspaceId: string, sessionId: string) =>
+      send(getGuidedReviewContract, { pathPrefix: ws(workspaceId), pathParams: { sessionId } }),
+
+    deleteGuidedReview: (workspaceId: string, sessionId: string) =>
+      send(deleteGuidedReviewContract, { pathPrefix: ws(workspaceId), pathParams: { sessionId } }),
+
+    refreshGuidedReview: (workspaceId: string, sessionId: string) =>
+      send(refreshGuidedReviewContract, { pathPrefix: ws(workspaceId), pathParams: { sessionId } }),
+
+    openGuidedReviewThread: (
+      workspaceId: string,
+      sessionId: string,
+      body: OpenGuidedReviewThreadInput,
+    ) =>
+      send(openGuidedReviewThreadContract, {
+        pathPrefix: ws(workspaceId),
+        pathParams: { sessionId },
+        body,
+      }),
+
+    getGuidedReviewThread: (workspaceId: string, sessionId: string, threadId: string) =>
+      send(getGuidedReviewThreadContract, {
+        pathPrefix: ws(workspaceId),
+        pathParams: { sessionId, threadId },
+      }),
+
+    askGuidedReview: (
+      workspaceId: string,
+      sessionId: string,
+      threadId: string,
+      body: AskGuidedReviewInput,
+    ) =>
+      send(askGuidedReviewContract, {
+        pathPrefix: ws(workspaceId),
+        pathParams: { sessionId, threadId },
+        body,
+      }),
+
+    requestGuidedReviewDrafts: (
+      workspaceId: string,
+      sessionId: string,
+      threadId: string,
+      instructions = '',
+    ) =>
+      send(requestGuidedReviewDraftsContract, {
+        pathPrefix: ws(workspaceId),
+        pathParams: { sessionId, threadId },
+        body: { instructions },
+      }),
+  }
+}

package/app/composables/useApi.ts

@@ -29,6 +29,7 @@ import { humanTestApi } from './api/humanTest'
 import { infraHandlersApi } from './api/infraHandlers'
 import { initiativeApi } from './api/initiative'
 import { docInterviewApi } from './api/docInterview'
+import { guidedReviewApi } from './api/guidedReview'
 import { visualConfirmApi } from './api/visualConfirm'
 import { kaizenApi } from './api/kaizen'
 import { localSettingsApi } from './api/localSettings'
@@ -160,6 +161,7 @@ export function useApi() {
     ...infraHandlersApi(ctx),
     ...initiativeApi(ctx),
     ...docInterviewApi(ctx),
+    ...guidedReviewApi(ctx),
     ...provisioningLogsApi(ctx),
     ...releaseHealthApi(ctx),
     ...validationChecksApi(ctx),

package/app/composables/usePipelineErrorToast.ts

@@ -171,6 +171,10 @@ const CONFLICT_INFO: Record<Exclude<ConflictReason, BespokeConflictReason>, Conf
     titleKey: 'errors.conflict.title.delegated_claim_missing',
     descriptionKey: 'errors.conflict.description.delegated_claim_missing',
   },
+  thread_busy: {
+    titleKey: 'errors.conflict.title.thread_busy',
+    descriptionKey: 'errors.conflict.description.thread_busy',
+  },
   task_limit_reached: {
     titleKey: 'errors.conflict.title.task_limit_reached',
     descriptionKey: 'errors.conflict.description.task_limit_reached',

package/app/composables/useWorkspaceStream.ts

@@ -34,6 +34,7 @@ export function useWorkspaceStream() {
   const kaizen = useKaizenStore()
   const initiatives = useInitiativesStore()
   const docInterview = useDocInterviewStore()
+  const guidedReview = useGuidedReviewStore()
   const api = useApi()
   const apiBase = useRuntimeConfig().public.apiBase
 
@@ -89,6 +90,7 @@ export function useWorkspaceStream() {
     upsertKaizen: (g) => kaizen.upsert(g),
     upsertInitiative: (i) => initiatives.upsert(i),
     upsertDocInterview: (s) => docInterview.upsert(s),
+    guidedReviewChanged: (change) => void guidedReview.applyChange(change),
     refreshBoard: () => coarse.schedule(),
   }
 
@@ -148,6 +150,8 @@ export function useWorkspaceStream() {
       // failure (`coarse.withRetry`) so a reconnect no longer presents as fully live while
       // silently missing everything from the outage; `connected` is still set even if every
       // retry fails (we ARE connected; a refresh error must not wedge the indicator/tests).
+      // A guided review is not in the snapshot, so whatever this tab has loaded refetches itself.
+      void guidedReview.resync()
       void coarse.withRetry(workspaceId).finally(() => {
         // A workspace switch (or stop()) may have happened while the refresh was in
         // flight — don't announce a connection for a socket we've since abandoned.

package/app/composables/workspaceStream/applyWorkspaceEvent.spec.ts

@@ -30,6 +30,7 @@ function targets(): WorkspaceEventTargets & { calls: string[] } {
     upsertKaizen: record('upsertKaizen'),
     upsertInitiative: record('upsertInitiative'),
     upsertDocInterview: record('upsertDocInterview'),
+    guidedReviewChanged: record('guidedReviewChanged'),
     refreshBoard: record('refreshBoard'),
   }
 }
@@ -129,6 +130,7 @@ describe('applyWorkspaceEvent: the other branches', () => {
       [{ type: 'kaizen', grading: {} as never, at: 1 }, 'upsertKaizen'],
       [{ type: 'initiative', initiative: {} as never, at: 1 }, 'upsertInitiative'],
       [{ type: 'docInterview', session: {} as never, at: 1 }, 'upsertDocInterview'],
+      [{ type: 'guidedReview', change: {} as never, at: 1 }, 'guidedReviewChanged'],
     ]
 
     for (const [event, expected] of cases) {

package/app/composables/workspaceStream/applyWorkspaceEvent.ts

@@ -16,6 +16,7 @@ import type { BrainstormSession } from '~/types/brainstorm'
 import type { ClarityReview } from '~/types/clarity'
 import type { ConsensusSession } from '~/types/consensus'
 import type { DocInterviewSession } from '~/types/doc-interview'
+import type { GuidedReviewChange } from '~/types/guided-review'
 import type { RequirementReview } from '~/types/requirements'
 
 /**
@@ -44,6 +45,8 @@ export interface WorkspaceEventTargets {
   upsertKaizen: (g: KaizenGrading) => void
   upsertInitiative: (i: Initiative) => void
   upsertDocInterview: (s: DocInterviewSession) => void
+  /** A guided review moved; the store refetches only what this client has loaded. */
+  guidedReviewChanged: (change: GuidedReviewChange) => void
   /** Debounced full `workspace.refresh()`: the fallback for a change no payload can state. */
   refreshBoard: () => void
 }
@@ -151,6 +154,9 @@ export function applyWorkspaceEvent(event: WorkspaceEvent, to: WorkspaceEventTar
       // convergence): patch the cache so an open interview window reflects it live.
       to.upsertDocInterview(event.session)
       return
+    case 'guidedReview':
+      to.guidedReviewChanged(event.change)
+      return
     default:
       return dropUnknownEvent(event)
   }

package/app/stores/guidedReview.spec.ts

@@ -0,0 +1,148 @@
+import { describe, expect, it, vi } from 'vitest'
+import { ApiError } from '~/composables/api/errors'
+import { useGuidedReviewStore } from '~/stores/guidedReview'
+import { useWorkspaceStore } from '~/stores/workspace'
+
+function view(sessionId: string, title: string) {
+  return {
+    session: { id: sessionId, prTitle: title },
+    threads: [],
+    drafts: [],
+  } as never
+}
+
+function threadView(threadId: string, messages: number) {
+  return {
+    thread: { id: threadId, sessionId: 's1' },
+    messages: Array.from({ length: messages }, (_, i) => ({ id: `m${i}` })),
+  } as never
+}
+
+function deferred<T>() {
+  let resolve!: (value: T) => void
+  const promise = new Promise<T>((r) => (resolve = r))
+  return { promise, resolve }
+}
+
+describe('guided review store', () => {
+  it('refetches only what this client has loaded when a change arrives', async () => {
+    const getGuidedReview = vi.fn(async (_ws: string, id: string) => view(id, 'fresh'))
+    const getGuidedReviewThread = vi.fn(async () => threadView('t1', 2))
+    vi.stubGlobal('useApi', () => ({ getGuidedReview, getGuidedReviewThread }))
+    useWorkspaceStore().workspaceId = 'ws_1'
+    const store = useGuidedReviewStore()
+
+    await store.applyChange({ sessionId: 'elsewhere', scope: 'thread', threadId: 't9' })
+    expect(getGuidedReview).not.toHaveBeenCalled()
+    expect(getGuidedReviewThread).not.toHaveBeenCalled()
+
+    await store.loadSession('s1')
+    await store.loadThread('s1', 't1')
+    getGuidedReview.mockClear()
+    getGuidedReviewThread.mockClear()
+    await store.applyChange({ sessionId: 's1', scope: 'thread', threadId: 't1' })
+    expect(getGuidedReview).toHaveBeenCalledTimes(1)
+    expect(getGuidedReviewThread).toHaveBeenCalledTimes(1)
+  })
+
+  it('drops a slow reply that a newer fetch overtook', async () => {
+    const slow = deferred<never>()
+    const replies = [slow.promise, Promise.resolve(view('s1', 'newer'))]
+    vi.stubGlobal('useApi', () => ({ getGuidedReview: vi.fn(() => replies.shift()) }))
+    useWorkspaceStore().workspaceId = 'ws_1'
+    const store = useGuidedReviewStore()
+
+    const first = store.loadSession('s1')
+    await store.loadSession('s1')
+    slow.resolve(view('s1', 'stale'))
+    await first
+    expect(store.sessions.s1?.session.prTitle).toBe('newer')
+  })
+
+  it('lets a refresh win over a load that started before it', async () => {
+    const slow = deferred<never>()
+    vi.stubGlobal('useApi', () => ({
+      getGuidedReview: vi.fn(() => slow.promise),
+      refreshGuidedReview: vi.fn(async () => view('s1', 'refreshed')),
+    }))
+    useWorkspaceStore().workspaceId = 'ws_1'
+    const store = useGuidedReviewStore()
+
+    const load = store.loadSession('s1')
+    await store.refresh('s1')
+    slow.resolve(view('s1', 'stale'))
+    await load
+    expect(store.sessions.s1?.session.prTitle).toBe('refreshed')
+  })
+
+  it('does not bring back a deleted session through a load still in flight', async () => {
+    const slow = deferred<never>()
+    vi.stubGlobal('useApi', () => ({ getGuidedReview: vi.fn(() => slow.promise) }))
+    useWorkspaceStore().workspaceId = 'ws_1'
+    const store = useGuidedReviewStore()
+
+    const load = store.loadSession('s1')
+    await store.applyChange({ sessionId: 's1', scope: 'deleted' })
+    slow.resolve(view('s1', 'stale'))
+    await load
+    expect(store.sessions.s1).toBeUndefined()
+  })
+
+  it('refetches the thread a drafts change names', async () => {
+    const getGuidedReview = vi.fn(async (_ws: string, id: string) => view(id, 'x'))
+    const getGuidedReviewThread = vi.fn(async () => threadView('t1', 3))
+    vi.stubGlobal('useApi', () => ({ getGuidedReview, getGuidedReviewThread }))
+    useWorkspaceStore().workspaceId = 'ws_1'
+    const store = useGuidedReviewStore()
+    await store.loadSession('s1')
+    await store.loadThread('s1', 't1')
+    getGuidedReviewThread.mockClear()
+    await store.applyChange({ sessionId: 's1', scope: 'drafts', threadId: 't1' })
+    expect(getGuidedReviewThread).toHaveBeenCalledTimes(1)
+  })
+
+  it('records a failed background refetch and clears it when the session lands again', async () => {
+    const failure = new ApiError(503, { error: { code: 'unavailable' } })
+    const getGuidedReview = vi
+      .fn()
+      .mockResolvedValueOnce(view('s1', 'x'))
+      .mockRejectedValueOnce(failure)
+      .mockResolvedValueOnce(view('s1', 'y'))
+    vi.stubGlobal('useApi', () => ({ getGuidedReview }))
+    useWorkspaceStore().workspaceId = 'ws_1'
+    const store = useGuidedReviewStore()
+    await store.loadSession('s1')
+    await store.applyChange({ sessionId: 's1', scope: 'session' })
+    expect(store.sessions.s1?.session.prTitle).toBe('x')
+    expect(store.refetchFailures.s1).toBe(failure)
+    await store.applyChange({ sessionId: 's1', scope: 'session' })
+    expect(store.refetchFailures.s1).toBeUndefined()
+  })
+
+  it('forgets a session whose refetch answers 404', async () => {
+    const getGuidedReview = vi
+      .fn()
+      .mockResolvedValueOnce(view('s1', 'x'))
+      .mockRejectedValueOnce(new ApiError(404, { error: { code: 'not_found' } }))
+    vi.stubGlobal('useApi', () => ({ getGuidedReview }))
+    useWorkspaceStore().workspaceId = 'ws_1'
+    const store = useGuidedReviewStore()
+    await store.loadSession('s1')
+    await store.applyChange({ sessionId: 's1', scope: 'session' })
+    expect(store.sessions.s1).toBeUndefined()
+  })
+
+  it('forgets a deleted session and its threads', async () => {
+    vi.stubGlobal('useApi', () => ({
+      getGuidedReview: vi.fn(async () => view('s1', 'x')),
+      getGuidedReviewThread: vi.fn(async () => threadView('t1', 1)),
+    }))
+    useWorkspaceStore().workspaceId = 'ws_1'
+    const store = useGuidedReviewStore()
+    await store.loadSession('s1')
+    await store.loadThread('s1', 't1')
+    await store.applyChange({ sessionId: 's1', scope: 'deleted' })
+    expect(store.sessions.s1).toBeUndefined()
+    expect(store.threads.t1).toBeUndefined()
+  })
+})

package/app/stores/guidedReview.ts

@@ -0,0 +1,200 @@
+import { defineStore } from 'pinia'
+import { ref } from 'vue'
+import type {
+  AskGuidedReviewInput,
+  GuidedReviewChange,
+  GuidedReviewSessionView,
+  GuidedReviewThreadView,
+  OpenGuidedReviewInput,
+  OpenGuidedReviewThreadInput,
+} from '~/types/domain'
+import { ApiError } from '~/composables/api/errors'
+import { useWorkspaceStore } from '~/stores/workspace'
+
+/**
+ * Guided PR review sessions and the threads a window has opened, loaded on demand and kept live
+ * by `guidedReview` stream events. An event carries ids only, so `applyChange` refetches what is
+ * loaded here and ignores the rest. Every fetch and every write takes a ticket, and a fetch lands
+ * only while its ticket is the newest for its key, so a change that arrives mid-fetch is never
+ * lost to a stale reply and a forgotten session is never brought back by one.
+ */
+export const useGuidedReviewStore = defineStore('guidedReview', () => {
+  const api = useApi()
+  const workspace = useWorkspaceStore()
+
+  const sessions = ref<Record<string, GuidedReviewSessionView>>({})
+  const threads = ref<Record<string, GuidedReviewThreadView>>({})
+  /**
+   * The last error of a background refetch per session, cleared when that session or one of its
+   * threads lands again, so a window can say its view may be out of date.
+   */
+  const refetchFailures = ref<Record<string, unknown>>({})
+  // One counter for every key and never reset, so a key dropped by `forget` or `reset` is never
+  // landed on by a fetch that was in flight when it went.
+  let issued = 0
+  const newest = new Map<string, number>()
+
+  const sessionKey = (sessionId: string) => `s:${sessionId}`
+  const threadKey = (sessionId: string, threadId: string) => `t:${sessionId}:${threadId}`
+
+  function claim(key: string): number {
+    issued += 1
+    newest.set(key, issued)
+    return issued
+  }
+
+  /** Run `fetch` for `key`, landing its result only if no newer fetch or write for it started. */
+  async function latest<T>(key: string, fetch: () => Promise<T>, land: (value: T) => void) {
+    const ticket = claim(key)
+    const value = await fetch()
+    if (newest.get(key) === ticket) land(value)
+  }
+
+  function putSession(view: GuidedReviewSessionView) {
+    sessions.value[view.session.id] = view
+    delete refetchFailures.value[view.session.id]
+  }
+
+  function putThread(view: GuidedReviewThreadView) {
+    threads.value[view.thread.id] = view
+    delete refetchFailures.value[view.thread.sessionId]
+  }
+
+  function loadSession(sessionId: string): Promise<void> {
+    const ws = workspace.requireId()
+    return latest(sessionKey(sessionId), () => api.getGuidedReview(ws, sessionId), putSession)
+  }
+
+  function loadThread(sessionId: string, threadId: string): Promise<void> {
+    const ws = workspace.requireId()
+    return latest(
+      threadKey(sessionId, threadId),
+      () => api.getGuidedReviewThread(ws, sessionId, threadId),
+      putThread,
+    )
+  }
+
+  async function open(input: OpenGuidedReviewInput): Promise<GuidedReviewSessionView> {
+    const view = await api.openGuidedReview(workspace.requireId(), input)
+    claim(sessionKey(view.session.id))
+    putSession(view)
+    return view
+  }
+
+  function refresh(sessionId: string): Promise<void> {
+    const ws = workspace.requireId()
+    return latest(sessionKey(sessionId), () => api.refreshGuidedReview(ws, sessionId), putSession)
+  }
+
+  async function remove(sessionId: string): Promise<void> {
+    await api.deleteGuidedReview(workspace.requireId(), sessionId)
+    forget(sessionId)
+  }
+
+  async function openThread(
+    sessionId: string,
+    input: OpenGuidedReviewThreadInput,
+  ): Promise<GuidedReviewThreadView> {
+    const view = await api.openGuidedReviewThread(workspace.requireId(), sessionId, input)
+    claim(threadKey(sessionId, view.thread.id))
+    putThread(view)
+    await loadSession(sessionId)
+    return view
+  }
+
+  async function ask(sessionId: string, threadId: string, input: AskGuidedReviewInput) {
+    await api.askGuidedReview(workspace.requireId(), sessionId, threadId, input)
+    await Promise.all([loadThread(sessionId, threadId), loadSession(sessionId)])
+  }
+
+  async function requestDrafts(sessionId: string, threadId: string, instructions = '') {
+    await api.requestGuidedReviewDrafts(workspace.requireId(), sessionId, threadId, instructions)
+    await Promise.all([loadThread(sessionId, threadId), loadSession(sessionId)])
+  }
+
+  function forget(sessionId: string) {
+    delete sessions.value[sessionId]
+    delete refetchFailures.value[sessionId]
+    newest.delete(sessionKey(sessionId))
+    const threadPrefix = threadKey(sessionId, '')
+    for (const key of newest.keys()) {
+      if (key.startsWith(threadPrefix)) newest.delete(key)
+    }
+    for (const [id, view] of Object.entries(threads.value)) {
+      if (view.thread.sessionId === sessionId) delete threads.value[id]
+    }
+  }
+
+  /** Drop everything on a board switch; fetches still in flight for the old board never land. */
+  function reset() {
+    sessions.value = {}
+    threads.value = {}
+    refetchFailures.value = {}
+    newest.clear()
+  }
+
+  /**
+   * A refetch nobody awaits (a live event, a reconnect). A session that answers 404 is gone and
+   * is forgotten; any other failure keeps the last view and is recorded in `refetchFailures`.
+   */
+  async function follow(sessionId: string, load: () => Promise<void>): Promise<void> {
+    try {
+      await load()
+    } catch (error) {
+      if (error instanceof ApiError && error.statusCode === 404) {
+        forget(sessionId)
+        return
+      }
+      if (sessions.value[sessionId]) refetchFailures.value[sessionId] = error
+    }
+  }
+
+  /** Follow a live `guidedReview` event: refetch what this client has loaded, nothing else. */
+  async function applyChange(change: GuidedReviewChange): Promise<void> {
+    if (change.scope === 'deleted') {
+      forget(change.sessionId)
+      return
+    }
+    const { sessionId } = change
+    const loads: Promise<void>[] = []
+    // A thread change also moves the session's summary (its pending answer), so both refetch.
+    if (sessions.value[sessionId]) {
+      loads.push(follow(sessionId, () => loadSession(sessionId)))
+    }
+    if (change.scope === 'thread' || change.scope === 'drafts') {
+      const { threadId } = change
+      if (threads.value[threadId]) {
+        loads.push(follow(sessionId, () => loadThread(sessionId, threadId)))
+      }
+    }
+    await Promise.all(loads)
+  }
+
+  /** Refetch everything loaded here, for events missed while the stream was disconnected. */
+  async function resync(): Promise<void> {
+    const loads = [
+      ...Object.keys(sessions.value).map((id) => follow(id, () => loadSession(id))),
+      ...Object.values(threads.value).map(({ thread }) =>
+        follow(thread.sessionId, () => loadThread(thread.sessionId, thread.id)),
+      ),
+    ]
+    await Promise.all(loads)
+  }
+
+  return {
+    sessions,
+    threads,
+    refetchFailures,
+    loadSession,
+    loadThread,
+    open,
+    refresh,
+    remove,
+    openThread,
+    ask,
+    requestDrafts,
+    applyChange,
+    resync,
+    reset,
+  }
+})

package/app/stores/workspace/hydrate.ts

@@ -10,6 +10,7 @@ import { useEnvironmentTestStore } from '~/stores/environmentTest'
 import { useExecutionStore } from '~/stores/execution'
 import { useFragmentsStore } from '~/stores/fragments'
 import { useGitHubStore } from '~/stores/github'
+import { useGuidedReviewStore } from '~/stores/guidedReview'
 import { useInitiativesStore } from '~/stores/initiative'
 import { useKaizenStore } from '~/stores/kaizen'
 import { useObservabilityStore } from '~/stores/observability'
@@ -45,6 +46,7 @@ export function resetPerBoardCaches() {
   useGitHubStore().reset()
   useInitiativesStore().reset()
   useDocInterviewStore().reset()
+  useGuidedReviewStore().reset()
   // The per-RUN observability + Kaizen caches. An execution id belongs to the board that owns it
   // and neither store is part of the snapshot, so nothing else ever evicted a key: a session that
   // visited several boards kept every run it had ever opened a panel on.

package/app/types/domain.ts

@@ -258,3 +258,4 @@ export type * from './recurring'
 export type * from './tracker'
 export type * from './initiative'
 export type * from './doc-interview'
+export type * from './guided-review'

package/app/types/guided-review.ts

@@ -0,0 +1,14 @@
+// Guided PR review wire shapes, re-exported from the shared contracts package. The SPA imports
+// these through `~/types/domain` like every other domain type.
+export type {
+  AskGuidedReviewInput,
+  GuidedReviewChange,
+  GuidedReviewCommentDraft,
+  GuidedReviewExchange,
+  GuidedReviewMessage,
+  GuidedReviewSession,
+  GuidedReviewSessionView,
+  GuidedReviewThreadView,
+  OpenGuidedReviewInput,
+  OpenGuidedReviewThreadInput,
+} from '@cat-factory/contracts'

package/i18n/locales/de.json

@@ -6313,7 +6313,8 @@
         "no_host_frame": "Diese Expedition liegt unter keinem Service",
         "delegated_executor_unwired": "Externer Executor nicht registriert",
         "delegated_step_async_only": "Dieser Schritt wird abgefragt, nicht abgewartet",
-        "delegated_claim_missing": "Für diesen Schritt gibt es keine externe Arbeit zu prüfen"
+        "delegated_claim_missing": "Für diesen Schritt gibt es keine externe Arbeit zu prüfen",
+        "thread_busy": "Dieser Thread antwortet noch"
       },
       "description": {
         "dependencies_unmet": "Diese Aufgabe hängt von anderen ab, die noch nicht abgeschlossen sind. Schließe sie ab oder gib sie frei und starte dann erneut.",
@@ -6370,7 +6371,8 @@
         "no_host_frame": "Eine Behebungsaufgabe braucht einen Service als Zuhause und ein Repository zum Beheben. Verschieben Sie die Expeditionsaufgabe unter einen Service-Rahmen und versuchen Sie es erneut.",
         "delegated_executor_unwired": "Ein Schritt dieser Pipeline läuft auf einem externen Executor, den diese Installation nicht registriert; es gibt also kein Ziel für die Arbeit. Registriere den Executor im Code oder wähle für den Schritt einen, der hier läuft.",
         "delegated_step_async_only": "Dieser Schritt läuft auf einem externen Executor und kann Stunden dauern. Er wird deshalb angestoßen und danach abgefragt, statt innerhalb einer Anfrage ausgeführt zu werden. Starte den Lauf über das Board; wenn du aus eigenem Code hierherkommst, steuere den Schritt über den asynchronen Pfad.",
-        "delegated_claim_missing": "Der Eintrag des Laufs darüber, was an den externen Executor geschickt wurde, fehlt, also gibt es nichts abzufragen. Am Executor selbst ist nichts falsch. Lade den Lauf neu und starte den Schritt erneut, falls er weiterhin hängt."
+        "delegated_claim_missing": "Der Eintrag des Laufs darüber, was an den externen Executor geschickt wurde, fehlt, also gibt es nichts abzufragen. Am Executor selbst ist nichts falsch. Lade den Lauf neu und starte den Schritt erneut, falls er weiterhin hängt.",
+        "thread_busy": "Die vorherige Frage in diesem Thread ist noch nicht beantwortet. Warte auf die Antwort oder frag in einem anderen Thread."
       },
       "action": {
         "connectGitHub": "GitHub verbinden",

package/i18n/locales/en.json

@@ -803,7 +803,8 @@
         "no_host_frame": "This expedition is not under a service",
         "delegated_executor_unwired": "External executor not registered",
         "delegated_step_async_only": "This step is polled, not awaited",
-        "delegated_claim_missing": "This step has no external work to check"
+        "delegated_claim_missing": "This step has no external work to check",
+        "thread_busy": "This thread is still answering"
       },
       "description": {
         "dependencies_unmet": "This task depends on others that aren't finished yet. Complete or unblock them, then start it again.",
@@ -863,7 +864,8 @@
         "no_host_frame": "A fix task needs a service to live under and a repository to fix. Move the expedition task under a service frame and try again.",
         "delegated_executor_unwired": "A step in this pipeline runs on an external executor this deployment does not register, so there is nowhere to send the work. Register the executor in code, or change the step to one that runs here.",
         "delegated_step_async_only": "This step runs on an external executor, which can take hours, so it is dispatched and then polled rather than run inside one request. Start the run from the board; if you reached this from your own code, drive the step through the async path.",
-        "delegated_claim_missing": "The run’s record of what it sent to the external executor is missing, so there is nothing to poll. Nothing is wrong with the executor itself. Reload the run, and re-run the step if it is still stuck."
+        "delegated_claim_missing": "The run’s record of what it sent to the external executor is missing, so there is nothing to poll. Nothing is wrong with the executor itself. Reload the run, and re-run the step if it is still stuck.",
+        "thread_busy": "The previous question in this thread has not been answered yet. Wait for that answer, or ask in another thread."
       },
       "action": {
         "connectGitHub": "Connect GitHub",

package/i18n/locales/es.json

@@ -725,7 +725,8 @@
         "no_host_frame": "Esta expedición no está bajo un servicio",
         "delegated_executor_unwired": "Ejecutor externo no registrado",
         "delegated_step_async_only": "Este paso se consulta, no se espera",
-        "delegated_claim_missing": "Este paso no tiene trabajo externo que consultar"
+        "delegated_claim_missing": "Este paso no tiene trabajo externo que consultar",
+        "thread_busy": "Este hilo todavía está respondiendo"
       },
       "description": {
         "dependencies_unmet": "Esta tarea depende de otras que aún no están terminadas. Complétalas o desbloquéalas y vuelve a iniciarla.",
@@ -782,7 +783,8 @@
         "no_host_frame": "Una tarea de corrección necesita un servicio donde vivir y un repositorio que arreglar. Mueva la tarea de la expedición bajo un marco de servicio e inténtelo de nuevo.",
         "delegated_executor_unwired": "Un paso de esta canalización se ejecuta en un ejecutor externo que esta instalación no registra, así que no hay dónde enviar el trabajo. Registra el ejecutor en el código o cambia el paso por uno que se ejecute aquí.",
         "delegated_step_async_only": "Este paso se ejecuta en un ejecutor externo y puede tardar horas, así que se lanza y luego se consulta en lugar de ejecutarse dentro de una sola petición. Inicia la ejecución desde el tablero; si has llegado aquí desde tu propio código, conduce el paso por la vía asíncrona.",
-        "delegated_claim_missing": "Falta el registro de lo que la ejecución envió al ejecutor externo, así que no hay nada que consultar. El ejecutor en sí no tiene ningún problema. Recarga la ejecución y vuelve a lanzar el paso si sigue atascado."
+        "delegated_claim_missing": "Falta el registro de lo que la ejecución envió al ejecutor externo, así que no hay nada que consultar. El ejecutor en sí no tiene ningún problema. Recarga la ejecución y vuelve a lanzar el paso si sigue atascado.",
+        "thread_busy": "La pregunta anterior de este hilo aún no tiene respuesta. Espera esa respuesta o pregunta en otro hilo."
       },
       "action": {
         "connectGitHub": "Conectar GitHub",

package/i18n/locales/fr.json

@@ -725,7 +725,8 @@
         "no_host_frame": "Cette expédition n'est sous aucun service",
         "delegated_executor_unwired": "Exécuteur externe non enregistré",
         "delegated_step_async_only": "Cette étape est interrogée, pas attendue",
-        "delegated_claim_missing": "Cette étape n’a aucun travail externe à interroger"
+        "delegated_claim_missing": "Cette étape n’a aucun travail externe à interroger",
+        "thread_busy": "Ce fil répond encore"
       },
       "description": {
         "dependencies_unmet": "Cette tâche dépend d'autres qui ne sont pas encore terminées. Terminez-les ou débloquez-les, puis relancez-la.",
@@ -782,7 +783,8 @@
         "no_host_frame": "Une tâche de correction a besoin d'un service où vivre et d'un dépôt à corriger. Déplacez la tâche d'expédition sous un cadre de service et réessayez.",
         "delegated_executor_unwired": "Une étape de ce pipeline s’exécute sur un exécuteur externe que ce déploiement n’enregistre pas : le travail n’a donc nulle part où aller. Enregistrez l’exécuteur dans le code, ou remplacez l’étape par une qui s’exécute ici.",
         "delegated_step_async_only": "Cette étape s’exécute sur un exécuteur externe et peut durer des heures : elle est donc lancée puis interrogée, au lieu d’être exécutée dans une seule requête. Démarrez l’exécution depuis le tableau ; si vous arrivez ici depuis votre propre code, pilotez l’étape par la voie asynchrone.",
-        "delegated_claim_missing": "L’enregistrement de ce que l’exécution a envoyé à l’exécuteur externe est absent : il n’y a donc rien à interroger. L’exécuteur lui-même n’a aucun problème. Rechargez l’exécution et relancez l’étape si elle reste bloquée."
+        "delegated_claim_missing": "L’enregistrement de ce que l’exécution a envoyé à l’exécuteur externe est absent : il n’y a donc rien à interroger. L’exécuteur lui-même n’a aucun problème. Rechargez l’exécution et relancez l’étape si elle reste bloquée.",
+        "thread_busy": "La question précédente de ce fil n'a pas encore reçu de réponse. Attends cette réponse ou pose ta question dans un autre fil."
       },
       "action": {
         "connectGitHub": "Connecter GitHub",

package/i18n/locales/he.json

@@ -725,7 +725,8 @@
         "no_host_frame": "המשלחת הזו אינה תחת שירות",
         "delegated_executor_unwired": "המריץ החיצוני אינו רשום",
         "delegated_step_async_only": "שלב זה נבדק מעת לעת, לא ממתינים לו",
-        "delegated_claim_missing": "לשלב זה אין עבודה חיצונית לבדיקה"
+        "delegated_claim_missing": "לשלב זה אין עבודה חיצונית לבדיקה",
+        "thread_busy": "השרשור הזה עדיין עונה"
       },
       "description": {
         "dependencies_unmet": "משימה זו תלויה במשימות אחרות שטרם הושלמו. השלם או שחרר אותן, ולאחר מכן הפעל אותה שוב.",
@@ -782,7 +783,8 @@
         "no_host_frame": "משימת תיקון זקוקה לשירות שתחתיו תחיה ולמאגר לתקן. העבירו את משימת המשלחת תחת מסגרת שירות ונסו שוב.",
         "delegated_executor_unwired": "שלב בצינור הזה רץ על מריץ חיצוני שההתקנה הזו אינה רושמת, ולכן אין לאן לשלוח את העבודה. רשמו את המריץ בקוד, או החליפו את השלב בשלב שרץ כאן.",
         "delegated_step_async_only": "השלב רץ על מבצע חיצוני ועשוי להימשך שעות, ולכן הוא נשלח ואז נבדק מעת לעת במקום לרוץ בתוך בקשה אחת. התחילו את ההרצה מהלוח; אם הגעתם לכאן מקוד משלכם, הפעילו את השלב דרך המסלול האסינכרוני.",
-        "delegated_claim_missing": "הרישום של מה שההרצה שלחה למבצע החיצוני חסר, ולכן אין מה לבדוק. אין שום בעיה במבצע עצמו. טענו מחדש את ההרצה, והריצו את השלב שוב אם הוא עדיין תקוע."
+        "delegated_claim_missing": "הרישום של מה שההרצה שלחה למבצע החיצוני חסר, ולכן אין מה לבדוק. אין שום בעיה במבצע עצמו. טענו מחדש את ההרצה, והריצו את השלב שוב אם הוא עדיין תקוע.",
+        "thread_busy": "השאלה הקודמת בשרשור הזה עדיין לא נענתה. המתינו לתשובה או שאלו בשרשור אחר."
       },
       "action": {
         "connectGitHub": "חבר את GitHub",

package/i18n/locales/it.json

@@ -6313,7 +6313,8 @@
         "no_host_frame": "Questa spedizione non si trova sotto un servizio",
         "delegated_executor_unwired": "Esecutore esterno non registrato",
         "delegated_step_async_only": "Questo passo viene interrogato, non atteso",
-        "delegated_claim_missing": "Questo passo non ha lavoro esterno da controllare"
+        "delegated_claim_missing": "Questo passo non ha lavoro esterno da controllare",
+        "thread_busy": "Questa discussione sta ancora rispondendo"
       },
       "description": {
         "dependencies_unmet": "Questa attività dipende da altre non ancora completate. Completale o sbloccale, poi avviala di nuovo.",
@@ -6370,7 +6371,8 @@
         "no_host_frame": "Un'attività di correzione ha bisogno di un servizio in cui vivere e di un repository da correggere. Sposti l'attività della spedizione sotto un frame di servizio e riprovi.",
         "delegated_executor_unwired": "Un passaggio di questa pipeline viene eseguito su un esecutore esterno che questa installazione non registra, quindi il lavoro non ha una destinazione. Registra l’esecutore nel codice oppure sostituisci il passaggio con uno eseguito qui.",
         "delegated_step_async_only": "Questo passo gira su un esecutore esterno e può durare ore, quindi viene avviato e poi interrogato invece di essere eseguito dentro una sola richiesta. Avvia l’esecuzione dalla board; se sei arrivato qui dal tuo codice, guida il passo attraverso il percorso asincrono.",
-        "delegated_claim_missing": "Manca la registrazione di ciò che l’esecuzione ha inviato all’esecutore esterno, quindi non c’è nulla da interrogare. L’esecutore in sé non ha alcun problema. Ricarica l’esecuzione e rilancia il passo se resta bloccato."
+        "delegated_claim_missing": "Manca la registrazione di ciò che l’esecuzione ha inviato all’esecutore esterno, quindi non c’è nulla da interrogare. L’esecutore in sé non ha alcun problema. Ricarica l’esecuzione e rilancia il passo se resta bloccato.",
+        "thread_busy": "La domanda precedente in questa discussione non ha ancora una risposta. Attendi la risposta o chiedi in un'altra discussione."
       },
       "action": {
         "connectGitHub": "Collega GitHub",

package/i18n/locales/ja.json

@@ -725,7 +725,8 @@
         "no_host_frame": "この探索はサービスの配下にありません",
         "delegated_executor_unwired": "外部エグゼキューターが登録されていません",
         "delegated_step_async_only": "このステップはポーリングされます。完了を待つことはできません",
-        "delegated_claim_missing": "このステップには確認できる外部の処理がありません"
+        "delegated_claim_missing": "このステップには確認できる外部の処理がありません",
+        "thread_busy": "このスレッドはまだ回答中です"
       },
       "description": {
         "dependencies_unmet": "このタスクは、まだ完了していない他のタスクに依存しています。それらを完了または解除してから、もう一度開始してください。",
@@ -782,7 +783,8 @@
         "no_host_frame": "修正タスクには所属するサービスと修正対象のリポジトリが必要です。探索タスクをサービスフレームの配下へ移動してからやり直してください。",
         "delegated_executor_unwired": "このパイプラインのステップは、このデプロイが登録していない外部エグゼキューターで実行されるため、処理の送り先がありません。エグゼキューターをコードに登録するか、ここで実行されるステップに変更してください。",
         "delegated_step_async_only": "このステップは外部エグゼキューター上で実行され、数時間かかることがあります。そのため、単一のリクエスト内で実行するのではなく、ディスパッチしたうえでポーリングします。実行はボードから開始してください。独自のコードからここに到達した場合は、非同期パスでステップを駆動してください。",
-        "delegated_claim_missing": "外部エグゼキューターに何を送ったかという実行の記録が失われているため、ポーリングする対象がありません。エグゼキューター自体に問題はありません。実行を再読み込みし、まだ止まったままならステップを再実行してください。"
+        "delegated_claim_missing": "外部エグゼキューターに何を送ったかという実行の記録が失われているため、ポーリングする対象がありません。エグゼキューター自体に問題はありません。実行を再読み込みし、まだ止まったままならステップを再実行してください。",
+        "thread_busy": "このスレッドの前の質問にまだ回答がありません。回答を待つか、別のスレッドで質問してください。"
       },
       "action": {
         "connectGitHub": "GitHub に接続",

package/i18n/locales/pl.json

@@ -725,7 +725,8 @@
         "no_host_frame": "Ta wyprawa nie znajduje się pod żadną usługą",
         "delegated_executor_unwired": "Zewnętrzny executor nie jest zarejestrowany",
         "delegated_step_async_only": "Ten krok jest odpytywany, a nie oczekiwany",
-        "delegated_claim_missing": "Ten krok nie ma zewnętrznej pracy do sprawdzenia"
+        "delegated_claim_missing": "Ten krok nie ma zewnętrznej pracy do sprawdzenia",
+        "thread_busy": "Ten wątek wciąż odpowiada"
       },
       "description": {
         "dependencies_unmet": "To zadanie zależy od innych, które nie zostały jeszcze ukończone. Ukończ je lub odblokuj, a następnie uruchom je ponownie.",
@@ -782,7 +783,8 @@
         "no_host_frame": "Zadanie naprawcze potrzebuje usługi, pod którą będzie żyć, i repozytorium do naprawy. Przenieś zadanie wyprawy pod ramkę usługi i spróbuj ponownie.",
         "delegated_executor_unwired": "Krok tego potoku działa na zewnętrznym executorze, którego ta instalacja nie rejestruje, więc pracy nie ma dokąd wysłać. Zarejestruj executor w kodzie albo zmień krok na taki, który działa tutaj.",
         "delegated_step_async_only": "Ten krok działa na zewnętrznym wykonawcy i może trwać godzinami, więc jest wysyłany, a następnie odpytywany, zamiast wykonywany w obrębie jednego żądania. Uruchom przebieg z tablicy; jeśli trafiłeś tu z własnego kodu, steruj krokiem ścieżką asynchroniczną.",
-        "delegated_claim_missing": "Brakuje zapisu tego, co przebieg wysłał do zewnętrznego wykonawcy, więc nie ma czego odpytywać. Z samym wykonawcą wszystko jest w porządku. Odśwież przebieg i uruchom krok ponownie, jeśli nadal stoi."
+        "delegated_claim_missing": "Brakuje zapisu tego, co przebieg wysłał do zewnętrznego wykonawcy, więc nie ma czego odpytywać. Z samym wykonawcą wszystko jest w porządku. Odśwież przebieg i uruchom krok ponownie, jeśli nadal stoi.",
+        "thread_busy": "Poprzednie pytanie w tym wątku nie ma jeszcze odpowiedzi. Poczekaj na nią albo zapytaj w innym wątku."
       },
       "action": {
         "connectGitHub": "Połącz GitHub",

package/i18n/locales/tr.json

@@ -725,7 +725,8 @@
         "no_host_frame": "Bu sefer bir hizmetin altında değil",
         "delegated_executor_unwired": "Dış yürütücü kayıtlı değil",
         "delegated_step_async_only": "Bu adım beklenmez, yoklanır",
-        "delegated_claim_missing": "Bu adımın kontrol edilecek harici işi yok"
+        "delegated_claim_missing": "Bu adımın kontrol edilecek harici işi yok",
+        "thread_busy": "Bu konu hâlâ yanıtlanıyor"
       },
       "description": {
         "dependencies_unmet": "Bu görev henüz tamamlanmamış başka görevlere bağlı. Onları tamamla veya engelini kaldır, ardından yeniden başlat.",
@@ -782,7 +783,8 @@
         "no_host_frame": "Bir düzeltme görevinin altında yaşayacağı bir hizmete ve düzeltilecek bir depoya ihtiyacı var. Sefer görevini bir hizmet çerçevesinin altına taşıyıp yeniden deneyin.",
         "delegated_executor_unwired": "Bu hattın bir adımı, bu kurulumun kaydetmediği bir dış yürütücüde çalışıyor; dolayısıyla işin gönderileceği bir yer yok. Yürütücüyü kodda kaydedin ya da adımı burada çalışan biriyle değiştirin.",
         "delegated_step_async_only": "Bu adım harici bir yürütücüde çalışır ve saatler sürebilir; bu yüzden tek bir istek içinde çalıştırılmak yerine gönderilip ardından yoklanır. Çalıştırmayı panodan başlatın; buraya kendi kodunuzdan geldiyseniz adımı asenkron yoldan sürün.",
-        "delegated_claim_missing": "Çalıştırmanın harici yürütücüye ne gönderdiğine dair kaydı eksik, dolayısıyla yoklanacak bir şey yok. Yürütücünün kendisinde bir sorun yok. Çalıştırmayı yeniden yükleyin ve adım hâlâ takılıysa yeniden çalıştırın."
+        "delegated_claim_missing": "Çalıştırmanın harici yürütücüye ne gönderdiğine dair kaydı eksik, dolayısıyla yoklanacak bir şey yok. Yürütücünün kendisinde bir sorun yok. Çalıştırmayı yeniden yükleyin ve adım hâlâ takılıysa yeniden çalıştırın.",
+        "thread_busy": "Bu konudaki önceki soru henüz yanıtlanmadı. Yanıtı bekleyin ya da başka bir konuda sorun."
       },
       "action": {
         "connectGitHub": "GitHub'ı bağla",

package/i18n/locales/uk.json

@@ -725,7 +725,8 @@
         "no_host_frame": "Ця експедиція не належить жодному сервісу",
         "delegated_executor_unwired": "Зовнішній виконавець не зареєстрований",
         "delegated_step_async_only": "Цей крок опитується, а не очікується",
-        "delegated_claim_missing": "У цього кроку немає зовнішньої роботи для перевірки"
+        "delegated_claim_missing": "У цього кроку немає зовнішньої роботи для перевірки",
+        "thread_busy": "Ця гілка ще відповідає"
       },
       "description": {
         "dependencies_unmet": "Це завдання залежить від інших, які ще не завершені. Заверши або розблокуй їх, а потім запусти його знову.",
@@ -782,7 +783,8 @@
         "no_host_frame": "Задачі виправлення потрібен сервіс, у якому вона житиме, і репозиторій для виправлення. Перемістіть задачу експедиції під рамку сервісу і спробуйте ще раз.",
         "delegated_executor_unwired": "Крок цього конвеєра виконується на зовнішньому виконавці, якого це розгортання не реєструє, тож роботу нікуди надіслати. Зареєструйте виконавця в коді або замініть крок на той, що виконується тут.",
         "delegated_step_async_only": "Цей крок виконується на зовнішньому виконавці й може тривати годинами, тому його надсилають і потім опитують, а не виконують у межах одного запиту. Запустіть прогін з дошки; якщо ви потрапили сюди зі свого коду, керуйте кроком через асинхронний шлях.",
-        "delegated_claim_missing": "Запис про те, що прогін надіслав зовнішньому виконавцю, відсутній, тож немає чого опитувати. Із самим виконавцем усе гаразд. Перезавантажте прогін і запустіть крок повторно, якщо він і далі стоїть."
+        "delegated_claim_missing": "Запис про те, що прогін надіслав зовнішньому виконавцю, відсутній, тож немає чого опитувати. Із самим виконавцем усе гаразд. Перезавантажте прогін і запустіть крок повторно, якщо він і далі стоїть.",
+        "thread_busy": "На попереднє запитання в цій гілці ще немає відповіді. Дочекайтеся її або запитайте в іншій гілці."
       },
       "action": {
         "connectGitHub": "Під'єднати GitHub",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.303.3",
+  "version": "0.304.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",
@@ -18,7 +18,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@cat-factory/contracts": "0.357.0",
+    "@cat-factory/contracts": "0.359.0",
     "@modular-frontend/core": "0.6.0",
     "@modular-vue/core": "^1.5.0",
     "@modular-vue/journeys": "^1.4.0",