npm - @wix/agent-skills - Versions diffs - 1.36.0 → 1.36.1 - Mend

@wix/agent-skills 1.36.0 → 1.36.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (776) hide show

package/skills/wix-replatform/resources/rp-target-wix/domains/media/docs-survey.json DELETED Viewed

@@ -1,41 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "media",
-  "fetchedAt": "2026-08-11",
-  "roots": [
-    "api-reference/assets/media"
-  ],
-  "surfaces": [
-    {
-      "id": "api-reference/assets/media/media-manager/files",
-      "title": "Files",
-      "url": "https://dev.wix.com/docs/api-reference/assets/media/media-manager/files",
-      "group": "Media Manager",
-      "verdict": "claimed",
-      "refs": [
-        "media/media-file"
-      ],
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/assets/media/media-manager/folders",
-      "title": "Folders",
-      "url": "https://dev.wix.com/docs/api-reference/assets/media/media-manager/folders",
-      "group": "Media Manager",
-      "verdict": "claimed",
-      "refs": [
-        "media/media-folder"
-      ],
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/assets/media/skills",
-      "title": "Skills",
-      "url": "https://dev.wix.com/docs/api-reference/assets/media/skills",
-      "group": null,
-      "verdict": "not-relevant",
-      "reason": "AI-skill documentation page, not a data surface.",
-      "reviewedOn": "2026-08-11"
-    }
-  ]
-}

package/skills/wix-replatform/resources/rp-target-wix/domains/media/domain.json DELETED Viewed

@@ -1,24 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "media",
-  "dependsOnRequired": true,
-  "docsRoots": [
-    "api-reference/assets/media"
-  ],
-  "displayName": "Wix Media Manager",
-  "ownerHint": "Media Manager import, upload, folders, and metadata domain owners",
-  "defaultImportOrder": [
-    "media-folder",
-    "media-file"
-  ],
-  "rateLimitNotes": [
-    "Prefer referenced media by default; full-library imports are opt-in."
-  ],
-  "evidence": [
-    {
-      "type": "domain-kb",
-      "path": "skills/wix-replatform/resources/rp-target-wix/domains/media/entities/media-file.json",
-      "note": "per-field import-suitability rationale and evidence for this domain live on the entity files (media-folder, media-file)"
-    }
-  ]
-}

package/skills/wix-replatform/resources/rp-target-wix/domains/media/entities/media-file.json DELETED Viewed

@@ -1,75 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "media",
-  "entity": "media-file",
-  "displayName": "Media File",
-  "capability": "media.file",
-  "target": {
-    "classification": "native-plus-cms",
-    "nativeEntity": "Media Manager File",
-    "verifiedFqdn": null,
-    "idPolicy": "server-assigned",
-    "crosswalkRequired": true
-  },
-  "dependsOn": [],
-  "sourceAliases": [
-    {
-      "sourceSystem": "wordpress",
-      "sourceEntity": "attachment",
-      "routes": [
-        "/wp/v2/media"
-      ],
-      "confidence": "high"
-    },
-    {
-      "sourceSystem": "wix",
-      "sourceEntity": "mediaFile",
-      "routes": [
-        "Media Manager"
-      ],
-      "confidence": "high"
-    }
-  ],
-  "preferredWrite": {
-    "surface": "Media Manager Import",
-    "endpoint": "POST /site-media/v1/files/import",
-    "writerId": "importMedia",
-    "verification": "verified-live",
-    "importSafe": true,
-    "bulk": false
-  },
-  "fallbacks": [
-    {
-      "classification": "cms",
-      "when": "Use for attachment parent, captions, external source IDs, or metadata not represented by Media Manager."
-    }
-  ],
-  "reliability": {
-    "status": "partially-reliable",
-    "flags": []
-  },
-  "pitfalls": [
-    {
-      "code": "async-ready",
-      "severity": "blocker",
-      "summary": "Media import is asynchronous; poll until READY before referencing the file."
-    },
-    {
-      "code": "source-url-access",
-      "severity": "warning",
-      "summary": "Remote source URLs may expire or block hotlinking."
-    }
-  ],
-  "mappingGuidance": [
-    "Import referenced media by default; treat full-library import as explicit opt-in."
-  ],
-  "setupRequirements": [],
-  "evidence": [
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/assets/media/media-manager/files/file-descriptor-object",
-      "note": "object page (docs-survey sweep 2026-08-11)"
-    }
-  ]
-}

