weekly-report

# Weekly Report

Generate a comprehensive weekly productivity report from Agent Monitor data.

## Input

The user provides: **$ARGUMENTS**

This may be:
- "this week" or empty (default: current week Mon-Sun)
- "last week" for the previous week
- A date range: "2025-04-07 to 2025-04-13"

## Procedure

1. **Fetch weekly data** from `http://localhost:4820`:
   - `GET /api/sessions?limit=200` — filter to target week (default sort: most recently updated first)
   - `GET /api/analytics` — aggregated analytics
   - `GET /api/pricing/cost` — cost data

2. **Build the weekly report**:

   ### 📊 Week at a Glance
   | Metric | This Week | Last Week | Change |
   |--------|-----------|-----------|--------|
   | Sessions | N | N | ↑/↓ N% |
   | Total Hours | N | N | ↑/↓ N% |
   | Tokens Used | N | N | ↑/↓ N% |
   | Total Cost | $X.XX | $X.XX | ↑/↓ N% |
   | Completion Rate | N% | N% | ↑/↓ |

   ### 🏆 Highlights
   - Most productive day (by sessions completed)
   - Longest session and what it accomplished
   - Most used tools and any new tools adopted
   - Notable achievements (complex tasks completed, errors resolved)

   ### 📈 Daily Breakdown
   | Day | Sessions | Hours | Cost | Completion |
   |-----|----------|-------|------|------------|
   For each day of the week with activity.

   ### 🔧 Tool Usage Report
   - Top 10 tools by invocation count
   - Tools with highest error rate
   - Tool usage distribution chart (text-based)

   ### 💡 Productivity Insights
   - Peak productivity hours
   - Average session duration and trend
   - Cost efficiency trend
   - Model usage distribution

   ### 🎯 Recommendations for Next Week
   - Based on error patterns: what to improve
   - Based on cost trends: optimization opportunities
   - Based on tool usage: workflow suggestions

## Output Format

Professional report format with:
- Executive summary (3 sentences max)
- Structured tables with week-over-week comparisons
- Emoji-prefixed section headers for scannability
- Actionable recommendations in priority order