@growth-labs/cms 0.5.9 → 0.5.10

package/src/schema/types.ts

@@ -9,6 +9,8 @@
 // Nullability: a column declared NOT NULL maps to a required, non-nullable
 // field; a nullable column maps to `T | null` (D1 returns SQL NULL as JS null).
 
+import { z } from 'zod'
+
 /** content_items.type CHECK domain. */
 export type ContentType = 'article' | 'video' | 'podcast' | 'newsletter' | 'page'
 
@@ -417,6 +419,60 @@ export type InsightRunStatus = 'running' | 'completed' | 'partial' | 'failed'
 /** Beat facet — secondary topical facet (geographic theater lives in desk). */
 export type InsightBeat = 'defense' | 'intelligence' | 'diplomacy' | 'analysis'
 
+/** Insight Engine v2 editorial action lane. */
+export type InsightLane = 'commission' | 'refresh' | 'optimize-ctr' | 'consolidate' | 'monitor'
+
+/** Bounded scoring inputs carried with Insight Engine v2 evidence. */
+export interface InsightScoreBreakdown {
+	actualCtr: number
+	expectedCtr: number
+	expectedClicksGain: number
+	laneWeight: number
+	score: number
+	targetPosition: number
+	topicalFit: number
+	winnabilityPrior: number
+}
+
+export type InsightJudgeReasonCode =
+	| 'no_coherent_intent'
+	| 'navigational_or_entity_locked'
+	| 'off_topic'
+	| 'already_covered'
+	| 'unwinnable'
+	| 'unsustainable_format'
+	| 'too_thin'
+	| 'accept'
+
+export type InsightJudgeVerdict = 'accept' | 'reject' | 'abstain'
+
+export interface InsightWinnabilityEvidence {
+	verdict: InsightJudgeVerdict
+	confidence: number
+	serp_summary: string
+}
+
+export interface InsightJudgeEvidence {
+	verdict: InsightJudgeVerdict
+	reason_code: InsightJudgeReasonCode
+	confidence: number
+	intent_statement: string
+	winnability?: InsightWinnabilityEvidence
+}
+
+export interface InsightSemanticEvidence {
+	topicalFit: number
+	disposition: 'reject' | 'judge_only' | 'advance'
+	coverageSimilarity: number
+	coverageAligned: boolean
+	sharedConcepts: number
+	nearest: Array<{
+		title: string
+		slug: string
+		similarity: number
+	}>
+}
+
 /** Demand evidence chip (signal_type='demand'): the real GSC metric. */
 export interface InsightEvidenceDemand {
 	query: string
@@ -428,6 +484,12 @@ export interface InsightEvidenceDemand {
 	position: number
 	/** Impression delta vs the prior window (signed). */
 	trend: number
+	lane?: InsightLane
+	coveredBy?: string | null
+	coverageSource?: 'page_join' | 'semantic' | 'lexical' | null
+	scoreBreakdown?: InsightScoreBreakdown
+	judge?: InsightJudgeEvidence
+	semantic?: InsightSemanticEvidence
 }
 
 /** Opportunity evidence chip (signal_type='opportunity'): validated-research basis. */
@@ -436,6 +498,10 @@ export interface InsightEvidenceOpportunity {
 	basis: string
 	/** Count of cite-or-cut validated sources backing the idea. */
 	source_count: number
+	lane?: InsightLane
+	scoreBreakdown?: InsightScoreBreakdown
+	judge?: InsightJudgeEvidence
+	semantic?: InsightSemanticEvidence
 }
 
 /** content_insights.evidence — JSON stored as TEXT NOT NULL, zod-validated. */
@@ -463,6 +529,16 @@ export interface InsightBrief {
 		spokes: string[]
 	}
 	sources: Array<{ title: string; url: string }>
+	format?: 'cornerstone' | 'pillar' | 'standalone'
+	content_outline?: Array<{
+		question: string
+		demand?: {
+			query: string
+			impressions: number
+			position: number
+			trend: number
+		}
+	}>
 	/**
 	 * Which open-web discovery STREAM produced this opportunity row (the theater
 	 * split): 'competitor' (RSS competitor-watch) vs 'audience_question' (Google
@@ -532,12 +608,28 @@ export interface ContentInsightRunRow {
 	error: string | null
 }
 
+/** Editor-owned dismissal taxonomy (migration 0022). */
+export const InsightDismissalReasonCodeSchema = z.enum([
+	'off_topic',
+	'already_covered',
+	'cant_win',
+	'wrong_format',
+	'not_now',
+	'other',
+])
+
+export type InsightDismissalReasonCode = z.infer<typeof InsightDismissalReasonCodeSchema>
+
 /** A content_insight_dismissals row (PK (site_id, intent_key)). */
 export interface ContentInsightDismissalRow {
 	site_id: string
 	intent_key: string
 	dismissed_at: number
 	dismissed_by: string | null
+	/** NULL is a pre-0022 legacy dismissal. */
+	reason_code: InsightDismissalReasonCode | null
+	/** NULL is either legacy or an editor dismissal without a note. */
+	note: string | null
 }
 
 export type ContentPublicationOperation = 'publish' | 'rollback'