43 lines
2.1 KiB
Markdown
43 lines
2.1 KiB
Markdown
# CLI with Plugin-Based Command Modules
|
|
|
|
## Module
|
|
Cli
|
|
|
|
## Status
|
|
VERIFIED
|
|
|
|
## Description
|
|
Modular CLI with ICliCommandModule interface, dynamic module loader, and multiple plugin command modules covering VEX, verdict, timestamp, symbols, AOC, and delta signatures.
|
|
|
|
## Implementation Details
|
|
- **Plugin System**: `src/Cli/StellaOps.Cli/Plugins/` -- plugin infrastructure with ICliCommandModule interface
|
|
- **Plugin Directory**: `src/Cli/plugins/` -- plugin implementations
|
|
- **Module Loader Tests**: `src/Cli/__Tests/StellaOps.Cli.Tests/Plugins/CliCommandModuleLoaderTests.cs`
|
|
- **Plugin Guard Tests**: `src/Cli/__Tests/StellaOps.Cli.Tests/Plugins/RestartOnlyCliPluginGuardTests.cs`
|
|
- **Built-in plugin modules**:
|
|
- VEX plugin -- VEX generation and verification commands
|
|
- Verdict plugin -- verdict inspection and verification
|
|
- Timestamp plugin -- RFC 3161 timestamp operations
|
|
- Symbols plugin -- symbol table operations
|
|
- AOC plugin -- attestation of compliance
|
|
- DeltaSig plugin -- delta signature operations (`src/Cli/StellaOps.Cli/Commands/DeltaSig/`)
|
|
|
|
## E2E Test Plan
|
|
- [ ] Verify all built-in plugins load at startup
|
|
- [ ] Verify VEX plugin commands are available (stella vex gen, stella vex verify)
|
|
- [ ] Verify verdict plugin commands work (stella verdict show)
|
|
- [ ] Verify timestamp plugin commands work (stella ts verify)
|
|
- [ ] Verify symbols plugin commands work (stella symbols ingest)
|
|
- [ ] Verify DeltaSig plugin commands work (stella deltasig create, verify)
|
|
- [ ] Verify plugin guard prevents unauthorized module loading
|
|
- [ ] Verify graceful degradation when optional plugin is missing
|
|
|
|
## 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-with-plugin-based-command-modules/run-001/tier2-integration-check.json`
|