create-ailk 0.22.0 → 0.24.0

package/templates/content/en/BookCall/onsite-estimate.mdx

@@ -20,22 +20,6 @@ sections:
           "primaryCta": { "label": "{Get in touch}", "href": "/contact" },
         },
     },
-    {
-      "id": "add-scheduling",
-      "type": "cta",
-      "data":
-        {
-          "variant": "box",
-          "headline": "{What booking an onsite estimate would do for your visitors}",
-          "description": "{One or two sentences on what live scheduling adds once it's on}",
-          "primaryCta":
-            {
-              "label": "Add scheduling with Pro",
-              "href": "https://ailaunchkit.ai/pricing",
-              "external": true,
-            },
-        },
-    },
     {
       "id": "back-to-meet",
       "type": "content-block",
@@ -53,4 +37,4 @@ sections:
   ]
 ---
 
-{/* Rendered from frontmatter `sections[]` by the /meet/[slug] placeholder route. A template that carries the scheduling module overrides this file with the live booker. Placeholder copy — replace every {brace} with your own words before you launch. */}
+{/* Rendered from frontmatter `sections[]` by the /meet/[slug] placeholder route. A site that carries the scheduling module renders the hub's meeting page instead, reading this seed only for its URL, its JSON-LD and its fallback title (#8843 C5). Placeholder copy — replace every {brace} with your own words before you launch. */}

package/templates/content/en/BookCall/onsite-service.mdx

@@ -20,22 +20,6 @@ sections:
           "primaryCta": { "label": "{Get in touch}", "href": "/contact" },
         },
     },
-    {
-      "id": "add-scheduling",
-      "type": "cta",
-      "data":
-        {
-          "variant": "box",
-          "headline": "{What booking an onsite service call would do for your visitors}",
-          "description": "{One or two sentences on what live scheduling adds once it's on}",
-          "primaryCta":
-            {
-              "label": "Add scheduling with Pro",
-              "href": "https://ailaunchkit.ai/pricing",
-              "external": true,
-            },
-        },
-    },
     {
       "id": "back-to-meet",
       "type": "content-block",
@@ -53,4 +37,4 @@ sections:
   ]
 ---
 
-{/* Rendered from frontmatter `sections[]` by the /meet/[slug] placeholder route. A template that carries the scheduling module overrides this file with the live booker. Placeholder copy — replace every {brace} with your own words before you launch. */}
+{/* Rendered from frontmatter `sections[]` by the /meet/[slug] placeholder route. A site that carries the scheduling module renders the hub's meeting page instead, reading this seed only for its URL, its JSON-LD and its fallback title (#8843 C5). Placeholder copy — replace every {brace} with your own words before you launch. */}

package/templates/content/en/BookCall/start-project.mdx

@@ -20,22 +20,6 @@ sections:
           "primaryCta": { "label": "{Get in touch}", "href": "/contact" },
         },
     },
-    {
-      "id": "add-scheduling",
-      "type": "cta",
-      "data":
-        {
-          "variant": "box",
-          "headline": "{What booking a project kickoff would do for your visitors}",
-          "description": "{One or two sentences on what live scheduling adds once it's on}",
-          "primaryCta":
-            {
-              "label": "Add scheduling with Pro",
-              "href": "https://ailaunchkit.ai/pricing",
-              "external": true,
-            },
-        },
-    },
     {
       "id": "back-to-meet",
       "type": "content-block",
@@ -53,4 +37,4 @@ sections:
   ]
 ---
 
-{/* Rendered from frontmatter `sections[]` by the /meet/[slug] placeholder route. A template that carries the scheduling module overrides this file with the live booker. Placeholder copy — replace every {brace} with your own words before you launch. */}
+{/* Rendered from frontmatter `sections[]` by the /meet/[slug] placeholder route. A site that carries the scheduling module renders the hub's meeting page instead, reading this seed only for its URL, its JSON-LD and its fallback title (#8843 C5). Placeholder copy — replace every {brace} with your own words before you launch. */}

