@foundrynorth/compass-schema 1.0.22 → 1.0.24

package/dist/types/activity-feed.d.ts

@@ -3,13 +3,13 @@
  * post-submission visibility (contract alerts, fulfillment status,
  * creative status, amendments, rate exception resolution).
  */
-export declare const ACTIVITY_EVENT_TYPES: readonly ["fulfillment_stage_changed", "creative_status_changed", "creative_delivered", "signing_progress", "drawdown_alert", "renewal_reminder", "amendment_submitted", "rate_exception_resolved", "sla_hold_set", "sla_hold_cleared", "sla_milestone_at_risk", "sla_milestone_breached", "sla_evaluated"];
+export declare const ACTIVITY_EVENT_TYPES: readonly ["fulfillment_stage_changed", "creative_status_changed", "creative_delivered", "signing_progress", "drawdown_alert", "renewal_reminder", "amendment_submitted", "rate_exception_resolved", "sla_hold_set", "sla_hold_cleared", "sla_milestone_at_risk", "sla_milestone_breached", "sla_evaluated", "mid_campaign_change_applied", "mid_campaign_task_state_changed", "mid_campaign_change_verified"];
 export type ActivityEventType = (typeof ACTIVITY_EVENT_TYPES)[number];
 export declare const ACTIVITY_SEVERITIES: readonly ["info", "success", "warning", "action_needed"];
 export type ActivitySeverity = (typeof ACTIVITY_SEVERITIES)[number];
 export declare const ACTIVITY_SOURCE_SYSTEMS: readonly ["flux", "forge", "hubspot", "compass"];
 export type ActivitySourceSystem = (typeof ACTIVITY_SOURCE_SYSTEMS)[number];
