proactive-gate 0.4.1 → 0.6.0

package/spec/fixtures/budget/bypass-priority.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "budget/bypass-priority",
   "description": "A bypass priority passes the budget without reading or consuming it.",

package/spec/fixtures/budget/daily-atomic-commit.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "budget/daily-atomic-commit",
   "description": "evaluate reads the counter, commit consumes it, the extra commit is refused.",

package/spec/fixtures/budget/near-limit.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "budget/near-limit",
   "description": "A pass close to the limit carries nearLimit.",

package/spec/fixtures/budget/race-second-commit-loses.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "budget/race-second-commit-loses",
   "description": "Two evaluations before either commit: only the first commit wins.",

package/spec/fixtures/budget/weekly-iso-week.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "budget/weekly-iso-week",
   "description": "The weekly counter is keyed on the local ISO week.",

package/spec/fixtures/consent/required.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "consent/required",
   "description": "Consent is the first thing about the person that is checked.",

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

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.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.",

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

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.2.0",
   "name": "dedupe/already-delivered",
   "description": "A key claimed inside the window rejects the second attempt at the same event.",

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

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.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.",

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

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "defer/snooze-as-defer",
   "description": "snooze with defer true produces a deferred decision with retryAt.",

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

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "mode/allow-list",
   "description": "Only listed operating modes receive proactive messages; an undefined mode passes.",

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

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "ordering/kill-switch",
   "description": "A kill switch that is on stops everything before consent is even read.",

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

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "ordering/short-circuit",
   "description": "Checks run in policy order and stop at the first rejection.",

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

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.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.",

package/spec/fixtures/presets/cn-minor-mode.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "presets/cn-minor-mode",
   "description": "cnMinorMode restricts minors to 06:00 to 22:00 China time and one message a day; adults pass.",

package/spec/fixtures/presets/in-tcccp.json

@@ -0,0 +1,258 @@
+{
+  "spec_version": "1.3.0",
+  "since": "1.3.0",
+  "name": "presets/in-tcccp",
+  "description": "inTcccp needs promotional consent always, and each Schedule-II default-off band passes only when the subscriber opted that band in.",
+  "policy": {
+    "specVersion": "1.0.0",
+    "checks": [
+      {
+        "preset": "inTcccp"
+      }
+    ]
+  },
+  "tests": [
+    {
+      "description": "no promotional consent",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Asia/Kolkata",
+          "quietHours": {
+            "start": "22:00",
+            "end": "08:00"
+          },
+          "createdAt": "2026-01-01T00:00:00Z",
+          "consents": {}
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T06:30:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "rejectedBy": "consent:promotional",
+        "trace": [
+          "consent:promotional"
+        ]
+      }
+    },
+    {
+      "description": "promotional consent at 12:00 IST passes",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Asia/Kolkata",
+          "quietHours": {
+            "start": "22:00",
+            "end": "08:00"
+          },
+          "createdAt": "2026-01-01T00:00:00Z",
+          "consents": {
+            "promotional": true
+          }
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T06:30:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent:promotional",
+          "consent:band00to06",
+          "consent:band06to08",
+          "consent:band08to10",
+          "consent:band21to24"
+        ]
+      }
+    },
+    {
+      "description": "22:30 IST without the band ix opt-in rejects",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Asia/Kolkata",
+          "quietHours": {
+            "start": "22:00",
+            "end": "08:00"
+          },
+          "createdAt": "2026-01-01T00:00:00Z",
+          "consents": {
+            "promotional": true
+          }
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T17:00:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "rejectedBy": "consent:band21to24",
+        "trace": [
+          "consent:promotional",
+          "consent:band00to06",
+          "consent:band06to08",
+          "consent:band08to10",
+          "consent:band21to24"
+        ]
+      }
+    },
+    {
+      "description": "22:30 IST with the band ix opt-in passes",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Asia/Kolkata",
+          "quietHours": {
+            "start": "22:00",
+            "end": "08:00"
+          },
+          "createdAt": "2026-01-01T00:00:00Z",
+          "consents": {
+            "promotional": true,
+            "band21to24": true
+          }
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T17:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent:promotional",
+          "consent:band00to06",
+          "consent:band06to08",
+          "consent:band08to10",
+          "consent:band21to24"
+        ]
+      }
+    },
+    {
+      "description": "04:00 IST rejects when only band 06:00 to 08:00 was opted in",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Asia/Kolkata",
+          "quietHours": {
+            "start": "22:00",
+            "end": "08:00"
+          },
+          "createdAt": "2026-01-01T00:00:00Z",
+          "consents": {
+            "promotional": true,
+            "band06to08": true
+          }
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T22:30:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "rejectedBy": "consent:band00to06",
+        "trace": [
+          "consent:promotional",
+          "consent:band00to06"
+        ]
+      }
+    },
+    {
+      "description": "09:00 IST without the band iii opt-in rejects",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Asia/Kolkata",
+          "quietHours": {
+            "start": "22:00",
+            "end": "08:00"
+          },
+          "createdAt": "2026-01-01T00:00:00Z",
+          "consents": {
+            "promotional": true
+          }
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T03:30:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "rejectedBy": "consent:band08to10",
+        "trace": [
+          "consent:promotional",
+          "consent:band00to06",
+          "consent:band06to08",
+          "consent:band08to10"
+        ]
+      }
+    }
+  ]
+}

