Repository navigation
Virfield v2.0.0
Virfield v2 replaces the TypeScript manager with a single Go control plane for disposable macOS VMs on an Apple Silicon host.
Included
- Four binaries:
virfieldd,virfield,virfield-mcp, andvirfield-lume; authenticated HTTP/MCP APIs and an embedded console. - Durable image/lease jobs, a two-VM capacity limit, explicit capacity errors, per-lease SSH identity isolation, expiry and cleanup.
- Verified macOS 27 image preparation, unattended Setup Assistant, Recovery/SIP automation and the optional Xcode/UI-test provisioning profile.
- Portable service/MCP preparation using the operator's account, HOME, configured paths and ports. No personal checkout paths or deployment credentials are bundled.
Install
Download virfield-v2.0.0-darwin-arm64.tar.gz and SHA256SUMS, then run shasum -a 256 -c SHA256SUMS before extracting. Follow Operations for dependencies and service registration.
The archive contains macOS/arm64 binaries, source, documentation, deployment tools, third-party license notices and a revision/hash manifest. Binaries have ad-hoc signatures; this is not an Apple-notarized installer. Lume, Python/VNC dependencies, Tesseract, Xcode and Apple restore media are installed separately.
Validation
- Clean source build and race tests with an empty HOME and empty Go caches; dependency integrity and static analysis passed.
- Linux and macOS GitHub Actions checks passed for the tagged commit, including current Go vulnerability checks and full-history secret scanning.
- Gitleaks found no secrets in all 50 reachable commits or the extracted release; binary hashes/signatures and installation smoke checks passed.
- Earlier real-host acceptance covered the Apple IPSW download/resume, full image build, two isolated clones, third-VM refusal, SSH/tunnels and cleanup. Verification records evidence and remaining limits.
Supported scope
VM hosting requires Apple Silicon macOS. The implemented image recipe is macOS 27 build 26A428; the full UI-test profile requires Xcode 27 or newer. Linux is supported for compilation/tests, not VM hosting. End-to-end image acceptance was performed on one physical Mac; a second-host image build, prolonged soak and full VM-disk disaster recovery are not yet accepted. Broker/Runner/Balda integration, remote TLS routing and per-principal authentication remain separate work.
The previous application is preserved in branch v1; main contains only the Go implementation. This release does not migrate or restart existing installations automatically.