@wix/agent-skills 1.36.0 → 1.36.1

package/skills/wix-replatform/resources/rp-target-wix/domains/members/entities/member.json

@@ -1,205 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "members",
-  "entity": "member",
-  "displayName": "Site Member",
-  "capability": "identity.member",
-  "target": {
-    "classification": "native-plus-cms",
-    "nativeEntity": "Member",
-    "verifiedFqdn": null,
-    "idPolicy": "server-assigned",
-    "crosswalkRequired": true
-  },
-  "dependsOn": [
-    "crm/contact"
-  ],
-  "sourceAliases": [
-    {
-      "sourceSystem": "wordpress",
-      "sourceEntity": "user",
-      "routes": [
-        "/wp/v2/users"
-      ],
-      "confidence": "medium"
-    },
-    {
-      "sourceSystem": "woocommerce",
-      "sourceEntity": "customer",
-      "routes": [
-        "/wc/v3/customers"
-      ],
-      "confidence": "medium"
-    },
-    {
-      "sourceSystem": "wix",
-      "sourceEntity": "member",
-      "routes": [
-        "Members APIs"
-      ],
-      "confidence": "high"
-    }
-  ],
-  "preferredWrite": {
-    "surface": "Members V1",
-    "endpoint": "POST /members/v1/members",
-    "writerId": "createMember",
-    "verification": "verified-live",
-    "importSafe": false,
-    "bulk": false
-  },
-  "safeModeContactFields": [
-    {
-      "kind": "email",
-      "targetPath": "member.loginEmail",
-      "source": "target-schema",
-      "notes": "Members V1 login email in the create-member request body."
-    }
-  ],
-  "fallbacks": [
-    {
-      "classification": "crm",
-      "when": "Use Contacts for person records that do not need login identity."
-    },
-    {
-      "classification": "cms",
-      "when": "Use for author profiles or member metadata not represented by Members APIs."
-    }
-  ],
-  "reliability": {
-    "status": "unreliable",
-    "flags": [
-      "IMPORT_UNRELIABLE"
-    ]
-  },
-  "pitfalls": [
-    {
-      "code": "safe-mode-email-domain-rejected",
-      "severity": "blocker",
-      "summary": "VERIFIED LIVE 2026-08-16: safe mode cannot import members at all today. `mockEmailForEntity` (rp-target-wix/lib/wix-writers.js) mints `replatform+<type>_<id>@wix.com`, and POST /members/v1/members rejects that domain with 400 INVALID_EMAIL_DOMAIN — so a safe-mode member import fails wholesale on the first record. The bug hid because Contacts V5 ACCEPTS @wix.com (existing test contacts use it), so only the Members surface trips it. A reserved-TLD address (RFC 2606 `.invalid`) was accepted by other surfaces in the same probe session and is the obvious candidate, but changing the safe-mode address format alters what gets written to a customer's site on every entity, not just members — it needs an explicit decision, not a silent lib patch. Until then: treat safe mode + member import as unsupported and say so in the plan rather than discovering it mid-run."
-    },
-    {
-      "code": "passwords-never-imported",
-      "severity": "warning",
-      "summary": "Passwords are NOT imported — project decision (2026-08-03), not just an API gap. Members keep account/profile/contact linkage; they set a new password via reset. Never propose hash import."
-    },
-    {
-      "code": "activation-via-forgot-password",
-      "severity": "warning",
-      "summary": "Activation (decided 2026-08-03): passwordless members complete the standard forgot-password flow (confirmed). Delivery = post-import automation (label-added trigger, owner-branded email, label applied in API waves). Never mass-send Send Set Password Email — its link dies in 3h."
-    },
-    {
-      "code": "serial-create-only",
-      "severity": "warning",
-      "summary": "No bulk member create; documented >=1s spacing per Create Member call (10k members ~ 3h serial floor). Plan throughput and resume via loginEmail crosswalk."
-    },
-    {
-      "code": "chronology-server-controlled",
-      "severity": "warning",
-      "summary": "Original createdDate and lastLoginDate are not writable as native member chronology."
-    },
-    {
-      "code": "phone-must-be-e164-and-dedupes-across-contacts",
-      "severity": "blocker",
-      "summary": "VERIFIED LIVE 2026-09-06: contact.phones[] REJECTS anything not already E.164 (\"050-1234567\" 400s INVALID_PHONE; \"+972501234567\" is accepted) -- WooCommerce phones are local-format text and need converting or dropping, never sent as-is. Separately, Contacts dedupes on phone: creating a SECOND member with an unrelated name/email but the SAME phone as a first member returned the FIRST member's contactId -- silently attaching the new person onto the old contact, renaming it in the process -- and this happened even after the first member had been DELETED (deleting a member does not delete its contact; the contact is left orphaned and reusable). rp-target-wix/lib/customer-member.js normalizePhoneE164 converts under an explicit per-country rule or refuses (never guesses); wix-writers.js ensureMember queries Contacts V5 by phone before every create (every phone in the array, not just the first -- an earlier version of this guard checked only phones[0], which a review caught 2026-09-06) and drops the phone(s) (finding member-phone-collision-dropped) rather than risk merging two different source customers. Also cosmetic, not a defect: Members V1 read-back reformats the phone with spaces/dashes for display (\"+972 50-999-0001\"), while Contacts V5 stores the compact string sent and exposes it again verbatim under phone.e164 -- compare on digits, not the display string."
-    },
-    {
-      "code": "query-members-by-login-email-is-eventually-consistent",
-      "severity": "warning",
-      "summary": "VERIFIED LIVE 2026-09-06: a freshly created member is NOT immediately findable through Query Members by loginEmail -- one probe saw zero matches at +0ms and +2000ms after Create Member returned, then one match at +5000ms. Create Member's own loginEmail UNIQUENESS check, by contrast, is immediate and case-insensitive (a same-email create in a different case 409s ALREADY_EXISTS right away, with no delay observed). So a caller that reconciles by Query Members before creating (rp-target-wix/lib/wix-writers.js ensureMember) can, within that window, see zero matches for a member that in fact already exists on the target (created moments earlier by an interrupted or concurrent run) and then hit a 409 attempting to create it again. ensureMember reports this as its own outcome (member-already-exists-unreconciled) rather than the generic member-failed, since the record is not lost -- a later run's query will catch up and reconcile it -- but it is not a silent success either. Reconciling through a crosswalk row's GET-by-id (matchedBy: crosswalk) does not depend on this: a fresh site's crosswalk-driven re-run in this project's own live verification reconciled correctly immediately after creation, suggesting GET-by-id does not carry the same lag, though that was not isolated and confirmed the way this consistency gap was."
-    },
-    {
-      "code": "login-email-immutable-once-member-exists",
-      "severity": "blocker",
-      "summary": "LIVE-VERIFIED 2026-09-16: once a Contact already has a Member on it (contact.memberInfo present), Contacts' updateContact 428s CANNOT_UPDATE_MEMBER_EMAIL on ANY email PATCH to that contact -- even when the on-file email is still a safe-mode mock. Update Member's own docs independently confirm loginEmail is immutable there too (\"The privacyStatus and loginEmail field can't be updated\"). So if a Member is ever created against the wrong email (a mock address, a typo, a placeholder used for early testing before the real value was known), there is NO supported API path to correct it afterward -- not via Contacts, not via Members. The only paths that avoid this are: (1) never create the Member until the contact's real email is already on file (this is why the crm/contact promotion flow updates the Contact's email BEFORE calling ensureMember, never after), or (2) if a wrong-email member already exists, accept it as-is and treat correcting it as requiring a delete-and-recreate (which loses member history/UGC) rather than an in-place fix. Detect this BEFORE attempting an email update by checking the read contact's own memberInfo.memberId -- it is free on the same getContact call that would otherwise 428 -- rather than discovering it from the write's error."
-    },
-    {
-      "code": "create-member-occasional-transient-failure",
-      "severity": "warning",
-      "summary": "LIVE-FOUND: in a real large sequential Create Member batch, with the documented >=1s floor already enforced, a small fraction of otherwise-valid Create Member calls failed on the first attempt with no 4xx/validation signature, and succeeded immediately when the IDENTICAL call was retried moments later with no changes to the request -- not a rate-limit artifact of this caller (the floor was already respected) and not a validation problem. ensureMember (rp-target-wix/lib/wix-writers.js) now retries Create Member once, after a short backoff, for any failure that is not the already-exists race (query-members-by-login-email-is-eventually-consistent above) and not a 4xx -- a 4xx is a validation error that will not fix itself and is reported as member-failed immediately. A caller still seeing member-failed after this retry should treat it as retryable on a LATER run, not terminal: every transient failure observed before this fix succeeded on a subsequent attempt with no other change."
-    }
-  ],
-  "mappingGuidance": [
-    "Split author, customer, contact, and login-member roles before selecting targets.",
-    "Create Member sends no email and does not fire the signup automations trigger (source-confirmed) — silent import is the default; the only member-facing email is the explicit Send Set Password Email call, which is per-member, interactive-mode, owner-approved only."
-  ],
-  "setupRequirements": [
-    "Activation is decided end-to-end: no credential import; post-import the owner creates ONE dashboard automation (label-added trigger → branded email directing members to Log in → Forgot password), then the importer applies the label in API waves for rate control and re-targeting. Enable the automation only after the import window (AUTO-02 pause choreography)."
-  ],
-  "evidence": [
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/members/member-object",
-      "note": "object page (docs-survey sweep 2026-08-11)"
-    }
-  ],
-  "intendedFields": [
-    {
-      "targetPath": "member.loginEmail",
-      "sourcePaths": [
-        "email",
-        "loginEmail"
-      ]
-    },
-    {
-      "targetPath": "member.contact.firstName",
-      "sourcePaths": [
-        "first_name",
-        "firstName"
-      ]
-    },
-    {
-      "targetPath": "member.contact.lastName",
-      "sourcePaths": [
-        "last_name",
-        "lastName"
-      ]
-    },
-    {
-      "targetPath": "member.contact.phones[]",
-      "sourcePaths": [
-        "phones[]",
-        "phone"
-      ]
-    },
-    {
-      "targetPath": "member.contact.addresses[]",
-      "sourcePaths": [
-        "addresses[]"
-      ]
-    }
-  ],
-  "readBackProjection": {
-    "identity": "member-id-login-email-contact-id",
-    "serverOwned": [
-      {
-        "path": "member.updatedDate",
-        "reason": "server timestamp"
-      }
-    ],
-    "read": [
-      "GET /members/v1/members/{id}?fieldsets=FULL",
-      "GET /contacts/v5/contacts/{member.contactId}"
-    ],
-    "rows": [
-      {
-        "writePath": "member.contact.firstName",
-        "readPath": "contact.name.first"
-      },
-      {
-        "writePath": "member.contact.lastName",
-        "readPath": "contact.name.last"
-      },
-      {
-        "writePath": "member.contact.phones[]",
-        "readPath": "contact.phone.phone + contact.additionalPhones[].phone",
-        "compare": "set"
-      },
-      {
-        "writePath": "member.contact.addresses[]",
-        "readPath": "contact.addresses[].address",
-        "compare": "content"
-      }
-    ]
-  }
-}

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

