@drawbridge/drawbridge-agents 0.1.28 → 0.1.30

package/.claude-template/settings.json

@@ -21,6 +21,7 @@
       "../drawbridge-docs",
       "../drawbridge-emails",
       "../drawbridge-games",
+      "../drawbridge-growth",
       "../drawbridge-mongodb",
       "../drawbridge-redis",
       "../drawbridge-share",

package/conventions/cross-repo-contracts.md

@@ -68,13 +68,20 @@ skill) so it stops living only in tribal memory.
   after it produced five distinct defects, ending in a 60-second line-window overlap that billed
   one correctly-delivered event twice. Do not reintroduce meter events, and do not "fix" a billing
   discrepancy by reporting usage to Stripe — corrections are `billing.trueup` ledger rows.
-- **`items.actions` is the record of what the customer was SOLD** — `{ limit,
-  overageCentsPerAction }`, written by drawbridge-stripe (≥0.1.44) at create/upgrade/downgrade and
-  read by drawbridge-sync at cycle close. plans.js is the default for NEW sales only; editing it
-  does not reprice existing customers (that is `repriceActionsSnapshot`, explicit and dry-runnable).
-  Anything adding custom/enterprise pricing must gate the plan-change paths and the reprice script
-  or negotiated values get silently overwritten. The rate is a NUMBER in cents — the string
-  `'2.5'` shape exists only at the Stripe `unit_amount_decimal` boundary.
+- **`subscription.overrides` is the single home for sold/negotiated terms** —
+  `{ actions : { limit, overages }, conversion }`. `overrides.actions` is ALWAYS stamped at sale by
+  drawbridge-stripe (≥0.1.46) and re-stamped on plan change; `overrides.conversion` exists only when
+  an admin overrides the plan default, and api carries it onto the new document across plan changes.
+  Resolution is PER FIELD: `overrides.actions.X` → legacy `items.actions.X` (transitional) →
+  plans.js; conversion resolves ONLY through `conversionRate()` in utils (`overrides.conversion` →
+  legacy top-level `conversion` → plan → free; `??` throughout, 0 is a valid override). `overages`
+  is a NUMBER in cents per action — the string `'2.5'` shape exists only at the Stripe
+  `unit_amount_decimal` boundary. Deleting a key restores plan flow, which is why the admin PUT
+  unsets the legacy keys it supersedes. plans.js is the default for NEW sales only; repricing
+  existing customers is `repriceActionsSnapshot` (explicit, dry-runnable — and it overwrites
+  admin-negotiated actions values, so read the dry run). The legacy keys are copy-only until the
+  overrides cleanup release, and sync (reader) deploys before stripe (writer) on any shape change.
+  Detail: drawbridge-docs `reference/billing.md`.
 - **No Stripe product backs actions (≥0.1.45).** Invoice items carry
   currency/quantity/unit_amount_decimal/tax_behavior/description directly; the account keeps exactly
   one product — the plan product behind `STRIPE_PRICE_*`. Never reintroduce a product-presence guard

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawbridge/drawbridge-agents",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "description": "Shared agent-instruction content (rules, code style, conventions) for the drawbridge-* monorepo.",
   "license": "UNLICENSED",
   "publishConfig": {