Skip to content

Add ecommerce abandoned carts and fulfillment routing#377

Closed
mayaz-mac wants to merge 13 commits into
wix:mainfrom
mayaz-mac:codex/ecommerce-routing-split
Closed

Add ecommerce abandoned carts and fulfillment routing#377
mayaz-mac wants to merge 13 commits into
wix:mainfrom
mayaz-mac:codex/ecommerce-routing-split

Conversation

@mayaz-mac

Copy link
Copy Markdown

Summary

  • Adds new ecommerce routing categories for Abandoned Carts, Fulfillment, and Orders
  • Rehomes abandoned-cart recovery out of Checkout and fulfillment execution out of Shipping
  • Adds ecommerce eval coverage for new and updated docs
  • Keeps Stores/Get Paid work out of this PR scope

Review notes

  • Abandoned-cart information/reporting routes use Analytics APIs first; Abandoned Checkout API is for record lookup/recovery actions
  • Fulfillment docs include public API guardrails: approved orders, one fulfillment per line item, 300 line items per fulfillment, 100 orders per bulk call, and tracking-provider behavior
  • Shipping-label export remains Dashboard-only unless a verified public/MCP route is added

Validation

  • git diff --check
  • YAML parse for yaml/**/*.yml and yaml/**/*.yaml
  • ecommerce registry check: no missing/unregistered docs
  • ecommerce eval coverage check: no missing coverage

Related

itayhewix and others added 13 commits June 5, 2026 07:41
Relocate the 17 per-domain skill-audit.md files (internal TPA-public and
redundancy assessments) into the wix-skills-routing-expert skill repo; they
must not ship publicly. Drop the audit reference from ecom-load-context.md
and rewrite the (still-public) ecommerce skill-graph for the new routing tree.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
…-graph

Coupons create/query use the stores/ service prefix (POST stores/v2/coupons),
not /v2/coupons — verified against dev.wix.com. Redraw the ecommerce
skill-graph with one group per L3 (Tax, Pricing), arrows landing on the group
and files stacked vertically under the default dispatcher.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
The README index embeds only title + description (not bodies), so a separate
category-doc that just links to -default was a dead ReadFullDocsArticle hop.
Fold the dispatch block into the README-surfaced ecom-tax.md / ecom-pricing.md
and drop both -default files. Repoint the run-a-sale routing note, SKILL.md
catalog, and skill-graph.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Catches the mirror up to the new ecommerce routing tree (category-doc +
dispatcher merge, removed legacy flat files). Regenerated via
npm run sync:plugin; --check now passes.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
…ut MCP-callable

The run-a-sale orchestrator and tracking-api use manage.wix.com endpoints with
no public docs page. They ARE callable via CallWixSiteAPI in the authenticated
editor context, so the recipes carry the full request/response spec inline and
must not be treated as unavailable. Also drop a stale `layer:` frontmatter key.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
… tree

Create the merged ecom-shipping.md category entry + shipping/ folder (renamed
ecom-shipping-*), repoint all cross-links (Pricing goal-increase-aov, checkout
abandonment goal), and register under the shipping/ paths. Slim every shipping
file's frontmatter to name+description. Reduce the cluster 10 -> 7: inline the
two guardrails (rate-sanity into free-shipping/optimize-rates, health+intl
filter into fix-coverage) and dissolve apply-recommendations per 7.5 (its CRUD
is all in the API reference; preserved the singular deliveryRegionId gotcha
there). The Shipping Options/Delivery Profiles APIs have no public docs, so
ecom-shipping-api.md stays as the inline reference.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Create the merged ecom-checkout.md category entry + checkout/ folder (the 2
existing delivery-step recipes renamed ecom-checkout-*), slim their frontmatter,
and repoint the run-a-sale ABANDONED_CART link. Dispatch covers the sheet's
checkout intents honestly: 2 recipes, Dashboard routes for the config intents
with no TPA-public API (guest checkout, min order, custom fields, upsell), a
7.5 API-doc entry for checkout policies, and flagged gaps (cart-recovery email,
agentic/UCP readiness, store-health). Completes all four ecommerce L2 categories.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Author ecom-checkout-recover-email: the Dashboard abandoned-cart automation
(timing, content, eligibility, recovery-rate benchmark) plus an agent API path
using the TPA-public Abandoned Checkout API (query + redirect-to-checkout for
the recovery link). Triggered Emails is PRIVATE/ALPHA so programmatic send
stays Dashboard-driven. Wire into the checkout dispatch and make the
view-abandoned entry concrete (POST /ecom/v1/abandoned-checkout/query).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Fold discount-conflicts + margin-protection into create-discount-rule (full set)
and create-coupon (coupon subset) — the skills they guard — deduping the
overlapping %-sanity/margin checks. Delete both guardrail files; repoint the 4
flows + 2 goals to the Create Discount Rule "Guardrails" section (slim their
frontmatter, replace inline guardrail steps with pointers). pricing-promotions
15 -> 13 files; guardrails now enforced once at creation, not per-caller.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
…nt tags

Add the skills that complete the four ecom L2 categories' sheet-intent coverage:
- Checkout: agentic-readiness (catalog data-quality audit + public test-checkout;
  UCP enablement is Dashboard) and store-health monitor.
- Shipping & fulfillment: fulfill-orders (Fulfillments API — mark fulfilled,
  tracking, partial, bulk) + §7.5 dispatch for find-unshipped / order invoice.
- Pricing: pricing-health periodic sweep + competitive-pricing advisory entry.

Also strip a stray trailing </content> line accidentally written into the four
category entries and several recipe files. Wire all into dispatch, yaml,
SKILL.md, and skill-graph.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@mayaz-mac

Copy link
Copy Markdown
Author

Closing because this work should be added to existing PR #366 instead of a separate PR.

@mayaz-mac mayaz-mac closed this Jun 8, 2026
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.

2 participants