How do updates work?
Installer creates or removes modules; Upgrade owns checks, replacement and repair.
Check first
upgrade -c analyzes every installed module without writing. upgrade help -c limits the check to one module.
Apply
upgrade replaces existing blocks, preserves Base or Minimum and keeps the original repository. A locally newer version is reported as Ahead and is not downgraded.
Dependencies
Missing hard dependencies may be installed through Installer. Existing dependency blocks are repaired or updated by Upgrade itself.
Automatic session check
With run installed, upgrade -auto check adds a managed upgrade -c action to autoload.lil. It runs once after authorization, reports available updates and does not change modules. upgrade -auto update switches the managed action to a real update; upgrade -auto off removes it.
Automatic update is disabled by default. The managed block does not replace or delete unrelated startup commands, and upgrade -info reports the current mode without writing.
Examples
upgrade -cupgradeupgrade helpupgrade -auto checkupgrade -infoupgrade -auto off