@cat-factory/app 0.36.0 → 0.37.0

package/app/types/notifications.ts

@@ -1,77 +1,18 @@
-// Notification shapes, mirroring `@cat-factory/contracts` (notifications.ts). A
-// notification is a first-class, human-actionable item surfaced on the board that
-// outlives the run that raised it (a PR awaiting a merge decision, a completed
-// pipeline awaiting confirmation, CI that gave up).
-
-import type { MergeAssessment } from './merge'
-
-export type NotificationType =
-  | 'merge_review'
-  | 'pipeline_complete'
-  | 'ci_failed'
-  | 'test_failed'
-  | 'requirement_review'
-  | 'clarity_review'
-  | 'release_regression'
-  | 'decision_required'
-  | 'human_test_ready'
-  | 'human_review'
-  | 'followup_pending'
-export type NotificationStatus = 'open' | 'acted' | 'dismissed'
-
-/** The on-call agent's recommendation on a `release_regression`. */
-export type OnCallRecommendation = 'revert' | 'hold' | 'monitor'
-
-/** The on-call agent's assessment of a post-release regression. */
-export interface OnCallAssessment {
-  culpritConfidence: number
-  recommendation: OnCallRecommendation
-  rationale: string
-  evidence?: string[]
-}
-
-/** A regressed monitor/SLO on a `release_regression`. */
-export interface ReleaseSignal {
-  kind: 'monitor' | 'slo'
-  id: string
-  name: string
-  state: 'ok' | 'warn' | 'alert' | 'no_data'
-  detail?: string
-}
-
-/** Optional structured detail for rendering a notification card. */
-export interface NotificationPayload {
-  assessment?: MergeAssessment
-  prUrl?: string
-  pipelineName?: string
-  findingCount?: number
-  /** The on-call assessment, on a `release_regression`. */
-  onCallAssessment?: OnCallAssessment
-  /** The regressed monitors/SLOs, on a `release_regression`. */
-  releaseSignals?: ReleaseSignal[]
-  /** A proposed revert PR URL, when known. */
-  revertUrl?: string
-}
-
-/** A human-actionable item surfaced on the board. */
-/**
- * Render urgency. A notification starts `normal` (the inbox's usual per-type colour) and
- * is escalated to `urgent` (red) by the backend's sweep once it has waited for a human
- * past the workspace's `waitingEscalationMinutes` threshold. Absent ⇒ `normal`.
- */
-export type NotificationSeverity = 'normal' | 'urgent'
-
-export interface Notification {
-  id: string
-  type: NotificationType
-  status: NotificationStatus
-  /** Render urgency (yellow vs red); escalated by the backend sweep. Absent ⇒ normal. */
-  severity?: NotificationSeverity
-  blockId: string | null
-  executionId: string | null
-  title: string
-  body: string
-  payload?: NotificationPayload | null
-  createdAt: number
-  resolvedAt: number | null
-}
+// Notification shapes. A notification is a first-class, human-actionable item
+// surfaced on the board that outlives the run that raised it (a PR awaiting a
+// merge decision, a completed pipeline awaiting confirmation, CI that gave up).
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of
+// truth). The historical frontend name `ReleaseSignal` is the contract's
+// `ReleaseSignalWire`.
+
+export type {
+  NotificationType,
+  NotificationStatus,
+  OnCallRecommendation,
+  OnCallAssessment,
+  NotificationPayload,
+  NotificationSeverity,
+  Notification,
+  ReleaseSignalWire as ReleaseSignal,
+} from '@cat-factory/contracts'

package/app/types/openrouter.ts

@@ -8,38 +8,12 @@
 // Mirrors the `@cat-factory/contracts` `openrouter` 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).
 
-/** Metadata for one OpenRouter model (prices per 1M tokens, in the spend currency). */
-export interface OpenRouterModelMeta {
-  /** OpenRouter `vendor/model` slug, e.g. `anthropic/claude-opus-4.8`. */
-  id: string
-  /** Human-readable model name from OpenRouter's catalog. */
-  name: string
-  /** Total context window (input + output tokens), when reported. */
-  contextLength?: number
-  /** Input price per 1M tokens, in the spend currency. */
-  inputPerMillion: number
-  /** Output price per 1M tokens, in the spend currency. */
-  outputPerMillion: number
-}
-
-/** A workspace's enabled OpenRouter models (the persisted subset). */
-export interface OpenRouterCatalog {
-  models: OpenRouterModelMeta[]
-  createdAt: number
-  updatedAt: number
-}
-
-/** Replace a workspace's enabled OpenRouter models with this subset (+ metadata). */
-export interface UpsertOpenRouterCatalogInput {
-  models: OpenRouterModelMeta[]
-}
-
-/** The result of probing OpenRouter's live `/models` for the browse list. */
-export interface OpenRouterRefreshResult {
-  reachable: boolean
-  /** Every model OpenRouter currently serves (empty when unreachable). */
-  models: OpenRouterModelMeta[]
-  /** Human-readable failure reason when `reachable` is false. */
-  error?: string
-}
+export type {
+  OpenRouterModelMeta,
+  OpenRouterCatalog,
+  UpsertOpenRouterCatalogInput,
+  OpenRouterRefreshResult,
+} from '@cat-factory/contracts'

