create-ailk 0.4.0 → 0.6.0

package/templates/apps/web/src/lib/commerce-claim.ts

@@ -0,0 +1,33 @@
+/**
+ * The deployment's `commerce` add-on claim, resolved PER REQUEST (#6084 D12).
+ *
+ * Extracted from `app/.well-known/mcp.json/route.ts`'s own inline
+ * `resolveCommerceClaim()` (#5971) — that route's behaviour is unchanged;
+ * only its import line moves. `/purchase/success` and `/purchase/cancel`
+ * need the identical check (D12's shape-2 gate: the pages ship BASE TREE
+ * and gate at REQUEST time on this claim, exactly as the checkout
+ * primitives do — `apps/api/src/lib/require-commerce-claim.ts`), so this is
+ * extracted ONCE and imported three times rather than copied a third time.
+ *
+ * Fail-closed (NFR-3 mirror): anything short of a positively-held,
+ * unrevoked claim reads as absent, and a licence read that throws never
+ * takes the caller down with it. Called PER REQUEST rather than memoised —
+ * unlike `apps/mcp/src/lib/commerce-claim.ts`'s boot-time memoisation — so a
+ * site that buys commerce after its last deploy starts serving immediately
+ * rather than waiting on a redeploy.
+ */
+import { checkLicense } from "@working-theory/license";
+
+/** The licence `features[]` claim that turns the commerce add-on on. */
+const COMMERCE_FEATURE = "commerce";
+
+export async function resolveCommerceClaim(): Promise<boolean> {
+  try {
+    const result = await checkLicense();
+    return (
+      result.revoked !== true && result.features.includes(COMMERCE_FEATURE)
+    );
+  } catch {
+    return false;
+  }
+}

package/templates/apps/web/src/lib/commerce-sections.ts

@@ -0,0 +1,61 @@
+/**
+ * Lazily registers the paid `@working-theory/ui-commerce` slice's sections
+ * (`payment-receipt`) — never a static top-level import (#6084, code-review
+ * finding on this issue's PR).
+ *
+ * `/purchase/success` and `/purchase/cancel` ship in the BASE TREE
+ * (`surfaces.ts` `CORE_ROUTE_DIRS`, D12) so a site that buys the `commerce`
+ * add-on after its last deploy gets working return pages without a
+ * redeploy. But a KEYLESS scaffold carries NO `ui-commerce` dependency by
+ * design — `packages/create-ailk/scripts/build-templates.mjs`'s
+ * `transformPaidUiPackages()` strips it from a keyless `apps/web/package.json`,
+ * and `__tests__/paid-module-honest-states.test.ts`'s "#5581 U6" suite
+ * asserts a keyless scaffold declares NONE of the four paid `ui-*` packages
+ * as a dependency. A plain top-level, STATIC named-import of that package's
+ * `registerCommerceSections` export would leave every keyless customer's
+ * build failing with `ERR_MODULE_NOT_FOUND` — webpack resolves a static
+ * import at BUILD time regardless of whether the code path importing it
+ * ever executes at runtime, so gating the CALL at request time (as
+ * `resolveCommerceClaim()` already does) is not enough on its own.
+ *
+ * The `webpackIgnore` magic comment tells webpack to leave this `import()`
+ * unresolved at build time; Node's own ESM loader then attempts it at
+ * RUNTIME, where a keyless deployment's absent package throws a genuine
+ * (caught) resolution error instead of a build failure. This repo's `dev`
+ * and `build` scripts both force `--webpack` (never Turbopack, which does
+ * not honor this comment), so the magic comment is reliably honored here.
+ *
+ * On success, the real `payment-receipt` renderer is registered and the
+ * caller may build a `payment-receipt` section as usual. On failure (the
+ * package genuinely is not installed), the caller MUST NOT construct a bare
+ * `payment-receipt` section anyway — `SectionRenderer`'s dispatch table
+ * falls back to `ModuleAbsent`, which renders `null` in production
+ * (`packages/ui/src/sections/ModuleAbsent.tsx`) — silently dropping the
+ * title/message/status that is this page's entire point. The caller must
+ * build an OSS `content-block` fallback carrying the same copy instead.
+ *
+ * Registered (or found absent) once per process — memoised, so a concurrent
+ * request never double-registers or double-attempts a failed resolution.
+ * This is a build-presence fact, not the license claim itself (which
+ * `resolveCommerceClaim()` deliberately re-checks every request); a
+ * process only changes which packages are on disk via a fresh deploy, which
+ * is a fresh process.
+ */
+let registration: Promise<boolean> | undefined;
+
+export function ensureCommerceSectionsRegistered(): Promise<boolean> {
+  if (!registration) {
+    registration = (async () => {
+      try {
+        const mod = await import(
+          /* webpackIgnore: true */ "@working-theory/ui-commerce"
+        );
+        mod.registerCommerceSections();
+        return true;
+      } catch {
+        return false;
+      }
+    })();
+  }
+  return registration;
+}

