@foundrynorth/flux-schema 1.19.3 → 1.19.5

package/dist/schema.js

@@ -186,6 +186,8 @@ export const fluxUsers = pgTable("flux_users", {
     primaryRole: fluxPrimaryRoleEnum("primary_role").notNull().default("strategist"),
     isAdmin: boolean("is_admin").default(false).notNull(),
     hasSentinelAccess: boolean("has_sentinel_access").notNull().default(false),
+    hasVarsityAccess: boolean("has_varsity_access").notNull().default(false),
+    hasOpinionAccess: boolean("has_opinion_access").notNull().default(false),
     hasDashboardAccess: boolean("has_dashboard_access").notNull().default(true),
     privacyKeywords: jsonb("privacy_keywords").default([]).$type(),
     /** HubSpot owner ID for reverse lookup (Flux user → HubSpot owner) */
@@ -2438,6 +2440,25 @@ export const fluxSemAlertSeverityEnum = pgEnum("flux_sem_alert_severity", [
     "warning",
     "critical",
 ]);
+/**
+ * SEM alert source — where the alert originated.
+ *
+ * - `internal_heuristics` — generated by the fn-flux SEM optimization engine
+ *   (rank drops, pacing deltas, staleness triggers, etc.). Default for every
+ *   row before the source column was added.
+ * - `google_recommendations` — ingested from the Google Ads Recommendations
+ *   API (via the fn-v2 `sem-sync-recommendations` task, gated on Google Ads
+ *   credentials from Q3). Each alert of this kind carries a
+ *   `recommendation_id` that uniquely identifies the Google recommendation
+ *   so repeat ingests are idempotent.
+ *
+ * Add a new value (planned source-system addition) via `ALTER TYPE ... ADD
+ * VALUE` in a follow-up migration — cannot run inside a transaction.
+ */
+export const fluxSemAlertSourceEnum = pgEnum("flux_sem_alert_source", [
+    "internal_heuristics",
+    "google_recommendations",
+]);
 /** SEM ticket complexity for workload sizing on the team board. */
 export const fluxSemComplexityEnum = pgEnum("flux_sem_complexity", [
     "light",
@@ -5727,6 +5748,26 @@ export const fluxSemOptimizationAlerts = pgTable("flux_sem_optimization_alerts",
     alertType: fluxSemAlertTypeEnum("alert_type").notNull(),
     /** Alert severity */
     severity: fluxSemAlertSeverityEnum("severity").notNull(),
+    /**
+     * Source of this alert.
+     *
+     * - `internal_heuristics` — produced by the SEM optimization engine
+     *   (rank changes, pacing deltas, staleness, competitor moves, etc.).
+     * - `google_recommendations` — ingested from the Google Ads
+     *   Recommendations API; paired with `recommendation_id` for idempotency.
+     *
+     * Defaults to `internal_heuristics` so existing rows (all produced by
+     * the heuristic engine) retain accurate provenance after backfill.
+     */
+    source: fluxSemAlertSourceEnum("source").notNull().default("internal_heuristics"),
+    /**
+     * Stable external identifier for this alert's source record, when
+     * applicable. Today only populated by `google_recommendations` alerts
+     * (the Google Ads recommendation resource name / ID). Null for
+     * internal-heuristic alerts. Enables idempotent re-ingest — see the
+     * partial unique index below.
+     */
+    recommendationId: text("recommendation_id"),
     /** Short alert title */
     title: text("title").notNull(),
     /** Detailed description of what was detected */
@@ -5745,6 +5786,15 @@ export const fluxSemOptimizationAlerts = pgTable("flux_sem_optimization_alerts",
 }, (table) => [
     index("flux_sem_alerts_campaign_idx").on(table.semCampaignId),
     index("flux_sem_alerts_unacked_idx").on(table.semCampaignId, table.acknowledged),
+    /**
+     * Idempotency guard for source-system ingest (today: Google Ads
+     * Recommendations API). Scoped with `WHERE recommendation_id IS NOT NULL`
+     * so it doesn't constrain internal-heuristic alerts, which have no
+     * external stable ID.
+     */
+    uniqueIndex("flux_sem_alerts_source_recommendation_uniq")
+        .on(table.semCampaignId, table.source, table.recommendationId)
+        .where(sql `${table.recommendationId} IS NOT NULL`),
 ]);
 /**
  * flux_sem_optimization_log — Proof-of-work optimization entries.