feat(pkg): add --omit-group flag to package list command

Agent-Logs-Url: https://github.com/microsoft/azure-linux-dev-tools/sessions/1b729d85-f047-4447-8a61-0344df08ffc5

Co-authored-by: christopherco <35273088+christopherco@users.noreply.github.com>

Author: Copilot

docs/user/how-to/inspect-package-config.md

@@ -90,6 +90,24 @@ azldev package list -a -q -O json
 ]
 ```
 
+To exclude the `group` field from the JSON output (for example, when consumers only
+need package name and channel), add `--omit-group`:
+
+```bash
+azldev package list -a -q -O json --omit-group
+```
+
+```json
+[
+  {
+    "packageName": "libcurl",
+    "component": "",
+    "channel": "rpm-base"
+  },
+  ...
+]
+```
+
 ## Alias
 
 `pkg` is an alias for the `package` subcommand:

docs/user/reference/cli/azldev_package_list.md

@@ -21,6 +21,9 @@ type ListPackageOptions struct {
 	// PackageNames contains specific binary package names to look up.
 	// If a package is not in any explicit config it is still resolved using project defaults.
 	PackageNames []string
+
+	// OmitGroup omits the 'group' field from the output when true.
+	OmitGroup bool
 }
 
 func listOnAppInit(_ *azldev.App, parent *cobra.Command) {
@@ -56,7 +59,10 @@ Resolution order (lowest to highest priority):
   azldev package list -p curl -p wget
 
   # Output as JSON for scripting
-  azldev package list -a -q -O json`,
+  azldev package list -a -q -O json
+
+  # Output as JSON without the group field
+  azldev package list -a -q -O json --omit-group`,
 		RunE: azldev.RunFuncWithExtraArgs(func(env *azldev.Env, args []string) (interface{}, error) {
 			options.PackageNames = append(args, options.PackageNames...)
 
@@ -66,6 +72,7 @@ Resolution order (lowest to highest priority):
 
 	cmd.Flags().BoolVarP(&options.All, "all-packages", "a", false, "List all explicitly-configured binary packages")
 	cmd.Flags().StringArrayVarP(&options.PackageNames, "package", "p", []string{}, "Package name to look up (repeatable)")
+	cmd.Flags().BoolVar(&options.OmitGroup, "omit-group", false, "Omit the 'group' field from the output")
 
 	azldev.ExportAsMCPTool(cmd)
 
@@ -78,7 +85,8 @@ type PackageListResult struct {
 	PackageName string `json:"packageName" table:"Package"`
 
 	// Group is the package-group this package belongs to, or empty if it is not in any group.
-	Group string `json:"group" table:"Group"`
+	// When [ListPackageOptions.OmitGroup] is true, this field is always empty and omitted from JSON.
+	Group string `json:"group,omitempty" table:"Group"`
 
 	// Component is the component that has an explicit per-package override for this package,
 	// or empty if the package is only configured via a group or project default.
@@ -178,15 +186,19 @@ func ListPackages(env *azldev.Env, options *ListPackageOptions) ([]PackageListRe
 			return nil, fmt.Errorf("failed to resolve config for package %#q:\n%w", pkgName, err)
 		}
 
+		group := groupOf[pkgName]
+		if options.OmitGroup {
+			group = ""
+		}
+
 		results = append(results, PackageListResult{
 			PackageName: pkgName,
-			Group:       groupOf[pkgName],
+			Group:       group,
 			Component:   compName,
 			Channel:     pkgConfig.Publish.Channel,
 		})
 	}
 
-	// Sort by package name for deterministic, readable output.
 	sort.Slice(results, func(i, j int) bool {
 		return results[i].PackageName < results[j].PackageName
 	})

internal/app/azldev/cmds/pkg/list.go

@@ -18,6 +18,7 @@ func TestNewPackageListCommand(t *testing.T) {
 	require.NotNil(t, cmd)
 	assert.Equal(t, "list [package-name...]", cmd.Use)
 	assert.NotNil(t, cmd.RunE)
+	assert.NotNil(t, cmd.Flags().Lookup("omit-group"), "expected --omit-group flag to be registered")
 }
 
 func TestListPackages_NoCriteria(t *testing.T) {
@@ -213,3 +214,26 @@ func TestListPackages_DuplicatePackageAcrossComponents_ReturnsError(t *testing.T
 	assert.Contains(t, err.Error(), "curl")
 	assert.Contains(t, err.Error(), "other")
 }
+
+func TestListPackages_OmitGroup_ClearsGroupField(t *testing.T) {
+	testEnv := testutils.NewTestEnv(t)
+	testEnv.Config.PackageGroups = map[string]projectconfig.PackageGroupConfig{
+		"devel-packages": {
+			Packages: []string{"curl-devel"},
+			DefaultPackageConfig: projectconfig.PackageConfig{
+				Publish: projectconfig.PackagePublishConfig{Channel: "devel"},
+			},
+		},
+	}
+
+	results, err := pkgcmds.ListPackages(testEnv.Env, &pkgcmds.ListPackageOptions{
+		All:       true,
+		OmitGroup: true,
+	})
+
+	require.NoError(t, err)
+	require.Len(t, results, 1)
+	assert.Equal(t, "curl-devel", results[0].PackageName)
+	assert.Empty(t, results[0].Group, "group should be empty when OmitGroup is true")
+	assert.Equal(t, "devel", results[0].Channel)
+}