package/templates/apps/web/src/lib/routes.ts

@@ -5,6 +5,8 @@
  * handlers to avoid copy-paste duplication.
  */
 
+import { routeFor } from "@working-theory/templates/routes";
+
 import { SITE_BASE_URL } from "../../lib/site-brand";
 
 /**
@@ -29,22 +31,15 @@ export function resolveBaseUrl(): string {
 /**
  * Maps a content-adapter page type + slug to a site-relative path.
  * Drives both /llms.txt and /sitemap.xml URL generation.
+ *
+ * A lookup over the routes map (#5572 U2, spec § D4 row 1) — `routeFor` is
+ * byte-identical to the switch this replaced for its six `case` literals and
+ * the `` `/${slug}` `` default (proven by
+ * `packages/templates/src/__tests__/routes-map.test.ts`'s table test and
+ * `apps/web/__tests__/routes/routes-map-identity.test.ts`'s differential
+ * test over the live content tree). The signature is annotated explicitly so
+ * this stays the exact `(type: string, slug: string) => string` contract the
+ * three call sites (`sitemap.xml`, `llms.txt`, `docs-blog/llms-route.ts`)
+ * depend on, even though `routeFor`'s own `slug` parameter is optional.
  */
-export function slugToPath(type: string, slug: string): string {
-  switch (type) {
-    case "HomePage":
-      return "/";
-    case "BlogPosting":
-      return `/blog/${slug}`;
-    case "Product":
-      return `/products/${slug}`;
-    case "Service":
-      return `/services/${slug}`;
-    case "AboutPage":
-      return "/about";
-    case "ContactPage":
-      return "/contact";
-    default:
-      return `/${slug}`;
-  }
-}
+export const slugToPath: (type: string, slug: string) => string = routeFor;

package/templates/brand_assets/README.md

@@ -0,0 +1,24 @@
+# brand_assets/
+
+This folder is where you put your project's real brand material. It ships
+empty — nothing here is required to run `pnpm dev` — but populating it is
+what lets Claude Code (and anyone else building this site) use your actual
+brand instead of inventing placeholder colors and copy.
+
+`apps/web/CLAUDE.md` reads from this folder before designing a page. If a
+file below is present, it's used; if it's absent, generic defaults are used
+instead.
+
+## What goes here
+
+| File / folder                   | Contents                                                                                                                               |
+| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| `logo.svg` (or `.png`)          | Your logo, ideally an SVG. Add light/dark variants if your mark needs them (e.g. `logo-dark.svg`).                                     |
+| `brand-guide.md`                | The global theme — brand colors, type direction, tone of voice, do's and don'ts — used when choosing layout and components for a page. |
+| `brand-brief.md`                | Positioning, messaging, and the target citation phrases a page's content should work toward.                                           |
+| `favicon.ico` / `favicon-*.png` | Favicon assets for `apps/web/app/favicon.ico` and any additional sizes your deploy target wants.                                       |
+| `photos/`                       | Real photography — team, product, office — to use instead of stock or placeholder images.                                              |
+| `reference/`                    | Mockups, screenshots, or other visual references to match when building or reviewing a page's design.                                  |
+
+None of these are mandatory. Add what you have; the rest can stay
+placeholder until you're ready.

package/templates/content/en/AboutPage/about.mdx

@@ -1,29 +1,174 @@
 ---
 type: "AboutPage"
 slug: "about"
