git.stella-ops.org/docs/features/checked/cli/cli-plugin-module-loading-architecture.md

CLI Plugin Module Loading Architecture

Module

Cli

Status

VERIFIED

Description

Plugin-based module loading for CLI commands, enabling extensible command registration and routing.

Implementation Details

• Plugin System: src/Cli/StellaOps.Cli/Plugins/ -- plugin loading infrastructure
• Plugin Directory: src/Cli/plugins/ -- plugin module implementations
• Plugin Guard: src/Cli/__Tests/StellaOps.Cli.Tests/Plugins/RestartOnlyCliPluginGuardTests.cs -- plugin security guard
• Module Loader: src/Cli/__Tests/StellaOps.Cli.Tests/Plugins/CliCommandModuleLoaderTests.cs -- module loader tests
• Architecture:
  • ICliCommandModule interface defines plugin contract
  • Dynamic module loader discovers and loads plugin assemblies
  • Plugins register commands into the CLI command tree
  • Restart-only guard prevents hot-loading for security
• Built-in plugins: VEX, verdict, timestamp, symbols, AOC, delta signatures

E2E Test Plan

• Verify built-in plugin modules are loaded at startup
• Verify plugin commands appear in stella --help output
• Verify plugin command execution works correctly
• Verify restart-only guard prevents unauthorized plugin loading
• Verify missing plugin gracefully reports error without crashing
• Verify plugin loading order is deterministic

Verification

• Verified: 2026-02-13T15:30:00Z
• Tier 0 (Source): pass -- all referenced source files exist on disk
• Tier 1 (Build): pass -- module builds cleanly, 339 tests pass in StellaOps.Cli.Plugins.Tests
• Tier 2d (Integration): pass -- targeted integration tests confirm behavioral correctness
• Test Project: src/Cli/__Tests/StellaOps.Cli.Plugins.Tests/StellaOps.Cli.Plugins.Tests.csproj
• Evidence: docs/qa/feature-checks/runs/cli/cli-plugin-module-loading-architecture/run-001/tier2-integration-check.json