BrennerSpear · April 18, 2026 00:02
diff --git a/A-EMAIL-TRIAGE-TEMPLATE.md b/A-EMAIL-TRIAGE-TEMPLATE.md
diff --git a/build-digest-email.sh b/build-digest-email.sh
 #!/bin/bash
 # Build HTML digest emails with inline sender logos
 # Usage: build-digest-email.sh <output.html> <<< "section|domain|name|subject|url|summary|read_time"
 #
 # Input format (pipe-delimited, one per line):
 #   section|domain|display_name|subject|url|summary|read_time
 #
 # For newsletter section: all fields used (summary + read_time shown)
 # For updates section: summary + read_time optional (omitted = simple row)
 #
 # Output: HTML file ready for gog gmail send --body-html

 set -euo pipefail

 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 WORKSPACE_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
 LOGO_DIR="${WORKSPACE_DIR}/data/sender-logos"
 FETCH_SCRIPT="${SCRIPT_DIR}/fetch-sender-logo.sh"
 OUTPUT="${1:?Usage: build-digest-email.sh <output.html>}"

 # Read entries from stdin
 entries=()
 while IFS= read -r line; do
  [ -n "$line" ] && entries+=("$line")
 done

 # Get date for header
 DATE_STR="${2:-$(date '+%b %d')}"

 # Start HTML
 cat > "$OUTPUT" <<HEADER
 <!DOCTYPE html>
 <html>
 <head><meta charset="utf-8"></head>
 <body style="margin:0;padding:0;background:#ffffff;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,'Helvetica Neue',Arial,sans-serif;">
 <table cellpadding="0" cellspacing="0" border="0" width="100%" style="max-width:600px;margin:0 auto;">
 HEADER

 section=""
 item_count=0

 for entry in "${entries[@]}"; do
  IFS='|' read -r type domain name subject url summary read_time <<< "$entry"
  item_count=$((item_count + 1))

  # Section header when type changes
  if [ "$type" != "$section" ]; then
    section="$type"
    cat >> "$OUTPUT" <<SECTION
 <tr>
  <td style="padding:20px 12px 8px;">
    <span style="font-size:18px;font-weight:700;color:#1a1a1a;">${section}</span>
    <span style="color:#999;font-size:14px;font-weight:400;"> &mdash; ${DATE_STR}</span>
  </td>
 </tr>
 SECTION
  fi

  # Get or fetch logo
  logo_file=""
  # Try exact domain first, then parent domain
  if [ -f "${LOGO_DIR}/${domain}.png" ]; then
    logo_file="${LOGO_DIR}/${domain}.png"
  else
    parent=$(echo "$domain" | awk -F. '{if(NF>2) print $(NF-1)"."$NF; else print $0}')
    if [ -f "${LOGO_DIR}/${parent}.png" ]; then
      logo_file="${LOGO_DIR}/${parent}.png"
    elif [ -x "$FETCH_SCRIPT" ]; then
      "$FETCH_SCRIPT" "$domain" >/dev/null 2>&1 || true
      if [ -f "${LOGO_DIR}/${domain}.png" ]; then
        logo_file="${LOGO_DIR}/${domain}.png"
      fi
    fi
  fi

  # Build logo HTML
  if [ -n "$logo_file" ] && [ -f "$logo_file" ]; then
    b64=$(base64 < "$logo_file" | tr -d '\n')
    logo_html="<img src=\"data:image/png;base64,${b64}\" width=\"32\" height=\"32\" style=\"width:32px;height:32px;border-radius:6px;object-fit:cover;display:block;\" alt=\"${name}\">"
  else
    letter=$(echo "$name" | cut -c1 | tr '[:lower:]' '[:upper:]')
    # Deterministic color from name
    hash_val=$(echo -n "$name" | cksum | awk '{print $1}')
    colors=("#4A90D9" "#D94A4A" "#4AD98F" "#D9A54A" "#9B59B6" "#1ABC9C" "#E74C3C" "#3498DB")
    color_idx=$((hash_val % 8))
    color="${colors[$color_idx]}"
    logo_html="<div style=\"width:32px;height:32px;border-radius:6px;background:${color};text-align:center;line-height:32px;font-size:16px;font-weight:600;color:#fff;\">${letter}</div>"
  fi

  # Use URL if provided, otherwise fall back to # (no link)
  link="${url:-#}"

  # Build row based on whether we have a summary (newsletter style) or not (update style)
  if [ -n "$summary" ] && [ "$summary" != " " ]; then
    # Newsletter style: logo + sender + read time + subject + summary
    read_time_html=""
    if [ -n "$read_time" ] && [ "$read_time" != " " ]; then
      read_time_html="<span style=\"color:#999;font-weight:400;font-size:12px;\"> &middot; ${read_time}</span>"
    fi

    cat >> "$OUTPUT" <<ROW
 <tr>
  <td style="padding:10px 12px;" valign="top">
    <table cellpadding="0" cellspacing="0" border="0" width="100%"><tr>
      <td valign="top" width="32" style="padding-right:12px;padding-top:2px;">${logo_html}</td>
      <td valign="top" style="font-size:14px;line-height:1.45;">
        <a href="${link}" style="text-decoration:none;color:#1a1a1a;">
          <span style="font-weight:700;">${name}</span>${read_time_html}
        </a>
        <br/>
        <a href="${link}" style="text-decoration:none;color:#1a1a1a;">
          <span style="font-weight:500;">${subject}</span>
        </a>
        <br/>
        <span style="color:#666;font-weight:400;font-size:13px;line-height:1.4;">${summary}</span>
      </td>
    </tr></table>
  </td>
 </tr>
 <tr><td style="padding:0 12px;"><hr style="border:none;border-top:1px solid #f0f0f0;margin:0;"/></td></tr>
 ROW
  else
    # Update style: logo + bold sender + subject (no summary)
    cat >> "$OUTPUT" <<ROW
 <tr>
  <td style="padding:7px 12px;" valign="middle">
    <table cellpadding="0" cellspacing="0" border="0" width="100%"><tr>
      <td valign="middle" width="32" style="padding-right:12px;">${logo_html}</td>
      <td valign="middle" style="font-size:14px;line-height:1.3;">
        <a href="${link}" style="text-decoration:none;color:#1a1a1a;">
          <span style="font-weight:600;">${name}</span>
          <span style="color:#5f5f5f;font-weight:400;"> &mdash; ${subject}</span>
        </a>
      </td>
    </tr></table>
  </td>
 </tr>
 ROW
  fi
 done

 # Footer
 cat >> "$OUTPUT" <<FOOTER
 <tr>
  <td style="padding:16px 12px;text-align:center;">
    <span style="font-size:12px;color:#b0b0b0;">Digest by Demo Bot &middot; ${item_count} items</span>
  </td>
 </tr>
 </table>
 </body>
 </html>
 FOOTER

 echo "$OUTPUT"