package/app/types/providerConnections.ts

@@ -1,44 +1,22 @@
-// Frontend mirrors of the shared provider self-description + connection wire contracts
-// (`@cat-factory/contracts` provider-config.ts + environments.ts + runners.ts), used by
-// the generic connect form for the two infrastructure providers: the ephemeral-environment
-// provider and the self-hosted runner pool. Both speak the same ProviderDescriptor.
+// Provider self-description + connection wire contracts for the generic connect form
+// used by the two infrastructure providers: the ephemeral-environment provider and the
+// self-hosted runner pool. Both speak the same ProviderDescriptor.
+//
+// The shared shapes are sourced from @cat-factory/contracts (single source of truth).
+// The register/test request bodies are the union of the two per-kind contract inputs
+// (the composable picks the right contract per kind). `ProviderConnectionKind` and the
+// generic `ProviderConnection` view have no exported contract type, so they stay
+// frontend-only below.
+
+export type {
+  ProviderConfigField,
+  ProviderDescriptor,
+  ConnectionTestResult,
+} from '@cat-factory/contracts'
 
 /** The two infrastructure providers configured through the generic connect form. */
 export type ProviderConnectionKind = 'environment' | 'runner-pool'
 
-/** One config value a provider needs, rendered as a single form field. */
-export interface ProviderConfigField {
-  key: string
-  label: string
-  help?: string
-  placeholder?: string
-  secret?: boolean
-  required?: boolean
-  type?: 'text' | 'password' | 'select'
-  options?: { value: string; label: string }[]
-  /** The provider/manifest default; a field with one is optional (UI shows a hint). */
-  default?: string
-}
-
-/** What the SPA needs to render a provider's connect form. */
-export interface ProviderDescriptor {
-  providerId: string
-  label: string
-  kind: 'native' | 'manifest'
-  configFields: ProviderConfigField[]
-  supportsTest: boolean
-  /** Required-without-default keys not yet supplied (drives the banner). */
-  missingRequired: string[]
-  /** Base manifest a native provider's flat fields are overlaid onto before save. */
-  manifestTemplate?: Record<string, unknown>
-  /**
-   * The CURRENT saved manifest (non-secret — only secret-ref key names), present once a
-   * connection exists. Edits are overlaid onto this (not the bare `manifestTemplate`) so
-   * re-saving preserves previously-stored providerConfig instead of dropping it.
-   */
-  savedManifest?: Record<string, unknown>
-}
-
 /** A workspace's provider binding, as exposed to clients (never secret values). */
 export interface ProviderConnection {
   providerId: string
@@ -49,10 +27,11 @@ export interface ProviderConnection {
   secretKeys: string[]
 }
 
-export interface ConnectionTestResult {
-  ok: boolean
-  message?: string
-}
+// The connect form builds the manifest dynamically from a server-provided scaffold
+// (`ProviderDescriptor.manifestTemplate`/`savedManifest`) overlaid with form values, so
+// the FE treats it as an opaque JSON bag. The backend re-validates it against the precise
+// per-provider manifest contract on receipt; the composable casts to the contract input
+// type at the single `send` boundary.
 
 /** The assembled register payload (a full manifest + the write-only secret bundle). */
 export interface RegisterProviderInput {
@@ -60,6 +39,7 @@ export interface RegisterProviderInput {
   secrets: Record<string, string>
 }
 
+/** The test/probe payload (manifest-driven or native), shared by both providers. */
 export interface TestProviderInput {
   manifest?: Record<string, unknown>
   config?: Record<string, string>

package/app/types/provisioningLogs.ts

@@ -1,32 +1,12 @@
 // Frontend mirror of the unified provisioning event-log wire shapes
 // (`@cat-factory/contracts` provisioning-logs.ts). Drives the "View logs" drawers in
 // the environment-provider + runner-pool config panels and the run-details env surface.
-
-export type ProvisioningSubsystem = 'environment' | 'runner-pool' | 'container'
-
-export type ProvisioningOperation =
-  | 'provision'
-  | 'teardown'
-  | 'status'
-  | 'dispatch'
-  | 'release'
-  | 'poll-failure'
-
-export type ProvisioningOutcome = 'success' | 'failure'
-
-/** One provisioning attempt (spin-up / tear-down), as returned by the logs endpoint. */
-export interface ProvisioningLogEntry {
-  id: string
-  workspaceId: string
-  subsystem: ProvisioningSubsystem
-  operation: ProvisioningOperation
-  targetId: string | null
-  providerId: string | null
-  blockId: string | null
-  executionId: string | null
-  outcome: ProvisioningOutcome
-  /** The verbatim provider/runtime error on a failure, else null. */
-  error: string | null
-  detail: string | null
-  createdAt: number
-}
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of truth).
+
+export type {
+  ProvisioningSubsystem,
+  ProvisioningOperation,
+  ProvisioningOutcome,
+  ProvisioningLogEntry,
+} from '@cat-factory/contracts'

package/app/types/recurring.ts

@@ -3,67 +3,14 @@
 // run every `intervalHours`, constrained to an optional allowed window (weekdays +
 // an hour-of-day range, in the schedule's timezone). Each schedule owns one reused
 // on-board task block; firing it starts the pipeline against that block.
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of truth).
 
-/** Template a schedule was created from; drives the seeded block description. */
-export type ScheduleTemplate = 'dep-update' | 'tech-debt' | 'custom'
-
-/** How often a schedule fires and when it is allowed to. */
-export interface Recurrence {
-  /** Base cadence in hours (≥1). */
-  intervalHours: number
-  /** Allowed weekdays (0=Sun..6=Sat). Empty = every day. */
-  weekdays: number[]
-  /** Inclusive start of the allowed hour-of-day window, or null for no lower bound. */
-  windowStartHour: number | null
-  /** Exclusive end of the allowed hour-of-day window, or null for no upper bound. */
-  windowEndHour: number | null
-  /** IANA timezone the weekday/hour window is evaluated in (e.g. 'UTC'). */
-  timezone: string
-}
-
-/** A recurring pipeline attached to a service. */
-export interface PipelineSchedule {
-  id: string
-  /** The reused on-board task block the pipeline runs against. */
-  blockId: string
-  /** The service frame it lives in. */
-  frameId: string
-  pipelineId: string
-  template: ScheduleTemplate
-  name: string
-  recurrence: Recurrence
-  enabled: boolean
-  lastRunAt: number | null
-  /** Computed epoch-ms of the next eligible fire. */
-  nextRunAt: number
-  createdAt: number
-}
-
-/** One historical fire of a schedule (retained ~1 week), shown in the inspector. */
-export interface ScheduleRun {
-  id: string
-  scheduleId: string
-  executionId: string | null
-  status: 'running' | 'done' | 'failed' | 'skipped'
-  startedAt: number
-  finishedAt: number | null
-  outcome: string | null
-}
-
-export interface CreateScheduleInput {
-  frameId: string
-  pipelineId: string
-  template?: ScheduleTemplate
-  name: string
-  recurrence: Recurrence
-  enabled?: boolean
-  /** The prompt/description for the reused on-board task; empty → the template seed. */
-  description?: string
-}
-
-export interface UpdateScheduleInput {
-  name?: string
-  pipelineId?: string
-  recurrence?: Recurrence
-  enabled?: boolean
-}
+export type {
+  ScheduleTemplate,
+  Recurrence,
+  PipelineSchedule,
+  ScheduleRun,
+  CreateScheduleInput,
+  UpdateScheduleInput,
+} from '@cat-factory/contracts'

package/app/types/releaseHealth.ts

@@ -1,39 +1,15 @@
-// Post-release-health (observability) settings shapes, mirroring `@cat-factory/contracts`
-// (release.ts). Per-workspace observability connection (provider + credentials, write-only,
-// never read back) and the per-block monitor/SLO mappings the post-release-health gate reads.
-
-/** Observability vendors a workspace can connect (extensible; Datadog today). */
-export type ObservabilityProviderKind = 'datadog'
-
-/** What `GET /observability/connection` returns — never the secret keys. */
-export interface ObservabilityConnectionView {
-  connected: boolean
-  provider: ObservabilityProviderKind | null
-  /** Non-secret display fields, e.g. `{ site }` for Datadog. */
-  summary: Record<string, string> | null
-}
-
-/** Set/replace the workspace's observability connection. */
-export interface UpsertObservabilityConnectionInput {
-  provider: ObservabilityProviderKind
-  credentials: {
-    site: string
-    apiKey: string
-    appKey: string
-  }
-}
-
-/** A block's monitor/SLO mapping for the post-release-health gate. */
-export interface ReleaseHealthConfig {
-  blockId: string
-  monitorIds: string[]
-  sloIds: string[]
-  envTag: string | null
-}
-
-/** Create/replace a block's release-health config. */
-export interface UpsertReleaseHealthConfigInput {
-  monitorIds?: string[]
-  sloIds?: string[]
-  envTag?: string | null
-}
+// Post-release-health (observability) settings shapes. Per-workspace observability
+// connection (provider + credentials, write-only, never read back) and the per-block
+// monitor/SLO mappings the post-release-health gate reads.
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of truth).
+// The historical frontend name `ReleaseHealthConfig` is the contract's
+// `ReleaseHealthConfigWire`.
+
+export type {
+  ObservabilityProviderKind,
+  ObservabilityConnectionView,
+  UpsertObservabilityConnectionInput,
+  UpsertReleaseHealthConfigInput,
+  ReleaseHealthConfigWire as ReleaseHealthConfig,
+} from '@cat-factory/contracts'

