@cat-factory/app 0.6.0 → 0.7.2

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,

package/app/types/documents.ts

@@ -1,104 +1,104 @@
-// ---------------------------------------------------------------------------
-// Document-source integration. Requirements / RFCs / PRDs imported from external
-// sources (Confluence, Notion, …) can be expanded into board structure or
-// attached to a task as agent context. These mirror the `@cat-factory/contracts`
-// document schemas; the abstraction is source-agnostic, keyed by `source`.
-// ---------------------------------------------------------------------------
-
-import type { BlockType } from './domain'
-
-/** The external document sources cat-factory can link to. */
-export type DocumentSourceKind = 'confluence' | 'notion' | 'github'
-
-/** One credential a provider needs to connect (rendered as a form field). */
-export interface CredentialField {
-  key: string
-  label: string
-  help?: string
-  placeholder?: string
-  secret?: boolean
-}
-
-/** A source's self-description: drives the generic connect + import UI. */
-export interface DocumentSourceDescriptor {
-  source: DocumentSourceKind
-  label: string
-  /** Lucide icon name for the source. */
-  icon: string
-  credentialFields: CredentialField[]
-  refLabel: string
-  refPlaceholder: string
-  /** Whether the source supports searching its catalogue by title/content. */
-  searchable?: boolean
-}
-
-/** A workspace's connection to a document source (never carries credentials). */
-export interface DocumentConnection {
-  source: DocumentSourceKind
-  /** Human-friendly label for what we're connected to (site URL, workspace name). */
-  label: string
-  /** When the connection was established (epoch ms). */
-  connectedAt: number
-}
-
-/** A page imported from a source into the workspace. */
-export interface SourceDocument {
-  source: DocumentSourceKind
-  /** The source's stable id for the page. */
-  externalId: string
-  title: string
-  url: string
-  /** Short plain-text preview of the page body. */
-  excerpt: string
-  /** The board block this document is attached to as context, if any. */
-  linkedBlockId: string | null
-  syncedAt: number
-}
-
-/** A lean hit from searching a document source's catalogue (not yet imported). */
-export interface DocumentSearchResult {
-  source: DocumentSourceKind
-  /** The source's stable id for the page (re-usable as an import ref). */
-  externalId: string
-  title: string
-  url: string
-  /** Short plain-text preview (may be empty). */
-  excerpt: string
-}
-
-/** A proposed task within a planned frame/module. */
-export interface PlanTask {
-  title: string
-  description?: string
-}
-
-/** A proposed module grouping tasks within a planned frame. */
-export interface PlanModule {
-  name: string
-  tasks: PlanTask[]
-}
-
-/** A proposed top-level frame with its modules and loose tasks. */
-export interface PlanFrame {
-  type: BlockType
-  title: string
-  description?: string
-  modules: PlanModule[]
-  tasks: PlanTask[]
-}
-
-/** A board structure extracted from an imported document. */
-export interface DocumentBoardPlan {
-  source: DocumentSourceKind
-  externalId: string
-  /** Whether an LLM produced the plan or the deterministic heading parser did. */
-  planner: 'llm' | 'headings'
-  frames: PlanFrame[]
-}
-
-/** Counts of blocks created by spawning a plan onto the board. */
-export interface SpawnResult {
-  frames: number
-  modules: number
-  tasks: number
-}
+// ---------------------------------------------------------------------------
+// Document-source integration. Requirements / RFCs / PRDs imported from external
+// sources (Confluence, Notion, …) can be expanded into board structure or
+// attached to a task as agent context. These mirror the `@cat-factory/contracts`
+// document schemas; the abstraction is source-agnostic, keyed by `source`.
+// ---------------------------------------------------------------------------
+
+import type { BlockType } from './domain'
+
+/** The external document sources cat-factory can link to. */
+export type DocumentSourceKind = 'confluence' | 'notion' | 'github'
+
+/** One credential a provider needs to connect (rendered as a form field). */
+export interface CredentialField {
+  key: string
+  label: string
+  help?: string
+  placeholder?: string
+  secret?: boolean
+}
+
+/** A source's self-description: drives the generic connect + import UI. */
+export interface DocumentSourceDescriptor {
+  source: DocumentSourceKind
+  label: string
+  /** Lucide icon name for the source. */
+  icon: string
+  credentialFields: CredentialField[]
+  refLabel: string
+  refPlaceholder: string
+  /** Whether the source supports searching its catalogue by title/content. */
+  searchable?: boolean
+}
+
+/** A workspace's connection to a document source (never carries credentials). */
+export interface DocumentConnection {
+  source: DocumentSourceKind
+  /** Human-friendly label for what we're connected to (site URL, workspace name). */
+  label: string
+  /** When the connection was established (epoch ms). */
+  connectedAt: number
+}
+
+/** A page imported from a source into the workspace. */
+export interface SourceDocument {
+  source: DocumentSourceKind
+  /** The source's stable id for the page. */
+  externalId: string
+  title: string
+  url: string
+  /** Short plain-text preview of the page body. */
+  excerpt: string
+  /** The board block this document is attached to as context, if any. */
+  linkedBlockId: string | null
+  syncedAt: number
+}
+
+/** A lean hit from searching a document source's catalogue (not yet imported). */
+export interface DocumentSearchResult {
+  source: DocumentSourceKind
+  /** The source's stable id for the page (re-usable as an import ref). */
+  externalId: string
+  title: string
+  url: string
+  /** Short plain-text preview (may be empty). */
+  excerpt: string
+}
+
+/** A proposed task within a planned frame/module. */
+export interface PlanTask {
+  title: string
+  description?: string
+}
+
+/** A proposed module grouping tasks within a planned frame. */
+export interface PlanModule {
+  name: string
+  tasks: PlanTask[]
+}
+
+/** A proposed top-level frame with its modules and loose tasks. */
+export interface PlanFrame {
+  type: BlockType
+  title: string
+  description?: string
+  modules: PlanModule[]
+  tasks: PlanTask[]
+}
+
+/** A board structure extracted from an imported document. */
+export interface DocumentBoardPlan {
+  source: DocumentSourceKind
+  externalId: string
+  /** Whether an LLM produced the plan or the deterministic heading parser did. */
+  planner: 'llm' | 'headings'
+  frames: PlanFrame[]
+}
+
+/** Counts of blocks created by spawning a plan onto the board. */
+export interface SpawnResult {
+  frames: number
+  modules: number
+  tasks: number
+}

