Feature Proposal: AI-Powered Gemini Semantic Email Classifier & Auto-Filter Generator

[don-petry]

Feature Proposal: Native Gemini AI Semantic Email Classifier for GAS

Overview

Integrate a native Gemini AI LLM semantic classifier () into the suite to automatically categorize incoming unclassified emails and self-learn permanent Gmail filter rules.

Key Capabilities

1. Zero-Configuration Semantic Classification: Classifies incoming emails from unknown senders based on intent, sender, subject, and body snippet into target canonical labels (, , etc.).
2. Self-Learning Gmail Filter Generation: When Gemini classifies a new sender with high confidence (>= 95%), the script automatically calls to create a permanent Gmail filter rule.
3. 100% Cloud Native: Executed natively inside Google Apps Script via calling or endpoints.

Proposed Architecture

• Runnable Apps Script module:
• Configuration schema:
• Test Coverage: Unit and integration Jest test suite in

[don-petry]

Update: Standard 7-Domain Taxonomy Matrix (PARA / ISO 15489 / MECE Aligned)

The AI Gemini Classifier has been updated to evaluate incoming mail against a standardized 7-domain taxonomy:

1. 01_Household: Primary residence (2809 Five Oaks), shop build, rental (3535 Broken Bow), 18 Running Deer archive.
2. 02_Finance_Legal: Taxes, banking (Schwab/BoA), insurance policies, court records, custody, estate planning.
3. 03_Vehicles: Vehicle searches (2026 car hunt), vehicle titles, Mercedes logs, auto maintenance.
4. 04_Family_Health: Children (Toby, Tide), school IEPs, speech/audiology reports, medical history, AYOP camps.
5. 05_Tech_Infrastructure: Home Assistant, NAS backups, Tasker scripts, network gear, software licenses.
6. 06_Work_Career: EY architecture, resumes, job interview decks, expense reports, admin notes.
7. 07_Community_NonProfit: HelpingOneGuy 501(c)(3) charity, JeffCo Bees BOD, faith outreach.

See updated PR #492 and proposal document docs/proposals/proposal-001-ai-gemini-semantic-classifier.md.

[don-petry]

Update: Explicit Inbox Preservation Rule

• Drive Ingestion Designator: The label suffix -Processed (or -Archived) indicates ingestion status into Google Drive, NOT removal from the user's Inbox.
• Inbox Preservation: Processing an email into Google Drive MUST NOT remove the message from the user's INBOX. The email thread remains visible in the Inbox for human review and reading until explicitly archived or deleted by the user.

[don-petry]

Update: Single Global 'Processed' Label Marker (Clean Sidebar UX)

• Eliminating Duplicate Labels: Rather than creating parallel -Processed labels (which doubles sidebar labels from 20 to 40+), the script applies a single global Processed label across all ingested mail.
• Category Preservation: The thread retains its canonical category label (Family/School-Toby, Finance/Taxes).
• Inbox Searching: Show all processed mail with label:Processed or unprocessed mail with in:inbox -label:Processed.

[don-petry]

Update: Idempotency & Single-Click Reprocessing Workflows

• Query Guard: Ingestion routines process threads matching label:Category -label:Processed.
• Deep Deduplication Guards: Native MD5 checksums (file.getMd5Checksum()) prevent duplicate attachment saves; thread markers ([THREAD:id]) prevent duplicate text logs.
• Single-Click Reprocessing: Removing the Processed label from an email thread in Gmail causes the script to re-evaluate, re-clean, and re-process the thread on its next run.

[don-petry]

Update: Handling Unclassified & Edge-Case Mail

• Zero Lost / Deleted Mail: Any email outside the 7 Canonical Domains (e.g. 2FA codes, password resets, casual chat) is NEVER deleted or hidden. It remains safely in the user's INBOX.
• Drive Exclusion for OTPs: 1-line verification passcodes are excluded from Drive processing to keep Google Drive folders clean.
• Optional Unclassified Badge: Ambiguous emails can be tagged with a temporary Unclassified label for easy visual filtering.

[don-petry]

Update: Native Apps Script GitHub Sync Module (gitHubSync.gs)

• 100% Cloud-Native Ingestion: Added src/gmail-ai-classifier/gitHubSync.gs which calls the GitHub REST API natively via UrlFetchApp.fetch().
• Zero Local Hardware Required: Apps Script automatically ingests email details and commits Markdown entries directly to self-private/main on GitHub without needing local cron jobs or running laptops!