4.0 KiB
Executable File
4.0 KiB
Executable File
Архив исходника README.md
Источник: Virfield, commit a1460d3372bdfbb5cb19d633d41dd5d3fb3164e6. Снимок перед релизной очисткой. Исторические утверждения ниже относятся к моменту исходной записи; актуальное состояние — в personal/projects/virfield.
# Virfield
Virfield is a Go control plane for local Tart macOS VMs and SSH-controlled
physical macOS/Linux nodes. Linux nodes can also host disposable macOS lab VMs
through rootless Podman/QEMU/OpenCore. It owns images, leases, capacity, pinned
SSH, desktop tunnels, durable jobs and confirmed cleanup. Execution Broker owns
queues, commands, runs, approvals and workload artifacts.
The maintained checkout is this repository. Current release hardening is
published on `codex/retire-lume-release-hardening`; `main` has not been promoted
to that candidate. The earlier `virfield-v3` worktree/branch is obsolete. Virfield switched to Tart on
2026-10-08; the runtime/factory/wrapper/build/install Lume code is removed. The separate old LaunchDaemon was disabled and booted out on 2026-10-14, with rollback files preserved. Current release gates are tracked
in [Verification](docs/VERIFICATION.md); old Lume runbooks are archived, not
installation instructions for the current product.
| Document | Authority |
|---|---|
| [Operations](docs/OPERATIONS.md) | Installation, configuration, services, client registration and recovery |
| [Agent guide](docs/AGENT-GUIDE.md) | MCP tool arguments, pinned SSH, retries and workflows; embedded help |
| [Image pipeline](docs/IMAGE-PIPELINE.md) | Tart/node image contracts, qualification and recovery |
| [Verification](docs/VERIFICATION.md) | Actual acceptance evidence, current defects and release gates |
| [Architecture](docs/ARCHITECTURE.md) | Current modules and lifecycle invariants |
| [Remote debugging](docs/REMOTE-DEBUG.md) | Existing generated VS Code workflow and its acceptance limits |
| [3.0 plan](docs/VIRFIELD-3-PLAN.md) | Delivery state and remaining target architecture |
| [Platform boundaries](docs/COMPOSITIONAL-PLATFORM.md) | Current product responsibilities and future components |
## Build
Go's minimum patch and dependencies are pinned in `go.mod`. The console is
embedded HTML/CSS/JavaScript and needs no frontend build. On macOS the native
Apple sign-in browser is also built. Runtime state, credentials, VM disks,
archives and installed binaries belong outside the checkout.
```sh
make check
make build
./bin/virfield -help
```
Release checks also include the pinned Staticcheck, module integrity,
`govulncheck`, Gitleaks and a clean archive/extraction test. A green unit suite
does not establish live workload or disaster-recovery acceptance.
## Supported deployment and release scope
The accepted runtime paths are local Tart and the R1–R3 SSH/node slices. Orchard
has an adapter but is not accepted for deployment. The broader 3.0 API, grants,
node-agent, browser desktop and VS Code extension remain roadmap work.
[Published v2.0.0](https://github.com/mallexxx/virfield/releases/tag/v2.0.0)
is a historical Lume release, not an archive of the current Tart implementation.
Use the current source and Operations until a new release passes its gates.
The [Broker macos27 reacceptance record](docs/VERIFICATION.md#broker-macos27-reacceptance)
records the current cross-project boundary and the evidence required to close it.
The operator requires the standard VM account `admin/admin`; automatic random
account-password rotation was removed in `0f8bc20` and later. Installed full
native/reboot/workload cycles passed for both Monterey inventories, the new
macOS27 golden and HTPC Sonoma/Sequoia. Pinned SSH key isolation, native GUI/new
SSH key-storage checks and preserved old golden identities remain required.
The [maintained plan](docs/VIRFIELD-3-PLAN.md) tracks all five delivered follow-ups,
current acceptance and the remaining 3.0 architecture. The earlier guest-kernel
stall remains unexplained; later successful cycles are not a causal fix.