From 83fcf797f98e3296b6a9019f70784dd1beb52654 Mon Sep 17 00:00:00 2001 From: Jean-Paul van Ravensberg <14926452+DevSecNinja@users.noreply.github.com> Date: Sat, 14 Nov 2026 11:44:34 +0100 Subject: [PATCH 01/11] feat(skills): add wazzup-mail-highlights mailbox digest skill Adds a Copilot/Cowork skill that scans the signed-in user's mailbox, picks the top highlights, and emails them a modern HTML digest with midnight (default) and editorial themes. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../skills/wazzup-mail-highlights/SKILL.md | 210 ++++++++++++++++++ .../templates/editorial.html | 72 ++++++ .../templates/midnight.html | 86 +++++++ README.md | 4 + 4 files changed, 372 insertions(+) create mode 100644 .github/skills/wazzup-mail-highlights/SKILL.md create mode 100644 .github/skills/wazzup-mail-highlights/templates/editorial.html create mode 100644 .github/skills/wazzup-mail-highlights/templates/midnight.html diff --git a/.github/skills/wazzup-mail-highlights/SKILL.md b/.github/skills/wazzup-mail-highlights/SKILL.md new file mode 100644 index 00000000..4bb84cfa --- /dev/null +++ b/.github/skills/wazzup-mail-highlights/SKILL.md @@ -0,0 +1,210 @@ +--- +name: wazzup-mail-highlights +description: Scan the signed-in user's mailbox, pick the top highlights (what needs them, decisions, deadlines, worth-knowing updates), and email them a polished, modern HTML digest. Use when asked for "mail highlights", "inbox digest", "what's important in my mailbox", "wazzup my inbox", or to send an email summary of recent mail to themselves. +--- + +# Wazzup mail highlights + +Deliver a short, high-signal digest of the user's mailbox as a slick, modern +HTML email sent **only to the user themself**. The skill folder (this file plus +`templates/`) works from Microsoft 365 Copilot Cowork and from GitHub Copilot +(CLI / VS Code) alike. + +## Guardrails + +- **Read-only on the mailbox.** Never reply to, forward, move, delete, flag, + categorize, or mark messages as read. The only write action allowed is + sending the digest. +- **Recipient is always the signed-in user.** Resolve the user's own primary + SMTP address (for example `GET /me` → `mail`). Never add other recipients, + CC, or BCC. If the user asks to send it elsewhere, confirm explicitly first. +- **Never copy secrets into the digest.** Skip or redact one-time codes, MFA + prompts, passwords, reset links, and full payment or identity numbers. +- For messages labelled Confidential / Highly Confidential, summarize at a + high level only and never quote the body. +- Do not invent facts, dates, or asks. Every highlight must trace back to a + real message and link to it. + +## Inputs (all optional) + +| Input | Default | +| ------------- | ------------------------------------------------------------------------ | +| Time window | Since the last Wazzup mail digest; otherwise last 24h (72h on Mondays) | +| Highlights | Up to 5 featured highlights, plus up to 6 quick hits | +| Folders | Inbox (Focused + Other); read sent items only to detect answered threads | +| VIPs | Manager, skip-level, direct reports, and people the user mailed recently | +| Language/tone | The user's language; crisp, friendly, no corporate filler | +| Time zone | The user's mailbox time zone (fall back to `Europe/Amsterdam`) | + +If the user gives explicit values ("last 3 days", "only top 3"), use them. + +## Step 1 — Collect + +Use whichever mail capability the host exposes, in this order of preference: + +1. **Cowork:** the built-in Outlook mail tools (search, read, send). +2. **GitHub Copilot:** Work IQ / Microsoft 365 MCP tools, or Microsoft Graph: + - `GET /me` and `GET /me/mailboxSettings` (name, address, time zone) + - `GET /me/mailFolders/inbox/messages?$filter=receivedDateTime ge {start}&$orderby=receivedDateTime desc&$top=100&$select=id,subject,from,toRecipients,ccRecipients,receivedDateTime,importance,flag,isRead,hasAttachments,bodyPreview,conversationId,inferenceClassification,webLink` + - `GET /me/manager` and `GET /me/directReports` to seed VIPs. + +To find the start of the window, search sent items for the most recent message +whose subject starts with `Wazzup ·`. Fetch full bodies only for candidates +that survive Step 2, and stop paging after ~300 messages. + +If no send-capable mail tool is available, stop before Step 5 and tell the user +which capability is missing instead of improvising another channel. + +## Step 2 — Filter out noise + +Drop messages that are: + +- Previous Wazzup digests, or anything the user sent to themself. +- Newsletters, marketing, social notifications, and bulk mail (look for + `List-Unsubscribe`, `noreply`/`no-reply` senders, or "Other" inference + classification) — unless they come from a VIP or mention the user directly. +- Calendar auto-responses (accepted/declined/tentative) with no added text. +- Automated alerts that self-resolved later in the same window. + +Collapse each conversation into one candidate, using the latest message for +status but all messages for context. + +## Step 3 — Score and pick + +Score each candidate 0–100 and keep the best. Weigh roughly: + +| Signal | Weight | +| ----------------------------------------------------------------------- | ------ | +| Explicit ask of the user (question, approval, review, "can you", @name) | +30 | +| Deadline or time-bound item within the next 7 days | +20 | +| Sender is a VIP | +20 | +| User is on **To** (not only CC), or the thread names them | +10 | +| High importance, or flagged by the user | +10 | +| Active thread (3+ replies in window) or a decision was made | +10 | +| Unread | +5 | +| User already replied after the latest message | −30 | +| Purely informational with no impact on the user | −15 | + +Assign each pick exactly one category: + +| Category | Use when | +| ----------- | -------------------------------------------------- | +| `NEEDS YOU` | The user must act, answer, approve, or attend | +| `DEADLINE` | A concrete due date or expiring item | +| `DECISION` | Something was decided or changed that affects them | +| `FYI` | Worth knowing, no action needed | + +Featured highlights are the top 3–5 by score, ordered `NEEDS YOU` → +`DEADLINE` → `DECISION` → `FYI`, then by score. The next up to 6 become quick +hits. If nothing clears ~40 points, send the "all quiet" variant instead of +padding the digest. + +## Step 4 — Write + +For every featured highlight, write: + +- **Headline:** rewrite the subject into a plain-language headline (max ~70 + characters). No `RE:`/`FW:` prefixes and no ticket noise. +- **Summary:** 1–2 sentences on what happened and why it matters to the user. +- **Next step:** one imperative line ("Approve the budget in the thread by + Thu 17:00"). For `FYI`, use "No action needed". +- **Meta:** sender display name, relative time ("2h ago", "Yesterday 16:40"), + and the message `webLink` for the "Open" button. + +For quick hits, write a single line: `Sender — what it is`, linked to the +message. + +Also write: + +- **TL;DR:** one sentence covering the overall picture ("Two approvals are + waiting on you and the launch moved to Friday."). +- **Preheader:** ~90 characters shown in the inbox preview, based on the TL;DR. +- **Greeting:** "Good morning/afternoon/evening, {first name}" by local time. + +HTML-escape all mail-derived text (`&`, `<`, `>`, `"`). Never paste raw email +HTML into the digest. + +## Step 5 — Render and send + +### Pick a theme + +| Theme | Look | Template | +| ----------- | -------------------------------------------------------------------- | ---------------------------------------------------- | +| `midnight` | Default. Dark Wazzup hero with stats, light cards with accent rails | [templates/midnight.html](templates/midnight.html) | +| `editorial` | Warm paper, serif headlines, numbered stories, dark quick-hits panel | [templates/editorial.html](templates/editorial.html) | + +Use `midnight` unless the user asks for `editorial` (for example "editorial +style", "newspaper look", or "weekend edition"). Read the chosen template file +from this skill's folder and fill it in; do not redesign it. + +### Fill the template + +Each template marks repeatable blocks with HTML comments. Repeat +`…` once per featured highlight and +`…` once per quick hit. Remove the whole +`…` section when there are none. In +`editorial`, drop the `` row before the first highlight. Strip +the marker comments from the final HTML. + +| Placeholder | Value | +| ------------------------------- | ----------------------------------------------------------------------------------------------------- | +| `{{PREHEADER}}` | Preheader text | +| `{{DATE_LABEL}}` | `Saturday 14 November` (`midnight`), `Sat 14 Nov 2026` (`editorial`) | +| `{{GREETING}}` | Greeting line | +| `{{TLDR}}` | TL;DR sentence | +| `{{STAT_SCANNED}}` | Emails scanned after paging | +| `{{STAT_NEEDS_YOU}}` | Featured items in `NEEDS YOU` | +| `{{STAT_DEADLINES}}` | Featured items in `DEADLINE` | +| `{{WINDOW_LABEL}}` | Window, for example `Fri 07:00 – Sat 08:00` | +| `{{INDEX}}` | `editorial` only: `01`, `02`, … | +| `{{CATEGORY}}` | `NEEDS YOU`, `DEADLINE`, `DECISION`, or `FYI` | +| `{{ACCENT}}` | Category accent for the chosen theme (table below) | +| `{{HEADLINE}}` / `{{SUMMARY}}` | Highlight headline and summary | +| `{{NEXT_STEP}}` | Next step; in `editorial` it is the link text, so use "Read the thread" instead of "No action needed" | +| `{{SENDER}}` / `{{WHEN}}` | Sender display name and relative time | +| `{{WEBLINK}}` | Message `webLink` | +| `{{QH_SENDER}}` / `{{QH_TEXT}}` | Quick hit sender and one-liner | +| `{{QH_WEBLINK}}` | Quick hit message `webLink` | + +| Category | `midnight` accent | `editorial` accent | +| ----------- | ----------------- | ------------------ | +| `NEEDS YOU` | `#e11d48` | `#c2410c` | +| `DEADLINE` | `#d97706` | `#b45309` | +| `DECISION` | `#7c3aed` | `#6d28d9` | +| `FYI` | `#0891b2` | `#0e7490` | + +Rendering rules: keep the template's table-based layout and inline styles so +it renders in Outlook desktop, Outlook on the web, mobile, and Gmail. Never add +JavaScript, external CSS, web fonts, or remote images. + +### "All quiet" variant + +When nothing is worth highlighting, set `{{TLDR}}` to "Nothing needs you right +now. Enjoy the calm.", remove every highlight and the quick-hits section, and +keep the header, stats, and footer. + +### Send + +Send it as HTML (`contentType: HTML`) to the user's own address with subject: + +```text +Wazzup · {Weekday d MMM} · {n} need you +``` + +Use `Wazzup · {Weekday d MMM} · All quiet` when nothing needs the user. With +Graph, use `POST /me/sendMail` with `saveToSentItems: true` so the next run +can find the window start. + +After sending, reply in chat with one line: how many emails were scanned, how +many highlights were sent, the theme, and the subject line. Do not repeat the +digest. + +## Installing + +- **GitHub Copilot (CLI / VS Code):** discovered automatically from + `.github/skills/wazzup-mail-highlights/` in this repository. Copy the folder + to `~/.copilot/skills/` to use it in other repositories. +- **Microsoft 365 Copilot Cowork:** copy the whole `wazzup-mail-highlights` + folder (including `templates/`) to OneDrive at + `/Documents/Cowork/skills/wazzup-mail-highlights/`, or upload it from + Cowork's Customize page. diff --git a/.github/skills/wazzup-mail-highlights/templates/editorial.html b/.github/skills/wazzup-mail-highlights/templates/editorial.html new file mode 100644 index 00000000..52e673d2 --- /dev/null +++ b/.github/skills/wazzup-mail-highlights/templates/editorial.html @@ -0,0 +1,72 @@ + + + + + +Wazzup · {{DATE_LABEL}} + + +
{{PREHEADER}} ͏ ͏ ͏ ͏ ͏
+ + +
+ + + + + + + + + + + + + + + + + + +
+ + + +
Wazzup.Inbox edition
{{DATE_LABEL}}
+
+

