@wix/agent-skills 1.35.1 → 1.36.1

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

@@ -1,106 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "tax",
-  "fetchedAt": "2026-08-12",
-  "roots": [
-    "api-reference/business-solutions/e-commerce/extensions/tax"
-  ],
-  "surfaces": [
-    {
-      "id": "api-reference/business-solutions/e-commerce/extensions/tax/contact-tax-details",
-      "title": "Contact Tax Details",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/contact-tax-details",
-      "group": null,
-      "verdict": "not-relevant",
-      "reason": "Per-contact tax-exempt-group association (e.g. reseller/non-profit customer exemption). WooCommerce's current capture (product tax_class/tax_status, wc/v3/taxes, wc/v3/settings/tax) has no per-customer tax exemption signal to map here; an anonymized verification environment's one exemption case is product-level (tax_status=none), handled via manual-tax-mapping.json's tax-group approach instead.",
-      "reviewedOn": "2026-08-12"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/extensions/tax/manual-tax-mappings",
-      "title": "Manual Tax Mappings",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/manual-tax-mappings",
-      "group": null,
-      "verdict": "claimed",
-      "refs": ["tax/manual-tax-mapping"],
-      "reviewedOn": "2026-08-12"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/extensions/tax/tax-calculation",
-      "title": "Tax Calculation",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-calculation",
-      "group": null,
-      "verdict": "not-relevant",
-      "reason": "Calculate Tax / List Tax Calculators are read/runtime APIs (Wix invokes Calculate Tax itself during checkout) with nothing to import. Used here as a live verification aid only: List Tax Calculators resolves the manual-calculator appId a Tax Region needs (see resolveManualTaxCalculatorAppId in wix-writers.js), and Calculate Tax was used to live-confirm the unmapped-tax-group-calculates-to-exactly-zero-tax finding recorded in domain.json sharedPitfalls.",
-      "reviewedOn": "2026-08-12"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/extensions/tax/tax-calculation-integration-service-plugin",
-      "title": "Tax Calculation Integration Service Plugin",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-calculation-integration-service-plugin",
-      "group": null,
-      "verdict": "not-relevant",
-      "reason": "Service plugin (SPI) -- not an import path. Could close a gap only if source tax logic exceeds Wix tax groups. 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/tax-exempt-groups",
-      "title": "Tax Exempt Groups",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-exempt-groups",
-      "group": null,
-      "verdict": "not-relevant",
-      "reason": "Reusable customer-exemption-group catalog (resellers, non-profits, etc.), read via a buyer's Contact Tax Details association. No such source concept exists in the current WooCommerce capture; an anonymized verification environment's one exemption is product-level, not customer-level. Revisit if a future source exposes customer/role-based tax exemption.",
-      "reviewedOn": "2026-08-12"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/extensions/tax/tax-exempt-groups-integration-service-plugin",
-      "title": "Tax Exempt Groups Integration Service Plugin",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-exempt-groups-integration-service-plugin",
-      "group": null,
-      "verdict": "not-relevant",
-      "reason": "Service plugin (SPI) -- provider integration, not 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/tax/tax-groups",
-      "title": "Tax Groups",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-groups",
-      "group": null,
-      "verdict": "claimed",
-      "refs": [
-        "tax/tax-group"
-      ],
-      "reviewedOn": "2026-08-12"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/extensions/tax/tax-groups-integration-service-plugin",
-      "title": "Tax Groups Integration Service Plugin",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-groups-integration-service-plugin",
-      "group": null,
-      "verdict": "not-relevant",
-      "reason": "Service plugin (SPI) -- provider integration, not 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/tax/tax-regions",
-      "title": "Tax Regions",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-regions",
-      "group": null,
-      "verdict": "claimed",
-      "refs": [
-        "tax/tax-region"
-      ],
-      "reviewedOn": "2026-08-12"
-    },
-    {
-      "id": "api-reference/business-solutions/e-commerce/extensions/tax/tax-settings",
-      "title": "Tax Settings",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-settings",
-      "group": null,
-      "verdict": "claimed",
-      "refs": [
-        "tax/tax-settings"
-      ],
-      "reviewedOn": "2026-08-12"
-    }
-  ]
-}

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