package/templates/content/en/ContactPage/contact.mdx

@@ -1,73 +1,16 @@
 ---
 type: "ContactPage"
 slug: "contact"
-title: "Contact {{COMPANY_NAME}}"
-description: "Or upgrade to Pro to save every message as a lead in your own marketing database."
+title: "Get in touch"
+description: "{One sentence on who should get in touch and how soon you reply}"
 sections:
   [
     {
-      "id": "hero",
-      "type": "hero",
-      "data":
-        {
-          "variant": "split",
-          "eyebrow": "Contact",
-          "headline": "Get every message in your email, free",
-          "subheadline": "Or upgrade to Pro to save every message as a lead in your own marketing database.",
-          "checklist":
-            [
-              "Every message arrives in your email",
-              "No database or setup to start",
-              "Upgrade any time to keep a lead inbox",
-            ],
-          "secondaryCta":
-            {
-              "label": "Save my leads",
-              "href": "https://ailaunchkit.ai/pricing",
-              "variant": "outline",
-            },
-        },
-    },
-    {
-      "id": "meeting-types",
-      "type": "items",
-      "data":
-        {
-          "headline": "{Add appointment scheduling to your site}",
-          "variant": "tiles",
-          "columns": 2,
-          "items":
-            [
-              {
-                "title": "Book a Call",
-                "description": "{A quick intro call.}",
-                "link": { "label": "Book a Call", "href": "/meet/book-a-call" },
-              },
-              {
-                "title": "Onsite Estimate",
-                "description": "{We come to you and quote the work.}",
-                "link":
-                  {
-                    "label": "Onsite Estimate",
-                    "href": "/meet/onsite-estimate",
-                  },
-              },
-              {
-                "title": "Start Project",
-                "description": "{Kick off a project you're ready to start.}",
-                "link":
-                  { "label": "Start Project", "href": "/meet/start-project" },
-              },
-              {
-                "title": "Onsite Service",
-                "description": "{Book a service visit at your location.}",
-                "link":
-                  { "label": "Onsite Service", "href": "/meet/onsite-service" },
-              },
-            ],
-        },
+      "id": "contact-form",
+      "type": "contact-form",
+      "data": { "variant": "column", "fields": [] },
     },
   ]
 ---
 
-{/* Rendered from frontmatter `sections[]`. The page's one contact surface — the plain contact form — is mounted by the /contact route itself, in the split hero's right column, and posts to the site's own API (`/v1/leads/submit`). Placeholder copy — replace before you launch. */}
+{/* Rendered from frontmatter `sections[]`. The page's one contact surface is the workspace's Contact form magnet: its heading, sentence, fields, consent, button and ending all come from the magnet, mounted by the /contact route in this section's slot. To change the form, change the magnet in Admin → Magnets. The `description` is the page's meta description — replace it before you launch. */}

package/templates/content/en/HomePage/home.mdx

@@ -39,27 +39,9 @@ sections:
           "headlineStyle": "label",
           "logos":
             [
-              {
-                "name": "SalesSmyth",
-                "src": "/logos/salessmyth.svg",
-                "darkSrc": "/logos/salessmyth-light.svg",
-                "width": 1118,
-                "height": 147,
-              },
-              {
-                "name": "AI Launch Kit",
-                "src": "/logos/ai-launch-kit.svg",
-                "darkSrc": "/logos/ai-launch-kit-light.svg",
-                "width": 1248,
-                "height": 144,
-              },
-              {
-                "name": "Atomic Agent",
-                "src": "/logos/atomic-agent.svg",
-                "darkSrc": "/logos/atomic-agent-light.svg",
-                "width": 1320,
-                "height": 148,
-              },
+              { "name": "Placeholder logo", "src": "/logomark.svg" },
+              { "name": "Placeholder logo", "src": "/logomark.svg" },
+              { "name": "Placeholder logo", "src": "/logomark.svg" },
             ],
           "layout": "inline",
           "treatment": "monochrome",

package/templates/database/CHANGELOG.md