package/skills/wix-replatform/resources/rp-target-wix/domains/media/entities/media-folder.json DELETED Viewed

@@ -1,71 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "media",
-  "entity": "media-folder",
-  "displayName": "Media Folder",
-  "capability": "media.folder",
-  "target": {
-    "classification": "native-plus-cms",
-    "nativeEntity": "Media Manager Folder",
-    "verifiedFqdn": null,
-    "idPolicy": "server-assigned",
-    "crosswalkRequired": true
-  },
-  "sourceAliases": [
-    {
-      "sourceSystem": "wordpress",
-      "sourceEntity": "media_folder",
-      "routes": [
-        "plugin-specific media folder routes"
-      ],
-      "confidence": "low"
-    },
-    {
-      "sourceSystem": "wix",
-      "sourceEntity": "mediaFolder",
-      "routes": [
-        "Media Manager folders"
-      ],
-      "confidence": "high"
-    }
-  ],
-  "dependsOn": [],
-  "preferredWrite": {
-    "surface": "Media Manager Folders",
-    "endpoint": null,
-    "writerId": null,
-    "verification": "unverified",
-    "importSafe": true,
-    "bulk": false
-  },
-  "fallbacks": [
-    {
-      "classification": "cms",
-      "when": "Use for source folder hierarchy if native folder creation is not in scope."
-    }
-  ],
-  "reliability": {
-    "status": "partially-reliable",
-    "flags": []
-  },
-  "pitfalls": [
-    {
-      "code": "folder-writer-unverified",
-      "severity": "warning",
-      "summary": "Do not require folder creation for media file preservation unless verified for the project."
-    }
-  ],
-  "mappingGuidance": [
-    "Dependencies: no other modeled record must exist first; a Media Manager folder is a standalone container.",
-    "Preserve folders as metadata when only file import is required."
-  ],
-  "setupRequirements": [],
-  "evidence": [
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/assets/media/media-manager/folders/folder-object",
-      "note": "object page (docs-survey sweep 2026-08-11)"
-    }
-  ]
-}

package/skills/wix-replatform/resources/rp-target-wix/domains/members/docs-survey.json DELETED Viewed

@@ -1,119 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "members",
-  "fetchedAt": "2026-08-11",
-  "roots": [
-    "api-reference/crm/members-contacts/members"
-  ],
-  "surfaces": [
-    {
-      "id": "api-reference/crm/members-contacts/members/activity/activity-counters",
-      "title": "Activity Counters",
-      "url": "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/activity/activity-counters",
-      "group": "Activity",
-      "verdict": "not-relevant",
-      "reason": "Member activity counters; WordPress has no equivalent member metric to carry.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/crm/members-contacts/members/activity/badge-assignments",
-      "title": "Badge Assignments",
-      "url": "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/activity/badge-assignments",
-      "group": "Activity",
-      "verdict": "claimed",
-      "refs": [
-        "members/badge"
-      ],
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/crm/members-contacts/members/activity/badges-v4",
-      "title": "Badges V4",
-      "url": "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/activity/badges-v4",
-      "group": "Activity",
-      "verdict": "claimed",
-      "refs": [
-        "members/badge"
-      ],
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/crm/members-contacts/members/activity/member-reports",
-      "title": "Member Reports",
-      "url": "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/activity/member-reports",
-      "group": "Activity",
-      "verdict": "not-relevant",
-      "reason": "Reporting/export utility, not a write surface.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/crm/members-contacts/members/activity/members-followers",
-      "title": "Members Followers",
-      "url": "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/activity/members-followers",
-      "group": "Activity",
-      "verdict": "not-relevant",
-      "reason": "Member follower graph; WordPress has no equivalent social graph.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/crm/members-contacts/members/member-management/custom-fields",
-      "title": "Custom Fields",
-      "url": "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/custom-fields",
-      "group": "Member Management",
-      "verdict": "claimed",
-      "reviewedOn": "2026-08-11",
-      "refs": [
-        "members/custom-field"
-      ]
-    },
-    {
-      "id": "api-reference/crm/members-contacts/members/member-management/member-authentication",
-      "title": "Member Authentication",
-      "url": "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/member-authentication",
-      "group": "Member Management",
-      "verdict": "not-importable",
-      "reason": "Credentials are never migrated (no password import path and none wanted); member activation is the post-import forgot-password flow.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/crm/members-contacts/members/member-management/members",
-      "title": "Members",
-      "url": "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/members",
-      "group": "Member Management",
-      "verdict": "claimed",
-      "refs": [
-        "members/member"
-      ],
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/crm/members-contacts/members/member-management/members-about-v2",
-      "title": "Members About V2",
-      "url": "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/members-about-v2",
-      "group": "Member Management",
-      "verdict": "claimed",
-      "reviewedOn": "2026-08-11",
-      "refs": [
-        "members/member-about"
-      ]
-    },
-    {
-      "id": "api-reference/crm/members-contacts/members/member-management/privacy",
-      "title": "Privacy",
-      "url": "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/privacy",
-      "group": "Member Management",
-      "verdict": "not-relevant",
-      "reason": "Member profile-privacy settings; runtime member choice, no source equivalent.",
-      "reviewedOn": "2026-08-11"
-    },
-    {
-      "id": "api-reference/crm/members-contacts/members/member-management/user-member",
-      "title": "User Member",
-      "url": "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/user-member",
-      "group": "Member Management",
-      "verdict": "not-relevant",
-      "reason": "Current-session member API (runtime), not a data target.",
-      "reviewedOn": "2026-08-11"
-    }
-  ]
-}

