claude-code-arcane 1.3.0 → 1.4.0

package/skills/commerce-data-model/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: commerce-data-model
+description: "Design and audit the core e-commerce domain model — products, variants, SKUs, options, collections, attributes, taxonomy, faceted search and pagination. Language- and platform-agnostic. Triggers: modeling a catalog, reviewing an existing product schema, designing filtering/search."
+argument-hint: "[model | audit | taxonomy]"
+category: "ecommerce"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Write, Edit
+---
+
+# Commerce Data Model
+
+Design the backbone of any storefront: a product catalog model that survives variants, bundles, localization, and faceted search — independent of language, framework, or database.
+
+> **Note:** This skill may create or modify files in your project (a model spec or schema doc). It will ask before writing.
+
+## Before Starting
+
+Gather: business context (physical/digital/services, single vs multi-vendor, B2C/B2B), scale (SKU count, variant explosion, locales/currencies), and goal (model from scratch, audit an existing schema, or design taxonomy + filtering).
+
+## How This Skill Works
+
+| Mode | Trigger | Output |
+|------|---------|--------|
+| **Model** | `model` | Entity model spec: Product, Variant, SKU, Option, Collection, Attribute |
+| **Audit** | `audit` | Gap analysis of an existing schema against commerce best practices |
+| **Taxonomy** | `taxonomy` | Category tree, attribute schema, faceted-search and pagination design |
+
+---
+
+## Phase 1 — Core Entities
+
+The canonical separation that prevents 90% of catalog pain:
+
+| Entity | Is | Is NOT | Key fields |
+|--------|----|--------|-----------|
+| **Product** | The marketing/SEO unit ("Acme Tee") | A buyable thing | title, description, slug, status, brand |
+| **Variant** | A buyable combination ("Tee / Red / M") | A category | option values, price, weight, barcode |
+| **SKU** | The stock-keeping identifier | A variant's price | code, variant_id |
+| **Option** | An axis of variation (Color, Size) | A value | name, position |
+| **Collection** | A merchandising grouping | A taxonomy node | title, rules (manual/automatic) |
+
+**Rule:** Price, inventory, and barcode live on the **Variant**, never the Product. A product with no options still has exactly one variant.
+
+For the full field-level spec, identifiers (GTIN/MPN), bundles/kits, and digital vs physical modeling, see [references/data-model-spec.md](references/data-model-spec.md).
+
+---
+
+## Phase 2 — Attributes & Taxonomy
+
+- **Taxonomy** (category tree): hierarchical, navigational, one primary path per product. Stable URLs.
+- **Collections**: many-to-many merchandising overlays (manual or rule-based). A product lives in one category branch but many collections.
+- **Attributes**: typed key-values (`material: cotton`, `sleeve: short`). Drive facets. Define a controlled vocabulary — free-text attributes break filtering.
+
+**Attribute typing:** `text | enum | number | boolean | measurement`. Enums must reference a value list. Measurements carry a unit.
+
+---
+
+## Phase 3 — Faceted Search & Pagination
+
+- Facets come from `enum`/`boolean`/`measurement` attributes, not free text.
+- Multi-select within a facet = OR; across facets = AND.
+- Always show counts; never show zero-result facet values.
+- **Pagination:** prefer cursor/keyset over offset for deep catalogs (offset degrades and double-counts under writes). Cap page size.
+
+---
+
+## Output Artifacts
+
+| Request | Output |
+|---------|--------|
+| Model from scratch | Entity spec + ER sketch + identifier strategy |
+| Audit schema | Verdict per entity: COMPLIANT / CONCERNS, with fixes |
+| Design taxonomy | Category tree + attribute schema + facet plan |
+
+A schema is **COMPLIANT** when price/inventory sit on variants, every product has ≥1 variant, attributes are typed against vocabularies, and URLs are stable.
+
+---
+
+## Related Skills
+
+- **storefront-architecture**: consumes this model to design PLP/PDP pages. Next step after modeling.
+- **merchant-feed**: maps these entities to Google/Meta feed attributes.
+- **inventory-stock**: owns stock levels that hang off the SKU/variant.
+- **order-lifecycle**: references variants as order line items.

package/skills/commerce-data-model/references/data-model-spec.md