@@ -1,64 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "tax",
-  "dependsOnRequired": true,
-  "displayName": "Wix Tax",
-  "ownerHint": "eCommerce tax domain owners (Tax Groups / Tax Regions / Manual Tax Mappings)",
-  "wixAppsRequired": ["Wix Stores"],
-  "docsRoots": [
-    "api-reference/business-solutions/e-commerce/extensions/tax"
-  ],
-  "defaultImportOrder": [
-    "tax-settings",
-    "tax-group",
-    "tax-region",
-    "manual-tax-mapping"
-  ],
-  "sharedPitfalls": [
-    {
-      "code": "tax-apis-live-under-billing-v1-not-ecom-v1",
-      "severity": "warning",
-      "summary": "Tax Groups, Tax Regions, and Manual Tax Mappings all live under `/billing/v1/...` — not `/ecom/v1/...` like Discount Rules, and not `/stores/v2/...` like Coupons. Guessing the ecom prefix by analogy with sibling commerce-extension entities is the most likely first-try mistake."
-    },
-    {
-      "code": "tax-group-has-no-rate-rate-lives-on-the-mapping",
-      "severity": "info",
-      "summary": "A Tax Group only categorizes products; it carries no tax rate. The rate for a (group, region) pair lives in a separate Manual Tax Mapping record (only meaningful when the region's calculator is the Wix manual calculator, not Avalara). A product joins a group via the product's own `taxGroupId` field on Wix Stores Catalog V3 (Update Product), not via any call in this domain."
-    },
-    {
-      "code": "query-tax-groups-excludes-defaults",
-      "severity": "blocker",
-      "summary": "Every site already has default tax groups (e.g. Products, Shipping and delivery, Services, Cancellation fees) inherited from its installed apps. Query Tax Groups returns ONLY custom groups a site created — it never returns the defaults. Call List Default Tax Groups (GET /billing/v1/tax-groups/default-tax-groups) to see or resolve a default group's id; this is flagged by Wix's own docs as the most common mistake when looking up a group id such as the shipping group."
-    },
-    {
-      "code": "never-hardcode-the-tax-calculator-appid",
-      "severity": "blocker",
-      "summary": "A Tax Region requires an appId naming an installed tax calculator, and calculator appIds are installation-scoped. Resolve them with List Tax Calculators immediately before creating a region; never reuse an ID from another site or documentation example. For a manually transcribed rate, select the Wix Manual Tax Calculator by display name rather than hardcoding its installation-specific ID, and do not select Avalara."
-    },
-    {
-      "code": "unmapped-tax-group-calculates-to-exactly-zero-tax",
-      "severity": "info",
-      "summary": "LIVE-VERIFIED (2026-08-12, not stated explicitly in docs): calling Calculate Tax for a line item whose tax group has NO manual tax mapping for the matched region returns exactly zero tax (taxAmount/taxableAmount both \"0\", empty taxBreakdown[]) rather than an error or a fallback rate. This is the correct primitive for representing a genuinely tax-exempt product/category: create one dedicated tax group for it and deliberately create no manual tax mapping for that group in any region, instead of enumerating a 0% mapping per region."
-    },
-    {
-      "code": "iso-codes-not-display-names",
-      "severity": "blocker",
-      "summary": "`country` (ISO 3166-1 alpha-2) and `subdivision` (ISO 3166-2 without the country prefix, e.g. `NY` not `US-NY`) are stored as codes only — no display name is kept anywhere. Storing a display name like `Georgia` instead of `GA` doesn't error; it just silently matches nothing at calculation time. Subdivision-level regions are only accepted for AU, BR, CA, FR, DE, IN, IT, MX, NL, PT, ES, AE, GB, and US; for any other country, omit `subdivision` (or pass `*`) to create a country-level region."
-    },
-    {
-      "code": "delete-diagnostic-tax-regions-they-surface-as-merchant-facing-warnings",
-      "severity": "warning",
-      "summary": "A Tax Region created without a Manual Tax Mapping is not inert: Wix's own Tax Locations UI lists it immediately with a visible warning icon and \"Add rates to this location to collect tax at checkout\" — merchant-facing, not just an internal API state. A diagnostic create-then-forget-to-delete cycle leaves real warnings on the live site. Always pair a diagnostic createTaxRegion with a matching deleteTaxRegion in the same session, and independently re-verify via the Tax Locations page (or Query Tax Regions) that nothing was left behind — do not rely on the create/delete call sequence in a script having actually run to completion."
-    }
-  ],
-  "evidence": [
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/introduction"
-    },
-    {
-      "type": "live-verification",
-      "path": "anonymized-live-verification"
-    }
-  ]
-}

package/skills/wix-replatform/resources/rp-target-wix/domains/tax/entities/manual-tax-mapping.json

