proactive-gate 0.2.2 → 0.2.4

package/spec/fixtures/consent/required.json

@@ -0,0 +1,116 @@
+{
+  "spec_version": "1.2.0",
+  "since": "1.0.0",
+  "name": "consent/required",
+  "description": "Consent is the first thing about the person that is checked.",
+  "policy": {
+    "specVersion": "1.0.0",
+    "checks": [
+      {
+        "id": "consent"
+      },
+      {
+        "id": "enabled"
+      }
+    ]
+  },
+  "tests": [
+    {
+      "description": "no consent",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": false,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Europe/Istanbul",
+          "quietHours": {
+            "start": "22:00",
+            "end": "08:00"
+          },
+          "createdAt": "2026-01-01T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T09:00:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "rejectedBy": "consent",
+        "trace": [
+          "consent"
+        ]
+      }
+    },
+    {
+      "description": "consent given, disabled profile",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": false,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Europe/Istanbul",
+          "quietHours": {
+            "start": "22:00",
+            "end": "08:00"
+          },
+          "createdAt": "2026-01-01T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T09:00:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "rejectedBy": "enabled",
+        "trace": [
+          "consent",
+          "enabled"
+        ]
+      }
+    },
+    {
+      "description": "consent given, undefined proactiveEnabled defaults to on",
+      "input": {
+        "user": {
+          "id": "u2",
+          "consent": true
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T09:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent",
+          "enabled"
+        ]
+      }
+    }
+  ]
+}

package/spec/fixtures/cooldown/three-dismissals.json

@@ -0,0 +1,132 @@
+{
+  "spec_version": "1.2.0",
+  "since": "1.0.0",
+  "name": "cooldown/three-dismissals",
+  "description": "Three dismissals of a type within 30 days silence it for 7 days from the latest.",
+  "policy": {
+    "specVersion": "1.0.0",
+    "checks": [
+      {
+        "id": "consent"
+      },
+      {
+        "id": "dismissalCooldown",
+        "dismissals": 3,
+        "withinDays": 30,
+        "silenceDays": 7
+      }
+    ]
+  },
+  "store_seed": {
+    "cooldown:u1:reminder": "[1788264000000, 1788436800000, 1788523200000]"
+  },
+  "tests": [
+    {
+      "description": "silent one day after the third dismissal",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Europe/Istanbul",
+          "quietHours": {
+            "start": "22:00",
+            "end": "08:00"
+          },
+          "createdAt": "2026-01-01T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-05T12:00:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "rejectedBy": "dismissalCooldown",
+        "trace": [
+          "consent",
+          "dismissalCooldown"
+        ],
+        "reason_pattern": "3 dismissals"
+      }
+    },
+    {
+      "description": "another type is unaffected",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Europe/Istanbul",
+          "quietHours": {
+            "start": "22:00",
+            "end": "08:00"
+          },
+          "createdAt": "2026-01-01T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "insight",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-05T12:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent",
+          "dismissalCooldown"
+        ]
+      }
+    },
+    {
+      "description": "eight days after the third dismissal it speaks again",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Europe/Istanbul",
+          "quietHours": {
+            "start": "22:00",
+            "end": "08:00"
+          },
+          "createdAt": "2026-01-01T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-13T00:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent",
+          "dismissalCooldown"
+        ]
+      }
+    }
+  ]
+}

package/spec/fixtures/dedupe/already-delivered.json

@@ -0,0 +1,87 @@
+{
+  "spec_version": "1.2.0",
+  "since": "1.2.0",
+  "name": "dedupe/already-delivered",
+  "description": "A key claimed inside the window rejects the second attempt at the same event.",
+  "policy": {
+    "specVersion": "1.0.0",
+    "checks": [
+      {
+        "id": "consent"
+      },
+      {
+        "id": "dedupe",
+        "windowSeconds": 3600
+      }
+    ]
+  },
+  "store_seed": {
+    "dedupe:u1:order-42-shipped": "1"
+  },
+  "tests": [
+    {
+      "description": "the same event arriving again is refused",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Europe/Istanbul",
+          "createdAt": "2026-01-01T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c2",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push"
+          ],
+          "dedupeKey": "order-42-shipped"
+        },
+        "now": "2026-09-05T12:00:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "rejectedBy": "dedupe",
+        "trace": [
+          "consent",
+          "dedupe"
+        ],
+        "reason_pattern": "already delivered"
+      }
+    },
+    {
+      "description": "a different event on the same user is unaffected",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Europe/Istanbul",
+          "createdAt": "2026-01-01T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c3",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push"
+          ],
+          "dedupeKey": "order-43-shipped"
+        },
+        "now": "2026-09-05T12:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent",
+          "dedupe"
+        ]
+      }
+    }
+  ]
+}

package/spec/fixtures/dedupe/no-key-skips.json

