{"standard_version":"1.0","title":"Product decision record","max_profile_bytes":5120,"required_profile_field":"commerce_profile","profile_schema":{"type":"object","additionalProperties":false,"properties":{"version":{"type":"string","const":"1.0"},"variant_status":{"type":"string","enum":["unknown","specified","not_applicable"]},"description":{"type":["object","null"],"additionalProperties":false,"properties":{"text":{"type":"string","maxLength":600},"source_id":{"type":"string","maxLength":32,"pattern":"^[a-z][a-z0-9_-]{0,31}$"}},"required":["text","source_id"]},"identity":{"type":"object","additionalProperties":false,"properties":{"gtin":{"type":["string","null"],"maxLength":14,"pattern":"^(?:[0-9]{8}|[0-9]{12,14})$"},"mpn":{"type":["string","null"],"maxLength":120},"merchant_sku":{"type":["string","null"],"maxLength":120},"source_id":{"type":["string","null"],"maxLength":32,"pattern":"^[a-z][a-z0-9_-]{0,31}$"},"catalog_product_id":{"type":["string","null"],"maxLength":120,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,119}$"},"catalog_variant_id":{"type":["string","null"],"maxLength":120,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,119}$"}},"required":["gtin","mpn","merchant_sku","source_id"]},"sources":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","maxLength":32,"pattern":"^[a-z][a-z0-9_-]{0,31}$"},"url":{"type":"string","maxLength":1024,"format":"uri"},"observed_at":{"type":"string","maxLength":24,"format":"date-time"},"scope":{"type":"string","enum":["product","variant","offer","policy","license"]},"method":{"type":"string","enum":["official_page","merchant_feed","merchant_confirmation"]}},"required":["id","url","observed_at","scope","method"]},"maxItems":6},"facts":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","maxLength":64},"value":{"type":"string","maxLength":240},"unit":{"type":["string","null"],"maxLength":32},"source_id":{"type":"string","maxLength":32,"pattern":"^[a-z][a-z0-9_-]{0,31}$"}},"required":["name","value","unit","source_id"]},"maxItems":8},"image_qa":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["pending","approved"]},"composition":{"type":"string","enum":["unknown","single_product","multipack","group"]},"geometry":{"type":"string","enum":["unknown","pass"]},"fidelity":{"type":"string","enum":["unknown","pass"]},"reviewed_at":{"type":["string","null"],"maxLength":24,"format":"date-time"},"source_id":{"type":["string","null"],"maxLength":32,"pattern":"^[a-z][a-z0-9_-]{0,31}$"},"reviewed_image_sha256":{"type":["string","null"],"maxLength":64,"pattern":"^[a-f0-9]{64}$"}},"required":["status","composition","geometry","fidelity","reviewed_at","source_id"]},"offer":{"type":["object","null"],"additionalProperties":false,"properties":{"seller_name":{"type":"string","maxLength":120},"url":{"type":"string","maxLength":1024,"format":"uri"},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"]},"availability":{"type":"string","enum":["in_stock","out_of_stock","preorder","backorder","unknown"]},"region":{"type":["string","null"],"maxLength":2,"pattern":"^[A-Z]{2}$"},"source_id":{"type":"string","maxLength":32,"pattern":"^[a-z][a-z0-9_-]{0,31}$"},"observed_at":{"type":"string","maxLength":24,"format":"date-time"},"expires_at":{"type":"string","maxLength":24,"format":"date-time"},"shipping":{"type":["object","null"],"additionalProperties":false,"properties":{"text":{"type":"string","maxLength":240},"url":{"type":"string","maxLength":1024,"format":"uri"},"source_id":{"type":"string","maxLength":32,"pattern":"^[a-z][a-z0-9_-]{0,31}$"}},"required":["text","url","source_id"]},"returns":{"type":["object","null"],"additionalProperties":false,"properties":{"text":{"type":"string","maxLength":240},"url":{"type":"string","maxLength":1024,"format":"uri"},"source_id":{"type":"string","maxLength":32,"pattern":"^[a-z][a-z0-9_-]{0,31}$"}},"required":["text","url","source_id"]},"purchase_unit":{"type":["object","null"],"additionalProperties":false,"properties":{"label":{"type":"string","maxLength":120},"unit_count":{"type":"integer","minimum":1,"maximum":1000},"unit_name":{"type":"string","maxLength":40},"unit_size":{"type":["string","null"],"maxLength":80},"merchant_variant_id":{"type":["string","null"],"maxLength":120,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,119}$"},"merchant_sku":{"type":["string","null"],"maxLength":120},"gtin":{"type":["string","null"],"maxLength":14,"pattern":"^(?:[0-9]{8}|[0-9]{12,14})$"}},"required":["label","unit_count","unit_name","unit_size","merchant_variant_id","merchant_sku","gtin"]}},"required":["seller_name","url","price","availability","region","source_id","observed_at","expires_at","shipping","returns"]},"rights":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["unknown","documented"]},"license_url":{"type":["string","null"],"maxLength":1024,"format":"uri"},"source_id":{"type":["string","null"],"maxLength":32,"pattern":"^[a-z][a-z0-9_-]{0,31}$"}},"required":["status","license_url","source_id"]},"caveats":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"field":{"type":"string","maxLength":64},"text":{"type":"string","maxLength":240},"source_ids":{"type":"array","items":{"type":"string","maxLength":32,"pattern":"^[a-z][a-z0-9_-]{0,31}$"},"maxItems":3,"minItems":1,"uniqueItems":true}},"required":["field","text","source_ids"]},"maxItems":4}},"required":["version","variant_status","description","identity","sources","facts","image_qa","offer","rights"]},"stages":[{"id":"image_record","requires":["Published catalog image","Explicit evidence and readiness gaps"]},{"id":"decision_ready","requires":["Resolved product/variant evidence","Hash-matched official source review","Sourced description and at least one fact","Approved single-product geometry and fidelity review","Reviewed SHA-256 matches the effective published PNG"]},{"id":"offer_ready","requires":["Decision-ready record","Current declared seller offer window","In-stock observation","Documented shipping and returns"]},{"id":"checkout_ready","requires":["Not implemented","Authorized checkout integration","Authoritative totals, confirmation and order state"]}],"rules":["A structurally valid submission is not independently verified. Preserve source scope, observation time and unknown values. Optional caveats record source-attributed limitations or conflicts; they never establish source review or resolve a disputed fact.","Future observations, unsupported claims of readiness, private URLs and undocumented identifiers are rejected.","New image ingestion requires commerce_profile version 1.0. Legacy records are mapped without inventing missing evidence.","Decision readiness requires a catalog source review with sufficient identity scope, resolved variant, description and facts from the canonical reviewed product URL or a trusted supplemental product review matching URL and observation time, and approved single-product image QA against the identity source. reviewed_image_sha256 must match the effective published PNG digest; original approval cannot cover replacement pixels.","Offer readiness additionally requires identical seller offer and source URLs matching the canonical reviewed product URL or a trusted supplemental offer review with the exact URL and observation time, in_stock observation, shipping and return policy evidence, and an unexpired observation window no longer than 24 hours.","Prices and currencies are source-attributed submissions. Currency validation checks three-letter formatting, not independent ISO membership or price accuracy.","When purchase_unit is documented, offer.price is the total price for that complete purchase unit, not a per-item price. The offer source must support its quantity and merchant identifiers. Purchase-unit labels and identifiers do not identify or certify the pictured product, variant, or image composition. Missing purchase-unit information remains unknown.","Offer freshness is a declared observation window, never a live stock or price check. An expired recorded offer remains visible with its timestamp and cannot be purchase-ready.","Authorized evidence revisions can replace a current profile without replacing its image. Revisions are bound to the image digest, retain history, and require conflict-safe publication.","Catalog product and variant IDs may be supplied to survive new image revisions. They do not establish a cross-merchant match or a global product identifier.","License documentation does not itself verify a legal grant. Checkout remains unavailable until an authorized integration supplies authoritative totals and order state.","No search ranking, AI recommendation, external shopping-feed acceptance or marketplace certification is implied."]}