New command: m365 viva engage role list. Closes #6796

[MartinM85]

Closes #6796

[milanholemans]

Thanks @MartinM85! We'll review it soon.

[MartinM85]

I forgot to push the .spec file, but all checks passed anyway.

[milanholemans]

I forgot to push the .spec file, but all checks passed anyway.

That's weird, normally the workflow should fail when there is uncovered code. We'll have a look at it, thanks for letting us know.

[Copilot]

Pull Request Overview

This PR introduces a new CLI command m365 viva engage role list to retrieve all available roles that can be assigned in Viva Engage. The implementation follows the project's established patterns for GraphCommand-based commands.

Key changes:

• Adds a new command to list Viva Engage roles using the Microsoft Graph API
• Implements comprehensive test coverage for the new functionality
• Provides complete documentation with usage examples and response formats

Reviewed Changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/m365/viva/commands/engage/engage-role-list.ts	Main command implementation using GraphCommand base class
src/m365/viva/commands/engage/engage-role-list.spec.ts	Complete test suite covering success and error scenarios
src/m365/viva/commands/engage/EngageRole.ts	TypeScript interface definition for EngageRole data structure
src/m365/viva/commands.ts	Command registration in the commands registry
docs/src/config/sidebars.ts	Documentation navigation structure update
docs/docs/cmd/viva/engage/engage-role-list.mdx	Comprehensive documentation with examples and response formats

[milanholemans]

Looks great, let's do some small tweaks before we merge it.

[milanholemans]

Apart from 2 small comments, it's good to go.