@@ -0,0 +1,49 @@
+{
+  "spec_version": "1.2.0",
+  "since": "1.2.0",
+  "name": "dedupe/no-key-skips",
+  "description": "With no dedupeKey on the candidate the check skips rather than guessing an identity.",
+  "policy": {
+    "specVersion": "1.0.0",
+    "checks": [
+      {
+        "id": "consent"
+      },
+      {
+        "id": "dedupe"
+      }
+    ]
+  },
+  "tests": [
+    {
+      "description": "a candidate with no dedupeKey is delivered; the check stands aside in the trace",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Europe/Istanbul",
+          "createdAt": "2026-01-01T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push"
+          ]
+        },
+        "now": "2026-09-05T12:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent",
+          "dedupe"
+        ]
+      }
+    }
+  ]
+}

package/spec/fixtures/defer/snooze-as-defer.json

@@ -0,0 +1,138 @@
+{
+  "spec_version": "1.2.0",
+  "since": "1.0.0",
+  "name": "defer/snooze-as-defer",
+  "description": "snooze with defer true produces a deferred decision with retryAt.",
+  "policy": {
+    "specVersion": "1.0.0",
+    "checks": [
+      {
+        "id": "consent"
+      },
+      {
+        "id": "snooze",
+        "defer": true
+      },
+      {
+        "id": "dailyBudget"
+      }
+    ]
+  },
+  "tests": [
+    {
+      "description": "snoozed: deferred until the snooze ends",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Europe/Istanbul",
+          "quietHours": {
+            "start": "22:00",
+            "end": "08:00"
+          },
+          "createdAt": "2026-01-01T00:00:00Z",
+          "snoozedUntil": "2026-09-04T10:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T09:00:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "deferredBy": "snooze",
+        "retryAt": "2026-09-04T10:00:00.000Z",
+        "trace": [
+          "consent",
+          "snooze"
+        ]
+      }
+    },
+    {
+      "description": "snooze in the past: passes",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Europe/Istanbul",
+          "quietHours": {
+            "start": "22:00",
+            "end": "08:00"
+          },
+          "createdAt": "2026-01-01T00:00:00Z",
+          "snoozedUntil": "2026-09-04T08:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T09:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent",
+          "snooze",
+          "dailyBudget"
+        ]
+      }
+    },
+    {
+      "description": "a deferred decision cannot be committed",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Europe/Istanbul",
+          "quietHours": {
+            "start": "22:00",
+            "end": "08:00"
+          },
+          "createdAt": "2026-01-01T00:00:00Z",
+          "snoozedUntil": "2026-09-04T10:00:00Z"
+        },
+        "candidate": {
+          "id": "c2",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T09:00:00Z"
+      },
+      "commit": true,
+      "expect": {
+        "allowed": false,
+        "deferredBy": "snooze",
+        "retryAt": "2026-09-04T10:00:00.000Z",
+        "trace": [
+          "consent",
+          "snooze"
+        ],
+        "commit": false
+      }
+    }
+  ]
+}

package/spec/fixtures/mode/allow-list.json

@@ -0,0 +1,139 @@
+{
+  "spec_version": "1.2.0",
+  "since": "1.0.0",
+  "name": "mode/allow-list",
+  "description": "Only listed operating modes receive proactive messages; an undefined mode passes.",
+  "policy": {
+    "specVersion": "1.0.0",
+    "checks": [
+      {
+        "id": "consent"
+      },
+      {
+        "id": "mode",
+        "allow": [
+          "normal",
+          "commute"
+        ]
+      },
+      {
+        "id": "mute"
+      }
+    ]
+  },
+  "tests": [
+    {
+      "description": "focus mode rejects",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "focus",
+          "intensity": "normal",
+          "timezone": "Europe/Istanbul",
+          "quietHours": {
+            "start": "22:00",
+            "end": "08:00"
+          },
+          "createdAt": "2026-01-01T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T09:00:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "rejectedBy": "mode",
+        "trace": [
+          "consent",
+          "mode"
+        ],
+        "reason_pattern": "focus"
+      }
+    },
+    {
+      "description": "commute passes",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "commute",
+          "intensity": "normal",
+          "timezone": "Europe/Istanbul",
+          "quietHours": {
+            "start": "22:00",
+            "end": "08:00"
+          },
+          "createdAt": "2026-01-01T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T09:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent",
+          "mode",
+          "mute"
+        ]
+      }
+    },
+    {
+      "description": "muted type rejects",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Europe/Istanbul",
+          "quietHours": {
+            "start": "22:00",
+            "end": "08:00"
+          },
+          "createdAt": "2026-01-01T00:00:00Z",
+          "mutedTypes": [
+            "reminder"
+          ]
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T09:00:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "rejectedBy": "mute",
+        "trace": [
+          "consent",
+          "mode",
+          "mute"
+        ]
+      }
+    }
+  ]
+}