@@ -0,0 +1,79 @@
+# Commerce Data Model — Field-Level Spec & Worked Example
+
+A language- and database-agnostic reference for the core catalog entities. Use it as the template for a model spec.
+
+## Entities & Fields
+
+### Product (marketing/SEO unit)
+| Field | Type | Notes |
+|-------|------|-------|
+| id | id | Internal key |
+| title | text | Display name |
+| slug | text | Stable URL segment, unique |
+| description | rich text | Long copy |
+| brand | text | Brand/manufacturer |
+| status | enum | draft / active / archived |
+| options | Option[] | Axes of variation (0..n) |
+| variants | Variant[] | ≥1 always |
+| collections | Collection[] | Many-to-many |
+| primary_category | Category | One navigational path |
+| attributes | Attribute[] | Typed key-values |
+
+### Variant (buyable unit)
+| Field | Type | Notes |
+|-------|------|-------|
+| id | id | |
+| sku | text | Stock-keeping code, unique |
+| option_values | map | e.g. {Color: Red, Size: M} |
+| price | integer (minor units) | Never a float |
+| compare_at_price | integer | For showing discounts |
+| barcode | text | GTIN/UPC/EAN |
+| weight / dimensions | number + unit | For shipping/carrier rates |
+| requires_shipping | bool | False for digital |
+
+### Option / Option Value
+`Option { name, position }` → `OptionValue { option_id, value, position }`. Example: Option "Size" → values S, M, L.
+
+### Collection (merchandising)
+`Collection { title, slug, type: manual|automatic, rules? }`. Automatic collections select by attribute rules (e.g. `tag = summer`).
+
+### Attribute (faceting)
+`Attribute { key, type: text|enum|number|boolean|measurement, value, unit? }`. Enum attributes reference a controlled value list.
+
+## Identifiers
+- **SKU** — your internal stock identifier (required, unique).
+- **GTIN** (UPC/EAN/ISBN) — global trade identifier; required for marketplaces/feeds where one exists.
+- **MPN** — manufacturer part number; fallback when no GTIN.
+
+## Bundles / Kits
+Model as a Product whose variant references component variants with quantities. Decide inventory rule: track by components (decrement each) vs by kit (own stock).
+
+## Worked Example — "Acme Tee"
+
+```yaml
+product:
+  title: "Acme Cotton Tee"
+  slug: "acme-cotton-tee"
+  brand: "Acme"
+  status: active
+  options:
+    - { name: Color, values: [Red, Blue] }
+    - { name: Size,  values: [S, M, L] }
+  attributes:
+    - { key: material, type: enum, value: cotton }
+    - { key: sleeve,   type: enum, value: short }
+  variants:
+    - sku: ACME-TEE-RED-M
+      option_values: { Color: Red, Size: M }
+      price: 2100            # 21.00 in minor units
+      barcode: "0123456789012"
+      weight: { value: 180, unit: g }
+```
+
+## Checklist (verdict: COMPLIANT when all true)
+- [ ] Price + inventory + barcode live on the variant, not the product
+- [ ] Every product has ≥1 variant (even with no options)
+- [ ] Attributes are typed and enums reference a vocabulary
+- [ ] Primary category is single; collections are many-to-many
+- [ ] Money stored as integer minor units
+- [ ] Slugs/URLs stable and unique

