Files
selfpost/docs/roadmap.md
T
mixandClaude Opus 5.5 91dadf7b35
test / test (push) Waiting to run
docs: preflight leaves the roadmap and the design contract
Owner, 2026-10-18: "Preflight там почему остался?" It was not dropped with a
condition for return: what it was for shipped in other forms - its checks on
Server › Health (health-setup-checks, 2.11.0), its test e-mail as a form of
its own (test-email, 2.12.0) - and its mockup went in 2c23f4c. The entry
under Dropped, the route row and the Who-sees-what mention go; the history
is in git and the CHANGELOG. The port-check entry still says it came from
the former preflight, which is where it came from.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 23:56:22 +03:00

9.1 KiB
Raw Blame History

Roadmap: open work

Status: a working tracker of extensions to the product boundary (product.md, .cursor/rules/agent-rules.mdc), each taken up only after explicit agreement. Items marked candidate need an OK before any code is written; detailed design, when an item needs it, lives in plans/. A shipped item leaves this file: what it did is in CHANGELOG.md, its section and plan stay in git history.

Reading this from outside the project: nothing here is a commitment or a release promise. There are no dates, the order is a recommendation rather than a schedule, and an item can be dropped or reshaped once its plan is written. What the project will not do is a separate question, answered in product.md — an item's absence from this file does not mean it is planned but unlisted.

Versioning: SemVer in the 2.x line — MINOR for a feature or a migration, PATCH for a fix. A major only for an explicit break; 2.0.0 was one (schema-migrations.md § 2.0 starts from an empty data directory).

Process: development.md.


Index

ID Topic Status Progress Plan
security-audit-2026-10-17 Stage H of the 2026-10-17 security audit: the test server's host (S1, S2, S5) and its DNS (S3) stages 0-6 shipped 2.14.4, the product side of S3 2.15.0; stage H the owner's 27/29 security-audit-2026-10-17.md § Stage H
go-milter-upstream An issue and a PR for go-milter: its header map outlives a message and is unbounded prepared 2026-10-16, the owner posts — third_party/go-milter/PATCHES.md

After a context reset, pick an item marked agreed or in progress, then work the Implementation checklist in its linked plan. The Progress column above is done/total checklist steps in that plan (development.md § Plan checklists).


security-audit-2026-10-17

The audit's stages 0-6 shipped together as 2.14.4, the server's DMARC hint (the product side of S3) and Verified TLS to the upstream (M7) as 2.15.0. What is left is stage H, the owner's host and DNS, about an hour of his time and no product code: S1, S2 and S5, whose commands are in dev/security-audit-2026-10-17-host.md (not published), and S3's records - _dmarc.selfpost.mixfed.ru TXT "v=DMARC1; p=reject; rua=mailto:<an address you read>" and mixfed.ru CAA 0 issue "letsencrypt.org". The report's § Stage H has the "done when" of each.


go-milter-upstream

Problem (owner, 2026-10-16): the panel builds go-milter v0.4.1 patched (third_party/go-milter, its PATCHES.md): upstream adds every header of a session to a map it hands to Headers and empties only on ABORT. Two things follow, for every user of the library: the map of a second message on one connection still holds the first message's headers (SelfPost met it as audit 2026-10-12, L9, and keeps its own headers since), and the map is bounded by no limit of its own - a message of nothing but headers, up to the MTA's message size limit, is held whole in each milter. Upstream had no issue about it on 2026-10-16; its last commit was 2026-04-04.

Goal: an issue and a PR, prepared here and posted by the owner from his GitHub account (nothing is sent from this side):

  • the issue: both effects, each with a reproduction through the library's own client (two messages on one connection; the map's size at EOH);
  • the PR, small and compatible: the map emptied when a message starts (CodeMail), as it is on ABORT - this fixes the first effect and bounds the second to one message;
  • in the issue, as a proposal: an option of Server not to keep the map, for a milter that reads headers through Header alone - what SelfPost's patch does unconditionally, which upstream cannot take as it is (it would break backends that read the map).

Done when: the texts and the branch are ready for the owner to post.

