proactive-gate 0.2.3 → 0.2.4

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"
+        ]
+      }
+    }
+  ]
+}

package/spec/fixtures/ordering/kill-switch.json

@@ -0,0 +1,56 @@
+{
+  "spec_version": "1.2.0",
+  "since": "1.0.0",
+  "name": "ordering/kill-switch",
+  "description": "A kill switch that is on stops everything before consent is even read.",
+  "policy": {
+    "specVersion": "1.0.0",
+    "checks": [
+      {
+        "id": "killSwitch",
+        "on": true
+      },
+      {
+        "id": "consent"
+      }
+    ]
+  },
+  "tests": [
+    {
+      "description": "rejected by the switch",
+      "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-04T09:00:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "rejectedBy": "killSwitch",
+        "trace": [
+          "killSwitch"
+        ],
+        "reason_pattern": "kill switch"
+      }
+    }
+  ]
+}

package/spec/fixtures/ordering/short-circuit.json

@@ -0,0 +1,235 @@
+{
+  "spec_version": "1.2.0",
+  "since": "1.0.0",
+  "name": "ordering/short-circuit",
+  "description": "Checks run in policy order and stop at the first rejection.",
+  "policy": {
+    "specVersion": "1.0.0",
+    "checks": [
+      {
+        "id": "killSwitch"
+      },
+      {
+        "id": "consent"
+      },
+      {
+        "id": "enabled"
+      },
+      {
+        "id": "mode",
+        "allow": [
+          "normal"
+        ]
+      },
+      {
+        "id": "snooze"
+      },
+      {
+        "id": "mute"
+      },
+      {
+        "id": "intensity"
+      },
+      {
+        "id": "quietHours",
+        "priorityFloor": "critical"
+      },
+      {
+        "id": "trustRamp"
+      },
+      {
+        "id": "dismissalCooldown"
+      },
+      {
+        "id": "adaptiveTiming"
+      },
+      {
+        "id": "dailyBudget",
+        "limit": 5
+      }
+    ]
+  },
+  "tests": [
+    {
+      "description": "everything passes; the trace lists all twelve",
+      "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-04T09:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "surfaces": [
+          "push",
+          "feed"
+        ],
+        "trace": [
+          "killSwitch",
+          "consent",
+          "enabled",
+          "mode",
+          "snooze",
+          "mute",
+          "intensity",
+          "quietHours",
+          "trustRamp",
+          "dismissalCooldown",
+          "adaptiveTiming",
+          "dailyBudget"
+        ]
+      }
+    },
+    {
+      "description": "consent rejects before quiet hours gets a chance",
+      "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-04T20:30:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "rejectedBy": "consent",
+        "trace": [
+          "killSwitch",
+          "consent"
+        ]
+      }
+    },
+    {
+      "description": "surfaces are the candidate's filtered by the user's",
+      "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",
+          "surfaces": [
+            "feed"
+          ]
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T09:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "surfaces": [
+          "feed"
+        ],
+        "trace": [
+          "killSwitch",
+          "consent",
+          "enabled",
+          "mode",
+          "snooze",
+          "mute",
+          "intensity",
+          "quietHours",
+          "trustRamp",
+          "dismissalCooldown",
+          "adaptiveTiming",
+          "dailyBudget"
+        ]
+      }
+    },
+    {
+      "description": "critical priority passes quiet hours",
+      "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": "critical",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T20:30:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "killSwitch",
+          "consent",
+          "enabled",
+          "mode",
+          "snooze",
+          "mute",
+          "intensity",
+          "quietHours",
+          "trustRamp",
+          "dismissalCooldown",
+          "adaptiveTiming",
+          "dailyBudget"
+        ]
+      }
+    }
+  ]
+}

package/spec/fixtures/policy/unknown-check-is-an-error.json

@@ -0,0 +1,50 @@
+{
+  "spec_version": "1.2.0",
+  "since": "1.0.0",
+  "name": "policy/unknown-check-is-an-error",
+  "description": "The runner never sees this fixture's expectation matter; it documents that compile errors are for the schema, not the runtime. A minimal valid policy passes.",
+  "policy": {
+    "specVersion": "1.0.0",
+    "checks": [
+      {
+        "id": "consent"
+      }
+    ]
+  },
+  "tests": [
+    {
+      "description": "consent only",
+      "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-04T09:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent"
+        ]
+      }
+    }
+  ]
+}