@cat-factory/app 0.35.0 → 0.37.0

package/app/types/github.ts

@@ -1,149 +1,33 @@
 // ---------------------------------------------------------------------------
 // GitHub integration. The backend's `GitHubModule` projects GitHub data
 // (repos/branches, pull requests/issues) into D1 and serves it fast and
-// rate-limit-free, alongside connect/resync/write endpoints. These mirror the
-// `@cat-factory/contracts` GitHub schemas so responses drop straight into the
-// Pinia store, just as the document-source types do for Confluence/Notion.
+// rate-limit-free, alongside connect/resync/write endpoints.
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of
+// truth). `CreatedRepo` has no exported contract type (the create-repo route
+// models the response inline), so it stays frontend-only below.
 // ---------------------------------------------------------------------------
 
-/** A workspace's GitHub App installation, as exposed to clients (no token). */
-export interface GitHubConnection {
-  installationId: number
-  accountLogin: string
-  targetType: 'Organization' | 'User'
-  connectedAt: number
-  /**
-   * Whether cat-factory can create repos under this account itself (privileged
-   * App tier). When true, the bootstrap UI drops the manual "create on GitHub"
-   * step. Defaults to false for older backends that don't send it.
-   */
-  canCreateRepos?: boolean
-  /**
-   * Whether the installation granted the App `workflows: write`. When false, agent
-   * pushes that add/update `.github/workflows/*` are rejected by GitHub, so the UI
-   * warns the user to grant the permission. Defaults to false for older backends.
-   */
-  canManageWorkflows?: boolean
-}
-
-/**
- * A discoverable App installation for the connect picker. `connected` says
- * whether it's already bound: to THIS workspace, to ANOTHER (so connecting would
- * be rejected), or to NONE (free to connect).
- */
-export interface GitHubInstallationOption {
-  installationId: number
-  accountLogin: string
-  targetType: 'Organization' | 'User'
-  accountAvatarUrl: string | null
-  connected: 'this' | 'other' | 'none'
-}
-
-/** A repository the integration tracks for a workspace. */
-export interface GitHubRepo {
-  githubId: number
-  installationId: number
-  owner: string
-  name: string
-  defaultBranch: string | null
-  private: boolean
-  /** Optional link to a board block this repo backs. */
-  blockId: string | null
-  /** Whether this repo is a monorepo hosting several services (each pinned to a subdirectory). */
-  isMonorepo?: boolean
-  syncedAt: number
-}
-
-/** One directory entry of a repo's tree, used by the monorepo service picker. */
-export interface RepoTreeEntry {
-  /** Path relative to the repo root, e.g. `packages/api`. */
-  path: string
-  /** Base name, e.g. `api`. */
-  name: string
-  /** `file` | `dir` | `symlink` | `submodule`. */
-  type: string
-}
-
-export interface GitHubBranch {
-  repoGithubId: number
-  name: string
-  headSha: string
-  protected: boolean
-  syncedAt: number
-}
-
-/**
- * A repo the connected installation can access, annotated with whether the
- * current workspace links it. Drives the per-workspace repo picker — repos are
- * linked explicitly per board, since the installation is shared across an
- * account's workspaces.
- */
-export interface GitHubAvailableRepo {
-  githubId: number
-  owner: string
-  name: string
-  defaultBranch: string | null
-  private: boolean
-  linked: boolean
-  /** Whether the (linked) repo is flagged as a monorepo. */
-  isMonorepo?: boolean
-}
-
-export type GitHubPullRequestState = 'open' | 'closed'
-
-export interface GitHubPullRequest {
-  repoGithubId: number
-  number: number
-  githubId: number
-  title: string
-  state: GitHubPullRequestState
-  headRef: string | null
-  baseRef: string | null
-  headSha: string | null
-  merged: boolean
-  author: string | null
-  updatedAt: number | null
-  syncedAt: number
-}
-
-export type GitHubIssueState = 'open' | 'closed'
-
-export interface GitHubIssue {
-  repoGithubId: number
-  number: number
-  githubId: number
-  title: string
-  state: GitHubIssueState
-  author: string | null
-  labels: string[]
-  updatedAt: number | null
-  syncedAt: number
-}
-
-// ---- request inputs -------------------------------------------------------
-
-/** Trigger a resync. Defaults to an incremental resync of all tracked repos. */
-export interface ResyncRequest {
-  /** Limit the resync to a single repo (by its GitHub numeric id). */
-  repoGithubId?: number
-  /** Run a full backfill (durable Workflow) instead of an incremental pass. */
-  full?: boolean
-}
-
-export interface CreateBranchInput {
-  name: string
-  fromSha: string
-}
-
-/** Body for programmatic repo creation (privileged App tier). */
-export interface CreateRepoRequest {
-  /** A single GitHub name segment — no "owner/" prefix. */
-  name: string
-  private?: boolean
-  description?: string
-}
-
-/** The freshly-created repository returned by the create-repo endpoint. */
+export type {
+  GitHubConnection,
+  GitHubInstallationOption,
+  GitHubRepo,
+  RepoTreeEntry,
+  GitHubBranch,
+  GitHubAvailableRepo,
+  GitHubPullRequestState,
+  GitHubPullRequest,
+  GitHubIssueState,
+  GitHubIssue,
+  ResyncRequest,
+  CreateBranchInput,
+  CreateRepoRequest,
+  CommitFilesInput,
+  OpenPullRequestInput,
+  MergePullRequestInput,
+} from '@cat-factory/contracts'
+
+/** The freshly-created repository returned by the create-repo endpoint. Frontend-only. */
 export interface CreatedRepo {
   githubId: number
   owner: string
@@ -151,23 +35,3 @@ export interface CreatedRepo {
   defaultBranch: string | null
   private: boolean
 }
-
-export interface CommitFilesInput {
-  branch: string
-  message: string
-  files: { path: string; content: string }[]
-  /** Parent commit to build on; defaults to the branch tip. */
-  baseSha?: string
-}
-
-export interface OpenPullRequestInput {
-  title: string
-  head: string
-  base: string
-  body?: string
-  draft?: boolean
-}
-
-export interface MergePullRequestInput {
-  method?: 'merge' | 'squash' | 'rebase'
-}

package/app/types/incidentEnrichment.ts

@@ -1,28 +1,13 @@
 // Per-workspace incident-enrichment connection (PagerDuty + incident.io). Mirrors
 // `@cat-factory/contracts` incident-enrichment. Credentials are write-only — the view
 // returns only a presence `summary`.
-
-export interface PagerDutyCredentials {
-  apiToken: string
-  fromEmail: string
-}
-
-export interface IncidentIoCredentials {
-  apiKey: string
-}
-
-/** Write input — set one or both providers; an omitted group is left unchanged. */
-export interface UpsertIncidentEnrichmentInput {
-  pagerDuty?: PagerDutyCredentials
-  incidentIo?: IncidentIoCredentials
-}
-
-export interface IncidentEnrichmentSummary {
-  pagerDuty: boolean
-  incidentIo: boolean
-}
-
-export interface IncidentEnrichmentView {
-  connected: boolean
-  summary: IncidentEnrichmentSummary | null
-}
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of truth).
+
+export type {
+  PagerDutyCredentials,
+  IncidentIoCredentials,
+  UpsertIncidentEnrichmentInput,
+  IncidentEnrichmentSummary,
+  IncidentEnrichmentView,
+} from '@cat-factory/contracts'

