@wix/agent-skills 1.15.0 → 1.16.0

package/skills/wix-replatform/resources/rp-target-wix/SPEC-product-reviews-and-blog-authorship.md

@@ -0,0 +1,330 @@
+# Spec: Wix Product Reviews and Blog Author Provisioning
+
+## Status
+
+Draft for implementation. No code changes are included in this spec.
+
+## Problem statement
+
+Two execution-time gaps are currently handled incorrectly:
+
+1. Product reviews can currently fail with:
+   `No verified native Wix product-review primitive was identified for this workflow`
+2. Wix Blog import in public-only mode can currently stop at:
+   `Wix Blog post import is marked IMPORT_UNRELIABLE, and original author identity is not available in public-only mode`
+
+Both failures are too coarse.
+
+- The first treats product reviews as if there is no usable native Wix target surface.
+- The second treats missing original member identity as a hard stop, even though Wix Blog
+  requires a `memberId` on draft-post create and RePlatform already has a native member
+  create primitive.
+
+## External facts to anchor the change
+
+Verified from current official Wix docs on July 29, 2026:
+
+- Wix Reviews has a native `Review` object and supports create/manage/retrieve for
+  reviews of an entity such as a Stores product:
+  <https://dev.wix.com/docs/api-reference/crm/community/feedback-moderation/reviews/reviews/review-object>
+- Wix Blog `Create Draft Post` requires `memberId` for 3rd-party apps:
+  <https://dev.wix.com/docs/api-reference/business-solutions/blog/draft-posts/list-draft-posts>
+
+Verified live on August 2, 2026 (probe against the wporg-news migration's
+API-provisioned Wix target site, "My Site 8"):
+
+- Wix **auto-creates a user-member for the site owner** (and contributing Wix users) on
+  API-provisioned sites — no Members-area interaction needed — and Create Draft Post
+  accepts it from an API-key caller. So "attribute everything to the site owner" requires
+  zero member provisioning. Resolution contract: find it via `GET /members/v1/members`
+  (`fieldsets=FULL`) matching the owner's `loginEmail`; the probe's observed id equality
+  (member id == account GUID) is a solo-account observation and undocumented — never
+  construct the memberId from the account/user GUID. These auto user-members must never
+  be deduped against source-site members.
+- Post authorship is **re-assignable after publish**: `PATCH /blog/v3/draft-posts/{id}`
+  with `{ draftPost: { memberId } }` followed by republish updates the published post's
+  author (post id == draft id). Republish events are not suppressed by `saveType=IMPORT`,
+  so author-reassignment passes must run inside the notification-mute window.
+
+This means:
+
+- product reviews are a native Wix target, even if our adapter does not yet expose a
+  dedicated verified writer
+- blog posts in third-party app flows must always resolve an author `memberId` before
+  `POST /blog/v3/draft-posts`
+
+## Goals
+
+- Treat product reviews as a native Wix target with an unverified direct REST path, not
+  as "no native primitive exists."
+- Replace the current blog-author hard stop with deterministic fallback member
+  provisioning for public-only runs.
+- Keep the behavior explicit in product metadata so mapper, codegen, and execution all
+  converge on the same rule.
+- Preserve current safety posture around login identities and unverifiable source data.
+
+## Non-goals
+
+- Do not make original Wix Members login identity portable.
+- Do not import source password hashes or original credentials.
+- Do not claim verified-live support for Wix Reviews until a live write test exists.
+- Do not solve all member dedup/merge policy in this change; this spec covers the minimal
+  deterministic author-member path required for blog import.
+
+## Desired behavior
+
+### 1) Product reviews
+
+When the source entity is specifically a product review:
+
+- Mapping must classify it as a product-review subtype, not as a generic comment.
+- The selected target must remain native Wix, using the Wix Reviews domain rather than a
+  CMS fallback by default.
+- If no dedicated writer exists yet, codegen/execution must use the existing direct REST
+  native path pattern:
+  - record the path as `unverified`
+  - notify the RePlatform team that a dedicated writer is missing
+  - surface the risk in the mapping and execution review artifacts
+- The execution path must no longer raise the specific error
+  `No verified native Wix product-review primitive was identified for this workflow`
+  for this case.
+
+### 2) Blog author provisioning
+
+When importing blog posts and the source run is public-only:
+
+- RePlatform must not require the original source author identity as a blocker for native
+  Wix Blog import.
+- Instead, it must deterministically provision or resolve a fallback Wix member and use
+  that member as the post author.
+- The member should be created before the first blog post that needs it, then reused for
+  subsequent posts that resolve to the same fallback author strategy.
+- The flow must continue to record the fidelity loss:
+  original author identity is not preserved as a native Wix member identity in
+  public-only mode.
+
+## Author fallback model
+
+### Terminology
+
+- `original author`: the source-system person record if one exists
+- `fallback author member`: the Wix member created or reused so Blog Draft Posts can be
+  created in third-party mode
+- `author attribution mode`: the strategy recorded in project artifacts for how blog
+  authorship is being represented
+
+### Default strategy
+
+For public-only blog imports, use this default:
+
+- Create one fallback Wix member per distinct source author when the source has stable
+  public author data sufficient to derive a deterministic identity key.
+- If the source author is not resolvable to a distinct stable public identity, create or
+  reuse one project-level generic fallback author member.
+- Alternative for the project-level case (verified live 2026-08-02): the site owner's
+  auto-created user-member is a valid author and requires no provisioning at all —
+  resolve it by `loginEmail` from the member list (never by deriving the id from the
+  account GUID). Use it when the user prefers "posts authored by me" over a synthetic
+  "Imported Author" appearing in the member list; record the choice as the
+  `authorAttributionMode`.
+
+Rationale:
+
+- per-author fallback preserves more authorship structure when public data exists
+- project-level fallback still allows import to proceed when only anonymous/public post
+  content is available
+
+### Deterministic identity key
+
+The implementation should derive a stable fallback member key from best available public
+  source data in this order:
+
+1. source author id
+2. source author slug
+3. source author archive/profile URL
+4. normalized display name
+5. project-level constant `blog-author-fallback`
+
+This key is for local crosswalk/idempotency. It is not exposed as user-facing content.
+
+### Member create payload
+
+The fallback member create path should continue to use the existing Members primitive and
+safe-mode replacement behavior.
+
+Preferred payload inputs:
+
+- `loginEmail`: deterministic synthetic email derived from the fallback identity key
+- `contact.firstName`: best available display name, else `Imported Author`
+- `profile.nickname`: same best available display name
+- `profile.slug`: derived stable slug from author key/display name
+
+The synthetic email is acceptable here because:
+
+- public-only mode lacks portable real login identity
+- Wix member create requires a login identity
+- the current product already supports synthetic safe-mode email patterns for native
+  writes
+
+### Reuse and idempotency
+
+Before creating a fallback member, generated code should:
+
+- consult local crosswalk state for an existing source-author -> member mapping
+- optionally query Wix Members by the deterministic synthetic email when crosswalk state
+  is absent or being rebuilt
+
+After create/resolve:
+
+- store the mapping in crosswalk state
+- reuse the resolved `memberId` for all blog posts tied to that fallback author key
+
+## Product metadata changes
+
+### A. Add explicit Wix Reviews target knowledge
+
+Introduce a domain/entity entry for product reviews owned by `rp-target-wix`.
+
+Recommended shape:
+
+- domain: likely `reviews` if a new domain is added, or another explicit target-owned
+  location if the current taxonomy requires it
+- entity: `product-review`
+- classification: `native-plus-cms` or `native`
+- native entity: `Review`
+- preferred write: direct REST `POST` to the Wix Reviews surface, initially
+  `verification: "docs"` or `verification: "unverified"` until live-tested
+- reliability: should not claim reliable/native-verified yet
+- pitfalls: relation/entity binding, moderation defaults, author/contact linkage, and any
+  required namespace or verified-purchase semantics
+
+The important contract is that product reviews must be discoverable as a native Wix
+target so mapper/codegen stop treating them as a missing primitive.
+
+### B. Update blog post target knowledge
+
+Update blog post metadata to replace the current setup requirement wording:
+
+- current: `Fallback member decision for author attribution.`
+- intended: deterministic fallback member provisioning is part of the default runtime
+  behavior for public-only/native blog import
+
+The entity should still remain `IMPORT_UNRELIABLE` if slug preservation and other current
+gaps still justify that flag.
+
+### C. Keep members/member reliability conservative
+
+Do not remove `IMPORT_UNRELIABLE` from site members globally. The new behavior does not
+mean members become generally faithful imports. It only means a constrained synthetic
+member path is acceptable for blog authorship enablement.
+
+## Stage-by-stage changes
+
+### 1) `rp-mapper`
+
+- Disambiguate generic source `comment` into concrete subtypes:
+  - blog comment
+  - page comment
+  - product review
+  - custom content comment
+- When subtype is product review, prefer the explicit native Reviews target.
+- Record a faithfulness-ledger entry whenever the product-review path is still unverified.
+- For blog posts in public-only mode, record:
+  - native Blog target remains selected
+  - author attribution mode uses fallback member provisioning
+  - original author identity is not preserved
+
+### 2) `rp-import-codegen`
+
+- Generate a direct REST writer path for product reviews when no dedicated writer exists.
+- Ensure generated execution-plan artifacts describe product reviews as native/unverified,
+  not unsupported.
+- Generate helper logic for fallback blog-author member resolution/provisioning before
+  draft-post writes.
+- Ensure blog posts depend on this member-resolution helper in the generated import order.
+
+### 3) `rp-target-wix/lib/wix-writers.js`
+
+- No new implementation is part of this spec, but the intended follow-up is:
+  - either add a dedicated `createReview` primitive
+  - or document the direct REST request shape and let codegen use `buildDirectRestRequest`
+    until a dedicated writer is added
+- Reuse existing `createMember` for fallback blog-author provisioning.
+- If needed, add a narrow helper around member lookup/create to avoid duplicating author
+  fallback logic in generated code.
+
+### 4) `rp-execute-import`
+
+- Product reviews should be executed as an unverified native path, not rejected as
+  "no primitive."
+- Blog posts should provision/resolve fallback author members during execution rather
+  than halting on missing original identity in public-only mode.
+- Completion and review artifacts must call out:
+  - product-review native path remained unverified
+  - blog authorship used synthetic fallback members where applicable
+
+## Artifacts and reporting
+
+The following user-facing statements must appear in generated review artifacts when
+relevant:
+
+- For product reviews:
+  `Wix has a native Reviews entity for product reviews. This migration uses an unverified native write path pending dedicated adapter verification.`
+- For blog authorship in public-only mode:
+  `Blog posts will be authored by fallback Wix members created for import because third-party Wix Blog post creation requires memberId and original login identity is not available in public-only capture.`
+
+Machine artifacts should also record:
+
+- chosen `authorAttributionMode`
+- fallback author key strategy
+- whether authorship is per-source-author fallback or project-level fallback
+
+## Acceptance criteria
+
+1. A source entity classified as product review no longer produces
+   `No verified native Wix product-review primitive was identified for this workflow`.
+2. Mapping artifacts classify product reviews as a native Wix target and mark the path
+   unverified until a live writer exists.
+3. Public-only blog imports no longer stop because original author identity is missing.
+4. Generated/imported blog posts always have a resolved `memberId` before
+   `POST /blog/v3/draft-posts`.
+5. Fallback author members are reused deterministically across reruns via local state.
+6. Review artifacts clearly disclose that blog author identity is represented by fallback
+   members rather than original portable identities.
+7. Existing reliability warnings for general member import are preserved unless separately
+   re-evaluated.
+
+## Risks and open questions
+
+1. Wix Reviews request shape still needs product-specific live verification:
+   - required namespace, if any
+   - whether author is expressed as contact, member, or another actor shape
+   - moderation defaults on create
+   - whether verified-purchase state is writable or derived
+2. Member dedup policy needs care if a later authenticated run provides real users that
+   overlap with previously-created fallback members. The re-attribution mechanics are now
+   verified (2026-08-02): the authenticated re-run provisions/resolves the real per-author
+   members, then for each fallback-attributed post PATCHes the draft `memberId` and
+   republishes — the crosswalk must therefore record `authorAttributionMode` (and the
+   author key) per post so the upgrade pass knows which posts to re-author. Remaining
+   policy questions: when to delete the now-orphaned fallback members (delete works —
+   `DELETE /members/v1/members/{id}` verified — but their auto-created contacts may
+   linger), and republish-event exposure (not IMPORT-suppressed; mute window required).
+3. Synthetic fallback members may appear in the site's member list; that is acceptable
+   for this migration path but should be disclosed in review artifacts.
+4. Some sources expose author display text per post but no stable author identity; those
+   should fall back to the project-level generic member unless a deterministic per-author
+   key can be justified from public data.
+
+## Suggested implementation order
+
+1. Add product metadata/domain knowledge for Wix Reviews product-review targeting.
+2. Update mapper subtype routing and faithfulness-ledger text.
+3. Update codegen/execution planning so product reviews use native-unverified direct REST.
+4. Add fallback blog-author member resolution/provisioning helper around existing member
+   create primitive.
+5. Update execution and review artifact text.
+6. Add contract tests for:
+   - product review classification and execution-plan wording
+   - public-only blog post imports resolving a fallback member id
+

