Documentation
¶
Overview ¶
Package lifecycle owns the config-apply lifecycle matrix shared by runtime, API, CLI, web, docs, and codegen checks.
Index ¶
Constants ¶
This section is empty.
Variables ¶
var Matrix = []Rule{ {Pattern: "subagents.result_max_chars", Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: "attention.*", Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: "shell.*.*", Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: "skills.disabled_skills", Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: "skills.sources", Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: "skills.custom_sources", Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: pathDaemonReloadTimeoutProviders, Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: pathDaemonReloadTimeoutMCP, Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: "providers.*.models", Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: "providers.*.models.*", Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: "marketplace.catalog.*", Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: "marketplace.plugin_sources", Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: "marketplace.plugin_sources.*", Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: "extensions.trust.allow_unverified", Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: pathRoles, Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: pathRoles + ".*", Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: "providers.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "mcp.oauth.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "mcp-servers.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "hooks.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "extensions.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "defaults.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "limits.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "session.busy_input.default_mode", Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: "session.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "permissions.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "tools.clarify.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "tools.artifacts.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "http.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "daemon.memory_report_interval", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, { Pattern: "daemon.subprocess_health_escalation_threshold", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired, }, {Pattern: "daemon.socket", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "daemon.load.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "automation.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "loops.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "goals.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "worktrees.*", Lifecycle: Live, DiffClass: DiffClassLive}, { Pattern: "task.orchestration.profile.default_worktree_mode", Lifecycle: Live, DiffClass: DiffClassLive, }, {Pattern: "task.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: pathGatewayPrivatePort, Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: pathGatewayPublicPort, Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: pathGatewayWildcard, Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: pathWindowManagerNavStackLimit, Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: pathWindowManagerClosedEntryLimit, Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: "window_manager.*", Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: "cmd_palette.*", Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: "observability.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "log.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "redact.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, {Pattern: "terminal.*", Lifecycle: Live, DiffClass: DiffClassLive}, {Pattern: "skills.*", Lifecycle: RestartRequired, DiffClass: DiffClassRestartRequired}, }
Matrix is the canonical config lifecycle matrix. Patterns use "." path segments and "*" wildcards for one segment.
Functions ¶
Types ¶
type DiffClass ¶
type DiffClass string
DiffClass summarizes the broad subsystem touched by one apply attempt.
const ( DiffClassLive DiffClass = DiffClass(Live) DiffClassLiveAdd DiffClass = DiffClass(LiveAdd) DiffClassLiveRemoveIfUnused DiffClass = DiffClass(LiveRemoveIfUnused) DiffClassRestartRequired DiffClass = DiffClass(RestartRequired) DiffClassSessionRebind DiffClass = DiffClass(SessionRebind) )
func DiffClassForRoot ¶
DiffClassForRoot maps a settings section or collection name onto a diff class.
type Lifecycle ¶
type Lifecycle string
Lifecycle names how a desired config change becomes daemon runtime truth.
const ( // Live applies in-place and advances the active config generation. Live Lifecycle = "live" // LiveAdd applies a new catalog entry in-place and advances the active generation. LiveAdd Lifecycle = "live-add" // LiveRemoveIfUnused applies a removal only when the removed resource has no active users. LiveRemoveIfUnused Lifecycle = "live-remove-if-unused" // RestartRequired writes desired state but cannot update daemon runtime truth. RestartRequired Lifecycle = "restart-required" // SessionRebind applies to new sessions while existing sessions keep their bound runtime values. SessionRebind Lifecycle = "session-rebind" )
type NextAction ¶
type NextAction string
NextAction is the user/agent-facing recovery or continuation hint.
const ( NextActionNone NextAction = "none" NextActionRestartDaemon NextAction = "restart-daemon" NextActionNewSession NextAction = "new-session" NextActionRetry NextAction = "retry" )
func NextActionForLifecycle ¶
func NextActionForLifecycle(lifecycle Lifecycle, status Status) NextAction
NextActionForLifecycle returns the canonical user-visible next action.
type Rule ¶
Rule records the lifecycle for a config path pattern.
func ClassifyPath ¶
ClassifyPath returns the matrix rule for one changed config path.
func SortedMatrix ¶
func SortedMatrix() []Rule
SortedMatrix returns a stable copy for docs and tests.