package/app/types/localModels.ts

@@ -8,66 +8,16 @@
 // Mirrors the `@cat-factory/contracts` `localModels` schemas exactly, so a payload
 // returned by the backend drops straight into the Pinia store without translation.
 // ---------------------------------------------------------------------------
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of truth).
 
-/** The supported local runner types. The runner type IS the `ModelRef.provider`. */
-export type LocalRunner = 'ollama' | 'lmstudio' | 'llamacpp' | 'vllm' | 'custom'
-
-/** Default base URL per runner, for UI prefill. `custom` has none (user supplies it). */
-export const LOCAL_RUNNER_DEFAULTS: Record<LocalRunner, string | null> = {
-  ollama: 'http://localhost:11434/v1',
-  lmstudio: 'http://localhost:1234/v1',
-  llamacpp: 'http://localhost:8080/v1',
-  vllm: 'http://localhost:8000/v1',
-  custom: null,
-}
-
-/** Short display label per runner, shown in the picker as the provider label. */
-export const LOCAL_RUNNER_LABELS: Record<LocalRunner, string> = {
-  ollama: 'Ollama',
-  lmstudio: 'LM Studio',
-  llamacpp: 'llama.cpp',
-  vllm: 'vLLM',
-  custom: 'Custom',
-}
-
-/**
- * A user's configured local runner endpoint, as returned to the SPA. The API key is
- * write-only (never returned); `hasApiKey` reports whether one is stored.
- */
-export interface LocalModelEndpoint {
-  provider: LocalRunner
-  label: string
-  baseUrl: string
-  /** Whether a (write-only) API key is stored for this endpoint. */
-  hasApiKey: boolean
-  /** The model ids the user has enabled from this runner (surfaced in the picker). */
-  models: string[]
-  createdAt: number
-  updatedAt: number
-}
-
-/** Create or replace the signed-in user's endpoint for a runner (one per runner). */
-export interface UpsertLocalModelEndpointInput {
-  provider: LocalRunner
-  label?: string
-  baseUrl: string
-  /** Optional bearer key (most local runners ignore it); stored encrypted at rest. */
-  apiKey?: string
-  models: string[]
-}
-
-/** Probe a runner endpoint for reachability + the models it currently serves. */
-export interface TestLocalModelEndpointInput {
-  provider: LocalRunner
-  baseUrl: string
-  apiKey?: string
-}
+export type {
+  LocalRunner,
+  LocalModelEndpoint,
+  UpsertLocalModelEndpointInput,
+  TestLocalModelEndpointInput,
+  LocalModelEndpointTestResult,
+} from '@cat-factory/contracts'
 
