create-kywi-app 0.10.0 → 0.11.0

package/assets/agent-patterns.md

@@ -441,20 +441,22 @@ interchangeable.
   page is complete with JavaScript off. This is the default for anything the
   server can know — rule-based audiences (UTM, referrer, the `kywi_audience`
   pin) and A/B experiments. Since 0.6.3 it also renders in the layout editor as
-  a badged block with an **arm switcher**, each arm editable with the ordinary
-  section/column/module tools, so server-resolution no longer costs the owner
-  their editing surface. Since kywi-cms#119, the owner doesn't need an agent to
-  hand-author this shape at all: the section chrome — in the admin layout
-  editor and in the in-place front-of-site overlay alike — offers
-  **Personalize this section** / **A/B test** actions that wrap an ordinary
-  section into a section-level variant container on the spot, seeding the
-  default arm from the section's current content and opening straight into its
-  config (audience/experiment picker included). An agent only needs to reach
-  for `update_layout` when scripting bulk changes or building a container the
-  UI can't reach.
+  a badged block with a **variant switcher** (internal editor code —
+  `activeArms`, the `VariantArm` type, `data-arm-id` — still says "arm"; the
+  persisted layout field is `variants`), each variant editable with the
+  ordinary section/column/module tools, so server-resolution no longer costs
+  the owner their editing surface. Since kywi-cms#119, the owner doesn't need
+  an agent to hand-author this shape at all: the section chrome — in the
+  admin layout editor and in the in-place front-of-site overlay alike —
+  offers **Personalize this section** / **A/B test** actions that wrap an
+  ordinary section into a section-level variant container on the spot,
+  seeding the default variant from the section's current content and
+  opening straight into its config (audience/experiment picker included).
+  An agent only needs to reach for `update_layout` when scripting bulk
+  changes or building a container the UI can't reach.
 - **Module-level** — the `variantContainer` *module*, placed in a column; its
-  arms are HTML strings (`defaultContent`, `variants: [{audienceId, label,
-  content}]`). Every arm ships in the HTML (default visible, the rest
+  variants are HTML strings (`defaultContent`, `variants: [{audienceId, label,
+  content}]`). Every variant ships in the HTML (default visible, the rest
   `display:none`) and the browser runtime reveals the matching one. Use it
   **only for signals the server cannot read at first paint** — in practice, a
   self-ID answer held in `localStorage`.

package/assets/kywi-personalization-skill.md

@@ -44,16 +44,18 @@ is progressive enhancement; anonymous visitors get the default).
 ### 4b. Experiment path
 
 Admin → Experiments: create the experiment. In the layout, add an A/B
-container with an arm per treatment. Assignment is deterministic per visitor
-(the scaffold's middleware issues a persistent `kywi_visitor` cookie), so a
-visitor sees the same arm on every visit — no client runtime needed.
+container with a variant per treatment (the editor UI and API both call these
+"variants"; the underlying data model calls each one an "arm" — same thing).
+Assignment is deterministic per visitor (the scaffold's middleware issues a
+persistent `kywi_visitor` cookie), so a visitor sees the same variant on every
+visit — no client runtime needed.
 
 ### 5. Verify before calling it done
 
 - **Preview tokens** (Audiences → Preview Tokens): view the page *as each
   audience* and confirm the right variant serves.
 - Experiments: two fresh browser profiles should get (possibly) different
-  arms, and each profile must get the **same** arm on reload.
+  variants, and each profile must get the **same** variant on reload.
 - Confirm exposures are being recorded in the Experiments admin.
 - Load the page as a plain anonymous visitor: the default must be complete.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-kywi-app",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Scaffold a new Kywi CMS project — npx create-kywi-app my-site",
   "type": "module",
   "homepage": "https://github.com/Kywi-Software/kywi-cms#readme",