QUEUE-144: Legacy listener source; deliver through #1746 [do not merge]

[peter-lawrey]

Deliver the complete listener lifecycle once through #1746, based on #1745 and the merged Wire #1280 implementation. Preserve this older branch as a comparison/reference; do not split its API, helper and integration into incomplete children.

There is a substantive semantic difference. This branch's ContextListenerCoreTest.indexedWriteDoesNotNotifyButStartsAppender consumes ordinary registration through an indexed write. #1746 instead tests indexedWriteDoesNotNotifyOrConsumeListenerRegistration and exactHistoricalRecoveryDoesNotChangeOrdinaryContext. The modern policy keeps exact recovery from consuming ordinary registration and includes stronger callback escape/failure handling.

Builder configuration, appender-local state, first notification, retained writers, nested/held documents, rollback and re-entry must agree on that modern contract. The old default-clock prerequisite #1729 remains part of the reference history; no second listener delivery is created on it.

Retained source 71c9db2f3c9f6a55a4cc5bc487802253df83930c includes current develop and the updated old prerequisite. The refresh's full test pass remains evidence for that older tree, not evidence that the two lifecycle policies are interchangeable.

[Copilot]

Pull request overview

Adds per-appender context listeners that emit context before the first data document of each queue roll.

Changes:

• Adds queue- and appender-level listener configuration.
• Supports retained/progressive writers and rejects incompatible buffering.
• Adds lifecycle and rollover tests.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
ContextListenerCoreTest.java	Tests listener lifecycle and rollover behavior.
StoreTailer.java	Exposes the current cycle as context count.
StoreAppender.java	Integrates listener invocation into writes.
SingleChronicleQueueBuilder.java	Adds listener configuration and validation.
SingleChronicleQueue.java	Propagates listener state to appenders.
ContextListenerState.java	Implements listener state and writer handling.
ExcerptAppender.java	Documents and exposes listener configuration.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.