FilePluginRegistry

JSON-file-backed registry: the config-driven activation source. A missing file is an empty registry; corrupt JSON is a loud error (never a silent empty). Every mutation persists immediately.

public function __construct(string $filePath):

Parameters

public function enabledNames(): array

Names of all enabled plugins; never throws — a broken store reads as [].

public function find(string $name): ?Milpa\Plugin\Contracts\PluginRecord

Find one plugin's record by name, or null when not registered.

Parameters

public function installed(): array

All installed plugins.

public function installedAndEnabled(): array

All plugins that are both installed and enabled.

public function register(Milpa\Plugin\Contracts\PluginRecord $record): void

Register a new plugin; throws if the name is already registered.

Parameters

public function save(Milpa\Plugin\Contracts\PluginRecord $record): void

Overwrite an existing plugin's record; throws if the plugin is not registered.

Parameters

public function setEnabled(string $name, bool $enabled): void

Flip a plugin's enabled flag; throws if the plugin is not registered.

Parameters

public function unregister(string $name): void

Remove a plugin from the registry; unknown name is a no-op.

Parameters

public function invalidateActivationCache(): void

Invalidate materialized activation caches; the file IS the source of truth.