{{GREETING}}

+

{{TLDR}}

+

{{STAT_SCANNED}} emails read  /  {{STAT_NEEDS_YOU}} need you  /  {{STAT_DEADLINES}} due soon

+
+ + + + + + + + + + +
 
{{INDEX}} +

{{CATEGORY}} · {{SENDER}} · {{WHEN}}

+

{{HEADLINE}}

+

{{SUMMARY}}

+ {{NEXT_STEP}} → +
+
+ + +
+

Also in your inbox

+ +

{{QH_SENDER}} — {{QH_TEXT}}

+ +
+
+ Covering {{WINDOW_LABEL}} · Read-only scan, nothing in your mailbox was changed.
+ Made with ☕ by Wazzup mail highlights +
+
+ + diff --git a/.github/skills/wazzup-mail-highlights/templates/midnight.html b/.github/skills/wazzup-mail-highlights/templates/midnight.html new file mode 100644 index 00000000..c595eeb1 --- /dev/null +++ b/.github/skills/wazzup-mail-highlights/templates/midnight.html @@ -0,0 +1,86 @@ + + + + + + + +Wazzup · {{DATE_LABEL}} + + +
{{PREHEADER}} ͏ ͏ ͏ ͏ ͏
+ + +
+ + + + + + + + + + + +
+ + + +
● Wazzup{{DATE_LABEL}}
+

