{
  "schemaVersion": "1.0",
  "artifactType": "manual-review-cases",
  "edition": "2026-10-02",
  "exampleOnly": true,
  "canonicalUrl": "https://www.iamgeorgekelly.com/field-guide/sale-price-effective-date-behavior",
  "scope": "Eight fictional manual review cases. No executable validator, provider uploads, or observed provider results. These objects are internal review records and are not valid feed rows or inputs to the existing site checkers.",
  "destinationProfiles": {
    "google-merchant-center": {
      "label": "Google Merchant Center",
      "dateField": "sale_price_effective_date",
      "documentedRole": "Sale-price display interval",
      "sourceId": "google-sale-window"
    },
    "openai-stable-native": {
      "label": "OpenAI Stable native file upload",
      "dateField": null,
      "documentedRole": "Supply current sale state; uploaded dates do not schedule price changes",
      "sourceId": "openai-file-products"
    },
    "openai-google-compatible-confirmed": {
      "label": "OpenAI confirmed Google-compatible file upload",
      "dateField": "sale_price_effective_date",
      "documentedRole": "Accepted date metadata; does not schedule sale activation",
      "sourceId": "openai-file-products"
    }
  },
  "reviewPolicy": {
    "owner": "George Kelly",
    "method": "Read the selected destination contract, preserve the raw date, compare a frozen reference time with the stated promotion plan and supplied current-offer evidence, then record the next editorial action.",
    "states": {
      "review": "Inspect the recorded schedule and current offer before deciding on a release.",
      "update-needed": "Supplied current-sale evidence calls for a proposed current-price change; this does not authorize or perform a merchant update.",
      "hold": "Resolve the missing or contradictory evidence before preparing the affected mapping."
    },
    "holds": "Missing profile confirmation, unknown intended timezone, reversed intervals, absent current-sale evidence, and unresolved source conflicts remain manual holds under this author policy. A hold is not a provider rejection prediction.",
    "boundaries": "Cases do not evaluate exact transition instants. No boundary inclusivity, provider processing deadline, or display timing is inferred.",
    "nativeDateField": "For native cases the raw date belongs to the internal promotion plan. sale_price_effective_date is not documented as a native field; behavior of an unknown native field is not asserted.",
    "nulls": "Null in this internal format means unresolved or absent. Proposed feed omissions are expressed in the action text; this file is not a provider payload."
  },
  "cases": [
    {
      "id": "SW1",
      "label": "A future Google sale has a display interval",
      "fictional": true,
      "destinationProfile": "google-merchant-center",
      "profileConfirmationRecorded": null,
      "itemId": "EXAMPLE-MUG-BLUE",
      "market": "US",
      "currency": "USD",
      "rawSalePriceEffectiveDate": "2026-10-05T09:00-0400/2026-10-07T18:00-0400",
      "dateValueLocation": "Google candidate sale_price_effective_date",
      "explicitTimezone": "-0400",
      "asOf": "2026-10-02T12:00:00Z",
      "evidence": {
        "promotionPlanRef": "fictional:SW1-promotion-plan",
        "currentOfferRef": "fictional:SW1-current-offer",
        "capturedAt": "2026-10-02T12:00:00Z",
        "sourceContractIds": [
          "google-sale-window"
        ],
        "independentlyAuthenticated": false
      },
      "currentSaleState": {
        "active": false,
        "regularPrice": "100.00 USD",
        "currentSalePrice": null,
        "payableItemPrice": "100.00 USD"
      },
      "feedSnapshot": {
        "price": "100.00 USD",
        "sale_price": "80.00 USD"
      },
      "expectedEditorialReview": {
        "status": "review",
        "action": "retain-scheduled-interval-and-verify-offer",
        "reason": "Retain the future Google interval for this fictional scheduled promotion. Review the current regular offer now and the sale offer at the planned transition; this case does not observe provider display.",
        "providerResult": null
      }
    },
    {
      "id": "SW2",
      "label": "A Google sale is observed within its planned interval",
      "fictional": true,
      "destinationProfile": "google-merchant-center",
      "profileConfirmationRecorded": null,
      "itemId": "EXAMPLE-MUG-BLUE",
      "market": "US",
      "currency": "USD",
      "rawSalePriceEffectiveDate": "2026-10-01T09:00-0400/2026-10-07T18:00-0400",
      "dateValueLocation": "Google candidate sale_price_effective_date",
      "explicitTimezone": "-0400",
      "asOf": "2026-10-02T12:00:00Z",
      "evidence": {
        "promotionPlanRef": "fictional:SW2-promotion-plan",
        "currentOfferRef": "fictional:SW2-current-offer",
        "capturedAt": "2026-10-02T12:00:00Z",
        "sourceContractIds": [
          "google-sale-window"
        ],
        "independentlyAuthenticated": false
      },
      "currentSaleState": {
        "active": true,
        "regularPrice": "100.00 USD",
        "currentSalePrice": "80.00 USD",
        "payableItemPrice": "80.00 USD"
      },
      "feedSnapshot": {
        "price": "100.00 USD",
        "sale_price": "80.00 USD"
      },
      "expectedEditorialReview": {
        "status": "review",
        "action": "retain-interval-and-reconcile-active-offer",
        "reason": "The frozen observation is away from both boundaries and records an active sale. Reconcile the exact variant and price evidence; interval metadata alone does not prove the live result.",
        "providerResult": null
      }
    },
    {
      "id": "SW3",
      "label": "A future date cannot defer a native current sale value",
      "fictional": true,
      "destinationProfile": "openai-stable-native",
      "profileConfirmationRecorded": null,
      "itemId": "EXAMPLE-MUG-BLUE",
      "market": "US",
      "currency": "USD",
      "rawSalePriceEffectiveDate": "2026-10-05T09:00-0400/2026-10-07T18:00-0400",
      "dateValueLocation": "promotion plan",
      "explicitTimezone": "-0400",
      "asOf": "2026-10-02T12:00:00Z",
      "evidence": {
        "promotionPlanRef": "fictional:SW3-promotion-plan",
        "currentOfferRef": "fictional:SW3-current-offer",
        "capturedAt": "2026-10-02T12:00:00Z",
        "sourceContractIds": [
          "openai-file-products"
        ],
        "independentlyAuthenticated": false
      },
      "currentSaleState": {
        "active": false,
        "regularPrice": "100.00 USD",
        "currentSalePrice": null,
        "payableItemPrice": "100.00 USD"
      },
      "feedSnapshot": {
        "price": "100.00 USD",
        "sale_price": "80.00 USD"
      },
      "expectedEditorialReview": {
        "status": "update-needed",
        "action": "prepare-removal-of-premature-sale-price",
        "reason": "The supplied offer is not on sale. Prepare a native snapshot without the premature sale_price; keep the planned date in the internal promotion record. This field name is not documented as a native scheduling field.",
        "providerResult": null
      }
    },
    {
      "id": "SW4",
      "label": "A native sale begins but the current sale value is missing",
      "fictional": true,
      "destinationProfile": "openai-stable-native",
      "profileConfirmationRecorded": null,
      "itemId": "EXAMPLE-MUG-BLUE",
      "market": "US",
      "currency": "USD",
      "rawSalePriceEffectiveDate": "2026-10-01T09:00-0400/2026-10-07T18:00-0400",
      "dateValueLocation": "promotion plan",
      "explicitTimezone": "-0400",
      "asOf": "2026-10-02T12:00:00Z",
      "evidence": {
        "promotionPlanRef": "fictional:SW4-promotion-plan",
        "currentOfferRef": "fictional:SW4-current-offer",
        "capturedAt": "2026-10-02T12:00:00Z",
        "sourceContractIds": [
          "openai-file-products"
        ],
        "independentlyAuthenticated": false
      },
      "currentSaleState": {
        "active": true,
        "regularPrice": "100.00 USD",
        "currentSalePrice": "80.00 USD",
        "payableItemPrice": "80.00 USD"
      },
      "feedSnapshot": {
        "price": "100.00 USD",
        "sale_price": null
      },
      "expectedEditorialReview": {
        "status": "update-needed",
        "action": "prepare-current-sale-price-update",
        "reason": "The frozen offer evidence records an active sale while the supplied native snapshot has no sale_price. Prepare the current 80.00 USD sale value; the planned date does not perform that update.",
        "providerResult": null
      }
    },
    {
      "id": "SW5",
      "label": "A native sale ends but its sale value remains",
      "fictional": true,
      "destinationProfile": "openai-stable-native",
      "profileConfirmationRecorded": null,
      "itemId": "EXAMPLE-MUG-BLUE",
      "market": "US",
      "currency": "USD",
      "rawSalePriceEffectiveDate": "2026-10-01T09:00-0400/2026-10-07T18:00-0400",
      "dateValueLocation": "promotion plan",
      "explicitTimezone": "-0400",
      "asOf": "2026-10-09T12:00:00Z",
      "evidence": {
        "promotionPlanRef": "fictional:SW5-promotion-plan",
        "currentOfferRef": "fictional:SW5-current-offer",
        "capturedAt": "2026-10-09T12:00:00Z",
        "sourceContractIds": [
          "openai-file-products"
        ],
        "independentlyAuthenticated": false
      },
      "currentSaleState": {
        "active": false,
        "regularPrice": "100.00 USD",
        "currentSalePrice": null,
        "payableItemPrice": "100.00 USD"
      },
      "feedSnapshot": {
        "price": "100.00 USD",
        "sale_price": "80.00 USD"
      },
      "expectedEditorialReview": {
        "status": "update-needed",
        "action": "prepare-removal-of-ended-sale-price",
        "reason": "The supplied evidence records the return to regular price after the planned interval. Prepare a native snapshot omitting the ended sale_price; do not wait for stored dates to remove it.",
        "providerResult": null
      }
    },
    {
      "id": "SW6",
      "label": "A confirmed compatible feed receives a future date",
      "fictional": true,
      "destinationProfile": "openai-google-compatible-confirmed",
      "profileConfirmationRecorded": true,
      "itemId": "EXAMPLE-MUG-BLUE",
      "market": "US",
      "currency": "USD",
      "rawSalePriceEffectiveDate": "2026-10-05T09:00-0400/2026-10-07T18:00-0400",
      "dateValueLocation": "OpenAI Google-compatible candidate sale_price_effective_date",
      "explicitTimezone": "-0400",
      "asOf": "2026-10-02T12:00:00Z",
      "evidence": {
        "promotionPlanRef": "fictional:SW6-promotion-plan",
        "currentOfferRef": "fictional:SW6-current-offer",
        "capturedAt": "2026-10-02T12:00:00Z",
        "sourceContractIds": [
          "openai-file-products"
        ],
        "independentlyAuthenticated": false
      },
      "currentSaleState": {
        "active": false,
        "regularPrice": "100.00 USD",
        "currentSalePrice": null,
        "payableItemPrice": "100.00 USD"
      },
      "feedSnapshot": {
        "price": "100.00 USD",
        "sale_price": "80.00 USD"
      },
      "expectedEditorialReview": {
        "status": "update-needed",
        "action": "prepare-removal-of-premature-sale-and-dependent-date",
        "reason": "This profile is confirmed for the fictional registered feed. A future interval is metadata, not an activation schedule. Prepare omission of the premature sale_price and its dependent date field; preserve the plan internally.",
        "providerResult": null
      }
    },
    {
      "id": "SW7",
      "label": "A confirmed compatible interval runs backwards",
      "fictional": true,
      "destinationProfile": "openai-google-compatible-confirmed",
      "profileConfirmationRecorded": true,
      "itemId": "EXAMPLE-MUG-BLUE",
      "market": "US",
      "currency": "USD",
      "rawSalePriceEffectiveDate": "2026-10-07T18:00:00Z/2026-10-01T09:00:00Z",
      "dateValueLocation": "OpenAI Google-compatible candidate sale_price_effective_date",
      "explicitTimezone": "Z",
      "asOf": "2026-10-02T12:00:00Z",
      "evidence": {
        "promotionPlanRef": "fictional:SW7-promotion-plan",
        "currentOfferRef": "fictional:SW7-current-offer",
        "capturedAt": "2026-10-02T12:00:00Z",
        "sourceContractIds": [
          "openai-file-products"
        ],
        "independentlyAuthenticated": false
      },
      "currentSaleState": {
        "active": true,
        "regularPrice": "100.00 USD",
        "currentSalePrice": "80.00 USD",
        "payableItemPrice": "80.00 USD"
      },
      "feedSnapshot": {
        "price": "100.00 USD",
        "sale_price": "80.00 USD"
      },
      "expectedEditorialReview": {
        "status": "hold",
        "action": "hold-and-resolve-reversed-interval",
        "reason": "The compatibility field requires start before end. Hold this date mapping under the author review policy, retain the current-price evidence, and request the correct plan. No upload rejection outcome is inferred.",
        "providerResult": null
      }
    },
    {
      "id": "SW8",
      "label": "An intended business timezone is missing",
      "fictional": true,
      "destinationProfile": "google-merchant-center",
      "profileConfirmationRecorded": null,
      "itemId": "EXAMPLE-MUG-BLUE",
      "market": "US",
      "currency": "USD",
      "rawSalePriceEffectiveDate": "2026-10-05T09:00/2026-10-07T18:00",
      "dateValueLocation": "Google candidate sale_price_effective_date",
      "explicitTimezone": null,
      "asOf": "2026-10-02T12:00:00Z",
      "evidence": {
        "promotionPlanRef": "fictional:SW8-promotion-plan",
        "currentOfferRef": "fictional:SW8-current-offer",
        "capturedAt": "2026-10-02T12:00:00Z",
        "sourceContractIds": [
          "google-sale-window"
        ],
        "independentlyAuthenticated": false
      },
      "currentSaleState": {
        "active": false,
        "regularPrice": "100.00 USD",
        "currentSalePrice": null,
        "payableItemPrice": "100.00 USD"
      },
      "feedSnapshot": {
        "price": "100.00 USD",
        "sale_price": "80.00 USD"
      },
      "expectedEditorialReview": {
        "status": "hold",
        "action": "hold-and-confirm-intended-timezone",
        "reason": "Google documents a UTC default when timezone is omitted. The fictional owner has not confirmed whether these business times were intended as UTC. Hold for that confirmation under the author policy; do not label the value rejected or silently assume local time.",
        "providerResult": null
      }
    }
  ],
  "sources": [
    {
      "id": "google-sale-window",
      "title": "Google Merchant Center: sale price effective date",
      "url": "https://support.google.com/merchants/answer/6324460?hl=en",
      "checked": "2026-10-02",
      "note": "Defines the interval controlling sale-price display, date/time formatting, and UTC/default whole-day behavior. It does not establish exact processing times or a live display result."
    },
    {
      "id": "openai-file-products",
      "title": "OpenAI Stable file-upload products specification",
      "url": "https://developers.openai.com/commerce/specs/file-upload/products",
      "checked": "2026-10-02",
      "note": "Separates native current-price updates from the confirmed Google-compatible date-metadata field. The compatibility path must be confirmed for the registered feed; its scheduling behavior differs from Google Merchant Center."
    }
  ]
}