-title: "About {{COMPANY_NAME}}"
-description: "Replace this with a sentence about who you are and why you do this work."
+title: "We want you to {ability they couldn't do before}"
+description: "We want you to {ability they couldn't do before}"
 sections:
   [
     {
-      "id": "hero",
-      "type": "hero",
-      "data":
-        {
-          "headline": "About {{COMPANY_NAME}}",
-          "subheadline": "Replace this with the short version of your story.",
+      "id": "manifesto",
+      "type": "content-block",
+      "data": {
+        "variant": "media-right",
+        "eyebrow": "Manifesto",
+        "headline": "We want you to {ability they couldn't do before}",
+        "body": "Hey, I’m {your name}, the founder of {your company}.\n\nWrite a few sentences introducing the problems you solve. You can even ask a rhetorical question to get people thinking about their own personal experiences with a problem they might have encountered.\n\nThis is your chance to tell the backstory of why your product exists and explain the gap your product fills. Don’t be afraid to take a stance and plant your flag.\n\nWe believe that {you should be able to X without Y}.\n\nWe’ll help you:\n\nSolve this problem\n\nSolve another problem\n\nSolve this other problem\n\nIf that resonates with you, you're in the right place.\n\n- (your name)",
+        "cta": {
+          "label": "Sign Up",
+          "href": "/sign-in"
         },
+        "secondaryCta": {
+          "label": "More about us",
+          "href": "/about",
+          "variant": "outline"
+        }
+      }
     },
     {
-      "id": "why-we-exist",
-      "type": "content-block",
-      "data":
-        {
-          "headline": "Why we exist",
-          "body": "Replace this paragraph with the reason your organization exists — the problem you kept running into, or the gap you decided to fill. Concrete beats aspirational.",
+      "id": "team",
+      "type": "team",
+      "data": {
+        "headline": "Our team",
+        "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
+        "members": [
+          {
+            "name": "Anya Lind",
+            "role": "Head of Growth",
+            "bio": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique."
+          },
+          {
+            "name": "Narciso Gerlach",
+            "role": "Head of Sales",
+            "bio": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique."
+          },
+          {
+            "name": "Edythe Sanford",
+            "role": "Head of Content",
+            "bio": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique."
+          },
+          {
+            "name": "Angeline Watsica",
+            "role": "Head of Conversion",
+            "bio": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique."
+          },
+          {
+            "name": "Gerardo Ullrich",
+            "role": "Head of Marketing",
+            "bio": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique."
+          }
+        ]
+      }
+    },
+    {
+      "id": "logo-cloud",
+      "type": "logoCloud",
+      "data": {
+        "headline": "Don’t just take our word for it",
+        "logos": [
+          {
+            "name": "Placeholder logo",
+            "src": "/logomark.svg"
+          },
+          {
+            "name": "Placeholder logo",
+            "src": "/logomark.svg"
+          },
+          {
+            "name": "Placeholder logo",
+            "src": "/logomark.svg"
+          },
+          {
+            "name": "Placeholder logo",
+            "src": "/logomark.svg"
+          },
+          {
+            "name": "Placeholder logo",
+            "src": "/logomark.svg"
+          },
+          {
+            "name": "Placeholder logo",
+            "src": "/logomark.svg"
+          }
+        ],
+        "layout": "inline",
+        "treatment": "monochrome"
+      }
+    },
+    {
+      "id": "testimonial",
+      "type": "testimonials",
+      "data": {
+        "variant": "featured",
+        "items": [
+          {
+            "quote": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique. Duis cursus, mi quis viverra ornare, eros dolor interdum nulla, ut commodo diam libero vitae erat.",
+            "author": "John Smith",
+            "role": "CEO, Google"
+          }
+        ]
+      }
+    },
+    {
+      "id": "switch",
+      "type": "cta",
+      "data": {
+        "variant": "box",
+        "headline": "Switch to {your product} in {time amount} or less",
+        "description": "You shouldn't have to {experience a painful problem}. With {your product}, you can finally {achieve a value outcome or get a big improvement}.",
+        "chips": [
+          "No credit card required",
+          "Cancel any time",
+          "Live chat support"
+        ],
+        "primaryCta": {
+          "label": "{Primary CTA}",
+          "href": "/contact"
+        },
+        "secondaryCta": {
+          "label": "{Secondary CTA}",
+          "href": "/pricing",
+          "variant": "outline"
         },
+        "closingLine": "{Social Proof goes here}"
+      }
     },
+    {
+      "id": "faq",
+      "type": "faq",
+      "data": {
+        "headline": "FAQs",
+        "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique.",
+        "supportLink": {
+          "label": "Contact",
+          "href": "/contact"
+        },
+        "presentation": "accordion",
+        "initialOpen": "first",
+        "items": [
+          {
+            "question": "Vel odio odit voluptatum ut veritatis. Ex rerum aspernatur voluptas unde officia. Dolorem officiis laboriosa?",
+            "answer": "Vel odio odit voluptatum ut veritatis. Ex rerum aspernatur voluptas unde officia. Dolorem officiis laboriosa odio odit voluptatum ut veritatis. Ex rerum aspernatur voluptas unde officia. Dolorem officiis laboriosa."
+          },
+          {
+            "question": "Dolorem consectetur quia maxime sunt ut sint. Fuga optio dolorem animi voluptatem laudantium error. Quis accusamus deleniti rer?",
+            "answer": "Vel odio odit voluptatum ut veritatis. Ex rerum aspernatur voluptas unde officia. Dolorem officiis laboriosa odio odit voluptatum ut veritatis. Ex rerum aspernatur voluptas unde officia. Dolorem officiis laboriosa."
+          },
+          {
+            "question": "Totam nihil esse. Itaque optio temporibus adipisci. Rerum nisi aperiam aliquid doloremque aliquam?",
+            "answer": "Vel odio odit voluptatum ut veritatis. Ex rerum aspernatur voluptas unde officia. Dolorem officiis laboriosa odio odit voluptatum ut veritatis. Ex rerum aspernatur voluptas unde officia. Dolorem officiis laboriosa."
+          },
+          {
+            "question": "Delectus minus officiis et. Perspiciatis illum nisi vitae. Sed consequuntur animi corrupti distinctio ipsam accusamus?",
+            "answer": "Vel odio odit voluptatum ut veritatis. Ex rerum aspernatur voluptas unde officia. Dolorem officiis laboriosa odio odit voluptatum ut veritatis. Ex rerum aspernatur voluptas unde officia. Dolorem officiis laboriosa."
+          },
+          {
+            "question": "Aperiam perferendis voluptatem est sit enim sed eaque perspiciatis enim. Est explicabo ea explicabo et et dignissimos aliquid?",
+            "answer": "Vel odio odit voluptatum ut veritatis. Ex rerum aspernatur voluptas unde officia. Dolorem officiis laboriosa odio odit voluptatum ut veritatis. Ex rerum aspernatur voluptas unde officia. Dolorem officiis laboriosa."
+          }
+        ]
+      }
+    }
   ]
 ---
 
-{/* Rendered from frontmatter `sections[]`. A `team` section is a good next addition here once you have people to list. */}
+{/* Rendered from frontmatter `sections[]`. Placeholder copy, verbatim from the reference — replace the manifesto and the team before you launch. */}

package/templates/content/en/CancellationPolicyPage/cancellation.mdx

@@ -0,0 +1,108 @@
+---
+type: "CancellationPolicyPage"
+slug: "cancellation"
+title: "Cancellation Policy"
+description: "How to cancel or reschedule a booking on this site, the notice required, and what a late cancellation or no-show costs."
+updatedAt: "2026-09-17"
+sections:
+  [
+    {
+      "id": "cancellation-document",
+      "type": "document-chassis",
+      "data":
+        {
+          "headline": "Cancellation Policy",
+          "backHref": "/",
+          "backLabel": "Back home",
+          "navGroupLabel": "Contents",
+          "stats":
+            [
+              { "label": "Last updated", "sublabel": "17 September 2026" },
+              { "label": "Applies to", "sublabel": "Bookings made on this site" },
+            ],
+          "sections":
+            [
+              {
+                "id": "intro",
+                "heading": "Cancellation Policy",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "This page explains how cancellations and reschedules work for bookings made on this site. Replace the starter copy below with the policy you actually operate — the headings are the ones a customer and an agent both look for, so keep them and fill in your own terms.",
+                    },
+                  ],
+              },
+              {
+                "id": "notice",
+                "heading": "How much notice is required",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "State the notice period in hours before the appointment, and say how it is measured. A customer reading at midnight should be able to work out, without arithmetic you have not shown them, whether they are still inside it.",
+                    },
+                  ],
+              },
+              {
+                "id": "how-to-cancel",
+                "heading": "How to cancel or reschedule",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "Give one route to cancel and one to reschedule, and say whether a reschedule inside the notice period counts as a cancellation. If a booking confirmation carries a self-service link, name it here.",
+                    },
+                  ],
+              },
+              {
+                "id": "fees",
+                "heading": "Late cancellations and no-shows",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "Say what a late cancellation costs and what a no-show costs, as a figure or a share of the booking, and when each is charged. If you hold a deposit, say what happens to it in each case.",
+                    },
+                  ],
+              },
+              {
+                "id": "our-cancellations",
+                "heading": "If we cancel",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "Set out what a customer gets if you cancel or move an appointment — a full refund, a rebooking, or both — and how quickly you tell them. A policy that only binds one side reads as one.",
+                    },
+                  ],
+              },
+              {
+                "id": "exceptions",
+                "heading": "Exceptions",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "Name the circumstances in which you waive a fee — illness, bereavement, severe weather — and say what you need from the customer to apply the waiver. Vague discretion is worse for you than a short written list.",
+                    },
+                  ],
+              },
+              {
+                "id": "contact",
+                "heading": "Questions about a booking",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "Point to the one place a customer should write, and say roughly how quickly you answer.",
+                    },
+                  ],
+              },
+            ],
+        },
+    },
+  ]
+---
+
+{/* Rendered from frontmatter `sections[]`; the MDX body is not read by the section-catalog renderer. schema.org has no cancellation-policy type, so this page emits a plain WebPage (#5947, D2) — a real policy field reaches the JSON-LD through the `schema:` escape hatch, never a coined @type. */}

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

