Adds viva engage role member add command. Closes #6819

[nanddeepn]

Adds viva engage role member add command. Closes #6819

[Copilot]

Pull request overview

Adds a new Viva Engage command to assign (add) a role member via Microsoft Graph, including tests and documentation, aligning the Viva Engage role management feature set.

Changes:

• Introduces viva engage role member add Graph command supporting role/user resolution by name or id.
• Adds Mocha test coverage for validation, successful POST behavior, and error handling.
• Adds Docusaurus documentation page and sidebar entry for the new command.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/m365/viva/commands/engage/engage-role-member-add.ts	Implements the new command and Graph POST to add a member to a role.
src/m365/viva/commands/engage/engage-role-member-add.spec.ts	Adds unit tests for validation, success paths, and error handling.
src/m365/viva/commands.ts	Registers the new command name constant.
docs/src/config/sidebars.ts	Adds the new command doc to the Viva Engage sidebar.
docs/docs/cmd/viva/engage/engage-role-member-add.mdx	Adds command reference docs, including preview warning and permissions.

[Copilot]

Docs advertise short options -i/-n for --roleId/--roleName (consistent with engage-role-member-list), but the command schema doesn't define these aliases. Add .alias('i') and .alias('n') (or update docs to remove the short options) so the documented CLI usage works.

Suggested change

	roleId: z.uuid().optional(),
	roleName: z.string().optional(),
	roleId: z.uuid().alias('i').optional(),
	roleName: z.string().alias('n').optional(),

[Copilot]

The warning text has a grammatical error and is inconsistent with the existing engage role member docs. Consider changing "once the API reached general availability" to "once the API reaches general availability".

Suggested change

	This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reached general availability.
	This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reaches general availability.

[milanholemans]

Thanks, we'll try to review it ASAP.

[MartinM85]

Thank you for the contribution @nanddeepn 🚀

Just a few notes from my side. Please check also the comments from Copilot.

[MartinM85]

Rather use the isValidGuid from the validation utils. It validated also the @meId token.

[MartinM85]

The endpoint returns a response, so the command should return the response back to the user.

https://learn.microsoft.com/en-us/graph/api/engagementrole-post-members?view=graph-rest-beta&tabs=http

Suggested change

	await request.post(requestOptions);
	const response = await request.post(requestOptions);
	await logger.log(response);