@@ -1,41 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "pricing-plans",
-  "fetchedAt": "2026-08-16",
-  "roots": [
-    "api-reference/business-solutions/pricing-plans"
-  ],
-  "surfaces": [
-    {
-      "id": "api-reference/business-solutions/pricing-plans/orders",
-      "title": "Orders",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/orders",
-      "group": null,
-      "verdict": "claimed",
-      "refs": [
-        "pricing-plans/plan-order"
-      ],
-      "reviewedOn": "2026-08-16"
-    },
-    {
-      "id": "api-reference/business-solutions/pricing-plans/plans-v3",
-      "title": "Plans V3",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/plans-v3",
-      "group": null,
-      "verdict": "claimed",
-      "refs": [
-        "pricing-plans/plan"
-      ],
-      "reviewedOn": "2026-08-16"
-    },
-    {
-      "id": "api-reference/business-solutions/pricing-plans/skills",
-      "title": "Skills",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/skills",
-      "group": null,
-      "verdict": "not-relevant",
-      "reason": "AI-skill documentation pages (agent walkthroughs: Create and Update Pricing Plans, Bookings integration, dashboard navigation), not a data surface.",
-      "reviewedOn": "2026-08-16"
-    }
-  ]
-}

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

@@ -1,46 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "pricing-plans",
-  "dependsOnRequired": true,
-  "docsRoots": [
-    "api-reference/business-solutions/pricing-plans"
-  ],
-  "displayName": "Wix Pricing Plans",
-  "ownerHint": "Pricing Plans (paid plans, memberships, plan orders/subscriptions) domain owners",
-  "wixAppsRequired": [
-    "Wix Pricing Plans"
-  ],
-  "defaultImportOrder": [
-    "plan",
-    "plan-order"
-  ],
-  "sharedPitfalls": [
-    {
-      "code": "pricing-plans-app-required",
-      "severity": "blocker",
-      "summary": "The Wix Pricing Plans app must be installed before any write in this domain; Create Offline Order fails with 428 PRICING_PLANS_NOT_INSTALLED. Verify during setup rather than discovering it at import time."
-    },
-    {
-      "code": "recurring-billing-never-migrates",
-      "severity": "blocker",
-      "summary": "Payment tokens do not carry from any source platform, and an offline plan order has no charge method attached. At best the contract's facts migrate; collection restarts on Wix (owner collects off-platform and marks paid, or subscribers re-purchase online). Required migration policy."
-    },
-    {
-      "code": "offline-order-lifecycle-calls-fire-events",
-      "severity": "warning",
-      "summary": "Order lifecycle calls emit domain events (Order Purchased/Started/Paused/Marked As Paid webhooks), and Mark As Paid explicitly documents that offline payments 'trigger events and emails'. Treat every post-create lifecycle call during import as a potential member-facing notification until verified live."
-    }
-  ],
-  "evidence": [
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/introduction",
-      "note": "domain root; menu walked 2026-08-16 (Plans V3, Orders, Skills)"
-    },
-    {
-      "type": "repo-research",
-      "path": "skills/wix-replatform/resources/rp-source-wordpress/plugins/capabilities-pending-decision.json",
-      "note": "commerce.subscription-contracts pending entry resolved by the approved product policy: recreate active WooCommerce subscriptions as Pricing Plans memberships (Create Plan + Create Offline Order)"
-    }
-  ]
-}

