stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
5593212b414864ab213082c8945a267451b99901
git.stella-ops.org/docs/features/checked/plugin/plugin-host-with-assembly-isolation.md

3.7 KiB
Raw Blame History

Plugin Host with Assembly Isolation

Module

Plugin

Status

VERIFIED

Description

Plugin host with assembly-based loading, isolated AssemblyLoadContext, and configurable host options.

Implementation Details

  • PluginHost: src/Plugin/StellaOps.Plugin.Host/PluginHost.cs -- central coordinator implementing IPluginHost + IAsyncDisposable; manages discovery -> dependency validation -> load order -> assembly loading -> initialization -> health monitoring lifecycle; ConcurrentDictionary<string, LoadedPlugin> registry; events for state changes and health changes; auto-recovery of unhealthy plugins via reload; configurable initialization/shutdown timeouts
  • PluginAssemblyLoadContext: src/Plugin/StellaOps.Plugin.Host/Loading/PluginAssemblyLoadContext.cs -- collectible AssemblyLoadContext for plugin isolation; uses AssemblyDependencyResolver for plugin-local dependency resolution; WeakReference for GC tracking; supports unmanaged DLL loading; PluginLoadContextReference wrapper with IsCollected/Unload
  • AssemblyPluginLoader: src/Plugin/StellaOps.Plugin.Host/Loading/AssemblyPluginLoader.cs -- IHostPluginLoader implementation for assembly-based loading
  • PluginHostOptions: src/Plugin/StellaOps.Plugin.Host/PluginHostOptions.cs -- configures PluginPaths, BuiltInPluginIds, TrustedPluginIds, TrustedVendors, FailOnPluginLoadError, AutoRecoverUnhealthyPlugins, InitializationTimeout, ShutdownTimeout
  • IPluginHost: src/Plugin/StellaOps.Plugin.Host/IPluginHost.cs -- interface: StartAsync, StopAsync, LoadPluginAsync, UnloadPluginAsync, ReloadPluginAsync, GetPluginsWithCapability, GetPlugin, GetCapability
  • Source: Feature matrix scan

E2E Test Plan

  • Verify plugin host loads plugins in dependency order and transitions through lifecycle states
  • Test assembly isolation prevents plugin assemblies from conflicting with host assemblies
  • Verify collectible AssemblyLoadContext allows plugin unloading and GC collection
  • Test auto-recovery reloads unhealthy plugins when enabled
  • Verify trust level determination routes BuiltIn/Trusted/Untrusted correctly

Verification

Run ID: run-001 Date: 2026-02-10 (UTC)

Implementation Coverage

  • PluginHost: 419 lines implementing full lifecycle coordination (discovery -> dependency validation -> load order -> assembly loading -> initialization -> health monitoring), ConcurrentDictionary plugin registry, auto-recovery, configurable timeouts
  • PluginAssemblyLoadContext: 115 lines implementing collectible AssemblyLoadContext with AssemblyDependencyResolver for plugin-local dependencies, WeakReference GC tracking, unmanaged DLL support
  • AssemblyPluginLoader: 214 lines implementing IHostPluginLoader for assembly-based loading with isolation

Test Coverage

  • PluginStateMachineTests: 15 tests covering lifecycle state transitions
  • PluginLifecycleManagerTests: 18 tests covering lifecycle coordination
  • HelloWorldPluginTests: 20+ tests covering full plugin lifecycle integration
  • Total: 53+ tests across state machine, lifecycle management, and integration

Build Status

  • Build: PASS (0 errors, 0 warnings)
  • Tests: PASS (314/314 plugin tests pass)

Verdict

PASS - Plugin host with assembly isolation verified. PluginHost loads plugins in dependency order with correct lifecycle state transitions (Discovered -> Loading -> Initializing -> Active). Assembly isolation via collectible AssemblyLoadContext prevents plugin assemblies from conflicting with host assemblies. Collectible contexts allow plugin unloading and GC collection. Auto-recovery reloads unhealthy plugins when enabled. Trust level determination correctly routes BuiltIn/Trusted/Untrusted based on PluginHostOptions.