commerce_core_ops

Unified commerce skill for bustly-skills.

This skill consolidates the fragmented commerce surface into one operator-facing entrypoint:

• data reads
• product writes

Platforms:

• Shopify
• BigCommerce
• WooCommerce
• Magento

Standard command surface

Preferred command contract:

bustly ops commerce <command>

Repo-local fallback:

node scripts/bustly-ops.js ops commerce <command>

Direct implementation fallback:

node skills/ops/commerce_core_ops/scripts/run.js <command>

Discovery commands

bustly ops commerce help
bustly ops commerce providers
bustly ops commerce connections
bustly ops commerce auth

Examples

# Read Shopify orders
bustly ops commerce read --platform shopify --entity orders --limit 50

# Read WooCommerce orders
bustly ops commerce read:entity --platform woocommerce --entity orders --limit 50 --since 2026-01-01

# Update a Shopify product
bustly ops commerce write:product --platform shopify --op update --payload '{"id":"gid://shopify/Product/123","title":"New Title"}'

Environment

Preferred env vars:

• BUSTLY_SUPABASE_URL
• BUSTLY_SUPABASE_ANON_KEY
• BUSTLY_SUPABASE_ACCESS_TOKEN
• BUSTLY_WORKSPACE_ID
• BUSTLY_USER_ID

~/.bustly/bustlyOauth.json is auto-detected with both new and legacy shapes:

• New: supabase.url / supabase.anonKey + user.userAccessToken / user.workspaceId
• Legacy: bustlySearchData.SEARCH_DATA_*

Design Scope

• Read directly from platform APIs (not semantic warehouse tables)
• Write products through platform adapters with one CLI interface
• Enforce JWT, workspace membership, workspace active status, and billing-window checks
• All four platforms read/write via /functions/v1/commerce-core-ops (DIRECT_READ / DIRECT_WRITE)

No custom sync workflow commands in this skill.

References

• ./SKILL.md
• ./references/contracts.md
• ./references/edge-function-commerce-core-ops.ts
• ../../gateway/supabase/functions/commerce-core-ops/index.ts