docs: align 3.0 migration notes with package runtime

Author: ImperaZim

CHANGELOG.md

@@ -303,15 +303,21 @@ elprobe run <package>
 
 ### Runtime compatibility hardening
 
-- `LibraryModules` now acts as a compatibility boundary for removed embedded
-  runtimes and points operators toward package-backed or standalone providers.
+- Removed `LibraryModules` and the remaining legacy embedded runtime control
+  layer from the EasyLibrary 3.x core.
+- `/easylibrary runtime` is now a read-only runtime overview/status surface.
+  It no longer exposes embedded `enable`, `disable`, `reload` or `targets`
+  operations.
+- Provider state now reports `not-installed` when an official library has no
+  package-backed or standalone owner. Old embedded provider states are treated
+  as historical migration notes, not current runtime modes.
 - Placeholder and World command registries live in their respective package or
   standalone repositories, not in the EasyLibrary core.
 - `PluginToolkit::getDatabase()` now fails with a controlled plugin exception
   when LibDB/`DBManager` is unavailable.
-- `LibraryStatusService` checks manager availability before reading embedded
-  runtime state, preventing doctor output from fataling when future builds
-  remove legacy embedded classes.
+- `LibraryStatusService` was simplified around current 3.x ownership:
+  package-backed provider, standalone provider, disabled standalone artifact or
+  no installed provider.
 - Moved `/plugins` and `/version` override command classes from
   `imperazim\components\commands` to `imperazim\library\command\override`.
 

changelogs/3.0.md

@@ -599,8 +599,7 @@ This absorbs the old internal `2.1.0-dev` milestone into `3.0.0-dev`.
 
 - `OfficialLibraryRegistry` for known EasyLibrary official libraries.
 - Expected standalone version metadata.
-- Historical embedded-kind metadata kept only so older migration states can be
-  described safely.
+- Current package type metadata for official package-backed providers.
 - `LibraryStatusService`.
 - Provider detection through PMMP's plugin manager.
 - Detection of standalone PHAR/folder files that exist but are not enabled.
@@ -615,7 +614,8 @@ This absorbs the old internal `2.1.0-dev` milestone into `3.0.0-dev`.
 - `/easylibrary libs status [library]`.
 - `/easylibrary libs available`.
 - `/easylibrary libs doctor`.
-- compatibility boundary for the retired `/easylibrary runtime` surface.
+- read-only compatibility output for the retired `/easylibrary runtime`
+  surface.
 - `/easylibrary doctor`.
 - `/easylibrary help`.
 
@@ -637,14 +637,17 @@ switches.
 |---|---|
 | `standalone-active` | A standalone PMMP plugin is enabled and owns the provider. |
 | `standalone-installed-disabled` | A standalone PHAR/folder exists but is not enabled. |
-| `embedded-runtime` | Historical state from earlier migration builds where EasyLibrary owned an embedded manager. |
-| `embedded-classpath` | Historical state from earlier migration builds where embedded API classes existed in the core. |
 | `package-backed-active` | The provider is an EasyLibrary package exposed through a PMMP proxy. |
-| `embedded-disabled` | Historical/retired state. Current 3.x core tells operators to install a package or standalone provider. |
+| `not-installed` | No package-backed or standalone provider is active for that official library. |
 | `duplicate-runtime` | Two providers appear active at the same time. |
 | `missing` | No valid provider was found for a runtime-required library. |
 | `unknown` | A manager exists but EasyLibrary cannot classify its owner confidently. |
 
+Older 3.0-dev prototypes also used embedded-oriented labels while the migration
+was still proving the provider model. Those labels are no longer current
+runtime modes after the legacy embedded source and `LibraryModules` layer were
+removed from the core.
+
 ### How to use it
 
 ```text
@@ -659,7 +662,7 @@ Example output shape:
 LibPlaceholder v1.0.0 [standalone-active] provider: LibPlaceholder
 LibWorld v1.0.0 [package-backed-active] provider: LibWorld
 LibSerializer v2.0.0 [package-backed-active] provider: LibSerializer
-EasyLibraryAgentBridge v1.0.0 [missing] provider: none
+EasyLibraryAgentBridge v1.0.0 [not-installed] provider: none
 ```
 
 ### Developer impact
