Skip to content

[cli-consistency] Missing 'campaign' command documented but not implemented #12744

@github-actions

Description

@github-actions

Issue Description

Priority: High
Type: Missing feature / Documentation mismatch

Problem

The CLI documentation at docs/src/content/docs/setup/cli.md extensively documents a campaign command (lines 408-420), but this command is not implemented in the codebase.

Current State (Documentation)

From docs/src/content/docs/setup/cli.md:

#### `campaign`

Manage campaign definitions. See [Agentic Campaigns Guide](/gh-aw/guides/campaigns/) for complete documentation.

**Quick Reference:**
- `gh aw campaign` - List campaigns
- `gh aw campaign status` - Show live status
- `gh aw campaign new (id)` - Create new campaign
- `gh aw campaign validate` - Validate specs

**Options:** `--json`

Alternative: create an issue with the `create-agentic-campaign` label to trigger automated campaign creation ([docs](/gh-aw/guides/campaigns/)).

Actual State (Source Code)

Evidence from code analysis:

  1. Not in main.go: The campaign command is not registered in cmd/gh-aw/main.go (checked lines 1-628)
  2. No command constructor: Search for NewCampaignCommand in pkg/cli/*.go returned no results
  3. No command file: Only found pkg/cli/workflows/example-campaign.md (example workflow, not command)

Impact

  • Users following documentation will encounter "unknown command: campaign" errors
  • Documentation claims functionality that doesn't exist
  • Confusing user experience when trying documented features

Suggested Fix

Option 1 (Preferred): Remove campaign command documentation until implemented

  • Remove lines 408-420 from docs/src/content/docs/setup/cli.md
  • Keep the alternative method (create-agentic-campaign label) which appears to be the actual implementation

Option 2: Implement the campaign command

  • Create pkg/cli/campaign_command.go with subcommands: list, status, new, validate
  • Register in cmd/gh-aw/main.go
  • Add to appropriate command group (likely "analysis" or "execution")

Related Code

AI generated by CLI Consistency Checker

Metadata

Metadata

Labels

automationclicookieIssue Monster Loves Cookies!documentationImprovements or additions to documentation

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions