docs: add release notes for the actor non-blocking sends
What changed, and why it matters
This commit only adds documentation (release notes) describing previously merged improvements to an internal actor messaging module. It contains no code changes and no security fixes or vulnerabilities.
No action required; this is a documentation-only commit with no security implications.
Security signals we found
No strong security signals were identified.
Evidence from the diff
The commit adds a single Markdown release note file (docs/release-notes/unreleased/11431.md) summarizing pull request #11431, which introduced non-blocking and shutdown-safe primitives to the actor module. The diff is purely documentation: it describes TryTell, TryAsk, overflow queue behavior, AskThen, and shutdown wait primitives. There are no source code modifications, no bug fixes, and no security-relevant changes in this commit.
Changed components
docs/release-notes/unreleased/11431.mdInspect captured patch +17 / −0
### docs/release-notes/unreleased/11431.md
@@ -0,0 +1,17 @@
+# Technical and Architectural Updates
+
+## Code Health
+
+* The `actor` module gains [non-blocking and shutdown-safe
+ primitives](https://github.com/lightningnetwork/lnd/pull/11431). `TryTell`
+ and `TryAsk` never block from any goroutine and report `ErrMailboxFull`,
+ `ErrMailboxClosed` or `ErrActorTerminated` instead of waiting for room.
+ `Tell` and `Ask` made with the context of a receive turn no longer park on a
+ full mailbox: they spill into a bounded overflow queue, configurable with
+ `ActorConfig.MailboxOverflowLimit`, and fail with `ErrMailboxOverflow` at the
+ cap. A blocking `Send` from outside the actor now waits for that overflow to
+ drain so it can't overtake accepted messages. `AskThen` delivers an `Ask`
+ reply to the caller as a later message, and `Actor.Done`,
+ `Actor.StopAndWait` and `ActorSystem.ShutdownAndWait` let an owner wait for
+ the last `Receive` to return before closing resources. The `actor` module
+ now requires `lnd/queue` v1.2.1.Why this scored 15/100
Community notes
Notes can correct, qualify, or add evidence to the AI analysis. Every note shown here has been validated by a human moderator.
The AI analysis stands alone for now. Submit a note if you can add evidence or important context.