feat: workflow engine mailbox - #20091

Merged

vxkc merged 103 commits into

mainfrom

feat/workflow-engine-mailbox

Sep 1, 2026

Commits on Sep 1, 2026

mailbox: proposal + implementation plan (stack base)
vxkc
committed
7dbd6d9
workflow-engine: mailbox step 1 — schema, mint, read, close
vxkc
committed
b5ea175
mailbox: orchestration bookkeeping (step 1 done; step 2 scoped)
vxkc
committed
00d7eaa
workflow-engine: mailbox step 2 — delivery ingestion
vxkc
committed
d1cfff1
mailbox: orchestration bookkeeping (step 2 done; step 3 scoped)
vxkc
committed
8b1d22a
workflow-engine: mailbox step 3 — Held, the mailbox declaration, and seq assignment
vxkc
committed
2be6787
mailbox: orchestration bookkeeping (step 3 done; step 4 scoped)
vxkc
committed
8e4d4d8
workflow-engine: mailbox step 4 — the wake and the closure release
vxkc
committed
6204ccd
mailbox: orchestration bookkeeping (step 4 done; step 5 scoped)
vxkc
committed
7ab0b3b
workflow-engine: mailbox step 5a — the deadline sweep and retention
vxkc
committed
107cae1
mailbox: orchestration bookkeeping (step 5a done; registry gap scoped as step 5c)
vxkc
committed
6dfa7fc
workflow-engine: mailbox step 5c — register every receiver's position
vxkc
committed
3ac6313
mailbox: orchestration bookkeeping (step 5c done; step 6 scoped, 5b deferred)
vxkc
committed
b860424
workflow-engine: mailbox step 6 — the delivery callback contract
vxkc
committed
f6110e3
mailbox: orchestration bookkeeping (step 6 done; 5b scoped with folded observability gaps)
vxkc
committed
77f3228
workflow-engine: mailbox step 5b-i — the mailbox read, the endpoint, and the alerts
vxkc
committed
233a20a
mailbox: orchestration bookkeeping (step 5b-i done; 5b-ii scoped)
vxkc
committed
94c7152
workflow-engine: mailbox step 5b-ii — rendering the mailbox under its collection
vxkc
committed
ba42a73
workflow-engine: dashboard — escape attribute and JS-argument interpolation
vxkc
committed
908701e
mailbox: orchestration bookkeeping (engine complete through 5b-ii + XSS fix; step 7 scoped)
vxkc
committed
ae6f9aa
app-lib: mailbox step 7a — MailboxOptions, WithReplyFrom, and the mailbox mint
vxkc
committed
f783f4d
mailbox: orchestration bookkeeping (step 7a done; step 7b scoped)
vxkc
committed
4348a99
app-lib: mailbox step 7b — the expansion's appended enqueue step
vxkc
committed
71e35ff
mailbox: orchestration bookkeeping (step 7b done; step 8 scoped)
vxkc
committed
ee88549
app-lib: mailbox step 8 — the receive handler and the relay saga
vxkc
committed
d9a158b
mailbox: orchestration bookkeeping (step 8 done; step 9 scoped)
vxkc
committed
ccd89d1
app-lib: mailbox step 9 — forwarder rework
vxkc
committed
660c057
mailbox: orchestration bookkeeping (step 9 done; step 10 scoped)
vxkc
committed
a14f747
app-lib: mailbox step 10 — Fiks Arkiv re-plumb
vxkc
committed
6700c23
mailbox: orchestration bookkeeping (step 10 done; implementation complete; step 11 scoped)
vxkc
committed
d7592a0
workflow-engine: mailbox step 11 — mailbox-storm measurement
vxkc
committed
e65ccdb
mailbox: orchestration bookkeeping (step 11 done; step 12 scoped)
vxkc
committed
a66e52d
workflow-engine: retention purge terminates at a zero batch size
vxkc
committed
e2ade65
workflow-engine: classify a repeated idempotency key without throwing
vxkc
committed
8c31e34
workflow-engine: stack hygiene — a stable snapshot, an escaped selector, en-GB spellings
vxkc
committed
e0495dc
app-lib: stack hygiene — required context members, a stable public-API snapshot, dead telemetry
vxkc
committed
75a39f6
app-lib: correct the remedy MailboxTimeoutOutlivesAppCode names
vxkc
committed
cebedde
docs: mailbox stack documentation pass
vxkc
committed
f97c5d0
mailbox: orchestration bookkeeping (step 12 done; stack complete)
vxkc
committed
9ac7003
app-lib: fail a late mailbox reply like any other parked workflow
vxkc
committed
7ff5447
cleanup: cut the mailbox stack's comments back to what earns its place
vxkc
committed
5811acf
chore: squash migrations
vxkc
committed
a2be6fc
docs: one normative home for the mailbox spec
vxkc
committed
25acca7
docs: tighten the technical guide's mailbox section
vxkc
committed
a8e9952
cleanup: second pass over the mailbox stack's comments
vxkc
committed
9b34162
add mailbox batch plan
vxkc
committed
a5697c8
fix: drop a duplicated doc summary tag that breaks the CI build
vxkc
committed
cc08cfc
refactor: release mailbox receivers through one array statement
vxkc
committed
f05f476
refactor: close mailboxes through one set-based statement
vxkc
committed
206272c
feat: close a whole batch of mailboxes in one transaction
vxkc
committed
d828d53
feat: mint a whole batch of mailboxes in one statement
vxkc
committed
40300b6
feat: deliver a whole batch of mailbox messages in one transaction
vxkc
committed
50dad8a
feat: batch mailbox deliveries through a channel buffer
vxkc
committed
b2c8ed7
feat: batch mailbox mints and closures through channel buffers
vxkc
committed
c369ab4
feat: serve the mailbox endpoints from the channel buffers
vxkc
committed
8c1685d
docs: document the batched mailbox buffers
vxkc
committed
e732cf2
docs: name the load the batching win needs; correct the depth gauge
vxkc
committed
aa12031
feat: count mailbox buffer flushes so batching is observable
vxkc
committed
545ac3f
refactor: thin the mailbox batching comments down to the load-bearing ones
vxkc
committed
5a30d7c
cleanup: third pass over the mailbox stack's comments
vxkc
committed
5bcd34b
docs: name the real discriminator behind the mailbox flushes' missing retry
vxkc
committed
5fb9503
docs: complete the connection budget outside the DB pool
vxkc
committed
fa7ada4
cleanup: drop comments
vxkc
committed
c540464
delete implemented proposal
vxkc
committed
46e1fb1
use preferred spelling
vxkc
committed
2c9aeb0
add mailbox api proposal
vxkc
committed
c569b94
app-lib: carry mailboxes as a map keyed by opening stage name
vxkc
committed
61cb96c
app-lib: mint the mailbox in its own engine step
vxkc
committed
bd89484
app-lib: reshape the mailbox pipeline API
vxkc
committed
430d2bc
app-lib: end-to-end integration coverage of a mailbox exchange
vxkc
committed
3adda09
app-lib: dispatch-by-shape cleanup of the mailbox pipeline runtime
vxkc
committed
1de3007
app-lib: document the reworked mailbox pipeline API
vxkc
committed
9596db0
add follow-up plan
vxkc
committed
c325e6f
workflow-engine docs: add execution protocol and step ledger to the phase-2 mailbox plan
vxkc
committed
32c0bce
app-lib: drop the singular reply terminal and close the builder ctor
vxkc
committed
4d5e687
app-lib: re-root the stage result hierarchy for reply handlers
vxkc
committed
99a0ee4
app-lib: order the pipeline as items and extract the segment planner
vxkc
committed
864e3bf
app-lib: name the exchange a receive step answers
vxkc
committed
0d4552e
app-lib: add the HandleReplies builder surface
vxkc
committed
074e97b
app-lib: dispatch receive steps to non-terminal reply handlers
vxkc
committed
0d89aa3
app-lib: continue the pipeline past a concluded exchange
vxkc
committed
4ce1516
app-lib: fail the build when a mailbox handle is answered twice
vxkc
committed
0691d97
app-lib: end-to-end coverage of a sequential multi-exchange
vxkc
committed
0ae29d1
app-lib: document sequential multi-exchange mailbox pipelines
vxkc
committed
283cf90
app-lib: cut mailbox comments the code already states
vxkc
committed
0039235
app-lib: refuse name-less receive steps instead of answering them
vxkc
committed
4af5b9f
add proposal to replace stage name by index
vxkc
committed
4bce0cc
app-lib: identify pipeline stages by index instead of name
vxkc
committed
947affe
docs: rewrite stage doctrine around index identity
vxkc
committed
c471a62
add proposal for one index per step
vxkc
committed
57a688f
app-lib: one index per step — conclusion becomes a pipeline item
vxkc
committed
765f496
docs: one index per step — AGENTS.md, changelog, xmldoc pass
vxkc
committed
23e4dce
delete proposals
vxkc
committed
2241712
app-lib: comment-reduction pass over the one-index-per-step revisions
vxkc
committed
b0c6459
reduce comments
vxkc
committed
3e806a9
mailbox: relay workflows depend on heads; rename unconsumedDeliveries -> unpairedDeliveries
vxkc
committed
a939106
app-lib: restore RunJsonError snapshot to its CRLF expectation
vxkc
committed
9cfebb2
app-lib: rework the Fiks Arkiv surface around the mailbox
vxkc
committed
eccbc03
app-lib: conclude a mailbox exchange from its opening stage
vxkc
committed
0505695
app-lib: end a workflow at every mailbox-opening stage
vxkc
committed
648d061
app-lib: derive each workflow's next segment instead of baking it
vxkc
committed
e725265
app-lib: name the instantiation model by its v9 spelling
vxkc
committed
ce62518
app-lib: spell the mailbox stack's prose in US English
vxkc
committed
14323af