@@ -1,119 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "tax",
-  "entity": "manual-tax-mapping",
-  "displayName": "Wix Manual Tax Mapping",
-  "capability": "commerce.tax-rate-mapping",
-  "target": {
-    "classification": "native",
-    "nativeEntity": "ManualTaxMapping",
-    "verifiedFqdn": "wix.billing.tax.v1.manual_tax_mapping",
-    "idPolicy": "server-assigned",
-    "crosswalkRequired": true
-  },
-  "dependsOn": [
-    "tax/tax-group",
-    "tax/tax-region"
-  ],
-  "sourceAliases": [
-    {
-      "sourceSystem": "woocommerce",
-      "sourceEntity": "tax-rate.rate",
-      "routes": [
-        "/wc/v3/taxes"
-      ],
-      "confidence": "medium",
-      "note": "The `rate` field of a wc/v3/taxes row (a percentage, e.g. 7.5) maps to `taxRate` as a decimal-string FRACTION (\"0.075\"), joined with `class` (-> resolved tax-group.json group id) and country/state (-> resolved tax-region.json region id). `name` maps to `taxName` (cosmetic only -- shown at checkout, doesn't change the amount)."
-    }
-  ],
-  "preferredWrite": {
-    "surface": "Manual Tax Mappings",
-    "endpoint": "POST /billing/v1/manual-tax-mappings",
-    "writerId": "createManualTaxMapping",
-    "verification": "verified-live",
-    "importSafe": true,
-    "bulk": false
-  },
-  "fallbacks": [
-    {
-      "classification": "skip-by-default",
-      "when": "No source rate rows exist (an anonymized verification environment's actual state, re-verified live 2026-08-12: 0 rows in wc/v3/taxes) -- nothing to map. A genuinely tax-exempt product/category needs NO manual tax mapping at all -- see the unmapped-tax-group pitfall below, which is the intentional non-writer path for that case."
-    }
-  ],
-  "reliability": {
-    "status": "reliable",
-    "flags": []
-  },
-  "pitfalls": [
-    {
-      "code": "tax-apis-live-under-billing-v1",
-      "severity": "warning",
-      "summary": "Create/Query/Delete Manual Tax Mapping are `/billing/v1/manual-tax-mappings...`, not `/ecom/v1/...`."
-    },
-    {
-      "code": "tax-rate-is-a-decimal-string-fraction",
-      "severity": "blocker",
-      "summary": "`taxRate` must be a decimal STRING representing a fraction: \"0.075\" for 7.5%, up to 6 decimal places. A number (0.075), an integer (5), or a percent string (\"7.5%\") are all wrong -- WooCommerce's `rate` field is a percentage (e.g. \"7.5000\"), so the transform must divide by 100 and re-stringify, not pass the WooCommerce value through."
-    },
-    {
-      "code": "group-and-region-must-already-exist",
-      "severity": "blocker",
-      "summary": "Both `taxGroupId` and `taxRegionId` must reference already-created entities (404s TAX_GROUP_ID_NOT_FOUND / TAX_REGION_ID_NOT_FOUND otherwise) -- enforce dependency order: tax-group and tax-region creates complete first, THEN manual-tax-mapping creates, resolving both ids from their own crosswalks."
-    },
-    {
-      "code": "duplicate-mapping-rejected-on-a-6-field-key",
-      "severity": "warning",
-      "summary": "Create Manual Tax Mapping 409s `MANUAL_TAX_MAPPING_ALREADY_EXISTS`/ALREADY_EXISTS when another mapping matches on (taxRegionId, taxGroupId, taxName, taxType, jurisdiction, jurisdictionType) -- dedupe on that composite key before creating, matching WooCommerce rows that differ only in an unrelated field (e.g. `priority`, which has no Wix Manual Tax Mapping equivalent)."
-    },
-    {
-      "code": "jurisdiction-type-undefined-sentinel-breaks-naive-dedupe",
-      "severity": "blocker",
-      "summary": "LIVE-VERIFIED 2026-08-15: Query Manual Tax Mapping returns the literal STRING \"UNDEFINED\" for an unset `jurisdictionType`, not \"\" and not an absent field -- while a freshly-built mapping input (buildManualTaxMappingInput) simply never sets the field (JS `undefined`). Comparing a fetched existing mapping against a freshly-built one for the same (region, group) with a naive `field || ''` dedupe key produces two DIFFERENT keys for what's actually the same mapping, so a re-run tries to create it again and 409s instead of skipping. tax-build.js's `manualTaxMappingDedupeKey` normalizes both \"\" and \"UNDEFINED\" to the same bucket for every field (not just jurisdictionType, in case the same sentinel shows up elsewhere) -- do not simplify this back to a plain `|| ''` fallback."
-    },
-    {
-      "code": "unmapped-tax-group-calculates-to-exactly-zero-tax",
-      "severity": "info",
-      "summary": "LIVE-VERIFIED 2026-08-12 (not stated explicitly in docs): calling Calculate Tax for a line item whose tax group has NO manual tax mapping for the matched region returns exactly zero tax (taxAmount/taxableAmount both \"0\", empty taxBreakdown[]) -- confirmed against an anonymized verification environment with a genuinely mapping-less tax group next to a 7%-mapped control group in the same calculateTax call/region. This is the correct primitive for a genuinely exempt product: create the dedicated tax group (tax-group.json) and deliberately create NO manual tax mapping for it anywhere, rather than enumerating a 0% mapping per region the product might ship to."
-    },
-    {
-      "code": "tax-breakdowns-are-multiple-mapping-rows-not-a-list-field",
-      "severity": "info",
-      "summary": "To show several tax components on one line (e.g. state + county tax), create MULTIPLE manual tax mapping rows for the same (taxGroupId, taxRegionId), one per component, each with its own taxName/taxRate -- there is no array field on a single mapping for this. No deduplication is applied; the set of rows IS the breakdown."
-    },
-    {
-      "code": "priority-and-compound-have-no-mapping-field",
-      "severity": "warning",
-      "summary": "WooCommerce tax-rate fields `priority` and `compound` have no corresponding ManualTaxMapping field. A compound/priority-ordered WooCommerce rate set needs the tax-breakdowns pattern above (verify Wix's calculation order matches priority intent)."
-    },
-    {
-      "code": "shipping-flag-is-a-group-fanout-not-a-mapping-field",
-      "severity": "blocker",
-      "summary": "CORRECTED 2026-08-15: earlier guidance treated WooCommerce's per-rate `shipping` boolean (whether the rate also applies to shipping, not just products) as an unmappable gap, since ManualTaxMapping has no such field. The real fix is structural, not a field: create one mapping per Wix DEFAULT tax group (see tax-group.json's DEFAULT_GROUP_NAMES / groupsForRate in tax-build.js), not one mapping against 'Products' only. A `class: \"standard\"` WooCommerce rate is the store's ONE general rate -- WooCommerce has no per-billing-category split the way Wix's Products/Shipping and delivery/Services/Cancellation fees groups do. Mapping to Products only silently zero-rates shipping, services, and cancellation fees in that region (a mapping-less group calculates to EXACTLY zero tax, see the finding below) -- a real undercharging bug, not a faithful migration. A non-`standard` class (reduced-rate, zero-rate, ...) is unaffected by this: it still targets only its own dedicated custom group, since that class is a per-product signal, not a store-wide one."
-    }
-  ],
-  "mappingGuidance": [
-    "Convert WooCommerce percentage `rate` to a Wix fraction string: rate / 100, formatted with no more than 6 decimal places, e.g. \"7.5\" -> \"0.075\".",
-    "Resolve `taxGroupId` from the source row's `class` via tax-group.json's crosswalk, and `taxRegionId` from (country, state) via tax-region.json's crosswalk -- never invent either id.",
-    "A `class: \"standard\"` (or blank) rate creates ONE Manual Tax Mapping PER DEFAULT GROUP (Products, Shipping and delivery, Services, Cancellation fees), all with the same taxRate/taxRegionId -- use tax-build.js's `groupsForRate` rather than hardcoding 'Products'. A non-standard class targets only its own custom group instead (never the defaults, never Tax Exempt).",
-    "Leave `taxName`/`taxType`/`jurisdiction`/`jurisdictionType` populated from the source `name`/country-state display info where available; they are cosmetic (shown at checkout) and don't affect the calculated amount, but a blank `taxName` shows a default 'Sales Tax' label which may not match a non-US source's terminology (VAT/GST)."
-  ],
-  "setupRequirements": [],
-  "evidence": [
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/manual-tax-mappings/manual-tax-mapping-object"
-    },
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/manual-tax-mappings/create-manual-tax-mapping"
-    },
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-calculation/calculate-tax"
-    },
-    {
-      "type": "live-verification",
-      "path": "anonymized-live-verification"
-    }
-  ]
-}

