create-ailk 0.4.0 → 0.6.0

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

@@ -0,0 +1,240 @@
+{
+  "template": "simple-service",
+  "requires": ["marketing", "scheduling", "commerce"],
+  "categories": ["landscaping"],
+  "generatedHash": "f0dce515363186cee7ec9d1b1fd91d0ca11e039db31e843d1235d451dd49e736",
+  "layout": {
+    "nav": "full",
+    "footer": "columns",
+    "announcementBanner": true,
+    "home": "default"
+  },
+  "rows": [
+    {
+      "route": "/",
+      "pageType": "HomePage",
+      "schema": "HomePage",
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": [
+        {
+          "type": "hero",
+          "component": "Hero"
+        },
+        {
+          "type": "items",
+          "component": "Items"
+        },
+        {
+          "type": "cta",
+          "component": "CTA"
+        }
+      ]
+    },
+    {
+      "route": "/services",
+      "pageType": "ServicesList",
+      "schema": "ServicesList",
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": [
+        {
+          "type": "hero",
+          "component": "Hero"
+        },
+        {
+          "type": "items",
+          "component": "Items"
+        },
+        {
+          "type": "cta",
+          "component": "CTA"
+        }
+      ]
+    },
+    {
+      "route": "/services/[slug]",
+      "pageType": null,
+      "schema": null,
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": []
+    },
+    {
+      "route": "/about",
+      "pageType": "AboutPage",
+      "schema": "AboutPage",
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": [
+        {
+          "type": "content-block",
+          "component": "ContentBlock"
+        },
+        {
+          "type": "cta",
+          "component": "CTA"
+        }
+      ]
+    },
+    {
+      "route": "/contact",
+      "pageType": "ContactPage",
+      "schema": "ContactPage",
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": [
+        {
+          "type": "hero",
+          "component": "Hero"
+        },
+        {
+          "type": "contact-form",
+          "component": "ContactForm"
+        },
+        {
+          "type": "cta",
+          "component": "CTA"
+        }
+      ]
+    },
+    {
+      "route": "/faq",
+      "pageType": "FAQPage",
+      "schema": "FAQPage",
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": [
+        {
+          "type": "faq",
+          "component": "FAQ"
+        },
+        {
+          "type": "cta",
+          "component": "CTA"
+        }
+      ]
+    },
+    {
+      "route": "/returns",
+      "pageType": "ReturnsPolicyPage",
+      "schema": "ReturnsPolicyPage",
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": [
+        {
+          "type": "document-chassis",
+          "component": "DocumentChassis"
+        }
+      ]
+    },
+    {
+      "route": "/cancellation",
+      "pageType": "CancellationPolicyPage",
+      "schema": "CancellationPolicyPage",
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": [
+        {
+          "type": "document-chassis",
+          "component": "DocumentChassis"
+        }
+      ]
+    },
+    {
+      "route": "/shipping",
+      "pageType": "ShippingPolicyPage",
+      "schema": "ShippingPolicyPage",
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": [
+        {
+          "type": "document-chassis",
+          "component": "DocumentChassis"
+        }
+      ]
+    },
+    {
+      "route": "/privacy",
+      "pageType": "PrivacyPage",
+      "schema": "PrivacyPage",
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": [
+        {
+          "type": "document-chassis",
+          "component": "DocumentChassis"
+        }
+      ]
+    },
+    {
+      "route": "/terms",
+      "pageType": "TermsPage",
+      "schema": "TermsPage",
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": [
+        {
+          "type": "document-chassis",
+          "component": "DocumentChassis"
+        }
+      ]
+    },
+    {
+      "route": "/account",
+      "pageType": null,
+      "schema": null,
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": []
+    },
+    {
+      "route": "/purchase/success",
+      "pageType": null,
+      "schema": null,
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": []
+    },
+    {
+      "route": "/purchase/cancel",
+      "pageType": null,
+      "schema": null,
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": []
+    },
+    {
+      "route": "/meet",
+      "pageType": null,
+      "schema": null,
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": []
+    },
+    {
+      "route": "/meet/[slug]",
+      "pageType": null,
+      "schema": null,
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": []
+    },
+    {
+      "route": "/meet/confirmed",
+      "pageType": null,
+      "schema": null,
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": []
+    },
+    {
+      "route": "/appointments",
+      "pageType": null,
+      "schema": null,
+      "shell": "MarketingShell",
+      "chrome": "on",
+      "sections": []
+    }
+  ]
+}

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