package/skills/wix-replatform/resources/rp-target-wix/domains/README.md

@@ -0,0 +1,21 @@
+# Wix Domain Entity Suitability
+
+This directory is the compact, machine-readable knowledge base for Wix target entity
+suitability. Domain and entity files are the source of truth. `index.json` is generated
+from those files and checked in so mapper/codegen lookups stay token-cheap.
+
+## Maintenance
+
+- Edit only the affected `domains/<domain>/` subtree when changing domain-owned facts.
+- Keep long analysis in `research/import-api-suitability/`; entity files should contain
+  compact guidance and evidence links.
+- Use `preferredWrite.writerId` only for exported functions from
+  `rp-target-wix/lib/wix-writers.js`. Use `null` for direct REST plans, setup work, or
+  unsupported native gaps.
+- Mark entity-level native import gaps with `IMPORT_UNRELIABLE` in
+  `reliability.flags[]`. Field-level lossiness belongs in `pitfalls[]`.
+- Regenerate and validate the index after edits:
+
+```bash
+node skills/replatform/resources/rp-target-wix/scripts/domain-knowledge-validate.js --write-index
+```

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

@@ -0,0 +1,19 @@
+{
+  "schemaVersion": 1,
+  "domain": "blog",
+  "displayName": "Wix Blog",
+  "ownerHint": "Blog posts, categories, tags, authorship, and comments domain owners",
+  "wixAppsRequired": ["Wix Blog"],
+  "defaultImportOrder": ["category", "tag", "post", "comment"],
+  "sideEffectNotes": ["Publishing imported posts may fire public publish side effects."],
+  "evidence": [
+    {
+      "type": "repo-research",
+      "path": "research/import-api-suitability/blog-cms-media.md"
+    },
+    {
+      "type": "repo-research",
+      "path": "research/source-entity-import-suitability-wordpress-woocommerce-wix.md"
+    }
+  ]
+}