package/skills/wix-replatform/resources/rp-target-wix/domains/tax/entities/tax-group.json

@@ -1,94 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "tax",
-  "entity": "tax-group",
-  "displayName": "Wix Tax Group",
-  "capability": "commerce.tax-treatment-group",
-  "target": {
-    "classification": "native",
-    "nativeEntity": "TaxGroup",
-    "verifiedFqdn": "wix.billing.tax.v1.tax_group",
-    "idPolicy": "server-assigned",
-    "crosswalkRequired": true
-  },
-  "dependsOn": [],
-  "sourceAliases": [
-    {
-      "sourceSystem": "woocommerce",
-      "sourceEntity": "product.tax_class",
-      "routes": ["/wc/v3/products", "/wc/v3/taxes/classes"],
-      "confidence": "medium",
-      "note": "WooCommerce's tax_class (standard/reduced-rate/zero-rate, plus any custom classes in wc/v3/taxes/classes) is the closest analog to a Wix tax group -- both bucket products by tax treatment. A site with only the 3 WooCommerce defaults and no differentiated rates per class has no live signal that actually requires more than the Wix default 'Products' group."
-    },
-    {
-      "sourceSystem": "woocommerce",
-      "sourceEntity": "product.tax_status",
-      "routes": ["/wc/v3/products"],
-      "confidence": "high",
-      "note": "tax_status=none (genuinely tax-exempt, independent of tax_class) is the strongest, most reliable signal in this domain -- map it to a dedicated custom tax group with no manual tax mapping in any region (see manual-tax-mapping.json's unmapped-tax-group pitfall). tax_status=taxable is the default and needs no assignment -- Wix Stores products with no taxGroupId automatically use the site's default 'Products' group."
-    }
-  ],
-  "preferredWrite": {
-    "surface": "Tax Groups",
-    "endpoint": "POST /billing/v1/tax-groups",
-    "writerId": "createTaxGroup",
-    "verification": "verified-live",
-    "importSafe": true,
-    "bulk": false
-  },
-  "fallbacks": [
-    {
-      "classification": "skip-by-default",
-      "when": "The source has no differentiated tax_class/tax_status signal beyond WooCommerce's 3 unused defaults -- do not create a custom tax group per WooCommerce tax_class name speculatively. Create one only when a real per-product signal (a non-default tax_class actually in use, or tax_status=none) exists."
-    }
-  ],
-  "reliability": { "status": "reliable", "flags": [] },
-  "pitfalls": [
-    {
-      "code": "tax-apis-live-under-billing-v1",
-      "severity": "warning",
-      "summary": "Create/Query/Delete Tax Group are all `/billing/v1/tax-groups...`, not `/ecom/v1/...` (unlike sibling Discount Rules) or `/stores/v2/...` (unlike Coupons)."
-    },
-    {
-      "code": "query-tax-groups-excludes-defaults",
-      "severity": "blocker",
-      "summary": "Query Tax Groups (POST /billing/v1/tax-groups/query) returns ONLY custom groups this site created -- it silently omits the built-in defaults (live-confirmed on an anonymized verification environment 2026-08-12: 'Shipping and delivery', 'Products' 215238eb-22a5-4c36-9e7b-e7c08025e04e, 'Services' 13d21c63-b5ec-5912-8397-c3a5ddb27a97, 'Cancellation fees'). Call List Default Tax Groups (GET /billing/v1/tax-groups/default-tax-groups) to resolve a default group's id -- e.g. to find the Products group id for a control/comparison mapping."
-    },
-    {
-      "code": "tax-group-carries-no-rate",
-      "severity": "info",
-      "summary": "Creating a tax group only creates the bucket. It sets no tax rate anywhere -- the rate for a (group, region) pair is a separate Manual Tax Mapping record. Do not expect Calculate Tax to charge anything for a brand-new group until (a) a manual tax mapping exists for it in a matched region, or (b) leave it deliberately unmapped for an exempt group (see manual-tax-mapping.json)."
-    },
-    {
-      "code": "assignment-is-a-plain-stores-product-write-not-a-tax-api-call",
-      "severity": "info",
-      "summary": "A product joins a tax group via the product's own `taxGroupId` field on Wix Stores Catalog V3 (PATCH /stores/v3/products/{id}, requiring the product's current `revision`) -- not via any endpoint in this file. Live-verified 2026-08-12: PATCH with `{product:{id, revision, taxGroupId}}` against an already-migrated product with tax_status=none succeeded and re-GET confirmed the persisted taxGroupId."
-    },
-    {
-      "code": "system-defined-groups-cannot-be-renamed-or-deleted",
-      "severity": "warning",
-      "summary": "Update Tax Group documents `ILLEGAL_UPDATE_ON_SYSTEM_DEFINED_TAX_GROUP` -- default groups from List Default Tax Groups cannot be renamed/deleted; only custom groups created via Create Tax Group can be."
-    },
-    {
-      "code": "default-group-name-is-not-a-locale-invariant-key",
-      "severity": "blocker",
-      "summary": "TaxGroup's own schema (checked 2026-08-15) is only `{id, name, revision, createdDate, updatedDate}` -- no locale-independent category key exists. The docs' own List Default Tax Groups worked example even returns a different default set ('Standard Tax') than an anonymized verification environment's real one ('Products'/'Shipping and delivery'/'Services'/'Cancellation fees'), confirming `name` genuinely varies per site/locale, not a fixed platform constant. tax-build.js's `groupsForRate` still matches by `name` (it's the only field the API offers), but now throws loudly if fewer than all 4 expected names are found -- a translated or differently-configured site must fail fast here, not silently fan a standard-class rate out to a partial set of groups (see manual-tax-mapping.json's shipping-flag-is-a-group-fanout-not-a-mapping-field pitfall for why an incomplete fan-out is the same undercharging bug)."
-    }
-  ],
-  "mappingGuidance": [
-    "Only create a custom tax group when there is a real per-product signal: either a non-default WooCommerce tax_class actually assigned to at least one product, or tax_status=none (exempt). Do not pre-create groups for WooCommerce's unused 'reduced-rate'/'zero-rate' defaults just because they exist in wc/v3/taxes/classes with no products using them.",
-    "For a genuinely tax-exempt product (tax_status=none), create ONE dedicated tax group (e.g. named 'Tax Exempt') and assign it via the product's taxGroupId -- do not create a manual tax mapping for it in any region; see manual-tax-mapping.json's unmapped-tax-group-calculates-to-exactly-zero-tax finding.",
-    "For a differentiated WooCommerce tax_class with an actual non-default rate in wc/v3/taxes, create one Wix tax group per class name and let manual-tax-mapping.json's writer carry the per-region rate."
-  ],
-  "setupRequirements": [],
-  "evidence": [
-    { "type": "wix-docs", "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-groups/tax-group-object" },
-    { "type": "wix-docs", "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-groups/create-tax-group" },
-    { "type": "wix-docs", "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-groups/query-tax-groups" },
-    { "type": "wix-docs", "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-groups/list-default-tax-groups" },
-    {
-      "type": "live-verification",
-      "path": "anonymized-live-verification"
-    }
-  ]
-}

