Add WrapperGenerator: a standalone cmdlet generator that reproduces published MS Graph cmdlet names

[Joywambui-maina]

Changes proposed in this pull request

• Add tools/WrapperGenerator, a standalone .NET CLI that generates the C# cmdlet
  classes behind commands like Get-MgUserMessage from Graph's OpenAPI description.
  The generated cmdlets call a Kiota-generated C# client (produced separately by
  kiota generate). This was previously prototyped as a -l PowerShellWrapper
  language option inside kiota itself (PowerShell wrapper Phase 1: cmdlet generation for the first 15 Graph modules microsoft/kiota#7986, closed); it moves here
  because the naming rules are Graph-specific — they mirror this repo's module
  configs and command inventory — so they belong next to the SDK, not in a
  general-purpose generator.
• Build cmdlet nouns from the URL path, singularized word by word, instead of from
  the operationId, so the same OpenAPI input always yields the same cmdlet name and
  naming and request routing share one source of truth.
• Reproduce the published SDK's hand-tuned names as checked-in data
  (NamingOverrides.cs, 3 entries, each citing the AutoRest directive it mirrors),
  and skip operations the published SDK deliberately does not ship.
• Emit paired list/item GETs the way the published SDK exposes them: one public
  dispatcher cmdlet with List/Get parameter sets forwarding to internal
  _List/_Get cmdlets.
• Add 69 unit tests whose expected values are published Microsoft.Graph cmdlet
  names taken from MgCommandMetadata.json.
• Add tools/Compare-WrapperCmdletNames.ps1, a parity gate that reconstructs each
  generated cmdlet's HTTP method + URI from its source and joins it against
  MgCommandMetadata.json (the inventory behind Find-MgGraphCommand), exiting
  non-zero on any name mismatch.
• Document the naming algorithm rule by rule in tools/WrapperGenerator/README.md,
  with a shipping cmdlet as evidence for each rule, plus known gaps (no module
  wiring yet, shallow body binding, no $count/$ref/delta/actions).

Why

Customer scripts depend on the exact cmdlet names the SDK ships — Get-MgUserMessage,
not Get-MgUsersMessages. When nouns are derived from operationIds, generated names
leak whatever plurality the spec author chose, and the current AutoRest pipeline has
quietly dropped cmdlets when names collided. For a regenerated module to be a drop-in
replacement, name parity is the hard requirement, so most of this tool is a naming
engine: deterministic path-based nouns, per-word singularization rules, and the few
genuinely hand-tuned published names kept as reviewable data with a cited source each
rather than special cases in code.

Validation

• dotnet test tools/WrapperGenerator.Tests — Passed: 69, Failed: 0.
• Parity gate on a regenerated Mail module:
  .\tools\Compare-WrapperCmdletNames.ps1 → Mail [v1.0]: 4 of 4 cmdlets match the oracle, exit code 0.
• Generated files are source, not a built module; they compile only alongside the
  Kiota-generated client. Wiring both into a buildable module is documented as
  later work in the README.

[Copilot]

Pull request overview

Adds a new standalone tools/WrapperGenerator .NET CLI that generates Microsoft Graph PowerShell wrapper cmdlets with deterministic, path-based naming intended to exactly match the published SDK cmdlet surface, along with parity validation tooling and a set of unit tests. The PR also extends Connect-MgGraph to support -LoginHint for interactive sign-in and updates related authentication docs/specs and pipeline assets.

Changes:

• Introduces tools/WrapperGenerator (naming engine + emitter) and tools/Compare-WrapperCmdletNames.ps1 parity gate against MgCommandMetadata.json.
• Adds a new -LoginHint parameter to Connect-MgGraph and updates auth record persistence to support per-account auth record reuse/migration.
• Updates various docs and OpenAPI description files, plus an Azure Pipelines image refresh pipeline tweak.

Reviewed changes

Copilot reviewed 35 out of 104 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
tools/WrapperGenerator/WrapperGenerator.csproj	New CLI project definition for WrapperGenerator (TFM/packages).
tools/WrapperGenerator/Singularizer.cs	Implements per-word singularization rules used to derive nouns from URL path segments.
tools/WrapperGenerator/SchemaProperties.cs	Extracts shallow primitive body properties into cmdlet parameters for New/Update emitters.
tools/WrapperGenerator/README.md	Documents the naming algorithm, list/item GET pairing behavior, and current limitations.
tools/WrapperGenerator/Program.cs	CLI entry point: reads OpenAPI, applies include-path filtering, runs generation, writes lock file.
tools/WrapperGenerator/PowerShellWrapperGenerationService.cs	Orchestrates generation across operations; handles GET pairing and schema/type resolution.
tools/WrapperGenerator/OperationInfo.cs	Operation metadata record used for naming/emission decisions.
tools/WrapperGenerator/NamingOverrides.cs	Data-driven naming suppressions/overrides to mirror published SDK directives.
tools/WrapperGenerator/IncludePathFilter.cs	Implements --include-path glob + method filtering on the OpenAPI document.
tools/WrapperGenerator/GeneratorExtensions.cs	Shared string/schema helper extensions (case conversion, $ref id access).
tools/WrapperGenerator/GeneratorConfig.cs	Run configuration record (client namespace + output path).
tools/WrapperGenerator/EmitContext.cs	Emitter context (client namespace, cmdlet namespace).
tools/WrapperGenerator/CmdletNaming.cs	Builds cmdlet verb/noun/class names and Kiota builder expressions from operations/paths.
tools/WrapperGenerator.Tests/WrapperGenerator.Tests.csproj	New test project for WrapperGenerator naming/emission behavior.
tools/WrapperGenerator.Tests/SchemaPropertiesTests.cs	Unit tests for primitive property extraction and passwordProfile detection.
tools/WrapperGenerator.Tests/NamingTests.cs	Unit tests pinning naming/builder-expression behavior to published SDK names.
tools/WrapperGenerator.Tests/GenerationServiceRegressionTests.cs	Regression tests ensuring unsupported shapes are skipped without throwing.
tools/WrapperGenerator.Tests/EmitterTests.cs	Tests for correct escaping of spec-derived string literals in emitted C#.
tools/Compare-WrapperCmdletNames.ps1	Parity gate that reconstructs Method+URI from generated sources and joins against the oracle.
src/Authentication/examples/Connect-MgGraph.md	Adds an example showing -LoginHint usage.
src/Authentication/docs/Set-MgRequestContext.md	Updates docs (incl. ProgressAction common parameter content).
src/Authentication/docs/Set-MgGraphOption.md	Adds a sovereign-cloud/WAM workaround example and updates ProgressAction text.
src/Authentication/docs/Set-MgEnvironment.md	Updates docs (incl. ProgressAction common parameter content).
src/Authentication/docs/Remove-MgEnvironment.md	Updates docs (incl. ProgressAction common parameter content).
src/Authentication/docs/Microsoft.Graph.Authentication.md	Updates module metadata and Set-MgGraphOption description wording.
src/Authentication/docs/Invoke-MgGraphRequest.md	Updates docs (incl. ProgressAction common parameter content).
src/Authentication/docs/Get-MgRequestContext.md	Updates docs (incl. ProgressAction common parameter content).
src/Authentication/docs/Get-MgGraphOption.md	Updates docs (incl. ProgressAction text and WAM note).
src/Authentication/docs/Get-MgEnvironment.md	Updates environment list example and adds ProgressAction parameter docs.
src/Authentication/docs/Get-MgContext.md	Updates docs to include ProgressAction common parameter section.
src/Authentication/docs/Disconnect-MgGraph.md	Reorders/updates parameter documentation (ProgressAction + SignOutFromBroker).
src/Authentication/docs/Connect-MgGraph.md	Documents -LoginHint, adds sovereign cloud examples, and updates syntax blocks.
src/Authentication/docs/Add-MgEnvironment.md	Updates docs (incl. ProgressAction common parameter content).
src/Authentication/Authentication/test/Connect-MgGraph.Tests.ps1	Adds assertions that LoginHint exists only in UserParameterSet.
src/Authentication/Authentication/Models/AuthContext.cs	Adds LoginHint to the auth context model.
src/Authentication/Authentication/Microsoft.Graph.Authentication.psd1	Updates module version and generated-on metadata.
src/Authentication/Authentication/Microsoft.Graph.Authentication.nuspec	Bumps package version to 2.38.1.
src/Authentication/Authentication/Microsoft.Graph.Authentication.csproj	Bumps project version to 2.38.1.
src/Authentication/Authentication/Microsoft.Graph.Authentication-help.xml	Help text formatting updates (line wrapping/paragraph reflow).
src/Authentication/Authentication/Constants.cs	Adds help message string for the new LoginHint parameter.
src/Authentication/Authentication/Cmdlets/ConnectMgGraph.cs	Adds -LoginHint parameter and wires it into the delegated interactive auth flow.
src/Authentication/Authentication.Test/Microsoft.Graph.Authentication.Test.csproj	Updates test project/package versions.
src/Authentication/Authentication.Test/Helpers/AuthenticationHelpersTests.cs	Adds tests for per-account auth record paths and login-hint-based record resolution.
src/Authentication/Authentication.Core/Utilities/AuthenticationHelpers.cs	Implements login hint plumbing for InteractiveBrowserCredential and per-account auth record storage/migration.
src/Authentication/Authentication.Core/Microsoft.Graph.Authentication.Core.csproj	Bumps core library version to 2.38.1.
src/Authentication/Authentication.Core/Interfaces/IAuthContext.cs	Adds LoginHint to the auth context interface.
src/Applications/beta/examples/Get-MgBetaServicePrincipalSynchronizationTemplate.md	Removes an example markdown file.
openApiDocs/v1.0/Users.Functions.yml	OpenAPI description updates (property description changes/metadata tweaks).
openApiDocs/v1.0/Users.Actions.yml	OpenAPI description updates (property description changes/metadata tweaks).
openApiDocs/v1.0/Search.yml	OpenAPI description updates (enum/member additions and description tweaks).
openApiDocs/v1.0/SchemaExtensions.yml	Minor OpenAPI wording change (“doesn't” vs “does not”).
openApiDocs/v1.0/Reports.yml	OpenAPI description wording updates for several endpoints.
openApiDocs/v1.0/Devices.ServiceAnnouncement.yml	OpenAPI wording/read-only wording updates.
openApiDocs/v1.0/Devices.CorporateManagement.yml	OpenAPI schema updates (new props/descriptions/read-only wording).
openApiDocs/v1.0/CrossDeviceExperiences.yml	OpenAPI description addition for JSON blob schema.
openApiDocs/v1.0/ConfigurationManagement.yml	OpenAPI description addition for JSON blob schema.
openApiDocs/v1.0/Compliance.yml	OpenAPI schema wording/description updates.
openApiDocs/v1.0/CloudCommunications.yml	OpenAPI wording updates and some schema description removals.
openApiDocs/v1.0/Calendar.yml	OpenAPI schema updates (placeId/servicePlans/service plan schema).
openApiDocs/v1.0/Bookings.yml	OpenAPI wording updates and new backup/notification-related schemas.
openApiDocs/v1.0/BackupRestore.yml	Adds emailNotificationsSetting endpoints/schemas under /solutions/backupRestore.
openApiDocs/beta/Search.yml	Beta OpenAPI additions (informationProtectionLabel, enum member, wording).
openApiDocs/beta/Migrations.yml	Beta OpenAPI wording updates and removal of deprecated validate action path.
openApiDocs/beta/Devices.ServiceAnnouncement.yml	Beta OpenAPI wording/read-only wording updates.
openApiDocs/beta/ChangeNotifications.yml	Adds Web Push-related subscription properties in beta schema.
openApiDocs/beta/Calendar.yml	Removes outdated placeId description text in beta schema.
openApiDocs/beta/Bookings.yml	Beta OpenAPI schema additions/description updates.
openApiDocs/beta/BackupRestore.yml	Beta OpenAPI schema additions (structuredQueryExpression/error/enums).
.gitignore	Adds sweep_results.json to ignored artifacts.
.azure-pipelines/docker-image-refresh.yml	Switches docker image refresh to ACR Tasks (az acr build) and adds pool parameters.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[ramsessanchez]

we can leave this as is, we will update our pipelines accordingly once we migrate over to this generator as main. Feel free to resolve this thread @Joywambui-maina

[ramsessanchez]

same as above

[ramsessanchez]

@Joywambui-maina lets leave the changes to the pipeline out of the scope of this pr.