suaveplan/openspec/archive/2026-04-19-enterprise-suppression/tasks.md

Tasks: enterprise-suppression

1. Scaffold

• 1.1 universal/email/suppression/; 100/100/100/100; guard tests; CLAUDE/README/FOLDERS.

2. Errors + schemas

• 2.1 src/errors/suppression-error.ts — SUPPRESSION.* codes.
• 2.2 Zod schemas.

3. Bounce classifier

• 3.1 src/core/bounce-classifier/bounce-classifier.ts — RFC 3463 status-code mapper → hard/soft/undetermined.

4. Store

• 4.1 src/stores/suppression.store.ts — SuppressionStore interface + MemorySuppressionStore.

5. Manager + filter

• 5.1 src/core/suppression-manager/suppression-manager.ts — CRUD over suppressions with reasons.
• 5.2 src/core/suppression-filter/suppression-filter.ts — filter(addresses) → FilterResult.
• 5.3 OTel counters.

6. Unsubscribe links

• 6.1 src/core/unsubscribe-link/unsubscribe-link.ts — HMAC-SHA256 signed link + TTL; RFC 8058 one-click payload.

7. Docs / barrel / subpath exports / README

8. Benchmarks

• 8.1 filter.bench.ts on 100 k-entry store.

9. Ship gate

• 9.1 Verification sequence; fold + archive.