-/** The result of probing a runner endpoint's `/models`. */
-export interface LocalModelEndpointTestResult {
-  reachable: boolean
-  /** Model ids the runner reports (empty when unreachable). */
-  models: string[]
-  /** Human-readable failure reason when `reachable` is false. */
-  error?: string
-}
+// Value re-exports (the per-runner default base URL + display labels).
+export { LOCAL_RUNNER_DEFAULTS, LOCAL_RUNNER_LABELS } from '@cat-factory/contracts'

package/app/types/localSettings.ts

@@ -3,29 +3,12 @@
 // dedicated local-mode settings panel — these replaced the old LOCAL_POOL_* / HARNESS_* env
 // vars. There are no secrets, so the read view is the plain config. Local-mode-only (the
 // warm pool is the local Docker-family runner's differentiator).
-
-export interface LocalPoolSettings {
-  /** Max idle warm containers kept for re-lease. 0 disables pooling (cold-start per run). */
-  size: number
-  /** Containers pre-warmed when the service starts. */
-  minWarm: number
-  /** Hard cap on total containers (leased + idle). `null` ⇒ defaults to `size`. */
-  max: number | null
-  /** How long an idle pooled container is kept before eviction (ms). */
-  idleTtlMs: number
-}
-
-export interface LocalCheckoutSettings {
-  /** Absolute in-container dir the reused per-repo checkout lives under. */
-  workspaceRoot: string
-  /** Dep-cache directories the per-run clean sweep keeps (so deps aren't reinstalled). */
-  cleanKeep: string[]
-}
-
-export interface LocalSettings {
-  pool: LocalPoolSettings
-  checkout: LocalCheckoutSettings
-}
-
-/** Admin write: the full settings blob fully replaces the stored config. */
-export type UpdateLocalSettingsInput = LocalSettings
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of truth).
+
+export type {
+  LocalPoolSettings,
+  LocalCheckoutSettings,
+  LocalSettings,
+  UpdateLocalSettingsInput,
+} from '@cat-factory/contracts'

package/app/types/merge.ts

@@ -1,71 +1,13 @@
 // Merge-policy shapes, mirroring `@cat-factory/contracts` (merge.ts). A `merger`
 // agent scores a PR on three 0..1 axes and the engine compares them against the
 // task's resolved threshold preset to auto-merge or raise a review notification.