package/skills/wix-replatform/resources/rp-target-wix/domains/blog/entities/category.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": 1,
+  "domain": "blog",
+  "entity": "category",
+  "displayName": "Blog Category",
+  "target": {
+    "classification": "native-plus-cms",
+    "nativeEntity": "Blog Category",
+    "verifiedFqdn": null,
+    "idPolicy": "server-assigned",
+    "crosswalkRequired": true
+  },
+  "sourceAliases": [
+    { "sourceSystem": "wordpress", "sourceEntity": "category", "routes": ["/wp/v2/categories"], "confidence": "high" },
+    { "sourceSystem": "wix", "sourceEntity": "blogCategory", "routes": ["Blog Categories"], "confidence": "high" }
+  ],
+  "preferredWrite": {
+    "surface": "Blog Categories",
+    "endpoint": "POST /blog/v3/categories",
+    "writerId": "createBlogCategory",
+    "verification": "verified-live",
+    "importSafe": true,
+    "bulk": false
+  },
+  "fallbacks": [
+    { "classification": "cms", "when": "Use to preserve WordPress category hierarchy because Wix Blog categories are flat." }
+  ],
+  "reliability": { "status": "partially-reliable", "flags": [] },
+  "pitfalls": [
+    { "code": "flat-target", "severity": "warning", "summary": "Wix Blog categories are flat; WordPress hierarchy needs CMS shadowing if it matters." }
+  ],
+  "mappingGuidance": ["Resolve category collisions and crosswalk IDs before writing posts."],
+  "setupRequirements": ["Wix Blog app"],
+  "evidence": [
+    { "type": "repo-research", "path": "research/import-api-suitability/blog-cms-media.md" }
+  ]
+}