package/skills/wix-replatform/resources/rp-target-wix/domains/pricing-plans/entities/plan-order.json

@@ -1,137 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "pricing-plans",
-  "entity": "plan-order",
-  "displayName": "Pricing Plan Order",
-  "capability": "commerce.subscription-contracts",
-  "target": {
-    "classification": "native",
-    "nativeEntity": "Pricing Plans Order",
-    "verifiedFqdn": null,
-    "idPolicy": "server-assigned",
-    "crosswalkRequired": true
-  },
-  "dependsOn": [
-    "pricing-plans/plan",
-    "members/member"
-  ],
-  "sourceAliases": [
-    {
-      "sourceSystem": "woocommerce",
-      "sourceEntity": "subscription",
-      "sourcePlugin": "subscriptions-for-woocommerce",
-      "routes": [
-        "/wsp-route/v1/wsp-view-subscription"
-      ],
-      "confidence": "medium"
-    }
-  ],
-  "preferredWrite": {
-    "surface": "Orders (CheckoutService)",
-    "endpoint": "POST /pricing-plans/v2/checkout/orders/offline",
-    "writerId": null,
-    "verification": "docs",
-    "importSafe": false,
-    "bulk": false
-  },
-  "reliability": {
-    "status": "unknown",
-    "flags": []
-  },
-  "pitfalls": [
-    {
-      "code": "create-notification-behavior-undocumented",
-      "severity": "blocker",
-      "summary": "STILL UNPROVEN after a live probe (2026-08-16) — importSafe deliberately stays false. Create Offline Order documents no member-notification behavior and has no suppress/silent flag (the request is only planId, memberId, paid, startDate, couponCode, submissionId), while the sibling Mark As Paid explicitly documents that offline payments 'trigger events and emails'. The 2026-08-16 probe created a real offline order with paid:true and observed NOTHING that indicates an email either way — but the observation is worthless as proof of silence for two independent reasons: (a) the target site was under a site-wide notification mute for the whole probe, which by design suppresses all notifications to all recipients on all channels, so no email could have been sent regardless of the API's default behavior; and (b) the probe member's address was deliberately undeliverable (example.invalid), and there is no Wix read API that lists emails a site has sent, so even unmuted there would have been nothing to inspect. Absence of evidence here is an artifact of the method, not a finding. See notification-proof-requirements for what would actually settle it."
-    },
-    {
-      "code": "notification-proof-requirements",
-      "severity": "warning",
-      "summary": "To make importSafe true, obtain either a controlled notification test on a separately provisioned, unmuted throwaway site with monitored mailboxes and a positive-control Mark As Paid message, or an authoritative Pricing Plans statement that Create Offline Order sends no member notification. The migration flow never unmutes a destination, so this test must never run on a migration target."
-    },
-    {
-      "code": "lifecycle-state-not-settable-at-create",
-      "severity": "blocker",
-      "summary": "status, endDate, pausePeriods, cancellation, and lastPaymentStatus are all read-only on the Order object; the only writable create inputs are startDate, paid, couponCode, submissionId. A source PAUSED contract needs a post-create Pause Order call (only ACTIVE orders can be paused); CANCELED/ENDED source contracts cannot be recreated in that state natively - keep them as CMS-only history."
-    },
-    {
-      "code": "past-start-date-accepted",
-      "severity": "info",
-      "summary": "RESOLVED — VERIFIED LIVE 2026-08-16 (this pitfall was 'past-start-date-undocumented'; the probe answered it). A backdated startDate IS accepted and preserved: a weekly plan ordered with startDate 2025-06-01 came back status ACTIVE with startDate 2025-06-01 and a server-computed currentCycle { index: 64, startedDate, endedDate } — Wix replays the cycle schedule forward from the backdated start rather than clamping to now. So the original signup date AND the billing anniversary can both be preserved in one field, and the next-payment-date trade-off described in next-payment-date-not-settable is real but resolvable: pick startDate = the source signup date and the derived anniversary follows automatically. Note the cycle index is exposed, so a source contract's cycle count can be cross-checked after import."
-    },
-    {
-      "code": "paid-flag-settles-asynchronously",
-      "severity": "warning",
-      "summary": "VERIFIED LIVE 2026-08-16: with paid:true at create, the CREATE RESPONSE returned lastPaymentStatus: 'UNPAID' and a GET moments later returned 'PAID'. The payment state settles asynchronously behind the create call. An importer that asserts lastPaymentStatus off the create response will record a false negative for every contract; re-read the order (or accept eventual consistency) before writing the crosswalk or the verification artifact."
-    },
-    {
-      "code": "next-payment-date-not-settable",
-      "severity": "warning",
-      "summary": "There is no next-payment-date input; Wix derives the payment schedule from startDate plus the plan's billingCycle. The source contract's next_payment_date can only be honored by choosing startDate so the cycles align - which trades off against preserving the original start date."
-    },
-    {
-      "code": "business-address-precondition",
-      "severity": "warning",
-      "summary": "Create Offline Order is documented to fail with 428 MISSING_BUSINESS_ADDRESS_STATE / MISSING_BUSINESS_ADDRESS_COUNTRY when the site business address is incomplete; configure it during setup, not at import time. NOT REPRODUCED 2026-08-16: an anonymized verification environment's GET /site-properties/v4/properties returned no businessAddress at all (only locale/currency/timezone) and the offline order still created successfully — so the precondition either depends on the plan's tax configuration or is not enforced on every path. Keep the setup step (it is cheap and the documented error is specific), but do not treat a missing business address as a hard preflight blocker without reproducing the 428."
-    },
-    {
-      "code": "order-snapshot-mislabels-plan-description",
-      "severity": "warning",
-      "summary": "VERIFIED LIVE 2026-08-16: the order snapshots planName and planDescription at creation, but planDescription came back as a COPY OF THE PLAN NAME, not the plan's actual description — the plan itself retained its real description. This matters because the accepted trade-off for the severed Stores-product linkage is 'the source product name survives in the plan title/description': that provenance survives on the PLAN, not on the order record. Do not read source provenance out of order.planDescription."
-    },
-    {
-      "code": "orders-are-cancel-only-never-deletable",
-      "severity": "warning",
-      "summary": "VERIFIED LIVE 2026-08-16: there is no delete for a pricing-plan order. POST /pricing-plans/v2/orders/{id}/cancel with { effectiveAt: 'IMMEDIATELY' } → 200 and the order moves to status CANCELED with endDate = the cancel instant, but the record and its subscriptionId persist forever. A faulty contract import cannot be rolled back to a clean slate the way imported eCom orders can (Bulk Delete Imported Orders has no counterpart here) — which is a second, independent reason to keep this write behind an explicit approval gate."
-    }
-  ],
-  "mappingGuidance": [
-    "Per active subscriber: create/crosswalk the plan first (pricing-plans/plan), resolve memberId via the member-import crosswalk (400 MEMBER_DOESNT_EXIST is the hard dependency - members import must run first), then POST the offline order; planId + memberId are the only required fields.",
-    "Set paid:true for contracts whose current cycle is already collected on the source (lastPaymentStatus becomes PAID); leave paid:false only when the source cycle is genuinely unpaid. For free plans lastPaymentStatus is NOT_APPLICABLE regardless.",
-    "Recurring BILLING never migrates - payment tokens do not carry and an offline order has no charge method attached; collection restarts on Wix (owner collects off-platform and marks paid, or subscribers re-purchase online). Required migration policy.",
-    "The Stores-product linkage is severed: the contract is recreated as a Pricing Plans membership and the source product name survives only in the plan title/description - required migration trade-off.",
-    "Status mapping: source active -> startDate now or past (ACTIVE); source pending-start -> future startDate (PENDING); source paused -> create ACTIVE then Pause Order; source cancelled/expired -> do not recreate natively, land the historical record in CMS.",
-    "Plan purchase limits are ignored for offline orders (documented), so per-member limits on the recreated plan cannot block the import.",
-    "Persist the returned order.id and subscriptionId against the source subscription id in the crosswalk at create time; the order also snapshots planName/planPrice at creation (but NOT a usable planDescription — see order-snapshot-mislabels-plan-description).",
-    "Observed live 2026-08-16: the created order also carries buyer.contactId, a wixPayOrderId, and onEcom: true — plan orders now surface through the eCom stack, so a plan-order import is visible to eCom-side views even though it is not an eCom order. Factor that into any post-import reconciliation that counts orders."
-  ],
-  "setupRequirements": [
-    "Wix Pricing Plans app installed — appDefId 1522827f-c56c-a5c9-2ac9-00f9e6ae12d3, installable via the App Installation API (see pricing-plans/plan). Observed live 2026-08-16: the actual pre-install failure on Plans V3 is 428 APP_NOT_INSTALLED carrying that appId, not the documented PRICING_PLANS_NOT_INSTALLED — match on the HTTP 428 and the appId, not the application-code string.",
-    "Site business address configured (documented 428 MISSING_BUSINESS_ADDRESS_STATE/COUNTRY — not reproduced 2026-08-16, see business-address-precondition)",
-    "Members import completed (memberId is required; 400 MEMBER_DOESNT_EXIST)",
-    "SCOPE.DC-PAIDPLANS.MANAGE-ORDERS"
-  ],
-  "evidence": [
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/orders/order-object",
-      "note": "object page: status enum (DRAFT/PENDING/ACTIVE/PAUSED/ENDED/CANCELED), endDate/pausePeriods/cancellation/lastPaymentStatus all read-only, buyer memberId+contactId, type OFFLINE (read 2026-08-16)"
-    },
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/orders/create-offline-order",
-      "note": "POST https://www.wixapis.com/pricing-plans/v2/checkout/orders/offline; required planId + memberId; settable paid (default false), startDate (default now; PENDING when future, ACTIVE otherwise), couponCode, submissionId; purchase limits ignored for offline orders; errors incl. PRICING_PLANS_NOT_INSTALLED, MEMBER_DOESNT_EXIST, MISSING_BUSINESS_ADDRESS_* (read 2026-08-16)"
-    },
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/orders/mark-as-paid",
-      "note": "'Subsequent offline payments do trigger events and emails' - the documented email trigger on this surface; also: an offline order cannot be marked paid twice (read 2026-08-16)"
-    },
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/orders/pause-order",
-      "note": "only ACTIVE orders can be paused; pausing extends endDate; Cancel Order supports IMMEDIATELY or NEXT_PAYMENT_DATE; Postpone End Date requires a later endDate and cannot target PAUSED orders (read 2026-08-16)"
-    },
-    {
-      "type": "repo-research",
-      "path": "skills/wix-replatform/resources/rp-source-wordpress/plugins/capabilities-pending-decision.json",
-      "note": "commerce.subscription-contracts uses the Pricing Plans recreation path described by this entity."
-    },
-    {
-      "type": "live-run",
-      "path": "anonymized-live-verification",
-      "note": "Verified live on a muted site: Create Offline Order accepted paid:true with a backdated startDate, preserved the start date, derived the current cycle, returned the expected offline-order identifiers, and changed lastPaymentStatus from UNPAID on create to PAID on readback. Notification behavior remains unverified because the site was muted and the test address was undeliverable, so importSafe stays false. Orders can be cancelled but not deleted; probe records were cleaned up accordingly."
-    }
-  ],
-  "notes": "WooCommerce active-subscription records migrate by recreation as Pricing Plans memberships using Plans V3 Create Plan and Create Offline Order per subscriber. Live verification established the end-to-end write mechanics and preservation of backdated start dates and billing anniversaries. preferredWrite.verification remains docs and importSafe remains false because member-notification behavior is unproven: verification used a muted site and an undeliverable address, so silence was not evidence. Codegen must keep this as a guarded write behind the approval gate."
-}