diff --git a/email-triage-fetch.sh b/email-triage-fetch.sh
 #!/bin/bash
 # email-triage-fetch.sh — Fetch unlabeled inbox emails for triage
 # Usage: email-triage-fetch.sh [--limit N] [--account EMAIL] [--page TOKEN]
 #
 # Returns only emails that have NO triage label applied yet.
 # Uses "has:nouserlabels" to exclude ALL user-labeled emails,
 # then pipes through a secondary filter to catch any leaks.

 set -euo pipefail

 LIMIT=50
 ACCOUNT="user@example.com"
 PAGE=""

 while [[ $# -gt 0 ]]; do
  case "$1" in
    --limit) LIMIT="$2"; shift 2 ;;
    --account) ACCOUNT="$2"; shift 2 ;;
    --page) PAGE="$2"; shift 2 ;;
    *) echo "Unknown arg: $1" >&2; exit 1 ;;
  esac
 done

 # All triage labels to exclude — use NOT operator (gog CLI doesn't handle -label: correctly)
 TRIAGE_LABELS=(
  "Auto-Archived"
  "Unsubscribed"
  "Newsletter"
  "Update"
  "Respond"
  "Action Required"
  "To Read"
  "To Archive"
  "To Unsubscribe"
  "Login"
  "Unsubscribe"
 )

 # Build query using NOT label:X (works correctly with gog CLI)
 QUERY="in:inbox"
 for label in "${TRIAGE_LABELS[@]}"; do
  QUERY="$QUERY NOT label:${label// /-}"
 done

 # Build command
 CMD=(gog gmail search "$QUERY" --account "$ACCOUNT" --plain --limit "$LIMIT")
 if [[ -n "$PAGE" ]]; then
  CMD+=(--page "$PAGE")
 fi

 # Run search and post-filter: remove any line containing a triage label name
 # (belt and suspenders — catches any Gmail search quirks)
 OUTPUT=$("${CMD[@]}" 2>/dev/null)

 # Normalize the emitted pagination hint so callers can pass the raw token back to --page.
 OUTPUT=$(printf '%s\n' "$OUTPUT" | sed -E 's/^# Next page: --page /# Next page: /')

 # Print header (skip any leading pagination hint from gog)
 HEADER=$(printf '%s\n' "$OUTPUT" | awk '!/^# Next page:/{print; exit}')
 echo "$HEADER"

 # Extract and print the pagination hint explicitly.
 printf '%s\n' "$OUTPUT" | awk '/^# Next page:/{sub(/^# Next page: --page /, "# Next page: "); print}' || true

 # Filter body: exclude lines only when the LABELS column contains an actual triage label.
 # Preserve Gmail category labels like CATEGORY_UPDATES, which should not match "Update".
 BODY=$(printf '%s\n' "$OUTPUT" | awk 'NR > 1 && !/^# Next page:/')
 echo "$BODY" | awk -F'\t' '
  BEGIN {
    split("Auto-Archived|Unsubscribed|Newsletter|Update|Respond|Action Required|To Read|To Archive|To Unsubscribe|Login|Unsubscribe", arr, "|")
    for (i in arr) blocked[arr[i]] = 1
  }
  {
    labels = $5
    n = split(labels, parts, ",")
    keep = 1
    for (i = 1; i <= n; i++) {
      gsub(/^ +| +$/, "", parts[i])
      if (parts[i] in blocked) {
        keep = 0
        break
      }
    }
    if (keep) print
  }
 ' || true
