@wix/agent-skills 1.35.1 → 1.36.1

package/skills/wix-replatform/resources/rp-target-wix/domains/ecom/docs-survey.json

@@ -1,306 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "ecom",
-  "fetchedAt": "2026-08-11",
-  "roots": [
-    "api-reference/business-solutions/e-commerce"
-  ],
-  "surfaces": [
-    {
-      "id": "api-reference/business-solutions/e-commerce/catalogs/catalog-service-plugin",
-      "title": "Catalog Service Plugin",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/catalogs/catalog-service-plugin",
-      "group": "Catalogs",
-      "verdict": "not-relevant",
-      "reason": "Service plugin (SPI), and here the 'not relevant' verdict is genuinely right for a reason worth stating: a catalog provider plugin makes an EXTERNAL catalog sellable on Wix, which is the OPPOSITE of migrating -- it keeps the data at the source. Never a migration path. See domains/SERVICE-PLUGINS.md for the escalation rule, the cost list, a worked example and the full 25-plugin catalog.",
-      "reviewedOn": "2026-08-31"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/catalogs/inventory-service-plugin",
-      "title": "Inventory Service Plugin",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/catalogs/inventory-service-plugin",
-      "group": "Catalogs",
-      "verdict": "not-relevant",
-      "reason": "Service plugin (SPI). Same shape as the catalog provider: it delegates stock to an external system rather than moving it in. Never a migration path. See domains/SERVICE-PLUGINS.md for the escalation rule, the cost list, a worked example and the full 25-plugin catalog.",
-      "reviewedOn": "2026-08-31"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/extensions/additional-fees",
-      "title": "Additional Fees",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/additional-fees",
-      "group": "Extensions",
-      "verdict": "not-relevant",
-      "reason": "Service plugin (SPI) -- not an import path, but a CANDIDATE GAP-CLOSER for source surcharges (handling, packaging, cash-on-delivery) that have no Wix field to land in. Not yet attempted. See domains/SERVICE-PLUGINS.md for the escalation rule, the cost list, a worked example and the full 25-plugin catalog.",
-      "reviewedOn": "2026-08-31"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/extensions/discounts",
-      "title": "Discounts",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/discounts",
-      "group": "Extensions",
-      "verdict": "not-relevant",
-      "reason": "Service plugin (SPI), so not an import path -- BUT NOT IRRELEVANT, and this entry was previously wrong to imply otherwise. The Custom Discount Triggers plugin CLOSED A MAPPING GAP: a WooCommerce bulk/tiered discount needs mutually exclusive quantity BANDS, Wix's native bounded ITEM_QUANTITY_RANGE leaves the rule unrenderable in the merchant dashboard, and open-ended ranges stack (21 items matched all five tiers -> 75% off instead of 25%). A custom trigger answers yes/no per cart, so the band is exact. Implemented and deployed; see the bounded-quantity-bands-need-a-custom-trigger-spi pitfall on entities/discount-rule.json. See domains/SERVICE-PLUGINS.md for the escalation rule, the cost list, a worked example and the full 25-plugin catalog.",
-      "reviewedOn": "2026-08-31"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/extensions/shipping-rates",
-      "title": "Shipping Rates",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/shipping-rates",
-      "group": "Extensions",
-      "verdict": "not-relevant",
-      "reason": "Service plugin (SPI) -- not an import path, but a CANDIDATE GAP-CLOSER rather than noise. This is the natural home for a source shipping rate table Wix's own shipping options cannot express; a free-shipping-over-threshold condition and per-shipping-class costs are both known to fail natively. Not yet attempted. See domains/SERVICE-PLUGINS.md for the escalation rule, the cost list, a worked example and the full 25-plugin catalog.",
-      "reviewedOn": "2026-08-31"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/extensions/tax",
-      "title": "Tax",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax",
-      "group": "Extensions",
-      "verdict": "not-relevant",
-      "reason": "Service plugin (SPI) -- not an import path. Tax calculation could close a gap only if the source's tax logic genuinely exceeds Wix tax groups; not yet exercised. See domains/SERVICE-PLUGINS.md for the escalation rule, the cost list, a worked example and the full 25-plugin catalog.",
-      "reviewedOn": "2026-08-31"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/extensions/validations",
-      "title": "Validations",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/validations",
-      "group": "Extensions",
-      "verdict": "not-relevant",
-      "reason": "Service plugin (SPI) -- not an import path, but a CANDIDATE GAP-CLOSER for source purchase restrictions (members-only items, min/max quantity, region blocks) with no native Wix equivalent. Not yet attempted. See domains/SERVICE-PLUGINS.md for the escalation rule, the cost list, a worked example and the full 25-plugin catalog.",
-      "reviewedOn": "2026-08-31"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/get-started/apps",
-      "title": "Apps",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/get-started/apps",
-      "group": "Get Started",
-      "verdict": "not-relevant",
-      "reason": "Documentation article, not an API surface.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/get-started/headless",
-      "title": "Headless",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/get-started/headless",
-      "group": "Get Started",
-      "verdict": "not-relevant",
-      "reason": "Documentation article, not an API surface.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/get-started/sites",
-      "title": "Sites",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/get-started/sites",
-      "group": "Get Started",
-      "verdict": "not-relevant",
-      "reason": "Documentation article, not an API surface.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/guides",
-      "title": "Guides",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/guides",
-      "group": null,
-      "verdict": "not-relevant",
-      "reason": "Documentation articles, not an API surface.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/orders/draft-orders",
-      "title": "Draft Orders",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/draft-orders",
-      "group": "Orders",
-      "verdict": "not-relevant",
-      "reason": "Merchant draft-order authoring flow; historical orders import through the Orders import endpoint (ecom/order), not as drafts.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/orders/order-billing",
-      "title": "Order Billing",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/order-billing",
-      "group": "Orders",
-      "verdict": "claimed",
-      "refs": [
-        "ecom/order-refund"
-      ],
-      "reason": "Billing details are carried on the imported order payload, but refund records use the separate Refund Payments surface (POST /ecom/v1/order-billing/refund-payments). Live verification established that externalRefund:true is mandatory for historical data.",
-      "reviewedOn": "2026-08-16"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/orders/order-fulfillments",
-      "title": "Order Fulfillments",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/order-fulfillments",
-      "group": "Orders",
-      "verdict": "not-relevant",
-      "reason": "Fulfillment status folds into the imported order payload; standalone fulfillment creation targets live orders. Revisit if imported historical orders prove to need explicit fulfillment records.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/orders/order-invoices",
-      "title": "Order Invoices",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/order-invoices",
-      "group": "Orders",
-      "verdict": "not-relevant",
-      "reason": "Wix-generated invoice documents; source PDF-invoice plugin outputs are documents, not records to recreate.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/orders/order-payment-requests",
-      "title": "Order Payment Requests",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/order-payment-requests",
-      "group": "Orders",
-      "verdict": "not-relevant",
-      "reason": "Live payment-collection flow, not migratable records.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/orders/order-transactions",
-      "title": "Order Transactions",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/order-transactions",
-      "group": "Orders",
-      "verdict": "claimed",
-      "refs": [
-        "ecom/order-refund"
-      ],
-      "reason": "Add Payments is the first half of the refund write path: Import Order creates no payment record, so a payment must be added before Order Billing's Refund Payments has a paymentId to reference. Note this surface alone is payments-only (refunds reach it as the Refund Completed webhook, and balanceSummary.refunded is computed) — the refund create lives in the sibling Order Billing tree, and reading this menu in isolation produced a false 'no refund-record import path' conclusion on 2026-08-12, corrected 2026-08-16.",
-      "reviewedOn": "2026-08-16"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/orders/orders",
-      "title": "Orders",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/orders",
-      "group": "Orders",
-      "verdict": "claimed",
-      "refs": [
-        "ecom/order",
-        "ecom/order-line-item",
-        "ecom/order-refund",
-        "ecom/order-applied-discount",
-        "ecom/order-merchant-note",
-        "ecom/order-line-item-options"
-      ],
-      "reviewedOn": "2026-08-16"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/orders/orders-settings",
-      "title": "Orders Settings",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/orders-settings",
-      "group": "Orders",
-      "verdict": "not-relevant",
-      "reason": "Settings singleton (get/update); configuration, not records.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/other-services/back-in-stock",
-      "title": "Back In Stock",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/other-services/back-in-stock",
-      "group": "Other Services",
-      "verdict": "not-relevant",
-      "reason": "Back-in-stock request collection; no waitlist source capability observed in runs so far. Revisit when a waitlist plugin is profiled.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/other-services/recommendations",
-      "title": "Recommendations",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/other-services/recommendations",
-      "group": "Other Services",
-      "verdict": "not-relevant",
-      "reason": "Algorithmic recommendations; computed, not migratable.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/other-services/tips",
-      "title": "Tips",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/other-services/tips",
-      "group": "Other Services",
-      "verdict": "not-relevant",
-      "reason": "Live checkout tipping flow; no migratable records.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/payments/gift-cards",
-      "title": "Gift Cards",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/payments/gift-cards",
-      "group": "Payments",
-      "verdict": "claimed",
-      "refs": [
-        "gift-cards/gift-card"
-      ],
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/payments/memberships",
-      "title": "Memberships",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/payments/memberships",
-      "group": "Payments",
-      "verdict": "not-relevant",
-      "reason": "Membership/pricing-plan payment surface; pricing-plans territory with no authored domain yet — whole-tree assignment is the deferred register’s job (future work).",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/payments/payment-settings",
-      "title": "Payment Settings",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/payments/payment-settings",
-      "group": "Payments",
-      "verdict": "not-relevant",
-      "reason": "Payment configuration; setup territory, not records.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/purchase-flow/cart",
-      "title": "Cart",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart",
-      "group": "Purchase Flow",
-      "verdict": "not-relevant",
-      "reason": "Ephemeral purchase-flow state; carts are not migratable records.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/purchase-flow/cart-v2",
-      "title": "Cart V2",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2",
-      "group": "Purchase Flow",
-      "verdict": "not-relevant",
-      "reason": "Ephemeral purchase-flow state; carts are not migratable records.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/purchase-flow/checkout",
-      "title": "Checkout",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/checkout",
-      "group": "Purchase Flow",
-      "verdict": "not-relevant",
-      "reason": "Ephemeral purchase-flow state; checkouts are not migratable records.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/purchase-flow/skills",
-      "title": "Skills",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/skills",
-      "group": "Purchase Flow",
-      "verdict": "not-relevant",
-      "reason": "AI-skill documentation page, not a data surface.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles",
-      "title": "Delivery Profiles",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles",
-      "group": "Shipping & Delivery",
-      "verdict": "claimed",
-      "reviewedOn": "2026-08-11",
-      "refs": [
-        "ecom/delivery-profile"
-      ]
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/skills",
-      "title": "Skills",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/skills",
-      "group": null,
-      "verdict": "not-relevant",
-      "reason": "AI-skill documentation page, not a data surface.",
-      "reviewedOn": "2026-08-11"
-    }
-  ]
-}

