create-ailk 0.23.0 → 0.24.0

package/templates/apps/web/app/[locale]/flows/[slug]/magnet-page.tsx

@@ -7,7 +7,9 @@
  * chrome — a centred hero of the flow record's `landing` copy, a CTA to
  * `/<magnet>/start`, and the `Assessment` page type's single-layer
  * `WebApplication` JSON-LD) and a `noindex, follow` WALK (`/<magnet>/start`,
- * chrome-free by `lib/magnet-routes.ts`, the back arrow alone above step 1).
+ * or the `startPath` a landing names, as `/trial` names `/trial/request` —
+ * #9287 DD10; chrome-free by `lib/magnet-routes.ts`, the back arrow alone
+ * above step 1).
  * This module is the only code that renders either half: `/flows/<slug>`,
  * the careers apply pages and every pair `create-ailk add-route magnet`
  * writes are callers of the factories below.
@@ -23,7 +25,8 @@
  * with no hub to ask — the read answers 503 `flows_not_configured`, or a
  * failed read with no API origin configured — is `not-configured` (#9219);
  * a pair renders it as `unavailable`, and `/reports/<slug>` uses it to 404
- * an unknown slug where a hub outage shows the contact email. A walk
+ * an unknown slug where a hub outage shows the contact email; a landing that
+ * passes `notFoundWhenNotConfigured` (`/trial`, #9423) 404s on it too. A walk
  * that exists apart from its flow (`/careers/apply`) passes a `title`: its
  * fallback then carries that page heading, and an absent flow renders the
  * same fallback rather than a 404 (#9219).
@@ -170,6 +173,15 @@ export interface MagnetLandingInput {
   /** The landing's own path, e.g. `/diagnostic`; the CTA goes to `<path>/start`. */
   path: string;
   locale: string;
+  /** #9287 DD10 — the walk's path when it is not `<path>/start` (`/trial/request`). */
+  startPath?: string;
+  /**
+   * #9423 — a landing that exists only to sell its hub's flow (`/trial`) is a
+   * 404 on a site with no hub to ask (`not-configured`), as `/reports/<slug>`
+   * is (#9219). A configured hub that cannot answer still shows the contact
+   * email.
+   */
+  notFoundWhenNotConfigured?: boolean;
 }
 
 /** The indexable landing of a magnet pair (D8). */
@@ -177,9 +189,12 @@ export async function renderMagnetLanding({
   slug,
   path,
   locale,
+  startPath = `${path}/start`,
+  notFoundWhenNotConfigured = false,
 }: MagnetLandingInput): Promise<ReactElement> {
   const read = await readMagnet(slug);
   if (read.kind === "absent") notFound();
+  if (read.kind === "not-configured" && notFoundWhenNotConfigured) notFound();
   if (read.kind !== "ok") return magnetUnavailable(locale);
   // #8848 D7 — a deliverable's one route.
   if (read.config.deliverable !== undefined) redirect(localeHref(locale, `/reports/${slug}`));
@@ -194,7 +209,7 @@ export async function renderMagnetLanding({
         headline: copy.title,
         subheadline: copy.description,
         ...(copy.meta !== undefined ? { body: copy.meta } : {}),
-        primaryCta: { label: copy.cta, href: localeHref(locale, `${path}/start`) },
+        primaryCta: { label: copy.cta, href: localeHref(locale, startPath) },
       },
     },
   ];
@@ -221,9 +236,11 @@ export async function renderMagnetLanding({
 export async function renderMagnetLandingMetadata({
   slug,
   locale,
-}: Pick<MagnetLandingInput, "slug" | "locale">): Promise<Metadata> {
+  notFoundWhenNotConfigured = false,
+}: Pick<MagnetLandingInput, "slug" | "locale" | "notFoundWhenNotConfigured">): Promise<Metadata> {
   const read = await readMagnet(slug);
   if (read.kind === "absent") return {};
+  if (read.kind === "not-configured" && notFoundWhenNotConfigured) return {};
   if (read.kind !== "ok") return flowRouteMetadata();
   const copy = await landingCopy(read.config, locale);
   return { title: copy.title, description: copy.description };

package/templates/apps/web/lib/__tests__/magnet-routes.test.ts

@@ -14,6 +14,9 @@ describe("isMagnetWalkPath (#8840 D10)", () => {
     "/careers/writer/apply",
     "/fr/careers/writer/apply",
     "/diagnostic/start?step=2",
+    "/trial/request",
+    "/en/trial/request",
+    "/fr/trial/request",
   ])("is a walk: %s", (path) => {
     expect(isMagnetWalkPath(path, LOCALES)).toBe(true);
   });
@@ -28,6 +31,10 @@ describe("isMagnetWalkPath (#8840 D10)", () => {
     "",
     "/apply",
     "/careers/a/b/apply",
+    "/trial",
+    "/en/trial",
+    "/request",
+    "/trial/a/request",
   ])("is not a walk: %j", (path) => {
     expect(isMagnetWalkPath(path, LOCALES)).toBe(false);
   });

package/templates/apps/web/lib/magnet-routes.ts

@@ -12,7 +12,8 @@
  * rather than writing a second predicate. #8848 D9 adds every page under
  * `/reports/<slug>` — a gated landing, an ungated reader and the grant
  * reader alike, since the path cannot tell them apart; `/reports` itself
- * keeps its chrome.
+ * keeps its chrome. #9287 DD10 adds `/trial/request`, the trial magnet's
+ * walk; `/trial`, its landing, keeps its chrome.
  *
  * Fail-safe direction, as `isAuthPath()`: an absent or empty pathname
  * answers `false`, so a missing `x-pathname` never strips a page's chrome.
@@ -34,6 +35,7 @@ export function isMagnetWalkPath(
   if (segments.length === 0) return false;
   if (segments[segments.length - 1] === "start") return true;
   if (segments[0] === "reports" && segments.length === 2) return true;
+  if (segments.length === 2 && segments[0] === "trial" && segments[1] === "request") return true;
   return (
     segments[0] === "careers" &&
     segments[segments.length - 1] === "apply" &&

package/templates/apps/web/lib/newsletter.actions.ts

@@ -6,7 +6,9 @@
  *
  * `/newsletter` and the footer render the newsletter magnet's
  * `NewsletterFormInline` bound to this action. Validates the address with
- * the tool's own input schema, calls `POST /v1/leads/subscribe` through
+ * its own `newsletterFormSchema` (the form's one field is the page's, not a
+ * wire contract — the `subscribe_newsletter` MCP tool takes the route body
+ * since #7172), calls `POST /v1/leads/subscribe` through
  * `@working-theory/api-client`, and maps the outcome the same way
  * `captureLeadAction` does: the API's 503 `lead_capture_not_configured` →
  * `unavailable`; any other non-2xx or thrown error → the generic `error`;
@@ -34,12 +36,10 @@
 
 import { flows, leads, visitorForwardHeaders } from "@working-theory/api-client";
 import { LEAD_CAPTURE_HONEYPOT, type LeadCaptureFormState } from "@working-theory/ui";
-import {
-  NEWSLETTER_FLOW_SLUG,
-  subscribeNewsletterInputSchema,
-} from "@working-theory/validation";
+import { NEWSLETTER_FLOW_SLUG } from "@working-theory/validation";
 import { cookies, headers } from "next/headers";
 import { getLocale } from "next-intl/server";
+import { z } from "zod";
 
 import { checkRateLimit, clientIpFromHeaders } from "../src/lib/rate-limit";
 
@@ -55,6 +55,9 @@ const RATE_LIMITED = "Too many signups from here. Please try again in a few minu
 const RATE_LIMIT_MAX_CALLS = 30;
 const RATE_LIMIT_WINDOW_MS = 10 * 60 * 1000;
 
+/** The form's one field; zod's default message is the field error shown. */
+const newsletterFormSchema = z.object({ email: z.string().email() });
+
 /** The API's 503 for a deployment with nowhere to keep a lead. */
 function isNotConfigured(res: { status: number; body: unknown }): boolean {
   return (
@@ -122,7 +125,7 @@ export async function subscribeNewsletterAction(
   const honeypot = formData.get(LEAD_CAPTURE_HONEYPOT);
   if (typeof honeypot === "string" && honeypot !== "") return { kind: "success" };
 
-  const parsed = subscribeNewsletterInputSchema.safeParse({
+  const parsed = newsletterFormSchema.safeParse({
     email: formData.get("email"),
   });
   if (!parsed.success) {

package/templates/database/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @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

package/templates/database/__tests__/seed.test.ts

@@ -21,6 +21,8 @@ import {
   REQUEST_QUOTE_FLOW_TITLE,
   requestQuoteFlowConfig,
   STANDARD_MAGNET_COMPLETIONS,
+  TRIAL_FLOW_SLUG,
+  trialFlowConfig,
 } from "@working-theory/validation";
 
 import {
@@ -114,7 +116,7 @@ describe("provisionDefaultWorkspace — the request-quote magnet (#8168 D8, C4,
 
     await provisionDefaultWorkspace(prisma);
 
-    expect(flowDefinitionUpsert).toHaveBeenCalledTimes(4);
+    expect(flowDefinitionUpsert).toHaveBeenCalledTimes(5);
     expect(flowDefinitionUpsert).toHaveBeenNthCalledWith(1, {
       where: {
         siteId_slug: { siteId: DEFAULT_WORKSPACE_ID, slug: REQUEST_QUOTE_FLOW_SLUG },
@@ -238,3 +240,33 @@ describe("provisionDefaultWorkspace — the newsletter magnet (#8847 D4, AC-5)",
     });
   });
 });
+
+describe("provisionDefaultWorkspace — the trial magnet (#9287 D11, #9301 AC-1)", () => {
+  it("upserts the default workspace's live trial magnet, insert-if-absent, as the fifth magnet", async () => {
+    const { prisma, flowDefinitionUpsert } = makeStubPrisma(0);
+
+    await provisionDefaultWorkspace(prisma);
+
+    expect(flowDefinitionUpsert).toHaveBeenCalledTimes(5);
+    expect(flowDefinitionUpsert).toHaveBeenNthCalledWith(5, {
+      where: {
+        siteId_slug: { siteId: DEFAULT_WORKSPACE_ID, slug: TRIAL_FLOW_SLUG },
+      },
+      create: {
+        siteId: DEFAULT_WORKSPACE_ID,
+        workspaceId: DEFAULT_WORKSPACE_ID,
+        slug: "trial",
+        config: trialFlowConfig,
+        kind: "diagnostic",
+        title: "Free trial",
+        status: "live",
+        customersEnabled: false,
+        // No account invite: the licence key's email is the invitation.
+        completion: "lead",
+        landingPage: "/trial",
+      },
+      // Empty: a re-run never overwrites the owner's edits.
+      update: {},
+    });
+  });
+});

package/templates/database/__tests__/trial-magnet-migration.test.ts

@@ -0,0 +1,186 @@
+/**
+ * @file trial-magnet-migration.test.ts
+ *
+ * DB-free: migrations/20261025120000_trial_magnet writes the trial magnet's
+ * config as a JSONB literal, because SQL cannot import TS (#9287 spec
+ * docs/specs/9287-operator-started-trials-spec.md D11; #9301 AC-1). This test
+ * holds the literal to its one TS source so they can never drift, as
+ * `in-page-magnets-migration.test.ts` does for the newsletter backfill:
+ * `trial backfill` inserts `trialFlowConfig` into every workspace,
+ * insert-only on `(site_id, slug)`, so an owner's own row at `trial` is never
+ * updated.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+
+import {
+  flowConfigSchema,
+  TRIAL_FLOW_LANDING_PAGE,
+  TRIAL_FLOW_SLUG,
+  TRIAL_FLOW_TITLE,
+  trialFlowConfig,
+} from "@working-theory/validation";
+
+const MIGRATION_SQL = readFileSync(
+  join(
+    __dirname,
+    "..",
+    "migrations",
+    "20261025120000_trial_magnet",
+    "migration.sql",
+  ),
+  "utf8",
+);
+
+const PROOF_MIGRATION_SQL = readFileSync(
+  join(
+    __dirname,
+    "..",
+    "migrations",
+    "20261026120000_trial_magnet_proof_line",
+    "migration.sql",
+  ),
+  "utf8",
+);
+
+/**
+ * #9301's shipped trial magnet — `trialFlowConfig` as #9301 wrote it, before
+ * #9302 added the landing's proof line. Written out here, not imported: the
+ * constant has moved on, and this is the value the backfill wrote and the
+ * #9302 upgrade's guard must match exactly (the in-page-magnets precedent).
+ */
+const TRIAL_9301_DEFAULT = {
+  slug: "trial",
+  defaultLocale: "en",
+  steps: [
+    {
+      key: "about",
+      type: "field",
+      copy: { title: { en: "Free trial" }, cta: { en: "Request my trial" } },
+      fields: [
+        { name: "first_name", inputType: "text", required: true, mapsTo: "givenName", copy: { label: { en: "First name" } } },
+        { name: "last_name", inputType: "text", required: true, mapsTo: "familyName", copy: { label: { en: "Last name" } } },
+        { name: "email", inputType: "email", required: true, mapsTo: "email", copy: { label: { en: "Work email" } } },
+        {
+          name: "terms",
+          inputType: "consent",
+          required: true,
+          purposes: ["service_terms"],
+          copy: { label: { en: "I accept the [Terms](terms) and [Privacy Policy](privacy)." } },
+        },
+      ],
+    },
+  ],
+  ending: {
+    default: {
+      kind: "screen",
+      headline: { en: "Thanks, {name}." },
+      body: { en: "We have your request and will be in touch about your trial." },
+    },
+  },
+  landing: {
+    title: { en: "Free trial" },
+    description: { en: "Try it free for 14 days. No card needed." },
+    cta: { en: "Request a free trial" },
+  },
+};
+
+/** The text between `-- BEGIN <name>` and `-- END <name>`. */
+function block(name: string, source: string = MIGRATION_SQL): string {
+  const match = new RegExp(
+    `-- BEGIN ${name}\\n([\\s\\S]*?)-- END ${name}`,
+  ).exec(source);
+  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 SQL with every string literal blanked, so only its structure is left. */
+const withoutLiterals = (sql: string): string =>
+  sql.replace(/'(?:[^']|'')*'/g, "''");
+
+describe("the trial backfill (#9287 D11, #9301 AC-1)", () => {
+  const sql = block("trial backfill");
+
+  it("carries exactly one JSONB config literal, and it deep-equals #9301's shipped default", () => {
+    const literals = [...sql.matchAll(/'(\{[\s\S]*?\})'::jsonb/g)];
+    expect(literals).toHaveLength(1);
+    const parsed = parseLiteral(literals[0]![1]!);
+    expect(parsed).toEqual(TRIAL_9301_DEFAULT);
+    expect(flowConfigSchema.safeParse(parsed).success).toBe(true);
+  });
+
+  it("#9301's default is trialFlowConfig minus the proof line #9302 added", () => {
+    const { meta, ...landing } = trialFlowConfig.landing!;
+    expect(meta).toEqual({ en: "A person on our team reviews every request." });
+    expect({ ...trialFlowConfig, landing }).toEqual(TRIAL_9301_DEFAULT);
+  });
+
+  it("writes the constants' slug, title and landing page, kind diagnostic, 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", '${TRIAL_FLOW_SLUG}',`);
+    expect(sql).toContain(
+      `'diagnostic', '${TRIAL_FLOW_TITLE}', 'live', false, 'lead', '${TRIAL_FLOW_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);
+  });
+
+  it("the whole migration is that one INSERT — no UPDATE or DELETE anywhere", () => {
+    const statements = withoutLiterals(MIGRATION_SQL.replace(/^--.*$/gm, ""))
+      .split(";")
+      .filter((s) => s.trim().length > 0);
+    expect(statements).toHaveLength(1);
+    expect(statements[0]!.trim()).toMatch(/^INSERT INTO "flow_definitions" /);
+    expect(withoutLiterals(MIGRATION_SQL.replace(/^--.*$/gm, ""))).not.toMatch(
+      /\b(UPDATE|DELETE)\b/i,
+    );
+  });
+});
+
+describe("the trial proof-line upgrade (#9302)", () => {
+  const sql = block("trial proof-line upgrade", PROOF_MIGRATION_SQL);
+  const statements = withoutLiterals(sql).split(";").filter((s) => s.trim().length > 0);
+
+  it("is one UPDATE of flow_definitions, and the whole migration is only that", () => {
+    expect(statements).toHaveLength(1);
+    expect(statements[0]!.trim()).toMatch(/^UPDATE "flow_definitions" SET /);
+    const all = withoutLiterals(PROOF_MIGRATION_SQL.replace(/^--.*$/gm, ""))
+      .split(";")
+      .filter((s) => s.trim().length > 0);
+    expect(all).toHaveLength(1);
+    expect(withoutLiterals(PROOF_MIGRATION_SQL.replace(/^--.*$/gm, ""))).not.toMatch(
+      /\b(INSERT|DELETE)\b/i,
+    );
+  });
+
+  it("its SET literal deep-equals trialFlowConfig, and it sets only config and updated_at", () => {
+    const set = /SET "config" = '(\{[\s\S]*?\})'::jsonb/.exec(sql);
+    expect(set?.[1]).toEqual(expect.any(String));
+    const parsed = parseLiteral(set![1]!);
+    expect(parsed).toEqual(trialFlowConfig);
+    expect(flowConfigSchema.safeParse(parsed).success).toBe(true);
+    expect(withoutLiterals(sql)).toMatch(
+      /SET "config" = ''::jsonb, "updated_at" = CURRENT_TIMESTAMP\s+WHERE /,
+    );
+  });
+
+  it("its WHERE names the trial slug and matches only #9301's exact default, so an owner's edit is never touched", () => {
+    expect(withoutLiterals(sql)).toMatch(/WHERE "slug" = '' AND "config" = ''::jsonb;\s*$/);
+    expect(sql).toContain(`WHERE "slug" = '${TRIAL_FLOW_SLUG}' AND "config" = '`);
+    const guard = /AND "config" = '(\{[\s\S]*?\})'::jsonb;/.exec(sql);
+    expect(guard?.[1]).toEqual(expect.any(String));
+    expect(parseLiteral(guard![1]!)).toEqual(TRIAL_9301_DEFAULT);
+  });
+});

package/templates/database/migrations/20261025120000_trial_magnet/migration.sql

@@ -0,0 +1,28 @@
+-- #9301 — the standard trial magnet (spec
+-- docs/specs/9287-operator-started-trials-spec.md D11, C1).
+--
+-- One marked block, re-runnable and held to its TypeScript constant by
+-- database/__tests__/trial-magnet-migration.test.ts, on the newsletter
+-- backfill's footing (20261022120000_in_page_magnets):
+--
+--   trial backfill   — every existing workspace gets the standard trial
+--                      magnet (`trialFlowConfig`, `diagnostic`, `live`,
+--                      landing page /trial, completion `lead`). Insert-only
+--                      on `(site_id, slug)`: a row already at `trial` (an
+--                      owner's own magnet included) is never changed. A
+--                      workspace created after this runs is seeded by
+--                      `POST /v1/workspaces`, and the seed-presets CLI covers
+--                      one created between this migration and the route
+--                      code's deploy.
+--
+-- Rollback: DELETE FROM "flow_definitions" WHERE "slug" = 'trial' AND
+-- "config" = <the backfill literal>::jsonb;
+
+-- BEGIN trial backfill
+INSERT INTO "flow_definitions" ("site_id", "workspace_id", "slug", "config", "kind", "title", "status", "customers_enabled", "completion", "landing_page", "updated_at")
+SELECT w."id", w."id", 'trial',
+  '{"slug":"trial","defaultLocale":"en","steps":[{"key":"about","type":"field","copy":{"title":{"en":"Free trial"},"cta":{"en":"Request my trial"}},"fields":[{"name":"first_name","inputType":"text","required":true,"mapsTo":"givenName","copy":{"label":{"en":"First name"}}},{"name":"last_name","inputType":"text","required":true,"mapsTo":"familyName","copy":{"label":{"en":"Last name"}}},{"name":"email","inputType":"email","required":true,"mapsTo":"email","copy":{"label":{"en":"Work email"}}},{"name":"terms","inputType":"consent","required":true,"purposes":["service_terms"],"copy":{"label":{"en":"I accept the [Terms](terms) and [Privacy Policy](privacy)."}}}]}],"ending":{"default":{"kind":"screen","headline":{"en":"Thanks, {name}."},"body":{"en":"We have your request and will be in touch about your trial."}}},"landing":{"title":{"en":"Free trial"},"description":{"en":"Try it free for 14 days. No card needed."},"cta":{"en":"Request a free trial"}}}'::jsonb,
+  'diagnostic', 'Free trial', 'live', false, 'lead', '/trial', CURRENT_TIMESTAMP
+FROM "workspaces" w
+ON CONFLICT ("site_id", "slug") DO NOTHING;
+-- END trial backfill

package/templates/database/migrations/20261026120000_trial_magnet_proof_line/migration.sql

@@ -0,0 +1,23 @@
+-- #9302 — the trial magnet's landing gains its proof line (spec
+-- docs/specs/9287-operator-started-trials-spec.md C2; operator decision on
+-- #9302, option (a)).
+--
+-- One marked block, held to its TypeScript constant by
+-- database/__tests__/trial-magnet-migration.test.ts, on the contact-form
+-- upgrade's footing (20261022120000_in_page_magnets):
+--
+--   trial proof-line upgrade — a trial magnet whose config is still exactly
+--                              #9301's shipped default (the backfill literal
+--                              in 20261025120000_trial_magnet) becomes
+--                              `trialFlowConfig`, which adds
+--                              `landing.meta`. An owner's edited trial magnet
+--                              is never touched. Sets nothing but `config`
+--                              and `updated_at`.
+--
+-- Rollback: UPDATE "flow_definitions" SET "config" = <the WHERE literal>::jsonb
+-- WHERE "slug" = 'trial' AND "config" = <the SET literal>::jsonb;
+
+-- BEGIN trial proof-line upgrade
+UPDATE "flow_definitions" SET "config" = '{"slug":"trial","defaultLocale":"en","steps":[{"key":"about","type":"field","copy":{"title":{"en":"Free trial"},"cta":{"en":"Request my trial"}},"fields":[{"name":"first_name","inputType":"text","required":true,"mapsTo":"givenName","copy":{"label":{"en":"First name"}}},{"name":"last_name","inputType":"text","required":true,"mapsTo":"familyName","copy":{"label":{"en":"Last name"}}},{"name":"email","inputType":"email","required":true,"mapsTo":"email","copy":{"label":{"en":"Work email"}}},{"name":"terms","inputType":"consent","required":true,"purposes":["service_terms"],"copy":{"label":{"en":"I accept the [Terms](terms) and [Privacy Policy](privacy)."}}}]}],"ending":{"default":{"kind":"screen","headline":{"en":"Thanks, {name}."},"body":{"en":"We have your request and will be in touch about your trial."}}},"landing":{"title":{"en":"Free trial"},"description":{"en":"Try it free for 14 days. No card needed."},"meta":{"en":"A person on our team reviews every request."},"cta":{"en":"Request a free trial"}}}'::jsonb, "updated_at" = CURRENT_TIMESTAMP
+WHERE "slug" = 'trial' AND "config" = '{"slug":"trial","defaultLocale":"en","steps":[{"key":"about","type":"field","copy":{"title":{"en":"Free trial"},"cta":{"en":"Request my trial"}},"fields":[{"name":"first_name","inputType":"text","required":true,"mapsTo":"givenName","copy":{"label":{"en":"First name"}}},{"name":"last_name","inputType":"text","required":true,"mapsTo":"familyName","copy":{"label":{"en":"Last name"}}},{"name":"email","inputType":"email","required":true,"mapsTo":"email","copy":{"label":{"en":"Work email"}}},{"name":"terms","inputType":"consent","required":true,"purposes":["service_terms"],"copy":{"label":{"en":"I accept the [Terms](terms) and [Privacy Policy](privacy)."}}}]}],"ending":{"default":{"kind":"screen","headline":{"en":"Thanks, {name}."},"body":{"en":"We have your request and will be in touch about your trial."}}},"landing":{"title":{"en":"Free trial"},"description":{"en":"Try it free for 14 days. No card needed."},"cta":{"en":"Request a free trial"}}}'::jsonb;
+-- END trial proof-line upgrade

package/templates/database/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@working-theory/database",
-  "version": "0.44.0",
+  "version": "0.45.0",
   "license": "Apache-2.0",
   "publishConfig": {
     "access": "public"

package/templates/database/seed.ts

@@ -41,6 +41,10 @@ import {
   REQUEST_QUOTE_FLOW_SLUG,
   REQUEST_QUOTE_FLOW_TITLE,
   requestQuoteFlowConfig,
+  TRIAL_FLOW_LANDING_PAGE,
+  TRIAL_FLOW_SLUG,
+  TRIAL_FLOW_TITLE,
+  trialFlowConfig,
 } from "@working-theory/validation";
 
 import type { PrismaClient } from "./generated/client/client.js";
@@ -217,6 +221,29 @@ export async function provisionDefaultWorkspace(
     update: {},
   });
 
+  // #9287 D11 — the standard trial magnet, the same way.
+  await prisma.flowDefinition.upsert({
+    where: {
+      siteId_slug: {
+        siteId: DEFAULT_WORKSPACE_ID,
+        slug: TRIAL_FLOW_SLUG,
+      },
+    },
+    create: {
+      siteId: DEFAULT_WORKSPACE_ID,
+      workspaceId: DEFAULT_WORKSPACE_ID,
+      slug: TRIAL_FLOW_SLUG,
+      config: trialFlowConfig,
+      kind: "diagnostic",
+      title: TRIAL_FLOW_TITLE,
+      status: "live",
+      customersEnabled: false,
+      completion: "lead",
+      landingPage: TRIAL_FLOW_LANDING_PAGE,
+    },
+    update: {},
+  });
+
   return { created: true };
 }