proactive-gate 0.2.3 → 0.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/README.md +63 -0
  2. package/package.json +4 -2
  3. package/spec/CONFORMANCE.md +83 -0
  4. package/spec/SPEC.md +140 -0
  5. package/spec/SPEC_VERSION +1 -0
  6. package/spec/fixtures/adaptive-timing/placeholder.json +58 -0
  7. package/spec/fixtures/budget/bypass-priority.json +100 -0
  8. package/spec/fixtures/budget/daily-atomic-commit.json +140 -0
  9. package/spec/fixtures/budget/near-limit.json +103 -0
  10. package/spec/fixtures/budget/race-second-commit-loses.json +93 -0
  11. package/spec/fixtures/budget/weekly-iso-week.json +134 -0
  12. package/spec/fixtures/consent/required.json +116 -0
  13. package/spec/fixtures/cooldown/three-dismissals.json +132 -0
  14. package/spec/fixtures/dedupe/already-delivered.json +87 -0
  15. package/spec/fixtures/dedupe/no-key-skips.json +49 -0
  16. package/spec/fixtures/defer/snooze-as-defer.json +138 -0
  17. package/spec/fixtures/mode/allow-list.json +139 -0
  18. package/spec/fixtures/ordering/kill-switch.json +56 -0
  19. package/spec/fixtures/ordering/short-circuit.json +235 -0
  20. package/spec/fixtures/policy/unknown-check-is-an-error.json +50 -0
  21. package/spec/fixtures/presets/cn-minor-mode.json +170 -0
  22. package/spec/fixtures/presets/kakao-brand-message.json +93 -0
  23. package/spec/fixtures/presets/kr-network-act-50.json +168 -0
  24. package/spec/fixtures/presets/telegram-bot.json +162 -0
  25. package/spec/fixtures/presets/us-tcpa.json +90 -0
  26. package/spec/fixtures/quiet-hours/apia.json +90 -0
  27. package/spec/fixtures/quiet-hours/caller-supplied-dates.json +197 -0
  28. package/spec/fixtures/quiet-hours/crosses-midnight-by-day.json +221 -0
  29. package/spec/fixtures/quiet-hours/dst-new-york.json +126 -0
  30. package/spec/fixtures/quiet-hours/istanbul.json +160 -0
  31. package/spec/fixtures/quiet-hours/wall-clock.json +94 -0
  32. package/spec/fixtures/quiet-hours/weekday-schedule.json +262 -0
  33. package/spec/fixtures/shadow/reject-continues.json +143 -0
  34. package/spec/fixtures/trust-ramp/first-week.json +154 -0
  35. package/spec/fixtures/utility/bounded-deferral-cap.json +60 -0
  36. package/spec/fixtures/utility/bounded-deferral.json +95 -0
  37. package/spec/fixtures/utility/floor.json +168 -0
  38. package/spec/schema/fixture.schema.json +58 -0
  39. package/spec/schema/policy.schema.json +23 -0
  40. package/spec/skip/python.txt +0 -0
  41. package/spec/skip/ts.txt +0 -0