package/skills/inventory-stock/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: inventory-stock
+description: "Design inventory and stock control — availability tracking, optimistic locking to prevent overselling, reservations, multi-location, backorders, and restock forecasting. Includes a safety-stock/reorder-point calculator. Triggers: designing inventory, fixing overselling, forecasting restock."
+argument-hint: "[design | forecast | audit]"
+category: "ecommerce"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Bash
+---
+
+# Inventory & Stock
+
+Stock is where data integrity meets revenue: oversell and you lose trust, over-reserve and you lose sales. Design availability that is correct under concurrency and forecast restocks from real demand — platform-agnostic.
+
+## Before Starting
+
+Gather: inventory model (single vs multi-location), sales velocity and lead times, fulfillment style (own stock, dropship, backorder), and goal (design the model, forecast restock, or audit for oversell risk).
+
+## How This Skill Works
+
+| Mode | Trigger | Output |
+|------|---------|--------|
+| **Design** | `design` | Availability model + concurrency strategy |
+| **Forecast** | `forecast` | Safety stock + reorder points (via script) |
+| **Audit** | `audit` | Oversell-risk and accuracy review |
+
+---
+
+## Phase 1 — Availability Model
+
+Track three numbers per SKU per location, never one:
+
+| Quantity | Meaning |
+|----------|---------|
+| **on_hand** | Physically present |
+| **reserved** | Allocated to unfulfilled orders/checkouts |
+| **available** | `on_hand − reserved` — the only number a shopper sees |
+
+**Rule:** Reserve at checkout start with a TTL; release on timeout/abandonment. Decrement `on_hand` at fulfillment, not at order placement.
+
+---
+
+## Phase 2 — Preventing Overselling
+
+The classic race: two shoppers buy the last unit. Defenses, in order of preference:
+
+1. **Optimistic locking** — version/row check on decrement; retry on conflict. Default choice.
+2. **Atomic conditional update** — `UPDATE ... WHERE available >= qty` and check rows-affected.
+3. **Pessimistic lock** — only for high-contention single rows; costs throughput.
+
+Always treat "reserve stock" as a transaction that can FAIL and surface that to checkout cleanly. Multi-location adds an allocation step (which location fulfills) before the decrement.
+
+For backorder rules, multi-location allocation strategies, and reservation TTL tuning, see the patterns above and hand off to `order-lifecycle` for fulfillment state.
+
+---
+
+## Phase 3 — Restock Forecasting
+
+Use the script to turn a sales CSV into reorder points:
+
+```bash
+python skills/inventory-stock/scripts/restock_forecast.py            # demo data
+python skills/inventory-stock/scripts/restock_forecast.py sales.csv --lead-time 14 --service-level 0.95
+```
+
+It computes average daily demand, demand variability, **safety stock** (`z × σ_demand × √lead_time`), and **reorder point** (`demand × lead_time + safety_stock`). CSV columns: `sku,date,units_sold`.
+
+---
+
+## Output Artifacts
+
+| Request | Output |
+|---------|--------|
+| Design | Availability model + chosen concurrency strategy |
+| Forecast | Per-SKU reorder point + safety stock table |
+| Audit | Oversell-risk findings: PASS / FAIL per check |
+
+An inventory design **PASSES** when shoppers only see `available`, reservations expire, decrements are atomic/versioned, and forecasts drive reorder points instead of guesswork.
+
+---
+
+## Related Skills
+
+- **commerce-data-model**: defines the SKU/variant that stock hangs off.
+- **order-lifecycle**: consumes reservations and triggers decrements at fulfillment.
+- **cart-checkout**: starts the reservation when checkout begins.
+- **commerce-analytics**: sell-through and turnover metrics that feed forecasts.

package/skills/inventory-stock/scripts/restock_forecast.py

