webdev-pipeline/backlog/tasks/task-14 - Send-approved-outreach-through-Stalwart-SMTP.md

id, title, status, assignee, created_date, updated_date, labels, dependencies, references, priority, ordinal

id	title	status	assignee	created_date	updated_date	labels	dependencies	references	priority	ordinal
TASK-14	Send approved outreach through Stalwart SMTP	In Progress		2026-06-03 19:14	2026-06-05 15:57	mvp email smtp	TASK-13	PRD.md	high	14000

Description

Implement approved email sending through the self-hosted Stalwart mail server using SMTP/SMTPS and Nodemailer. The system must never send automatically before manual approval and must log recipient, subject, audit link, status, and errors in Convex.

Acceptance Criteria

• #1 Nodemailer is configured for Stalwart SMTP/SMTPS using environment or Convex secrets
• #2 E-Mail freigeben und senden sends only the currently approved/editable email draft to the visible recipient
• #3 A final send action shows recipient, subject, sender, and audit link before sending
• #4 Convex records sent timestamp, recipient, subject, audit link, SMTP result, and any error details
• #5 SMTP failures keep the lead in a retryable review state and do not mark the lead as contacted

Implementation Plan

1. Analyse und TDD-Testergänzung
2. Implementierung backend Claims/Record + Guard-Fixes
3. Typing/Actions straffen + package lock
4. Typechecks lokal ausführen

Implementation Notes

Implemented TASK-14 via subagent-driven TDD. Verification passed: targeted outreach tests (27/27), pnpm test (278/278), pnpm exec tsc -p tsconfig.json --noEmit, pnpm lint (0 errors, 2 generated BetterAuth warnings), pnpm build (passed with network-enabled run for Google Fonts). Task remains In Progress until explicit user confirmation after manual SMTP testing.