package/skills/wix-replatform/resources/rp-target-wix/domains/members/domain.json DELETED Viewed

@@ -1,23 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "members",
-  "dependsOnRequired": true,
-  "docsRoots": [
-    "api-reference/crm/members-contacts/members"
-  ],
-  "displayName": "Wix Members",
-  "ownerHint": "Members identity, profile, roles, and badges domain owners",
-  "defaultImportOrder": [
-    "custom-field",
-    "member",
-    "member-about",
-    "badge"
-  ],
-  "evidence": [
-    {
-      "type": "domain-kb",
-      "path": "skills/wix-replatform/resources/rp-target-wix/domains/members/entities/member.json",
-      "note": "per-field import-suitability rationale and evidence for this domain live on the entity files (custom-field, member, member-about, badge)"
-    }
-  ]
-}

package/skills/wix-replatform/resources/rp-target-wix/domains/members/entities/badge.json DELETED Viewed

@@ -1,71 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "members",
-  "entity": "badge",
-  "displayName": "Member Badge",
-  "capability": "identity.member-badge",
-  "target": {
-    "classification": "native-plus-cms",
-    "nativeEntity": "Member Badge",
-    "verifiedFqdn": null,
-    "idPolicy": "server-assigned",
-    "crosswalkRequired": true
-  },
-  "sourceAliases": [
-    {
-      "sourceSystem": "wordpress",
-      "sourceEntity": "user_badge",
-      "routes": [
-        "plugin-specific member badge routes"
-      ],
-      "confidence": "medium"
-    },
-    {
-      "sourceSystem": "wix",
-      "sourceEntity": "memberBadge",
-      "routes": [
-        "Members Badges APIs"
-      ],
-      "confidence": "high"
-    }
-  ],
-  "dependsOn": [],
-  "preferredWrite": {
-    "surface": "Members Badges",
-    "endpoint": null,
-    "writerId": null,
-    "verification": "unverified",
-    "importSafe": true,
-    "bulk": false
-  },
-  "fallbacks": [
-    {
-      "classification": "cms",
-      "when": "Use when badge APIs or source badge semantics are not verified."
-    }
-  ],
-  "reliability": {
-    "status": "partially-reliable",
-    "flags": []
-  },
-  "pitfalls": [
-    {
-      "code": "subsurface-verification",
-      "severity": "warning",
-      "summary": "Verify badge creation and assignment surfaces before native execution."
-    }
-  ],
-  "mappingGuidance": [
-    "Dependencies: no other modeled record must exist first; this has no verified native writer and membership is preserved separately when needed.",
-    "Preserve source badge membership as CMS when native assignment is not verified."
-  ],
-  "setupRequirements": [],
-  "evidence": [
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/activity/badges-v4/badge-object",
-      "note": "object page (docs-survey sweep 2026-08-11)"
-    }
-  ]
-}

package/skills/wix-replatform/resources/rp-target-wix/domains/members/entities/custom-field.json DELETED Viewed

