Skip to content

fix(wix-headless): document 12 auto-created demo products and verify-after-delete (GPV-8744) - #950

Open
gilgwix wants to merge 5 commits into
mainfrom
swift-newt-3c6118
Open

fix(wix-headless): document 12 auto-created demo products and verify-after-delete (GPV-8744)#950
gilgwix wants to merge 5 commits into
mainfrom
swift-newt-3c6118

Conversation

@gilgwix

@gilgwix gilgwix commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds an explicit mandate in CREATE.md §4 to Read each capability's inline recipe (how-to-code-*.md) before authoring any page or component code for that capability
  • Adds a pre-release API-wiring check: grep the generated source for real SDK call sites (e.g. addToCurrentCart, productsV3) and treat their absence as a broken deliverable, not a warning

Problem

Agents were generating convincing storefront UIs — product grids, cart badges, checkout buttons — that weren't wired to real @wix/stores / @wix/ecom SDK calls. The storefront looked complete but failed entirely at runtime (no items added to cart, currency dropdown with no setCurrency(), cart badge stuck at 0).

Root cause: CREATE.md §4 directed agents to SDK_HANDOFF.md for package names, which maps each capability to its inline recipe — but never explicitly required reading that recipe before writing code. Agents could (and did) generate plausible-looking UI from model memory instead, producing stubs that matched the real API shape superficially but called nothing.

Jira: https://wix.atlassian.net/browse/GPV-8742

Test plan

  • A managed create run for a store site reads how-to-code-a-store.md before authoring product/cart/checkout pages
  • Generated source contains real productsV3 / addToCurrentCart calls (verifiable with the new grep check)
  • A managed create run for a bookings site reads how-to-code-bookings.md before authoring availability/booking pages

🤖 Generated with Claude Code

gilgwix and others added 5 commits August 3, 2026 13:18
The Catalog V3 searchProducts() API returns { products, pagingMetadata },
not { items }. Destructuring items yields undefined and silently renders
an empty product gallery.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…rchProducts

queryProducts().find() returns result.items[] (query-builder result),
searchProducts({}) returns result.products[] (search response).
The previous single-line comment was correct for neither after the flip.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…after-delete step (GPV-8744)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…bility code (GPV-8742)

Agents were generating convincing storefront UI (product gallery, cart badge, checkout button)
not backed by real @wix/stores SDK calls. The root cause: CREATE.md §4 directed agents to
SDK_HANDOFF.md for package names but never explicitly required reading the per-capability
inline recipe before authoring code — leaving the door open to plausible-looking stubs.

Adds a pre-code mandate to Read each capability's how-to-code-*.md recipe before writing
any pages, and a pre-release grep check to verify addToCurrentCart/productsV3 are actually
present in the source.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant