-
Notifications
You must be signed in to change notification settings - Fork 0
Open
0 / 30 of 3 issues completedDescription
This issue introduces the top-level azdo boards command group so users can manage Azure Boards resources directly from azdo.
Command Group Description
Create a boards parent command that is registered under the root CLI and acts as the entry point for work item and backlog management scenarios. The group should provide concise help text describing its relationship to Azure Boards and should follow the repository's conventions for wiring new groups (directory structure, NewCmd(ctx) factory, documentation regeneration, etc.).
Implementation Notes
- Add a new package at
internal/cmd/boardsthat definesNewCmd(ctx util.CmdContext) *cobra.Commandand registers existing/future subcommands. - Ensure the new command group is added to the root command (
internal/cmd/root/root.go) and appears in generated docs (make docs). - Maintain consistency with other top-level groups (aliases, short description, examples scaffold) to keep the CLI ergonomic.
- Delegate feature-specific wiring to dedicated subgroups (work items, area paths, iteration paths) so leaf commands live one level deeper.
Command Wiring
- Implement the group factory in
internal/cmd/boards/boards.goand ensure it registers the child subgroups (work-item,area,iteration). - Update
internal/cmd/root/root.goto includerootCmd.AddCommand(boards.NewCmd(ctx))so the CLI exposes the new top-level entry point. - Run
make docsafter wiring changes to refresh generated help content.
SDK / Client Requirements
- The top-level group itself does not introduce new SDK dependencies. Subcommands under
boardsconsume specific clients (Work Item Tracking, Identity, etc.). - If adding new Azure DevOps clients becomes necessary for future boards subcommands, follow the "Handling Missing Azure DevOps SDK Clients" procedure in
AGENTS.md(extendClientFactory, rungo mod tidyandgo mod vendor, updatescripts/generate_mocks.sh, and implement the factory method) before shipping command logic.
Tooling & Validation
- Format new Go files with
gofmt/goimports. - Run
go build ./cmd/azdo/...to confirm the CLI compiles with the new group wiring. - Add/update hermetic tests and execute
go test ./...; regenerate documentation as part of the validation checklist.
Sub-Issues
- Introduce
azdo boards work-itemcommand group (feat: Introduceazdo boards work-itemcommand group #138) - Introduce
azdo boards areacommand group (feat: Introduceazdo boards areacommand group #139) - Introduce
azdo boards iterationcommand group (feat: Introduceazdo boards iterationcommand group #140)
References
Sub-issues
Metadata
Metadata
Assignees
Labels
No labels