package/skills/wix-replatform/resources/rp-target-wix/domains/ecom/domain.json

@@ -1,44 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "ecom",
-  "dependsOnRequired": true,
-  "docsRoots": [
-    "api-reference/business-solutions/e-commerce"
-  ],
-  "displayName": "Wix eCommerce",
-  "ownerHint": "eCommerce Orders, refunds, checkout, and order-history domain owners",
-  "wixAppsRequired": [
-    "Wix Stores"
-  ],
-  "defaultImportOrder": [
-    "delivery-profile",
-    "shipping-option",
-    "pickup-location",
-    "discount-rule",
-    "order",
-    "order-line-item",
-    "order-applied-discount",
-    "order-line-item-options",
-    "order-payment",
-    "order-refund",
-    "order-invoice-document",
-    "order-merchant-note"
-  ],
-  "sideEffectNotes": [
-    "Historical order writes are blocked unless setup verification proves side-effect behavior."
-  ],
-  "evidence": [
-    {
-      "type": "domain-kb",
-      "path": "skills/wix-replatform/resources/rp-target-wix/domains/ecom/entities/order.json",
-      "note": "per-field import-suitability rationale and evidence for this domain live on the entity files (delivery-profile, order, order-line-item, order-applied-discount, order-line-item-options, order-payment, order-refund, order-merchant-note)"
-    }
-  ],
-  "sharedPitfalls": [
-    {
-      "code": "a-delivery-region-is-three-writes-not-one",
-      "severity": "blocker",
-      "summary": "Finishing `delivery-profile` does NOT finish shipping, and stopping there is the single most repeated defect in this domain. A working region needs THREE resources, and the import order reflects that: (1) the region and its carriers on the profile; (2) a ShippingOption per paid/free delivery choice -- a carrier's backupRate alone leaves the region non-functional at checkout and still shows Wix's 'missing rates' warning; (3) a PickupLocation for any collection point, plus the Pickup carrier attached with an INACTIVE backup rate. Each of these was live-observed missing on a store while the API read-back looked complete."
-    }
-  ]
-}