{{GREETING}}

+

{{TLDR}}

+ + + + + + +
+ {{STAT_SCANNED}} + Scanned + + {{STAT_NEEDS_YOU}} + Need you + + {{STAT_DEADLINES}} + Deadlines +
+
+

Top highlights

+ + + + + + + +
  + {{CATEGORY}} +

{{HEADLINE}}

+

{{SUMMARY}}

+

→ {{NEXT_STEP}}

+ + + +
{{SENDER}} · {{WHEN}}Open ›
+
+ + + +

Quick hits

+ + + + +
+ ●  {{QH_SENDER}} — {{QH_TEXT}} +
+ +
+ Covering {{WINDOW_LABEL}} · Read-only scan, nothing in your mailbox was changed.
+ Made with ☕ by Wazzup mail highlights +
+
+ + diff --git a/README.md b/README.md index d2dc39b7..c0ad0020 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,10 @@ Wazzup is a GitHub-native personal news briefing app. It collects configured RSS - [config/sources.yml](config/sources.yml) maintains the RSS/Atom source registry with short source tags, broad category tags, source weights, and feed-specific interest hints. - [config/interests.yml](config/interests.yml) configures English summaries, 3-day retention, `Europe/Amsterdam`, and weighted interests for security, AI/developer platforms, cloud, and Microsoft. +## AI skills + +- [wazzup-mail-highlights](.github/skills/wazzup-mail-highlights/SKILL.md) scans your mailbox from GitHub Copilot or Microsoft 365 Copilot Cowork and emails you the top highlights as a modern HTML digest, with `midnight` (default) and `editorial` themes. + ## Implemented app 1. Fetch configured RSS/Atom feeds from GitHub Actions every two hours at 07:00, 09:00, ... 21:00 Europe/Amsterdam. From 7af3277ae14faaf4a026c0ad0a48ab8fc7d8ef11 Mon Sep 17 00:00:00 2001 From: Jean-Paul van Ravensberg <14926452+DevSecNinja@users.noreply.github.com> Date: Sat, 14 Nov 2026 12:43:50 +0100 Subject: [PATCH 02/11] feat(skills): add obsidian theme to wazzup-mail-highlights Adds a dark HUD-style theme adapted from the Gemini prototype, with signal meter, category tag chips, and terminal action boxes. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../skills/wazzup-mail-highlights/SKILL.md | 88 ++++++---- .../templates/obsidian.html | 162 ++++++++++++++++++ README.md | 2 +- 3 files changed, 217 insertions(+), 35 deletions(-) create mode 100644 .github/skills/wazzup-mail-highlights/templates/obsidian.html diff --git a/.github/skills/wazzup-mail-highlights/SKILL.md b/.github/skills/wazzup-mail-highlights/SKILL.md index 4bb84cfa..bd963afb 100644 --- a/.github/skills/wazzup-mail-highlights/SKILL.md +++ b/.github/skills/wazzup-mail-highlights/SKILL.md @@ -128,14 +128,16 @@ HTML into the digest. ### Pick a theme -| Theme | Look | Template | -| ----------- | -------------------------------------------------------------------- | ---------------------------------------------------- | -| `midnight` | Default. Dark Wazzup hero with stats, light cards with accent rails | [templates/midnight.html](templates/midnight.html) | -| `editorial` | Warm paper, serif headlines, numbered stories, dark quick-hits panel | [templates/editorial.html](templates/editorial.html) | +| Theme | Look | Template | +| ----------- | ------------------------------------------------------------------------ | ---------------------------------------------------- | +| `midnight` | Default. Dark Wazzup hero with stats, light cards with accent rails | [templates/midnight.html](templates/midnight.html) | +| `editorial` | Warm paper, serif headlines, numbered stories, dark quick-hits panel | [templates/editorial.html](templates/editorial.html) | +| `obsidian` | Fully dark HUD: signal meter, monospace telemetry, terminal action boxes | [templates/obsidian.html](templates/obsidian.html) | -Use `midnight` unless the user asks for `editorial` (for example "editorial -style", "newspaper look", or "weekend edition"). Read the chosen template file -from this skill's folder and fill it in; do not redesign it. +Use `midnight` unless the user asks for another theme, for example `editorial` +for "editorial style", "newspaper look", or "weekend edition", and `obsidian` +for "dark mode", "HUD", or "terminal look". Read the chosen template file from +this skill's folder and fill it in; do not redesign it. ### Fill the template @@ -143,35 +145,53 @@ Each template marks repeatable blocks with HTML comments. Repeat `…` once per featured highlight and `…` once per quick hit. Remove the whole `…` section when there are none. In -`editorial`, drop the `` row before the first highlight. Strip +`editorial`, drop the `` row before the first highlight. In +`obsidian`, drop the `` chip when a highlight has no tag. Strip the marker comments from the final HTML. -| Placeholder | Value | -| ------------------------------- | ----------------------------------------------------------------------------------------------------- | -| `{{PREHEADER}}` | Preheader text | -| `{{DATE_LABEL}}` | `Saturday 14 November` (`midnight`), `Sat 14 Nov 2026` (`editorial`) | -| `{{GREETING}}` | Greeting line | -| `{{TLDR}}` | TL;DR sentence | -| `{{STAT_SCANNED}}` | Emails scanned after paging | -| `{{STAT_NEEDS_YOU}}` | Featured items in `NEEDS YOU` | -| `{{STAT_DEADLINES}}` | Featured items in `DEADLINE` | -| `{{WINDOW_LABEL}}` | Window, for example `Fri 07:00 – Sat 08:00` | -| `{{INDEX}}` | `editorial` only: `01`, `02`, … | -| `{{CATEGORY}}` | `NEEDS YOU`, `DEADLINE`, `DECISION`, or `FYI` | -| `{{ACCENT}}` | Category accent for the chosen theme (table below) | -| `{{HEADLINE}}` / `{{SUMMARY}}` | Highlight headline and summary | -| `{{NEXT_STEP}}` | Next step; in `editorial` it is the link text, so use "Read the thread" instead of "No action needed" | -| `{{SENDER}}` / `{{WHEN}}` | Sender display name and relative time | -| `{{WEBLINK}}` | Message `webLink` | -| `{{QH_SENDER}}` / `{{QH_TEXT}}` | Quick hit sender and one-liner | -| `{{QH_WEBLINK}}` | Quick hit message `webLink` | - -| Category | `midnight` accent | `editorial` accent | -| ----------- | ----------------- | ------------------ | -| `NEEDS YOU` | `#e11d48` | `#c2410c` | -| `DEADLINE` | `#d97706` | `#b45309` | -| `DECISION` | `#7c3aed` | `#6d28d9` | -| `FYI` | `#0891b2` | `#0e7490` | +Shared placeholders: + +| Placeholder | Value | +| ------------------------------- | --------------------------------------------------------------- | +| `{{PREHEADER}}` | Preheader text | +| `{{DATE_LABEL}}` | `Saturday 14 November` (`midnight`), `Sat 14 Nov 2026` (others) | +| `{{GREETING}}` | Greeting line | +| `{{TLDR}}` | TL;DR sentence | +| `{{STAT_SCANNED}}` | Emails scanned after paging | +| `{{STAT_NEEDS_YOU}}` | Featured items in `NEEDS YOU` | +| `{{STAT_DEADLINES}}` | Featured items in `DEADLINE` | +| `{{WINDOW_LABEL}}` | Window, for example `Fri 07:00 – Sat 08:00` | +| `{{CATEGORY}}` | `NEEDS YOU`, `DEADLINE`, `DECISION`, or `FYI` | +| `{{ACCENT}}` | Category accent for the chosen theme (table below) | +| `{{HEADLINE}}` / `{{SUMMARY}}` | Highlight headline and summary | +| `{{NEXT_STEP}}` | Next step (see theme notes) | +| `{{SENDER}}` / `{{WHEN}}` | Sender display name and relative time | +| `{{WEBLINK}}` | Message `webLink` | +| `{{QH_SENDER}}` / `{{QH_TEXT}}` | Quick hit sender and one-liner | +| `{{QH_WEBLINK}}` | Quick hit message `webLink` | + +Theme-specific placeholders: + +| Placeholder | Theme | Value | +| -------------------------------------------------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------- | +| `{{INDEX}}` | `editorial`, `obsidian` | Highlight position: `01`, `02`, … | +| `{{NEXT_STEP}}` | `editorial` | Used as link text, so write "Read the thread" instead of "No action needed" | +| `{{NEXT_LABEL}}` | `obsidian` | `NEXT`, or `STATUS` when the next step is "No action needed" | +| `{{TAG}}` | `obsidian` | Short uppercase chip (≤ 16 chars) with the key fact: amount, due time, or type (`€42K SIGN-OFF`) | +| `{{ACCENT_SOFT}}` / `{{ACCENT_EDGE}}` | `obsidian` | Category soft and edge colors (table below) | +| `{{STAT_DECISIONS}}` | `obsidian` | Featured items in `DECISION` | +| `{{HIGHLIGHT_COUNT}}` / `{{QUICK_HIT_COUNT}}` | `obsidian` | Number of featured highlights / quick hits | +| `{{QH_INDEX}}` | `obsidian` | Quick hit position: `01`, `02`, … | +| `{{NOISE_PCT}}` | `obsidian` | `round(100 × (scanned − featured − quick hits) / scanned)` | +| `{{SEG_NEEDS_YOU}}`, `{{SEG_DEADLINE}}`, `{{SEG_DECISION}}`, `{{SEG_FYI}}` | `obsidian` | Meter widths: `6 ×` featured items in that category (quick hits count as `FYI`); remove a segment cell whose width is `0` | +| `{{SEG_NOISE}}` | `obsidian` | `100 −` the other segments (keep at least `40`; scale the others down if needed) | + +| Category | `midnight` | `editorial` | `obsidian` accent / soft / edge | +| ----------- | ---------- | ----------- | --------------------------------- | +| `NEEDS YOU` | `#e11d48` | `#c2410c` | `#e11d48` / `#fb7185` / `#331a2c` | +| `DEADLINE` | `#d97706` | `#b45309` | `#d97706` / `#fbbf24` / `#3d2a14` | +| `DECISION` | `#7c3aed` | `#6d28d9` | `#7c3aed` / `#a78bfa` / `#2a1f4a` | +| `FYI` | `#0891b2` | `#0e7490` | `#0891b2` / `#22d3ee` / `#164e63` | Rendering rules: keep the template's table-based layout and inline styles so it renders in Outlook desktop, Outlook on the web, mobile, and Gmail. Never add diff --git a/.github/skills/wazzup-mail-highlights/templates/obsidian.html b/.github/skills/wazzup-mail-highlights/templates/obsidian.html new file mode 100644 index 00000000..e68f860e --- /dev/null +++ b/.github/skills/wazzup-mail-highlights/templates/obsidian.html @@ -0,0 +1,162 @@ + + + + + + + + +Wazzup · {{DATE_LABEL}} + + + + +
{{PREHEADER}} ͏ ͏ ͏ ͏ ͏
+ + + +
+ + + + + + + + + + + + + + + +
 
