feat: `azdo pipelines` command group

[tmeckel]

This issue tracks establishing the top-level azdo pipelines command group.

Command Group Description

Azure DevOps exposes an az pipelines surface for managing pipeline definitions, runs, variables, variable groups, folders, and supporting resources. azdo should introduce a dedicated pipelines group that organizes all pipeline-related subcommands under a single entry point while following the CLI ergonomics described in ISSUE-TRIAGE.md. This umbrella command wires the immediate children (variable-group, variable, build, runs, pool, queue, and future subgroups such as folders, agent-pools, etc.) as well as top-level leaves (show, create, delete, list, update, run).

CLI Structure

• azdo pipelines (group)
  • azdo pipelines variable-group (subgroup, tracked in feat: Introduce azdo pipelines variable-group subgroup #117)
  • azdo pipelines variable (subgroup, tracked in feat: azdo pipelines variable command group #118)
  • azdo pipelines build (subgroup, tracked in feat: Introduce azdo pipelines build command group #213) — legacy Build API surface; first leaf is list (feat: Implement azdo pipelines build list command #211); show (feat: Implement azdo pipelines build show command #241); cancel (feat: Implement azdo pipelines build cancel command #252); queue (feat: Implement azdo pipelines build queue command #253); nested tag subgroup (Introduce azdo pipelines build tag command group #276 — leaves: add feat: Implement azdo pipelines build tag add command #277, delete feat: Implement azdo pipelines build tag delete command #278, list feat: Implement azdo pipelines build tag list command #279)
  • azdo pipelines runs (subgroup, tracked in feat: Introduce azdo pipelines runs command group #214) — modern Pipelines API surface; first leaf is list (feat: Implement azdo pipelines runs list command #212); show (feat: Implement azdo pipelines runs show command #242)
  • azdo pipelines pool (subgroup, tracked in Introduce azdo pipelines pool command group #239) — agent pools (org-scoped); first leaf is show (feat: Implement azdo pipelines pool show command #244)
  • azdo pipelines queue (subgroup, tracked in Introduce azdo pipelines queue command group #240) — agent queues (project-scoped); first leaf is show (feat: Implement azdo pipelines queue show command #245)
  • azdo pipelines show (top-level leaf, tracked in feat: Implement azdo pipelines show command #243) — pipeline definition by ID
  • azdo pipelines create (top-level leaf, tracked in feat: Implement azdo pipelines create command #254) — create a pipeline definition
  • azdo pipelines delete (top-level leaf, tracked in feat: Implement azdo pipelines delete command #255) — delete a pipeline definition by ID (destructive, with confirmation)
  • azdo pipelines list (top-level leaf, tracked in feat: Implement azdo pipelines list command #256) — list pipeline definitions in a project
  • azdo pipelines update (top-level leaf, tracked in feat: Implement azdo pipelines update command #257) — update a pipeline definition by ID (partial update, name/description/branch/yml-path/queue-id/folder-path)
  • azdo pipelines run (top-level leaf, tracked in feat: Implement azdo pipelines run command #258) — queue a pipeline run by ID or name (legacy QueueBuild path only; --parameters out of scope)
  • Additional subgroups are added here as they are triaged.

The parent group itself does not perform operations but supplies shared persistent flags (e.g., --organization, --project) and help text summarizing the available categories.

Scope & Defaults

• Commands that operate at the project scope will adopt the [ORGANIZATION/]PROJECT positional argument pattern; when only PROJECT is provided, fall back to the configured default organization (per internal/cmd/util helpers).
• Commands that operate at the org scope (e.g. pool show) take a positional ORGANIZATION instead.
• Keep the group help consistent with the Azure CLI description while emphasizing azdo conventions (kebab-case flags, JSON export support).

Implementation Outline

• Create internal/cmd/pipelines/pipelines.go that defines NewCmd(ctx util.CmdContext) *cobra.Command with Use: "pipelines", short and long descriptions, and registers child groups and top-level leaves via:
  • AddCommand(variablegroup.NewCmd(ctx)) (feat: Introduce azdo pipelines variable-group subgroup #117)
  • AddCommand(variable.NewCmd(ctx)) (feat: azdo pipelines variable command group #118)
  • AddCommand(build.NewCmd(ctx)) (feat: Introduce azdo pipelines build command group #213 — legacy Build API subgroup; leaves: list feat: Implement azdo pipelines build list command #211, show feat: Implement azdo pipelines build show command #241, cancel feat: Implement azdo pipelines build cancel command #252, queue feat: Implement azdo pipelines build queue command #253; nested tag subgroup Introduce azdo pipelines build tag command group #276)
  • AddCommand(runs.NewCmd(ctx)) (feat: Introduce azdo pipelines runs command group #214 — modern Pipelines API subgroup; leaves: list feat: Implement azdo pipelines runs list command #212, show feat: Implement azdo pipelines runs show command #242)
  • AddCommand(pool.NewCmd(ctx)) (Introduce azdo pipelines pool command group #239 — agent pools; leaves: show feat: Implement azdo pipelines pool show command #244)
  • AddCommand(queue.NewCmd(ctx)) (Introduce azdo pipelines queue command group #240 — agent queues; leaves: show feat: Implement azdo pipelines queue show command #245)
  • AddCommand(show.NewCmd(ctx)) (feat: Implement azdo pipelines show command #243 — top-level pipelines show leaf; pipeline definition by ID)
  • AddCommand(create.NewCmd(ctx)) (feat: Implement azdo pipelines create command #254 — top-level pipelines create leaf; non-interactive pipeline definition create)
  • AddCommand(delete.NewCmd(ctx)) (feat: Implement azdo pipelines delete command #255 — top-level pipelines delete leaf; destructive pipeline definition delete with confirmation)
  • AddCommand(list.NewCmd(ctx)) (feat: Implement azdo pipelines list command #256 — top-level pipelines list leaf; list pipeline definitions)
  • AddCommand(update.NewCmd(ctx)) (feat: Implement azdo pipelines update command #257 — top-level pipelines update leaf; partial-update pipeline definition)
  • AddCommand(run.NewCmd(ctx)) (feat: Implement azdo pipelines run command #258 — top-level pipelines run leaf; queue a pipeline run)
  • Additional AddCommand(...) calls for any future subgroup.
• Import the new package in internal/cmd/root/root.go and call rootCmd.AddCommand(pipelines.NewCmd(ctx)).
• Ensure ctx.Printer lookups and JSON flag helpers are only wired when leaf commands require them; the group command itself should only manage descriptive help.
• Update docs/ via make docs once child commands land so that the command hierarchy appears in generated markdown.

Testing

• Add/adjust CLI docs tests if present (e.g., snapshot expectations) after the group and initial children are wired.
• Future child issues cover unit and acceptance tests for concrete commands.

References

• Azure CLI registration for the pipelines surface: azure-devops/azext_devops/dev/pipelines/commands.py
• Subgroup parents: feat: Introduce azdo pipelines variable-group subgroup #117 (variable-group), feat: azdo pipelines variable command group #118 (variable), feat: Introduce azdo pipelines build command group #213 (build), feat: Introduce azdo pipelines runs command group #214 (runs), Introduce azdo pipelines pool command group #239 (pool), Introduce azdo pipelines queue command group #240 (queue), Introduce azdo pipelines build tag command group #276 (build tag).
• Leaf children: feat: Implement azdo pipelines build list command #211 (build list), feat: Implement azdo pipelines runs list command #212 (runs list), feat: Implement azdo pipelines build show command #241 (build show), feat: Implement azdo pipelines runs show command #242 (runs show), feat: Implement azdo pipelines show command #243 (pipelines show), feat: Implement azdo pipelines pool show command #244 (pool show), feat: Implement azdo pipelines queue show command #245 (queue show), feat: Implement azdo pipelines build cancel command #252 (build cancel), feat: Implement azdo pipelines build queue command #253 (build queue), feat: Implement azdo pipelines create command #254 (pipelines create), feat: Implement azdo pipelines delete command #255 (pipelines delete), feat: Implement azdo pipelines list command #256 (pipelines list), feat: Implement azdo pipelines update command #257 (pipelines update), feat: Implement azdo pipelines run command #258 (pipelines run), feat: Implement azdo pipelines build tag add command #277 (build tag add), feat: Implement azdo pipelines build tag delete command #278 (build tag delete), feat: Implement azdo pipelines build tag list command #279 (build tag list).