package/app/types/domain.ts

@@ -23,7 +23,7 @@ import type { ClarityReview } from './clarity'
 import type { MergeThresholdPreset } from './merge'
 import type { PipelineSchedule } from './recurring'
 import type { Service, WorkspaceMount } from './services'
-import type { TrackerSettings } from './tracker'
+import type { TrackerSettings, WritebackOverride } from './tracker'
 
 /** Lifecycle of an architecture building block. */
 export type BlockStatus =
@@ -145,6 +145,10 @@ export interface Block {
    * with the `product` role, notified when requirement review flags this task.
    */
   responsibleProductUserId?: string | null
+  /** task-only: override "comment on the linked issue when a PR opens"; absent/null = inherit workspace. */
+  trackerCommentOnPrOpen?: WritebackOverride | null
+  /** task-only: override "close the linked issue as resolved on merge"; absent/null = inherit workspace. */
+  trackerResolveOnMerge?: WritebackOverride | null
 }
 
 /**

package/app/types/execution.ts

@@ -333,6 +333,22 @@ export interface PipelineStep {
 export interface GateFailingCheck {
   name: string
   conclusion: string | null
+  /** GitHub web URL of the check run, so the UI can link to the failed run's logs */
+  url?: string | null
+}
+
+/** One helper-agent attempt the gate dispatched (mirrors `gateAttemptSchema`). */
+export interface GateAttempt {
+  /** 1-based attempt number */
+  attempt: number
+  /** epoch ms when the helper job finished */
+  at: number
+  /** how the helper job ended */
+  outcome: 'completed' | 'failed'
+  /** the PR head commit the helper worked against, when known */
+  headSha?: string | null
+  /** the helper's own account of what it did / what remains */
+  summary?: string | null
 }
 
 /** Live state of a polling gate step (`ci` / `conflicts`); mirrors `gateStepStateSchema`. */
@@ -350,6 +366,8 @@ export interface GateStepState {
   lastFailureSummary?: string | null
   /** structured failing checks behind the summary (CI gate only; absent for conflicts) */
   failingChecks?: GateFailingCheck[] | null
+  /** history of the helper-agent attempts this gate dispatched, newest last */
+  attemptLog?: GateAttempt[] | null
 }
 
 /** Live state of a `tester` step's Tester→Fixer loop (mirrors `testerStepStateSchema`). */