@foundrynorth/compass-schema 1.0.20 → 1.0.22

package/src/schema.ts

@@ -105,6 +105,12 @@ import {
 import { createInsertSchema } from "drizzle-zod";
 import { z } from "zod";
 import type { IntelligenceData } from "./analyzeTypes.js";
+import {
+  ACTIVITY_EVENT_TYPES,
+  ACTIVITY_SEVERITIES,
+  ACTIVITY_SOURCE_SYSTEMS,
+  PENDING_ACTION_TYPES,
+} from "./types/activity-feed.js";
 
 export const users = pgTable("users", {
   id: varchar("id")
@@ -124,6 +130,38 @@ export type User = typeof users.$inferSelect;
 
 export const avatarRequestStatusEnum = pgEnum("avatar_request_status", ["pending", "processed", "rejected"]);
 
+// Activity feed enums (order activity feed + pending actions)
+export const activityEventTypeEnum = pgEnum(
+  "activity_event_type",
+  ACTIVITY_EVENT_TYPES as unknown as [string, ...string[]],
+);
+
+export const activitySeverityEnum = pgEnum(
+  "activity_severity",
+  ACTIVITY_SEVERITIES as unknown as [string, ...string[]],
+);
+
+export const activitySourceSystemEnum = pgEnum(
+  "activity_source_system",
+  ACTIVITY_SOURCE_SYSTEMS as unknown as [string, ...string[]],
+);
+
+export const pendingActionTypeEnum = pgEnum(
+  "pending_action_type",
+  PENDING_ACTION_TYPES as unknown as [string, ...string[]],
+);
+
+export const amendmentReasonEnum = pgEnum("amendment_reason", [
+  "budget_adjustment",
+  "flight_date_change",
+  "product_swap",
+  "add_line_items",
+  "remove_line_items",
+  "rate_renegotiation",
+  "client_request",
+  "other",
+]);
+
 // Vendor enums (must be declared before clerkUsers which references them)
 export const vendorFulfillmentStatusEnum = pgEnum("vendor_fulfillment_status", [
   "assigned",
@@ -208,6 +246,19 @@ export const userProfiles = pgTable("user_profiles", {
   photoUrl: text("photo_url"), // Profile photo (can sync from Clerk or custom upload)
   agencyAvatarUrl: text("agency_avatar_url"), // Hand-sketched avatar for proposals (Fal.ai)
   lastAvatarGeneratedAt: timestamp("last_avatar_generated_at"), // Rate limiting: non-admins can only generate 1/day
+  proposalPortraitRenderUrl: text("proposal_portrait_render_url"),
+  proposalPortraitCutoutUrl: text("proposal_portrait_cutout_url"),
+  proposalPortraitStatus: text("proposal_portrait_status"),
+  proposalPortraitPromptVersion: text("proposal_portrait_prompt_version"),
+  proposalPortraitSeed: integer("proposal_portrait_seed"),
+  proposalPortraitGeneratedAt: timestamp("proposal_portrait_generated_at"),
+  proposalPortraitSourcePhotoHash: text("proposal_portrait_source_photo_hash"),
+  proposalPortraitPreviewRenderUrl: text("proposal_portrait_preview_render_url"),
+  proposalPortraitPreviewCutoutUrl: text("proposal_portrait_preview_cutout_url"),
+  proposalPortraitPreviewPromptVersion: text("proposal_portrait_preview_prompt_version"),
+  proposalPortraitPreviewSeed: integer("proposal_portrait_preview_seed"),
+  proposalPortraitPreviewGeneratedAt: timestamp("proposal_portrait_preview_generated_at"),
+  proposalPortraitPreviewSourcePhotoHash: text("proposal_portrait_preview_source_photo_hash"),
 
   // Active Market Preference (overrides partner default)
   preferredMarketId: varchar("preferred_market_id"), // User's preferred market for planning
@@ -247,6 +298,19 @@ export const externalTeamMembers = pgTable("external_team_members", {
   title: text("title"),
   photoUrl: text("photo_url"),
   agencyAvatarUrl: text("agency_avatar_url"),
+  proposalPortraitRenderUrl: text("proposal_portrait_render_url"),
+  proposalPortraitCutoutUrl: text("proposal_portrait_cutout_url"),
+  proposalPortraitStatus: text("proposal_portrait_status"),
+  proposalPortraitPromptVersion: text("proposal_portrait_prompt_version"),
+  proposalPortraitSeed: integer("proposal_portrait_seed"),
+  proposalPortraitGeneratedAt: timestamp("proposal_portrait_generated_at"),
+  proposalPortraitSourcePhotoHash: text("proposal_portrait_source_photo_hash"),
+  proposalPortraitPreviewRenderUrl: text("proposal_portrait_preview_render_url"),
+  proposalPortraitPreviewCutoutUrl: text("proposal_portrait_preview_cutout_url"),
+  proposalPortraitPreviewPromptVersion: text("proposal_portrait_preview_prompt_version"),
+  proposalPortraitPreviewSeed: integer("proposal_portrait_preview_seed"),
+  proposalPortraitPreviewGeneratedAt: timestamp("proposal_portrait_preview_generated_at"),
+  proposalPortraitPreviewSourcePhotoHash: text("proposal_portrait_preview_source_photo_hash"),
   linkedinUrl: text("linkedin_url"),
   displayOrder: integer("display_order").default(0),
   createdAt: timestamp("created_at").notNull().defaultNow(),
@@ -534,6 +598,35 @@ export const competitorSchema = z.object({
       lng: z.number(),
     })
     .optional(), // Detailed location information
+
+  // Ad library data from Apify deep enrichment
+  ads: z
+    .object({
+      facebook: z
+        .array(
+          z.object({
+            adImage: z.string().optional(),
+            headline: z.string().optional(),
+            adCopy: z.string().optional(),
+            callToAction: z.string().optional(),
+            publisherPlatforms: z.array(z.string()).optional(),
+            startDate: z.string().optional(),
+          })
+        )
+        .optional(),
+      google: z
+        .array(
+          z.object({
+            headline: z.string().optional(),
+            description: z.string().optional(),
+            landingPage: z.string().optional(),
+            adType: z.string().optional(),
+            imageUrl: z.string().optional(),
+          })
+        )
+        .optional(),
+    })
+    .optional(),
 });
 
 export type Competitor = z.infer<typeof competitorSchema>;
@@ -1029,7 +1122,7 @@ export const plans = pgTable("plans", {
   contractId: uuid("contract_id"), // FK → contracts.id (nullable — links to annual contract)
 
   // Workflow mode: determines which UI sections and features are available
-  // 'research_backed' = full AnalyzeAndPlan flow (default, all existing plans)
+  // 'research_backed' = discovery mode — creates plan, runs analysis in background
   // 'direct_config' = configure products directly without research
   // 'aor_pitch' = agency-of-record pitch with proposal focus
   // 'io_entry' = direct insertion order entry from client PDF/XLSX
@@ -1180,6 +1273,7 @@ export const plans = pgTable("plans", {
   defaultTargeting: text("default_targeting"),
   defaultAudience: text("default_audience"),
   defaultPromoting: text("default_promoting"),
+  defaultCreativeSource: varchar("default_creative_source"),
   defaultFlightStart: date("default_flight_start"),
   defaultFlightEnd: date("default_flight_end"),
 
@@ -1251,8 +1345,12 @@ export const proposals = pgTable(
       .default(sql`gen_random_uuid()`),
 
     // Optional plan reference (nullable — can be standalone)
-    planId: varchar("plan_id"),
-    engagementId: varchar("engagement_id"), // FK → engagements.id (nullable during transition)
+    planId: varchar("plan_id").references(() => plans.id, {
+      onDelete: "set null",
+    }),
+    engagementId: varchar("engagement_id").references(() => engagements.id, {
+      onDelete: "set null",
+    }), // nullable during transition
 
     // Configuration references (which plan_configurations to include)
     configurationIds: jsonb("configuration_ids").$type<string[]>(),
@@ -1323,6 +1421,41 @@ export const insertPlanSchema = createInsertSchema(plans).omit({
   createdAt: true,
 } as any);
 
+// ============================================================================
+// Proposal Engagement Tracking
+// ============================================================================
+
+export const proposalEngagement = pgTable(
+  "proposal_engagement",
+  {
+    id: varchar("id")
+      .primaryKey()
+      .default(sql`gen_random_uuid()`),
+    proposalId: varchar("proposal_id"), // FK → proposals.id (nullable for legacy plan-based shares)
+    planId: varchar("plan_id"), // FK → plans.id (fallback for legacy shares)
+    shareToken: text("share_token").notNull(), // The share token used to access
+    sessionId: text("session_id").notNull(), // Anonymous session ID (crypto.randomUUID on client)
+    // Engagement data
+    events: jsonb("events").notNull().default(sql`'[]'::jsonb`), // Array of engagement events
+    engagementScore: integer("engagement_score").default(0), // Computed 0-100 score
+    summary: text("summary"), // AI-generated follow-up brief
+    // Device context
+    device: text("device"), // "desktop" | "mobile" | "tablet"
+    referrer: text("referrer"), // HTTP referrer
+    userAgent: text("user_agent"),
+    // Timestamps
+    firstSeenAt: timestamp("first_seen_at").notNull().defaultNow(),
+    lastSeenAt: timestamp("last_seen_at").notNull().defaultNow(),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+  },
+  (table) => [
+    index("proposal_engagement_proposal_id_idx").on(table.proposalId),
+    index("proposal_engagement_plan_id_idx").on(table.planId),
+    index("proposal_engagement_share_token_idx").on(table.shareToken),
+    index("proposal_engagement_token_session_idx").on(table.shareToken, table.sessionId),
+  ]
+);
+
 export type InsertPlan = z.infer<typeof insertPlanSchema>;
 export type Plan = typeof plans.$inferSelect;
 
@@ -1762,6 +1895,7 @@ export const clerkUsers = pgTable("clerk_users", {
   createdAt: timestamp("created_at").notNull().defaultNow(),
   approvedAt: timestamp("approved_at"),
   approvedBy: text("approved_by"), // Admin who approved
+  compassVoiceWarmth: numeric("compass_voice_warmth").default("0.6"),
 });
 
 export const insertClerkUserSchema = createInsertSchema(clerkUsers).omit({
@@ -4707,21 +4841,167 @@ export const mediaOrderStatusEnum = pgEnum("media_order_status", [
   "completed",
 ]);
 
+export const salesInitiatives = pgTable(
+  "sales_initiatives",
+  {
+    id: uuid("id").primaryKey().defaultRandom(),
+    code: varchar("code").notNull().unique(),
+    name: varchar("name").notNull(),
+    description: text("description"),
+    hubspotValue: varchar("hubspot_value").notNull().unique(),
+    displayOrder: integer("display_order").notNull().default(0),
+    startsAt: date("starts_at"),
+    endsAt: date("ends_at"),
+    isActive: boolean("is_active").notNull().default(true),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+    updatedAt: timestamp("updated_at").notNull().defaultNow(),
+  },
+  (table) => [
+    index("sales_initiatives_active_idx").on(table.isActive),
+    index("sales_initiatives_display_order_idx").on(table.displayOrder),
+  ],
+);
+
+export const insertSalesInitiativeSchema = createInsertSchema(
+  salesInitiatives,
+).omit({
+  id: true,
+  createdAt: true,
+  updatedAt: true,
+});
+export const updateSalesInitiativeSchema = insertSalesInitiativeSchema.partial();
+export type SalesInitiative = typeof salesInitiatives.$inferSelect;
+export type InsertSalesInitiative = z.infer<typeof insertSalesInitiativeSchema>;
+export type UpdateSalesInitiative = z.infer<typeof updateSalesInitiativeSchema>;
+
+export const salesPackages = pgTable(
+  "sales_packages",
+  {
+    id: uuid("id").primaryKey().defaultRandom(),
+    code: varchar("code").notNull().unique(),
+    name: varchar("name").notNull(),
+    description: text("description"),
+    initiativeCode: varchar("initiative_code"),
+    sellerSummary: text("seller_summary"),
+    packagePrice: numeric("package_price", { precision: 12, scale: 2 }),
+    discountPercent: numeric("discount_percent", { precision: 5, scale: 2 }),
+    addedValueAmount: numeric("added_value_amount", { precision: 12, scale: 2 }),
+    addedValueDescription: varchar("added_value_description", { length: 255 }),
+    hubspotPackageValue: varchar("hubspot_package_value").notNull().unique(),
+    startsAt: date("starts_at"),
+    endsAt: date("ends_at"),
+    status: varchar("status").notNull().default("draft"),
+    recommendationMode: varchar("recommendation_mode").notNull().default("both"),
+    recommendationPriority: integer("recommendation_priority").notNull().default(0),
+    eligibilityRules: jsonb("eligibility_rules").$type<{
+      goals?: string[];
+      industries?: string[];
+      geographyTags?: string[];
+      minBudget?: number | null;
+      maxBudget?: number | null;
+      requireActiveWindow?: boolean;
+      minProductOverlap?: number | null;
+      allowSubsetMatch?: boolean;
+      allowNearMatch?: boolean;
+      compareSignals?: string[];
+    }>(),
+    assistantHints: jsonb("assistant_hints").$type<{
+      recommendedWhen?: string[];
+      upsellMessage?: string | null;
+      compareHeadline?: string | null;
+      compareBody?: string | null;
+    }>(),
+    taskTemplateMode: varchar("task_template_mode").notNull().default("standard"),
+    displayOrder: integer("display_order").notNull().default(0),
+    isActive: boolean("is_active").notNull().default(true),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+    updatedAt: timestamp("updated_at").notNull().defaultNow(),
+  },
+  (table) => [
+    index("sales_packages_active_idx").on(table.isActive),
+    index("sales_packages_status_idx").on(table.status),
+    index("sales_packages_display_order_idx").on(table.displayOrder),
+    index("sales_packages_initiative_code_idx").on(table.initiativeCode),
+  ],
+);
+
+export const insertSalesPackageSchema = createInsertSchema(salesPackages).omit({
+  id: true,
+  createdAt: true,
+  updatedAt: true,
+});
+export const updateSalesPackageSchema = insertSalesPackageSchema.partial();
+export type SalesPackage = typeof salesPackages.$inferSelect;
+export type InsertSalesPackage = z.infer<typeof insertSalesPackageSchema>;
+export type UpdateSalesPackage = z.infer<typeof updateSalesPackageSchema>;
+
+export const salesPackageProducts = pgTable(
+  "sales_package_products",
+  {
+    id: uuid("id").primaryKey().defaultRandom(),
+    salesPackageCode: varchar("sales_package_code").notNull(),
+    stribProductId: uuid("strib_product_id")
+      .notNull()
+      .references(() => stribProducts.id, { onDelete: "cascade" }),
+    displayOrder: integer("display_order").notNull().default(0),
+    approvedUnitRate: numeric("approved_unit_rate", { precision: 12, scale: 4 }),
+    approvedRateType: varchar("approved_rate_type"),
+    allocationMode: varchar("allocation_mode").notNull().default("percent"),
+    allocationValue: numeric("allocation_value", { precision: 12, scale: 4 }),
+    required: boolean("required").notNull().default(true),
+    defaultFulfillmentDetails: jsonb("default_fulfillment_details"),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+    updatedAt: timestamp("updated_at").notNull().defaultNow(),
+  },
+  (table) => [
+    uniqueIndex("sales_package_products_unique_idx").on(
+      table.salesPackageCode,
+      table.stribProductId,
+    ),
+    index("sales_package_products_code_idx").on(table.salesPackageCode),
+    index("sales_package_products_product_idx").on(table.stribProductId),
+  ],
+);
+
+export type SalesPackageProduct = typeof salesPackageProducts.$inferSelect;
+
 export const mediaOrders = pgTable(
   "media_orders",
   {
     id: varchar("id")
       .primaryKey()
       .default(sql`gen_random_uuid()`),
-    planId: varchar("plan_id"), // FK → plans.id (nullable — can exist without a plan)
-    engagementId: varchar("engagement_id"), // FK → engagements.id (nullable during transition)
+    planId: varchar("plan_id").references(() => plans.id, {
+      onDelete: "set null",
+    }), // nullable — can exist without a plan
+    engagementId: varchar("engagement_id").references(() => engagements.id, {
+      onDelete: "set null",
+    }), // nullable during transition
     configurationId: varchar("configuration_id"), // FK → plan_configurations.id (named product mix)
     optionId: varchar("option_id"), // FK → plan_options.id (canonical selected option)
-    contractId: uuid("contract_id"), // FK → contracts.id (nullable — links to annual contract)
+    contractId: uuid("contract_id").references(() => contracts.id, {
+      onDelete: "set null",
+    }), // nullable — links to annual contract
     partnerId: varchar("partner_id"),
     hubspotDealId: text("hubspot_deal_id"),
     hubspotCompanyId: text("hubspot_company_id"),
     parentHubspotCompanyId: text("parent_hubspot_company_id"),
+    initiativeCode: varchar("initiative_code"),
+    salesPackageCode: varchar("sales_package_code"),
+    salesPackageSnapshot: jsonb("sales_package_snapshot").$type<Array<{
+      code: string;
+      name: string;
+      packagePrice: number | null;
+      initiativeCode: string | null;
+      componentCount: number;
+      appliedAt: string;
+      packageSource: "direct_package" | "upgrade_from_selection" | "manual_products";
+      compareSignals?: string[];
+      sellerSummary?: string | null;
+      discountPercent?: number | null;
+      addedValueAmount?: number | null;
+      addedValueDescription?: string | null;
+    }>>(),
 
     // Client header
     clientName: text("client_name").notNull(),
@@ -4749,6 +5029,8 @@ export const mediaOrders = pgTable(
     activatedAt: timestamp("activated_at"),
     completedAt: timestamp("completed_at"),
     returnReason: text("return_reason"),
+    amendmentReason: amendmentReasonEnum("amendment_reason"),
+    amendmentNotes: text("amendment_notes"),
     slaHold: boolean("sla_hold").default(false),
     clientTier: text("client_tier"),
 
@@ -4780,9 +5062,6 @@ export const mediaOrders = pgTable(
     // Order-level notes
     orderNotes: text("order_notes"),
 
-    // Sales initiative (links to sales_initiatives table)
-    initiativeCode: varchar("initiative_code"),
-
     // Billing fields
     navigaAdvertiserId: text("naviga_advertiser_id"),
     purchaseOrderNumber: text("purchase_order_number"),
@@ -4839,12 +5118,14 @@ export const mediaOrders = pgTable(
     index("media_orders_engagement_id_idx").on(table.engagementId),
     index("media_orders_partner_id_idx").on(table.partnerId),
     index("media_orders_hubspot_company_id_idx").on(table.hubspotCompanyId),
+    index("media_orders_hubspot_deal_id_idx").on(table.hubspotDealId),
     index("media_orders_status_idx").on(table.status),
     index("media_orders_vendor_id_idx").on(table.vendorId),
     index("media_orders_vendor_fulfillment_status_idx").on(table.vendorFulfillmentStatus),
     index("media_orders_parent_company_idx").on(table.parentHubspotCompanyId),
     index("media_orders_contract_id_idx").on(table.contractId),
     index("media_orders_initiative_code_idx").on(table.initiativeCode),
+    index("media_orders_sales_package_code_idx").on(table.salesPackageCode),
   ]
 );
 
@@ -4973,6 +5254,11 @@ export const mediaOrderLineItems = pgTable(
     // Fulfillment details (product-specific fields for HubSpot sync)
     fulfillmentDetails: jsonb("fulfillment_details"),
     creativeSource: varchar("creative_source"),
+    initiativeCode: varchar("initiative_code"),
+    salesPackageCode: varchar("sales_package_code"),
+    salesPackageComponentRef: varchar("sales_package_component_ref"),
+    isPackageDerived: boolean("is_package_derived").notNull().default(false),
+    packagePricingSource: varchar("package_pricing_source"),
 
     // Ad trafficking reference key (auto-generated naming convention)
     trafficKey: text("traffic_key"),
@@ -4994,9 +5280,12 @@ export const mediaOrderLineItems = pgTable(
   },
   (table) => [
     index("media_order_line_items_section_id_idx").on(table.sectionId),
+    index("media_order_line_items_sync_status_idx").on(table.syncStatus),
     index("idx_line_items_parent").on(table.parentLineItemId),
     index("media_order_line_items_location_id_idx").on(table.locationId),
     index("media_order_line_items_tracking_key_idx").on(table.trackingKey),
+    index("media_order_line_items_initiative_code_idx").on(table.initiativeCode),
+    index("media_order_line_items_sales_package_code_idx").on(table.salesPackageCode),
   ]
 );
 
@@ -5217,6 +5506,30 @@ export const updateStribProductSchema = insertStribProductSchema.partial();
 export type StribProduct = typeof stribProducts.$inferSelect;
 export type InsertStribProduct = z.infer<typeof insertStribProductSchema>;
 
+export const salesInitiativeProducts = pgTable(
+  "sales_initiative_products",
+  {
+    id: uuid("id").primaryKey().defaultRandom(),
+    initiativeCode: varchar("initiative_code").notNull(),
+    stribProductId: uuid("strib_product_id")
+      .notNull()
+      .references(() => stribProducts.id, { onDelete: "cascade" }),
+    displayOrder: integer("display_order").notNull().default(0),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+    updatedAt: timestamp("updated_at").notNull().defaultNow(),
+  },
+  (table) => [
+    uniqueIndex("sales_initiative_products_unique_idx").on(
+      table.initiativeCode,
+      table.stribProductId,
+    ),
+    index("sales_initiative_products_code_idx").on(table.initiativeCode),
+    index("sales_initiative_products_product_idx").on(table.stribProductId),
+  ],
+);
+
+export type SalesInitiativeProduct = typeof salesInitiativeProducts.$inferSelect;
+
 /**
  * strib_product_rates — tier-based pricing per product.
  * Different tiers depending on family: Digital uses open/advocacy/tier_1/tier_2/tier_3;
@@ -5555,6 +5868,7 @@ export const rateExceptionRequests = pgTable(
     escalationHistory: jsonb("escalation_history"), // Array of {level, at, by, reason}
     expiresAt: timestamp("expires_at"),
     approvalScope: varchar("approval_scope").notNull().default("request"), // "request" = affects this exception only; "catalog" = also updates global product rate
+    batchId: uuid("batch_id"), // Groups bulk rate exception requests submitted together
     createdAt: timestamp("created_at").notNull().defaultNow(),
     updatedAt: timestamp("updated_at").notNull().defaultNow(),
   },
@@ -5563,6 +5877,8 @@ export const rateExceptionRequests = pgTable(
     index("rate_exception_status_idx").on(table.status),
     index("rate_exception_requester_idx").on(table.requestedByUserId),
     index("rate_exception_plan_idx").on(table.planId),
+    index("rate_exception_batch_idx").on(table.batchId),
+    index("rate_exception_order_status_idx").on(table.mediaOrderId, table.status),
   ]
 );
 
@@ -5633,6 +5949,41 @@ export const slaConfig = pgTable("sla_config", {
 export type SlaConfig = typeof slaConfig.$inferSelect;
 export type InsertSlaConfig = typeof slaConfig.$inferInsert;
 
+// ─── SLA Snapshots ───────────────────────────────────────────────────────────
+
+/**
+ * sla_snapshots — Point-in-time SLA state from fn-flux evaluations.
+ * Each row captures the hold status, deadline, milestones, and profile
+ * for a given media order + fulfillment ticket pair.
+ */
+export const slaHoldStatusEnum = pgEnum("sla_hold_status", ["clear", "hold", "override"]);
+
+export const slaSnapshots = pgTable(
+  "sla_snapshots",
+  {
+    id: serial("id").primaryKey(),
+    mediaOrderId: text("media_order_id").notNull().references(() => mediaOrders.id),
+    ticketId: text("ticket_id").notNull(),
+    holdStatus: slaHoldStatusEnum("hold_status").notNull().default("clear"),
+    holdReason: text("hold_reason"),
+    slaDays: integer("sla_days").notNull(),
+    availableDays: numeric("available_days"),
+    slaDeadline: timestamp("sla_deadline"),
+    campaignStartDate: date("campaign_start_date"),
+    milestones: jsonb("milestones"),
+    profileName: text("profile_name"),
+    lastUpdatedAt: timestamp("last_updated_at").defaultNow(),
+  },
+  (table) => [
+    index("sla_snapshots_media_order_id_idx").on(table.mediaOrderId),
+    index("sla_snapshots_ticket_id_idx").on(table.ticketId),
+    uniqueIndex("sla_snapshots_order_ticket_uniq").on(table.mediaOrderId, table.ticketId),
+  ]
+);
+
+export type SlaSnapshot = typeof slaSnapshots.$inferSelect;
+export type InsertSlaSnapshot = typeof slaSnapshots.$inferInsert;
+
 // ─── Inventory Sync Audit Trail ─────────────────────────────────────────────
 
 /**
@@ -8157,6 +8508,7 @@ export type InsertSemCampaign = typeof semCampaigns.$inferInsert;
 
 export const compassEventOutboxStatusEnum = pgEnum("compass_event_outbox_status", [
   "pending",
+  "processing",
   "failed",
   "delivered",
   "dead_letter",
@@ -8205,3 +8557,133 @@ export const creativeDeliveries = pgTable("creative_deliveries", {
   assetCount: integer("asset_count").notNull().default(0),
   receivedAt: timestamp("received_at").defaultNow().notNull(),
 });
+
+// ─── Order Activity Feed ────────────────────────────────────────────────────
+
+export const orderActivityFeed = pgTable(
+  "order_activity_feed",
+  {
+    id: uuid("id").primaryKey().defaultRandom(),
+    mediaOrderId: varchar("media_order_id")
+      .notNull()
+      .references(() => mediaOrders.id),
+    lineItemId: varchar("line_item_id").references(() => mediaOrderLineItems.id),
+    eventType: activityEventTypeEnum("event_type").notNull(),
+    title: text("title").notNull(),
+    detail: text("detail"),
+    severity: activitySeverityEnum("severity").notNull(),
+    sourceSystem: activitySourceSystemEnum("source_system").notNull(),
+    externalId: text("external_id").notNull().unique(), // idempotency key — prevents duplicate event ingestion
+    status: text("status"), // intentionally untyped — values vary by eventType (creative vs fulfillment vs contract)
+    occurredAt: timestamp("occurred_at").notNull(),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+    metadata: jsonb("metadata").$type<Record<string, unknown>>(),
+  },
+  (table) => [
+    index("order_activity_feed_order_occurred_idx").on(
+      table.mediaOrderId,
+      table.occurredAt,
+    ),
+    index("order_activity_feed_line_item_idx").on(table.lineItemId),
+  ],
+);
+
+export type OrderActivityFeedEntry = typeof orderActivityFeed.$inferSelect;
+
+// ─── Pending Actions ────────────────────────────────────────────────────────
+
+export const pendingActions = pgTable(
+  "pending_actions",
+  {
+    id: uuid("id").primaryKey().defaultRandom(),
+    mediaOrderId: varchar("media_order_id")
+      .notNull()
+      .references(() => mediaOrders.id),
+    lineItemId: varchar("line_item_id").references(() => mediaOrderLineItems.id),
+    actionType: pendingActionTypeEnum("action_type").notNull(),
+    message: text("message").notNull(),
+    activityFeedId: uuid("activity_feed_id")
+      .notNull()
+      .references(() => orderActivityFeed.id),
+    resolvedAt: timestamp("resolved_at"),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+  },
+  (table) => [
+    index("pending_actions_order_idx").on(table.mediaOrderId),
+    index("pending_actions_line_item_idx").on(table.lineItemId),
+    index("pending_actions_activity_feed_idx").on(table.activityFeedId),
+    index("pending_actions_unresolved_idx").on(table.mediaOrderId).where(
+      sql`resolved_at IS NULL`,
+    ),
+  ],
+);
+
+export type PendingAction = typeof pendingActions.$inferSelect;
+
+// ─── Order Version Snapshots ────────────────────────────────────────────────
+
+export const orderVersionSnapshots = pgTable(
+  "order_version_snapshots",
+  {
+    id: uuid("id").primaryKey().defaultRandom(),
+    mediaOrderId: varchar("media_order_id")
+      .notNull()
+      .references(() => mediaOrders.id),
+    version: integer("version").notNull(),
+    amendmentReason: text("amendment_reason"),
+    amendmentNotes: text("amendment_notes"),
+    amendedBy: varchar("amended_by"),
+    snapshot: jsonb("snapshot").notNull().$type<Record<string, unknown>>(),
+    netInvestment: numeric("net_investment", { precision: 12, scale: 2 }),
+    lineItemCount: integer("line_item_count"),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+  },
+  (table) => [
+    index("order_version_snapshots_order_version_idx").on(
+      table.mediaOrderId,
+      table.version,
+    ),
+  ],
+);
+
+export type OrderVersionSnapshot = typeof orderVersionSnapshots.$inferSelect;
+
+// ─── User Milestones ────────────────────────────────────────────────────────
+
+export const userMilestones = pgTable(
+  "user_milestones",
+  {
+    id: uuid("id").primaryKey().defaultRandom(),
+    userId: varchar("user_id").notNull(),
+    milestoneKey: text("milestone_key").notNull(),
+    shownAt: timestamp("shown_at").notNull().defaultNow(),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+  },
+  (table) => [
+    index("user_milestones_user_id_idx").on(table.userId),
+    unique("user_milestones_user_key_unique").on(table.userId, table.milestoneKey),
+  ],
+);
+
+export type UserMilestone = typeof userMilestones.$inferSelect;
+
+/** Shape of the ad_activity JSONB column in business_intel_cache */
+export interface BusinessIntelAdActivity {
+  google?: { active: boolean; adCount: number; lastSeen?: string };
+  meta?: { active: boolean; adCount: number; lastSeen?: string };
+}
+
+/** Shape of the seo_snapshot JSONB column in business_intel_cache */
+export interface BusinessIntelSeoSnapshot {
+  organicTraffic?: number;
+  topKeywords?: string[];
+  paidTrafficCost?: number;
+}
+
+/** Shape of the tech_signals JSONB column in business_intel_cache */
+export interface BusinessIntelTechSignals {
+  analytics?: string[];
+  advertising?: string[];
+  crm?: string[];
+  social?: string[];
+}