[spec-enforcer] Enforce specifications for cli

[github-actions]

Specification Test Enforcement

This PR updates specification-driven tests for the following packages:

Package	Tests Changed	Spec Sections Covered	Notes
cli	Corrected	Public API, Types, Design Decisions	Converted from package cli to package cli_test; removed internal function tests

Packages Reviewed (No Changes Needed)

Package	Status	Spec Coverage
actionpins	Up-to-date	Public API, Types, Thread Safety
agentdrain	Up-to-date	Public API, Types, Design Decisions

Changes Made

pkg/cli/spec_test.go:

• Changed package declaration from package cli (internal) to package cli_test (external) — the correct form for specification-driven tests
• Removed tests for unexported internal functions (parseRepoSpec, parseWorkflowSpec, parseSourceSpec, buildSourceStringWithCommitSHA) that violate the spec-first methodology
• Renamed TestIsCommitSHA → TestSpec_PublicAPI_IsCommitSHA for consistent naming convention
• Added github.com/github/gh-aw/pkg/cli import and cli. prefixes throughout

Test Derivation

All tests are derived from README.md specifications, not from implementation source code.

Spec-Implementation Mismatches (Previously Documented)

• actionpins: GetActionPins() documented in README but not implemented; proxy test via GetActionPinsByRepo
• agentdrain: ClusterCount() referenced in README but not implemented; len(Clusters()) used instead

Round-Robin State

• Run mode: round-robin
• Packages processed this run: actionpins, agentdrain, cli
• Next packages in rotation: constants, envutil, fileutil
• Total eligible packages: 22 (with README.md)

---

Auto-generated by Package Specification Enforcer workflow (§25317826810)

Generated by Package Specification Enforcer · ● 716.4K · ◷

• expires on May 7, 2026, 12:18 PM UTC