raft / docs
Release notes

Raft 0.5.0

  • No box cap. A location no longer stops at four saved boxes. Agents create the boxes their task needs; creation only fails for real reasons such as a full pool.
  • Any size. --cpu N and --memory NGiB accept any positive size up to the host's CPUs and RAM. A box from the image gets 1 CPU, 2 GiB and the shared disk; new --from and fork keep the source's CPU, RAM and disk, and each flag overrides only its own value.
  • Own box disks. raft new --disk SIZE gives a box its own ext4 disk with a hard cap that also holds for Docker inside the box. Own disks are opt-in per host: redeploy with --disk-pool SIZE to create the thin LVM pool raft-disks. New boxes, forks, template copies and snapshots are copy-on-write, and a reservation check refuses any request that would overcommit the pool. raft list shows each box's disk.
  • raft capacity replaces raft limits. It is advisory only: it reports host CPUs, RAM, allocations, both pools and how many more boxes of example sizes fit, and never limits creation. JSON fields changed (boxes, estimates, sharedPool, boxDiskPool, headroom, notice).
  • raft self-update. Updates the CLI through the channel that installed it: npm, or a uv tool from the release wheel verified against SHA256SUMS. --check reports without installing (exit 100 when an update exists) and --version X.Y.Z installs a specific release. A notice on stderr at most once a day says when a newer release exists; RAFT_NO_UPDATE_CHECK=1 turns it off. It never installs on its own and never changes hosts.
  • Controller defaults. raft config, raft config set KEY VALUE and raft config unset KEY manage ~/.config/raft/config.json with defaults for location, ttl, cpu, memory and disk. A flag beats the config, which beats the built-in default. --disk shared overrides a configured disk default for one box.
  • Note policies. raft policy LOCATION --require purpose,owner makes a host require those box note fields. new, fork, recover and note refuse a box without them, with an error naming the missing flag, and the host checks again under its lock. Policy changes are recorded on the host and in its journal. This is a guardrail for agents, not a security boundary.

Install on Linux with Python 3.11.8+ using npm install -g @microck/raft@0.5.0, or install the attached Python wheel; existing installs can run raft self-update.

Redeploy each host with this release's deploy/deploy.py. It installs lvm2 and python3-yaml, which raft recover now needs to read backups, and changes nothing else unless you add --disk-pool SIZE to enable own box disks. That needs SIZE plus 20 GiB free on the host; existing storage is never resized.

ARM64 and AMD64 development images accompany this release. Verify SHA256SUMS before importing an image for your host architecture.

On this page