residual/init
=============

userspace init daemon and service manager for residual.

`res-init` runs alongside the host init system (systemd, openrc, runit). It
loads Lua service scripts, harvests zombie processes, exposes a
JSON-over-UNIX-socket RPC, and optionally launches a session binary.

packages:
  init/config/    init-specific TOML config and services.toml registry helpers.
  init/install/   host-init service file writers (systemd, openrc, runit).
  init/service/   service definition loading, dependency ordering, and runner.

binary:
  res-init   daemon + client for residual services.

             daemon mode:
               res-init daemon                 # user mode
               res-init daemon --system        # system mode
               res-init daemon --skip-session  # user mode, no session launch

             client mode:
               res-init ping
               res-init status [name]
               res-init start <name>
               res-init stop <name>
               res-init restart <name>
               res-init enable <name>
               res-init disable <name>
               res-init add <path.lua>
               res-init remove <name>

             system scope (prefix with `system`):
               res-init system ping
               res-init system status [name]
               ...

build:
  go build ./cmd/res-init

module:   git.merith.xyz/residual/init
requires: git.merith.xyz/residual/core

design docs:
  docs/init-design.md      full init subsystem design
  docs/res-init-client.md  daemon/client command reference