package/spec/fixtures/budget/near-limit.json ADDED
@@ -0,0 +1,103 @@
1
+ {
2
+ "spec_version": "1.2.0",
3
+ "since": "1.0.0",
4
+ "name": "budget/near-limit",
5
+ "description": "A pass close to the limit carries nearLimit.",
6
+ "policy": {
7
+ "specVersion": "1.0.0",
8
+ "checks": [
9
+ {
10
+ "id": "consent"
11
+ },
12
+ {
13
+ "id": "dailyBudget",
14
+ "limit": 5,
15
+ "nearLimit": 0.8
16
+ }
17
+ ]
18
+ },
19
+ "store_seed": {
20
+ "budget:u1:2026-09-04": "4",
21
+ "budget:u9:2026-09-04": "3"
22
+ },
23
+ "tests": [
24
+ {
25
+ "description": "4 of 5 used",
26
+ "input": {
27
+ "user": {
28
+ "id": "u1",
29
+ "consent": true,
30
+ "proactiveEnabled": true,
31
+ "mode": "normal",
32
+ "intensity": "normal",
33
+ "timezone": "Europe/Istanbul",
34
+ "quietHours": {
35
+ "start": "22:00",
36
+ "end": "08:00"
37
+ },
38
+ "createdAt": "2026-01-01T00:00:00Z"
39
+ },
40
+ "candidate": {
41
+ "id": "c1",
42
+ "type": "reminder",
43
+ "priority": "normal",
44
+ "surfaces": [
45
+ "push",
46
+ "feed"
47
+ ]
48
+ },
49
+ "now": "2026-09-04T09:00:00Z"
50
+ },
51
+ "expect": {
52
+ "allowed": true,
53
+ "trace": [
54
+ "consent",
55
+ "dailyBudget"
56
+ ],
57
+ "nearLimit": [
58
+ {
59
+ "check": "dailyBudget",
60
+ "used": 4,
61
+ "limit": 5
62
+ }
63
+ ]
64
+ }
65
+ },
66
+ {
67
+ "description": "3 of 5 used carries nothing",
68
+ "input": {
69
+ "user": {
70
+ "id": "u9",
71
+ "consent": true,
72
+ "proactiveEnabled": true,
73
+ "mode": "normal",
74
+ "intensity": "normal",
75
+ "timezone": "Europe/Istanbul",
76
+ "quietHours": {
77
+ "start": "22:00",
78
+ "end": "08:00"
79
+ },
80
+ "createdAt": "2026-01-01T00:00:00Z"
81
+ },
82
+ "candidate": {
83
+ "id": "c2",
84
+ "type": "reminder",
85
+ "priority": "normal",
86
+ "surfaces": [
87
+ "push",
88
+ "feed"
89
+ ]
90
+ },
91
+ "now": "2026-09-04T09:00:00Z"
92
+ },
93
+ "expect": {
94
+ "allowed": true,
95
+ "trace": [
96
+ "consent",
97
+ "dailyBudget"
98
+ ],
99
+ "nearLimit": []
100
+ }
101
+ }
102
+ ]
103
+ }
package/spec/fixtures/budget/race-second-commit-loses.json ADDED
@@ -0,0 +1,93 @@
1
+ {
2
+ "spec_version": "1.2.0",
3
+ "since": "1.0.0",
4
+ "name": "budget/race-second-commit-loses",
5
+ "description": "Two evaluations before either commit: only the first commit wins.",
6
+ "policy": {
7
+ "specVersion": "1.0.0",
8
+ "checks": [
9
+ {
10
+ "id": "consent"
11
+ },
12
+ {
13
+ "id": "dailyBudget",
14
+ "limit": 1
15
+ }
16
+ ]
17
+ },
18
+ "tests": [
19
+ {
20
+ "description": "first commit consumes the only unit",
21
+ "input": {
22
+ "user": {
23
+ "id": "u1",
24
+ "consent": true,
25
+ "proactiveEnabled": true,
26
+ "mode": "normal",
27
+ "intensity": "normal",
28
+ "timezone": "Europe/Istanbul",
29
+ "quietHours": {
30
+ "start": "22:00",
31
+ "end": "08:00"
32
+ },
33
+ "createdAt": "2026-01-01T00:00:00Z"
34
+ },
35
+ "candidate": {
36
+ "id": "c1",
37
+ "type": "reminder",
38
+ "priority": "normal",
39
+ "surfaces": [
40
+ "push",
41
+ "feed"
42
+ ]
43
+ },
44
+ "now": "2026-09-04T09:00:00Z"
45
+ },
46
+ "commit": true,
47
+ "expect": {
48
+ "allowed": true,
49
+ "trace": [
50
+ "consent",
51
+ "dailyBudget"
52
+ ],
53
+ "commit": true
54
+ }
55
+ },
56
+ {
57
+ "description": "the second candidate was evaluated when the counter read 1; its commit is refused",
58
+ "input": {
59
+ "user": {
60
+ "id": "u1",
61
+ "consent": true,
62
+ "proactiveEnabled": true,
63
+ "mode": "normal",
64
+ "intensity": "normal",
65
+ "timezone": "Europe/Istanbul",
66
+ "quietHours": {
67
+ "start": "22:00",
68
+ "end": "08:00"
69
+ },
70
+ "createdAt": "2026-01-01T00:00:00Z"
71
+ },
72
+ "candidate": {
73
+ "id": "c2",
74
+ "type": "reminder",
75
+ "priority": "normal",
76
+ "surfaces": [
77
+ "push",
78
+ "feed"
79
+ ]
80
+ },
81
+ "now": "2026-09-04T09:00:00Z"
82
+ },
83
+ "expect": {
84
+ "allowed": false,
85
+ "rejectedBy": "dailyBudget",
86
+ "trace": [
87
+ "consent",
88
+ "dailyBudget"
89
+ ]
90
+ }
91
+ }
92
+ ]
93
+ }
package/spec/fixtures/budget/weekly-iso-week.json ADDED
@@ -0,0 +1,134 @@
1
+ {
2
+ "spec_version": "1.2.0",
3
+ "since": "1.0.0",
4
+ "name": "budget/weekly-iso-week",
5
+ "description": "The weekly counter is keyed on the local ISO week.",
6
+ "policy": {
7
+ "specVersion": "1.0.0",
8
+ "checks": [
9
+ {
10
+ "id": "consent"
11
+ },
12
+ {
13
+ "id": "weeklyBudget",
14
+ "limit": 2
15
+ }
16
+ ]
17
+ },
18
+ "store_seed": {
19
+ "weeklyBudget:u1:2026-W36": "1"
20
+ },
21
+ "tests": [
22
+ {
23
+ "description": "Friday 4 Sep 2026 is week 36",
24
+ "input": {
25
+ "user": {
26
+ "id": "u1",
27
+ "consent": true,
28
+ "proactiveEnabled": true,
29
+ "mode": "normal",
30
+ "intensity": "normal",
31
+ "timezone": "Europe/Istanbul",
32
+ "quietHours": {
33
+ "start": "22:00",
34
+ "end": "08:00"
35
+ },
36
+ "createdAt": "2026-01-01T00:00:00Z"
37
+ },
38
+ "candidate": {
39
+ "id": "c1",
40
+ "type": "reminder",
41
+ "priority": "normal",
42
+ "surfaces": [
43
+ "push",
44
+ "feed"
45
+ ]
46
+ },
47
+ "now": "2026-09-04T09:00:00Z"
48
+ },
49
+ "commit": true,
50
+ "expect": {
51
+ "allowed": true,
52
+ "trace": [
53
+ "consent",
54
+ "weeklyBudget"
55
+ ],
56
+ "commit": true,
57
+ "store_after": {
58
+ "weeklyBudget:u1:2026-W36": "2"
59
+ }
60
+ }
61
+ },
62
+ {
63
+ "description": "week 36 is full",
64
+ "input": {
65
+ "user": {
66
+ "id": "u1",
67
+ "consent": true,
68
+ "proactiveEnabled": true,
69
+ "mode": "normal",
70
+ "intensity": "normal",
71
+ "timezone": "Europe/Istanbul",
72
+ "quietHours": {
73
+ "start": "22:00",
74
+ "end": "08:00"
75
+ },
76
+ "createdAt": "2026-01-01T00:00:00Z"
77
+ },
78
+ "candidate": {
79
+ "id": "c2",
80
+ "type": "reminder",
81
+ "priority": "normal",
82
+ "surfaces": [
83
+ "push",
84
+ "feed"
85
+ ]
86
+ },
87
+ "now": "2026-09-04T09:00:00Z"
88
+ },
89
+ "expect": {
90
+ "allowed": false,
91
+ "rejectedBy": "weeklyBudget",
92
+ "trace": [
93
+ "consent",
94
+ "weeklyBudget"
95
+ ]
96
+ }
97
+ },
98
+ {
99
+ "description": "Monday 7 Sep is week 37",
100
+ "input": {
101
+ "user": {
102
+ "id": "u1",
103
+ "consent": true,
104
+ "proactiveEnabled": true,
105
+ "mode": "normal",
106
+ "intensity": "normal",
107
+ "timezone": "Europe/Istanbul",
108
+ "quietHours": {
109
+ "start": "22:00",
110
+ "end": "08:00"
111
+ },
112
+ "createdAt": "2026-01-01T00:00:00Z"
113
+ },
114
+ "candidate": {
115
+ "id": "c3",
116
+ "type": "reminder",
117
+ "priority": "normal",
118
+ "surfaces": [
119
+ "push",
120
+ "feed"
121
+ ]
122
+ },
123
+ "now": "2026-09-07T09:00:00Z"
124
+ },
125
+ "expect": {
126
+ "allowed": true,
127
+ "trace": [
128
+ "consent",
129
+ "weeklyBudget"
130
+ ]
131
+ }
132
+ }
133
+ ]
134
+ }
package/spec/fixtures/consent/required.json ADDED
@@ -0,0 +1,116 @@
1
+ {
2
+ "spec_version": "1.2.0",
3
+ "since": "1.0.0",
4
+ "name": "consent/required",
5
+ "description": "Consent is the first thing about the person that is checked.",
6
+ "policy": {
7
+ "specVersion": "1.0.0",
8
+ "checks": [
9
+ {
10
+ "id": "consent"
11
+ },
12
+ {
13
+ "id": "enabled"
14
+ }
15
+ ]
16
+ },
17
+ "tests": [
18
+ {
19
+ "description": "no consent",
20
+ "input": {
21
+ "user": {
22
+ "id": "u1",
23
+ "consent": false,
24
+ "proactiveEnabled": true,
25
+ "mode": "normal",
26
+ "intensity": "normal",
27
+ "timezone": "Europe/Istanbul",
28
+ "quietHours": {
29
+ "start": "22:00",
30
+ "end": "08:00"
31
+ },
32
+ "createdAt": "2026-01-01T00:00:00Z"
33
+ },
34
+ "candidate": {
35
+ "id": "c1",
36
+ "type": "reminder",
37
+ "priority": "normal",
38
+ "surfaces": [
39
+ "push",
40
+ "feed"
41
+ ]
42
+ },
43
+ "now": "2026-09-04T09:00:00Z"
44
+ },
45
+ "expect": {
46
+ "allowed": false,
47
+ "rejectedBy": "consent",
48
+ "trace": [
49
+ "consent"
50
+ ]
51
+ }
52
+ },
53
+ {
54
+ "description": "consent given, disabled profile",
55
+ "input": {
56
+ "user": {
57
+ "id": "u1",
58
+ "consent": true,
59
+ "proactiveEnabled": false,
60
+ "mode": "normal",
61
+ "intensity": "normal",
62
+ "timezone": "Europe/Istanbul",
63
+ "quietHours": {
64
+ "start": "22:00",
65
+ "end": "08:00"
66
+ },
67
+ "createdAt": "2026-01-01T00:00:00Z"
68
+ },
69
+ "candidate": {
70
+ "id": "c1",
71
+ "type": "reminder",
72
+ "priority": "normal",
73
+ "surfaces": [
74
+ "push",
75
+ "feed"
76
+ ]
77
+ },
78
+ "now": "2026-09-04T09:00:00Z"
79
+ },
80
+ "expect": {
81
+ "allowed": false,
82
+ "rejectedBy": "enabled",
83
+ "trace": [
84
+ "consent",
85
+ "enabled"
86
+ ]
87
+ }
88
+ },
89
+ {
90
+ "description": "consent given, undefined proactiveEnabled defaults to on",
91
+ "input": {
92
+ "user": {
93
+ "id": "u2",
94
+ "consent": true
95
+ },
96
+ "candidate": {
97
+ "id": "c1",
98
+ "type": "reminder",
99
+ "priority": "normal",
100
+ "surfaces": [
101
+ "push",
102
+ "feed"
103
+ ]
104
+ },
105
+ "now": "2026-09-04T09:00:00Z"
106
+ },
107
+ "expect": {
108
+ "allowed": true,
109
+ "trace": [
110
+ "consent",
111
+ "enabled"
112
+ ]
113
+ }
114
+ }
115
+ ]
116
+ }
package/spec/fixtures/cooldown/three-dismissals.json ADDED
@@ -0,0 +1,132 @@
1
+ {
2
+ "spec_version": "1.2.0",
3
+ "since": "1.0.0",
4
+ "name": "cooldown/three-dismissals",
5
+ "description": "Three dismissals of a type within 30 days silence it for 7 days from the latest.",
6
+ "policy": {
7
+ "specVersion": "1.0.0",
8
+ "checks": [
9
+ {
10
+ "id": "consent"
11
+ },
12
+ {
13
+ "id": "dismissalCooldown",
14
+ "dismissals": 3,
15
+ "withinDays": 30,
16
+ "silenceDays": 7
17
+ }
18
+ ]
19
+ },
20
+ "store_seed": {
21
+ "cooldown:u1:reminder": "[1788264000000, 1788436800000, 1788523200000]"
22
+ },
23
+ "tests": [
24
+ {
25
+ "description": "silent one day after the third dismissal",
26
+ "input": {
27
+ "user": {
28
+ "id": "u1",
29
+ "consent": true,
30
+ "proactiveEnabled": true,
31
+ "mode": "normal",
32
+ "intensity": "normal",
33
+ "timezone": "Europe/Istanbul",
34
+ "quietHours": {
35
+ "start": "22:00",
36
+ "end": "08:00"
37
+ },
38
+ "createdAt": "2026-01-01T00:00:00Z"
39
+ },
40
+ "candidate": {
41
+ "id": "c1",
42
+ "type": "reminder",
43
+ "priority": "normal",
44
+ "surfaces": [
45
+ "push",
46
+ "feed"
47
+ ]
48
+ },
49
+ "now": "2026-09-05T12:00:00Z"
50
+ },
51
+ "expect": {
52
+ "allowed": false,
53
+ "rejectedBy": "dismissalCooldown",
54
+ "trace": [
55
+ "consent",
56
+ "dismissalCooldown"
57
+ ],
58
+ "reason_pattern": "3 dismissals"
59
+ }
60
+ },
61
+ {
62
+ "description": "another type is unaffected",
63
+ "input": {
64
+ "user": {
65
+ "id": "u1",
66
+ "consent": true,
67
+ "proactiveEnabled": true,
68
+ "mode": "normal",
69
+ "intensity": "normal",
70
+ "timezone": "Europe/Istanbul",
71
+ "quietHours": {
72
+ "start": "22:00",
73
+ "end": "08:00"
74
+ },
75
+ "createdAt": "2026-01-01T00:00:00Z"
76
+ },
77
+ "candidate": {
78
+ "id": "c1",
79
+ "type": "insight",
80
+ "priority": "normal",
81
+ "surfaces": [
82
+ "push",
83
+ "feed"
84
+ ]
85
+ },
86
+ "now": "2026-09-05T12:00:00Z"
87
+ },
88
+ "expect": {
89
+ "allowed": true,
90
+ "trace": [
91
+ "consent",
92
+ "dismissalCooldown"
93
+ ]
94
+ }
95
+ },
96
+ {
97
+ "description": "eight days after the third dismissal it speaks again",
98
+ "input": {
99
+ "user": {
100
+ "id": "u1",
101
+ "consent": true,
102
+ "proactiveEnabled": true,
103
+ "mode": "normal",
104
+ "intensity": "normal",
105
+ "timezone": "Europe/Istanbul",
106
+ "quietHours": {
107
+ "start": "22:00",
108
+ "end": "08:00"
109
+ },
110
+ "createdAt": "2026-01-01T00:00:00Z"
111
+ },
112
+ "candidate": {
113
+ "id": "c1",
114
+ "type": "reminder",
115
+ "priority": "normal",
116
+ "surfaces": [
117
+ "push",
118
+ "feed"
119
+ ]
120
+ },
121
+ "now": "2026-09-13T00:00:00Z"
122
+ },
123
+ "expect": {
124
+ "allowed": true,
125
+ "trace": [
126
+ "consent",
127
+ "dismissalCooldown"
128
+ ]
129
+ }
130
+ }
131
+ ]
132
+ }
package/spec/fixtures/dedupe/already-delivered.json ADDED
@@ -0,0 +1,87 @@
1
+ {
2
+ "spec_version": "1.2.0",
3
+ "since": "1.2.0",
4
+ "name": "dedupe/already-delivered",
5
+ "description": "A key claimed inside the window rejects the second attempt at the same event.",
6
+ "policy": {
7
+ "specVersion": "1.0.0",
8
+ "checks": [
9
+ {
10
+ "id": "consent"
11
+ },
12
+ {
13
+ "id": "dedupe",
14
+ "windowSeconds": 3600
15
+ }
16
+ ]
17
+ },
18
+ "store_seed": {
19
+ "dedupe:u1:order-42-shipped": "1"
20
+ },
21
+ "tests": [
22
+ {
23
+ "description": "the same event arriving again is refused",
24
+ "input": {
25
+ "user": {
26
+ "id": "u1",
27
+ "consent": true,
28
+ "proactiveEnabled": true,
29
+ "mode": "normal",
30
+ "intensity": "normal",
31
+ "timezone": "Europe/Istanbul",
32
+ "createdAt": "2026-01-01T00:00:00Z"
33
+ },
34
+ "candidate": {
35
+ "id": "c2",
36
+ "type": "reminder",
37
+ "priority": "normal",
38
+ "surfaces": [
39
+ "push"
40
+ ],
41
+ "dedupeKey": "order-42-shipped"
42
+ },
43
+ "now": "2026-09-05T12:00:00Z"
44
+ },
45
+ "expect": {
46
+ "allowed": false,
47
+ "rejectedBy": "dedupe",
48
+ "trace": [
49
+ "consent",
50
+ "dedupe"
51
+ ],
52
+ "reason_pattern": "already delivered"
53
+ }
54
+ },
55
+ {
56
+ "description": "a different event on the same user is unaffected",
57
+ "input": {
58
+ "user": {
59
+ "id": "u1",
60
+ "consent": true,
61
+ "proactiveEnabled": true,
62
+ "mode": "normal",
63
+ "intensity": "normal",
64
+ "timezone": "Europe/Istanbul",
65
+ "createdAt": "2026-01-01T00:00:00Z"
66
+ },
67
+ "candidate": {
68
+ "id": "c3",
69
+ "type": "reminder",
70
+ "priority": "normal",
71
+ "surfaces": [
72
+ "push"
73
+ ],
74
+ "dedupeKey": "order-43-shipped"
75
+ },
76
+ "now": "2026-09-05T12:00:00Z"
77
+ },
78
+ "expect": {
79
+ "allowed": true,
80
+ "trace": [
81
+ "consent",
82
+ "dedupe"
83
+ ]
84
+ }
85
+ }
86
+ ]
87
+ }