@@ -672,11 +675,11 @@ for programmatic integration.
 
 This absorbs the old internal `2.2.0-dev` milestone into `3.0.0-dev`.
 
-### What was added during the migration
+### What was prototyped and then retired
 
 - `LibraryRuntimeControlService`.
 - `LibraryRuntimeOperationResult`.
-- Temporary runtime targets:
+- Temporary embedded runtime targets:
   - `command`;
   - `placeholder`;
   - `trigger`;
@@ -709,7 +712,10 @@ Current behavior:
 
 - EasyLibrary does not start, stop or reload embedded official library
   runtimes.
-- `/easylibrary runtime` is not the operator path for packages.
+- `/easylibrary runtime` is a read-only overview/status surface, not the
+  operator path for packages.
+- The old embedded runtime control subcommands (`enable`, `disable`, `reload`
+  and `targets`) were retired.
 - Install, update, remove, rollback, repair and proxy operations live under
   `/easylibrary packages`.
 - Standalone plugins remain managed by PMMP.
@@ -1318,7 +1324,7 @@ It keeps server/system information and adds EasyLibrary context:
 
 ```text
 Packages: 13/13 installed, 13 active, 0 pending, 0 shadowed
-Official libs: 13 package-backed, 0 standalone, 0 embedded
+Official libs: 13 package-backed, 0 standalone, 0 not installed
 Command backend: libcommand-rich
 Config: package-manager=split / library-installer=split
 ```
@@ -1446,7 +1452,8 @@ Reload rereads config files for future EasyLibrary operations. It does not:
 
 ### What changed
 
-- Legacy embedded runtime entry points now fail closed and point operators to
+- Legacy embedded runtime control entry points were removed from the active
+  command surface. Read-only runtime commands now point operators to
   package-backed or standalone providers.
 - Placeholder, Trigger and World managers are optional package/standalone
   providers instead of bundled EasyLibrary core runtimes.

docs/migration.md

@@ -7,6 +7,14 @@ This file records practical migration steps for EasyLibrary versions.
 EasyLibrary 2.x is the old full-bundle model. EasyLibrary 3.x is moving toward
 a core/package-manager model.
 
+The important behavior change is provider ownership:
+
+| 2.x full bundle | 3.x development line |
+|---|---|
+| EasyLibrary carried official `Lib*` source in the core. | EasyLibrary core manages official libs as packages or lets standalone plugins own them. |
+| Missing standalone libs could fall back to bundled runtime code. | Missing providers are reported as `not-installed`; install a package or standalone plugin. |
+| Runtime ownership could be implicit. | Runtime ownership is explicit in `/easylibrary doctor` and `/easylibrary packages doctor`. |
+
 Before migrating a server:
 
 ```txt
@@ -31,6 +39,47 @@ Recommended order:
 6. Restart after each provider switch.
 7. Validate with `/easylibrary packages doctor` and `elprobe run <package>`.
 
+Recommended package-backed install flow:
+
+```txt
+/easylibrary packages available
+/easylibrary packages install libcommand stable confirm
+restart server
+/easylibrary packages doctor
+/easylibrary doctor
+elprobe run libcommand
+```
+
+Recommended standalone-to-package switch flow:
+
+```txt
+/easylibrary packages install libplaceholder stable confirm
+restart server
+/easylibrary packages switch libplaceholder
+stop server
+remove the standalone LibPlaceholder artifact from /plugins
+start server
+/easylibrary packages doctor
+elprobe run libplaceholder
+```
+
+For plugin code, prefer normal PMMP dependency declarations instead of assuming
+EasyLibrary always ships a class:
+
+```yaml
+softdepend:
+  - LibPlaceholder
+  - LibCommand
+```
+
+```php
+$provider = $this->getServer()->getPluginManager()->getPlugin("LibPlaceholder");
+if($provider === null || !$provider->isEnabled()){
+    // Disable the optional integration or use a fallback path.
+    return;
+}
+```
+
 ## Safe rollback
 
 Because config migration does not delete `config.yml`, rollback is simple: