weekly-report

name	weekly-report
description	Compile a weekly productivity report using Agent Monitor data — daily_sessions and daily_events trends, per-session costs from pricing engine, token volumes (input/output/cache_read/cache_write + baselines), tool usage top 20, session completion rates by status, and workflow intelligence metrics.

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