Prepared (2026-10-16): in dev/upstream-pr (not in git): ISSUE.md, PR.md, a README with the steps, and a clone of go-milter on branch reset-headers-per-message - one commit over master (0277691) that empties the map on SMFIC_MAIL, with TestMilterClient_HeadersPerMessage, which fails on master (the second message sees both From values) and passes with it. Read for the issue: Postfix carries every message of one SMTP session over the one milter connection smtpd opened (Postfix 3.10.13, src/milter/milter8.c:2723, LOCAL_SEND_FD of the milter socket to cleanup; src/smtpd/smtpd.c:3475, milter_send()). When upstream releases a version that does not keep the map (or offers the option), third_party/go-milter goes and go.mod's replace with it.


Dropped, with the condition for return

Items the owner took off the roadmap. Each names what would bring it back; without that it is not offered again.

  • structured-logging (dropped 2026-10-13) - move the panel from log.Printf to log/slog with levels and fields, one logger passed through constructors. Dropped because the panel's log has one reader, the owner, by eye in docker logs; the change is wide (some 225 call sites), changes no behaviour, and gives a new format to everything that reads the output. Returns if: the log goes to an outside collector, or it has to be filtered by level.
  • Certificate warnings measured by the certificate's lifetime (left as it is, owner, 2026-10-14). The panel warns 14 and 3 days before a certificate expires, whatever its lifetime (notify.go, certFirstDays, certLastDays). A certificate issued for less than 14 days is inside the first warning from its first hour, and each renewal of it is a new certificate and a new message. Not reachable with the 90-day certificate the instance has. Returns if: the instance takes a certificate that lives less than 30 days. The rule then offered: the first warning at a quarter of the lifetime left, the last at a tenth, and never earlier than the 14 and 3 days of today - so a longer certificate, a yearly one included, is warned about exactly as now.
  • contributing (dropped 2026-10-13) - a CONTRIBUTING.md in the root: the dev loop, the checks before a PR, the commit protocol. Dropped because there is one developer and no PRs, and everything the file would say is in development.md; a second file is a second copy to keep in step. Returns if: the first outside PR arrives, or the owner decides to invite contributors.
  • A check that ports 25, 465 and 587 are reachable (dropped 2026-10-13, from the former preflight). The panel can only dial its own public address from inside the container: behind NAT without hairpin that shows an open port as closed, and with hairpin it shows as open a port the provider blocks from outside. A card that is wrong both ways is worse than none, and an honest check needs a probe outside the server, which is outside the product (product.md). The administrator's browser cannot do it either: 25, 465 and 587 are on the Fetch standard's list of blocked ports. Two substitutes were offered and declined the same day: a Health line "last connection from outside on each port", read from mail.log, and a command in the help to run from one's own machine. Returns if: the owner accepts an outside probe, or asks for one of the two substitutes.
  • A domain administrator's rows in the queues (decided 2026-10-18: "Пока только Global. Пересмотр по необходимости."). Since 2.16.0 both queues are tables split by the recipient's domain, so the rows of a domain could be shown to the administrator it is assigned to, as the logs are; Outbound › Queue and Inbound › Queue stay the global role's. Returns if: the owner asks for it. The work then: the rows filtered by the user's reach in the handler (outbound by the send-log row's domain or the sender's, inbound by the recipient's), the menu entry and the help topic shown to a domain user, and the per-route 404 tests turned into reach tests.
  • csrf-tokens (decided 2026-10-13) - session-bound tokens on every form. Replaced by origin-strict (2.10.4); the conditions for building tokens after all are in security.md, ADR § CSRF via origin checking.

Ideas, not on the roadmap

Thoughts kept so they are not lost. They are not candidates: nothing here is waiting for an OK, has a version or takes a place in the order above. An idea joins the index only when the owner says so.

  • Inbound quarantine (moved here by the owner on 2026-10-12: "an idea to think about") - hold suspicious inbound mail, review it in the panel, then release it to the upstream or discard it. It would take the relay from passing mail on to storing it for a while, against "no mailboxes" in product.md. Notes and open questions: plans/inbound-quarantine.md; the screens in-quarantine and in-quarantine-message are drawn and stay unbuilt.