GitHubDownloader

Downloads plugin releases from GitHub. Uses GitHub REST API v3 (no auth required for public repos). Optionally uses GITHUB_TOKEN env var for private repos or rate limits. Transport is a seam. With no PSR-18 client injected it goes over `file_get_contents()` with a stream context, exactly as it always has — nothing a host has to change. Injecting one is what makes everything above the transport reachable from a test: version listing, constraint resolution, the zipball download and its fallback tag were all unreachable while the only way in was the network. The same seam `milpa/ai-gateway` and `milpa/mcp-client` already carry. GitHub is one source of plugins, not the only conceivable one: what the installer actually depends on is {@see PluginDownloaderInterface}. The two public methods beyond that port — {@see self::listVersions()} and {@see self::getRepoInfo()} — are GitHub facts, and stay off it.

public function __construct(?string $token = null, ?Psr\Http\Client\ClientInterface $httpClient = null, ?Psr\Http\Message\RequestFactoryInterface $requestFactory = null):

Parameters

public function parseSource(string $source): array

Parse a source string into owner, repo, and optional version constraint. Formats: "acme/mail-plugin" → owner=acme, repo=mail-plugin, constraint=null "acme/mail-plugin:^2.0" → owner=acme, repo=mail-plugin, constraint=^2.0 "https://github.com/acme/mail-plugin" → owner=acme, repo=mail-plugin, constraint=null

Parameters

Throws

\InvalidArgumentException

public function listVersions(string $owner, string $repo): array

List available versions (releases + tags) from GitHub. Filters to valid semver only.

Parameters

Returns

Sorted descending (newest first)

public function resolveVersion(string $owner, string $repo, ?string $constraint = null): Milpa\ValueObjects\SemanticVersion

Find the best matching version for a constraint.

Parameters

Throws

\RuntimeException If no matching version found

public function download(string $owner, string $repo, Milpa\ValueObjects\SemanticVersion $version): string

Download and extract a specific version to a temporary directory.

Parameters

Returns

Path to the extracted plugin directory

Throws

\RuntimeException On download or extraction failure

public function getRepoInfo(string $owner, string $repo): ?array

Get repository info from GitHub API.

Parameters

public function cleanup(string $path): void

Clean up a temporary directory recursively.

Parameters