package/skills/wix-replatform/resources/rp-target-wix/domains/blog/entities/comment.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": 1,
+  "domain": "blog",
+  "entity": "comment",
+  "displayName": "Blog Comment",
+  "target": {
+    "classification": "native-plus-cms",
+    "nativeEntity": "Comment",
+    "verifiedFqdn": null,
+    "idPolicy": "server-assigned",
+    "crosswalkRequired": true
+  },
+  "sourceAliases": [
+    { "sourceSystem": "wordpress", "sourceEntity": "comment", "routes": ["/wp/v2/comments"], "confidence": "high" },
+    { "sourceSystem": "wix", "sourceEntity": "comment", "routes": ["Comments API"], "confidence": "medium" }
+  ],
+  "preferredWrite": {
+    "surface": "Comments",
+    "endpoint": "POST /comments/v1/comments",
+    "writerId": null,
+    "verification": "docs",
+    "importSafe": false,
+    "bulk": false
+  },
+  "fallbacks": [
+    { "classification": "cms", "when": "Use for unsupported target relations, moderation history, IP/user-agent policy limits, or threading gaps." }
+  ],
+  "reliability": { "status": "partially-reliable", "flags": [] },
+  "pitfalls": [
+    { "code": "relation-required", "severity": "blocker", "summary": "Verify the target relation and notification behavior before native comment writes." }
+  ],
+  "mappingGuidance": ["Classify blog comments, page comments, product reviews, and custom-post comments separately."],
+  "setupRequirements": ["Comment relation verification before execution."],
+  "evidence": [
+    { "type": "repo-research", "path": "research/import-api-suitability/blog-cms-media.md" }
+  ]
+}