+ + + +
+ + +
● WAZZUP // INBOX HUD
+
{{DATE_LABEL}}
+ +

{{GREETING}}

+

{{TLDR}}

+ + + + +
+ + + +
Signal filter · {{WINDOW_LABEL}}{{NOISE_PCT}}% NOISE SUPPRESSED
+ + + + + + +
     
+
+ + + + + + + + + + +
+ {{STAT_SCANNED}} + Scanned +   + {{STAT_NEEDS_YOU}} + Need you +   + {{STAT_DEADLINES}} + Deadlines +   + {{STAT_DECISIONS}} + Decisions +
+
+ + + +
■ Priority queue ({{HIGHLIGHT_COUNT}})RANKED BY URGENCY
+ + + + + + + +
  + + + +
+ {{CATEGORY}} + + {{TAG}} + + {{INDEX}} / {{HIGHLIGHT_COUNT}}
+

{{HEADLINE}}

+

{{SUMMARY}}

+ + +
{{NEXT_LABEL}} →  {{NEXT_STEP}}
+ + + +
{{SENDER}} · {{WHEN}}Open thread ↗
+
+ + + + + +
◆ Quick hits · worth knowing ({{QUICK_HIT_COUNT}})
+ + + + +
+ + + + +
{{QH_INDEX}}{{QH_SENDER}} — {{QH_TEXT}}›
+
+ +
+ WINDOW: {{WINDOW_LABEL}} · {{STAT_SCANNED}} emails scanned · Read-only scan, nothing in your mailbox was changed.
+ Made with ☕ by Wazzup mail highlights +
+
+ + diff --git a/README.md b/README.md index c0ad0020..baab4f06 100644 --- a/README.md +++ b/README.md @@ -19,7 +19,7 @@ Wazzup is a GitHub-native personal news briefing app. It collects configured RSS ## AI skills -- [wazzup-mail-highlights](.github/skills/wazzup-mail-highlights/SKILL.md) scans your mailbox from GitHub Copilot or Microsoft 365 Copilot Cowork and emails you the top highlights as a modern HTML digest, with `midnight` (default) and `editorial` themes. +- [wazzup-mail-highlights](.github/skills/wazzup-mail-highlights/SKILL.md) scans your mailbox from GitHub Copilot or Microsoft 365 Copilot Cowork and emails you the top highlights as a modern HTML digest, with `midnight` (default), `editorial`, and `obsidian` themes. ## Implemented app From d4f05fb44460a2eda563ac93d89716e8ea2a9f9e Mon Sep 17 00:00:00 2001 From: Jean-Paul van Ravensberg <14926452+DevSecNinja@users.noreply.github.com> Date: Sat, 14 Nov 2026 13:28:04 +0100 Subject: [PATCH 03/11] fix(skills): make mail highlight templates dark-mode safe and reusable Outlook on the web dark mode recolors every computed color and ignores color-scheme opt-outs; it only keeps pure black, saturated colors, and light text. Dark palettes and the obsidian theme now use pure black surfaces with saturated accents and transparent or accent borders, verified in Outlook on the web dark mode. Also parameterizes mailbox-specific labels with per-theme defaults, splits SLOT (color) from CATEGORY_LABEL (text), and clarifies relative time, greeting cut-offs, meter rounding, subject date format, marker stripping, time zone fallback, and pre-send compaction. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../skills/wazzup-mail-highlights/SKILL.md | 143 ++++++++++++------ .../templates/editorial.html | 63 +++++--- .../templates/midnight.html | 65 +++++--- .../templates/obsidian.html | 87 +++++------ 4 files changed, 219 insertions(+), 139 deletions(-) diff --git a/.github/skills/wazzup-mail-highlights/SKILL.md b/.github/skills/wazzup-mail-highlights/SKILL.md index bd963afb..4dbe1883 100644 --- a/.github/skills/wazzup-mail-highlights/SKILL.md +++ b/.github/skills/wazzup-mail-highlights/SKILL.md @@ -34,9 +34,11 @@ HTML email sent **only to the user themself**. The skill folder (this file plus | Folders | Inbox (Focused + Other); read sent items only to detect answered threads | | VIPs | Manager, skip-level, direct reports, and people the user mailed recently | | Language/tone | The user's language; crisp, friendly, no corporate filler | -| Time zone | The user's mailbox time zone (fall back to `Europe/Amsterdam`) | +| Time zone | The user's mailbox time zone; fall back to `Europe/Amsterdam` | If the user gives explicit values ("last 3 days", "only top 3"), use them. +Work IQ often denies `/me/mailboxSettings`, so the time zone fallback is the +normal path there; do not treat it as an error. ## Step 1 — Collect @@ -87,12 +89,16 @@ Score each candidate 0–100 and keep the best. Weigh roughly: Assign each pick exactly one category: -| Category | Use when | -| ----------- | -------------------------------------------------- | -| `NEEDS YOU` | The user must act, answer, approve, or attend | -| `DEADLINE` | A concrete due date or expiring item | -| `DECISION` | Something was decided or changed that affects them | -| `FYI` | Worth knowing, no action needed | +| Category | Slot | Use when | +| ----------- | ----------- | -------------------------------------------------- | +| `NEEDS YOU` | `needs-you` | The user must act, answer, approve, or attend | +| `DEADLINE` | `deadline` | A concrete due date or expiring item | +| `DECISION` | `decision` | Something was decided or changed that affects them | +| `FYI` | `fyi` | Worth knowing, no action needed | + +The slot drives colors; the category is the label text. For mailbox digests +they match, but other content (for example news) can keep the four slots and +use its own labels. Featured highlights are the top 3–5 by score, ordered `NEEDS YOU` → `DEADLINE` → `DECISION` → `FYI`, then by score. The next up to 6 become quick @@ -108,8 +114,10 @@ For every featured highlight, write: - **Summary:** 1–2 sentences on what happened and why it matters to the user. - **Next step:** one imperative line ("Approve the budget in the thread by Thu 17:00"). For `FYI`, use "No action needed". -- **Meta:** sender display name, relative time ("2h ago", "Yesterday 16:40"), - and the message `webLink` for the "Open" button. +- **Meta:** sender display name, relative time, and the message `webLink` for + the "Open" button. Relative time, rounded down: under 1 hour `{m}m ago`; + same day `{h}h ago`; yesterday `Yesterday HH:mm`; within 7 days + `Ddd HH:mm` (`Thu 09:12`); older `d MMM` (`3 Nov`). For quick hits, write a single line: `Sender — what it is`, linked to the message. @@ -119,7 +127,8 @@ Also write: - **TL;DR:** one sentence covering the overall picture ("Two approvals are waiting on you and the launch moved to Friday."). - **Preheader:** ~90 characters shown in the inbox preview, based on the TL;DR. -- **Greeting:** "Good morning/afternoon/evening, {first name}" by local time. +- **Greeting:** "Good morning, {first name}" from 05:00 to 11:59, "Good + afternoon" from 12:00 to 17:59, otherwise "Good evening" (local time). HTML-escape all mail-derived text (`&`, `<`, `>`, `"`). Never paste raw email HTML into the digest. @@ -128,11 +137,11 @@ HTML into the digest. ### Pick a theme -| Theme | Look | Template | -| ----------- | ------------------------------------------------------------------------ | ---------------------------------------------------- | -| `midnight` | Default. Dark Wazzup hero with stats, light cards with accent rails | [templates/midnight.html](templates/midnight.html) | -| `editorial` | Warm paper, serif headlines, numbered stories, dark quick-hits panel | [templates/editorial.html](templates/editorial.html) | -| `obsidian` | Fully dark HUD: signal meter, monospace telemetry, terminal action boxes | [templates/obsidian.html](templates/obsidian.html) | +| Theme | Look | Template | +| ----------- | --------------------------------------------------------------------- | ---------------------------------------------------- | +| `midnight` | Default. Dark Wazzup hero with stats, light cards with accent rails | [templates/midnight.html](templates/midnight.html) | +| `editorial` | Warm paper, serif headlines, numbered stories, dark quick-hits panel | [templates/editorial.html](templates/editorial.html) | +| `obsidian` | Black HUD: signal meter, monospace telemetry, accent-outlined actions | [templates/obsidian.html](templates/obsidian.html) | Use `midnight` unless the user asks for another theme, for example `editorial` for "editorial style", "newspaper look", or "weekend edition", and `obsidian` @@ -146,8 +155,7 @@ Each template marks repeatable blocks with HTML comments. Repeat `…` once per quick hit. Remove the whole `…` section when there are none. In `editorial`, drop the `` row before the first highlight. In -`obsidian`, drop the `` chip when a highlight has no tag. Strip -the marker comments from the final HTML. +`obsidian`, drop the `` chip when a highlight has no tag. Shared placeholders: @@ -158,45 +166,81 @@ Shared placeholders: | `{{GREETING}}` | Greeting line | | `{{TLDR}}` | TL;DR sentence | | `{{STAT_SCANNED}}` | Emails scanned after paging | -| `{{STAT_NEEDS_YOU}}` | Featured items in `NEEDS YOU` | -| `{{STAT_DEADLINES}}` | Featured items in `DEADLINE` | +| `{{STAT_NEEDS_YOU}}` | Featured items in the `needs-you` slot | +| `{{STAT_DEADLINES}}` | Featured items in the `deadline` slot | | `{{WINDOW_LABEL}}` | Window, for example `Fri 07:00 – Sat 08:00` | -| `{{CATEGORY}}` | `NEEDS YOU`, `DEADLINE`, `DECISION`, or `FYI` | -| `{{ACCENT}}` | Category accent for the chosen theme (table below) | +| `{{SLOT}}` | `needs-you`, `deadline`, `decision`, or `fyi` | +| `{{CATEGORY_LABEL}}` | Label text, for example `NEEDS YOU` | +| `{{ACCENT}}` | Slot accent for the chosen theme (table below) | | `{{HEADLINE}}` / `{{SUMMARY}}` | Highlight headline and summary | | `{{NEXT_STEP}}` | Next step (see theme notes) | | `{{SENDER}}` / `{{WHEN}}` | Sender display name and relative time | | `{{WEBLINK}}` | Message `webLink` | | `{{QH_SENDER}}` / `{{QH_TEXT}}` | Quick hit sender and one-liner | | `{{QH_WEBLINK}}` | Quick hit message `webLink` | +| `{{FOOTER_NOTE}}` | `Read-only scan, nothing in your mailbox was changed.` | + +Label placeholders keep the templates reusable for non-mail content. For a +mailbox digest, use these defaults: + +| Placeholder | `midnight` | `editorial` | `obsidian` | +| -------------------------- | ---------------- | -------------------- | ---------------------------- | +| `{{EDITION_LABEL}}` | — | `Inbox edition` | `INBOX HUD` | +| `{{STAT_LABEL_SCANNED}}` | `Scanned` | `emails read` | `Scanned` | +| `{{STAT_LABEL_NEEDS_YOU}}` | `Need you` | `need you` | `Need you` | +| `{{STAT_LABEL_DEADLINES}}` | `Deadlines` | `due soon` | `Deadlines` | +| `{{STAT_LABEL_DECISIONS}}` | — | — | `Decisions` | +| `{{HIGHLIGHTS_LABEL}}` | `Top highlights` | — | `Priority queue` | +| `{{QUICK_HITS_LABEL}}` | `Quick hits` | `Also in your inbox` | `Quick hits · worth knowing` | +| `{{OPEN_LABEL}}` | `Open` | — | `Open thread` | +| `{{RANKING_LABEL}}` | — | — | `RANKED BY URGENCY` | +| `{{NOISE_LABEL}}` | — | — | `NOISE SUPPRESSED` | Theme-specific placeholders: -| Placeholder | Theme | Value | -| -------------------------------------------------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------- | -| `{{INDEX}}` | `editorial`, `obsidian` | Highlight position: `01`, `02`, … | -| `{{NEXT_STEP}}` | `editorial` | Used as link text, so write "Read the thread" instead of "No action needed" | -| `{{NEXT_LABEL}}` | `obsidian` | `NEXT`, or `STATUS` when the next step is "No action needed" | -| `{{TAG}}` | `obsidian` | Short uppercase chip (≤ 16 chars) with the key fact: amount, due time, or type (`€42K SIGN-OFF`) | -| `{{ACCENT_SOFT}}` / `{{ACCENT_EDGE}}` | `obsidian` | Category soft and edge colors (table below) | -| `{{STAT_DECISIONS}}` | `obsidian` | Featured items in `DECISION` | -| `{{HIGHLIGHT_COUNT}}` / `{{QUICK_HIT_COUNT}}` | `obsidian` | Number of featured highlights / quick hits | -| `{{QH_INDEX}}` | `obsidian` | Quick hit position: `01`, `02`, … | -| `{{NOISE_PCT}}` | `obsidian` | `round(100 × (scanned − featured − quick hits) / scanned)` | -| `{{SEG_NEEDS_YOU}}`, `{{SEG_DEADLINE}}`, `{{SEG_DECISION}}`, `{{SEG_FYI}}` | `obsidian` | Meter widths: `6 ×` featured items in that category (quick hits count as `FYI`); remove a segment cell whose width is `0` | -| `{{SEG_NOISE}}` | `obsidian` | `100 −` the other segments (keep at least `40`; scale the others down if needed) | - -| Category | `midnight` | `editorial` | `obsidian` accent / soft / edge | -| ----------- | ---------- | ----------- | --------------------------------- | -| `NEEDS YOU` | `#e11d48` | `#c2410c` | `#e11d48` / `#fb7185` / `#331a2c` | -| `DEADLINE` | `#d97706` | `#b45309` | `#d97706` / `#fbbf24` / `#3d2a14` | -| `DECISION` | `#7c3aed` | `#6d28d9` | `#7c3aed` / `#a78bfa` / `#2a1f4a` | -| `FYI` | `#0891b2` | `#0e7490` | `#0891b2` / `#22d3ee` / `#164e63` | - -Rendering rules: keep the template's table-based layout and inline styles so +| Placeholder | Theme | Value | +| -------------------------------------------------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------ | +| `{{INDEX}}` | `editorial`, `obsidian` | Highlight position: `01`, `02`, … | +| `{{NEXT_STEP}}` | `editorial` | Used as link text, so write "Read the thread" instead of "No action needed" | +| `{{NEXT_LABEL}}` | `obsidian` | `NEXT`, or `STATUS` when the next step is "No action needed" (other short labels are fine) | +| `{{TAG}}` | `obsidian` | Short uppercase chip (≤ 16 chars) with the key fact: amount, due time, or type (`€42K SIGN-OFF`) | +| `{{ACCENT_SOFT}}` | `obsidian` | Slot soft color (table below) | +| `{{STAT_DECISIONS}}` | `obsidian` | Featured items in the `decision` slot | +| `{{HIGHLIGHT_COUNT}}` / `{{QUICK_HIT_COUNT}}` | `obsidian` | Number of featured highlights (two digits, `04`) / quick hits | +| `{{QH_INDEX}}` | `obsidian` | Quick hit position: `01`, `02`, … | +| `{{NOISE_PCT}}` | `obsidian` | `round(100 × (scanned − featured − quick hits) / scanned)` | +| `{{SEG_NEEDS_YOU}}`, `{{SEG_DEADLINE}}`, `{{SEG_DECISION}}`, `{{SEG_FYI}}` | `obsidian` | Meter widths: `6 ×` items in that slot (quick hits count as `fyi`); drop a `0` segment cell | +| `{{SEG_NOISE}}` | `obsidian` | `100 −` the other segments, at least `40` (see rounding below) | + +Meter rounding: if the slot segments sum to more than `60`, scale them by +`60 / sum`, round each to a whole number, then set `SEG_NOISE` to `100 −` their +sum so the row always totals exactly `100`. + +| Slot | `midnight` | `editorial` | `obsidian` accent / soft | +| ----------- | ---------- | ----------- | ------------------------ | +| `needs-you` | `#e11d48` | `#c2410c` | `#e11d48` / `#fb7185` | +| `deadline` | `#d97706` | `#b45309` | `#d97706` / `#fbbf24` | +| `decision` | `#7c3aed` | `#6d28d9` | `#7c3aed` / `#a78bfa` | +| `fyi` | `#0891b2` | `#0e7490` | `#0891b2` / `#22d3ee` | + +Finally, remove only the block marker comments (`HIGHLIGHT`, `QUICK HIT`, +`QUICK HITS`, `DIVIDER`, `TAG`). Other section comments may stay or go, but +never remove `` conditional blocks or the ` - +
{{PREHEADER}} ͏ ͏ ͏ ͏ ͏
- +
diff --git a/.github/skills/wazzup-news-mail/templates/midnight.html b/.github/skills/wazzup-news-mail/templates/midnight.html index 17c37106..5c2989f8 100644 --- a/.github/skills/wazzup-news-mail/templates/midnight.html +++ b/.github/skills/wazzup-news-mail/templates/midnight.html @@ -98,7 +98,7 @@

+