# weekly-recap

**Trigger:** cron, Mondays at 7:00 am Mountain Time.
**Cadence:** weekly.
**Agents (in order):** queen-coordinator -> brand-sentry (per brand) -> recap-composer (a plain template-based composer, not an agent; reads brand-sentry's digest and the template at /templates/weekly-recap-operator.md or /templates/weekly-recap-brand-hq.md) -> sendgrid send.
**Output:** one email per operator (single-store + multi-unit owners) and one email per brand HQ contact (Enterprise customers + 50%+ rollup recipients).
**SLA:** all emails dispatched by 8:00 am MT Monday.

## How it runs

1. Queen-coordinator gets the Monday tick. It enumerates brands with at least one paid or rollup-eligible customer.
2. For each brand, queen routes to brand-sentry, which produces the digest JSON described in /ops/agents/brand-sentry.md.
3. For each operator under that brand (single-store and multi-unit owners), the recap-composer takes the brand digest + the operator's per-location stats and fills in /templates/weekly-recap-operator.md.
4. For brand HQ contacts (Enterprise + 50%+ rollup), the recap-composer fills in /templates/weekly-recap-brand-hq.md.
5. Emails dispatch via sendgrid.

## What's in each recap

**Operator recap** (single-store and multi-unit owners):
- Rating per location, this week vs last 30.
- Open escalations and their status.
- One concrete recommendation, e.g. "your Wednesday afternoons keep getting wait-time complaints."
- The week's worst review, with the response that was approved.

**Brand HQ recap**:
- Brand-wide rating + delta.
- Topic clusters (cleanliness, wait time, etc.) that grew this week.
- Top 10 worst reviews across the brand.
- Locations with response-time slippage.
- Locations missing platform connections.

## Why Monday 7am MT

That's before most operators do their Monday huddle. The recap is on the table for the meeting, not catching up after it. MT because Durango is MT and most US franchise operators run on East/Central; 7am MT is 8/9 eastern, which is the start of the operations day for the largest cohort.

## Cost

Per brand: ~$0.50 (Opus 4.7 for brand-sentry is the dominant cost). At 50 brands, the weekly recap budget is $25/week.