manage

Documentation

Overview

Package manage is the host's self-management surface: it edits the managed plugins.go composition and rebuilds the binary. It is invoked by the herrscher dispatcher for the plugin/update/install verbs. Runtime lives in the host; this is install/update/plugin tooling only.

Index

• func InitCmd(ctx context.Context, args []string) int
• func InstallCmd(ctx context.Context, args []string) int
• func PluginCmd(ctx context.Context, args []string) int
• func UpdateCmd(ctx context.Context, args []string) int

Functions

func InitCmd

func InitCmd(ctx context.Context, args []string) int

InitCmd composes the host's plugin stack from scratch: it picks one module per category (defaulting to the batteries-included stack), rewrites plugins.go to exactly that set, seeds a .env from .env.example, asks where agent turns run (route policy, gateway credentials, default model), then go-gets and rebuilds. Pass --gateway/--backend/--memory/--orchestrator to swap a category, the kind "none" to drop one, or --with MODULE to pin an extra module verbatim.

func InstallCmd

func InstallCmd(ctx context.Context, args []string) int

installCmd builds the host binary from its current plugin composition, then delegates to `herrscherd service install` for the OS-service glue (systemd / launchd / Task Scheduler). The CLI never reimplements that glue — it lives in core/service, exposed by the host. Anything after `--` is forwarded verbatim to the host's service install (e.g. --health-addr, --env-file, --cmd).

func PluginCmd

func PluginCmd(ctx context.Context, args []string) int

PluginCmd lists, adds or removes a compiled-in plugin in the managed plugins.go, rebuilding the binary on a change.

func UpdateCmd

func UpdateCmd(ctx context.Context, args []string) int

updateCmd bumps every compiled-in plugin to its latest version, then rebuilds the host. This is the plugin-side counterpart to `herrscherd service update` (which pulls the host's own source): here we refresh the blank-imported plugin modules listed in plugins.go and re-tidy/rebuild the composition.