Module planner 

Update planner — computes eligible updates and classifies by risk.

This module implements:

• UpdateClassification — safe/guarded/blocked/candidate/experimental
• PlannerItem — an update candidate with classification, selection state, rationale
• UpdatePlanner — builds an update plan from scan results and manifest data

Classification Rules

Classification	Criteria
Safe	Patch-only bump, Validated tier, no new dependencies, compatible hardware
Guarded	Minor bump or new dependencies or config changes
Blocked	Incompatible hardware, missing executor, manifest-declared incompatibility
Candidate	Major bump that passes all compatibility checks
Experimental	Component marked Experimental validation tier

Selection Defaults

Classification	Visible	Preselected
Safe	Yes	Yes
Guarded	Yes	No
Candidate	Yes	No
Experimental	No*	No
Blocked	No	No

* Visible only with --include-experimental flag.

Structs

CompatibilityContext

Context about the system’s capabilities used for compatibility checks.

InstalledComponent

An installed component in scan output.

PlanOutput

Machine-readable plan output for non-TTY / JSON mode.

PlanSummary

Summary statistics for the plan.

PlannerItem

An update candidate produced by the planner.

PlannerItemOutput

A single item in the plan output.

PlannerOptions

Options controlling planner behavior.

ScanOutput

Machine-readable scan output for non-TTY / JSON mode.

UpdatePlanner

Builds an update plan from manifest data and system context.

Enums

PlannerError

Errors that can occur during planning.

UpdateClassification

Classification of an update’s risk and suitability.