daemon

package

v1.5.5 Latest Latest Go to latest Published: Jul 5, 2026 License: MIT Imports: 19 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/a-novel-kit/stack

Links

Open Source Insights

Documentation ¶

Overview ¶

Package daemon owns the daemon's process lifecycle: socket listener, graceful shutdown, signal handling, and recovery of orphan containers. The RPC handlers live in internal/daemon/server.

Index ¶

func Run(ctx context.Context, opts Options) error
type Options

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func Run ¶

func Run(ctx context.Context, opts Options) error

Run starts the daemon: binds the unix socket, serves connect-rpc until ctx is cancelled or a shutdown signal arrives, then cleans up the socket file. Blocks until the daemon exits — callers wanting a background daemon must fork the process themselves (see cli/core/start).

Types ¶

type Options ¶

type Options struct {
	Version    string         // daemon binary version
	SocketPath string         // override; default paths.Socket()
	Stacks     []stacks.Stack // override; default stacks.ParseEnv()
}

Options configures Run.

Source Files ¶

View all Source files

daemon.go

Directories ¶

Path	Synopsis
discovery Package discovery parses each stack's per-service podman-compose.yaml files and exposes the result as a structured model (services, targets, infra, volumes, networks, dependency graph).	Package discovery parses each stack's per-service podman-compose.yaml files and exposes the result as a structured model (services, targets, infra, volumes, networks, dependency graph).
env Package env owns the daemon's environment-variable handling: port allocation (with refcounting), value synthesis (HOST / URL for allocated ports), cross-service propagation, and operator un-prefix.	Package env owns the daemon's environment-variable handling: port allocation (with refcounting), value synthesis (HOST / URL for allocated ports), cross-service propagation, and operator un-prefix.
logs Package logs owns the daemon-side log storage and streaming hub.	Package logs owns the daemon-side log storage and streaming hub.
reinstall Package reinstall implements the daemon's reinstall-handoff checkpoint.	Package reinstall implements the daemon's reinstall-handoff checkpoint.
runner Package runner supervises the lifecycle of the daemon's run targets: it starts them, tracks their phase and health, streams their logs, and tears them down.	Package runner supervises the lifecycle of the daemon's run targets: it starts them, tracks their phase and health, streams their logs, and tears them down.
server Package server implements the daemon-side handler for the anovel.v1.CoreService connect-rpc API.	Package server implements the daemon-side handler for the anovel.v1.CoreService connect-rpc API.
volumes Package volumes owns the daemon-side volume operations: list, backup, restore, clear — all service-scoped.	Package volumes owns the daemon-side volume operations: list, backup, restore, clear — all service-scoped.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL