platform

package

v0.3.0 Latest Latest Go to latest Published: Nov 11, 2026 License: AGPL-3.0 Imports: 10 Imported by: 0

Details

Package platform (piece ⑮) holds process-level concerns: data directory, logging and supervision of long-running services.

This section is empty.

This section is empty.

func DefaultDataDir() string

DefaultDataDir returns the per-OS default data directory.

func NewLogger(w io.Writer, level, format string) *slog.Logger

NewLogger returns a logger: coloured text on a terminal, JSON when format is "json". Secrets are redacted in one place.

func Run(ctx context.Context, log *slog.Logger, services ...Service) error

Run supervises services until ctx is cancelled. A failing service is restarted with backoff without stopping the others (ADR 0009).

type Func struct {
	Name string
	Fn   func(ctx context.Context) error
}

Func adapts a function to a Service.

func (f Func) Serve(ctx context.Context) error

func (f Func) String() string

type Service interface {
	Serve(ctx context.Context) error
	String() string
}

Service is a long-running piece supervised with restarts.