package/skills/wix-replatform/resources/rp-target-wix/domains/pricing-plans/entities/plan.json

@@ -1,133 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "pricing-plans",
-  "entity": "plan",
-  "displayName": "Pricing Plan",
-  "capability": "commerce.subscription-plans",
-  "target": {
-    "classification": "native",
-    "nativeEntity": "Pricing Plan",
-    "verifiedFqdn": null,
-    "idPolicy": "server-assigned",
-    "crosswalkRequired": true
-  },
-  "dependsOn": [],
-  "sourceAliases": [
-    {
-      "sourceSystem": "woocommerce",
-      "sourceEntity": "subscriptionProduct",
-      "sourcePlugin": "subscriptions-for-woocommerce",
-      "routes": [
-        "/wc/v3/products"
-      ],
-      "confidence": "medium"
-    }
-  ],
-  "preferredWrite": {
-    "surface": "Plans V3",
-    "endpoint": "POST /pricing-plans/v3/plans",
-    "writerId": "ensurePlanDefinition",
-    "verification": "verified-live",
-    "importSafe": true,
-    "bulk": false
-  },
-  "reliability": {
-    "status": "partially-reliable",
-    "flags": []
-  },
-  "pitfalls": [
-    {
-      "code": "status-required-on-create",
-      "severity": "blocker",
-      "summary": "plan.status is REQUIRED on create and is NOT listed among the docs' required parameters. VERIFIED LIVE 2026-08-16: omitting it 400s with REQUIRED_FIELD on plan.status; 'ACTIVE' is accepted. Any generated create payload built strictly from the documented required-field list will fail on the first call."
-    },
-    {
-      "code": "no-archive-on-v3",
-      "severity": "warning",
-      "summary": "Plans V3 has no archive endpoint — POST /pricing-plans/v3/plans/{id}/archive 404s. VERIFIED LIVE 2026-08-16: the working call is the V2 one, POST /pricing-plans/v2/plans/{id}/archive → 200, after which the V3 GET shows archived: true while status stays ACTIVE. Rollback/cleanup for a plan import therefore crosses API versions, and 'archived' and 'status' are independent flags — never infer one from the other."
-    },
-    {
-      "code": "private-forces-buyable-false",
-      "severity": "warning",
-      "summary": "VERIFIED LIVE 2026-08-16: creating a plan with visibility PRIVATE returns buyable: false even when buyable was not sent. Recreated contracts still work (offline orders ignore buyability), but a plan imported PRIVATE for a staged rollout will not become self-purchasable just by flipping visibility later — check buyable explicitly after any visibility change."
-    },
-    {
-      "code": "billing-cycle-minimum-7-days",
-      "severity": "blocker",
-      "summary": "billingCycle must be at least 7 days and can't exceed 10 years (error VALID_BILLING_CYCLE). The period enum includes DAY, but a source cadence of every 1-6 days cannot be recreated; surface affected offers before import."
-    },
-    {
-      "code": "plan-duration-max-10-years",
-      "severity": "warning",
-      "summary": "Total plan duration (billingCycle x billingCycleCount) can't exceed 10 years (error VALID_PLAN_DURATION); billingCycleCount is capped at 2000. Very long fixed-length source subscriptions must fall back to UNTIL_CANCELLED with a ledger entry."
-    },
-    {
-      "code": "single-variant-single-strategy",
-      "severity": "warning",
-      "summary": "Docs state pricing variants are 'Currently limited to 1 variant per plan', and pricingStrategies is validated minItems 1 / maxItems 1 with flatRate as the only strategy. Tiered, usage-based, or multi-cadence pricing on one source offer must be split into separate plans or dropped with a ledger entry."
-    },
-    {
-      "code": "plan-name-max-50-chars",
-      "severity": "warning",
-      "summary": "plan.name is limited to 50 characters (description to 450). Long source product names truncate; keep the full source name and product reference in the description."
-    },
-    {
-      "code": "currency-is-site-level",
-      "severity": "warning",
-      "summary": "plan.currency is read-only (ISO-4217, driven by site settings). A source subscription priced in a different currency imports its numeric amount under the site currency; verify the site currency matches the source before import (error INVALID_AMOUNT rejects more decimal places than the plan currency supports)."
-    },
-    {
-      "code": "public-plans-render-immediately",
-      "severity": "warning",
-      "summary": "visibility is a required create field; PUBLIC plans appear on the live site's Plans & Pricing page as soon as they are created. Import with the intended final visibility deliberately - PRIVATE keeps a plan off the page while existing buyers can still use it, and buyable:false blocks self-purchase."
-    }
-  ],
-  "mappingGuidance": [
-    "Cadence maps 1:1: billingTerms.billingCycle.period enum is DAY | WEEK | MONTH | YEAR, matching WooCommerce day|week|month|year (e.g. wps_sfw_subscription_interval); billingCycle.count (string, min 1) carries the interval number.",
-    "Open-ended source subscriptions -> endType UNTIL_CANCELLED. A source expiry/length -> endType CYCLES_COMPLETED with cyclesCompletedDetails.billingCycleCount = expiry divided by the cadence (must divide evenly; ledger the remainder otherwise). startType ON_PURCHASE.",
-    "Required create fields: plan, plan.status (undocumented but enforced — see status-required-on-create), pricingVariants[].id (GUID), .name, .billingTerms (billingCycle.period, startType, endType), plan.visibility; pricingStrategies[0].flatRate.amount is the recurring price as a decimal string (>= 0, max 4 decimal places; 0 makes a free plan). A client-minted pricingVariants[].id GUID is preserved verbatim (verified live 2026-08-16), so the variant id can be derived deterministically from the source offer id and used as a crosswalk key.",
-    "A source initial signup fee maps to pricingVariants[].fees[]: priceType FIXED_AMOUNT (fixedAmountOptions.amount > 0), appliedAt FIRST_PAYMENT - the only documented fee type and application point.",
-    "freeTrialDays (integer 0-999) carries the free trial; it is days only, so convert week/month source trials to days.",
-    "Deduplicate to one plan per distinct source offer (product x cadence x price) shared by all its subscribers - never one plan per subscriber.",
-    "Pass idempotencyKey (must be GUID format) derived deterministically from the source offer id (e.g. UUIDv5) so a retried import returns the original plan instead of duplicating it.",
-    "The Stores-product linkage is severed by design: record the source product name/id in the plan title/description (required migration trade-off). extendedFields exists on the plan but requires a schema-plugin app namespace, so it is not a free-form carry.",
-    "Definitions are built by lib/pricing-plan-definition.js (buildPlanDefinition: PRIVATE, buyable false, status ACTIVE, name<=50/description<=450 truncated WITH a finding, 7-day minimum cycle and 10-year maximum enforced as unmappable/finding) and written by wix-writers.js ensurePlanDefinition: the reconciliation identity is the client-minted pricingVariants[].id -- a crosswalk row is read back and adopted only if the plan exists, is not archived and carries it; then Query Plans by name filtered to plans carrying it (one reconciles, more is ambiguous and creates nothing); then Create Plan >=1s apart. The row-count gate (evaluatePlanSources over B1/B2/B3) runs first: all zero means 'no pricing plans found', never 'not supported'."
-  ],
-  "setupRequirements": [
-    "Wix Pricing Plans app installed — appDefId 1522827f-c56c-a5c9-2ac9-00f9e6ae12d3 (ground truth: the appId echoed by the 428 APP_NOT_INSTALLED error). Verified live 2026-08-16: it is NOT present on a commerce-template site by default, and it installs cleanly and dependency-free through the standard App Installation API (POST /apps-installer-service/v1/app-instance/install), so this is an automatable setup step, not a manual one. Until it is installed, every Plans V3 read/write returns 428 APP_NOT_INSTALLED.",
-    "SCOPE.DC-PAIDPLANS.MANAGE-PLANS"
-  ],
-  "evidence": [
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/plans-v3/plan-object",
-      "note": "object page: full plan shape incl. currency (read-only, site-level), visibility PUBLIC|PRIVATE, buyable, purchaseLimits (read 2026-08-16)"
-    },
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/plans-v3/create-plan",
-      "note": "POST https://www.wixapis.com/pricing-plans/v3/plans; required params, billingCycle.period enum DAY|WEEK|MONTH|YEAR, startType ON_PURCHASE|CUSTOM, endType UNTIL_CANCELLED|CYCLES_COMPLETED, flatRate-only pricing strategy, fee enums FIXED_AMOUNT/FIRST_PAYMENT, idempotencyKey GUID, errors VALID_BILLING_CYCLE / VALID_PLAN_DURATION / INVALID_AMOUNT (read 2026-08-16)"
-    },
-    {
-      "type": "repo-research",
-      "path": "skills/wix-replatform/resources/rp-source-wordpress/plugins/subscriptions-for-woocommerce.json",
-      "note": "source offer shape: wps_sfw_* postmeta cadence/expiry/signup-price/free-trial keys"
-    },
-    {
-      "type": "live-run",
-      "path": "anonymized-live-verification",
-      "note": "Verified live: the Pricing Plans app must be installed before Plans V3 writes. Create and GET readback preserved the client-supplied variant ID, billing terms, and flat-rate strategy; Wix derived the slug and site currency and supplied the documented defaults. plan.status is required on create, and archival uses V2 because V3 has no archive endpoint."
-    },
-    {
-      "type": "live-verification",
-      "path": "tests/target-wix/coupon-plan-live-sentinel.js",
-      "note": "2026-09-05, fresh disposable site with the Pricing Plans app installed at creation (Create Project `apps`): ensurePlanDefinition -> Create Plan V3 with visibility PRIVATE, buyable false, status ACTIVE, one MONTH variant with freeTrialDays 7 and a client-minted variant id -> 200; GET reads back PRIVATE / buyable:false / ACTIVE; Query Plans with `filter: { name: { $eq } }` finds it so a re-run reconciles by name and creates nothing; POST /pricing-plans/v2/plans/{id}/archive -> 200."
-    },
-    {
-      "type": "live-verification",
-      "path": "tests/target-wix/coupon-plan-live-sentinel.js",
-      "note": "2026-09-05 (fresh site): reconciliation is by the client-minted `pricingVariants[].id`, not the name — the Query Plans read-back carries the variant id verbatim and the re-run reported `matchedBy: variant-id`, creating nothing. GET /pricing-plans/v3/plans/{id} is the read used to verify a crosswalk row before it is adopted (404 -> stale row). A name is only a candidate filter: names are cut to 50 chars and collide across offers."
-    }
-  ],
-  "notes": "WooCommerce active subscriptions migrate by recreation as Pricing Plans memberships: this entity is the offer half (one plan per distinct source offer), and pricing-plans/plan-order is the per-subscriber contract half. Live verification covered install, create, readback, and archive for a WEEK/UNTIL_CANCELLED/flatRate plan. CYCLES_COMPLETED, fees[], freeTrialDays, and the documented VALID_BILLING_CYCLE 7-day floor remain unverified, and plans can be archived but not deleted; reliability therefore remains partially-reliable. The recurring offer also has a live-verified field home at stores/product.subscriptionDetails, which keeps the product purchasable while this plan anchors recreated contracts."
-}

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

