btn-publish
white
#129 / 601
NAME
btn-publish — White read-cart in the 'Buttons (write ops, mint-flavor) (15)' group. Operator-commanded data surface in the Analysis tab.
SYNOPSIS
id btn-publish
tier white
section §6. White — atomic tools (142 baseline, 149 post-matrix)
trigger operator-commanded
tools cortex_query, list_listings / list_orders
source carry-forward
DESCRIPTION
The publish button. Takes a draft live on the platform. Most destructive action in the white tier; strictest consent gate.
White read-cart in the 'Buttons (write ops, mint-flavor) (15)' group. Operator-commanded data surface in the Analysis tab.
MECHANISM
;;~ title "Publish a listing" ;;~ author "lacuna" ;;~ version 1 ;;~ mode automation ;;~ flavor green ;;~ id btn-publish ;;~ touches (etsy-listings) ;;~ summary "Take a draft live." ;; Take a draft live. ;; ;; Destructive write cart. Action-wrapper shape with the consent gate: ;; precondition_fetch (ctx has id + payload + operator-confirmed) ;; -> guard (consent required) -> perform -> result -> on_error. ;; operator_confirmed rides in args so the driver's destructive-verb ;; gate sees it. Rate-limit retries with backoff; auth-stale escalates. ;; State is `perform` (not `act`) so it never shadows the descriptor ;; constructor of the same name in cartPrelude. (cart 'btn-publish '((author . "lacuna") (version . 1) (touches . (etsy-listings)) (read-only . #f))) (define (start ctx) (let ((id (ctx-get 'listing-id ctx)) (consent (ctx-get 'operator-confirmed ctx))) (cond ((null? id) (escalate 'missing-listing-id null)) ((not consent) (escalate 'consent-required null)) (else (next 'perform ctx))))) (define (perform ctx) (let ((id (ctx-get 'listing-id ctx))) (act 'etsy/publish (list id (list 'operator_confirmed #t)) 'check-result))) (define (check-result ctx) (let ((r (ctx-result ctx))) (cond ((eq? r 'ok) (done)) ((eq? r 'rate-limited) (after 30 'perform ctx)) ((eq? r 'auth-stale) (escalate 'auth-relogin null)) (else (escalate 'write-failed r)))))
EXAMPLES
Operator presses the green Publish button on a draft. Sakura confirms (the consent gate), Lacuna ships the listing live to Etsy, and on rate-limit she waits 30s and retries. If your token went stale, she escalates to relogin — never silently swallows the failure.
TIER
white
atomic · free · operator-commanded
FITNESS
Ready
Fits any shop today — this one has no sample-size floor.
SEE ALSO
HISTORY
canonical source: curator/docs/AUTOMATIONS-CANONICAL.md · §6-white-atomic-tools-142-baseline-149-post-matrix
last regenerated: 2026-06-05 20:31 UTC (mechanical — edits land in the MD or sidecars, not here)
KNOWN BUGS
(none recorded — flag in AUTOMATIONS-CANONICAL.md or open an issue against the cart file)