proxy/.scratch/proxyctl/issues/09-release-v1.md

09 — Publish a verifiable proxyctl v1

What to build: A documented and reproducible first release that users on Linux amd64 and arm64 can install, verify, operate safely, diagnose, and remove without relying on distribution-specific packaging.

Blocked by: 08 — Coordinate the Active Profile and complete the Target panel.

Status: done

• proxyctl version reports the build version in human-readable and script-friendly output.
• Process-level smoke tests cover default TUI startup, version, doctor, reset confirmation, and Shell integration install/uninstall using an isolated environment.
• The full automated suite proves no test modifies real Shell startup files, package-manager configuration, Docker state, GNOME settings, or system services.
• Reproducible release automation builds single Linux binaries for amd64 and arm64.
• Release automation emits SHA-256 checksums for every distributed binary or archive.
• User documentation explains installation, first Profile creation, Shell integration, each Target's effects, all status meanings, permission behavior, explicit sudo use, Docker restart risk, diagnostics, reset, and uninstall cleanup.
• Documentation states that proxyctl does not manage proxy processes, test connectivity, elevate privileges internally, collect telemetry, or check for updates automatically.
• Documentation identifies the supported Linux, Shell, APT, Docker, and GNOME boundaries and the intentionally deferred integrations.
• Source installation through Go tooling works without relying on deb, rpm, AUR, Snap, Flatpak, or another distribution package.
• A clean-machine verification demonstrates installation, a Profile workflow, at least one hermetic Target workflow, diagnosis, reset, and removal.