Skip to content

Software: add Flatpak and Snap backends (design 0018) - #44

Merged
mastacontrola merged 2 commits into
mainfrom
feat/software-more-backends
Nov 9, 2026
Merged

mastacontrola merged 2 commits into
mainfrom
feat/software-more-backends

Conversation

@mastacontrola

Copy link
Copy Markdown
Member

The software capability ran every entry through Chocolatey, so Linux hosts had no backend. Each entry now runs through the backend it names: choco, flatpak or snap. The admin picks the backend per entry.

  • flatpak and snap run system-wide as root. Neither can hold an exact version, so a pinned entry reports cannot_run with the reason.
  • The agent installs neither tool and adds no remote. A missing tool reports cannot_run. fog-docs gives the manual steps.
  • SoftwareMissing replaces SoftwareBlocked. Only a backend whose binary is missing is checked every poll. A failing installed-list now retries at the drift check instead of every poll.
  • Every poll declares software-backends-v1. A server sends an agent that does not declare it Chocolatey entries only (Software: offer Flatpak and Snap backends to the fog-agent fogproject#2079).
  • The Chocolatey bootstrap runs on Windows only. On Linux it failed every run.

Tests: parsers are tested against real flatpak list and snap list output from Fedora 44, plus a shim end-to-end test; the parser and poll-feature tests were seen red first.
Lab: a 0.1.22-lab build on fog-agent-test (Debian 13) installed hello-world (snap 6.4) and Flatseal (flatpak 2.4.1), removed the snap on absent, refused a pinned snap, reported Chocolatey missing on Linux, and did not re-run the set each poll.

Homebrew is not here: brew refuses to run as root, and the macOS package does not exist yet (0018 section 6).

🤖 Generated with Claude Code

mastacontrola and others added 2 commits November 9, 2026 04:45
The software capability ran every entry through Chocolatey. Linux hosts
had no backend. Each entry now runs through the backend it names:
choco, flatpak or snap. The admin picks the backend per entry.

- flatpak and snap run system-wide as root. Neither can hold an exact
  version, so a pinned entry reports cannot_run with the reason.
- The agent installs neither tool and adds no remote. A missing tool
  reports cannot_run; fog-docs gives the manual steps.
- SoftwareMissing replaces SoftwareBlocked: only a backend whose binary
  is missing is checked every poll. A failing installed-list now retries
  at the drift check instead of every poll.
- Every poll declares software-backends-v1. A server sends an agent that
  does not declare it Chocolatey entries only, because v0.1.21 and
  earlier run every entry through Chocolatey.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The bootstrap is a PowerShell script. On Linux it failed every run and
logged a failed bootstrap before the entry reported Chocolatey missing.
Seen on the fog-agent-test lab VM.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mastacontrola
mastacontrola merged commit 397f676 into main Nov 9, 2026
2 checks passed
@mastacontrola
mastacontrola deleted the feat/software-more-backends branch November 9, 2026 11:15
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