@@ -0,0 +1,173 @@
+"""
+restock_forecast.py — Safety stock & reorder points from a sales history CSV.
+
+Turns daily sales into per-SKU reorder signals using the classic
+reorder-point model. No external dependencies (stdlib only), cross-platform.
+
+Usage:
+    python restock_forecast.py                                  # built-in demo data
+    python restock_forecast.py sales.csv                        # your data, defaults
+    python restock_forecast.py sales.csv --lead-time 14 --service-level 0.95
+    python restock_forecast.py sales.csv --on-hand on_hand.csv  # flag what to reorder
+
+CSV format (header required):
+    sku,date,units_sold
+    ACME-TEE-RED-M,2026-05-01,4
+    ACME-TEE-RED-M,2026-05-02,2
+    ...
+
+Optional on-hand CSV (header required):  sku,on_hand
+
+Model:
+    avg_daily_demand   = mean(units_sold per day)
+    sigma_demand       = stdev(units_sold per day)
+    safety_stock       = z(service_level) * sigma_demand * sqrt(lead_time)
+    reorder_point      = avg_daily_demand * lead_time + safety_stock
+
+When on-hand is provided, a SKU is flagged REORDER when on_hand <= reorder_point.
+"""
+
+import argparse
+import csv
+import math
+import sys
+from collections import defaultdict
+
+
+# Embedded demo data: two SKUs, ~3 weeks of daily sales.
+DEMO_ROWS = [
+    ("ACME-TEE-RED-M", d, u)
+    for d, u in zip(
+        [f"2026-05-{n:02d}" for n in range(1, 22)],
+        [4, 2, 5, 3, 6, 8, 7, 3, 4, 5, 2, 6, 9, 7, 4, 3, 5, 6, 8, 4, 5],
+    )
+] + [
+    ("ACME-MUG-BLUE", d, u)
+    for d, u in zip(
+        [f"2026-05-{n:02d}" for n in range(1, 22)],
+        [1, 0, 2, 1, 1, 3, 2, 0, 1, 1, 0, 2, 1, 2, 1, 0, 1, 2, 3, 1, 1],
+    )
+]
+DEMO_ON_HAND = {"ACME-TEE-RED-M": 40, "ACME-MUG-BLUE": 60}
+
+
+def z_for_service_level(p):
+    """Inverse standard-normal CDF (Acklam's rational approximation)."""
+    if not 0.0 < p < 1.0:
+        raise ValueError("service-level must be between 0 and 1 (exclusive)")
+    a = [-3.969683028665376e+01, 2.209460984245205e+02, -2.759285104469687e+02,
+         1.383577518672690e+02, -3.066479806614716e+01, 2.506628277459239e+00]
+    b = [-5.447609879822406e+01, 1.615858368580409e+02, -1.556989798598866e+02,
+         6.680131188771972e+01, -1.328068155288572e+01]
+    c = [-7.784894002430293e-03, -3.223964580411365e-01, -2.400758277161838e+00,
+         -2.549732539343734e+00, 4.374664141464968e+00, 2.938163982698783e+00]
+    d = [7.784695709041462e-03, 3.224671290700398e-01, 2.445134137142996e+00,
+         3.754408661907416e+00]
+    plow, phigh = 0.02425, 1 - 0.02425
+    if p < plow:
+        q = math.sqrt(-2 * math.log(p))
+        return (((((c[0]*q+c[1])*q+c[2])*q+c[3])*q+c[4])*q+c[5]) / \
+               ((((d[0]*q+d[1])*q+d[2])*q+d[3])*q+1)
+    if p > phigh:
+        q = math.sqrt(-2 * math.log(1 - p))
+        return -(((((c[0]*q+c[1])*q+c[2])*q+c[3])*q+c[4])*q+c[5]) / \
+                ((((d[0]*q+d[1])*q+d[2])*q+d[3])*q+1)
+    q = p - 0.5
+    r = q * q
+    return (((((a[0]*r+a[1])*r+a[2])*r+a[3])*r+a[4])*r+a[5])*q / \
+           (((((b[0]*r+b[1])*r+b[2])*r+b[3])*r+b[4])*r+1)
+
+
+def load_sales(path):
+    rows = []
+    with open(path, newline="", encoding="utf-8") as f:
+        reader = csv.DictReader(f)
+        required = {"sku", "date", "units_sold"}
+        if not required.issubset({c.strip() for c in (reader.fieldnames or [])}):
+            print(f"[ERROR] {path}: header must include sku,date,units_sold")
+            sys.exit(1)
+        for r in reader:
+            try:
+                rows.append((r["sku"].strip(), r["date"].strip(), float(r["units_sold"])))
+            except (KeyError, ValueError):
+                print(f"[WARN] skipping malformed row: {r}")
+    return rows
+
+
+def load_on_hand(path):
+    out = {}
+    with open(path, newline="", encoding="utf-8") as f:
+        for r in csv.DictReader(f):
+            try:
+                out[r["sku"].strip()] = float(r["on_hand"])
+            except (KeyError, ValueError):
+                pass
+    return out
+
+
+def stdev(xs):
+    if len(xs) < 2:
+        return 0.0
+    mean = sum(xs) / len(xs)
+    return math.sqrt(sum((x - mean) ** 2 for x in xs) / (len(xs) - 1))
+
+
+def forecast(rows, lead_time, service_level, on_hand):
+    z = z_for_service_level(service_level)
+    by_sku = defaultdict(list)
+    for sku, _date, units in rows:
+        by_sku[sku].append(units)
+
+    results = []
+    for sku in sorted(by_sku):
+        daily = by_sku[sku]
+        avg = sum(daily) / len(daily)
+        sigma = stdev(daily)
+        safety = z * sigma * math.sqrt(lead_time)
+        rop = avg * lead_time + safety
+        oh = on_hand.get(sku)
+        flag = ""
+        if oh is not None:
+            flag = "REORDER" if oh <= rop else "OK"
+        results.append((sku, avg, sigma, safety, rop, oh, flag))
+    return results
+
+
+def main():
+    ap = argparse.ArgumentParser(description="Safety stock & reorder points from sales CSV.")
+    ap.add_argument("csv", nargs="?", help="sales CSV (sku,date,units_sold). Omit for demo.")
+    ap.add_argument("--lead-time", type=float, default=14, help="supplier lead time in days (default 14)")
+    ap.add_argument("--service-level", type=float, default=0.95, help="0-1 target fill rate (default 0.95)")
+    ap.add_argument("--on-hand", help="optional CSV (sku,on_hand) to flag what to reorder")
+    args = ap.parse_args()
+
+    if args.csv:
+        rows = load_sales(args.csv)
+        on_hand = load_on_hand(args.on_hand) if args.on_hand else {}
+    else:
+        print("[INFO] No CSV given - using built-in demo data.\n")
+        rows = DEMO_ROWS
+        on_hand = DEMO_ON_HAND
+
+    if not rows:
+        print("[ERROR] No sales rows to analyze.")
+        sys.exit(1)
+
+    results = forecast(rows, args.lead_time, args.service_level, on_hand)
+
+    z = z_for_service_level(args.service_level)
+    print(f"Lead time: {args.lead_time:g}d | Service level: {args.service_level:g} (z={z:.2f})\n")
+    header = f"{'SKU':<20} {'avg/day':>8} {'sigma':>7} {'safety':>8} {'reorder_pt':>11} {'on_hand':>8} {'flag':>8}"
+    print(header)
+    print("-" * len(header))
+    for sku, avg, sigma, safety, rop, oh, flag in results:
+        oh_s = f"{oh:g}" if oh is not None else "-"
+        print(f"{sku:<20} {avg:>8.2f} {sigma:>7.2f} {safety:>8.1f} {rop:>11.1f} {oh_s:>8} {flag:>8}")
+
+    reorder = [r for r in results if r[6] == "REORDER"]
+    if on_hand:
+        print(f"\n{'PASS' if not reorder else 'ACTION'}: {len(reorder)} SKU(s) at/below reorder point.")
+
+
+if __name__ == "__main__":
+    main()

