@cat-factory/app 0.6.0 → 0.7.3

package/app/stores/documents.ts

@@ -1,176 +1,176 @@
-import { defineStore } from 'pinia'
-import { computed, ref } from 'vue'
-import type {
-  DocumentBoardPlan,
-  DocumentConnection,
-  DocumentSearchResult,
-  DocumentSourceDescriptor,
-  DocumentSourceKind,
-  SourceDocument,
-} from '~/types/domain'
-import { useWorkspaceStore } from '~/stores/workspace'
-
-/**
- * Document-source integration state: the sources the backend offers (and their
- * connect metadata), the workspace's per-source connections, and the pages it
- * has imported — plus the actions that connect/import/plan/spawn/link against the
- * backend. `available` mirrors the backend's opt-in gate: a 503 from the source
- * probe means the integration is off, and the UI hides its entry points (just as
- * `auth.required` gates the login UI). The abstraction is source-agnostic; every
- * action is keyed by a `DocumentSourceKind`. Per-workspace, like the board
- * itself; nothing is persisted client-side.
- */
-export const useDocumentsStore = defineStore('documents', () => {
-  const api = useApi()
-  const workspace = useWorkspaceStore()
-
-  /** null = unknown (not probed yet), true/false = integration on/off. */
-  const available = ref<boolean | null>(null)
-  /** The configured sources and their connect/import descriptors. */
-  const sources = ref<DocumentSourceDescriptor[]>([])
-  /** Live connections, one per connected source. */
-  const connections = ref<DocumentConnection[]>([])
-  const documents = ref<SourceDocument[]>([])
-  const loading = ref(false)
-
-  /** Sources the workspace currently has a live connection to. */
-  const connectedSources = computed(() =>
-    sources.value.filter((s) => connections.value.some((c) => c.source === s.source)),
-  )
-  const anyConnected = computed(() => connections.value.length > 0)
-
-  function descriptorFor(source: DocumentSourceKind): DocumentSourceDescriptor | undefined {
-    return sources.value.find((s) => s.source === source)
-  }
-
-  function connectionFor(source: DocumentSourceKind): DocumentConnection | undefined {
-    return connections.value.find((c) => c.source === source)
-  }
-
-  function isConnected(source: DocumentSourceKind): boolean {
-    return connectionFor(source) !== undefined
-  }
-
-  /** Imported documents currently attached to a given block. */
-  function docsForBlock(blockId: string): SourceDocument[] {
-    return documents.value.filter((d) => d.linkedBlockId === blockId)
-  }
-
-  /** Merge a document returned by the backend into the local cache. */
-  function upsertDoc(doc: SourceDocument) {
-    const i = documents.value.findIndex(
-      (d) => d.source === doc.source && d.externalId === doc.externalId,
-    )
-    if (i >= 0) documents.value[i] = doc
-    else documents.value.unshift(doc)
-  }
-
-  function upsertConnection(conn: DocumentConnection) {
-    const i = connections.value.findIndex((c) => c.source === conn.source)
-    if (i >= 0) connections.value[i] = conn
-    else connections.value.push(conn)
-  }
-
-  /** Probe the integration: resolves `available`, the sources and connections. */
-  async function probe() {
-    if (!workspace.workspaceId) return
-    try {
-      const [{ sources: srcs }, { connections: conns }] = await Promise.all([
-        api.listDocumentSources(workspace.requireId()),
-        api.listDocumentConnections(workspace.requireId()),
-      ])
-      available.value = true
-      sources.value = srcs
-      connections.value = conns
-    } catch {
-      // 503 (integration disabled) or any error → hide the UI entry points.
-      available.value = false
-      sources.value = []
-      connections.value = []
-    }
-  }
-
-  /** Connect the workspace to a source with its credential bag. */
-  async function connect(source: DocumentSourceKind, credentials: Record<string, string>) {
-    const conn = await api.connectDocumentSource(workspace.requireId(), source, credentials)
-    upsertConnection(conn)
-    available.value = true
-  }
-
-  /** Disconnect the workspace from a source. */
-  async function disconnect(source: DocumentSourceKind) {
-    await api.disconnectDocumentSource(workspace.requireId(), source)
-    connections.value = connections.value.filter((c) => c.source !== source)
-  }
-
-  /** Load the imported documents for the workspace (across sources). */
-  async function loadDocuments() {
-    documents.value = await api.listDocuments(workspace.requireId())
-  }
-
-  /** Import (fetch + persist) a page by id or URL from a source. */
-  async function importDocument(source: DocumentSourceKind, ref: string): Promise<SourceDocument> {
-    loading.value = true
-    try {
-      const doc = await api.importDocument(workspace.requireId(), source, { ref })
-      upsertDoc(doc)
-      return doc
-    } finally {
-      loading.value = false
-    }
-  }
-
-  /** Search a connected source's catalogue by free text (title/content). */
-  async function search(
-    source: DocumentSourceKind,
-    query: string,
-  ): Promise<DocumentSearchResult[]> {
-    const { results } = await api.searchDocumentSource(workspace.requireId(), source, query)
-    return results
-  }
-
-  /** Preview the board structure a page would expand into (no writes). */
-  function plan(source: DocumentSourceKind, externalId: string): Promise<DocumentBoardPlan> {
-    return api.planDocument(workspace.requireId(), source, externalId)
-  }
-
-  /** Apply a page's structure to the board, then refresh the board snapshot. */
-  async function spawn(source: DocumentSourceKind, externalId: string, frameId?: string) {
-    const { result } = await api.spawnDocument(workspace.requireId(), source, {
-      externalId,
-      frameId,
-    })
-    await workspace.refresh()
-    return result
-  }
-
-  /** Attach an imported page to a block as agent context. */
-  async function linkToBlock(blockId: string, source: DocumentSourceKind, externalId: string) {
-    const doc = await api.linkDocument(workspace.requireId(), { source, externalId, blockId })
-    upsertDoc(doc)
-    return doc
-  }
-
-  return {
-    available,
-    sources,
-    connections,
-    documents,
-    loading,
-    connectedSources,
-    anyConnected,
-    descriptorFor,
-    connectionFor,
-    isConnected,
-    docsForBlock,
-    probe,
-    connect,
-    disconnect,
-    loadDocuments,
-    importDocument,
-    search,
-    plan,
-    spawn,
-    linkToBlock,
-  }
-})
+import { defineStore } from 'pinia'
+import { computed, ref } from 'vue'
+import type {
+  DocumentBoardPlan,
+  DocumentConnection,
+  DocumentSearchResult,
+  DocumentSourceDescriptor,
+  DocumentSourceKind,
+  SourceDocument,
+} from '~/types/domain'
+import { useWorkspaceStore } from '~/stores/workspace'
+
+/**
+ * Document-source integration state: the sources the backend offers (and their
+ * connect metadata), the workspace's per-source connections, and the pages it
+ * has imported — plus the actions that connect/import/plan/spawn/link against the
+ * backend. `available` mirrors the backend's opt-in gate: a 503 from the source
+ * probe means the integration is off, and the UI hides its entry points (just as
+ * `auth.required` gates the login UI). The abstraction is source-agnostic; every
+ * action is keyed by a `DocumentSourceKind`. Per-workspace, like the board
+ * itself; nothing is persisted client-side.
+ */
+export const useDocumentsStore = defineStore('documents', () => {
+  const api = useApi()
+  const workspace = useWorkspaceStore()
+
+  /** null = unknown (not probed yet), true/false = integration on/off. */
+  const available = ref<boolean | null>(null)
+  /** The configured sources and their connect/import descriptors. */
+  const sources = ref<DocumentSourceDescriptor[]>([])
+  /** Live connections, one per connected source. */
+  const connections = ref<DocumentConnection[]>([])
+  const documents = ref<SourceDocument[]>([])
+  const loading = ref(false)
+
+  /** Sources the workspace currently has a live connection to. */
+  const connectedSources = computed(() =>
+    sources.value.filter((s) => connections.value.some((c) => c.source === s.source)),
+  )
+  const anyConnected = computed(() => connections.value.length > 0)
+
+  function descriptorFor(source: DocumentSourceKind): DocumentSourceDescriptor | undefined {
+    return sources.value.find((s) => s.source === source)
+  }
+
+  function connectionFor(source: DocumentSourceKind): DocumentConnection | undefined {
+    return connections.value.find((c) => c.source === source)
+  }
+
+  function isConnected(source: DocumentSourceKind): boolean {
+    return connectionFor(source) !== undefined
+  }
+
+  /** Imported documents currently attached to a given block. */
+  function docsForBlock(blockId: string): SourceDocument[] {
+    return documents.value.filter((d) => d.linkedBlockId === blockId)
+  }
+
+  /** Merge a document returned by the backend into the local cache. */
+  function upsertDoc(doc: SourceDocument) {
+    const i = documents.value.findIndex(
+      (d) => d.source === doc.source && d.externalId === doc.externalId,
+    )
+    if (i >= 0) documents.value[i] = doc
+    else documents.value.unshift(doc)
+  }
+
+  function upsertConnection(conn: DocumentConnection) {
+    const i = connections.value.findIndex((c) => c.source === conn.source)
+    if (i >= 0) connections.value[i] = conn
+    else connections.value.push(conn)
+  }
+
+  /** Probe the integration: resolves `available`, the sources and connections. */
+  async function probe() {
+    if (!workspace.workspaceId) return
+    try {
+      const [{ sources: srcs }, { connections: conns }] = await Promise.all([
+        api.listDocumentSources(workspace.requireId()),
+        api.listDocumentConnections(workspace.requireId()),
+      ])
+      available.value = true
+      sources.value = srcs
+      connections.value = conns
+    } catch {
+      // 503 (integration disabled) or any error → hide the UI entry points.
+      available.value = false
+      sources.value = []
+      connections.value = []
+    }
+  }
+
+  /** Connect the workspace to a source with its credential bag. */
+  async function connect(source: DocumentSourceKind, credentials: Record<string, string>) {
+    const conn = await api.connectDocumentSource(workspace.requireId(), source, credentials)
+    upsertConnection(conn)
+    available.value = true
+  }
+
+  /** Disconnect the workspace from a source. */
+  async function disconnect(source: DocumentSourceKind) {
+    await api.disconnectDocumentSource(workspace.requireId(), source)
+    connections.value = connections.value.filter((c) => c.source !== source)
+  }
+
+  /** Load the imported documents for the workspace (across sources). */
+  async function loadDocuments() {
+    documents.value = await api.listDocuments(workspace.requireId())
+  }
+
+  /** Import (fetch + persist) a page by id or URL from a source. */
+  async function importDocument(source: DocumentSourceKind, ref: string): Promise<SourceDocument> {
+    loading.value = true
+    try {
+      const doc = await api.importDocument(workspace.requireId(), source, { ref })
+      upsertDoc(doc)
+      return doc
+    } finally {
+      loading.value = false
+    }
+  }
+
+  /** Search a connected source's catalogue by free text (title/content). */
+  async function search(
+    source: DocumentSourceKind,
+    query: string,
+  ): Promise<DocumentSearchResult[]> {
+    const { results } = await api.searchDocumentSource(workspace.requireId(), source, query)
+    return results
+  }
+
+  /** Preview the board structure a page would expand into (no writes). */
+  function plan(source: DocumentSourceKind, externalId: string): Promise<DocumentBoardPlan> {
+    return api.planDocument(workspace.requireId(), source, externalId)
+  }
+
+  /** Apply a page's structure to the board, then refresh the board snapshot. */
+  async function spawn(source: DocumentSourceKind, externalId: string, frameId?: string) {
+    const { result } = await api.spawnDocument(workspace.requireId(), source, {
+      externalId,
+      frameId,
+    })
+    await workspace.refresh()
+    return result
+  }
+
+  /** Attach an imported page to a block as agent context. */
+  async function linkToBlock(blockId: string, source: DocumentSourceKind, externalId: string) {
+    const doc = await api.linkDocument(workspace.requireId(), { source, externalId, blockId })
+    upsertDoc(doc)
+    return doc
+  }
+
+  return {
+    available,
+    sources,
+    connections,
+    documents,
+    loading,
+    connectedSources,
+    anyConnected,
+    descriptorFor,
+    connectionFor,
+    isConnected,
+    docsForBlock,
+    probe,
+    connect,
+    disconnect,
+    loadDocuments,
+    importDocument,
+    search,
+    plan,
+    spawn,
+    linkToBlock,
+  }
+})