package/skills/wix-replatform/resources/rp-target-wix/domains/blog/entities/post.json

@@ -0,0 +1,39 @@
+{
+  "schemaVersion": 1,
+  "domain": "blog",
+  "entity": "post",
+  "displayName": "Blog Post",
+  "target": {
+    "classification": "native-plus-cms",
+    "nativeEntity": "Blog Post",
+    "verifiedFqdn": null,
+    "idPolicy": "server-assigned",
+    "crosswalkRequired": true
+  },
+  "sourceAliases": [
+    { "sourceSystem": "wordpress", "sourceEntity": "post", "routes": ["/wp/v2/posts"], "confidence": "high" },
+    { "sourceSystem": "wix", "sourceEntity": "blogPost", "routes": ["Blog Draft Posts", "Blog Posts"], "confidence": "high" }
+  ],
+  "preferredWrite": {
+    "surface": "Blog Draft Posts",
+    "endpoint": "POST /blog/v3/draft-posts",
+    "writerId": "createDraftPost",
+    "verification": "verified-live",
+    "importSafe": false,
+    "bulk": false
+  },
+  "fallbacks": [
+    { "classification": "cms", "when": "Use for SEO fields, author/profile metadata, or source-only fields not represented by Blog APIs." }
+  ],
+  "reliability": { "status": "partially-reliable", "flags": ["IMPORT_UNRELIABLE"] },
+  "pitfalls": [
+    { "code": "slug-url-rewrite", "severity": "blocker", "summary": "Exact original URL or slug preservation is not reliable through public Blog Draft Posts." },
+    { "code": "publish-side-effects", "severity": "warning", "summary": "Publishing imported posts may trigger public publish behavior." }
+  ],
+  "mappingGuidance": ["Create categories, tags, media, and author/member references before posts."],
+  "setupRequirements": ["Wix Blog app", "Fallback member decision for author attribution."],
+  "evidence": [
+    { "type": "repo-research", "path": "research/import-api-suitability/blog-cms-media.md" },
+    { "type": "repo-research", "path": "research/source-entity-import-suitability-wordpress-woocommerce-wix.md" }
+  ]
+}

