[spec-enforcer] Enforce specifications for agentdrain, cli

[github-actions]

Specification Test Enforcement

This PR updates specification-driven tests for the following packages, reviewed against their README.md specifications added in commit 3d1140a.

Package	Tests Added	Tests Updated	Spec Sections Covered
actionpins	0	0	No changes needed — tests up-to-date
agentdrain	0	1 removed	Core Components, Types, Utility Functions
cli	3	0	Public API (Docker helpers)

Test Derivation

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

Changes

pkg/agentdrain/spec_test.go

• Removed TestSpec_PublicAPI_Miner_ClusterCount_SPEC_MISMATCH: had an incorrect SPEC_MISMATCH comment (the README does not document ClusterCount() — only Clusters() []Cluster) and was functionally duplicate of the existing TestSpec_PublicAPI_Miner_Clusters test.

pkg/cli/spec_test.go

• Added TestSpec_PublicAPI_IsDockerAvailable: validates IsDockerAvailable returns a bool without panicking. Documents SPEC_MISMATCH: README shows func() bool but implementation requires context.Context.
• Added TestSpec_PublicAPI_IsDockerImageAvailable: validates non-existent image returns false. Documents same SPEC_MISMATCH on the ctx parameter.
• Added TestSpec_PublicAPI_IsDockerImageDownloading: validates non-existent image returns false (no SPEC_MISMATCH — signature matches README).
• Added "context" import for the new tests.

Spec-Implementation Mismatches Documented

Package	Function	Mismatch
cli	IsDockerAvailable	README shows func() bool; implementation is func(context.Context) bool
cli	IsDockerImageAvailable	README shows func(string) bool; implementation is func(context.Context, string) bool

Round-Robin State

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

---

Auto-generated by Package Specification Enforcer workflow §25494513033

Generated by Package Specification Enforcer · ● 823.1K · ◷

• expires on May 10, 2026, 12:15 PM UTC