@topy-ai/maggie 0.7.52 → 0.7.53

package/bundled-contracts/maggiedash/booking-rules-v1.json

@@ -0,0 +1,1699 @@
+{
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
+ "schemaVersion": "maggiedash-booking-rules.v1",
+ "title": "MaggieDash booking rule contracts and shared test vectors",
+ "description": "Pure rules every booking host implements the same way. Run `maggie booking rules-vectors` against the reference, or `--host-command` against the host's implementation (one {rule, input} JSON line in, the result JSON out). Expected objects are partial: only the listed fields are compared. Money is integer minor units; instants are UTC ISO-8601; local wall times use the venue's IANA zone.",
+ "rules": [
+  {
+   "id": "manage_action",
+   "why": "99edd9: a manage link cancelled a booking that had started or was still on hold",
+   "vectors": [
+    {
+     "name": "client cancels a confirmed booking days ahead",
+     "input": {
+      "status": "confirmed",
+      "action": "cancel",
+      "actor": "client",
+      "startAt": "2026-10-20T10:00:00Z",
+      "now": "2026-10-17T10:00:00Z",
+      "policy": {
+       "mode": "window",
+       "windowHours": 24
+      }
+     },
+     "expect": {
+      "allowed": true,
+      "reason": "ok"
+     }
+    },
+    {
+     "name": "client cannot cancel after arrival",
+     "input": {
+      "status": "arrived",
+      "action": "cancel",
+      "actor": "client",
+      "startAt": "2026-10-20T10:00:00Z",
+      "now": "2026-10-20T09:55:00Z"
+     },
+     "expect": {
+      "allowed": false,
+      "reason": "in_progress"
+     }
+    },
+    {
+     "name": "client cannot cancel a booking still on hold",
+     "input": {
+      "status": "held",
+      "action": "cancel",
+      "actor": "client",
+      "startAt": "2026-10-20T10:00:00Z",
+      "now": "2026-10-17T10:00:00Z"
+     },
+     "expect": {
+      "allowed": false,
+      "reason": "not_confirmed"
+     }
+    },
+    {
+     "name": "client cannot reschedule after the start",
+     "input": {
+      "status": "confirmed",
+      "action": "reschedule",
+      "actor": "client",
+      "startAt": "2026-10-20T10:00:00Z",
+      "now": "2026-10-20T10:10:00Z"
+     },
+     "expect": {
+      "allowed": false,
+      "reason": "started"
+     }
+    },
+    {
+     "name": "free-cancellation policy still stops at the start",
+     "input": {
+      "status": "confirmed",
+      "action": "cancel",
+      "actor": "client",
+      "startAt": "2026-10-20T10:00:00Z",
+      "now": "2026-10-20T10:01:00Z",
+      "policy": {
+       "mode": "free"
+      }
+     },
+     "expect": {
+      "allowed": false,
+      "reason": "started"
+     }
+    },
+    {
+     "name": "inside the cancellation window the client must contact the business",
+     "input": {
+      "status": "confirmed",
+      "action": "cancel",
+      "actor": "client",
+      "startAt": "2026-10-20T10:00:00Z",
+      "now": "2026-10-20T05:00:00Z",
+      "policy": {
+       "mode": "window",
+       "windowHours": 24
+      }
+     },
+     "expect": {
+      "allowed": false,
+      "reason": "inside_window"
+     }
+    },
+    {
+     "name": "business may cancel a booking in service",
+     "input": {
+      "status": "in_service",
+      "action": "cancel",
+      "actor": "business",
+      "startAt": "2026-10-20T10:00:00Z",
+      "now": "2026-10-20T10:20:00Z"
+     },
+     "expect": {
+      "allowed": true
+     }
+    },
+    {
+     "name": "nobody reschedules a booking in service",
+     "input": {
+      "status": "in_service",
+      "action": "reschedule",
+      "actor": "business",
+      "startAt": "2026-10-20T10:00:00Z",
+      "now": "2026-10-20T10:20:00Z"
+     },
+     "expect": {
+      "allowed": false,
+      "reason": "in_progress"
+     }
+    },
+    {
+     "name": "completed bookings are closed",
+     "input": {
+      "status": "completed",
+      "action": "cancel",
+      "actor": "client",
+      "startAt": "2026-10-20T10:00:00Z",
+      "now": "2026-10-21T10:00:00Z"
+     },
+     "expect": {
+      "allowed": false,
+      "reason": "closed"
+     }
+    }
+   ]
+  },
+  {
+   "id": "late_payment",
+   "why": "3873f8: payment completed after the hold expired left a paid client without a booking",
+   "vectors": [
+    {
+     "name": "normal payment confirms",
+     "input": {
+      "bookingStatus": "pending_payment",
+      "paidMinor": 2500
+     },
+     "expect": {
+      "outcome": "confirm",
+      "newStatus": "confirmed"
+     }
+    },
+    {
+     "name": "late payment, time still free: reinstate",
+     "input": {
+      "bookingStatus": "expired",
+      "slotFree": true,
+      "paidMinor": 2500
+     },
+     "expect": {
+      "outcome": "reinstate",
+      "newStatus": "confirmed",
+      "refundMinor": 0
+     }
+    },
+    {
+     "name": "late payment, time taken: refund in full and tell the client",
+     "input": {
+      "bookingStatus": "expired",
+      "slotFree": false,
+      "paidMinor": 2500
+     },
+     "expect": {
+      "outcome": "refund",
+      "newStatus": "expired",
+      "refundMinor": 2500,
+      "notify": [
+       "client.payment_refunded_slot_taken",
+       "business.late_payment_refunded"
+      ]
+     }
+    },
+    {
+     "name": "repeated webhook is a no-op",
+     "input": {
+      "bookingStatus": "confirmed",
+      "paidMinor": 2500
+     },
+     "expect": {
+      "outcome": "duplicate_event",
+      "refundMinor": 0
+     }
+    },
+    {
+     "name": "payment after the client cancelled is refunded",
+     "input": {
+      "bookingStatus": "cancelled",
+      "cancelledBy": "client",
+      "slotFree": true,
+      "paidMinor": 4000
+     },
+     "expect": {
+      "outcome": "refund",
+      "refundMinor": 4000
+     }
+    }
+   ]
+  },
+  {
+   "id": "schedule_to_utc",
+   "why": "2076c0: time off was converted with the browser's zone",
+   "vectors": [
+    {
+     "name": "summer time off in a UK venue from a US browser",
+     "input": {
+      "local": "2026-07-10T09:00",
+      "venueTz": "Europe/London",
+      "browserTz": "America/New_York"
+     },
+     "expect": {
+      "utc": "2026-07-10T08:00:00Z",
+      "ambiguous": false
+     }
+    },
+    {
+     "name": "winter time off",
+     "input": {
+      "local": "2026-01-10T09:00",
+      "venueTz": "Europe/London",
+      "browserTz": "Asia/Tokyo"
+     },
+     "expect": {
+      "utc": "2026-01-10T09:00:00Z"
+     }
+    },
+    {
+     "name": "a time skipped by the spring change is rejected",
+     "input": {
+      "local": "2026-03-29T01:30",
+      "venueTz": "Europe/London"
+     },
+     "expect": {
+      "error": "nonexistent_local_time"
+     }
+    },
+    {
+     "name": "a repeated autumn time uses the first occurrence and says so",
+     "input": {
+      "local": "2026-10-25T01:30",
+      "venueTz": "Europe/London"
+     },
+     "expect": {
+      "utc": "2026-10-25T00:30:00Z",
+      "ambiguous": true
+     }
+    }
+   ]
+  },
+  {
+   "id": "money_minor",
+   "why": "27a77a: bigint prices arrived as strings and broke totals",
+   "vectors": [
+    {
+     "name": "pg bigint string",
+     "input": {
+      "value": "4500"
+     },
+     "expect": {
+      "minor": 4500
+     }
+    },
+    {
+     "name": "integer",
+     "input": {
+      "value": 4500
+     },
+     "expect": {
+      "minor": 4500
+     }
+    },
+    {
+     "name": "decimal string is not minor units",
+     "input": {
+      "value": "45.00"
+     },
+     "expect": {
+      "error": "not_minor_units"
+     }
+    },
+    {
+     "name": "float is not minor units",
+     "input": {
+      "value": 45.5
+     },
+     "expect": {
+      "error": "not_minor_units"
+     }
+    },
+    {
+     "name": "boolean is not money",
+     "input": {
+      "value": true
+     },
+     "expect": {
+      "error": "not_minor_units"
+     }
+    }
+   ]
+  },
+  {
+   "id": "sale_total",
+   "why": "14c87e: add-ons already in the booking item price were counted twice at the till",
+   "vectors": [
+    {
+     "name": "add-on included in the item price is not added again",
+     "input": {
+      "items": [
+       {
+        "priceMinor": 6000,
+        "addOns": [
+         {
+          "priceMinor": 1500,
+          "includedInItemPrice": true
+         }
+        ]
+       }
+      ]
+     },
+     "expect": {
+      "subtotalMinor": 6000,
+      "totalMinor": 6000,
+      "amountDueMinor": 6000
+     }
+    },
+    {
+     "name": "add-on sold separately is added",
+     "input": {
+      "items": [
+       {
+        "priceMinor": 6000,
+        "addOns": [
+         {
+          "priceMinor": 1500
+         }
+        ]
+       }
+      ]
+     },
+     "expect": {
+      "subtotalMinor": 7500
+     }
+    },
+    {
+     "name": "discount, service charge, voucher and a split tip",
+     "input": {
+      "items": [
+       {
+        "priceMinor": 5000
+       },
+       {
+        "priceMinor": 2000,
+        "qty": 2
+       }
+      ],
+      "discountMinor": 1000,
+      "serviceChargePercent": 12.5,
+      "voucherMinor": 3000,
+      "tipMinor": 1000,
+      "tipSplit": [
+       {
+        "staffId": "a"
+       },
+       {
+        "staffId": "b"
+       }
+      ]
+     },
+     "expect": {
+      "subtotalMinor": 9000,
+      "serviceChargeMinor": 1000,
+      "totalMinor": 9000,
+      "voucherMinor": 3000,
+      "amountDueMinor": 7000,
+      "tipsByStaff": {
+       "a": 500,
+       "b": 500
+      }
+     }
+    },
+    {
+     "name": "tip remainder pennies go out one by one",
+     "input": {
+      "items": [
+       {
+        "priceMinor": 1000
+       }
+      ],
+      "tipMinor": 1001,
+      "tipSplit": [
+       {
+        "staffId": "c"
+       },
+       {
+        "staffId": "a"
+       },
+       {
+        "staffId": "b"
+       }
+      ]
+     },
+     "expect": {
+      "tipsByStaff": {
+       "a": 334,
+       "b": 334,
+       "c": 333
+      }
+     }
+    },
+    {
+     "name": "service charge rounds half up",
+     "input": {
+      "items": [
+       {
+        "priceMinor": 3333
+       }
+      ],
+      "serviceChargePercent": 12.5
+     },
+     "expect": {
+      "serviceChargeMinor": 417,
+      "totalMinor": 3750
+     }
+    },
+    {
+     "name": "a package covers part of the sale",
+     "input": {
+      "items": [
+       {
+        "priceMinor": 6000
+       }
+      ],
+      "voucherMinor": 1000,
+      "packageCoveredMinor": 4000
+     },
+     "expect": {
+      "voucherMinor": 1000,
+      "packageMinor": 4000,
+      "amountDueMinor": 1000
+     }
+    }
+   ]
+  },
+  {
+   "id": "payment_policy_setup",
+   "why": "fd6d59: deposits could be chosen without payments connected; clients were refused at the last step",
+   "vectors": [
+    {
+     "name": "pay at the venue needs nothing",
+     "input": {
+      "policy": "venue",
+      "paymentsConnected": false
+     },
+     "expect": {
+      "allowed": true
+     }
+    },
+    {
+     "name": "deposit without payments connected",
+     "input": {
+      "policy": "deposit",
+      "paymentsConnected": false
+     },
+     "expect": {
+      "allowed": false,
+      "reason": "payments_not_connected"
+     }
+    },
+    {
+     "name": "full payment while charges are disabled",
+     "input": {
+      "policy": "full",
+      "paymentsConnected": true,
+      "chargesEnabled": false
+     },
+     "expect": {
+      "allowed": false,
+      "reason": "charges_not_enabled"
+     }
+    },
+    {
+     "name": "deposit with a live account",
+     "input": {
+      "policy": "deposit",
+      "paymentsConnected": true,
+      "chargesEnabled": true
+     },
+     "expect": {
+      "allowed": true
+     }
+    }
+   ]
+  },
+  {
+   "id": "reminders_due",
+   "why": "ff4665: only a 24 h reminder existed; reminders need several offsets and a once-only guard",
+   "vectors": [
+    {
+     "name": "24 h reminder",
+     "input": {
+      "startAt": "2026-10-20T15:00:00Z",
+      "createdAt": "2026-10-10T09:00:00Z",
+      "now": "2026-10-19T15:30:00Z",
+      "offsetsHours": [
+       24,
+       2
+      ],
+      "sent": []
+     },
+     "expect": {
+      "due": [
+       "24h"
+      ],
+      "skipped": []
+     }
+    },
+    {
+     "name": "2 h reminder after the 24 h one",
+     "input": {
+      "startAt": "2026-10-20T15:00:00Z",
+      "createdAt": "2026-10-10T09:00:00Z",
+      "now": "2026-10-20T13:10:00Z",
+      "offsetsHours": [
+       24,
+       2
+      ],
+      "sent": [
+       "24h"
+      ]
+     },
+     "expect": {
+      "due": [
+       "2h"
+      ],
+      "skipped": []
+     }
+    },
+    {
+     "name": "a missed 24 h reminder is not sent late",
+     "input": {
+      "startAt": "2026-10-20T15:00:00Z",
+      "createdAt": "2026-10-10T09:00:00Z",
+      "now": "2026-10-20T13:10:00Z",
+      "offsetsHours": [
+       24,
+       2
+      ],
+      "sent": []
+     },
+     "expect": {
+      "due": [
+       "2h"
+      ],
+      "skipped": [
+       "24h"
+      ]
+     }
+    },
+    {
+     "name": "booked 3 h ahead: no 24 h reminder",
+     "input": {
+      "startAt": "2026-10-20T15:00:00Z",
+      "createdAt": "2026-10-20T12:00:00Z",
+      "now": "2026-10-20T13:05:00Z",
+      "offsetsHours": [
+       24,
+       2
+      ],
+      "sent": []
+     },
+     "expect": {
+      "due": [
+       "2h"
+      ],
+      "skipped": [
+       "24h"
+      ]
+     }
+    },
+    {
+     "name": "nothing after the start",
+     "input": {
+      "startAt": "2026-10-20T15:00:00Z",
+      "createdAt": "2026-10-10T09:00:00Z",
+      "now": "2026-10-20T15:01:00Z",
+      "offsetsHours": [
+       24,
+       2
+      ],
+      "sent": [
+       "24h"
+      ]
+     },
+     "expect": {
+      "due": []
+     }
+    },
+    {
+     "name": "cancelled bookings get no reminder",
+     "input": {
+      "status": "cancelled",
+      "startAt": "2026-10-20T15:00:00Z",
+      "createdAt": "2026-10-10T09:00:00Z",
+      "now": "2026-10-19T15:30:00Z"
+     },
+     "expect": {
+      "due": []
+     }
+    },
+    {
+     "name": "offsets are per business",
+     "input": {
+      "startAt": "2026-10-20T15:00:00Z",
+      "createdAt": "2026-10-10T09:00:00Z",
+      "now": "2026-10-18T15:30:00Z",
+      "offsetsHours": [
+       48,
+       1
+      ],
+      "sent": []
+     },
+     "expect": {
+      "due": [
+       "48h"
+      ]
+     }
+    }
+   ]
+  },
+  {
+   "id": "notification_plan",
+   "why": "ff4665: the business got no notice of a client reschedule; the cancel template always said the client cancelled",
+   "vectors": [
+    {
+     "name": "client cancels",
+     "input": {
+      "event": "cancelled",
+      "actor": "client"
+     },
+     "expect": {
+      "templates": {
+       "client": "booking.cancelled.by_client",
+       "business": "business.booking_cancelled.by_client"
+      }
+     }
+    },
+    {
+     "name": "business cancels",
+     "input": {
+      "event": "cancelled",
+      "actor": "business"
+     },
+     "expect": {
+      "templates": {
+       "client": "booking.cancelled.by_business"
+      }
+     }
+    },
+    {
+     "name": "client reschedules: the business is told",
+     "input": {
+      "event": "rescheduled",
+      "actor": "client"
+     },
+     "expect": {
+      "templates": {
+       "client": "booking.rescheduled.by_client",
+       "business": "business.booking_rescheduled.by_client"
+      }
+     }
+    },
+    {
+     "name": "system expiry",
+     "input": {
+      "event": "cancelled",
+      "actor": "system"
+     },
+     "expect": {
+      "templates": {
+       "client": "booking.cancelled.by_system",
+       "business": "business.booking_cancelled.by_system"
+      }
+     }
+    }
+   ]
+  },
+  {
+   "id": "ics_text",
+   "why": "44894d: escaping ';' did nothing; .ics must escape and fold per RFC 5545",
+   "vectors": [
+    {
+     "name": "semicolon, comma, backslash and newline",
+     "input": {
+      "text": "Lash lift; tint, \\ brow\nnotes"
+     },
+     "expect": {
+      "escaped": "Lash lift\\; tint\\, \\\\ brow\\nnotes"
+     }
+    },
+    {
+     "name": "lines fold at 75 octets",
+     "input": {
+      "text": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+     },
+     "expect": {
+      "lines": [
+       "SUMMARY:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+       " aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+      ]
+     }
+    }
+   ]
+  },
+  {
+   "id": "rota_week",
+   "why": "7589df: alternate-week rotas",
+   "vectors": [
+    {
+     "name": "second week of a two-week rota",
+     "input": {
+      "anchor": "2026-10-05",
+      "date": "2026-10-14",
+      "weeks": 2
+     },
+     "expect": {
+      "week": 1
+     }
+    },
+    {
+     "name": "back to the first week",
+     "input": {
+      "anchor": "2026-10-05",
+      "date": "2026-10-19",
+      "weeks": 2
+     },
+     "expect": {
+      "week": 0
+     }
+    },
+    {
+     "name": "anchor mid-week counts from its Monday",
+     "input": {
+      "anchor": "2026-10-07",
+      "date": "2026-10-12",
+      "weeks": 2
+     },
+     "expect": {
+      "week": 1
+     }
+    }
+   ]
+  },
+  {
+   "id": "plan_slots",
+   "why": "7589df: split hours, per-staff durations, any-staff choice, gaps, groups, rotas and DST with shared vectors",
+   "vectors": [
+    {
+     "name": "split opening hours keep both ranges",
+     "input": {
+      "timezone": "Europe/London",
+      "date": "2026-10-14",
+      "slotMinutes": 60,
+      "hours": [
+       [
+        "09:00",
+        "12:00"
+       ],
+       [
+        "13:00",
+        "15:00"
+       ]
+      ],
+      "service": {
+       "id": "svc",
+       "durationMinutes": 60
+      },
+      "staff": [
+       {
+        "id": "s1"
+       }
+      ]
+     },
+     "expect": {
+      "starts": [
+       "09:00",
+       "10:00",
+       "11:00",
+       "13:00",
+       "14:00"
+      ]
+     }
+    },
+    {
+     "name": "per-staff duration and the least busy person first",
+     "input": {
+      "timezone": "Europe/London",
+      "date": "2026-10-14",
+      "slotMinutes": 30,
+      "hours": [
+       [
+        "09:00",
+        "11:00"
+       ]
+      ],
+      "service": {
+       "id": "svc",
+       "durationMinutes": 60
+      },
+      "staff": [
+       {
+        "id": "a",
+        "sortOrder": 1,
+        "bookingsToday": 2,
+        "durations": {
+         "svc": 90
+        }
+       },
+       {
+        "id": "b",
+        "sortOrder": 2,
+        "bookingsToday": 0
+       }
+      ]
+     },
+     "expect": {
+      "starts": [
+       "09:00",
+       "09:30",
+       "10:00"
+      ],
+      "slots": [
+       {
+        "start": "09:00",
+        "utc": "2026-10-14T08:00:00Z",
+        "staff": [
+         "b"
+        ]
+       },
+       {
+        "start": "09:30",
+        "utc": "2026-10-14T08:30:00Z",
+        "staff": [
+         "b"
+        ]
+       },
+       {
+        "start": "10:00",
+        "utc": "2026-10-14T09:00:00Z",
+        "staff": [
+         "b"
+        ]
+       }
+      ]
+     }
+    },
+    {
+     "name": "buffers keep other bookings away",
+     "input": {
+      "timezone": "Europe/London",
+      "date": "2026-10-14",
+      "slotMinutes": 15,
+      "hours": [
+       [
+        "09:00",
+        "12:00"
+       ]
+      ],
+      "service": {
+       "id": "svc",
+       "durationMinutes": 30,
+       "bufferAfter": 15
+      },
+      "staff": [
+       {
+        "id": "s1",
+        "busy": [
+         [
+          "2026-10-14T09:00:00Z",
+          "2026-10-14T10:00:00Z"
+         ]
+        ]
+       }
+      ]
+     },
+     "expect": {
+      "starts": [
+       "09:00",
+       "09:15",
+       "11:00",
+       "11:15",
+       "11:30"
+      ]
+     }
+    },
+    {
+     "name": "no gaps shorter than 30 minutes",
+     "input": {
+      "timezone": "Europe/London",
+      "date": "2026-10-14",
+      "slotMinutes": 15,
+      "hours": [
+       [
+        "09:00",
+        "12:00"
+       ]
+      ],
+      "minGapMinutes": 30,
+      "service": {
+       "id": "svc",
+       "durationMinutes": 30
+      },
+      "staff": [
+       {
+        "id": "s1",
+        "busy": [
+         [
+          "2026-10-14T09:00:00Z",
+          "2026-10-14T10:00:00Z"
+         ]
+        ]
+       }
+      ]
+     },
+     "expect": {
+      "starts": [
+       "09:00",
+       "09:30",
+       "11:00",
+       "11:30"
+      ]
+     }
+    },
+    {
+     "name": "clock change day",
+     "input": {
+      "timezone": "Europe/London",
+      "date": "2026-03-29",
+      "slotMinutes": 60,
+      "hours": [
+       [
+        "09:00",
+        "11:00"
+       ]
+      ],
+      "service": {
+       "id": "svc",
+       "durationMinutes": 60
+      },
+      "staff": [
+       {
+        "id": "s1"
+       }
+      ]
+     },
+     "expect": {
+      "slots": [
+       {
+        "start": "09:00",
+        "utc": "2026-03-29T08:00:00Z",
+        "staff": [
+         "s1"
+        ]
+       },
+       {
+        "start": "10:00",
+        "utc": "2026-03-29T09:00:00Z",
+        "staff": [
+         "s1"
+        ]
+       }
+      ]
+     }
+    },
+    {
+     "name": "group of three needs three free people",
+     "input": {
+      "timezone": "Europe/London",
+      "date": "2026-10-14",
+      "slotMinutes": 60,
+      "hours": [
+       [
+        "09:00",
+        "10:00"
+       ]
+      ],
+      "groupSize": 3,
+      "service": {
+       "id": "svc",
+       "durationMinutes": 60
+      },
+      "staff": [
+       {
+        "id": "a"
+       },
+       {
+        "id": "b"
+       },
+       {
+        "id": "c",
+        "busy": [
+         [
+          "2026-10-14T08:00:00Z",
+          "2026-10-14T09:00:00Z"
+         ]
+        ]
+       }
+      ]
+     },
+     "expect": {
+      "starts": []
+     }
+    },
+    {
+     "name": "group of two",
+     "input": {
+      "timezone": "Europe/London",
+      "date": "2026-10-14",
+      "slotMinutes": 60,
+      "hours": [
+       [
+        "09:00",
+        "10:00"
+       ]
+      ],
+      "groupSize": 2,
+      "service": {
+       "id": "svc",
+       "durationMinutes": 60
+      },
+      "staff": [
+       {
+        "id": "a"
+       },
+       {
+        "id": "b"
+       },
+       {
+        "id": "c",
+        "busy": [
+         [
+          "2026-10-14T08:00:00Z",
+          "2026-10-14T09:00:00Z"
+         ]
+        ]
+       }
+      ]
+     },
+     "expect": {
+      "slots": [
+       {
+        "start": "09:00",
+        "utc": "2026-10-14T08:00:00Z",
+        "staff": [
+         "a",
+         "b"
+        ]
+       }
+      ]
+     }
+    },
+    {
+     "name": "alternate-week rota: off this week",
+     "input": {
+      "timezone": "Europe/London",
+      "date": "2026-10-14",
+      "slotMinutes": 60,
+      "hours": [
+       [
+        "09:00",
+        "12:00"
+       ]
+      ],
+      "service": {
+       "id": "svc",
+       "durationMinutes": 60
+      },
+      "staff": [
+       {
+        "id": "s1",
+        "rota": {
+         "anchor": "2026-10-05",
+         "patterns": [
+          {
+           "2": [
+            [
+             "09:00",
+             "12:00"
+            ]
+           ]
+          },
+          {
+           "2": []
+          }
+         ]
+        }
+       }
+      ]
+     },
+     "expect": {
+      "starts": []
+     }
+    },
+    {
+     "name": "alternate-week rota: on this week",
+     "input": {
+      "timezone": "Europe/London",
+      "date": "2026-10-07",
+      "slotMinutes": 60,
+      "hours": [
+       [
+        "09:00",
+        "12:00"
+       ]
+      ],
+      "service": {
+       "id": "svc",
+       "durationMinutes": 60
+      },
+      "staff": [
+       {
+        "id": "s1",
+        "rota": {
+         "anchor": "2026-10-05",
+         "patterns": [
+          {
+           "2": [
+            [
+             "09:00",
+             "11:00"
+            ]
+           ]
+          },
+          {
+           "2": []
+          }
+         ]
+        }
+       }
+      ]
+     },
+     "expect": {
+      "starts": [
+       "09:00",
+       "10:00"
+      ]
+     }
+    }
+   ]
+  },
+  {
+   "id": "price_for",
+   "why": "7589df: peak/off-peak price rules",
+   "vectors": [
+    {
+     "name": "Saturday peak",
+     "input": {
+      "timezone": "Europe/London",
+      "startUtc": "2026-10-17T10:30:00Z",
+      "basePriceMinor": 5000,
+      "rules": [
+       {
+        "name": "peak",
+        "weekdays": [
+         5,
+         6
+        ],
+        "from": "10:00",
+        "to": "18:00",
+        "percent": 20
+       },
+       {
+        "name": "off-peak",
+        "weekdays": [
+         0,
+         1,
+         2,
+         3,
+         4
+        ],
+        "from": "09:00",
+        "to": "12:00",
+        "priceMinor": 4000
+       }
+      ]
+     },
+     "expect": {
+      "priceMinor": 6000,
+      "rule": "peak"
+     }
+    },
+    {
+     "name": "weekday morning off-peak",
+     "input": {
+      "timezone": "Europe/London",
+      "startUtc": "2026-10-14T08:30:00Z",
+      "basePriceMinor": 5000,
+      "rules": [
+       {
+        "name": "peak",
+        "weekdays": [
+         5,
+         6
+        ],
+        "from": "10:00",
+        "to": "18:00",
+        "percent": 20
+       },
+       {
+        "name": "off-peak",
+        "weekdays": [
+         0,
+         1,
+         2,
+         3,
+         4
+        ],
+        "from": "09:00",
+        "to": "12:00",
+        "priceMinor": 4000
+       }
+      ]
+     },
+     "expect": {
+      "priceMinor": 4000,
+      "rule": "off-peak"
+     }
+    },
+    {
+     "name": "no rule applies",
+     "input": {
+      "timezone": "Europe/London",
+      "startUtc": "2026-10-14T13:00:00Z",
+      "basePriceMinor": 5000,
+      "rules": [
+       {
+        "name": "off-peak",
+        "weekdays": [
+         0,
+         1,
+         2,
+         3,
+         4
+        ],
+        "from": "09:00",
+        "to": "12:00",
+        "priceMinor": 4000
+       }
+      ]
+     },
+     "expect": {
+      "priceMinor": 5000,
+      "rule": null
+     }
+    }
+   ]
+  },
+  {
+   "id": "permission_check",
+   "why": "601910: 'own bookings only' was tied to a role name and the PIN switch did not reach pages, menus or clock-in",
+   "vectors": [
+    {
+     "name": "therapist sees only own bookings",
+     "input": {
+      "role": "therapist",
+      "permission": "bookings.edit",
+      "bookingStaffId": "s2",
+      "actorStaffId": "s1"
+     },
+     "expect": {
+      "allowed": false,
+      "reason": "own_bookings_only"
+     }
+    },
+    {
+     "name": "reception edits anyone's booking",
+     "input": {
+      "role": "reception",
+      "permission": "bookings.edit",
+      "bookingStaffId": "s2",
+      "actorStaffId": "s1"
+     },
+     "expect": {
+      "allowed": true
+     }
+    },
+    {
+     "name": "owner grants a therapist all bookings",
+     "input": {
+      "role": "therapist",
+      "permission": "bookings.edit",
+      "bookingStaffId": "s2",
+      "actorStaffId": "s1",
+      "overrides": {
+       "therapist": {
+        "grant": [
+         "bookings.view_all"
+        ]
+       }
+      }
+     },
+     "expect": {
+      "allowed": true
+     }
+    },
+    {
+     "name": "team management is never delegable",
+     "input": {
+      "role": "manager",
+      "permission": "team.manage",
+      "overrides": {
+       "manager": {
+        "grant": [
+         "team.manage"
+        ]
+       }
+      }
+     },
+     "expect": {
+      "allowed": false,
+      "reason": "owner_only"
+     }
+    },
+    {
+     "name": "PIN switch lowers the owner to therapist for refunds",
+     "input": {
+      "role": "owner",
+      "pinRole": "therapist",
+      "permission": "checkout.refund"
+     },
+     "expect": {
+      "allowed": false,
+      "effectiveRole": "therapist"
+     }
+    },
+    {
+     "name": "PIN switch applies to clock-in too",
+     "input": {
+      "role": "owner",
+      "pinRole": "therapist",
+      "permission": "timeclock.self"
+     },
+     "expect": {
+      "allowed": true,
+      "effectiveRole": "therapist"
+     }
+    },
+    {
+     "name": "PIN switch can never raise a role",
+     "input": {
+      "role": "therapist",
+      "pinRole": "manager",
+      "permission": "reports.view"
+     },
+     "expect": {
+      "allowed": false,
+      "reason": "pin_cannot_raise_role"
+     }
+    },
+    {
+     "name": "owner revokes refunds from managers",
+     "input": {
+      "role": "manager",
+      "permission": "checkout.refund",
+      "overrides": {
+       "manager": {
+        "revoke": [
+         "checkout.refund"
+        ]
+       }
+      }
+     },
+     "expect": {
+      "allowed": false,
+      "reason": "missing_permission"
+     }
+    }
+   ]
+  },
+  {
+   "id": "online_booking_gate",
+   "why": "66c948: missing patch tests and blocked clients did not stop online booking",
+   "vectors": [
+    {
+     "name": "blocked client gets a neutral message",
+     "input": {
+      "client": {
+       "blocked": true
+      },
+      "service": {},
+      "startAt": "2026-10-20T09:00:00Z"
+     },
+     "expect": {
+      "allowed": false,
+      "reason": "contact_business"
+     }
+    },
+    {
+     "name": "patch test required",
+     "input": {
+      "client": {},
+      "service": {
+       "patchTestCategory": "lash-tint"
+      },
+      "startAt": "2026-10-20T09:00:00Z"
+     },
+     "expect": {
+      "allowed": false,
+      "reason": "patch_test_required"
+     }
+    },
+    {
+     "name": "patch test expired",
+     "input": {
+      "client": {
+       "patchTests": {
+        "lash-tint": "2026-01-01T09:00:00Z"
+       }
+      },
+      "service": {
+       "patchTestCategory": "lash-tint",
+       "patchTestValidDays": 180
+      },
+      "startAt": "2026-10-20T09:00:00Z"
+     },
+     "expect": {
+      "allowed": false,
+      "reason": "patch_test_expired"
+     }
+    },
+    {
+     "name": "patch test less than 48 h before",
+     "input": {
+      "client": {
+       "patchTests": {
+        "lash-tint": "2026-10-19T10:00:00Z"
+       }
+      },
+      "service": {
+       "patchTestCategory": "lash-tint"
+      },
+      "startAt": "2026-10-20T09:00:00Z"
+     },
+     "expect": {
+      "allowed": false,
+      "reason": "patch_test_too_recent"
+     }
+    },
+    {
+     "name": "valid patch test",
+     "input": {
+      "client": {
+       "patchTests": {
+        "lash-tint": "2026-10-01T10:00:00Z"
+       }
+      },
+      "service": {
+       "patchTestCategory": "lash-tint"
+      },
+      "startAt": "2026-10-20T09:00:00Z"
+     },
+     "expect": {
+      "allowed": true
+     }
+    },
+    {
+     "name": "no patch test needed",
+     "input": {
+      "client": {},
+      "service": {
+       "id": "massage"
+      },
+      "startAt": "2026-10-20T09:00:00Z"
+     },
+     "expect": {
+      "allowed": true
+     }
+    }
+   ]
+  },
+  {
+   "id": "merge_clients",
+   "why": "b54ba7: the first client merge lost loyalty points",
+   "vectors": [
+    {
+     "name": "points, tier, history and memberships survive a merge",
+     "input": {
+      "primary": {
+       "points": 120,
+       "lifetimePoints": 300,
+       "history": [
+        1,
+        2,
+        3
+       ],
+       "memberships": [
+        "m1"
+       ]
+      },
+      "duplicate": {
+       "points": 80,
+       "lifetimePoints": 250,
+       "history": [
+        4,
+        5
+       ],
+       "memberships": [
+        "m2"
+       ]
+      },
+      "tiers": [
+       {
+        "name": "bronze",
+        "minLifetimePoints": 0
+       },
+       {
+        "name": "silver",
+        "minLifetimePoints": 500
+       },
+       {
+        "name": "gold",
+        "minLifetimePoints": 1000
+       }
+      ]
+     },
+     "expect": {
+      "points": 200,
+      "lifetimePoints": 550,
+      "tier": "silver",
+      "historyEntries": 5,
+      "memberships": [
+       "m1",
+       "m2"
+      ]
+     }
+    }
+   ]
+  },
+  {
+   "id": "membership_credits",
+   "why": "b54ba7: memberships with pause",
+   "vectors": [
+    {
+     "name": "a paused month neither bills nor adds credits",
+     "input": {
+      "creditsPerMonth": 2,
+      "priceMinor": 3000,
+      "months": [
+       {
+        "state": "active"
+       },
+       {
+        "state": "paused"
+       },
+       {
+        "state": "active"
+       }
+      ]
+     },
+     "expect": {
+      "billedMonths": 2,
+      "creditsAdded": 4,
+      "amountBilledMinor": 6000
+     }
+    }
+   ]
+  },
+  {
+   "id": "commission",
+   "why": "de5f23: team pay",
+   "vectors": [
+    {
+     "name": "service and product rates per person, on net sales",
+     "input": {
+      "lines": [
+       {
+        "kind": "service",
+        "netMinor": 10000,
+        "staffId": "a"
+       },
+       {
+        "kind": "product",
+        "netMinor": 2000,
+        "staffId": "a"
+       },
+       {
+        "kind": "service",
+        "netMinor": 5000,
+        "staffId": "b"
+       }
+      ],
+      "rates": {
+       "a": {
+        "service": 0.4,
+        "product": 0.1
+       },
+       "b": {
+        "service": 0.35
+       }
+      }
+     },
+     "expect": {
+      "commissionMinor": {
+       "a": 4200,
+       "b": 1750
+      }
+     }
+    }
+   ]
+  },
+  {
+   "id": "hourly_pay",
+   "why": "de5f23: clock-in and hourly pay",
+   "vectors": [
+    {
+     "name": "two shifts with an unpaid break",
+     "input": {
+      "rateMinor": 1250,
+      "shifts": [
+       {
+        "in": "2026-10-13T09:00:00Z",
+        "out": "2026-10-13T17:30:00Z",
+        "breakMinutes": 30
+       },
+       {
+        "in": "2026-10-14T09:00:00Z",
+        "out": "2026-10-14T13:20:00Z"
+       }
+      ]
+     },
+     "expect": {
+      "minutes": 740,
+      "payMinor": 15417
+     }
+    }
+   ]
+  },
+  {
+   "id": "link_booking_to_account",
+   "why": "1bc306: token bookings join a signed-in account by verified e-mail",
+   "vectors": [
+    {
+     "name": "verified, same e-mail ignoring case and spaces",
+     "input": {
+      "bookingEmail": " Amy@Example.com ",
+      "accountEmail": "amy@example.com",
+      "accountEmailVerified": true
+     },
+     "expect": {
+      "link": true
+     }
+    },
+    {
+     "name": "unverified e-mail never links",
+     "input": {
+      "bookingEmail": "amy@example.com",
+      "accountEmail": "amy@example.com",
+      "accountEmailVerified": false
+     },
+     "expect": {
+      "link": false,
+      "reason": "email_not_verified"
+     }
+    },
+    {
+     "name": "different e-mail",
+     "input": {
+      "bookingEmail": "amy@example.com",
+      "accountEmail": "amy2@example.com",
+      "accountEmailVerified": true
+     },
+     "expect": {
+      "link": false,
+      "reason": "different_email"
+     }
+    }
+   ]
+  }
+ ]
+}