package/skills/wix-replatform/resources/rp-target-wix/domains/blog/entities/tag.json

@@ -0,0 +1,35 @@
+{
+  "schemaVersion": 1,
+  "domain": "blog",
+  "entity": "tag",
+  "displayName": "Blog Tag",
+  "target": {
+    "classification": "native",
+    "nativeEntity": "Blog Tag",
+    "verifiedFqdn": null,
+    "idPolicy": "server-assigned",
+    "crosswalkRequired": true
+  },
+  "sourceAliases": [
+    { "sourceSystem": "wordpress", "sourceEntity": "tag", "routes": ["/wp/v2/tags"], "confidence": "high" },
+    { "sourceSystem": "wix", "sourceEntity": "blogTag", "routes": ["Blog Tags"], "confidence": "high" }
+  ],
+  "preferredWrite": {
+    "surface": "Blog Tags",
+    "endpoint": "POST /blog/v3/tags",
+    "writerId": "createBlogTag",
+    "verification": "verified-live",
+    "importSafe": true,
+    "bulk": false
+  },
+  "fallbacks": [],
+  "reliability": { "status": "reliable", "flags": [] },
+  "pitfalls": [
+    { "code": "slug-derived", "severity": "warning", "summary": "Blog tag slug is derived; dedupe by label/language." }
+  ],
+  "mappingGuidance": ["Create tags before posts and crosswalk created or existing tag IDs."],
+  "setupRequirements": ["Wix Blog app"],
+  "evidence": [
+    { "type": "repo-research", "path": "research/import-api-suitability/blog-cms-media.md" }
+  ]
+}

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

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": 1,
+  "domain": "cms",
+  "displayName": "Wix CMS",
+  "ownerHint": "CMS/Data collections, items, references, permissions, and indexes domain owners",
+  "wixAppsRequired": ["Wix Data"],
+  "defaultImportOrder": ["collection", "data-item", "reference"],
+  "evidence": [
+    {
+      "type": "repo-research",
+      "path": "research/import-api-suitability/blog-cms-media.md"
+    }
+  ]
+}

package/skills/wix-replatform/resources/rp-target-wix/domains/cms/entities/collection.json

@@ -0,0 +1,35 @@
+{
+  "schemaVersion": 1,
+  "domain": "cms",
+  "entity": "collection",
+  "displayName": "CMS Collection",
+  "target": {
+    "classification": "setup-config",
+    "nativeEntity": "Wix Data Collection",
+    "verifiedFqdn": null,
+    "idPolicy": "client-assigned",
+    "crosswalkRequired": false
+  },
+  "sourceAliases": [
+    { "sourceSystem": "wordpress", "sourceEntity": "custom_post_type", "routes": ["/wp/v2/{type}"], "confidence": "medium" },
+    { "sourceSystem": "wix", "sourceEntity": "cmsCollection", "routes": ["Wix Data Collections"], "confidence": "high" }
+  ],
+  "preferredWrite": {
+    "surface": "Wix Data Collections",
+    "endpoint": null,
+    "writerId": null,
+    "verification": "unverified",
+    "importSafe": true,
+    "bulk": false
+  },
+  "fallbacks": [],
+  "reliability": { "status": "partially-reliable", "flags": [] },
+  "pitfalls": [
+    { "code": "setup-before-items", "severity": "blocker", "summary": "Collections, fields, permissions, and indexes must be represented in setup before item import." }
+  ],
+  "mappingGuidance": ["Use CMS collections for custom content models and native gaps where data should remain queryable."],
+  "setupRequirements": ["Wix Data enabled", "Collection schema and permissions plan"],
+  "evidence": [
+    { "type": "repo-research", "path": "research/import-api-suitability/blog-cms-media.md" }
+  ]
+}

