stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
534aabfa2a8c9264f2479541a5c11e48de7b97fa
git.stella-ops.org/docs/features/checked/cli/cli-with-plugin-based-command-modules.md
master e9aeadc040 save checkpoint
2026-02-14 09:11:48 +02:00

2.1 KiB
Raw Blame History

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