History

chahinebrini 5b57bea9c0 perf(mail): kill redundant 30min scan-cron + in-flight scan guard

Backend-Lag-Fix Phase 1 — entlastet die CPU-Dauerschleife im Mail-Stack:
- delete mail-scan-cron.ts: der 30-Min-Nitro-Cron scannte alle User parallel
  (Promise.allSettled) und war redundant zum IMAP-IDLE-Daemon (Single Source
  of Truth). Reine Dauerlast ohne Mehrwert.
- imap-idle: In-Flight-Guard (scanInFlight + coalescePending). triggerScan ist
  jetzt re-entry-safe — pro Connection max. 1 aktiver + 1 pending Scan statt
  bis zu 8 gestapelt pro 2-Min-NOOP-Tick. Gilt für NOOP + exists-Event.
- plan-features: Pro mailAgents 3->2 (+ Math.min-Hack in coach/message aufgeräumt).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-05 10:38:06 +02:00

index.mjs

perf(mail): kill redundant 30min scan-cron + in-flight scan guard

2026-06-05 10:38:06 +02:00

package.json

feat(mail): IDLE-daemon for real-time Legend mail-protection

2026-05-09 20:48:44 +02:00

README.md

feat(mail): IDLE-daemon for real-time Legend mail-protection

2026-05-09 20:48:44 +02:00

start-idle-staging.sh

feat(mail): outlook oauth — full end-to-end (backend + daemon + frontend)

2026-05-13 21:04:14 +02:00

README.md

rebreak-imap-idle

Standalone IMAP IDLE Daemon für Rebreak.

Was er macht

Hält pro aktiver MailConnection (DB) eine persistente IMAP-IDLE-Session
Reagiert in Echtzeit auf EXISTS-Events (neue Mail im Postfach)
Feuert bei jedem Event POST /api/mail/scan-internal gegen das lokale Backend
Das Backend entscheidet ob und welche Mails gelöscht werden (Gambling-Keywords + Blocklist)
Aktualisiert alle 5 min die Connection-Liste (neue User → neue Sessions, entfernte → geschlossen)
IDLE wird alle 25 min erneuert (RFC 3501 Server-Timeout liegt bei 29 min)

Env-Vars

Variable	Pflicht	Beschreibung
`DATABASE_URL`	ja	Postgres-Connection-String (Supabase Pooler oder direkt)
`ADMIN_SECRET`	ja	Shared Secret für /api/mail/scan-internal Header
`ENCRYPTION_KEY`	ja	AES-256 Key (identisch zum Backend-Key, 32+ Zeichen)
`BACKEND_URL`	nein	Default: http://127.0.0.1:3016 (staging) / 3015 (prod)
`NODE_ENV`	nein	`production` → BACKEND_URL default port 3015

Lokal starten (Entwicklung)

cd backend/imap-idle
npm install
DATABASE_URL=<...> ADMIN_SECRET=<...> ENCRYPTION_KEY=<...> node index.mjs

Via Infisical (analog zu start-staging.sh):

infisical run --env=staging -- node index.mjs

PM2 (Produktion)

Wird via ecosystem.config.js gestartet — siehe docs/internal/MAIL_DAEMON_DEPLOYMENT.md.

Logs (pm2)

[idle/<email>] connected (imap.gmail.com:993)
[idle/<email>] exists-event received (new mail)
[idle/<email>] scan-triggered → scanned=12 blocked=1
[idle/<email>] idle renewing (25min threshold)
[idle/<email>] reconnecting in 5s (attempt 2)
[idle/db] refreshed — 47 active connections, 47 sessions