Files
selfpost/docs/roadmap.md
T
mixandClaude Opus 5.5 d17fee8f81
test / test (push) Waiting to run
docs: the queues stay the global role's, by the owner's decision
Owner, 2026-10-18, asked whether a domain administrator should see their
domains' rows now that the queues are tables: "Пока только Global. Пересмотр
по необходимости." panel-redesign.md § Who sees what quotes it; roadmap.md
§ Dropped records it with the condition for return and what the work would
be.

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

171 lines
9.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Roadmap: open work
**Status:** a working tracker of extensions to the product boundary
([product.md](product.md),
[.cursor/rules/agent-rules.mdc](../.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/](plans/). A shipped item leaves this file: what it did is in
[CHANGELOG.md](../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](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](schema-migrations.md) § 2.0 starts from an empty data
directory).
**Process:** [development.md](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](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](../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](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](../internal/notify/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](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](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.
- **preflight as a page of its own** (dropped 2026-10-13): its installation
checks went to Server › Health (health-setup-checks, `2.11.0`) and its test
e-mail to a form of its own (test-email, `2.12.0`). Its plan,
`plans/preflight.md`, was removed and stays in git history.
- **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](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](product.md). Notes and open questions:
[plans/inbound-quarantine.md](plans/inbound-quarantine.md); the screens
`in-quarantine` and `in-quarantine-message` are drawn and stay unbuilt.