create-ailk 0.8.0 → 0.10.0

package/README.md

@@ -52,9 +52,9 @@ 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`.
+three named aliases (`marketing-site-free`, `marketing-site`, `saas-product`) —
+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
 
@@ -94,6 +94,45 @@ result of the roster check (`Page roster check: clean`). Running it again
 changes nothing and reports nothing to add.
 Run `pnpm install` afterwards.
 
+### Apply a design to an existing site
+
+A site that already exists can wear a different design with one command. Name
+a shipped design, or point at a directory holding a `DESIGN.md`:
+
+```bash
+# in an already-scaffolded repo (default target: cwd)
+create-ailk apply-design minimalism
+# a design package on disk, applied to a repo named explicitly
+create-ailk apply-design ./designs/acme --target ./my-site
+```
+
+It changes how the site **looks**, never what it **is**. It writes only:
+
+- the `theme:` block of `content/_site.mdx` — every other key, the `brand:`
+  block included, and the body stay byte-for-byte;
+- the generated `apps/web/lib/site-chrome.ts` — the design's layout, under any
+  knob the site's own template sets (so a template's announcement banner
+  stays on);
+- the look fields of sections the site's pages already place, from the
+  design's `sections:` presets;
+- the `design`, `layout` and `theme` record in `.ailk-site-manifest.json`.
+
+It never adds, removes or renames a route or page, never touches a content
+field, and leaves every page's structured data unchanged. It prints the files
+it changed; running it again changes nothing. A site whose roster is the older
+root `TEMPLATE-MANIFEST.json` gets the look but no record, and the report says
+so.
+
+A design other than `standard` needs a Pro or Pro Plus key. The key is read
+from the site's own `ailk.key` (put one there with
+`create-ailk license set <key>`), else from `AILK_LICENSE_KEY`. A malformed
+package, a preset the validator refuses or a missing key is refused before
+anything is written, naming the field or the licence level.
+
+A preset **sets** the look fields it names and never unsets one: a field it
+does not name keeps whatever value the page has, including one a previous
+design set.
+
 ### Sync `architecture.yaml` after adding a module
 
 `add-module` above regenerates `architecture.yaml` itself. To regenerate it by
@@ -114,6 +153,35 @@ no install. Because `deriveArchitecture` is byte-deterministic, the synced file
 is identical to a fresh scaffold's for the same module set — the idempotency
 the deferred-sync signal contract depends on.
 
+### Keep `CLAUDE.md` aligned with the template
+
+A scaffold's root `CLAUDE.md` is a run of AI Launch Kit sections, each between
+`<!-- ailk:template id="…" sha256="…" -->` and `<!-- /ailk:template id="…" -->`,
+followed by a **Site notes** section that starts at `<!-- ailk:site -->` and is
+the site owner's alone. Each begin marker records the SHA-256 of its section,
+so the scaffold's own check needs no network:
+
+```bash
+# in the scaffold — fails naming any template section edited by hand
+pnpm claude-md:check          # also runs inside `pnpm preflight` and CI
+```
+
+To pull a newer template's sections into an existing site:
+
+```bash
+# in an already-scaffolded repo (default target: cwd)
+pnpm create ailk@latest --sync-claude-md
+# or point at the repo explicitly
+pnpm create ailk@latest --sync-claude-md ./my-site
+```
+
+It rewrites only the template sections of `CLAUDE.md` and writes no other
+file; Site notes, and anything between sections (such as a pasted CloudParity
+block, which goes just above `<!-- ailk:site -->`), are kept byte for byte. A
+`CLAUDE.md` from before these markers is replaced only when it is an unedited
+published template; an edited one is refused with the steps to move your
+notes across.
+
 ### Sync template routes into an existing site
 
 The template is copied once, at scaffold time. When a later release adds a

package/component-catalog.json

@@ -4686,7 +4686,19 @@
           "headline"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant",
+        "size",
+        "surface",
+        "accentStyle",
+        "eyebrowTone",
+        "subtitleSize",
+        "gapBelow",
+        "measure",
+        "ctaSize",
+        "fill"
+      ]
     },
     {
       "type": "feature",
@@ -4926,7 +4938,18 @@
           "features"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant",
+        "cardShape",
+        "itemStyle",
+        "actionsPosition",
+        "surface",
+        "headlineSize",
+        "numbered",
+        "numberTone",
+        "itemTitleSize"
+      ]
     },
     {
       "type": "items",
@@ -4942,7 +4965,8 @@
               "default",
               "branded",
               "minimal",
-              "tile"
+              "tile",
+              "tiles"
             ]
           },
           "tileHover": {
@@ -5117,7 +5141,16 @@
           "items"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant",
+        "tileHover",
+        "align",
+        "columns",
+        "separation",
+        "gap",
+        "surface"
+      ]
     },
     {
       "type": "content-block",
@@ -5323,7 +5356,16 @@
           }
         }
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant",
+        "mediaPosition",
+        "accentStyle",
+        "glow",
+        "surface",
+        "align",
+        "fill"
+      ]
     },
     {
       "type": "video-section",
@@ -5478,7 +5520,13 @@
           "video"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "width",
+        "surface",
+        "headlineSize",
+        "playBadge"
+      ]
     },
     {
       "type": "faq",
@@ -5663,7 +5711,19 @@
           }
         }
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant",
+        "presentation",
+        "initialOpen",
+        "containerWidth",
+        "density",
+        "questionSize",
+        "answerSize",
+        "dividerTone",
+        "surface",
+        "headlineSize"
+      ]
     },
     {
       "type": "objection",
@@ -5783,7 +5843,13 @@
           "items"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant",
+        "density",
+        "responseSize",
+        "dividerTone"
+      ]
     },
     {
       "type": "stats",
@@ -6007,7 +6073,17 @@
           "items"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant",
+        "labelStep",
+        "labelTone",
+        "cardVariant",
+        "separation",
+        "gap",
+        "surface",
+        "headlineSize"
+      ]
     },
     {
       "type": "testimonials",
@@ -6132,7 +6208,15 @@
           "items"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant",
+        "separation",
+        "gap",
+        "avatarSize",
+        "avatarShape",
+        "surface"
+      ]
     },
     {
       "type": "social-proof",
@@ -6230,7 +6314,12 @@
           "items"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant",
+        "separation",
+        "gap"
+      ]
     },
     {
       "type": "pricing",
@@ -6869,7 +6958,21 @@
           "plans"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "featureListStyle",
+        "cardLayout",
+        "toggleStyle",
+        "gapAbove",
+        "addonLayout",
+        "headlineSize",
+        "variant",
+        "separation",
+        "gap",
+        "surface",
+        "bandSurface",
+        "collapseFeaturesOnMobile"
+      ]
     },
     {
       "type": "cta",
@@ -7017,7 +7120,11 @@
           "primaryCta"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant",
+        "surface"
+      ]
     },
     {
       "type": "logoCloud",
@@ -7147,7 +7254,14 @@
           "logos"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "headlineStyle",
+        "layout",
+        "treatment",
+        "logoSize",
+        "surface"
+      ]
     },
     {
       "type": "gallery",
@@ -7253,7 +7367,10 @@
           "images"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "columns"
+      ]
     },
     {
       "type": "media-band",
@@ -7312,7 +7429,11 @@
           }
         }
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "aspect",
+        "width"
+      ]
     },
     {
       "type": "awards",
@@ -7437,7 +7558,10 @@
           "badges"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "surface"
+      ]
     },
     {
       "type": "spotlight-panel",
@@ -7512,7 +7636,10 @@
           "headline"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "dimStrength"
+      ]
     },
     {
       "type": "tabs",
@@ -7602,7 +7729,12 @@
           "tabs"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "alignment",
+        "indicator",
+        "tone"
+      ]
     },
     {
       "type": "before-after",
@@ -8064,7 +8196,11 @@
           "after"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "defaultView",
+        "lightbox"
+      ]
     },
     {
       "type": "bento-grid",
@@ -8184,7 +8320,10 @@
           "items"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "gap"
+      ]
     },
     {
       "type": "carousel",
@@ -8311,7 +8450,12 @@
           "items"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "autoplay",
+        "interval",
+        "controls"
+      ]
     },
     {
       "type": "team",
@@ -8542,7 +8686,19 @@
           "members"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant",
+        "avatarSize",
+        "avatarShape",
+        "carded",
+        "largePhotos",
+        "hoverReveal",
+        "separation",
+        "gap",
+        "phoneColumns",
+        "surface"
+      ]
     },
     {
       "type": "contact-form",
@@ -8742,7 +8898,11 @@
           "fields"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant",
+        "pattern"
+      ]
     },
     {
       "type": "step-flow",
@@ -8934,7 +9094,10 @@
           "action"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "arrowIcon"
+      ]
     },
     {
       "type": "contact-channels",
@@ -9002,7 +9165,10 @@
           "items"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "layout"
+      ]
     },
     {
       "type": "newsletter",
@@ -9118,7 +9284,11 @@
           "action"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "pattern",
+        "surface"
+      ]
     },
     {
       "type": "glossary-index",
@@ -9172,7 +9342,10 @@
           "terms"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant"
+      ]
     },
     {
       "type": "blog-list",
@@ -9319,7 +9492,10 @@
           "posts"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant"
+      ]
     },
     {
       "type": "blog-post",
@@ -9548,7 +9724,10 @@
           "publishedAt"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant"
+      ]
     },
     {
       "type": "separator",
@@ -9644,7 +9823,14 @@
           }
         }
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "size",
+        "rule",
+        "shape",
+        "upperSurface",
+        "lowerSurface"
+      ]
     },
     {
       "type": "comparison-table",
@@ -9867,7 +10053,13 @@
           "groups"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "separation",
+        "variant",
+        "headlineSize",
+        "checkStyle"
+      ]
     },
     {
       "type": "definition",
@@ -9946,7 +10138,12 @@
           "definition"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant",
+        "definitionSize",
+        "borderTone"
+      ]
     },
     {
       "type": "payment-receipt",
@@ -10019,7 +10216,8 @@
           "statusLabel"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": []
     },
     {
       "type": "scheduler-embed",
@@ -10100,7 +10298,12 @@
           }
         }
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "surface",
+        "height",
+        "layout"
+      ]
     },
     {
       "type": "alert",
@@ -10132,7 +10335,8 @@
           "tone"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": []
     },
     {
       "type": "decision-split",
@@ -10308,7 +10512,11 @@
           "panels"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "surface",
+        "headlineSize"
+      ]
     },
     {
       "type": "auth-panel",
@@ -10409,7 +10617,8 @@
           }
         }
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": []
     },
     {
       "type": "ask-ai",
@@ -10466,7 +10675,11 @@
           "promptText"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant",
+        "surface"
+      ]
     },
     {
       "type": "stair-steps",
@@ -10567,7 +10780,11 @@
           "tiles"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "direction",
+        "headlineSize"
+      ]
     },
     {
       "type": "document-chassis",
@@ -10801,7 +11018,12 @@
           "sections"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "accentStyle",
+        "layout",
+        "surface"
+      ]
     },
     {
       "type": "document-viewer",
@@ -10892,7 +11114,10 @@
           "pages"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "surface"
+      ]
     },
     {
       "type": "report-header",
@@ -10929,7 +11154,10 @@
           "title"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "tone"
+      ]
     },
     {
       "type": "reports-list",
@@ -11029,7 +11257,12 @@
           "reports"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": [
+        "variant",
+        "tone",
+        "surface"
+      ]
     },
     {
       "type": "booker",
@@ -11066,7 +11299,8 @@
           "calLink"
         ]
       },
-      "schemaError": null
+      "schemaError": null,
+      "look": []
     }
   ],
   "sectionSchemaFailures": 0,