package/spec/fixtures/presets/kakao-brand-message.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "presets/kakao-brand-message",
   "description": "kakaoBrandMessage runs 08:00 to 20:50 Korea time regardless of the recipient's zone.",

package/spec/fixtures/presets/kr-network-act-50.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "presets/kr-network-act-50",
   "description": "krNetworkAct50 needs ad consent always and night consent 21:00 to 08:00.",

package/spec/fixtures/presets/telegram-bot.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "presets/telegram-bot",
   "description": "telegramBot limits one message a second and twenty a minute per channel.",

package/spec/fixtures/presets/us-tcpa.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "presets/us-tcpa",
   "description": "usTcpa allows 08:00 to 21:00 in the user's zone.",

package/spec/fixtures/quiet-hours/apia.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "quiet-hours/apia",
   "description": "Pacific/Apia is UTC+13; 10:00Z is 23:00 local.",

package/spec/fixtures/quiet-hours/caller-supplied-dates.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.1.0",
   "name": "quiet-hours/caller-supplied-dates",
   "description": "A calendar date the caller supplies beats the weekday and the default, in both directions. There is no bundled holiday calendar.",

package/spec/fixtures/quiet-hours/crosses-midnight-by-day.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.1.0",
   "name": "quiet-hours/crosses-midnight-by-day",
   "description": "A window belongs to the day it opens on, so Friday 18:00 to 02:00 silences Saturday morning. Saturday has no window of its own, so the carry is the only thing that can explain the silence.",

package/spec/fixtures/quiet-hours/dst-new-york.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "quiet-hours/dst-new-york",
   "description": "On 2026-03-08 New York springs forward at 02:00; 06:30Z is 01:30 EST, 07:30Z is 03:30 EDT.",

package/spec/fixtures/quiet-hours/istanbul.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "quiet-hours/istanbul",
   "description": "Quiet hours cross midnight in the user's zone; the priority floor bypasses them.",

package/spec/fixtures/quiet-hours/wall-clock.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "quiet-hours/wall-clock",
   "description": "now is in 2031; the outcome only holds when the implementation used the supplied instant, not the wall clock.",

package/spec/fixtures/quiet-hours/weekday-schedule.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.1.0",
   "name": "quiet-hours/weekday-schedule",
   "description": "A Friday and Saturday weekend in Asia/Dubai (UTC+4, no daylight saving). A date beats a weekday beats the default, and null means the day has no quiet hours.",

package/spec/fixtures/shadow/reject-continues.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "shadow/reject-continues",
   "description": "A shadow check records its rejection and evaluation continues.",

package/spec/fixtures/trust-ramp/first-week.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "trust-ramp/first-week",
   "description": "During the first days only high priority and above gets through.",

package/spec/fixtures/utility/bounded-deferral-cap.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "utility/bounded-deferral-cap",
   "description": "The bound caps t*.",

package/spec/fixtures/utility/bounded-deferral.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "utility/bounded-deferral",
   "description": "boundedDeferral moves deliverAt by t* = min(bound, lambda * c / (2 * staleness)) when the candidate is busy.",

package/spec/fixtures/utility/floor.json

@@ -1,5 +1,5 @@
 {
-  "spec_version": "1.2.0",
+  "spec_version": "1.3.0",
   "since": "1.0.0",
   "name": "utility/floor",
   "description": "utilityFloor rejects when pAccept is below tau = cFA / (cFA + pNeed * cFN).",