create-ailk 0.6.0 → 0.7.0

package/site-templates/simple-service/TEMPLATE-MANIFEST.md

@@ -1,6 +1,6 @@
 # Template manifest — `simple-service`
 
-> The T1 lawn-care template (#6087, Epic #5778) — the first site shape that composes `scheduling` and `commerce`: three priced services, a booker, a checkout return pair and the three #5947 policy pages. Generated file: the regions between `<!-- generated:begin <id> -->` and `<!-- generated:end -->` are produced by `scripts/build-template-manifest.mjs --template simple-service` from the composed layer stack (this tree → its required modules → `_base` → the always-copied overlay), each roster row's MDX `sections[]`, and `component-catalog.json`. Everything outside the markers is written by hand.
+> The T1 lawn-care template (#6087, Epic #5778) — the first site shape that composes `scheduling` and `commerce`: three priced services, a booker, a checkout return pair and a purchase policy (cancellation and refunds, #6646). Generated file: the regions between `<!-- generated:begin <id> -->` and `<!-- generated:end -->` are produced by `scripts/build-template-manifest.mjs --template simple-service` from the composed layer stack (this tree → its required modules → `_base` → the always-copied overlay), each roster row's MDX `sections[]`, and `component-catalog.json`. Everything outside the markers is written by hand.
 
 | Field                  | Value                                                                                                                     |
 | ---------------------- | ------------------------------------------------------------------------------------------------------------------------- |
@@ -25,11 +25,44 @@ The template's `layout` block — resolved with `resolveSiteChrome`, defaults fi
 | -------------------- | --------- |
 | `nav`                | `full`    |
 | `footer`             | `columns` |
-| `announcementBanner` | `true`    |
+| `announcementBanner` | `false`   |
 | `home`               | `default` |
 
 <!-- generated:end -->
 
+### Theme (locked)
+
+The template's `theme:` block as `_site.mdx` declares it — the shape knobs and the colour overlay. Generated, so a change to a locked template's look is a red `manifest:check`, not a silent drift (starter-template contract R3.5).
+
+<!-- generated:begin theme -->
+
+| Setting                  | Value      |
+| ------------------------ | ---------- |
+| `corners`                | `square`   |
+| `eyebrowCase`            | `sentence` |
+| `placeholders`           | `fill`     |
+| `checkmarks`             | `plain`    |
+| `colors.light.bg`        | `#ffffff`  |
+| `colors.light.bgMuted`   | `#ffffff`  |
+| `colors.light.surface`   | `#ffffff`  |
+| `colors.light.border`    | `#000000`  |
+| `colors.light.text`      | `#000000`  |
+| `colors.light.textMuted` | `#333333`  |
+| `colors.light.primary`   | `#000000`  |
+| `colors.light.primaryFg` | `#ffffff`  |
+| `colors.light.accent`    | `#000000`  |
+| `colors.dark.bg`         | `#000000`  |
+| `colors.dark.bgMuted`    | `#000000`  |
+| `colors.dark.surface`    | `#000000`  |
+| `colors.dark.border`     | `#ffffff`  |
+| `colors.dark.text`       | `#ffffff`  |
+| `colors.dark.textMuted`  | `#cccccc`  |
+| `colors.dark.primary`    | `#ffffff`  |
+| `colors.dark.primaryFg`  | `#000000`  |
+| `colors.dark.accent`     | `#ffffff`  |
+
+<!-- generated:end -->
+
 ## 2. The money path
 
 The whole point of this template is the first roster that takes a booking **and** the payment for it:
@@ -40,7 +73,7 @@ The whole point of this template is the first roster that takes a booking **and*
 | Booking   | `/meet`, `/meet/<slug>`, `/meet/confirmed` — the `scheduling` module's own contributed rows; `/appointments` is the site owner's own list (#6086).                                                       |
 | Payment   | a provider-hosted page on the seller's own Stripe account. Nothing on this site renders a card form.                                                                                                     |
 | Return    | `/purchase/success` and `/purchase/cancel` — base tree under #6084 D12's shape-2 disposition, gated at request time on the `commerce` licence claim.                                                     |
-| Policies  | `/returns`, `/cancellation`, `/shipping` (#5947) — their seed rides the always-copied overlay.                                                                                                           |
+| Policies  | `/purchase-policy` (#6646) — cancellation and refunds sections, this template's service-shape override of the overlay's product-shape seed.                                                              |
 
 ## 3. Pages
 
@@ -53,7 +86,7 @@ One `page=<route>` region per roster row, generated from the seed file the compo
 | #   | Section                                                    | Component | Copy (first line)                              |
 | --- | ---------------------------------------------------------- | --------- | ---------------------------------------------- |
 | 1   | `hero` (centered · eyebrow "{Your service area}" · 2 CTAs) | `Hero`    | {Lawn care that turns up when it says it will} |
-| 2   | `items` (items ×3)                                         | `Items`   | What we do                                     |
+| 2   | `items` (columns=3 · items ×3)                             | `Items`   | What we do                                     |
 | 3   | `cta` (minimal · 2 CTAs)                                   | `CTA`     | Ready for a tidier yard?                       |
 
 <!-- generated:end -->
@@ -65,7 +98,7 @@ One `page=<route>` region per roster row, generated from the seed file the compo
 | #   | Section                                | Component | Copy (first line)        |
 | --- | -------------------------------------- | --------- | ------------------------ |
 | 1   | `hero` (centered · eyebrow "Services") | `Hero`    | Three jobs, three prices |
-| 2   | `items` (items ×3)                     | `Items`   | What we do               |
+| 2   | `items` (columns=3 · items ×3)         | `Items`   | What we do               |
 | 3   | `cta` (minimal · 1 CTA)                | `CTA`     | Not sure which one?      |
 
 <!-- generated:end -->
@@ -74,7 +107,7 @@ One `page=<route>` region per roster row, generated from the seed file the compo
 
 <!-- generated:begin page=/services/[slug] -->
 
-_Code route — no content, no sections._
+_Detail route over `content/en/Service/` — 3 seed pages: `landscape-design.mdx`, `lawn-maintenance.mdx`, `seasonal-cleanup.mdx`._
 <!-- generated:end -->
 
 `/about`:
@@ -92,11 +125,10 @@ _Code route — no content, no sections._
 
 <!-- generated:begin page=/contact -->
 
-| #   | Section                               | Component     | Copy (first line)                |
-| --- | ------------------------------------- | ------------- | -------------------------------- |
-| 1   | `hero` (centered · eyebrow "Contact") | `Hero`        | Tell us about the yard           |
-| 2   | `contact-form` (card · fields ×3)     | `ContactForm` | Name · Email · What needs doing? |
-| 3   | `cta` (minimal · 1 CTA)               | `CTA`         | Would a visit be faster?         |
+| #   | Section                               | Component | Copy (first line)        |
+| --- | ------------------------------------- | --------- | ------------------------ |
+| 1   | `hero` (centered · eyebrow "Contact") | `Hero`    | Tell us about the yard   |
+| 2   | `cta` (minimal · 1 CTA)               | `CTA`     | Would a visit be faster? |
 
 <!-- generated:end -->
 
@@ -111,33 +143,45 @@ _Code route — no content, no sections._
 
 <!-- generated:end -->
 
-`/returns`:
+`/glossary`, `/newsletter` (base-layer seeds every starter carries, #6658 D5):
 
-<!-- generated:begin page=/returns -->
+<!-- generated:begin page=/glossary -->
 
-| #   | Section            | Component         | Copy (first line) |
-| --- | ------------------ | ----------------- | ----------------- |
-| 1   | `document-chassis` | `DocumentChassis` | Returns & Refunds |
+| #   | Section                             | Component       | Copy (first line)                            |
+| --- | ----------------------------------- | --------------- | -------------------------------------------- |
+| 1   | `hero` (eyebrow "Glossary" · 1 CTA) | `Hero`          | {Glossary: the terms your customers look up} |
+| 2   | `glossary-index` (columns)          | `GlossaryIndex` | {Terms, A to Z}                              |
 
 <!-- generated:end -->
 
-`/cancellation`:
+<!-- generated:begin page=/newsletter -->
+
+| #   | Section                               | Component    | Copy (first line)                                |
+| --- | ------------------------------------- | ------------ | ------------------------------------------------ |
+| 1   | `hero` (eyebrow "Newsletter" · 1 CTA) | `Hero`       | {Newsletter: what subscribers get and how often} |
+| 2   | `newsletter`                          | `Newsletter` | Subscribe                                        |
+| 3   | `faq` (expanded · items ×3)           | `FAQ`        | FAQs                                             |
+
+<!-- generated:end -->
 
-<!-- generated:begin page=/cancellation -->
+`/book-a-call` (this template's own override of the base seed — the call to action opens the `/meet` booker the scheduling module supplies, not `/contact`):
 
-| #   | Section            | Component         | Copy (first line)   |
-| --- | ------------------ | ----------------- | ------------------- |
-| 1   | `document-chassis` | `DocumentChassis` | Cancellation Policy |
+<!-- generated:begin page=/book-a-call -->
+
+| #   | Section                                | Component | Copy (first line)                          |
+| --- | -------------------------------------- | --------- | ------------------------------------------ |
+| 1   | `hero` (eyebrow "Book a call" · 1 CTA) | `Hero`    | {Book a call: what a visitor gets from it} |
+| 2   | `items` (columns=3 · items ×3)         | `Items`   | What happens on the call?                  |
 
 <!-- generated:end -->
 
-`/shipping`:
+`/purchase-policy`:
 
-<!-- generated:begin page=/shipping -->
+<!-- generated:begin page=/purchase-policy -->
 
-| #   | Section            | Component         | Copy (first line) |
-| --- | ------------------ | ----------------- | ----------------- |
-| 1   | `document-chassis` | `DocumentChassis` | Shipping Policy   |
+| #   | Section                             | Component         | Copy (first line) |
+| --- | ----------------------------------- | ----------------- | ----------------- |
+| 1   | `document-chassis` (layout=article) | `DocumentChassis` | Purchase Policy   |
 
 <!-- generated:end -->
 
@@ -145,9 +189,9 @@ _Code route — no content, no sections._
 
 <!-- generated:begin page=/privacy -->
 
-| #   | Section                                                            | Component         | Copy (first line) |
-| --- | ------------------------------------------------------------------ | ----------------- | ----------------- |
-| 1   | `document-chassis` (eyebrow "PLACEHOLDER — REPLACE BEFORE LAUNCH") | `DocumentChassis` | Privacy Policy    |
+| #   | Section                             | Component         | Copy (first line) |
+| --- | ----------------------------------- | ----------------- | ----------------- |
+| 1   | `document-chassis` (layout=article) | `DocumentChassis` | Privacy Policy    |
 
 <!-- generated:end -->
 
@@ -155,9 +199,9 @@ _Code route — no content, no sections._
 
 <!-- generated:begin page=/terms -->
 
-| #   | Section                                                            | Component         | Copy (first line) |
-| --- | ------------------------------------------------------------------ | ----------------- | ----------------- |
-| 1   | `document-chassis` (eyebrow "PLACEHOLDER — REPLACE BEFORE LAUNCH") | `DocumentChassis` | Terms of Service  |
+| #   | Section                             | Component         | Copy (first line) |
+| --- | ----------------------------------- | ----------------- | ----------------- |
+| 1   | `document-chassis` (layout=article) | `DocumentChassis` | Terms of Service  |
 
 <!-- generated:end -->
 
@@ -182,6 +226,13 @@ _Code route — no content, no sections._
 _Code route — no content, no sections._
 <!-- generated:end -->
 
+`/thanks/[slug]`:
+
+<!-- generated:begin page=/thanks/[slug] -->
+
+_Code route — no content, no sections._
+<!-- generated:end -->
+
 `/meet`:
 
 <!-- generated:begin page=/meet -->
@@ -212,7 +263,7 @@ _Code route — no content, no sections._
 
 ## 4. Roster, as the registry declares it
 
-`simple-service` is the second declared template that does not reuse `TEMPLATE_BASE_ROSTER`: a lawn-care site sells three named services from `/services`, not from a pricing table, so `/how-it-works`, `/features` and `/pricing` are not pages this site has. `/pricing`'s absence is not a missing file — the `_base` layer still lands `content/en/Pricing/pricing.mdx`; the roster is what the template IS, so an unrostered page simply has no route directory copied. The merged roster, as the registry composes it:
+`simple-service` is the second declared template that does not reuse `TEMPLATE_BASE_ROSTER`: a lawn-care site sells three named services from `/services`, not from a pricing table, so `/how-it-works`, the product page (`/software/product`) and `/pricing` are not pages this site has. The roster is what the template IS, so an unrostered page has neither a route directory nor its seed: `scaffold()` installs a `_base` or overlay seed only for a row that names it (#6646), so `content/en/Pricing/pricing.mdx` does not land. The merged roster, as the registry composes it:
 
 <!-- generated:begin roster -->
 
@@ -220,25 +271,29 @@ _Code route — no content, no sections._
 simple-service:
   requires: [marketing, scheduling, commerce]
   categories: [landscaping]
+  shape: local-business-service
+  design: standard
   roster:
-    - { route: "/",                 content: ["content/en/HomePage/home.mdx"] }
-    - { route: "/services",         content: ["content/en/ServicesList/services.mdx"] }
-    - { route: "/services/[slug]" }
-    - { route: "/about",            content: ["content/en/AboutPage/about.mdx"] }
-    - { route: "/contact",          content: ["content/en/ContactPage/contact.mdx"] }
-    - { route: "/faq",              content: ["content/en/FAQPage/faq.mdx"] }
-    - { route: "/returns",          content: ["content/en/ReturnsPolicyPage/returns.mdx"] }
-    - { route: "/cancellation",     content: ["content/en/CancellationPolicyPage/cancellation.mdx"] }
-    - { route: "/shipping",         content: ["content/en/ShippingPolicyPage/shipping.mdx"] }
-    - { route: "/privacy",          content: ["content/en/PrivacyPage/privacy.mdx"] }
-    - { route: "/terms",            content: ["content/en/TermsPage/terms.mdx"] }
-    - { route: "/account" }
-    - { route: "/purchase/success" }
-    - { route: "/purchase/cancel" }
-    - { route: "/meet" }
-    - { route: "/meet/[slug]" }
-    - { route: "/meet/confirmed" }
-    - { route: "/appointments" }
+    - { route: "/",                 kind: page, content: ["content/en/HomePage/home.mdx"] }
+    - { route: "/services",         kind: page, content: ["content/en/ServicesList/services.mdx"] }
+    - { route: "/services/[slug]",  kind: page, contentDir: "content/en/Service" }
+    - { route: "/about",            kind: page, content: ["content/en/AboutPage/about.mdx"] }
+    - { route: "/contact",          kind: page, content: ["content/en/ContactPage/contact.mdx"] }
+    - { route: "/faq",              kind: page, content: ["content/en/FAQPage/faq.mdx"] }
+    - { route: "/glossary",         kind: page, content: ["content/en/GlossaryList/glossary.mdx"] }
+    - { route: "/newsletter",       kind: page, content: ["content/en/NewsletterSignup/newsletter.mdx"] }
+    - { route: "/book-a-call",      kind: page, content: ["content/en/BookCall/book-call.mdx"] }
+    - { route: "/purchase-policy",  kind: page, content: ["content/en/PurchasePolicyPage/purchase-policy.mdx"] }
+    - { route: "/privacy",          kind: page, content: ["content/en/PrivacyPage/privacy.mdx"] }
+    - { route: "/terms",            kind: page, content: ["content/en/TermsPage/terms.mdx"] }
+    - { route: "/account",          kind: route }
+    - { route: "/purchase/success", kind: route }
+    - { route: "/purchase/cancel",  kind: route }
+    - { route: "/thanks/[slug]",    kind: route }
+    - { route: "/meet",             kind: route }
+    - { route: "/meet/[slug]",      kind: route }
+    - { route: "/meet/confirmed",   kind: route }
+    - { route: "/appointments",     kind: route }
 ```
 
 <!-- generated:end -->
@@ -247,14 +302,14 @@ By source:
 
 ```
 template:    / · /services · /services/<slug> · /about · /contact · /faq
-             /returns · /cancellation · /shipping · /privacy · /terms · /account
-             /purchase/success · /purchase/cancel
+             /purchase-policy · /privacy · /terms · /account
+             /purchase/success · /purchase/cancel · /thanks/<slug>
 scheduling:  /meet · /meet/<slug> · /meet/confirmed · /appointments
 ```
 
 **Why the two `/purchase/*` rows are the TEMPLATE's and not the `commerce` module's.** #6084 landed the checkout return pair under the operator's shape-2 disposition (#6084 D12): `CORE_ROUTE_DIRS` carries `[locale]/purchase`, and neither `GATEABLE_SURFACES` nor `MODULE_SURFACES.commerce` gained an entry, so `MODULE_SLICES.commerce` contributes **no** `pageContributions` at all. Nothing else claims the two routes, so declaring them here trips no both-claimants refusal — and the issue's AC-1 requires the merged roster to carry them. The four scheduling rows, by contrast, **are** the module's, and declaring one here would make `mergeRoster` refuse this template outright.
 
-`/account` and the three policy routes carry no `GATEABLE_SURFACES` entry and need none: `(authed)` ships unconditionally, and `/returns`, `/cancellation` and `/shipping` have no gateable surface at all, so they are always copied. The three module-less surfaces this roster enables are `privacy`, `services` and `terms`.
+`/account` and `/purchase-policy` carry no `GATEABLE_SURFACES` entry and need none: `(authed)` ships unconditionally, and `/purchase-policy` has no gateable surface at all, so it is always copied. The six module-less surfaces this roster enables are `book-a-call`, `glossary`, `newsletter`, `privacy`, `services` and `terms`.
 
 ## 5. Component inventory
 
@@ -262,11 +317,11 @@ Every component the roster rows' seed content composes today (generated):
 
 <!-- generated:begin inventory -->
 
-| Tier     | Used by this template                                                           |
-| -------- | ------------------------------------------------------------------------------- |
-| Shell    | `MarketingShell`                                                                |
-| Chrome   | `Nav`, `Footer`, `Banner` (+ `BannerConsentIsland`, `BannerDismissIsland`)      |
-| Sections | `ContactForm`, `ContentBlock`, `CTA`, `DocumentChassis`, `FAQ`, `Hero`, `Items` |
+| Tier     | Used by this template                                                                           |
+| -------- | ----------------------------------------------------------------------------------------------- |
+| Shell    | `MarketingShell`                                                                                |
+| Chrome   | `Nav`, `Footer`, `Banner` (+ `BannerConsentIsland`, `BannerDismissIsland`)                      |
+| Sections | `ContentBlock`, `CTA`, `DocumentChassis`, `FAQ`, `GlossaryIndex`, `Hero`, `Items`, `Newsletter` |
 
 <!-- generated:end -->
 

package/site-templates/simple-service/ailk-template.json

@@ -2,9 +2,10 @@
   "name": "simple-service",
   "requires": ["marketing", "scheduling", "commerce"],
   "extends": "_base",
-  "$comment": "The T1 lawn-care template (#6087, Epic #5778) — the first site shape that composes scheduling and commerce. Composed base -> modules -> template: /pricing (unrostered), /privacy and /terms arrive with the _base layer this extends; /meet, /meet/<slug>, /meet/confirmed and /appointments with the scheduling bundle; /purchase/success and /purchase/cancel are BASE TREE (#6084 D12 shape 2 — CORE_ROUTE_DIRS carries [locale]/purchase and the commerce licence claim, not the scaffold, decides whether they serve); /returns, /cancellation, /shipping, /how-it-works, /features, /sign-in and the Free about/contact/faq compositions with the always-copied overlay, which this template's own /about, /contact and /faq files then override. This tree holds ONLY its own compositions and its placeholder copy. It declares no layout block — the default marketing-site chrome is what this template renders with, and the code registry (TEMPLATE_MANIFESTS) is authoritative for a template create-ailk ships, so a duplicate block here would be a second authority for one fact. installMap: bundle-relative source -> scaffold-relative destination; the stager reads only installMap/postInstall/patches. Unmapped content/en/** lands at the scaffold root's content/, exactly as marketing-site-free's does.",
+  "$comment": "The T1 lawn-care template (#6087, Epic #5778) — the first site shape that composes scheduling and commerce. Composed base -> modules -> template: /privacy and /terms arrive with the _base layer this extends (its unrostered /pricing seed does not install, #6646), and /purchase-policy is this tree's own service-shape override of the overlay's product-shape seed (#6646 — cancellation and refunds sections); /meet, /meet/<slug>, /meet/confirmed and /appointments with the scheduling bundle; /purchase/success and /purchase/cancel are BASE TREE (#6084 D12 shape 2 — CORE_ROUTE_DIRS carries [locale]/purchase and the commerce licence claim, not the scaffold, decides whether they serve); the Free about/contact/faq compositions with the overlay, which this template's own /about, /contact and /faq files then override; the overlay's other seeds (/use-cases, the /software/product page, the /blog teaser) are unrostered here and do not install (#6646). This tree holds ONLY its own compositions and its placeholder copy. It declares no layout block — the default marketing-site chrome is what this template renders with, and the code registry (TEMPLATE_MANIFESTS) is authoritative for a template create-ailk ships, so a duplicate block here would be a second authority for one fact. installMap: bundle-relative source -> scaffold-relative destination; the stager reads only installMap/postInstall/patches. Unmapped content/en/** lands at the scaffold root's content/, exactly as marketing-site-free's does.",
   "installMap": {
-    "provenance.json": ".ailk-template.json"
+    "provenance.json": ".ailk-template.json",
+    "TEMPLATE-MANIFEST.json": ".ailk-site-manifest.json"
   },
-  "postInstall": "Template simple-service installed. This is the lawn-care shape: three priced services at /services (content/en/Service/), a booker at /meet from the scheduling module, the site owner's own list at /appointments, and the checkout return pair at /purchase/success and /purchase/cancel. /privacy and /terms came with the base layer; /returns, /cancellation and /shipping came with the overlay. This template adds the home page, /services and its three detail pages, /about, /contact and /faq. THE THREE PRICES ARE PLACEHOLDERS AND THEY ARE PUBLISHED: each service page's top-level price and priceCurrency become a schema.org Offer in that page's JSON-LD, which is what an agent reading your site quotes back to a buyer — replace all three, and the provider name with them, before you launch. Taking money needs the commerce licence claim and your own Stripe account: without the claim the return pages 404 by design. EVERY line of copy on this site is a placeholder too — replace it before you launch."
+  "postInstall": "Template simple-service installed. This is the lawn-care shape: three priced services at /services (content/en/Service/), a booker at /meet from the scheduling module, the site owner's own list at /appointments, and the checkout return pair at /purchase/success and /purchase/cancel. /privacy, /terms, /glossary and /newsletter came with the base layer, and /book-a-call is this template's own override of the base seed, its call to action opening the /meet booker. This template adds the home page, /services and its three detail pages, /about, /contact, /faq and /purchase-policy (cancellation and refunds). THE THREE PRICES ARE PLACEHOLDERS AND THEY ARE PUBLISHED: each service page's top-level price and priceCurrency become a schema.org Offer in that page's JSON-LD, which is what an agent reading your site quotes back to a buyer — replace all three, and the provider name with them, before you launch. Taking money needs the commerce licence claim and your own Stripe account: without the claim the return pages 404 by design. EVERY line of copy on this site is a placeholder too — replace it before you launch."
 }

package/site-templates/simple-service/content/en/BookCall/book-call.mdx

@@ -0,0 +1,53 @@
+---
+type: "BookCall"
+slug: "book-call"
+title: "{Book a call: what a visitor gets from it}"
+description: "{One sentence on who the call is for and what they leave with}"
+placeholder: true
+schema:
+  mainEntity:
+    "@type": "Offer"
+    name: "{Your call name}"
+    price: 0
+    priceCurrency: "USD"
+sections:
+  [
+    {
+      "id": "hero",
+      "type": "hero",
+      "data":
+        {
+          "eyebrow": "Book a call",
+          "headline": "{Book a call: what a visitor gets from it}",
+          "subheadline": "{One sentence on who the call is for and what they leave with}",
+          "primaryCta": { "label": "Book a time", "href": "/meet" },
+        },
+    },
+    {
+      "id": "what-happens-on-the-call",
+      "type": "items",
+      "data":
+        {
+          "headline": "What happens on the call?",
+          "columns": 3,
+          "items":
+            [
+              {
+                "title": "{The first thing you cover}",
+                "description": "{One or two sentences on what the visitor learns or decides here}",
+              },
+              {
+                "title": "{The second thing you cover}",
+                "description": "{One or two sentences on what the visitor learns or decides here}",
+              },
+              {
+                "title": "{The next step you agree}",
+                "description": "{One or two sentences on what happens after the call}",
+              },
+            ],
+        },
+    },
+  ]
+---
+
+{/* Rendered from frontmatter `sections[]` by the /book-a-call route. This template carries the scheduling module, so the call to action opens the /meet booker. It overrides the base layer's copy, which points at /contact. The `schema:` Offer is the page's JSON-LD main entity — a free call. Placeholder copy — replace every {brace} with your own words before you launch. */}

package/site-templates/simple-service/content/en/ContactPage/contact.mdx

@@ -16,41 +16,6 @@ sections:
           "subheadline": "{One line on what happens after you send this, and how long it takes. If a call is faster, say so.}",
         },
     },
-    {
-      "id": "contact-form",
-      "type": "contact-form",
-      "data":
-        {
-          "variant": "card",
-          "source": "contact",
-          "fields":
-            [
-              {
-                "name": "name",
-                "label": "Name",
-                "type": "text",
-                "required": true,
-              },
-              {
-                "name": "email",
-                "label": "Email",
-                "type": "email",
-                "required": true,
-              },
-              {
-                "name": "message",
-                "label": "What needs doing?",
-                "type": "textarea",
-                "required": true,
-              },
-            ],
-          "submitLabel": "Send →",
-          "consentText": "I accept the Terms",
-          "consentLink": { "label": "Terms", "href": "/terms" },
-          "successMessage": "Thank you — your message is in. You will hear back within {time amount}.",
-          "action": "/v1/leads/submit",
-        },
-    },
     {
       "id": "closing",
       "type": "cta",
@@ -64,4 +29,4 @@ sections:
   ]
 ---
 
-The form posts to the site's own API (`/v1/leads/submit`) and confirms inline — no redirect, no thank-you page. Placeholder copy.
+The /contact route mounts the page's one contact surface — the guided intake, with its fallback form — which posts to the site's own API (`/v1/leads/submit`) and confirms inline. Placeholder copy.

package/site-templates/simple-service/content/en/PurchasePolicyPage/purchase-policy.mdx

@@ -0,0 +1,124 @@
+---
+type: "PurchasePolicyPage"
+slug: "purchase-policy"
+title: "Purchase Policy"
+description: "How cancellations, reschedules and refunds work for bookings made on this site. Placeholder policy — replace every section before you launch."
+placeholder: true
+sections:
+  [
+    {
+      "id": "purchase-policy-document",
+      "type": "document-chassis",
+      "data":
+        {
+          "headline": "Purchase Policy",
+          "layout": "article",
+          "updated": "Last updated {Month Day, Year}",
+          "navGroupLabel": "Contents",
+          "sections":
+            [
+              {
+                "id": "cancellation",
+                "heading": "Cancellation",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "This page is starter content that shipped with your site. It is not a purchase policy, it makes no commitment on behalf of Your Company, and it is not legal advice. Replace every section with the policy you actually operate, and have someone qualified read it before you publish.",
+                    },
+                    {
+                      "kind": "paragraph",
+                      "text": "This section explains how cancellations and reschedules work for bookings made on this site. The headings are the ones a customer and an agent both look for, so keep them and fill in your own terms.",
+                    },
+                  ],
+                "subsections":
+                  [
+                    {
+                      "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": "refunds",
+                "heading": "Refunds",
+                "blocks":
+                  [
+                    {
+                      "kind": "paragraph",
+                      "text": "Say what a customer gets back after a cancellation — the booking price, the deposit, or both, and how long the refund takes to reach the payment method it came from. If you offer store credit or a rebooking instead, describe when each applies.",
+                    },
+                  ],
+                "subsections":
+                  [
+                    {
+                      "id": "questions",
+                      "heading": "Questions about a refund",
+                      "blocks":
+                        [
+                          {
+                            "kind": "paragraph",
+                            "text": "Point to the one place a customer should write, and say roughly how quickly you answer. A policy nobody can ask a question about is a policy that generates disputes.",
+                          },
+                        ],
+                    },
+                  ],
+              },
+            ],
+        },
+    },
+  ]
+---
+
+{/* Rendered from frontmatter `sections[]`; the MDX body is not read by the section-catalog renderer. Service shape (#6646): cancellation and refunds — this template's override of the `_base` product-shape seed. The JSON-LD — a WebPage, wrapping a MerchantReturnPolicy when a returns section is present — is emitted by `buildPurchasePolicyPage` (#6646), not hand-rolled here. */}

package/templates/.claude/settings.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cd \"$CLAUDE_PROJECT_DIR\" && [ -x node_modules/.bin/tsx ] || exit 0; pnpm --silent architecture >&2 || exit 2"
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/.claude/skills/README.md

@@ -9,14 +9,14 @@ them automatically at session start — nothing to install or enable.
 
 ## Available skills
 
-| Skill                 | Purpose                                                                                                 |
-| ---------------------- | -------------------------------------------------------------------------------------------------------- |
-| `suggest-site-pages`  | Recommend a starter set of pages — each tagged with a schema.org type — from a free-text business description. |
-| `scaffold-page`       | Generate a new page: App Router route + MDX content stub + typed JSON-LD, in one confirm-before-write pass. |
-| `add-schema`          | Add or replace schema.org JSON-LD on a page that already exists.                                        |
-| `scaffold-auth`       | Activate auth providers — magic-link via Resend, Google OAuth, GitHub OAuth.                            |
-| `provision-config`    | Emit deploy configuration — `vercel.json`, `.env.example`, and `RUNBOOK.md` — for a Vercel deploy.       |
-| `audit-site`          | Run `ailk-audit --json` and explain the score and findings in plain language.                           |
+| Skill          | Purpose                                                                                                      |
+| -------------- | -------------------------------------------------------------------------------------------------------------- |
+| `add-page`     | Generate a new page: App Router route + MDX content stub + typed JSON-LD, in one confirm-before-write pass. Also documents the `schema:` frontmatter override for adding supplementary structured data to a page that already exists. |
+| `add-auth`     | Activate auth providers — magic-link via Resend, Google OAuth, GitHub OAuth.                                  |
+| `setup-deploy` | Emit deploy configuration — `vercel.json`, `.env.example`, and `RUNBOOK.md` — for a Vercel deploy.            |
+| `check-site`   | Run `ailk-audit --json` and explain the score and findings in plain language.                                 |
+| `fill-page`    | Fill one page's section content from a category profile: labelled sample content (tier 1) or your own first draft from a short intake (tier 2). |
+| `upgrade-plan` | Compare Free, Pro, Pro Plus, Agency and the commerce add-on side by side, with the prices the public pricing page publishes right now, and recommend one option for this site with a reason. |
 
 `scaffold-commerce` is delivered with the commerce module (`--modules commerce`, licensed).