package/skills/wix-replatform/resources/rp-target-wix/domains/cms/entities/data-item.json

@@ -0,0 +1,36 @@
+{
+  "schemaVersion": 1,
+  "domain": "cms",
+  "entity": "data-item",
+  "displayName": "CMS Data Item",
+  "target": {
+    "classification": "cms",
+    "nativeEntity": "Wix Data Item",
+    "verifiedFqdn": "wix.data.v2.data_item",
+    "idPolicy": "client-assigned",
+    "crosswalkRequired": false
+  },
+  "sourceAliases": [
+    { "sourceSystem": "wordpress", "sourceEntity": "custom_post_type_item", "routes": ["/wp/v2/{type}"], "confidence": "medium" },
+    { "sourceSystem": "wix", "sourceEntity": "cmsDataItem", "routes": ["Wix Data Items"], "confidence": "high" }
+  ],
+  "preferredWrite": {
+    "surface": "Wix Data Items",
+    "endpoint": "POST /wix-data/v2/items",
+    "writerId": "insertDataItem",
+    "verification": "verified-live",
+    "importSafe": true,
+    "bulk": false
+  },
+  "fallbacks": [],
+  "reliability": { "status": "reliable", "flags": [] },
+  "pitfalls": [
+    { "code": "readonly-dates", "severity": "warning", "summary": "_createdDate and _updatedDate are read-only; preserve source dates in explicit fields." },
+    { "code": "bulk-save-replaces", "severity": "warning", "summary": "Bulk Save replaces complete items, so generated records must include all fields." }
+  ],
+  "mappingGuidance": ["Use client-supplied IDs where possible for recoverable CMS imports."],
+  "setupRequirements": ["Wix Data enabled", "Target collection exists before item writes."],
+  "evidence": [
+    { "type": "repo-research", "path": "research/import-api-suitability/blog-cms-media.md" }
+  ]
+}

package/skills/wix-replatform/resources/rp-target-wix/domains/cms/entities/reference.json

@@ -0,0 +1,35 @@
+{
+  "schemaVersion": 1,
+  "domain": "cms",
+  "entity": "reference",
+  "displayName": "CMS Reference",
+  "target": {
+    "classification": "cms",
+    "nativeEntity": "Wix Data Reference",
+    "verifiedFqdn": null,
+    "idPolicy": "client-assigned",
+    "crosswalkRequired": false
+  },
+  "sourceAliases": [
+    { "sourceSystem": "wordpress", "sourceEntity": "relationship", "routes": ["post meta", "term relationships"], "confidence": "medium" },
+    { "sourceSystem": "wix", "sourceEntity": "cmsReference", "routes": ["Wix Data reference fields"], "confidence": "high" }
+  ],
+  "preferredWrite": {
+    "surface": "Wix Data Items",
+    "endpoint": "POST /wix-data/v2/items",
+    "writerId": "insertDataItem",
+    "verification": "verified-live",
+    "importSafe": true,
+    "bulk": false
+  },
+  "fallbacks": [],
+  "reliability": { "status": "reliable", "flags": [] },
+  "pitfalls": [
+    { "code": "second-pass", "severity": "blocker", "summary": "References and multi-references often require a second pass after target IDs are known." }
+  ],
+  "mappingGuidance": ["Resolve crosswalks before writing reference fields."],
+  "setupRequirements": ["Reference fields declared in target collection schema."],
+  "evidence": [
+    { "type": "repo-research", "path": "research/import-api-suitability/blog-cms-media.md" }
+  ]
+}

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

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": 1,
+  "domain": "crm",
+  "displayName": "Wix CRM",
+  "ownerHint": "Contacts, labels, extended fields, and subscription-consent domain owners",
+  "defaultImportOrder": ["label", "contact", "email-subscription"],
+  "sideEffectNotes": ["Contact creation and subscription updates can trigger automations."],
+  "evidence": [
+    {
+      "type": "repo-research",
+      "path": "research/import-api-suitability/orders-contacts-members.md"
+    }
+  ]
+}