**Monitoring improvement:** Enhanced `WorkspaceMigrationBuilderException` to include validation error details in the exception message. Previously, Sentry only showed the generic caller-provided message (e.g., "Multiple validation errors occurred while creating agent"). Now the message includes the specific validation error codes and messages (e.g., "Multiple validation errors occurred while creating agent: [AGENT_ALREADY_EXISTS] Agent with name 'workflowAgentc719' already exists").
This is achieved by extracting error details from the structured `OrchestratorFailureReport` and appending them to the `super()` message. The change is safe because:
- All 55 callers use `instanceof WorkspaceMigrationBuilderException` for control flow, not string matching
- The structured `failedWorkspaceMigrationBuildResult` field remains unchanged
- The GraphQL error formatter at `workspace-migration-builder-exception-formatter.ts` already uses `error.message` (line 36), so the richer message will flow through to both Sentry and GraphQL error responses
Sonarly Claude Code
d87260536d