@cat-factory/app 0.36.0 → 0.37.0

package/app/types/consensus.ts

@@ -1,91 +1,18 @@
 // Frontend mirror of the consensus + task-estimate wire contracts in
 // `@cat-factory/contracts` (src/consensus.ts). Hand-synced, like the other type mirrors.
-
-export type ConsensusStrategy = 'specialist-panel' | 'debate' | 'ranked-voting'
-
-export interface ConsensusParticipant {
-  id: string
-  role: string
-  systemFraming?: string
-  modelId?: string
-}
-
-export interface ConsensusGating {
-  enabled: boolean
-  minComplexity?: number
-  minRisk?: number
-  minImpact?: number
-  onMissingEstimate?: 'consensus' | 'standard'
-}
-
-/**
- * Estimate-based gating of whether a pipeline STEP runs at all (the same three axes as
- * {@link ConsensusGating}). When enabled the step runs only if ANY supplied axis is met or
- * exceeded; otherwise it is skipped at runtime. Used to make a companion conditional on how
- * heavy the task is. A step with enabled gating requires a `task-estimator` earlier in the
- * pipeline.
- */
-export interface StepGating {
-  enabled: boolean
-  minComplexity?: number
-  minRisk?: number
-  minImpact?: number
-  onMissingEstimate?: 'run' | 'skip'
-}
-
-export interface ConsensusStepConfig {
-  enabled: boolean
-  strategy: ConsensusStrategy
-  participants: ConsensusParticipant[]
-  synthesizerModelId?: string
-  rounds?: number
-  gating?: ConsensusGating
-}
-
-/** The task-estimator's triage of a task (each axis 0..1). */
-export interface TaskEstimate {
-  complexity: number
-  risk: number
-  impact: number
-  rationale: string
-  model?: string | null
-  createdAt: number
-}
-
-export interface ConsensusScore {
-  dimension: string
-  value: number
-  rationale?: string
-}
-
-export interface ConsensusContribution {
-  participantId: string
-  text: string
-  scores?: ConsensusScore[]
-}
-
-export interface ConsensusRound {
-  index: number
-  kind?: 'draft' | 'critique' | 'score'
-  contributions: ConsensusContribution[]
-}
-
-export type ConsensusSessionStatus = 'running' | 'synthesizing' | 'done' | 'failed'
-
-export interface ConsensusSession {
-  id: string
-  blockId: string
-  executionId: string | null
-  stepIndex: number
-  agentKind: string
-  strategy: ConsensusStrategy
-  status: ConsensusSessionStatus
-  participants: ConsensusParticipant[]
-  rounds: ConsensusRound[]
-  synthesis: string | null
-  confidence?: number | null
-  dissent?: string[]
-  error?: string | null
-  createdAt: number
-  updatedAt: number
-}
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of truth).
+
+export type {
+  ConsensusStrategy,
+  ConsensusParticipant,
+  ConsensusGating,
+  StepGating,
+  ConsensusStepConfig,
+  TaskEstimate,
+  ConsensusScore,
+  ConsensusContribution,
+  ConsensusRound,
+  ConsensusSessionStatus,
+  ConsensusSession,
+} from '@cat-factory/contracts'

package/app/types/documents.ts

@@ -1,102 +1,27 @@
 // ---------------------------------------------------------------------------
 // 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`.
+// attached to a task as agent context.
+//
+// All wire shapes are sourced from @cat-factory/contracts (single source of
+// truth). `SpawnResult` has no exported contract type (the contract models it
+// inline), so it stays frontend-only below.
 // ---------------------------------------------------------------------------
 
-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 type {
+  DocumentSourceKind,
+  CredentialField,
+  DocumentSourceDescriptor,
+  DocumentConnection,
+  SourceDocument,
+  DocumentSearchResult,
+  PlanTask,
+  PlanModule,
+  PlanFrame,
+  DocumentBoardPlan,
+} from '@cat-factory/contracts'
+
+/** Counts of blocks created by spawning a plan onto the board. Frontend-only. */
 export interface SpawnResult {
   frames: number
   modules: number