@@ -1,5 +1,56 @@
 # @working-theory/database
 
+## 0.45.0
+
+### Patch Changes
+
+- [#9309](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/pull/9309) [`42b37e2`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/42b37e237d0f424573346b158290f0ecc4ae77a4) Thanks [@samuelhenry](https://github.com/samuelhenry)! - Every workspace now holds a standard trial magnet at the fixed slug `trial` ([#9301](https://github.com/working-theory-labs/ai-launch-kit-internal/issues/9301)).
+
+  - **`@working-theory/validation`**: new exports `TRIAL_FLOW_SLUG`, `TRIAL_FLOW_TITLE`, `TRIAL_FLOW_LANDING_PAGE`, `TRIAL_TERMS_STATEMENT` and `trialFlowConfig` — one step asking for first name, last name, work email and the terms box, ending on "Thanks, {name}.", with a landing whose button reads "Request a free trial". `RESERVED_FLOW_SLUGS` gains `trial`, so no flow-engine write, spoke seed or new listing can take the slug (a new listing named "Trial" now derives `trial-2`).
+  - **`@working-theory/database`**: the default workspace's seed writes the trial magnet (`diagnostic`, `live`, completion `lead`, landing page `/trial`), and the `20261025120000_trial_magnet` migration backfills it into every existing workspace, insert-only — a row already at `trial` is never changed.
+  - **`create-ailk`**: the API seeds the trial magnet when it creates a workspace and from `seed-presets`, and the magnet PATCH refuses to rename the trial magnet or rename another magnet to `trial` (`409`). A completed walk is a `flow:trial` Inbox submission whose Person carries the given name, family name, email and, when a site adds a `company`-tagged field, the company.
+
+- [#9330](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/pull/9330) [`569b348`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/569b348a95aa7b1b414ed62151d810e41877f238) Thanks [@samuelhenry](https://github.com/samuelhenry)! - The trial magnet gets its page pair: `/trial` and `/trial/request` ([#9302](https://github.com/working-theory-labs/ai-launch-kit-internal/issues/9302)).
+
+  - **`create-ailk`**: a site with the `signal-collectors` module carries `/trial`, the indexable landing inside the site's Nav and Footer — the trial magnet's landing copy, one button ("Request a free trial") to `/trial/request`, and the `Assessment` JSON-LD — and `/trial/request`, the full-screen, `noindex, follow` walk of the trial magnet with a back arrow to `/trial`. When the trial flow is absent or the hub cannot answer, the walk shows the site's contact email under its own "Free trial" heading instead of a 404. The magnet landing renderer takes an optional `startPath` for a walk not at `<path>/start`.
+  - **`@working-theory/validation`**: `trialFlowConfig.landing` gains its proof line, `meta`: "A person on our team reviews every request." It is true for every site, because only an operator starts a trial, from the Inbox.
+  - **`@working-theory/database`**: the `20261026120000_trial_magnet_proof_line` migration gives that line to every workspace's trial magnet that still holds [#9301](https://github.com/working-theory-labs/ai-launch-kit-internal/issues/9301)'s exact default. A trial magnet an owner has edited is never touched.
+  - **`@working-theory/templates`**: `ROUTES` gains the `/trial` and `/trial/request` rows (module `signal-collectors`).
+
+- Updated dependencies [[`1d9b675`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/1d9b6755b3fbffebfcd7c57a93ea7cbc9941bba0), [`875714a`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/875714ad871e2b9b3778383ed106e8a1586fe3a6), [`42b37e2`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/42b37e237d0f424573346b158290f0ecc4ae77a4), [`569b348`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/569b348a95aa7b1b414ed62151d810e41877f238), [`d648b1a`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/d648b1a98a84dfee56f6847e7ec5f9fd0421a163), [`5008d1d`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/5008d1d13283fe5ed04504dcfb17122d18892a18), [`a5c5d1c`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/a5c5d1cc3443394d0da9507c7b11954b54e8c0da), [`67e75c8`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/67e75c87519235435f578ee22c2cf8fa2f74f17d), [`16c889b`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/16c889b7434ad49c3b18f900c42779c72e78f233)]:
+  - @working-theory/validation@0.45.0
+
+## 0.44.0
+
+### Minor Changes
+
+- [#8955](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/pull/8955) [`1a84162`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/1a841626a9e5664d926a2f186425f35e8757a6b4) Thanks [@samuelhenry](https://github.com/samuelhenry)! - The Offerings data model and its typed read services ([#8876](https://github.com/working-theory-labs/ai-launch-kit-internal/issues/8876)).
+
+  - **`@working-theory/database`** — three config tables, in migration `20261020120000_offerings_data_model`: `StripeConnection` (an Organization's own Stripe account by a restricted key — mode, last four, the key and webhook secret as ciphertext the database refuses in clear, a webhook token), `OrganizationOfferings` (the Products an Organization has switched on) and `WorkspaceOfferings` (what a workspace shows, its Recommended plan and add-on, and the last-good Stripe snapshot). Deploy the migration before the API. No existing table is touched.
+  - **`@working-theory/ids`** — registers the `stripecon`, `orgoffer` and `wsoffer` prefixes for the new models.
+  - **`@working-theory/validation`** — the Offerings data contract: `parseLookupKey` (the one lookup-key parser, `<plan>_<monthly|yearly|once>`), `periodOfStripePrice`, the text bounds, and the typed shapes `offeringsProductSchema`, `offeringsSnapshotSchema`, `orgEnabledProductsSchema`, `workspaceShownSetSchema` and `stripeConnectionSummarySchema`.
+  - **`create-ailk`** — a scaffold's `apps/api` carries the Offerings read services (`getOrgEnabledProducts`, `getWorkspaceShownSet`, `getSellableProductIds`, the bounded snapshot refresh and the connection summary). No route reads them yet, so a site's behaviour is unchanged.
+
+- [#8968](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/pull/8968) [`8da1163`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/8da1163fd04f083fd8d408a4a7d762b756b23274) Thanks [@samuelhenry](https://github.com/samuelhenry)! - The Offerings Checkout session record ([#8930](https://github.com/working-theory-labs/ai-launch-kit-internal/issues/8930)).
+
+  - **`@working-theory/database`** — one config table, in migration `20261021120000_offerings_checkout_session`: `OfferingsCheckoutSession`, one row per Checkout Session the hub created (its id, workspace, Organization, Price, lookup key and mode), with a CHECK on every column but `created_at`. Deploy the migration before the API. No existing table is touched.
+  - **`@working-theory/ids`** — registers the `ocsess` prefix for the new model.
+  - **`create-ailk`** — a scaffold's `apps/api` carries the record's one store (`recordCheckoutSession`, `readCheckoutSessionRecord`). No route calls it yet, so a site's behaviour is unchanged.
+
+- [#9091](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/pull/9091) [`23cf71c`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/23cf71c316c9e44c6109c76439cb64281e6368d5) Thanks [@samuelhenry](https://github.com/samuelhenry)! - A workspace's Offerings shown set is chosen per Stripe Price, and the Admin's Offerings page reads like Magnets ([#9070](https://github.com/working-theory-labs/ai-launch-kit-internal/issues/9070)).
+
+  - **`@working-theory/database`** — migration `20261023120000_offerings_shown_price_ids` adds `workspace_offerings.shown_price_ids TEXT[] NOT NULL DEFAULT '{}'` and two CHECKs (at most 300 non-null ids; Price ids only beside a shown Product). No row is rewritten: an empty array means every Price of each shown Product, so every workspace saved before this release shows exactly what it showed before. **Deploy the migration before the API, and the API before the Admin.** While the API and the Admin are on different versions the Offerings page cannot save (nothing is written and nothing new is sold).
+  - **`@working-theory/validation`** — new exports `OFFERINGS_PRICE_IDS_MAX`, `offeringsPriceIdsSchema`, `workspaceOfferingsShownEntrySchema` and `workspaceOfferingsShownSchema`. Changed shapes: `workspaceOfferingsSelectionInputSchema` is now one Price's switch, `{ productId, period, shown }`, so no body names a Recommended or a whole set; `workspaceOfferingsSelectionSchema` gains `shownPriceIds`, empty exactly when `shownProductIds` is; `workspaceOfferingsViewSchema`'s available branch answers `shown` (`{ productId, periods }` per Product) in place of `shownProductIds`.
+  - **`create-ailk`** — a scaffold's `PUT /v1/workspaces/:workspaceId/offerings` takes one Price per save and keeps or clears a stored Recommended but never sets one (`recommended_not_shown` is retired; a period the Product has no Price for is `400 price_not_offered`). Its audit row's `shown`, `added` and `removed` count Prices, not Products, from this release. `/pricing`, the agent pricing tools, the plan picker and checkout show and sell only the shown Prices, so a seller can show a yearly Price without its monthly sibling; a Price replaced in Stripe stays off until it is switched on. The Admin's Offerings page is a Title / Tags / Live table, one row per Price, with a New recommender button and no Recommended control.
+
+  **Rollback.** Roll the API back, then run `UPDATE workspace_offerings SET shown_price_ids = '{}'` so every row reads at the Product grain again and the old route's saves succeed. Tell each owner who saved per Price that every Price of their shown Products — on `/pricing` and at checkout — is on sale again. Never drop the column while a per-Price row exists without that notice.
+
+### Patch Changes
+
+- Updated dependencies [[`6ad87d6`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/6ad87d65d91013ac9c0945a62efbf28c627b1fce), [`d9c2cd3`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/d9c2cd3c601d9a267d4d29cb9bcef77ec71cd518), [`407810f`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/407810fbd63a02d14773aef36a10c1f9f04dd5e3), [`5875c18`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/5875c189f72f66ea2af7b7c79a47baba53a329d1), [`13c0b3d`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/13c0b3dd64a105292962821f5b0050c5cabc2d45), [`82bc2f1`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/82bc2f1ecab1a12f23a45e326355841ba87d9f04), [`ea18e21`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/ea18e2181241ba9357b4dcfa3a1d2f4c3ffe4518), [`8754f86`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/8754f866b49003965c4be28cbe19b1f040aec4af), [`1a84162`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/1a841626a9e5664d926a2f186425f35e8757a6b4), [`74cb7b3`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/74cb7b37adea5d27adc1f3ec3ea58b9941167c4d), [`25b4b61`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/25b4b6199d8632167bd5501a4e12d4774eed432a), [`8da1163`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/8da1163fd04f083fd8d408a4a7d762b756b23274), [`bd1c9b5`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/bd1c9b576ac337596e585145f09b08696e9f412e), [`d1dacc5`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/d1dacc5d76a9cc91f6ad3b1883067e327b5e3d3c), [`fff5487`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/fff5487a6d14a3010bf22cb99e7554e6542449a0), [`23cf71c`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/23cf71c316c9e44c6109c76439cb64281e6368d5), [`75ecc58`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/75ecc584f43793bb5234f69e0f80b15327a99236), [`85ae357`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/85ae357410ebd6c11b08b04355a9ede1d2088d2d), [`059c892`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/059c89249f7db3dc106f133ef37180e9eb1e318a), [`c563360`](https://github.com/Working-Theory-Labs/ai-launch-kit-internal/commit/c563360db386758aa2d25309ab693a18a41e4139)]:
+  - @working-theory/validation@0.44.0
+  - @working-theory/ids@0.15.0
+
 ## 0.43.0
 
 ### Minor Changes

package/templates/database/__tests__/in-page-magnets-migration.test.ts

@@ -0,0 +1,161 @@
+/**
+ * @file in-page-magnets-migration.test.ts
+ *
+ * DB-free: migrations/20261022120000_in_page_magnets writes two configs as
+ * JSONB literals, because SQL cannot import TS (#8847 spec
+ * docs/specs/8847-the-in-page-form-shape-spec.md D5; AC-3, AC-5). This test
+ * holds each literal to its one TS source so they can never drift, as
+ * `member-contract-migration.test.ts` does for the request-quote backfill:
+ *
+ *   - `newsletter backfill` inserts `newsletterFlowConfig` into every
+ *     workspace, insert-only on `(site_id, slug)`;
+ *   - `contact-form upgrade` replaces a stored Contact form with
+ *     `contactFormFlowConfig` ONLY where its config equals #8661's shipped
+ *     default as JSONB, so an owner's edit (or a wizard-built Contact form) is
+ *     never touched, and it sets nothing but `config` and `updated_at`.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+
+import {
+  CONTACT_FORM_FLOW_SLUG,
+  contactFormFlowConfig,
+  flowConfigSchema,
+  NEWSLETTER_FLOW_SLUG,
+  NEWSLETTER_FLOW_TITLE,
+  NEWSLETTER_LANDING_PAGE,
+  newsletterFlowConfig,
+  STANDARD_MAGNET_COMPLETIONS,
+} from "@working-theory/validation";
+
+const MIGRATION_SQL = readFileSync(
+  join(__dirname, "..", "migrations", "20261022120000_in_page_magnets", "migration.sql"),
+  "utf8",
+);
+
+/**
+ * #8661's shipped default Contact form — `contactFormFlowConfig` as it stood
+ * at commit e34e7468^ (`git show e34e7468^:packages/validation/src/schemas/flow.ts`),
+ * the only shape the #8661 seed ever wrote. Written out here, not imported:
+ * the constant has moved on, and this is the value the upgrade's guard must
+ * match exactly.
+ */
+const CONTACT_FORM_8661_DEFAULT = {
+  slug: "contact",
+  defaultLocale: "en",
+  steps: [
+    {
+      key: "contact",
+      type: "field",
+      copy: { title: { en: "Contact form" }, cta: { en: "Send message" } },
+      fields: [
+        { name: "name", inputType: "text", required: true, mapsTo: "name", copy: { label: { en: "Name" } } },
+        { name: "email", inputType: "email", required: true, mapsTo: "email", copy: { label: { en: "Email" } } },
+        {
+          name: "subject",
+          inputType: "select",
+          required: false,
+          options: [
+            { value: "General question", label: { en: "General question" } },
+            { value: "Working together", label: { en: "Working together" } },
+            { value: "Support", label: { en: "Support" } },
+            { value: "Press and partnerships", label: { en: "Press and partnerships" } },
+            { value: "Other", label: { en: "Other" } },
+          ],
+          copy: { label: { en: "Subject" }, placeholder: { en: "Choose a subject" } },
+        },
+        { name: "message", inputType: "textarea", required: false, copy: { label: { en: "Message" } } },
+        {
+          name: "terms",
+          inputType: "consent",
+          required: true,
+          purposes: ["service_terms"],
+          copy: {
+            label: {
+              en: "I accept the [Terms](terms), [Privacy Policy](privacy), and [Working Agreement](working_agreement).",
+            },
+          },
+        },
+      ],
+    },
+  ],
+};
+
+/** The text between `-- BEGIN <name>` and `-- END <name>`. */
+function block(name: string): string {
+  const match = new RegExp(`-- BEGIN ${name}\\n([\\s\\S]*?)-- END ${name}`).exec(MIGRATION_SQL);
+  if (!match?.[1]) throw new Error(`${name} markers not found`);
+  return match[1];
+}
+
+/** A SQL string literal's body, `''` unescaped, parsed as JSON. */
+const parseLiteral = (body: string): unknown => JSON.parse(body.replace(/''/g, "'"));
+
+/** The block with every string literal blanked, so only SQL structure is left. */
+const withoutLiterals = (sql: string): string => sql.replace(/'(?:[^']|'')*'/g, "''");
+
+describe("the newsletter backfill (#8847 D5, AC-5)", () => {
+  const sql = block("newsletter backfill");
+
+  it("carries exactly one JSONB config literal, and it deep-equals newsletterFlowConfig", () => {
+    const literals = [...sql.matchAll(/'(\{[\s\S]*?\})'::jsonb/g)];
+    expect(literals).toHaveLength(1);
+    const parsed = parseLiteral(literals[0]![1]!);
+    expect(parsed).toEqual(newsletterFlowConfig);
+    expect(flowConfigSchema.safeParse(parsed).success).toBe(true);
+  });
+
+  it("writes the constants' slug, title and landing page, kind newsletter, live, the lead completion, into every workspace", () => {
+    expect(sql).toContain(
+      `INSERT INTO "flow_definitions" ("site_id", "workspace_id", "slug", "config", "kind", "title", "status", "customers_enabled", "completion", "landing_page", "updated_at")`,
+    );
+    expect(sql).toContain(`SELECT w."id", w."id", '${NEWSLETTER_FLOW_SLUG}',`);
+    expect(STANDARD_MAGNET_COMPLETIONS[NEWSLETTER_FLOW_SLUG]).toBe("lead");
+    expect(sql).toContain(
+      `'newsletter', '${NEWSLETTER_FLOW_TITLE}', 'live', false, 'lead', '${NEWSLETTER_LANDING_PAGE}', CURRENT_TIMESTAMP`,
+    );
+    expect(sql).toContain(`FROM "workspaces" w`);
+  });
+
+  it("ends ON CONFLICT (\"site_id\", \"slug\") DO NOTHING, so an existing row is never overwritten", () => {
+    expect(sql.trimEnd().endsWith(`ON CONFLICT ("site_id", "slug") DO NOTHING;`)).toBe(true);
+    expect(sql).not.toMatch(/DO UPDATE/i);
+  });
+});
+
+describe("the contact-form upgrade (#8847 D5, C5, AC-3)", () => {
+  const sql = block("contact-form upgrade");
+  const statements = withoutLiterals(sql).split(";").filter((s) => s.trim().length > 0);
+
+  it("is one UPDATE of flow_definitions", () => {
+    expect(statements).toHaveLength(1);
+    expect(statements[0]!.trim()).toMatch(/^UPDATE "flow_definitions" SET /);
+  });
+
+  it("its SET literal deep-equals contactFormFlowConfig", () => {
+    const set = /SET "config" = '(\{[\s\S]*?\})'::jsonb/.exec(sql);
+    expect(set?.[1]).toBeDefined();
+    const parsed = parseLiteral(set![1]!);
+    expect(parsed).toEqual(contactFormFlowConfig);
+    expect(flowConfigSchema.safeParse(parsed).success).toBe(true);
+  });
+
+  it("its WHERE names the contact slug and compares config with = against a ::jsonb literal equal to #8661's default", () => {
+    const where = new RegExp(
+      `WHERE "slug" = '${CONTACT_FORM_FLOW_SLUG}' AND "config" = '(\\{[\\s\\S]*?\\})'::jsonb;`,
+    ).exec(sql);
+    expect(where?.[1]).toBeDefined();
+    expect(parseLiteral(where![1]!)).toEqual(CONTACT_FORM_8661_DEFAULT);
+    // The guard is a different value from what it writes, so a re-run matches nothing.
+    expect(CONTACT_FORM_8661_DEFAULT).not.toEqual(contactFormFlowConfig);
+    expect(flowConfigSchema.safeParse(CONTACT_FORM_8661_DEFAULT).success).toBe(true);
+  });
+
+  it("sets no column besides config and updated_at", () => {
+    const setClause = /SET ([\s\S]*?)\s+WHERE /.exec(withoutLiterals(sql))?.[1];
+    expect(setClause).toBeDefined();
+    const columns = [...setClause!.matchAll(/"([a-z_]+)"\s*=/g)].map((m) => m[1]);
+    expect(columns).toEqual(["config", "updated_at"]);
+    expect(setClause).toContain(`"updated_at" = CURRENT_TIMESTAMP`);
+  });
+});