Can now specify the week for the summary

Author: MrDesjardins

README.md

@@ -538,6 +538,14 @@ curl "http://localhost:8000/admin/llm-usage/summary?start_date=2026-02-01T00:00:
 curl -X POST "http://localhost:8000/admin/weekly-summary/trigger"
 ```
 
+or  for a specific week:
+
+```bash
+curl -X POST "http://10.0.0.181:8000/admin/weekly-summary/trigger" \
+  -H "Content-Type: application/json" \
+  -d '{"date": "2026-02-06"}'
+```
+
 **Get next scheduled run time:**
 ```bash
 curl "http://localhost:8000/admin/weekly-summary/next-run"

routes/admin.py

@@ -18,6 +18,13 @@
 config = get_config()
 templates = Jinja2Templates(directory="templates")
 
+
+class WeeklySummaryTriggerRequest(BaseModel):
+    """Request body for triggering weekly summary generation."""
+
+    date: Optional[str] = None  # Format: YYYY-MM-DD (e.g., "2026-02-04")
+
+
 # Client logs storage
 CLIENT_LOGS_DIR = Path("/tmp/audio-stream-client-logs")
 CLIENT_LOGS_FILE = CLIENT_LOGS_DIR / "client.log"
@@ -40,11 +47,20 @@ async def stats_page(request: Request):
 
 
 @router.post("/weekly-summary/trigger")
-def trigger_weekly_summary():
+def trigger_weekly_summary(
+    request: WeeklySummaryTriggerRequest = WeeklySummaryTriggerRequest(),
+):
     """
     Manually trigger the weekly summary generation.
 
     Useful for testing the weekly summary feature without waiting for Friday 11pm.
+
+    Request body (optional):
+    {
+        "date": "YYYY-MM-DD"  // Generate summary for the week containing this date
+    }
+
+    If no date is provided, generates summary for the current week.
     """
     if not config.weekly_summary_enabled:
         raise HTTPException(
@@ -54,16 +70,41 @@ def trigger_weekly_summary():
     try:
         from services.scheduler import trigger_weekly_summary_now
 
-        logger.info("Manual trigger of weekly summary requested")
-        trigger_weekly_summary_now()
+        # Parse the date if provided
+        target_date = None
+        if request.date:
+            try:
+                # Parse YYYY-MM-DD format
+                target_date = datetime.strptime(request.date, "%Y-%m-%d")
+                logger.info(
+                    f"Manual trigger of weekly summary requested for date: {request.date}"
+                )
+            except ValueError:
+                raise HTTPException(
+                    status_code=400,
+                    detail=f"Invalid date format. Expected YYYY-MM-DD, got: {request.date}",
+                )
+        else:
+            logger.info("Manual trigger of weekly summary requested for current week")
+
+        trigger_weekly_summary_now(target_date)
+
+        message = (
+            f"Weekly summary generation started for {request.date}. Check logs for progress."
+            if request.date
+            else "Weekly summary generation started for current week. Check logs for progress."
+        )
 
         return JSONResponse(
             {
                 "status": "triggered",
-                "message": "Weekly summary generation started. Check logs for progress.",
+                "message": message,
+                "date": request.date if request.date else "current",
             }
         )
 
+    except HTTPException:
+        raise
     except Exception as e:
         logger.error(f"Error triggering weekly summary: {e}", exc_info=True)
         raise HTTPException(status_code=500, detail=str(e))

services/scheduler.py

@@ -5,6 +5,8 @@
 """
 
 import logging
+from datetime import datetime
+from typing import Optional
 from apscheduler.schedulers.background import BackgroundScheduler  # type: ignore
 from apscheduler.triggers.cron import CronTrigger  # type: ignore
 from pytz import timezone  # type: ignore
@@ -88,15 +90,22 @@ def get_scheduler() -> BackgroundScheduler | None:
     return _scheduler
 
 
-def trigger_weekly_summary_now() -> None:
+def trigger_weekly_summary_now(target_date: Optional[datetime] = None) -> None:
     """
     Manually trigger the weekly summary job immediately.
 
     Useful for testing or manual runs.
+
+    Args:
+        target_date: Optional datetime to generate summary for.
+                     If None, uses current date.
     """
     try:
-        logger.info("Manually triggering weekly summary")
-        result = generate_and_save_weekly_summary()
+        if target_date:
+            logger.info(f"Manually triggering weekly summary for date: {target_date}")
+        else:
+            logger.info("Manually triggering weekly summary for current week")
+        result = generate_and_save_weekly_summary(target_date)
 
         if result:
             logger.info(f"Weekly summary created: {result['url']}")

services/weekly_summary.py

@@ -661,12 +661,18 @@ def _generate_and_attach_tts(
         return {"noteId": note_id, "url": _get_trilium_note_url(note_id)}
 
 
-def generate_and_save_weekly_summary() -> Optional[Dict[str, str]]:
+def generate_and_save_weekly_summary(
+    target_date: Optional[datetime] = None,
+) -> Optional[Dict[str, str]]:
     """
     Main function to generate and save weekly summary.
 
     This is called by the scheduler every Friday at 11pm Pacific.
 
+    Args:
+        target_date: Optional datetime to generate summary for.
+                     If None, uses current date. Used to generate summaries for past weeks.
+
     Behavior for existing summaries:
     - If audio file exists on disk:
       - Check if already attached to Trilium note
@@ -690,8 +696,8 @@ def generate_and_save_weekly_summary() -> Optional[Dict[str, str]]:
     try:
         logger.info("Starting weekly summary generation")
 
-        # Get current week number
-        now = datetime.now(timezone.utc)
+        # Get week number for target date (defaults to current date)
+        now = target_date if target_date else datetime.now(timezone.utc)
         year, week = get_week_number(now)
         week_year = f"{year}-W{week:02d}"
         logger.info(f"Generating summary for week {week_year}")