@@ -2,27 +2,104 @@
 type: "ContactPage"
 slug: "contact"
 title: "Contact {{COMPANY_NAME}}"
-description: "How to reach {{COMPANY_NAME}}. Replace this with the channels you actually monitor."
+description: "Find out if {your product} is a good fit for you in just {time amount}."
 sections:
   [
     {
       "id": "hero",
       "type": "hero",
-      "data":
-        {
-          "headline": "Contact {{COMPANY_NAME}}",
-          "subheadline": "Replace this with how you prefer to be reached, and how quickly you reply.",
-        },
+      "data": {
+        "variant": "split",
+        "eyebrow": "Book a Demo",
+        "headline": "Ready to {achieve a valuable outcome}?",
+        "subheadline": "Find out if {your product} is a good fit for you in just {time amount}.",
+        "checklist": [
+          "Use these bullet points to describe what to expect on the call",
+          "Alleviate any fears or hesitations visitors might have before scheduling",
+          "Frame the meeting around what they get out of it instead of what you get out of it"
+        ]
+      }
     },
     {
-      "id": "channels",
-      "type": "content-block",
-      "data":
-        {
-          "body": "Replace this with your contact channels — email, a booking link, a form. List only the ones you actually monitor: a published channel nobody watches is worse than no channel.",
-        },
+      "id": "contact-form",
+      "type": "contact-form",
+      "data": {
+        "variant": "card",
+        "fields": [
+          {
+            "name": "name",
+            "label": "Name",
+            "type": "text",
+            "required": true
+          },
+          {
+            "name": "email",
+            "label": "Email",
+            "type": "email",
+            "required": true
+          },
+          {
+            "name": "message",
+            "label": "Message",
+            "type": "textarea",
+            "required": true
+          }
+        ],
+        "consentText": "I accept the Terms",
+        "successMessage": "Thank you! Your submission has been received!",
+        "action": "/v1/leads/submit"
+      }
     },
+    {
+      "id": "logo-cloud",
+      "type": "logoCloud",
+      "data": {
+        "headline": "Don’t just take our word for it",
+        "logos": [
+          {
+            "name": "Placeholder logo",
+            "src": "/logomark.svg"
+          },
+          {
+            "name": "Placeholder logo",
+            "src": "/logomark.svg"
+          },
+          {
+            "name": "Placeholder logo",
+            "src": "/logomark.svg"
+          },
+          {
+            "name": "Placeholder logo",
+            "src": "/logomark.svg"
+          },
+          {
+            "name": "Placeholder logo",
+            "src": "/logomark.svg"
+          },
+          {
+            "name": "Placeholder logo",
+            "src": "/logomark.svg"
+          }
+        ],
+        "layout": "inline",
+        "treatment": "monochrome"
+      }
+    },
+    {
+      "id": "testimonial",
+      "type": "testimonials",
+      "data": {
+        "variant": "featured",
+        "items": [
+          {
+            "quote": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique. Duis cursus, mi quis viverra ornare, eros dolor interdum nulla, ut commodo diam libero vitae erat.",
+            "author": "John Smith",
+            "role": "CEO, Google"
+          }
+        ]
+      }
+    }
   ]
 ---
 
-{/* Rendered from frontmatter `sections[]`. Swap the content-block above for a `contact-channels` section once you know your channels. */}
+{/* Rendered from frontmatter `sections[]`. The form posts to the site's own API (`/v1/leads/submit`) and confirms inline. Placeholder copy — replace before you launch. */}