Skip to content

Clone, Box updates, ephemeral runs, CLI exit codes and lifecycle fixes - #2

Merged
KitsuneSemCalda merged 5 commits into
masterfrom
integrations-opt-out-and-fixes
Oct 2, 2026
Merged

KitsuneSemCalda merged 5 commits into
masterfrom
integrations-opt-out-and-fixes

Conversation

@KitsuneSemCalda

Copy link
Copy Markdown
Collaborator

Implements most of docs/TODO.md (P1/P2 and the QEMU front) and three P3 items released by the owner (Clone, Box update, omavm run --ephemeral). Also carries the v0.3.0 PKGBUILD commit.

New

  • Clone (omavm clone NAME NEW, "Clone…" on the card): Box via distrobox create --clone (stopped; the commit image is removed with the clone), Machine via a sparse/reflink copy of its stopped disk, snapshots included, after a free-space check. The dialog states what is copied and the cost first.
  • Update a Box (omavm update NAME, "Update System"): distrobox upgrade, package-manager lines shown as progress.
  • Ephemeral: omavm start --ephemeral / "Start Without Keeping Changes" (QEMU -snapshot, snapshots refused meanwhile) and omavm run --ephemeral --image ISO (new Desktop, deleted when it shuts down; Ctrl+C ends and deletes it; no daemon).
  • CLI contract for agents: exit codes 0–6 by error class, {"error": {code, message}} with --json; exec/ssh pass the command's code through (README "Exit codes").
  • Status: pending restart, Travel Mode trimming CPUs, low host disk, session that ended without shutting down; per-capability guest integration (clipboard via the vdagent port, shared folder via guest-get-fsinfo); one-way clipboard option.
  • GUI: Box creation progress (image pulled first), viewer disconnect panel with Reconnect, single-instance Experience Center, terminal color strip / scrollback keys / font zoom, distribution name on cards, primary action labels that say the result, open-after-create, KVM warning before creating a Desktop, apps export progress and results.

Fixes

  • QMP: per-command timeouts (long ones for disk snapshots), structured errors, and snapshot commands left without a reply reconciled through query-block instead of guessed.
  • A snapshot gone from the disk no longer blocks removal and retention.
  • Resume reports a disk-full pause that comes right back; a paused Machine whose shutdown times out is paused again, never left running.
  • Locked disk, memory above the host's and unreadable ISOs explained at Start.
  • The list poll no longer waits 700 ms per running Machine for an absent guest agent (~720 ms → ~10 ms).
  • make install points the launcher entry at the installed binary; desktop entry categories fixed.

Verification

  • gofmt -l ., go vet ./..., go test ./... (Core run tests also with -race), make test-qml (70), make test-backend (14), make test-terminal (35), make build-gui.
  • Exercised against real QEMU 11.1, Distrobox 1.8 and Podman (isolated state and storage): clone/update/ephemeral flows, locked disk, memory check, QMP formats, unexpected exit, paused shutdown timeout.
  • Not verified (needs a real session or an installed guest): visuals in a live Omarchy session, guest-side clipboard/shared-folder "ready" states, Reconnect and the bar icon tint in the shell. Each is noted in docs/TODO.md.

The JSON contract changed additively (list --status gains integration.capabilities; golden updated).

Bump to the v0.3.0 tag and its checksum. The GUI links GIO and EGL since
the D-Bus display, so depend on glib2 and libglvnd; drop qt6-tools, which
the build never used (qmake6 ships in qt6-base).
New:
- omavm clone (Box via distrobox --clone, Machine via a sparse/reflink
  copy of its stopped disk with snapshots); "Clone…" says the cost first.
  A Box clone's commit image goes away with the clone.
- omavm update / "Update System" for Boxes (distrobox upgrade), with the
  package manager's lines as progress on the card.
- omavm run --ephemeral: a new Desktop that is deleted when it shuts
  down; start --ephemeral / "Start Without Keeping Changes" for existing
  ones (-snapshot, snapshots refused meanwhile).
- Stable CLI exit codes (0-6) and {"error": {code, message}} with --json;
  exec/ssh pass their command's code through.
- Progress while creating a Box (image pulled first, layer by layer).
- Status says when saved settings wait for a restart, when Travel Mode
  trimmed CPUs, when the host disk is low, and when a session ended
  without shutting down.
- Per-capability guest integration (clipboard via spice-vdagent's port,
  shared folder via guest-get-fsinfo) and a one-way clipboard option.
- Viewer: disconnect panel with Reconnect; Experience Center is single
  instance; terminal color strip, scrollback keys and font zoom; the
  card names the distribution and says what its main action does;
  creation offers to open the new environment; KVM warning before
  creating a Desktop.

Fixes:
- QMP: per-command timeouts, structured errors, and snapshot commands
  left without a reply reconciled through query-block.
- A snapshot gone from the disk no longer blocks removal and retention.
- Resume reports a disk-full pause that comes right back; a paused
  Machine whose shutdown times out is paused again, never left running.
- Locked disk, too much memory and unreadable ISOs explained at Start.
- The list poll no longer waits 700 ms for an absent guest agent.
- make install points the launcher entry at the installed binary.
Start blamed /dev/kvm whenever it was inaccessible, even when QEMU never
ran because the binary was missing, hiding the install hint. CI runners
have no KVM, so TestMissingBinaryDiagnostic failed there. The test now
runs without KVM too.
machine/qemu, box/distrobox and box/container (the legacy Podman/Docker
adapter), next to the box router. Code is unchanged; imports, comments
and docs follow the new paths, and CLAUDE.md records the convention.
Qt 6.4's QML parser still reserves long (an ES3 future reserved word),
so the whole file failed to compile on CI; newer Qt accepts it.
@KitsuneSemCalda
KitsuneSemCalda merged commit f2c1a38 into master Oct 2, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant