upgrade

Overview

upgrade turns module maintenance into a predictable workflow: inspect the plan first, update one module or the whole installation, repair compatible dependencies, and—when run is installed—optionally schedule one check-only or update action for the start of each authorized session.

Check the plan before replacing code

upgrade -c resolves versions, packages and dependencies without writing module source. A real update preserves the installed package and repository, replaces modules atomically and uses install only when a required dependency is completely missing.

Syntax

upgrade [module ...] [-c] · upgrade -auto <check|update|off> · upgrade -info

Reference

upgrade manual

In Minimum, only a plain upgrade of all modules or one named module is available. Check mode, multiple-name selection and automatic scheduling require Base.

When a working site already has modules, updating them deserves a check first. Run upgrade -c to see which installed versions differ from the repository without replacing code. upgrade hash -c narrows the check to one module.

upgrade hash updates or repairs an installed module, preserving its Base/Minimum edition and repository. upgrade without arguments works across installed modules. Missing modules are installed with install, not by treating an unknown name as an update.

upgrade -auto check adds a session-start check through run and autoload.lil; upgrade -auto update allows unattended PHP-code changes. Automatic updates are off by default. Check the current mode with upgrade -info, and disable it with upgrade -auto off. Core commands such as cd require replacing lil.php, not running upgrade cd.

Planning

Each installed marker records its repository, version, Base or Minimum package and lil.core generation. upgrade resolves the newest compatible public release from the same repository, preserves the installed package, validates compatibility metadata and never downgrades a version that is ahead of the repository.

Replacement and repair

Existing modules are downloaded, normalized, parsed, checked for method conflicts and replaced atomically. Existing dependencies are checked for repository, package, version and core generation. upgrade updates or expands an installed dependency itself; only a dependency that is completely absent is handed to install.

Check mode

-c performs the same version, package and dependency analysis without downloading module source or writing the extension file. It is the recommended first action before a manual or automatic update on an important installation.

Automatic mode

The optional automatic mode uses the existing run startup contract and its autoload.lil file. upgrade edits only its own marked # <upgrade:auto> block and preserves every unrelated line. check stores upgrade -c, update stores upgrade, and off removes only that managed block. check and update are mutually exclusive.

Because autoload.lil runs once per authorized session, the selected action runs after authorization rather than before every terminal command. The run module is required for automatic mode. upgrade -info reports the current mode without writing.

Safety

Automatic update is disabled by default. Update mode downloads and replaces executable PHP module code, so use only a trusted repository. Choose check when changes must remain explicit. Disable the managed action at any time with upgrade -auto off.

Summary layout

Whole-installation checks and updates begin with a compact total, show changed modules as version-first rows such as v1.30 > v1.33 help ⌘, and finish with counts such as Current: 10. This makes several updates easy to compare at a glance.

Built-in cd and core follow the Core release, not a separately installed module; upgrade reports their status, but replacing lil.php is required to update them.

Base packages are marked ⌘; Minimum packages remain labeled (minimum).

Single-module results

Single-module check and update results show only the version and package marker, for example v1.1.5 ⌘ or v1.1.4 > v1.1.5 ⌘, without repeating the command name or Current/Available labels. A failed source request is retried once for the same version.

Selected module names now work in a single upgrade command, including checks with -c. Only selected modules and their required dependencies are touched.

Install and manage

Install the current compatible version. Choose Base for the complete feature set or Minimum for the reduced package; use upgrade to update a module that is already installed.

Base and Minimum are two packages of the same current module release, not separate command versions.

Examples

Examples are copyable command lines, not actions executed by this website. Review paths, permissions and destructive flags before running them on a real project.

Prepared training result — the Play button does not modify your installation.
Status  All 3 modules are current
This example depends on the installed packages and repository state.

Prepared training result — the Play button does not modify your installation.
All installed extension modules are current
This example depends on the installed packages and repository state.

Prepared training result — the Play button does not modify your installation.
v1.1.4
This example depends on the installed packages and repository state.

Prepared training result — the Play button does not modify your installation.
v1.1.4
This example depends on the installed packages and repository state.

Prepared training result — the Play button does not modify your installation.
v1.1.5
This example depends on the installed packages and repository state.

Prepared training result — the Play button does not modify your installation.
Selected (check)  3
attr     v1.3.2
stat     v1.1.6
include  v1.2.6
This example depends on the installed packages and repository state.

Prepared training result — the Play button does not modify your installation.
All 3 selected modules are current
This example depends on the installed packages and repository state.

Prepared training result — the Play button does not modify your installation.
Built-in  cd · Core v1.5.x
Update    replace lil.php to update
This example depends on the installed packages and repository state.

Prepared training result — the Play button does not modify your installation.
Built-in  core · Core v1.5.x
Update    replace lil.php to update
This example depends on the installed packages and repository state.

Prepared training result — the Play button does not modify your installation.
Automatic upgrade  Check only
Session command     upgrade -c
Script              autoload.lil
This example depends on the installed packages and repository state.

Prepared training result — the Play button does not modify your installation.
Automatic upgrade  Check only
Run module         Installed
Script             autoload.lil
This example depends on the installed packages and repository state.

Prepared training result — the Play button does not modify your installation.
Automatic upgrade  Update automatically
Session command     upgrade
Script              autoload.lil
This example depends on the installed packages and repository state.

Prepared training result — the Play button does not modify your installation.
Automatic upgrade  Off
Script             autoload.lil
This example depends on the installed packages and repository state.

Prepared training result — the Play button does not modify your installation.
missing_module: not installed

Prepared training result — the Play button does not modify your installation.
?

Prepared training result — the Play button does not modify your installation.
?

Prepared training result — the Play button does not modify your installation.
?

Prepared training result — the Play button does not modify your installation.
v1.4.8
This example depends on the installed packages and repository state.

Prepared training result — the Play button does not modify your installation.
v1.3.6
This example depends on the installed packages and repository state.

Prepared training result — the Play button does not modify your installation.
Selected (check)  2
hash  v1.1.4
pwd   v1.1.5
This example depends on the installed packages and repository state.

Related commands

A purple command link means that this feature uses another module. Open the linked command to see what it provides and how to install it.

Related documentation