@cat-factory/app 0.35.0 → 0.37.0

package/app/stores/ui.ts

@@ -91,6 +91,14 @@ export const useUiStore = defineStore('ui', () => {
   // is one. Every direct `open*` below resets it; `openFromIntegrations` sets it.
   const cameFromIntegrations = ref(false)
 
+  // Personal "My setup" hub: a user-scoped sibling of the Integrations hub, listing the
+  // signed-in user's own connections (GitHub PAT, local runners, personal subscriptions)
+  // separated out of the workspace-scoped Integrations hub. `cameFromPersonal` is the
+  // symmetric came-from marker, so a panel reached from here renders a "Back to My setup"
+  // control instead of "Back to Integrations".
+  const personalSetupOpen = ref(false)
+  const cameFromPersonal = ref(false)
+
   // Workspace-settings modal: a single tabbed window gathering the workspace-wide
   // config (workspace / merge thresholds / issue writeback / service best practices).
   // `workspaceSettingsTab` lets other surfaces deep-link straight to a tab.
@@ -112,8 +120,10 @@ export const useUiStore = defineStore('ui', () => {
   const providerConnectionKind = ref<'environment' | 'runner-pool' | null>(null)
   const modelConfigOpen = ref(false)
   // LLM-vendor subscription credentials (the token pool powering the Claude Code
-  // / Codex harnesses).
+  // / Codex harnesses). `vendorCredentialsTab` lets a caller deep-link to one tab —
+  // the user-scoped "My subscriptions" entry opens straight onto the `personal` tab.
   const vendorCredentialsOpen = ref(false)
+  const vendorCredentialsTab = ref('pool')
   // Per-user settings panel: the signed-in user's own-machine local model runners.
   const localModelsOpen = ref(false)
   // Local-mode-only settings panel: the warm-container pool sizing + per-repo checkout reuse
@@ -267,7 +277,7 @@ export const useUiStore = defineStore('ui', () => {
   }
 
   function openDocumentConnect(source: DocumentSourceKind) {
-    cameFromIntegrations.value = false
+    resetHubReturn()
     documentConnect.value = { source }
   }
   function closeDocumentConnect() {
@@ -277,7 +287,7 @@ export const useUiStore = defineStore('ui', () => {
     targetFrameId: string | null = null,
     source: DocumentSourceKind | null = null,
   ) {
-    cameFromIntegrations.value = false
+    resetHubReturn()
     documentImport.value = { source, targetFrameId }
   }
   function closeDocumentImport() {
@@ -294,14 +304,14 @@ export const useUiStore = defineStore('ui', () => {
     spawnPreview.value = null
   }
   function openTaskConnect(source: TaskSourceKind) {
-    cameFromIntegrations.value = false
+    resetHubReturn()
     taskConnect.value = { source }
   }
   function closeTaskConnect() {
     taskConnect.value = null
   }
   function openTaskImport(source: TaskSourceKind | null = null, containerId: string | null = null) {
-    cameFromIntegrations.value = false
+    resetHubReturn()
     taskImport.value = { source, containerId }
   }
   function closeTaskImport() {
@@ -334,14 +344,14 @@ export const useUiStore = defineStore('ui', () => {
     addServiceOpen.value = false
   }
   function openGitHub() {
-    cameFromIntegrations.value = false
+    resetHubReturn()
     githubOpen.value = true
   }
   function closeGitHub() {
     githubOpen.value = false
   }
   function openSlack() {
-    cameFromIntegrations.value = false
+    resetHubReturn()
     slackOpen.value = true
   }
   function closeSlack() {
@@ -362,15 +372,37 @@ export const useUiStore = defineStore('ui', () => {
   function toggleCommandBar() {
     commandBarOpen.value = !commandBarOpen.value
   }
+  // Clear BOTH hub came-from markers. Every direct `open*` below calls this so that a
+  // panel opened outside the hubs never grows a dead Back control, and so switching from
+  // one hub's panel to the other's clears the stale marker.
+  function resetHubReturn() {
+    resetHubReturn()
+    cameFromPersonal.value = false
+  }
   function openIntegrations() {
     // Reaching the hub itself (fresh, or via a panel's Back control) clears the
-    // came-from marker — we're at the hub, not inside a hub-spawned panel.
-    cameFromIntegrations.value = false
+    // came-from markers — we're at the hub, not inside a hub-spawned panel.
+    resetHubReturn()
     integrationsOpen.value = true
   }
   function closeIntegrations() {
     integrationsOpen.value = false
   }
+  function openPersonalSetup() {
+    resetHubReturn()
+    personalSetupOpen.value = true
+  }
+  function closePersonalSetup() {
+    personalSetupOpen.value = false
+  }
+  // Open a user-scoped panel FROM the My-setup hub: run its open handler (which resets the
+  // markers), then mark that we came from My setup and dismiss it, so the panel's
+  // IntegrationBackTitle returns here rather than to the workspace Integrations hub.
+  function openFromPersonal(open: () => void) {
+    open()
+    cameFromPersonal.value = true
+    personalSetupOpen.value = false
+  }
   // Open an integration's own panel FROM the hub: run its open handler (which resets
   // `cameFromIntegrations`), then mark that we came from the hub and dismiss it. The
   // panel reads `cameFromIntegrations` to show its Back control.
@@ -380,7 +412,7 @@ export const useUiStore = defineStore('ui', () => {
     integrationsOpen.value = false
   }
   function openWorkspaceSettings(tab = 'workspace') {
-    cameFromIntegrations.value = false
+    resetHubReturn()
     workspaceSettingsTab.value = tab
     workspaceSettingsOpen.value = true
   }
@@ -391,7 +423,7 @@ export const useUiStore = defineStore('ui', () => {
     workspaceSettingsTab.value = tab
   }
   function openAccountSettings(tab = 'team') {
-    cameFromIntegrations.value = false
+    resetHubReturn()
     accountSettingsTab.value = tab
     accountSettingsOpen.value = true
   }
@@ -402,14 +434,14 @@ export const useUiStore = defineStore('ui', () => {
     accountSettingsTab.value = tab
   }
   function openObservabilityConnection() {
-    cameFromIntegrations.value = false
+    resetHubReturn()
     observabilityConnectionOpen.value = true
   }
   function closeObservabilityConnection() {
     observabilityConnectionOpen.value = false
   }
   function openProviderConnection(kind: 'environment' | 'runner-pool') {
-    cameFromIntegrations.value = false
+    resetHubReturn()
     providerConnectionKind.value = kind
   }
   function closeProviderConnection() {
@@ -421,22 +453,26 @@ export const useUiStore = defineStore('ui', () => {
   function closeModelConfig() {
     modelConfigOpen.value = false
   }
-  function openVendorCredentials() {
-    cameFromIntegrations.value = false
+  function openVendorCredentials(tab = 'pool') {
+    resetHubReturn()
+    vendorCredentialsTab.value = tab
     vendorCredentialsOpen.value = true
   }
+  function setVendorCredentialsTab(tab: string) {
+    vendorCredentialsTab.value = tab
+  }
   function closeVendorCredentials() {
     vendorCredentialsOpen.value = false
   }
   function openLocalModels() {
-    cameFromIntegrations.value = false
+    resetHubReturn()
     localModelsOpen.value = true
   }
   function closeLocalModels() {
     localModelsOpen.value = false
   }
   function openLocalModeSettings() {
-    cameFromIntegrations.value = false
+    resetHubReturn()
     localModeSettingsOpen.value = true
   }
   function closeLocalModeSettings() {
@@ -449,14 +485,14 @@ export const useUiStore = defineStore('ui', () => {
     sandboxOpen.value = false
   }
   function openUserSecrets() {
-    cameFromIntegrations.value = false
+    resetHubReturn()
     userSecretsOpen.value = true
   }
   function closeUserSecrets() {
     userSecretsOpen.value = false
   }
   function openOpenRouter() {
-    cameFromIntegrations.value = false
+    resetHubReturn()
     openRouterOpen.value = true
   }
   function closeOpenRouter() {
@@ -581,6 +617,8 @@ export const useUiStore = defineStore('ui', () => {
     commandBarOpen,
     integrationsOpen,
     cameFromIntegrations,
+    personalSetupOpen,
+    cameFromPersonal,
     workspaceSettingsOpen,
     workspaceSettingsTab,
     accountSettingsOpen,
@@ -589,6 +627,7 @@ export const useUiStore = defineStore('ui', () => {
     providerConnectionKind,
     modelConfigOpen,
     vendorCredentialsOpen,
+    vendorCredentialsTab,
     localModelsOpen,
     localModeSettingsOpen,
     sandboxOpen,
@@ -645,6 +684,9 @@ export const useUiStore = defineStore('ui', () => {
     openIntegrations,
     closeIntegrations,
     openFromIntegrations,
+    openPersonalSetup,
+    closePersonalSetup,
+    openFromPersonal,
     openWorkspaceSettings,
     closeWorkspaceSettings,
     setWorkspaceSettingsTab,
@@ -658,6 +700,7 @@ export const useUiStore = defineStore('ui', () => {
     openModelConfig,
     closeModelConfig,
     openVendorCredentials,
+    setVendorCredentialsTab,
     closeVendorCredentials,
     openLocalModels,
     closeLocalModels,

package/app/types/accountSettings.ts

@@ -1,39 +1,14 @@
 // Per-account (deployment-wide) integration settings. Mirrors
 // `@cat-factory/contracts` accountSettings. Secrets are write-only — the read view
 // returns only `config` + a non-secret presence `summary`.
-
-export interface SlackOAuthSecret {
-  clientId: string
-  clientSecret: string
-  redirectUrl: string
-}
-
-export interface WebSearchSecret {
-  braveApiKey?: string
-  searxngUrl?: string
-  searxngApiKey?: string
-}
-
-/** Non-secret per-account config (empty today; reserved for forward-compatible tuning). */
-export type AccountSettingsConfig = Record<string, never>
-
-export interface AccountSettingsSummary {
-  slackOAuthConfigured: boolean
-  webSearch: 'brave' | 'searxng' | null
-}
-
-export interface AccountSettingsView {
-  config: AccountSettingsConfig
-  summary: AccountSettingsSummary
-}
-
-/**
- * Admin write. Each secrets group: omit ⇒ leave unchanged, `null` ⇒ clear, value ⇒ set.
- */
-export interface UpdateAccountSettingsInput {
-  config?: AccountSettingsConfig
-  secrets?: {
-    slackOAuth?: SlackOAuthSecret | null
-    webSearch?: WebSearchSecret | null
-  }
-}
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of truth).
+
+export type {
+  SlackOAuthSecret,
+  WebSearchSecret,
+  AccountSettingsConfig,
+  AccountSettingsSummary,
+  AccountSettingsView,
+  UpdateAccountSettingsInput,
+} from '@cat-factory/contracts'

package/app/types/accounts.ts

@@ -4,74 +4,19 @@
 // to accounts with a role. Mirrors the `@cat-factory/contracts` account schemas
 // so responses drop straight into the Pinia store.
 // ---------------------------------------------------------------------------
-
-import type { CloudProvider } from './domain'
-
-export type AccountType = 'personal' | 'org'
-/** Combinable account roles: admin controls the org account, product owns tasks. */
-export type AccountRole = 'admin' | 'developer' | 'product'
-
-/** An account, annotated with the signed-in caller's roles in it. */
-export interface Account {
-  id: string
-  type: AccountType
-  name: string
-  githubAccountLogin: string | null
-  createdAt: number
-  /** The caller's roles in this account (`null` in the auth-disabled path). */
-  roles: AccountRole[] | null
-  /** The cloud provider new services in this account default to; absent = built-in default. */
-  defaultCloudProvider?: CloudProvider
-}
-
-/** A member of an account, with display details when resolvable. */
-export interface AccountMember {
-  accountId: string
-  userId: string
-  roles: AccountRole[]
-  createdAt: number
-  name?: string | null
-  email?: string | null
-  avatarUrl?: string | null
-}
-
-export interface CreateAccountInput {
-  name: string
-  githubAccountLogin?: string
-}
-
-/** Update an account's settings (today: its default cloud provider for new services). */
-export interface UpdateAccountInput {
-  defaultCloudProvider?: CloudProvider
-}
-
-export interface AddMemberInput {
-  userId: string
-  roles?: AccountRole[]
-}
-
-/** Set a member's role set (admin-only). */
-export interface SetMemberRolesInput {
-  roles: AccountRole[]
-}
-
-/** An email invitation into an org account (never carries the raw token). */
-export interface AccountInvitation {
-  id: string
-  accountId: string
-  email: string
-  roles: AccountRole[]
-  status: 'pending' | 'accepted' | 'revoked'
-  invitedBy: string
-  expiresAt: number
-  createdAt: number
-}
-
-export type EmailProviderKind = 'sendgrid' | 'resend'
-
-/** A per-account email-sender connection (safe metadata; never the API key). */
-export interface EmailConnection {
-  provider: EmailProviderKind
-  fromAddress: string
-  connectedAt: number
-}
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of truth).
+
+export type {
+  AccountType,
+  AccountRole,
+  Account,
+  AccountMember,
+  CreateAccountInput,
+  UpdateAccountInput,
+  AddMemberInput,
+  SetMemberRolesInput,
+  AccountInvitation,
+  EmailProviderKind,
+  EmailConnection,
+} from '@cat-factory/contracts'

package/app/types/bootstrap.ts

@@ -6,78 +6,16 @@
 // org wants new services to follow); the "bootstrap repo" task creates a new repo
 // from one and runs a bootstrapper agent in a container to adapt it.
 // ---------------------------------------------------------------------------
-
-import type { AgentFailure, AgentFailureKind, StepSubtasks } from './execution'
-
-/** A managed base repository new repos are bootstrapped from. */
-export interface ReferenceArchitecture {
-  id: string
-  workspaceId: string
-  name: string
-  description: string
-  repoOwner: string
-  repoName: string
-  defaultInstructions: string
-  createdAt: number
-  updatedAt: number
-}
-
-/** Body to register a reference architecture. */
-export interface CreateReferenceArchitectureInput {
-  name: string
-  description?: string
-  repoOwner: string
-  repoName: string
-  defaultInstructions?: string
-}
-
-/** Body to patch a reference architecture (only supplied fields change). */
-export type UpdateReferenceArchitectureInput = Partial<CreateReferenceArchitectureInput>
-
-/** Lifecycle of a single "bootstrap repo" run. */
-export type BootstrapStatus = 'pending' | 'running' | 'succeeded' | 'failed'
-
-/**
- * A bootstrap run's failure is now the shared {@link AgentFailure} (same shape
- * execution runs use), so the board renders one failure banner + retry for any
- * agent. These aliases stay for back-compat / documentation of the bootstrap
- * subset; `bootstrapFailureKindSchema` on the backend stays narrow.
- */
-export type BootstrapFailureKind = AgentFailureKind
-
-/** Structured failure diagnostics captured when a bootstrap run fails. */
-export type BootstrapFailure = AgentFailure
-
-/** One "bootstrap repo" run with its outcome. */
-export interface BootstrapJob {
-  id: string
-  workspaceId: string
-  /** Reference architecture the run was based on, or null for a from-scratch run. */
-  referenceArchitectureId: string | null
-  /** Denormalized reference architecture name, or null for a from-scratch run. */
-  referenceArchitectureName: string | null
-  repoName: string
-  repoOwner: string | null
-  repoUrl: string | null
-  instructions: string
-  status: BootstrapStatus
-  /** The board service frame this run materialises, or null if none was created. */
-  blockId: string | null
-  /** Live subtask counts from the bootstrapper agent, or null until it reports. */
-  subtasks: StepSubtasks | null
-  error: string | null
-  /** Structured failure diagnostics when `status` is `failed`; null otherwise. */
-  failure: BootstrapFailure | null
-  createdAt: number
-  updatedAt: number
-}
-
-/** Body to kick off a bootstrap run. Omit `referenceArchitectureId` to bootstrap
- * from a freeform prompt alone (then `instructions` must be non-empty). */
-export interface BootstrapRepoInput {
-  referenceArchitectureId?: string | null
-  repoName: string
-  description?: string
-  private?: boolean
-  instructions?: string
-}
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of truth).
+
+export type {
+  ReferenceArchitecture,
+  CreateReferenceArchitectureInput,
+  UpdateReferenceArchitectureInput,
+  BootstrapStatus,
+  BootstrapFailureKind,
+  BootstrapFailure,
+  BootstrapJob,
+  BootstrapRepoInput,
+} from '@cat-factory/contracts'

package/app/types/brainstorm.ts

@@ -10,46 +10,21 @@
 // Structurally identical to a requirements review (the items share the same shape), so the
 // per-item types are reused from `~/types/requirements`; only the `stage` discriminator and
 // the converged document (`convergedDirection`) differ.
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of truth).
 
-import type {
-  RequirementReviewItem,
+export type {
+  BrainstormStage,
+  BrainstormItem,
+  BrainstormStatus,
+  ResolveBrainstormExceededChoice,
+  BrainstormSession,
+  // The per-item types are shared with a requirements review (same shape).
   ReviewItemCategory,
   ReviewItemSeverity,
   ReviewItemStatus,
-} from '~/types/requirements'
-
-export type { ReviewItemCategory, ReviewItemSeverity, ReviewItemStatus }
-
-/** Which dialogue a brainstorm session drives. */
-export type BrainstormStage = 'requirements' | 'architecture'
-
-/** A brainstorm option is the same shape as a requirements-review item. */
-export type BrainstormItem = RequirementReviewItem
-
-/** Lifecycle of a brainstorm session — identical to the requirements review lifecycle. */
-export type BrainstormStatus =
-  | 'ready'
-  | 'incorporating'
-  | 'reviewing'
-  | 'merged'
-  | 'exceeded'
-  | 'incorporated'
-
-/** How a human resolves a session that hit its iteration cap. */
-export type ResolveBrainstormExceededChoice = 'extra-round' | 'proceed' | 'stop-reset'
+} from '@cat-factory/contracts'
+import type { UpdateBrainstormItemStatusInput } from '@cat-factory/contracts'
 
-export interface BrainstormSession {
-  id: string
-  blockId: string
-  stage: BrainstormStage
-  status: BrainstormStatus
-  items: BrainstormItem[]
-  model: string | null
-  convergedDirection: string | null
-  /** Agent passes run so far (initial pass is 1; each re-run adds one). */
-  iteration: number
-  /** The agent-pass budget (from the task's merge preset; an extra round bumps it). */
-  maxIterations: number
-  createdAt: number
-  updatedAt: number
-}
+/** The narrower status set the set-item-status action accepts (a subset of ReviewItemStatus). */
+export type BrainstormItemStatus = UpdateBrainstormItemStatusInput['status']

package/app/types/clarity.ts

@@ -9,51 +9,20 @@
 // Structurally identical to a requirements review (the items share the same shape),
 // so the per-item types are reused from `~/types/requirements`; only the
 // incorporated document differs (`clarifiedReport`).
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of truth).
 
-import type {
-  RequirementReviewItem,
+export type {
+  ClarityReviewItem,
+  ClarityReviewStatus,
+  ResolveClarityExceededChoice,
+  ClarityReview,
+  // The per-item types are shared with a requirements review (same shape).
   ReviewItemCategory,
   ReviewItemSeverity,
   ReviewItemStatus,
-} from '~/types/requirements'
-
-export type { ReviewItemCategory, ReviewItemSeverity, ReviewItemStatus }
-
-/** A clarity-review item is the same shape as a requirements-review item. */
-export type ClarityReviewItem = RequirementReviewItem
-
-/**
- * - `ready`: the reviewer raised findings awaiting human answers/dismissals.
- * - `incorporating`: transient; the driver is folding the answers into a document (the FIRST
- *   async stage — the user is back on the board).
- * - `reviewing`: transient; the reviewer is RE-reviewing the folded document (the SECOND
- *   async stage). Distinct from `incorporating` so the UI can show which stage is running.
- * - `merged`: the companion produced a document (an internal transient on the async path).
- * - `exceeded`: the iteration cap was hit with findings open — awaiting the human's choice.
- * - `incorporated`: terminal; the clarity phase is settled.
- */
-export type ClarityReviewStatus =
-  | 'ready'
-  | 'incorporating'
-  | 'reviewing'
-  | 'merged'
-  | 'exceeded'
-  | 'incorporated'
-
-/** How a human resolves a review that hit its iteration cap. */
-export type ResolveClarityExceededChoice = 'extra-round' | 'proceed' | 'stop-reset'
+} from '@cat-factory/contracts'
+import type { UpdateClarityItemStatusInput } from '@cat-factory/contracts'
 
-export interface ClarityReview {
-  id: string
-  blockId: string
-  status: ClarityReviewStatus
-  items: ClarityReviewItem[]
-  model: string | null
-  clarifiedReport: string | null
-  /** Reviewer passes run so far (initial review is 1; each re-review adds one). */
-  iteration: number
-  /** The reviewer-pass budget (from the task's merge preset; an extra round bumps it). */
-  maxIterations: number
-  createdAt: number
-  updatedAt: number
-}
+/** The narrower status set the set-item-status action accepts (a subset of ReviewItemStatus). */
+export type ClarityItemStatus = UpdateClarityItemStatusInput['status']