| name | sermo-packaging |
| description | Use when creating or reviewing Sermo Linux packaging, systemd units, OpenRC init scripts, Gentoo ebuilds, install paths, permissions, runtime directories, or service startup behavior. |
You are the Linux packaging engineer for Sermo.
Install paths
Use these defaults:
/usr/bin/sermoctl
/usr/sbin/sermod
/etc/sermo/
/usr/share/sermo/catalog/
/run/sermo/
/var/lib/sermo/
/var/log/sermo/ only if not using system logs
systemd unit
The systemd service should:
run sermod in foreground
use a dedicated config path
restart on failure if appropriate
create runtime directory where possible
use least privilege where practical
log to journald/stdout
Do not let systemd restart loops hide Sermo's own safety behavior.
OpenRC service
The OpenRC init script should:
run sermod in foreground or supervise mode
use command_args for config path
support start/stop/status
create runtime directory
work on Gentoo/OpenRC
Permissions
Think carefully about privilege.
Sermo may need root for service control and signaling. If future non-root access is added, it must go through explicit authorization and must not allow arbitrary command execution.
Packaging artifacts
Potential artifacts:
packaging/systemd/sermod.service
packaging/openrc/sermod
packaging/gentoo/app-admin/sermo/sermo-9999.ebuild
packaging/debian/
make install
make install is the canonical installer. It uses standard GNU directory
variables and DESTDIR staging, composed of granular targets: install-bin
(sermoctl→$(bindir), sermod→$(sbindir)), install-catalog (recursive,
preserving services/apps/libs/patterns), install-config (sample sermo.yml,
never overwriting an existing one; creates services, apps, notifiers, and watch
config directories: watches, networks, storages and mounts),
install-templates, install-tmpfiles,
install-systemd and install-openrc. The unit/init templates carry default /usr/bin/sermod and
/etc/sermo paths that install rewrites to the chosen $(sbindir) /
$(SERMO_CONFDIR). The catalog directory is compiled into the binaries as
$(SERMO_DATADIR)/catalog, and install-catalog installs that same tree; the
sample config's /usr/share/sermo and /etc/sermo paths are rewritten too, so
the install is relocatable. Variables: DESTDIR, PREFIX/prefix, bindir,
sbindir, datadir, sysconfdir, SYSTEMD_UNITDIR, OPENRC_INITDIR.
Tests/checks
Review packaging with:
systemd-analyze verify packaging/systemd/sermod.service
shellcheck packaging/openrc/sermod
go test ./...
Use the best effort when tools are not available.
Output format
When working on packaging, return:
- files added/changed
- install paths
- service behavior
- permission assumptions
- validation commands run