package/skills/wix-replatform/resources/rp-target-wix/domains/tax/entities/tax-region.json

@@ -1,113 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "tax",
-  "entity": "tax-region",
-  "displayName": "Wix Tax Region",
-  "capability": "commerce.tax-region",
-  "target": {
-    "classification": "native",
-    "nativeEntity": "TaxRegion",
-    "verifiedFqdn": "wix.billing.tax.v1.tax_region",
-    "idPolicy": "server-assigned",
-    "crosswalkRequired": true
-  },
-  "dependsOn": [],
-  "sourceAliases": [
-    {
-      "sourceSystem": "woocommerce",
-      "sourceEntity": "tax-rate",
-      "routes": [
-        "/wc/v3/taxes"
-      ],
-      "confidence": "medium",
-      "note": "A wc/v3/taxes row's `country` + `state` columns map to one Tax Region (country + optional ISO 3166-2 subdivision, without the country prefix). `postcode`/`postcodes` and `city`/`cities` have NO Wix Tax Region equivalent -- Wix's region model stops at country/subdivision (see pitfalls). `priority`/`compound`/`order` (rate stacking/ordering) also have no direct Tax Region/Manual Tax Mapping field; a compound-rate WooCommerce setup needs the 'tax breakdowns' multi-mapping pattern documented in manual-tax-mapping.json, not a Tax Region field."
-    }
-  ],
-  "preferredWrite": {
-    "surface": "Tax Regions",
-    "endpoint": "POST /billing/v1/tax-regions",
-    "writerId": "createTaxRegion",
-    "verification": "verified-live",
-    "importSafe": true,
-    "bulk": false
-  },
-  "fallbacks": [
-    {
-      "classification": "skip-by-default",
-      "when": "No source has any wc/v3/taxes rows (an anonymized verification environment's actual state, verified live 2026-08-12: 0 rows) -- there is nothing to create a region FOR. Do not pre-create speculative regions; wait for real rate data."
-    },
-    {
-      "classification": "cms",
-      "when": "A source rate row is scoped narrower than subdivision (postcode or city) -- Wix Tax Region has no field for either. Record the narrower scope as a mapping gap rather than silently widening it to the whole subdivision/country, which would change who gets charged tax."
-    }
-  ],
-  "reliability": {
-    "status": "reliable",
-    "flags": []
-  },
-  "pitfalls": [
-    {
-      "code": "tax-apis-live-under-billing-v1",
-      "severity": "warning",
-      "summary": "Create/Query/Delete Tax Region are `/billing/v1/tax-regions...`, not `/ecom/v1/...`."
-    },
-    {
-      "code": "never-hardcode-the-calculator-appid",
-      "severity": "blocker",
-      "summary": "appId is required and installation-scoped. Resolve it with List Tax Calculators immediately before creating a region. A source manual rate must select the non-Avalara calculator by display name through resolveManualTaxCalculatorAppId in wix-writers.js, never a hardcoded installation-specific ID."
-    },
-    {
-      "code": "no-postcode-or-city-granularity",
-      "severity": "blocker",
-      "summary": "The TaxRegion object has exactly two location fields: `country` (ISO 3166-1 alpha-2) and `subdivision` (ISO 3166-2 without country prefix). There is no postcode/zip or city field. A WooCommerce tax rate scoped to `postcode`/`postcodes` or `city`/`cities` cannot be represented at that granularity -- it must be flattened to the containing subdivision (or country, if the source didn't even specify one), which is a real, not cosmetic, change to who is charged. Record this as an explicit mapping gap per affected source row rather than silently widening scope."
-    },
-    {
-      "code": "subdivisions-only-for-14-countries",
-      "severity": "warning",
-      "summary": "Subdivision-level regions are accepted only for AU, BR, CA, FR, DE, IN, IT, MX, NL, PT, ES, AE, GB, US. For any other country, create the region at country level (omit `subdivision` or pass `*`); passing one anyway risks `SUBDIVISIONS_NOT_SUPPORTED_FOR_COUNTRY`."
-    },
-    {
-      "code": "iso-codes-not-display-names",
-      "severity": "blocker",
-      "summary": "`country`/`subdivision` are stored as ISO codes ONLY -- no display name is kept anywhere, so there is no way to recover 'New York' from a stored `NY` later, and storing 'New York' instead of `NY` doesn't error, it just silently matches nothing at Calculate Tax time. WooCommerce's `state` column is typically already an ISO-ish code (e.g. `US-NY` region format varies by version) -- verify the exact source format per site before stripping/mapping it, don't assume it is already bare ISO 3166-2."
-    },
-    {
-      "code": "no-duplicate-country-plus-subdivision",
-      "severity": "warning",
-      "summary": "Create Tax Region 409s `ALREADY_EXISTS` for a second region with the same (country, subdivision) pair -- dedupe by that pair before creating, the same way product/category dedupe works elsewhere in this pipeline, rather than relying on the API's rejection as the dedupe mechanism."
-    },
-    {
-      "code": "embargoed-countries-rejected",
-      "severity": "info",
-      "summary": "Tax regions can't be created for Cuba, Iran, North Korea, or Syria."
-    }
-  ],
-  "mappingGuidance": [
-    "Group WooCommerce wc/v3/taxes rows by (country, state) before creating regions -- one Wix Tax Region per distinct pair, not per source row (a source site can have multiple rows -- e.g. standard/reduced/zero rate -- sharing the same region, which fan out to separate Manual Tax Mappings against ONE region).",
-    "Resolve the manual calculator's appId once per import run (it doesn't change mid-run) and reuse it for every region create in that run.",
-    "When a source rate has no state/province value, create a country-level region (omit subdivision) rather than guessing a default subdivision."
-  ],
-  "setupRequirements": [],
-  "evidence": [
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-regions/tax-region-object"
-    },
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-regions/create-tax-region"
-    },
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-regions/query-tax-regions"
-    },
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-calculation/list-tax-calculators"
-    },
-    {
-      "type": "live-verification",
-      "path": "anonymized-live-verification"
-    }
-  ]
-}

