weekly-review

name	weekly-review
description	Weekly ADHD pattern summary with focus trends and insights
triggers	["weekly review","how was my week","weekly summary","weekly patterns"]

Weekly ADHD Pattern Review

Delivers a 7-day behavioral pattern summary. Triggered automatically on Sundays at 8 PM via HEARTBEAT, or on-demand.

How to Fetch Data

GET http://localhost:8420/insights/weekly

The response contains:

• avg_focus_percentage (0-100)
• avg_distraction_percentage (0-100)
• total_interventions (count)
• intervention_acceptance_rate (0-100%)
• best_focus_day (date string)
• worst_focus_day (date string)
• top_apps_weekly (list of {app_name, minutes, percentage})
• trend ("improving" | "declining" | "stable")
• daily_focus_scores (list of {date, focus_pct, distraction_pct})

Message Format

Structure the weekly review as a brief summary:

Opening (based on trend)

• Improving: "Your week showed real progress!"
• Stable: "Solid, consistent week. Here's the snapshot:"
• Declining: "This week was tough, and that's okay. Here's what happened:"

Key Stats (pick 2-3 most relevant)

• "Average focus: {avg_focus_percentage}%"
• "Best day: {best_focus_day}" (only if notably better)
• "You used {interventions} interventions and found {acceptance_rate}% helpful"

One Actionable Insight

Based on the data, offer ONE specific, actionable observation:

• If top distraction app is social media: "Instagram took {X} min this week. Maybe try putting it in a different room during focus blocks?"
• If trend is improving: "Whatever you did on {best_focus_day} worked — try to recreate those conditions."
• If trend is declining: "Rest is productive too. Consider a lighter schedule next week."

Rules

• Total message: 3-4 sentences max
• Lead with validation, not metrics
• ONE actionable takeaway (not a list of improvements)
• Never compare to previous weeks negatively
• Celebrate small wins explicitly

Error Handling

If backend is unreachable:

• Reply: "Couldn't pull your weekly data. Take a moment to reflect: what went well this week? What's one thing you'd adjust?"