Skip to content

Free, Open Source, Self-Hosted WhatsApp API Gateway

docs(session): list the ACTION_REQUIRED writer in the transition table

Yudhi Armyndharisac976668e603
diff --git a/docs/31-session-lifecycle-design.md b/docs/31-session-lifecycle-design.md
index 0ef68491b..18a1b7869 100644
--- a/docs/31-session-lifecycle-design.md
+++ b/docs/31-session-lifecycle-design.md
@@ -148,6 +148,7 @@ writer before anything else:
| → `QR_READY` / `AUTHENTICATING` | engine callbacks (wired in the lifecycle delegate), via the registry's liveness check |
| → `READY` | `handleEngineReady` (also drops a recorded failure reason, see INV-7's rationale comment) |
| → `DISCONNECTED` | init-timeout eviction, graceful stop, logout, forceKill, a delete whose teardown fence times out, the engine `onDisconnected` callback and the liveness watchdog (`handleEngineDisconnected`), the boot reset, a backup import (active rows restored as disconnected), engine-reported `DISCONNECTED` via `onStateChanged`, the takeover sweep's `markLapsedDisconnected` (INV-6) |
+| → `ACTION_REQUIRED` | engine-reported `ACTION_REQUIRED` via `onStateChanged` (ownership-fenced status write; the whatsapp-web.js onboarding-modal fallback), and `onActionRequired` records the reason |
| → `FAILED` | five terminal paths only, all ownership-fenced: see below |
`FAILED` is the one worth spelling out, because it is terminal (neither the boot reset nor the