Weekly Report

Automated Monday-morning email summarizing the prior week's activity, costs, and risks.

Every Monday at 07:00 UTC Muster generates a weekly report covering the previous week (Mon 00:00 UTC → Sun 23:59 UTC) per project. The report is an HTML email with an executive summary, top cost drivers, risk posture, and concrete recommendations.

What's in the email

Summary — agent count and status distribution at week end
Cost — total spend with trend vs. prior week, top 5 agents by spend
Risk posture — count of agents at each risk level, biggest movers
Anomalies — count by type (COST_SPIKE, ERROR_SURGE, ACCURACY_DEGRADATION)
Hallucinations — count by type (arithmetic, reference, instability)
Accuracy — average pass rate, agents whose pass rate degraded
Recommendations — short bullets about which agents to look at

If a Gemini API key is configured (MUSTER_GEMINI_API_KEY), the narrative copy is generated by the LLM from the metrics. Without a key, Muster falls back to a deterministic template — content is the same, the tone is just less conversational.

Configuration

Per-project config lives in MusterReportConfig:

Field	Default	Effect
`enabled`	`true`	Master switch. False = no generation, no send.
`autoSend`	`true`	False = report still generates Monday, but admin must manually send.
`recipients`	`[]` (project members)	Override the recipient list with explicit email addresses.

To turn the report off entirely for a project: set enabled = false. To keep generating but not auto-mail: set autoSend = false and use the manual Send Now action.

Manual preview, generate, send

The Reports page in the project sidebar shows every previously generated report and lets you:

Preview the latest HTML report inline.
Generate Now — kicks off a fresh weeklyReport worker run immediately, useful for ad-hoc snapshots or end-of-month reviews.
Send Now — emails an existing report. Override recipients in the dialog if you want to send to a one-off list (e.g. a specific exec) without modifying the project's recipients config.

SMTP wiring

Email delivery uses whatever SMTP config Muster resolves from SMTP_CONNECTION_URL (env var) or the per-project SMTP override configured in the Super Admin Panel. If neither is set, the worker records error: "SMTP not configured" on the report row and skips delivery — generation still succeeds, the report is still viewable in the UI.

If recipients aren't getting the email:

Confirm SMTP_CONNECTION_URL is set on the worker container (not just the web container).
Check the MusterWeeklyReport.sentAt and error columns to distinguish "wasn't sent yet" from "sent failed".
Verify project member emails — by default recipients = [] falls back to every project member with an email on file.

Disabling for a single project

UPDATE muster_report_config
SET enabled = false
WHERE project_id = '...';

Or via the Reports page settings tab. The next Monday cron will skip this project entirely.