-
-/** A `merger` agent's assessment of a pull request (each axis 0..1). */
-export interface MergeAssessment {
-  complexity: number
-  risk: number
-  impact: number
-  rationale: string
-}
-
-/**
- * The highest reviewer-finding severity a task tolerates before the requirements review
- * stops for a human. `none` tolerates nothing; `high` tolerates everything. Ordered
- * none < low < medium < high.
- */
-export type RequirementConcernLevel = 'none' | 'low' | 'medium' | 'high'
-
-/** A named, per-workspace merge policy a task can select. */
-export interface MergeThresholdPreset {
-  id: string
-  name: string
-  /** Auto-merge only when the assessment's complexity is ≤ this. */
-  maxComplexity: number
-  /** Auto-merge only when the assessment's risk is ≤ this. */
-  maxRisk: number
-  /** Auto-merge only when the assessment's impact is ≤ this. */
-  maxImpact: number
-  /** How many times the CI-fixer may try before the CI gate gives up. */
-  ciMaxAttempts: number
-  /** How many reviewer passes the requirements-review loop runs before asking the human. */
-  maxRequirementIterations: number
-  /** Findings at or below this severity auto-pass without stopping for a human. */
-  maxRequirementConcernAllowed: RequirementConcernLevel
-  /** Minutes the post-release-health gate watches the release's monitors/SLOs after deploy. */
-  releaseWatchWindowMinutes: number
-  /** How many on-call investigations the post-release-health gate may dispatch. */
-  releaseMaxAttempts: number
-  /** The workspace's fallback preset, used by tasks that pick none. */
-  isDefault: boolean
-  createdAt: number
-}
-
-/** Create a merge threshold preset. */
-export interface CreateMergePresetInput {
-  name: string
-  maxComplexity: number
-  maxRisk: number
-  maxImpact: number
-  ciMaxAttempts: number
-  maxRequirementIterations: number
-  maxRequirementConcernAllowed: RequirementConcernLevel
-  releaseWatchWindowMinutes?: number
-  releaseMaxAttempts?: number
-  isDefault?: boolean
-}
-
-/** Patch a merge threshold preset (all fields optional). */
-export interface UpdateMergePresetInput {
-  name?: string
-  maxComplexity?: number
-  maxRisk?: number
-  maxImpact?: number
-  ciMaxAttempts?: number
-  maxRequirementIterations?: number
-  maxRequirementConcernAllowed?: RequirementConcernLevel
-  releaseWatchWindowMinutes?: number
-  releaseMaxAttempts?: number
-  isDefault?: boolean
-}
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of truth).
+
+export type {
+  MergeAssessment,
+  RequirementConcernLevel,
+  MergeThresholdPreset,
+  CreateMergePresetInput,
+  UpdateMergePresetInput,
+} from '@cat-factory/contracts'

package/app/types/model-presets.ts

@@ -2,32 +2,11 @@
 // is a named, per-workspace model->agent mapping: one base model applied to every
 // agent kind plus per-kind overrides. A task selects one (Block.modelPresetId); none
 // resolves to the workspace default preset.
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of truth).
 
-/** A named, per-workspace model preset a task can select. */
-export interface ModelPreset {
-  id: string
-  name: string
-  /** The model every agent kind defaults to under this preset (a catalog id). */
-  baseModelId: string
-  /** Per-agent-kind model overrides on top of the base (agent kind → model id). */
-  overrides: Record<string, string>
-  /** The workspace's fallback preset, used by tasks that pick none. */
-  isDefault: boolean
-  createdAt: number
-}
-
-/** Create a model preset. */
-export interface CreateModelPresetInput {
-  name: string
-  baseModelId: string
-  overrides?: Record<string, string>
-  isDefault?: boolean
-}
-
-/** Patch a model preset (all fields optional; `overrides` replaces the map). */
-export interface UpdateModelPresetInput {
-  name?: string
-  baseModelId?: string
-  overrides?: Record<string, string>
-  isDefault?: boolean
-}
+export type {
+  ModelPreset,
+  CreateModelPresetInput,
+  UpdateModelPresetInput,
+} from '@cat-factory/contracts'

package/app/types/models.ts

@@ -2,167 +2,19 @@
 // Model selection & best-practice prompt fragments. Mirrors the
 // `@cat-factory/contracts` schemas served read-only by the backend.
 // ---------------------------------------------------------------------------
