autoconfigure

Documentation

Overview

Package autoconfigure contributes the runtime-plugin host only when an application explicitly blank-imports this package. The contributed host augments the immutable compiled Spice tool graph; it never discovers or mutates compiled beans at runtime.

Index

• func DefaultCompiledDispatcher(tools map[string]tool.Tool) (stage.ToolDispatcher, error)
• func DefaultCurrentUserEndpointFactory() pluginhost.LocalEndpointFactory
• func DefaultDisabledRestartPolicy() pluginhost.RestartPolicy
• func DefaultHost(hostIdentity *pluginv1.BuildIdentity, compiled stage.ToolDispatcher, ...) (*pluginhost.Host, lifecycle.Cleanup, error)
• func DefaultToolPlanSource(host *pluginhost.Host) (stage.ToolPlanSource, error)
• func SpiceAutoConfiguration() starter.AutoConfiguration

Functions

func DefaultCompiledDispatcher

func DefaultCompiledDispatcher(tools map[string]tool.Tool) (stage.ToolDispatcher, error)

DefaultCompiledDispatcher snapshots the application-owned, statically composed named tool beans. Runtime plugins may augment this dispatcher in a new immutable generation, but cannot change the compiled Spice graph.

func DefaultCurrentUserEndpointFactory

func DefaultCurrentUserEndpointFactory() pluginhost.LocalEndpointFactory

DefaultCurrentUserEndpointFactory constructs the local-only endpoint allocator used for authenticated runtime-plugin processes.

func DefaultDisabledRestartPolicy

func DefaultDisabledRestartPolicy() pluginhost.RestartPolicy

DefaultDisabledRestartPolicy preserves fail-closed, application-owned recovery selection. Blank-importing this package wires a valid zero policy; an application or distribution must explicitly replace it to enable automatic runtime-plugin recovery.

func DefaultHost

func DefaultHost(
	hostIdentity *pluginv1.BuildIdentity,
	compiled stage.ToolDispatcher,
	guards []stage.ToolDispatchGuard,
	decorators []stage.ToolDispatchDecorator,
	restart pluginhost.RestartPolicy,
	launcher process.VerifiedLauncher,
	endpoints pluginhost.LocalEndpointFactory,
) (*pluginhost.Host, lifecycle.Cleanup, error)

DefaultHost constructs the runtime-plugin generation owner from exact, constructor-injected dependencies. Closing the returned lifecycle cleanup waits for active leases and releases every owned plugin process.

func DefaultToolPlanSource

func DefaultToolPlanSource(host *pluginhost.Host) (stage.ToolPlanSource, error)

DefaultToolPlanSource exposes the exact interface consumed by the engine while preserving the Host pointer and its generation ownership.

func SpiceAutoConfiguration

func SpiceAutoConfiguration() starter.AutoConfiguration

SpiceAutoConfiguration is statically decoded by Spice and never executed during analysis.