service

type Config struct {
	// ControlSocket is the local control-plane endpoint (spec §2A "local
	// control plane" row): the Unix-domain socket path (named-pipe name on
	// Windows, once the pipe transport lands) that answers `da service
	// status`/`stop`. Empty defaults to
	// <RepoDir>/.agents/active/service.sock.
	ControlSocket string
	// HTTPAddr is the HTTP/SSE edge bind address. Empty defaults to
	// DefaultHTTPAddr (loopback-only, OQ3); an explicit non-loopback
	// address is the deliberate external opt-in.
	HTTPAddr string
	// IterLogDir is the iteration-log directory the ingester task watches.
	// Empty defaults to <RepoDir>/.agents/active/iteration-log.
	IterLogDir string
	// RepoDir is the repository root the tasks resolve scoring and
	// watermark state against. Empty defaults to the current working
	// directory.
	RepoDir string
	// RescoreInterval is the rescore task's rubric-version check cadence.
	// Zero applies the tasks package default.
	RescoreInterval time.Duration
	// ShutdownTimeout is the single wall-clock budget covering the whole
	// teardown (both listeners + scheduler drain, concurrently) once shutdown
	// begins. Zero applies shutdownTimeout (5s, the spec exit-within-5s bound).
	// A straggler still draining when the budget expires is abandoned.
	ShutdownTimeout time.Duration
	// EnabledTasks selects which background tasks Run registers, by
	// scheduler task name (tasks.IterLogIngesterName, tasks.RescoreName).
	// Empty enables every builtin task; an unknown name is rejected.
	EnabledTasks []string
	// Bus is the event transport backend behind the spec D4.1 EventBus
	// interface seam. Nil constructs the in-process builtin (D4.3) — the
	// only backend that ships in v1 per the OQ6 interface-only ruling.
	// Injecting a bus is how a future config-selected adapter (D4.4) — or
	// a test subscriber — plugs in; either way Run owns the bus lifecycle
	// and closes it on shutdown.
	Bus events.EventBus
}