package/skills/merchant-feed/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: merchant-feed
+description: "Build and validate product feeds for shopping channels — Google Merchant Center and Meta Catalog — including required/recommended attributes, attribute mapping, and feed validation. Includes a feed validator/generator script. Triggers: building a product feed, fixing feed disapprovals, mapping catalog to feed attributes."
+argument-hint: "[validate | generate | map]"
+category: "ecommerce"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Bash
+---
+
+# Merchant Feed
+
+Shopping ads and free listings live or die on feed quality. A clean, complete feed gets products approved and surfaced; a sloppy one gets disapprovals. Map your catalog to channel attributes and validate before upload — platform-agnostic.
+
+## Before Starting
+
+Gather: target channel (Google Merchant / Meta Catalog), source of truth (DB export, CSV, platform), product categories, and goal (validate an existing feed, generate one, or map catalog → feed attributes).
+
+## How This Skill Works
+
+| Mode | Trigger | Output |
+|------|---------|--------|
+| **Validate** | `validate` | Pass/fail report against required attributes |
+| **Generate** | `generate` | Feed emitted from a source CSV |
+| **Map** | `map` | Catalog field → feed attribute mapping |
+
+---
+
+## Phase 1 — Required Attributes
+
+Google Merchant / Meta share a common core. Required for every item:
+
+| Attribute | Notes |
+|-----------|-------|
+| `id` | Stable, unique per variant (use SKU) |
+| `title` | Front-load product; ≤150 chars; match landing page |
+| `description` | Plain, accurate; no promo text/caps |
+| `link` | Canonical PDP URL |
+| `image_link` | Main image, meets resolution minimums |
+| `availability` | in_stock / out_of_stock / preorder |
+| `price` | With currency; must match landing page exactly |
+| `brand` | Required unless exempt category |
+| `gtin` / `mpn` | Required where a GTIN exists — improves matching |
+| `condition` | new / refurbished / used |
+
+**Rule:** Feed price and availability must **exactly match** the live PDP, or the item is disapproved and the account is penalized.
+
+---
+
+## Phase 2 — Validate / Generate
+
+Run the validator on a CSV export:
+
+```bash
+python skills/merchant-feed/scripts/feed_validate.py            # demo data
+python skills/merchant-feed/scripts/feed_validate.py feed.csv
+```
+
+It checks every row for required attributes, flags missing/empty values, validates `availability`/`condition` enums and price+currency format, and reports a per-row and summary verdict. For the full attribute reference and category-specific requirements, see [references/feed-attribute-map.md](references/feed-attribute-map.md).
+
+---
+
+## Phase 3 — Recommended Attributes & Quality
+
+Beyond required, these lift performance: `google_product_category`, `product_type`, `item_group_id` (links variants), `color`, `size`, `gender`, `age_group`, `sale_price`, `shipping`, `gtin`. Use `item_group_id` so variants cluster correctly — without it, variants compete as separate products.
+
+---
+
+## Output Artifacts
+
+| Request | Output |
+|---------|--------|
+| Validate | Per-row + summary PASS / FAIL report |
+| Generate | Channel-ready feed file |
+| Map | Catalog → feed attribute mapping table |
+
+A feed is **READY** when every item has all required attributes, price/availability match the PDP, variants share an `item_group_id`, and GTINs are present where they exist.
+
+---
+
+## Related Skills
+
+- **commerce-data-model**: the catalog entities mapped into feed attributes.
+- **product-listing**: titles/descriptions reused between PDP and feed.
+- **shipping-tax**: shipping attribute values in the feed.
+- **schema-markup**: Product structured data complements the feed for organic.

