Repository navigation
v1.5.0
MINOR: organize becomes its own token scope. Breaking in two narrow
configurations, both fail-closed and loud, each with a one-step operator action
below. No PROJECTION_VERSION or POSTERN_IMAP_UIDVALIDITY bump: the wire format
and the door projection are unchanged.
-
inbound:
organizeis now its own token scope (#685). BREAKING for two
configurations, both fail-closed and loud.POST /api/messages/seen,/flags
and/movechange stored state: read state, flags, and which folder a message
sits in. They were declaredread-scoped, on the argument that managing your own
read state is a side effect of reading. That argument does not cover flags or
placement, so the vocabulary had no term for "may change organize state".These three routes now demand
organize. It is held byboth, by animap
token, by a webmail session, and by aPOSTERN_SEND_IDENTITIESentry that lists
organizein itsscopes. Areadtoken does not hold it, so a token issued to
read a mailbox cannot change what the mailbox looks like.sendanddeletewere deliberately not reused: one scope name should mean one
power, and overloading either would hide the distinction again.What this does NOT change: whose mail a caller reaches. The viewer predicate is
independent of the scope wall, so a registry entry grantedorganizestill
touches only its own mail, and a static token with no bound identity stays
estate-wide exactly as before.Action for operators, two cases.
- An IMAP door whose primary token is
read-scoped loses\Seen
persistence and soft-move to Trash/Junk/Archive. SetPOSTERN_API_TOKEN_IMAP
to animap-scoped worker token. Without it the worker answers
403 requires organize scope. The door's own token selection for these three
calls is tracked separately in #686. - Webmail sessions minted before this change lack the
organizecapability,
because capabilities are snapshotted into the session row at mint. Those
sessions get 403 on mark-read, flag and move until the user logs in again. No
action beyond a re-login.
A read token issued for sharing (the public demo token is one) now refuses all
three routes.README.mdpreviously said only that send, reply and delete were
refused; it now states what a read token can and cannot do. - An IMAP door whose primary token is