create-ailk 0.7.0 → 0.8.0

package/README.md

@@ -7,7 +7,7 @@ canonical install path per [ADR 0007](../../docs/adr/0007-install-path-canonical
 ## Usage
 
 ```bash
-pnpm create ailk@latest my-site
+pnpm create ailk@latest my-site --shape organization-product
 cd my-site
 pnpm install
 pnpm dev
@@ -16,17 +16,46 @@ pnpm dev
 Compose the site from modules with `--modules`. The recognized vocabulary is
 `RECOGNIZED_MODULES` in `src/parse-args.ts` — `marketing`, `docs-blog`,
 `multi-tenant`, `workspace`, `scheduling`, `signal-collectors`, `commerce` —
-and the default when the flag is absent is `marketing` (`DEFAULT_MODULES`, same
-file):
+and `--modules` TRIMS or ADDS relative to the level your licence key unlocks
+(#6759), never replaces it: with no key the level is Free (`marketing`
+alone); a Pro key switches on `docs-blog`, `scheduling` and
+`signal-collectors` too; Pro Plus adds `multi-tenant`. Naming modules here
+keeps exactly those, trimming the level's default; naming only `commerce`
+(a per-site add-on) or `workspace` (included at Pro, opt-in) adds it on top
+of the level's default without trimming. The level is always DERIVED from
+what the module registry answers for your key — never read from a flag, a
+manifest or a key claim (`src/lib/module-tier.ts` `LEVEL_MODULES`,
+`src/lib/module-license-gate.ts` `deriveLevel`):
 
 ```bash
-pnpm create ailk@latest my-site --modules marketing,docs-blog
+pnpm create ailk@latest my-site --shape organization-product --modules marketing,docs-blog
 ```
 
 Every recognized module except `marketing` is a paid module, delivered under a
 license key rather than shipped inside this package — see
 [Paid modules require `AILK_LICENSE_KEY`](#paid-modules-require-ailk_license_key).
 
+### Shape, level and design
+
+Every scaffold also picks a shape and, optionally, a design. `--shape`'s
+vocabulary is `RECOGNIZED_SHAPES` in `src/parse-args.ts` — `organization-product`,
+`organization-service`, `local-business-service`, `person-service` (the README
+already lists `RECOGNIZED_MODULES` the same way); `local-business-product` is
+refused as not available yet. A terminal run with no `--shape` asks; a
+non-interactive one stops. The level comes only from your license key: no key
+is Free, and a key switches on its level's modules (`LEVEL_MODULES`) —
+`--modules` trims or adds relative to that set, as above. A keyed example:
+
+```bash
+pnpm create ailk@latest my-site --shape organization-service --license <key>
+```
+
+`--design minimalism` picks the other look and needs a Pro or Pro Plus key;
+`standard` (the default) needs none. `--template <alias>` scaffolds one of the
+four named aliases (`marketing-site-free`, `marketing-site`, `saas-product`,
+`minimalism-site`) — each fixes a shape, a design and its own module list — and
+cannot be combined with `--shape` or `--design`.
+
 ### Add a purchased module to an existing site
 
 A site scaffolded without a paid module (a Free site whose owner then buys
@@ -183,16 +212,21 @@ a refused run leaves no partial scaffold behind.
 
 ```bash
 # free-only — no key read, no network call
-pnpm create ailk@latest my-site --modules marketing
+pnpm create ailk@latest my-site --shape organization-product --modules marketing
 
 # paid — the key is read from the environment
-AILK_LICENSE_KEY=... pnpm create ailk@latest my-site --modules marketing,docs-blog
+AILK_LICENSE_KEY=... pnpm create ailk@latest my-site --shape organization-product --modules marketing,docs-blog
 ```
 
-A request that names no paid module never reaches the key check at all:
-`resolvePaidModules` returns an empty map on its first branch, before touching
-`process.env` or the network, so a free-only `--modules` request reads no env
-var and makes no network call (`src/lib/module-license-gate.ts`).
+The network invariant (#6759 D6), in full:
+
+- **No key** → no request at all. A request that names no paid module never
+  reaches the key check either: `resolvePaidModules` returns an empty map on
+  its first branch, before touching `process.env` or the network.
+- **A key with no `--modules`** → the level probe (`deriveLevel`): 3-4
+  requests, to find out what the key unlocks.
+- **An explicit `--modules` list** → requests only for the paid modules it
+  names, exactly as before this level mechanism existed.
 
 ## What it does
 

package/component-catalog.json

@@ -9,7 +9,7 @@
       "importPath": "@working-theory/ui/sections",
       "rootBarrel": "@working-theory/ui",
       "sourceRoot": "packages/ui/src/sections",
-      "count": 54
+      "count": 55
     },
     {
       "name": "blocks",
@@ -17,7 +17,7 @@
       "importPath": "@working-theory/ui/blocks",
       "rootBarrel": "@working-theory/ui",
       "sourceRoot": "packages/ui/src/blocks",
-      "count": 97
+      "count": 99
     },
     {
       "name": "chrome",
@@ -188,6 +188,17 @@
       "descriptionGrade": "strong",
       "sectionType": "awards"
     },
+    {
+      "name": "BeforeAfter",
+      "tier": "sections",
+      "sourcePath": "packages/ui/src/sections/BeforeAfter.tsx",
+      "importPath": "@working-theory/ui/sections",
+      "exported": true,
+      "description": "A before/after comparison — use on a case-study or portfolio page to show what a client had and what they have now: two labeled panels behind a Side-by-side / Before / After selector, each body an image or rows of content, with an optional catalyst column between them and a key-takeaway box below.",
+      "descriptionSource": "registry",
+      "descriptionGrade": "strong",
+      "sectionType": "before-after"
+    },
     {
       "name": "BentoGrid",
       "tier": "sections",
@@ -991,6 +1002,17 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "ContactFallback",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/ContactFallback.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "The contact email in place of a contact form. Shown when a site cannot take messages through its form: in production with neither a database nor an email key, the page renders this instead, and `LeadCaptureForm`'s `unavailable` state renders this same markup when a submit is refused — so the two fallbacks are one component.",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "ContactFormFields",
       "tier": "blocks",
@@ -1167,6 +1189,17 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "LeadCaptureForm",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/LeadCaptureForm.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "The one contact form every template renders. Submits ONLY through the `action` prop — a Server Action the page binds — so there is no fetch, no URL and no browser-side JSON here.",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "LinkCard",
       "tier": "blocks",
@@ -4912,6 +4945,13 @@
               "tile"
             ]
           },
+          "tileHover": {
+            "type": "string",
+            "enum": [
+              "lift",
+              "outline"
+            ]
+          },
           "eyebrow": {
             "type": "string"
           },
@@ -6218,7 +6258,15 @@
             "type": "string",
             "enum": [
               "soft",
-              "solid"
+              "solid",
+              "switch"
+            ]
+          },
+          "gapAbove": {
+            "type": "string",
+            "enum": [
+              "default",
+              "tight"
             ]
           },
           "addonLayout": {
@@ -7556,6 +7604,468 @@
       },
       "schemaError": null
     },
+    {
+      "type": "before-after",
+      "component": "BeforeAfter",
+      "whenToUse": "A before/after comparison — use on a case-study or portfolio page to show what a client had and what they have now: two labeled panels behind a Side-by-side / Before / After selector, each body an image or rows of content, with an optional catalyst column between them and a key-takeaway box below.",
+      "schema": {
+        "$schema": "https://json-schema.org/draft/2020-12/schema",
+        "type": "object",
+        "properties": {
+          "header": {
+            "type": "object",
+            "properties": {
+              "headline": {
+                "type": "string"
+              },
+              "tagline": {
+                "type": "string"
+              },
+              "tags": {
+                "maxItems": 6,
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "logo": {
+                "type": "object",
+                "properties": {
+                  "src": {
+                    "type": "string"
+                  },
+                  "alt": {
+                    "type": "string"
+                  },
+                  "width": {
+                    "type": "number"
+                  },
+                  "height": {
+                    "type": "number"
+                  },
+                  "blurDataURL": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "src",
+                  "alt"
+                ]
+              }
+            },
+            "required": [
+              "headline"
+            ]
+          },
+          "pager": {
+            "type": "object",
+            "properties": {
+              "prev": {
+                "type": "object",
+                "properties": {
+                  "label": {
+                    "type": "string"
+                  },
+                  "href": {
+                    "type": "string"
+                  },
+                  "variant": {
+                    "type": "string",
+                    "enum": [
+                      "default",
+                      "outline",
+                      "secondary",
+                      "ghost",
+                      "link",
+                      "gradient"
+                    ]
+                  },
+                  "external": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "label",
+                  "href"
+                ]
+              },
+              "next": {
+                "type": "object",
+                "properties": {
+                  "label": {
+                    "type": "string"
+                  },
+                  "href": {
+                    "type": "string"
+                  },
+                  "variant": {
+                    "type": "string",
+                    "enum": [
+                      "default",
+                      "outline",
+                      "secondary",
+                      "ghost",
+                      "link",
+                      "gradient"
+                    ]
+                  },
+                  "external": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "label",
+                  "href"
+                ]
+              },
+              "backTo": {
+                "type": "object",
+                "properties": {
+                  "label": {
+                    "type": "string"
+                  },
+                  "href": {
+                    "type": "string"
+                  },
+                  "variant": {
+                    "type": "string",
+                    "enum": [
+                      "default",
+                      "outline",
+                      "secondary",
+                      "ghost",
+                      "link",
+                      "gradient"
+                    ]
+                  },
+                  "external": {
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "label",
+                  "href"
+                ]
+              }
+            }
+          },
+          "before": {
+            "type": "object",
+            "properties": {
+              "label": {
+                "type": "string"
+              },
+              "tone": {
+                "type": "string",
+                "enum": [
+                  "brand",
+                  "accent",
+                  "neutral",
+                  "success",
+                  "error",
+                  "warning",
+                  "info"
+                ]
+              },
+              "icon": {
+                "type": "string"
+              },
+              "align": {
+                "type": "string",
+                "enum": [
+                  "start",
+                  "center",
+                  "end"
+                ]
+              },
+              "image": {
+                "type": "object",
+                "properties": {
+                  "src": {
+                    "type": "string"
+                  },
+                  "alt": {
+                    "type": "string"
+                  },
+                  "width": {
+                    "type": "number"
+                  },
+                  "height": {
+                    "type": "number"
+                  },
+                  "blurDataURL": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "src",
+                  "alt"
+                ]
+              },
+              "rows": {
+                "maxItems": 8,
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "title": {
+                      "type": "string"
+                    },
+                    "body": {
+                      "type": "string"
+                    },
+                    "icon": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "title",
+                    "body"
+                  ]
+                }
+              },
+              "verdict": {
+                "type": "string"
+              },
+              "notes": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "label"
+            ]
+          },
+          "after": {
+            "type": "object",
+            "properties": {
+              "label": {
+                "type": "string"
+              },
+              "tone": {
+                "type": "string",
+                "enum": [
+                  "brand",
+                  "accent",
+                  "neutral",
+                  "success",
+                  "error",
+                  "warning",
+                  "info"
+                ]
+              },
+              "icon": {
+                "type": "string"
+              },
+              "align": {
+                "type": "string",
+                "enum": [
+                  "start",
+                  "center",
+                  "end"
+                ]
+              },
+              "image": {
+                "type": "object",
+                "properties": {
+                  "src": {
+                    "type": "string"
+                  },
+                  "alt": {
+                    "type": "string"
+                  },
+                  "width": {
+                    "type": "number"
+                  },
+                  "height": {
+                    "type": "number"
+                  },
+                  "blurDataURL": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "src",
+                  "alt"
+                ]
+              },
+              "rows": {
+                "maxItems": 8,
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "title": {
+                      "type": "string"
+                    },
+                    "body": {
+                      "type": "string"
+                    },
+                    "icon": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "title",
+                    "body"
+                  ]
+                }
+              },
+              "verdict": {
+                "type": "string"
+              },
+              "notes": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "label"
+            ]
+          },
+          "catalyst": {
+            "type": "object",
+            "properties": {
+              "image": {
+                "type": "object",
+                "properties": {
+                  "src": {
+                    "type": "string"
+                  },
+                  "alt": {
+                    "type": "string"
+                  },
+                  "width": {
+                    "type": "number"
+                  },
+                  "height": {
+                    "type": "number"
+                  },
+                  "blurDataURL": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "src",
+                  "alt"
+                ]
+              },
+              "title": {
+                "type": "string"
+              },
+              "subtitle": {
+                "type": "string"
+              },
+              "tone": {
+                "type": "string",
+                "enum": [
+                  "brand",
+                  "accent",
+                  "neutral",
+                  "success",
+                  "error",
+                  "warning",
+                  "info"
+                ]
+              },
+              "arrow": {
+                "type": "boolean"
+              },
+              "steps": {
+                "maxItems": 8,
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "label": {
+                      "type": "string"
+                    },
+                    "marker": {
+                      "type": "string",
+                      "maxLength": 2
+                    }
+                  },
+                  "required": [
+                    "label"
+                  ]
+                }
+              }
+            },
+            "required": [
+              "title"
+            ]
+          },
+          "takeaway": {
+            "type": "object",
+            "properties": {
+              "label": {
+                "type": "string"
+              },
+              "body": {
+                "type": "string"
+              },
+              "icon": {
+                "type": "string"
+              },
+              "tone": {
+                "type": "string",
+                "enum": [
+                  "brand",
+                  "accent",
+                  "neutral",
+                  "success",
+                  "error",
+                  "warning",
+                  "info"
+                ]
+              }
+            },
+            "required": [
+              "body"
+            ]
+          },
+          "defaultView": {
+            "type": "string",
+            "enum": [
+              "side-by-side",
+              "before",
+              "after"
+            ]
+          },
+          "viewLabels": {
+            "type": "object",
+            "properties": {
+              "sideBySide": {
+                "type": "string"
+              },
+              "before": {
+                "type": "string"
+              },
+              "after": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "sideBySide",
+              "before",
+              "after"
+            ]
+          },
+          "lightbox": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "before",
+          "after"
+        ]
+      },
+      "schemaError": null
+    },
     {
       "type": "bento-grid",
       "component": "BentoGrid",
@@ -8229,8 +8739,7 @@
           }
         },
         "required": [
-          "fields",
-          "action"
+          "fields"
         ]
       },
       "schemaError": null
@@ -8693,6 +9202,9 @@
                 "slug": {
                   "type": "string"
                 },
+                "href": {
+                  "type": "string"
+                },
                 "excerpt": {
                   "type": "string"
                 },
@@ -8914,6 +9426,9 @@
                 "slug": {
                   "type": "string"
                 },
+                "href": {
+                  "type": "string"
+                },
                 "excerpt": {
                   "type": "string"
                 },