claude-code/docs/plans/2025-01-02-morning-report-design.md

Morning Report System Design

Date: 2025-01-02 Status: Approved Author: PA + User collaboration

Overview

A daily morning dashboard that aggregates useful information into a single Markdown file, generated automatically via systemd timer and refreshable on-demand.

Output

• Format: Markdown
• Location: ~/.claude/reports/morning.md
• Archive: ~/.claude/reports/archive/YYYY-MM-DD.md (30 days retention)

Schedule

• Automatic: Systemd timer at 8:00 AM Pacific
• On-demand: /morning command for manual refresh

Report Sections

1. Weather

• Source: wttr.in (no API key)
• Location: Seattle, WA, USA
• LLM: Haiku (parse output, add hints like "bring umbrella")

2. Email

• Source: Gmail skill (existing)
• Display: Unread count, urgent highlights, top 5 emails
• LLM: Sonnet (triage urgency, summarize)

3. Calendar

• Source: gcal skill (existing)
• Display: Today's events + tomorrow preview
• LLM: None (structured JSON, Python formatting)

4. Stocks

• Source: stock-lookup skill (existing)
• Watchlist: CRWV, NVDA, MSFT
• Display: Price, daily change, trend indicator
• LLM: Haiku (format table, light commentary)

5. Tasks

• Source: Google Tasks API (new integration)
• Display: Pending items, due dates, top 5
• LLM: None (structured JSON, Python formatting)

6. Infrastructure

• Source: k8s-quick-status + sysadmin-health skills (existing)
• Display: Traffic light status (green/yellow/red)
• LLM: Haiku (interpret health output)
• Future: Enhanced detail levels (fc-042)

7. News

• Source: RSS feeds (Hacker News, Lobsters)
• Display: Top 5 headlines with scores
• LLM: Sonnet (summarize headlines)

Architecture

┌─────────────────────────────────────────────────────────────┐
│                    morning-report skill                      │
├─────────────────────────────────────────────────────────────┤
│  scripts/generate.py          # Main orchestrator            │
│  scripts/collectors/          # Data fetchers                │
│    ├── gmail.py               # Reuse existing gmail skill   │
│    ├── gcal.py                # Reuse existing gcal skill    │
│    ├── gtasks.py              # New: Google Tasks API        │
│    ├── stocks.py              # Reuse stock-lookup skill     │
│    ├── weather.py             # wttr.in integration          │
│    ├── infra.py               # K8s + workstation health     │
│    └── news.py                # RSS/Hacker News feeds        │
│  scripts/render.py            # Markdown templating          │
│  config.json                  # Watchlist, location, feeds   │
└─────────────────────────────────────────────────────────────┘

Configuration

File: ~/.claude/skills/morning-report/config.json

{
  "version": "1.0",
  "schedule": {
    "time": "08:00",
    "timezone": "America/Los_Angeles"
  },
  "output": {
    "path": "~/.claude/reports/morning.md",
    "archive": true,
    "archive_days": 30
  },
  "stocks": {
    "watchlist": ["CRWV", "NVDA", "MSFT"],
    "show_trend": true
  },
  "weather": {
    "location": "Seattle,WA,USA",
    "provider": "wttr.in"
  },
  "email": {
    "max_display": 5,
    "triage": true
  },
  "calendar": {
    "show_tomorrow": true
  },
  "tasks": {
    "max_display": 5,
    "show_due_dates": true
  },
  "infra": {
    "check_k8s": true,
    "check_workstation": true,
    "detail_level": "traffic_light"
  },
  "news": {
    "feeds": [
      {"name": "Hacker News", "url": "https://hnrss.org/frontpage", "limit": 3},
      {"name": "Lobsters", "url": "https://lobste.rs/rss", "limit": 2}
    ],
    "summarize": true
  }
}

LLM Delegation

Section	LLM Tier	Reason
Weather	Haiku	Parse wttr.in, add hints
Email	Sonnet	Triage urgency, summarize
Calendar	None	Structured JSON, template
Stocks	Haiku	Format, light commentary
Tasks	None	Structured JSON, template
Infra	Haiku	Interpret health output
News	Sonnet	Summarize headlines

Error Handling

Each collector is isolated - failures don't break the whole report.

Collector	Timeout	Retries	Fallback
Weather	5s	1	"Weather unavailable"
Email	10s	2	Show error + auth hint
Calendar	10s	2	Show error
Stocks	5s	1	Partial results per-symbol
Tasks	10s	2	Show error
Infra	15s	1	"Status unknown" (yellow)
News	10s	1	"News unavailable"

Logging

• Run logs: ~/.claude/logs/morning-report.log
• Systemd logs: journalctl --user -u morning-report

Implementation Order

1. Config + skeleton structure
2. Weather, Stocks, Infra collectors (easy wins)
3. Google Tasks collector (new OAuth scope)
4. News collector
5. Orchestrator + renderer
6. Systemd timer + /morning command

Future Considerations

• fc-041: Terminal output version (motd-style)
• fc-042: Enhanced infrastructure detail levels

Sample Output

# Morning Report - Thu Jan 2, 2025

## Weather
Seattle: 45°F, Partly Cloudy | High 52° Low 38° | Rain likely 3PM

## Email (3 unread, 1 urgent)
[!] From: boss@work.com - "Q4 numbers needed"
  * From: github.com - "PR #123 merged"
  * From: newsletter@tech.com - "Weekly digest"

## Today
  * 9:00 AM - Standup (30m)
  * 2:00 PM - 1:1 with Sarah (1h)
Tomorrow: 3 events, first at 10:00 AM

## Stocks
CRWV  $79.32  +10.8%    NVDA $188.85  +1.3%    MSFT $430.50  -0.2%

## Tasks (4 pending)
  * Finish quarterly report (due today)
  * Review PR #456
  * Book travel for conference
  * Call dentist

## Infrastructure
K8s Cluster: [OK]  |  Workstation: [OK]

## Tech News
  * "OpenAI announces GPT-5" (Hacker News, 342 pts)
  * "Rust 2.0 released" (Lobsters, 89 votes)
  * "Kubernetes 1.32 features" (Hacker News, 156 pts)

---
Generated: 2025-01-02 08:00:00 PT