package/skills/merchant-feed/references/feed-attribute-map.md

@@ -0,0 +1,47 @@
+# Product Feed — Attribute Reference & Catalog Mapping
+
+Maps the commerce data model to Google Merchant / Meta Catalog feed attributes. The `feed_validate.py` script enforces the required core.
+
+## Required attributes (every item)
+| Feed attribute | Source (data model) | Rule |
+|----------------|---------------------|------|
+| id | variant.sku | Stable, unique per variant |
+| title | product.title (+ variant) | Front-load product; ≤150 chars; match PDP |
+| description | product.description | Plain, accurate; no promo/ALL CAPS |
+| link | product URL | Canonical, absolute https |
+| image_link | main image | Absolute https; meets resolution min |
+| availability | variant stock | in_stock / out_of_stock / preorder / backorder |
+| price | variant.price | `"21.00 USD"` — matches PDP exactly |
+| brand | product.brand | Required unless exempt category |
+| condition | — | new / refurbished / used |
+
+## Strongly recommended
+| Feed attribute | Source | Why |
+|----------------|--------|-----|
+| gtin | variant.barcode | Improves matching / eligibility |
+| mpn | variant.mpn | Fallback when no GTIN |
+| item_group_id | product.id | Clusters variants (else they compete) |
+| google_product_category | category map | Taxonomy alignment |
+| product_type | primary_category | Your own taxonomy |
+| color / size / gender / age_group | attributes | Apparel facets |
+| sale_price | compare_at logic | Promo pricing |
+| shipping | shipping-tax rules | Overrides account settings |
+
+## Hard rules (disapproval triggers)
+- Feed **price + availability must match the live PDP** exactly.
+- No promotional text in `title`/`description` (no "Free shipping!", no emojis/caps).
+- `image_link` must resolve and meet the channel's minimum resolution.
+- Variants without a shared `item_group_id` are treated as separate products.
+
+## Worked example (CSV row)
+```csv
+id,title,description,link,image_link,availability,price,brand,condition,gtin,item_group_id
+ACME-TEE-RED-M,"Acme Cotton Tee — Red, Medium","Soft 100% cotton crew-neck tee.",https://shop.example.com/p/acme-tee-red-m,https://shop.example.com/img/acme-tee-red-m.jpg,in_stock,21.00 USD,Acme,new,0123456789012,ACME-TEE
+```
+
+## Verdict: READY when
+- [ ] All required attributes present and non-empty
+- [ ] price/availability match PDP
+- [ ] valid availability + condition enums
+- [ ] price formatted `amount ISO-currency`
+- [ ] variants share item_group_id; GTIN present where it exists