Skip to content

Module Smoke Matrix

ImperaZim edited this page Jul 7, 2026 · 2 revisions

Module Smoke Matrix

The versioned source document is docs/module-smoke-matrix.md.

This page summarizes the module validation work for EasyLibrary 3.0-dev after LibModule became the owner of module runtime behavior.

What It Covers

  • no-LibModule boot with disabled provider;
  • package-backed LibModule boot with real fixtures;
  • standalone LibModule boot;
  • one basic module;
  • service provider plus consumer;
  • missing dependency diagnostics;
  • reload, refresh, disable and enable behavior;
  • owner plugin cleanup/resource reporting.

Automated Evidence

The lightweight suite covers provider boundaries and report/read-model behavior without requiring a full PocketMine-MP boot:

composer run test

Relevant passing tests:

module runtime provider exposes disabled boundary without LibModule
plugin and version inventories hide modules without a visible LibModule provider
libmodule experimental provider becomes the active runtime owner

Manual Fixtures

Manual PMMP validation uses the example plugins in the LibModule repository:

LibModule/examples/

Fixtures:

  • 01-basic-plugin;
  • 02-economy-provider-plugin;
  • 03-farm-consumer-plugin;
  • 04-diagnostics-plugin.

Result

OP-68 closed the module-core removal path. The current result is:

  • EasyLibrary without LibModule exposes no bundled module runtime;
  • package-backed LibModule can own commands, manifests, services, capabilities, lifecycle and examples;
  • standalone LibModule can own the same runtime independently;
  • EasyLibrary keeps only the host bridge for provider selection and diagnostics.

Clone this wiki locally