carloscape/octorato/inbox-triage-classifier

            operator invokes: /<arm>-triage <source> [args]
                                       │
                                       ▼
                                  orchestrator
                                       │
        ┌──────────────────────────────┼──────────────────────────────┐
        ▼                              ▼                              ▼
    [1] FETCH                  [2] NORMALIZE                  [3] PHI SCREEN
    delta-query for             strip HTML, sigs,             regex + (optional)
    last N days,                quoted replies; build         classifier; mark
    READ-ONLY                   stable hash                    each item phi or clean
                                       │
                                       ▼
                              ┌────────┴────────┐
                              ▼                 ▼
                         clean items      phi-tainted items
                              │                 │
                              ▼                 ▼
                    [4a] CLASSIFY        [4b] CLASSIFY
                    cloud LLM            local LLM
                    (Groq / OpenAI)      (ollama)
                              │                 │
                              └────────┬────────┘
                                       ▼
                          [5] STRUCTURED VERDICT
                          { needs_followup: bool,
                            reason, suggested_action,
                            urgency: low|med|high,
                            phi: bool, llm: str }
                                       │
                                       ▼
                               [6] SORT + REPORT
                               sort by urgency, then
                               by recency; print to
                               stdout (+ optional
                               PHI-redacted digest)

{
  "needs_followup": true,
  "reason": "<=120 chars — why this needs attention",
  "suggested_action": "<=140 chars — what the operator should do",
  "urgency": "low" | "med" | "high"
}

# GOLDEN RULES (must obey)
- Output ONLY a single JSON object — no prose, no markdown, no code fence.
- Schema: {"needs_followup": boolean, "reason": "...", "suggested_action": "...", "urgency": "low"|"med"|"high"}
- needs_followup=true only if the item expects an action from the recipient.
- needs_followup=false for FYI broadcasts, auto-notifications, newsletters, already-handled invites.
- Be conservative: when uncertain, prefer needs_followup=false.
 
# TASK
Classify whether <RECIPIENT_NAME>, a <RECIPIENT_ROLE>, needs to follow up on this <ITEM_TYPE>.
 
# REMEMBER
- JSON only. No invention. Concrete actions, not vague advice.

Subject: <subject>                    # or: Channel: <channel>, Ticket: <id>
From: <name> <<email/handle>>
Received: <ISO datetime>
Read: <yes|no>                        # if source supports unread state
Importance/Priority: <normal|high>
Flag: <followup|completed|none>       # if source supports flags
 
---
<first 3500 chars of normalized body>

async function classifyItem(item, normalizedText, ctx) {
  const phiRisk = phi.isPhiRisk(normalizedText, { strictness: 'medium' });
  const messages = [
    { role: 'system', content: SANDWICH_SYSTEM },
    { role: 'user',   content: buildUserMessage(item, normalizedText) },
  ];
  if (phiRisk) {
    if (!ctx.ollamaAvailable) {
      // FAIL CLOSED — do NOT degrade to cloud
      return { error: 'PHI detected but ollama unavailable', phi: true, llm: 'none' };
    }
    return await ollama.chat(messages, { maxTokens: 180, temperature: 0 });
  }
  return await groq.chat(messages, { maxTokens: 180, temperature: 0 });
}

🐙 <source> follow-up scanner
   window=7d  limit=50  ...
 
   user: <email>
 
→ Fetching items...
  N item(s) returned
→ Checking ollama availability...
  ollama: up (M models)
→ Classifying items...
●●·!··●·
 
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  <source> follow-up report
  <user> · last <N>d · X items scanned
  PHI-tainted: A (ollama)  ·  Clean: B (Groq)  ·  Errors: C
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
  K item(s) need follow-up:
 
● HIGH  2026-05-22 08:21  <subject>
         from: <name> <<email>>
         why:  <reason>
         do:   <suggested_action>

{
  id: string,
  subject: string,
  from: { name, email|handle },
  body: string,               // raw, may be HTML
  bodyType: 'html' | 'text',
  receivedDateTime: ISO,
  isRead: bool | null,
  flag: string | null,
  importance: 'normal' | 'high',
  webLink: string,            // deep link back to source
  hasAttachments: bool,
}