-export declare const PENDING_ACTION_TYPES: readonly ["creative_revision_needed", "creative_rejected", "fulfillment_blocked", "rate_exception_pending", "sla_hold_active"];
+export declare const PENDING_ACTION_TYPES: readonly ["creative_revision_needed", "creative_rejected", "fulfillment_blocked", "rate_exception_pending", "sla_hold_active", "mid_campaign_tasks_pending"];
 export type PendingActionType = (typeof PENDING_ACTION_TYPES)[number];
 /** The event envelope fn-flux sends to fn-legacy */
 export interface CompassStatusEvent {

package/dist/types/activity-feed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity-feed.d.ts","sourceRoot":"","sources":["../../src/types/activity-feed.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,oBAAoB,6SAcvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,eAAO,MAAM,mBAAmB,0DAKtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,eAAO,MAAM,uBAAuB,kDAK1B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,eAAO,MAAM,oBAAoB,gIAMvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KAC3C,CAAC;CACH;AAED,mEAAmE;AACnE,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAChD,iBAAiB,EACjB;IAAE,mBAAmB,EAAE,iBAAiB,CAAC;IAAC,kBAAkB,EAAE,MAAM,EAAE,CAAA;CAAE,CAsBzE,CAAC"}
+{"version":3,"file":"activity-feed.d.ts","sourceRoot":"","sources":["../../src/types/activity-feed.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,oBAAoB,+YAiBvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,eAAO,MAAM,mBAAmB,0DAKtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,eAAO,MAAM,uBAAuB,kDAK1B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,eAAO,MAAM,oBAAoB,8JAOvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KAC3C,CAAC;CACH;AAED,mEAAmE;AACnE,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAChD,iBAAiB,EACjB;IAAE,mBAAmB,EAAE,iBAAiB,CAAC;IAAC,kBAAkB,EAAE,MAAM,EAAE,CAAA;CAAE,CA0BzE,CAAC"}

package/dist/types/activity-feed.js

@@ -17,6 +17,9 @@ export const ACTIVITY_EVENT_TYPES = [
     "sla_milestone_at_risk",
     "sla_milestone_breached",
     "sla_evaluated",
+    "mid_campaign_change_applied",
+    "mid_campaign_task_state_changed",
+    "mid_campaign_change_verified",
 ];
 export const ACTIVITY_SEVERITIES = [
     "info",
@@ -36,6 +39,7 @@ export const PENDING_ACTION_TYPES = [
     "fulfillment_blocked",
     "rate_exception_pending",
     "sla_hold_active",
+    "mid_campaign_tasks_pending",
 ];
 /** Resolution mapping: which events clear which pending actions */
 export const PENDING_ACTION_RESOLUTION_MAP = {
@@ -59,5 +63,9 @@ export const PENDING_ACTION_RESOLUTION_MAP = {
         resolvedByEventType: "sla_hold_cleared",
         resolvedByStatuses: ["clear"],
     },
+    mid_campaign_tasks_pending: {
+        resolvedByEventType: "mid_campaign_change_verified",
+        resolvedByStatuses: ["verified"],
+    },
 };
 //# sourceMappingURL=activity-feed.js.map

package/dist/types/activity-feed.js.map

@@ -1 +1 @@
-{"version":3,"file":"activity-feed.js","sourceRoot":"","sources":["../../src/types/activity-feed.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,2BAA2B;IAC3B,yBAAyB;IACzB,oBAAoB;IACpB,kBAAkB;IAClB,gBAAgB;IAChB,kBAAkB;IAClB,qBAAqB;IACrB,yBAAyB;IACzB,cAAc;IACd,kBAAkB;IAClB,uBAAuB;IACvB,wBAAwB;IACxB,eAAe;CACP,CAAC;AAIX,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,MAAM;IACN,SAAS;IACT,SAAS;IACT,eAAe;CACP,CAAC;AAIX,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM;IACN,OAAO;IACP,SAAS;IACT,SAAS;CACD,CAAC;AAIX,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,0BAA0B;IAC1B,mBAAmB;IACnB,qBAAqB;IACrB,wBAAwB;IACxB,iBAAiB;CACT,CAAC;AAuBX,mEAAmE;AACnE,MAAM,CAAC,MAAM,6BAA6B,GAGtC;IACF,wBAAwB,EAAE;QACxB,mBAAmB,EAAE,yBAAyB;QAC9C,kBAAkB,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;KAC9C;IACD,iBAAiB,EAAE;QACjB,mBAAmB,EAAE,yBAAyB;QAC9C,kBAAkB,EAAE,CAAC,UAAU,CAAC;KACjC;IACD,mBAAmB,EAAE;QACnB,mBAAmB,EAAE,2BAA2B;QAChD,kBAAkB,EAAE,CAAC,qBAAqB,EAAE,SAAS,EAAE,WAAW,CAAC;KACpE;IACD,sBAAsB,EAAE;QACtB,mBAAmB,EAAE,yBAAyB;QAC9C,kBAAkB,EAAE,CAAC,UAAU,EAAE,eAAe,EAAE,UAAU,CAAC;KAC9D;IACD,eAAe,EAAE;QACf,mBAAmB,EAAE,kBAAkB;QACvC,kBAAkB,EAAE,CAAC,OAAO,CAAC;KAC9B;CACF,CAAC"}
+{"version":3,"file":"activity-feed.js","sourceRoot":"","sources":["../../src/types/activity-feed.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,2BAA2B;IAC3B,yBAAyB;IACzB,oBAAoB;IACpB,kBAAkB;IAClB,gBAAgB;IAChB,kBAAkB;IAClB,qBAAqB;IACrB,yBAAyB;IACzB,cAAc;IACd,kBAAkB;IAClB,uBAAuB;IACvB,wBAAwB;IACxB,eAAe;IACf,6BAA6B;IAC7B,iCAAiC;IACjC,8BAA8B;CACtB,CAAC;AAIX,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,MAAM;IACN,SAAS;IACT,SAAS;IACT,eAAe;CACP,CAAC;AAIX,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM;IACN,OAAO;IACP,SAAS;IACT,SAAS;CACD,CAAC;AAIX,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,0BAA0B;IAC1B,mBAAmB;IACnB,qBAAqB;IACrB,wBAAwB;IACxB,iBAAiB;IACjB,4BAA4B;CACpB,CAAC;AAuBX,mEAAmE;AACnE,MAAM,CAAC,MAAM,6BAA6B,GAGtC;IACF,wBAAwB,EAAE;QACxB,mBAAmB,EAAE,yBAAyB;QAC9C,kBAAkB,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;KAC9C;IACD,iBAAiB,EAAE;QACjB,mBAAmB,EAAE,yBAAyB;QAC9C,kBAAkB,EAAE,CAAC,UAAU,CAAC;KACjC;IACD,mBAAmB,EAAE;QACnB,mBAAmB,EAAE,2BAA2B;QAChD,kBAAkB,EAAE,CAAC,qBAAqB,EAAE,SAAS,EAAE,WAAW,CAAC;KACpE;IACD,sBAAsB,EAAE;QACtB,mBAAmB,EAAE,yBAAyB;QAC9C,kBAAkB,EAAE,CAAC,UAAU,EAAE,eAAe,EAAE,UAAU,CAAC;KAC9D;IACD,eAAe,EAAE;QACf,mBAAmB,EAAE,kBAAkB;QACvC,kBAAkB,EAAE,CAAC,OAAO,CAAC;KAC9B;IACD,0BAA0B,EAAE;QAC1B,mBAAmB,EAAE,8BAA8B;QACnD,kBAAkB,EAAE,CAAC,UAAU,CAAC;KACjC;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foundrynorth/compass-schema",
-  "version": "1.0.22",
+  "version": "1.0.24",
   "description": "Canonical Drizzle ORM schema for Foundry Compass (rough-waterfall database)",
   "type": "module",
   "main": "dist/index.js",

package/src/schema.ts

@@ -8503,7 +8503,15 @@ export type SemCampaignRecord = typeof semCampaigns.$inferSelect;
 export type InsertSemCampaign = typeof semCampaigns.$inferInsert;
 
 // =============================================================================
-// COMPASS EVENT OUTBOX (dead-letter queue for fn-flux webhook events)
+// COMPASS EVENT OUTBOX (durable outbox for cross-system writes)
+//
+// Generic claim/retry/DLQ pattern used by multiple producers. Events are
+// namespaced by `eventType` prefix so multiple workers can drain the same
+// table without contention:
+//   • "flux.*"         — fn-flux webhook delivery to external consumers
+//   • "hubspot.*"      — HubSpot ticket / Campaign Task writes from fn-legacy
+//                        (drained by fn-v2 hubspot-outbox-worker)
+// Workers filter on `event_type LIKE '{namespace}.%'` in their claim query.
 // =============================================================================
 
 export const compassEventOutboxStatusEnum = pgEnum("compass_event_outbox_status", [
@@ -8667,6 +8675,236 @@ export const userMilestones = pgTable(
 
 export type UserMilestone = typeof userMilestones.$inferSelect;
 
+// ─── Mid-Campaign Change Management ────────────────────────────────────────
+//
+// Finance-grade in-place edits to live media orders. Distinct from
+// AmendOrderWizard (which takes orders active→draft→sent). A mid-campaign
+// change keeps the order `active`, touches a surgical set of line items,
+// and routes through the existing rate-exception-engine if it would alter
+// rate rules or margin. HubSpot push is the canonical output — HubSpot's
+// own workflow pushes deltas to Naviga.
+//
+// State machine:
+//   draft → (rate violation?) ─┬─ pending_rate_approval ─┬─ applied → hubspot_syncing → hubspot_synced
+//                              │                          └─ rejected (terminal, line items rolled back)
+//                              └─ applied → hubspot_syncing ─┬─ hubspot_synced
+//                                                              └─ hubspot_failed (retryable)
+
+export const midCampaignChangeRequests = pgTable(
+  "mid_campaign_change_requests",
+  {
+    id: uuid("id").primaryKey().defaultRandom(),
+    mediaOrderId: varchar("media_order_id")
+      .notNull()
+      .references(() => mediaOrders.id),
+    reason: amendmentReasonEnum("reason").notNull(),
+    notes: text("notes").notNull(),
+    requestedByUserId: varchar("requested_by_user_id").notNull(),
+    requestedByEmail: varchar("requested_by_email"),
+    requestedByName: varchar("requested_by_name"),
+    requestedAt: timestamp("requested_at").notNull().defaultNow(),
+    appliedAt: timestamp("applied_at"),
+    status: varchar("status").notNull().default("draft"),
+    // draft | pending_rate_approval | applied | rejected | hubspot_syncing | hubspot_synced | hubspot_failed | verified
+    // `verified` is terminal — set when taskStateJson.allComplete && hubspotTicketStage is terminal.
+
+    // Denormalized summary (so finance reports never join into ops)
+    totalInvestmentDelta: numeric("total_investment_delta", { precision: 12, scale: 2 }).notNull().default("0"),
+    affectedLineItemCount: integer("affected_line_item_count").notNull().default(0),
+    marginDeltaPercent: numeric("margin_delta_percent", { precision: 7, scale: 4 }),
+    marginDeltaDollars: numeric("margin_delta_dollars", { precision: 12, scale: 2 }),
+
+    // Approval state (nullable — only set when rate engine returned pending_approval for any op)
+    rateApprovalCompletedAt: timestamp("rate_approval_completed_at"),
+    rejectionReason: text("rejection_reason"),
+
+    // HubSpot ticket (fulfillment pipeline, CHANGE_REQUIRED stage)
+    hubspotTicketId: text("hubspot_ticket_id"),
+    hubspotCampaignTaskIds: jsonb("hubspot_campaign_task_ids").$type<string[]>().default(sql`'[]'::jsonb`),
+
+    // HubSpot line-item sync (via fn-v2 hubspot-order-sync)
+    hubspotSyncRunId: text("hubspot_sync_run_id"),
+    hubspotSyncStartedAt: timestamp("hubspot_sync_started_at"),
+    hubspotSyncCompletedAt: timestamp("hubspot_sync_completed_at"),
+    hubspotSyncError: text("hubspot_sync_error"),
+
+    // Closed-loop projection from HubSpot Campaign Task webhooks
+    // (updated by handleCampaignTaskChange in hubspot-mid-campaign-writeback.ts)
+    hubspotTicketStage: varchar("hubspot_ticket_stage", { length: 40 }),
+    // Current ticket stage as seen in the most recent webhook delivery.
+    // Values: CHANGE_REQUIRED | BILLING_CHANGE_REQUIRED | CANCELLED | COMPLETED | etc.
+    taskStateJson: jsonb("task_state_json").$type<{
+      tasks: Array<{
+        hubspotTaskId: string;
+        templateId: string;
+        queue: string;
+        status: "not_started" | "in_progress" | "completed" | "waiting" | "blocked";
+        completedAt: string | null;
+        ownerId: string | null;
+        ownerName: string | null;
+      }>;
+      completedCount: number;
+      totalCount: number;
+      allComplete: boolean;
+    }>(),
+    taskStateUpdatedAt: timestamp("task_state_updated_at"),
+    verifiedAt: timestamp("verified_at"),
+
+    // Slack alert (thread follow-up replies on approval/sync completion)
+    slackMessageTs: text("slack_message_ts"),
+    slackChannelId: text("slack_channel_id"),
+
+    // Snapshot for rollback on rate-exception rejection
+    rollbackSnapshotVersion: integer("rollback_snapshot_version"),
+
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+    updatedAt: timestamp("updated_at").notNull().defaultNow(),
+  },
+  (table) => [
+    index("mcc_requests_order_idx").on(table.mediaOrderId),
+    index("mcc_requests_status_idx").on(table.status),
+    index("mcc_requests_requested_at_idx").on(table.requestedAt),
+    index("mcc_requests_order_status_idx").on(table.mediaOrderId, table.status),
+  ],
+);
+
+export type MidCampaignChangeRequest = typeof midCampaignChangeRequests.$inferSelect;
+export type InsertMidCampaignChangeRequest = typeof midCampaignChangeRequests.$inferInsert;
+
+/**
+ * One row per line-item operation inside a change request. This is the
+ * finance report source — one row per field changed per line item.
+ */
+export const midCampaignChangeOps = pgTable(
+  "mid_campaign_change_ops",
+  {
+    id: uuid("id").primaryKey().defaultRandom(),
+    changeRequestId: uuid("change_request_id")
+      .notNull()
+      .references(() => midCampaignChangeRequests.id, { onDelete: "cascade" }),
+    opType: varchar("op_type").notNull(), // update | cancel | create
+    lineItemId: varchar("line_item_id")
+      .notNull()
+      .references(() => mediaOrderLineItems.id),
+    // For cancel+create pairs (date-shift across month boundary, product swap)
+    supersedesLineItemId: varchar("supersedes_line_item_id").references(() => mediaOrderLineItems.id),
+
+    // Denormalized for reporting (so the report query is one table scan)
+    periodLabel: text("period_label"),        // "Aug 2026"
+    productCode: text("product_code"),
+    productName: text("product_name"),
+    placement: text("placement"),
+
+    // The per-field diff — this is the atom finance sees
+    fieldChanges: jsonb("field_changes")
+      .notNull()
+      .$type<Array<{ field: string; from: string | number | null; to: string | number | null }>>(),
+
+    // Per-op investment delta (sums to totalInvestmentDelta on the request)
+    investmentDelta: numeric("investment_delta", { precision: 12, scale: 2 }).notNull().default("0"),
+
+    // Tracks which HubSpot action this op triggered when synced
+    hubspotOp: varchar("hubspot_op"), // update | cancel | create | skipped
+    hubspotLineItemIdBefore: text("hubspot_line_item_id_before"),
+    hubspotLineItemIdAfter: text("hubspot_line_item_id_after"),
+
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+  },
+  (table) => [
+    index("mcc_ops_change_request_idx").on(table.changeRequestId),
+    index("mcc_ops_line_item_idx").on(table.lineItemId),
+    index("mcc_ops_period_idx").on(table.periodLabel),
+    uniqueIndex("mcc_ops_change_request_line_item_unique").on(
+      table.changeRequestId,
+      table.lineItemId,
+    ),
+  ],
+);
+
+export type MidCampaignChangeOp = typeof midCampaignChangeOps.$inferSelect;
+export type InsertMidCampaignChangeOp = typeof midCampaignChangeOps.$inferInsert;
+
+/**
+ * Join table: change requests ↔ rate exception requests. A single change
+ * request may trigger N rate exceptions (one per line item that violates
+ * rate rules). The change request blocks in `pending_rate_approval` until
+ * every linked exception is decided; if any reject, the change rolls back.
+ */
+export const midCampaignChangeRateExceptions = pgTable(
+  "mid_campaign_change_rate_exceptions",
+  {
+    id: uuid("id").primaryKey().defaultRandom(),
+    changeRequestId: uuid("change_request_id")
+      .notNull()
+      .references(() => midCampaignChangeRequests.id, { onDelete: "cascade" }),
+    rateExceptionRequestId: uuid("rate_exception_request_id")
+      .notNull()
+      .references(() => rateExceptionRequests.id, { onDelete: "restrict" }),
+    // Which op on the change request this exception corresponds to
+    changeOpId: uuid("change_op_id").references(() => midCampaignChangeOps.id, { onDelete: "cascade" }),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+  },
+  (table) => [
+    index("mcc_rate_exc_change_request_idx").on(table.changeRequestId),
+    index("mcc_rate_exc_exception_idx").on(table.rateExceptionRequestId),
+    uniqueIndex("mcc_rate_exc_change_request_exception_unique").on(
+      table.changeRequestId,
+      table.rateExceptionRequestId,
+    ),
+  ],
+);
+
+export type MidCampaignChangeRateException = typeof midCampaignChangeRateExceptions.$inferSelect;
+export type InsertMidCampaignChangeRateException = typeof midCampaignChangeRateExceptions.$inferInsert;
+
+/**
+ * Campaign Task templates for mid-campaign changes. Hybrid storage — config
+ * in DB (queue, offset, priority, is_active, display_order) so admins can
+ * hot-edit without deploys; predicate logic stays in a code registry
+ * (mid-campaign-template-predicates.ts) keyed by `predicateKey`.
+ *
+ * CI validator asserts every row's `queue` value is in the live HubSpot
+ * Campaign Task `queue` enum. Prevents the "wrong queue ships to HubSpot and
+ * silently fails enum validation" bug.
+ */
+export const midCampaignTaskTemplates = pgTable(
+  "mid_campaign_task_templates",
+  {
+    // Stable key (e.g. "review_change_request", "verify_billing_impact").
+    // Used as the templateId in the task plan and for deduplication.
+    id: varchar("id", { length: 64 }).primaryKey(),
+    // Human-readable name — sent as campaign_task_name to HubSpot.
+    name: text("name").notNull(),
+    // Portal Campaign Task queue enum value. CI validator enforces.
+    queue: varchar("queue", { length: 40 }).notNull(),
+    // Days from applied-at when the task is due. Negative = before apply.
+    offsetDays: integer("offset_days").notNull().default(0),
+    // Written to HubSpot priority: high | medium | low.
+    priority: varchar("priority", { length: 16 }).notNull().default("medium"),
+    // Key into the PREDICATES registry in code. Must resolve at runtime.
+    // Valid: always, has_financial_change, has_digital_update_or_cancel,
+    //   has_digital_create, has_print_change, touches_dates
+    predicateKey: varchar("predicate_key", { length: 64 }).notNull(),
+    // Inactive templates are skipped by buildMidCampaignChangeTaskPlan.
+    isActive: boolean("is_active").notNull().default(true),
+    // Display/evaluation order. Lower = higher up in the Compass task list.
+    displayOrder: integer("display_order").notNull().default(0),
+    // Optional human description for the admin UI.
+    description: text("description"),
+    // Audit — who last edited and when.
+    updatedAt: timestamp("updated_at").notNull().defaultNow(),
+    updatedBy: varchar("updated_by"),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+  },
+  (table) => [
+    index("mid_campaign_task_templates_active_idx").on(table.isActive),
+    index("mid_campaign_task_templates_order_idx").on(table.displayOrder),
+  ],
+);
+
+export type MidCampaignTaskTemplate = typeof midCampaignTaskTemplates.$inferSelect;
+export type InsertMidCampaignTaskTemplate = typeof midCampaignTaskTemplates.$inferInsert;
+
 /** Shape of the ad_activity JSONB column in business_intel_cache */
 export interface BusinessIntelAdActivity {
   google?: { active: boolean; adCount: number; lastSeen?: string };

package/src/types/activity-feed.ts

@@ -18,6 +18,9 @@ export const ACTIVITY_EVENT_TYPES = [
   "sla_milestone_at_risk",
   "sla_milestone_breached",
   "sla_evaluated",
+  "mid_campaign_change_applied",
+  "mid_campaign_task_state_changed",
+  "mid_campaign_change_verified",
 ] as const;
 
 export type ActivityEventType = (typeof ACTIVITY_EVENT_TYPES)[number];
@@ -46,6 +49,7 @@ export const PENDING_ACTION_TYPES = [
   "fulfillment_blocked",
   "rate_exception_pending",
   "sla_hold_active",
+  "mid_campaign_tasks_pending",
 ] as const;
 
 export type PendingActionType = (typeof PENDING_ACTION_TYPES)[number];
@@ -94,4 +98,8 @@ export const PENDING_ACTION_RESOLUTION_MAP: Record<
     resolvedByEventType: "sla_hold_cleared",
     resolvedByStatuses: ["clear"],
   },
+  mid_campaign_tasks_pending: {
+    resolvedByEventType: "mid_campaign_change_verified",
+    resolvedByStatuses: ["verified"],
+  },
 };