@@ -0,0 +1,278 @@
+# 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.
+
+| Field                  | Value                                                                                                                     |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------- |
+| Template               | `simple-service`                                                                                                          |
+| Level                  | Pro (derived from `requires` — `scheduling` and `commerce` are paid; never declared)                                      |
+| `requires`             | `[marketing, scheduling, commerce]` — the first template to take `commerce`                                               |
+| `extends`              | `_base` — lineage only, never level                                                                                       |
+| Delivery               | licence-checked module bundle (#5441); never in the Free tarball                                                          |
+| Sample content posture | every line of copy, and all three service prices, are **placeholders** — and the prices are PUBLISHED as JSON-LD `Offer`s |
+
+## 1. Chrome
+
+This template declares **no `layout` block**. The default marketing-site chrome is what a lawn-care site wants — a nav row a reader can reach `/services` from, the four-column footer, and the document-scroll home — and the issue's STOP boundary excludes layout knobs the spec does not name.
+
+### Layout knobs (#5612)
+
+The template's `layout` block — resolved with `resolveSiteChrome`, defaults filled.
+
+<!-- generated:begin layout -->
+
+| Knob                 | Value     |
+| -------------------- | --------- |
+| `nav`                | `full`    |
+| `footer`             | `columns` |
+| `announcementBanner` | `true`    |
+| `home`               | `default` |
+
+<!-- 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:
+
+| Step      | Where it lives                                                                                                                                                                                           |
+| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Discovery | `/services` and the three `/services/<slug>` pages. Each detail page's top-level `price` + `priceCurrency` + `provider` become one schema.org `Offer` in its JSON-LD (#5838) — the free discovery floor. |
+| 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.                                                                                                           |
+
+## 3. Pages
+
+One `page=<route>` region per roster row, generated from the seed file the composed layer stack lands for that route.
+
+`/`:
+
+<!-- generated:begin page=/ -->
+
+| #   | 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                                     |
+| 3   | `cta` (minimal · 2 CTAs)                                   | `CTA`     | Ready for a tidier yard?                       |
+
+<!-- generated:end -->
+
+`/services`:
+
+<!-- generated:begin page=/services -->
+
+| #   | Section                                | Component | Copy (first line)        |
+| --- | -------------------------------------- | --------- | ------------------------ |
+| 1   | `hero` (centered · eyebrow "Services") | `Hero`    | Three jobs, three prices |
+| 2   | `items` (items ×3)                     | `Items`   | What we do               |
+| 3   | `cta` (minimal · 1 CTA)                | `CTA`     | Not sure which one?      |
+
+<!-- generated:end -->
+
+`/services/[slug]`:
+
+<!-- generated:begin page=/services/[slug] -->
+
+_Code route — no content, no sections._
+<!-- generated:end -->
+
+`/about`:
+
+<!-- generated:begin page=/about -->
+
+| #   | Section                                    | Component      | Copy (first line)                          |
+| --- | ------------------------------------------ | -------------- | ------------------------------------------ |
+| 1   | `content-block` (narrow · eyebrow "About") | `ContentBlock` | {A small crew, the same yards, every week} |
+| 2   | `cta` (minimal · 2 CTAs)                   | `CTA`          | Want us to take a look?                    |
+
+<!-- generated:end -->
+
+`/contact`:
+
+<!-- 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?         |
+
+<!-- generated:end -->
+
+`/faq`:
+
+<!-- generated:begin page=/faq -->
+
+| #   | Section                                                       | Component | Copy (first line)      |
+| --- | ------------------------------------------------------------- | --------- | ---------------------- |
+| 1   | `faq` (centered · items ×5 · supportLink · initialOpen first) | `FAQ`     | Questions              |
+| 2   | `cta` (minimal · 1 CTA)                                       | `CTA`     | Still have a question? |
+
+<!-- generated:end -->
+
+`/returns`:
+
+<!-- generated:begin page=/returns -->
+
+| #   | Section            | Component         | Copy (first line) |
+| --- | ------------------ | ----------------- | ----------------- |
+| 1   | `document-chassis` | `DocumentChassis` | Returns & Refunds |
+
+<!-- generated:end -->
+
+`/cancellation`:
+
+<!-- generated:begin page=/cancellation -->
+
+| #   | Section            | Component         | Copy (first line)   |
+| --- | ------------------ | ----------------- | ------------------- |
+| 1   | `document-chassis` | `DocumentChassis` | Cancellation Policy |
+
+<!-- generated:end -->
+
+`/shipping`:
+
+<!-- generated:begin page=/shipping -->
+
+| #   | Section            | Component         | Copy (first line) |
+| --- | ------------------ | ----------------- | ----------------- |
+| 1   | `document-chassis` | `DocumentChassis` | Shipping Policy   |
+
+<!-- generated:end -->
+
+`/privacy`:
+
+<!-- generated:begin page=/privacy -->
+
+| #   | Section                                                            | Component         | Copy (first line) |
+| --- | ------------------------------------------------------------------ | ----------------- | ----------------- |
+| 1   | `document-chassis` (eyebrow "PLACEHOLDER — REPLACE BEFORE LAUNCH") | `DocumentChassis` | Privacy Policy    |
+
+<!-- generated:end -->
+
+`/terms`:
+
+<!-- generated:begin page=/terms -->
+
+| #   | Section                                                            | Component         | Copy (first line) |
+| --- | ------------------------------------------------------------------ | ----------------- | ----------------- |
+| 1   | `document-chassis` (eyebrow "PLACEHOLDER — REPLACE BEFORE LAUNCH") | `DocumentChassis` | Terms of Service  |
+
+<!-- generated:end -->
+
+`/account`:
+
+<!-- generated:begin page=/account -->
+
+_Code route — no content, no sections._
+<!-- generated:end -->
+
+`/purchase/success`:
+
+<!-- generated:begin page=/purchase/success -->
+
+_Code route — no content, no sections._
+<!-- generated:end -->
+
+`/purchase/cancel`:
+
+<!-- generated:begin page=/purchase/cancel -->
+
+_Code route — no content, no sections._
+<!-- generated:end -->
+
+`/meet`:
+
+<!-- generated:begin page=/meet -->
+
+_Code route — no content, no sections._
+<!-- generated:end -->
+
+`/meet/[slug]`:
+
+<!-- generated:begin page=/meet/[slug] -->
+
+_Code route — no content, no sections._
+<!-- generated:end -->
+
+`/meet/confirmed`:
+
+<!-- generated:begin page=/meet/confirmed -->
+
+_Code route — no content, no sections._
+<!-- generated:end -->
+
+`/appointments`:
+
+<!-- generated:begin page=/appointments -->
+
+_Code route — no content, no sections._
+<!-- generated:end -->
+
+## 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:
+
+<!-- generated:begin roster -->
+
+```
+simple-service:
+  requires: [marketing, scheduling, commerce]
+  categories: [landscaping]
+  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" }
+```
+
+<!-- generated:end -->
+
+By source:
+
+```
+template:    / · /services · /services/<slug> · /about · /contact · /faq
+             /returns · /cancellation · /shipping · /privacy · /terms · /account
+             /purchase/success · /purchase/cancel
+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`.
+
+## 5. Component inventory
+
+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` |
+
+<!-- generated:end -->
+
+## 6. Known gaps this manifest depends on
+
+| Gap                                                                                          | Issue |
+| -------------------------------------------------------------------------------------------- | ----- |
+| No routes-map row for `/account`, `/appointments` or `/purchase/*`, so those rows show blank | #5572 |
+| The Pro demo host `simple-service.ailaunchkit.ai` — provisioning is the runbook's act        | #5778 |

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

@@ -0,0 +1,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.",
+  "installMap": {
+    "provenance.json": ".ailk-template.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."
+}

package/site-templates/simple-service/content/en/AboutPage/about.mdx

@@ -0,0 +1,38 @@
+---
+type: "AboutPage"
+slug: "about"
+title: "About"
+description: "The crew behind {your company}. Placeholder copy — replace before you launch."
+sections:
+  [
+    {
+      "id": "intro",
+      "type": "content-block",
+      "data":
+        {
+          "variant": "narrow",
+          "eyebrow": "About",
+          "headline": "{A small crew, the same yards, every week}",
+          "body": "{Two or three sentences on how the business started, how far you travel, and what you will not take on. Keep it short — this page is read on a phone in a driveway.}",
+        },
+    },
+    {
+      "id": "closing",
+      "type": "cta",
+      "data":
+        {
+          "variant": "minimal",
+          "headline": "Want us to take a look?",
+          "primaryCta": { "label": "Book a visit →", "href": "/meet" },
+          "secondaryCta":
+            {
+              "label": "Ask a question",
+              "href": "/contact",
+              "variant": "outline",
+            },
+        },
+    },
+  ]
+---
+
+Placeholder copy. This page overrides the always-copied overlay's `AboutPage/about.mdx`.

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

@@ -0,0 +1,67 @@
+---
+type: "ContactPage"
+slug: "contact"
+title: "Contact"
+description: "One form, three fields, an inline confirmation. Placeholder copy — replace before you launch."
+sections:
+  [
+    {
+      "id": "hero",
+      "type": "hero",
+      "data":
+        {
+          "variant": "centered",
+          "eyebrow": "Contact",
+          "headline": "Tell us about the yard",
+          "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",
+      "data":
+        {
+          "variant": "minimal",
+          "headline": "Would a visit be faster?",
+          "primaryCta": { "label": "Book a visit →", "href": "/meet" },
+        },
+    },
+  ]
+---
+
+The form posts to the site's own API (`/v1/leads/submit`) and confirms inline — no redirect, no thank-you page. Placeholder copy.