Summary

• buffer Discord gateway error events emitted during provider startup before lifecycle wait listeners are attached
• drain queued startup errors when lifecycle begins, treating disallowed intents (4014) as actionable/non-crashing while preserving fail-fast behavior for other fatal gateway errors
• add regression coverage for queued 4014, queued non-4014 fatal errors, and pre-lifecycle emission capture
• add a changelog fix entry

Root Cause

A Discord gateway error could fire between client/plugin initialization and waitForDiscordGatewayStop listener registration. In that gap, Fatal Gateway error: 4014 events were not owned by lifecycle handling and could surface as uncaught process exceptions.

Testing

• pnpm vitest run src/discord/monitor/provider.lifecycle.test.ts src/discord/monitor/provider.test.ts
• pnpm exec oxlint --type-aware src/discord/monitor/provider.ts src/discord/monitor/provider.lifecycle.ts src/discord/monitor/provider.lifecycle.test.ts src/discord/monitor/provider.test.ts
• pnpm exec oxfmt --check CHANGELOG.md src/discord/monitor/provider.ts src/discord/monitor/provider.lifecycle.ts src/discord/monitor/provider.lifecycle.test.ts src/discord/monitor/provider.test.ts

Greptile Summary

Buffers Discord gateway error events during provider startup to prevent uncaught exceptions when errors fire before lifecycle listeners attach. Disallowed intents (4014) are handled as actionable configuration guidance, while other fatal gateway errors preserve fail-fast behavior. Adds comprehensive test coverage for queued error scenarios and CHANGELOG entry.

Confidence Score: 5/5

• This PR is safe to merge with minimal risk
• Well-architected fix for a specific race condition with proper error handling, comprehensive test coverage (3 new test cases covering all scenarios), and clean resource management via finally blocks. The implementation follows existing patterns and maintains fail-fast behavior for fatal errors while gracefully handling the targeted 4014 intent issue.
• No files require special attention

_{Last reviewed commit: 8e380bd}

_{(2/5) Greptile learns from your feedback when you react with thumbs up/down!}