sonichi / morning-briefing

Morning Briefing

Generate a prioritized daily briefing from all your channels.

Usage: /morning-briefing

ARGUMENTS: $ARGUMENTS

What to gather

Step 0 — Calendar cache. CONDITIONAL: Google-calendar hosts only.

src/morning-briefing.py cannot reach the owner's Google Workspace calendar; it reads a cache the
agent writes. Omitting this is silent: the briefing reports "no calendar source is configured.
Connect Google Calendar via Settings → Integrations, or set MORNINGBRIEFINGCALENDAR_SOURCE=macos to
use the local Calendar app". Pull today's local-day events from the
Google connector (order: the Station connector; if not connected, the owner's own
mcp__claude_ai_Google_Calendar__* tools when present; otherwise the one-line note below), then:

echo '[{"raw":"9:00-9:30am 1:1 w/ Sam","calendar":"work"}]' | python3 src/write_calendar_cache.py
python3 src/write_calendar_cache.py --empty   # ONLY for a genuinely empty day

Hosts with no Google connector skip STEP 0 ONLY. The reader never touches the local macOS
Calendar or Reminders app on its own (they raise a macOS permission prompt); an owner who wants them
sets MORNING_BRIEFING_CALENDAR_SOURCE=macos once. Step 1 below still runs on every host. See
"Calendar source (Google Workspace) — activation" for the full contract.

A missing connector is one line of text, never a card. If composio_find reports the owner's
calendar or mail app connected: false, say so in the briefing ("Google Calendar isn't connected;
connect it in AG2 Space") and move on. The briefing is not an owner request: never post a connect
card or start a connect-apps wait from it.

Step 1 — Base data (canonical; runs on EVERY host, including hosts that skipped Step 0):

WORKSPACE="$(bash scripts/sutando-config.sh workspace)"
python3 src/morning-briefing.py

src/morning-briefing.py is the single source of truth for core briefing data: weather (Open-Meteo), the calendar cache (or macOS Calendar + Reminders, opt-in only), overnight Discord DMs, pending questions, and system health. It writes output to results/proactive-<ts>.txt and sends a Discord DM directly. Review its output before composing the full briefing — do NOT re-fetch those sources manually.

Then augment with the following if configured (skip if not available):

1. Email — Read the unread inbox through the Station Gmail connector (composio_find /
   composio_exec), or gws gmail +triage where the Station isn't available. Summarize top 5 by
   priority. Flag anything urgent.

2. GWS Calendar — If the user uses Google Calendar (not just macOS Calendar), run gws calendar +agenda --today. List any meetings not already covered by the macOS Calendar output above.
3. Friction check — Run python3 src/friction-detector.py. If friction items found, include as "⚠‹VARIATION SELECTOR U+FE0F› Friction: [count] items need attention" with the top 3.

How to deliver

src/morning-briefing.py already writes results/proactive-<ts>.txt (spoken by voice) and sends a Discord DM for the base data. If you gathered email in steps 1–3, append it as a follow-up proactive file:

echo "📧 Email: [count] unread. [summary]" > "$WORKSPACE/results/proactive-$(date +%s).txt"

Calendar source (Google Workspace) — activation

src/morning-briefing.py is a standalone script and cannot reach the owner's Google Workspace calendar — the Station/Composio connector is agent-only. So the briefing reads a cache that the agent produces:

• Producer: src/write_calendar_cache.py writes state/calendar-today.json — {"date": "YYYY-MM-DD", "events": [{"raw": "...", "calendar": "..."}]}, atomically (tmp + os.replace). date is today in local time so a stale cache is ignored, and events: [] means a verified-empty day (never rendered as "clear" from a missing cache). Feed it the events you pulled from the connector:

  echo '[{"raw":"9:00-9:30am 1:1 w/ Sam","calendar":"work"}]' | python3 src/write_calendar_cache.py
  python3 src/write_calendar_cache.py --empty   # verified no events today

• Reader: get_calendar_events() reads the cache. Set MORNING_BRIEFING_CALENDAR_SOURCE=google to make the cache the only trusted source — if it's missing/stale the briefing reports "couldn't read your calendar" rather than reading a local macOS Calendar that may not include the work account (the 2026-07-21 "falsely clear" bug, #2256). With no source at all it says "no calendar source is configured. Connect Google Calendar via Settings → Integrations, or set MORNINGBRIEFINGCALENDARSOURCE=macos to use the local Calendar app", and while reminders are not read: "Reminders not read: the local Reminders app is opt-in (set MORNINGBRIEFINGCALENDARSOURCE=macos to include it)".
• Local macOS Calendar + Reminders are opt-in: MORNING_BRIEFING_CALENDAR_SOURCE=macos (set by the owner, never by you), or the owner's host opt-in python3 skills/macos-tools/scripts/native_pim_consent.py grant. Reading them raises a macOS Automation prompt, so the default never touches them. One AppleScript read, no app launch, no retry; a denial (-1743) is recorded once in state/calendar-automation-denied (the shared native_pim_consent marker) and never re-asked — the owner grants access in System Settings and runs grant, which clears stored denials.

Nothing writes the cache automatically, so a briefing that only runs the reader reports unread on a Google-source host. The producer is therefore step 0 of this skill's own flow (above), which covers both /morning-briefing and a cron declared as "prompt_skill": "morning-briefing" — the natural config. The expanded cron prompt under "Scheduling" below remains valid but is no longer the only place the producer appears.

Observed on Chis-Mac-mini: state/calendar-today.json was last written 2026-07-30 07:28 and the host's cron was {"name": "morning-briefing", "prompt_skill": "morning-briefing"}, so nothing invoked the producer. Three consecutive briefings reported no calendar, and the local fallback added a ~23s AppleScript stall before returning nothing.

Scheduling

The canonical daily schedule produces the Google-calendar cache first, then runs the briefing against it (see the activation section above):

{
  "name": "morning-briefing",
  "cron": "57 6 * * *",
  "prompt": "Morning briefing. FIRST produce the calendar cache from the owner's REAL Google calendar (the standalone script can't reach the connector): pull today's events via the Google-calendar connector (e.g. sutando-station composio_exec GOOGLECALENDAR_EVENTS_LIST, calendarId=primary, today's local-day window), then pipe them as a JSON array of {raw,calendar} to `python3 src/write_calendar_cache.py` (or `--empty` if genuinely no events). THEN run `MORNING_BRIEFING_CALENDAR_SOURCE=google python3 src/morning-briefing.py` to deliver the briefing. Speak the result if voice is connected, send as Discord DM otherwise."
}

Calling /morning-briefing manually runs the same script plus GWS augmentation.