{
  "schemaVersion": "0.1",
  "purpose": "Canonical format for adding products from affiliate networks, merchant APIs, curated links, or parallel signup threads into AI Native Commerce.",
  "ingestionTarget": "https://bargar.art/ai/catalog",
  "writePath": "Currently code-backed. Add reviewed products to CATALOG and, when needed, SOURCES in worker/index.js; API-backed writes can be added after authentication/storage policy is settled.",
  "requiredProductFields": [
    "id",
    "sourceId",
    "sourceProductId",
    "name",
    "type",
    "status",
    "vendor",
    "sourceUrl",
    "currency",
    "priceAuthority",
    "availabilityAuthority"
  ],
  "recommendedProductFields": [
    "artist",
    "brand",
    "affiliateUrl",
    "affiliateNetwork",
    "affiliateStatus",
    "collectionUrl",
    "imageUrl",
    "imageAlt",
    "price",
    "lastObservedPrice",
    "estimatedShipping",
    "tags",
    "bestFor",
    "avoidIf",
    "humanVisibleSummary",
    "agentNotes",
    "verificationStatus",
    "verifiedAt"
  ],
  "affiliateRules": [
    "Use affiliateUrl only when it is a real network-generated tracking URL or approved programmatic wrapper.",
    "If a network signup is pending, leave affiliateUrl null and set affiliateStatus to not_configured or pending_network_approval.",
    "Do not double-wrap links. Prefer direct FlexOffers links for advertisers explicitly approved there; otherwise use Sovrn only after Sovrn approval is confirmed.",
    "Always preserve sourceUrl as the authoritative merchant product page."
  ],
  "productTemplate": {
    "id": "merchant-slug-product-slug",
    "sourceId": "merchant-or-network-source-id",
    "sourceProductId": "merchant product id, SKU, URL id, or feed id",
    "name": "Human-readable product name",
    "type": "physical_art_print | physical_apparel | physical_accessory | physical_home_good | digital_product | service",
    "status": "active",
    "vendor": "Merchant or marketplace",
    "artist": null,
    "brand": null,
    "sourceUrl": "https://merchant.example/product",
    "affiliateUrl": null,
    "affiliateNetwork": null,
    "affiliateStatus": "not_configured",
    "collectionUrl": null,
    "imageUrl": null,
    "imageAlt": "Concise image description",
    "price": null,
    "estimatedShipping": null,
    "currency": "USD",
    "priceAuthority": "Merchant product page or named API/feed",
    "availabilityAuthority": "Merchant product page or named API/feed",
    "tags": [
      "gift"
    ],
    "bestFor": [
      "buyer intent this product fits"
    ],
    "avoidIf": [
      "buyer condition where agent should not recommend it"
    ],
    "humanVisibleSummary": "One sentence product summary.",
    "agentNotes": [
      "Final price, taxes, shipping, returns, and availability must be confirmed at the merchant unless API-backed values are current."
    ]
  },
  "sourceTemplate": {
    "id": "merchant-or-network-source-id",
    "type": "affiliate_network_feed | merchant_api | external_marketplace_curated_products | external_marketplace_collection",
    "status": "pending_network_approval | active_seed_source | active_api_source",
    "merchantName": "Merchant or source name",
    "marketplace": null,
    "brand": null,
    "sourceUrl": "https://merchant-or-network.example",
    "ingestionMode": "curated_from_public_product_links | affiliate_feed | merchant_api",
    "priceMode": "source_authoritative | api_authoritative",
    "checkoutMode": "source_marketplace_checkout | api_created_checkout_handoff"
  }
}