Module install 

Boot-time installation of the embedded document into the engine catalog. Boot-time installation of the embedded assistant into the engine catalog.

The rule, in one sentence

The embedded document is loaded (and therefore routed) ONLY when the engine holds no version of the assistant workflow type at all.

Why it is that narrow

aion::Engine::load_package re-points routing for a package’s workflow type on every load, idempotent hash or not — that is correct for an operator deploy (re-deploying a rolled-back version must take effect) and wrong for a restart. A server that loaded the embedded document unconditionally at boot would undo an operator’s rollback every time the process restarted, without anyone asking it to, and the session parked on the previous version would find its type pointing somewhere else. So the install claims only the empty case, which no operator decision can be sitting in.

When a version IS resident the install stands down and reports which — an AssistantInstall::AlreadyCurrent when the routed hash is the embedded one, an AssistantInstall::Deferred naming both hashes otherwise. A deferred install is not a failure: it is the live cut waiting for the operator, and the log line carries the verbs that perform it.

Enums

AssistantInstall

What the boot install did, and to what.

Functions

install_embedded_assistant

Installs the embedded assistant into engine under the rule above, logging exactly what happened.

install_embedded_assistant_for_server

Installs the embedded assistant into the engine state is serving.