package/skills/wix-replatform/resources/rp-target-wix/domains/ecom/entities/delivery-profile.json

@@ -1,171 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "ecom",
-  "entity": "delivery-profile",
-  "displayName": "Delivery Profile",
-  "capability": "commerce.delivery-profiles",
-  "target": {
-    "classification": "setup-config",
-    "nativeEntity": "eCommerce Delivery Profile",
-    "verifiedFqdn": null,
-    "idPolicy": "server-assigned",
-    "crosswalkRequired": true
-  },
-  "dependsOn": [],
-  "sourceAliases": [
-    {
-      "sourceSystem": "woocommerce",
-      "sourceEntity": "shipping-zone",
-      "routes": [
-        "/wc/v3/shipping/zones",
-        "/wc/v3/shipping/zones/{id}/locations",
-        "/wc/v3/shipping/zones/{id}/methods"
-      ],
-      "confidence": "high"
-    },
-    {
-      "sourceSystem": "wix",
-      "sourceEntity": "deliveryProfile",
-      "routes": [
-        "eCommerce Delivery Profiles API"
-      ],
-      "confidence": "high"
-    }
-  ],
-  "preferredWrite": {
-    "surface": "eCommerce Delivery Profiles",
-    "endpoint": "POST /ecom/v1/delivery-profiles/add-delivery-region",
-    "writerId": "addDeliveryRegion",
-    "verification": "verified-live",
-    "importSafe": true,
-    "bulk": false,
-    "releaseStatus": "stable",
-    "decision": "Verified live: add source zones as delivery regions on the existing DEFAULT delivery profile, then attach each zone's methods with addDeliveryCarrier. Each region write is followed by one or more carrier writes using the returned region ID. createDeliveryProfile remains available for projects that deliberately need a separate profile. Read profiles with GET /ecom/v1/delivery-profiles/{id} or POST /ecom/v1/delivery-profiles/query; there is no GET list endpoint."
-  },
-  "reliability": {
-    "status": "partially-reliable",
-    "flags": []
-  },
-  "pitfalls": [
-    {
-      "code": "zone-model-mismatch",
-      "severity": "warning",
-      "summary": "WooCommerce shipping zones (location rules + per-zone methods) and Wix delivery profiles/regions do not map one-to-one; carrier-calculated Woo methods (e.g. a real UPS/FedEx/USPS integration plugin) have no data equivalent and become reconfigure-in-Wix decisions — shipping-build.js's classifyMethod flags these as a gap rather than guessing a rate."
-    },
-    {
-      "code": "config-affects-live-checkout",
-      "severity": "blocker",
-      "summary": "Delivery profiles change what buyers can order the moment they exist; apply at the setup gate with user approval, never silently during a data import. Mitigation verified live 2026-08-16: delivery regions can be created with active:false — the flag is accepted and echoed back — so the structure can be staged and switched on by the owner afterwards."
-    },
-    {
-      "code": "rates-live-on-carriers-not-the-profile",
-      "severity": "warning",
-      "summary": "Confirmed live: the delivery profile object carries no rates; it contains only name, regions, and destinations. Every amount lives on a delivery carrier attached to a region through backupRate/additionalCharges, while carrier-specific rate tables remain dashboard configuration outside this API. Write a source flat-rate cost through addDeliveryCarrier's backupRate, never through profile creation."
-    },
-    {
-      "code": "default-profile-already-exists",
-      "severity": "warning",
-      "summary": "Installing Wix Stores/Bookings/Events/Restaurants auto-creates a default profile (observed: \"General profile\" with Domestic + International regions already bound to Basic Shipping). `default` is read-only, cannot be transferred, and the default profile cannot be deleted — plan Woo zones as regions added to that existing default (the normal path) or as additional profiles, and never assume an empty shipping config."
-    },
-    {
-      "code": "response-field-is-deliveryRegions-not-regions",
-      "severity": "blocker",
-      "summary": "LIVE-VERIFIED: a DeliveryProfile object's regions array is `deliveryRegions` on every response that returns one (query, get, addDeliveryRegion, removeDeliveryRegion, addDeliveryCarrier, removeDeliveryCarrier) -- there is no `.regions` field at all on the raw HTTP response. A caller that reads `.regions` directly off a raw response after a successful addDeliveryRegion gets an empty array/undefined every time, so a follow-up 'find the region I just added by name' lookup silently fails even though the write itself returned 200 and the region really was created. This is exactly the class of defect the coupon/order request-shape bugs were: the write succeeds, the caller's OWN read of the response is wrong. Also confirmed live: removeDeliveryRegion cascades that region's own carriers in the same call -- no separate removeDeliveryCarrier first. ADDENDUM: `wix-writers.js`'s own DeliveryProfile-returning functions (createDeliveryProfile, queryDeliveryProfiles, addDeliveryRegion, etc.) now normalize their return value through `withRegionsAlias`, which mirrors `deliveryRegions` onto a `.regions` property -- so reading `.regions` off THIS LIBRARY's own return values is safe and either name works. The gap this pitfall documents still applies in full to a raw HTTP response read directly (bypassing this library's writers), which never gets that alias."
-    },
-    {
-      "code": "destination-and-subdivision-limits",
-      "severity": "warning",
-      "summary": "Caps: 99 profiles/site, 100 regions/profile, 250 destinations/site, 100 subdivisions/destination. Overlapping destinations inside one profile fail with DESTINATIONS_COLLISION. AT, BE, BS, CH, CI, CZ, DO, GR, NO, PL, RS, SD, SI, SK and SN reject subdivisions entirely (SUBDIVISIONS_UNSUPPORTED_FOR_COUNTRY) — a Woo zone scoped to a state in those countries must widen to the whole country and be ledgered."
-    },
-    {
-      "code": "continent-zones-need-expansion",
-      "severity": "warning",
-      "summary": "A WooCommerce zone location can be continent-scoped (e.g. code EU); Wix's Destination object has no continent concept, only country/subdivision. shipping-build.js expands a continent to its member countries using WooCommerce's own continents.php table (only EU populated so far — VERIFIED against a zone actually using it); an unlisted continent code is a flagged gap, not silently dropped or approximated as global."
-    },
-    {
-      "code": "free-shipping-condition-belongs-on-the-rate-not-on-a-row",
-      "severity": "blocker",
-      "summary": "SUPERSEDES an earlier pitfall that said this condition is unavoidably lost and mapped to 'always free'. It is not lost — ShippingOption.rates carries conditions (see ecom/shipping-option), so a minimum-order threshold migrates as a price band. What IS true is that a delivery carrier's backupRate is unconditional, so the threshold must never be expressed there. shipping-build.js classifies such a method kind:'threshold' — it is NOT a buyer-facing choice and gets no row of its own; it folds onto the paid options in the same zone as an LT/GTE price split. Several thresholds in one zone: the lowest wins, matching the source showing free shipping as soon as any threshold is met. A zone with a threshold and no paid option to fold onto keeps it as a standalone option carrying the GTE condition — never as an unconditional 0. Mapping such a method to 'always free' makes every paid option unreachable and costs the merchant its shipping revenue; it was observed live doing exactly that."
-    },
-    {
-      "code": "coupon-gated-free-shipping-is-not-a-delivery-setting",
-      "severity": "warning",
-      "summary": "A source free_shipping method whose condition is a coupon has NO delivery-config counterpart in Wix: at checkout the buyer sees the normal delivery price and the coupon removes it. shipping-build.js classifies it kind:'coupon-domain' and it produces nothing here — that is the complete, correct answer, not an unmigrated gap. But 'nothing here' is only half of it: a coupon must actually carry the behaviour, and this pipeline never invents one. Resolution order is source (coupons already carrying the free-shipping flag — the coupon pipeline is already moving them), then target (a live read, which also guards re-runs and hand-made coupons), then report. 'Neither exists' means a dead source setting or a coupon discovery missed; it is a merchant decision, never an auto-created discount code. See shipping-build.js's resolveFreeShippingCouponCoverage and stores/coupon."
-    },
-    {
-      "code": "free-shipping-requiring-both-a-minimum-and-a-coupon-is-a-gap",
-      "severity": "warning",
-      "summary": "A source free_shipping method requiring a minimum order AND a coupon has no faithful mapping: a Wix rate condition can carry the amount but has no coupon term, so migrating the threshold alone hands out free shipping the source withholds. Being MORE generous than the source is the same class of defect as being unconditional, so this is reported as a gap for a merchant decision rather than approximated. (The OR variant is different and does migrate: the minimum half becomes the threshold, the coupon half is covered by a free-shipping coupon.)"
-    },
-    {
-      "code": "pickup-needs-an-inactive-carrier-and-never-a-shipping-option",
-      "severity": "blocker",
-      "summary": "A source local_pickup/pickup_location method must NEVER become a ShippingOption -- that renders collection as a 0-priced DELIVERY beside the real paid one, because a ShippingOption has no app/carrier/role field to mark it as collection. It DOES need a Pickup deliveryCarrier, but only with backupRate {amount '0', active FALSE}. Both halves were learned live, in opposite directions: an ACTIVE pickup backupRate produced the same 0-priced delivery row, while removing the Pickup carrier ENTIRELY made the collection point disappear from checkout even though the PickupLocation existed, was active, and was bound to the region. The API read-back and the economics check both passed in that broken state, because they check data and this is a rendering dependency neither can see. Correct shape: inactive Pickup carrier + PickupLocation + no ShippingOption. See ecom/pickup-location. Corollary for this file's missing-rates alert: a zone whose only enabled method is pickup is NOT a checkout dead end, since collection is a real way to receive an order."
-    },
-    {
-      "code": "per-shipping-class-cost-not-applied",
-      "severity": "warning",
-      "summary": "WooCommerce flat_rate can set a different cost per product shipping class (class_cost_*). Wix's deliveryCarrier.additionalCharges apply to every order in the region regardless of product, so mapping a class-specific cost there would overcharge every other class — shipping-build.js only maps the base cost and flags class overrides in notes[], never auto-applies them."
-    },
-    {
-      "code": "postcode-zones-have-no-equivalent",
-      "severity": "warning",
-      "summary": "A WooCommerce zone location can match by postcode/postal pattern; Wix Destination has no postcode-level matching at all (country/subdivision only). Always a flagged gap — reconfigure-in-wix."
-    },
-    {
-      "code": "checkout-blocking-region-with-no-working-carrier",
-      "severity": "blocker",
-      "summary": "A zone whose destinations resolve to a real region but whose methods are ALL either disabled or classify as a gap (carrier-calculated, non-numeric flat_rate cost, unrecognized method_id) -- or has no methods at all -- creates a Wix delivery region with zero working carriers. Wix's own Delivery Locations UI flags this live with 'This region is missing rates. Add them so customers can complete checkout.' -- every buyer matching that region hits a dead end at checkout, not a cosmetic gap. shipping-build.js's planShippingZones detects this (hasWorkingCarrier finding no enabled carrier-kind method against a non-empty destinations[]) and attaches the same verbatim text as plan.alert, so it surfaces at the execution approval gate's 'Present gaps, blockers, and manual actions' step rather than being buried inside a routine per-method notes[] entry."
-    },
-    {
-      "code": "backup-rate-alone-still-shows-the-missing-rates-warning",
-      "severity": "blocker",
-      "summary": "A DeliveryCarrier with a correctly shaped, active backupRate is not sufficient to clear Wix's 'This region is missing rates' warning or make checkout functional. The warning is driven by the separate ShippingOption resource. Live verification showed that each imported region needs both a DeliveryCarrier and a matching ShippingOption built from the same classified method; addDeliveryCarrier alone is an incomplete migration despite a successful write and readback."
-    }
-  ],
-  "mappingGuidance": [
-    "Map each WooCommerce shipping zone to a delivery region on the site's existing default profile (Add Delivery Region), and each zone's methods to delivery carriers on that region (Add Delivery Carrier). Do not create a second delivery profile unless the project genuinely needs per-product-group shipping rules — a fresh site already has exactly one default profile from the Wix Stores install.",
-    "A zone method is NOT automatically a buyer-facing choice. Resolve the zone's methods first (shipping-build.js's resolveZoneMethods) and only then write: kind:'carrier' becomes a delivery carrier plus a shipping option; kind:'threshold' folds onto the paid carriers as a conditional rate and gets no row; kind:'coupon-domain' produces nothing here; kind:'pickup' becomes a PickupLocation; kind:'gap' is reported. Writing one row per source method reproduces the source's own duplicate-choice display defect and multiplies it.",
-    "flat_rate and free_shipping map to a deliveryCarrier using Wix's own 'Basic Shipping' app (shipping-build.js's BASIC_SHIPPING_APP_ID, a fixed cross-site constant) with backupRate.active=true and backupRate.amount set from the resolved cost. local_pickup/pickup_location DO get a carrier, but a constrained one: the Pickup app (appId resolved live with wix-writers.js's resolvePickupAppId, installation-scoped) with backupRate {amount '0', active FALSE} — build it with shipping-build.js's buildPickupCarrierInput, never buildDeliveryCarrierInput. The region needs the Pickup app attached in order to render collection at all; the inactive rate is what stops the carrier itself becoming a 0-priced delivery row. See the pickup pitfall for both halves.",
-    "CRITICAL: also create a ShippingOption (see shipping-option.json, a separate entity) for every kind:'carrier' choice on the region — addDeliveryCarrier's backupRate alone does not clear Wix's checkout coverage gap or its 'missing rates' dashboard warning; see this file's backup-rate-alone-still-shows-the-missing-rates-warning pitfall.",
-    "Verify the economics, never the row count: after writing, assert that nothing is free-and-unconditional while something else on the same region costs money, that no shipping option came from a pickup method, that each carrier's appId matches its role, and that no two options on a region are identical. shipping-build.js's verifyShippingEconomics does this. A store can be left broken in several ways at once while a row-count check reports success.",
-    "Report every resolution as well as every gap. A source defect that is silently cleaned up is indistinguishable from one that was never noticed, and leaves the merchant no way to confirm the intent was read correctly — surface collapsed duplicates, folded thresholds and removed coupon rows in the merchant's own terms at the approval gate.",
-    "Never speculatively create a region for WooCommerce's unused default catch-all zone (id 0, empty locations and methods on a fresh install) — shipping-build.js's planShippingZones skips it, same discipline as the tax domain never creating a group for an unused default tax class.",
-    "Present the zone-to-profile plan (and every flagged gap: carrier-calculated methods, continent zones without a country table yet, lost free-shipping conditions, per-class cost overrides, postcode zones) at the setup approval gate as configuration, separate from data imports."
-  ],
-  "setupRequirements": [
-    "Wix Stores app (eCommerce checkout) — auto-creates the site's one default delivery profile."
-  ],
-  "evidence": [
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/delivery-profile-object",
-      "note": "object page: profile with delivery regions and rates"
-    },
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/create-delivery-profile"
-    },
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/add-delivery-region",
-      "note": "fetched 2026-08-12 while building shipping-build.js/wix-writers.js"
-    },
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/add-delivery-carrier",
-      "note": "fetched 2026-08-12; backupRate.active=true is the mechanism for an unconditional flat/free rate with no real carrier integration"
-    },
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/shipping-delivery/delivery-profiles/list-installed-delivery-carriers",
-      "note": "fetched 2026-08-12; live call against an anonymized verification environment confirmed 'Basic Shipping' (appId 45c44b27-...) and 'Pickup' as installed first-party carriers"
-    },
-    {
-      "type": "live-run",
-      "path": "anonymized-live-verification",
-      "note": "Verified live: create with one inactive US/US-CA region → 200 (profile <anonymized-id>, revision 1); GET read back identically; DELETE → 200 and a follow-up GET → 404 NOT_FOUND; query returned the pre-existing default \"General profile\"; installed carriers listed (Basic Shipping, Pickup, Local delivery, Calculated by USPS); GET /ecom/v1/delivery-profiles (list) → 404, query endpoint required"
-    }
-  ],
-  "notes": "Authored 2026-08-11 from the docs-survey gap (Delivery Profiles). Classified setup-config: shipping configuration applied at the setup gate, not a data import. Full source-to-target pipeline built and live-verified 2026-08-12 — see shipping-build.js, wix-writers.js's Delivery Profiles section, and the wp-route-classifier.js entry for /wc/v3/shipping/zones. A separate KB probe 2026-08-16 independently verified profile create/readback/delete and added the carrier/limit pitfalls; it also corrected an earlier reading that Woo flat/free amounts map to \"profile rates\" — there are no rates on a profile, they belong to the carrier."
-}