@@ -1,82 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "members",
-  "entity": "custom-field",
-  "displayName": "Member Custom Field",
-  "capability": "identity.member-custom-fields",
-  "target": {
-    "classification": "setup-config",
-    "nativeEntity": "Members Custom Field",
-    "verifiedFqdn": null,
-    "idPolicy": "server-assigned",
-    "crosswalkRequired": true
-  },
-  "sourceAliases": [],
-  "dependsOn": [],
-  "preferredWrite": {
-    "surface": "Members Custom Fields",
-    "endpoint": "POST /members/v1/custom-fields",
-    "writerId": null,
-    "verification": "verified-live",
-    "importSafe": true,
-    "bulk": false,
-    "decision": "Two-step: (1) define the field with { field: { name, fieldType, defaultPrivacy } } and capture the SERVER-ASSIGNED key from the response; (2) write per-member values with PATCH /members/v1/members/{memberId} { member: { contact: { customFields: { \"<key>\": { value } } } } }. Delete needs the revision as a query param: DELETE /members/v1/custom-fields/{id}?revision=<n>."
-  },
-  "reliability": {
-    "status": "reliable",
-    "flags": []
-  },
-  "pitfalls": [
-    {
-      "code": "definitions-then-values",
-      "severity": "warning",
-      "summary": "This surface defines the profile field (name, fieldType, defaultPrivacy); per-member values are written on the member profile. Import definitions before members or the value writes have no field to land in."
-    },
-    {
-      "code": "meta-key-selection",
-      "severity": "warning",
-      "summary": "WordPress user_meta is a mixed bag of plugin bookkeeping and real profile data; import only keys the mapping review approves, or the member profile schema fills with junk fields."
-    },
-    {
-      "code": "key-is-server-assigned",
-      "severity": "blocker",
-      "summary": "CORRECTED 2026-08-16 (live): `key` is READ-ONLY and server-derived — creating a field named \"ZZZ Probe WP Meta\" returned key `custom.zzz-probe-wp-meta-iveokecsuhrarwyqq` (slugified name + random suffix). You cannot set the source meta key as the Wix key, and you cannot reconstruct it. Capture `field.key` from the create response into the crosswalk; every value write addresses that key. A codegen path that derives the key from the source meta key writes into a field that does not exist."
-    },
-    {
-      "code": "value-write-is-a-member-patch",
-      "severity": "warning",
-      "summary": "VERIFIED LIVE 2026-08-16: values land at member.contact.customFields[key].value via PATCH /members/v1/members/{id} — not on this surface, and not under member.profile. The patch succeeded with no revision field on the member payload; the readback returns { name, value } per key."
-    },
-    {
-      "code": "delete-requires-revision-query-param",
-      "severity": "warning",
-      "summary": "VERIFIED LIVE 2026-08-16: DELETE /members/v1/custom-fields/{id} with no query string → 400 `revision must not be empty`. Pass the current revision as a query param (`?revision=1`) — rollback/cleanup code must read the field first."
-    }
-  ],
-  "mappingGuidance": [
-    "Dependencies: no other modeled record must exist first; custom-field definitions are standalone setup records, although member values consume their server-assigned keys later.",
-    "Create one custom field per approved source user_meta key: human label → name, inferred type → fieldType (TEXT | NUMBER | DATE | URL | SOCIAL), defaultPrivacy PUBLIC | PRIVATE.",
-    "Record the SERVER-ASSIGNED field key from the create response in the crosswalk (source meta key → Wix `field.key`); the member import addresses values by that key, never by the source key.",
-    "SOCIAL fields additionally require socialType (FACEBOOK, INSTAGRAM, LINKEDIN, TWITTER, YOUTUBE, PINTEREST, TIKTOK, DEVIANTART, SOUNDCLOUD, TUMBLR, VIMEO, VKONTAKTE, ODNOKLASSNIKI, OTHER)."
-  ],
-  "setupRequirements": [
-    "Wix Members Area app"
-  ],
-  "evidence": [
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/custom-fields/custom-fields/custom-field-object",
-      "note": "object page: key (read-only), name, fieldType, defaultPrivacy, appliesTo"
-    },
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/custom-fields/custom-fields/create-custom-field"
-    },
-    {
-      "type": "live-run",
-      "path": "anonymized-live-verification",
-      "note": "Verified live: create → 200 (id <anonymized-id>, server key custom.zzz-probe-wp-meta-iveokecsuhrarwyqq, fieldOrigin CUSTOM, appliesTo ALL_MEMBERS, section GENERAL); value set on a probe member via member PATCH and read back; DELETE without revision → 400, DELETE ?revision=1 → 200; list-custom-fields empty afterwards"
-    }
-  ],
-  "notes": "Authored 2026-08-11 from the docs-survey gap (member Custom Fields). Classified setup-config: it defines profile schema (the member-side analog of contact extended fields); per-member values ride on members/member. Promoted to verified-live 2026-08-16; the probe corrected the original mappingGuidance claim that the source meta key becomes the Wix field key — the key is server-assigned."
-}

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

