{
  "schemaVersion": 1,
  "domain": "cms",
  "entity": "reference",
  "displayName": "CMS Reference",
  "capability": "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": "domain-kb",
      "path": "skills/wix-replatform/resources/rp-target-wix/domains/cms/domain.json",
      "note": "domain-level evidence and cross-entity notes for CMS collections/data-items/references"
    }
  ]
}