Code Review

This pull request updates the project's architectural and structural documentation, including EVENTQUEUE.md, FLOWS.md, compatibility_0.3.md, and AGENTS.md, to align with recent code changes such as the transition of spec types to Java records and updates to the EventConsumer and ResultAggregator APIs. The review feedback correctly identifies a discrepancy in both EVENTQUEUE.md and FLOWS.md, where consumeOne() is documented as a blocking method, but its actual implementation in EventConsumer.java is non-blocking and throws an exception when the queue is empty. This documentation should be updated to accurately reflect the code's behavior.