@@ -1,7 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "sales-channels",
-  "fetchedAt": "2026-08-16",
-  "roots": [],
-  "surfaces": []
-}

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

@@ -1,36 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "sales-channels",
-  "dependsOnRequired": true,
-  "docsRoots": [],
-  "displayName": "Wix Sales Channels",
-  "ownerHint": "Stores multichannel/marketplace integrations — the \"Sales Channels\" section of the Wix Stores dashboard (Catalog > Sales Channels)",
-  "wixAppsRequired": [
-    "Wix Stores"
-  ],
-  "defaultImportOrder": [
-    "meta-catalog-connect",
-    "google-youtube-connect",
-    "tiktok-catalog-connect",
-    "pinterest-catalog-connect",
-    "amazon-shop-connect",
-    "ebay-shop-connect"
-  ],
-  "sharedPitfalls": [
-    {
-      "code": "no-public-rest-surface",
-      "severity": "info",
-      "summary": "Every entity in this domain is a merchant-executed connect flow inside the Wix dashboard (and, for several channels, the third-party dashboard too) — not a public dev.wix.com REST API. docsRoots is intentionally empty: there is no dev.wix.com business-solutions menu to survey here (the docs-survey requirement is satisfied with an empty roots/surfaces pair, not skipped). Evidence for these entities is the internal Business Schema/FQDN registry (docs-schema MCP) plus support.wix.com, not dev.wix.com."
-    }
-  ],
-  "evidence": [
-    {
-      "type": "wix-docs",
-      "url": "https://support.wix.com/en/setting-up-sales-channels"
-    },
-    {
-      "type": "internal-fqdn",
-      "path": "wix.stores_channels.* (39 FQDNs under this namespace as of 2026-08-16: feed/catalog builder, marketplace actions/settings/overrides, per-channel gateways and feed pushers) — enumerated via docs-schema MCP fqdn_lookup"
-    }
-  ]
-}