chore: Update AGENTS.md and architecture docs

[kabir]

No description provided.

[gemini-code-assist]

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.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.