upgrade

upgrade checks installed module versions, plans updates, replaces installed module blocks and repairs installed dependencies. A module that is completely absent remains an install operation.

SystemVersion 1.3.1Stable
lil-terminal

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

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

Reference

upgrade

update every installed extension module

upgrade <module>

update (or repair) the specified installed module

upgrade -c

check versions, packages and dependencies (without writing)

upgrade <module> -c

check one module version (without writing)

upgrade -auto check @run

check for updates once per authorized session through autoload.lil

upgrade -auto update @run

attempt updates once per authorized session through autoload.lil

upgrade -auto off

disable automatic upgrade actions managed by upgrade

upgrade -info

show automatic-upgrade mode and autoload.lil status

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 (base), and finish with counts such as Current: 10. This makes several updates easy to compare at a glance.

Interactive sandbox preview

Run the prepared examples directly on the page. Their results are prebuilt and shown in the browser; no terminal command is executed on the server.

Update every installed extension module

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.

Base package

Install the complete package with local command reference and every published mode.

install upgrade
Minimum package

Install the reduced package. Local reference is omitted; help <cmd> -i opens the current server reference.

install upgrade -m
Exact public version

Install exactly this published version.

install upgrade -v 1.3.1
Remove module

Remove the extension block while leaving the core and unrelated modules intact.

install upgrade -u

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.

Update every installed extension module
upgrade -c | upgrade
Available: 4 of 14
                v1.40	>	v1.42	help (base)
                v1.17	>	v1.18	include (base)
                v1.10	>	v1.11	ping (base)
                v1.8	>	v1.9	run (base)
Current: 9
Ahead: 1

Updated 4 of 14
                v1.40	>	v1.42	help (base)
                v1.17	>	v1.18	include (base)
                v1.10	>	v1.11	ping (base)
                v1.8	>	v1.9	run (base)
Current: 9
Ahead: 1
Check versions, packages and dependencies (without writing)
upgrade -c
Available: 4 of 14
                v1.40	>	v1.42	help (base)
                v1.17	>	v1.18	include (base)
                v1.10	>	v1.11	ping (base)
                v1.8	>	v1.9	run (base)
Current: 9
Ahead: 1
Check one module version (without writing)
upgrade help -c
Available: 1 of 1
                v1.30	>	v1.33	help (base)
Update (or repair) the specified installed module
upgrade help
Updated 1 of 1
                v1.30	>	v1.33	help (base)
Update every installed extension module
upgrade
Updated 4 of 14
                v1.40	>	v1.42	help (base)
                v1.17	>	v1.18	include (base)
                v1.10	>	v1.11	ping (base)
                v1.8	>	v1.9	run (base)
Current: 9
Ahead: 1
Check for updates once per authorized session through autoload.lil
upgrade -auto check
Automatic upgrade  Check only
Session command    upgrade -c
Script             autoload.lil

This writes a single managed upgrade -c line into autoload.lil. At the next authorized session run executes the check once, reports what is available and makes no module changes.

Show automatic-upgrade mode and autoload.lil status
upgrade -info
Automatic upgrade  Check only
Run module         Installed
Script             autoload.lil

upgrade -info reads the managed startup block and reports whether automatic upgrade is off, check-only or update mode. It does not change autoload.lil.

Attempt updates once per authorized session through autoload.lil
upgrade -auto update
Automatic upgrade  Update automatically
Session command    upgrade
Script             autoload.lil

This replaces the managed check action with upgrade. It can download and replace executable module code once per authorized session, so enable it only for a repository you trust.

Disable automatic upgrade actions managed by upgrade
upgrade -auto off
Automatic upgrade  Off
Script             autoload.lil
Update (or repair) the specified installed module
upgrade missing_module
missing_module: not installed

Related documentation

How do updates work? →What is the difference between Base and Minimum? →How do I install a module? →Why does a command say “command not found”? →

Current public release

v1.3.12026-08-11

File-routing metadata preservation and repair

Current stable release of upgrade. upgrade checks installed module versions, plans updates, replaces installed module blocks and repairs installed dependencies.

# Version history