diff --git a/email-triage.heuristics.md b/email-triage.heuristics.md
diff --git a/email-triage.SKILL.md b/email-triage.SKILL.md
diff --git a/extract-newsletter-url.sh b/extract-newsletter-url.sh
 #!/usr/bin/env bash
 # Extract the primary article URL from a newsletter email
 # Usage: extract-newsletter-url.sh <message_id> [account]
 # Outputs: the resolved article URL (cleaned of tracking params)

 set -euo pipefail

 MSG_ID="${1:?Usage: extract-newsletter-url.sh <message_id> [account]}"
 ACCOUNT="${2:-user@example.com}"

 # Get the email body and extract the best URL
 URL=$(gog gmail get "$MSG_ID" --json --account "$ACCOUNT" 2>/dev/null | python3 -c "
 import sys, json, re

 data = json.load(sys.stdin)
 body = data.get('body', '')
 lines = body.split('\n')

 # Strategy 1: 'View in browser' / 'view the post online' / 'read online' etc.
 # Check current line, next line, and parenthetical URLs
 for i, line in enumerate(lines):
    lower = line.lower().strip()
    
    # Pattern: 'View in browser ( URL )' or 'View in browser: URL'
    if any(phrase in lower for phrase in [
        'view in browser', 'view online', 'read in browser', 
        'view this email', 'view this post', 'read this email',
        'view the post online', 'copy and paste this link',
        'open in browser', 'view in your browser'
    ]):
        # Check this line for URL (possibly in parens)
        urls_in_line = re.findall(r'https?://[^\s<>\")\]]+', line)
        if urls_in_line:
            print(urls_in_line[0])
            sys.exit(0)
        
        # Check next few lines for URL
        for j in range(i+1, min(len(lines), i+4)):
            urls_next = re.findall(r'https?://[^\s<>\")\]]+', lines[j])
            if urls_next:
                print(urls_next[0])
                sys.exit(0)

 # Strategy 2: First URL that looks like article content (not images/tracking/unsubscribe)
 all_urls = re.findall(r'https?://[^\s<>\")\]]+', body)
 for u in all_urls:
    lower_u = u.lower()
    # Skip non-content URLs
    if any(skip in lower_u for skip in [
        'unsubscribe', 'manage', 'preference', 'tracking', 'pixel', 'beacon',
        'cdn-cgi', 'media.beehiiv', '.png', '.gif', '.jpg', '.jpeg', '.svg',
        'email-analytics', 'click?upn=', 'list-manage.com', 'mailchimp.com',
        'passport.online/member'
    ]):
        continue
    print(u)
    sys.exit(0)

 # Fallback: first URL, whatever it is
 if all_urls:
    print(all_urls[0])
 ")

 if [ -z "$URL" ]; then
    echo ""
    exit 0
 fi

 # If URL is a tracking redirect, follow it to get the final destination
 if echo "$URL" | grep -qE '(ablink\.|click\?|redirect|trk\.|track\.)'; then
    FINAL=$(curl -sI -L --max-redirs 5 --max-time 10 "$URL" 2>/dev/null | grep -i '^location:' | tail -1 | sed 's/^[Ll]ocation: *//' | tr -d '\r\n')
    if [ -n "$FINAL" ]; then
        URL="$FINAL"
    fi
 fi

 # Strip common tracking params
 echo "$URL" | sed -E 's/[?&](lid|utm_[a-z]+|ref|mc_[a-z]+|access_token)=[^&]*//g' | sed 's/[?&]$//' | sed 's/\?&/?/'
diff --git a/fetch-sender-logo.sh b/fetch-sender-logo.sh
 #!/bin/bash
 # Fetch and cache sender logos from multiple sources
 # Usage: fetch-sender-logo.sh <domain> [--force]
 # Outputs: path to cached logo file
 # Tries icon.horse and Google favicons, keeps the higher-res one

 set -euo pipefail

 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 WORKSPACE_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
 CACHE_DIR="${WORKSPACE_DIR}/data/sender-logos"
 MIN_SIZE=64  # minimum acceptable pixel dimension

 domain="${1:?Usage: fetch-sender-logo.sh <domain> [--force]}"
 force="${2:-}"

 # Strip any email address down to domain
 domain=$(echo "$domain" | sed 's/.*@//' | tr '[:upper:]' '[:lower:]')

 cached="${CACHE_DIR}/${domain}.png"

 if [ -f "$cached" ] && [ "$force" != "--force" ]; then
  echo "$cached"
  exit 0
 fi

 mkdir -p "$CACHE_DIR"
 tmpdir=$(mktemp -d)
 trap "rm -rf $tmpdir" EXIT

 best_file=""
 best_size=0

 # Source 1: icon.horse (gets apple-touch-icons, often 180x180+)
 if curl -sL -o "$tmpdir/iconhorse.png" "https://icon.horse/icon/${domain}" --max-time 8 2>/dev/null; then
  if [ -s "$tmpdir/iconhorse.png" ]; then
    w=$(sips -g pixelWidth "$tmpdir/iconhorse.png" 2>/dev/null | awk '/pixelWidth/{print $2}')
    h=$(sips -g pixelHeight "$tmpdir/iconhorse.png" 2>/dev/null | awk '/pixelHeight/{print $2}')
    dim=$(( w > h ? w : h ))
    if [ "$dim" -gt "$best_size" ] 2>/dev/null; then
      best_size=$dim
      best_file="$tmpdir/iconhorse.png"
    fi
  fi
 fi

 # Source 2: Google favicons at max size (256)
 if curl -sL -o "$tmpdir/google.png" "https://www.google.com/s2/favicons?domain=${domain}&sz=256" --max-time 8 2>/dev/null; then
  if [ -s "$tmpdir/google.png" ]; then
    w=$(sips -g pixelWidth "$tmpdir/google.png" 2>/dev/null | awk '/pixelWidth/{print $2}')
    h=$(sips -g pixelHeight "$tmpdir/google.png" 2>/dev/null | awk '/pixelHeight/{print $2}')
    dim=$(( w > h ? w : h ))
    if [ "$dim" -gt "$best_size" ] 2>/dev/null; then
      best_size=$dim
      best_file="$tmpdir/google.png"
    fi
  fi
 fi

 if [ -z "$best_file" ] || [ "$best_size" -lt "$MIN_SIZE" ]; then
  # Fallback: generate a letter avatar
  letter=$(echo "$domain" | cut -c1 | tr '[:lower:]' '[:upper:]')
  # Use sips to create a simple colored square with the letter
  # Actually, just use the Google one even if small - better than nothing
  if [ -n "$best_file" ]; then
    cp "$best_file" "$cached"
    echo "$cached"
    exit 0
  fi
  echo "NONE" >&2
  exit 1
 fi

 cp "$best_file" "$cached"
 echo "$cached"
diff --git a/Z-GMAIL-MULTIPLE-INBOXES-SETUP.svg b/Z-GMAIL-MULTIPLE-INBOXES-SETUP.svg
	#!/bin/bash
	# Build HTML digest emails with inline sender logos
	# Usage: build-digest-email.sh <output.html> <<< "section\|domain\|name\|subject\|url\|summary\|read_time"
	#
	# Input format (pipe-delimited, one per line):
	# section\|domain\|display_name\|subject\|url\|summary\|read_time
	#
	# For newsletter section: all fields used (summary + read_time shown)
	# For updates section: summary + read_time optional (omitted = simple row)
	#
	# Output: HTML file ready for gog gmail send --body-html

	set -euo pipefail

	SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
	WORKSPACE_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
	LOGO_DIR="${WORKSPACE_DIR}/data/sender-logos"
	FETCH_SCRIPT="${SCRIPT_DIR}/fetch-sender-logo.sh"
	OUTPUT="${1:?Usage: build-digest-email.sh <output.html>}"

	# Read entries from stdin
	entries=()
	while IFS= read -r line; do
	[ -n "$line" ] && entries+=("$line")
	done

	# Get date for header
	DATE_STR="${2:-$(date '+%b %d')}"

	# Start HTML
	cat > "$OUTPUT" <<HEADER
	<!DOCTYPE html>
	<html>
	<head><meta charset="utf-8"></head>
	<body style="margin:0;padding:0;background:#ffffff;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,'Helvetica Neue',Arial,sans-serif;">
	<table cellpadding="0" cellspacing="0" border="0" width="100%" style="max-width:600px;margin:0 auto;">
	HEADER

	section=""
	item_count=0

	for entry in "${entries[@]}"; do
	IFS='\|' read -r type domain name subject url summary read_time <<< "$entry"
	item_count=$((item_count + 1))

	# Section header when type changes
	if [ "$type" != "$section" ]; then
	section="$type"
	cat >> "$OUTPUT" <<SECTION
	<tr>
	<td style="padding:20px 12px 8px;">
	<span style="font-size:18px;font-weight:700;color:#1a1a1a;">${section}</span>
	<span style="color:#999;font-size:14px;font-weight:400;"> — ${DATE_STR}</span>
	</td>
	</tr>
	SECTION
	fi

	# Get or fetch logo
	logo_file=""
	# Try exact domain first, then parent domain
	if [ -f "${LOGO_DIR}/${domain}.png" ]; then
	logo_file="${LOGO_DIR}/${domain}.png"
	else
	parent=$(echo "$domain" \| awk -F. '{if(NF>2) print $(NF-1)"."$NF; else print $0}')
	if [ -f "${LOGO_DIR}/${parent}.png" ]; then
	logo_file="${LOGO_DIR}/${parent}.png"
	elif [ -x "$FETCH_SCRIPT" ]; then
	"$FETCH_SCRIPT" "$domain" >/dev/null 2>&1 \|\| true
	if [ -f "${LOGO_DIR}/${domain}.png" ]; then
	logo_file="${LOGO_DIR}/${domain}.png"
	fi
	fi
	fi

	# Build logo HTML
	if [ -n "$logo_file" ] && [ -f "$logo_file" ]; then
	b64=$(base64 < "$logo_file" \| tr -d '\n')
	logo_html="<img src=\"data:image/png;base64,${b64}\" width=\"32\" height=\"32\" style=\"width:32px;height:32px;border-radius:6px;object-fit:cover;display:block;\" alt=\"${name}\">"
	else
	letter=$(echo "$name" \| cut -c1 \| tr '[:lower:]' '[:upper:]')
	# Deterministic color from name
	hash_val=$(echo -n "$name" \| cksum \| awk '{print $1}')
	colors=("#4A90D9" "#D94A4A" "#4AD98F" "#D9A54A" "#9B59B6" "#1ABC9C" "#E74C3C" "#3498DB")
	color_idx=$((hash_val % 8))
	color="${colors[$color_idx]}"
	logo_html="<div style=\"width:32px;height:32px;border-radius:6px;background:${color};text-align:center;line-height:32px;font-size:16px;font-weight:600;color:#fff;\">${letter}</div>"
	fi

	# Use URL if provided, otherwise fall back to # (no link)
	link="${url:-#}"

	# Build row based on whether we have a summary (newsletter style) or not (update style)
	if [ -n "$summary" ] && [ "$summary" != " " ]; then
	# Newsletter style: logo + sender + read time + subject + summary
	read_time_html=""
	if [ -n "$read_time" ] && [ "$read_time" != " " ]; then
	read_time_html="<span style=\"color:#999;font-weight:400;font-size:12px;\"> · ${read_time}</span>"
	fi

	cat >> "$OUTPUT" <<ROW
	<tr>
	<td style="padding:10px 12px;" valign="top">
	<table cellpadding="0" cellspacing="0" border="0" width="100%"><tr>
	<td valign="top" width="32" style="padding-right:12px;padding-top:2px;">${logo_html}</td>
	<td valign="top" style="font-size:14px;line-height:1.45;">
	<a href="${link}" style="text-decoration:none;color:#1a1a1a;">
	<span style="font-weight:700;">${name}</span>${read_time_html}
	</a>
	<br/>
	<a href="${link}" style="text-decoration:none;color:#1a1a1a;">
	<span style="font-weight:500;">${subject}</span>
	</a>
	<br/>
	<span style="color:#666;font-weight:400;font-size:13px;line-height:1.4;">${summary}</span>
	</td>
	</tr></table>
	</td>
	</tr>
	<tr><td style="padding:0 12px;"><hr style="border:none;border-top:1px solid #f0f0f0;margin:0;"/></td></tr>
	ROW
	else
	# Update style: logo + bold sender + subject (no summary)
	cat >> "$OUTPUT" <<ROW
	<tr>
	<td style="padding:7px 12px;" valign="middle">
	<table cellpadding="0" cellspacing="0" border="0" width="100%"><tr>
	<td valign="middle" width="32" style="padding-right:12px;">${logo_html}</td>
	<td valign="middle" style="font-size:14px;line-height:1.3;">
	<a href="${link}" style="text-decoration:none;color:#1a1a1a;">
	<span style="font-weight:600;">${name}</span>
	<span style="color:#5f5f5f;font-weight:400;"> — ${subject}</span>
	</a>
	</td>
	</tr></table>
	</td>
	</tr>
	ROW
	fi
	done

	# Footer
	cat >> "$OUTPUT" <<FOOTER
	<tr>
	<td style="padding:16px 12px;text-align:center;">
	<span style="font-size:12px;color:#b0b0b0;">Digest by Demo Bot · ${item_count} items</span>
	</td>
	</tr>
	</table>
	</body>
	</html>
	FOOTER

	echo "$OUTPUT"
	#!/bin/bash
	# email-triage-fetch.sh — Fetch unlabeled inbox emails for triage
	# Usage: email-triage-fetch.sh [--limit N] [--account EMAIL] [--page TOKEN]
	#
	# Returns only emails that have NO triage label applied yet.
	# Uses "has:nouserlabels" to exclude ALL user-labeled emails,
	# then pipes through a secondary filter to catch any leaks.

	set -euo pipefail

	LIMIT=50
	ACCOUNT="user@example.com"
	PAGE=""

	while [[ $# -gt 0 ]]; do
	case "$1" in
	--limit) LIMIT="$2"; shift 2 ;;
	--account) ACCOUNT="$2"; shift 2 ;;
	--page) PAGE="$2"; shift 2 ;;
	*) echo "Unknown arg: $1" >&2; exit 1 ;;
	esac
	done

	# All triage labels to exclude — use NOT operator (gog CLI doesn't handle -label: correctly)
	TRIAGE_LABELS=(
	"Auto-Archived"
	"Unsubscribed"
	"Newsletter"
	"Update"
	"Respond"
	"Action Required"
	"To Read"
	"To Archive"
	"To Unsubscribe"
	"Login"
	"Unsubscribe"
	)

	# Build query using NOT label:X (works correctly with gog CLI)
	QUERY="in:inbox"
	for label in "${TRIAGE_LABELS[@]}"; do
	QUERY="$QUERY NOT label:${label// /-}"
	done

	# Build command
	CMD=(gog gmail search "$QUERY" --account "$ACCOUNT" --plain --limit "$LIMIT")
	if [[ -n "$PAGE" ]]; then
	CMD+=(--page "$PAGE")
	fi

	# Run search and post-filter: remove any line containing a triage label name
	# (belt and suspenders — catches any Gmail search quirks)
	OUTPUT=$("${CMD[@]}" 2>/dev/null)

	# Normalize the emitted pagination hint so callers can pass the raw token back to --page.
	OUTPUT=$(printf '%s\n' "$OUTPUT" \| sed -E 's/^# Next page: --page /# Next page: /')

	# Print header (skip any leading pagination hint from gog)
	HEADER=$(printf '%s\n' "$OUTPUT" \| awk '!/^# Next page:/{print; exit}')
	echo "$HEADER"

	# Extract and print the pagination hint explicitly.
	printf '%s\n' "$OUTPUT" \| awk '/^# Next page:/{sub(/^# Next page: --page /, "# Next page: "); print}' \|\| true

	# Filter body: exclude lines only when the LABELS column contains an actual triage label.
	# Preserve Gmail category labels like CATEGORY_UPDATES, which should not match "Update".
	BODY=$(printf '%s\n' "$OUTPUT" \| awk 'NR > 1 && !/^# Next page:/')
	echo "$BODY" \| awk -F'\t' '
	BEGIN {
	split("Auto-Archived\|Unsubscribed\|Newsletter\|Update\|Respond\|Action Required\|To Read\|To Archive\|To Unsubscribe\|Login\|Unsubscribe", arr, "\|")
	for (i in arr) blocked[arr[i]] = 1
	}
	{
	labels = $5
	n = split(labels, parts, ",")
	keep = 1
	for (i = 1; i <= n; i++) {
	gsub(/^ +\| +$/, "", parts[i])
	if (parts[i] in blocked) {
	keep = 0
	break
	}
	}
	if (keep) print
	}
	' \|\| true
