@wix/agent-skills 1.28.0 → 1.30.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/agent-skills",
-  "version": "1.28.0",
+  "version": "1.30.0",
   "description": "Wix Skills for AI coding agents — versioned npm distribution of the wix/skills content.",
   "license": "MIT",
   "repository": {
@@ -12,7 +12,7 @@
     "url": "https://github.com/wix/skills/issues"
   },
   "scripts": {
-    "version": "node .github/scripts/sync-plugin-versions.mjs && git add .claude-plugin/plugin.json .codex-plugin/plugin.json .cursor-plugin/plugin.json plugin.json gemini-extension.json"
+    "version": "node .github/scripts/sync-plugin-versions.mjs && git add .claude-plugin/plugin.json .codex-plugin/plugin.json .cursor-plugin/plugin.json plugin.json gemini-extension.json skills/wix-headless-kit/install/pins.json"
   },
   "files": [
     "skills/**",

package/skills/wix-app/references/editor-react-component/PARTS.md

@@ -51,7 +51,7 @@ CSS driven by a data attribute, or disable it when it should remain visible.
 After generating the manifest, confirm that its `elements` include every
 intended named part.
 
-## Sanity Check
+## Plausibility Check
 
 For each candidate, ask:
 

package/skills/wix-app/references/service-plugin/DISCOUNT-TRIGGERS.md

@@ -76,7 +76,7 @@ customTriggers.provideHandlers({
 1. **Trigger IDs must match** - The `customTriggerId` in `getEligibleTriggers` must match an `_id` from `listTriggers`
 2. **Both handlers required** - You must implement both `getEligibleTriggers` and `listTriggers`
 3. **Dynamic eligibility** - `getEligibleTriggers` is called during checkout to determine which triggers are currently active
-4. **Static list** - `listTriggers` provides the master list of all possible triggers for configuration in the Wix dashboard
+4. **Static list** - `listTriggers` provides the full list of all possible triggers for configuration in the Wix dashboard
 5. **Manual step required, every time** — this plugin only supplies *eligibility*. It has no visible effect until the merchant creates an Automatic Discount that uses your trigger. Tell the user this step is required; don't imply the discount is live just because the plugin is installed. Confirmed live, click-by-click in the dashboard:
    1. Go to **Catalog** (left sidebar) → **Discounts** → **Automatic Discounts**.
    2. Click **Create Discount**.

package/skills/wix-headless/references/astro.md

@@ -81,7 +81,7 @@ The **per-vertical values** — which `WIX_APPS.*PageMetadata` accessor + `seoTa
 
 ## 7 — Caveats (the gaps the docs don't mention)
 
-The heart of the file: tribal knowledge the docs won't surface. These are **guidance the model must follow when it writes the frontend** — not things this skill writes for it.
+The heart of the file: hard-won knowledge the docs won't surface. These are **guidance the model must follow when it writes the frontend** — not things this skill writes for it.
 
 | Caveat | What it says |
 |---|---|

package/skills/wix-headless-kit/SKILL.md

@@ -23,11 +23,13 @@ doesn't express — or once the site exists and the work turns to managing or ex
 
 - **Shipped code is the implementation.** Every vertical ships in the repository's
   `wix-headless-templates` skill (`skills/wix-headless-templates/<vertical>/`), not in this skill's
-  folder: `node <SKILL_ROOT>/install/templates.mjs`
-  fetches all of it once into `<SKILL_ROOT>/templates/` (a second) and prints the path; every
-  script below fetches it itself when the folder is missing. The folder stays with the project
-  (only the composed `project/` scaffolds are left out of its repository), so a later session
-  reads the version the project was built from. Each vertical holds:
+  folder. `node <SKILL_ROOT>/install/templates.mjs` prints where that skill is: the sibling folder
+  `<SKILL_ROOT>/../wix-headless-templates/` when the install carried both skills (the cold start
+  does), else a one-time fetch into `<SKILL_ROOT>/templates/` (a second); every script below
+  resolves it the same way. **Every `templates/...` path in this document is relative to that
+  printed root** — there is no `templates/` folder inside this skill when the sibling exists.
+  The folder stays with the project (only the composed `project/` scaffolds are left out of its
+  repository), so a later session reads the version the project was built from. Each vertical holds:
   - `app/` — the framework-agnostic core (TypeScript): a data layer that returns **plain,
     serializable DTOs** (images resolved to https URLs, prices pre-formatted), React hooks, and
     routing-free headless components. Works in Astro islands, Vite SPAs, and Next.

package/skills/wix-headless-kit/install/pins.json

@@ -1,8 +1,8 @@
 {
-  "@wix/cli": "1.1.257",
-  "@wix/create-new": "0.0.123",
+  "@wix/cli": "1.1.258",
+  "@wix/create-new": "0.0.124",
   "typescript": "5.8.3",
   "templates": {
-    "ref": "v1.28.0"
+    "ref": "v1.30.0"
   }
 }

package/skills/wix-headless-templates/restaurants/app/wix/restaurants/types.ts

@@ -21,7 +21,7 @@ export interface MenuItemLabel {
   iconUrl: string;
 }
 
-/** One price variant of an item ("Glass" / "Bottle"). An item has price OR variants. */
+/** One price variant of an item ("Small" / "Large"). An item has price OR variants. */
 export interface MenuItemVariant {
   variantId: string;
   name: string;

package/skills/wix-headless-templates/restaurants/project/src/wix/restaurants/types.ts

@@ -21,7 +21,7 @@ export interface MenuItemLabel {
   iconUrl: string;
 }
 
-/** One price variant of an item ("Glass" / "Bottle"). An item has price OR variants. */
+/** One price variant of an item ("Small" / "Large"). An item has price OR variants. */
 export interface MenuItemVariant {
   variantId: string;
   name: string;

package/skills/wix-headless-templates/restaurants/seed/SEED.md

@@ -45,9 +45,9 @@ size, or a `modifierGroups` entry) when the restaurant takes orders, so the dish
         { "name": "Branzino", "description": "Whole roasted sea bass, lemon, herbs.",
           "price": 28, "imageUrl": "https://…" }
       ] },
-      { "name": "Vino", "items": [
-        { "name": "Chianti Classico", "description": "Sangiovese, Tuscany.",
-          "variants": [{ "name": "Glass", "price": 11 }, { "name": "Bottle", "price": 44 }], "imageUrl": "https://…" }
+      { "name": "Pizze", "items": [
+        { "name": "Margherita", "description": "San Marzano tomato, fior di latte, basil.",
+          "variants": [{ "name": "Small", "price": 14 }, { "name": "Large", "price": 22 }], "imageUrl": "https://…" }
       ] },
       { "name": "Dolci", "items": [
         { "name": "Tiramisù", "description": "Espresso-soaked ladyfingers, mascarpone.",
@@ -65,7 +65,7 @@ size, or a `modifierGroups` entry) when the restaurant takes orders, so the dish
 ```
 
 - `price` — a number; stored as a decimal string in the **site currency** (never send one per item).
-  An item has `price` OR `variants` (each `{ name, price }` — "Glass" / "Bottle"), never both; an
+  An item has `price` OR `variants` (each `{ name, price }` — "Small" / "Large"), never both; an
   item with neither renders as "Market price" and can't be ordered online.
 - `modifierGroups` — per item: `{ name, required?, min?, max?, modifiers: [{ name, price?, preSelected?, inStock? }] }`.
   `required: true, min: 1, max: 1` is a single choice (radios); `max` alone is "choose up to";

package/skills/wix-headless-templates/restaurants/seed/seed-restaurants.mjs

@@ -166,7 +166,7 @@ export async function createModifierGroups(ctx, groups) {
 }
 
 /**
- * Bulk-create price variants (the reusable "Glass" / "Bottle" names; the price per item lives on
+ * Bulk-create price variants (the reusable "Small" / "Large" names; the price per item lives on
  * the item's priceVariants reference). Returns ids in input order.
  * docs: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/menus/items/item-variants/bulk-create-variants.md
  */

package/skills/wix-headless-templates/shared/capabilities/site-search/seed/install.mjs

@@ -29,9 +29,9 @@ if (!siteId) {
   console.log(JSON.stringify({ error: "no site: pass --site <siteId> or run in a folder with wix.config.json" }));
   process.exit(1);
 }
-const token = execFileSync("npx", ["-y", "@wix/cli@1.1.257", "token", "--site", siteId], { encoding: "utf8" }).trim();
+const token = execFileSync("npx", ["-y", "@wix/cli@1.1.258", "token", "--site", siteId], { encoding: "utf8" }).trim();
 if (!token) {
-  console.log(JSON.stringify({ error: "the Wix CLI returned no token — run `npx @wix/cli@1.1.257 login` first" }));
+  console.log(JSON.stringify({ error: "the Wix CLI returned no token — run `npx @wix/cli@1.1.258 login` first" }));
   process.exit(1);
 }
 try {

package/skills/wix-headless-templates/shared/seed/wix-cli.mjs

@@ -8,7 +8,7 @@ import { delimiter, join } from "node:path";
 import { execFileSync, spawnSync } from "node:child_process";
 
 // The CLI version the fallback installs; equal to `@wix/cli` in wix-headless-kit/install/pins.json.
-const WIX_CLI_VERSION = "1.1.257";
+const WIX_CLI_VERSION = "1.1.258";
 
 export function resolveWixCli(cwd = process.cwd()) {
   const bin = process.platform === "win32" ? "wix.cmd" : "wix";

package/skills/wix-manage/references/bookings/diagnose-availability-issues.md

@@ -64,7 +64,7 @@ Interpret the result:
 
 > **The hidden-service trap.** A service that's **hidden** from the site, or has **online booking turned off**, can still list slots here — so bookable slots do **not** prove customers can book it. When the complaint is "customers can't book / can't find this service" (as opposed to "the calendar is empty"), **run [Step 2](#step-2--rule-out-service-level-blockers-visibility--online-booking) before trusting the slot count** — it's the single most common cause and neither `ListAvailabilityTimeSlots` nor `DiagnoseAvailability` detects it.
 
-If **no slots come back at all**, also sanity-check the inputs before concluding "no availability": the queried window isn't entirely in the past, and any `locations` filter is actually offered by the service.
+If **no slots come back at all**, also double-check the inputs before concluding "no availability": the queried window isn't entirely in the past, and any `locations` filter is actually offered by the service.
 
 ---
 

package/skills/wix-manage/references/ecommerce/ecom-shipping.md

@@ -39,7 +39,7 @@ Set up and tune how a store ships — what rates to charge, which regions are co
 
 ### Troubleshoot
 
-> - [Shipping rate incorrect (customer charged wrong shipping)](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-optimize-rates) — tags: `[intent:rate-incorrect]` · priority 0 · *audit rates via the Rate Pricing Sanity guardrail, then correct the rate structure*
+> - [Shipping rate incorrect (customer charged wrong shipping)](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-optimize-rates) — tags: `[intent:rate-incorrect]` · priority 0 · *audit rates via the Rate Pricing Plausibility guardrail, then correct the rate structure*
 
 ## Tag matching
 
@@ -53,7 +53,7 @@ The agent matches the merchant's natural-language query to an `intent:*` tag (cu
 | "How much should I charge for shipping?" | any | `ecom-shipping-setup-rates` via `[intent:setup-rates]` |
 | "I want customers to pick up from my shop" | any | `ecom-shipping-setup-pickup` via `[intent:setup-pickup]` |
 | "Some regions have no shipping option" | any | `ecom-shipping-fix-coverage` via `[intent:fix-coverage]` |
-| "A customer was charged the wrong shipping" | any | `ecom-shipping-optimize-rates` via `[intent:rate-incorrect]` (runs rate-sanity guardrail first) |
+| "A customer was charged the wrong shipping" | any | `ecom-shipping-optimize-rates` via `[intent:rate-incorrect]` (runs rate-plausibility guardrail first) |
 
 ## Base recipe (fallback)
 

package/skills/wix-manage/references/ecommerce/pricing-promotions/ecom-pricing-create-coupon.md

@@ -68,7 +68,7 @@ Check for: duplicate codes, overlapping scopes with active coupons, and cross-me
 
 - **Duplicate / conflicting code** — reject a code already in use.
 - **Cross-mechanism stacking** — coupons stack with automatic discount rules at checkout. Query active discount rules on overlapping scope; if found, warn with the combined effective discount ("a 20% coupon during a 20% automatic sale = ~36% off"). Only one coupon applies per checkout, but automatic rules are unlimited.
-- **% sanity** — > 50% warn (show a $100 → $(100−pct) example); = 100% block unless confirmed; > 100% always block.
+- **% plausibility** — > 50% warn (show a $100 → $(100−pct) example); = 100% block unless confirmed; > 100% always block.
 - **Margin** — if cost data is available, ensure the discount doesn't push price below cost; otherwise warn for > 40%.
 - **User override** — explicit merchant values override these caps; document the override in your reasoning.
 

package/skills/wix-manage/references/ecommerce/pricing-promotions/ecom-pricing-create-discount-rule.md

@@ -129,10 +129,10 @@ These checks guard every discount creation (rule **or** coupon). Run them before
 - **Time overlap** — overlapping `activeTimeInfo` on the same scope (`existingStart < newEnd AND existingEnd > newStart`) → warn about the overlap window.
 - **Cross-mechanism (automatic + coupon)** — automatic discounts and coupons both apply at checkout. If creating a rule, query active coupons on overlapping scope (and vice-versa); warn with the combined effective discount. (Only one coupon per checkout, but automatic rules are unlimited.)
 
-**Margin / sanity:**
+**Margin / plausibility:**
 - **Global cap** — default max discount **25%**; flag anything higher (proceed only on explicit request).
 - **Minimum margin** — default floor **15%**; if cost data is available, `effective_margin = (price − cost − discount_amount) / price × 100` must stay ≥ 15% (block + explain otherwise).
-- **% sanity** — > 50% warn (show a $100 → $(100−pct) example); = 100% block unless confirmed ("makes the product free"); > 100% always block.
+- **% plausibility** — > 50% warn (show a $100 → $(100−pct) example); = 100% block unless confirmed ("makes the product free"); > 100% always block.
 - **Stacking margin** — when a new discount overlaps existing active ones, evaluate the *combined* discount against the cap and margin floor, not just the new one in isolation.
 
 | Scenario | Action |

package/skills/wix-manage/references/ecommerce/pricing-promotions/ecom-pricing-flow-bundle-and-save.md

@@ -4,7 +4,7 @@ description: "BUNDLE_AND_SAVE sub-flow — load [Goal: Drive Cross-Sells] FIRST
 ---
 # Flow: Bundle & Save Campaign
 
-> **Before executing this skill**, read [Create Discount Rule](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/pricing-create-discount-rule) with `ReadFullDocsArticle` — it contains the discount-rule mechanics **and** the pre-create guardrails (conflict/stacking, margin floor, %-sanity).
+> **Before executing this skill**, read [Create Discount Rule](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/pricing-create-discount-rule) with `ReadFullDocsArticle` — it contains the discount-rule mechanics **and** the pre-create guardrails (conflict/stacking, margin floor, %-plausibility).
 
 Creates a discount that rewards customers for purchasing multiple items, encouraging product discovery and cross-selling. The discount activates when the cart contains a minimum number of items, and targets categories or products where bundling makes strategic sense.
 

package/skills/wix-manage/references/ecommerce/pricing-promotions/ecom-pricing-flow-seasonal-promotion.md

@@ -8,7 +8,7 @@ description: "SEASONAL sub-flow — load [Goal: Seasonal Revenue] FIRST (it owns
 >
 > This flow is a sub-step, not a direct entry point. If you have not yet called `ReadFullDocsArticle` on [Goal: Seasonal Revenue](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/goal-seasonal-revenue) in this conversation, **stop and load it now**. The goal skill owns the SEASONAL classification rule, the time-window presentation requirement, and the priority rule that gates access to this flow.
 >
-> **Before executing this flow**, also read [Create Discount Rule](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/pricing-create-discount-rule) with `ReadFullDocsArticle` — it contains the discount-rule mechanics **and** the pre-create guardrails (conflict/stacking, margin floor, %-sanity).
+> **Before executing this flow**, also read [Create Discount Rule](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/pricing-create-discount-rule) with `ReadFullDocsArticle` — it contains the discount-rule mechanics **and** the pre-create guardrails (conflict/stacking, margin floor, %-plausibility).
 
 Creates event-driven promotional discounts tied to holidays, shopping events, or seasonal milestones. The flow identifies upcoming events based on the site's country and current date, calculates optimal campaign start/end windows, and targets event-relevant product categories with appropriately sized discounts.
 

package/skills/wix-manage/references/ecommerce/pricing-promotions/ecom-pricing-flow-stock-mover.md

@@ -6,7 +6,7 @@ description: "Stock-mover clearance sub-flow — load [Goal: Clear Inventory] FI
 
 > **Routing rule (READ FIRST).** This recipe is a sub-step of [Goal: Clear Inventory](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/goal-clear-inventory). If you arrived here directly from the WixREADME index, load the goal recipe NOW before executing — it owns the velocity scoring, classification cues, and the per-recommendation presentation rules (including the **margin-floor guardrail** surfacing requirement).
 >
-> **Then** read [Create Discount Rule](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/pricing-create-discount-rule) with `ReadFullDocsArticle` — it contains the discount-rule mechanics **and** the pre-create guardrails (conflict/stacking, margin floor, %-sanity).
+> **Then** read [Create Discount Rule](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/pricing-create-discount-rule) with `ReadFullDocsArticle` — it contains the discount-rule mechanics **and** the pre-create guardrails (conflict/stacking, margin floor, %-plausibility).
 
 Creates a discount targeting slow-moving inventory — products with high stock levels and low sales velocity. The discount depth is proportional to how overstocked the product is, with deeper discounts for the most stagnant items. Margin protection guardrails are especially important here since clearance discounts tend to push closer to cost.
 
@@ -99,7 +99,7 @@ If scope is CATEGORY, call `getCategoryIds` to convert category names to GUIDs.
 
 ## Step 6: Run guardrail checks
 
-**Run the pre-create guardrails in [Create Discount Rule](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/pricing-create-discount-rule) → "Guardrails" before creating the rule** (conflict/stacking, %-sanity, margin floor). Clearance is the **most margin-sensitive** case: discounts push closest to cost, so the margin-floor check (effective margin ≥ 15% unless the merchant overrides) is the one most likely to fire here — verify it per candidate product.
+**Run the pre-create guardrails in [Create Discount Rule](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/pricing-create-discount-rule) → "Guardrails" before creating the rule** (conflict/stacking, %-plausibility, margin floor). Clearance is the **most margin-sensitive** case: discounts push closest to cost, so the margin-floor check (effective margin ≥ 15% unless the merchant overrides) is the one most likely to fire here — verify it per candidate product.
 
 ---
 

package/skills/wix-manage/references/ecommerce/pricing-promotions/ecom-pricing-flow-upsell-boost.md

@@ -4,7 +4,7 @@ description: "UPSELL_BOOST sub-flow — load [Goal: Increase AOV] FIRST (it owns
 ---
 # Flow: Upsell Boost Campaign
 
-> **Before executing this skill**, read [Create Discount Rule](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/pricing-create-discount-rule) with `ReadFullDocsArticle` — it contains the discount-rule mechanics **and** the pre-create guardrails (conflict/stacking, margin floor, %-sanity).
+> **Before executing this skill**, read [Create Discount Rule](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/pricing-create-discount-rule) with `ReadFullDocsArticle` — it contains the discount-rule mechanics **and** the pre-create guardrails (conflict/stacking, margin floor, %-plausibility).
 
 Creates a discount that incentivizes customers to spend more per order by setting a minimum subtotal threshold above the store's current AOV. The discount percentage is scaled to the store's average profit margin, and the scope targets high-margin categories or products.
 
@@ -29,7 +29,7 @@ Catalog analytics and product data are already in conversation context — do NO
 - `siteData.aov` — site-level AOV (revenue / ordersCount). Loaded by eCommerce Load Context.
 
 Extract from context:
-- `effective_aov` — use `siteData.aov`; run AOV sanity check: if AOV < price_p25, override with price_p50 as effective AOV
+- `effective_aov` — use `siteData.aov`; run AOV plausibility check: if AOV < price_p25, override with price_p50 as effective AOV
 - `avg_profit_margin` — from the "All Products" group in `siteData.catalogAnalytics`
 - `price_p50`, `price_p75`, `price_p90` — from quantiles in `siteData.catalogAnalytics`
 - Top products by price and order volume — from `siteData.productCatalogData`
@@ -90,7 +90,7 @@ Max 3 categoryIds per discount rule.
 
 ## Step 6: Run guardrail checks
 
-**Run the pre-create guardrails in [Create Discount Rule](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/pricing-create-discount-rule) → "Guardrails" before creating the rule** — conflict/stacking (scope, time, coupon cross-stacking), the 25% cap, the 15% margin floor, and %-sanity. Present any warnings to the merchant and get confirmation before proceeding.
+**Run the pre-create guardrails in [Create Discount Rule](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/pricing-create-discount-rule) → "Guardrails" before creating the rule** — conflict/stacking (scope, time, coupon cross-stacking), the 25% cap, the 15% margin floor, and %-plausibility. Present any warnings to the merchant and get confirmation before proceeding.
 
 ---
 

package/skills/wix-manage/references/ecommerce/shipping/ecom-shipping-free-shipping.md

@@ -8,7 +8,7 @@ description: Creates a free shipping option with an AOV-calibrated threshold to
 
 > **Before executing this skill**, read [Setup: Shipping Rates](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-set-up-rates) with `ReadFullDocsArticle` for the rate-object mechanics.
 
-## Rate pricing sanity (inline guardrail)
+## Rate pricing plausibility (inline guardrail)
 
 Validate every rate you create or update against the store's AOV; flag any that fail:
 
@@ -101,7 +101,7 @@ If the threshold needs adjustment, update the shipping option via PATCH (see Ste
 
 ---
 
-## Step 3: Run AOV sanity check
+## Step 3: Run AOV plausibility check
 
 Before calculating a threshold, validate that AOV is reliable by comparing it against catalog price distribution.
 
@@ -263,7 +263,7 @@ Report to the merchant:
 | `deliveryRegionId is not a valid GUID` | Used `deliveryRegionIds` (plural) instead of `deliveryRegionId` (singular) | Use the singular `deliveryRegionId` field |
 | `SHIPPING_OPTION_NOT_FOUND` | Option ID doesn't exist when trying to update | Re-query shipping options to get current IDs |
 | `REVISION_MISMATCH` | Revision doesn't match the current version when updating | Re-fetch the option for the latest revision, then retry |
-| Threshold seems unreasonable | AOV data is unreliable (too few orders, data anomaly) | Run the AOV sanity check (Step 3) and use `effective_aov` instead of raw AOV |
+| Threshold seems unreasonable | AOV data is unreliable (too few orders, data anomaly) | Run the AOV plausibility check (Step 3) and use `effective_aov` instead of raw AOV |
 | Free shipping not visible at checkout | Region linked to the option has `active=false` | Check region active status and activate if intended |
 
 ## References

package/skills/wix-manage/references/ecommerce/shipping/ecom-shipping-optimize-rates.md

@@ -6,7 +6,7 @@ description: Analyzes catalog price distribution and current rate structure to r
 
 > **Routing rule:** BEFORE taking any action, call `ReadFullDocsArticle` on [Shipping API Reference](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills/shipping-api-reference). The Query Shipping Options and Update/Create Shipping Option endpoints used in Steps 2–4 live there. Do NOT query or modify any shipping options without loading it first.
 
-## Rate pricing sanity (inline guardrail)
+## Rate pricing plausibility (inline guardrail)
 
 Validate every rate you create or update against the store's AOV; flag any that fail:
 

package/skills/wix-manage/references/ecommerce/shipping/ecom-shipping-setup-rates.md

@@ -1,10 +1,10 @@
 ---
 name: "Shipping: Set Up Rates"
-description: Configures shipping option rates — rate types (flat, tiered, free), condition types and operators, free shipping threshold calibration, AOV sanity check, per-item penalty avoidance, and tier gap detection.
+description: Configures shipping option rates — rate types (flat, tiered, free), condition types and operators, free shipping threshold calibration, AOV plausibility check, per-item penalty avoidance, and tier gap detection.
 ---
 # Shipping Rates
 
-## AOV Sanity Check
+## AOV Plausibility Check
 
 **MANDATORY before any threshold calculation that references AOV.** Raw AOV can be misleading due to data issues or bulk purchases.
 
@@ -80,6 +80,6 @@ When ALL of the following are true, flat rate is optimal and no change is needed
 
 Sort all conditions by value and look for gaps between ranges. Gaps mean some cart totals have no matching rate, which can cause checkout failures.
 
-## Shipping Cost Sanity Check
+## Shipping Cost Plausibility Check
 
 Any rate `amount > AOV x 0.15` (15% of average order value) should be flagged as a cart abandonment risk.

package/skills/wix-replatform/resources/rp-target-wix/lib/wix-writers.js

@@ -1624,7 +1624,7 @@ function normalizeV5Contact(contact = {}) {
   return normalized;
 }
 // Legacy V4-style `info` payloads (pre-GA generated transforms) convert through this
-// STRICT whitelist: unknown keys throw instead of silently dropping source data.
+// STRICT allowlist: unknown keys throw instead of silently dropping source data.
 // `extendedFields` and `labelKeys` throw because they have no mechanical V5 equivalent —
 // V5 custom fields live under extendedFields.namespaces (Data Extension Schema) and
 // labels became tags (Tags API); both need a setup-time decision, not a converter guess.

package/skills/wix-vibe-headless/references/restaurants/seed/seed-restaurants.cjs

@@ -326,7 +326,7 @@ async function enableOnlineReservations(ctx, reservationLocationId, revision) {
 }
 
 // ══ EXPERIENCES (setup-restaurant-experiences.md) ══════════════════════════════════════════════════
-// An experience is a reservation that IS a curated dining occasion (wine tasting, chef's table). Feature
+// An experience is a reservation that IS a curated dining occasion (chef's table, tasting menu). Feature
 // of the Table Reservations app — no separate install. Created against a reservationLocationId (from
 // listReservationLocations). The full create payload lives in the live docs (fields evolve) — build each
 // `experience` from the Create-Experience doc; this only wires the loop. Set configuration.visible:true.