@@ -1,77 +0,0 @@
-{
-  "schemaVersion": 1,
-  "domain": "members",
-  "entity": "member-about",
-  "displayName": "Member About",
-  "capability": "identity.member-about",
-  "target": {
-    "classification": "native",
-    "nativeEntity": "Members About",
-    "verifiedFqdn": null,
-    "idPolicy": "server-assigned",
-    "crosswalkRequired": true
-  },
-  "sourceAliases": [],
-  "dependsOn": ["members/member"],
-  "preferredWrite": {
-    "surface": "Members About V2",
-    "endpoint": "POST /members/v2/abouts",
-    "writerId": null,
-    "verification": "verified-live",
-    "importSafe": true,
-    "bulk": false,
-    "decision": "Create with { memberAbout: { memberId, content: { nodes: [...] } } }; content is a Ricos RichContent node tree. One About per member (unique constraint on memberId), so the import path is upsert: query by memberId, PATCH the existing About with its revision, otherwise create."
-  },
-  "reliability": {
-    "status": "reliable",
-    "flags": []
-  },
-  "pitfalls": [
-    {
-      "code": "rich-content-wrapping",
-      "severity": "warning",
-      "summary": "content is Ricos RichContent (node tree), not plain text; a WordPress user description must be wrapped as paragraph nodes. Malformed node trees fail the write. Verified-live minimal shape: { nodes: [ { type: 'PARAGRAPH', id: 'p1', paragraphData: {}, nodes: [ { type: 'TEXT', id: '', nodes: [], textData: { text, decorations: [] } } ] } ] }."
-    },
-    {
-      "code": "member-must-exist",
-      "severity": "blocker",
-      "summary": "Keyed by memberId — the member import must complete and the crosswalk resolve before abouts are written."
-    },
-    {
-      "code": "one-about-per-member",
-      "severity": "warning",
-      "summary": "VERIFIED LIVE 2026-08-16: a second create for the same memberId returns 409 ALREADY_EXISTS (uniqueConstraintViolation on memberId). A resumed/retried import must upsert — POST /members/v2/abouts/query { query: { filter: { memberId } } }, then PATCH /members/v2/abouts/{id} with { memberAbout: { id, revision, memberId, content } } (revision required; returns revision+1)."
-    },
-    {
-      "code": "about-outlives-member",
-      "severity": "warning",
-      "summary": "VERIFIED LIVE 2026-08-16: DELETE /members/v1/members/{id} does NOT delete that member's About — the record is still returned by the abouts query afterwards. Probe/rollback cleanup must delete the About explicitly (DELETE /members/v2/abouts/{id}), and a re-import onto a cleaned site can collide with an orphan About."
-    }
-  ],
-  "mappingGuidance": [
-    "Dependencies: members/member is required because memberAbout.memberId is the created member's crosswalked ID.",
-    "Import after members/member: resolve memberId from the crosswalk, wrap the source bio (WP user description) in a minimal RichContent paragraph tree.",
-    "Skip empty bios rather than writing empty abouts.",
-    "Use upsert semantics (query by memberId → PATCH with revision, else POST) so re-runs don't 409."
-  ],
-  "setupRequirements": [
-    "Wix Members Area app"
-  ],
-  "evidence": [
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/members-about-v2/member-about-object",
-      "note": "object page: memberId + RichContent content"
-    },
-    {
-      "type": "wix-docs",
-      "url": "https://dev.wix.com/docs/api-reference/crm/members-contacts/members/member-management/members-about-v2/create-member-about"
-    },
-    {
-      "type": "live-run",
-      "path": "anonymized-live-verification",
-      "note": "Verified live: create → 200 (about <anonymized-id>, revision 1) on a probe member; GET by id and query-by-memberId both read the content back; PATCH with revision → 200 revision 2; duplicate create → 409 ALREADY_EXISTS; probe member + orphan About deleted"
-    }
-  ],
-  "notes": "Authored 2026-08-11 from the docs-survey gap (Members About V2). WordPress core user description maps here; not covered by the members/member basic-profile import. Promoted to verified-live 2026-08-16 by a create/read/update/delete probe on an anonymized verification environment — one-About-per-member and About-outlives-member were discovered by that probe."
-}