package/app/types/requirements.ts

@@ -5,87 +5,17 @@
 // A stateless reviewer agent inspects a block's collected requirements and
 // raises questions / gaps / clarifications; a human answers or dismisses each;
 // then the agent folds the answers back into the block's requirements.
-
-export type ReviewItemCategory = 'gap' | 'clarification' | 'assumption' | 'risk' | 'question'
-
-export type ReviewItemSeverity = 'low' | 'medium' | 'high'
-
-export type ReviewItemStatus =
-  | 'open'
-  | 'answered'
-  | 'resolved'
-  | 'dismissed'
-  | 'recommend_requested'
-
-export interface RequirementReviewItem {
-  id: string
-  category: ReviewItemCategory
-  severity: ReviewItemSeverity
-  title: string
-  detail: string
-  status: ReviewItemStatus
-  reply: string | null
-  createdAt: number
-  updatedAt: number
-}
-
-/**
- * - `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 requirements phase is settled.
- */
-export type RequirementReviewStatus =
-  | 'ready'
-  | 'incorporating'
-  | 'reviewing'
-  | 'merged'
-  | 'exceeded'
-  | 'incorporated'
-
-/** How a human resolves a review that hit its iteration cap. */
-export type ResolveRequirementsExceededChoice = 'extra-round' | 'proceed' | 'stop-reset'
-
-/**
- * Lifecycle of a Requirement-Writer recommendation. `pending` is a placeholder created the
- * moment the human requests it — the Writer is still producing the suggestion in the background
- * (the async story); it fills in to `ready` via the `requirements` stream.
- */
-export type RecommendationStatus = 'pending' | 'ready' | 'accepted' | 'rejected'
-
-/**
- * A Requirement-Writer suggestion for one finding. First-class on the review (survives the
- * re-review item churn); the source finding is snapshotted by title/detail. `groundedInFragment`
- * marks a suggestion taken straight from a best-practice fragment (the "current standard").
- */
-export interface RequirementRecommendation {
-  id: string
-  sourceFinding: { title: string; detail: string; itemId?: string }
-  recommendedText: string
-  status: RecommendationStatus
-  note: string | null
-  groundedInFragment: { id: string; title: string } | null
-  createdAt: number
-  updatedAt: number
-}
-
-export interface RequirementReview {
-  id: string
-  blockId: string
-  status: RequirementReviewStatus
-  items: RequirementReviewItem[]
-  model: string | null
-  incorporatedRequirements: 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
-  /** Requirement-Writer suggestions awaiting (or settled by) human accept/reject. */
-  recommendations: RequirementRecommendation[]
-  createdAt: number
-  updatedAt: number
-}
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of truth).
+
+export type {
+  ReviewItemCategory,
+  ReviewItemSeverity,
+  ReviewItemStatus,
+  RequirementReviewItem,
+  RequirementReviewStatus,
+  ResolveRequirementsExceededChoice,
+  RecommendationStatus,
+  RequirementRecommendation,
+  RequirementReview,
+} from '@cat-factory/contracts'