@ssheleg/sheleg-dev 0.11.8 → 0.12.0

package/plugins/sheleg-dev/skills/stripe-billing/fixtures/manifest.json

@@ -1,200 +1,335 @@
 {
-  "skill": "stripe-billing",
-  "assertionPack": "assert-money-invariants.mjs",
-  "referenceHandler": "reference-handler.mjs",
-  "runbook": "README.md",
-  "note": "The single home of the invariant -> fixture -> document mapping. test/validate.py in this repository reads it: every fixture must be claimed by a row, every row's fixtures must exist, and every claiming document must still carry its phrase, name the invariant id, and name a path under fixtures/. A claim whose fixture is gone and a fixture nobody claims are both failures.",
-  "invariants": [
-    {
-      "id": "renewal-grants-exactly-once",
-      "isolates": "grant-on-renewal",
-      "fixtures": [
-        "invoice-paid-subscription-cycle.json"
-      ],
-      "claimedBy": [
-        {
-          "document": "references/webhook-events.md",
-          "phrase": "| `subscription_cycle` | the renewal | **yes** |"
-        }
-      ]
-    },
-    {
-      "id": "proration-invoice-grants-nothing",
-      "isolates": "billing-reason",
-      "fixtures": [
-        "invoice-paid-subscription-cycle.json",
-        "invoice-paid-subscription-update-proration.json"
-      ],
-      "claimedBy": [
-        {
-          "document": "references/webhook-events.md",
-          "phrase": "mid-cycle proration (quantity or plan change)"
-        }
-      ]
-    },
-    {
-      "id": "sequential-redelivery-grants-once",
-      "isolates": "claim",
-      "fixtures": [
-        "invoice-paid-subscription-cycle.json",
-        "invoice-paid-subscription-cycle-redelivery.json"
-      ],
-      "claimedBy": [
-        {
-          "document": "references/webhook-events.md",
-          "phrase": "- `claimEvent` = `INSERT`; unique violation means duplicate."
-        }
-      ]
-    },
-    {
-      "id": "concurrent-redelivery-grants-once",
-      "isolates": "claim",
-      "fixtures": [
-        "invoice-paid-subscription-cycle.json",
-        "invoice-paid-subscription-cycle-redelivery.json"
-      ],
-      "claimedBy": [
-        {
-          "document": "references/webhook-events.md",
-          "phrase": "A failure to *claim* (database down) is a 503"
-        }
-      ]
-    },
-    {
-      "id": "sequential-redelivery-grants-once-by-count-alone",
-      "isolates": null,
-      "fixtures": [
-        "invoice-paid-subscription-cycle.json",
-        "invoice-paid-subscription-cycle-redelivery.json"
-      ],
-      "claimedBy": [
-        {
-          "document": "references/testing-and-local-dev.md",
-          "phrase": "two mechanisms cover each other"
-        }
-      ]
-    },
-    {
-      "id": "reconciliation-does-not-regrant",
-      "isolates": "grant-marker",
-      "fixtures": [
-        "invoice-paid-subscription-cycle.json"
-      ],
-      "claimedBy": [
-        {
-          "document": "references/webhook-events.md",
-          "phrase": "Guard the grant with a marker that survives a replay"
-        }
-      ]
-    },
-    {
-      "id": "out-of-order-pair-does-not-rewind-state",
-      "isolates": "ordering",
-      "fixtures": [
-        "invoice-paid-subscription-cycle.json",
-        "invoice-paid-subscription-cycle-next-period.json"
-      ],
-      "claimedBy": [
-        {
-          "document": "references/webhook-events.md",
-          "phrase": "**Never derive state from arrival order.**"
-        }
-      ]
-    },
-    {
-      "id": "refund-total-is-cumulative",
-      "isolates": "cumulative-refund",
-      "fixtures": [
-        "charge-refunded-partial.json",
-        "charge-refunded-remainder.json"
-      ],
-      "claimedBy": [
-        {
-          "document": "references/webhook-events.md",
-          "phrase": "`amount_refunded` is **cumulative**."
-        }
-      ]
-    },
-    {
-      "id": "duplicate-refund-claws-back-once",
-      "isolates": null,
-      "fixtures": [
-        "charge-refunded-partial.json"
-      ],
-      "claimedBy": [
-        {
-          "document": "references/testing-and-local-dev.md",
-          "phrase": "two mechanisms cover each other"
-        }
-      ]
-    },
-    {
-      "id": "unpaid-session-grants-nothing",
-      "isolates": "async-gate",
-      "fixtures": [
-        "checkout-session-completed-async-unpaid.json",
-        "checkout-session-async-payment-failed.json"
-      ],
-      "claimedBy": [
-        {
-          "document": "references/webhook-events.md",
-          "phrase": "grant belongs to `async_payment_succeeded`"
-        }
-      ]
-    },
-    {
-      "id": "paid-session-grants-once",
-      "isolates": "grant-on-checkout",
-      "fixtures": [
-        "checkout-session-completed-paid.json"
-      ],
-      "claimedBy": [
-        {
-          "document": "references/webhook-events.md",
-          "phrase": "Uniqueness key: the subscription id for subscriptions, the payment intent id"
-        }
-      ]
-    },
-    {
-      "id": "conversion-id-survives-the-session",
-      "isolates": "conversion-id-from-metadata",
-      "fixtures": [
-        "invoice-paid-subscription-cycle.json"
-      ],
-      "claimedBy": [
-        {
-          "document": "references/testing-and-local-dev.md",
-          "phrase": "the id the browser will reuse"
-        }
-      ]
-    },
-    {
-      "id": "retention-offer-is-consumed-once",
-      "isolates": "retention-eligibility",
-      "fixtures": [
-        "customer-discount-created-retention.json",
-        "customer-subscription-updated-discount-consumed.json"
-      ],
-      "claimedBy": [
-        {
-          "document": "references/cancellation-and-retention.md",
-          "phrase": "**The ledger is the source of truth, Stripe is the second opinion.**"
-        }
-      ]
-    },
-    {
-      "id": "scheduled-cancellation-survives-billing-mode",
-      "isolates": "cancellation-timestamp",
-      "fixtures": [
-        "customer-subscription-updated-cancel-flexible.json",
-        "customer-subscription-updated-cancel-classic.json"
-      ],
-      "claimedBy": [
-        {
-          "document": "references/cancellation-and-retention.md",
-          "phrase": "Store the timestamp, not the boolean."
-        }
-      ]
-    }
-  ]
+ "skill": "stripe-billing",
+ "assertionPack": "assert-money-invariants.mjs",
+ "referenceHandler": "reference-handler.mjs",
+ "runbook": "README.md",
+ "note": "The single home of the invariant -> fixture -> document mapping. test/validate.py in this repository reads it: every fixture must be claimed by a row, every row's fixtures must exist, and every claiming document must still carry its phrase, name the invariant id, and name a path under fixtures/. A claim whose fixture is gone and a fixture nobody claims are both failures.",
+ "invariants": [
+  {
+   "id": "renewal-grants-exactly-once",
+   "isolates": "grant-on-renewal",
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "| `subscription_cycle` | the renewal | **yes** |"
+    }
+   ]
+  },
+  {
+   "id": "proration-invoice-grants-nothing",
+   "isolates": "billing-reason",
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json",
+    "invoice-paid-subscription-update-proration.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "mid-cycle proration (quantity or plan change)"
+    }
+   ]
+  },
+  {
+   "id": "sequential-redelivery-grants-once",
+   "isolates": null,
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json",
+    "invoice-paid-subscription-cycle-redelivery.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "`claimEvent` = `INSERT`; a unique violation is not yet an answer"
+    }
+   ]
+  },
+  {
+   "id": "concurrent-redelivery-grants-once",
+   "isolates": "claim",
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json",
+    "invoice-paid-subscription-cycle-redelivery.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "A failure to *claim* (database down) is a 503"
+    }
+   ]
+  },
+  {
+   "id": "crash-after-receipt-is-retryable",
+   "isolates": "claim-expiry",
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json",
+    "invoice-paid-subscription-cycle-redelivery.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "belonged to a worker that died between receipt and completion"
+    }
+   ]
+  },
+  {
+   "id": "in-flight-claim-answers-retry-later",
+   "isolates": "claim",
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json",
+    "invoice-paid-subscription-cycle-redelivery.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "another worker is (or may still be) on it: answer 5xx"
+    }
+   ]
+  },
+  {
+   "id": "completion-is-recorded-with-the-grant",
+   "isolates": "claim-completion",
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "a row that says completed is one whose business write committed"
+    }
+   ]
+  },
+  {
+   "id": "duplicate-of-completed-never-regrants",
+   "isolates": null,
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json",
+    "invoice-paid-subscription-cycle-redelivery.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "ages a completed row past the expiry and requires the late retry to answer duplicate"
+    }
+   ]
+  },
+  {
+   "id": "transaction-rolls-back-whole",
+   "isolates": "atomic-application",
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "commit together, or none of them exist"
+    }
+   ]
+  },
+  {
+   "id": "crash-before-commit-applies-nothing",
+   "isolates": null,
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json",
+    "invoice-paid-subscription-cycle-redelivery.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "the retry runs the whole application again"
+    }
+   ]
+  },
+  {
+   "id": "committed-retry-sends-once",
+   "isolates": "outbox-consumer-key",
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "A redelivered outbox row must send nothing twice"
+    }
+   ]
+  },
+  {
+   "id": "sequential-redelivery-grants-once-by-count-alone",
+   "isolates": null,
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json",
+    "invoice-paid-subscription-cycle-redelivery.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/testing-and-local-dev.md",
+     "phrase": "two mechanisms cover each other"
+    }
+   ]
+  },
+  {
+   "id": "concurrent-entry-points-grant-once",
+   "isolates": "grant-key-atomic",
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/subscription-lifecycle.md",
+     "phrase": "both pass the read and both credit"
+    }
+   ]
+  },
+  {
+   "id": "serialization-conflict-does-not-lose-the-renewal",
+   "isolates": "tx-retry-bounded",
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "a conflict may delay a grant, never lose it"
+    }
+   ]
+  },
+  {
+   "id": "exhausted-retries-answer-5xx-and-the-redelivery-lands",
+   "isolates": null,
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json",
+    "invoice-paid-subscription-cycle-redelivery.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "a swallowed conflict answered 200 is a renewal that silently never happened"
+    }
+   ]
+  },
+  {
+   "id": "reconciliation-does-not-regrant",
+   "isolates": "grant-marker",
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "Guard the grant with a marker that survives a replay"
+    }
+   ]
+  },
+  {
+   "id": "out-of-order-pair-does-not-rewind-state",
+   "isolates": "ordering",
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json",
+    "invoice-paid-subscription-cycle-next-period.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "**Never derive state from arrival order.**"
+    }
+   ]
+  },
+  {
+   "id": "refund-total-is-cumulative",
+   "isolates": "cumulative-refund",
+   "fixtures": [
+    "charge-refunded-partial.json",
+    "charge-refunded-remainder.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "`amount_refunded` is **cumulative**."
+    }
+   ]
+  },
+  {
+   "id": "duplicate-refund-claws-back-once",
+   "isolates": null,
+   "fixtures": [
+    "charge-refunded-partial.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/testing-and-local-dev.md",
+     "phrase": "two mechanisms cover each other"
+    }
+   ]
+  },
+  {
+   "id": "unpaid-session-grants-nothing",
+   "isolates": "async-gate",
+   "fixtures": [
+    "checkout-session-completed-async-unpaid.json",
+    "checkout-session-async-payment-failed.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "grant belongs to `async_payment_succeeded`"
+    }
+   ]
+  },
+  {
+   "id": "paid-session-grants-once",
+   "isolates": "grant-on-checkout",
+   "fixtures": [
+    "checkout-session-completed-paid.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/webhook-events.md",
+     "phrase": "Uniqueness key: the subscription id for subscriptions, the payment intent id"
+    }
+   ]
+  },
+  {
+   "id": "conversion-id-survives-the-session",
+   "isolates": "conversion-id-from-metadata",
+   "fixtures": [
+    "invoice-paid-subscription-cycle.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/testing-and-local-dev.md",
+     "phrase": "the id the browser will reuse"
+    }
+   ]
+  },
+  {
+   "id": "retention-offer-is-consumed-once",
+   "isolates": "retention-eligibility",
+   "fixtures": [
+    "customer-discount-created-retention.json",
+    "customer-subscription-updated-discount-consumed.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/cancellation-and-retention.md",
+     "phrase": "**The ledger is the source of truth, Stripe is the second opinion.**"
+    }
+   ]
+  },
+  {
+   "id": "scheduled-cancellation-survives-billing-mode",
+   "isolates": "cancellation-timestamp",
+   "fixtures": [
+    "customer-subscription-updated-cancel-flexible.json",
+    "customer-subscription-updated-cancel-classic.json"
+   ],
+   "claimedBy": [
+    {
+     "document": "references/cancellation-and-retention.md",
+     "phrase": "Store the timestamp, not the boolean."
+    }
+   ]
+  }
+ ]
 }