package/skills/wix-replatform/resources/rp-target-wix/domains/tax/entities/tax-settings.json

@@ -1,65 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "tax",
-  "entity": "tax-settings",
-  "displayName": "Wix Tax Settings",
-  "capability": "commerce.tax-settings",
-  "target": {
-    "classification": "setup-config",
-    "nativeEntity": "TaxSettings",
-    "verifiedFqdn": "wix.billing.tax.v1.tax_settings",
-    "idPolicy": "not-applicable",
-    "crosswalkRequired": false
-  },
-  "sourceAliases": [
-    {
-      "sourceSystem": "woocommerce",
-      "sourceEntity": "settings.woocommerce_prices_include_tax",
-      "routes": ["/wc/v3/settings/tax"],
-      "confidence": "high",
-      "note": "A direct boolean 1:1: WooCommerce 'yes'/'no' -> Wix taxIncludedInItemPrices true/false. This is a single site-level flag, not a per-record entity -- there is exactly one TaxSettings resource per site (upsert, not create)."
-    }
-  ],
-  "dependsOn": [],
-  "preferredWrite": {
-    "surface": "Tax Settings",
-    "endpoint": "POST /billing/v1/tax-settings",
-    "writerId": "upsertTaxSettings",
-    "verification": "verified-live",
-    "importSafe": true,
-    "bulk": false
-  },
-  "fallbacks": [],
-  "reliability": { "status": "reliable", "flags": [] },
-  "pitfalls": [
-    {
-      "code": "single-site-level-resource-not-a-crosswalked-record",
-      "severity": "info",
-      "summary": "There is exactly one TaxSettings object per site (Get returns defaults if never set; Upsert creates-or-updates the same singleton). Treat this as ordinary setup/config work, never a per-record write with a crosswalk."
-    },
-    {
-      "code": "display-flag-only-does-not-reprice-the-catalog",
-      "severity": "info",
-      "summary": "`taxIncludedInItemPrices` only changes how checkout DISPLAYS/treats existing catalog prices (tax-inclusive vs. added-on-top); it does not rewrite product prices. Setting it does not require touching already-imported product prices."
-    },
-    {
-      "code": "shared-across-all-wix-products-on-the-site",
-      "severity": "warning",
-      "summary": "Per Wix's own docs, this setting is 'shared across all Wix products on the site' -- if the destination site later gets a second sales channel/app relying on a different price-inclusion convention, changing this affects it too. Not a concern for a single-purpose migration, but don't set it speculatively on a site with pre-existing unrelated commerce config."
-    }
-  ],
-  "mappingGuidance": [
-    "Dependencies: no other modeled record must exist first; Tax Settings is a single site-level configuration resource.",
-    "Read the source's woocommerce_prices_include_tax setting and the destination's Get Tax Settings response; call Upsert Tax Settings only when they differ. Live verification confirmed that a source value of 'no' can already match Wix's false default, requiring no write."
-  ],
-  "setupRequirements": [],
-  "evidence": [
-    { "type": "wix-docs", "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-settings/tax-settings-object" },
-    { "type": "wix-docs", "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-settings/get-tax-settings" },
-    { "type": "wix-docs", "url": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/extensions/tax/tax-settings/upsert-tax-settings" },
-    {
-      "type": "live-verification",
-      "path": "anonymized-live-verification"
-    }
-  ]
-}

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

