feat: ✨Implement azdo team member add command

docs/azdo_help_reference.md

@@ -1362,6 +1362,23 @@ ls, l
 
 Manage members of a team.
 
+#### `azdo team member add [ORGANIZATION/]PROJECT/TEAM [flags]`
+
+Add one or more members to a team.
+
+```
+-q, --jq expression     Filter JSON output using a jq expression
+    --json fields[=*]   Output JSON with the specified fields. Prefix a field with '-' to exclude it.
+-t, --template string   Format JSON output using a Go template; see "azdo help formatting"
+-u, --user strings      Members to add. Accepts a descriptor, email, principal name, SID, or identity ID. Pass the flag multiple times to add several members.
+```
+
+Aliases
+
+```
+a
+```
+
 #### `azdo team member list [ORGANIZATION/]PROJECT/TEAM [flags]`
 
 List members of a team.

docs/azdo_team_member.md

@@ -4,6 +4,7 @@ Manage members of a team.
 
 ### Available commands
 
+* [azdo team member add](./azdo_team_member_add.md)
 * [azdo team member list](./azdo_team_member_list.md)
 
 ### See also

docs/azdo_team_member_add.md

@@ -0,0 +1,56 @@
+## Command `azdo team member add`
+
+```
+azdo team member add [ORGANIZATION/]PROJECT/TEAM [flags]
+```
+
+Add one or more users or groups as members of a team.
+
+The positional argument accepts the team's project and team name in the
+form [ORGANIZATION/]PROJECT/TEAM.
+
+
+### Options
+
+
+* `-q`, `--jq` `expression`
+
+	Filter JSON output using a jq expression
+
+* `--json` `fields`
+
+	Output JSON with the specified fields. Prefix a field with '-' to exclude it.
+
+* `-t`, `--template` `string`
+
+	Format JSON output using a Go template; see "azdo help formatting"
+
+* `-u`, `--user` `strings`
+
+	Members to add. Accepts a descriptor, email, principal name, SID, or identity ID. Pass the flag multiple times to add several members.
+
+
+### ALIASES
+
+- `a`
+
+### JSON Fields
+
+`memberDescriptor`, `memberDisplayName`, `memberOrigin`, `memberOriginId`, `results`, `status`, `teamName`
+
+### Examples
+
+```bash
+# Add a user by email
+azdo team member add Fabrikam/FabrikamEngineering/MyTeam --user user@example.com
+
+# Add multiple users in a single invocation
+azdo team member add Fabrikam/MyProject/MyTeam -u alice@contoso.com -u bob@contoso.com
+
+# Add a user by subject descriptor
+azdo team member add MyOrg/Fabrikam/MyTeam --user vssgp.Uy0xLTItMw==
+```
+
+### See also
+
+* [azdo team member](./azdo_team_member.md)

internal/azdo/extensions/extension.go

@@ -28,6 +28,10 @@ type Client interface {
 	FindGroupsByDisplayName(ctx context.Context, displayName string, scopeDescriptor *string) ([]*graph.GraphGroup, error)
 	// ResolveSubject resolves a member identifier (descriptor, email, or principal name) into a graph subject descriptor.
 	ResolveSubject(ctx context.Context, member string) (*graph.GraphSubject, error)
+	// ResolveSubjects resolves a batch of member identifiers in a single call, reducing round trips.
+	// Inputs that cannot be resolved are absent from the result map (keyed by the trimmed input string).
+	// The map naturally deduplicates repeated inputs; only catastrophic failures (e.g. client creation) return an error.
+	ResolveSubjects(ctx context.Context, members []string) (map[string]*graph.GraphSubject, error)
 	ResolveIdentity(ctx context.Context, member string) (*identity.Identity, error)
 }