package/app/stores/services.ts

@@ -1,87 +1,87 @@
-import { defineStore } from 'pinia'
-import { computed, ref } from 'vue'
-import type { Service, WorkspaceMount } from '~/types/services'
-import { useWorkspaceStore } from '~/stores/workspace'
-
-/**
- * In-org shared services. A `Service` is account-owned (a service frame + its subtree + repo)
- * and can be mounted onto several teams' boards; a `WorkspaceMount` places one onto THIS
- * board with its own frame layout. Hydrated from the workspace snapshot:
- *   - `mounts` — the services this board mounts (drives the per-board frame layout),
- *   - `catalog` — the org's services this board can mount from (each with a `mountCount`).
- */
-export const useServicesStore = defineStore('services', () => {
-  const api = useApi()
-
-  const mounts = ref<WorkspaceMount[]>([])
-  const catalog = ref<Service[]>([])
-
-  function hydrate(nextMounts: WorkspaceMount[], nextCatalog: Service[]) {
-    mounts.value = [...nextMounts]
-    catalog.value = [...nextCatalog]
-  }
-
-  /** Mount row keyed by service id. */
-  const byServiceId = computed<Record<string, WorkspaceMount>>(() => {
-    const map: Record<string, WorkspaceMount> = {}
-    for (const m of mounts.value) map[m.serviceId] = m
-    return map
-  })
-
-  /** Catalog service keyed by its frame block id (resolve a frame → its service). */
-  const serviceByFrameBlock = computed<Record<string, Service>>(() => {
-    const map: Record<string, Service> = {}
-    for (const s of catalog.value) map[s.frameBlockId] = s
-    return map
-  })
-
-  /** Org services NOT yet mounted on this board (the "add existing service" picker's options). */
-  const mountable = computed<Service[]>(() => {
-    const mounted = new Set(mounts.value.map((m) => m.serviceId))
-    return catalog.value.filter((s) => !mounted.has(s.id))
-  })
-
-  /** A frame is "shared" when its service is mounted on more than one board. */
-  function isSharedFrame(frameBlockId: string): boolean {
-    return (serviceByFrameBlock.value[frameBlockId]?.mountCount ?? 0) > 1
-  }
-
-  async function mount(serviceId: string, position?: { x: number; y: number }) {
-    const ws = useWorkspaceStore()
-    const created = await api.mountService(ws.requireId(), serviceId, position ? { position } : {})
-    await ws.refresh()
-    return created
-  }
-
-  async function unmount(serviceId: string) {
-    const ws = useWorkspaceStore()
-    await api.unmountService(ws.requireId(), serviceId)
-    await ws.refresh()
-  }
-
-  /** Persist a mounted frame's per-board layout (called on frame drag/resize end). */
-  async function updateLayout(
-    serviceId: string,
-    position?: { x: number; y: number },
-    size?: { w: number; h: number } | null,
-  ) {
-    const ws = useWorkspaceStore()
-    const updated = await api.updateMountLayout(ws.requireId(), serviceId, { position, size })
-    const local = mounts.value.find((m) => m.serviceId === serviceId)
-    if (local) Object.assign(local, updated)
-    return updated
-  }
-
-  return {
-    mounts,
-    catalog,
-    byServiceId,
-    serviceByFrameBlock,
-    mountable,
-    isSharedFrame,
-    hydrate,
-    mount,
-    unmount,
-    updateLayout,
-  }
-})
+import { defineStore } from 'pinia'
+import { computed, ref } from 'vue'
+import type { Service, WorkspaceMount } from '~/types/services'
+import { useWorkspaceStore } from '~/stores/workspace'
+
+/**
+ * In-org shared services. A `Service` is account-owned (a service frame + its subtree + repo)
+ * and can be mounted onto several teams' boards; a `WorkspaceMount` places one onto THIS
+ * board with its own frame layout. Hydrated from the workspace snapshot:
+ *   - `mounts` — the services this board mounts (drives the per-board frame layout),
+ *   - `catalog` — the org's services this board can mount from (each with a `mountCount`).
+ */
+export const useServicesStore = defineStore('services', () => {
+  const api = useApi()
+
+  const mounts = ref<WorkspaceMount[]>([])
+  const catalog = ref<Service[]>([])
+
+  function hydrate(nextMounts: WorkspaceMount[], nextCatalog: Service[]) {
+    mounts.value = [...nextMounts]
+    catalog.value = [...nextCatalog]
+  }
+
+  /** Mount row keyed by service id. */
+  const byServiceId = computed<Record<string, WorkspaceMount>>(() => {
+    const map: Record<string, WorkspaceMount> = {}
+    for (const m of mounts.value) map[m.serviceId] = m
+    return map
+  })
+
+  /** Catalog service keyed by its frame block id (resolve a frame → its service). */
+  const serviceByFrameBlock = computed<Record<string, Service>>(() => {
+    const map: Record<string, Service> = {}
+    for (const s of catalog.value) map[s.frameBlockId] = s
+    return map
+  })
+
+  /** Org services NOT yet mounted on this board (the "add existing service" picker's options). */
+  const mountable = computed<Service[]>(() => {
+    const mounted = new Set(mounts.value.map((m) => m.serviceId))
+    return catalog.value.filter((s) => !mounted.has(s.id))
+  })
+
+  /** A frame is "shared" when its service is mounted on more than one board. */
+  function isSharedFrame(frameBlockId: string): boolean {
+    return (serviceByFrameBlock.value[frameBlockId]?.mountCount ?? 0) > 1
+  }
+
+  async function mount(serviceId: string, position?: { x: number; y: number }) {
+    const ws = useWorkspaceStore()
+    const created = await api.mountService(ws.requireId(), serviceId, position ? { position } : {})
+    await ws.refresh()
+    return created
+  }
+
+  async function unmount(serviceId: string) {
+    const ws = useWorkspaceStore()
+    await api.unmountService(ws.requireId(), serviceId)
+    await ws.refresh()
+  }
+
+  /** Persist a mounted frame's per-board layout (called on frame drag/resize end). */
+  async function updateLayout(
+    serviceId: string,
+    position?: { x: number; y: number },
+    size?: { w: number; h: number } | null,
+  ) {
+    const ws = useWorkspaceStore()
+    const updated = await api.updateMountLayout(ws.requireId(), serviceId, { position, size })
+    const local = mounts.value.find((m) => m.serviceId === serviceId)
+    if (local) Object.assign(local, updated)
+    return updated
+  }
+
+  return {
+    mounts,
+    catalog,
+    byServiceId,
+    serviceByFrameBlock,
+    mountable,
+    isSharedFrame,
+    hydrate,
+    mount,
+    unmount,
+    updateLayout,
+  }
+})