@@ -1,64 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-
-function createBucket() {
-  return {
-    total: 0,
-    ok: 0,
-    created: 0,
-    updated: 0,
-    skipped: 0,
-    failed: 0,
-    retried: 0,
-    throttled: 0,
-  };
-}
-
-function statusOf(event) {
-  return event.status || event.resultStatus || event.result || 'unknown';
-}
-
-function entityOf(event) {
-  return event.entity || event.entityKey || event.sourceEntity || 'unknown';
-}
-
-function summarizeAuditEvents(events, { runId } = {}) {
-  if (!runId) {
-    throw new Error('summarizeAuditEvents requires runId; append-only audit logs may contain multiple attempts.');
-  }
-  const summary = {};
-  for (const event of events) {
-    if (!event || event.runId !== runId) continue;
-    const entity = entityOf(event);
-    const status = statusOf(event);
-    if (!summary[entity]) summary[entity] = createBucket();
-    summary[entity].total += 1;
-    if (Object.prototype.hasOwnProperty.call(summary[entity], status)) {
-      summary[entity][status] += 1;
-    }
-  }
-  return summary;
-}
-
-function readAuditNdjson(filePath) {
-  const text = fs.readFileSync(filePath, 'utf8').trim();
-  if (!text) return [];
-  return text.split('\n').filter(Boolean).map((line, index) => {
-    try {
-      return JSON.parse(line);
-    } catch (error) {
-      throw new Error(`Invalid audit JSON at line ${index + 1}: ${error.message}`);
-    }
-  });
-}
-
-function summarizeAuditFile(filePath, options) {
-  return summarizeAuditEvents(readAuditNdjson(filePath), options);
-}
-
-module.exports = {
-  summarizeAuditEvents,
-  summarizeAuditFile,
-  readAuditNdjson,
-};