Expand description
The built-in manual-only update check: embedded document, boot install,
completed-check recording, and the served last-check state.
The built-in update check: “does a newer aion-cli exist?” — slice one,
know and show.
Four parts, one contract:
- [
document] — the embedded AWL document whose declaredcurlcommand the server executes through the declared-body spine, with its output on the transcript. The binary’s default build keeps ZERO outbound-HTTP dependencies; the transfer is runtimecurlin a declared command. - [
install] — boot-time installation of that document into the engine catalog, claiming only a catalog that holds no version of it. Installing makes the check STARTABLE; it never starts one. observer+index/semver(crate-internal) — the server half: when the check’s own dispatch completes, parse the fetched sparse-index lines (skipping yanked releases and prereleases — the versions a plaincargo installrefuses) and record the greatest installable version.status(crate-internal) — the recorded last check, served byGET /update-statusbeside the installed version fromcrate::build_identity.
§Manual-only is the design, not a default
There is no cadence configuration key, no timer, no check-on-startup. Every check is one explicit operator act — the ops console’s “check now” or a plain workflow start. And knowing is ALL this slice does: no install, no upgrade, and no restart machinery exists here.
§Visibility: only the document and its install are API
The parser, the SemVer implementation, the observer, and the status slot
are implementation detail behind GET /update-status, and publishing them
would make a hand-rolled SemVer part of aion-server’s public API — a
surface that could never be retired. They are pub(crate); the embedded
document and its boot install are the exported face (the CLI and the e2e
suites drive the feature through them, exactly as with the assistant).
Re-exports§
pub use document::EMBEDDED_UPDATE_CHECK_DOCUMENT;pub use document::EMBEDDED_UPDATE_CHECK_FILENAME;pub use document::EmbeddedUpdateCheck;pub use document::EmbeddedUpdateCheckError;pub use document::FETCH_ACTION;pub use document::FETCH_COMMAND;pub use document::UPDATE_CHECK_QUEUE;pub use document::UPDATE_CHECK_WORKFLOW_TYPE;pub use document::embedded_update_check;pub use install::UpdateCheckInstall;pub use install::install_embedded_update_check;pub use install::install_embedded_update_check_for_server;
Modules§
- document
- The embedded AWL document, its compiled identity, and the verified names the server half keys on. The embedded update-check document: its bytes, its compiled identity, and the verified names the server half keys on.
- install
- Boot-time installation of the embedded document into the engine catalog. Boot-time installation of the embedded update-check document into the engine catalog.