package/app/stores/tracker.ts

@@ -1,27 +1,39 @@
-import { defineStore } from 'pinia'
-import { ref } from 'vue'
-import type { PutTrackerSettingsInput, TrackerSettings } from '~/types/tracker'
-import { useWorkspaceStore } from '~/stores/workspace'
-
-/**
- * The workspace's issue-tracker selection (GitHub Issues or Jira) — where the
- * tech-debt recurring pipeline files its ticket. Hydrated from the snapshot;
- * edited inline when configuring a tech-debt recurring pipeline.
- */
-export const useTrackerStore = defineStore('tracker', () => {
-  const api = useApi()
-
-  const settings = ref<TrackerSettings>({ tracker: null, jiraProjectKey: null, updatedAt: 0 })
-
-  function hydrate(value: TrackerSettings | undefined) {
-    settings.value = value ?? { tracker: null, jiraProjectKey: null, updatedAt: 0 }
-  }
-
-  async function save(input: PutTrackerSettingsInput) {
-    const ws = useWorkspaceStore()
-    settings.value = await api.putTrackerSettings(ws.requireId(), input)
-    return settings.value
-  }
-
-  return { settings, hydrate, save }
-})
+import { defineStore } from 'pinia'
+import { ref } from 'vue'
+import type { PutTrackerSettingsInput, TrackerSettings } from '~/types/tracker'
+import { useWorkspaceStore } from '~/stores/workspace'
+
+/**
+ * The workspace's issue-tracker selection (GitHub Issues or Jira) — where the
+ * tech-debt recurring pipeline files its ticket. Hydrated from the snapshot;
+ * edited inline when configuring a tech-debt recurring pipeline.
+ */
+export const useTrackerStore = defineStore('tracker', () => {
+  const api = useApi()
+
+  const settings = ref<TrackerSettings>({
+    tracker: null,
+    jiraProjectKey: null,
+    writebackCommentOnPrOpen: false,
+    writebackResolveOnMerge: false,
+    updatedAt: 0,
+  })
+
+  function hydrate(value: TrackerSettings | undefined) {
+    settings.value = value ?? {
+      tracker: null,
+      jiraProjectKey: null,
+      writebackCommentOnPrOpen: false,
+      writebackResolveOnMerge: false,
+      updatedAt: 0,
+    }
+  }
+
+  async function save(input: PutTrackerSettingsInput) {
+    const ws = useWorkspaceStore()
+    settings.value = await api.putTrackerSettings(ws.requireId(), input)
+    return settings.value
+  }
+
+  return { settings, hydrate, save }
+})

