Playbooks

Playbooks are standard operating procedures (SOPs) for SLC. Use calls.md for payload shape and required fields.

Surface availability (explicit)

• API Gateway: Available.
• Direct Lambda: Available.
• CLI: Not available.
• MCP: Available.

Creating a channel

1. Create channel: {"action":"channel/create", "orgcode":"ORG", "name":"My Store", "config":{...}}.
2. Channel is created in inactive state.
3. Add variant inclusions: {"action":"variants/add", "channel_guid":"...", "variant_guids":["..."]}.
4. Bind facilities: {"action":"facility/bind", "channel_guid":"...", "facility_guid":"...", "role":"primary"}.
5. Activate: {"action":"channel/activate", "channel_guid":"..."}.

Rotating credentials

1. Obtain new Shopify access token.
2. Call {"action":"credentials/rotate", "channel_guid":"...", "orgcode":"ORG", "shopify_access_token":"shpat_new..."}.
3. Handler tests connectivity before persisting. On failure, old token remains.

Force-sync

1. Sync all variants: {"action":"channel/force-sync", "channel_guid":"..."}.
2. Sync specific variants: {"action":"channel/force-sync-variant", "channel_guid":"...", "variant_guids":["..."]}.

Audit queries

1. By variant: {"action":"audit/variant-history", "variant_guid":"..."}.
2. By Shopify ID: {"action":"audit/shopify-history", "shopify_variant_id":"gid://shopify/ProductVariant/123"}.
3. By SKU: {"action":"audit/sku-history", "orgcode":"ORG", "sku":"STYLE-001-XL-BLK"}.
4. All support limit, since, until, start_key for pagination.

Vacuuming an org

1. Call {"action":"vacuum/org", "orgcode":"ORG", "confirmation_phrase":"DELETE ORG DATA"}.
2. DDB records are deleted. S3 audit objects are cleaned by OPS vacuum (manifest entry).