name	email-triage
description	Triage Gmail inbox — categorize and label every unread email, propose unsubscribes and auto-archive filters for approval. Use when asked to filter emails, triage inbox, clean up email, unsubscribe from senders, or create Gmail skip-inbox filters. Triggers on "filter my emails", "triage my inbox", "clean up my email", "unsubscribe", "email cleanup".
	#!/bin/bash
	# Fetch and cache sender logos from multiple sources
	# Usage: fetch-sender-logo.sh <domain> [--force]
	# Outputs: path to cached logo file
	# Tries icon.horse and Google favicons, keeps the higher-res one

	set -euo pipefail

	SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
	WORKSPACE_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"
	CACHE_DIR="${WORKSPACE_DIR}/data/sender-logos"
	MIN_SIZE=64 # minimum acceptable pixel dimension

	domain="${1:?Usage: fetch-sender-logo.sh <domain> [--force]}"
	force="${2:-}"

	# Strip any email address down to domain
	domain=$(echo "$domain" \| sed 's/.*@//' \| tr '[:upper:]' '[:lower:]')

	cached="${CACHE_DIR}/${domain}.png"

	if [ -f "$cached" ] && [ "$force" != "--force" ]; then
	echo "$cached"
	exit 0
	fi

	mkdir -p "$CACHE_DIR"
	tmpdir=$(mktemp -d)
	trap "rm -rf $tmpdir" EXIT

	best_file=""
	best_size=0

	# Source 1: icon.horse (gets apple-touch-icons, often 180x180+)
	if curl -sL -o "$tmpdir/iconhorse.png" "https://icon.horse/icon/${domain}" --max-time 8 2>/dev/null; then
	if [ -s "$tmpdir/iconhorse.png" ]; then
	w=$(sips -g pixelWidth "$tmpdir/iconhorse.png" 2>/dev/null \| awk '/pixelWidth/{print $2}')
	h=$(sips -g pixelHeight "$tmpdir/iconhorse.png" 2>/dev/null \| awk '/pixelHeight/{print $2}')
	dim=$(( w > h ? w : h ))
	if [ "$dim" -gt "$best_size" ] 2>/dev/null; then
	best_size=$dim
	best_file="$tmpdir/iconhorse.png"
	fi
	fi
	fi

	# Source 2: Google favicons at max size (256)
	if curl -sL -o "$tmpdir/google.png" "https://www.google.com/s2/favicons?domain=${domain}&sz=256" --max-time 8 2>/dev/null; then
	if [ -s "$tmpdir/google.png" ]; then
	w=$(sips -g pixelWidth "$tmpdir/google.png" 2>/dev/null \| awk '/pixelWidth/{print $2}')
	h=$(sips -g pixelHeight "$tmpdir/google.png" 2>/dev/null \| awk '/pixelHeight/{print $2}')
	dim=$(( w > h ? w : h ))
	if [ "$dim" -gt "$best_size" ] 2>/dev/null; then
	best_size=$dim
	best_file="$tmpdir/google.png"
	fi
	fi
	fi

	if [ -z "$best_file" ] \|\| [ "$best_size" -lt "$MIN_SIZE" ]; then
	# Fallback: generate a letter avatar
	letter=$(echo "$domain" \| cut -c1 \| tr '[:lower:]' '[:upper:]')
	# Use sips to create a simple colored square with the letter
	# Actually, just use the Google one even if small - better than nothing
	if [ -n "$best_file" ]; then
	cp "$best_file" "$cached"
	echo "$cached"
	exit 0
	fi
	echo "NONE" >&2
	exit 1
	fi

	cp "$best_file" "$cached"
	echo "$cached"