proactive-gate 0.2.2 → 0.2.4

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

@@ -0,0 +1,262 @@
+{
+  "spec_version": "1.2.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.",
+  "policy": {
+    "specVersion": "1.0.0",
+    "checks": [
+      {
+        "id": "consent"
+      },
+      {
+        "id": "quietHours"
+      }
+    ]
+  },
+  "tests": [
+    {
+      "description": "Friday 14:00 local is the weekend here, rejects",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Asia/Dubai",
+          "quietHours": {
+            "default": {
+              "start": "22:00",
+              "end": "08:00"
+            },
+            "days": {
+              "fri": {
+                "start": "00:00",
+                "end": "23:59"
+              },
+              "sat": {
+                "start": "00:00",
+                "end": "23:59"
+              },
+              "sun": null
+            }
+          },
+          "createdAt": "2026-01-01T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T10:00:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "trace": [
+          "consent",
+          "quietHours"
+        ],
+        "rejectedBy": "quietHours"
+      }
+    },
+    {
+      "description": "Saturday 14:00 local rejects",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Asia/Dubai",
+          "quietHours": {
+            "default": {
+              "start": "22:00",
+              "end": "08:00"
+            },
+            "days": {
+              "fri": {
+                "start": "00:00",
+                "end": "23:59"
+              },
+              "sat": {
+                "start": "00:00",
+                "end": "23:59"
+              },
+              "sun": null
+            }
+          },
+          "createdAt": "2026-01-01T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-05T10:00:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "trace": [
+          "consent",
+          "quietHours"
+        ],
+        "rejectedBy": "quietHours"
+      }
+    },
+    {
+      "description": "Sunday 23:00 local is a working night, sun is null so the default does not apply",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Asia/Dubai",
+          "quietHours": {
+            "default": {
+              "start": "22:00",
+              "end": "08:00"
+            },
+            "days": {
+              "fri": {
+                "start": "00:00",
+                "end": "23:59"
+              },
+              "sat": {
+                "start": "00:00",
+                "end": "23:59"
+              },
+              "sun": null
+            }
+          },
+          "createdAt": "2026-01-01T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-06T19:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent",
+          "quietHours"
+        ]
+      }
+    },
+    {
+      "description": "Monday 23:00 local falls back to the default and rejects",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Asia/Dubai",
+          "quietHours": {
+            "default": {
+              "start": "22:00",
+              "end": "08:00"
+            },
+            "days": {
+              "fri": {
+                "start": "00:00",
+                "end": "23:59"
+              },
+              "sat": {
+                "start": "00:00",
+                "end": "23:59"
+              },
+              "sun": null
+            }
+          },
+          "createdAt": "2026-01-01T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-07T19:00:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "trace": [
+          "consent",
+          "quietHours"
+        ],
+        "rejectedBy": "quietHours"
+      }
+    },
+    {
+      "description": "Monday 14:00 local passes",
+      "input": {
+        "user": {
+          "id": "u1",
+          "consent": true,
+          "proactiveEnabled": true,
+          "mode": "normal",
+          "intensity": "normal",
+          "timezone": "Asia/Dubai",
+          "quietHours": {
+            "default": {
+              "start": "22:00",
+              "end": "08:00"
+            },
+            "days": {
+              "fri": {
+                "start": "00:00",
+                "end": "23:59"
+              },
+              "sat": {
+                "start": "00:00",
+                "end": "23:59"
+              },
+              "sun": null
+            }
+          },
+          "createdAt": "2026-01-01T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-07T10:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent",
+          "quietHours"
+        ]
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,143 @@
+{
+  "spec_version": "1.2.0",
+  "since": "1.0.0",
+  "name": "shadow/reject-continues",
+  "description": "A shadow check records its rejection and evaluation continues.",
+  "policy": {
+    "specVersion": "1.0.0",
+    "checks": [
+      {
+        "id": "consent"
+      },
+      {
+        "id": "quietHours",
+        "shadow": true
+      },
+      {
+        "id": "dailyBudget",
+        "limit": 5
+      }
+    ]
+  },
+  "store_seed": {
+    "budget:full:2026-09-04": "5"
+  },
+  "tests": [
+    {
+      "description": "23:30 local: quiet hours would reject; the decision is allowed and lists it",
+      "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-04T20:30:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent",
+          "quietHours",
+          "dailyBudget"
+        ],
+        "shadowed": [
+          "quietHours"
+        ]
+      }
+    },
+    {
+      "description": "noon: nothing shadowed",
+      "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",
+          "quietHours",
+          "dailyBudget"
+        ],
+        "shadowed": []
+      }
+    },
+    {
+      "description": "a real rejection later still rejects, with the shadow listed",
+      "input": {
+        "user": {
+          "id": "full",
+          "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": "c2",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T20:30:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "rejectedBy": "dailyBudget",
+        "trace": [
+          "consent",
+          "quietHours",
+          "dailyBudget"
+        ],
+        "shadowed": [
+          "quietHours"
+        ]
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,154 @@
+{
+  "spec_version": "1.2.0",
+  "since": "1.0.0",
+  "name": "trust-ramp/first-week",
+  "description": "During the first days only high priority and above gets through.",
+  "policy": {
+    "specVersion": "1.0.0",
+    "checks": [
+      {
+        "id": "consent"
+      },
+      {
+        "id": "trustRamp",
+        "days": 7,
+        "minPriority": "high"
+      }
+    ]
+  },
+  "tests": [
+    {
+      "description": "day 2, normal priority 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-09-03T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T09:00:00Z"
+      },
+      "expect": {
+        "allowed": false,
+        "rejectedBy": "trustRamp",
+        "trace": [
+          "consent",
+          "trustRamp"
+        ],
+        "reason_pattern": "day 2 of 7"
+      }
+    },
+    {
+      "description": "day 2, high priority 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-09-03T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "high",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T09:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent",
+          "trustRamp"
+        ]
+      }
+    },
+    {
+      "description": "day 8 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-08-27T00:00:00Z"
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T09:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent",
+          "trustRamp"
+        ]
+      }
+    },
+    {
+      "description": "no createdAt: skip, not reject",
+      "input": {
+        "user": {
+          "id": "u3",
+          "consent": true
+        },
+        "candidate": {
+          "id": "c1",
+          "type": "reminder",
+          "priority": "normal",
+          "surfaces": [
+            "push",
+            "feed"
+          ]
+        },
+        "now": "2026-09-04T09:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "trace": [
+          "consent",
+          "trustRamp"
+        ]
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,60 @@
+{
+  "spec_version": "1.2.0",
+  "since": "1.0.0",
+  "name": "utility/bounded-deferral-cap",
+  "description": "The bound caps t*.",
+  "policy": {
+    "specVersion": "1.0.0",
+    "checks": [
+      {
+        "id": "consent"
+      },
+      {
+        "id": "boundedDeferral",
+        "lambda": 1,
+        "interruptCost": 1,
+        "staleness": 0.0001,
+        "boundSeconds": 240
+      }
+    ]
+  },
+  "tests": [
+    {
+      "description": "t* would be 5000 s; capped at 240",
+      "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"
+          ],
+          "busy": true
+        },
+        "now": "2026-09-04T09:00:00Z"
+      },
+      "expect": {
+        "allowed": true,
+        "deliverAt": "2026-09-04T09:04:00.000Z",
+        "trace": [
+          "consent",
+          "boundedDeferral"
+        ]
+      }
+    }
+  ]
+}