Files
git.stella-ops.org/docs/features/unchecked/cli/cli-with-plugin-based-command-modules.md

1.6 KiB

CLI with Plugin-Based Command Modules

Module

Cli

Status

IMPLEMENTED

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