create-ailk 0.1.0 → 0.2.0

package/templates/database/migrations/20260714010000_add_usage_billing_content_models/migration.sql

@@ -0,0 +1,151 @@
+-- Usage-billing metering: UsageEvent + UsagePeriod + UsageBillingReport
+-- (content namespace, FEAT-047 P1.S1, #3709 — Epic #3704).
+--
+-- Three new tables, hand-authored (no live DB available to run
+-- `prisma migrate dev`, mirroring 20260714000000_add_lead_promotion_fields).
+--
+-- Per ADR 0009 D2 (roadmap §4), the metering event + its org-level aggregates
+-- live in `content`; balances/plans (S2) live in auth/config. organization_id/
+-- workspace_id/user_id are plain TEXT stable-ids — no FK into auth (ADR 0009
+-- invariant 1). Field roster ported from
+-- docs/research/wt-billing-capture/schema.md, modeled on WT's TraceLog billing
+-- columns (spec D1), with workspace_id/user_id added to the event grain
+-- (spec D2).
+--
+-- Per ADR 0031 (entity id strategy): every generated primary key is a
+-- prefixed UUIDv7 (COLLATE "C" + a format CHECK). usage_events/usage_periods/
+-- usage_billing_reports mint id via the shared uuidv7() function
+-- (20260713192000_add_uuidv7_function). The three prefixes (usagev_/usagper_/
+-- usagrept_) are NOT YET added to @working-theory/ids' central registry
+-- (packages/ids/src/registry.ts) — that registry-row + the TS branded-id/Zod
+-- helpers are deferred to the P2/S2 service-layer work that will actually
+-- construct/validate these ids in application code (this is a schema-only
+-- unit, spec §2.3). The format CHECK constraints below are added now
+-- regardless, matching ADR 0031 rule 4 (every id column format-enforced),
+-- and using ALREADY-registered prefixes for the cross-namespace scope
+-- columns (org_/wksp_/user_ — no new registry entries needed for those).
+--
+-- Zero-data, additive-only: three brand-new tables, no existing table is
+-- altered. Only `onDemandCents`/`onDemandPortionCents` are ever reported to
+-- Stripe (P4, spec D4) — the other attribution-split columns are
+-- informational.
+--
+-- Rollback:
+--   DROP TABLE "usage_billing_reports";
+--   DROP TABLE "usage_periods";
+--   DROP TABLE "usage_events";
+--   DROP TYPE "UsageBillingStatus";
+--   DROP TYPE "ModelTier";
+
+-- CreateEnum
+CREATE TYPE "ModelTier" AS ENUM ('BASE', 'PREMIUM', 'FRONTIER');
+
+-- CreateEnum
+CREATE TYPE "UsageBillingStatus" AS ENUM ('PENDING', 'REPORTED', 'INVOICED', 'PAID', 'FAILED');
+
+-- CreateTable
+CREATE TABLE "usage_events" (
+    "id" TEXT COLLATE "C" NOT NULL DEFAULT ('usagev_'::text || (uuidv7())::text),
+    "organization_id" TEXT COLLATE "C" NOT NULL,
+    "workspace_id" TEXT COLLATE "C" NOT NULL,
+    "user_id" TEXT COLLATE "C" NOT NULL,
+    "provider" TEXT NOT NULL,
+    "model" TEXT NOT NULL,
+    "input_tokens_cache_write" INTEGER NOT NULL,
+    "input_tokens_no_cache_write" INTEGER NOT NULL,
+    "cache_read_tokens" INTEGER NOT NULL,
+    "output_tokens" INTEGER NOT NULL,
+    "thinking_tokens" INTEGER NOT NULL,
+    "total_tokens" INTEGER NOT NULL,
+    "provider_cost_usd" DECIMAL(10,6) NOT NULL,
+    "billed_cost_usd" DECIMAL(10,6) NOT NULL,
+    "markup_percent" DECIMAL(5,2) NOT NULL,
+    "model_tier" "ModelTier" NOT NULL DEFAULT 'BASE',
+    "was_auto_model" BOOLEAN NOT NULL,
+    "included_portion_cents" INTEGER NOT NULL DEFAULT 0,
+    "credit_balance_portion_cents" INTEGER NOT NULL DEFAULT 0,
+    "on_demand_portion_cents" INTEGER NOT NULL DEFAULT 0,
+    "completion_status" TEXT NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "usage_events_pkey" PRIMARY KEY ("id"),
+    CONSTRAINT "usage_events_id_format" CHECK ("id" ~ '^usagev_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$'),
+    CONSTRAINT "usage_events_organization_id_format" CHECK ("organization_id" ~ '^org_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$'),
+    CONSTRAINT "usage_events_workspace_id_format" CHECK ("workspace_id" ~ '^wksp_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$'),
+    CONSTRAINT "usage_events_user_id_format" CHECK ("user_id" ~ '^user_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$')
+);
+
+-- CreateTable
+CREATE TABLE "usage_periods" (
+    "id" TEXT COLLATE "C" NOT NULL DEFAULT ('usagper_'::text || (uuidv7())::text),
+    "organization_id" TEXT COLLATE "C" NOT NULL,
+    "period_start" TIMESTAMP(3) NOT NULL,
+    "period_end" TIMESTAMP(3) NOT NULL,
+    "tokens_consumed" BIGINT NOT NULL DEFAULT 0,
+    "base_tokens_consumed" BIGINT NOT NULL DEFAULT 0,
+    "premium_tokens_consumed" BIGINT NOT NULL DEFAULT 0,
+    "frontier_tokens_consumed" BIGINT NOT NULL DEFAULT 0,
+    "usage_spend_cents" INTEGER NOT NULL DEFAULT 0,
+
+    CONSTRAINT "usage_periods_pkey" PRIMARY KEY ("id"),
+    CONSTRAINT "usage_periods_id_format" CHECK ("id" ~ '^usagper_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$'),
+    CONSTRAINT "usage_periods_organization_id_format" CHECK ("organization_id" ~ '^org_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$')
+);
+
+-- CreateTable
+CREATE TABLE "usage_billing_reports" (
+    "id" TEXT COLLATE "C" NOT NULL DEFAULT ('usagrept_'::text || (uuidv7())::text),
+    "organization_id" TEXT COLLATE "C" NOT NULL,
+    "period_start" TIMESTAMP(3) NOT NULL,
+    "period_end" TIMESTAMP(3) NOT NULL,
+    "total_provider_cost" DECIMAL(10,6) NOT NULL,
+    "total_markup_amount" DECIMAL(10,6) NOT NULL,
+    "total_billed_amount" DECIMAL(10,6) NOT NULL,
+    "total_tokens" INTEGER NOT NULL,
+    "event_count" INTEGER NOT NULL,
+    "included_cents" INTEGER NOT NULL DEFAULT 0,
+    "credit_balance_cents" INTEGER NOT NULL DEFAULT 0,
+    "on_demand_cents" INTEGER NOT NULL DEFAULT 0,
+    "stripe_usage_record_id" TEXT,
+    "reported_to_stripe_at" TIMESTAMP(3),
+    "stripe_invoice_id" TEXT,
+    "status" "UsageBillingStatus" NOT NULL DEFAULT 'PENDING',
+    "error_message" TEXT,
+
+    CONSTRAINT "usage_billing_reports_pkey" PRIMARY KEY ("id"),
+    CONSTRAINT "usage_billing_reports_id_format" CHECK ("id" ~ '^usagrept_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$'),
+    CONSTRAINT "usage_billing_reports_organization_id_format" CHECK ("organization_id" ~ '^org_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$')
+);
+
+-- CreateIndex
+CREATE INDEX "usage_events_organization_id_created_at_idx" ON "usage_events"("organization_id", "created_at");
+
+-- CreateIndex
+CREATE INDEX "usage_events_workspace_id_created_at_idx" ON "usage_events"("workspace_id", "created_at");
+
+-- CreateIndex
+CREATE INDEX "usage_events_user_id_created_at_idx" ON "usage_events"("user_id", "created_at");
+
+-- CreateIndex
+CREATE INDEX "usage_events_provider_model_idx" ON "usage_events"("provider", "model");
+
+-- CreateIndex
+CREATE INDEX "usage_events_model_tier_was_auto_model_idx" ON "usage_events"("model_tier", "was_auto_model");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "usage_periods_organization_id_period_start_key" ON "usage_periods"("organization_id", "period_start");
+
+-- CreateIndex
+CREATE INDEX "usage_periods_tier_tracking_idx" ON "usage_periods"("base_tokens_consumed", "premium_tokens_consumed", "frontier_tokens_consumed");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "usage_billing_reports_period_key" ON "usage_billing_reports"("organization_id", "period_start", "period_end");
+
+-- CreateIndex
+CREATE INDEX "usage_billing_reports_organization_id_status_idx" ON "usage_billing_reports"("organization_id", "status");
+
+-- CreateIndex
+CREATE INDEX "usage_billing_reports_status_idx" ON "usage_billing_reports"("status");
+
+-- CreateIndex
+CREATE INDEX "usage_billing_reports_period_start_idx" ON "usage_billing_reports"("period_start");

package/templates/database/migrations/20260714020000_add_usage_billing_auth_config_models/migration.sql

@@ -0,0 +1,223 @@
+-- Usage-billing balances/subscription/plan (auth) + pricing/markup/model
+-- config (config namespace, FEAT-047 P1.S2, #3710 — Epic #3704). Applies
+-- after S1's 20260714010000_add_usage_billing_content_models (Blocked-by
+-- #3709 — shared generated migrations folder ordering only; the model sets
+-- are namespace-disjoint).
+--
+-- Hand-authored (no live DB available to run `prisma migrate dev`, mirroring
+-- 20260714000000_add_lead_promotion_fields and S1's
+-- 20260714010000_add_usage_billing_content_models).
+--
+-- Per ADR 0009 D2 (roadmap §4), billing balances/subscription/plan live in
+-- `auth` (identity+tenancy charter); pricing/markup/model config lives in
+-- `config`. organization_id/plan_id are plain TEXT stable-ids — no FK across
+-- or within the auth namespace (spec D4: billing writes are keyed on
+-- explicit id, not relation traversal, mirroring the sanctioned
+-- usage-credits.ts / entitlements.ts / webhooks/stripe.ts read/write shape).
+-- Field roster ported from docs/research/wt-billing-capture/schema.md.
+--
+-- Per ADR 0031 (entity id strategy): every generated primary key is a
+-- prefixed UUIDv7 (COLLATE "C" + a format CHECK). The seven new prefixes
+-- (orgsub_/plan_/usgset_/markup_/llmprc_/llmmdl_/hbyrst_) are NOT YET added
+-- to @working-theory/ids' central registry (packages/ids/src/registry.ts) —
+-- deferred to the P2+ service-layer work that will actually construct/
+-- validate these ids in application code (this is a schema-only unit, spec
+-- §2.3), mirroring S1's identical deferral for usagev_/usagper_/usagrept_.
+-- The format CHECK constraints below are added now regardless (rule 4),
+-- using the same uuidv7() function shipped in 20260713192000_add_uuidv7_function.
+-- Subscription.plan_id (a relation-free scope/id reference column, spec D4)
+-- also gets a format CHECK against the plan_ prefix.
+--
+-- Zero-data, additive-only: seven brand-new tables plus ten new
+-- nullable/defaulted columns on "organizations" — no existing row needs a
+-- backfill.
+--
+-- Rollback:
+--   DROP TABLE "hobby_reset_trackers";
+--   DROP TABLE "llm_models";
+--   DROP TABLE "llm_model_pricing";
+--   DROP TABLE "ai_markup_configs";
+--   DROP TABLE "usage_settings";
+--   DROP TABLE "plans";
+--   DROP TABLE "subscriptions";
+--   DROP TYPE "ContractType";
+--   DROP TYPE "BillingCycle";
+--   DROP TYPE "SubscriptionPaymentMode";
+--   DROP TYPE "BillingMode";
+--   ALTER TABLE "organizations" DROP COLUMN "limit_allocation_mode";
+--   ALTER TABLE "organizations" DROP COLUMN "credits_cycle_end";
+--   ALTER TABLE "organizations" DROP COLUMN "on_demand_credit_balance_cents";
+--   ALTER TABLE "organizations" DROP COLUMN "on_demand_precharged_cents";
+--   ALTER TABLE "organizations" DROP COLUMN "on_demand_used_cents";
+--   ALTER TABLE "organizations" DROP COLUMN "on_demand_limit_cents";
+--   ALTER TABLE "organizations" DROP COLUMN "included_credits_used_cents";
+--   ALTER TABLE "organizations" DROP COLUMN "included_credits_cents";
+--   ALTER TABLE "organizations" DROP COLUMN "stripe_usage_meter_item_id";
+--   ALTER TABLE "organizations" DROP COLUMN "usage_billing_enabled";
+
+-- CreateEnum
+CREATE TYPE "BillingMode" AS ENUM ('INDIVIDUAL', 'ORGANIZATION');
+
+-- CreateEnum
+CREATE TYPE "SubscriptionPaymentMode" AS ENUM ('CARD', 'INVOICE');
+
+-- CreateEnum
+CREATE TYPE "BillingCycle" AS ENUM ('MONTHLY', 'YEARLY');
+
+-- CreateEnum
+CREATE TYPE "ContractType" AS ENUM ('SELF_SERVE', 'SALES_ASSISTED', 'ENTERPRISE');
+
+-- AlterTable — Organization Company-counter balance fields (capture D6)
+ALTER TABLE "organizations" ADD COLUMN "usage_billing_enabled" BOOLEAN NOT NULL DEFAULT false,
+                            ADD COLUMN "stripe_usage_meter_item_id" TEXT,
+                            ADD COLUMN "included_credits_cents" INTEGER NOT NULL DEFAULT 0,
+                            ADD COLUMN "included_credits_used_cents" INTEGER NOT NULL DEFAULT 0,
+                            ADD COLUMN "on_demand_limit_cents" INTEGER,
+                            ADD COLUMN "on_demand_used_cents" INTEGER NOT NULL DEFAULT 0,
+                            ADD COLUMN "on_demand_precharged_cents" INTEGER NOT NULL DEFAULT 0,
+                            ADD COLUMN "on_demand_credit_balance_cents" INTEGER NOT NULL DEFAULT 0,
+                            ADD COLUMN "credits_cycle_end" TIMESTAMP(3),
+                            ADD COLUMN "limit_allocation_mode" TEXT NOT NULL DEFAULT 'COMPANY_WIDE';
+
+-- CreateTable
+CREATE TABLE "subscriptions" (
+    "id" TEXT COLLATE "C" NOT NULL DEFAULT ('orgsub_'::text || (uuidv7())::text),
+    "organization_id" TEXT COLLATE "C" NOT NULL,
+    "plan_id" TEXT COLLATE "C" NOT NULL,
+    "stripe_subscription_id" TEXT,
+    "stripe_price_id" TEXT,
+    "stripe_customer_id" TEXT,
+    "contract_type" "ContractType",
+    "net_terms_days" INTEGER,
+    "contract_value_cents" INTEGER,
+    "payment_mode" "SubscriptionPaymentMode",
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "subscriptions_pkey" PRIMARY KEY ("id"),
+    CONSTRAINT "subscriptions_id_format" CHECK ("id" ~ '^orgsub_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$'),
+    CONSTRAINT "subscriptions_organization_id_format" CHECK ("organization_id" ~ '^org_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$'),
+    CONSTRAINT "subscriptions_plan_id_format" CHECK ("plan_id" ~ '^plan_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$')
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "subscriptions_organization_id_key" ON "subscriptions"("organization_id");
+
+-- CreateTable
+CREATE TABLE "plans" (
+    "id" TEXT COLLATE "C" NOT NULL DEFAULT ('plan_'::text || (uuidv7())::text),
+    "slug" TEXT NOT NULL,
+    "tier" INTEGER NOT NULL,
+    "base_tokens" INTEGER NOT NULL,
+    "usage_multiplier" DECIMAL(5,2) NOT NULL,
+    "is_pooled" BOOLEAN NOT NULL,
+    "monthly_dollar_credit_cents" INTEGER NOT NULL,
+    "features" JSONB NOT NULL,
+    "limits" JSONB NOT NULL,
+    "stripe_price_id" TEXT,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "plans_pkey" PRIMARY KEY ("id"),
+    CONSTRAINT "plans_id_format" CHECK ("id" ~ '^plan_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$')
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "plans_slug_key" ON "plans"("slug");
+
+-- CreateTable
+CREATE TABLE "usage_settings" (
+    "id" TEXT COLLATE "C" NOT NULL DEFAULT ('usgset_'::text || (uuidv7())::text),
+    "organization_id" TEXT COLLATE "C" NOT NULL,
+    "usage_based_billing_enabled" BOOLEAN NOT NULL DEFAULT false,
+    "monthly_spend_limit_cents" INTEGER,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "usage_settings_pkey" PRIMARY KEY ("id"),
+    CONSTRAINT "usage_settings_id_format" CHECK ("id" ~ '^usgset_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$'),
+    CONSTRAINT "usage_settings_organization_id_format" CHECK ("organization_id" ~ '^org_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$')
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "usage_settings_organization_id_key" ON "usage_settings"("organization_id");
+
+-- CreateTable
+CREATE TABLE "ai_markup_configs" (
+    "id" TEXT COLLATE "C" NOT NULL DEFAULT ('markup_'::text || (uuidv7())::text),
+    "organization_id" TEXT COLLATE "C" NOT NULL,
+    "provider" TEXT,
+    "model" TEXT,
+    "markup_percent" DECIMAL(5,2) NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "ai_markup_configs_pkey" PRIMARY KEY ("id"),
+    CONSTRAINT "ai_markup_configs_id_format" CHECK ("id" ~ '^markup_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$'),
+    CONSTRAINT "ai_markup_configs_organization_id_format" CHECK ("organization_id" ~ '^org_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$')
+);
+
+-- CreateIndex
+-- Null provider+model = org default; null model = provider-wide; both set =
+-- model-specific (spec §2.1 item 5). SQL NULL <> NULL, so multiple
+-- (organization_id, NULL, NULL) rows are not rejected at this constraint --
+-- the "one default per org" invariant is a service-layer concern (spec does
+-- not require NULLS NOT DISTINCT).
+CREATE UNIQUE INDEX "ai_markup_configs_organization_id_provider_model_key" ON "ai_markup_configs"("organization_id", "provider", "model");
+
+-- CreateTable
+CREATE TABLE "llm_model_pricing" (
+    "id" TEXT COLLATE "C" NOT NULL DEFAULT ('llmprc_'::text || (uuidv7())::text),
+    "provider" TEXT NOT NULL,
+    "model" TEXT NOT NULL,
+    "input_price_per_million" DECIMAL(10,4) NOT NULL,
+    "output_price_per_million" DECIMAL(10,4) NOT NULL,
+    "cached_input_price_per_million" DECIMAL(10,4),
+    "effective_from" TIMESTAMP(3) NOT NULL,
+    "effective_to" TIMESTAMP(3),
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "llm_model_pricing_pkey" PRIMARY KEY ("id"),
+    CONSTRAINT "llm_model_pricing_id_format" CHECK ("id" ~ '^llmprc_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$')
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "llm_model_pricing_provider_model_effective_from_key" ON "llm_model_pricing"("provider", "model", "effective_from");
+
+-- CreateTable
+CREATE TABLE "llm_models" (
+    "id" TEXT COLLATE "C" NOT NULL DEFAULT ('llmmdl_'::text || (uuidv7())::text),
+    "provider" TEXT NOT NULL,
+    "model" TEXT NOT NULL,
+    "tier" "ModelTier" NOT NULL,
+    "consumption_multiplier" DECIMAL(5,2) NOT NULL DEFAULT 1.0,
+    "charge_extended_context_at_2x" BOOLEAN NOT NULL,
+    "is_auto_model" BOOLEAN NOT NULL,
+    "default_context" INTEGER NOT NULL,
+    "max_context" INTEGER NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "llm_models_pkey" PRIMARY KEY ("id"),
+    CONSTRAINT "llm_models_id_format" CHECK ("id" ~ '^llmmdl_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$')
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "llm_models_provider_model_key" ON "llm_models"("provider", "model");
+
+-- CreateTable
+CREATE TABLE "hobby_reset_trackers" (
+    "id" TEXT COLLATE "C" NOT NULL DEFAULT ('hbyrst_'::text || (uuidv7())::text),
+    "organization_id" TEXT COLLATE "C" NOT NULL,
+    "last_reset_at" TIMESTAMP(3) NOT NULL,
+    "next_reset_at" TIMESTAMP(3) NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "hobby_reset_trackers_pkey" PRIMARY KEY ("id"),
+    CONSTRAINT "hobby_reset_trackers_id_format" CHECK ("id" ~ '^hbyrst_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$'),
+    CONSTRAINT "hobby_reset_trackers_organization_id_format" CHECK ("organization_id" ~ '^org_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$')
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "hobby_reset_trackers_organization_id_key" ON "hobby_reset_trackers"("organization_id");

package/templates/database/migrations/20260714030000_credit_balance_non_negative/migration.sql

@@ -0,0 +1,22 @@
+-- FEAT-047 P3.S1 hardening (#3730) — defence-in-depth backstop for the credit
+-- waterfall's zero-clamp + compare-and-swap (apps/api/src/services/usage-credits.ts).
+--
+-- The service is the primary control: it clamps both derived availabilities to
+-- zero and debits via a conditional UPDATE whose predicate restates every
+-- column the read observed. This CHECK is the backstop against a FUTURE writer
+-- that does not go through the service.
+--
+-- Safe to add now: the column is `Int DEFAULT 0` and has no writers on `main`
+-- (verified — nothing calls consumeCredits), so no existing row can violate it.
+ALTER TABLE "organizations"
+  ADD CONSTRAINT "organizations_on_demand_credit_balance_non_negative"
+  CHECK ("on_demand_credit_balance_cents" >= 0);
+
+-- ⚠️ DELIBERATELY ABSENT: CHECK ("included_credits_used_cents" <= "included_credits_cents").
+-- `used > included` is a LEGITIMATE, EXPECTED state produced by any mid-cycle
+-- plan DOWNGRADE (Pro 10000/5000-used → Basic 1000) with no bug present. That
+-- constraint would make the downgrade fail AT THE DATABASE — converting a normal
+-- billing operation into a self-inflicted outage on the plan-change path.
+-- The invariant that actually matters is not "used <= included" on the row; it is
+-- "the debit never reads a negative availability" at the COMPUTATION — which is
+-- the service's Math.max(0, …) zero-clamp. See spec D3 (#3730).

package/templates/database/migrations/20260714030000_widen_usage_billing_report_aggregates/migration.sql

@@ -0,0 +1,32 @@
+-- Widen the UsageBillingReport AGGREGATE columns (#3738 H2).
+--
+-- The aggregate columns were sized as if they held ONE event rather than a
+-- month of them — they reused UsageEvent's per-event precision:
+--
+--   total_provider_cost  numeric(10,6)  -> max     9,999.999999
+--   total_billed_amount  numeric(10,6)  -> max     9,999.999999
+--   total_markup_amount  numeric(10,6)  -> max     9,999.999999
+--   total_tokens         integer        -> max 2,147,483,647
+--
+-- Consequence: an organization whose month crossed $10,000.00 of provider
+-- spend (or ~2.15B tokens — roughly 700k requests at 3k tokens, i.e. one busy
+-- tenant) overflowed the column. The aggregation upsert threw, the service
+-- fail-closed, and the UsageBillingReport for that org was then NEVER written
+-- on any subsequent run — permanently. Since the P4 Stripe report derives from
+-- that row, revenue silently stopped for precisely the largest customers, and
+-- the failure grew monotonically worse each month.
+--
+-- This migration is FORWARD-ADDITIVE and NON-DESTRUCTIVE: widening a numeric's
+-- precision and promoting int4 -> int8 are both widening conversions in
+-- Postgres. Every existing row is preserved exactly; no value can be truncated
+-- by a widening, so no backfill or data migration is required.
+--
+-- The already-merged 20260714010000_add_usage_billing_content_models migration
+-- is on main and is deliberately left untouched.
+
+-- AlterTable
+ALTER TABLE "usage_billing_reports"
+  ALTER COLUMN "total_provider_cost" TYPE DECIMAL(20,6),
+  ALTER COLUMN "total_markup_amount" TYPE DECIMAL(20,6),
+  ALTER COLUMN "total_billed_amount" TYPE DECIMAL(20,6),
+  ALTER COLUMN "total_tokens" TYPE BIGINT;

package/templates/database/migrations/20260810233516_add_flow_engine_models/migration.sql

@@ -0,0 +1,40 @@
+-- CreateTable
+CREATE TABLE "flow_definitions" (
+    "id" TEXT NOT NULL DEFAULT ('flow_'::text || (uuidv7())::text),
+    "site_id" TEXT NOT NULL,
+    "slug" TEXT NOT NULL,
+    "config" JSONB NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "flow_definitions_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "flow_sessions" (
+    "id" TEXT NOT NULL DEFAULT ('flsess_'::text || (uuidv7())::text),
+    "site_id" TEXT NOT NULL,
+    "flow_id" TEXT NOT NULL,
+    "flow_slug" TEXT NOT NULL,
+    "config_snapshot" JSONB NOT NULL,
+    "state" JSONB NOT NULL DEFAULT '{}',
+    "email" TEXT,
+    "lead_id" TEXT,
+    "completed_at" TIMESTAMP(3),
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "flow_sessions_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "flow_definitions_site_id_slug_key" ON "flow_definitions"("site_id", "slug");
+
+-- CreateIndex
+CREATE INDEX "flow_sessions_site_id_idx" ON "flow_sessions"("site_id");
+
+-- CreateIndex
+CREATE INDEX "flow_sessions_site_id_completed_at_idx" ON "flow_sessions"("site_id", "completed_at");
+
+-- CreateIndex
+CREATE INDEX "flow_sessions_email_idx" ON "flow_sessions"("email");

package/templates/database/migrations/20260811020000_add_flow_session_abandon_email_columns/migration.sql

@@ -0,0 +1,4 @@
+-- AlterTable
+ALTER TABLE "flow_sessions" ADD COLUMN     "locale" TEXT,
+ADD COLUMN     "abandon_email_status" TEXT,
+ADD COLUMN     "abandon_email_at" TIMESTAMP(3);

package/templates/database/migrations/20260811030000_add_flow_session_abandon_email_index/migration.sql

@@ -0,0 +1,2 @@
+-- CreateIndex
+CREATE INDEX "flow_sessions_flow_id_completed_at_abandon_email_status_idx" ON "flow_sessions"("flow_id", "completed_at", "abandon_email_status");

package/templates/database/migrations/20260811040000_add_flow_session_segment/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "flow_sessions" ADD COLUMN     "segment" TEXT;

package/templates/database/migrations/20260811050000_add_deliverable_models/migration.sql

@@ -0,0 +1,29 @@
+-- CreateTable
+CREATE TABLE "deliverable_assets" (
+    "id" TEXT NOT NULL DEFAULT ('dasset_'::text || (uuidv7())::text),
+    "site_id" TEXT NOT NULL,
+    "key" TEXT NOT NULL,
+    "filename" TEXT NOT NULL,
+    "content_type" TEXT NOT NULL,
+    "bytes" BYTEA NOT NULL,
+    "size" INTEGER NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "deliverable_assets_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "deliverable_grants" (
+    "id" TEXT NOT NULL DEFAULT ('dgrant_'::text || (uuidv7())::text),
+    "site_id" TEXT NOT NULL,
+    "asset_id" TEXT NOT NULL,
+    "lead_id" TEXT NOT NULL,
+    "session_id" TEXT NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "deliverable_grants_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "deliverable_assets_site_id_key_key" ON "deliverable_assets"("site_id", "key");

package/templates/database/migrations/20260812000000_add_deliverable_grant_send_columns/migration.sql

@@ -0,0 +1,6 @@
+-- AlterTable
+ALTER TABLE "deliverable_grants" ADD COLUMN     "send_at" TIMESTAMP(3),
+ADD COLUMN     "send_status" TEXT;
+
+-- CreateIndex
+CREATE INDEX "deliverable_grants_site_id_send_status_idx" ON "deliverable_grants"("site_id", "send_status");

package/templates/database/migrations/20260902222948_add_waitlist_experiment_models/migration.sql

@@ -0,0 +1,39 @@
+-- CreateTable
+CREATE TABLE "waitlist_experiments" (
+    "id" TEXT NOT NULL DEFAULT ('wlexp_'::text || (uuidv7())::text),
+    "site_id" TEXT NOT NULL,
+    "key" TEXT NOT NULL,
+    "mode" TEXT NOT NULL,
+    "status" TEXT NOT NULL,
+    "config" JSONB NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "waitlist_experiments_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "waitlist_scores" (
+    "id" TEXT NOT NULL DEFAULT ('wlscore_'::text || (uuidv7())::text),
+    "site_id" TEXT NOT NULL,
+    "lead_id" TEXT NOT NULL,
+    "experiment_key" TEXT NOT NULL,
+    "waitlist_key" TEXT NOT NULL,
+    "tier" TEXT NOT NULL,
+    "score" INTEGER NOT NULL,
+    "category_scores" JSONB NOT NULL,
+    "rule_trace" JSONB NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "waitlist_scores_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "waitlist_experiments_site_id_key_key" ON "waitlist_experiments"("site_id", "key");
+
+-- CreateIndex
+CREATE INDEX "waitlist_scores_site_id_experiment_key_waitlist_key_idx" ON "waitlist_scores"("site_id", "experiment_key", "waitlist_key");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "waitlist_scores_lead_id_key" ON "waitlist_scores"("lead_id");

package/templates/database/migrations/20260902224500_add_waitlist_id_format_checks/migration.sql

@@ -0,0 +1,24 @@
+-- ADR-0031 rule-3 completion for A1's waitlist-experiment models (#4661,
+-- flagged on #4661/#4671, closed by #4674).
+--
+-- 20260902222948_add_waitlist_experiment_models minted `waitlist_experiments`
+-- and `waitlist_scores` with a `wlexp_`/`wlscore_` dbgenerated default but
+-- registered neither prefix in @working-theory/ids nor added the `_id_format`
+-- CHECK constraint every other ADR-0031 entity carries. Both prefixes are now
+-- registered in packages/ids/src/registry.ts (ENTITY_PREFIX.waitlistExperiment
+-- / .waitlistScore) — this migration closes the database side, mirroring
+-- 20260713192429_prefixed_uuid_entity_ids/migration.sql lines 28–38 (COLLATE
+-- "C" + SET DEFAULT re-assertion + CHECK, per entity).
+--
+-- Zero-data, additive-only: both tables were created in the immediately
+-- preceding migration, so no existing row can violate the new CHECKs.
+
+-- waitlist_experiments: wlexp_
+ALTER TABLE "waitlist_experiments" ALTER COLUMN "id" TYPE text COLLATE "C";
+ALTER TABLE "waitlist_experiments" ALTER COLUMN "id" SET DEFAULT ('wlexp_'::text || (uuidv7())::text);
+ALTER TABLE "waitlist_experiments" ADD CONSTRAINT "waitlist_experiments_id_format" CHECK ("id" ~ '^wlexp_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$');
+
+-- waitlist_scores: wlscore_
+ALTER TABLE "waitlist_scores" ALTER COLUMN "id" TYPE text COLLATE "C";
+ALTER TABLE "waitlist_scores" ALTER COLUMN "id" SET DEFAULT ('wlscore_'::text || (uuidv7())::text);
+ALTER TABLE "waitlist_scores" ADD CONSTRAINT "waitlist_scores_id_format" CHECK ("id" ~ '^wlscore_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$');

package/templates/database/migrations/20260903004112_add_flow_session_flags_aeo_score/migration.sql

@@ -0,0 +1,3 @@
+-- AlterTable
+ALTER TABLE "flow_sessions" ADD COLUMN     "aeo_score" JSONB,
+ADD COLUMN     "flags" JSONB NOT NULL DEFAULT '{}';

package/templates/database/migrations/20260903010000_add_playbook_instance/migration.sql

@@ -0,0 +1,33 @@
+-- FEAT-074 U4a (#4715) — PlaybookInstance: a compiled, person-scoped
+-- Playbook, append-only per lead. Mirrors the shape of
+-- 20260902222948_add_waitlist_experiment_models (CreateTable + CreateIndex)
+-- immediately followed by the ADR-0031 rule-3 id-format completion
+-- 20260902224500_add_waitlist_id_format_checks applied to `waitlist_scores`
+-- — done in ONE migration here since the table is new (no retrofit needed).
+
+-- CreateTable
+CREATE TABLE "playbook_instances" (
+    "id" TEXT NOT NULL DEFAULT ('pbk_'::text || (uuidv7())::text),
+    "site_id" TEXT NOT NULL,
+    "lead_id" TEXT NOT NULL,
+    "experiment_key" TEXT NOT NULL,
+    "score_id" TEXT NOT NULL,
+    "tier" TEXT NOT NULL,
+    "level" INTEGER NOT NULL,
+    "rule_trace" JSONB NOT NULL,
+    "source" JSONB NOT NULL,
+    "markdown" TEXT NOT NULL,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "playbook_instances_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "playbook_instances_site_id_lead_id_created_at_idx" ON "playbook_instances"("site_id", "lead_id", "created_at");
+
+-- ADR-0031 rule 3 — playbook_instances: pbk_ (registered in
+-- packages/ids/src/registry.ts ENTITY_PREFIX.playbookInstance; this
+-- migration's path is added to migration-sync.test.ts's PK_CHECK_MIGRATIONS).
+ALTER TABLE "playbook_instances" ALTER COLUMN "id" TYPE text COLLATE "C";
+ALTER TABLE "playbook_instances" ALTER COLUMN "id" SET DEFAULT ('pbk_'::text || (uuidv7())::text);
+ALTER TABLE "playbook_instances" ADD CONSTRAINT "playbook_instances_id_format" CHECK ("id" ~ '^pbk_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$');