-
-import type { AgentKind, BlockType } from './domain'
-import type { DocumentSourceKind } from './documents'
-
-/** Subscription vendors whose pooled tokens drive the Claude Code / Codex harnesses. */
-export type SubscriptionVendor = 'claude' | 'codex' | 'glm' | 'kimi' | 'deepseek'
-
-/** Informational list price (per 1M tokens) for a model flavour. */
-export interface ModelCost {
-  inputPerMillion: number
-  outputPerMillion: number
-  currency: string
-}
-
-/**
- * A selectable LLM model, resolved to the flavour in use for this deployment
- * (served by `GET /models`). Mirrors `ModelOption` in `@cat-factory/contracts`.
- * The base `flavor`/`provider`/`model` is the always-available fallback
- * (cloudflare/direct/openrouter), or the subscription itself for subscription-only
- * models. `subscription` (when present) is the alternative the picker prefers once
- * the workspace has a token for its vendor.
- */
-export interface ModelOption {
-  id: string
-  label: string
-  description: string
-  flavor: 'cloudflare' | 'direct' | 'openrouter' | 'subscription'
-  /**
-   * Whether this model is actually selectable for the workspace: a direct API key for
-   * its provider, a connected subscription vendor, or Cloudflare AI enabled. Absent on
-   * the deployment-level catalog; present on the per-workspace `/workspaces/:id/models`.
-   */
-  available?: boolean
-  providerLabel: string
-  provider: string
-  model: string
-  vendor?: SubscriptionVendor
-  cost?: ModelCost
-  contextTokens?: number
-  /** True when the effective flavour is flat-rate quota (not budget-metered). */
-  quotaBased?: boolean
-  /** The alternative subscription flavour for a dual-mode model (GLM/Kimi). */
-  subscription?: {
-    vendor: SubscriptionVendor
-    providerLabel: string
-    provider: string
-    model: string
-    cost?: ModelCost
-    contextTokens?: number
-  }
-}
-
-/**
- * Status of a user's personal (individual-usage) subscription — Claude consumer
- * subscriptions are licensed per individual, so they're stored per-user (not pooled)
- * and unlocked with a personal password. Metadata only; never the token.
- */
-export interface PersonalSubscriptionStatus {
-  vendor: SubscriptionVendor
-  label: string
-  createdAt: number
-  updatedAt: number
-  lastUsedAt: number | null
-  /** Subscription's own expiry (null = no fixed end date). */
-  expiresAt: number | null
-  /** Whole days until `expiresAt` (negative once lapsed; null when no expiry). */
-  expiresInDays: number | null
-  expired: boolean
-  /** Whether renewal should be surfaced now (expiry within the warning window). */
-  renewSoon: boolean
-}
-
-/** Connect (or replace) the signed-in user's personal subscription for a vendor. */
-export interface StorePersonalSubscriptionInput {
-  vendor: SubscriptionVendor
-  label: string
-  token: string
-  /** Personal password gating the second encryption layer; never stored. */
-  password: string
-  /** Epoch ms the subscription expires (for renewal warnings); optional. */
-  expiresAt?: number | null
-}
-
-/** The scope a stored direct-provider API key belongs to. */
-export type ApiKeyScope = 'account' | 'workspace' | 'user'
-
-/** The direct providers that own a poolable API key. */
-export type ApiKeyProvider =
-  | 'openai'
-  | 'anthropic'
-  | 'qwen'
-  | 'deepseek'
-  | 'moonshot'
-  | 'openrouter'
-  | 'litellm'
-
-/** A connected direct-provider API key (metadata + usage), never the secret. */
-export interface ApiKey {
-  id: string
-  scope: ApiKeyScope
-  scopeId: string
-  provider: ApiKeyProvider
-  label: string
-  createdAt: number
-  lastUsedAt: number | null
-  inputTokens: number
-  outputTokens: number
-  requestCount: number
-}
-
-/** Add a direct-provider API key to a pool. `key` is write-only (the raw secret). */
-export interface AddApiKeyInput {
-  provider: ApiKeyProvider
-  label: string
-  key: string
-}
-
-/** A connected subscription credential (metadata + usage), never the secret. */
-export interface VendorCredential {
-  id: string
-  vendor: SubscriptionVendor
-  label: string
-  createdAt: number
-  lastUsedAt: number | null
-  inputTokens: number
-  outputTokens: number
-  requestCount: number
-}
-
-/**
- * A curated best-practice "prompt fragment" served read-only by the backend
- * (`GET /prompt-fragments`). Users pick which apply to a block; the backend folds
- * the selected fragments' bodies into the agent system prompt at run time.
- */
-export interface PromptFragment {
-  id: string
-  version: string
-  title: string
-  category: string
-  summary: string
-  body: string
-  appliesTo?: {
-    blockTypes?: BlockType[]
-    agentKinds?: AgentKind[]
-  }
-  /** Free-form tags the relevance selector uses (managed/sourced fragments only). */
-  tags?: string[]
-  /** Provenance when sourced from a repo; absent for built-in/hand-authored. */
-  source?: {
-    sourceId: string
-    path: string
-    sha: string
-  }
-  /**
-   * Provenance when the body is a LIVING external document (Confluence/Notion/
-   * GitHub). The body is re-resolved from the source at run time, not frozen.
-   */
-  documentRef?: {
-    source: DocumentSourceKind
-    externalId: string
-  }
-  /** When the document-backed body was last resolved from the source (epoch ms). */
-  resolvedAt?: number
-}
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of truth).
+
+export type {
+  SubscriptionVendor,
+  ModelCost,
+  ModelOption,
+  PersonalSubscriptionStatus,
+  StorePersonalSubscriptionInput,
+  ApiKeyScope,
+  ApiKeyProvider,
+  ApiKey,
+  AddApiKeyInput,
+  VendorCredential,
+  PromptFragment,
+} from '@cat-factory/contracts'