Commit graph

41 commits

Author SHA1 Message Date
tgiachi
e6713962f9 feat(queue): background worker with retries, backoff and bounded concurrency
- Add Worker.RunOnce, Run and Wake over the durable outbox
- Send prefix plus shared message per recipient with a per-send timeout
- Retry temporary failures after 1m, 5m, 15m, 1h, 3h, then every 6h; give up after 3 days
- Drop permanent failures; count a hard bounce only for bad-mailbox replies
- Leave interrupted sends queued on shutdown
- Share the bounce threshold between router and worker
2026-11-09 15:47:14 +01:00
tgiachi
ecbab4d18c feat(outbound): classify relay errors as permanent or bad mailbox
- Add IsPermanent for SMTP 5xx and PermanentError
- Add IsBadMailbox for enhanced status 5.1.x only, so a misconfigured relay says nothing about recipients
2026-11-09 15:46:27 +01:00
tgiachi
092cf4c350 feat(store): durable outbox with shared bodies and retry scheduling
- Add outbox_msgs and outbox tables
- Enqueue every recipient of a post in one transaction
- Add due, list, complete, retry and stats queries
- Delete the shared body with the last recipient
2026-11-09 15:45:19 +01:00
squidd
16124bbaf3 Merge pull request 'Milestone 4: admin web UI (Vite, React, shadcn/ui)' (#12) from feat/m4-admin-ui into main 2026-11-09 15:42:37 +01:00
tgiachi
a0a083273c feat(admin): build tooling, Docker stage and docs; close test gaps
- Add Makefile (admin, build, test) and a node stage in the Dockerfile
- Add .dockerignore so host node_modules and builds stay out of the image
- Document the admin UI in the README
- Cover mutation survivors: token cleanup on non-401 failures, cache dropped on 401 and sign out, member filter by name, archive invalidated after approval, page offset
2026-11-09 15:42:07 +01:00
tgiachi
b3a85a55ea feat(admin): archive tab with search, paging and message viewer
- Add paginated archive table with full-text search
- Add message viewer that renders the body as plain text
- Add inline-confirmed deletion
- Warn when archiving is off
2026-11-09 15:37:39 +01:00
tgiachi
c5f158b664 feat(admin): held messages tab
- Add held queue table with approve and confirmed discard
- Explain how messages get held when posting is not moderated
- Refresh the tab badge and the archive after approving
- Add byte and date formatting helpers
2026-11-09 15:36:47 +01:00
tgiachi
75a32386b2 feat(admin): members tab
- Add member table with status, bounce count and client-side filter
- Add add-member form, re-enable for disabled members and confirmed removal
2026-11-09 15:35:43 +01:00
tgiachi
1a7d16f8a9 test(admin): wait for the modal cleanup after deleting a list 2026-11-09 15:34:46 +01:00
tgiachi
f9e5b142c2 feat(admin): list page with tabs, settings and deletion
- Add list header, tab navigation driven by the URL and held-queue badge
- Add settings form that sends only changed fields
- Add confirmed list deletion with error handling in the dialog
- Add labelled select field wrapper for shadcn Select
2026-11-09 15:33:47 +01:00
tgiachi
bbb5f3f9ce feat(admin): create lists from a dialog
- Add new-list dialog with client validation and server error display
- Reset the form each time the dialog opens
2026-11-09 15:32:39 +01:00
tgiachi
5f67289943 feat(admin): login, session guard and lists overview
- Add AuthProvider that verifies the token and ends the session on any 401
- Add login page, shell with sign out, not-found page
- Add lists table with policy badges
- Add fake API and render helpers for component tests
2026-11-09 15:31:51 +01:00
tgiachi
97024ca642 feat(admin): typed API client with session token handling
- Add api client for lists, members, held queue and archive
- Keep the bearer token in sessionStorage and clear it on 401
- Turn network and non-JSON errors into ApiError
2026-11-09 15:30:13 +01:00
tgiachi
5a0dd7f6d6 feat(adminui): embed the admin SPA and serve it next to the API
- Add internal/adminui with a SPA handler: index fallback for client routes, immutable caching for hashed assets, 404 for missing assets, security headers
- Answer 503 with a hint when the UI has not been built, so go build always works
- Mount the UI at / and the API at /api/ on the same listener, no CORS needed
- Scaffold admin/ with Vite, React, TypeScript, Tailwind v4, shadcn/ui and Vitest
2026-11-09 15:29:12 +01:00
squidd
48c7124fcf Merge pull request 'Milestone 3: archive with full-text search and public web pages' (#10) from feat/m3-archive-web into main 2026-11-09 15:24:55 +01:00
tgiachi
8f64ac671d feat: serve the public web from the daemon and document the archive
- Add web.listen config (default 127.0.0.1:8081, empty disables)
- Start the public web in app, close it with the rest
- Add end-to-end test: archive stays private, becomes public, hides addresses, one-click unsubscribe works
- Cover mutation survivors: attachments, first text part, multibyte cap, member id 0, page clamp, API limit cap, closing connections
- Update OpenAPI, README and example config
2026-11-09 15:22:50 +01:00
tgiachi
19c845caab feat(web): public archive pages and one-click unsubscribe
- Add list index, paginated archive with search, and message pages with thread links
- Show only lists whose archive policy is public; hide others and foreign messages with 404
- Escape all content and obfuscate email addresses in subjects, senders and bodies
- Add GET confirm page and POST one-click unsubscribe with signed tokens
- Send CSP, nosniff, no-referrer and no-store headers
2026-11-09 15:20:45 +01:00
tgiachi
8253dd608e feat(router): archive accepted posts and add per-recipient unsubscribe links
- Archive the original message on delivery and on release, never when held or rejected
- Log archive failures instead of blocking delivery
- Add List-Unsubscribe per recipient: signed one-click URL and the +leave address
- Add signed unsubscribe tokens bound to their purpose
- Fix the mailto unsubscribe address, +unsubscribe was not a known command
2026-11-09 15:20:01 +01:00
tgiachi
4ac967e001 feat(archive): parse messages into archivable entries
- Decode subject, sender name, date, Message-ID and In-Reply-To
- Pick the plain text body from nested multipart, fall back to stripped HTML
- Decode transfer encodings and charsets, repair invalid UTF-8, cap at 1 MiB
- Synthesize a stable Message-ID when missing
- Never expose a sender address domain; add email obfuscation for public pages
2026-11-09 15:18:23 +01:00
tgiachi
d8275aaa1f feat(store,api): archive with full-text search, threading and archive policy
- Add archive table with FTS5 index kept in sync by triggers
- Deduplicate by Message-ID per list so MTA retries do not repeat posts
- Thread messages through In-Reply-To within the same list
- Quote every search word so user input is never FTS syntax
- Add archive_policy (public, private, off) with migration
- Add API to list, search, read and delete archived messages
2026-11-09 15:17:13 +01:00
squidd
aad87be74c Merge pull request 'Harden the test suite' (#8) from chore/test-hardening into main 2026-11-09 15:14:11 +01:00
tgiachi
7fc1bed7e9 fix(app): do not log closed listener errors on shutdown 2026-11-09 15:13:35 +01:00
tgiachi
952fada19c refactor: move daemon wiring into internal/app and test it end to end
- Add app.Start and App.Close, main only parses flags and waits for signals
- Add end-to-end test: API creates a list, LMTP posts, a fake relay receives VERP copies
- Cover disabled API, bad database, busy port and idempotent Close
- Fix a shutdown race: Close before Serve left the LMTP server blocked
2026-11-09 15:12:51 +01:00
tgiachi
d6a0f6e5a9 test: close gaps found by mutation checks
- Cover the default relay batch size
- Cover partial and total relay failure in Router.Send
- Cover stripping of spoofed List-* headers without a base URL
- Cover the end of the confirmation rate-limit window
2026-11-09 15:09:23 +01:00
squidd
d2adddc8a7 Merge pull request 'Milestone 2: moderation, subscribe/unsubscribe confirmation, VERP bounces' (#6) from feat/m2-moderation-subscribe-bounce into main 2026-11-09 15:06:29 +01:00
tgiachi
ad58789630 feat(api): list policies, held queue and member bounce state
- Add post_policy and join_policy to lists, patchable per field
- Add held message listing, approve and discard endpoints
- Expose disabled and bounce_count on members
- Reject '+' in list names, it is the command separator
- Wire the router release into the daemon
- Update OpenAPI description and README
2026-11-09 15:05:11 +01:00
tgiachi
966b3e0234 feat(ingest): dispatch command addresses and held mail
- Route +join, +leave, +confirm and +bounce addresses before list posts
- Accept held mail without relaying it
- Map invalid tokens and closed lists to 550
2026-11-09 15:04:56 +01:00
tgiachi
91c01bcb83 feat(router): moderation, confirmation commands and VERP bounces
- Hold posts on moderated lists and release them on approval
- Add +join, +leave and +confirm-TOKEN command addresses
- Send one message per recipient with a signed bounce envelope sender
- Disable members after 3 hard bounces and skip them on delivery
- Reject forged bounce addresses and tokens from other lists
2026-11-09 15:04:26 +01:00
tgiachi
9eb4d14a70 feat(store): schema v2 with moderation, pending requests and bounce state
- Add member id, disabled flag and bounce counter
- Add per-list post and join policies
- Add held message queue
- Add expiring, rate-limited pending subscribe and unsubscribe tokens
- Add persistent HMAC secret
- Migrate databases created by milestone 1
2026-11-09 15:03:08 +01:00
squidd
131299dc0c Merge pull request 'REST API for administration' (#4) from feat/rest-api into main 2026-11-09 14:58:20 +01:00
tgiachi
1ba42316fd feat: wire REST API into the daemon and document it
- Add api.listen config; token comes from PARSIMONY_API_TOKEN
- Disable the API when the token is not set
- Add OpenAPI description and README usage
2026-11-09 14:57:57 +01:00
tgiachi
7ce6a1c98e feat(api): REST API for lists and members
- Add /api/v1 JSON endpoints: lists CRUD, members add/list/remove, health
- Protect routes with a constant-time bearer token check
- Reject unknown JSON fields and invalid names or addresses
- Map store errors to 404 and 409
2026-11-09 14:57:43 +01:00
tgiachi
e1b0c7666c feat(store): list update, delete, listing and member removal
- Add ListLists, GetList, UpdateList, DeleteList, RemoveMember
- Add ErrExists for duplicate lists
2026-11-09 14:57:13 +01:00
squidd
2b77cb7c05 Merge pull request 'Milestone 1: LMTP ingest and end-to-end discussion list' (#3) from feat/m1-ingest-fanout into main 2026-11-09 14:56:23 +01:00
tgiachi
28d22d51de feat: daemon entrypoint, YAML config and Dockerfile
- Add config loader with defaults and strict unknown-field rejection
- Add cmd/parsimony wiring store, router, relay and LMTP server
- Handle SIGINT and SIGTERM for graceful shutdown
- Add Dockerfile and example config
2026-11-09 14:55:38 +01:00
tgiachi
87744a0d97 feat(ingest): LMTP server with per-recipient status
- Add LMTP server routing each recipient through the router
- Relay accepted mail with a list+bounce@ envelope sender
- Reject unknown lists and non-members with 550
- Return 451 on relay or internal failures so the MTA retries
- Cover end to end with a fake relay
2026-11-09 14:54:57 +01:00
tgiachi
dd2818d392 feat(outbound): SMTP relay sender with batching
- Add Sender interface
- Add SMTPRelay sending in batches of 50 recipients per transaction
- Add Fake sender that records messages for tests
2026-11-09 14:52:40 +01:00
tgiachi
d8f31d9b3e feat(router): rewrite headers for list delivery
- Add List-Id, List-Post, List-Unsubscribe and Precedence headers
- Add one-click unsubscribe (RFC 8058) when a base URL is configured
- Strip incoming List-* headers to prevent spoofing
- Rewrite From as "Name via List" and keep the original in Reply-To
- Copy the message body byte for byte
2026-11-09 14:50:56 +01:00
tgiachi
eb9e992f4a feat(router): accept posts only from list members
- Add Router.Route resolving list, checking sender membership
- Return ErrUnknownList and ErrNotMember
- Return subscriber addresses as recipients
2026-11-09 14:47:44 +01:00
tgiachi
015e0bbd0f feat(store): SQLite store for lists and members
- Add schema with lists and members tables
- Add CreateList, FindList, AddMember, IsMember, Members
- Normalize addresses to lowercase
2026-11-09 14:46:35 +01:00
tgiachi
a5ea90dbee chore: initial project skeleton 2026-11-09 14:44:55 +01:00