stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
d0f2cc3b2cf0dfa4b1ea69737ad5ebd02089fbc6
git.stella-ops.org/docs/features/checked/cli/cli-and-automation-ux.md
master e9aeadc040 save checkpoint
2026-02-14 09:11:48 +02:00

2.7 KiB
Raw Blame History

CLI and Automation UX

Module

Cli

Status

VERIFIED

Description

Full CLI with command groups for replay, verdict, air-gap, prove, audit, and feeds operations.

Implementation Details

  • Entry Point: src/Cli/StellaOps.Cli/Program.cs -- CLI application bootstrap
  • Application: src/Cli/StellaOps.Cli/CliApplication.cs -- command tree assembly and DI configuration
  • Command Factory: src/Cli/StellaOps.Cli/Commands/CommandFactory.cs -- factory for building the full command hierarchy
  • Key Command Groups (all under src/Cli/StellaOps.Cli/Commands/):
    • ReplayCommandGroup.cs -- stella replay for deterministic verdict replay
    • VerdictCommandGroup.cs -- stella verdict for verdict inspection and verification
    • AirGapCommandGroup.cs -- stella airgap for offline/air-gapped operations
    • ProveCommandGroup.cs -- stella prove for proof generation and verification
    • AuditCommandGroup.cs -- stella audit for audit bundle generation
    • FeedsCommandGroup.cs -- stella feeds for advisory feed management (consolidated under stella config feeds)
  • Output: src/Cli/StellaOps.Cli/Output/ -- output renderer extensions for consistent formatting
  • Configuration: src/Cli/StellaOps.Cli/Configuration/ -- CLI configuration and bootstrapping
  • ~18 top-level command groups: scan, release, verify, attest, evidence, policy, vex, reachability, sbom, crypto, config, auth, admin, ci, setup, explain, tools, doctor

E2E Test Plan

  • Run stella --help and verify top-level command groups are listed with descriptions
  • Run stella replay run <digest> and verify replay execution with deterministic output
  • Run stella verdict show <digest> and verify verdict details displayed
  • Run stella airgap export and verify offline bundle creation
  • Run stella prove generate <digest> and verify proof generation
  • Run stella audit bundle <digest> and verify audit package creation
  • Run stella config feeds list and verify feed listing
  • Verify --format json works across all command groups for automation
  • Verify --verbose flag provides additional output across all commands
  • Verify exit codes follow convention: 0=success, 1=error, 2=block

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, 193 tests pass in StellaOps.Cli.Core.Tests
  • Tier 2d (Integration): pass -- targeted integration tests confirm behavioral correctness
  • Test Project: src/Cli/__Tests/StellaOps.Cli.Core.Tests/StellaOps.Cli.Core.Tests.csproj
  • Evidence: docs/qa/feature-checks/runs/cli/cli-and-automation-ux/run-001/tier2-integration-check.json