Skip to content

Virfield v2.0.0

Choose a tag to compare

@mallexxx mallexxx released this 30 Sep 05:53
· 207 commits to main since this release

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, and virfield-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.