package/app/stores/ui.ts

@@ -70,6 +70,9 @@ export const useUiStore = defineStore('ui', () => {
   // Workspace-settings panel: the run-timing escalation threshold + per-service task limit.
   const workspaceSettingsOpen = ref(false)
   const datadogOpen = ref(false)
+  // Workspace-settings panel: issue-tracker writeback toggles (comment on PR open,
+  // close linked issue on merge).
+  const issueWritebackOpen = ref(false)
   const modelDefaultsOpen = ref(false)
   // Workspace-settings panel: the default service-fragment selection new services inherit.
   const serviceFragmentDefaultsOpen = ref(false)
@@ -287,6 +290,12 @@ export const useUiStore = defineStore('ui', () => {
   function closeWorkspaceSettings() {
     workspaceSettingsOpen.value = false
   }
+  function openIssueWriteback() {
+    issueWritebackOpen.value = true
+  }
+  function closeIssueWriteback() {
+    issueWritebackOpen.value = false
+  }
   function openDatadog() {
     datadogOpen.value = true
   }
@@ -360,6 +369,7 @@ export const useUiStore = defineStore('ui', () => {
     fragmentLibraryOpen,
     commandBarOpen,
     mergeThresholdsOpen,
+    issueWritebackOpen,
     workspaceSettingsOpen,
     datadogOpen,
     modelDefaultsOpen,
@@ -411,6 +421,8 @@ export const useUiStore = defineStore('ui', () => {
     toggleCommandBar,
     openMergeThresholds,
     closeMergeThresholds,
+    openIssueWriteback,
+    closeIssueWriteback,
     openWorkspaceSettings,
     closeWorkspaceSettings,
     openDatadog,