Skip to content

Package Doctor

ImperaZim edited this page Jun 28, 2026 · 6 revisions

Package Doctor

/easylibrary packages doctor explains package ownership, proxy state and restart requirements.

Healthy Output Shape

Severity: OK
Packages: 16 / installed: 16 / active: 16 / pending restart: 0 / shadowed: 0 / safe-blocked: 0
Problems: 0

For each active package:

- Proxy manifest: active for next boot.
- Package-backed plugin proxy is loaded and enabled for this server session.
- PMMP getPlugin("LibCommand") resolves to the generated EasyLibrary proxy.

Common States

State Meaning
active Package-backed provider is loaded this session.
installed-shadowed-by-standalone Package is installed, but standalone wins.
safe-blocked Package files exist, but the safety gate refuses to arm the proxy.
pending restart Operation staged for next boot.
planned Dry-run command has a plan but did not write files.
disabled Package or loader rules prevent activation.

See Package Safety Gate for the checks behind safe-blocked.

When To Run It

  • after package install/update/remove/rollback;
  • after moving standalone plugins;
  • after proxy repair;
  • after config split migration;
  • before opening a support request.

Doctor Is For Operators

Doctor text is not a stable machine API. Plugins should use provider APIs, PMMP dependencies or future capability/service contracts.

For scripts and support bundles, use:

/easylibrary packages doctor json

See Doctor Output.

Clone this wiki locally