create-ailk 0.1.0

package/templates/database/migrations/20260515000000_add_user_billing_fields/migration.sql

@@ -0,0 +1,28 @@
+-- Add User billing identity fields (#854)
+--
+-- Adds two provider-agnostic billing columns to the `users` table and a
+-- composite unique index over (billing_provider, billing_customer_id).
+--
+-- Motivation: the Stripe webhook handler (apps/api/src/routes/webhooks/stripe.ts)
+-- upserts these fields on customer.created / checkout.session.completed events.
+-- The #771 self-serve dashboard reads billing_customer_id to build the Stripe
+-- customer-portal URL without a live Stripe API call on every page load.
+--
+-- Design decisions (locked in closed #732 + docs/internal/decisions/ailk-mvp-scope-2026-05-15.md):
+--   - "billing_provider" not "stripe_provider" — provider-agnostic; v1 value is "stripe"
+--   - Nullable: webhook is the only writer; signup does not pre-populate
+--   - Composite unique allows (NULL, NULL) for pre-billing users (SQL NULL ≠ NULL)
+--   - NO Purchase/Subscription tables — aggregate billing state deferred to Phase B (#852)
+--
+-- Rollback: drop the index then the two columns.
+--   ALTER TABLE "users" DROP CONSTRAINT "users_billing_provider_billing_customer_id_key";
+--   ALTER TABLE "users" DROP COLUMN "billing_provider";
+--   ALTER TABLE "users" DROP COLUMN "billing_customer_id";
+
+-- AlterTable
+ALTER TABLE "users" ADD COLUMN "billing_provider" TEXT,
+                    ADD COLUMN "billing_customer_id" TEXT;
+
+-- CreateIndex
+ALTER TABLE "users" ADD CONSTRAINT "users_billing_provider_billing_customer_id_key"
+  UNIQUE ("billing_provider", "billing_customer_id");

package/templates/database/migrations/20260516000000_add_user_tier_care_plan_seat/migration.sql

@@ -0,0 +1,25 @@
+-- Add User tier projection columns (#898)
+--
+-- Adds three columns to the `users` table that mirror the projection the
+-- @working-theory/billing webhook handler maintains in-memory today. The Stripe
+-- customer.subscription.created / customer.subscription.updated handlers
+-- write these via product-aware routing: read subscription.items[0].price.product,
+-- reverse-look up the tier from the STRIPE_PRODUCT_IDS map, then set:
+--
+--   - tier            from the resolved tier name (pro / pro_plus / etc.)
+--   - has_care_plan   true iff tier == "pro_plus" (care plan is bundled, not a SKU)
+--   - seat_count      from subscription.items[0].quantity (1–50 per the
+--                     adjustable-quantity widget on Stripe Checkout)
+--
+-- Defaults keep pre-billing users at the free tier with one seat, matching
+-- the read-side expectation that every user has a tier (no NULLs).
+--
+-- Rollback:
+--   ALTER TABLE "users" DROP COLUMN "seat_count";
+--   ALTER TABLE "users" DROP COLUMN "has_care_plan";
+--   ALTER TABLE "users" DROP COLUMN "tier";
+
+-- AlterTable
+ALTER TABLE "users" ADD COLUMN "tier" TEXT NOT NULL DEFAULT 'free',
+                    ADD COLUMN "has_care_plan" BOOLEAN NOT NULL DEFAULT false,
+                    ADD COLUMN "seat_count" INTEGER NOT NULL DEFAULT 1;

package/templates/database/migrations/20260518000000_add_telemetry_records/migration.sql

@@ -0,0 +1,42 @@
+-- Add telemetry_records table for opt-in seat-usage telemetry (S2 #1031)
+--
+-- Stores time-series records from customer deployments when AILK_TELEMETRY=1.
+-- Written by POST /telemetry on apps-paid/license-issuer. Enables queries
+-- computing the distribution of active_user_count / seat_count across the
+-- customer base over a time window — the S2 trigger condition for revisiting
+-- Option A (per the brief at docs/internal/decisions/2026-05-18-seat-billing-honor-system-launch.md).
+--
+-- Columns:
+--   id              — CUID primary key
+--   customer_id     — opaque customer identifier (Stripe customer ID)
+--   active_user_count — active users observed in the deployment
+--   seat_count      — licensed seat count from the billing record
+--   timestamp       — client-side observation time (from the telemetry payload)
+--   recorded_at     — server-side receipt time (default now())
+--
+-- Indexes:
+--   (customer_id, recorded_at DESC) — "latest record per customer" queries
+--   (recorded_at DESC)              — time-window aggregate queries
+--
+-- Rollback:
+--   DROP INDEX "telemetry_records_recorded_at_idx";
+--   DROP INDEX "telemetry_records_customer_id_recorded_at_idx";
+--   DROP TABLE "telemetry_records";
+
+-- CreateTable
+CREATE TABLE "telemetry_records" (
+    "id" TEXT NOT NULL,
+    "customer_id" TEXT NOT NULL,
+    "active_user_count" INTEGER NOT NULL,
+    "seat_count" INTEGER NOT NULL,
+    "timestamp" TIMESTAMPTZ NOT NULL,
+    "recorded_at" TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "telemetry_records_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE INDEX "telemetry_records_customer_id_recorded_at_idx" ON "telemetry_records"("customer_id", "recorded_at" DESC);
+
+-- CreateIndex
+CREATE INDEX "telemetry_records_recorded_at_idx" ON "telemetry_records"("recorded_at" DESC);

package/templates/database/migrations/20260525000000_theme_wiring/migration.sql

@@ -0,0 +1,67 @@
+-- Add per-tenant Theme, SiteIdentity, and SEO tables (TWP3-MAT #1359)
+--
+-- Three tables for the paid-side persistence layer backing the marketing-api
+-- theme/site-identity/seo endpoints. Each table stores one Zod-validated JSON
+-- blob per tenant (userId = Better Auth User.id).
+--
+-- Design decisions (spec §3):
+--   - One table per schema (not a polymorphic config table)
+--   - Json column for the blob — schema evolves at the API layer without DB migration
+--   - userId FK with onDelete Cascade — user removal cleans up config rows
+--   - @@unique([userId]) — one active record per tenant per config type
+--
+-- Rollback:
+--   DROP TABLE "tenant_seos";
+--   DROP TABLE "tenant_site_identities";
+--   DROP TABLE "tenant_themes";
+
+-- CreateTable
+CREATE TABLE "tenant_themes" (
+    "id" TEXT NOT NULL,
+    "user_id" TEXT NOT NULL,
+    "data" JSONB NOT NULL,
+    "created_at" TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMPTZ NOT NULL,
+
+    CONSTRAINT "tenant_themes_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "tenant_site_identities" (
+    "id" TEXT NOT NULL,
+    "user_id" TEXT NOT NULL,
+    "data" JSONB NOT NULL,
+    "created_at" TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMPTZ NOT NULL,
+
+    CONSTRAINT "tenant_site_identities_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "tenant_seos" (
+    "id" TEXT NOT NULL,
+    "user_id" TEXT NOT NULL,
+    "data" JSONB NOT NULL,
+    "created_at" TIMESTAMPTZ NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMPTZ NOT NULL,
+
+    CONSTRAINT "tenant_seos_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "tenant_themes_user_id_key" ON "tenant_themes"("user_id");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "tenant_site_identities_user_id_key" ON "tenant_site_identities"("user_id");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "tenant_seos_user_id_key" ON "tenant_seos"("user_id");
+
+-- AddForeignKey
+ALTER TABLE "tenant_themes" ADD CONSTRAINT "tenant_themes_user_id_fkey" FOREIGN KEY ("user_id") REFERENCES "users"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "tenant_site_identities" ADD CONSTRAINT "tenant_site_identities_user_id_fkey" FOREIGN KEY ("user_id") REFERENCES "users"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "tenant_seos" ADD CONSTRAINT "tenant_seos_user_id_fkey" FOREIGN KEY ("user_id") REFERENCES "users"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/templates/database/migrations/20260710000000_retire_commercial_tier/migration.sql

@@ -0,0 +1,21 @@
+-- Retire the agency/commercial tier — migrate rows to enterprise (#3516)
+--
+-- Sam disposed Option B (2026-07-10): the `agency`/`commercial` tier is retired
+-- from the entitlement manifest; multi-tenancy is now an Enterprise-gated
+-- entitlement (the existing multi-tenant-basic / multi-tenant-advanced
+-- features). Any User row whose tier projection still reads a retired value is
+-- forward-migrated to `enterprise` so the narrowed Tier vocabulary
+-- (free | pro | pro_plus | enterprise) holds and the partner gate keeps
+-- admitting these customers.
+--
+-- The physical table is `users` (Prisma model `User`, @@map("users")); the
+-- projected tier column is `tier`.
+--
+-- Forward-only and idempotent: re-running the UPDATE is a no-op once no
+-- `agency`/`commercial` rows remain. No data loss beyond the intended remap.
+--
+-- Rollback: not reversible — the pre-migration `agency`/`commercial` values are
+-- not recoverable from the row (both mapped to `enterprise`). Restore from a
+-- pre-migration backup if the tier distinction is needed.
+
+UPDATE "users" SET "tier" = 'enterprise' WHERE "tier" IN ('agency', 'commercial');

package/templates/database/migrations/migration_lock.toml

@@ -0,0 +1,3 @@
+# Please do not edit this file manually
+# It should be added in your version-control system (e.g., Git)
+provider = "postgresql"

package/templates/database/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@working-theory/database",
+  "version": "0.1.2",
+  "description": "AI Launch Kit database schema (single-tenant Prisma)",
+  "type": "module",
+  "main": "./dist/client/client.js",
+  "types": "./dist/client/client.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/client/client.d.ts",
+      "import": "./dist/client/client.js",
+      "default": "./dist/client/client.js"
+    },
+    "./client": {
+      "types": "./dist/client/client.d.ts",
+      "import": "./dist/client/client.js",
+      "default": "./dist/client/client.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json",
+    "db:generate": "prisma generate && pnpm run build",
+    "db:migrate": "prisma migrate dev",
+    "db:migrate:deploy": "prisma migrate deploy",
+    "db:push": "prisma db push",
+    "db:seed": "prisma db seed",
+    "db:seed:test": "tsx seed-test.ts",
+    "db:studio": "prisma studio",
+    "test": "jest --config jest.config.cjs",
+    "test:watch": "jest --config jest.config.cjs --watch"
+  },
+  "dependencies": {
+    "@prisma/client": "^7.8.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.20.0",
+    "dotenv": "^17.4.2",
+    "jest": "^30.4.2",
+    "prisma": "^7.8.0",
+    "ts-jest": "^29.4.11",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3"
+  }
+}

package/templates/database/prisma.config.ts

@@ -0,0 +1,20 @@
+// Prisma 7 CLI config.
+//
+// Runtime DB URL (DATABASE_URL, pooled) is injected into the driver adapter at
+// PrismaClient construction in apps/api and apps/web — it does NOT appear here.
+// Migrate-time DB URL (DATABASE_URL_NON_POOLED, direct) is read here and
+// consumed by `prisma migrate`. The two-env-var contract from the migration
+// brief's D2 is preserved.
+//
+// `dotenv/config` is imported because the Prisma 7 CLI runs in its own process
+// and does not inherit .env values from a parent shell.
+
+import "dotenv/config";
+import { defineConfig } from "prisma/config";
+
+export default defineConfig({
+  schema: "./schema.prisma",
+  datasource: {
+    url: process.env.DATABASE_URL_NON_POOLED,
+  },
+});