# 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`