proactive-gate 0.2.2 → 0.2.4

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

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

@@ -0,0 +1,170 @@
+{
+  "spec_version": "1.2.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.",
+  "policy": {
+    "specVersion": "1.0.0",
+    "checks": [
+      {
+        "id": "consent"
+      },
+      {
+        "preset": "cnMinorMode"
+      }
+    ]
+  },
+  "tests": [
+    {
+      "description": "minor at 23:00 CST 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",
+          "minor": true
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T15:00:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "rejectedBy": "window:minor",
+        "trace": [
+          "consent",
+          "window:minor"
+        ]
+      }
+    },
+    {
+      "description": "adult at 23:00 CST passes both",
+      "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",
+          "minor": false
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T15:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent",
+          "window:minor",
+          "dailyBudget"
+        ]
+      }
+    },
+    {
+      "description": "minor at noon CST: first message allowed and consumed",
+      "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",
+          "minor": true
+        },
+        "candidate": {
+          "id": "c2",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T04:00:00Z"
+      },
+      "commit": true,
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent",
+          "window:minor",
+          "dailyBudget"
+        ],
+        "commit": true
+      }
+    },
+    {
+      "description": "minor at noon CST: second message rejected",
+      "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",
+          "minor": true
+        },
+        "candidate": {
+          "id": "c3",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T04:00:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "rejectedBy": "dailyBudget",
+        "trace": [
+          "consent",
+          "window:minor",
+          "dailyBudget"
+        ]
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,93 @@
+{
+  "spec_version": "1.2.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.",
+  "policy": {
+    "specVersion": "1.0.0",
+    "checks": [
+      {
+        "preset": "kakaoBrandMessage"
+      }
+    ]
+  },
+  "tests": [
+    {
+      "description": "21:00 KST rejects even for a user in Istanbul",
+      "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",
+          "consents": {
+            "ad": true
+          }
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T12:00:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "rejectedBy": "window:kakao",
+        "trace": [
+          "consent:ad",
+          "window:kakao"
+        ]
+      }
+    },
+    {
+      "description": "10:00 KST 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",
+          "consents": {
+            "ad": true
+          }
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T01:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent:ad",
+          "window:kakao"
+        ]
+      }
+    }
+  ]
+}