@drawbridge/drawbridge-agents 0.1.40 → 0.1.43

package/conventions/cross-repo-contracts.md

@@ -137,6 +137,19 @@ skill) so it stops living only in tribal memory.
 - **A subscription must open with the plan item.** It used to open with the metered actions price
   and attach the plan afterwards with `always_invoice`. With no metered item, Stripe rejects an
   itemless subscription, so the plan goes in at creation — changing the first invoice's shape.
+- **Ending a subscription is written twice, from ONE implementation** (stripe ↔ api ↔ sync).
+  `subscription.markTerminal` in **drawbridge-stripe** (`lib/subscription.js`, takes the caller's
+  db controller + session like `reconcile`) clears the org's `subscription` pointer, demotes to
+  `unsubscribed` under `status : { $nin : [ 'suspended', 'unsubscribed' ] }`, `$pull`s the org's
+  `type : 'method'` errors and flips the sub doc to `canceled`. Both callers run it: sync's
+  `markSubscriptionTerminal` (`lib/buffer.js`, on `customer.subscription.deleted` and terminal
+  `subscription.updated`) and drawbridge-api's admin cancel
+  (`route/organization-subscription.js` `handlers.delete.cancel`), which mirrors it inline so the
+  page isn't stale for a webhook it just caused. **The mirror runs FIRST and consumes the status
+  guard**, so the webhook's pass then matches nothing — anything one caller does outside
+  `markTerminal` therefore never happens on the admin path. Never re-inline these writes: the
+  hand-copied version drifted, and a stale card decline outlived its subscription and permanently
+  blocked the org from resubscribing (Asana 1217947409527192).
 - **Invoice line descriptions must keep the word "actions":** `isActionsLine` matches `/actions/i`
   to count billed quantity for the billed-vs-ledger reconcile. A copy edit that drops it silently
   breaks the audit. Detail: drawbridge-docs `reference/billing.md`.

package/conventions/superpowers-docs.md

@@ -8,7 +8,12 @@ drawbridge-docs/superpowers/plans/YYYY-MM-DD-<slug>.md
 drawbridge-docs/superpowers/specs/YYYY-MM-DD-<slug>.md
 ```
 
-This is the **only** allowed home for these working docs. Rules:
+**THE ONE EXCEPTION IS drawbridge-growth** (Darren, repeatedly, most recently 2026-09-01:
+"Don't add growth docs to docs"): growth is its own system — its plans and specs live in
+`drawbridge-growth/docs/superpowers/{plans,specs}/` and must **never** be written to
+drawbridge-docs. The guard hook exempts any `drawbridge-growth*` path for this reason.
+
+For every other repo, this is the **only** allowed home for these working docs. Rules:
 
 - Do **not** create or keep superpowers plans/specs (or `docs/superpowers/`, `docs/plans/`)
   inside any other repo. When you finalize a plan or spec, write it under

package/hooks/guard-superpowers-docs.js

@@ -47,6 +47,11 @@ const run = () => {
   // drawbridge-docs is the canonical home — anything there is fine.
   if (resolved.split('/').includes('drawbridge-docs')) process.exit(0)
 
+  // GROWTH IS THE EXCEPTION (Darren, repeatedly, most recently 2026-09-01):
+  // growth is its own system and its docs stay in drawbridge-growth — never
+  // in drawbridge-docs. Any growth checkout or worktree passes.
+  if (/\/drawbridge-growth[^/]*\//.test(resolved + '/')) process.exit(0)
+
   const hit = FORBIDDEN.find((seg) => resolved.includes('/' + seg + '/') || resolved.endsWith('/' + seg))
   if (!hit) process.exit(0)
 

package/package.json

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