;;~ title    "Review themes · monthly"
;;~ author   "lacuna"
;;~ version  1
;;~ mode     automation
;;~ flavor   light-purple
;;~ id       review-themes-monthly
;;~ trigger  cron:monthly
;;~ touches  ()
;;~ summary  "Monthly: cluster the month's reviews into themes with concrete examples."

;; Monthly rollup. Fetch reviews for the past 30d, hand the bundle to
;; Sonnet for theme clustering + example quotations. Returns a
;; structured narrative the operator can read in two minutes.

(cart 'review-themes-monthly
  '((author    . "lacuna")
    (version   . 1)
    (read-only . #t)))

(define (start ctx)
  (let ((connected (ctx-get 'shop-connected ctx)))
    (cond
      ((not connected) (escalate 'shop-not-connected null))
      (else            (next 'fetch ctx)))))

(define (fetch ctx)
  (act 'etsy/reviews (list '30d) 'check-fetch))

(define (check-fetch ctx)
  (let ((r (ctx-result ctx)))
    (cond
      ((null? r)                       (escalate 'no-data null))
      ((eq? r 'rate-limited)           (after 30 'fetch ctx))
      (else                            (next 'reason (ctx-set 'reviews r ctx))))))

(define (reason ctx)
  (let ((reviews (ctx-get 'reviews ctx)))
    (act 'sakura/cloud-reason
         (list 'task 'review-themes-monthly reviews)
         'check-reason)))

(define (check-reason ctx)
  (let ((r (ctx-result ctx)))
    (cond
      ((null? r)                       (escalate 'cloud-empty null))
      ((not (string? r))               (escalate 'cloud-garbled null))
      ((eq? r 'cloud-quota-exhausted)  (escalate 'cloud-quota null))
      ((eq? r 'cloud-consent-required) (escalate 'cloud-consent null))
      (else                            (next 'announce (ctx-set 'themes r ctx))))))

(define (announce ctx) (done))