GeezerVison

Summary

PyPI is the only ecosystem that carries a Socket-specific artifact_id PURL qualifier, so one package@version can resolve to several patch variants (one per wheel/sdist release). Only the installed distribution can ever apply, yet scan/get downloaded every variant and remove/rollback mishandled the qualified manifest keys. This PR adds a download-time breadth control and fixes the multi-variant lifecycle bugs it exposed.

Feature — download-time release breadth (narrow by default)

• --all-releases flag (env SOCKET_ALL_RELEASES, default off) on scan and get.
  • Narrow (default): keep only the patch for the locally-installed distribution → smallest .socket/.
  • Broad (--all-releases): keep every release variant → manifest portable across environments (cross-platform CI caches).
• select_installed_variant (core patch/apply.rs): picks the variant whose first patched file is Ready/AlreadyPatched against the on-disk package. Shared by the narrow filter and the rollback dedupe so selection stays consistent with apply.
• filter_to_installed_releases (commands/get.rs): runs in the shared download path. Non-PyPI ecosystems and single-variant packages pass through untouched. Falls back to broad (with a warning surfaced in the JSON warnings array) when the package isn't installed or no variant matches the on-disk bytes.

Correctness fixes surfaced by multi-release manifests

• Base-PURL matching (purl_matches_identifier, core utils/purl.rs): remove/rollback of a base PURL now affect every release variant; a qualified PURL or UUID still targets exactly one. Previously a base PURL matched nothing (manifest keys are qualified for PyPI).
• Rollback variant dedupe: rollback groups discovered packages by base PURL and rolls back only the installed-dist variant — ending the spurious HashMismatch failures a broad manifest would otherwise cause (all variants resolve to the same on-disk file).
• remove lists each variant when a base PURL expands, so the blast radius is visible before confirmation.
• detect_prunable compares on stripped base PURLs, so scan --all-releases --sync no longer prunes the variants it just downloaded.

Tests

• New in_process_pypi_multi_release.rs: real pip install six==1.16.0 + a three-variant wiremock exercising narrow-keeps-one, broad-keeps-all, remove-base-clears-all-and-rolls-back, and rollback-all-succeeds.
• Unit tests for purl_matches_identifier, find_patches_to_rollback, remove_patch_from_manifest, detect_prunable (PyPI keep/prune), and --all-releases parse defaults for scan + get.

Full workspace suite: 1573 passed, 0 failed; clippy clean under the pinned 1.93.1 toolchain.

Co-Authored-By: Claude Opus 4.8 (1M context) [email protected]